# Parquet SerDe
<a name="parquet-serde"></a>

Parquet SerDe を使用して、Parquet データから Athena テーブルを作成します。

Parquet SerDe は、[Parquet 形式](https://cwiki.apache.org/confluence/display/Hive/Parquet)で保存されているデータに使用します。データを Parket 形式に変換するには、[CREATE TABLE AS SELECT (CTAS)](create-table-as.md) クエリを使用できます。詳細については、「[クエリ結果からテーブルを作成する (CTAS)](ctas.md)」、「[CTAS クエリの例](ctas-examples.md)」、および「[ETL およびデータ分析での CTAS および INSERT INTO を使用する](ctas-insert-into-etl.md)」を参照してください。

## シリアル化ライブラリ名
<a name="parquet-serde-library-name"></a>

Parquet SerDe のシリアル化ライブラリ名は `org.apache.hadoop.hive.ql.io.parquet.serde.ParquetHiveSerDe` です。ソースコード情報については、Apache ドキュメントの「[Class ParquetHiveSerDe](https://svn.apache.org/repos/infra/websites/production/hive/content/javadocs/r2.1.1/api/org/apache/hadoop/hive/ql/io/parquet/serde/ParquetHiveSerDe.html)」を参照してください。

## 例: Parquet で保存されているファイルをクエリする
<a name="example-querying-a-file-stored-in-parquet"></a>

**注記**  
`s3://athena-examples-{{myregion}}/path/to/data/` の {{myregion}} を、Athena が実行されるリージョンの識別子 (`s3://athena-examples-us-west-1/path/to/data/` など) に置き換えます。

以下の `CREATE TABLE` ステートメントを使用して、Amazon S3 に Parquet 形式で保存されている基盤となるデータから Athena テーブルを作成します。

```
CREATE EXTERNAL TABLE flight_delays_pq (
    yr INT,
    quarter INT,
    month INT,
    dayofmonth INT,
    dayofweek INT,
    flightdate STRING,
    uniquecarrier STRING,
    airlineid INT,
    carrier STRING,
    tailnum STRING,
    flightnum STRING,
    originairportid INT,
    originairportseqid INT,
    origincitymarketid INT,
    origin STRING,
    origincityname STRING,
    originstate STRING,
    originstatefips STRING,
    originstatename STRING,
    originwac INT,
    destairportid INT,
    destairportseqid INT,
    destcitymarketid INT,
    dest STRING,
    destcityname STRING,
    deststate STRING,
    deststatefips STRING,
    deststatename STRING,
    destwac INT,
    crsdeptime STRING,
    deptime STRING,
    depdelay INT,
    depdelayminutes INT,
    depdel15 INT,
    departuredelaygroups INT,
    deptimeblk STRING,
    taxiout INT,
    wheelsoff STRING,
    wheelson STRING,
    taxiin INT,
    crsarrtime INT,
    arrtime STRING,
    arrdelay INT,
    arrdelayminutes INT,
    arrdel15 INT,
    arrivaldelaygroups INT,
    arrtimeblk STRING,
    cancelled INT,
    cancellationcode STRING,
    diverted INT,
    crselapsedtime INT,
    actualelapsedtime INT,
    airtime INT,
    flights INT,
    distance INT,
    distancegroup INT,
    carrierdelay INT,
    weatherdelay INT,
    nasdelay INT,
    securitydelay INT,
    lateaircraftdelay INT,
    firstdeptime STRING,
    totaladdgtime INT,
    longestaddgtime INT,
    divairportlandings INT,
    divreacheddest INT,
    divactualelapsedtime INT,
    divarrdelay INT,
    divdistance INT,
    div1airport STRING,
    div1airportid INT,
    div1airportseqid INT,
    div1wheelson STRING,
    div1totalgtime INT,
    div1longestgtime INT,
    div1wheelsoff STRING,
    div1tailnum STRING,
    div2airport STRING,
    div2airportid INT,
    div2airportseqid INT,
    div2wheelson STRING,
    div2totalgtime INT,
    div2longestgtime INT,
    div2wheelsoff STRING,
    div2tailnum STRING,
    div3airport STRING,
    div3airportid INT,
    div3airportseqid INT,
    div3wheelson STRING,
    div3totalgtime INT,
    div3longestgtime INT,
    div3wheelsoff STRING,
    div3tailnum STRING,
    div4airport STRING,
    div4airportid INT,
    div4airportseqid INT,
    div4wheelson STRING,
    div4totalgtime INT,
    div4longestgtime INT,
    div4wheelsoff STRING,
    div4tailnum STRING,
    div5airport STRING,
    div5airportid INT,
    div5airportseqid INT,
    div5wheelson STRING,
    div5totalgtime INT,
    div5longestgtime INT,
    div5wheelsoff STRING,
    div5tailnum STRING
)
PARTITIONED BY (year STRING)
STORED AS PARQUET
LOCATION 's3://athena-examples-{{myregion}}/flight/parquet/'
tblproperties ("parquet.compression"="SNAPPY");
```

テーブルに対して `MSCK REPAIR TABLE` ステートメントを実行し、パーティションのメタデータを更新します。

```
MSCK REPAIR TABLE flight_delays_pq;
```

遅延が 1 時間を超えた上位 10 便をクエリします。

```
SELECT origin, dest, count(*) as delays
FROM flight_delays_pq
WHERE depdelayminutes > 60
GROUP BY origin, dest
ORDER BY 3 DESC
LIMIT 10;
```

**注記**  
フライトテーブルデータは、米国運輸省の[運輸統計局](http://www.transtats.bts.gov/)が提供する [Flights](http://www.transtats.bts.gov/DL_SelectFields.asp?Table_ID=236&amp;DB_Short_Name=On-Time) からのものです。オリジナルを白黒に変換しています。

## Parquet 統計を無視する
<a name="parquet-serde-ignoring-parquet-statistics"></a>

Parquet データを読み取ると、次のようなエラーメッセージが表示されることがあります。

```
HIVE_CANNOT_OPEN_SPLIT: Index x out of bounds for length y
HIVE_CURSOR_ERROR: Failed to read x bytes
HIVE_CURSOR_ERROR: FailureException at Malformed input: offset=x
HIVE_CURSOR_ERROR: FailureException at java.io.IOException: 
can not read class org.apache.parquet.format.PageHeader: Socket is closed by peer.
```

この問題を回避するには、次の例のように [CREATE TABLE](create-table.md) ステートメントまたは [ALTER TABLE SET TBLPROPERTIES](alter-table-set-tblproperties.md) ステートメントを使用して Parquet SerDe `parquet.ignore.statistics` プロパティを `true` に設定します。

CREATE TABLE の例

```
...
ROW FORMAT SERDE  
'org.apache.hadoop.hive.ql.io.parquet.serde.ParquetHiveSerDe' 
WITH SERDEPROPERTIES (  
'parquet.ignore.statistics'='true')  
STORED AS PARQUET 
...
```

ALTER TABLE の例

```
ALTER TABLE ... SET TBLPROPERTIES ('parquet.ignore.statistics'='true')
```