Strumento: create_release_config
Crea una nuova configurazione di release in un determinato repository Dataform.
Il valore parametro parent deve essere nel formato projects/{project_id}/locations/{location}/repositories/{repository}.
release_config_id è l'ID definito dall'utente per la configurazione della release. Se l'utente non specifica un ID, genera un ID breve e descrittivo utilizzando lettere minuscole, numeri e trattini in base alla sua richiesta.
Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP create_release_config.
| Richiesta 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 }' |
Schema di input
Messaggio di richiesta di CreateReleaseConfig.
CreateReleaseConfigRequest
| Rappresentazione JSON |
|---|
{
"parent": string,
"releaseConfig": {
object ( |
| Campi | |
|---|---|
parent |
Obbligatorio. Il repository in cui creare la configurazione della release. Deve essere nel formato |
releaseConfig |
Obbligatorio. La configurazione della release da creare. |
releaseConfigId |
Obbligatorio. L'ID da utilizzare per la configurazione della release, che diventerà il componente finale del nome della risorsa della configurazione della release. |
ReleaseConfig
| Rappresentazione JSON |
|---|
{ "name": string, "gitCommitish": string, "codeCompilationConfig": { object ( |
| Campi | |
|---|---|
name |
Identificatore. Il nome della configurazione della release. |
gitCommitish |
Obbligatorio. Nome del commit/tag/branch Git in cui deve essere compilato il repository. Deve esistere nel repository remoto. Esempi: - SHA di un commit: |
codeCompilationConfig |
Facoltativo. Se impostati, i campi di |
cronSchedule |
Facoltativo. Pianificazione facoltativa (in formato cron) per la creazione automatica dei risultati della compilazione. |
timeZone |
Facoltativo. Specifica il fuso orario da utilizzare per interpretare cron_schedule. Deve essere un nome di fuso orario del database dei fusi orari. Se non specificato, il valore predefinito è |
recentScheduledReleaseRecords[] |
Solo output. Record dei 10 tentativi di rilascio pianificato più recenti, ordinati in ordine decrescente di |
releaseCompilationResult |
Facoltativo. Il nome del risultato di compilazione attualmente rilasciato per questa configurazione della release. Questo valore viene aggiornato quando viene creato automaticamente un risultato di compilazione da questa configurazione di rilascio (utilizzando cron_schedule) o quando questa risorsa viene aggiornata tramite chiamata API (ad esempio per eseguire il rollback a una release precedente). Il risultato della compilazione deve essere stato creato utilizzando questa configurazione della release. Deve essere nel formato |
disabled |
Facoltativo. Disattiva la creazione automatica dei risultati di compilazione. |
Campo unione
|
|
internalMetadata |
Solo output. Tutte le informazioni sui metadati utilizzate internamente per pubblicare la risorsa. Ad esempio, timestamp, flag, campi di stato e così via. Il formato di questo campo è una stringa JSON. |
CodeCompilationConfig
| Rappresentazione JSON |
|---|
{ "defaultDatabase": string, "defaultSchema": string, "defaultLocation": string, "assertionSchema": string, "vars": { string: string, ... }, "databaseSuffix": string, "schemaSuffix": string, "tablePrefix": string, "builtinAssertionNamePrefix": string, "defaultNotebookRuntimeOptions": { object ( |
| Campi | |
|---|---|
defaultDatabase |
Facoltativo. Il database predefinito (ID progetto Google Cloud). |
defaultSchema |
Facoltativo. Lo schema predefinito (ID set di dati BigQuery). |
defaultLocation |
Facoltativo. La località BigQuery predefinita da utilizzare. Il valore predefinito è "US". Per un elenco completo delle località, consulta la documentazione di BigQuery: https://cloud.google.com/bigquery/docs/locations. |
assertionSchema |
Facoltativo. Lo schema predefinito (ID set di dati BigQuery) per le asserzioni. |
vars |
Facoltativo. Variabili definite dall'utente rese disponibili al codice del progetto durante la compilazione. Un oggetto contenente un elenco di coppie |
databaseSuffix |
Facoltativo. Il suffisso da aggiungere a tutti i nomi dei database (ID progetto Google Cloud). |
schemaSuffix |
Facoltativo. Il suffisso da aggiungere a tutti i nomi degli schemi (ID set di dati BigQuery). |
tablePrefix |
Facoltativo. Il prefisso da aggiungere all'inizio di tutti i nomi delle tabelle. |
builtinAssertionNamePrefix |
Facoltativo. Il prefisso da anteporre ai nomi delle asserzioni integrate. |
defaultNotebookRuntimeOptions |
Facoltativo. Le opzioni di runtime predefinite del notebook. |
pipelineConfig |
Facoltativo. Le opzioni della pipeline che definiscono il tipo e il percorso della pipeline all'interno del repository Git. |
VarsEntry
| Rappresentazione JSON |
|---|
{ "key": string, "value": string } |
| Campi | |
|---|---|
key |
|
value |
|
NotebookRuntimeOptions
| Rappresentazione JSON |
|---|
{ "aiPlatformNotebookRuntimeTemplate": string, // Union field |
| Campi | |
|---|---|
aiPlatformNotebookRuntimeTemplate |
Facoltativo. Il nome risorsa del template di runtime di Colab, da cui viene creato un runtime per le esecuzioni dei notebook. Se non specificato, viene creato un runtime con le specifiche predefinite di Colab. |
Campo unione execution_sink. La posizione in cui archiviare il risultato dell'esecuzione del notebook. execution_sink può essere solo uno dei seguenti tipi: |
|
gcsOutputBucket |
Facoltativo. La posizione di Google Cloud Storage in cui caricare il risultato. Formato: |
Campo unione repository_snapshot_storage. La destinazione dello snapshot dei file del repository da rendere disponibile per l'accesso in sola lettura all'interno di un runtime del notebook repository_snapshot_storage può essere solo una delle seguenti: |
|
gcsRepositorySnapshotDestination |
Facoltativo. La destinazione Google Cloud Storage in cui caricare lo snapshot. Per l'URI vuoto, il valore predefinito è gcs_output_bucket fornito. Formato: |
GcsRepositorySnapshotDestination
| Rappresentazione JSON |
|---|
{ "repositorySnapshotUri": string } |
| Campi | |
|---|---|
repositorySnapshotUri |
Facoltativo. La destinazione Google Cloud Storage in cui caricare lo snapshot del repository. Formato: |
PipelineConfig
| Rappresentazione JSON |
|---|
{
"pipelineType": enum ( |
| Campi | |
|---|---|
pipelineType |
Obbligatorio. Il tipo di pipeline. |
path |
Obbligatorio. Il percorso relativo all'interno del repository Git in cui è definita la pipeline. Ad esempio, per una pipeline Dataform, è un percorso alla cartella in cui si trova |
ScheduledReleaseRecord
| Rappresentazione JSON |
|---|
{ "releaseTime": string, // Union field |
| Campi | |
|---|---|
releaseTime |
Solo output. Il timestamp di questo tentativo di rilascio. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
Campo unione result. Il risultato di questo tentativo di rilascio. result può essere solo uno dei seguenti tipi: |
|
compilationResult |
Il nome del risultato della compilazione creato, se ne è stato creato uno. Deve essere nel formato |
errorStatus |
Lo stato di errore riscontrato durante questo tentativo di creare il risultato di compilazione, se il tentativo non è andato a buon fine. |
Stato
| Rappresentazione JSON |
|---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
| Campi | |
|---|---|
code |
Il codice di stato, che deve essere un valore enum di |
message |
Un messaggio di errore rivolto agli sviluppatori, che deve essere in inglese. Qualsiasi messaggio di errore rivolto agli utenti deve essere localizzato e inviato nel campo |
details[] |
Un elenco di messaggi contenenti i dettagli dell'errore. Esiste un insieme comune di tipi di messaggi da utilizzare per le API. Un oggetto contenente campi di tipo arbitrario. Un campo aggiuntivo |
Qualsiasi
| Rappresentazione JSON |
|---|
{ "typeUrl": string, "value": string } |
| Campi | |
|---|---|
typeUrl |
Identifica il tipo di messaggio Protobuf serializzato con un riferimento URI costituito da un prefisso che termina con una barra e il nome del tipo completo. Esempio: type.googleapis.com/google.protobuf.StringValue Questa stringa deve contenere almeno un carattere Il prefisso è arbitrario e le implementazioni di Protobuf devono semplicemente rimuovere tutto fino all'ultimo Tutte le stringhe URL di tipo devono essere riferimenti URI validi con l'ulteriore limitazione (per il formato di testo) che il contenuto del riferimento deve essere costituito solo da caratteri alfanumerici, sequenze di escape codificate in percentuale e caratteri del seguente insieme (senza includere gli apici inversi esterni): Nella progettazione originale di |
value |
Contiene una serializzazione Protobuf del tipo descritto da type_url. Una stringa con codifica in base64. |
Timestamp
| Rappresentazione JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Campi | |
|---|---|
seconds |
Rappresenta i secondi di tempo UTC trascorsi dall'epoca di Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z). |
nanos |
Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la parte in nanosecondi della durata, non un'alternativa ai secondi. I valori negativi dei secondi con frazioni devono comunque avere valori di nanosecondi non negativi che vengono conteggiati in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi. |
PipelineType
Il tipo di pipeline. Questo periodo potrebbe essere esteso in futuro. In caso di UNSPECIFIED, l'errore verrà generato.
| Enum | |
|---|---|
PIPELINE_TYPE_UNSPECIFIED |
Valore predefinito. Questo valore non viene utilizzato. |
DATAFORM |
Pipeline Dataform normale. |
SQL |
Asset di un singolo file SQL. |
NOTEBOOK |
Asset di un singolo file del notebook. |
Schema di output
Rappresenta una configurazione della release Dataform.
ReleaseConfig
| Rappresentazione JSON |
|---|
{ "name": string, "gitCommitish": string, "codeCompilationConfig": { object ( |
| Campi | |
|---|---|
name |
Identificatore. Il nome della configurazione della release. |
gitCommitish |
Obbligatorio. Nome del commit/tag/branch Git in cui deve essere compilato il repository. Deve esistere nel repository remoto. Esempi: - SHA di un commit: |
codeCompilationConfig |
Facoltativo. Se impostati, i campi di |
cronSchedule |
Facoltativo. Pianificazione facoltativa (in formato cron) per la creazione automatica dei risultati della compilazione. |
timeZone |
Facoltativo. Specifica il fuso orario da utilizzare per interpretare cron_schedule. Deve essere un nome di fuso orario del database dei fusi orari. Se non specificato, il valore predefinito è |
recentScheduledReleaseRecords[] |
Solo output. Record dei 10 tentativi di rilascio pianificato più recenti, ordinati in ordine decrescente di |
releaseCompilationResult |
Facoltativo. Il nome del risultato di compilazione attualmente rilasciato per questa configurazione della release. Questo valore viene aggiornato quando viene creato automaticamente un risultato di compilazione da questa configurazione di rilascio (utilizzando cron_schedule) o quando questa risorsa viene aggiornata tramite chiamata API (ad esempio per eseguire il rollback a una release precedente). Il risultato della compilazione deve essere stato creato utilizzando questa configurazione della release. Deve essere nel formato |
disabled |
Facoltativo. Disattiva la creazione automatica dei risultati di compilazione. |
Campo unione
|
|
internalMetadata |
Solo output. Tutte le informazioni sui metadati utilizzate internamente per pubblicare la risorsa. Ad esempio, timestamp, flag, campi di stato e così via. Il formato di questo campo è una stringa JSON. |
CodeCompilationConfig
| Rappresentazione JSON |
|---|
{ "defaultDatabase": string, "defaultSchema": string, "defaultLocation": string, "assertionSchema": string, "vars": { string: string, ... }, "databaseSuffix": string, "schemaSuffix": string, "tablePrefix": string, "builtinAssertionNamePrefix": string, "defaultNotebookRuntimeOptions": { object ( |
| Campi | |
|---|---|
defaultDatabase |
Facoltativo. Il database predefinito (ID progetto Google Cloud). |
defaultSchema |
Facoltativo. Lo schema predefinito (ID set di dati BigQuery). |
defaultLocation |
Facoltativo. La località BigQuery predefinita da utilizzare. Il valore predefinito è "US". Per un elenco completo delle località, consulta la documentazione di BigQuery: https://cloud.google.com/bigquery/docs/locations. |
assertionSchema |
Facoltativo. Lo schema predefinito (ID set di dati BigQuery) per le asserzioni. |
vars |
Facoltativo. Variabili definite dall'utente rese disponibili al codice del progetto durante la compilazione. Un oggetto contenente un elenco di coppie |
databaseSuffix |
Facoltativo. Il suffisso da aggiungere a tutti i nomi dei database (ID progetto Google Cloud). |
schemaSuffix |
Facoltativo. Il suffisso da aggiungere a tutti i nomi degli schemi (ID set di dati BigQuery). |
tablePrefix |
Facoltativo. Il prefisso da aggiungere all'inizio di tutti i nomi delle tabelle. |
builtinAssertionNamePrefix |
Facoltativo. Il prefisso da anteporre ai nomi delle asserzioni integrate. |
defaultNotebookRuntimeOptions |
Facoltativo. Le opzioni di runtime predefinite del notebook. |
pipelineConfig |
Facoltativo. Le opzioni della pipeline che definiscono il tipo e il percorso della pipeline all'interno del repository Git. |
VarsEntry
| Rappresentazione JSON |
|---|
{ "key": string, "value": string } |
| Campi | |
|---|---|
key |
|
value |
|
NotebookRuntimeOptions
| Rappresentazione JSON |
|---|
{ "aiPlatformNotebookRuntimeTemplate": string, // Union field |
| Campi | |
|---|---|
aiPlatformNotebookRuntimeTemplate |
Facoltativo. Il nome risorsa del template di runtime di Colab, da cui viene creato un runtime per le esecuzioni dei notebook. Se non specificato, viene creato un runtime con le specifiche predefinite di Colab. |
Campo unione execution_sink. La posizione in cui archiviare il risultato dell'esecuzione del notebook. execution_sink può essere solo uno dei seguenti tipi: |
|
gcsOutputBucket |
Facoltativo. La posizione di Google Cloud Storage in cui caricare il risultato. Formato: |
Campo unione repository_snapshot_storage. La destinazione dello snapshot dei file del repository da rendere disponibile per l'accesso in sola lettura all'interno di un runtime del notebook repository_snapshot_storage può essere solo una delle seguenti: |
|
gcsRepositorySnapshotDestination |
Facoltativo. La destinazione Google Cloud Storage in cui caricare lo snapshot. Per l'URI vuoto, il valore predefinito è gcs_output_bucket fornito. Formato: |
GcsRepositorySnapshotDestination
| Rappresentazione JSON |
|---|
{ "repositorySnapshotUri": string } |
| Campi | |
|---|---|
repositorySnapshotUri |
Facoltativo. La destinazione Google Cloud Storage in cui caricare lo snapshot del repository. Formato: |
PipelineConfig
| Rappresentazione JSON |
|---|
{
"pipelineType": enum ( |
| Campi | |
|---|---|
pipelineType |
Obbligatorio. Il tipo di pipeline. |
path |
Obbligatorio. Il percorso relativo all'interno del repository Git in cui è definita la pipeline. Ad esempio, per una pipeline Dataform, è un percorso alla cartella in cui si trova |
ScheduledReleaseRecord
| Rappresentazione JSON |
|---|
{ "releaseTime": string, // Union field |
| Campi | |
|---|---|
releaseTime |
Solo output. Il timestamp di questo tentativo di rilascio. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
Campo unione result. Il risultato di questo tentativo di rilascio. result può essere solo uno dei seguenti tipi: |
|
compilationResult |
Il nome del risultato della compilazione creato, se ne è stato creato uno. Deve essere nel formato |
errorStatus |
Lo stato di errore riscontrato durante questo tentativo di creare il risultato di compilazione, se il tentativo non è andato a buon fine. |
Stato
| Rappresentazione JSON |
|---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
| Campi | |
|---|---|
code |
Il codice di stato, che deve essere un valore enum di |
message |
Un messaggio di errore rivolto agli sviluppatori, che deve essere in inglese. Qualsiasi messaggio di errore rivolto agli utenti deve essere localizzato e inviato nel campo |
details[] |
Un elenco di messaggi contenenti i dettagli dell'errore. Esiste un insieme comune di tipi di messaggi da utilizzare per le API. Un oggetto contenente campi di tipo arbitrario. Un campo aggiuntivo |
Qualsiasi
| Rappresentazione JSON |
|---|
{ "typeUrl": string, "value": string } |
| Campi | |
|---|---|
typeUrl |
Identifica il tipo di messaggio Protobuf serializzato con un riferimento URI costituito da un prefisso che termina con una barra e il nome del tipo completo. Esempio: type.googleapis.com/google.protobuf.StringValue Questa stringa deve contenere almeno un carattere Il prefisso è arbitrario e le implementazioni di Protobuf devono semplicemente rimuovere tutto fino all'ultimo Tutte le stringhe URL di tipo devono essere riferimenti URI validi con l'ulteriore limitazione (per il formato di testo) che il contenuto del riferimento deve essere costituito solo da caratteri alfanumerici, sequenze di escape codificate in percentuale e caratteri del seguente insieme (senza includere gli apici inversi esterni): Nella progettazione originale di |
value |
Contiene una serializzazione Protobuf del tipo descritto da type_url. Una stringa con codifica in base64. |
Timestamp
| Rappresentazione JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Campi | |
|---|---|
seconds |
Rappresenta i secondi di tempo UTC trascorsi dall'epoca di Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z). |
nanos |
Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la parte in nanosecondi della durata, non un'alternativa ai secondi. I valori negativi dei secondi con frazioni devono comunque avere valori di nanosecondi non negativi che vengono conteggiati in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi. |
PipelineType
Il tipo di pipeline. Questo periodo potrebbe essere esteso in futuro. In caso di UNSPECIFIED, l'errore verrà generato.
| Enum | |
|---|---|
PIPELINE_TYPE_UNSPECIFIED |
Valore predefinito. Questo valore non viene utilizzato. |
DATAFORM |
Pipeline Dataform normale. |
SQL |
Asset di un singolo file SQL. |
NOTEBOOK |
Asset di un singolo file del notebook. |
Annotazioni dello strumento
Suggerimento distruttivo: ❌ | Suggerimento idempotente: ❌ | Suggerimento di sola lettura: ❌ | Suggerimento open world: ❌