パーティション分割テーブルの管理

このドキュメントでは、BigQuery でパーティション分割テーブルを管理する方法について説明します。取り込み時間パーティション分割テーブルとパーティション分割テーブルはどちらも同じ方法で管理されます。パーティション分割テーブルでは、以下の管理タスクを実行できます。

時間パーティション分割テーブルに関する以下の情報を更新する
- 説明
- テーブルの有効期限
- パーティションの有効期限
- パーティションフィルタの要件
- スキーマ定義
- ラベル
時間分割テーブルの名前を変更する（テーブルをコピーする）
時間パーティション分割テーブルをコピーする
パーティションをコピーする
時間パーティション分割テーブルを削除する
時間パーティション分割テーブルのパーティションを削除する

パーティションメタデータの取得

パーティション分割テーブルに関する情報を取得するには、次の方法があります。

INFORMATION_SCHEMA.PARTITIONS ビューを使用する（プレビュー）。
__PARTITIONS_SUMMARY__ メタテーブルを使用する（レガシー SQL のみ）。

`INFORMATION_SCHEMA` ビューを使用したパーティションメタデータの取得

INFORMATION_SCHEMA.PARTITIONS ビューにクエリを実行すると、クエリ結果にはパーティションごとに 1 行が含まれます。たとえば、次のクエリでは、mydataset という名前のデータセット内のすべてのテーブルパーティションが一覧表示されます。

SELECT table_name, partition_id, total_rows
FROM `mydataset.INFORMATION_SCHEMA.PARTITIONS`
WHERE partition_id IS NOT NULL

詳細については、INFORMATION_SCHEMA.PARTITIONS をご覧ください。

メタテーブルを使用したパーティションメタデータの取得

レガシー SQL では、__PARTITIONS_SUMMARY__ メタテーブルにクエリを実行して、テーブルパーティションに関するメタデータを取得できます。メタテーブルは、メタデータを含む読み取り専用テーブルです。

次のように __PARTITIONS_SUMMARY__ メタテーブルにクエリを実行します。

#legacySQL
SELECT
  column
FROM
  [dataset.table$__PARTITIONS_SUMMARY__]

__PARTITIONS_SUMMARY__ メタテーブルには次の列があります。

値	説明
`project_id`	プロジェクトの名前。
`dataset_id`	データセットの名前。
`table_id`	時間パーティション分割テーブルの名前。
`partition_id`	パーティションの名前（日付）。
`creation_time`	パーティションが作成された日時（UTC 1970 年 1 月 1 日からのミリ秒数）。
`last_modified_time`	パーティションが最後に変更された日時（1970 年 1 月 1 日 UTC からの経過ミリ秒数）。

__PARTITIONS_SUMMARY__ メタテーブルを使用するクエリジョブを実行するには、少なくとも bigquery.jobs.create 権限と bigquery.tables.getData 権限が付与されている必要があります。

BigQuery での IAM ロールの詳細については、アクセス制御をご覧ください。

パーティション分割テーブルのプロパティの更新

分割テーブルの以下の情報を更新できます。

説明
テーブルの有効期限
パーティションの有効期限
スキーマ定義
ラベル

必要な権限

テーブルプロパティを更新するユーザーには、少なくとも bigquery.tables.update 権限と bigquery.tables.get 権限が付与されている必要があります。次の IAM 事前定義ロールには bigquery.tables.update 権限と bigquery.tables.get 権限が含まれています。

bigquery.dataEditor
bigquery.dataOwner
bigquery.admin

また、bigquery.datasets.create 権限を持つユーザーがデータセットを作成すると、そのデータセットに対する bigquery.dataOwner アクセス権がユーザーに付与されます。bigquery.dataOwner アクセス権により、そのデータセットに含まれるテーブルのプロパティの更新が許可されます。

BigQuery での IAM のロールと権限については、事前定義ロールと権限をご覧ください。

パーティション分割テーブルの説明の更新

分割テーブルの説明を更新するプロセスは、標準テーブルの説明を更新するプロセスと同じです。テーブルの説明を追加または変更する方法については、テーブルの説明の更新をご覧ください。

現時点では、個々のパーティションごとに説明を作成することはできません。

テーブルの有効期限の更新

