MCP Tools Reference: cloud-sql

Alat: update_user

Memperbarui pengguna database untuk instance Cloud SQL. Kasus penggunaan umum untuk update_user adalah memberikan peran cloudsqlsuperuser kepada pengguna, yang dapat memberikan banyak izin yang diperlukan kepada pengguna.

Alat ini hanya mendukung pembaruan pengguna untuk menetapkan peran database.

  • Alat ini menampilkan operasi yang berjalan lama. Gunakan alat get_operation untuk melakukan polling statusnya hingga operasi selesai.
  • Sebelum memanggil alat update_user, selalu periksa konfigurasi pengguna yang ada, seperti jenis pengguna dengan alat list_users.
  • Sebagai kasus khusus untuk MySQL, jika alat list_users menampilkan alamat email lengkap untuk kolom iamEmail, misalnya {name=test-account, iamEmail=test-account@project-id.iam.gserviceaccount.com}, maka dalam permintaan update_user, gunakan alamat email lengkap di kolom iamEmail pada kolom name permintaan alat Anda. Misalnya, name=test-account@project-id.iam.gserviceaccount.com.

Parameter utama untuk memperbarui peran pengguna:

  • database_roles: Daftar peran database yang akan ditetapkan kepada pengguna.
  • revokeExistingRoles: Kolom boolean (default: false) yang mengontrol cara penanganan peran yang ada.

Cara kerja pembaruan peran:

  1. Jika revokeExistingRoles bernilai benar:

    • Semua peran yang sudah ada yang diberikan kepada pengguna tetapi TIDAK ada dalam daftar database_roles yang diberikan akan DICABUT.
    • Mencabut hanya berlaku untuk peran non-sistem. Peran sistem seperti cloudsqliamuser, dll. tidak akan dicabut.
    • Semua peran dalam daftar database_roles yang BELUM dimiliki pengguna akan DIBERIKAN.
    • Jika database_roles kosong, semua peran non-sistem yang ada akan dibatalkan.

  2. Jika revokeExistingRoles salah (default):

    • Semua peran dalam daftar database_roles yang BELUM dimiliki pengguna akan DIBERIKAN.
    • Peran yang ada yang TIDAK ada dalam daftar database_roles akan TETAP ADA.
    • Jika database_roles kosong, tidak ada perubahan pada peran pengguna.

Contoh:

  • Peran yang Ada: [roleA, roleB]

    • Permintaan: database_roles: [roleB, roleC], revokeExistingRoles: true
    • Hasil: Mencabut roleA, Memberikan roleC. Peran pengguna menjadi [roleB, roleC].
    • Permintaan: database_roles: [roleB, roleC], revokeExistingRoles: false
    • Hasil: Hibah roleC. Peran pengguna menjadi [roleA, roleB, roleC].
    • Permintaan: database_roles: [], revokeExistingRoles: true
    • Hasil: Mencabut roleA, Mencabut roleB. Peran pengguna menjadi [].
    • Permintaan: database_roles: [], revokeExistingRoles: false
    • Hasil: Tidak ada perubahan. Peran pengguna tetap [roleA, roleB].

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP update_user.

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

Skema Input

Permintaan pembaruan pengguna untuk MCP.

SqlUsersUpdateMcpRequest

Representasi JSON 
{
  "host": string,
  "instance": string,
  "name": string,
  "project": string,
  "databaseRoles": [
    string
  ],
  "type": enum (SqlUserType),

  // Union field _revoke_existing_roles can be only one of the following:
  "revokeExistingRoles": boolean
  // End of list of possible types for union field _revoke_existing_roles.
}
Kolom
host

string

Opsional. Host pengguna di instance.
instance

string

Wajib. ID instance database. Hal ini tidak mencakup project ID.
name

string

Wajib. Nama pengguna di instance.
project

string

Wajib. Project ID project yang berisi instance.
databaseRoles[]

string

Opsional. Daftar peran database yang akan diberikan kepada pengguna. body.database_roles akan diabaikan untuk permintaan update.
type

enum (SqlUserType)

Wajib. Jenis pengguna. Menentukan metode untuk mengautentikasi pengguna selama login. Defaultnya adalah jenis pengguna bawaan database.

Kolom union _revoke_existing_roles.

_revoke_existing_roles hanya dapat berupa salah satu dari berikut:
revokeExistingRoles

boolean

