Tool: get_operation
Den Status eines lang andauernden Vorgangs abrufen. Ein lang andauernder Vorgang kann einige Minuten dauern. Wenn ein Vorgang längere Zeit in Anspruch nimmt, verwenden Sie ein Befehlszeilentool, um 30 Sekunden zu warten, bevor Sie den Status des Vorgangs noch einmal prüfen.
Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool get_operation aufrufen.
| Curl-Anfrage |
|---|
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": "get_operation", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
Eingabeschema
Get-Anfrage für Vorgänge.
SqlOperationsGetRequest
| JSON-Darstellung |
|---|
{ "operation": string, "project": string } |
| Felder | |
|---|---|
operation |
Erforderlich. Instanzvorgangs-ID |
project |
Erforderlich. Projekt-ID des Projekts mit der Instanz. |
Ausgabeschema
Eine Vorgangsressource. Bei erfolgreichen Vorgängen, die eine Vorgangsressource zurückgeben, werden in der Ressource nur die für den Vorgang relevanten Felder ausgefüllt.
Vorgang
| JSON-Darstellung |
|---|
{ "kind": string, "targetLink": string, "status": enum ( |
| Felder | |
|---|---|
kind |
Dies ist immer |
targetLink |
|
status |
Der Status eines Vorgangs. |
user |
Die E-Mail-Adresse des Nutzers, der diesen Vorgang initiiert hat. |
insertTime |
Die Zeit, zu der dieser Vorgang in der UTC-Zeitzone im RFC 3339-Format in die Warteschlange gestellt wurde, z. B. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
startTime |
Die Uhrzeit, zu der dieser Vorgang tatsächlich in der UTC-Zeitzone im RFC 3339-Format gestartet wurde, z. B. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
endTime |
Die Uhrzeit, zu der dieser Vorgang in der UTC-Zeitzone im RFC 3339-Format abgeschlossen wurde, z. B. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
error |
Wenn bei der Verarbeitung dieses Vorgangs Fehler aufgetreten sind, wird dieses Feld ausgefüllt. |
apiWarning |
Eine Admin API-Warnmeldung. |
operationType |
Der Typ des Vorgangs. Gültige Werte sind: * |
importContext |
Der Kontext für den Importvorgang, falls zutreffend. |
exportContext |
Der Kontext für den Exportvorgang, falls zutreffend. |
backupContext |
Der Kontext für den Sicherungsvorgang, falls zutreffend. |
preCheckMajorVersionUpgradeContext |
Dieses Feld wird nur ausgefüllt, wenn „operation_type“ auf PRE_CHECK_MAJOR_VERSION_UPGRADE festgelegt ist. Die Nachricht „PreCheckMajorVersionUpgradeContext“ selbst enthält die Details für diese Vorabprüfung, z. B. die Zieldatenbankversion für das Upgrade und die Ergebnisse der Prüfung (einschließlich aller gefundenen Warnungen oder Fehler). |
name |
Eine Kennung, die den Vorgang eindeutig identifiziert. Mit dieser Kennung können Sie die Operations-Ressource mit Informationen zum Vorgang abrufen. |
targetId |
Name der Ressource, für die dieser Vorgang ausgeführt wird. |
selfLink |
Der URI dieser Ressource. |
targetProject |
Die Projekt-ID der Zielinstanz, die mit diesem Vorgang verknüpft ist. |
acquireSsrsLeaseContext |
Der Kontext für den Vorgang zum Erwerben einer SSRS-Freigabe, falls zutreffend. |
subOperationType |
Optional. Der untergeordnete Vorgang basierend auf dem Vorgangstyp. |
Zeitstempel
| JSON-Darstellung |
|---|
{ "seconds": string, "nanos": integer } |
| Felder | |
|---|---|
seconds |
Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss einschließlich zwischen -62135596800 und 253402300799 liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z). |
nanos |
Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld enthält den Nanosekundenanteil der Dauer und ist keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 liegen (einschließlich). |
OperationErrors
| JSON-Darstellung |
|---|
{
"kind": string,
"errors": [
{
object ( |
| Felder | |
|---|---|
kind |
Dies ist immer |
errors[] |
Die Liste der Fehler, die bei der Verarbeitung dieses Vorgangs aufgetreten sind. |
OperationError
| JSON-Darstellung |
|---|
{ "kind": string, "code": string, "message": string } |
| Felder | |
|---|---|
kind |
Dies ist immer |
code |
Identifiziert den spezifischen Fehler, der aufgetreten ist. |
message |
Zusätzliche Informationen zum aufgetretenen Fehler. |
ApiWarning
| JSON-Darstellung |
|---|
{
"code": enum ( |
| Felder | |
|---|---|
code |
Code zur eindeutigen Identifizierung des Warnungstyps. |
message |
Warnmeldung. |
region |
Der Name der Region für die Warnung REGION_UNREACHABLE. |
ImportContext
| JSON-Darstellung |
|---|
{ "uri": string, "database": string, "kind": string, "fileType": enum ( |
| Felder | |
|---|---|
uri |
Pfad zur Importdatei in Cloud Storage im Format |
database |
Die Zieldatenbank für den Import. Wenn |
kind |
Dies ist immer |
fileType |
Der Dateityp für den angegebenen URI.`SQL |
csvImportOptions |
Optionen für den Import von Daten als CSV-Datei. |
importUser |
Der PostgreSQL-Nutzer für diesen Importvorgang. Nur PostgreSQL-Instanzen. |
bakImportOptions |
Importparameter für SQL Server-BAK-Dateien |
sqlImportOptions |
Optional. Optionen zum Importieren von Daten aus SQL-Anweisungen. |
tdeImportOptions |
Optional. Importparameter für SQL Server-TDE-Zertifikate |
SqlCsvImportOptions
| JSON-Darstellung |
|---|
{ "table": string, "columns": [ string ], "escapeCharacter": string, "quoteCharacter": string, "fieldsTerminatedBy": string, "linesTerminatedBy": string } |
| Felder | |
|---|---|
table |
Die Tabelle, in die CSV-Daten importiert werden. |
columns[] |
Die Spalten, in die CSV-Daten importiert werden. Wenn nicht angegeben, werden alle Spalten der Datenbanktabelle mit CSV-Daten geladen. |
escapeCharacter |
Gibt das Zeichen an, das vor einem Datenzeichen stehen muss, das maskiert werden soll. |
quoteCharacter |
Gibt das Anführungszeichen an, das verwendet werden soll, wenn ein Datenwert in Anführungszeichen gesetzt wird. |
fieldsTerminatedBy |
Gibt das Zeichen an, das Spalten in jeder Zeile der Datei trennt. |
linesTerminatedBy |
Damit werden Zeilen getrennt. Wenn eine Zeile nicht alle Felder enthält, werden die restlichen Spalten auf ihre Standardwerte gesetzt. |
SqlBakImportOptions
| JSON-Darstellung |
|---|
{ "encryptionOptions": { object ( |
| Felder | |
|---|---|
encryptionOptions |
|
striped |
Gibt an, ob der wiederherzustellende Sicherungssatz gestripped ist. Gilt nur für Cloud SQL for SQL Server. |
noRecovery |
Gibt an, ob beim Importieren der Sicherung die Datenbank mit der Option NORECOVERY wiederhergestellt wird. Gilt nur für Cloud SQL for SQL Server. |
recoveryOnly |
Gibt an, ob die Anfrage zum Importieren der Sicherung die Datenbank nur online schaltet, ohne BAK-Inhalte herunterzuladen. Nur einer der Werte „no_recovery“ und „recovery_only“ kann „true“ sein. Andernfalls wird ein Fehler zurückgegeben. Gilt nur für Cloud SQL for SQL Server. |
bakType |
Typ des BAK-Inhalts: FULL oder DIFF |
stopAt |
Optional. Der Zeitstempel, zu dem der Import beendet werden soll. Dieser Zeitstempel hat das Format RFC 3339 (z. B. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
stopAtMark |
Optional. Die markierte Transaktion, an der der Import beendet werden soll. Dieses Feld entspricht dem Keyword STOPATMARK und gilt nur für Cloud SQL for SQL Server. |
EncryptionOptions
| JSON-Darstellung |
|---|
{ "certPath": string, "pvkPath": string, "pvkPassword": string, "keepEncrypted": boolean } |
| Felder | |
|---|---|
certPath |
Pfad zum Zertifikat (.cer) in Cloud Storage im Format |
pvkPath |
Der Pfad zum privaten Schlüssel des Zertifikats (.pvk) in Cloud Storage im Format |
pvkPassword |
Passwort, mit dem der private Schlüssel verschlüsselt wird |
keepEncrypted |
Optional. Gibt an, ob die importierte Datei verschlüsselt bleibt. |
BoolValue
| JSON-Darstellung |
|---|
{ "value": boolean } |
| Felder | |
|---|---|
value |
Der boolesche Wert. |
SqlImportOptions
| JSON-Darstellung |
|---|
{
"threads": integer,
"parallel": boolean,
"postgresImportOptions": {
object ( |
| Felder | |
|---|---|
threads |
Optional. Die Anzahl der Threads, die für den parallelen Import verwendet werden sollen. |
parallel |
Optional. Gibt an, ob der Import parallel erfolgen soll. |
postgresImportOptions |
Optional. Optionen für den Import aus einer Cloud SQL for PostgreSQL-Instanz. |
Int32Value
| JSON-Darstellung |
|---|
{ "value": integer } |
| Felder | |
|---|---|
value |
Der int32-Wert. |
PostgresImportOptions
| JSON-Darstellung |
|---|
{ "clean": boolean, "ifExists": boolean } |
| Felder | |
|---|---|
clean |
Optional. Das Flag „--clean“ für das Dienstprogramm „pg_restore“. Dieses Flag gilt nur, wenn Sie Cloud SQL für den parallelen Import von Dateien aktiviert haben. |
ifExists |
Optional. Das Flag „--if-exists“ für das Dienstprogramm „pg_restore“. Dieses Flag gilt nur, wenn Sie Cloud SQL für den parallelen Import von Dateien aktiviert haben. |
SqlTdeImportOptions
| JSON-Darstellung |
|---|
{ "certificatePath": string, "privateKeyPath": string, "privateKeyPassword": string, "name": string } |
| Felder | |
|---|---|
certificatePath |
Erforderlich. Pfad zum öffentlichen Schlüssel des TDE-Zertifikats im Format gs://bucketName/fileName. Die Instanz muss Lesezugriff auf die Datei haben. Gilt nur für SQL Server-Instanzen. |
privateKeyPath |
Erforderlich. Pfad zum privaten Schlüssel des TDE-Zertifikats im Format gs://bucketName/fileName. Die Instanz muss Lesezugriff auf die Datei haben. Gilt nur für SQL Server-Instanzen. |
privateKeyPassword |
Erforderlich. Das Passwort, mit dem der private Schlüssel verschlüsselt wird. |
name |
Erforderlich. Name des Zertifikats. Gilt nur für SQL Server-Instanzen. |
ExportContext
| JSON-Darstellung |
|---|
{ "uri": string, "databases": [ string ], "kind": string, "sqlExportOptions": { object ( |
| Felder | |
|---|---|
uri |
Der Pfad zur Datei in Google Cloud Storage, in der der Export gespeichert wird. Der URI hat das Format |
databases[] |
Zu exportierende Datenbanken. |
kind |
Dies ist immer |
sqlExportOptions |
Optionen zum Exportieren von Daten als SQL-Anweisungen. |
csvExportOptions |
Optionen zum Exportieren von Daten als CSV. Nur |
fileType |
Der Dateityp für den angegebenen URI. |
offload |
Gibt an, ob ein serverloser Export durchgeführt werden soll. |
bakExportOptions |
Optionen zum Exportieren von Daten als BAK-Dateien |
tdeExportOptions |
Optional. Exportparameter für SQL Server-TDE-Zertifikate |
SqlExportOptions
| JSON-Darstellung |
|---|
{ "tables": [ string ], "schemaOnly": boolean, "mysqlExportOptions": { object ( |
| Felder | |
|---|---|
tables[] |
Tabellen, die aus der angegebenen Datenbank exportiert werden sollen oder wurden. Wenn Sie Tabellen angeben, geben Sie nur eine Datenbank an. Bei PostgreSQL-Instanzen können Sie nur eine Tabelle angeben. |
schemaOnly |
Nur Schemas exportieren. |
mysqlExportOptions |
|
threads |
Optional. Die Anzahl der Threads, die für den parallelen Export verwendet werden sollen. |
parallel |
Optional. Gibt an, ob der Export parallel erfolgen soll. |
postgresExportOptions |
Optional. Optionen für den Export aus einer Cloud SQL for PostgreSQL-Instanz. |
MysqlExportOptions
| JSON-Darstellung |
|---|
{ "masterData": integer } |
| Felder | |
|---|---|
masterData |
Option zum Einbeziehen der SQL-Anweisung, die zum Einrichten der Replikation erforderlich ist. Wenn |
PostgresExportOptions
| JSON-Darstellung |
|---|
{ "clean": boolean, "ifExists": boolean } |
| Felder | |
|---|---|
clean |
Optional. Mit dieser Option können Sie DROP einfügen.
SQL-Anweisungen. Mit diesen Anweisungen können Sie Datenbankobjekte löschen, bevor Sie den Importvorgang ausführen. |
ifExists |
Optional. Option zum Einfügen einer IF EXISTS-SQL-Anweisung in jede DROP-Anweisung, die von „clean“ generiert wird. |
SqlCsvExportOptions
| JSON-Darstellung |
|---|
{ "selectQuery": string, "escapeCharacter": string, "quoteCharacter": string, "fieldsTerminatedBy": string, "linesTerminatedBy": string } |
| Felder | |
|---|---|
selectQuery |
Die SELECT-Abfrage, mit der die Daten extrahiert werden. |
escapeCharacter |
Gibt das Zeichen an, das vor einem Datenzeichen stehen muss, das maskiert werden soll. |
quoteCharacter |
Gibt das Anführungszeichen an, das verwendet werden soll, wenn ein Datenwert in Anführungszeichen gesetzt wird. |
fieldsTerminatedBy |
Gibt das Zeichen an, das Spalten in jeder Zeile der Datei trennt. |
linesTerminatedBy |
Damit werden Zeilen getrennt. Wenn eine Zeile nicht alle Felder enthält, werden die restlichen Spalten auf ihre Standardwerte gesetzt. |
SqlBakExportOptions
| JSON-Darstellung |
|---|
{
"striped": boolean,
"stripeCount": integer,
"bakType": enum ( |
| Felder | |
|---|---|
striped |
Gibt an, ob der Export gestreift werden soll. |
stripeCount |
Option zum Angeben der Anzahl der Stripes für den Export. Wenn das Feld leer ist und der Wert des gestreiften Felds „true“ ist, wird die Anzahl der Streifen automatisch ausgewählt. |
bakType |
Typ dieser BAK-Datei: EXPORT, FULL oder DIFF (nur SQL Server) |
copyOnly |
Verworfen: copy_only wird nicht mehr unterstützt. Stattdessen „differential_base“ verwenden |
differentialBase |
Gibt an, ob das Backup als differenzielle Basis verwendet werden kann. „copy_only“-Backups können nicht als differenzielle Basis verwendet werden. |
exportLogStartTime |
Optional. Der Zeitstempel für den Beginn des Zeitraums, für den Transaktionsprotokolle in den Exportvorgang einbezogen werden. RFC 3339-Format (z. B. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
exportLogEndTime |
Optional. Der End-Zeitstempel, bis zu dem das Transaktionslog in den Exportvorgang einbezogen wird. RFC 3339-Format (z. B. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
SqlTdeExportOptions
| JSON-Darstellung |
|---|
{ "certificatePath": string, "privateKeyPath": string, "privateKeyPassword": string, "name": string } |
| Felder | |
|---|---|
certificatePath |
Erforderlich. Pfad zum öffentlichen Schlüssel des TDE-Zertifikats im Format gs://bucketName/fileName. Die Instanz muss Schreibzugriff auf den Bucket haben. Gilt nur für SQL Server-Instanzen. |
privateKeyPath |
Erforderlich. Pfad zum privaten Schlüssel des TDE-Zertifikats im Format gs://bucketName/fileName. Die Instanz muss Schreibzugriff auf den Speicherort haben. Gilt nur für SQL Server-Instanzen. |
privateKeyPassword |
Erforderlich. Das Passwort, mit dem der private Schlüssel verschlüsselt wird. |
name |
Erforderlich. Name des Zertifikats. Gilt nur für SQL Server-Instanzen. |
BackupContext
| JSON-Darstellung |
|---|
{ "backupId": string, "kind": string, "name": string } |
| Felder | |
|---|---|
backupId |
Die Kennung der Sicherung. |
kind |
Dies ist immer |
name |
Der Name der Sicherung. Format: projects/{project}/backups/{backup} |
PreCheckMajorVersionUpgradeContext
| JSON-Darstellung |
|---|
{ "targetDatabaseVersion": enum ( |
| Felder | |
|---|---|
targetDatabaseVersion |
Erforderlich. Die Zieldatenbankversion für das Upgrade. |
preCheckResponse[] |
Nur Ausgabe. Die Antworten des Vorabprüfvorgangs. |
kind |
Optional. Dies ist immer |
PreCheckResponse
| JSON-Darstellung |
|---|
{ "actionsRequired": [ string ], // Union field |
| Felder | |
|---|---|
actionsRequired[] |
Die Aktionen, die der Nutzer ausführen muss. Verwenden Sie „Wiederholen“ für mehrere Aktionen. |
Union-Feld Für |
|
message |
Die Nachricht, die dem Nutzer angezeigt werden soll. |
Union-Feld Für |
|
messageType |
Der Typ der Meldung, also ob es sich um eine Information, eine Warnung oder einen Fehler handelt. |
AcquireSsrsLeaseContext
| JSON-Darstellung |
|---|
{ // Union field |
| Felder | |
|---|---|
Union-Feld Für |
|
setupLogin |
Der Nutzername, der als Einrichtungsanmeldung für die Verbindung zum Datenbankserver für die SSRS-Einrichtung verwendet werden soll. |
Union-Feld Für |
|
serviceLogin |
Der Nutzername, der als Dienstanmeldung für die Verbindung zur Berichtsdatenbank für die SSRS-Einrichtung verwendet werden soll. |
Union-Feld Für |
|
reportDatabase |
Die Berichtsdatenbank, die für die SSRS-Einrichtung verwendet werden soll. |
Union-Feld Für |
|
duration |
Die für die SSRS-Einrichtung erforderliche Leasedauer. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „ |
Dauer
| JSON-Darstellung |
|---|
{ "seconds": string, "nanos": integer } |
| Felder | |
|---|---|
seconds |
Signierte Sekunden des Zeitraums. Muss zwischen -315.576.000.000 und +315.576.000.000 (einschließlich) liegen. Hinweis: Diese Grenzen werden so berechnet: 60 Sek./Min. × 60 Min./Std. × 24 Std./Tag × 365,25 Tage/Jahr × 10.000 Jahre |
nanos |
Signierte Sekundenbruchteile mit Nanosekunden-Auflösung für den Zeitraum. Dauern von weniger als einer Sekunde werden mit dem Feld „0“ |
SqlSubOperationType
| JSON-Darstellung |
|---|
{ // Union field |
| Felder | |
|---|---|
Union-Feld sub_operation_details. Details zum untergeordneten Vorgang, die dem Vorgangstyp entsprechen. Für sub_operation_details ist nur einer der folgenden Werte zulässig: |
|
maintenanceType |
Die Art der Wartung, die für die Instanz durchgeführt werden soll. |
Tool-Annotationen
Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ❌ | Hinweis „Nur lesen“: ✅ | Hinweis „Offene Welt“: ❌