MCP Tools Reference: cloud-sql

工具：update_instance

部分更新 Cloud SQL 執行個體的設定。

  • 這項工具會傳回長時間執行的作業。使用 get_operation 工具輪詢狀態，直到作業完成為止。

以下範例示範如何使用 curl 叫用 update_instance MCP 工具。

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

輸入內容的結構定義

MCP 的執行個體修補要求。

SqlInstancesPatchMcpRequest

JSON 表示法 
{
  "project": string,
  "instance": string,
  "databaseFlags": [
    {
      object (DatabaseFlags)
    }
  ],
  "dataApiAccess": enum (DataApiAccess)
}
欄位
project

string

這是必要旗標，包含執行個體的專案 ID。
instance

string

這是必要旗標，Cloud SQL 執行個體 ID。這不包括專案 ID。
databaseFlags[]

object (DatabaseFlags)

選用。資料庫旗標。
dataApiAccess

enum (DataApiAccess)

選用。控管執行個體資料 API 存取權的設定。

DatabaseFlags

JSON 表示法 
{
  "name": string,
  "value": string
}
欄位
name

string

旗標的名稱。這些標記會在執行個體啟動時傳遞，因此請同時加入伺服器選項和系統變數。旗標以底線指定，而非連字號。詳情請參閱 Cloud SQL 說明文件中的「設定資料庫旗標」。
value

string

旗標的值。布林值旗標會設為 on (true) 和 off (false)。如果標記沒有值，則必須省略這個欄位。

輸出內容的結構定義

作業資源。如果作業成功並傳回 Operation 資源，系統只會在資源中填入與作業相關的欄位。

作業

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)
  }
}
欄位
kind

string

這個值一律為 sql#operation。
targetLink

string
status

enum (SqlOperationStatus)

作業狀態。
user

string

啟動這項作業的使用者電子郵件地址。
insertTime

string (Timestamp format)

這項作業在世界標準時間時區中加入佇列的時間，採用 RFC 3339 格式，例如 2012-11-15T16:19:00.094Z。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
startTime

string (Timestamp format)

這項作業實際開始的時間，採用 RFC 3339 格式 (時區為世界標準時間)，例如 2012-11-15T16:19:00.094Z。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
endTime

string (Timestamp format)

這項作業完成的時間，採用 RFC 3339 格式 (世界標準時間時區)，例如 2012-11-15T16:19:00.094Z。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
error

object (OperationErrors)

如果這項作業的處理過程中發生錯誤，系統會填入這個欄位。
apiWarning

object (ApiWarning)

Admin API 警告訊息。
operationType

enum (SqlOperationType)

作業類型。有效值包括：* CREATE * DELETE * UPDATE * RESTART * IMPORT * EXPORT * BACKUP_VOLUME * RESTORE_VOLUME * CREATE_USER * DELETE_USER * CREATE_DATABASE * DELETE_DATABASE
importContext

object (ImportContext)

匯入作業的環境 (如適用)。
exportContext

object (ExportContext)

匯出作業的環境 (如適用)。
backupContext

object (BackupContext)

備份作業的背景資訊 (如適用)。
preCheckMajorVersionUpgradeContext

object (PreCheckMajorVersionUpgradeContext)

只有在 operation_type 為 PRE_CHECK_MAJOR_VERSION_UPGRADE 時，才會填入這個欄位。PreCheckMajorVersionUpgradeContext 訊息本身包含前置檢查的詳細資料，例如升級的目標資料庫版本和檢查結果 (包括發現的任何警告或錯誤)。
name

string

可明確識別作業的 ID。您可以使用這個 ID 擷取 Operations 資源，其中包含作業的相關資訊。
targetId

string

這項作業執行的資源名稱。
selfLink

string

這項資源的 URI。
targetProject

string

與這項作業相關的目標執行個體專案 ID。
acquireSsrsLeaseContext

object (AcquireSsrsLeaseContext)

取得 SSRS 租約作業的內容 (如適用)。
subOperationType

object (SqlSubOperationType)

選用。根據作業類型執行的子作業。

時間戳記

JSON 表示法 
{
  "seconds": string,
  "nanos": integer
}
欄位
seconds

string (int64 format)

代表自 Unix 紀元 1970-01-01T00:00:00Z 起算的世界標準時間秒數。必須介於 -62135596800 和 253402300799 之間 (含)，對應至 0001-01-01T00:00:00Z 至 9999-12-31T23:59:59Z。
nanos

integer

