vDataFrame.append¶

In [ ]:

vDataFrame.append(input_relation,
                  expr1: list = [],
                  expr2: list = [],
                  union_all: bool = True)

Merges the vDataFrame with another vDataFrame or an input relation and returns a new vDataFrame.

Parameters¶

Name	Type	Optional	Description
input_relation	str / vDataFrame	❌	Relation to merge with.
expr1	list	✓	List of pure SQL expressions from the current vDataFrame to use during the merge. If empty, all the vDataFrame vcolumns will be used. Aliases are recommended to avoid automatic naming. Examples: 'CASE WHEN "column" > 3 THEN 2 ELSE NULL END' or 'POWER("column", 2).'
expr2	list	✓	List of pure SQL expressions from the input vDataFrame to use during the merge. If empty, all the vDataFrame vcolumns will be used. Aliases are recommended to avoid automatic naming. Examples: 'CASE WHEN "column" > 3 THEN 2 ELSE NULL END' or 'POWER("column", 2).'
union_all	bool	✓	If set to True, the vDataFrame will be merged with the input relation with 'UNION ALL' instead of an 'UNION'.

Returns¶

vDataFrame : self

Example¶

In [106]:

from verticapy.datasets import load_iris
iris = load_iris()
display(iris)

	123 SepalLengthCm Numeric(5,2)	Abc Species Varchar(30)	123 PetalLengthCm Numeric(5,2)	123 SepalWidthCm Numeric(5,2)	123 PetalWidthCm Numeric(5,2)
