MCP Tools Reference: cloud-sql

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:

  1. Utilizza lo strumento get_instance per ottenere l'indirizzo email del account di servizio dell'istanza. Dall'output dello strumento, ottieni il valore del campo serviceAccountEmailAddress.
  2. Concedi al account di servizio dell'istanza il ruolo storage.objectAdmin sul bucket Cloud Storage fornito. Utilizza un comando come gcloud storage buckets add-iam-policy-binding o 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 (InstancesImportRequest)
  },
  "location": string
}
Campi
instance

string

ID dell'istanza Cloud SQL. Non è incluso l'ID progetto.

project

string

ID progetto del progetto che contiene l'istanza.

body

object (InstancesImportRequest)

location

string

Facoltativo. Regione dell'istanza Cloud SQL.

InstancesImportRequest

Rappresentazione JSON
{
  "importContext": {
    object (ImportContext)
  }
}
Campi
importContext

object (ImportContext)

Contiene i dettagli dell'operazione di importazione.

ImportContext

Rappresentazione JSON
{
  "uri": string,
  "database": string,
  "kind": string,
  "fileType": enum (SqlFileType),
  "csvImportOptions": {
    object (SqlCsvImportOptions)
  },
  "importUser": string,
  "bakImportOptions": {
    object (SqlBakImportOptions)
  },
  "sqlImportOptions": {
    object (SqlImportOptions)
  },
  "tdeImportOptions": {
    object (SqlTdeImportOptions)
  }
}
Campi
uri

string

Percorso del file di importazione in Cloud Storage, nel formato gs://bucketName/fileName. I file gzip compressi (.gz) sono supportati quando fileType è SQL. L'istanza deve disporre delle autorizzazioni in scrittura per il bucket e dell'accesso in lettura al file.

database

string

Il database di destinazione per l'importazione. Se fileType è SQL, questo campo è obbligatorio solo se il file di importazione non specifica un database e viene sostituito da qualsiasi specifica del database nel file di importazione. Per le operazioni di importazione parallela dell'intera istanza, il database viene sostituito dal nome del database memorizzato nel nome della sottodirectory. Se fileType è CSV, deve essere specificato un database.

kind

string

Questo valore è sempre sql#importContext.

fileType

enum (SqlFileType)

Il tipo di file per l'URI specificato.`SQL: The file contains SQL statements. \CSV`: il file contiene dati CSV.

csvImportOptions

object (SqlCsvImportOptions)

Opzioni per l'importazione dei dati in formato CSV.

importUser

string

Utente di PostgreSQL per questa operazione di importazione. Solo istanze PostgreSQL.

bakImportOptions

object (SqlBakImportOptions)

Parametri di importazione specifici per i file .BAK di SQL Server

sqlImportOptions

object (SqlImportOptions)

Facoltativo. Opzioni per l'importazione di dati da istruzioni SQL.

tdeImportOptions

object (SqlTdeImportOptions)

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

string

La tabella in cui vengono importati i dati CSV.

columns[]

string

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

string

Specifica il carattere che deve essere visualizzato prima di un carattere di dati che deve essere sottoposto a escape.

quoteCharacter

string

Specifica il carattere di virgolette da utilizzare quando un valore dei dati è racchiuso tra virgolette.

fieldsTerminatedBy

string

Specifica il carattere che separa le colonne all'interno di ogni riga del file.

linesTerminatedBy

string

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 (EncryptionOptions)
  },
  "striped": boolean,
  "noRecovery": boolean,
  "recoveryOnly": boolean,
  "bakType": enum (BakType),
  "stopAt": string,
  "stopAtMark": string
}
Campi
encryptionOptions

object (EncryptionOptions)

striped

boolean

Indica se il set di backup in fase di ripristino è con striping. Si applica solo a Cloud SQL per SQL Server.

noRecovery

boolean

Indica se l'importazione del backup ripristinerà il database con l'opzione NORECOVERY. Si applica solo a Cloud SQL per SQL Server.

recoveryOnly

boolean

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

enum (BakType)

Tipo di contenuti bak, FULL o DIFF

stopAt