以奈秒為單位的非負秒數小數。這個欄位是時間長度的奈秒部分，並非秒數的替代值。如果秒數值為負數，且包含小數，奈秒值仍須為非負數，且會向前計時。必須介於 0 至 999,999,999 之間 (含)。

OperationErrors

JSON 表示法 
{
  "kind": string,
  "errors": [
    {
      object (OperationError)
    }
  ]
}
欄位
kind

string

這個值一律為 sql#operationErrors。
errors[]

object (OperationError)

處理這項作業時發生的錯誤清單。

OperationError

JSON 表示法 
{
  "kind": string,
  "code": string,
  "message": string
}
欄位
kind

string

這個值一律為 sql#operationError。
code

string

指出發生的具體錯誤。
message

string

所發生錯誤的其他資訊。

ApiWarning

JSON 表示法 
{
  "code": enum (SqlApiWarningCode),
  "message": string,
  "region": string
}
欄位
code

enum (SqlApiWarningCode)

可明確識別警告類型的代碼。
message

string

警告訊息。
region

string

REGION_UNREACHABLE 警告的區域名稱。

ImportContext

JSON 表示法 
{
  "uri": string,
  "database": string,
  "kind": string,
  "fileType": enum (SqlFileType),
  "csvImportOptions": {
    object (SqlCsvImportOptions)
  },
  "importUser": string,
  "bakImportOptions": {
    object (SqlBakImportOptions)
  },
  "sqlImportOptions": {
    object (SqlImportOptions)
  },
  "tdeImportOptions": {
    object (SqlTdeImportOptions)
  }
}
欄位
uri

string

Cloud Storage 中匯入檔案的路徑，格式為 gs://bucketName/fileName。當 fileType 為 SQL 時，系統支援壓縮的 gzip 檔案 (.gz)。執行個體必須具備值區的寫入權限和檔案的讀取權限。
database

string

匯入作業的目標資料庫。如果 fileType 為 SQL，只有在匯入檔案未指定資料庫時，才需要填寫這個欄位，且匯入檔案中的任何資料庫規格都會覆寫這個欄位。如果是整個執行個體的平行匯入作業，系統會以儲存在子目錄名稱中的資料庫名稱覆寫資料庫。如果 fileType 為 CSV，則必須指定一個資料庫。
kind

string

這個值一律為 sql#importContext。
fileType

enum (SqlFileType)

指定 URI 的檔案類型。`SQL: The file contains SQL statements. \CSV`：檔案包含 CSV 資料。
csvImportOptions

object (SqlCsvImportOptions)

匯入 CSV 格式資料的選項。
importUser

string

這項匯入作業的 PostgreSQL 使用者。僅限 PostgreSQL 執行個體。
bakImportOptions

object (SqlBakImportOptions)

SQL Server .BAK 檔案專用的匯入參數
sqlImportOptions

object (SqlImportOptions)

選用。從 SQL 陳述式匯入資料的選項。
tdeImportOptions

object (SqlTdeImportOptions)

選用。匯入 SQL Server TDE 憑證專用的參數

SqlCsvImportOptions

JSON 表示法 
{
  "table": string,
  "columns": [
    string
  ],
  "escapeCharacter": string,
  "quoteCharacter": string,
  "fieldsTerminatedBy": string,
  "linesTerminatedBy": string
}
欄位
table

string

要匯入 CSV 資料的資料表。
columns[]

string

要匯入 CSV 資料的欄。如未指定，系統會載入資料庫資料表的所有資料欄和 CSV 資料。
escapeCharacter

string

指定需要逸出資料字元前應顯示的字元。
quoteCharacter

string

指定在引用資料值時使用的引用字元。
fieldsTerminatedBy

string

指定檔案中每列 (行) 內分隔資料欄的字元。
linesTerminatedBy

string

用來分隔行。如果某行未包含所有欄位，其餘欄位會設為預設值。

SqlBakImportOptions

JSON 表示法 
{
  "encryptionOptions": {
    object (EncryptionOptions)
  },
  "striped": boolean,
  "noRecovery": boolean,
  "recoveryOnly": boolean,
  "bakType": enum (BakType),
  "stopAt": string,
  "stopAtMark": string
}
欄位
encryptionOptions

object (EncryptionOptions)
striped

boolean

要還原的備份集是否為條紋。僅適用於 SQL Server 適用的 Cloud SQL。
noRecovery

boolean

備份匯入作業是否會還原資料庫，並使用 NORECOVERY 選項。僅適用於 SQL Server 適用的 Cloud SQL。
recoveryOnly

boolean