1	4.30	Iris-setosa	1.10	3.00	0.10
2	4.40	Iris-setosa	1.40	2.90	0.20
3	4.40	Iris-setosa	1.30	3.00	0.20
4	4.40	Iris-setosa	1.30	3.20	0.20
5	4.50	Iris-setosa	1.30	2.30	0.30
6	4.60	Iris-setosa	1.50	3.10	0.20
7	4.60	Iris-setosa	1.40	3.20	0.20
8	4.60	Iris-setosa	1.40	3.40	0.30
9	4.60	Iris-setosa	1.00	3.60	0.20
10	4.70	Iris-setosa	1.30	3.20	0.20
11	4.70	Iris-setosa	1.60	3.20	0.20
12	4.80	Iris-setosa	1.40	3.00	0.10
13	4.80	Iris-setosa	1.40	3.00	0.30
14	4.80	Iris-setosa	1.60	3.10	0.20
15	4.80	Iris-setosa	1.60	3.40	0.20
16	4.80	Iris-setosa	1.90	3.40	0.20
17	4.90	Iris-versicolor	3.30	2.40	1.00
18	4.90	Iris-virginica	4.50	2.50	1.70
19	4.90	Iris-setosa	1.40	3.00	0.20
20	4.90	Iris-setosa	1.50	3.10	0.10
21	4.90	Iris-setosa	1.50	3.10	0.10
22	4.90	Iris-setosa	1.50	3.10	0.10
23	5.00	Iris-versicolor	3.50	2.00	1.00
24	5.00	Iris-versicolor	3.30	2.30	1.00
25	5.00	Iris-setosa	1.60	3.00	0.20
26	5.00	Iris-setosa	1.20	3.20	0.20
27	5.00	Iris-setosa	1.40	3.30	0.20
28	5.00	Iris-setosa	1.50	3.40	0.20
29	5.00	Iris-setosa	1.60	3.40	0.40
30	5.00	Iris-setosa	1.30	3.50	0.30
31	5.00	Iris-setosa	1.60	3.50	0.60
32	5.00	Iris-setosa	1.40	3.60	0.20
33	5.10	Iris-versicolor	3.00	2.50	1.10
34	5.10	Iris-setosa	1.70	3.30	0.50
35	5.10	Iris-setosa	1.50	3.40	0.20
36	5.10	Iris-setosa	1.40	3.50	0.20
37	5.10	Iris-setosa	1.40	3.50	0.30
38	5.10	Iris-setosa	1.50	3.70	0.40
39	5.10	Iris-setosa	1.50	3.80	0.30
40	5.10	Iris-setosa	1.60	3.80	0.20
41	5.10	Iris-setosa	1.90	3.80	0.40
42	5.20	Iris-versicolor	3.90	2.70	1.40
43	5.20	Iris-setosa	1.40	3.40	0.20
44	5.20	Iris-setosa	1.50	3.50	0.20
45	5.20	Iris-setosa	1.50	4.10	0.10
46	5.30	Iris-setosa	1.50	3.70	0.20
47	5.40	Iris-versicolor	4.50	3.00	1.50
48	5.40	Iris-setosa	1.50	3.40	0.40
49	5.40	Iris-setosa	1.70	3.40	0.20
50	5.40	Iris-setosa	1.50	3.70	0.20
51	5.40	Iris-setosa	1.30	3.90	0.40
52	5.40	Iris-setosa	1.70	3.90	0.40
53	5.50	Iris-versicolor	4.00	2.30	1.30
54	5.50	Iris-versicolor	3.70	2.40	1.00
55	5.50	Iris-versicolor	3.80	2.40	1.10
56	5.50	Iris-versicolor	4.00	2.50	1.30
57	5.50	Iris-versicolor	4.40	2.60	1.20
58	5.50	Iris-setosa	1.30	3.50	0.20
59	5.50	Iris-setosa	1.40	4.20	0.20
60	5.60	Iris-versicolor	3.90	2.50	1.10
61	5.60	Iris-versicolor	4.20	2.70	1.30
62	5.60	Iris-virginica	4.90	2.80	2.00
63	5.60	Iris-versicolor	3.60	2.90	1.30
64	5.60	Iris-versicolor	4.10	3.00	1.30
65	5.60	Iris-versicolor	4.50	3.00	1.50
66	5.70	Iris-virginica	5.00	2.50	2.00
67	5.70	Iris-versicolor	3.50	2.60	1.00
68	5.70	Iris-versicolor	4.10	2.80	1.30
69	5.70	Iris-versicolor	4.50	2.80	1.30
70	5.70	Iris-versicolor	4.20	2.90	1.30
71	5.70	Iris-versicolor	4.20	3.00	1.20
72	5.70	Iris-setosa	1.70	3.80	0.30
73	5.70	Iris-setosa	1.50	4.40	0.40
74	5.80	Iris-versicolor	4.00	2.60	1.20
75	5.80	Iris-versicolor	3.90	2.70	1.20
76	5.80	Iris-versicolor	4.10	2.70	1.00
77	5.80	Iris-virginica	5.10	2.70	1.90
78	5.80	Iris-virginica	5.10	2.70	1.90
79	5.80	Iris-virginica	5.10	2.80	2.40
80	5.80	Iris-setosa	1.20	4.00	0.20
81	5.90	Iris-versicolor	4.20	3.00	1.50
82	5.90	Iris-virginica	5.10	3.00	1.80
83	5.90	Iris-versicolor	4.80	3.20	1.80
84	6.00	Iris-versicolor	4.00	2.20	1.00
85	6.00	Iris-virginica	5.00	2.20	1.50
86	6.00	Iris-versicolor	5.10	2.70	1.60
87	6.00	Iris-versicolor	4.50	2.90	1.50
88	6.00	Iris-virginica	4.80	3.00	1.80
89	6.00	Iris-versicolor	4.50	3.40	1.60
90	6.10	Iris-virginica	5.60	2.60	1.40
91	6.10	Iris-versicolor	4.00	2.80	1.30
92	6.10	Iris-versicolor	4.70	2.80	1.20
93	6.10	Iris-versicolor	4.70	2.90	1.40
94	6.10	Iris-versicolor	4.60	3.00	1.40
95	6.10	Iris-virginica	4.90	3.00	1.80
96	6.20	Iris-versicolor	4.50	2.20	1.50
97	6.20	Iris-virginica	4.80	2.80	1.80
98	6.20	Iris-versicolor	4.30	2.90	1.30
99	6.20	Iris-virginica	5.40	3.40	2.30
100	6.30	Iris-versicolor	4.40	2.30	1.30

Rows: 1-100 of 150 | Columns: 5

In [107]:

# Adding another vDataFrame with the same columns name
iris.append(iris)

	123 SepalLengthCm Numeric(5,2)	Abc Species Varchar(30)	123 PetalLengthCm Numeric(5,2)	123 SepalWidthCm Numeric(5,2)	123 PetalWidthCm Numeric(5,2)
