Alat: create_release_config
Membuat konfigurasi rilis baru di repositori Dataform tertentu.
Nilai parameter parent harus dalam format projects/{project_id}/locations/{location}/repositories/{repository}.
release_config_id adalah ID yang ditentukan pengguna untuk konfigurasi rilis. Jika pengguna tidak menentukan ID, buat ID deskriptif singkat menggunakan huruf kecil, angka, dan tanda hubung berdasarkan permintaannya.
Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP create_release_config.
| Permintaan Curl |
|---|
curl --location 'https://dataform.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "create_release_config", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
Skema Input
Pesan permintaan CreateReleaseConfig.
CreateReleaseConfigRequest
| Representasi JSON |
|---|
{
"parent": string,
"releaseConfig": {
object ( |
| Kolom | |
|---|---|
parent |
Wajib. Repositori tempat membuat konfigurasi rilis. Harus dalam format |
releaseConfig |
Wajib. Konfigurasi rilis yang akan dibuat. |
releaseConfigId |
Wajib. ID yang akan digunakan untuk konfigurasi rilis, yang akan menjadi komponen akhir dari nama resource konfigurasi rilis. |
ReleaseConfig
| Representasi JSON |
|---|
{ "name": string, "gitCommitish": string, "codeCompilationConfig": { object ( |
| Kolom | |
|---|---|
name |
ID. Nama konfigurasi rilis. |
gitCommitish |
Wajib. Nama commit/tag/cabang Git tempat repositori harus dikompilasi. Harus ada di repositori jarak jauh. Contoh: - SHA commit: |
codeCompilationConfig |
Opsional. Jika disetel, kolom |
cronSchedule |
Opsional. Jadwal opsional (dalam format cron) untuk pembuatan hasil kompilasi otomatis. |
timeZone |
Opsional. Menentukan zona waktu yang akan digunakan saat menafsirkan cron_schedule. Harus berupa nama zona waktu dari database zona waktu. Jika tidak ditentukan, defaultnya adalah |
recentScheduledReleaseRecords[] |
Hanya output. Catatan 10 upaya rilis terjadwal terbaru, yang diurutkan dalam urutan menurun |
releaseCompilationResult |
Opsional. Nama hasil kompilasi yang saat ini dirilis untuk konfigurasi rilis ini. Nilai ini diperbarui saat hasil kompilasi dibuat secara otomatis dari konfigurasi rilis ini (menggunakan cron_schedule), atau saat resource ini diperbarui oleh panggilan API (mungkin untuk mengembalikan ke rilis sebelumnya). Hasil kompilasi harus dibuat menggunakan konfigurasi rilis ini. Harus dalam format |
disabled |
Opsional. Menonaktifkan pembuatan otomatis hasil kompilasi. |
Kolom union
|
|
internalMetadata |
Hanya output. Semua informasi metadata yang digunakan secara internal untuk menayangkan resource. Misalnya: stempel waktu, tanda, kolom status, dll. Format kolom ini adalah string JSON. |
CodeCompilationConfig
| Representasi JSON |
|---|
{ "defaultDatabase": string, "defaultSchema": string, "defaultLocation": string, "assertionSchema": string, "vars": { string: string, ... }, "databaseSuffix": string, "schemaSuffix": string, "tablePrefix": string, "builtinAssertionNamePrefix": string, "defaultNotebookRuntimeOptions": { object ( |
| Kolom | |
|---|---|
defaultDatabase |
Opsional. Database default (ID project Google Cloud). |
defaultSchema |
Opsional. Skema default (ID set data BigQuery). |
defaultLocation |
Opsional. Lokasi BigQuery default yang akan digunakan. Defaultnya adalah "US". Lihat dokumentasi BigQuery untuk mengetahui daftar lengkap lokasi: https://cloud.google.com/bigquery/docs/locations. |
assertionSchema |
Opsional. Skema default (ID set data BigQuery) untuk pernyataan. |
vars |
Opsional. Variabel buatan pengguna yang tersedia untuk kode project selama kompilasi. Objek yang berisi daftar pasangan |
databaseSuffix |
Opsional. Sufiks yang harus ditambahkan ke semua nama database (ID project Google Cloud). |
schemaSuffix |
Opsional. Sufiks yang harus ditambahkan ke semua nama skema (ID set data BigQuery). |
tablePrefix |
Opsional. Awalan yang harus ditambahkan ke semua nama tabel. |
builtinAssertionNamePrefix |
Opsional. Awalan yang akan ditambahkan ke nama pernyataan bawaan. |
defaultNotebookRuntimeOptions |
Opsional. Opsi runtime notebook default. |
pipelineConfig |
Opsional. Opsi pipeline yang menentukan jenis dan jalur pipeline dalam repositori Git. |
VarsEntry
| Representasi JSON |
|---|
{ "key": string, "value": string } |
| Kolom | |
|---|---|
key |
|
value |
|
NotebookRuntimeOptions
| Representasi JSON |
|---|
{ "aiPlatformNotebookRuntimeTemplate": string, // Union field |
| Kolom | |
|---|---|
aiPlatformNotebookRuntimeTemplate |
Opsional. Nama resource template runtime Colab, yang digunakan untuk membuat runtime bagi eksekusi notebook. Jika tidak ditentukan, runtime akan dibuat dengan spesifikasi default Colab. |
Kolom union execution_sink. Lokasi untuk menyimpan hasil eksekusi notebook. execution_sink hanya ada berupa salah satu diantara berikut: |
|
gcsOutputBucket |
Opsional. Lokasi Google Cloud Storage untuk mengupload hasil. Format: |
Kolom union repository_snapshot_storage. Tujuan snapshot file repositori yang akan tersedia untuk akses hanya baca di dalam runtime notebook repository_snapshot_storage hanya dapat berupa salah satu dari berikut ini: |
|
gcsRepositorySnapshotDestination |
Opsional. Tujuan Google Cloud Storage untuk mengupload snapshot. Untuk URI kosong, nilai defaultnya adalah gcs_output_bucket yang disediakan. Format: |
GcsRepositorySnapshotDestination
| Representasi JSON |
|---|
{ "repositorySnapshotUri": string } |
| Kolom | |
|---|---|
repositorySnapshotUri |
Opsional. Tujuan Google Cloud Storage untuk mengupload snapshot repositori. Format: |
PipelineConfig
| Representasi JSON |
|---|
{
"pipelineType": enum ( |
| Kolom | |
|---|---|
pipelineType |
Wajib. Jenis pipeline. |
path |
Wajib. Jalur relatif dalam repositori Git tempat pipeline ditentukan. Misalnya, untuk pipeline Dataform, ini adalah jalur ke folder tempat |
ScheduledReleaseRecord
| Representasi JSON |
|---|
{ "releaseTime": string, // Union field |
| Kolom | |
|---|---|
releaseTime |
Hanya output. Stempel waktu upaya rilis ini. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
Kolom union result. Hasil upaya rilis ini. result hanya ada berupa salah satu diantara berikut: |
|
compilationResult |
Nama hasil kompilasi yang dibuat, jika berhasil dibuat. Harus dalam format |
errorStatus |
Status error yang terjadi saat upaya membuat hasil kompilasi ini, jika upaya tersebut tidak berhasil. |
Status
| Representasi JSON |
|---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
| Kolom | |
|---|---|
code |
Kode status, harus berupa nilai enum dari |
message |
Pesan error yang ditampilkan ke developer dan seharusnya dalam bahasa Inggris. Setiap pesan error yang ditampilkan kepada pengguna harus dilokalkan dan dikirim di kolom |
details[] |
Daftar pesan yang membawa detail error. Ada seperangkat jenis pesan umum untuk digunakan API. Objek yang berisi kolom tipe arbitrer. Kolom tambahan |
Semua
| Representasi JSON |
|---|
{ "typeUrl": string, "value": string } |
| Kolom | |
|---|---|
typeUrl |
Mengidentifikasi jenis pesan Protobuf yang diserialkan dengan referensi URI yang terdiri dari awalan yang diakhiri dengan garis miring dan nama jenis yang sepenuhnya memenuhi syarat. Contoh: type.googleapis.com/google.protobuf.StringValue String ini harus berisi setidaknya satu karakter Awalan bersifat arbitrer dan implementasi Protobuf diharapkan cukup menghapus semua yang ada hingga dan termasuk Semua string URL jenis harus berupa referensi URI yang valid dengan batasan tambahan (untuk format teks) bahwa konten referensi hanya boleh terdiri dari karakter alfanumerik, escape yang dienkode persen, dan karakter dalam set berikut (tidak termasuk tanda petik terbalik luar): Dalam desain asli |
value |
Berisi serialisasi Protobuf dari jenis yang dijelaskan oleh type_url. String berenkode base64. |
Stempel waktu
| Representasi JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Kolom | |
|---|---|
seconds |
Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z). |
nanos |
Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nanos non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif. |
PipelineType
Jenis pipeline. Periode ini dapat diperpanjang pada masa mendatang. Jika UNSPECIFIED, error akan ditampilkan.
| Enum | |
|---|---|
PIPELINE_TYPE_UNSPECIFIED |
Nilai default. Nilai ini tidak digunakan. |
DATAFORM |
Pipeline Dataform reguler. |
SQL |
Aset file tunggal SQL. |
NOTEBOOK |
Aset file tunggal notebook. |
Skema Output
Menampilkan konfigurasi rilis Dataform.
ReleaseConfig
| Representasi JSON |
|---|
{ "name": string, "gitCommitish": string, "codeCompilationConfig": { object ( |
| Kolom | |
|---|---|
name |
ID. Nama konfigurasi rilis. |
gitCommitish |
Wajib. Nama commit/tag/cabang Git tempat repositori harus dikompilasi. Harus ada di repositori jarak jauh. Contoh: - SHA commit: |
codeCompilationConfig |
Opsional. Jika disetel, kolom |
cronSchedule |
Opsional. Jadwal opsional (dalam format cron) untuk pembuatan hasil kompilasi otomatis. |
timeZone |
Opsional. Menentukan zona waktu yang akan digunakan saat menafsirkan cron_schedule. Harus berupa nama zona waktu dari database zona waktu. Jika tidak ditentukan, defaultnya adalah |
recentScheduledReleaseRecords[] |
Hanya output. Catatan 10 upaya rilis terjadwal terbaru, yang diurutkan dalam urutan menurun |
releaseCompilationResult |
Opsional. Nama hasil kompilasi yang saat ini dirilis untuk konfigurasi rilis ini. Nilai ini diperbarui saat hasil kompilasi dibuat secara otomatis dari konfigurasi rilis ini (menggunakan cron_schedule), atau saat resource ini diperbarui oleh panggilan API (mungkin untuk mengembalikan ke rilis sebelumnya). Hasil kompilasi harus dibuat menggunakan konfigurasi rilis ini. Harus dalam format |
disabled |
Opsional. Menonaktifkan pembuatan otomatis hasil kompilasi. |
Kolom union
|
|
internalMetadata |
Hanya output. Semua informasi metadata yang digunakan secara internal untuk menayangkan resource. Misalnya: stempel waktu, tanda, kolom status, dll. Format kolom ini adalah string JSON. |
CodeCompilationConfig
| Representasi JSON |
|---|
{ "defaultDatabase": string, "defaultSchema": string, "defaultLocation": string, "assertionSchema": string, "vars": { string: string, ... }, "databaseSuffix": string, "schemaSuffix": string, "tablePrefix": string, "builtinAssertionNamePrefix": string, "defaultNotebookRuntimeOptions": { object ( |
| Kolom | |
|---|---|
defaultDatabase |
Opsional. Database default (ID project Google Cloud). |
defaultSchema |
Opsional. Skema default (ID set data BigQuery). |
defaultLocation |
Opsional. Lokasi BigQuery default yang akan digunakan. Defaultnya adalah "US". Lihat dokumentasi BigQuery untuk mengetahui daftar lengkap lokasi: https://cloud.google.com/bigquery/docs/locations. |
assertionSchema |
Opsional. Skema default (ID set data BigQuery) untuk pernyataan. |
vars |
Opsional. Variabel buatan pengguna yang tersedia untuk kode project selama kompilasi. Objek yang berisi daftar pasangan |
databaseSuffix |
Opsional. Sufiks yang harus ditambahkan ke semua nama database (ID project Google Cloud). |
schemaSuffix |
Opsional. Sufiks yang harus ditambahkan ke semua nama skema (ID set data BigQuery). |
tablePrefix |
Opsional. Awalan yang harus ditambahkan ke semua nama tabel. |
builtinAssertionNamePrefix |
Opsional. Awalan yang akan ditambahkan ke nama pernyataan bawaan. |
defaultNotebookRuntimeOptions |
Opsional. Opsi runtime notebook default. |
pipelineConfig |
Opsional. Opsi pipeline yang menentukan jenis dan jalur pipeline dalam repositori Git. |
VarsEntry
| Representasi JSON |
|---|
{ "key": string, "value": string } |
| Kolom | |
|---|---|
key |
|
value |
|
NotebookRuntimeOptions
| Representasi JSON |
|---|
{ "aiPlatformNotebookRuntimeTemplate": string, // Union field |
| Kolom | |
|---|---|
aiPlatformNotebookRuntimeTemplate |
Opsional. Nama resource template runtime Colab, yang digunakan untuk membuat runtime bagi eksekusi notebook. Jika tidak ditentukan, runtime akan dibuat dengan spesifikasi default Colab. |
Kolom union execution_sink. Lokasi untuk menyimpan hasil eksekusi notebook. execution_sink hanya ada berupa salah satu diantara berikut: |
|
gcsOutputBucket |
Opsional. Lokasi Google Cloud Storage untuk mengupload hasil. Format: |
Kolom union repository_snapshot_storage. Tujuan snapshot file repositori yang akan tersedia untuk akses hanya baca di dalam runtime notebook repository_snapshot_storage hanya dapat berupa salah satu dari berikut ini: |
|
gcsRepositorySnapshotDestination |
Opsional. Tujuan Google Cloud Storage untuk mengupload snapshot. Untuk URI kosong, nilai defaultnya adalah gcs_output_bucket yang disediakan. Format: |
GcsRepositorySnapshotDestination
| Representasi JSON |
|---|
{ "repositorySnapshotUri": string } |
| Kolom | |
|---|---|
repositorySnapshotUri |
Opsional. Tujuan Google Cloud Storage untuk mengupload snapshot repositori. Format: |
PipelineConfig
| Representasi JSON |
|---|
{
"pipelineType": enum ( |
| Kolom | |
|---|---|
pipelineType |
Wajib. Jenis pipeline. |
path |
Wajib. Jalur relatif dalam repositori Git tempat pipeline ditentukan. Misalnya, untuk pipeline Dataform, ini adalah jalur ke folder tempat |
ScheduledReleaseRecord
| Representasi JSON |
|---|
{ "releaseTime": string, // Union field |
| Kolom | |
|---|---|
releaseTime |
Hanya output. Stempel waktu upaya rilis ini. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
Kolom union result. Hasil upaya rilis ini. result hanya ada berupa salah satu diantara berikut: |
|
compilationResult |
Nama hasil kompilasi yang dibuat, jika berhasil dibuat. Harus dalam format |
errorStatus |
Status error yang terjadi saat upaya membuat hasil kompilasi ini, jika upaya tersebut tidak berhasil. |
Status
| Representasi JSON |
|---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
| Kolom | |
|---|---|
code |
Kode status, harus berupa nilai enum dari |
message |
Pesan error yang ditampilkan ke developer dan seharusnya dalam bahasa Inggris. Setiap pesan error yang ditampilkan kepada pengguna harus dilokalkan dan dikirim di kolom |
details[] |
Daftar pesan yang membawa detail error. Ada seperangkat jenis pesan umum untuk digunakan API. Objek yang berisi kolom tipe arbitrer. Kolom tambahan |
Semua
| Representasi JSON |
|---|
{ "typeUrl": string, "value": string } |
| Kolom | |
|---|---|
typeUrl |
Mengidentifikasi jenis pesan Protobuf yang diserialkan dengan referensi URI yang terdiri dari awalan yang diakhiri dengan garis miring dan nama jenis yang sepenuhnya memenuhi syarat. Contoh: type.googleapis.com/google.protobuf.StringValue String ini harus berisi setidaknya satu karakter Awalan bersifat arbitrer dan implementasi Protobuf diharapkan cukup menghapus semua yang ada hingga dan termasuk Semua string URL jenis harus berupa referensi URI yang valid dengan batasan tambahan (untuk format teks) bahwa konten referensi hanya boleh terdiri dari karakter alfanumerik, escape yang dienkode persen, dan karakter dalam set berikut (tidak termasuk tanda petik terbalik luar): Dalam desain asli |
value |
Berisi serialisasi Protobuf dari jenis yang dijelaskan oleh type_url. String berenkode base64. |
Stempel waktu
| Representasi JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Kolom | |
|---|---|
seconds |
Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z). |
nanos |
Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nanos non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif. |
PipelineType
Jenis pipeline. Periode ini dapat diperpanjang pada masa mendatang. Jika UNSPECIFIED, error akan ditampilkan.
| Enum | |
|---|---|
PIPELINE_TYPE_UNSPECIFIED |
Nilai default. Nilai ini tidak digunakan. |
DATAFORM |
Pipeline Dataform reguler. |
SQL |
Aset file tunggal SQL. |
NOTEBOOK |
Aset file tunggal notebook. |
Anotasi Alat
Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ❌ | Petunjuk Hanya Baca: ❌ | Petunjuk Dunia Terbuka: ❌