Opsional. Mencabut peran yang ada yang diberikan kepada pengguna.

Skema Output

Resource Operasi. Untuk operasi yang berhasil dan menampilkan resource Operasi, hanya kolom yang relevan dengan operasi yang diisi dalam resource.

Operasi

Representasi 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)
  }
}
Kolom
kind

string

Nilai ini selalu sql#operation.
targetLink

string
status

enum (SqlOperationStatus)

Status operasi.
user

string

Alamat email pengguna yang memulai operasi ini.
insertTime

string (Timestamp format)

Waktu operasi ini dimasukkan dalam antrean di zona waktu UTC dalam format RFC 3339, misalnya 2012-11-15T16:19:00.094Z.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
startTime

string (Timestamp format)

Waktu operasi ini benar-benar dimulai dalam zona waktu UTC dalam format RFC 3339, misalnya 2012-11-15T16:19:00.094Z.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Waktu selesainya operasi ini dalam zona waktu UTC dalam format RFC 3339, misalnya 2012-11-15T16:19:00.094Z.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
error

object (OperationErrors)

Jika terjadi error selama pemrosesan operasi ini, kolom ini akan diisi.
apiWarning

object (ApiWarning)

Pesan peringatan Admin API.
operationType

enum (SqlOperationType)

Jenis operasi. Nilai yang valid adalah: * CREATE * DELETE * UPDATE * RESTART * IMPORT * EXPORT * BACKUP_VOLUME * RESTORE_VOLUME * CREATE_USER * DELETE_USER * CREATE_DATABASE * DELETE_DATABASE
importContext

object (ImportContext)

Konteks untuk operasi impor, jika ada.
exportContext

object (ExportContext)

Konteks untuk operasi ekspor, jika berlaku.
backupContext

object (BackupContext)

Konteks untuk operasi pencadangan, jika ada.
preCheckMajorVersionUpgradeContext

object (PreCheckMajorVersionUpgradeContext)

Kolom ini hanya diisi jika operation_type adalah PRE_CHECK_MAJOR_VERSION_UPGRADE. Pesan PreCheckMajorVersionUpgradeContext itu sendiri berisi detail untuk pra-pemeriksaan tersebut, seperti versi database target untuk upgrade dan hasil pemeriksaan (termasuk peringatan atau error yang ditemukan).
name

string

ID yang mengidentifikasi operasi secara unik. Anda dapat menggunakan ID ini untuk mengambil resource Operasi yang memiliki informasi tentang operasi.
targetId

string

Nama resource tempat operasi ini berjalan.
selfLink

string

URI resource ini.
targetProject

string

ID project instance target yang terkait dengan operasi ini.
acquireSsrsLeaseContext

object (AcquireSsrsLeaseContext)

Konteks untuk operasi perolehan sewa SSRS, jika berlaku.
subOperationType

object (SqlSubOperationType)

Opsional. Sub-operasi berdasarkan jenis operasi.

Stempel waktu

Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z).
nanos

integer

Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nanos non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif.

OperationErrors

Representasi JSON 
{
  "kind": string,
  "errors": [
    {
      object (OperationError)
    }
  ]
}
Kolom
kind

string

Nilai ini selalu sql#operationErrors.
errors[]

object (OperationError)

Daftar error yang terjadi saat memproses operasi ini.

OperationError

Representasi JSON 
{
  "kind": string,
  "code": string,
  "message": string
}
Kolom
kind

string

Nilai ini selalu sql#operationError.
code

string

Mengidentifikasi error spesifik yang terjadi.
message

string

Informasi tambahan tentang error yang terjadi.

ApiWarning

Representasi JSON 
{
  "code": enum (SqlApiWarningCode),
  "message": string,
  "region": string
}
Kolom
code

enum (SqlApiWarningCode)

Kode untuk mengidentifikasi jenis peringatan secara unik.
message

string

Pesan peringatan.
region

string

Nama wilayah untuk peringatan REGION_UNREACHABLE.

ImportContext

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

string

Jalur ke file impor di Cloud Storage, dalam bentuk gs://bucketName/fileName. File gzip terkompresi (.gz) didukung jika fileType adalah SQL. Instance harus memiliki izin tulis ke bucket dan akses baca ke file.
database

string