1	4.30	Iris-setosa	1.10	3.00	0.10
2	4.40	Iris-setosa	1.40	2.90	0.20
3	4.40	Iris-setosa	1.30	3.00	0.20
4	4.40	Iris-setosa	1.30	3.20	0.20
5	4.50	Iris-setosa	1.30	2.30	0.30
6	4.60	Iris-setosa	1.50	3.10	0.20
7	4.60	Iris-setosa	1.40	3.20	0.20
8	4.60	Iris-setosa	1.40	3.40	0.30
9	4.60	Iris-setosa	1.00	3.60	0.20
10	4.70	Iris-setosa	1.30	3.20	0.20
11	4.70	Iris-setosa	1.60	3.20	0.20
12	4.80	Iris-setosa	1.40	3.00	0.10
13	4.80	Iris-setosa	1.40	3.00	0.30
14	4.80	Iris-setosa	1.60	3.10	0.20
15	4.80	Iris-setosa	1.60	3.40	0.20
16	4.80	Iris-setosa	1.90	3.40	0.20
17	4.90	Iris-versicolor	3.30	2.40	1.00
18	4.90	Iris-virginica	4.50	2.50	1.70
19	4.90	Iris-setosa	1.40	3.00	0.20
20	4.90	Iris-setosa	1.50	3.10	0.10
21	4.90	Iris-setosa	1.50	3.10	0.10
22	4.90	Iris-setosa	1.50	3.10	0.10
23	5.00	Iris-versicolor	3.50	2.00	1.00
24	5.00	Iris-versicolor	3.30	2.30	1.00
25	5.00	Iris-setosa	1.60	3.00	0.20
26	5.00	Iris-setosa	1.20	3.20	0.20
27	5.00	Iris-setosa	1.40	3.30	0.20
28	5.00	Iris-setosa	1.50	3.40	0.20
29	5.00	Iris-setosa	1.60	3.40	0.40
30	5.00	Iris-setosa	1.30	3.50	0.30
31	5.00	Iris-setosa	1.60	3.50	0.60
32	5.00	Iris-setosa	1.40	3.60	0.20
33	5.10	Iris-versicolor	3.00	2.50	1.10
34	5.10	Iris-setosa	1.70	3.30	0.50
35	5.10	Iris-setosa	1.50	3.40	0.20
36	5.10	Iris-setosa	1.40	3.50	0.20
37	5.10	Iris-setosa	1.40	3.50	0.30
38	5.10	Iris-setosa	1.50	3.70	0.40
39	5.10	Iris-setosa	1.50	3.80	0.30
40	5.10	Iris-setosa	1.60	3.80	0.20
41	5.10	Iris-setosa	1.90	3.80	0.40
42	5.20	Iris-versicolor	3.90	2.70	1.40
43	5.20	Iris-setosa	1.40	3.40	0.20
44	5.20	Iris-setosa	1.50	3.50	0.20
45	5.20	Iris-setosa	1.50	4.10	0.10
46	5.30	Iris-setosa	1.50	3.70	0.20
47	5.40	Iris-versicolor	4.50	3.00	1.50
48	5.40	Iris-setosa	1.50	3.40	0.40
49	5.40	Iris-setosa	1.70	3.40	0.20
50	5.40	Iris-setosa	1.50	3.70	0.20
51	5.40	Iris-setosa	1.30	3.90	0.40
52	5.40	Iris-setosa	1.70	3.90	0.40
53	5.50	Iris-versicolor	4.00	2.30	1.30
54	5.50	Iris-versicolor	3.70	2.40	1.00
55	5.50	Iris-versicolor	3.80	2.40	1.10
56	5.50	Iris-versicolor	4.00	2.50	1.30
57	5.50	Iris-versicolor	4.40	2.60	1.20
58	5.50	Iris-setosa	1.30	3.50	0.20
59	5.50	Iris-setosa	1.40	4.20	0.20
60	5.60	Iris-versicolor	3.90	2.50	1.10
61	5.60	Iris-versicolor	4.20	2.70	1.30
62	5.60	Iris-virginica	4.90	2.80	2.00
63	5.60	Iris-versicolor	3.60	2.90	1.30
64	5.60	Iris-versicolor	4.10	3.00	1.30
65	5.60	Iris-versicolor	4.50	3.00	1.50
66	5.70	Iris-virginica	5.00	2.50	2.00
67	5.70	Iris-versicolor	3.50	2.60	1.00
68	5.70	Iris-versicolor	4.10	2.80	1.30
69	5.70	Iris-versicolor	4.50	2.80	1.30
70	5.70	Iris-versicolor	4.20	2.90	1.30
71	5.70	Iris-versicolor	4.20	3.00	1.20
72	5.70	Iris-setosa	1.70	3.80	0.30
73	5.70	Iris-setosa	1.50	4.40	0.40
74	5.80	Iris-versicolor	4.00	2.60	1.20
75	5.80	Iris-versicolor	3.90	2.70	1.20
76	5.80	Iris-versicolor	4.10	2.70	1.00
77	5.80	Iris-virginica	5.10	2.70	1.90
78	5.80	Iris-virginica	5.10	2.70	1.90
79	5.80	Iris-virginica	5.10	2.80	2.40
80	5.80	Iris-setosa	1.20	4.00	0.20
81	5.90	Iris-versicolor	4.20	3.00	1.50
82	5.90	Iris-virginica	5.10	3.00	1.80
83	5.90	Iris-versicolor	4.80	3.20	1.80
84	6.00	Iris-versicolor	4.00	2.20	1.00
85	6.00	Iris-virginica	5.00	2.20	1.50
86	6.00	Iris-versicolor	5.10	2.70	1.60
87	6.00	Iris-versicolor	4.50	2.90	1.50
88	6.00	Iris-virginica	4.80	3.00	1.80
89	6.00	Iris-versicolor	4.50	3.40	1.60
90	6.10	Iris-virginica	5.60	2.60	1.40
91	6.10	Iris-versicolor	4.00	2.80	1.30
92	6.10	Iris-versicolor	4.70	2.80	1.20
93	6.10	Iris-versicolor	4.70	2.90	1.40
94	6.10	Iris-versicolor	4.60	3.00	1.40
95	6.10	Iris-virginica	4.90	3.00	1.80
96	6.20	Iris-versicolor	4.50	2.20	1.50
97	6.20	Iris-virginica	4.80	2.80	1.80
98	6.20	Iris-versicolor	4.30	2.90	1.30
99	6.20	Iris-virginica	5.40	3.40	2.30
100	6.30	Iris-versicolor	4.40	2.30	1.30