分割テーブルの有効期限を更新するプロセスは、標準テーブルの有効期限を更新するプロセスと同じです。テーブルの有効期限を追加または変更する方法については、テーブルの有効期限の更新をご覧ください。

パーティションの有効期限の更新

取り込み時間、または日付 / タイムスタンプ列でパーティション分割されたテーブルを作成する際に、パーティションの有効期限を指定できます。この設定では、BigQuery が各パーティションにデータを保持する期間を指定します。この設定は、テーブル内のすべてのパーティションに適用されます。パーティションが期限切れになると、BigQuery はそのパーティションのデータを削除します。

パーティションの有効期限はパーティションの境界（UTC）から計算されます。たとえば、日単位パーティショニングでは、パーティションの境界は午前 0 時（00:00:00 UTC）です。テーブルのパーティション有効期限が 6 時間の場合、各パーティションは翌日の 06:00:00 UTC に期限切れになります。

データセットレベルでデフォルトのパーティション有効期限を指定することもできます。テーブルにパーティションの有効期限を設定すると、その値によってデフォルトのパーティション有効期限がオーバーライドされます。（テーブルまたはデータセットで）パーティションの有効期限を指定しない場合、パーティションは期限切れになりません。

テーブルの有効期限を設定した場合、その値はパーティションの有効期限よりも優先されます。たとえば、テーブルの有効期限が 5 日間、パーティションの有効期限が 7 日間に設定されている場合、テーブルとテーブル内のすべてのパーティションは 5 日後に削除されます。

テーブルが作成された後はいつでも、テーブルのパーティションの有効期限を更新できます。新しい設定は、パーティションがいつ作成されたかにかかわらず、そのテーブル内のすべてのパーティションに適用されます。既存のパーティションは、新しい有効期限よりも古いとすぐに期限切れになります。

パーティションが期限切れになると、そのパーティション内のデータはクエリで使用できなくなり、そのパーティションのストレージに対しては課金されません。期限切れのパーティションは最終的に BigQuery によって削除されます。それまでは、パーティションはテーブル割り当ての計算対象になります。パーティションを直ちに削除するには、パーティションを手動で削除します。

2016 年 12 月 13 日より前に作成されたプロジェクトの場合、パーティションの有効期限はパーティションの最終更新日によって決まります。この規則は、既存のテーブルとプロジェクトで作成された新しいテーブルの両方に適用されます。プロジェクトを新しい規則に移行するには、BigQuery Issue Tracker でリクエストを送信してください。

パーティション分割テーブルのパーティションの有効期限を更新する手順は以下のとおりです。

Console

Cloud Console でパーティションの有効期限を更新することはできません。

SQL

データ定義言語（DDL）ステートメントを使用すると、標準 SQL クエリ構文を使用してテーブルとビューの作成と変更ができます。

データ定義言語ステートメントの使用をご覧ください。

DDL ステートメントを使用してパーティション分割テーブルのパーティションの有効期限を更新するには:

Cloud Console で、[BigQuery] ページを開きます。

[BigQuery] に移動
[クエリを新規作成] をクリックします。

[クエリエディタ] テキスト領域に DDL ステートメントを入力します。

 ALTER TABLE mydataset.mytable
 SET OPTIONS (
   -- Sets partition expiration to 5 days
   partition_expiration_days=5
 )

[実行] をクリックします。

bq

--time_partitioning_expiration フラグを指定して bq update コマンドを発行します。更新するパーティション分割テーブルがデフォルトプロジェクト以外のプロジェクトにある場合は、project_id:dataset の形式でプロジェクト ID をデータセット名に追加します。

bq update \
--time_partitioning_expiration integer \
--time_partitioning_type unit_time \
project_id:dataset.table

ここで

integer は、テーブルのパーティションのデフォルトの存続期間（秒）です。最小値はありません。パーティションの日付にこの整数値を足した値が有効期限になります。0 を指定すると、パーティションの有効期限は削除され、パーティションは無期限に有効になります。有効期限のないパーティションは手動で削除する必要があります。
unit_time は、テーブルのパーティショニングの粒度に応じて、DAY、HOUR、MONTH、YEAR のいずれかになります。この値は、テーブルの作成時に設定した粒度と一致している必要があります。
project_id はプロジェクト ID です。
dataset は、更新しているテーブルを含むデータセットの名前です。
table は更新するテーブルの名前です。

例:

次のコマンドを入力して、mydataset.mytable のパーティションの有効期限を 5 日間（432,000 秒）に更新します。mydataset はデフォルトプロジェクトにあります。

bq update --time_partitioning_expiration 432000 mydataset.mytable

次のコマンドを入力して、mydataset.mytable のパーティションの有効期限を 5 日間（432,000 秒）に更新します。mydataset はデフォルトプロジェクトではなく myotherproject にあります。

bq update \
--time_partitioning_expiration 432000 \
myotherproject:mydataset.mytable

API

tables.patch メソッドを呼び出し、timePartitioning.expirationMs プロパティを使用してパーティションの有効期限をミリ秒単位で更新します。tables.update メソッドはテーブルリソース全体を置き換えるため、tables.patch メソッドのほうが適切です。

パーティションフィルタ要件の更新

パーティション分割テーブルを作成するときに、[パーティションフィルタを要求] オプションを有効にすると、述語フィルタの使用を要求できます。このオプションを適用した場合、WHERE 句を指定しないでパーティション分割テーブルにクエリを実行すると、次のエラーが発生します。 Cannot query over table 'project_id.dataset.table' without a filter that can be used for partition elimination。

パーティション分割テーブルを作成するときに [パーティションフィルタを要求] オプションを追加する方法については、パーティション分割テーブルの作成をご覧ください。

パーティション分割テーブルを作成するときに [パーティションフィルタを要求] オプションを有効にしない場合でも、テーブルを更新してオプションを追加できます。

[パーティションフィルタを要求] オプションの更新

パーティションを除外する WHERE 句を含むクエリを要求するようにパーティション分割テーブルを更新するには:

Console

パーティション分割テーブルの作成後に、Cloud Console でパーティションフィルタを要求することはできません。

bq

bq コマンドラインツールを使用してパーティションフィルタを要求するようにパーティション分割テーブルを更新するには、bq update コマンドを入力して、--require_partition_filter フラグを指定します。

デフォルトプロジェクト以外のプロジェクトにあるパーティション分割テーブルを更新するには、project_id:dataset の形式でプロジェクト ID をデータセットに追加します。

例:

デフォルトプロジェクトで mydataset の mypartitionedtable を更新するには、次のように入力します。

bq update --require_partition_filter mydataset.mytable

myotherproject で mydataset の mypartitionedtable を更新するには、次のように入力します。

bq update --require_partition_filter myotherproject:mydataset.mytable

API

tables.patch メソッドを呼び出して、requirePartitionFilter プロパティを true に設定すると、パーティションフィルタが要求されます。tables.update メソッドはテーブルリソース全体を置き換えるため、tables.patch メソッドのほうが適切です。

Java

このサンプルを試す前に、BigQuery クイックスタート: クライアントライブラリの使用の Java の設定手順を実施してください。詳細については、BigQuery Java API のリファレンスドキュメントをご覧ください。

GitHub で表示フィードバック

import com.google.cloud.bigquery.BigQuery;
import com.google.cloud.bigquery.BigQueryException;
import com.google.cloud.bigquery.BigQueryOptions;
import com.google.cloud.bigquery.Table;

// Sample to update require partition filter on a table.
public class UpdateTableRequirePartitionFilter {

  public static void runUpdateTableRequirePartitionFilter() {
    // TODO(developer): Replace these variables before running the sample.
    String datasetName = "MY_DATASET_NAME";
    String tableName = "MY_TABLE_NAME";
    updateTableRequirePartitionFilter(datasetName, tableName);
  }

  public static void updateTableRequirePartitionFilter(String datasetName, String tableName) {
    try {
      // Initialize client that will be used to send requests. This client only needs to be created
      // once, and can be reused for multiple requests.
      BigQuery bigquery = BigQueryOptions.getDefaultInstance().getService();

      Table table = bigquery.getTable(datasetName, tableName);
      table.toBuilder().setRequirePartitionFilter(true).build().update();

      System.out.println("Table require partition filter updated successfully");
    } catch (BigQueryException e) {
      System.out.println("Table require partition filter was not updated \n" + e.toString());
    }
  }
}

スキーマ定義の更新

パーティション分割テーブルのスキーマ定義を更新するプロセスは、標準テーブルのスキーマ定義を更新するプロセスと同じです。詳細については、テーブルスキーマの変更をご覧ください。

