CSV ファイルを使用したエクスポートとインポート

MySQL | PostgreSQL | SQL Server

このページでは、Cloud SQL インスタンスで CSV ファイルを使用してデータのエクスポートとインポートを行う方法について説明します。

注: サポートされているデータベースサーバー（オンプレミス、AWS または Cloud SQL）から新しい Cloud SQL インスタンスにデータベース全体を移行する場合は、ファイルをエクスポートしてからインポートする代わりに、Database Migration Service を使用できます。エクスポートされたファイルから新しいインスタンスを作成するためにエクスポートする場合は、バックアップから別のインスタンスに復元するか、インスタンスのクローンを作成することを検討してください。

Cloud SQL インスタンスへのデータのインポートと、インスタンスからのデータのエクスポートをキャンセルできます。このデータは CSV ファイルに含まれています。インポートまたはエクスポートのオペレーションのキャンセルの詳細については、データのインポートとエクスポートをキャンセルするをご覧ください。

準備

エクスポートまたはインポートオペレーションを開始する前に、次のことを行います。

データベースに十分な空き容量があることを確認します。

エクスポートとインポートではデータベースリソースが使用されますが、インスタンスがプロビジョニングされていない限り、エクスポートによって通常のデータベースオペレーションが妨げられることはありません。

CSV ファイルに目的のデータがあり、正しい形式であることを確認します。CSV ファイルは、データの行ごとに 1 行を使用する必要があります。
データのエクスポートとインポートのベストプラクティスに従います。

Cloud SQL for MySQL からデータをエクスポートする

Cloud SQL for MySQL からのエクスポートに必要なロールと権限

Cloud SQL から Cloud Storage にデータをエクスポートするには、Cloud SQL インスタンスのサービスアカウントまたはユーザーに、次のいずれかのロールの組み合わせが必要です。

Cloud SQL 編集者ロールと storage.objectAdmin Identity and Access Management（IAM）ロール
次の権限を含むカスタムロール:
- cloudsql.instances.get
- cloudsql.instances.export
- storage.buckets.create
- storage.objects.create
- storage.objects.list（ファイルの並行エクスポートのみ）
- storage.objects.delete（ファイルの並行エクスポートのみ）

IAM ロールについては、Identity and Access Management をご覧ください。

Cloud SQL for MySQL から CSV ファイルにデータをエクスポートする

他のツールや環境で使用可能な CSV 形式でデータをエクスポートできます。エクスポートはデータベースレベルで行われます。CSV をエクスポートするときに、エクスポートするスキーマを指定できます。データベースレベルのスキーマはすべてエクスポート可能です。

注: Cloud SQL では、デフォルトのエスケープ文字として二重引用符（16 進数の 22）が使用されます。これは、NULL の値が文字列リテラルとして入力されているデータベースでは問題になる場合があります。デフォルトのエスケープ文字を使用してエクスポートされたファイルをインポートすると、そのファイルの値は NULL ではなく "NULL" として扱われます。ファイルをエクスポートするときに、--escape="5C" を使用してデフォルトをオーバーライドすることをおすすめします。

Cloud SQL インスタンス上のデータベースから Cloud Storage バケットの CSV ファイルにデータをエクスポートするには:

Console

Google Cloud コンソールで Cloud SQL の [インスタンス] ページに移動します。

Cloud SQL の [インスタンス] に移動
インスタンスの [概要] ページを開くには、インスタンス名をクリックします。
[エクスポート] をクリックします。
[Offload export] を選択して、エクスポートの進行中に他のオペレーションを実行できるようにします。
[詳細設定を表示] をクリックします。
[データベース] セクションで、プルダウンメニューからデータベースの名前を選択します。
[SQL クエリ] に、SQL クエリを入力して、データのエクスポート元のテーブルを指定します。

たとえば、guestbook データベースの entries テーブルの内容全体をエクスポートするには、次のように入力します。
```
SELECT * FROM guestbook.entries;
```
指定したデータベース内のテーブルをクエリで指定する必要があります。データベース全体を CSV 形式でエクスポートすることはできません。

注: 転送中は、クエリがターゲットインスタンスのロケーション以外の中間ロケーションで処理されることがあります。
[エクスポート] をクリックしてエクスポートを開始します。
[データベースをエクスポートしますか？] ボックスが開き、大規模なデータベースの場合、エクスポートプロセスに 1 時間以上かかることがあるという内容のメッセージが表示されます。エクスポート時、インスタンスで実行できる操作は情報の閲覧のみです。エクスポートの開始後は、オペレーションをキャンセルできます。エクスポートを開始してもよい場合は、[エクスポート] をクリックします。それ以外の場合は、[キャンセル] をクリックします。

