MCP Tools Reference: cloud-sql

Strumento: update_instance

Aggiorna parzialmente le impostazioni di configurazione di un'istanza Cloud SQL.

  • Questo strumento restituisce un'operazione a lunga esecuzione. Utilizza lo strumento get_operation per eseguire il polling del relativo stato fino al completamento dell'operazione.
  • Alcune operazioni di aggiornamento, come la modifica dell'upgrade della versione o del livello dell'istanza, potrebbero causare il riavvio dell'istanza, con conseguente tempo di inattività. Prima di procedere con queste operazioni, chiedi conferma all'utente.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP update_instance.

Curl Request 
                  
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": "update_instance",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

Richiesta di patch dell'istanza per MCP.

SqlInstancesPatchMcpRequest

Rappresentazione JSON 
{
  "project": string,
  "instance": string,
  "databaseFlags": [
    {
      object (DatabaseFlags)
    }
  ],
  "dataApiAccess": enum (DataApiAccess),
  "dataDiskSizeGb": string,
  "googleMlIntegrationEnabled": boolean,
  "dataCacheConfig": {
    object (DataCacheConfig)
  },
  "edition": string,
  "ipv4Enabled": boolean,

  // Union field _psc_mcp_config can be only one of the following:
  "pscMcpConfig": {
    object (PscMcpConfig)
  }
  // End of list of possible types for union field _psc_mcp_config.

  // Union field _psa_mcp_config can be only one of the following:
  "psaMcpConfig": {
    object (PsaMcpConfig)
  }
  // End of list of possible types for union field _psa_mcp_config.

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

string

Obbligatorio. ID progetto del progetto che contiene l'istanza.
instance

string

Obbligatorio. ID istanza Cloud SQL. L'ID progetto non è incluso.
databaseFlags[]

object (DatabaseFlags)

Facoltativo. I flag di database.
dataApiAccess

enum (DataApiAccess)

Facoltativo. Le impostazioni per controllare l'accesso all'API di dati a un'istanza.
dataDiskSizeGb

string (Int64Value format)

Facoltativo. Dimensione del disco dati in GB.
googleMlIntegrationEnabled

boolean

Facoltativo. Consente alle istanze Cloud SQL di connettersi a Vertex AI per inoltrare richieste di previsioni e insight in tempo reale all'AI. Il valore predefinito è false. Questo vale solo per le istanze Cloud SQL per MySQL e Cloud SQL per PostgreSQL.
dataCacheConfig

object (DataCacheConfig)

Facoltativo. Configurazione della cache dei dati. Una cache dei dati può migliorare le prestazioni per i workload con molte letture memorizzando nella cache i dati a cui si accede di frequente in memoria.
edition

string

Facoltativo. La versione dell'istanza, che può essere ENTERPRISE o ENTERPRISE_PLUS.
ipv4Enabled

boolean

Facoltativo. Indica se abilitare l'IP pubblico per l'istanza.

L'attivazione di questo flag rende la risorsa accessibile da internet pubblico, il che rappresenta un rischio per la sicurezza se non gestito correttamente. Ti consigliamo di mantenere le risorse private, quando possibile.

Campo unione _psc_mcp_config.

_psc_mcp_config può essere solo uno dei seguenti tipi:
pscMcpConfig

object (PscMcpConfig)

Facoltativo. Configurazione per l'aggiornamento dell'istanza Private Service Connect (PSC).

Campo unione _psa_mcp_config.

_psa_mcp_config può essere solo uno dei seguenti tipi:
psaMcpConfig

object (PsaMcpConfig)

Facoltativo. Configurazione per l'aggiornamento dell'istanza di accesso privato ai servizi (PSA).

Campo unione _tier.

_tier può essere solo uno dei seguenti tipi:
tier

string

Facoltativo. Il livello (o il tipo di macchina) per questa istanza. Formato: db-custom-{CPUs}-{Memory}.

DatabaseFlags

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

string

Il nome del flag. Questi flag vengono passati all'avvio dell'istanza, quindi includi sia le opzioni del server sia le variabili di sistema. I flag vengono specificati con trattini bassi, non trattini. Per saperne di più, consulta Configurazione dei flag di database nella documentazione di Cloud SQL.
value

string

Il valore del flag. I flag booleani sono impostati su on per true e off per false. Questo campo deve essere omesso se il flag non accetta un valore.

Int64Value

Rappresentazione JSON 
{
  "value": string
}
Campi
value

string (int64 format)

Il valore int64.

BoolValue

Rappresentazione JSON 
{
  "value": boolean
}
Campi
value

boolean

Il valore booleano.

PscMcpConfig

Rappresentazione JSON 
{
  "pscEnabled": boolean,
  "project": string,
  "network": string
}
Campi
pscEnabled

boolean

Facoltativo. Indica se la connettività PSC è abilitata per questa istanza.
project

string

Facoltativo. L'ID progetto del progetto di servizio di questo endpoint consumer PSC.

Questo vale solo se network è una rete VPC condivisa.
network

string

Facoltativo. La rete consumer di questo endpoint consumer. Deve essere un percorso della risorsa che include sia il progetto host che il nome della rete.

Ad esempio, projects/project1/global/networks/network1.

Il progetto host consumer di questa rete potrebbe essere diverso dal progetto di servizio consumer.

DataCacheConfig

Rappresentazione JSON 
{
  "dataCacheEnabled": boolean
}
Campi
dataCacheEnabled

boolean

Indica se la cache dei dati è abilitata per l'istanza.

PsaMcpConfig

Rappresentazione JSON 
{
  "network": string,

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

string

Obbligatorio. Il nome completo della risorsa della rete VPC a cui connettersi tramite PSA. Formato: projects/{project}/global/networks/{network} OBBLIGATORIO se abiliti PSA.

Campo unione _allocated_ip_range.

_allocated_ip_range può essere solo uno dei seguenti tipi:
allocatedIpRange

string

(Facoltativo) Il nome di un intervallo IP allocato nel VPC consumer.

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)
  },
  "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 questa operazione.