パーティション分割テーブルの名前の変更

現時点では、既存のパーティション分割テーブルの名前を変更することはできません。テーブル名を変更する場合は、テーブルをコピーする手順に従います。コピーオペレーションでコピー先のテーブルを指定する場合は、新しいテーブル名を使用します。

パーティション分割テーブルのコピー

単一のパーティション分割テーブルのコピー

単一の分割テーブルをコピーするプロセスは、単一の標準テーブルをコピーするプロセスと同じです。詳細については、テーブルのコピーをご覧ください。

分割テーブルをコピーする際は、以下の点に注意してください。

コピー元テーブルとコピー先テーブルは、同じロケーションにあるデータセット内に存在する必要があります。
パーティション分割テーブルを新しいパーティション分割テーブルにコピーする場合

時間パーティション分割テーブルを新しいテーブルにコピーした場合、すべてのパーティショニング情報がテーブルとともにコピーされます。新しいテーブルに設定されるパーティションは古いテーブルと同じです。
パーティション分割されていないテーブルをパーティション分割テーブルにコピーする場合
パーティション分割されていないテーブルをパーティション分割テーブルにコピーした場合、コピー元のデータは現在の日付に対応するパーティションにコピーされます。
パーティション分割テーブルを別のパーティション分割テーブルにコピーする場合

パーティション分割テーブルを別のパーティション分割テーブルにコピーするには、コピー元テーブルとコピー先テーブルのパーティションの設定が一致している必要があります。コピー先テーブルにデータを追加するか、コピー先テーブルを上書きするかを指定できます。
パーティション分割テーブルを分割されていないテーブルにコピーする場合

パーティション分割テーブルをパーティション分割されていないテーブルにコピーした場合、コピー先テーブルは分割されません。設定に応じて、パーティション分割されていないテーブルにデータが追加されるか、パーティション分割されていないテーブルが上書きされます。

複数のパーティション分割テーブルのコピー

複数の分割テーブルをコピーするプロセスは、複数の標準テーブルをコピーするプロセスと同じです。詳細については、複数のテーブルのコピーをご覧ください。

複数の分割テーブルをコピーする際は、以下の点に注意してください。

同じジョブで複数のテーブルを分割テーブルにコピーする場合、コピー元に分割テーブルと分割されていないテーブルが混在していてはなりません。
コピー元のテーブルがすべてパーティション分割テーブルの場合、すべてのコピー元テーブルのパーティションの設定がコピー先テーブルのパーティションの設定と一致している必要があります。コピー先テーブルにデータが追加されるか、コピー先テーブルが上書きされるかは、設定によって決まります。
コピー元テーブルとコピー先テーブルは、同じロケーションにあるデータセット内に存在する必要があります。

パーティションのコピー

次の方法で 1 つ以上のパーティションをコピーできます。

bq コマンドラインツールの bq cp コマンドを使用する
jobs.insert API メソッドを呼び出して copy ジョブを構成する
クライアントライブラリの使用

現在、Cloud Console では、パーティションのコピーはサポート対象外です。

必要な権限

テーブルとパーティションをコピーするユーザーには、少なくとも以下の権限が付与されている必要があります。

コピー元データセットに対して:

bigquery.tables.get
bigquery.tables.getData

コピー先データセットに対して:

bigquery.tables.create でコピー先データセット内のテーブルまたはパーティションのコピーを作成する

bigquery.tables.create 権限、bigquery.tables.get 権限、bigquery.tables.getData 権限は、以下の IAM 事前定義ロールに含まれています。

bigquery.dataEditor
bigquery.dataOwner
bigquery.admin

また、コピージョブを実行するには、bigquery.jobs.create 権限が付与されている必要があります。

次の事前定義された IAM ロールには bigquery.jobs.create 権限が含まれています。

bigquery.user
bigquery.jobUser
bigquery.admin

また、bigquery.datasets.create 権限を持つユーザーがデータセットを作成すると、そのデータセットに対する bigquery.dataOwner アクセス権がユーザーに付与されます。bigquery.dataOwner アクセス権により、ユーザーはデータセット内のテーブルとパーティションをコピーできますが、コピー先データセットについては、同じユーザーが作成した場合を除き、アクセス権を明示的に指定する必要があります。

BigQuery での IAM のロールと権限については、事前定義ロールと権限をご覧ください。

