テーブルデータのエクスポート

このページでは、BigQuery のテーブルからデータをエクスポートする方法について説明します。

BigQuery にデータを読み込んだ後、さまざまな形式でデータをエクスポートできます。BigQuery は最大 1 GB のデータを 1 つのファイルにエクスポートできます。1 GB を超えるデータをエクスポートする場合は、データを複数のファイルにエクスポートする必要があります。データを複数のファイルにエクスポートすると、さまざまなサイズのファイルになります。

手動でエクスポートする代わりに、Cloud Dataflow などのサービスを使用して BigQuery からデータを読み取ることができます。Cloud Dataflow を使用して BigQuery でデータの読み取りと書き込みを行う方法の詳細については、Apache Beam ドキュメントの BigQuery I/O をご覧ください。

必要な権限

エクスポートするデータが保存されているデータセットへの READER アクセス権があることを確認します。または、事前定義されているプロジェクトレベル BigQuery IAM 役割のうち、bigquery.tables.export 権限を含むものを使用することもできます。たとえば、bigquery.dataViewer、bigquery.dataOwner、bigquery.dataEditor、bigquery.admin です。プロジェクトレベルで IAM 役割を割り当てると、そのプロジェクト内のすべてのテーブルに対する bigquery.tables.export 権限がユーザーまたはグループに与えられます。
Cloud Storage バケットへの WRITER 権限があること、またはオブジェクトをバケットに書き込むための権限を持つ事前定義済みの IAM 役割が割り当てられていることを確認してください。BigQuery からのエクスポートの出力先として、Cloud Storage バケットのみが可能です。Cloud Storage の IAM 役割については、Cloud Storage の IAM 役割をご覧ください。
エクスポートジョブを実行するには、bigquery.jobs.create 権限が必要です。次の事前定義済みの IAM 役割のいずれかを付与することによって、プロジェクトレベルで bigquery.jobs.create 権限を設定できます。
- bigquery.user
- bigquery.jobUser
- bigquery.admin

エクスポートの制限事項

BigQuery からデータをエクスポートするときは、次の点に注意してください。

テーブルデータをローカルファイル、Google スプレッドシート、Google ドライブにエクスポートすることはできません。可能なエクスポート先は Cloud Storage だけです。クエリ結果の保存については、クエリ結果のダウンロードと保存をご覧ください。
1 つのファイルに最大 1 GB のテーブルデータをエクスポートできます。1 GB を超えるデータをエクスポートする場合は、ワイルドカードを使用してデータを複数のファイルにエクスポートします。データを複数のファイルにエクスポートすると、さまざまなサイズのファイルになります。
ネストや繰り返しのあるデータを CSV 形式でエクスポートすることはできません。ネストや繰り返しのあるデータは、Avro および JSON のエクスポートでサポートされています。
データを JSON 形式でエクスポートするときは、INT64（整数）データ型が JSON 文字列としてエンコードされます。これは、そのデータが他のシステムで読み込まれるときに 64 ビットの精度を保持するためです。
単一のエクスポートジョブで複数のテーブルからデータをエクスポートすることはできません。
分割テーブルからデータをエクスポートする場合は、個々のパーティションをエクスポートできません。
GCP Console または従来の BigQuery ウェブ UI を使用してデータをエクスポートする場合、GZIP 以外の圧縮タイプは選択できません。

ロケーションに関する留意事項

データのロケーションを選択するときは、次の点を考慮してください。

データをエクスポートするには Cloud Storage バケットを同じリージョンに配置する

データをエクスポートする場合、リージョンまたはマルチリージョンの Cloud Storage バケットを BigQuery データセットと同じロケーションに配置する必要があります。たとえば、BigQuery データセットが EU のマルチリージョンロケーションにある場合、エクスポート対象のデータが含まれている Cloud Storage バケットは EU のリージョンまたはマルチリージョンロケーションに存在する必要があります。
データセットがリージョンロケーションにある場合、Cloud Storage バケットは同じロケーションのリージョンバケットに存在する必要があります。たとえば、データセットが東京リージョンにある場合、Cloud Storage バケットは東京のリージョンバケットである必要があります。
例外: データセットが米国のマルチリージョンロケーションにある場合、任意のリージョンまたはマルチリージョンロケーションにある Cloud Storage バケットにデータをエクスポートできます。