Database target untuk impor. Jika fileType adalah SQL, kolom ini hanya diperlukan jika file impor tidak menentukan database, dan diganti oleh spesifikasi database apa pun dalam file impor. Untuk operasi impor paralel seluruh instance, database digantikan oleh nama database yang disimpan dalam nama subdirektori. Jika fileType adalah CSV, satu database harus ditentukan.
kind

string

Nilai ini selalu sql#importContext.
fileType

enum (SqlFileType)

Jenis file untuk URI yang ditentukan.`SQL: The file contains SQL statements. \CSV`: File berisi data CSV.
csvImportOptions

object (SqlCsvImportOptions)

Opsi untuk mengimpor data sebagai CSV.
importUser

string

Pengguna PostgreSQL untuk operasi impor ini. Khusus instance PostgreSQL.
bakImportOptions

object (SqlBakImportOptions)

Parameter impor khusus untuk file .BAK SQL Server
sqlImportOptions

object (SqlImportOptions)

Opsional. Opsi untuk mengimpor data dari pernyataan SQL.
tdeImportOptions

object (SqlTdeImportOptions)

Opsional. Mengimpor parameter khusus untuk sertifikat TDE SQL Server

SqlCsvImportOptions

Representasi JSON 
{
  "table": string,
  "columns": [
    string
  ],
  "escapeCharacter": string,
  "quoteCharacter": string,
  "fieldsTerminatedBy": string,
  "linesTerminatedBy": string
}
Kolom
table

string

Tabel tempat data CSV diimpor.
columns[]

string

Kolom tempat data CSV diimpor. Jika tidak ditentukan, semua kolom tabel database akan dimuat dengan data CSV.
escapeCharacter

string

Menentukan karakter yang akan muncul sebelum karakter data yang perlu di-escape.
quoteCharacter

string

Menentukan karakter kutipan yang akan digunakan saat nilai data dikutip.
fieldsTerminatedBy

string

Menentukan karakter yang memisahkan kolom dalam setiap baris (baris) file.
linesTerminatedBy

string

Ini digunakan untuk memisahkan baris. Jika baris tidak berisi semua kolom, kolom lainnya akan ditetapkan ke nilai defaultnya.

SqlBakImportOptions

Representasi JSON 
{
  "encryptionOptions": {
    object (EncryptionOptions)
  },
  "striped": boolean,
  "noRecovery": boolean,
  "recoveryOnly": boolean,
  "bakType": enum (BakType),
  "stopAt": string,
  "stopAtMark": string
}
Kolom
encryptionOptions

object (EncryptionOptions)
striped

boolean

Apakah set cadangan yang dipulihkan di-striping atau tidak. Hanya berlaku untuk Cloud SQL untuk SQL Server.
noRecovery

boolean

Apakah pengimporan cadangan akan memulihkan database dengan opsi NORECOVERY atau tidak. Hanya berlaku untuk Cloud SQL untuk SQL Server.
recoveryOnly

boolean

Apakah permintaan impor cadangan hanya akan mengaktifkan database tanpa mendownload konten Bak. Hanya salah satu dari "no_recovery" dan "recovery_only" yang dapat bernilai benar, jika tidak, error akan ditampilkan. Hanya berlaku untuk Cloud SQL untuk SQL Server.
bakType

enum (BakType)

Jenis konten bak, FULL atau DIFF
stopAt

string (Timestamp format)

Opsional. Stempel waktu saat impor harus berhenti. Stempel waktu ini dalam format RFC 3339 (misalnya, 2023-10-01T16:19:00.094). Kolom ini setara dengan kata kunci STOPAT dan hanya berlaku untuk Cloud SQL untuk SQL Server.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
stopAtMark

string

Opsional. Transaksi yang ditandai tempat impor harus dihentikan. Kolom ini setara dengan kata kunci STOPATMARK dan hanya berlaku untuk Cloud SQL untuk SQL Server.

EncryptionOptions

Representasi JSON 
{
  "certPath": string,
  "pvkPath": string,
  "pvkPassword": string,
  "keepEncrypted": boolean
}
Kolom
certPath

string

Jalur ke Sertifikat (.cer) di Cloud Storage, dalam bentuk gs://bucketName/fileName. Instance harus memiliki izin tulis ke bucket dan akses baca ke file.
pvkPath

string

Jalur ke Kunci Pribadi Sertifikat (.pvk) di Cloud Storage, dalam bentuk gs://bucketName/fileName. Instance harus memiliki izin tulis ke bucket dan akses baca ke file.
pvkPassword