備份匯入要求是否只會將資料庫上線，而不下載 Bak 內容。只有「no_recovery」和「recovery_only」其中一個可以為 true，否則會傳回錯誤。僅適用於 SQL Server 適用的 Cloud SQL。
bakType

enum (BakType)

備份內容類型，FULL 或 DIFF
stopAt

string (Timestamp format)

選用。匯入作業應停止的時間戳記。這個時間戳記採用 RFC 3339 格式 (例如 2023-10-01T16:19:00.094)。這個欄位等同於 STOPAT 關鍵字，僅適用於 SQL Server 適用的 Cloud SQL。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
stopAtMark

string

選用。匯入作業應停止的標記交易。這個欄位等同於 STOPATMARK 關鍵字，僅適用於 Cloud SQL for SQL Server。

EncryptionOptions

JSON 表示法 
{
  "certPath": string,
  "pvkPath": string,
  "pvkPassword": string,
  "keepEncrypted": boolean
}
欄位
certPath

string

Cloud Storage 中憑證 (.cer) 的路徑，格式為 gs://bucketName/fileName。執行個體必須具備值區的寫入權限和檔案的讀取權限。
pvkPath

string

Cloud Storage 中憑證私密金鑰 (.pvk) 的路徑，格式為 gs://bucketName/fileName。執行個體必須具備值區的寫入權限和檔案的讀取權限。
pvkPassword

string

用於加密私密金鑰的密碼
keepEncrypted

boolean

選用。匯入的檔案是否仍處於加密狀態。

BoolValue

JSON 表示法 
{
  "value": boolean
}
欄位
value

boolean

布林值。

SqlImportOptions

JSON 表示法 
{
  "threads": integer,
  "parallel": boolean,
  "postgresImportOptions": {
    object (PostgresImportOptions)
  }
}
欄位
threads

integer

選用。用於平行匯入的執行緒數量。
parallel

boolean

選用。匯入作業是否應平行處理。
postgresImportOptions

object (PostgresImportOptions)

選用。從 PostgreSQL 適用的 Cloud SQL 執行個體匯入資料的選項。

Int32Value

JSON 表示法 
{
  "value": integer
}
欄位
value

integer

int32 值。

PostgresImportOptions

JSON 表示法 
{
  "clean": boolean,
  "ifExists": boolean
}
欄位
clean

boolean

選用。pg_restore 公用程式的 --clean 旗標。只有在啟用 Cloud SQL 檔案平行匯入功能時，這個旗標才適用。
ifExists

boolean

選用。pg_restore 公用程式的 --if-exists 標記。只有在啟用 Cloud SQL 檔案平行匯入功能時，這個旗標才適用。

SqlTdeImportOptions

JSON 表示法 
{
  "certificatePath": string,
  "privateKeyPath": string,
  "privateKeyPassword": string,
  "name": string
}
欄位
certificatePath

string

這是必要旗標，TDE 憑證公開金鑰的路徑，格式為 gs://bucketName/fileName。執行個體必須具備檔案的讀取權限。僅適用於 SQL Server 執行個體。
privateKeyPath

string

這是必要旗標，TDE 憑證私密金鑰的路徑，格式為 gs://bucketName/fileName。執行個體必須具備檔案的讀取權限。僅適用於 SQL Server 執行個體。
privateKeyPassword

string

這是必要旗標，用於加密私密金鑰的密碼。
name

string

這是必要旗標，憑證名稱。僅適用於 SQL Server 執行個體。

ExportContext

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

string

匯出內容在 Google Cloud Storage 中的儲存路徑。URI 的格式為 gs://bucketName/fileName。如果檔案已存在，要求會成功，但作業會失敗。如果 fileType 為 SQL，且檔案名稱結尾為 .gz，則內容會經過壓縮。
databases[]

string

要匯出的資料庫。
MySQL instances:如果 fileType 為 SQL 且未指定資料庫，系統會匯出所有資料庫，但 mysql 系統資料庫除外。如果 fileType 為 CSV，您可以使用這個屬性或 csvExportOptions.selectQuery 屬性指定一個資料庫 (csvExportOptions.selectQuery 屬性的優先順序高於這個屬性)。
PostgreSQL instances: 如果未依名稱指定資料庫，系統會匯出執行個體中的所有使用者資料庫。這不包括用於管理內部作業的系統資料庫和 Cloud SQL 資料庫。只有目錄格式的平行匯出作業，才能匯出所有使用者資料庫。如果 fileType 為 CSV，這個資料庫必須與 csvExportOptions.selectQuery 屬性中指定的資料庫相符。
SQL Server instances: 您必須指定要匯出的資料庫，且 fileType 必須為 BAK。
kind