データ管理計画を作成する

BigQuery データセットや Cloud Storage バケットなどのリージョンストレージリソースを選択する場合は、データの地理的管理を行うための計画を作成します。

Cloud Storage のロケーションの詳細については、Cloud Storage のドキュメントのバケットのロケーションをご覧ください。

ロケーション間での BigQuery データの移動

データセットの作成後にロケーションを変更することはできません。また、データセットをあるロケーションから別のロケーションに移動させることもできません。データセットをあるロケーションから別のロケーションに移動する場合は、次の手順に従います。

BigQuery テーブルから、データセットと同じロケーションにあるリージョンまたはマルチリージョンの Cloud Storage バケットにデータをエクスポートします。たとえば、データセットが EU のマルチリージョンロケーションにある場合は、EU のリージョンまたはマルチリージョンバケットにデータをエクスポートします。

BigQuery からのデータのエクスポートについて請求は発生しませんが、エクスポートしたデータを Cloud Storage に保存する場合は請求の対象になります。BigQuery からのエクスポートは、エクスポートジョブの制限が適用されます。
Cloud Storage バケットから新しいロケーションのリージョンまたはマルチリージョンバケットに、データをコピーするか移動します。たとえば、米国のマルチリージョンロケーションから東京のリージョンロケーションにデータを移動すると、データは東京のリージョンバケットに転送されます。Cloud Storage オブジェクトの転送に関する詳細については、Cloud Storage ドキュメントのオブジェクトの名前変更、コピー、移動をご覧ください。

リージョン間でデータを転送すると、Cloud Storage でネットワークの下り料金が発生することに注意してください。
新しいロケーションの Cloud Storage バケットにデータを転送した後、新しい BigQuery データセットを（新しいロケーションに）作成します。次に、Cloud Storage バケットから BigQuery にデータを読み込みます。

BigQuery へのデータの読み込みについて請求は発生しませんが、Cloud Storage にデータを保存した場合は請求が発生し、データまたはバケットを削除するまで請求が行われます。読み込まれたデータを BigQuery に保存した場合も、請求の対象になります。BigQuery へのデータの読み込みには、読み込みジョブの制限が適用されます。

Cloud Storage を使用した大量のデータセットの保存や移動に関する詳細は、Cloud Storage とビッグデータの使用をご覧ください。

エクスポート形式と圧縮形式

BigQuery は、エクスポートされるデータに対して次のデータ形式と圧縮形式をサポートしています。

データ形式サポートされている圧縮タイプ詳細

CSV

GZIP

データ形式	サポートされている圧縮タイプ	詳細
CSV	GZIP	エクスポートされるデータの CSV 区切り文字を制御するには、`--field_delimiter` CLI フラグまたは `configuration.extract.fieldDelimiter` 抽出ジョブプロパティを使用できます。ネストされたデータや繰り返しデータは、サポートされていません。
JSON	GZIP	ネストされたデータや繰り返しデータはサポートされます。
Avro	DEFLATE、SNAPPY	Avro のエクスポートでは、GZIP はサポートされていません。ネストされたデータや繰り返しデータはサポートされます。

エクスポートされるデータの CSV 区切り文字を制御するには、--field_delimiter CLI フラグまたは configuration.extract.fieldDelimiter 抽出ジョブプロパティを使用できます。

ネストされたデータや繰り返しデータは、サポートされていません。

JSON GZIP ネストされたデータや繰り返しデータはサポートされます。

Avro

DEFLATE、SNAPPY

Avro のエクスポートでは、GZIP はサポートされていません。

ネストされたデータや繰り返しデータはサポートされます。

BigQuery に保存されているデータのエクスポート