単一のパーティションのコピー

Console

Cloud Console では、パーティションのコピーはサポート対象外です。

bq

パーティションをコピーするには、bq コマンドラインツールの bq cp（コピー）コマンドに $20160201 などのパーティションデコレータ（$date）を指定して使用します。

オプションのフラグを使用して、コピー先パーティションの書き込み処理を制御できます。

-a または --append_table を指定すると、コピー元パーティションのデータがコピー先データセット内の既存のテーブルまたはパーティションに追加されます。
-f または --force を指定すると、コピー先データセット内の既存のテーブルまたはパーティションが上書きされますが、確認を求めるプロンプトは表示されません。
-n または --no_clobber を指定すると、コピー先データセット内にテーブルまたはパーティションが存在する場合、「Table '<var>project_id:dataset.table</var> or <var>table$date</var>' already exists, skipping.」というエラーメッセージが返されます。-n が指定されていない場合は、デフォルトの動作として、コピー先のテーブルやパーティションを置き換えるかどうかの選択を求めるプロンプトが表示されます。
--destination_kms_key は顧客管理の Cloud KMS 鍵で、コピー先テーブルまたはパーティションを暗号化するために使用します。

cp コマンドは --time_partitioning_field フラグや --time_partitioning_type フラグをサポートしません。コピージョブを使用して取り込み時間パーティション分割テーブルをパーティション分割テーブルに変換することはできません。

--destination_kms_key はここでは説明しません。詳細については、Cloud KMS 鍵によるデータの保護をご覧ください。

コピー元またはコピー先のデータセットがデフォルト以外のプロジェクトにある場合は、project_id:dataset の形式でプロジェクト ID をデータセット名に追加します。

（省略可）--location フラグを指定して、その値をロケーションに設定します。

bq --location=location cp \
-a -f -n \
project_id:dataset.source_table$source_partition \
project_id:dataset.destination_table$destination_partition

ここで

location はロケーションの名前です。--location フラグは省略可能です。たとえば、BigQuery を東京リージョンで使用している場合は、このフラグの値を asia-northeast1 に設定します。.bigqueryrc ファイルを使用してロケーションのデフォルト値を設定できます。
project_id はプロジェクト ID です。
dataset は、コピー元またはコピー先データセットの名前です。
source_table は、コピーするテーブルです。
source_partition は、コピー元パーティションのパーティションデコレータです。
destination_table は、コピー先データセット内のテーブルの名前です。
destination_partition は、コピー先パーティションのパーティションデコレータです。

例:

パーティションを新しいテーブルにコピーする

次のコマンドを入力して mydataset.mytable にある 2018 年 1 月 30 日のパーティションを別のテーブル（mydataset.mytable2）にコピーします。mydataset はデフォルトプロジェクトにあります。

bq cp -a 'mydataset.mytable$20180130' mydataset.mytable2

パーティションをパーティション分割されていないテーブルにコピーする

次のコマンドを入力して mydataset.mytable にある 2018 年 1 月 30 日のパーティションをパーティション分割されていないテーブル（mydataset2.mytable2）にコピーします。-a ショートカットが指定されているため、パーティションのデータはパーティション分割されていないコピー先テーブルに追加されます。データセットは両方ともデフォルトプロジェクトにあります。

bq cp -a 'mydataset.mytable$20180130' mydataset2.mytable2

次のコマンドを入力して mydataset.mytable にある 2018 年 1 月 30 日のパーティションをパーティション分割されていないテーブル（mydataset2.mytable2）にコピーします。-f ショートカットが指定されているため、パーティション分割されていないコピー先テーブルがプロンプトなしで上書きされます。

bq --location=US cp -f 'mydataset.mytable$20180130' mydataset2.mytable2

パーティションを別のパーティション分割テーブルにコピーする

次のコマンドを入力して mydataset.mytable にある 2018 年 1 月 30 日のパーティションを別のパーティション分割テーブル（mydataset2.mytable2）にコピーします。-a ショートカットが指定されているため、パーティションのデータはコピー先テーブルに追加されます。コピー先テーブルにはパーティションデコレータが指定されていないため、コピー元のパーティションキーが維持され、データはコピー先テーブルの 2018 年 1 月 30 日のパーティションにコピーされます。コピー先テーブルでパーティションデコレータを指定して特定のパーティションにデータをコピーすることもできます。mydataset はデフォルトプロジェクトにあります。mydataset2 はデフォルトプロジェクトではなく myotherproject にあります。

