MCP Tools Reference: dataform.googleapis.com

Strumento: get_release_config

Recupera una singola configurazione della release Dataform.

Il valore parametro name deve essere nel formato projects/{project_id}/locations/{location}/repositories/{repository}/releaseConfigs/{release_config}.

Il seguente esempio di codice mostra come utilizzare curl per chiamare lo strumento MCP get_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": "get_release_config",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

GetReleaseConfig messaggio di richiesta.

GetReleaseConfigRequest

Rappresentazione JSON 
{
  "name": string
}
Campi
name

string

Obbligatorio. Il nome della configurazione della release.

Schema di output

Rappresenta una configurazione della release Dataform.

ReleaseConfig

Rappresentazione JSON 
{
  "name": string,
  "gitCommitish": string,
  "codeCompilationConfig": {
    object (CodeCompilationConfig)
  },
  "cronSchedule": string,
  "timeZone": string,
  "recentScheduledReleaseRecords": [
    {
      object (ScheduledReleaseRecord)
    }
  ],
  "releaseCompilationResult": string,
  "disabled": boolean,

  // Union field _internal_metadata can be only one of the following:
  "internalMetadata": string
  // End of list of possible types for union field _internal_metadata.
}
Campi
name

string

Identificatore. Il nome della configurazione della release.
gitCommitish

string

Obbligatorio. Nome del commit/tag/branch Git in cui deve essere compilato il repository. Deve esistere nel repository remoto. Esempi: - SHA di un commit: 12ade345 - un tag: tag1 - un nome di branch: branch1
codeCompilationConfig

object (CodeCompilationConfig)

Facoltativo. Se impostati, i campi di code_compilation_config sostituiscono le impostazioni di compilazione predefinite specificate in dataform.json.
cronSchedule

string

Facoltativo. Pianificazione facoltativa (in formato cron) per la creazione automatica dei risultati della compilazione.
timeZone

string

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 è UTC.
recentScheduledReleaseRecords[]

object (ScheduledReleaseRecord)

Solo output. Record dei 10 tentativi di rilascio pianificato più recenti, ordinati in ordine decrescente di release_time. Aggiornato ogni volta che la creazione automatica di un risultato di compilazione viene attivata da cron_schedule.
releaseCompilationResult