gcloud

Cloud Storage バケットを作成します。
ファイルをバケットにアップロードします。

ファイルをバケットにアップロードする方法については、オブジェクトのアップロードをご覧ください。
エクスポート元の Cloud SQL インスタンスのサービスアカウントを見つけます。これを行うには、gcloud sql instances describe コマンドを実行します。出力で serviceAccountEmailAddress フィールドを探します。
```
gcloud sql instances describe INSTANCE_NAME
```
gsutil iam を使用して、Cloud SQL インスタンスのサービスアカウントに storage.objectAdmin IAM ロールを付与します。IAM 権限の設定については、IAM 権限の使用をご覧ください。
データベースをエクスポートします。
注: サーバーレスエクスポートを使用する場合は、--offload フラグを使用します。それ以外の場合は、次のコマンドからこのフラグを削除します。
```
gcloud sql export csv INSTANCE_NAME gs://BUCKET_NAME/FILE_NAME \
--database=DATABASE_NAME \
--offload \
--query=SELECT_QUERY
```
export csv コマンドの使用方法については、sql export csv コマンドのリファレンスページをご覧ください。

注: 転送中は、SELECT_QUERY がターゲットインスタンスのロケーション以外の中間のロケーションで処理される可能性があります。
以前に設定した IAM ロールを保持する必要がない場合は、この時点で取り消してください。

REST v1

エクスポート先のバケットを作成します。
```
gsutil mb -p PROJECT_NAME -l LOCATION_NAME gs://BUCKET_NAME
```
このステップは必須ではありませんが、他のデータへ一切アクセスできないようにするために、実行することを強く推奨します。
バケットに対する legacyBucketWriter IAM ロールをインスタンスに付与します。IAM 権限の設定については、IAM 権限の使用をご覧ください。
データベースをエクスポートします。

リクエストのデータを使用する前に、次のように置き換えます。
- project-id: プロジェクト ID
- instance-id: インスタンス ID
- bucket_name: Cloud Storage バケット名
- path_to_csv_file: CSV ファイルへのパス
- database_name: Cloud SQL インスタンス内のデータベースの名前
- offload: サーバーレスエクスポートを有効にします。サーバーレスエクスポートを使用するには true に設定します。
  注: サーバーレスエクスポートには追加料金がかかります。料金ページをご覧ください。
- select_query: エクスポート用の SQL クエリ（省略可）
  注: 転送中は、クエリがターゲットインスタンスのロケーション以外の中間ロケーションで処理されることがあります。
- escape_character: エスケープが必要なデータ文字の前に表示する文字。この引数の値は 16 進数 ASCII コード内の文字である必要があります。たとえば、22 は二重引用符を表します。（省略可）
- quote_character: 文字列データ型を持つ列の値を囲む文字。この引数の値は 16 進数 ASCII コード内の文字である必要があります。たとえば、22 は二重引用符を表します。（省略可）
- fields_terminated_by: 列の値を分割する文字。この引数の値は 16 進数 ASCII コード内の文字である必要があります。たとえば、2C はカンマを表します。（省略可）
- lines_terminated_by: 行レコードを分割した文字。この引数の値は 16 進数 ASCII コード内の文字である必要があります。たとえば、0A は新しい行を表します。（省略可）
HTTP メソッドと URL:
```
POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/export
```
リクエストの本文（JSON）:
```
{
 "exportContext":
   {
      "fileType": "CSV",
      "uri": "gs://bucket_name/path_to_csv_file",
      "databases": ["database_name"],
      "offload": true | false
      "csvExportOptions":
       {
           "selectQuery":"select_query",
           "escapeCharacter":"escape_character",
           "quoteCharacter":"quote_character",
           "fieldsTerminatedBy":"fields_terminated_by",
           "linesTerminatedBy":"lines_terminated_by"
       }
   }
}
```
リクエストを送信するには、次のいずれかのオプションを展開します。
curl（Linux、macOS、Cloud Shell）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。
```
curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @request.json \
    "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/export"
```
PowerShell（Windows）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/export" | Select-Object -Expand Content
```
次のような JSON レスポンスが返されます。
レスポンス
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}
```
SELECT クエリでデータベースが指定されている場合は、databases プロパティがオーバーライドされます。
以前に設定した IAM の権限を保持する必要がない場合は、今すぐ削除してください。