insertTime

string (Timestamp format)

L'ora in cui questa operazione è stata inserita nella coda 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".
startTime

string (Timestamp format)

L'ora in cui è iniziata effettivamente 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".
endTime

string (Timestamp format)

L'ora in cui è terminata 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".
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 contiene i dettagli del controllo preliminare, ad esempio la versione del database di destinazione per l'upgrade e i risultati del controllo (inclusi eventuali avvisi o errori rilevati).
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 di destinazione correlata a questa operazione.
acquireSsrsLeaseContext

object (AcquireSsrsLeaseContext)

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

object (SqlSubOperationType)

Facoltativo. L'operazione secondaria in base al tipo di operazione.

Timestamp

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

string (int64 format)

Rappresenta i secondi di tempo UTC dall'epoca di Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).
nanos

integer

Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la porzione di nanosecondi della durata, non un'alternativa ai secondi. I valori negativi dei secondi con frazioni devono comunque avere valori di nanosecondi non negativi che vengono conteggiati in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.

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 di 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 archiviato 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 importare i 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 importare i dati dalle istruzioni SQL.
tdeImportOptions

object (SqlTdeImportOptions)

Facoltativo. Importa 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 specificate, 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 citazione da utilizzare quando un valore di dati è citato.
fieldsTerminatedBy

string

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

string

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 è suddiviso in bande. 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à online il database senza scaricare i contenuti Bak. Solo uno dei valori "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 interrompersi. Questo timestamp è nel 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 deve interrompersi l'importazione. Questo campo è equivalente 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 di 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 di 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 booleano.

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 parallela o meno.
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. Percorso della chiave pubblica del certificato TDE nel formato gs://bucketName/fileName. L'istanza deve disporre dell'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 è 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 il 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. Esporta i parametri 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 parallela o meno.
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 impostato 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 DROP

<object>

istruzioni SQL. 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 citazione da utilizzare quando un valore di dati è citato.
fieldsTerminatedBy

string

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

string

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 il numero di strisce da utilizzare per l'esportazione. Se è vuoto e il valore del campo a strisce è true, il numero di strisce 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. Usa invece differential_base
differentialBase

boolean

Indica se il backup può essere utilizzato come backup differenziale di sola copia
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 formato 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 finale 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 al momento attuale. 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 disporre dell'accesso in scrittura al bucket. 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 scrittura alla posizione. 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
}
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 precontrollo.
kind

string

Facoltativo. Questo valore è sempre sql#preCheckMajorVersionUpgradeContext.

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 ripetuto 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, che può essere informativo, di avviso o di errore.

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

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 in base a: 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 di 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.

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 dell'operazione secondaria 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.

Annotazioni dello strumento

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