string

Sandi yang mengenkripsi kunci pribadi
keepEncrypted

boolean

Opsional. Apakah file yang diimpor tetap dienkripsi.

BoolValue

Representasi JSON 
{
  "value": boolean
}
Kolom
value

boolean

Nilai bool.

SqlImportOptions

Representasi JSON 
{
  "threads": integer,
  "parallel": boolean,
  "postgresImportOptions": {
    object (PostgresImportOptions)
  }
}
Kolom
threads

integer

Opsional. Jumlah thread yang akan digunakan untuk impor paralel.
parallel

boolean

Opsional. Apakah impor harus paralel atau tidak.
postgresImportOptions

object (PostgresImportOptions)

Opsional. Opsi untuk mengimpor dari instance Cloud SQL untuk PostgreSQL.

Int32Value

Representasi JSON 
{
  "value": integer
}
Kolom
value

integer

Nilai int32.

PostgresImportOptions

Representasi JSON 
{
  "clean": boolean,
  "ifExists": boolean
}
Kolom
clean

boolean

Opsional. Flag --clean untuk utilitas pg_restore. Flag ini hanya berlaku jika Anda mengaktifkan Cloud SQL untuk mengimpor file secara paralel.
ifExists

boolean

Opsional. Flag --if-exists untuk utilitas pg_restore. Flag ini hanya berlaku jika Anda mengaktifkan Cloud SQL untuk mengimpor file secara paralel.

SqlTdeImportOptions

Representasi JSON 
{
  "certificatePath": string,
  "privateKeyPath": string,
  "privateKeyPassword": string,
  "name": string
}
Kolom
certificatePath

string

Wajib. Jalur ke kunci publik sertifikat TDE dalam bentuk gs://bucketName/fileName. Instance harus memiliki akses baca ke file. Hanya berlaku untuk instance SQL Server.
privateKeyPath

string

Wajib. Jalur ke kunci pribadi sertifikat TDE dalam bentuk gs://bucketName/fileName. Instance harus memiliki akses baca ke file. Hanya berlaku untuk instance SQL Server.
privateKeyPassword

string

Wajib. Sandi yang mengenkripsi kunci pribadi.
name

string

Wajib. Nama sertifikat. Hanya berlaku untuk instance SQL Server.

ExportContext

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

string

Jalur ke file di Google Cloud Storage tempat penyimpanan hasil ekspor. URI berbentuk gs://bucketName/fileName. Jika file sudah ada, permintaan akan berhasil, tetapi operasi akan gagal. Jika fileType adalah SQL dan nama file diakhiri dengan .gz, konten akan dikompresi.
databases[]

string

Database yang akan diekspor.
MySQL instances: Jika fileType adalah SQL dan tidak ada database yang ditentukan, semua database akan diekspor, kecuali database sistem mysql. Jika fileType adalah CSV, Anda dapat menentukan satu database, baik dengan menggunakan properti ini atau dengan menggunakan properti csvExportOptions.selectQuery, yang lebih diprioritaskan daripada properti ini.
PostgreSQL instances: Jika Anda tidak menentukan database berdasarkan nama, semua database pengguna di instance akan diekspor. Hal ini tidak termasuk database sistem dan database Cloud SQL yang digunakan untuk mengelola operasi internal. Mengekspor semua database pengguna hanya tersedia untuk ekspor paralel berformat direktori. Jika fileType adalah CSV, database ini harus cocok dengan yang ditentukan dalam properti csvExportOptions.selectQuery.
SQL Server instances: Anda harus menentukan satu database yang akan diekspor, dan fileType harus BAK.
kind

string

Nilai ini selalu sql#exportContext.
sqlExportOptions

object (SqlExportOptions)

Opsi untuk mengekspor data sebagai pernyataan SQL.
csvExportOptions

object (SqlCsvExportOptions)

Opsi untuk mengekspor data sebagai CSV. Hanya instance MySQL dan PostgreSQL.
fileType

enum (SqlFileType)

Jenis file untuk URI yang ditentukan.
offload

boolean

Apakah akan melakukan ekspor serverless atau tidak.
bakExportOptions

object (SqlBakExportOptions)

Opsi untuk mengekspor data sebagai file BAK.
tdeExportOptions

object (SqlTdeExportOptions)

Opsional. Mengekspor parameter khusus untuk sertifikat TDE SQL Server