Out[107]:

Rows: 1-100 of 300 | Columns: 5

In [108]:

# Adding another relation with the same columns name
iris.append("public.iris")

	123 SepalLengthCm Numeric(5,2)	Abc Species Varchar(30)	123 PetalLengthCm Numeric(5,2)	123 SepalWidthCm Numeric(5,2)	123 PetalWidthCm Numeric(5,2)
1	4.30	Iris-setosa	1.10	3.00	0.10
2	4.40	Iris-setosa	1.40	2.90	0.20
3	4.40	Iris-setosa	1.30	3.00	0.20
4	4.40	Iris-setosa	1.30	3.20	0.20
5	4.50	Iris-setosa	1.30	2.30	0.30
6	4.60	Iris-setosa	1.50	3.10	0.20
7	4.60	Iris-setosa	1.40	3.20	0.20
8	4.60	Iris-setosa	1.40	3.40	0.30
9	4.60	Iris-setosa	1.00	3.60	0.20
10	4.70	Iris-setosa	1.30	3.20	0.20
11	4.70	Iris-setosa	1.60	3.20	0.20
12	4.80	Iris-setosa	1.40	3.00	0.10
13	4.80	Iris-setosa	1.40	3.00	0.30
14	4.80	Iris-setosa	1.60	3.10	0.20
15	4.80	Iris-setosa	1.60	3.40	0.20
16	4.80	Iris-setosa	1.90	3.40	0.20
17	4.90	Iris-versicolor	3.30	2.40	1.00
18	4.90	Iris-virginica	4.50	2.50	1.70
19	4.90	Iris-setosa	1.40	3.00	0.20
20	4.90	Iris-setosa	1.50	3.10	0.10
21	4.90	Iris-setosa	1.50	3.10	0.10
22	4.90	Iris-setosa	1.50	3.10	0.10
23	5.00	Iris-versicolor	3.50	2.00	1.00
24	5.00	Iris-versicolor	3.30	2.30	1.00
25	5.00	Iris-setosa	1.60	3.00	0.20
26	5.00	Iris-setosa	1.20	3.20	0.20
27	5.00	Iris-setosa	1.40	3.30	0.20
28	5.00	Iris-setosa	1.50	3.40	0.20
29	5.00	Iris-setosa	1.60	3.40	0.40
30	5.00	Iris-setosa	1.30	3.50	0.30
31	5.00	Iris-setosa	1.60	3.50	0.60
32	5.00	Iris-setosa	1.40	3.60	0.20
33	5.10	Iris-versicolor	3.00	2.50	1.10
34	5.10	Iris-setosa	1.70	3.30	0.50
35	5.10	Iris-setosa	1.50	3.40	0.20
36	5.10	Iris-setosa	1.40	3.50	0.20
37	5.10	Iris-setosa	1.40	3.50	0.30
38	5.10	Iris-setosa	1.50	3.70	0.40
39	5.10	Iris-setosa	1.50	3.80	0.30
40	5.10	Iris-setosa	1.60	3.80	0.20
41	5.10	Iris-setosa	1.90	3.80	0.40
42	5.20	Iris-versicolor	3.90	2.70	1.40
43	5.20	Iris-setosa	1.40	3.40	0.20
44	5.20	Iris-setosa	1.50	3.50	0.20
45	5.20	Iris-setosa	1.50	4.10	0.10
46	5.30	Iris-setosa	1.50	3.70	0.20
47	5.40	Iris-versicolor	4.50	3.00	1.50
48	5.40	Iris-setosa	1.50	3.40	0.40
49	5.40	Iris-setosa	1.70	3.40	0.20
50	5.40	Iris-setosa	1.50	3.70	0.20
51	5.40	Iris-setosa	1.30	3.90	0.40
52	5.40	Iris-setosa	1.70	3.90	0.40
53	5.50	Iris-versicolor	4.00	2.30	1.30
54	5.50	Iris-versicolor	3.70	2.40	1.00
55	5.50	Iris-versicolor	3.80	2.40	1.10
56	5.50	Iris-versicolor	4.00	2.50	1.30
57	5.50	Iris-versicolor	4.40	2.60	1.20
58	5.50	Iris-setosa	1.30	3.50	0.20
59	5.50	Iris-setosa	1.40	4.20	0.20
60	5.60	Iris-versicolor	3.90	2.50	1.10
61	5.60	Iris-versicolor	4.20	2.70	1.30
62	5.60	Iris-virginica	4.90	2.80	2.00
63	5.60	Iris-versicolor	3.60	2.90	1.30
64	5.60	Iris-versicolor	4.10	3.00	1.30
65	5.60	Iris-versicolor	4.50	3.00	1.50
66	5.70	Iris-virginica	5.00	2.50	2.00
67	5.70	Iris-versicolor	3.50	2.60	1.00
68	5.70	Iris-versicolor	4.10	2.80	1.30
69	5.70	Iris-versicolor	4.50	2.80	1.30
70	5.70	Iris-versicolor	4.20	2.90	1.30
71	5.70	Iris-versicolor	4.20	3.00	1.20
72	5.70	Iris-setosa	1.70	3.80	0.30
73	5.70	Iris-setosa	1.50	4.40	0.40
74	5.80	Iris-versicolor	4.00	2.60	1.20
75	5.80	Iris-versicolor	3.90	2.70	1.20
76	5.80	Iris-versicolor	4.10	2.70	1.00
77	5.80	Iris-virginica	5.10	2.70	1.90
78	5.80	Iris-virginica	5.10	2.70	1.90
79	5.80	Iris-virginica	5.10	2.80	2.40
80	5.80	Iris-setosa	1.20	4.00	0.20
81	5.90	Iris-versicolor	4.20	3.00	1.50
82	5.90	Iris-virginica	5.10	3.00	1.80
83	5.90	Iris-versicolor	4.80	3.20	1.80
84	6.00	Iris-versicolor	4.00	2.20	1.00
85	6.00	Iris-virginica	5.00	2.20	1.50
86	6.00	Iris-versicolor	5.10	2.70	1.60
87	6.00	Iris-versicolor	4.50	2.90	1.50
88	6.00	Iris-virginica	4.80	3.00	1.80
89	6.00	Iris-versicolor	4.50	3.40	1.60
90	6.10	Iris-virginica	5.60	2.60	1.40
91	6.10	Iris-versicolor	4.00	2.80	1.30
92	6.10	Iris-versicolor	4.70	2.80	1.20
93	6.10	Iris-versicolor	4.70	2.90	1.40
94	6.10	Iris-versicolor	4.60	3.00	1.40
95	6.10	Iris-virginica	4.90	3.00	1.80
96	6.20	Iris-versicolor	4.50	2.20	1.50
97	6.20	Iris-virginica	4.80	2.80	1.80
98	6.20	Iris-versicolor	4.30	2.90	1.30
99	6.20	Iris-virginica	5.40	3.40	2.30
100	6.30	Iris-versicolor	4.40	2.30	1.30