string (Timestamp format)

Facoltativo. Il timestamp in cui l'importazione deve essere interrotta. Questo timestamp è in formato RFC 3339 (ad esempio, 2023-10-01T16:19:00.094). Questo campo è equivalente alla parola chiave STOPAT e si applica solo a Cloud SQL per SQL Server.

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".

stopAtMark

string

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

string

Percorso del certificato (.cer) in Cloud Storage, nel formato gs://bucketName/fileName. L'istanza deve disporre delle autorizzazioni in scrittura per il bucket e dell'accesso in lettura al file.

pvkPath

string

Percorso della chiave privata del certificato (.pvk) in Cloud Storage, nel formato gs://bucketName/fileName. L'istanza deve disporre delle autorizzazioni in scrittura per il bucket e dell'accesso in lettura al file.

pvkPassword

string

Password che cripta la chiave privata

keepEncrypted

boolean

Facoltativo. Indica se il file importato rimane criptato.

BoolValue

Rappresentazione JSON
{
  "value": boolean
}
Campi
value

boolean

Il valore bool.

Timestamp

Rappresentazione JSON
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

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

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 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 (PostgresImportOptions)
  }
}
Campi
threads

integer

Facoltativo. Il numero di thread da utilizzare per l'importazione parallela.

parallel

boolean

Facoltativo. Indica se l'importazione deve essere eseguita in parallelo.

postgresImportOptions

object (PostgresImportOptions)

Facoltativo. Opzioni per l'importazione da un'istanza Cloud SQL per PostgreSQL.

Int32Value

Rappresentazione JSON
{
  "value": integer
}
Campi
value

integer

Il valore int32.

PostgresImportOptions

Rappresentazione JSON
{
  "clean": boolean,
  "ifExists": boolean
}
Campi
clean

boolean

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

boolean

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

string

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

string

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

string

Obbligatorio. Password che cripta la chiave privata.

name

string

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 (SqlOperationStatus),
  "user": string,
  "insertTime": string,
  "startTime": string,
  "endTime": string,
  "error": {
    object (OperationErrors)
  },
  "apiWarning": {
    object (ApiWarning)
  },
  "operationType": enum (SqlOperationType),
  "importContext": {
    object (ImportContext)
  },
  "exportContext": {
    object (ExportContext)
  },
  "backupContext": {
    object (BackupContext)
  },
  "preCheckMajorVersionUpgradeContext": {
    object (PreCheckMajorVersionUpgradeContext)
  },
  "startWorkloadCaptureContext": {
    object (StartWorkloadCaptureContext)
  },
  "stopWorkloadCaptureContext": {
    object (StopWorkloadCaptureContext)
  },
  "startWorkloadReplayContext": {
    object (StartWorkloadReplayContext)
  },
  "stopWorkloadReplayContext": {
    object (StopWorkloadReplayContext)
  },
  "name": string,
  "targetId": string,
  "selfLink": string,
  "targetProject": string,
  "acquireSsrsLeaseContext": {
    object (AcquireSsrsLeaseContext)
  },
  "subOperationType": {
    object (SqlSubOperationType)
  }
}
Campi
kind

string

Questo valore è sempre sql#operation.

targetLink

string

status

enum (SqlOperationStatus)

Lo stato di un'operazione.

user

string

L'indirizzo email dell'utente che ha avviato l'operazione.

insertTime

string (Timestamp format)

L'ora in cui l'operazione è stata inserita in coda nel fuso orario UTC nel formato RFC 3339, ad esempio 2012-11-15T16:19:00.094Z.

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".

startTime

string (Timestamp format)

L'ora di inizio effettiva di questa operazione nel fuso orario UTC nel formato RFC 3339, ad esempio 2012-11-15T16:19:00.094Z.

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".

endTime

string (Timestamp format)

L'ora in cui è terminata questa operazione nel fuso orario UTC in formato RFC 3339, ad esempio 2012-11-15T16:19:00.094Z.

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".

error

object (OperationErrors)

Se si sono verificati errori durante l'elaborazione di questa operazione, questo campo verrà compilato.

apiWarning