リクエストのパラメータの一覧については、instances:export ページをご覧ください。

REST v1beta4

エクスポート先のバケットを作成します。
```
gsutil mb -p PROJECT_NAME -l LOCATION_NAME gs://BUCKET_NAME
```
このステップは必須ではありませんが、他のデータへ一切アクセスできないようにするために、実行することを強く推奨します。
バケットに対する storage.objectAdmin IAM ロールをインスタンスに付与します。IAM 権限の設定については、IAM 権限の使用をご覧ください。
データベースをエクスポートします。

リクエストのデータを使用する前に、次のように置き換えます。
- project-id: プロジェクト ID
- instance-id: インスタンス ID
- bucket_name: Cloud Storage バケット名
- path_to_csv_file: CSV ファイルへのパス
- database_name: Cloud SQL インスタンス内のデータベースの名前
- offload: サーバーレスエクスポートを有効にします。サーバーレスエクスポートを使用するには true に設定します。
  注: サーバーレスエクスポートには追加料金がかかります。料金ページをご覧ください。
- select_query: エクスポート用の SQL クエリ（省略可）
  注: 転送中は、クエリがターゲットインスタンスのロケーション以外の中間ロケーションで処理されることがあります。
- escape_character: エスケープが必要なデータ文字の前に表示する文字。この引数の値は、ASCII の 16 進数形式にする必要があります。たとえば、22 は二重引用符を表します。（省略可）
- quote_character: 文字列データ型を持つ列の値を囲む文字。この引数の値は、ASCII の 16 進数形式にする必要があります。たとえば、22 は二重引用符を表します。（省略可）
- fields_terminated_by: 列の値を分割する文字。この引数の値は、ASCII の 16 進数形式にする必要があります。たとえば、2C はカンマを表します。（省略可）
- lines_terminated_by: 行レコードを分割した文字。この引数の値は、ASCII の 16 進数形式にする必要があります。たとえば、0A は新しい行を表します。（省略可）
HTTP メソッドと URL:
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/export
```
リクエストの本文（JSON）:
```
{
 "exportContext":
   {
      "fileType": "CSV",
      "uri": "gs://bucket_name/path_to_csv_file",
      "databases": ["database_name"],
      "offload": true | false
      "csvExportOptions":
       {
           "selectQuery": "select_query",
           "escapeCharacter":  "escape_character",
           "quoteCharacter": "quote_character",
           "fieldsTerminatedBy": "fields_terminated_by",
           "linesTerminatedBy": "lines_terminated_by"
       }
   }
}
```
リクエストを送信するには、次のいずれかのオプションを展開します。
curl（Linux、macOS、Cloud Shell）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。
```
curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @request.json \
    "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/export"
