Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

SQL ファイルをインポートする

SQL コマンドの書式なしテキストスクリプトからデータベースを再構築するには、Cloud Storage バケットに保存されている SQL ファイルを AlloyDB for PostgreSQL クラスタにインポートします。

AlloyDB クラスタへのデータのインポートをキャンセルできます。詳細については、インポートオペレーションをキャンセルするをご覧ください。

SQL ダンプファイルをインポートするときは、ダンプの作成元の PostgreSQL バージョンが AlloyDB インスタンスの PostgreSQL バージョンと互換性があることを確認してください。上位バージョンから下位バージョンにダンプファイルをインポートすると、SQL 構文の互換性がないために失敗することがあります。

始める前に

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

データベースに十分な保存容量があることを確認します。
インポートオペレーションではデータベースリソースが使用されますが、クラスタのプロビジョニングが不足していない限り、インポートによって通常のデータベースオペレーションが妨げられることはありません。

AlloyDB へのインポートに必要なロールと権限

Cloud Storage から AlloyDB にデータをインポートするには、インポートを開始するユーザーに次のいずれかのロールが必要です。

AlloyDB 管理者ロール
次の権限を含むカスタムロール:
- alloydb.clusters.get
- alloydb.clusters.import

また、AlloyDB クラスタのサービスアカウントには、次のいずれかのロールが必要です。

storage.objectViewer IAM ロール
次の権限を含むカスタムロール:
- storage.objects.get

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

SQL ファイルを AlloyDB クラスタにインポートする

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

コンソール

Google Cloud コンソールで、[クラスタ] ページに移動します。

[クラスタ] に移動
クラスタ名をクリックして、そのクラスタの [概要] ページを開きます。
[インポート] をクリックします。
[ファイル形式] で [SQL] を選択します。
[ソースファイルを選択] で、パソコンからファイルをアップロードするか、Cloud Storage のロケーションからファイルを選択するかを選択します。
1. パソコンからファイルをアップロードする手順は次のとおりです。
  1. [パソコンからファイルをアップロードする] を選択します。
  2. [ローカルファイルの選択] の横にある [参照] をクリックして、ローカルマシンから SQL ファイルを選択します。
  3. [Cloud Storage のロケーションを選択します] の横にある [参照] をクリックして、アップロードしたローカルファイルを保存する Cloud Storage のロケーションを選択します。
  4. [アップロード] をクリックして、ファイルをアップロードします。
2. Cloud Storage バケットに存在している SQL ファイルを選択するには、次の操作を行います。
  1. [Google Cloud Storage からファイルを選択] を選択します。
  2. [bucket-name/file-name] の横にある [参照] をクリックして、Cloud Storage バケットから SQL ファイルを選択します。
[データベース] プルダウンメニューから、データをインポートするデータベースを選択します。

SQL ダンプファイルに \connect（または \c）メタコマンドが含まれている場合は、 Google Cloud コンソールで選択したターゲットデータベースがオーバーライドされます。
省略可: インポートオペレーションに対してユーザーを指定するには、[ユーザーオプションを表示] をクリックし、[ユーザー] フィールドにユーザー名を入力します。
インポートオペレーションを開始するには、[インポート] をクリックします。

gcloud

Cloud Storage バケットを作成します。
SQL ファイルをバケットにアップロードします。ファイルをバケットにアップロードする方法については、オブジェクトのアップロードをご覧ください。
gcloud storage buckets add-iam-policy-binding を使用して、バケットの AlloyDB クラスタのサービスアカウントに storage.objectViewer IAM ロールを付与します。
```
service-PROJECT_NUMBER@gcp-sa-alloydb.iam.gserviceaccount.com
```
IAM 権限の設定については、IAM 権限の使用をご覧ください。
ファイルをインポートします。
```
gcloud alloydb clusters import CLUSTER_NAME \
  --region=REGION \
  --database=DATABASE_NAME \
  --gcs-uri='gs://BUCKET_NAME/PATH_TO_SQL_FILE' \
  --user=USERNAME \
  --sql
```
注: 圧縮ファイル（.gz）または非圧縮ファイル（.sql）をインポートできます。

次のように置き換えます。
- CLUSTER_NAME: クラスタの名前。
- REGION: AlloyDB クラスタがデプロイされているリージョン。
- DATABASE_NAME: クラスタ内のデータベースの名前。
- BUCKET_NAME: Cloud Storage バケット名。
- PATH_TO_SQL_FILE: SQL ファイルへのパス
- USERNAME: インポートオペレーションのユーザー。
コマンドから PERMISSION_DENIED のようなエラーが返された場合は、権限を確認してください。

