Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id D1ACA200CC9 for ; Mon, 17 Jul 2017 15:06:17 +0200 (CEST) Received: by cust-asf.ponee.io (Postfix) id D01F316474F; Mon, 17 Jul 2017 13:06:17 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id EF167163A5A for ; Mon, 17 Jul 2017 15:06:16 +0200 (CEST) Received: (qmail 5888 invoked by uid 500); 17 Jul 2017 13:06:15 -0000 Mailing-List: contact commits-help@arrow.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@arrow.apache.org Delivered-To: mailing list commits@arrow.apache.org Received: (qmail 5873 invoked by uid 99); 17 Jul 2017 13:06:15 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 17 Jul 2017 13:06:15 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id 143B1DFAB2; Mon, 17 Jul 2017 13:06:15 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit From: wesm@apache.org To: commits@arrow.apache.org Date: Mon, 17 Jul 2017 13:06:15 -0000 Message-Id: <393ca45fcb534b8ea5c2d5e152e20867@git.apache.org> In-Reply-To: <705579d92691442a889b4e146adb0b0d@git.apache.org> References: <705579d92691442a889b4e146adb0b0d@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: [02/15] arrow-site git commit: Update pyarrow Python documentation archived-at: Mon, 17 Jul 2017 13:06:18 -0000 http://git-wip-us.apache.org/repos/asf/arrow-site/blob/796ce23f/docs/python/parquet.html ---------------------------------------------------------------------- diff --git a/docs/python/parquet.html b/docs/python/parquet.html index 7f82186..d3a08ee 100644 --- a/docs/python/parquet.html +++ b/docs/python/parquet.html @@ -1,5 +1,6 @@ + @@ -37,7 +38,7 @@ - +

@@ -174,7 +175,7 @@ details.

Reading and Writing Single Files¶

The functions read_table() and write_table() read and write the pyarrow.Table objects, respectively.

-

Let’s look at a simple table:

+

Let’s look at a simple table:

In [2]: import numpy as np
 
 In [3]: import pandas as pd
@@ -216,7 +217,7 @@ the whole file (due to the columnar layout):
 one: double
 three: bool
 -- metadata --
-pandas: {"pandas_version": "0.19.0", "index_columns": ["__index_level_0__"], "columns": [{"metadata": null, "name": "one", "numpy_type": "float64", "pandas_type": "float64"}, {"metadata": null, "name": "three", "numpy_type": "bool", "pandas_type": "boolean"}, {"metadata": null, "name": "two", "numpy_type": "object", "pandas_type": "bytes"}, {"metadata": null, "name": "__index_level_0__", "numpy_type": "int64", "pandas_type": "int64"}]}
+pandas: {"pandas_version": "0.19.2", "index_columns": ["__index_level_0__"], "columns": [{"metadata": null, "numpy_type": "float64", "pandas_type": "float64", "name": "one"}, {"metadata": null, "numpy_type": "bool", "pandas_type": "bool", "name": "three"}, {"metadata": null, "numpy_type": "object", "pandas_type": "unicode", "name": "two"}, {"metadata": null, "numpy_type": "int64", "pandas_type": "int64", "name": "__index_level_0__"}]}

We need not use a string to specify the origin of the file. It can be any of:

@@ -236,20 +237,20 @@ maps) will perform the best.

In [13]: parquet_file.metadata Out[13]: -<pyarrow._parquet.FileMetaData object at 0x7efc440f5940> +<pyarrow._parquet.FileMetaData object at 0x2b9643b72cc8> created_by: parquet-cpp version 1.1.1-SNAPSHOT num_columns: 4 num_rows: 3 num_row_groups: 1 format_version: 1.0 - serialized_size: 803 + serialized_size: 804 In [14]: parquet_file.schema -Out[14]: -<pyarrow._parquet.ParquetSchema object at 0x7efc46c13fc8> +Out[14]: +<pyarrow._parquet.ParquetSchema object at 0x2b9642aecfc8> one: DOUBLE three: BOOLEAN -two: BYTE_ARRAY +two: BYTE_ARRAY UTF8 __index_level_0__: INT64

@@ -261,14 +262,14 @@ concatenate them into a single table. You can read individual row groups with Out[15]: 1 In [16]: parquet_file.read_row_group(0) -Out[16]: +Out[16]: pyarrow.Table one: double three: bool -two: binary +two: string __index_level_0__: int64 -- metadata -- -pandas: {"pandas_version": "0.19.0", "index_columns": ["__index_level_0__"], "columns": [{"metadata": null, "name": "one", "numpy_type": "float64", "pandas_type": "float64"}, {"metadata": null, "name": "three", "numpy_type": "bool", "pandas_type": "boolean"}, {"metadata": null, "name": "two", "numpy_type": "object", "pandas_type": "bytes"}, {"metadata": null, "name": "__index_level_0__", "numpy_type": "int64", "pandas_type": "int64"}]} +pandas: {"pandas_version": "0.19.2", "index_columns": ["__index_level_0__"], "columns": [{"metadata": null, "numpy_type": "float64", "pandas_type": "float64", "name": "one"}, {"metadata": null, "numpy_type": "bool", "pandas_type": "bool", "name": "three"}, {"metadata": null, "numpy_type": "object", "pandas_type": "unicode", "name": "two"}, {"metadata": null, "numpy_type": "int64", "pandas_type": "int64", "name": "__index_level_0__"}]}

We can similarly write a Parquet file with multiple row groups by using @@ -291,7 +292,7 @@ concatenate them into a single table. You can read individual row groups with

Compression, Encoding, and File Compatibility¶

The most commonly used Parquet implementations use dictionary encoding when -writing files; if the dictionaries grow too large, then they “fall back” to +writing files; if the dictionaries grow too large, then they “fall back” to plain encoding. Whether dictionary encoding is used can be toggled using the use_dictionary option:

pq.write_table(table, where, use_dictionary=False)
@@ -376,7 +377,7 @@ throughput:
     
     
         © Copyright 2016-2017 Apache Software Foundation.

-      Created using Sphinx 1.6.2.

+      Created using Sphinx 1.5.5.

http://git-wip-us.apache.org/repos/asf/arrow-site/blob/796ce23f/docs/python/search.html ---------------------------------------------------------------------- diff --git a/docs/python/search.html b/docs/python/search.html index eddb979..cc410d7 100644 --- a/docs/python/search.html +++ b/docs/python/search.html @@ -1,5 +1,6 @@ + @@ -43,7 +44,7 @@ - +