SqlExportOptions

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

string

Tabel yang akan diekspor, atau yang telah diekspor, dari database yang ditentukan. Jika Anda menentukan tabel, tentukan satu dan hanya satu database. Untuk instance PostgreSQL, Anda hanya dapat menentukan satu tabel.
schemaOnly

boolean

Hanya mengekspor skema.
mysqlExportOptions

object (MysqlExportOptions)
threads

integer

Opsional. Jumlah thread yang akan digunakan untuk ekspor paralel.
parallel

boolean

Opsional. Apakah ekspor harus paralel atau tidak.
postgresExportOptions

object (PostgresExportOptions)

Opsional. Opsi untuk mengekspor dari instance Cloud SQL untuk PostgreSQL.

MysqlExportOptions

Representasi JSON 
{
  "masterData": integer
}
Kolom
masterData

integer

Opsi untuk menyertakan pernyataan SQL yang diperlukan untuk menyiapkan replikasi. Jika disetel ke 1, file dump akan menyertakan pernyataan CHANGE MASTER TO dengan koordinat log biner, dan --set-gtid-purged disetel ke ON. Jika disetel ke 2, pernyataan CHANGE MASTER TO ditulis sebagai komentar SQL dan tidak berpengaruh. Jika disetel ke nilai selain 1, --set-gtid-purged disetel ke OFF.

PostgresExportOptions

Representasi JSON 
{
  "clean": boolean,
  "ifExists": boolean
}
Kolom
clean

boolean

Opsional. Gunakan opsi ini untuk menyertakan DROP

<object>

Pernyataan SQL. Gunakan pernyataan ini untuk menghapus objek database sebelum menjalankan operasi impor.
ifExists

boolean

Opsional. Opsi untuk menyertakan pernyataan SQL IF EXISTS dengan setiap pernyataan DROP yang dihasilkan oleh clean.

SqlCsvExportOptions

Representasi JSON 
{
  "selectQuery": string,
  "escapeCharacter": string,
  "quoteCharacter": string,
  "fieldsTerminatedBy": string,
  "linesTerminatedBy": string
}
Kolom
selectQuery

string

Kueri pemilihan yang digunakan untuk mengekstrak data.
escapeCharacter

string

Menentukan karakter yang akan muncul sebelum karakter data yang perlu di-escape.
quoteCharacter

string

Menentukan karakter kutipan yang akan digunakan saat nilai data dikutip.
fieldsTerminatedBy

string

Menentukan karakter yang memisahkan kolom dalam setiap baris (baris) file.
linesTerminatedBy

string

Ini digunakan untuk memisahkan baris. Jika baris tidak berisi semua kolom, kolom lainnya akan ditetapkan ke nilai defaultnya.

SqlBakExportOptions

Representasi JSON 
{
  "striped": boolean,
  "stripeCount": integer,
  "bakType": enum (BakType),
  "copyOnly": boolean,
  "differentialBase": boolean,
  "exportLogStartTime": string,
  "exportLogEndTime": string
}
Kolom
striped

boolean

Apakah ekspor harus ditampilkan dalam format bergaris atau tidak.
stripeCount

integer

Opsi untuk menentukan jumlah garis yang akan digunakan untuk ekspor. Jika kosong, dan nilai kolom bergaris adalah benar (true), jumlah garis akan dipilih secara otomatis.
bakType

enum (BakType)

Jenis file bak ini adalah export, FULL, atau DIFF, khusus SQL Server
copyOnly
(deprecated)

boolean

Tidak digunakan lagi: copy_only tidak digunakan lagi. Gunakan differential_base
differentialBase

boolean

Apakah cadangan dapat digunakan sebagai basis diferensial atau tidak, cadangan copy_only tidak dapat ditayangkan sebagai basis diferensial
exportLogStartTime

string (Timestamp format)

Opsional. Stempel waktu awal saat log transaksi akan disertakan dalam operasi ekspor. Format RFC 3339 (misalnya, 2023-10-01T16:19:00.094) dalam UTC. Jika tidak disertakan, semua log yang tersedia sejak awal periode retensi akan disertakan. Hanya diterapkan ke Cloud SQL untuk SQL Server.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
exportLogEndTime

string (Timestamp format)

