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

Per eseguire questa operazione:

  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 nel bucket Cloud Storage fornito. Utilizza un comando come gcloud storage buckets add-iam-policy-binding o una richiesta all'API Cloud Storage. Possono essere necessari da 2 a 7 minuti o più prima che il ruolo venga concesso e le autorizzazioni vengano propagate al account di servizio in Cloud Storage. Se si verifica un errore di autorizzazione dopo aver aggiornato il criterio 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 del sistema. Il tipo di file può in genere essere 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"
        }

Non è presente alcun parametro database per MySQL, poiché il nome del database deve essere presente nel file SQL. Specifica un solo URI. Al di fuori di 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 del suo stato fino al completamento dell'operazione.

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

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

Schema di input

Richiesta di importazione dell'istanza.

SqlInstancesImportRequest

Rappresentazione JSON 
{
  "instance": string,
  "project": string,
  "body": {
    object (InstancesImportRequest)
  }
}
Campi
instance

string

ID istanza Cloud SQL. L'ID progetto non è incluso.
project

string

ID progetto del progetto che contiene l'istanza.
body

object (InstancesImportRequest)

InstancesImportRequest

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

object (ImportContext)

Contiene dettagli sull'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 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 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 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.

Timestamp

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

string (int64 format)

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

integer

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

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

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

Il 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 parte in nanosecondi della durata, non un'alternativa ai secondi. I valori negativi dei secondi con frazioni devono comunque avere valori di nanosecondi non negativi che vengono conteggiati in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.

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

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