BigQuery 移行の SQL 変換を有効にする

データ ウェアハウスから BigQuery に移行する際に、BigQuery SQL トランスレータを使用して、ソース言語の SQL スクリプトとクエリを GoogleSQL に変換します。

BigQuery では、BigQuery Migration Service の一部として、次の SQL 変換が提供されています。

ソース SQL を変換する前に、use the dwh-migration-dumper ツールを使用して、ソースデータ ウェアハウスから DDL スキーマ メタデータを抽出することをおすすめします。抽出したメタデータを SQL トランスレータで使用すると、SQL 変換の精度を向上させることができます。

このドキュメントでは、SQL トランスレータを使用する前に必要な手順について説明します。また、SQL トランスレータでサポートされている SQL 言語と、SQL 変換がサポートされているリージョンについても説明します。

SQL 変換を有効にする

SQL トランスレータを使用して SQL を変換する前に、次の手順を行います。

BigQuery Migration API を有効にする

2022 年 2 月 15 日より前に Google Cloud CLI プロジェクトを作成した場合は、次の操作を行って BigQuery Migration API を有効にします。

  1. コンソール Google Cloud で、BigQuery Migration API のページに移動します。

    BigQuery Migration API に移動

  2. [有効にする] をクリックします。

必要な権限を追加する

インタラクティブ トランスレータ、Translation API、バッチ SQL トランスレータを使用して変換ジョブを作成するために必要な権限を取得するには、parent リソースに対する次の IAM ロールを付与するよう管理者に依頼してください。

  • 移行ジョブの表示とモニタリング: MigrationWorkflow 閲覧者 (roles/bigquerymigration.viewer)
  • 移行ジョブの送信: MigrationWorkflow 編集者 （roles/bigquerymigration.editor）
  • 入力ファイルと出力ファイル用の Cloud Storage バケットへのアクセス: Storage オブジェクト管理者（roles/storage.objectAdmin）- ソースと宛先の Cloud Storage バケット。

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

これらの事前定義ロールには インタラクティブ トランスレータ、Translation API、バッチ SQL トランスレータを使用して変換ジョブを作成するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

インタラクティブ トランスレータ、Translation API、バッチ SQL トランスレータを使用して変換ジョブを作成するには、次の権限が必要です。

  • bigquerymigration.workflows.create
  • bigquerymigration.workflows.get
  • bigquerymigration.workflows.list
  • bigquerymigration.workflows.delete
  • bigquerymigration.subtasks.get
  • bigquerymigration.subtasks.list
  • storage.objects.get
  • storage.objects.list
  • storage.objects.create

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

サポートされている SQL 言語

BigQuery SQL トランスレータは、次の SQL 言語の GoogleSQL への変換をサポートしています。

  • Amazon Redshift SQL（Redshift2BigQuery_Translation）
  • Apache HiveQL と Beeline CLI（HiveQL2BigQuery_Translation）
  • IBM Netezza SQL と NZPLSQL（Netezza2BigQuery_Translation）
  • Snowflake SQL（Snowflake2BigQuery_Translation）
  • Teradata と Teradata Vantage（Teradata2BigQuery_Translation）
    • SQL
    • 基本的な Teradata Query（BTEQ）
    • Teradata Parallel Transport（TPT）

また、次の SQL 言語の変換は、 プレビューでサポートされています。

  • Apache Impala SQL（Impala2BigQuery_Translation）
  • Apache Spark SQL（SparkSQL2BigQuery_Translation）
  • Azure Synapse T-SQL（AzureSynapse2BigQuery_Translation）
  • GoogleSQL、BigQuery（Bigquery2Bigquery_Translation）
  • Greenplum SQL（Greenplum2BigQuery_Translation）
  • IBM DB2 SQL（Db22BigQuery_Translation）
  • MySQL SQL（MySQL2BigQuery_Translation）
  • Oracle SQL、PL/SQL、Exadata（Oracle2BigQuery_Translation）
  • PostgreSQL SQL（Postgresql2BigQuery_Translation）
  • Trino または PrestoSQL（Presto2BigQuery_Translation）
  • SQL Server T-SQL（SQLServer2BigQuery_Translation）
  • SQLite（SQLite2BigQuery_Translation）
  • Vertica SQL（Vertica2BigQuery_Translation）

ロケーション

BigQuery SQL トランスレータは、次の処理を行うロケーションでのみ使用できます。

リージョンの説明 リージョン名 詳細
アジア太平洋
バンコク asia-southeast3
デリー asia-south2
香港 asia-east2
ジャカルタ asia-southeast2
メルボルン australia-southeast2
ムンバイ asia-south1
大阪 asia-northeast2
ソウル asia-northeast3
シンガポール asia-southeast1
シドニー australia-southeast1
台湾 asia-east1
東京 asia-northeast1
ヨーロッパ
ベルギー europe-west1 リーフアイコン 低 CO2
ベルリン europe-west10
EU（マルチリージョン） eu
フィンランド europe-north1 リーフアイコン 低 CO2
フランクフルト europe-west3
ロンドン europe-west2 リーフアイコン 低 CO2
マドリード europe-southwest1 リーフアイコン 低 CO2
ミラノ europe-west8
オランダ europe-west4 リーフアイコン 低 CO2
パリ europe-west9 リーフアイコン 低 CO2
ストックホルム europe-north2 リーフアイコン 低 CO2
トリノ europe-west12
ワルシャワ europe-central2
チューリッヒ europe-west6 リーフアイコン 低 CO2
南北アメリカ
コロンバス（オハイオ州） us-east5
ダラス us-south1 リーフアイコン 低 CO2
アイオワ us-central1 リーフアイコン 低 CO2
ラスベガス us-west4
ロサンゼルス us-west2
メキシコ northamerica-south1
北バージニア us-east4
オレゴン us-west1 リーフアイコン 低 CO2
ケベック northamerica-northeast1 リーフアイコン 低 CO2
サンパウロ southamerica-east1 リーフアイコン 低 CO2
ソルトレイクシティ us-west3
サンティアゴ southamerica-west1 リーフアイコン 低 CO2
サウスカロライナ us-east1
トロント northamerica-northeast2 リーフアイコン 低 CO2
米国（マルチリージョン） us
アフリカ
ヨハネスブルグ africa-south1
中東
ダンマーム me-central2
ドーハ me-central1
イスラエル me-west1