string

這個值一律為 sql#exportContext。
sqlExportOptions

object (SqlExportOptions)

以 SQL 陳述式匯出資料的選項。
csvExportOptions

object (SqlCsvExportOptions)

將資料匯出為 CSV 檔案的選項。僅限 MySQL 和 PostgreSQL 執行個體。
fileType

enum (SqlFileType)

指定 URI 的檔案類型。
offload

boolean

是否要執行無伺服器匯出。
bakExportOptions

object (SqlBakExportOptions)

將資料匯出為 BAK 檔案的選項。
tdeExportOptions

object (SqlTdeExportOptions)

選用。匯出 SQL Server TDE 憑證專屬參數

SqlExportOptions

JSON 表示法 
{
  "tables": [
    string
  ],
  "schemaOnly": boolean,
  "mysqlExportOptions": {
    object (MysqlExportOptions)
  },
  "threads": integer,
  "parallel": boolean,
  "postgresExportOptions": {
    object (PostgresExportOptions)
  }
}
欄位
tables[]

string

要從指定資料庫匯出，或已從指定資料庫匯出的資料表。如果您指定資料表，請指定一個資料庫，且只能指定一個。如果是 PostgreSQL 執行個體，您只能指定一個資料表。
schemaOnly

boolean

僅匯出結構定義。
mysqlExportOptions

object (MysqlExportOptions)
threads

integer

選用。用於平行匯出的執行緒數量。
parallel

boolean

選用。匯出作業是否應平行處理。
postgresExportOptions

object (PostgresExportOptions)

選用。從 PostgreSQL 適用的 Cloud SQL 執行個體匯出的選項。

MysqlExportOptions

JSON 表示法 
{
  "masterData": integer
}
欄位
masterData

integer

可選擇是否要納入設定複寫所需的 SQL 陳述式。如果設為 1，傾印檔案會包含 CHANGE MASTER TO 陳述式和二進位記錄座標，且 --set-gtid-purged 會設為 ON。如果設為 2，CHANGE MASTER TO 陳述式會寫成 SQL 註解，不會產生任何影響。如果設為 1 以外的值，--set-gtid-purged 會設為 OFF。

PostgresExportOptions

JSON 表示法 
{
  "clean": boolean,
  "ifExists": boolean
}
欄位
clean

boolean

選用。使用這個選項可納入 DROP

<object>

SQL 陳述式。請使用這些陳述式刪除資料庫物件，再執行匯入作業。
ifExists

boolean

選用。您可以選擇在 clean 產生的每個 DROP 陳述式中加入 IF EXISTS SQL 陳述式。

SqlCsvExportOptions

JSON 表示法 
{
  "selectQuery": string,
  "escapeCharacter": string,
  "quoteCharacter": string,
  "fieldsTerminatedBy": string,
  "linesTerminatedBy": string
}
欄位
selectQuery

string

用於擷取資料的 SELECT 查詢。
escapeCharacter

string

指定需要逸出資料字元前應顯示的字元。
quoteCharacter

string

指定在引用資料值時使用的引用字元。
fieldsTerminatedBy

string

指定檔案中每列 (行) 內分隔資料欄的字元。
linesTerminatedBy

string

用來分隔行。如果某行未包含所有欄位，其餘欄位會設為預設值。

SqlBakExportOptions

JSON 表示法 
{
  "striped": boolean,
  "stripeCount": integer,
  "bakType": enum (BakType),
  "copyOnly": boolean,
  "differentialBase": boolean,
  "exportLogStartTime": string,
  "exportLogEndTime": string
}
欄位
striped

boolean

是否要將匯出內容加上條紋。
stripeCount

integer

用於指定匯出時要使用的條紋數量。如果留空，且條紋欄位的值為 true，系統會自動選擇條紋數量。
bakType

enum (BakType)

這個 bak 檔案的類型為匯出、FULL 或 DIFF，僅限 SQL Server
copyOnly
(deprecated)

boolean

已淘汰：copy_only 已淘汰。請改用 differential_base
differentialBase

boolean

備份是否可用做差異備份的基準副本_only 備份無法做為差異備份的基準
exportLogStartTime

string (Timestamp format)

選用。交易記錄納入匯出作業的開始時間戳記。世界標準時間的 RFC 3339 格式 (例如 2023-10-01T16:19:00.094)。如果省略此參數，系統會納入保留期限開始時的所有可用記錄。僅適用於 SQL Server 適用的 Cloud SQL。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
exportLogEndTime