bq --location=US cp \
-a \
'mydataset.mytable$20180130' \
myotherproject:mydataset2.mytable2

次のコマンドを入力して mydataset.mytable にある 2018 年 1 月 30 日のパーティションを別のパーティション分割テーブルの 2018 年 2 月 20 日のパーティション（mydataset2.mytable2）にコピーします。-f ショートカットが指定されているため、コピー先テーブルの 2018 年 2 月 20 日のパーティションがプロンプトなしに上書きされます。パーティションデコレータを使用しない場合、コピー先テーブルのすべてのデータが上書きされます。mydataset はデフォルトプロジェクトにあります。mydataset2 はデフォルトプロジェクトではなく myotherproject にあります。

bq cp \
-f \
'mydataset.mytable$20180130' \
'myotherproject:mydataset2.mytable2$20180220'

次のコマンドを入力して mydataset.mytable にある 2018 年 1 月 30 日のパーティションを別のパーティション分割テーブル（mydataset2.mytable2）にコピーします。mydataset はデフォルトプロジェクトにあります。mydataset2 はデフォルトプロジェクトではなく myotherproject にあります。コピー先テーブルにデータがある場合は、デフォルトの動作として、上書きするかどうかを確認するプロンプトが表示されます。

bq cp \
'mydataset.mytable$20180130' \
myotherproject:mydataset2.mytable2

注: パーティションデコレータが指定された bq cp コマンドは、コピー元パーティションとコピー先パーティションが同一である列ベースのパーティションで機能します。bq cp コマンドは、取り込み時間ベースのパーティションでも機能します。このパーティションは、同じ時間単位、またはソースパーティションを含む粗い時間単位を表します。たとえば、$20180130 がソースパーティションデコレータの場合、有効なコピー先パーティションデコレータには $20180130、$201801、$2018 が含まれます。列ベースのパーティションを、完全に別のパーティションデコレータ、またはより細かい粒度の時間単位パーティションにコピーするには、INSERT SELECT ステートメントを使用します。

API

jobs.insert メソッドを呼び出して、copy ジョブを構成します。（省略可）ジョブリソースの jobReference セクションにある location プロパティでリージョンを指定します。

ジョブ構成で以下のプロパティを指定します。

sourceTables プロパティに、コピー元のデータセット、テーブル、パーティションを入力します。
destinationTable プロパティに、コピー先のデータセットとテーブルを入力します。
writeDisposition プロパティを使用して、コピー先のテーブルまたはパーティションにデータを追加するか上書きするかを指定します。

複数のパーティションのコピー

複数のパーティションをコピーするには:

Console

現在、Cloud Console では、パーティションのコピーはサポート対象外です。

bq

複数のパーティションをコピーするプロセスは単一のパーティションをコピーするプロセスと同じですが、複数のコピー元パーティションをカンマ区切りのリストとして指定します。

bq cp \
'mydataset.mytable$20180130,mydataset.mytable$20180131' \
myotherproject:mydataset.mytable2

API

jobs.insert メソッドを呼び出して、copy ジョブを構成します。ジョブリソースの jobReference セクションにある location プロパティでリージョンを指定します。

ジョブ構成で以下のプロパティを指定します。

sourceTables プロパティに、複数のコピー元パーティション（データセット名とテーブル名を含む）を入力します。
destinationTable プロパティに、コピー先のデータセットとテーブルを入力します。
writeDisposition プロパティを使用して、コピー先のテーブルまたはパーティションにデータを追加するか上書きするかを指定します。

パーティション分割テーブルの削除

時間分割テーブルとそのすべてのパーティションを削除するプロセスは、標準テーブルを削除するプロセスと同じです。テーブルの削除の詳細については、テーブルの削除をご覧ください。

パーティション分割テーブルのパーティションの削除

パーティション分割テーブルのパーティションを削除するには、bq コマンドラインツールの bq rm コマンドを使用するか、tables.delete API メソッドを呼び出します。

パーティションデコレータを使用すると、特定のパーティションを削除できます。たとえば、mydataset.mytable というパーティション分割テーブルの 2016 年 3 月 1 日のパーティション（$20160301）は、次のコマンドを使用して削除できます。