object (ApiWarning)

Un messaggio di avviso dell'API Admin.

operationType

enum (SqlOperationType)

Il tipo di operazione. I valori validi sono: * CREATE * DELETE * UPDATE * RESTART * IMPORT * EXPORT * BACKUP_VOLUME * RESTORE_VOLUME * CREATE_USER * DELETE_USER * CREATE_DATABASE * DELETE_DATABASE

importContext

object (ImportContext)

Il contesto per l'operazione di importazione, se applicabile.

exportContext

object (ExportContext)

Il contesto dell'operazione di esportazione, se applicabile.

backupContext

object (BackupContext)

Il contesto dell'operazione di backup, se applicabile.

preCheckMajorVersionUpgradeContext

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

object (StartWorkloadCaptureContext)

Il contesto dell'operazione StartWorkloadCapture, che contiene i dettagli per avviare la registrazione del workload (query SQL) su un'istanza Cloud SQL.

stopWorkloadCaptureContext

object (StopWorkloadCaptureContext)

Il contesto dell'operazione StopWorkloadCapture, che contiene i dettagli per interrompere la registrazione del workload (query SQL) su un'istanza Cloud SQL.

startWorkloadReplayContext

object (StartWorkloadReplayContext)

Il contesto dell'operazione StartWorkloadReplay, che contiene dettagli sull'avvio dell'esecuzione di un workload acquisito (query SQL di lettura e scrittura registrate) su un'istanza di riproduzione (l'istanza Cloud SQL in cui vengono eseguite le query SQL registrate).

stopWorkloadReplayContext

object (StopWorkloadReplayContext)

Il contesto dell'operazione StopWorkloadReplay, che contiene i dettagli sull'interruzione dell'esecuzione di un workload acquisito (query SQL di lettura e scrittura registrate) su un'istanza di replay.

name

string

Un identificatore univoco dell'operazione. Puoi utilizzare questo identificatore per recuperare la risorsa Operations che contiene informazioni sull'operazione.

targetId

string

Nome della risorsa su cui viene eseguita questa operazione.

selfLink

string

L'URI di questa risorsa.

targetProject

string

L'ID progetto dell'istanza target correlata a questa operazione.

acquireSsrsLeaseContext

object (AcquireSsrsLeaseContext)

Il contesto per l'operazione di acquisizione del lease SSRS, se applicabile.

subOperationType

object (SqlSubOperationType)

Facoltativo. La sotto-operazione basata sul tipo di operazione.

Timestamp

Rappresentazione JSON
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

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

integer

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 (OperationError)
    }
  ]
}
Campi
kind

string

Questo valore è sempre sql#operationErrors.

errors[]

object (OperationError)

L'elenco degli errori riscontrati durante l'elaborazione di questa operazione.

OperationError

Rappresentazione JSON
{
  "kind": string,
  "code": string,
  "message": string
}
Campi
kind

string

Questo valore è sempre sql#operationError.

code

string

Identifica l'errore specifico che si è verificato.

message

string

Informazioni aggiuntive sull'errore riscontrato.

ApiWarning

Rappresentazione JSON
{
  "code": enum (SqlApiWarningCode),
  "message": string,
  "region": string
}
Campi
code

enum (SqlApiWarningCode)

Codice per identificare in modo univoco il tipo di avviso.

message

string

Il messaggio di avviso.

region

string

Il nome della regione per l'avviso REGION_UNREACHABLE.

ImportContext

Rappresentazione JSON
{
  "uri": string,
  "database": string,
  "kind": string,
  "fileType": enum (SqlFileType),
  "csvImportOptions": {
    object (SqlCsvImportOptions)
  },
  "importUser": string,
  "bakImportOptions": {
    object (SqlBakImportOptions)
  },
  "sqlImportOptions": {
    object (SqlImportOptions)
  },
  "tdeImportOptions": {
    object (SqlTdeImportOptions)
  }
}
Campi
uri

string

Percorso del file di importazione in Cloud Storage, nel formato gs://bucketName/fileName. I file gzip compressi (.gz) sono supportati quando fileType è SQL. L'istanza deve disporre delle autorizzazioni in scrittura per il bucket e dell'accesso in lettura al file.