string (Timestamp format)

選用。交易記錄納入匯出作業的結束時間戳記。世界標準時間的 RFC 3339 格式 (例如 2023-10-01T16:19:00.094)。如果省略，系統會納入目前時間之前的所有可用記錄。僅適用於 SQL Server 適用的 Cloud SQL。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

SqlTdeExportOptions

JSON 表示法 
{
  "certificatePath": string,
  "privateKeyPath": string,
  "privateKeyPassword": string,
  "name": string
}
欄位
certificatePath

string

這是必要旗標，TDE 憑證公開金鑰的路徑，格式為 gs://bucketName/fileName。執行個體必須具備 bucket 的寫入權限。僅適用於 SQL Server 執行個體。
privateKeyPath

string

這是必要旗標，TDE 憑證私密金鑰的路徑，格式為 gs://bucketName/fileName。執行個體必須具備該位置的寫入權限。僅適用於 SQL Server 執行個體。
privateKeyPassword

string

這是必要旗標，用於加密私密金鑰的密碼。
name

string

這是必要旗標，憑證名稱。僅適用於 SQL Server 執行個體。

BackupContext

JSON 表示法 
{
  "backupId": string,
  "kind": string,
  "name": string
}
欄位
backupId

string (int64 format)

備份的 ID。
kind

string

這個值一律為 sql#backupContext。
name

string

備份名稱。格式：projects/{project}/backups/{backup}

PreCheckMajorVersionUpgradeContext

JSON 表示法 
{
  "targetDatabaseVersion": enum (SqlDatabaseVersion),
  "preCheckResponse": [
    {
      object (PreCheckResponse)
    }
  ],
  "kind": string
}
欄位
targetDatabaseVersion

enum (SqlDatabaseVersion)

這是必要旗標，要升級的目標資料庫版本。
preCheckResponse[]

object (PreCheckResponse)

僅供輸出。預檢作業的回應。
kind

string

選用。這個值一律為 sql#preCheckMajorVersionUpgradeContext。

PreCheckResponse

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.
}
欄位
actionsRequired[]

string

使用者需要採取的動作。重複使用可復原或重做連續動作。

聯集欄位 _message。

_message 只能是下列其中一項：
message

string

要向使用者顯示的訊息。

聯集欄位 _message_type。

_message_type 只能是下列其中一項：
messageType

enum (MessageType)

訊息類型，包括資訊、警告或錯誤。

AcquireSsrsLeaseContext

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.
}
欄位

聯集欄位 _setup_login。

_setup_login 只能是下列其中一項：
setupLogin

string

用於設定登入的使用者名稱，可連線至資料庫伺服器以進行 SSRS 設定。

聯集欄位 _service_login。

_service_login 只能是下列其中一項：
serviceLogin

string

用於服務登入的使用者名稱，可連線至 SSRS 設定的報表資料庫。

聯集欄位 _report_database。

_report_database 只能是下列其中一項：
reportDatabase

string

用於 SSRS 設定的報表資料庫。

聯集欄位 _duration。

_duration 只能是下列其中一項：
duration

string (Duration format)

設定 SSRS 時需要租約期限。

時間長度以秒為單位，最多可有 9 個小數位數，並應以「s」結尾，例如："3.5s"。

時間長度

JSON 表示法 
{
  "seconds": string,
  "nanos": integer
}
欄位
seconds

string (int64 format)

時間範圍的簽署秒數。必須介於 -315,576,000,000 至 +315,576,000,000 之間 (含這兩個值)。注意：這些界限是根據以下計算得出：60 秒/分鐘 * 60 分鐘/小時 * 24 小時/天 * 365.25 天/年 * 10000 年
nanos

integer

時間跨度的小數部分 (以奈秒為單位)，可為正數或負數。如果時間長度不到一秒，系統會以 0 seconds 欄位和正數或負數 nanos 欄位表示。如果時間長度為一秒以上，nanos 欄位的非零值必須與 seconds 欄位相同。值必須介於 -999,999,999 到 +999,999,999 之間 (含)。

SqlSubOperationType

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.
}
欄位
聯集欄位 sub_operation_details。與作業類型對應的子作業詳細資料。sub_operation_details 只能是下列其中一個設定：
maintenanceType

enum (SqlMaintenanceType)

要在執行個體上執行的維護作業類型。

工具註解

破壞性提示：✅ | 等冪提示：❌ | 唯讀提示：❌ | 開放世界提示：❌