bq rm 'mydataset.mytable$20160301'

現時点では、一度に削除できるパーティションは 1 つだけです。

必要な権限

パーティションを削除するには、少なくとも bigquery.tables.delete 権限と bigquery.tables.get 権限が付与されている必要があります。次の IAM 事前定義ロールには bigquery.tables.delete 権限と bigquery.tables.get 権限が含まれています。

bigquery.dataOwner
bigquery.dataEditor
bigquery.admin

また、bigquery.datasets.create 権限を持つユーザーがデータセットを作成すると、そのデータセットに対する bigquery.dataOwner アクセス権がユーザーに付与されます。bigquery.dataOwner アクセス権により、ユーザーはデータセットに含まれるテーブルとパーティションを削除できます。

BigQuery での IAM のロールと権限については、事前定義ロールと権限をご覧ください。

パーティション分割テーブル内のパーティションの削除

次に挙げる 2 つの特別なパーティションではない限り、パーティションのデコレータを指定することでパーティションを削除できます。現在、__NULL__ パーティションと __UNPARTITIONED__ パーティションは削除できません。

パーティション分割テーブルのパーティションを削除するには:

Console

Cloud Console では、パーティションの削除はサポート対象外です。

bq

--table フラグ（または -t ショートカット）を指定して bq rm コマンドを使用し、パーティションデコレータを指定して、特定のパーティションを削除します。

bq rm --table project_id:dataset.table$partition

ここで

project_id はプロジェクト ID です。省略した場合は、デフォルトのプロジェクトが使用されます。
dataset は、テーブルを含むデータセットの名前です。
table はテーブルの名前です。
partition は、削除するパーティションのパーティションデコレータです。

パーティションデコレータには、パーティショニングのタイプに応じて次の形式があります。

時間単位パーティション: yyyymmddhh。例: $2016030100
日単位パーティション: yyyymmdd。例: $20160301
月単位パーティション: yyyymm。例: $201603
年単位パーティション: yyyy。例: $2016
整数範囲パーティション: パーティション範囲の始点。例: $20。

アクションの確認を求めるプロンプトが bq コマンドラインツールに表示されます。確認をスキップするには、--force フラグ（または -f ショートカット）を使用します。

例:

デフォルトプロジェクトの mydataset.mytable という名前の日単位パーティション分割テーブルから、2016 年 3 月 1 日のパーティションを削除します。

bq rm --table 'mydataset.mytable$20160301'

月単位パーティション分割テーブルから、2016 年 3 月のパーティションを削除します。

bq rm --table 'mydataset.mytable$201603'

mydataset.mytable という名前の整数範囲パーティション分割テーブルから、20 で始まる整数範囲を削除します。

bq rm --table 'mydataset.mytable$20'

API

tables.delete メソッドを呼び出して、tableId パラメータを使用してテーブルおよびパーティションデコレータを指定します。

テーブルのセキュリティ

BigQuery でテーブルへのアクセスを制御するには、テーブルのアクセス制御の概要をご覧ください。

パーティション分割テーブルの管理

パーティション メタデータの取得

INFORMATION_SCHEMA ビューを使用したパーティション メタデータの取得

メタテーブルを使用したパーティション メタデータの取得

パーティション分割テーブルのプロパティの更新

必要な権限

パーティション分割テーブルの説明の更新

テーブルの有効期限の更新

パーティションの有効期限の更新

Console

SQL

bq

API

パーティション フィルタ要件の更新

[パーティション フィルタを要求] オプションの更新

Console

bq

API

Java

スキーマ定義の更新

パーティション分割テーブルの名前の変更

パーティション分割テーブルのコピー

単一のパーティション分割テーブルのコピー

複数のパーティション分割テーブルのコピー

パーティションのコピー

必要な権限

単一のパーティションのコピー

Console

bq

API

複数のパーティションのコピー

Console

bq

API

パーティション分割テーブルの削除

パーティション分割テーブルのパーティションの削除

必要な権限

パーティション分割テーブル内のパーティションの削除

Console

bq

API

テーブルのセキュリティ

パーティションメタデータの取得

`INFORMATION_SCHEMA` ビューを使用したパーティションメタデータの取得

メタテーブルを使用したパーティションメタデータの取得

パーティションフィルタ要件の更新

[パーティションフィルタを要求] オプションの更新