Opsional. Stempel waktu akhir saat log transaksi akan disertakan dalam operasi ekspor. Format RFC 3339 (misalnya, 2023-10-01T16:19:00.094) dalam UTC. Jika tidak disertakan, semua log yang tersedia hingga waktu saat ini akan disertakan. Hanya diterapkan ke Cloud SQL untuk SQL Server.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

SqlTdeExportOptions

Representasi JSON 
{
  "certificatePath": string,
  "privateKeyPath": string,
  "privateKeyPassword": string,
  "name": string
}
Kolom
certificatePath

string

Wajib. Jalur ke kunci publik sertifikat TDE dalam bentuk gs://bucketName/fileName. Instance harus memiliki akses tulis ke bucket. Hanya berlaku untuk instance SQL Server.
privateKeyPath

string

Wajib. Jalur ke kunci pribadi sertifikat TDE dalam bentuk gs://bucketName/fileName. Instance harus memiliki akses tulis ke lokasi. Hanya berlaku untuk instance SQL Server.
privateKeyPassword

string

Wajib. Sandi yang mengenkripsi kunci pribadi.
name

string

Wajib. Nama sertifikat. Hanya berlaku untuk instance SQL Server.

BackupContext

Representasi JSON 
{
  "backupId": string,
  "kind": string,
  "name": string
}
Kolom
backupId

string (int64 format)

ID cadangan.
kind

string

Nilai ini selalu sql#backupContext.
name

string

Nama cadangan. Format: projects/{project}/backups/{backup}

PreCheckMajorVersionUpgradeContext

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

enum (SqlDatabaseVersion)

Wajib. Versi database target yang akan diupgrade.
preCheckResponse[]

object (PreCheckResponse)

Hanya output. Respons dari operasi pra-pemeriksaan.
kind

string

Opsional. Nilai ini selalu sql#preCheckMajorVersionUpgradeContext.

PreCheckResponse

Representasi 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.
}
Kolom
actionsRequired[]

string

Tindakan yang perlu dilakukan pengguna. Gunakan berulang untuk beberapa tindakan.

Kolom union _message.

_message hanya dapat berupa salah satu dari berikut:
message

string

Pesan yang akan ditampilkan kepada pengguna.

Kolom union _message_type.

_message_type hanya dapat berupa salah satu dari berikut:
messageType

enum (MessageType)

Jenis pesan, apakah berupa info, peringatan, atau error.

AcquireSsrsLeaseContext

Representasi 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.
}
Kolom

Kolom union _setup_login.

_setup_login hanya dapat berupa salah satu dari berikut:
setupLogin

string

Nama pengguna yang akan digunakan sebagai login penyiapan untuk terhubung ke server database untuk penyiapan SSRS.

Kolom union _service_login.

_service_login hanya dapat berupa salah satu dari berikut:
serviceLogin

string

Nama pengguna yang akan digunakan sebagai login layanan untuk terhubung ke database laporan untuk penyiapan SSRS.

Kolom union _report_database.

_report_database hanya dapat berupa salah satu dari berikut:
reportDatabase

string

Database laporan yang akan digunakan untuk penyiapan SSRS.

Kolom union _duration.

_duration hanya dapat berupa salah satu dari berikut:
duration

string (Duration format)

Durasi sewa diperlukan untuk penyiapan SSRS.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

Durasi

Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Detik bertanda dari rentang waktu. Harus dari -315.576.000.000 hingga +315.576.000.000 inklusif. Catatan: batas ini dihitung dari: 60 dtk/mnt * 60 mnt/j * 24 j/h * 365,25 h/thn * 10.000 thn
nanos

integer

Pecahan detik bertanda pada resolusi nanodetik rentang waktu. Durasi kurang dari satu detik ditampilkan dengan kolom seconds 0 dan kolom nanos positif atau negatif. Untuk durasi satu detik atau lebih, nilai non-nol untuk kolom nanos harus memiliki tanda yang sama dengan kolom seconds. Harus dari -999.999.999 hingga +999.999.999 inklusif.

SqlSubOperationType

Representasi 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.
}
Kolom
Kolom union sub_operation_details. Detail sub-operasi yang sesuai dengan jenis operasi. sub_operation_details hanya ada berupa salah satu diantara berikut:
maintenanceType

enum (SqlMaintenanceType)

Jenis pemeliharaan yang akan dilakukan pada instance.

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ❌ | Petunjuk Hanya Baca: ❌ | Petunjuk Dunia Terbuka: ❌