database

string

Il database di destinazione per l'importazione. Se fileType è SQL, questo campo è obbligatorio solo se il file di importazione non specifica un database e viene sostituito da qualsiasi specifica del database nel file di importazione. Per le operazioni di importazione parallela dell'intera istanza, il database viene sostituito dal nome del database memorizzato nel nome della sottodirectory. Se fileType è CSV, deve essere specificato un database.

kind

string

Questo valore è sempre sql#importContext.

fileType

enum (SqlFileType)

Il tipo di file per l'URI specificato.`SQL: The file contains SQL statements. \CSV`: il file contiene dati CSV.

csvImportOptions

object (SqlCsvImportOptions)

Opzioni per l'importazione dei dati in formato CSV.

importUser

string

Utente di PostgreSQL per questa operazione di importazione. Solo istanze PostgreSQL.

bakImportOptions

object (SqlBakImportOptions)

Parametri di importazione specifici per i file .BAK di SQL Server

sqlImportOptions

object (SqlImportOptions)

Facoltativo. Opzioni per l'importazione di dati da istruzioni SQL.

tdeImportOptions

object (SqlTdeImportOptions)

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

string

La tabella in cui vengono importati i dati CSV.

columns[]

string

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

string

Specifica il carattere che deve essere visualizzato prima di un carattere di dati che deve essere sottoposto a escape.

quoteCharacter

string

Specifica il carattere di virgolette da utilizzare quando un valore dei dati è racchiuso tra virgolette.

fieldsTerminatedBy

string

Specifica il carattere che separa le colonne all'interno di ogni riga del file.

linesTerminatedBy

string

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 (EncryptionOptions)
  },
  "striped": boolean,
  "noRecovery": boolean,
  "recoveryOnly": boolean,
  "bakType": enum (BakType),
  "stopAt": string,
  "stopAtMark": string
}
Campi
encryptionOptions

object (EncryptionOptions)

striped

boolean

Indica se il set di backup in fase di ripristino è con striping. Si applica solo a Cloud SQL per SQL Server.

noRecovery

boolean

Indica se l'importazione del backup ripristinerà il database con l'opzione NORECOVERY. Si applica solo a Cloud SQL per SQL Server.

recoveryOnly

boolean

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

enum (BakType)

Tipo di contenuti bak, FULL o DIFF

stopAt

string (Timestamp format)

Facoltativo. Il timestamp in cui l'importazione deve essere interrotta. Questo timestamp è in formato RFC 3339 (ad esempio, 2023-10-01T16:19:00.094). Questo campo equivale alla parola chiave STOPAT e si applica solo a Cloud SQL per SQL Server.

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".

stopAtMark

string

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

string

Percorso del certificato (.cer) in Cloud Storage, nel formato gs://bucketName/fileName. L'istanza deve disporre delle autorizzazioni in scrittura per il bucket e dell'accesso in lettura al file.

pvkPath

string

Percorso della chiave privata del certificato (.pvk) in Cloud Storage, nel formato gs://bucketName/fileName. L'istanza deve disporre delle autorizzazioni in scrittura per il bucket e dell'accesso in lettura al file.

pvkPassword

string

Password che cripta la chiave privata

keepEncrypted

boolean

Facoltativo. Indica se il file importato rimane criptato.

BoolValue

Rappresentazione JSON
{
  "value": boolean
}
Campi
value

boolean

Il valore bool.

SqlImportOptions

Rappresentazione JSON
{
  "threads": integer,
  "parallel": boolean,
  "postgresImportOptions": {
    object (PostgresImportOptions)
  }
}
Campi
threads

integer

Facoltativo. Il numero di thread da utilizzare per l'importazione parallela.

parallel

boolean

Facoltativo. Indica se l'importazione deve essere eseguita in parallelo.

postgresImportOptions

object (PostgresImportOptions)

Facoltativo. Opzioni per l'importazione da un'istanza Cloud SQL per PostgreSQL.

Int32Value

Rappresentazione JSON
{
  "value": integer
}
Campi
value

