Menerjemahkan kueri SQL dengan Translation API
Dokumen ini menjelaskan cara menggunakan Translation API di BigQuery untuk menerjemahkan skrip yang ditulis dalam dialek SQL lainnya ke dalam kueri GoogleSQL. Translation API dapat menyederhanakan proses migrasi beban kerja ke BigQuery.
Sebelum memulai
Sebelum Anda mengirimkan tugas terjemahan, selesaikan langkah-langkah berikut:
- Pastikan Anda memiliki semua izin yang diperlukan.
- Mengaktifkan BigQuery Migration API.
- Mengumpulkan file sumber yang berisi skrip dan kueri SQL yang akan diterjemahkan.
- Mengupload file sumber ke Cloud Storage.
Izin yang diperlukan
Untuk mendapatkan izin yang diperlukan guna membuat tugas terjemahan menggunakan Translation API, minta administrator untuk memberi Anda peran IAM MigrationWorkflow Editor (roles/bigquerymigration.editor
) di resource parent
.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.
Peran yang telah ditetapkan ini berisi izin yang diperlukan untuk membuat tugas terjemahan menggunakan Translation API. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk membuat tugas terjemahan menggunakan Translation API:
-
bigquerymigration.workflows.create
-
bigquerymigration.workflows.get
Anda mung juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaanlainnya.
Mengaktifkan BigQuery Migration API
Jika project Google Cloud CLI Anda dibuat sebelum 15 Februari 2022, aktifkan BigQuery Migration API sebagai berikut:
Di konsol Google Cloud, buka halaman BigQuery Migration API.
Klik Enable.
Mengupload file input ke Cloud Storage
Jika ingin menggunakan Konsol Google Cloud atau BigQuery Migration API untuk melakukan tugas terjemahan, Anda harus mengupload file sumber yang berisi kueri dan skrip yang ingin diterjemahkan ke Cloud Storage. Anda juga dapat mengupload file metadata apa pun atau file YAML konfigurasi ke bucket Cloud Storage yang sama yang berisi file sumber. Untuk mengetahui informasi selengkapnya tentang membuat bucket dan mengupload file ke Cloud Storage, lihat Membuat bucket dan Mengupload objek dari sistem file.
Jenis tugas yang didukung
Translation API dapat menerjemahkan dialek SQL berikut ke GoogleSQL:
- Amazon Redshift SQL -
Redshift2BigQuery_Translation
- Apache HiveQL dan Beeline CLI -
HiveQL2BigQuery_Translation
- Apache Spark SQL -
SparkSQL2BigQuery_Translation
- T-SQL Azure Synapse -
AzureSynapse2BigQuery_Translation
- SQL Greenplum -
Greenplum2BigQuery_Translation
- IBM Db2 SQL -
Db22BigQuery_Translation
- IBM Netezza SQL dan NZPLSQL -
Netezza2BigQuery_Translation
- SQL MySQL -
MySQL2BigQuery_Translation
- Oracle SQL, PL/SQL, Exadata -
Oracle2BigQuery_Translation
- SQL PostgreSQL -
Postgresql2BigQuery_Translation
- SQL Presto atau Trino -
Presto2BigQuery_Translation
- SQL Snowflake -
Snowflake2BigQuery_Translation
- SQLite -
SQLite2BigQuery_Translation
- SQL Server T-SQL -
SQLServer2BigQuery_Translation
- Vantage Teradata dan Teradata -
Teradata2BigQuery_Translation
- Vertica SQL -
Vertica2BigQuery_Translation
Lokasi
Translation API tersedia di lokasi pemrosesan berikut:
Deskripsi region | Nama region | Detail | |
---|---|---|---|
Asia Pasifik | |||
Tokyo | asia-northeast1 |
||
Mumbai | asia-south1 |
||
Singapura | asia-southeast1 |
||
Sydney | australia-southeast1 |
||
Eropa | |||
Multi-region di UE | eu |
||
Warsawa | europe-central2 |
||
Finlandia | europe-north1 |
|
|
Madrid | europe-southwest1 |
|
|
Belgia | europe-west1 |
|
|
London | europe-west2 |
|
|
Frankfurt | europe-west3 |
|
|
Belanda | europe-west4 |
|
|
Zürich | europe-west6 |
|
|
Paris | europe-west9 |
|
|
Turin | europe-west12 |
||
Amerika | |||
Sao Paulo | southamerica-east1 |
|
|
Multi-region AS | us |
||
Iowa | us-central1 |
|
|
South Carolina | us-east1 |
||
Northern Virginia | us-east4 |
||
Columbus, Ohio | us-east5 |
||
Dallas | us-south1 |
|
|
Oregon | us-west1 |
|
|
Los Angeles | us-west2 |
||
Salt Lake City | us-west3 |
Mengirim tugas terjemahan
Untuk mengirim tugas terjemahan menggunakan Translation API, gunakan metode projects.locations.workflows.create
dan berikan instance resource MigrationWorkflow
dengan jenis tugas yang didukung.
Contoh: Membuat terjemahan massal
Perintah curl
berikut membuat tugas terjemahan batch tempat file input dan output disimpan di Cloud Storage. Kolom source_target_mapping
berisi daftar yang memetakan entri literal
sumber ke jalur relatif
opsional untuk output target.
curl -d "{ \"tasks\": { string: { \"type\": \"TYPE\", \"translation_details\": { \"target_base_uri\": \"TARGET_BASE\", \"source_target_mapping\": { \"source_spec\": { \"base_uri\": \"BASE\" } }, } } } }" \ -H "Content-Type:application/json" \ -H "Authorization: Bearer TOKEN" -X POST https://bigquerymigration.googleapis.com/v2alpha/projects/PROJECT_ID/locations/LOCATION/workflows
Ganti kode berikut:
TYPE
: jenis tugas terjemahan, yang menentukan dialek sumber dan target.TARGET_BASE
: URI dasar untuk semua output terjemahan.BASE
: URI dasar untuk semua file yang dibaca sebagai sumber untuk diterjemahkan.TOKEN
: token untuk autentikasi. Untuk membuat token, gunakan perintahgcloud auth print-access-token
atau OAuth 2.0 playground (gunakan cakupanhttps://www.googleapis.com/auth/cloud-platform
).PROJECT_ID
: project untuk memproses terjemahan.LOCATION
: lokasi tempat tugas diproses.
Perintah sebelumnya menampilkan respons yang menyertakan ID alur kerja yang ditulis dalam format projects/PROJECT_ID/locations/LOCATION/workflows/WORKFLOW_ID
.
Contoh: Membuat tugas terjemahan interaktif dengan input dan output literal string
Perintah curl
berikut membuat tugas terjemahan dengan input dan output literal
string. Kolom source_target_mapping
berisi daftar yang memetakan
direktori sumber ke jalur relatif opsional untuk output target.
curl -d "{ \"tasks\": { string: { \"type\": \"TYPE\", \"translation_details\": { \"source_target_mapping\": { \"source_spec\": { \"literal\": { \"relative_path\": \"PATH\", \"literal_string\": \"STRING\" } } }, \"target_return_literals\": \"TARGETS\", } } } }" \ -H "Content-Type:application/json" \ -H "Authorization: Bearer TOKEN" -X POST https://bigquerymigration.googleapis.com/v2alpha/projects/PROJECT_ID/locations/LOCATION/workflows
Ganti kode berikut:
TYPE
: jenis tugas terjemahan, yang menentukan dialek sumber dan target.PATH
: ID entri literal, yang mirip dengan nama file atau jalur.STRING
: string data input literal (misalnya, SQL) yang akan diterjemahkan.TARGETS
: target yang diharapkan yang diinginkan pengguna untuk ditampilkan secara langsung dalam respons dalam formatliteral
. ID ini harus dalam format URI target (misalnya, GENERATED_DIR +target_spec.relative_path
+source_spec.literal.relative_path
). Apa pun yang tidak ada dalam daftar ini tidak ditampilkan dalam respons. Direktori yang dihasilkan, GENERATED_DIR untuk terjemahan SQL umum adalahsql/
.TOKEN
: token untuk autentikasi. Untuk membuat token, gunakan perintahgcloud auth print-access-token
atau OAuth 2.0 playground (gunakan cakupanhttps://www.googleapis.com/auth/cloud-platform
).PROJECT_ID
: project untuk memproses terjemahan.LOCATION
: lokasi tempat tugas diproses.
Perintah sebelumnya menampilkan respons yang menyertakan ID alur kerja yang ditulis dalam format projects/PROJECT_ID/locations/LOCATION/workflows/WORKFLOW_ID
.
Pelajari output terjemahan
Setelah menjalankan tugas terjemahan, ambil hasilnya dengan menentukan ID alur kerja tugas terjemahan menggunakan perintah berikut:
curl \ -H "Content-Type:application/json" \ -H "Authorization:Bearer TOKEN" -X GET https://bigquerymigration.googleapis.com/v2alpha/projects/PROJECT_ID/locations/LOCATION/workflows/WORKFLOW_ID
Ganti kode berikut:
TOKEN
: token untuk autentikasi. Untuk membuat token, gunakan perintahgcloud auth print-access-token
atau OAuth 2.0 playground (gunakan cakupanhttps://www.googleapis.com/auth/cloud-platform
).PROJECT_ID
: project untuk memproses terjemahan.LOCATION
: lokasi tempat tugas diproses.WORKFLOW_ID
: ID yang dihasilkan saat Anda membuat alur kerja terjemahan.