string

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 projects/*/locations/*/repositories/*/compilationResults/*.
disabled

boolean

Facoltativo. Disattiva la creazione automatica dei risultati di compilazione.

Campo unione _internal_metadata.

_internal_metadata può essere solo uno dei seguenti tipi:
internalMetadata

string

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 (NotebookRuntimeOptions)
  },
  "pipelineConfig": {
    object (PipelineConfig)
  }
}
Campi
defaultDatabase

string

Facoltativo. Il database predefinito (ID progetto Google Cloud).
defaultSchema

string

Facoltativo. Lo schema predefinito (ID set di dati BigQuery).
defaultLocation

string

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

string

Facoltativo. Lo schema predefinito (ID set di dati BigQuery) per le asserzioni.
vars

map (key: string, value: string)

Facoltativo. Variabili definite dall'utente rese disponibili al codice del progetto durante la compilazione.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
databaseSuffix

string

Facoltativo. Il suffisso da aggiungere a tutti i nomi dei database (ID progetto Google Cloud).
schemaSuffix

string

Facoltativo. Il suffisso da aggiungere a tutti i nomi degli schemi (ID set di dati BigQuery).
tablePrefix

string

Facoltativo. Il prefisso da aggiungere all'inizio di tutti i nomi delle tabelle.
builtinAssertionNamePrefix

string

Facoltativo. Il prefisso da anteporre ai nomi delle asserzioni integrate.
defaultNotebookRuntimeOptions

object (NotebookRuntimeOptions)

Facoltativo. Le opzioni di runtime predefinite del notebook.
pipelineConfig

object (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

string
value

string

NotebookRuntimeOptions

Rappresentazione JSON 
{
  "aiPlatformNotebookRuntimeTemplate": string,

  // Union field execution_sink can be only one of the following:
  "gcsOutputBucket": string
  // End of list of possible types for union field execution_sink.

  // Union field repository_snapshot_storage can be only one of the following:
  "gcsRepositorySnapshotDestination": {
    object (GcsRepositorySnapshotDestination)
  }
  // End of list of possible types for union field repository_snapshot_storage.
}
Campi
aiPlatformNotebookRuntimeTemplate

string

Facoltativo. Il nome della 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. Il percorso in cui archiviare il risultato dell'esecuzione del notebook. execution_sink può essere solo uno dei seguenti tipi:
gcsOutputBucket

string

Facoltativo. La posizione di Google Cloud Storage in cui caricare il risultato. Formato: gs://bucket-name.
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

object (GcsRepositorySnapshotDestination)

Facoltativo. La destinazione Google Cloud Storage in cui caricare lo snapshot. Per l'URI vuoto, il valore predefinito è gcs_output_bucket fornito. Formato: gs://bucket-name/path/.

GcsRepositorySnapshotDestination

Rappresentazione JSON 
{
  "repositorySnapshotUri": string
}
Campi
repositorySnapshotUri

string

Facoltativo. La destinazione Google Cloud Storage in cui caricare lo snapshot del repository. Formato: gs://bucket-name/path/.

PipelineConfig

Rappresentazione JSON 
{
  "pipelineType": enum (PipelineType),
  "path": string
}
Campi
pipelineType

enum (PipelineType)

Obbligatorio. Il tipo di pipeline.
path

string

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 workflow_settings.yaml o dataform.json.

ScheduledReleaseRecord

Rappresentazione JSON 
{
  "releaseTime": string,

  // Union field result can be only one of the following:
  "compilationResult": string,
  "errorStatus": {
    object (Status)
  }
  // End of list of possible types for union field result.
}
Campi
releaseTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
Campo unione result. Il risultato di questo tentativo di rilascio. result può essere solo uno dei seguenti tipi:
compilationResult

string

Il nome del risultato della compilazione creato, se ne è stato creato uno. Deve essere nel formato projects/*/locations/*/repositories/*/compilationResults/*.
errorStatus

object (Status)

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

integer

Il codice di stato, che deve essere un valore enum di google.rpc.Code.
message

string

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 google.rpc.Status.details o localizzato dal client.
details[]

object

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 "@type" contenente un URI che identifica il tipo. Esempio: { "id": 1234, "@type": "types.example.com/standard/id" }.

Qualsiasi

Rappresentazione JSON 
{
  "typeUrl": string,
  "value": string
}
Campi
typeUrl

string

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 / e il contenuto dopo l'ultimo / deve essere il nome completo del tipo in forma canonica, senza un punto iniziale. Non scrivere uno schema su questi riferimenti URI in modo che i client non tentino di contattarli.

Il prefisso è arbitrario e le implementazioni di Protobuf devono semplicemente rimuovere tutto fino all'ultimo / incluso per identificare il tipo. type.googleapis.com/ è un prefisso predefinito comune richiesto da alcune implementazioni legacy. Questo prefisso non indica l'origine del tipo e non è previsto che gli URI che lo contengono rispondano a richieste.

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): /-.~_!$&()*+,;=. Nonostante consentiamo le codifiche in percentuale, le implementazioni non devono decodificarle per evitare confusione con i parser esistenti. Ad esempio, type.googleapis.com%2FFoo deve essere rifiutato.

Nella progettazione originale di Any, è stata presa in considerazione la possibilità di avviare un servizio di risoluzione dei tipi in questi URL di tipo, ma Protobuf non ne ha mai implementato uno e considera il contatto con questi URL problematico e un potenziale problema di sicurezza. Non tentare di contattare gli URL dei tipi.
value

string (bytes format)

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

string (int64 format)

Rappresenta i secondi di tempo UTC 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

integer

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

Le annotazioni dello strumento vengono inviate ai client MCP per descrivere il rischio di base di un determinato strumento. La maggior parte dei client considera questi suggerimenti non attendibili, ma possono essere utilizzati per decidere quando inviare a un utente una richiesta di conferma.

Oltre alla stringa del titolo, sono definiti i seguenti suggerimenti booleani:

  • readOnlyHint: se è true, lo strumento non modifica il suo ambiente. Valore predefinito: false.
  • destructiveHint: se è true, lo strumento può eseguire azioni distruttive. Se il valore è false, lo strumento può eseguire solo azioni additive. Valore predefinito: true.
  • idempotentHint: se è true, chiamare ripetutamente lo strumento con gli stessi argomenti non avrà alcun effetto aggiuntivo sul suo ambiente. Valore predefinito: false.
  • openWorldHint: se è true, lo strumento può interagire con un "open world" di entità esterne. Se è false, lo strumento può interagire solo con le entità interne. Ad esempio, uno strumento di ricerca web sarebbe open world, mentre uno strumento di memoria no.

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