integer

Il valore int32.

PostgresImportOptions

Rappresentazione JSON
{
  "clean": boolean,
  "ifExists": boolean
}
Campi
clean

boolean

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

boolean

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

string

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

string

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

string

Obbligatorio. Password che cripta la chiave privata.

name

string

Obbligatorio. Nome del certificato. Applicabile solo alle istanze SQL Server.

ExportContext

Rappresentazione JSON
{
  "uri": string,
  "databases": [
    string
  ],
  "kind": string,
  "sqlExportOptions": {
    object (SqlExportOptions)
  },
  "csvExportOptions": {
    object (SqlCsvExportOptions)
  },
  "fileType": enum (SqlFileType),
  "offload": boolean,
  "bakExportOptions": {
    object (SqlBakExportOptions)
  },
  "tdeExportOptions": {
    object (SqlTdeExportOptions)
  }
}
Campi
uri

string

Il percorso del file in Google Cloud Storage in cui verrà archiviata l'esportazione. L'URI è nel formato gs://bucketName/fileName. Se il file esiste già, la richiesta va a buon fine, ma l'operazione non riesce. Se fileType è SQL e il nome file termina con .gz, i contenuti sono compressi.

databases[]

string

Database da esportare.
MySQL instances: Se fileType è SQL e non viene specificato alcun database, vengono esportati tutti i database, ad eccezione del database di sistema mysql. Se fileType è CSV, puoi specificare un database utilizzando questa proprietà o la proprietà csvExportOptions.selectQuery, che ha la precedenza su questa proprietà.
PostgreSQL instances: Se non specifichi un database per nome, vengono esportati tutti i database utente nell'istanza. Sono esclusi i database di sistema e i database Cloud SQL utilizzati per gestire le operazioni interne. L'esportazione di tutti i database utente è disponibile solo per l'esportazione parallela in formato directory. Se fileType è CSV, questo database deve corrispondere a quello specificato nella proprietà csvExportOptions.selectQuery.
SQL Server instances: Devi specificare un database da esportare e fileType deve essere BAK.

kind

string

Questo valore è sempre sql#exportContext.

sqlExportOptions

object (SqlExportOptions)

Opzioni per l'esportazione dei dati come istruzioni SQL.

csvExportOptions

object (SqlCsvExportOptions)

Opzioni per l'esportazione dei dati in formato CSV. Solo istanze MySQL e PostgreSQL.

fileType

enum (SqlFileType)

Il tipo di file per l'URI specificato.

offload

boolean

Indica se eseguire un'esportazione serverless.

bakExportOptions

object (SqlBakExportOptions)

Opzioni per l'esportazione dei dati come file BAK.

tdeExportOptions

object (SqlTdeExportOptions)

Facoltativo. Parametri di esportazione specifici per i certificati TDE di SQL Server

SqlExportOptions

Rappresentazione JSON
{
  "tables": [
    string
  ],
  "schemaOnly": boolean,
  "mysqlExportOptions": {
    object (MysqlExportOptions)
  },
  "threads": integer,
  "parallel": boolean,
  "postgresExportOptions": {
    object (PostgresExportOptions)
  }
}
Campi
tables[]

string

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

boolean

Esporta solo gli schemi.

mysqlExportOptions

object (MysqlExportOptions)

threads

integer

Facoltativo. Il numero di thread da utilizzare per l'esportazione parallela.

parallel

boolean

Facoltativo. Indica se l'esportazione deve essere eseguita in parallelo.

postgresExportOptions

object (PostgresExportOptions)

Facoltativo. Opzioni per l'esportazione da un'istanza Cloud SQL per PostgreSQL.

MysqlExportOptions

Rappresentazione JSON
{
  "masterData": integer
}
Campi
masterData

integer

Opzione per includere l'istruzione SQL necessaria per configurare la replica. Se impostato su 1, il file di dump include un'istruzione CHANGE MASTER TO con le coordinate del log binario e --set-gtid-purged è impostato su ON. Se impostata su 2, l'istruzione CHANGE MASTER TO viene scritta come commento SQL e non ha alcun effetto. Se impostato su un valore diverso da 1, --set-gtid-purged è impostato su OFF.