```
PowerShell（Windows）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/export" | Select-Object -Expand Content
```
次のような JSON レスポンスが返されます。
レスポンス
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}
```
SELECT クエリでデータベースが指定されている場合は、databases プロパティがオーバーライドされます。
以前に設定した IAM ロールを保持する必要がない場合は、この時点で取り消してください。

リクエストのパラメータの一覧については、instances:export ページをご覧ください。

CSV エクスポートファイルの形式をカスタマイズする

CSV ファイル形式は、gcloud または REST API を使用してカスタマイズできます。エクスポートを実行するときに、次のフォーマットオプションを指定できます。

CSV のオプション	デフォルト値	gcloud フラグ	REST API プロパティ	説明
エスケープ	`"5C"` ファイル区切り文字の ASCII 16 進数コード。	`--escape`	`escapeCharacter`	エスケープする必要があるデータ文字の前に表示される文字。 MySQL と PostgreSQL でのみ使用できます。
引用符	`"22"` 二重引用符の ASCII 16 進数コード。	`--quote`	`quoteCharacter`	文字列データ型を持つ列の値を囲む文字。 MySQL と PostgreSQL でのみ使用できます。
フィールド区切り文字	`"2C"` カンマを表す ASCII 16 進数コード。	`--fields-terminated-by`	`fieldsTerminatedBy`	列の値を分割する文字。 MySQL と PostgreSQL でのみ使用できます。
改行文字	`"0A"` 改行を表す ASCII 16 進数コード。	`--lines-terminated-by`	`linesTerminatedBy`	行レコードを分割する文字。 MySQL でのみ使用できます。

たとえば、これらの引数をすべて使用する gcloud コマンドは次のようになります。

gcloud sql export csv INSTANCE_NAME gs://BUCKET_NAME/FILE_NAME \
--database=DATABASE_NAME \
--offload \
--query=SELECT_QUERY \
--quote="22" \
--escape="5C" \
--fields-terminated-by="2C" \
--lines-terminated-by="0A"

同等の REST API リクエストの本文は次のようになります。

{
 "exportContext":
   {
      "fileType": "CSV",
      "uri": "gs://bucket_name/path_to_csv_file",
      "databases": ["DATABASE_NAME"],
      "offload": true,
      "csvExportOptions":
       {
           "selectQuery": "SELECT_QUERY",
           "escapeCharacter":  "5C",
           "quoteCharacter": "22",
           "fieldsTerminatedBy": "2C",
           "linesTerminatedBy": "0A"
       }
   }
}

上記の gcloud と API の例は、次の SQL ステートメントを実行する場合と同じです。

SELECT [QUERY] INTO OUTFILE ... CHARACTER SET 'utf8mb4'
            FIELDS TERMINATED BY ',' OPTIONALLY ENCLOSED BY '\"'
            ESCAPED BY '\\' LINES TERMINATED BY '\n'

Cloud SQL for MySQL にデータをインポートする

Cloud SQL for MySQL へのインポートに必要なロールと権限

Cloud Storage から Cloud SQL にデータをインポートするには、Cloud SQL インスタンスのサービスアカウントまたはユーザーに、次のいずれかのロールの組み合わせが必要です。

Cloud SQL 管理者のロールと storage.objectAdmin IAM ロール
次の権限を含むカスタムロール:
- cloudsql.instances.get
- cloudsql.instances.import
- storage.buckets.get
- storage.objects.get
- storage.objects.list（ファイルの並列インポートのみ）

IAM ロールについては、Identity and Access Management をご覧ください。

ローカル MySQL サーバーから CSV ファイルにデータをエクスポートする

Cloud SQL にインポートする MySQL テーブルをエクスポートするには、次のコマンドを使用してファイルをフォーマットすることをおすすめします。

mysql --host=INSTANCE_IP --user=USER_NAME --password DATABASE \
-e " SELECT * FROM TABLE INTO OUTFILE 'FILE_NAME' CHARACTER SET 'utf8mb4'
     FIELDS TERMINATED BY ',' OPTIONALLY ENCLOSED BY '\"' ESCAPED BY '\"' "

CSV エクスポートファイルの形式をカスタマイズできます。

CSV ファイルから Cloud SQL for MySQL にデータをインポートする

インポート先のデータベースとテーブルが、Cloud SQL インスタンス上に存在している必要があります。データベースの作成方法については、データベースを作成するをご覧ください。
テーブルを作成するには、mysql クライアントの CREATE TABLE SQL ステートメントを使用します。
CSV ファイルは、CSV ファイル形式の要件に従う必要があります。
オンプレミスの MySQL サーバーからエクスポートしたデータをインポートする場合:
1. Cloud Storage にバケットを作成します。
2. Cloud Storage バケットに SQL ダンプファイルをアップロードします。

CSV ファイル形式の要件

CSV ファイルは、データの行ごとに 1 行を使用し、カンマ区切りのフィールドが含まれている必要があります。

CSV ファイルを使用して Cloud SQL インスタンスにデータをインポートする手順は次のとおりです。

Console

Google Cloud コンソールで Cloud SQL の [インスタンス] ページに移動します。

Cloud SQL の [インスタンス] に移動
インスタンスの [概要] ページを開くには、インスタンス名をクリックします。
[インポート] をクリックします。
データのインポート元となるファイルを選択するセクションで、インポートに使用するバケットと CSV ファイルのパスを入力します。または、次のようにしてファイルを参照します。
1. [参照] をクリックします。
2. [ロケーション] セクションで、リスト内のバケット名をダブルクリックします。
3. リストからファイルを選択します。
4. [選択] をクリックします。
圧縮ファイル（.gz）または非圧縮ファイル（.csv）ファイルをインポートできます。
[ファイル形式] セクションで [CSV] を選択します。
CSV ファイルをインポートする Cloud SQL インスタンスの [データベース] と [テーブル] を指定します。
[インポート] をクリックしてインポートを開始します。

gcloud

Cloud Storage バケットを作成します。
ファイルをバケットにアップロードします。

ファイルをバケットにアップロードする方法については、オブジェクトのアップロードをご覧ください。
CSV ファイルからバケットにデータをアップロードします。
エクスポート元の Cloud SQL インスタンスのサービスアカウントを確認します。そのためには、インスタンス名を指定して gcloud sql instances describe コマンドを実行します。出力で serviceAccountEmailAddress フィールドを探します。
```
gcloud sql instances describe INSTANCE_NAME
```
serviceAccountEmailAddress フィールドをコピーします。
gsutil iam を使用して、バケットの Cloud SQL インスタンスサービスアカウントに storage.objectAdmin IAM ロールを付与します。IAM 権限の設定については、IAM 権限の使用をご覧ください。
ファイルをインポートします。
```
gcloud sql import csv INSTANCE_NAME gs://BUCKET_NAME/FILE_NAME \
--database=DATABASE_NAME \
--table=TABLE_NAME
```
import csv コマンドの使用方法については、sql import csv コマンドのリファレンスページをご覧ください。
以前に設定した IAM の権限を保持する必要がない場合は、gsutil iam を使用して削除してください。

REST v1

Cloud Storage バケットを作成します。
ファイルをバケットにアップロードします。

ファイルをバケットにアップロードする方法については、オブジェクトのアップロードをご覧ください。
バケットに対する legacyBucketWriter と objectViewer の IAM ロールをインスタンスに付与します。IAM 権限の設定については、IAM 権限の使用をご覧ください。
ファイルをインポートします。
リクエストのデータを使用する前に、次のように置き換えます。
- project-id: プロジェクト ID
- instance-id: インスタンス ID
- bucket_name: Cloud Storage バケット名
- path_to_csv_file: CSV ファイルへのパス
- database_name: Cloud SQL インスタンス内のデータベースの名前
- table_name: データベーステーブルの名前
- escape_character: エスケープが必要なデータ文字の前に表示する文字。この引数の値は 16 進数 ASCII コード内の文字である必要があります。たとえば、22 は二重引用符を表します。（省略可）
- quote_character: 文字列データ型を持つ列の値を囲む文字。この引数の値は 16 進数 ASCII コード内の文字である必要があります。たとえば、22 は二重引用符を表します。（省略可）
- fields_terminated_by: 列の値を分割する文字。この引数の値は 16 進数 ASCII コード内の文字である必要があります。たとえば、2C はカンマを表します。（省略可）
- lines_terminated_by: 行レコードを分割した文字。この引数の値は 16 進数 ASCII コード内の文字である必要があります。たとえば、0A は新しい行を表します。（省略可）
HTTP メソッドと URL:
```
POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/import
```
リクエストの本文（JSON）:
```
{
 "importContext":
   {
      "fileType": "CSV",
      "uri": "gs://bucket_name/path_to_csv_file",
      "database": "database_name",
      "csvImportOptions":
       {
         "table": "table_name",
         "escapeCharacter": "escape_character",
         "quoteCharacter": "quote_character",
         "fieldsTerminatedBy": "fields_terminated_by",
         "linesTerminatedBy": "lines_terminated_by"
       }
   }
}
```
リクエストを送信するには、次のいずれかのオプションを展開します。
curl（Linux、macOS、Cloud Shell）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。
```
curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @request.json \
    "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/import"