テーブルデータをエクスポートするには、BigQuery ウェブ UI を使用するか、bq extract CLI コマンドを使用するか、API やクライアントライブラリを介して抽出ジョブを送信します。

BigQuery テーブルからデータをエクスポートするには:

Console

GCP Console で BigQuery ウェブ UI を開きます。
BigQuery ウェブ UI に移動
ナビゲーションパネルの [リソース] セクションでプロジェクトを展開し、データセットをクリックして展開します。エクスポートするデータを含むテーブルを見つけてクリックします。
ウィンドウの右側にある [エクスポート] をクリックし、[Export to Cloud Storage] を選択します。
[Export to Cloud Storage] ダイアログで、次の手順を行います。
- [Select Cloud Storage location] で、データのエクスポート場所となるバケット、フォルダ、またはファイルを参照します。
- [Export format] で、エクスポートするデータの形式を [CSV]、[JSON]（改行区切り）、[Avro] から選択します。
- [圧縮] では、デフォルト値 None を受け入れるか、GZIP を選択します。Avro 形式を GZIP 圧縮と組み合わせて使用することはできません。Avro データを圧縮するには、bq コマンドラインツールまたは API を使用して、Avro データでサポートされている圧縮タイプの 1 つ（DEFLATE または SNAPPY）を指定します。
- [エクスポート] をクリックしてテーブルをエクスポートします。

ジョブの進行状況を確認するには、ナビゲーションの上部にある [エクスポート] ジョブの [ジョブ履歴] を確認します。

従来の UI

BigQuery ウェブ UI に移動します。
BigQuery ウェブ UI に移動
ナビゲーション領域で、データセットの横の展開アイコンをクリックして、その内容を表示します。
エクスポートするデータを含むテーブルの横にある下矢印アイコンをクリックします。
[Export to Cloud Storage] ダイアログで [Export table] を選択します。
[Export to Cloud Storage] ダイアログで、次の手順を行います。
- [Export format] で、エクスポートするデータの形式を [CSV]、[JSON]（改行区切り）、[Avro] から選択します。
- [圧縮] では、デフォルト値 None を受け入れるか、GZIP を選択します。Avro 形式を GZIP 圧縮と組み合わせて使用することはできません。Avro データを圧縮するには、bq コマンドラインツールまたは API を使用して、Avro データでサポートされている圧縮タイプの 1 つ（DEFLATE または SNAPPY）を指定します。
- [Cloud Storage URI] テキストボックスに、有効な URI を gs://[BUCKET_NAME]/[FILENAME.CSV] 形式で入力します。ここで [BUCKET_NAME] は Cloud Storage のバケット名、[FILENAME] は保存先ファイルの名前です。BigQuery データセットと Cloud Storage バケットは同じロケーションに存在する必要があります。
- [OK] をクリックしてテーブルをエクスポートします。

ジョブが実行されている間、（extracting）というメッセージがナビゲーション領域のテーブル名の横に表示されます。ジョブの進行状況をチェックするには、ナビゲーション領域の上の方にある [Job History] で [Extract] ジョブを確認します。

コマンドライン

bq extract コマンドを使用します。

bq --location=[LOCATION] extract --destination_format [FORMAT] --compression [COMPRESSION_TYPE] --field_delimiter [DELIMITER] --print_header [BOOLEAN] [PROJECT_ID]:[DATASET].[TABLE] gs://[BUCKET]/[FILENAME]

ここで