PostgresExportOptions

Rappresentazione JSON
{
  "clean": boolean,
  "ifExists": boolean
}
Campi
clean

boolean

Facoltativo. Utilizza questa opzione per includere le istruzioni SQL DROP <object>. Utilizza queste istruzioni per eliminare gli oggetti del database prima di eseguire l'operazione di importazione.

ifExists

boolean

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

string

La query SELECT utilizzata per estrarre i dati.

escapeCharacter

string

Specifica il carattere che deve essere visualizzato prima di un carattere di dati che deve essere sottoposto a escape.

quoteCharacter

string

Specifica il carattere di virgolette da utilizzare quando un valore dei dati è racchiuso tra virgolette.

fieldsTerminatedBy

string

Specifica il carattere che separa le colonne all'interno di ogni riga del file.

linesTerminatedBy

string

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 (BakType),
  "copyOnly": boolean,
  "differentialBase": boolean,
  "exportLogStartTime": string,
  "exportLogEndTime": string
}
Campi
striped

boolean

Indica se l'esportazione deve essere suddivisa in strisce.

stripeCount

integer

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

enum (BakType)

Il tipo di questo file bak sarà export, FULL o DIFF, solo SQL Server

copyOnly
(deprecated)

boolean

Deprecato: copy_only è deprecato. Utilizza invece differential_base

differentialBase

boolean

Indica se il backup può essere utilizzato come base differenziale. Il backup copy_only non può essere utilizzato come base differenziale

exportLogStartTime

string (Timestamp format)

Facoltativo. Il timestamp di inizio in cui il log delle transazioni verrà incluso nell'operazione di esportazione. Formato RFC 3339 (ad esempio, 2023-10-01T16:19:00.094) in UTC. Se omesso, verranno inclusi tutti i log disponibili dall'inizio del periodo di conservazione. Applicato solo a Cloud SQL per SQL Server.

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".

exportLogEndTime

string (Timestamp format)

Facoltativo. Il timestamp di fine in cui il log delle transazioni verrà incluso nell'operazione di esportazione. Formato RFC 3339 (ad esempio, 2023-10-01T16:19:00.094) in formato UTC. Se omesso, verranno inclusi tutti i log disponibili fino all'ora corrente. Applicato solo a Cloud SQL per SQL Server.

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".

SqlTdeExportOptions

Rappresentazione JSON
{
  "certificatePath": string,
  "privateKeyPath": string,
  "privateKeyPassword": string,
  "name": string
}
Campi
certificatePath

string

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

string

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

string

Obbligatorio. Password che cripta la chiave privata.

name

string

Obbligatorio. Nome del certificato. Applicabile solo alle istanze SQL Server.

BackupContext

Rappresentazione JSON
{
  "backupId": string,
  "kind": string,
  "name": string
}
Campi
backupId

string (int64 format)

L'identificatore del backup.

kind

string

Questo valore è sempre sql#backupContext.

name

string

Il nome del backup. Formato: projects/{project}/backups/{backup}

PreCheckMajorVersionUpgradeContext

Rappresentazione JSON
{
  "targetDatabaseVersion": enum (SqlDatabaseVersion),
  "preCheckResponse": [
    {
      object (PreCheckResponse)
    }
  ],
  "kind": string,

  // Union field _max_runtime can be only one of the following:
  "maxRuntime": string
  // End of list of possible types for union field _max_runtime.
}
Campi
targetDatabaseVersion

enum (SqlDatabaseVersion)

Obbligatorio. La versione del database di destinazione di cui eseguire l'upgrade.

preCheckResponse[]

object (PreCheckResponse)

Solo output. Le risposte dell'operazione di pre-controllo.

kind

string

Facoltativo. Questo valore è sempre sql#preCheckMajorVersionUpgradeContext.

Campo unione _max_runtime.

_max_runtime può essere solo uno dei seguenti tipi:

maxRuntime

string (Duration format)

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 "s". Esempio: "3.5s".

PreCheckResponse

