[
https://issues.apache.org/jira/browse/ARROW-2181?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16393494#comment-16393494
]
ASF GitHub Bot commented on ARROW-2181:
---------------------------------------
BryanCutler commented on a change in pull request #1733: ARROW-2181:
[PYTHON][DOC] Add doc on usage of concat_tables
URL: https://github.com/apache/arrow/pull/1733#discussion_r173559109
##########
File path: python/doc/source/data.rst
##########
@@ -393,6 +393,22 @@ objects to contiguous NumPy arrays for use in pandas:
c.to_pandas()
+Multiple tables can also be concatenated together to form a single table using
+``pa.concat_tables``, if the schemas are equal:
+
+.. ipython:: python
+
+ tables = [table] * 2
+ table_all = pa.concat_tables(tables)
+ table_all.num_rows
+ c = table_all[0]
+ c.data.num_chunks
+
+This is similar to ``Table.from_batches``, but uses tables as input instead of
+record batches. Record batches can be made into tables, but not the other way
+around, so if your data is already in table form, then use
+``pa.concat_tables``.
Review comment:
Sure, will do
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
> [Python] Add concat_tables to API reference, add documentation on use
> ---------------------------------------------------------------------
>
> Key: ARROW-2181
> URL: https://issues.apache.org/jira/browse/ARROW-2181
> Project: Apache Arrow
> Issue Type: Improvement
> Components: Python
> Reporter: Wes McKinney
> Assignee: Bryan Cutler
> Priority: Major
> Labels: pull-request-available
> Fix For: 0.9.0
>
>
> This omission of documentation was mentioned on the mailing list on February
> 13. The documentation should illustrate the contrast between
> {{Table.from_batches}} and {{concat_tables}}.
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
