# パーティション API
<a name="aws-glue-api-catalog-partitions"></a>

Partition API では、パーティションを使用するためのデータ型とオペレーションについて説明します。

## データタイプ
<a name="aws-glue-api-catalog-partitions-objects"></a>
+ [パーティションの構造](#aws-glue-api-catalog-partitions-Partition)
+ [PartitionInput の構造](#aws-glue-api-catalog-partitions-PartitionInput)
+ [PartitionSpecWithSharedStorageDescriptor 構造](#aws-glue-api-catalog-partitions-PartitionSpecWithSharedStorageDescriptor)
+ [PartitionListComposingSpec 構造](#aws-glue-api-catalog-partitions-PartitionListComposingSpec)
+ [PartitionSpecProxy 構造](#aws-glue-api-catalog-partitions-PartitionSpecProxy)
+ [PartitionValueList 構造](#aws-glue-api-catalog-partitions-PartitionValueList)
+ [セグメント構造](#aws-glue-api-catalog-partitions-Segment)
+ [PartitionError 構造](#aws-glue-api-catalog-partitions-PartitionError)
+ [BatchUpdatePartitionFailureEntry 構造](#aws-glue-api-catalog-partitions-BatchUpdatePartitionFailureEntry)
+ [BatchUpdatePartitionRequestEntry 構造](#aws-glue-api-catalog-partitions-BatchUpdatePartitionRequestEntry)
+ [StorageDescriptor 構造](#aws-glue-api-catalog-partitions-StorageDescriptor)
+ [SchemaReference 構造](#aws-glue-api-catalog-partitions-SchemaReference)
+ [SerDeInfo 構造](#aws-glue-api-catalog-partitions-SerDeInfo)
+ [SkewedInfo 構造](#aws-glue-api-catalog-partitions-SkewedInfo)

## パーティションの構造
<a name="aws-glue-api-catalog-partitions-Partition"></a>

テーブルデータのスライスを表します。

**フィールド**
+ `Values` – UTF-8 文字列の配列。

  パーティションの値。
+ `DatabaseName` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションを作成するカタログデータベースの名前。
+ `TableName` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションを作成するデータベーステーブルの名前。
+ `CreationTime` – タイムスタンプ。

  パーティションが作成された時刻。
+ `LastAccessTime` – タイムスタンプ。

  パーティションが最後にアクセスされた時刻。
+ `StorageDescriptor` – [StorageDescriptor](#aws-glue-api-catalog-partitions-StorageDescriptor) オブジェクト。

  パーティションが格納されている物理的な場所に関する情報を提供します。
+ `Parameters` – キーバリューペアのマップ配列。

  各キーはキー文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  各値は UTF-8 文字列で、512,000 バイト長以下です。

  これらのキー/値ペアはパーティションパラメータを定義します。
+ `LastAnalyzedTime` – タイムスタンプ。

  このパーティションの列統計が最後に計算された時刻。
+ `CatalogId` – カタログ ID 文字列、1～255 バイト長、[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションがある Data Catalog の ID。

## PartitionInput の構造
<a name="aws-glue-api-catalog-partitions-PartitionInput"></a>

パーティションの作成と更新に使用される構造。

**フィールド**
+ `Values` – UTF-8 文字列の配列。

  パーティションの値。SDK ではこのパラメータは必要ありませんが、有効な入力としてこのパラメータを指定する必要があります。

  新しいパーティションのキーの値は、文字列オブジェクトの配列として渡す必要があります。この配列は、Amazon S3 プレフィックスに表示されるパーティションキーと同じ順序で順序付けする必要があります。そうしないと、AWS Glue では、間違ったキーに値が追加されます。
+ `LastAccessTime` – タイムスタンプ。

  パーティションが最後にアクセスされた時刻。
+ `StorageDescriptor` – [StorageDescriptor](#aws-glue-api-catalog-partitions-StorageDescriptor) オブジェクト。

  パーティションが格納されている物理的な場所に関する情報を提供します。
+ `Parameters` – キーバリューペアのマップ配列。

  各キーはキー文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  各値は UTF-8 文字列で、512,000 バイト長以下です。

  これらのキー/値ペアはパーティションパラメータを定義します。
+ `LastAnalyzedTime` – タイムスタンプ。

  このパーティションの列統計が最後に計算された時刻。

## PartitionSpecWithSharedStorageDescriptor 構造
<a name="aws-glue-api-catalog-partitions-PartitionSpecWithSharedStorageDescriptor"></a>

物理的な場所を共有するパーティションのパーティション仕様。

**フィールド**
+ `StorageDescriptor` – [StorageDescriptor](#aws-glue-api-catalog-partitions-StorageDescriptor) オブジェクト。

  共有物理ストレージ情報。
+ `Partitions` – [パーティション](#aws-glue-api-catalog-partitions-Partition) オブジェクトの配列。

  この物理的な場所を共有するパーティションのリスト。

## PartitionListComposingSpec 構造
<a name="aws-glue-api-catalog-partitions-PartitionListComposingSpec"></a>

関連するパーティションを一覧表示します。

**フィールド**
+ `Partitions` – [パーティション](#aws-glue-api-catalog-partitions-Partition) オブジェクトの配列。

  構成仕様のパーティションのリスト。

## PartitionSpecProxy 構造
<a name="aws-glue-api-catalog-partitions-PartitionSpecProxy"></a>

指定されたパーティションへのルートパスを提供します。

**フィールド**
+ `DatabaseName` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションが存在するカタログデータベース。
+ `TableName` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションを含むテーブルの名前。
+ `RootPath` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションをアドレス指定するためのプロキシのルートパス。
+ `PartitionSpecWithSharedSD` – [PartitionSpecWithSharedStorageDescriptor](#aws-glue-api-catalog-partitions-PartitionSpecWithSharedStorageDescriptor) オブジェクト。

  同じ物理ストレージの場所を共有するパーティションの仕様。
+ `PartitionListComposingSpec` – [PartitionListComposingSpec](#aws-glue-api-catalog-partitions-PartitionListComposingSpec) オブジェクト。

  パーティションのリストを指定します。

## PartitionValueList 構造
<a name="aws-glue-api-catalog-partitions-PartitionValueList"></a>

パーティションを定義する値のリストが含まれています。

**フィールド**
+ `Values` – *必須:* UTF-8 文字列の配列。

  値のリスト。

## セグメント構造
<a name="aws-glue-api-catalog-partitions-Segment"></a>

テーブルのパーティションの重複しないリージョンを定義し、複数のリクエストを並行して実行できるようにします。

**フィールド**
+ `SegmentNumber` – *必須:* 数値 (整数)。None 以下。

  セグメントのゼロベースのインデックス番号。たとえば、セグメントの合計数が 4 の場合、 `SegmentNumber` 値の範囲は 0～3 です。
+ `TotalSegments` – *必須:* 数値 (整数)。1 ～ 10。

  セグメントの合計数。

## PartitionError 構造
<a name="aws-glue-api-catalog-partitions-PartitionError"></a>

パーティションのエラーに関する情報が含まれます。

**フィールド**
+ `PartitionValues` – UTF-8 文字列の配列。

  パーティションを定義する値。
+ `ErrorDetail` – [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail) オブジェクト。

  パーティションエラーの詳細。

## BatchUpdatePartitionFailureEntry 構造
<a name="aws-glue-api-catalog-partitions-BatchUpdatePartitionFailureEntry"></a>

バッチ更新パーティションエラーに関する情報が含まれます。

**フィールド**
+ `PartitionValueList` - UTF-8 文字列の配列、文字列 100 個以下。

  パーティションを定義する値のリスト。
+ `ErrorDetail` – [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail) オブジェクト。

  バッチ更新パーティションエラーの詳細。

## BatchUpdatePartitionRequestEntry 構造
<a name="aws-glue-api-catalog-partitions-BatchUpdatePartitionRequestEntry"></a>

パーティションの更新に使用される値と構造体を含む構造体。

**フィールド**
+ `PartitionValueList` – *必須:* UTF-8 文字列の配列。文字列 100 個以下。

  パーティションを定義する値のリスト。
+ `PartitionInput` – *必須:* [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput) オブジェクト。

  パーティションの更新に使用される構造体。

## StorageDescriptor 構造
<a name="aws-glue-api-catalog-partitions-StorageDescriptor"></a>

テーブルデータの物理ストレージについて説明します。

**フィールド**
+ `Columns` – [Column](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-Column) オブジェクトの配列。

  テーブル内の `Columns` のリストです。
+ `Location` – 場所文字列。2,056 バイト長以下。[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri) に一致。

  テーブルの物理的な場所。デフォルトでは、ウェアハウスの場所、その後にウェアハウス内のデータベースの場所、その後にテーブル名が続く形式になります。
+ `AdditionalLocations` – UTF-8 文字列の配列。

  Delta テーブルへのパスを指す場所のリスト。
+ `InputFormat` – 書式設定文字列。128 バイト長以下。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  入力形式: `SequenceFileInputFormat` (バイナリ)、または `TextInputFormat`、もしくはカスタム形式。
+ `OutputFormat` – 書式設定文字列。128 バイト長以下。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  出力形式: `SequenceFileOutputFormat` (バイナリ)、または `IgnoreKeyTextOutputFormat`、もしくはカスタム形式。
+ `Compressed` – ブール。

  テーブルのデータが圧縮されている場合は `True`、圧縮されていない場合は `False`。
+ `NumberOfBuckets` – 数値 (整数)。

  テーブルにディメンション列が含まれている場合、指定する必要があります。
+ `SerdeInfo` – [SerDeInfo](#aws-glue-api-catalog-partitions-SerDeInfo) オブジェクト。

  シリアライズ/デシリアライズ (SerDe) 情報。
+ `BucketColumns` – UTF-8 文字列の配列。

  テーブルのリデューサーグループ化列、クラスター列、およびバケット列のリスト。
+ `SortColumns` – [注文](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-Order) オブジェクトの配列。

  テーブル内の各バケットのソート順を指定するリスト。
+ `Parameters` – キーバリューペアのマップ配列。

  各キーはキー文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  各値は UTF-8 文字列で、512,000 バイト長以下です。

  ユーザーが指定したキーバリュー形式のプロパティ。
+ `SkewedInfo` – [SkewedInfo](#aws-glue-api-catalog-partitions-SkewedInfo) オブジェクト。

  列に高い頻度で表示される値 (歪んだ値) に関する情報。
+ `StoredAsSubDirectories` – ブール。

  テーブルデータがサブディレクトリに保管されている場合は `True`、保管されていない場合は `False`。
+ `SchemaReference` – [SchemaReference](#aws-glue-api-catalog-partitions-SchemaReference) オブジェクト。

  AWS Glue スキーマレジストリに保存されているスキーマを参照するオブジェクト。

  テーブルを作成するときにスキーマに空の列リストを渡し、代わりにスキーマリファレンスを使用します。

## SchemaReference 構造
<a name="aws-glue-api-catalog-partitions-SchemaReference"></a>

AWS Glue スキーマレジストリに保存されているスキーマを参照するオブジェクト。

**フィールド**
+ `SchemaId` – [SchemaId](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-SchemaId) オブジェクト。

  スキーマアイデンティティフィールドを含む構造。こちらか `SchemaVersionId` のいずれかを指定する必要があります。
+ `SchemaVersionId` – UTF-8 文字列。36 バイト長。[Custom string pattern #45](aws-glue-api-common.md#regex_45) に一致。

  スキーマのバージョンに割り当てられた一意の ID。こちらか `SchemaId` のいずれかを指定する必要があります。
+ `SchemaVersionNumber` – 数値 (long)。1～100000。

  スキーマのバージョン番号。

## SerDeInfo 構造
<a name="aws-glue-api-catalog-partitions-SerDeInfo"></a>

エクストラクターおよびローダーとして機能するシリアライズ/デシリアライズプログラム (SerDe) に関する情報。

**フィールド**
+ `Name` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  SerDe 名。
+ `SerializationLibrary` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  通常、SerDe を実装するクラス。例は `org.apache.hadoop.hive.serde2.columnar.ColumnarSerDe` です。
+ `Parameters` – キーバリューペアのマップ配列。

  各キーはキー文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  各値は UTF-8 文字列で、512,000 バイト長以下です。

  これらのキーバリューペアは SerDe の初期化パラメータを定義します。

## SkewedInfo 構造
<a name="aws-glue-api-catalog-partitions-SkewedInfo"></a>

テーブルで歪んだ値を指定します。「歪んだ値」とは、非常に高い頻度で発生する値です。

**フィールド**
+ `SkewedColumnNames` – UTF-8 文字列の配列。

  歪んだ値を含む列名のリスト。
+ `SkewedColumnValues` – UTF-8 文字列の配列。

  頻繁に出現するため、歪んだとみなされる値のリスト。
+ `SkewedColumnValueLocationMaps` – キーバリューペアのマップ配列。

  各キーは UTF-8 文字列。

  各値は UTF-8 文字列。

  歪んだ値が含まれている列へのマッピング。

## 操作
<a name="aws-glue-api-catalog-partitions-actions"></a>
+ [CreatePartition アクション (Python: create\_partition)](#aws-glue-api-catalog-partitions-CreatePartition)
+ [BatchCreatePartition アクション (Python: batch\_create\_partition)](#aws-glue-api-catalog-partitions-BatchCreatePartition)
+ [UpdatePartition アクション (Python: update\_partition)](#aws-glue-api-catalog-partitions-UpdatePartition)
+ [DeletePartition アクション (Python: delete\_partition)](#aws-glue-api-catalog-partitions-DeletePartition)
+ [BatchDeletePartition アクション (Python: batch\_delete\_partition)](#aws-glue-api-catalog-partitions-BatchDeletePartition)
+ [GetPartition アクション (Python: get\_partition)](#aws-glue-api-catalog-partitions-GetPartition)
+ [GetPartitions アクション (Python: get\_partitions)](#aws-glue-api-catalog-partitions-GetPartitions)
+ [BatchGetPartition アクション (Python: batch\_get\_partition)](#aws-glue-api-catalog-partitions-BatchGetPartition)
+ [BatchUpdatePartition アクション (Python: batch\_update\_partition)](#aws-glue-api-catalog-partitions-BatchUpdatePartition)
+ [GetColumnStatisticsForPartition アクション (Python: get\_column\_statistics\_for\_partition)](#aws-glue-api-catalog-partitions-GetColumnStatisticsForPartition)
+ [UpdateColumnStatisticsForPartition アクション (Python: update\_column\_statistics\_for\_partition)](#aws-glue-api-catalog-partitions-UpdateColumnStatisticsForPartition)
+ [DeleteColumnStatisticsForPartition アクション (Python: delete\_column\_statistics\_for\_partition)](#aws-glue-api-catalog-partitions-DeleteColumnStatisticsForPartition)

## CreatePartition アクション (Python: create\_partition)
<a name="aws-glue-api-catalog-partitions-CreatePartition"></a>

新しいパーティションを作成します。

**リクエスト**
+ `CatalogId` – カタログ ID 文字列、1～255 バイト長、「[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)」に一致。

  パーティションを作成するカタログの AWS アカウント ID。
+ `DatabaseName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションが作成されるメタデータデータベースの名前。
+ `TableName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションが作成されるメタデータテーブルの名前。
+ `PartitionInput` – *必須:* [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput) オブジェクト。

  作成されるパーティションを定義する `PartitionInput` 構造。

**応答**
+ *応答パラメータはありません。*

**エラー**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## BatchCreatePartition アクション (Python: batch\_create\_partition)
<a name="aws-glue-api-catalog-partitions-BatchCreatePartition"></a>

バッチオペレーションで 1 つ以上のパーティションを作成します。

**リクエスト**
+ `CatalogId` – カタログ ID 文字列、1～255 バイト長、「[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)」に一致。

  パーティションを作成するカタログの ID。現在、これは AWS アカウント ID である必要があります。
+ `DatabaseName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションが作成されるメタデータデータベースの名前。
+ `TableName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションが作成されるメタデータテーブルの名前。
+ `PartitionInputList` – *必須:* [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput) オブジェクトの配列。構造 100 個以下。

  作成されるパーティションを定義する `PartitionInput` 構造のリスト。

**応答**
+ `Errors` – [PartitionError](#aws-glue-api-catalog-partitions-PartitionError) オブジェクトの配列。

  リクエストされたパーティションを作成しようとしたときにエラーが発生しました。

**エラー**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## UpdatePartition アクション (Python: update\_partition)
<a name="aws-glue-api-catalog-partitions-UpdatePartition"></a>

パーティションを更新します。

**リクエスト**
+ `CatalogId` – カタログ ID 文字列、1～255 バイト長、「[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)」に一致。

  更新されるパーティションが存在するデータカタログの ID。設定しない場合は、AWS アカウント ID がデフォルトで使用されます。
+ `DatabaseName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  該当する表が存在するカタログデータベースの名前。
+ `TableName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  更新するパーティションが存在するテーブルの名前。
+ `PartitionValueList` – *必須:* UTF-8 文字列の配列。文字列 100 個以下。

  更新するパーティションを定義するパーティションキー値のリスト。
+ `PartitionInput` – *必須:* [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput) オブジェクト。

  パーティションを更新する新しいパーティションオブジェクト。

  `Values` プロパティは変更できません。パーティションのパーティションキー値を変更する場合は、パーティションを削除して再作成します。

**応答**
+ *応答パラメータはありません。*

**エラー**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## DeletePartition アクション (Python: delete\_partition)
<a name="aws-glue-api-catalog-partitions-DeletePartition"></a>

指定したパーティションを削除します。

**リクエスト**
+ `CatalogId` – カタログ ID 文字列、1～255 バイト長、「[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)」に一致。

  削除されるパーティションが存在するデータカタログの ID。設定しない場合は、AWS アカウント ID がデフォルトで使用されます。
+ `DatabaseName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  該当する表が存在するカタログデータベースの名前。
+ `TableName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  削除するパーティションを含むテーブルの名前。
+ `PartitionValues` – *必須:* UTF-8 文字列の配列。

  パーティションを定義する値。

**応答**
+ *応答パラメータはありません。*

**エラー**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## BatchDeletePartition アクション (Python: batch\_delete\_partition)
<a name="aws-glue-api-catalog-partitions-BatchDeletePartition"></a>

バッチオペレーションで 1 つ以上のパーティションを削除します。

**リクエスト**
+ `CatalogId` – カタログ ID 文字列、1～255 バイト長、「[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)」に一致。

  削除されるパーティションが存在するデータカタログの ID。設定しない場合は、AWS アカウント ID がデフォルトで使用されます。
+ `DatabaseName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  該当する表が存在するカタログデータベースの名前。
+ `TableName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  削除するパーティションを含むテーブルの名前。
+ `PartitionsToDelete` – *必須:* [PartitionValueList](#aws-glue-api-catalog-partitions-PartitionValueList) オブジェクトの配列。構造 25 個以下。

  削除されるパーティションを定義する `PartitionInput` 構造のリスト。

**応答**
+ `Errors` – [PartitionError](#aws-glue-api-catalog-partitions-PartitionError) オブジェクトの配列。

  リクエストされたパーティションを削除しようとしたときにエラーが発生しました。

**エラー**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetPartition アクション (Python: get\_partition)
<a name="aws-glue-api-catalog-partitions-GetPartition"></a>

指定したパーティションに関する情報を取得します。

**リクエスト**
+ `CatalogId` – カタログ ID 文字列、1～255 バイト長、「[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)」に一致。

  対象のパーティションが存在する Data Catalog の ID。設定しない場合は、AWS アカウント ID がデフォルトで使用されます。
+ `DatabaseName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションが存在するカタログデータベースの名前。
+ `TableName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションのテーブルの名前。
+ `PartitionValues` – *必須:* UTF-8 文字列の配列。

  パーティションを定義する値。

**応答**
+ `Partition` – [パーティション](#aws-glue-api-catalog-partitions-Partition) オブジェクト。

  `Partition` オブジェクトの形式で、リクエストされた情報。

**エラー**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## GetPartitions アクション (Python: get\_partitions)
<a name="aws-glue-api-catalog-partitions-GetPartitions"></a>

テーブルのパーティションについての情報を取得します。

**リクエスト**
+ `CatalogId` – カタログ ID 文字列、1～255 バイト長、「[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)」に一致。

  該当するパーティションが存在するデータカタログの ID。設定しない場合は、AWS アカウント ID がデフォルトで使用されます。
+ `DatabaseName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションが存在するカタログデータベースの名前。
+ `TableName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションのテーブルの名前。
+ `Expression` – 述語文字列、2048 バイト長以下、[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri) に一致。

  返されるパーティションをフィルタリングする式。

  この式では、SQL `WHERE` フィルタ句と似た SQL 構文を使用します。SQL ステートメントパーサー [JSQLParser](http://jsqlparser.sourceforge.net/home.php) が式を解析します。

  *演算子*: `Expression` API 呼び出しで使用できる演算子を以下に示します。  
=  
2 つのオペランドの値が等しいかどうかを確認します。「はい」の場合、条件は true です。  
例: 「変数 a」が 10、「変数 b」が 20 とします。  
(a = b) は true ではありません。  
< >  
2 つのオペランドの値が等しいかどうかを確認します。値が等しくない場合、条件は true です。  
例: (a < > b) は true です。  
>  
左のオペランドの値が右のオペランドの値よりも大きいかどうかを確認します。「はい」の場合、条件は true です。  
例: (a > b) は true ではありません。  
<  
左のオペランドの値が右のオペランドの値よりも小さいかどうかを確認します。「はい」の場合、条件は true です。  
例: (a < b) は true です。  
>=  
左のオペランドの値が右のオペランドの値以上かどうかを確認します。「はい」の場合、条件は true です。  
例: (a >= b) は true ではありません。  
<=  
左のオペランドの値が右のオペランドの値以下かどうかを確認します。「はい」の場合、条件は true です。  
例: (a <= b) は true です。  
AND、OR、IN、BETWEEN、LIKE、NOT、IS NULL  
論理演算子。

  *サポートされているパーティションキーの型*: サポートされているパーティションキーを以下に示します。
  + `string`
  + `date`
  + `timestamp`
  + `int`
  + `bigint`
  + `long`
  + `tinyint`
  + `smallint`
  + `decimal`

  無効なタイプが存在した場合は、例外が発生します。

  各タイプの有効な演算子のリストを次に示します。クローラを定義する場合、`partitionKey` タイプはカタログパーティションとの互換性を確保するため `STRING` として作成されます。

  *サンプル API コール*:   
**Example**  

  このテーブル `twitter_partition` には 3 つのパーティションがあります。

  ```
  year = 2015
          year = 2016
          year = 2017
  ```  
**Example**  

  パーティション `year` を 2015 と等しくする

  ```
  aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year*=*'2015'"
  ```  
**Example**  

  パーティション `year` を 2016-2018 (これらの値を含まない) にする

  ```
  aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year>'2016' AND year<'2018'"
  ```  
**Example**  

  パーティション `year` を 2015-2018 (これらの値を含む) にする 次の API コールは、相互に等しくなります。

  ```
  aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year>='2015' AND year<='2018'"
          
          aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year BETWEEN 2015 AND 2018"
          
          aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year IN (2015,2016,2017,2018)"
  ```  
**Example**  

  ワイルドカードパーティションフィルタ。次のコール出力がパーティション year=2017 になります。正規表現は `LIKE` ではサポートされません。

  ```
  aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year LIKE '%7'"
  ```
+ `NextToken` – UTF–8 文字列。

  これらのパーティションを取得する最初の呼び出しでない場合は、継続トークン。
+ `Segment` – [Segment](#aws-glue-api-catalog-partitions-Segment) オブジェクト。

  このリクエストでスキャンするテーブルのパーティションのセグメント。
+ `MaxResults` – 1～1000 の数値 (整数)。

  1 回の応答で返されるパーティションの最大数。
+ `ExcludeColumnSchema` – ブール。

  true の場合、パーティション列スキーマを返さないことを指定します。パーティション値や場所など、他のパーティション属性にのみ関心がある場合に便利です。この方法では、重複データを返さないことで、大きな応答の問題を回避できます。
+ `TransactionId` – UTF-8 文字列。1～255 バイト長。[Custom string pattern #44](aws-glue-api-common.md#regex_44) に一致。

  テーブルの内容を更新するトランザクション ID。
+ `QueryAsOfTime` – タイムスタンプ。

  パーティションの内容を読み取る時点の時間。設定されていない場合は、最新のトランザクションコミット時間が使用されます。`TransactionId` と一緒に指定することはできません。

**応答**
+ `Partitions` – [パーティション](#aws-glue-api-catalog-partitions-Partition) オブジェクトの配列。

  リクエストされたパーティションのリスト。
+ `NextToken` – UTF–8 文字列。

  継続トークン (戻されたパーティションのリストに最後のパーティションが含まれていない場合)。

**エラー**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `GlueEncryptionException`
+ `InvalidStateException`
+ `ResourceNotReadyException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## BatchGetPartition アクション (Python: batch\_get\_partition)
<a name="aws-glue-api-catalog-partitions-BatchGetPartition"></a>

バッチリクエストのパーティションを取得します。

**リクエスト**
+ `CatalogId` – カタログ ID 文字列、1～255 バイト長、「[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)」に一致。

  該当するパーティションが存在するデータカタログの ID。提供されない場合は、AWS アカウント ID がデフォルトで使用されます。
+ `DatabaseName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションが存在するカタログデータベースの名前。
+ `TableName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションのテーブルの名前。
+ `PartitionsToGet` – *必須:* [PartitionValueList](#aws-glue-api-catalog-partitions-PartitionValueList) オブジェクトの配列。構造 1000 個以下。

  取得するパーティションを識別するパーティション値のリスト。

**応答**
+ `Partitions` – [パーティション](#aws-glue-api-catalog-partitions-Partition) オブジェクトの配列。

  リクエストされたパーティションのリスト。
+ `UnprocessedKeys` – [PartitionValueList](#aws-glue-api-catalog-partitions-PartitionValueList) オブジェクトの配列。構造 1000 個以下。

  パーティションが返されなかったリクエスト内のパーティション値のリスト。

**エラー**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `GlueEncryptionException`
+ `InvalidStateException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## BatchUpdatePartition アクション (Python: batch\_update\_partition)
<a name="aws-glue-api-catalog-partitions-BatchUpdatePartition"></a>

バッチ操作で 1 つ以上のパーティションを更新します。

**リクエスト**
+ `CatalogId` – カタログ ID 文字列、1～255 バイト長、「[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)」に一致。

  パーティションを更新するカタログの ID。現在、これは AWS アカウント ID である必要があります。
+ `DatabaseName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションが更新されるメタデータデータベースの名前。
+ `TableName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションが更新されるメタデータテーブルの名前。
+ `Entries` – *必須:* [BatchUpdatePartitionRequestEntry](#aws-glue-api-catalog-partitions-BatchUpdatePartitionRequestEntry) オブジェクトの配列。1～100 個の構造。

  更新する最大 100 個の `BatchUpdatePartitionRequestEntry` オブジェクトのリスト。

**応答**
+ `Errors` – [BatchUpdatePartitionFailureEntry](#aws-glue-api-catalog-partitions-BatchUpdatePartitionFailureEntry) オブジェクトの配列。

  リクエストされたパーティションを更新しようとしたときにエラーが発生しました。`BatchUpdatePartitionFailureEntry` オブジェクトのリスト。

**エラー**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `GlueEncryptionException`

## GetColumnStatisticsForPartition アクション (Python: get\_column\_statistics\_for\_partition)
<a name="aws-glue-api-catalog-partitions-GetColumnStatisticsForPartition"></a>

列のパーティション統計を取得します。

このオペレーションに必要な Identity and Access Management (IAM) アクセス許可は `GetPartition` です。

**リクエスト**
+ `CatalogId` – カタログ ID 文字列、1～255 バイト長、「[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)」に一致。

  該当するパーティションが存在するデータカタログの ID。提供されない場合は、AWS アカウント ID がデフォルトで使用されます。
+ `DatabaseName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションが存在するカタログデータベースの名前。
+ `TableName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションのテーブルの名前。
+ `PartitionValues` – *必須:* UTF-8 文字列の配列。

  パーティションを識別するパーティション値のリスト。
+ `ColumnNames` – *必須:* UTF-8 文字列の配列。文字列 100 個以下。

  列名のリスト。

**応答**
+ `ColumnStatisticsList` – [ColumnStatistics](aws-glue-api-common.md#aws-glue-api-common-ColumnStatistics) オブジェクトの配列。

  取得に失敗した ColumnStatistics のリスト。
+ `Errors` – [ColumnError](aws-glue-api-common.md#aws-glue-api-common-ColumnError) オブジェクトの配列。

  列の統計データの取得中にエラーが発生しました。

**エラー**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## UpdateColumnStatisticsForPartition アクション (Python: update\_column\_statistics\_for\_partition)
<a name="aws-glue-api-catalog-partitions-UpdateColumnStatisticsForPartition"></a>

カラムのパーティション統計を作成または更新します。

このオペレーションに必要な Identity and Access Management (IAM) アクセス許可は `UpdatePartition` です。

**リクエスト**
+ `CatalogId` – カタログ ID 文字列、1～255 バイト長、「[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)」に一致。

  該当するパーティションが存在するデータカタログの ID。提供されない場合は、AWS アカウント ID がデフォルトで使用されます。
+ `DatabaseName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションが存在するカタログデータベースの名前。
+ `TableName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションのテーブルの名前。
+ `PartitionValues` – *必須:* UTF-8 文字列の配列。

  パーティションを識別するパーティション値のリスト。
+ `ColumnStatisticsList` – *必須:* [ColumnStatistics](aws-glue-api-common.md#aws-glue-api-common-ColumnStatistics) オブジェクトの配列。構造 25 個以下。

  列の統計のリスト。

**応答**
+ `Errors` – [ColumnStatisticsError](aws-glue-api-common.md#aws-glue-api-common-ColumnStatisticsError) オブジェクトの配列。

  列の統計データの更新中にエラーが発生しました。

**エラー**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## DeleteColumnStatisticsForPartition アクション (Python: delete\_column\_statistics\_for\_partition)
<a name="aws-glue-api-catalog-partitions-DeleteColumnStatisticsForPartition"></a>

列のパーティション列統計を削除します。

このオペレーションに必要な Identity and Access Management (IAM) アクセス許可は `DeletePartition` です。

**リクエスト**
+ `CatalogId` – カタログ ID 文字列、1～255 バイト長、「[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)」に一致。

  該当するパーティションが存在するデータカタログの ID。提供されない場合は、AWS アカウント ID がデフォルトで使用されます。
+ `DatabaseName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションが存在するカタログデータベースの名前。
+ `TableName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  パーティションのテーブルの名前。
+ `PartitionValues` – *必須:* UTF-8 文字列の配列。

  パーティションを識別するパーティション値のリスト。
+ `ColumnName` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  列の名前。

**応答**
+ *応答パラメータはありません。*

**エラー**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`