Rappresentazione JSON
{
  "actionsRequired": [
    string
  ],

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

  // Union field _message_type can be only one of the following:
  "messageType": enum (MessageType)
  // End of list of possible types for union field _message_type.
}
Campi
actionsRequired[]

string

Le azioni che l'utente deve intraprendere. Utilizza repeated per più azioni.

Campo unione _message.

_message può essere solo uno dei seguenti tipi:

message

string

Il messaggio da mostrare all'utente.

Campo unione _message_type.

_message_type può essere solo uno dei seguenti tipi:

messageType

enum (MessageType)

Il tipo di messaggio, ovvero informazioni, avviso o errore.

Durata

Rappresentazione JSON
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

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

integer

Frazioni di secondo con segno con risoluzione in nanosecondi dell'intervallo di tempo. Le durate inferiori a un secondo sono rappresentate con un campo seconds pari a 0 e un campo nanos positivo o negativo. Per durate di un secondo o più, un valore diverso da zero per il campo nanos deve avere lo stesso segno del campo seconds. Deve essere compreso tra -999.999.999 e +999.999.999 inclusi.

StartWorkloadCaptureContext

Rappresentazione JSON
{
  "enableLiveReplay": boolean,

  // Union field _replay_instance can be only one of the following:
  "replayInstance": string
  // End of list of possible types for union field _replay_instance.
}
Campi
enableLiveReplay

boolean

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 StartWorkloadReplayRequest separato. Nota: l'acquisizione del carico di lavoro viene eseguita in modo continuo fino all'emissione di un StopWorkloadCaptureRequest esplicito.

Campo unione _replay_instance.

_replay_instance può essere solo uno dei seguenti tipi:

replayInstance

string

Facoltativo. Obbligatorio se enable_live_replay è true. Il nome dell'istanza Cloud SQL in cui viene eseguito il workload acquisito (query SQL), escluso l'ID progetto (ad esempio, my-replay-instance). Il nome dell'istanza deve iniziare con una lettera minuscola e contenere solo lettere minuscole, numeri e trattini. La lunghezza combinata di project-ID:instance-name deve essere di massimo 98 caratteri.

StopWorkloadCaptureContext

Rappresentazione JSON
{
  "abortLiveReplay": boolean
}
Campi
abortLiveReplay

boolean

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

string

Obbligatorio. Il nome dell'istanza Cloud SQL in cui viene eseguito il workload acquisito (query SQL), escluso l'ID progetto (ad esempio, my-replay-instance). Il nome dell'istanza deve iniziare con una lettera minuscola e contenere solo lettere minuscole, numeri e trattini. La lunghezza combinata di project-ID:instance-name deve essere di massimo 98 caratteri.

workloadId

string

Solo output. L'ID del carico di lavoro da avviare nell'istanza di replay. Ogni acquisizione del workload genera un ID univoco nel formato workload-<epoch_timestamp> (ad esempio, workload-1786046400). Utilizza questo ID per iniziare a eseguire le query SQL registrate.

AcquireSsrsLeaseContext

Rappresentazione JSON
{

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

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

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

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

Campo unione _setup_login.

_setup_login può essere solo uno dei seguenti tipi:

setupLogin

string

Il nome utente da utilizzare come accesso di configurazione per connettersi al server di database per la configurazione di SSRS.

Campo unione _service_login.

_service_login può essere solo uno dei seguenti tipi:

serviceLogin

string

Il nome utente da utilizzare come accesso al servizio per connettersi al database dei report per la configurazione di SSRS.

Campo unione _report_database.

_report_database può essere solo uno dei seguenti tipi:

reportDatabase

string

Il database dei report da utilizzare per la configurazione di SSRS.

Campo unione _duration.

_duration può essere solo uno dei seguenti tipi:

duration

string (Duration format)

Durata del lease necessaria per la configurazione di SSRS.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

SqlSubOperationType

Rappresentazione JSON
{

  // Union field sub_operation_details can be only one of the following:
  "maintenanceType": enum (SqlMaintenanceType)
  // End of list of possible types for union field sub_operation_details.
}
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

enum (SqlMaintenanceType)

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: ❌