[LOCATION] はロケーションの名前です。--location フラグは省略可能です。たとえば、BigQuery を東京リージョンで使用している場合は、このフラグの値を asia-northeast1 に設定します。.bigqueryrc ファイルを使用してロケーションのデフォルト値を設定できます。
[FORMAT] は、エクスポートされるデータの形式です（CSV、NEWLINE_DELIMITED_JSON、または AVRO）。
[COMPRESSION_TYPE] は、データ形式に対してサポートされる圧縮タイプです。 CSV と NEWLINE_DELIMITED_JSON は GZIP をサポートしています。AVRO は DEFLATE と SNAPPY をサポートしています。
[DELIMITER] は、CSV エクスポートの列間の境界を示す文字です。タブの名前として受け入れられるのは \t と tab です。
[BOOLEAN] は true または false です。true に設定すると、データ形式がヘッダーをサポートする場合に、エクスポートされるデータにヘッダー行が出力されます。デフォルト値は true です。
[PROJECT_ID] はプロジェクト ID です。
[DATASET] はソースデータセットの名前です。
[TABLE] は、エクスポートするテーブルです。
[BUCKET] は、データのエクスポート先の Cloud Storage バケットの名前です。BigQuery データセットと Cloud Storage バケットは同じロケーションに存在する必要があります。
[FILENAME] は、エクスポートされるデータファイルの名前です。ワイルドカードを使用して複数のファイルにエクスポートできます。

例:

たとえば次のコマンドは、mydataset.mytable を myfile.csv という名前の gzip 圧縮ファイルにエクスポートします。myfile.csv は example-bucket という Cloud Storage バケットに保存されます。

bq --location=US extract --compression GZIP 'mydataset.mytable' gs://example-bucket/myfile.csv

デフォルトの出力形式は CSV です。JSON または Avro 形式でエクスポートするには、destination_format フラグを NEWLINE_DELIMITED_JSON または AVRO に設定します。次に例を示します。

bq --location=US extract --destination_format NEWLINE_DELIMITED_JSON 'mydataset.mytable' gs://example-bucket/myfile.json

次のコマンドは、mydataset.mytable を、Snappy を使用して圧縮された Avro ファイルにエクスポートします。このファイルの名前は myfile.avro です。myfile.avro は example-bucket という Cloud Storage バケットにエクスポートされます。

bq --location=US extract --destination_format AVRO --compression SNAPPY 'mydataset.mytable' gs://example-bucket/myfile.avro

API

データをエクスポートするには、ジョブを作成して configuration.extract オブジェクトの内容を設定します。

ジョブリソースの jobReference セクションにある location プロパティで、ロケーションを指定します。

抽出ジョブを作成し、抽出元の BigQuery データと抽出先の Cloud Storage を指定します。
sourceTable 構成オブジェクトを使用してソーステーブルを指定します。このオブジェクトはプロジェクト ID、データセット ID、テーブル ID で構成されています。
宛先 URI は gs://[BUCKET_NAME]/[FILENAME.CSV] という形式で完全修飾される必要があります。各 URI に '*' ワイルドカード文字を 1 つ含めることができますが、ワイルドカードはバケット名より後にある必要があります。
configuration.extract.destinationFormat プロパティでデータ形式を指定します。たとえば、JSON ファイルとしてエクスポートするには、このプロパティの値を NEWLINE_DELIMITED_JSON に設定します。
ジョブステータスを確認するには、最初のリクエストで返されるジョブの ID を指定して jobs.get([JOB_ID]) を呼び出します。
- status.state = DONE の場合、ジョブは正常に完了しました。
- status.errorResult プロパティが存在する場合は、リクエストが失敗しました。エラーを記述する情報がオブジェクトに格納されています。
- status.errorResult が存在しない場合、ジョブは正常に完了しましたが、致命的でないエラーが発生した可能性があります。致命的でないエラーは、返されたジョブオブジェクトの status.errors プロパティに格納されています。

API に関する注:

jobs.insert() を呼び出してジョブを作成するとき、一意の ID を生成し、その ID を jobReference.jobId として渡すことをおすすめします。この手法を使用すると、クライアントは既知のジョブ ID を使ってポーリングまたは再試行できるので、ネットワーク障害に強くなります。
特定のジョブ ID で jobs.insert() を呼び出す操作は「べき等」です。つまり、同じジョブ ID で何回でも再試行できますが、成功するオペレーションはそのうちの 1 回だけです。

C#

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

GitHub で表示フィードバック

using Google.Cloud.BigQuery.V2;
using System;