```
PowerShell（Windows）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/import" | Select-Object -Expand Content
```
次のような JSON レスポンスが返されます。
レスポンス
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}
```
このリクエストのパラメータの完全な一覧については、instances:import ページをご覧ください。
以前に設定した IAM 権限を保持する必要がない場合は、権限を削除します。

REST v1beta4

Cloud Storage バケットを作成します。
ファイルをバケットにアップロードします。

ファイルをバケットにアップロードする方法については、オブジェクトのアップロードをご覧ください。
インスタンスにバケットに対する storage.objectAdmin IAM ロールを付与します。IAM 権限の設定については、IAM 権限の使用をご覧ください。
ファイルをインポートします。
リクエストのデータを使用する前に、次のように置き換えます。
- project-id: プロジェクト ID
- instance-id: インスタンス ID
- bucket_name: Cloud Storage バケット名
- path_to_csv_file: CSV ファイルへのパス
- database_name: Cloud SQL インスタンス内のデータベースの名前
- table_name: データベーステーブルの名前
- escape_character: エスケープが必要なデータ文字の前に表示する文字。この引数の値は、ASCII の 16 進数形式にする必要があります。たとえば、22 は二重引用符を表します。（省略可）
- quote_character: 文字列データ型を持つ列の値を囲む文字。この引数の値は、ASCII の 16 進数形式にする必要があります。たとえば、22 は二重引用符を表します。（省略可）
- fields_terminated_by: 列の値を分割する文字。この引数の値は、ASCII の 16 進数形式にする必要があります。たとえば、2C はカンマを表します。（省略可）
- lines_terminated_by: 行レコードを分割した文字。この引数の値は、ASCII の 16 進数形式にする必要があります。たとえば、0A は新しい行を表します。（省略可）
HTTP メソッドと URL:
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/import
```
リクエストの本文（JSON）:
```
{
 "importContext":
   {
      "fileType": "CSV",
      "uri": "gs://bucket_name/path_to_csv_file",
      "database": "database_name",
      "csvImportOptions":
       {
         "table": "table_name",
         "escapeCharacter": "escape_character",
         "quoteCharacter": "quote_character",
         "fieldsTerminatedBy": "fields_terminated_by",
         "linesTerminatedBy": "lines_terminated_by"
       }
   }
}
```
リクエストを送信するには、次のいずれかのオプションを展開します。
curl（Linux、macOS、Cloud Shell）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。
```
curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @request.json \
    "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/import"
```
PowerShell（Windows）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/import" | Select-Object -Expand Content
```
次のような JSON レスポンスが返されます。
レスポンス
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}
```
このリクエストのパラメータの完全な一覧については、instances:import ページをご覧ください。
以前に設定した IAM 権限を保持する必要がない場合は、権限を削除します。