import コマンドの使用方法については、gcloud alloydb clusters import コマンドのリファレンスページをご覧ください。
以前に設定した IAM 権限を保持する必要がない場合は、gcloud storage buckets remove-iam-policy-binding を使用して削除します。

REST v1

Cloud Storage バケットを作成します。
SQL ファイルをバケットにアップロードします。ファイルをバケットにアップロードする方法については、オブジェクトのアップロードをご覧ください。
gcloud storage buckets add-iam-policy-binding を使用して、バケットの AlloyDB クラスタのサービスアカウントに storage.objectViewer IAM ロールを付与します。サービスアカウントの形式は次のとおりです。
```
service-PROJECT_NUMBER@gcp-sa-alloydb.iam.gserviceaccount.com
```
IAM 権限の設定については、IAM 権限の使用をご覧ください。
SQL ファイルをインポートします。

注: 圧縮ファイル（.gz）または非圧縮ファイル（.sql）をインポートできます。

次の HTTP メソッドと URL を使用します。
```
POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID:import
```
リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: プロジェクト ID。
- LOCATION_ID: AlloyDB クラスタがデプロイされているリージョン。
- CLUSTER_ID: クラスタ ID。
- BUCKET_NAME: Cloud Storage バケット名。
- PATH_TO_SQL_FILE: SQL ファイルへのパス
- USER: インポートに使用するユーザー。
- DATABASE_NAME: AlloyDB クラスタ内のデータベースの名前。
リクエストの本文（JSON）:
```
{
   "gcsUri": "gs://BUCKET_NAME/PATH_TO_SQL_FILE",
   "database": "DATABASE_NAME",
   "user": "USER",
   "sqlImportOptions": {}
}
```
リクエストを送信するには、次のいずれかのオプションを展開します。
curl（Linux、macOS、Cloud Shell）

次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで Google Cloud 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://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID:import"
```
PowerShell（Windows）

次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで Google Cloud 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://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID:import"| Select-Object -Expand Content
```
次のような JSON レスポンスが返されます。
レスポンス
```
{
 "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
 "metadata": {
  "@type": "type.googleapis.com/google.cloud.alloydb.v1.OperationMetadata",
  "createTime": "2025-01-04T13:12:32.363393723Z",
  "target": "projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID",
  "verb": "import",
  "requestedCancellation": false,
  "apiVersion": "v1"
 },
 "done": false
}
```
別のユーザーがインポートするには、ユーザープロパティを指定します。
以前に設定した IAM 権限を保持する必要がない場合は、削除してください。

リクエストのパラメータの一覧については、clusters.import をご覧ください。

インポートオペレーションのステータスを確認する

インポートオペレーションのステータスを確認する手順は次のとおりです。

gcloud

gcloud alloydb operations describe コマンドを使用して、実行します。

gcloud alloydb operations describe OPERATION_ID --region=REGION

特定のオペレーションの詳細の一覧表示や、特定のオペレーションのキャンセルもできます。このコマンドの詳細については、gcloud alloydb operations コマンドのリファレンスページをご覧ください。

REST v1

GET メソッドと次の URL を使用します。

GET https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID

詳細については、get をご覧ください。

リクエストのデータを使用する前に、次のように置き換えます。

REGION: AlloyDB クラスタがデプロイされているリージョン。
PROJECT_ID: プロジェクト ID。
OPERATION_ID: インポートオペレーションの ID。詳細については、始める前にをご覧ください。

リクエストを送信するには、次のいずれかのオプションを開きます。

curl（Linux、macOS、Cloud Shell）

次のコマンドを実行します。

  curl -X GET \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID

PowerShell（Windows）

次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method GET `
  -Headers $headers `
  -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID" | Select-Object -Expand Content

成功した場合、レスポンスの本文には Operation のインスタンスが含まれます。

次のステップ

CSV ファイルをインポートする方法を確認する
インポートオペレーションをキャンセルする方法を確認する。

SQL ファイルをインポートする コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

始める前に

AlloyDB へのインポートに必要なロールと権限

SQL ファイルを AlloyDB クラスタにインポートする

コンソール

gcloud

REST v1

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

インポート オペレーションのステータスを確認する

gcloud

REST v1

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

次のステップ

SQL ファイルをインポートする

インポートオペレーションのステータスを確認する