public class BigQueryExtractTable
{
    public void ExtractTable(
        string projectId = "your-project-id",
        string bucketName = "your-bucket-name")
    {
        BigQueryClient client = BigQueryClient.Create(projectId);
        // Define a destination URI. Use a single wildcard URI if you think
        // your exported data will be larger than the 1 GB maximum value.
        string destinationUri = $"gs://{bucketName}/shakespeare-*.csv";
        BigQueryJob job = client.CreateExtractJob(
            projectId: "bigquery-public-data",
            datasetId: "samples",
            tableId: "shakespeare",
            destinationUri: destinationUri
        );
        job.PollUntilCompleted();  // Waits for the job to complete.
        Console.Write($"Exported table to {destinationUri}.");
    }
}

Go

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

GitHub で表示フィードバック

srcProject := "bigquery-public-data"
srcDataset := "samples"
srcTable := "shakespeare"

// For example, gcsUri = "gs://mybucket/shakespeare.csv"
gcsRef := bigquery.NewGCSReference(gcsURI)
gcsRef.FieldDelimiter = ","

extractor := client.DatasetInProject(srcProject, srcDataset).Table(srcTable).ExtractorTo(gcsRef)
extractor.DisableHeader = true
// You can choose to run the job in a specific location for more complex data locality scenarios.
// Ex: In this example, source dataset and GCS bucket are in the US.
extractor.Location = "US"

job, err := extractor.Run(ctx)
if err != nil {
	return err
}
status, err := job.Wait(ctx)
if err != nil {
	return err
}
if err := status.Err(); err != nil {
	return err
}

Java

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

GitHub で表示フィードバック

Job job = table.extract(format, gcsUrl);
// Wait for the job to complete
try {
  Job completedJob =
      job.waitFor(
          RetryOption.initialRetryDelay(Duration.ofSeconds(1)),
          RetryOption.totalTimeout(Duration.ofMinutes(3)));
  if (completedJob != null && completedJob.getStatus().getError() == null) {
    // Job completed successfully
  } else {
    // Handle error case
  }
} catch (InterruptedException e) {
  // Handle interrupted wait
}

Node.js

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

GitHub で表示フィードバック

// Import the Google Cloud client libraries
const {BigQuery} = require('@google-cloud/bigquery');
const {Storage} = require('@google-cloud/storage');

async function extractTableToGCS() {
  // Exports my_dataset:my_table to gcs://my-bucket/my-file as raw CSV.

  /**
   * TODO(developer): Uncomment the following lines before running the sample.
   */
  // const datasetId = "my_dataset";
  // const tableId = "my_table";
  // const bucketName = "my-bucket";
  // const filename = "file.csv";

  // Instantiate clients
  const bigqueryClient = new BigQuery();
  const storageClient = new Storage();

  // Location must match that of the source table.
  const options = {
    location: 'US',
  };

  // Export data from the table into a Google Cloud Storage file
  const [job] = await bigqueryClient
    .dataset(datasetId)
    .table(tableId)
    .extract(storageClient.bucket(bucketName).file(filename), options);
  // load() waits for the job to finish
  console.log(`Job ${job.id} completed.`);

  // Check the job's status for errors
  const errors = job.status.errors;
  if (errors && errors.length > 0) {
    throw errors;
  }
}
extractTableToGCS();

PHP

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

GitHub で表示フィードバック

use Google\Cloud\BigQuery\BigQueryClient;

/** Uncomment and populate these variables in your code */
// $projectId  = 'The Google project ID';
// $datasetId  = 'The BigQuery dataset ID';
// $tableId    = 'The BigQuery table ID';
// $bucketName = 'The Cloud Storage bucket Name';

$bigQuery = new BigQueryClient([
    'projectId' => $projectId,
]);
$dataset = $bigQuery->dataset($datasetId);
$table = $dataset->table($tableId);
$destinationUri = "gs://{$bucketName}/{$tableId}.json";
// Define the format to use. If the format is not specified, 'CSV' will be used.
$format = 'NEWLINE_DELIMITED_JSON';
// Create the extract job
$extractConfig = $table->extract($destinationUri)->destinationFormat($format);
// Run the job
$job = $table->runJob($extractConfig);  // Waits for the job to complete
printf('Exported %s to %s' . PHP_EOL, $table->id(), $destinationUri);