Out[108]:

Rows: 1-100 of 300 | Columns: 5

In [109]:

# Considering only specific columns
iris.append(iris,
            expr1 = ["SepalLengthCm AS sl", "PetalLengthCm AS pl"],
            expr2 = ["SepalLengthCm AS sl", "PetalLengthCm AS pl"])

	123 sl Numeric(5,2)	123 pl Numeric(5,2)
1	4.30	1.10
2	4.40	1.40
3	4.40	1.30
4	4.40	1.30
5	4.50	1.30
6	4.60	1.50
7	4.60	1.40
8	4.60	1.40
9	4.60	1.00
10	4.70	1.30
11	4.70	1.60
12	4.80	1.40
13	4.80	1.40
14	4.80	1.60
15	4.80	1.60
16	4.80	1.90
17	4.90	3.30
18	4.90	4.50
19	4.90	1.40
20	4.90	1.50
21	4.90	1.50
22	4.90	1.50
23	5.00	3.50
24	5.00	3.30
25	5.00	1.60
26	5.00	1.20
27	5.00	1.40
28	5.00	1.50
29	5.00	1.60
30	5.00	1.30
31	5.00	1.60
32	5.00	1.40
33	5.10	3.00
34	5.10	1.70
35	5.10	1.50
36	5.10	1.40
37	5.10	1.40
38	5.10	1.50
39	5.10	1.50
40	5.10	1.60
41	5.10	1.90
42	5.20	3.90
43	5.20	1.40
44	5.20	1.50
45	5.20	1.50
46	5.30	1.50
47	5.40	4.50
48	5.40	1.50
49	5.40	1.70
50	5.40	1.50
51	5.40	1.30
52	5.40	1.70
53	5.50	4.00
54	5.50	3.70
55	5.50	3.80
56	5.50	4.00
57	5.50	4.40
58	5.50	1.30
59	5.50	1.40
60	5.60	3.90
61	5.60	4.20
62	5.60	4.90
63	5.60	3.60
64	5.60	4.10
65	5.60	4.50
66	5.70	5.00
67	5.70	3.50
68	5.70	4.10
69	5.70	4.50
70	5.70	4.20
71	5.70	4.20
72	5.70	1.70
73	5.70	1.50
74	5.80	4.00
75	5.80	3.90
76	5.80	4.10
77	5.80	5.10
78	5.80	5.10
79	5.80	5.10
80	5.80	1.20
81	5.90	4.20
82	5.90	5.10
83	5.90	4.80
84	6.00	4.00
85	6.00	5.00
86	6.00	5.10
87	6.00	4.50
88	6.00	4.80
89	6.00	4.50
90	6.10	5.60
91	6.10	4.00
92	6.10	4.70
93	6.10	4.70
94	6.10	4.60
95	6.10	4.90
96	6.20	4.50
97	6.20	4.80
98	6.20	4.30
99	6.20	5.40
100	6.30	4.40

Out[109]:

Rows: 1-100 of 300 | Columns: 2

vDataFrame.groupby	Aggregates the vDataFrame.
vDataFrame.join	Joins the vDataFrame with another relation.
vDataFrame.sort	Sorts the vDataFrame.

vDataFrame.append¶

Parameters¶

Returns¶

Example¶

See Also¶