Cloud SQL for MySQL の CSV ファイル形式をカスタマイズする

CSV ファイル形式は、gcloud または REST API を使用してカスタマイズできます。

gcloud コマンドの例を次に示します。

gcloud sql import csv INSTANCE_NAME gs://BUCKET_NAME/FILE_NAME \
--database=DATABASE_NAME \
--table=TABLE_NAME \
--quote="22" \
--escape="5C" \
--fields-terminated-by="2C" \
--lines-terminated-by="0A"

同等の REST API リクエストの本文は次のようになります。

{
 "importContext":
   {
      "fileType": "CSV",
      "uri": "gs://bucket_name/path_to_csv_file",
      "database": ["DATABASE_NAME"],
      "csvImportOptions":
       {
           "table": "TABLE_NAME",
           "escapeCharacter":  "5C",
           "quoteCharacter": "22",
           "fieldsTerminatedBy": "2C",
           "linesTerminatedBy": "0A"
       }
   }
}

上記の gcloud と API の例は、次の SQL ステートメントを実行する場合と同じです。

LOAD DATA LOCAL INFILE ... CHARACTER SET 'utf8mb4'
FIELDS TERMINATED BY ',' OPTIONALLY ENCLOSED BY '\"' ESCAPED BY '\\'.

ERROR_RDBMS のようなエラーが発生した場合、テーブルが存在することを確認してください。存在している場合は、バケットに対して正しい権限があることを確認します。Cloud Storage のアクセス制御の構成について詳しくは、アクセス制御リストの作成と管理をご覧ください。

このタスクのために基盤となる REST API リクエストがどのように作成されるかについては、instances: import ページの API Explorer をご覧ください。

次のステップ

インポートとエクスポートの各オペレーションのステータスのチェック方法について学習する
データのインポートとエクスポートのベストプラクティスについて確認する
インポートとエクスポートの既知の問題

CSV ファイルを使用したエクスポートとインポート

準備

Cloud SQL for MySQL からデータをエクスポートする

Cloud SQL for MySQL からのエクスポートに必要なロールと権限

Cloud SQL for MySQL から CSV ファイルにデータをエクスポートする

Console

gcloud

REST v1

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

CSV エクスポート ファイルの形式をカスタマイズする

Cloud SQL for MySQL にデータをインポートする

Cloud SQL for MySQL へのインポートに必要なロールと権限

ローカル MySQL サーバーから CSV ファイルにデータをエクスポートする

CSV ファイルから Cloud SQL for MySQL にデータをインポートする

CSV ファイル形式の要件

Console

gcloud

REST v1

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

Cloud SQL for MySQL の CSV ファイル形式をカスタマイズする

次のステップ

CSV エクスポートファイルの形式をカスタマイズする