Python

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

GitHub で表示フィードバック

# from google.cloud import bigquery
# client = bigquery.Client()
# bucket_name = 'my-bucket'
project = "bigquery-public-data"
dataset_id = "samples"
table_id = "shakespeare"

destination_uri = "gs://{}/{}".format(bucket_name, "shakespeare.csv")
dataset_ref = client.dataset(dataset_id, project=project)
table_ref = dataset_ref.table(table_id)

extract_job = client.extract_table(
    table_ref,
    destination_uri,
    # Location must match that of the source table.
    location="US",
)  # API request
extract_job.result()  # Waits for job to complete.

print(
    "Exported {}:{}.{} to {}".format(project, dataset_id, table_id, destination_uri)
)

Ruby

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

GitHub で表示フィードバック

require "google/cloud/bigquery"

def extract_table(
    bucket_name = "my-bucket",
    dataset_id  = "my_dataset_id",
    table_id    = "my_table_id"
  )
  bigquery = Google::Cloud::Bigquery.new
  dataset  = bigquery.dataset dataset_id
  table    = dataset.table    table_id

  # Define a destination URI. Use a single wildcard URI if you think
  # your exported data will be larger than the 1 GB maximum value.
  destination_uri = "gs://#{bucket_name}/output-*.csv"

  extract_job = table.extract_job(destination_uri) do |config|
    # Location must match that of the source table.
    config.location = "US"
  end
  extract_job.wait_until_done!  # Waits for the job to complete

  puts "Exported #{table.id} to #{destination_uri}"
end

Avro エクスポートの詳細

BigQuery は次の方法で Avro 形式のデータを表現します。

エクスポートされたファイルは Avro コンテナファイルになります。
各 BigQuery 行は 1 つの Avro レコードとして表されます。ネストされたデータは、ネストされたレコードオブジェクトによって表されます。
REQUIRED フィールドは、対応する Avro 型として表されます。たとえば、BigQuery の INTEGER 型は Avro の LONG 型に対応しています。
NULLABLE フィールドは、対応する型と "null" の Avro ユニオンとして表されます。
REPEATED フィールドは Avro 配列として表されます。
TIMESTAMP データ型は Avro の LONG 型として表されます。

Avro 形式を GZIP 圧縮とともに使用することはできません。Avro データを圧縮するには、bq コマンドラインツールまたは API を使用して、Avro データでサポートされている圧縮タイプの 1 つ（DEFLATE または SNAPPY）を指定します。

1 つまたは複数のファイルへのデータのエクスポート

destinationUris プロパティはファイルをエクスポートする場所とファイル名を示します。

BigQuery は URI ごとに 1 つのワイルドカード演算子（*）をサポートします。ワイルドカードは、バケット名の中を除いて URI のどこでも使用できます。ワイルドカード演算子を使用すると、指定したパターンに基づいて複数の分割ファイルが作成されます。ワイルドカード演算子は、左側に 0 が埋められた 12 桁の数値（0 から始まるシーケンス番号）に置き換えられます。たとえば、ファイル名の最後にワイルドカードがある URI の場合、最初のファイルに 000000000000 が追加され、2 番目のファイルに 000000000001 が追加されます。

destinationUris プロパティで使用できるオプションを次の表に示します。

destinationUris のオプション

単一の URI

