Strumento: import_data
Importa i dati in un'istanza Cloud SQL.
Se il file non inizia con gs://, si presume che sia archiviato localmente. Se il file è locale, deve essere caricato in Cloud Storage prima di poter effettuare la chiamata import_data effettiva. Per caricare il file su Cloud Storage, puoi utilizzare i comandi gcloud o gsutil.
Prima di caricare il file su Cloud Storage, valuta se vuoi utilizzare un bucket esistente o crearne uno nuovo nel progetto fornito.
Dopo il caricamento del file su Cloud Storage, il account di servizio dell'istanza deve disporre di autorizzazioni sufficienti per leggere il file caricato dal bucket Cloud Storage.
A questo scopo:
- Utilizza lo strumento
get_instanceper ottenere l'indirizzo email del account di servizio dell'istanza. Dall'output dello strumento, ottieni il valore del camposerviceAccountEmailAddress. - Concedi al account di servizio dell'istanza il ruolo
storage.objectAdminsul bucket Cloud Storage fornito. Utilizza un comando comegcloud storage buckets add-iam-policy-bindingo una richiesta all'API Storage di Cloud Storage. La concessione del ruolo e la propagazione delle autorizzazioni al account di servizio in Cloud Storage possono richiedere da due a sette minuti o più. Se si verifica un errore di autorizzazione dopo l'aggiornamento della policy IAM, attendi qualche minuto e riprova.
Una volta concesse le autorizzazioni, puoi importare i dati. Ti consigliamo di lasciare vuoti i parametri facoltativi e di utilizzare i valori predefiniti di sistema. Il tipo di file può essere generalmente determinato dall'estensione del file. Ad esempio, se il file è un file SQL, .sql o .csv per il file CSV.
Di seguito è riportato un esempio di SQL importContext per MySQL.
{
"uri": "gs://sample-gcs-bucket/sample-file.sql",
"kind": "sql#importContext",
"fileType": "SQL"
}
Per MySQL non è presente alcun parametro database, poiché il nome del database deve essere presente nel file SQL. Specifica un solo URI. Oltre a importContext, non sono necessari altri campi.
Per PostgreSQL, il campo database è obbligatorio. Di seguito è riportato un importContext PostgreSQL di esempio con il campo database specificato.
{
"uri": "gs://sample-gcs-bucket/sample-file.sql",
"kind": "sql#importContext",
"fileType": "SQL",
"database": "sample-db"
}
Lo strumento import_data restituisce un'operazione a lunga esecuzione. Utilizza lo strumento get_operation per eseguire il polling dello stato fino al completamento dell'operazione.
Il seguente esempio di codice mostra come utilizzare curl per chiamare lo strumento MCP import_data.
| Richiesta curl |
|---|
curl --location 'https://sqladmin.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "import_data", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }' |
Schema di input
Richiesta di importazione dell'istanza.
SqlInstancesImportRequest
| Rappresentazione JSON |
|---|
{
"instance": string,
"project": string,
"body": {
object ( |
| Campi | |
|---|---|
instance |
ID dell'istanza Cloud SQL. Non è incluso l'ID progetto. |
project |
ID progetto del progetto che contiene l'istanza. |
body |
|
location |
Facoltativo. Regione dell'istanza Cloud SQL. |
InstancesImportRequest
| Rappresentazione JSON |
|---|
{
"importContext": {
object ( |
| Campi | |
|---|---|
importContext |
Contiene i dettagli dell'operazione di importazione. |
ImportContext
| Rappresentazione JSON |
|---|
{ "uri": string, "database": string, "kind": string, "fileType": enum ( |
| Campi | |
|---|---|
uri |
Percorso del file di importazione in Cloud Storage, nel formato |
database |
Il database di destinazione per l'importazione. Se |
kind |
Questo valore è sempre |
fileType |
Il tipo di file per l'URI specificato.`SQL |
csvImportOptions |
Opzioni per l'importazione dei dati in formato CSV. |
importUser |
Utente di PostgreSQL per questa operazione di importazione. Solo istanze PostgreSQL. |
bakImportOptions |
Parametri di importazione specifici per i file .BAK di SQL Server |
sqlImportOptions |
Facoltativo. Opzioni per l'importazione di dati da istruzioni SQL. |
tdeImportOptions |
Facoltativo. Importa i parametri specifici per i certificati TDE di SQL Server |
SqlCsvImportOptions
| Rappresentazione JSON |
|---|
{ "table": string, "columns": [ string ], "escapeCharacter": string, "quoteCharacter": string, "fieldsTerminatedBy": string, "linesTerminatedBy": string } |
| Campi | |
|---|---|
table |
La tabella in cui vengono importati i dati CSV. |
columns[] |
Le colonne in cui vengono importati i dati CSV. Se non specificato, tutte le colonne della tabella del database vengono caricate con i dati CSV. |
escapeCharacter |
Specifica il carattere che deve essere visualizzato prima di un carattere di dati che deve essere sottoposto a escape. |
quoteCharacter |
Specifica il carattere di virgolette da utilizzare quando un valore dei dati è racchiuso tra virgolette. |
fieldsTerminatedBy |
Specifica il carattere che separa le colonne all'interno di ogni riga del file. |
linesTerminatedBy |
Questo viene utilizzato per separare le righe. Se una riga non contiene tutti i campi, le restanti colonne vengono impostate sui valori predefiniti. |
SqlBakImportOptions
| Rappresentazione JSON |
|---|
{ "encryptionOptions": { object ( |
| Campi | |
|---|---|
encryptionOptions |
|
striped |
Indica se il set di backup in fase di ripristino è con striping. Si applica solo a Cloud SQL per SQL Server. |
noRecovery |
Indica se l'importazione del backup ripristinerà il database con l'opzione NORECOVERY. Si applica solo a Cloud SQL per SQL Server. |
recoveryOnly |
Indica se la richiesta di importazione del backup porterà il database online senza scaricare i contenuti Bak. Solo uno tra "no_recovery" e "recovery_only" può essere true, altrimenti verrà restituito un errore. Si applica solo a Cloud SQL per SQL Server. |
bakType |
Tipo di contenuti bak, FULL o DIFF |
stopAt |
Facoltativo. Il timestamp in cui l'importazione deve essere interrotta. Questo timestamp è in formato RFC 3339 (ad esempio, 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: |
stopAtMark |
Facoltativo. La transazione contrassegnata in cui l'importazione deve essere interrotta. Questo campo equivale alla parola chiave STOPATMARK e si applica solo a Cloud SQL per SQL Server. |
EncryptionOptions
| Rappresentazione JSON |
|---|
{ "certPath": string, "pvkPath": string, "pvkPassword": string, "keepEncrypted": boolean } |
| Campi | |
|---|---|
certPath |
Percorso del certificato (.cer) in Cloud Storage, nel formato |
pvkPath |
Percorso della chiave privata del certificato (.pvk) in Cloud Storage, nel formato |
pvkPassword |
Password che cripta la chiave privata |
keepEncrypted |
Facoltativo. Indica se il file importato rimane criptato. |
BoolValue
| Rappresentazione JSON |
|---|
{ "value": boolean } |
| Campi | |
|---|---|
value |
Il valore bool. |
Timestamp
| Rappresentazione JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Campi | |
|---|---|
seconds |
Rappresenta i secondi dell'ora UTC dall'epoca di Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (che corrisponde a un intervallo compreso tra 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 dei secondi negativi con frazioni devono comunque avere valori di nanosecondi non negativi che avanzano nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi. |
SqlImportOptions
| Rappresentazione JSON |
|---|
{
"threads": integer,
"parallel": boolean,
"postgresImportOptions": {
object ( |
| Campi | |
|---|---|
threads |
Facoltativo. Il numero di thread da utilizzare per l'importazione parallela. |
parallel |
Facoltativo. Indica se l'importazione deve essere eseguita in parallelo. |
postgresImportOptions |
Facoltativo. Opzioni per l'importazione da un'istanza Cloud SQL per PostgreSQL. |
Int32Value
| Rappresentazione JSON |
|---|
{ "value": integer } |
| Campi | |
|---|---|
value |
Il valore int32. |
PostgresImportOptions
| Rappresentazione JSON |
|---|
{ "clean": boolean, "ifExists": boolean } |
| Campi | |
|---|---|
clean |
Facoltativo. Il flag --clean per l'utilità pg_restore. Questo flag si applica solo se hai abilitato Cloud SQL per importare i file in parallelo. |
ifExists |
Facoltativo. Il flag --if-exists per l'utilità pg_restore. Questo flag si applica solo se hai abilitato Cloud SQL per importare i file in parallelo. |
SqlTdeImportOptions
| Rappresentazione JSON |
|---|
{ "certificatePath": string, "privateKeyPath": string, "privateKeyPassword": string, "name": string } |
| Campi | |
|---|---|
certificatePath |
Obbligatorio. Il percorso della chiave pubblica del certificato TDE nel formato gs://bucketName/fileName. L'istanza deve avere accesso in lettura al file. Applicabile solo alle istanze SQL Server. |
privateKeyPath |
Obbligatorio. Il percorso della chiave privata del certificato TDE nel formato gs://bucketName/fileName. L'istanza deve disporre dell'accesso in lettura al file. Applicabile solo alle istanze SQL Server. |
privateKeyPassword |
Obbligatorio. Password che cripta la chiave privata. |
name |
Obbligatorio. Nome del certificato. Applicabile solo alle istanze SQL Server. |
SqlFileType
| Enum | |
|---|---|
SQL_FILE_TYPE_UNSPECIFIED |
Tipo di file sconosciuto. |
SQL |
File contenente istruzioni SQL. |
CSV |
File in formato CSV. |
BAK |
|
TDE |
Certificato TDE. |
BakType
| Enum | |
|---|---|
BAK_TYPE_UNSPECIFIED |
Tipo predefinito. |
FULL |
Backup completo. |
DIFF |
Backup differenziale. |
TLOG |
Backup dei log delle transazioni |
Schema di output
Una risorsa Operation. Per le operazioni riuscite che restituiscono una risorsa Operation, nella risorsa vengono compilati solo i campi pertinenti all'operazione.
Operazione
| Rappresentazione JSON |
|---|
{ "kind": string, "targetLink": string, "status": enum ( |
| Campi | |
|---|---|
kind |
Questo valore è sempre |
targetLink |
|
status |
Lo stato di un'operazione. |
user |
L'indirizzo email dell'utente che ha avviato l'operazione. |
insertTime |
L'ora in cui l'operazione è stata inserita in coda nel fuso orario UTC nel formato RFC 3339, ad esempio 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: |
startTime |
L'ora di inizio effettiva di questa operazione nel fuso orario UTC nel formato RFC 3339, ad esempio 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: |
endTime |
L'ora in cui è terminata questa operazione nel fuso orario UTC in formato RFC 3339, ad esempio 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: |
error |
Se si sono verificati errori durante l'elaborazione di questa operazione, questo campo verrà compilato. |
apiWarning |
Un messaggio di avviso dell'API Admin. |
operationType |
Il tipo di operazione. I valori validi sono: * |
importContext |
Il contesto per l'operazione di importazione, se applicabile. |
exportContext |
Il contesto dell'operazione di esportazione, se applicabile. |
backupContext |
Il contesto dell'operazione di backup, se applicabile. |
preCheckMajorVersionUpgradeContext |
Questo campo viene compilato solo quando operation_type è PRE_CHECK_MAJOR_VERSION_UPGRADE. Il messaggio PreCheckMajorVersionUpgradeContext stesso contiene i dettagli del pre-controllo, ad esempio la versione del database di destinazione per l'upgrade e i risultati del controllo (inclusi eventuali avvisi o errori rilevati). |
startWorkloadCaptureContext |
Il contesto dell'operazione |
stopWorkloadCaptureContext |
Il contesto dell'operazione |
startWorkloadReplayContext |
Il contesto dell'operazione |
stopWorkloadReplayContext |
Il contesto dell'operazione |
name |
Un identificatore univoco dell'operazione. Puoi utilizzare questo identificatore per recuperare la risorsa Operations che contiene informazioni sull'operazione. |
targetId |
Nome della risorsa su cui viene eseguita questa operazione. |
selfLink |
L'URI di questa risorsa. |
targetProject |
L'ID progetto dell'istanza target correlata a questa operazione. |
acquireSsrsLeaseContext |
Il contesto per l'operazione di acquisizione del lease SSRS, se applicabile. |
subOperationType |
Facoltativo. La sotto-operazione basata sul tipo di operazione. |
Timestamp
| Rappresentazione JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Campi | |
|---|---|
seconds |
Rappresenta i secondi dell'ora UTC dall'epoca di Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (che corrisponde a un intervallo compreso tra 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z). |
nanos |
Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la porzione di nanosecondi della durata, non un'alternativa ai secondi. I valori dei secondi negativi con frazioni devono comunque avere valori di nanosecondi non negativi che avanzano nel tempo. Il valore deve essere compreso tra 0 e 999.999.999 inclusi. |
OperationErrors
| Rappresentazione JSON |
|---|
{
"kind": string,
"errors": [
{
object ( |
| Campi | |
|---|---|
kind |
Questo valore è sempre |
errors[] |
L'elenco degli errori riscontrati durante l'elaborazione di questa operazione. |
OperationError
| Rappresentazione JSON |
|---|
{ "kind": string, "code": string, "message": string } |
| Campi | |
|---|---|
kind |
Questo valore è sempre |
code |
Identifica l'errore specifico che si è verificato. |
message |
Informazioni aggiuntive sull'errore riscontrato. |
ApiWarning
| Rappresentazione JSON |
|---|
{
"code": enum ( |
| Campi | |
|---|---|
code |
Codice per identificare in modo univoco il tipo di avviso. |
message |
Il messaggio di avviso. |
region |
Il nome della regione per l'avviso REGION_UNREACHABLE. |
ImportContext
| Rappresentazione JSON |
|---|
{ "uri": string, "database": string, "kind": string, "fileType": enum ( |
| Campi | |
|---|---|
uri |
Percorso del file di importazione in Cloud Storage, nel formato |
database |
Il database di destinazione per l'importazione. Se |
kind |
Questo valore è sempre |
fileType |
Il tipo di file per l'URI specificato.`SQL |
csvImportOptions |
Opzioni per l'importazione dei dati in formato CSV. |
importUser |
Utente di PostgreSQL per questa operazione di importazione. Solo istanze PostgreSQL. |
bakImportOptions |
Parametri di importazione specifici per i file .BAK di SQL Server |
sqlImportOptions |
Facoltativo. Opzioni per l'importazione di dati da istruzioni SQL. |
tdeImportOptions |
Facoltativo. Importa i parametri specifici per i certificati TDE di SQL Server |
SqlCsvImportOptions
| Rappresentazione JSON |
|---|
{ "table": string, "columns": [ string ], "escapeCharacter": string, "quoteCharacter": string, "fieldsTerminatedBy": string, "linesTerminatedBy": string } |
| Campi | |
|---|---|
table |
La tabella in cui vengono importati i dati CSV. |
columns[] |
Le colonne in cui vengono importati i dati CSV. Se non specificato, tutte le colonne della tabella del database vengono caricate con i dati CSV. |
escapeCharacter |
Specifica il carattere che deve essere visualizzato prima di un carattere di dati che deve essere sottoposto a escape. |
quoteCharacter |
Specifica il carattere di virgolette da utilizzare quando un valore dei dati è racchiuso tra virgolette. |
fieldsTerminatedBy |
Specifica il carattere che separa le colonne all'interno di ogni riga del file. |
linesTerminatedBy |
Questo viene utilizzato per separare le righe. Se una riga non contiene tutti i campi, le restanti colonne vengono impostate sui valori predefiniti. |
SqlBakImportOptions
| Rappresentazione JSON |
|---|
{ "encryptionOptions": { object ( |
| Campi | |
|---|---|
encryptionOptions |
|
striped |
Indica se il set di backup in fase di ripristino è con striping. Si applica solo a Cloud SQL per SQL Server. |
noRecovery |
Indica se l'importazione del backup ripristinerà il database con l'opzione NORECOVERY. Si applica solo a Cloud SQL per SQL Server. |
recoveryOnly |
Indica se la richiesta di importazione del backup porterà il database online senza scaricare i contenuti Bak. Solo uno tra "no_recovery" e "recovery_only" può essere true, altrimenti verrà restituito un errore. Si applica solo a Cloud SQL per SQL Server. |
bakType |
Tipo di contenuti bak, FULL o DIFF |
stopAt |
Facoltativo. Il timestamp in cui l'importazione deve essere interrotta. Questo timestamp è in formato RFC 3339 (ad esempio, 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: |
stopAtMark |
Facoltativo. La transazione contrassegnata in cui l'importazione deve essere interrotta. Questo campo equivale alla parola chiave STOPATMARK e si applica solo a Cloud SQL per SQL Server. |
EncryptionOptions
| Rappresentazione JSON |
|---|
{ "certPath": string, "pvkPath": string, "pvkPassword": string, "keepEncrypted": boolean } |
| Campi | |
|---|---|
certPath |
Percorso del certificato (.cer) in Cloud Storage, nel formato |
pvkPath |
Percorso della chiave privata del certificato (.pvk) in Cloud Storage, nel formato |
pvkPassword |
Password che cripta la chiave privata |
keepEncrypted |
Facoltativo. Indica se il file importato rimane criptato. |
BoolValue
| Rappresentazione JSON |
|---|
{ "value": boolean } |
| Campi | |
|---|---|
value |
Il valore bool. |
SqlImportOptions
| Rappresentazione JSON |
|---|
{
"threads": integer,
"parallel": boolean,
"postgresImportOptions": {
object ( |
| Campi | |
|---|---|
threads |
Facoltativo. Il numero di thread da utilizzare per l'importazione parallela. |
parallel |
Facoltativo. Indica se l'importazione deve essere eseguita in parallelo. |
postgresImportOptions |
Facoltativo. Opzioni per l'importazione da un'istanza Cloud SQL per PostgreSQL. |
Int32Value
| Rappresentazione JSON |
|---|
{ "value": integer } |
| Campi | |
|---|---|
value |
Il valore int32. |
PostgresImportOptions
| Rappresentazione JSON |
|---|
{ "clean": boolean, "ifExists": boolean } |
| Campi | |
|---|---|
clean |
Facoltativo. Il flag --clean per l'utilità pg_restore. Questo flag si applica solo se hai abilitato Cloud SQL per importare i file in parallelo. |
ifExists |
Facoltativo. Il flag --if-exists per l'utilità pg_restore. Questo flag si applica solo se hai abilitato Cloud SQL per importare i file in parallelo. |
SqlTdeImportOptions
| Rappresentazione JSON |
|---|
{ "certificatePath": string, "privateKeyPath": string, "privateKeyPassword": string, "name": string } |
| Campi | |
|---|---|
certificatePath |
Obbligatorio. Il percorso della chiave pubblica del certificato TDE nel formato gs://bucketName/fileName. L'istanza deve avere accesso in lettura al file. Applicabile solo alle istanze SQL Server. |
privateKeyPath |
Obbligatorio. Il percorso della chiave privata del certificato TDE nel formato gs://bucketName/fileName. L'istanza deve disporre dell'accesso in lettura al file. Applicabile solo alle istanze SQL Server. |
privateKeyPassword |
Obbligatorio. Password che cripta la chiave privata. |
name |
Obbligatorio. Nome del certificato. Applicabile solo alle istanze SQL Server. |
ExportContext
| Rappresentazione JSON |
|---|
{ "uri": string, "databases": [ string ], "kind": string, "sqlExportOptions": { object ( |
| Campi | |
|---|---|
uri |
Il percorso del file in Google Cloud Storage in cui verrà archiviata l'esportazione. L'URI è nel formato |
databases[] |
Database da esportare. |
kind |
Questo valore è sempre |
sqlExportOptions |
Opzioni per l'esportazione dei dati come istruzioni SQL. |
csvExportOptions |
Opzioni per l'esportazione dei dati in formato CSV. Solo istanze |
fileType |
Il tipo di file per l'URI specificato. |
offload |
Indica se eseguire un'esportazione serverless. |
bakExportOptions |
Opzioni per l'esportazione dei dati come file BAK. |
tdeExportOptions |
Facoltativo. Parametri di esportazione specifici per i certificati TDE di SQL Server |
SqlExportOptions
| Rappresentazione JSON |
|---|
{ "tables": [ string ], "schemaOnly": boolean, "mysqlExportOptions": { object ( |
| Campi | |
|---|---|
tables[] |
Tabelle da esportare o che sono state esportate dal database specificato. Se specifichi le tabelle, specifica un solo database. Per le istanze PostgreSQL, puoi specificare una sola tabella. |
schemaOnly |
Esporta solo gli schemi. |
mysqlExportOptions |
|
threads |
Facoltativo. Il numero di thread da utilizzare per l'esportazione parallela. |
parallel |
Facoltativo. Indica se l'esportazione deve essere eseguita in parallelo. |
postgresExportOptions |
Facoltativo. Opzioni per l'esportazione da un'istanza Cloud SQL per PostgreSQL. |
MysqlExportOptions
| Rappresentazione JSON |
|---|
{ "masterData": integer } |
| Campi | |
|---|---|
masterData |
Opzione per includere l'istruzione SQL necessaria per configurare la replica. Se impostato su |
PostgresExportOptions
| Rappresentazione JSON |
|---|
{ "clean": boolean, "ifExists": boolean } |
| Campi | |
|---|---|
clean |
Facoltativo. Utilizza questa opzione per includere le istruzioni SQL DROP |
ifExists |
Facoltativo. Opzione per includere un'istruzione SQL IF EXISTS con ogni istruzione DROP prodotta da clean. |
SqlCsvExportOptions
| Rappresentazione JSON |
|---|
{ "selectQuery": string, "escapeCharacter": string, "quoteCharacter": string, "fieldsTerminatedBy": string, "linesTerminatedBy": string } |
| Campi | |
|---|---|
selectQuery |
La query SELECT utilizzata per estrarre i dati. |
escapeCharacter |
Specifica il carattere che deve essere visualizzato prima di un carattere di dati che deve essere sottoposto a escape. |
quoteCharacter |
Specifica il carattere di virgolette da utilizzare quando un valore dei dati è racchiuso tra virgolette. |
fieldsTerminatedBy |
Specifica il carattere che separa le colonne all'interno di ogni riga del file. |
linesTerminatedBy |
Questo viene utilizzato per separare le righe. Se una riga non contiene tutti i campi, le restanti colonne vengono impostate sui valori predefiniti. |
SqlBakExportOptions
| Rappresentazione JSON |
|---|
{
"striped": boolean,
"stripeCount": integer,
"bakType": enum ( |
| Campi | |
|---|---|
striped |
Indica se l'esportazione deve essere suddivisa in strisce. |
stripeCount |
Opzione per specificare quante strisce utilizzare per l'esportazione. Se il campo è vuoto e il valore del campo striped è true, il numero di stripe viene scelto automaticamente. |
bakType |
Il tipo di questo file bak sarà export, FULL o DIFF, solo SQL Server |
copyOnly |
Deprecato: copy_only è deprecato. Utilizza invece differential_base |
differentialBase |
Indica se il backup può essere utilizzato come base differenziale. Il backup copy_only non può essere utilizzato come base differenziale |
exportLogStartTime |
Facoltativo. Il timestamp di inizio in cui il log delle transazioni verrà incluso nell'operazione di esportazione. Formato RFC 3339 (ad esempio, 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: |
exportLogEndTime |
Facoltativo. Il timestamp di fine in cui il log delle transazioni verrà incluso nell'operazione di esportazione. Formato RFC 3339 (ad esempio, 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: |
SqlTdeExportOptions
| Rappresentazione JSON |
|---|
{ "certificatePath": string, "privateKeyPath": string, "privateKeyPassword": string, "name": string } |
| Campi | |
|---|---|
certificatePath |
Obbligatorio. Percorso della chiave pubblica del certificato TDE nel formato gs://bucketName/fileName. L'istanza deve avere accesso in scrittura al bucket. Applicabile solo alle istanze SQL Server. |
privateKeyPath |
Obbligatorio. Percorso della chiave privata del certificato TDE nel formato gs://bucketName/fileName. L'istanza deve disporre dell'accesso in scrittura alla località. Applicabile solo alle istanze SQL Server. |
privateKeyPassword |
Obbligatorio. Password che cripta la chiave privata. |
name |
Obbligatorio. Nome del certificato. Applicabile solo alle istanze SQL Server. |
BackupContext
| Rappresentazione JSON |
|---|
{ "backupId": string, "kind": string, "name": string } |
| Campi | |
|---|---|
backupId |
L'identificatore del backup. |
kind |
Questo valore è sempre |
name |
Il nome del backup. Formato: projects/{project}/backups/{backup} |
PreCheckMajorVersionUpgradeContext
| Rappresentazione JSON |
|---|
{ "targetDatabaseVersion": enum ( |
| Campi | |
|---|---|
targetDatabaseVersion |
Obbligatorio. La versione del database di destinazione di cui eseguire l'upgrade. |
preCheckResponse[] |
Solo output. Le risposte dell'operazione di pre-controllo. |
kind |
Facoltativo. Questo valore è sempre |
Campo unione
|
|
maxRuntime |
Facoltativo. Il tempo di esecuzione massimo consentito per l'operazione di pre-controllo. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
PreCheckResponse
| Rappresentazione JSON |
|---|
{ "actionsRequired": [ string ], // Union field |
| Campi | |
|---|---|
actionsRequired[] |
Le azioni che l'utente deve intraprendere. Utilizza repeated per più azioni. |
Campo unione
|
|
message |
Il messaggio da mostrare all'utente. |
Campo unione
|
|
messageType |
Il tipo di messaggio, ovvero informazioni, avviso o errore. |
Durata
| Rappresentazione JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Campi | |
|---|---|
seconds |
Secondi firmati dell'intervallo di tempo. Deve essere compreso tra -315.576.000.000 e +315.576.000.000 inclusi. Nota: questi limiti vengono calcolati da: 60 sec/min * 60 min/ora * 24 ore/giorno * 365,25 giorni/anno * 10.000 anni |
nanos |
Frazioni di secondo con segno con risoluzione in nanosecondi dell'intervallo di tempo. Le durate inferiori a un secondo sono rappresentate con un campo |
StartWorkloadCaptureContext
| Rappresentazione JSON |
|---|
{ "enableLiveReplay": boolean, // Union field |
| Campi | |
|---|---|
enableLiveReplay |
Facoltativo. Se impostato su true, il carico di lavoro acquisito viene eseguito contemporaneamente su un'istanza Cloud SQL effimera separata. Questa istanza di "replica della live" viene sottoposta automaticamente a provisioning e viene clonata dall'istanza di origine. Se è impostato su false (valore predefinito), il workload viene solo archiviato e non viene eseguita alcuna replica della live. Può essere riprodotto in un secondo momento utilizzando un |
Campo unione
|
|
replayInstance |
Facoltativo. Obbligatorio se |
StopWorkloadCaptureContext
| Rappresentazione JSON |
|---|
{ "abortLiveReplay": boolean } |
| Campi | |
|---|---|
abortLiveReplay |
Facoltativo. Se impostato su true, interrompe immediatamente la replica della live simultanea e ignora il traffico non riprodotto, oltre a interrompere l'acquisizione. Se è impostato su false (valore predefinito), l'acquisizione interrompe la registrazione del nuovo traffico, ma la replica della live continuerà a essere eseguita fino a quando non sarà stato riprodotto l'intero backlog del traffico acquisito. |
StartWorkloadReplayContext
| Rappresentazione JSON |
|---|
{ "replayInstance": string, "workloadId": string } |
| Campi | |
|---|---|
replayInstance |
Obbligatorio. Il nome dell'istanza Cloud SQL in cui viene eseguito il workload acquisito (query SQL), escluso l'ID progetto (ad esempio, |
workloadId |
Solo output. L'ID del carico di lavoro da avviare nell'istanza di replay. Ogni acquisizione del workload genera un ID univoco nel formato |
AcquireSsrsLeaseContext
| Rappresentazione JSON |
|---|
{ // Union field |
| Campi | |
|---|---|
Campo unione
|
|
setupLogin |
Il nome utente da utilizzare come accesso di configurazione per connettersi al server di database per la configurazione di SSRS. |
Campo unione
|
|
serviceLogin |
Il nome utente da utilizzare come accesso al servizio per connettersi al database dei report per la configurazione di SSRS. |
Campo unione
|
|
reportDatabase |
Il database dei report da utilizzare per la configurazione di SSRS. |
Campo unione
|
|
duration |
Durata del lease necessaria per la configurazione di SSRS. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
SqlSubOperationType
| Rappresentazione JSON |
|---|
{ // Union field |
| Campi | |
|---|---|
Campo unione sub_operation_details. Dettagli della sotto-operazione corrispondenti al tipo di operazione. sub_operation_details può essere solo uno dei seguenti tipi: |
|
maintenanceType |
Il tipo di manutenzione da eseguire sull'istanza. |
SqlOperationStatus
Lo stato di un'operazione.
| Enum | |
|---|---|
SQL_OPERATION_STATUS_UNSPECIFIED |
Lo stato dell'operazione è sconosciuto. |
PENDING |
L'operazione è stata messa in coda, ma non è ancora iniziata. |
RUNNING |
L'operazione è in corso. |
DONE |
L'operazione è stata completata. |
SqlApiWarningCode
| Enum | |
|---|---|
SQL_API_WARNING_CODE_UNSPECIFIED |
Un tipo di avviso sconosciuto o non impostato dall'API Cloud SQL. |
REGION_UNREACHABLE |
Avviso quando una o più regioni non sono raggiungibili. Il set di risultati restituito potrebbe essere incompleto. |
MAX_RESULTS_EXCEEDS_LIMIT |
Avviso quando il parametro maxResults fornito dall'utente supera il limite. Il set di risultati restituito potrebbe essere incompleto. |
COMPROMISED_CREDENTIALS |
Avviso quando l'utente tenta di creare/aggiornare un utente con credenziali precedentemente compromesse da una violazione dei dati pubblica. |
INTERNAL_STATE_FAILURE |
Avviso quando l'operazione riesce, ma lo stato di un workflow non critico non è riuscito. |
SqlOperationType
Il tipo di operazione Cloud SQL.
| Enum | |
|---|---|
SQL_OPERATION_TYPE_UNSPECIFIED |
Tipo di operazione sconosciuto. |
IMPORT |
Importa i dati in un'istanza Cloud SQL. |
EXPORT |
Esporta i dati da un'istanza Cloud SQL in un bucket Cloud Storage. |
CREATE |
Crea una nuova istanza Cloud SQL. |
UPDATE |
Aggiorna le impostazioni di un'istanza Cloud SQL. |
DELETE |
Elimina un'istanza Cloud SQL. |
RESTART |
Riavvia l'istanza Cloud SQL. |
BACKUP |
|
SNAPSHOT |
|
BACKUP_VOLUME |
Esegue il backup dell'istanza. |
DELETE_VOLUME |
Elimina il backup di un'istanza. |
RESTORE_VOLUME |
Ripristina un backup dell'istanza. |
INJECT_USER |
Inserisce un utente con privilegi in MySQL per le istanze MOB. |
CLONE |
Clona un'istanza Cloud SQL. |
STOP_REPLICA |
Arresta la replica su un'istanza di replica di lettura Cloud SQL. |
START_REPLICA |
Avvia la replica su un'istanza di replica di lettura Cloud SQL. |
PROMOTE_REPLICA |
Promuove un'istanza di replica Cloud SQL. |
CREATE_REPLICA |
Crea un'istanza di replica Cloud SQL. |
CREATE_USER |
Crea un nuovo utente in un'istanza Cloud SQL. |
DELETE_USER |
Elimina un utente da un'istanza Cloud SQL. |
UPDATE_USER |
Aggiorna un utente esistente in un'istanza Cloud SQL. Se non esiste un utente con il nome utente specificato, ne viene creato uno nuovo. |
CREATE_DATABASE |
Crea un database nell'istanza Cloud SQL. |
DELETE_DATABASE |
Elimina un database nell'istanza Cloud SQL. |
UPDATE_DATABASE |
Aggiorna un database nell'istanza Cloud SQL. |
FAILOVER |
Esegue il failover di una replica di failover Cloud SQL con HA abilitata. |
DELETE_BACKUP |
Elimina il backup eseguito da un'esecuzione di backup. |
RECREATE_REPLICA |
|
TRUNCATE_LOG |
Tronca una tabella di log generale o lento in MySQL. |
DEMOTE_MASTER |
Retrocede l'istanza autonoma a replica di lettura Cloud SQL per un server di database esterno. |
MAINTENANCE |
Indica che l'istanza è attualmente in manutenzione. In genere, la manutenzione rende l'istanza non disponibile per 1-3 minuti. |
ENABLE_PRIVATE_IP |
Questo campo è deprecato e verrà rimosso nella versione futura dell'API. |
DEFER_MAINTENANCE |
|
CREATE_CLONE |
Crea un'istanza clone. |
RESCHEDULE_MAINTENANCE |
Ripianifica la manutenzione in un altro momento. |
START_EXTERNAL_SYNC |
Avvia la sincronizzazione esterna di una replica Cloud SQL EM con un'istanza principale esterna. |
LOG_CLEANUP |
Recupera i log dal vecchio disco dati di un'istanza. |
AUTO_RESTART |
Esegue il riavvio automatico di un database Cloud SQL abilitato per l'alta disponibilità per il recupero automatico. |
REENCRYPT |
Crittografa di nuovo le istanze CMEK con l'ultima versione della chiave. |
SWITCHOVER |
Cambia i ruoli della coppia principale e di replica. L'istanza target deve essere la replica. |
UPDATE_BACKUP |
Aggiorna un backup. |
ACQUIRE_SSRS_LEASE |
Acquisisci un lease per la configurazione di SQL Server Reporting Services (SSRS). |
RELEASE_SSRS_LEASE |
Rilascia un lease per la configurazione di SQL Server Reporting Services (SSRS). |
RECONFIGURE_OLD_PRIMARY |
Riconfigura l'istanza principale precedente dopo un'operazione di promozione della replica. L'effetto di un'operazione di promozione sull'istanza principale precedente viene eseguito in questa operazione, in modo asincrono rispetto all'operazione di promozione della replica eseguita sulla replica. |
CLUSTER_MAINTENANCE |
Indica che l'istanza, le relative repliche di lettura e le relative repliche a cascata sono in manutenzione. La manutenzione in genere viene avviata prima sui gruppi di repliche e poi sull'istanza primaria. Per ogni istanza, la manutenzione in genere rende l'istanza non disponibile per 1-3 minuti. |
SELF_SERVICE_MAINTENANCE |
Indica che l'istanza (e le relative repliche) è attualmente in manutenzione. Questa operazione viene avviata come richiesta di servizio self-service utilizzando SSM. In genere, la manutenzione causa l'indisponibilità dell'istanza per 1-3 minuti. |
SWITCHOVER_TO_REPLICA |
Cambia un'istanza principale in una replica. Questa operazione viene eseguita nell'ambito di un'operazione di switchover all'istanza principale originale. |
MAJOR_VERSION_UPGRADE |
Aggiorna la versione principale di un'istanza Cloud SQL. |
ADVANCED_BACKUP |
Deprecato: ADVANCED_BACKUP è deprecato. Utilizza invece ENHANCED_BACKUP. |
MANAGE_BACKUP |
Modifica il livello di backup di un'istanza Cloud SQL. |
ENHANCED_BACKUP |
Crea un backup per un'istanza Cloud SQL con livello di backup avanzato. |
REPAIR_READ_POOL |
Ripara l'intero pool di lettura o i nodi del pool di lettura specificati nel pool di lettura. |
CREATE_READ_POOL |
Crea un'istanza del pool di lettura Cloud SQL. |
PRE_CHECK_MAJOR_VERSION_UPGRADE |
Esegue il controllo preliminare dell'operazione di upgrade della versione principale. |
SETUP_MIGRATION |
Questo tipo di operazione rappresenta i singoli passaggi di un workflow di migrazione della configurazione in più fasi, tra cui configurazione, replica, switchover/switchback e ripopolamento dei dati, come definito dall'intent dell'operazione. |
CREATE_BLUE_GREEN_DEPLOYMENT |
Crea un nuovo deployment blu/verde. |
SWITCHOVER_BLUE_GREEN_DEPLOYMENT |
Esegue il passaggio a un deployment blu/verde. |
DELETE_BLUE_GREEN_DEPLOYMENT |
Elimina un deployment blu/verde. |
SqlFileType
| Enum | |
|---|---|
SQL_FILE_TYPE_UNSPECIFIED |
Tipo di file sconosciuto. |
SQL |
File contenente istruzioni SQL. |
CSV |
File in formato CSV. |
BAK |
|
TDE |
Certificato TDE. |
BakType
| Enum | |
|---|---|
BAK_TYPE_UNSPECIFIED |
Tipo predefinito. |
FULL |
Backup completo. |
DIFF |
Backup differenziale. |
TLOG |
Backup dei log delle transazioni |
SqlDatabaseVersion
Il tipo e la versione del motore del database.
| Enum | |
|---|---|
SQL_DATABASE_VERSION_UNSPECIFIED |
Questa è una versione del database sconosciuta. |
MYSQL_5_1 |
La versione del database è MySQL 5.1. |
MYSQL_5_5 |
La versione del database è MySQL 5.5. |
MYSQL_5_6 |
La versione del database è MySQL 5.6. |
MYSQL_5_7 |
La versione del database è MySQL 5.7. |
MYSQL_8_0 |
La versione del database è MySQL 8. |
MYSQL_8_0_18 |
La versione principale del database è MySQL 8.0 e la versione secondaria è 18. |
MYSQL_8_0_26 |
La versione principale del database è MySQL 8.0 e la versione secondaria è 26. |
MYSQL_8_0_27 |
La versione principale del database è MySQL 8.0 e la versione secondaria è 27. |
MYSQL_8_0_28 |
La versione principale del database è MySQL 8.0 e la versione secondaria è 28. |
MYSQL_8_0_29 |
La versione principale del database è MySQL 8.0 e la versione secondaria è 29. |
MYSQL_8_0_30 |
La versione principale del database è MySQL 8.0 e la versione secondaria è 30. |
MYSQL_8_0_31 |
La versione principale del database è MySQL 8.0 e la versione secondaria è 31. |
MYSQL_8_0_32 |
La versione principale del database è MySQL 8.0 e la versione secondaria è 32. |
MYSQL_8_0_33 |
La versione principale del database è MySQL 8.0 e la versione secondaria è 33. |
MYSQL_8_0_34 |
La versione principale del database è MySQL 8.0 e la versione secondaria è 34. |
MYSQL_8_0_35 |
La versione principale del database è MySQL 8.0 e la versione secondaria è 35. |
MYSQL_8_0_36 |
La versione principale del database è MySQL 8.0 e la versione secondaria è 36. |
MYSQL_8_0_37 |
La versione principale del database è MySQL 8.0 e la versione secondaria è 37. |
MYSQL_8_0_39 |
La versione principale del database è MySQL 8.0 e la versione secondaria è 39. |
MYSQL_8_0_40 |
La versione principale del database è MySQL 8.0 e la versione secondaria è 40. |
MYSQL_8_0_41 |
La versione principale del database è MySQL 8.0 e la versione secondaria è 41. |
MYSQL_8_0_42 |
La versione principale del database è MySQL 8.0 e la versione secondaria è 42. |
MYSQL_8_0_43 |
La versione principale del database è MySQL 8.0 e la versione secondaria è 43. |
MYSQL_8_0_44 |
La versione principale del database è MySQL 8.0 e la versione secondaria è 44. |
MYSQL_8_0_45 |
La versione principale del database è MySQL 8.0 e la versione secondaria è 45. |
MYSQL_8_0_46 |
La versione principale del database è MySQL 8.0 e la versione secondaria è 46. |
MYSQL_8_4 |
La versione del database è MySQL 8.4. |
MYSQL_9_7 |
La versione del database è MySQL 9.7. |
SQLSERVER_2017_STANDARD |
La versione del database è SQL Server 2017 Standard. |
SQLSERVER_2017_ENTERPRISE |
La versione del database è SQL Server 2017 Enterprise. |
SQLSERVER_2017_EXPRESS |
La versione del database è SQL Server 2017 Express. |
SQLSERVER_2017_WEB |
La versione del database è SQL Server 2017 Web. |
POSTGRES_9_6 |
La versione del database è PostgreSQL 9.6. |
POSTGRES_10 |
La versione del database è PostgreSQL 10. |
POSTGRES_11 |
La versione del database è PostgreSQL 11. |
POSTGRES_12 |
La versione del database è PostgreSQL 12. |
POSTGRES_13 |
La versione del database è PostgreSQL 13. |
POSTGRES_14 |
La versione del database è PostgreSQL 14. |
POSTGRES_15 |
La versione del database è PostgreSQL 15. |
POSTGRES_16 |
La versione del database è PostgreSQL 16. |
POSTGRES_17 |
La versione del database è PostgreSQL 17. |
POSTGRES_18 |
La versione del database è PostgreSQL 18. |
POSTGRES_19 |
La versione del database è PostgreSQL 19. |
POSTGRES_20 |
La versione del database è PostgreSQL 20. |
SQLSERVER_2019_STANDARD |
La versione del database è SQL Server 2019 Standard. |
SQLSERVER_2019_ENTERPRISE |
La versione del database è SQL Server 2019 Enterprise. |
SQLSERVER_2019_EXPRESS |
La versione del database è SQL Server 2019 Express. |
SQLSERVER_2019_WEB |
La versione del database è SQL Server 2019 Web. |
SQLSERVER_2022_STANDARD |
La versione del database è SQL Server 2022 Standard. |
SQLSERVER_2022_ENTERPRISE |
La versione del database è SQL Server 2022 Enterprise. |
SQLSERVER_2022_EXPRESS |
La versione del database è SQL Server 2022 Express. |
SQLSERVER_2022_WEB |
La versione del database è SQL Server 2022 Web. |
SQLSERVER_2025_STANDARD |
La versione del database è SQL Server 2025 Standard. |
SQLSERVER_2025_ENTERPRISE |
La versione del database è SQL Server 2025 Enterprise. |
SQLSERVER_2025_EXPRESS |
La versione del database è SQL Server 2025 Express. |
MessageType
Il tipo di messaggio, che può essere un'informazione, un avviso o un errore che richiede l'intervento dell'utente.
| Enum | |
|---|---|
MESSAGE_TYPE_UNSPECIFIED |
Valore predefinito non specificato per evitare modifiche impreviste del comportamento. |
INFO |
Messaggi informativi generali che non richiedono alcuna azione. |
WARNING |
Avvisi che potrebbero influire sull'upgrade, ma non lo bloccano. |
ERROR |
Errori che un utente deve risolvere prima di procedere con l'upgrade. |
SqlMaintenanceType
Il tipo di manutenzione da eseguire sull'istanza.
| Enum | |
|---|---|
SQL_MAINTENANCE_TYPE_UNSPECIFIED |
Il tipo di manutenzione non è specificato. |
INSTANCE_MAINTENANCE |
Indica che è in corso la manutenzione di un'istanza autonoma. L'istanza può essere un'istanza principale o una replica. |
REPLICA_INCLUDED_MAINTENANCE |
Indica che l'istanza primaria e tutte le relative repliche, incluse le repliche a cascata, sono in fase di manutenzione. La manutenzione viene eseguita prima sui gruppi di repliche e poi sull'istanza principale. |
INSTANCE_SELF_SERVICE_MAINTENANCE |
Indica che l'istanza autonoma è in fase di manutenzione, avviata in modalità self-service. L'istanza può essere un'istanza principale o una replica. |
REPLICA_INCLUDED_SELF_SERVICE_MAINTENANCE |
Indica che l'istanza principale e tutte le sue repliche sono in fase di manutenzione, avviata in modalità self-service. La manutenzione viene eseguita prima sui gruppi di repliche e poi sull'istanza principale. |
Annotazioni dello strumento
Le annotazioni degli strumenti 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 una richiesta di conferma a un utente.
Oltre alla stringa del titolo, i seguenti suggerimenti booleani sono definiti come segue:
readOnlyHint: se true, lo strumento non modifica il suo ambiente. Valore predefinito: false.destructiveHint: se è true, lo strumento può eseguire azioni distruttive. Se false, lo strumento può eseguire solo azioni additive. Valore predefinito: true.idempotentHint: se true, la chiamata ripetuta dello 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 entità interne. Ad esempio, uno strumento di ricerca web sarebbe open world, mentre uno strumento di memoria no.
Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ❌