destinationUris のオプション
単一の URI	1 GB 以下のテーブルデータをエクスポートする場合は、単一の URI を使用します。ほとんどの場合、エクスポートされるデータは 1 GB という最大値よりも小さいため、このオプションは最も一般的なユースケースです。プロパティの定義: `['gs://[YOUR_BUCKET]/file-name.json']` 作成されるファイル: gs://my-bucket/file-name.json
単一のワイルドカード URI	エクスポートされるデータが 1 GB という最大値よりも大きくなりそうな場合は、単一のワイルドカード URI を使用します。データは、指定したパターンに基づいて複数のファイルに分割されます。エクスポートされるファイルのサイズは変動します。ファイル名以外の URI コンポーネントでワイルドカードを使用する場合、データをエクスポートする前に、そのパスコンポーネントが存在していないことを確認してください。プロパティの定義: `['gs://[YOUR_BUCKET]/file-name-.json']` 作成されるファイル:* gs://my-bucket/file-name-000000000000.json gs://my-bucket/file-name-000000000001.json gs://my-bucket/file-name-000000000002.json ... プロパティの定義: `['gs://[YOUR_BUCKET]/path-component-/file-name.json']` 作成されるファイル:* gs://my-bucket/path-component-000000000000/file-name.json gs://my-bucket/path-component-000000000001/file-name.json gs://my-bucket/path-component-000000000002/file-name.json ...
複数のワイルドカード URI	複数のワイルドカード URI は、エクスポート出力をパーティショニングする場合に使用します。Cloud Dataproc のようなサービスで並列処理ジョブを実行している場合は、このオプションを使用します。ジョブの処理に使用できるワーカーの数を判断し、ワーカーごとに 1 つの URI を作成します。BigQuery は各 URI の場所をパーティションとして扱い、並行処理を使用してそれぞれの場所でデータを複数のファイルに分割します。各 URI に単一のワイルドカード演算子が含まれていて、各 URI が重複しておらず、URI の数が割り当てのポリシーの上限を超えていない限り、ファイル名でどのようなパターンでも使用できます。複数のワイルドカード URI を渡すと、一連のファイルの「最後」のファイルであることを示す特別なファイルが各パーティションの最後に作成されます。このファイル名は、作成された分割ファイルの数を示しています。たとえば、ワイルドカード URI が `gs://[YOUR_BUCKET]/file-name- <worker number>-.json`、作成される分割ファイルが 80 個である場合、ゼロレコードファイルの名前は `gs://my-bucket/file- name-<worker number>-000000000080.json` になります。このファイル名から、000000000000～000000000079 という名前の 80 個の分割ファイルを BigQuery が作成したことがわかります。列ヘッダーのある CSV 形式など、エクスポートしたデータ形式によっては、ゼロレコードファイルのサイズが 0 バイトより大きくなる場合があります。文字列パターン:* `gs://[YOUR_BUCKET]/file-name-<worker number>-.json` プロパティの定義:* ['gs://my-bucket/file-name-1-.json', 'gs://my-bucket/file-name-2-.json', 'gs://my-bucket/file-name-3-.json'] 作成されるファイル:* この例は各パーティションで 80 個の分割ファイルが作成された場合を示します gs://my-bucket/file-name-1-000000000000.json gs://my-bucket/file-name-1-000000000001.json ... gs://my-bucket/file-name-1-000000000080.json gs://my-bucket/file-name-2-000000000000.json gs://my-bucket/file-name-2-000000000001.json ... gs://my-bucket/file-name-2-000000000080.json gs://my-bucket/file-name-3-000000000000.json gs://my-bucket/file-name-3-000000000001.json ... gs://my-bucket/file-name-3-000000000080.json

1 GB 以下のテーブルデータをエクスポートする場合は、単一の URI を使用します。ほとんどの場合、エクスポートされるデータは 1 GB という最大値よりも小さいため、このオプションは最も一般的なユースケースです。

プロパティの定義:

['gs://[YOUR_BUCKET]/file-name.json']

作成されるファイル:


gs://my-bucket/file-name.json

単一のワイルドカード URI

エクスポートされるデータが 1 GB という最大値よりも大きくなりそうな場合は、単一のワイルドカード URI を使用します。データは、指定したパターンに基づいて複数のファイルに分割されます。エクスポートされるファイルのサイズは変動します。

ファイル名以外の URI コンポーネントでワイルドカードを使用する場合、データをエクスポートする前に、そのパスコンポーネントが存在していないことを確認してください。

プロパティの定義:

['gs://[YOUR_BUCKET]/file-name-*.json']

作成されるファイル:


gs://my-bucket/file-name-000000000000.json
gs://my-bucket/file-name-000000000001.json
gs://my-bucket/file-name-000000000002.json
...

プロパティの定義:

['gs://[YOUR_BUCKET]/path-component-*/file-name.json']

作成されるファイル:


gs://my-bucket/path-component-000000000000/file-name.json
gs://my-bucket/path-component-000000000001/file-name.json
gs://my-bucket/path-component-000000000002/file-name.json
...

複数のワイルドカード URI

複数のワイルドカード URI は、エクスポート出力をパーティショニングする場合に使用します。Cloud Dataproc のようなサービスで並列処理ジョブを実行している場合は、このオプションを使用します。ジョブの処理に使用できるワーカーの数を判断し、ワーカーごとに 1 つの URI を作成します。BigQuery は各 URI の場所をパーティションとして扱い、並行処理を使用してそれぞれの場所でデータを複数のファイルに分割します。各 URI に単一のワイルドカード演算子が含まれていて、各 URI が重複しておらず、URI の数が割り当てのポリシーの上限を超えていない限り、ファイル名でどのようなパターンでも使用できます。

複数のワイルドカード URI を渡すと、一連のファイルの「最後」のファイルであることを示す特別なファイルが各パーティションの最後に作成されます。このファイル名は、作成された分割ファイルの数を示しています。

たとえば、ワイルドカード URI が gs://[YOUR_BUCKET]/file-name- <worker number>-*.json、作成される分割ファイルが 80 個である場合、ゼロレコードファイルの名前は gs://my-bucket/file- name-<worker number>-000000000080.json になります。このファイル名から、000000000000～000000000079 という名前の 80 個の分割ファイルを BigQuery が作成したことがわかります。

列ヘッダーのある CSV 形式など、エクスポートしたデータ形式によっては、ゼロレコードファイルのサイズが 0 バイトより大きくなる場合があります。

文字列パターン:

gs://[YOUR_BUCKET]/file-name-<worker number>-*.json

プロパティの定義:


['gs://my-bucket/file-name-1-*.json',
'gs://my-bucket/file-name-2-*.json',
'gs://my-bucket/file-name-3-*.json']

作成されるファイル:

この例は各パーティションで 80 個の分割ファイルが作成された場合を示します


gs://my-bucket/file-name-1-000000000000.json
gs://my-bucket/file-name-1-000000000001.json
...
gs://my-bucket/file-name-1-000000000080.json
gs://my-bucket/file-name-2-000000000000.json
gs://my-bucket/file-name-2-000000000001.json
...
gs://my-bucket/file-name-2-000000000080.json
gs://my-bucket/file-name-3-000000000000.json
gs://my-bucket/file-name-3-000000000001.json
...
gs://my-bucket/file-name-3-000000000080.json

割り当てポリシー

エクスポートジョブの割り当てについては、「割り当てと制限」のページのエクスポートジョブをご覧ください。

料金

現時点では、BigQuery からのデータのエクスポートについて請求は発生しませんが、エクスポートは BigQuery の割り当てと制限の対象となります。

BigQuery の料金設定の詳細については、料金設定のページをご覧ください。

データのエクスポート後は、Cloud Storage にデータを保存することで料金が発生します。

Cloud Storage の料金設定の詳細については、クラウドの料金設定のページをご覧ください。

次のステップ

BigQuery ウェブ UI について学習するには、BigQuery ウェブ UI をご覧ください。
bq コマンドラインツールについて学習するには、bq コマンドラインツールをご覧ください。
Google BigQuery API クライアントライブラリを使ってアプリケーションを作成する方法を学習するには、クライアントライブラリクイックスタートガイドをご覧ください。

テーブルデータのエクスポート

必要な権限

エクスポートの制限事項

ロケーションに関する留意事項

ロケーション間での BigQuery データの移動

エクスポート形式と圧縮形式

BigQuery に保存されているデータのエクスポート