MCP Tools Reference: cloud-sql

כלי: get_instance

קבלת הפרטים של מכונת Cloud SQL.

בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להפעיל את כלי ה-MCP‏ get_instance.

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

סכימת הקלט

בקשת GET של מופע.

SqlInstancesGetRequest

ייצוג ב-JSON 
{
  "instance": string,
  "project": string
}
שדות
instance

string

חובה. מזהה מופע של מסד נתונים. הפרטים האלה לא כוללים את מזהה הפרויקט.
project

string

חובה. מזהה הפרויקט שמכיל את המופע.

סכימת פלט

משאב של מכונת Cloud SQL.

DatabaseInstance

ייצוג ב-JSON 
{
  "kind": string,
  "state": enum (SqlInstanceState),
  "databaseVersion": enum (SqlDatabaseVersion),
  "settings": {
    object (Settings)
  },
  "etag": string,
  "failoverReplica": {
    object (SqlFailoverReplica)
  },
  "masterInstanceName": string,
  "replicaNames": [
    string
  ],
  "maxDiskSize": string,
  "currentDiskSize": string,
  "ipAddresses": [
    {
      object (IpMapping)
    }
  ],
  "serverCaCert": {
    object (SslCert)
  },
  "instanceType": enum (SqlInstanceType),
  "project": string,
  "ipv6Address": string,
  "serviceAccountEmailAddress": string,
  "onPremisesConfiguration": {
    object (OnPremisesConfiguration)
  },
  "replicaConfiguration": {
    object (ReplicaConfiguration)
  },
  "backendType": enum (SqlBackendType),
  "selfLink": string,
  "suspensionReason": [
    enum (SqlSuspensionReason)
  ],
  "connectionName": string,
  "name": string,
  "region": string,
  "gceZone": string,
  "secondaryGceZone": string,
  "diskEncryptionConfiguration": {
    object (DiskEncryptionConfiguration)
  },
  "diskEncryptionStatus": {
    object (DiskEncryptionStatus)
  },
  "rootPassword": string,
  "scheduledMaintenance": {
    object (SqlScheduledMaintenance)
  },
  "satisfiesPzs": boolean,
  "databaseInstalledVersion": string,
  "createTime": string,
  "availableMaintenanceVersions": [
    string
  ],
  "maintenanceVersion": string,
  "upgradableDatabaseVersions": [
    {
      object (AvailableDatabaseVersion)
    }
  ],
  "replicationCluster": {
    object (ReplicationCluster)
  },
  "satisfiesPzi": boolean,
  "tags": {
    string: string,
    ...
  },
  "nodes": [
    {
      object (PoolNodeConfig)
    }
  ],
  "dnsNames": [
    {
      object (DnsNameMapping)
    }
  ],

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

  // Union field _sql_network_architecture can be only one of the following:
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  // End of list of possible types for union field _sql_network_architecture.

  // Union field _psc_service_attachment_link can be only one of the following:
  "pscServiceAttachmentLink": string
  // End of list of possible types for union field _psc_service_attachment_link.

  // Union field _dns_name can be only one of the following:
  "dnsName": string
  // End of list of possible types for union field _dns_name.

  // Union field _primary_dns_name can be only one of the following:
  "primaryDnsName": string
  // End of list of possible types for union field _primary_dns_name.

  // Union field _write_endpoint can be only one of the following:
  "writeEndpoint": string
  // End of list of possible types for union field _write_endpoint.

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

  // Union field _switch_transaction_logs_to_cloud_storage_enabled can be only
  // one of the following:
  "switchTransactionLogsToCloudStorageEnabled": boolean
  // End of list of possible types for union field
  // _switch_transaction_logs_to_cloud_storage_enabled.

  // Union field _include_replicas_for_major_version_upgrade can be only one of
  // the following:
  "includeReplicasForMajorVersionUpgrade": boolean
  // End of list of possible types for union field
  // _include_replicas_for_major_version_upgrade.

  // Union field _node_count can be only one of the following:
  "nodeCount": integer
  // End of list of possible types for union field _node_count.
}
שדות
kind

string

הערך הזה תמיד יהיה sql#instance.
state

enum (SqlInstanceState)

מצב ההצגה הנוכחי של המופע ב-Cloud SQL.
databaseVersion

enum (SqlDatabaseVersion)

הסוג והגרסה של המנוע של מסד הנתונים. אי אפשר לשנות את השדה databaseVersion אחרי שיוצרים את המופע.
settings

object (Settings)

הגדרות המשתמש.
etag

string

השדה הזה הוצא משימוש ויוסר מגרסה עתידית של ה-API. במקום זאת, צריך להשתמש בשדה settings.settingsVersion.
failoverReplica

object (SqlFailoverReplica)

השם והסטטוס של רפליקת יתירות הכשל.
masterInstanceName

string

השם של המופע שיפעל כראשי בהגדרת השכפול.
replicaNames[]

string

הרפליקות של המופע.
maxDiskSize
(deprecated)

string (Int64Value format)

הגודל המקסימלי של הדיסק של המופע בבייטים.
currentDiskSize
(deprecated)

string (Int64Value format)

השימוש הנוכחי בדיסק של המכונה בבייטים. המאפיין הזה יצא משימוש. במקום זאת, אפשר להשתמש במדד cloudsql.googleapis.com/database/disk/bytes_used ב-Cloud Monitoring API. פרטים נוספים מופיעים בהודעה הזו.
ipAddresses[]

object (IpMapping)

כתובות ה-IP שהוקצו למכונה.
serverCaCert

object (SslCert)

הגדרת SSL.
instanceType

enum (SqlInstanceType)

סוג המופע.
project

string

מזהה הפרויקט שמכיל את מופע Cloud SQL. אם רלוונטי, הדומיין של אפליקציות Google מופיע כקידומת.
ipv6Address
(deprecated)

string

כתובת ה-IPv6 שהוקצתה למופע. (הוצא משימוש) המאפיין הזה היה רלוונטי רק למופעים מהדור הראשון.
serviceAccountEmailAddress

string

כתובת האימייל של חשבון השירות שהוקצתה למופע. המאפיין הזה הוא לקריאה בלבד.
onPremisesConfiguration

object (OnPremisesConfiguration)

הגדרה ספציפית למופעים מקומיים.
replicaConfiguration

object (ReplicaConfiguration)

הגדרה ספציפית של רפליקות ליתירות כשל ורפליקות לקריאה.
backendType

enum (SqlBackendType)

סוג הקצה העורפי. ‫SECOND_GEN: מופע של מסד נתונים ב-Cloud SQL. ‫EXTERNAL: שרת מסד נתונים שלא מנוהל על ידי Google.

המאפיין הזה הוא לקריאה בלבד. כדי לקבוע את סוג מסד הנתונים, צריך להשתמש במאפיין tier באובייקט settings.
selfLink

string

ה-URI של מקור המידע הזה.
suspensionReason[]

enum (SqlSuspensionReason)

אם מצב המופע הוא SUSPENDED, הסיבה להשעיה.
connectionName

string

שם החיבור של מכונת Cloud SQL שמשמש במחרוזות חיבור.
name

string

השם של המכונה של Cloud SQL. הפרטים האלה לא כוללים את מזהה הפרויקט.
region

string

האזור הגיאוגרפי של המכונה של Cloud SQL.

אפשר לבחור באחד מהאזורים שבהם פועל Cloud SQL:

לדוגמה, asia-east1,‏ europe-west1 ו-us-central1. ערך ברירת המחדל הוא us-central1.
gceZone

string

התחום (zone) של Compute Engine שממנו המכונה משרתת כרגע. הערך הזה יכול להיות שונה מהאזור שצוין כשנוצר המופע, אם המופע עבר לזמינות בעקבות כשל באזור המשני שלו. אזהרה: שינוי ההגדרה הזו עלול להפעיל מחדש את המופע.
secondaryGceZone

string

התחום (zone) של Compute Engine שממנו מוגשת כרגע מכונת הגיבוי למכונה אזורית. הערך הזה יכול להיות שונה מהאזור שצוין כשנוצר המופע, אם המופע עבר לגיבוי באזור המשני או באזור הגיבוי שלו.
diskEncryptionConfiguration

object (DiskEncryptionConfiguration)

הגדרת הצפנת הדיסק ספציפית למכונה.
diskEncryptionStatus

object (DiskEncryptionStatus)

סטטוס הצפנת הדיסק שספציפי למופע.
rootPassword

string

סיסמת הבסיס הראשונית. לשימוש רק בזמן היצירה. כדי להתחבר למופעי PostgreSQL, צריך להגדיר סיסמאות של משתמש root.
scheduledMaintenance

object (SqlScheduledMaintenance)

שעת ההתחלה של כל תחזוקה מתוזמנת קרובה למכונה הזו.
satisfiesPzs

boolean

הסטטוס הזה מציין אם המופע עומד בדרישות של PZS.

הסטטוס הזה שמור לשימוש עתידי.
databaseInstalledVersion

string

פלט בלבד. הגרסה הנוכחית של מסד הנתונים שפועלת במופע, כולל גרסה משנית כמו MYSQL_8_0_18.
createTime

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".
availableMaintenanceVersions[]

string

פלט בלבד. List all maintenance versions applicable on the instance
maintenanceVersion

string

גרסת התוכנה הנוכחית במופע.
upgradableDatabaseVersions[]

object (AvailableDatabaseVersion)

פלט בלבד. כל הגרסאות של מסד הנתונים שזמינות לשדרוג.
replicationCluster

object (ReplicationCluster)

זה שינוי אופציונלי. מופע ראשי וזוג רפליקות של תוכנית התאוששות מאסון (DR). שכפול DR הוא רפליקה חוצת אזורים שאתם מגדירים ליתירות כשל למקרה שהמופע הראשי חווה כשל אזורי. רלוונטי ל-MySQL ול-PostgreSQL.
satisfiesPzi

boolean

פלט בלבד. הסטטוס הזה מציין אם המופע עומד בדרישות של PZI.

הסטטוס הזה שמור לשימוש עתידי.
tags

map (key: string, value: string)

זה שינוי אופציונלי. קלט בלבד. אי אפשר לשנות. מפתחות תגים וערכי תגים שמשויכים למופע הזה. כל פריט במפה צריך להיות מיוצג כך: "<tag-key-namespaced-name>" : "<tag-value-short-name>".

לדוגמה, למשאב יחיד יכולים להיות התגים הבאים:

  "123/environment": "production",
  "123/costCenter": "marketing",

מידע נוסף על יצירה וניהול של תגים זמין בכתובת https://cloud.google.com/resource-manager/docs/tags/tags-overview.

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
nodes[]

object (PoolNodeConfig)

פלט בלבד. רשומות שמכילות מידע על כל צומת של מאגר הקריאה במאגר הקריאה.
dnsNames[]

object (DnsNameMapping)

פלט בלבד. רשימת שמות ה-DNS שמשמשים את המופע הזה.

שדה איחוד _out_of_disk_report.

הערך _out_of_disk_report יכול להיות רק אחד מהבאים:
outOfDiskReport

object (SqlOutOfDiskReport)

השדה הזה מייצג את הדוח שנוצר על ידי משימת הבדיקה הפרואקטיבית של תקינות מסד הנתונים, לגבי בעיות שקשורות למצב OutOfDisk. * פעולות כתיבה: * משימת הבדיקה הפרואקטיבית של מסד הנתונים ל-OOD. * קוראים: * משימת הבריאות היזומה של מסד הנתונים

שדה איחוד _sql_network_architecture.

הערך _sql_network_architecture יכול להיות רק אחד מהבאים:
sqlNetworkArchitecture

enum (SqlNetworkArchitecture)

שדה איחוד _psc_service_attachment_link.

הערך _psc_service_attachment_link יכול להיות רק אחד מהבאים:
pscServiceAttachmentLink

string

פלט בלבד. הקישור לקובץ המצורף של שירות מופע PSC.

שדה איחוד _dns_name.

הערך _dns_name יכול להיות רק אחד מהבאים:
dnsName

string

פלט בלבד. שם ה-DNS של המכונה.

שדה איחוד _primary_dns_name.

הערך _primary_dns_name יכול להיות רק אחד מהבאים:
primaryDnsName
(deprecated)

string

פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ב-write_endpoint.

שדה איחוד _write_endpoint.

הערך _write_endpoint יכול להיות רק אחד מהבאים:
writeEndpoint

string

פלט בלבד. שם ה-DNS של המופע הראשי בקבוצת שכפול.

שדה איחוד _gemini_config.

הערך _gemini_config יכול להיות רק אחד מהבאים:
geminiConfig

object (GeminiInstanceConfig)

הגדרה של מופע Gemini.

שדה איחוד _switch_transaction_logs_to_cloud_storage_enabled.

הערך _switch_transaction_logs_to_cloud_storage_enabled יכול להיות רק אחד מהבאים:
switchTransactionLogsToCloudStorageEnabled

boolean

קלט בלבד. האם Cloud SQL מופעל כדי להעביר את קובצי היומן של שחזור לנקודת זמן מסוימת מדיסק נתונים ל-Cloud Storage.

שדה איחוד _include_replicas_for_major_version_upgrade.

הערך _include_replicas_for_major_version_upgrade יכול להיות רק אחד מהבאים:
includeReplicasForMajorVersionUpgrade

boolean

קלט בלבד. ההגדרה הזו קובעת אם שדרוג של גרסה ראשית במקום של רפליקות יתבצע כשיוזם שדרוג של גרסה ראשית במקום של מופע ראשי.

שדה איחוד _node_count.

הערך _node_count יכול להיות רק אחד מהבאים:
nodeCount

integer

מספר הצמתים במאגר הקריאה.

הגדרות

ייצוג ב-JSON 
{
  "settingsVersion": string,
  "authorizedGaeApplications": [
    string
  ],
  "tier": string,
  "kind": string,
  "userLabels": {
    string: string,
    ...
  },
  "availabilityType": enum (SqlAvailabilityType),
  "pricingPlan": enum (SqlPricingPlan),
  "replicationType": enum (SqlReplicationType),
  "storageAutoResizeLimit": string,
  "activationPolicy": enum (SqlActivationPolicy),
  "ipConfiguration": {
    object (IpConfiguration)
  },
  "storageAutoResize": boolean,
  "locationPreference": {
    object (LocationPreference)
  },
  "databaseFlags": [
    {
      object (DatabaseFlags)
    }
  ],
  "dataDiskType": enum (SqlDataDiskType),
  "maintenanceWindow": {
    object (MaintenanceWindow)
  },
  "backupConfiguration": {
    object (BackupConfiguration)
  },
  "databaseReplicationEnabled": boolean,
  "crashSafeReplicationEnabled": boolean,
  "dataDiskSizeGb": string,
  "activeDirectoryConfig": {
    object (SqlActiveDirectoryConfig)
  },
  "collation": string,
  "denyMaintenancePeriods": [
    {
      object (DenyMaintenancePeriod)
    }
  ],
  "insightsConfig": {
    object (InsightsConfig)
  },
  "passwordValidationPolicy": {
    object (PasswordValidationPolicy)
  },
  "sqlServerAuditConfig": {
    object (SqlServerAuditConfig)
  },
  "edition": enum (Edition),
  "connectorEnforcement": enum (ConnectorEnforcement),
  "deletionProtectionEnabled": boolean,
  "timeZone": string,
  "advancedMachineFeatures": {
    object (AdvancedMachineFeatures)
  },
  "dataCacheConfig": {
    object (DataCacheConfig)
  },
  "replicationLagMaxSeconds": integer,
  "enableGoogleMlIntegration": boolean,
  "enableDataplexIntegration": boolean,
  "retainBackupsOnDelete": boolean,
  "entraidConfig": {
    object (SqlServerEntraIdConfig)
  },
  "performanceCaptureConfig": {
    object (PerformanceCaptureConfig)
  },

  // Union field _data_disk_provisioned_iops can be only one of the following:
  "dataDiskProvisionedIops": string
  // End of list of possible types for union field _data_disk_provisioned_iops.

  // Union field _data_disk_provisioned_throughput can be only one of the
  // following:
  "dataDiskProvisionedThroughput": string
  // End of list of possible types for union field
  // _data_disk_provisioned_throughput.

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

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

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

  // Union field _auto_upgrade_enabled can be only one of the following:
  "autoUpgradeEnabled": boolean
  // End of list of possible types for union field _auto_upgrade_enabled.

  // Union field _data_api_access can be only one of the following:
  "dataApiAccess": enum (DataApiAccess)
  // End of list of possible types for union field _data_api_access.
}
שדות
settingsVersion

string (Int64Value format)

הגרסה של הגדרות המופע. זהו שדה חובה לשיטת העדכון, כדי לוודא שעדכונים בו-זמניים מטופלים בצורה תקינה. במהלך העדכון, צריך להשתמש בערך הגרסה העדכני ביותר של ההגדרות עבור המופע הזה, ולא לנסות לעדכן את הערך הזה.
authorizedGaeApplications[]
(deprecated)

string

מזהי האפליקציות ב-App Engine שיכולות לגשת למופע הזה. (הוצא משימוש) רלוונטי רק למופעים מהדור הראשון.
tier

string

המסלול (או סוג המכונה) של המופע הזה, לדוגמה db-custom-1-3840. אזהרה: שינוי ההגדרה הזו יגרום להפעלה מחדש של המכונה.
kind

string

הערך הזה תמיד יהיה sql#settings.
userLabels

map (key: string, value: string)

תוויות שהמשתמשים סיפקו, שמיוצגות כמילון שבו כל תווית היא צמד מפתח/ערך.

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
availabilityType

enum (SqlAvailabilityType)

סוג הזמינות. ערכים אפשריים: * ZONAL: המופע משרת נתונים מאזור אחד בלבד. הפסקות זמניות בשירות באזור הזה משפיעות על הגישה לנתונים. ‫* REGIONAL: המופע יכול להציג נתונים מיותר מאזור אחד באזור (זמינות גבוהה)./

מידע נוסף זמין במאמר סקירה כללית של הגדרת זמינות גבוהה.
pricingPlan

enum (SqlPricingPlan)

תוכנית התשלומים של המופע הזה. הערך יכול להיות PER_USE או PACKAGE. רק PER_USE נתמך במופעים מהדור השני.
replicationType
(deprecated)

enum (SqlReplicationType)

סוג השכפול שבו נעשה שימוש במופע הזה. הערך יכול להיות ASYNCHRONOUS או SYNCHRONOUS. (הוצא משימוש) המאפיין הזה היה רלוונטי רק למופעים מהדור הראשון.
storageAutoResizeLimit

string (Int64Value format)

הגודל המקסימלי שאליו אפשר להגדיל את נפח האחסון באופן אוטומטי. ערך ברירת המחדל הוא 0, שמשמעותו היא שאין מגבלה.
activationPolicy

enum (SqlActivationPolicy)

מדיניות ההפעלה מציינת מתי המופע מופעל. היא רלוונטית רק כשמצב המופע הוא RUNNABLE. ערכים תקינים: * ALWAYS: המופע פועל, והוא יישאר פעיל גם אם לא יתקבלו בקשות חיבור. ‫* NEVER: המופע מושבת, הוא לא מופעל גם אם מתקבלת בקשת חיבור.
ipConfiguration

object (IpConfiguration)

ההגדרות של ניהול כתובות IP. כך אפשר להפעיל או להשבית את כתובת ה-IP של המכונה ולנהל את הרשתות החיצוניות שיכולות להתחבר למכונה. אי אפשר להשבית את כתובת ה-IPv4 במכונות וירטואליות מהדור השני.
storageAutoResize

boolean

הגדרה להגדלת נפח האחסון באופן אוטומטי. ערך ברירת המחדל הוא True.
locationPreference

object (LocationPreference)

הגדרות ההעדפה לגבי מיקום. כך אפשר למקם את המופע קרוב ככל האפשר לאפליקציית App Engine או לאזור Compute Engine, כדי לשפר את הביצועים. המיקום המשותף של App Engine היה רלוונטי רק למכונות וירטואליות מהדור הראשון.
databaseFlags[]

object (DatabaseFlags)

הדגלים של מסד הנתונים שמועברים למופע בזמן ההפעלה.
dataDiskType

enum (SqlDataDiskType)

סוג דיסק הנתונים: PD_SSD (ברירת מחדל) או PD_HDD. לא משמשת למופעים מהדור הראשון.
maintenanceWindow

object (MaintenanceWindow)

חלון הזמן לתחזוקה של המופע הזה. ההגדרה הזו מציינת מתי אפשר להפעיל מחדש את המופע לצורכי תחזוקה.
backupConfiguration

object (BackupConfiguration)

הגדרת הגיבוי היומי של המופע.
databaseReplicationEnabled

boolean

הגדרה שספציפית למופעים של רפליקות לקריאה. מציין אם הרפליקציה מופעלת או לא. אזהרה: שינוי ההגדרה הזו יגרום להפעלה מחדש של המכונה.
crashSafeReplicationEnabled
(deprecated)

boolean

הגדרה שספציפית למופעים של רפליקות לקריאה. מציין אם מופעלים סימונים של מסד נתונים לרפליקציה בטוחה במקרה של קריסה. המאפיין הזה היה רלוונטי רק למופעים מהדור הראשון.
dataDiskSizeGb

string (Int64Value format)

גודל דיסק הנתונים, ב-GB. הגודל המינימלי של דיסק הנתונים הוא 10GB.
activeDirectoryConfig

object (SqlActiveDirectoryConfig)

הגדרת Active Directory, רלוונטית רק ל-Cloud SQL ל-SQL Server.
collation

string

השם של אוסף הכללים של מופע השרת.
denyMaintenancePeriods[]

object (DenyMaintenancePeriod)

דחיית תקופות תחזוקה
insightsConfig

object (InsightsConfig)

הגדרת התובנות רלוונטית כרגע רק ל-Postgres.
passwordValidationPolicy

object (PasswordValidationPolicy)

מדיניות האימות של סיסמאות משתמשים מקומיים במופע.
sqlServerAuditConfig

object (SqlServerAuditConfig)

הגדרת ביקורת ספציפית ל-SQL Server.
edition

enum (Edition)

זה שינוי אופציונלי. המהדורה של המופע.
connectorEnforcement

enum (ConnectorEnforcement)

מציינת אם החיבורים צריכים להשתמש במחברים של Cloud SQL. ערכי האפשרויות כוללים את האפשרויות הבאות: NOT_REQUIRED (אפשר להתחבר למכונות Cloud SQL בלי Cloud SQL Connectors) ו-REQUIRED (אפשר להתחבר רק באמצעות Cloud SQL Connectors).

שימו לב: שימוש בערך REQUIRED משבית את כל הרשתות המורשות הקיימות. אם לא מציינים את השדה הזה כשיוצרים מופע חדש, המערכת משתמשת בערך NOT_REQUIRED. אם לא מציינים את השדה הזה כשמבצעים תיקון או עדכון של מופע קיים, הוא נשאר ללא שינוי במופע.
deletionProtectionEnabled

boolean

הגדרות להגנה מפני מחיקה מקרית של מופע.
timeZone

string

אזור הזמן של השרת, רלוונטי רק ל-Cloud SQL ל-SQL Server.
advancedMachineFeatures

object (AdvancedMachineFeatures)

מציינת הגדרת מכונה מתקדמת למכונות שרלוונטית רק ל-SQL Server.
dataCacheConfig

object (DataCacheConfig)

הגדרות של מטמון נתונים.
replicationLagMaxSeconds

integer

זה שינוי אופציונלי. ערך ההגדרה ליצירה מחדש של העתק אחרי השהיה מסוימת בשכפול
enableGoogleMlIntegration

boolean

זה שינוי אופציונלי. כשהפרמטר הזה מוגדר כ-True, מופעלת האפשרות למכונות Cloud SQL להתחבר ל-Vertex AI כדי להעביר בקשות לתחזיות ולתובנות בזמן אמת ל-AI. ערך ברירת המחדל הוא false. ההגדרה הזו חלה רק על מופעים של Cloud SQL ל-MySQL ו-Cloud SQL ל-PostgreSQL.
enableDataplexIntegration

boolean

זה שינוי אופציונלי. כברירת מחדל, חילוץ סכימות ממופעי Cloud SQL מושבת ב-Dataplex. הגדרת הפרמטר הזה כ-True מפעילה את חילוץ הסכימה עבור Dataplex במופעים של Cloud SQL.
retainBackupsOnDelete

boolean

זה שינוי אופציונלי. כשמגדירים את הפרמטר הזה לערך True, ‏ Cloud SQL שומר גיבויים של המכונה גם אחרי שהמכונה נמחקת. גיבוי לפי דרישה יישמר עד שהלקוח ימחק את הגיבוי או את הפרויקט. הגיבוי האוטומטי יישמר בהתאם להגדרת השמירה של הגיבויים.
entraidConfig

object (SqlServerEntraIdConfig)

זה שינוי אופציונלי. ההגדרה של Microsoft Entra ID עבור מופע SQL Server.
performanceCaptureConfig

object (PerformanceCaptureConfig)

זה שינוי אופציונלי. ההגדרה של Performance Capture מספקת מדדי אבחון במצבים של עומס גבוה.

שדה איחוד _data_disk_provisioned_iops.

הערך _data_disk_provisioned_iops יכול להיות רק אחד מהבאים:
dataDiskProvisionedIops

string (int64 format)

זה שינוי אופציונלי. מספר פעולות הקלט/פלט לשנייה שהוקצו לדיסק הנתונים. השדה הזה משמש רק לסוגי דיסקים מאוזנים של Hyperdisk.

שדה איחוד _data_disk_provisioned_throughput.

הערך _data_disk_provisioned_throughput יכול להיות רק אחד מהבאים:
dataDiskProvisionedThroughput

string (int64 format)

זה שינוי אופציונלי. התפוקה שהוקצתה נמדדת ב-MiB לשנייה עבור דיסק הנתונים. השדה הזה משמש רק לסוגי דיסקים מאוזנים של Hyperdisk.

שדה איחוד _connection_pool_config.

הערך _connection_pool_config יכול להיות רק אחד מהבאים:
connectionPoolConfig

object (ConnectionPoolConfig)

זה שינוי אופציונלי. ההגדרה של מאגר החיבורים המנוהל של המכונה.

שדה איחוד _final_backup_config.

הערך _final_backup_config יכול להיות רק אחד מהבאים:
finalBackupConfig

object (FinalBackupConfig)

זה שינוי אופציונלי. הגדרת הגיבוי הסופית של המופע.

שדה איחוד _read_pool_auto_scale_config.

הערך _read_pool_auto_scale_config יכול להיות רק אחד מהבאים:
readPoolAutoScaleConfig

object (ReadPoolAutoScaleConfig)

זה שינוי אופציונלי. ההגדרה של התאמה אוטומטית של גודל מאגר הקריאה עבור המופע.

שדה איחוד _auto_upgrade_enabled.

הערך _auto_upgrade_enabled יכול להיות רק אחד מהבאים:
autoUpgradeEnabled

boolean

זה שינוי אופציונלי. הגדרת שדרוג אוטומטי של Cloud SQL ל-MySQL. אם הפרמטר הזה מוגדר כ-True, השדרוג האוטומטי מופעל לגרסאות משניות של MySQL 8.0. גרסת MySQL חייבת להיות 8.0.35 ומעלה.

שדה איחוד _data_api_access.

הערך _data_api_access יכול להיות רק אחד מהבאים:
dataApiAccess

enum (DataApiAccess)

הפרמטר הזה קובע אם לאפשר שימוש ב-ExecuteSql API כדי להתחבר למופע. כברירת מחדל, אי אפשר להעביר קבצים.

Int64Value

ייצוג ב-JSON 
{
  "value": string
}
שדות
value

string (int64 format)

הערך int64.

UserLabelsEntry

ייצוג ב-JSON 
{
  "key": string,
  "value": string
}
שדות
key

string
value

string

IpConfiguration

ייצוג ב-JSON 
{
  "ipv4Enabled": boolean,
  "privateNetwork": string,
  "requireSsl": boolean,
  "authorizedNetworks": [
    {
      object (AclEntry)
    }
  ],
  "allocatedIpRange": string,
  "enablePrivatePathForGoogleCloudServices": boolean,
  "sslMode": enum (SslMode),
  "customSubjectAlternativeNames": [
    string
  ],

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

  // Union field _server_ca_mode can be only one of the following:
  "serverCaMode": enum (CaMode)
  // End of list of possible types for union field _server_ca_mode.

  // Union field _server_ca_pool can be only one of the following:
  "serverCaPool": string
  // End of list of possible types for union field _server_ca_pool.

  // Union field _server_certificate_rotation_mode can be only one of the
  // following:
  "serverCertificateRotationMode": enum (ServerCertificateRotationMode)
  // End of list of possible types for union field
  // _server_certificate_rotation_mode.
}
שדות
ipv4Enabled

boolean

האם למכונה הוקצתה כתובת IP ציבורית.
privateNetwork

string

קישור המשאב לרשת ה-VPC שממנה אפשר לגשת למופע Cloud SQL באמצעות כתובת IP פרטית. לדוגמה, /projects/myProject/global/networks/default. אפשר לעדכן את ההגדרה הזו, אבל אי אפשר להסיר אותה אחרי שהיא מוגדרת.
requireSsl

boolean

במקום זאת, אתם צריכים להשתמש ב-ssl_mode.

האם חיבורי SSL/TLS דרך IP נאכפים. אם המדיניות מוגדרת כ-False, מותרים חיבורים ללא SSL/TLS וגם חיבורים עם SSL/TLS. בחיבורי SSL/TLS, אישור הלקוח לא יאומת. אם ההגדרה היא true, מותרים רק חיבורים מוצפנים באמצעות SSL/TLS עם אישורי לקוח תקינים. אם רוצים לאכוף SSL/TLS בלי לאכוף את הדרישה לאישורי לקוח תקינים, צריך להשתמש בדגל ssl_mode במקום בדגל require_ssl.
authorizedNetworks[]

object (AclEntry)

רשימה של רשתות חיצוניות שמורשות להתחבר למופע באמצעות כתובת ה-IP. בסימון CIDR, שנקרא גם סימון 'לוכסן' (לדוגמה: 157.197.200.0/24).
allocatedIpRange

string

השם של טווח כתובות ה-IP שהוקצה למכונת Cloud SQL עם כתובת IP פרטית. לדוגמה: google-managed-services-default. אם ההגדרה מוגדרת, כתובת ה-IP של המכונה נוצרת בטווח שהוקצה. שם הטווח צריך להיות תואם ל-RFC 1035. השם צריך להיות באורך של 1-63 תווים ולהתאים לביטוי הרגולרי [a-z]([-a-z0-9]*[a-z0-9])?.
enablePrivatePathForGoogleCloudServices

boolean

שליטה בקישוריות למופעים עם כתובות IP פרטיות משירותי Google, כמו BigQuery.
sslMode

enum (SslMode)

מציינים איך לאכוף SSL/TLS בחיבורים למסד הנתונים. אם אתם חייבים להשתמש בדגל require_ssl לצורך תאימות לדורות קודמים, רק צמדי הערכים הבאים תקפים:

ל-PostgreSQL ול-MySQL:

  • ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED וגם require_ssl=false
  • ssl_mode=ENCRYPTED_ONLY וגם require_ssl=false
  • ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED וגם require_ssl=true

ל-SQL Server:

  • ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED וגם require_ssl=false
  • ssl_mode=ENCRYPTED_ONLY וגם require_ssl=true

הערך של ssl_mode מקבל עדיפות על פני הערך של require_ssl.

לדוגמה, עבור הצמד ssl_mode=ENCRYPTED_ONLY ו-require_ssl=false, הערך ssl_mode=ENCRYPTED_ONLY אומר לקבל רק חיבורי SSL, ואילו הערך require_ssl=false אומר לקבל גם חיבורים ללא SSL וגם חיבורי SSL. במקרה כזה, מסדי נתונים של MySQL ו-PostgreSQL מכבדים את ssl_mode ומקבלים רק חיבורי SSL.
customSubjectAlternativeNames[]

string

זה שינוי אופציונלי. שמות חלופיים מותאמים אישית של בעלים(SAN) עבור מכונה של Cloud SQL.

שדה איחוד _psc_config.

הערך _psc_config יכול להיות רק אחד מהבאים:
pscConfig

object (PscConfig)

הגדרות PSC עבור המופע הזה.

שדה איחוד _server_ca_mode.

הערך _server_ca_mode יכול להיות רק אחד מהבאים:
serverCaMode

enum (CaMode)

מציינים את סוג ה-CA שמשמש לאישור השרת.

שדה איחוד _server_ca_pool.

הערך _server_ca_pool יכול להיות רק אחד מהבאים:
serverCaPool

string

זה שינוי אופציונלי. שם המשאב של מאגר אישורי CA של השרת עבור מופע עם CUSTOMER_MANAGED_CAS_CA בתור server_ca_mode. פורמט: projects/{PROJECT}/locations/{REGION}/caPools/{CA_POOL_ID}

שדה איחוד _server_certificate_rotation_mode.

הערך _server_certificate_rotation_mode יכול להיות רק אחד מהבאים:
serverCertificateRotationMode

enum (ServerCertificateRotationMode)

זה שינוי אופציונלי. המדיניות קובעת את התכונה של רוטציה אוטומטית של אישורי שרת. התכונה הזו מושבתת כברירת מחדל. אם האפשרות הזו מופעלת, אישור השרת יוחלף אוטומטית במהלך תחזוקה מתוזמנת של Cloud SQL או עדכוני תחזוקה בשירות עצמי, עד שישה חודשים לפני שהוא יפוג. אפשר להגדיר את ההגדרה הזו רק אם server_ca_mode הוא GOOGLE_MANAGED_CAS_CA או CUSTOMER_MANAGED_CAS_CA.

BoolValue

ייצוג ב-JSON 
{
  "value": boolean
}
שדות
value

boolean

הערך הבוליאני.

AclEntry

ייצוג ב-JSON 
{
  "value": string,
  "expirationTime": string,
  "name": string,
  "kind": string
}
שדות
value

string

הערך שמופיע ברשימת ההיתרים של רשימת בקרת הגישה.
expirationTime

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

string

זה שינוי אופציונלי. תווית לזיהוי הרשומה הזו.
kind

string

הערך הזה תמיד יהיה sql#aclEntry.

חותמת הזמן

ייצוג ב-JSON 
{
  "seconds": string,
  "nanos": integer
}
שדות
seconds

string (int64 format)

מייצג את מספר השניות מאז ראשית זמן יוניקס (Unix epoch) ב-1 בינואר 1970 בשעה 00:00:00 UTC. הערך חייב להיות בין ‎-62135596800 ל-253402300799, כולל (שמתאים לטווח 0001-01-01T00:00:00Z עד 9999-12-31T23:59:59Z).
nanos

integer

שברים לא שליליים של שנייה ברזולוציית ננו-שנייה. השדה הזה מייצג את החלק של הננו-שניות במשך הזמן, ולא מהווה חלופה לשניות. ערכי שניות שליליים עם שברים עדיין צריכים לכלול ערכי ננו-שניות לא שליליים שסופרים קדימה בזמן. הערך חייב להיות בין 0 ל-999,999,999, כולל.

PscConfig

ייצוג ב-JSON 
{
  "allowedConsumerProjects": [
    string
  ],
  "pscAutoConnections": [
    {
      object (PscAutoConnectionConfig)
    }
  ],
  "networkAttachmentUri": string,

  // Union field _psc_enabled can be only one of the following:
  "pscEnabled": boolean
  // End of list of possible types for union field _psc_enabled.
}
שדות
allowedConsumerProjects[]

string

זה שינוי אופציונלי. רשימת פרויקטים של צרכנים שנכללים ברשימת ההיתרים לחיבורי PSC למופע הזה. אפשר להתחבר למופע הזה באמצעות PSC מכל רשת בפרויקטים האלה.

כל פרויקט צרכן ברשימה הזו יכול להיות מיוצג על ידי מספר פרויקט (מספרי) או על ידי מזהה פרויקט (אלפאנומרי).
pscAutoConnections[]

object (PscAutoConnectionConfig)

זה שינוי אופציונלי. רשימת ההגדרות של נקודות הקצה לצרכן ב-Private Service Connect שניתן להשתמש בהן כדי להתחבר למופע Cloud SQL הזה.
networkAttachmentUri

string

זה שינוי אופציונלי. קובץ מצורף עם הרשת של הצרכן שהמכונה של Cloud SQL עם Private Service Connect מורשית להתחבר אליה דרך ממשק PSC. פורמט: projects/PROJECT/regions/REGION/networkAttachments/ID

שדה איחוד _psc_enabled.

הערך _psc_enabled יכול להיות רק אחד מהבאים:
pscEnabled

boolean

האם קישוריות PSC מופעלת במופע הזה.

PscAutoConnectionConfig

ייצוג ב-JSON 
{
  "consumerProject": string,
  "consumerNetwork": string,

  // Union field _ip_address can be only one of the following:
  "ipAddress": string
  // End of list of possible types for union field _ip_address.

  // Union field _status can be only one of the following:
  "status": string
  // End of list of possible types for union field _status.

  // Union field _consumer_network_status can be only one of the following:
  "consumerNetworkStatus": string
  // End of list of possible types for union field _consumer_network_status.
}
שדות
consumerProject

string

זה שינוי אופציונלי. מזהה הפרויקט של פרויקט השירות של הצרכן של נקודת הקצה הזו של הצרכן.

זה שינוי אופציונלי. האפשרות הזו רלוונטית רק אם consumer_network היא רשת VPC משותפת.
consumerNetwork

string

זה שינוי אופציונלי. רשת הצרכן של נקודת הקצה הזו של הצרכן. זו צריכה להיות נתיב משאב שכולל גם את פרויקט המארח וגם את שם הרשת.

לדוגמה, projects/project1/global/networks/network1.

יכול להיות שהפרויקט המארח של הצרכן ברשת הזו יהיה שונה מפרויקט השירות של הצרכן.

שדה איחוד _ip_address.

הערך _ip_address יכול להיות רק אחד מהבאים:
ipAddress

string

כתובת ה-IP של נקודת הקצה (endpoint) של הצרכן.

שדה איחוד _status.

הערך _status יכול להיות רק אחד מהבאים:
status

string

סטטוס החיבור של נקודת הקצה של הצרכן.

שדה איחוד _consumer_network_status.

הערך _consumer_network_status יכול להיות רק אחד מהבאים:
consumerNetworkStatus

string

סטטוס מדיניות החיבור של רשת הצרכן.

LocationPreference

ייצוג ב-JSON 
{
  "followGaeApplication": string,
  "zone": string,
  "secondaryZone": string,
  "kind": string
}
שדות
followGaeApplication
(deprecated)

string

אפליקציית App Engine שרוצים לעקוב אחריה, היא צריכה להיות באותו אזור כמו מכונת Cloud SQL. אזהרה: שינוי ההגדרה הזו עלול להפעיל מחדש את המופע.
zone

string

התחום המועדף ב-Compute Engine (לדוגמה: us-central1-a,‏ us-central1-b וכו'). אזהרה: שינוי ההגדרה הזו עלול להפעיל מחדש את המופע.
secondaryZone

string

האזור המועדף ב-Compute Engine למערכת המשנית/לגיבוי כשל (לדוגמה: us-central1-a,‏ us-central1-b וכו'). כדי להשבית את השדה הזה, מגדירים אותו ל-no_secondary_zone.
kind

string

הערך הזה תמיד יהיה sql#locationPreference.

DatabaseFlags

ייצוג ב-JSON 
{
  "name": string,
  "value": string
}
שדות
name

string

שם הדגל. הדגלים האלה מועברים בזמן הפעלת המכונה, ולכן הם כוללים גם אפשרויות שרת וגם משתני מערכת. הסימונים מצוינים באמצעות קווים תחתונים, ולא באמצעות מקפים. מידע נוסף זמין במאמר הגדרת דגלים של מסד נתונים במסמכי התיעוד של Cloud SQL.
value

string

הערך של הדגל. הערך של דגלים בוליאניים הוא on אם הוא true ו-off אם הוא false. אם הדגל לא מקבל ערך, צריך להשמיט את השדה הזה.

MaintenanceWindow

ייצוג ב-JSON 
{
  "hour": integer,
  "day": integer,
  "updateTrack": enum (SqlUpdateTrack),
  "kind": string
}
שדות
hour

integer

שעה ביום – 0 עד 23. מציינים את אזור הזמן UTC.
day

integer

יום בשבוע – MONDAY,‏ TUESDAY,‏ WEDNESDAY,‏ THURSDAY,‏ FRIDAY,‏ SATURDAY או SUNDAY. מציינים את אזור הזמן UTC. הפונקציה מחזירה מספר שלם, 1 עד 7, כאשר 1 שווה ליום שני.
updateTrack

enum (SqlUpdateTrack)

הגדרות התזמון של התחזוקה: canary,‏ stable או week5. מידע נוסף מופיע במאמר בנושא תחזוקה במכונות Cloud SQL.
kind

string

הערך הזה תמיד יהיה sql#maintenanceWindow.

Int32Value

ייצוג ב-JSON 
{
  "value": integer
}
שדות
value

integer

הערך int32.

BackupConfiguration

ייצוג ב-JSON 
{
  "startTime": string,
  "enabled": boolean,
  "kind": string,
  "binaryLogEnabled": boolean,
  "replicationLogArchivingEnabled": boolean,
  "location": string,
  "pointInTimeRecoveryEnabled": boolean,
  "backupRetentionSettings": {
    object (BackupRetentionSettings)
  },
  "transactionLogRetentionDays": integer,

  // Union field _transactional_log_storage_state can be only one of the
  // following:
  "transactionalLogStorageState": enum (TransactionalLogStorageState)
  // End of list of possible types for union field
  // _transactional_log_storage_state.

  // Union field _backup_tier can be only one of the following:
  "backupTier": enum (BackupTier)
  // End of list of possible types for union field _backup_tier.
}
שדות
startTime

string

שעת ההתחלה של הגדרת הגיבוי היומי באזור הזמן UTC בפורמט של 24 שעות – HH:MM.
enabled

boolean

האם ההגדרה הזו מופעלת.
kind

string

הערך הזה תמיד יהיה sql#backupConfiguration.
binaryLogEnabled

boolean

(MySQL בלבד) האם יומן בינארי מופעל. אם השבתתם את הגדרות הגיבוי, אתם צריכים להשבית גם את binarylog.
replicationLogArchivingEnabled

boolean

שמור לשימוש בעתיד.
location

string

מיקום הגיבוי
pointInTimeRecoveryEnabled

boolean

האם שחזור לנקודת זמן מופעל.
backupRetentionSettings

object (BackupRetentionSettings)

הגדרות שימור הגיבוי.
transactionLogRetentionDays

integer

מספר הימים של יומני העסקאות שאנחנו שומרים לצורך שחזור לנקודת זמן מסוימת, מ-1 עד 7.

שדה איחוד _transactional_log_storage_state.

הערך _transactional_log_storage_state יכול להיות רק אחד מהבאים:
transactionalLogStorageState

enum (TransactionalLogStorageState)

פלט בלבד. הערך הזה מכיל את מיקום האחסון של יומני טרנזקציות שמשמשים לביצוע שחזור לנקודת זמן מסוימת (PITR) של מסד הנתונים.

שדה איחוד _backup_tier.

הערך _backup_tier יכול להיות רק אחד מהבאים:
backupTier

enum (BackupTier)

פלט בלבד. רמת הגיבוי שמנהלת את הגיבויים של המופע.

BackupRetentionSettings

ייצוג ב-JSON 
{
  "retentionUnit": enum (RetentionUnit),
  "retainedBackups": integer
}
שדות
retentionUnit

enum (RetentionUnit)

היחידה שמיוצגת על ידי 'retained_backups'.
retainedBackups

integer

הערך הזה משמש לקביעה אם צריך למחוק גיבוי, בהתאם לערך של retention_unit. אם retention_unit הוא COUNT, נשמור את מספר הגיבויים הזה.

SqlActiveDirectoryConfig

ייצוג ב-JSON 
{
  "kind": string,
  "domain": string,
  "mode": enum (ActiveDirectoryMode),
  "dnsServers": [
    string
  ],
  "adminCredentialSecretName": string,
  "organizationalUnit": string
}
שדות
kind

string

הערך הזה הוא תמיד sql#activeDirectoryConfig.
domain

string

שם הדומיין (למשל, mydomain.com).
mode

enum (ActiveDirectoryMode)

זה שינוי אופציונלי. המצב של הגדרת Active Directory.
dnsServers[]

string

זה שינוי אופציונלי. כתובות IPv4 של בקרי דומיין שמשמשות לאתחול של Active Directory.
adminCredentialSecretName

string

זה שינוי אופציונלי. המפתח של מנהל הסודות שבו מאוחסנים פרטי הכניסה של האדמין. (לדוגמה, projects/{project}/secrets/{secret}).
organizationalUnit

string

זה שינוי אופציונלי. השם הייחודי (DN) של היחידה הארגונית. זהו הנתיב ההיררכי המלא ליחידה הארגונית.

DenyMaintenancePeriod

ייצוג ב-JSON 
{
  "startDate": string,
  "endDate": string,
  "time": string
}
שדות
startDate

string

תאריך ההתחלה של 'דחיית תקופת התחזוקה'. אם שנת תאריך ההתחלה ריקה, גם שנת תאריך הסיום חייבת להיות ריקה. במקרה הזה, המשמעות היא שחלון הסירוב לעבודות תחזוקה חוזר על עצמו מדי שנה. התאריך הוא בפורמט yyyy-mm-dd, כלומר: ‫2020-11-01 או mm-dd, כלומר, 11-01
endDate

string

תאריך הסיום של 'דחיית תקופת התחזוקה'. אם שנת תאריך הסיום ריקה, גם שנת תאריך ההתחלה חייבת להיות ריקה. במקרה הזה, המשמעות היא שמרווח הזמן בין התחזוקות חוזר על עצמו כל שנה. התאריך הוא בפורמט yyyy-mm-dd, כלומר: ‫2020-11-01 או mm-dd, כלומר, 11-01
time

string

השעה לפי שעון UTC שבה מתחילה התקופה שבה נדחתה התחזוקה בתאריך start_date ומסתיימת בתאריך end_date. השעה בפורמט: HH:mm:SS, כלומר, 00:00:00

InsightsConfig

ייצוג ב-JSON 
{
  "queryInsightsEnabled": boolean,
  "recordClientAddress": boolean,
  "recordApplicationTags": boolean,
  "queryStringLength": integer,
  "queryPlansPerMinute": integer,
  "enhancedQueryInsightsEnabled": boolean
}
שדות
queryInsightsEnabled

boolean

האם התכונה 'תובנות לגבי שאילתות' מופעלת.
recordClientAddress

boolean

האם התכונה 'תובנות לגבי שאילתות' תתעד את כתובת הלקוח כשהיא מופעלת.
recordApplicationTags

boolean

האם התכונה Query Insights תתעד תגי אפליקציה משאילתה כשהיא מופעלת.
queryStringLength

integer

אורך השאילתה המקסימלי שמאוחסן בבייטים. ערך ברירת המחדל: 1,024 בייט. טווח: 256-4500 בייטים. אורך השאילתה שגדול מהערך בשדה הזה יקוצר לערך הזה. אם לא מגדירים ערך, אורך השאילתה יהיה ערך ברירת המחדל. שינוי אורך השאילתה יגרום להפעלה מחדש של מסד הנתונים.
queryPlansPerMinute

integer

מספר תוכניות ההפעלה של השאילתות שתועדו על ידי 'תובנות' בכל דקה לכל השאילתות יחד. ברירת המחדל היא 5.
enhancedQueryInsightsEnabled

boolean

זה שינוי אופציונלי. האם התכונה 'תובנות משופרות לגבי שאילתות' מופעלת.

PasswordValidationPolicy

ייצוג ב-JSON 
{
  "minLength": integer,
  "complexity": enum (Complexity),
  "reuseInterval": integer,
  "disallowUsernameSubstring": boolean,
  "passwordChangeInterval": string,
  "enablePasswordPolicy": boolean,
  "disallowCompromisedCredentials": boolean
}
שדות
minLength

integer

מספר התווים המינימלי המותר.
complexity

enum (Complexity)

מורכבות הסיסמה.
reuseInterval

integer

מספר הסיסמאות הקודמות שאסור להשתמש בהן שוב.
disallowUsernameSubstring

boolean

אי אפשר להשתמש בשם המשתמש כחלק מהסיסמה.
passwordChangeInterval

string (Duration format)

המרווח המינימלי שאחריו אפשר לשנות את הסיסמה. הסימון הזה נתמך רק ב-PostgreSQL.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-'s'. דוגמה: "3.5s".
enablePasswordPolicy

boolean

האם להפעיל את מדיניות הסיסמאות או לא. כשההגדרה הזו מופעלת, הסיסמאות צריכות לעמוד בדרישות המורכבות. כדאי להשאיר את המדיניות הזו מופעלת כדי למנוע גישה לא מורשית. אם משביתים את המדיניות הזו, אפשר להשתמש בסיסמאות חלשות.
disallowCompromisedCredentials
(deprecated)

boolean

השדה הזה הוצא משימוש ויוסר בגרסה עתידית של ה-API.

משך הזמן

ייצוג ב-JSON 
{
  "seconds": string,
  "nanos": integer
}
שדות
seconds

string (int64 format)

השניות החתומות של טווח הזמן. הערך חייב להיות בין ‎-315,576,000,000 לבין ‎+315,576,000,000, כולל. הערה: הגבולות האלה מחושבים לפי: 60 שניות/דקה * 60 דקות/שעה * 24 שעות/יום * 365.25 ימים/שנה * 10,000 שנים
nanos

integer

שברים חתומים של שנייה ברזולוציית ננו-שנייה של טווח הזמן. משכי זמן של פחות משנייה אחת מיוצגים באמצעות שדה seconds עם הערך 0 ושדה nanos עם ערך חיובי או שלילי. למשכי זמן של שנייה אחת או יותר, הערך בשדה nanos צריך להיות שונה מאפס ובעל אותו סימן כמו הערך בשדה seconds. הערך חייב להיות בין ‎-999,999,999 ל-‎+999,999,999, כולל.

SqlServerAuditConfig

ייצוג ב-JSON 
{
  "kind": string,
  "bucket": string,
  "retentionInterval": string,
  "uploadInterval": string
}
שדות
kind

string

הערך הזה הוא תמיד sql#sqlServerAuditConfig
bucket

string

השם של קטגוריית היעד (למשל, gs://mybucket).
retentionInterval

string (Duration format)

כמה זמן לשמור את קובצי הביקורת שנוצרו.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-'s'. דוגמה: "3.5s".
uploadInterval

string (Duration format)

התדירות שבה רוצים להעלות את קובצי הביקורת שנוצרו.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-'s'. דוגמה: "3.5s".

AdvancedMachineFeatures

ייצוג ב-JSON 
{
  "threadsPerCore": integer
}
שדות
threadsPerCore

integer

מספר השרשורים לכל ליבה פיזית.

DataCacheConfig

ייצוג ב-JSON 
{
  "dataCacheEnabled": boolean
}
שדות
dataCacheEnabled

boolean

האם מטמון הנתונים מופעל עבור המופע.

ConnectionPoolConfig

ייצוג ב-JSON 
{
  "flags": [
    {
      object (ConnectionPoolFlags)
    }
  ],

  // Union field _connection_pooling_enabled can be only one of the following:
  "connectionPoolingEnabled": boolean
  // End of list of possible types for union field _connection_pooling_enabled.

  // Union field _pooler_count can be only one of the following:
  "poolerCount": integer
  // End of list of possible types for union field _pooler_count.
}
שדות
flags[]

object (ConnectionPoolFlags)

זה שינוי אופציונלי. רשימה של דגלים להגדרת מאגר חיבורים.

שדה איחוד _connection_pooling_enabled.

הערך _connection_pooling_enabled יכול להיות רק אחד מהבאים:
connectionPoolingEnabled

boolean

האם מאגר החיבורים המנוהל מופעל.

שדה איחוד _pooler_count.

הערך _pooler_count יכול להיות רק אחד מהבאים:
poolerCount

integer

פלט בלבד. מספר המאגדים של החיבורים.

ConnectionPoolFlags

ייצוג ב-JSON 
{
  "name": string,
  "value": string
}
שדות
name

string

חובה. שם הדגל.
value

string

חובה. הערך של הדגל. הערך של דגלים בוליאניים הוא on ל-true ו-off ל-false. אם הדגל לא מקבל ערך, צריך להשמיט את השדה הזה.

FinalBackupConfig

ייצוג ב-JSON 
{

  // Union field _enabled can be only one of the following:
  "enabled": boolean
  // End of list of possible types for union field _enabled.

  // Union field _retention_days can be only one of the following:
  "retentionDays": integer
  // End of list of possible types for union field _retention_days.
}
שדות

שדה איחוד _enabled.

הערך _enabled יכול להיות רק אחד מהבאים:
enabled

boolean

האם הגיבוי הסופי מופעל עבור המופע.

שדה איחוד _retention_days.

הערך _retention_days יכול להיות רק אחד מהבאים:
retentionDays

integer

מספר הימים לשמירת הגיבוי הסופי אחרי מחיקת המופע. הגיבוי הסופי יימחק ב-(time_of_instance_deletion + retention_days).

ReadPoolAutoScaleConfig

ייצוג ב-JSON 
{
  "targetMetrics": [
    {
      object (TargetMetric)
    }
  ],

  // Union field _enabled can be only one of the following:
  "enabled": boolean
  // End of list of possible types for union field _enabled.

  // Union field _min_node_count can be only one of the following:
  "minNodeCount": integer
  // End of list of possible types for union field _min_node_count.

  // Union field _max_node_count can be only one of the following:
  "maxNodeCount": integer
  // End of list of possible types for union field _max_node_count.

  // Union field _disable_scale_in can be only one of the following:
  "disableScaleIn": boolean
  // End of list of possible types for union field _disable_scale_in.

  // Union field _scale_in_cooldown_seconds can be only one of the following:
  "scaleInCooldownSeconds": integer
  // End of list of possible types for union field _scale_in_cooldown_seconds.

  // Union field _scale_out_cooldown_seconds can be only one of the following:
  "scaleOutCooldownSeconds": integer
  // End of list of possible types for union field _scale_out_cooldown_seconds.
}
שדות
targetMetrics[]

object (TargetMetric)

זה שינוי אופציונלי. מדדי יעד להתאמה אוטומטית של גודל המאגר לקריאה.

שדה איחוד _enabled.

הערך _enabled יכול להיות רק אחד מהבאים:
enabled

boolean

מציין אם ההתאמה האוטומטית לעומס של מאגר הקריאה מופעלת.

שדה איחוד _min_node_count.

הערך _min_node_count יכול להיות רק אחד מהבאים:
minNodeCount

integer

מספר הצמתים המינימלי במאגר לקריאה שצריך לשמור.

שדה איחוד _max_node_count.

הערך _max_node_count יכול להיות רק אחד מהבאים:
maxNodeCount

integer

המספר המקסימלי של צמתים במאגר לקריאה שצריך לשמור.

שדה איחוד _disable_scale_in.

הערך _disable_scale_in יכול להיות רק אחד מהבאים:
disableScaleIn

boolean

מציין אם ההתאמה האוטומטית לעומס של מאגר הקריאה תומכת בפעולות של הקטנת המידרוג (הסרת צמתים).

שדה איחוד _scale_in_cooldown_seconds.

הערך _scale_in_cooldown_seconds יכול להיות רק אחד מהבאים:
scaleInCooldownSeconds

integer

תקופת הצינון לפעולות של הקטנת הקיבולת.

שדה איחוד _scale_out_cooldown_seconds.

הערך _scale_out_cooldown_seconds יכול להיות רק אחד מהבאים:
scaleOutCooldownSeconds

integer

תקופת הצינון לפעולות של הרחבת הקיבולת.

TargetMetric

ייצוג ב-JSON 
{

  // Union field _metric can be only one of the following:
  "metric": string
  // End of list of possible types for union field _metric.

  // Union field _target_value can be only one of the following:
  "targetValue": number
  // End of list of possible types for union field _target_value.
}
שדות

שדה איחוד _metric.

הערך _metric יכול להיות רק אחד מהבאים:
metric

string

שם המדד שישמש לשינוי גודל אוטומטי.

שדה איחוד _target_value.

הערך _target_value יכול להיות רק אחד מהבאים:
targetValue

number

ערך היעד של המדד.

SqlServerEntraIdConfig

ייצוג ב-JSON 
{
  "kind": string,
  "tenantId": string,
  "applicationId": string
}
שדות
kind

string

פלט בלבד. הערך הזה הוא תמיד sql#sqlServerEntraIdConfig
tenantId

string

זה שינוי אופציונלי. מזהה הדייר של הגדרת Entra ID.
applicationId

string

זה שינוי אופציונלי. מזהה האפליקציה להגדרה של Entra ID.

PerformanceCaptureConfig

ייצוג ב-JSON 
{

  // Union field _enabled can be only one of the following:
  "enabled": boolean
  // End of list of possible types for union field _enabled.

  // Union field _probing_interval_seconds can be only one of the following:
  "probingIntervalSeconds": integer
  // End of list of possible types for union field _probing_interval_seconds.

  // Union field _probe_threshold can be only one of the following:
  "probeThreshold": integer
  // End of list of possible types for union field _probe_threshold.

  // Union field _running_threads_threshold can be only one of the following:
  "runningThreadsThreshold": integer
  // End of list of possible types for union field _running_threads_threshold.

  // Union field _seconds_behind_source_threshold can be only one of the
  // following:
  "secondsBehindSourceThreshold": integer
  // End of list of possible types for union field
  // _seconds_behind_source_threshold.

  // Union field _transaction_duration_threshold can be only one of the
  // following:
  "transactionDurationThreshold": integer
  // End of list of possible types for union field
  // _transaction_duration_threshold.
}
שדות

שדה איחוד _enabled.

הערך _enabled יכול להיות רק אחד מהבאים:
enabled

boolean

זה שינוי אופציונלי. הפעלה או השבתה של התכונה 'תיעוד הביצועים'.

שדה איחוד _probing_interval_seconds.

הערך _probing_interval_seconds יכול להיות רק אחד מהבאים:
probingIntervalSeconds

integer

זה שינוי אופציונלי. מרווח הזמן בשניות בין שני ניסיונות בדיקה.

שדה איחוד _probe_threshold.

הערך _probe_threshold יכול להיות רק אחד מהבאים:
probeThreshold

integer

זה שינוי אופציונלי. המספר המינימלי של קריאות רצופות מעל הסף שמפעיל את תיעוד מצב המופע.

שדה איחוד _running_threads_threshold.

הערך _running_threads_threshold יכול להיות רק אחד מהבאים:
runningThreadsThreshold

integer

זה שינוי אופציונלי. מספר השרשורים המינימלי של השרת שפועלים כדי להפעיל את הלכידה בשרת הראשי.

שדה איחוד _seconds_behind_source_threshold.

הערך _seconds_behind_source_threshold יכול להיות רק אחד מהבאים:
secondsBehindSourceThreshold

integer

זה שינוי אופציונלי. מספר השניות המינימלי שבו העותק צריך להיות בפיגור אחרי המקור כדי להפעיל את הלכידה בעותק.

שדה איחוד _transaction_duration_threshold.

הערך _transaction_duration_threshold יכול להיות רק אחד מהבאים:
transactionDurationThreshold

integer

זה שינוי אופציונלי. משך הזמן בשניות שצריך לעבור מאז פתיחת העסקה עד שהכלי למעקב מתחיל לתעד אותה.

SqlFailoverReplica

ייצוג ב-JSON 
{
  "name": string,
  "available": boolean
}
שדות
name

string

השם של הרפליקה ליתירות כשל. אם מציינים זאת בזמן יצירת המכונה, נוצרת מכונת רפליקה למעבר אוטומטי לגיבוי (failover) עבור המכונה. השם לא כולל את מזהה הפרויקט.
available

boolean

סטטוס הזמינות של הרפליקה למעבר אוטומטי. סטטוס שגוי מציין שהרפליקה של המעבר לגיבוי חלופי לא מסונכרנת. המופע הראשי יכול לבצע מעבר לגיבוי בעת כשל רק אם הסטטוס הוא TRUE.

IpMapping

ייצוג ב-JSON 
{
  "type": enum (SqlIpAddressType),
  "ipAddress": string,
  "timeToRetire": string
}
שדות
type

enum (SqlIpAddressType)

הסוג של כתובת ה-IP הזו. כתובת PRIMARY היא כתובת ציבורית שיכולה לקבל חיבורים נכנסים. כתובת PRIVATE היא כתובת פרטית שיכולה לקבל חיבורים נכנסים. כתובת OUTGOING היא כתובת המקור של חיבורים שמגיעים מהמופע, אם נתמך.
ipAddress

string

כתובת ה-IP שהוקצתה.
timeToRetire

string (Timestamp format)

המועד האחרון להוצאת כתובת ה-IP הזו משימוש, בפורמט RFC 3339, לדוגמה 2012-11-15T16:19:00.094Z. השדה הזה זמין רק אם כתובת ה-IP מתוכננת להוצאה משימוש.

הפורמט הוא 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".

SslCert

ייצוג ב-JSON 
{
  "kind": string,
  "certSerialNumber": string,
  "cert": string,
  "createTime": string,
  "commonName": string,
  "expirationTime": string,
  "sha1Fingerprint": string,
  "instance": string,
  "selfLink": string
}
שדות
kind

string

הערך הזה תמיד יהיה sql#sslCert.
certSerialNumber

string

המספר הסידורי, כפי שחולץ מהאישור.
cert

string

ייצוג PEM.
createTime

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

string

השם שהמשתמש סיפק. מוגבל ל-‎[a-zA-Z.-_ ]+‎.
expirationTime

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

string

טביעת אצבע Sha1.
instance

string

השם של מופע מסד הנתונים.
selfLink

string

ה-URI של מקור המידע הזה.

OnPremisesConfiguration

ייצוג ב-JSON 
{
  "hostPort": string,
  "kind": string,
  "username": string,
  "password": string,
  "caCertificate": string,
  "clientCertificate": string,
  "clientKey": string,
  "dumpFilePath": string,
  "sourceInstance": {
    object (InstanceReference)
  },
  "selectedObjects": [
    {
      object (SelectedObjects)
    }
  ],
  "sslOption": enum (SslOption)
}
שדות
hostPort

string

המארח והיציאה של המופע המקומי בפורמט host:port
kind

string

הערך הזה תמיד יהיה sql#onPremisesConfiguration.
username

string

שם המשתמש להתחברות למופע מקומי.
password

string

הסיסמה לחיבור למופע מקומי.
caCertificate

string

ייצוג PEM של אישור x509 של רשות האישורים המהימנה.
clientCertificate

string

ייצוג PEM של אישור x509 של העותק המשוכפל.
clientKey

string

ייצוג PEM של המפתח הפרטי של העותק. המפתח הציבורי המתאים מקודד באישור של הלקוח.
dumpFilePath

string

קובץ ה-dump ליצירת רפליקת Cloud SQL.
sourceInstance

object (InstanceReference)

ההפניה למכונת Cloud SQL אם המקור הוא Cloud SQL.
selectedObjects[]

object (SelectedObjects)

זה שינוי אופציונלי. רשימה של אובייקטים שהמשתמש בוחר לשכפול ממופע של מקור חיצוני.
sslOption

enum (SslOption)

זה שינוי אופציונלי. אפשרות SSL לחיבור רפליקה למקור המקומי.

InstanceReference

ייצוג ב-JSON 
{
  "name": string,
  "region": string,
  "project": string
}
שדות
name

string

השם של המכונה של Cloud SQL שאליה מתבצעת הפניה. הפרטים האלה לא כוללים את מזהה הפרויקט.
region

string

האזור של מופע Cloud SQL שאליו מתבצעת הפניה.
project

string

מזהה הפרויקט של מופע Cloud SQL שאליו מתבצעת הפניה. ברירת המחדל היא מזהה הפרויקט שאליו המופע מפנה.

SelectedObjects

ייצוג ב-JSON 
{
  "database": string
}
שדות
database

string

חובה. השם של מסד הנתונים שרוצים להעביר.

ReplicaConfiguration

ייצוג ב-JSON 
{
  "kind": string,
  "mysqlReplicaConfiguration": {
    object (MySqlReplicaConfiguration)
  },
  "failoverTarget": boolean,
  "cascadableReplica": boolean
}
שדות
kind

string

הערך הזה תמיד יהיה sql#replicaConfiguration.
mysqlReplicaConfiguration

object (MySqlReplicaConfiguration)

הגדרה ספציפית ל-MySQL כשמשכפלים ממכונה ראשית מקומית של MySQL. פרטי ההגדרה של השכפול, כמו שם המשתמש, הסיסמה, האישורים והמפתחות, לא מאוחסנים במטא-נתונים של המופע. המידע על ההגדרות משמש רק להגדרת חיבור השכפול, והוא מאוחסן על ידי MySQL בקובץ בשם master.info בספריית הנתונים.
failoverTarget

boolean

מציין אם הרפליקה היא יעד היתירות כשל. אם השדה מוגדר ל-true, הרפליקה תוגדר כרפליקה ליתירות כשל. אם המכונה הראשית תיכשל, הרפליקה תקודם כראשית החדשה. אפשר לציין רק רפליקה אחת כיעד למעבר אוטומטי לגיבוי, והרפליקה צריכה להיות באזור אחר מהמופע הראשי.
cascadableReplica

boolean

זה שינוי אופציונלי. ההגדרה קובעת אם רפליקת SQL Server היא רפליקה שניתנת להעברה. עותק משוכפל ניתן להעברה הוא עותק משוכפל של SQL Server בין אזורים שתומך בעותקים משוכפלים שמתחתיו.

MySqlReplicaConfiguration

ייצוג ב-JSON 
{
  "dumpFilePath": string,
  "username": string,
  "password": string,
  "connectRetryInterval": integer,
  "masterHeartbeatPeriod": string,
  "caCertificate": string,
  "clientCertificate": string,
  "clientKey": string,
  "sslCipher": string,
  "verifyServerCertificate": boolean,
  "kind": string
}
שדות
dumpFilePath

string

נתיב לקובץ SQL מוכן לשימוש ב-Google Cloud Storage שממנו ייצור מופע ההעתקה. מזהה ה-URI הוא בפורמט gs://bucketName/fileName. יש תמיכה גם בקובצי gzip דחוסים (‎.gz). בקובצי ה-dump יש את הקואורדינטות של ה-binlog שממנו מתחילה השכפול. אפשר לעשות זאת על ידי הגדרת ‎--master-data ל-1 כשמשתמשים ב-mysqldump.
username

string

שם המשתמש לחיבור השכפול.
password

string

הסיסמה לחיבור השכפול.
connectRetryInterval

integer

מספר השניות להמתנה בין ניסיונות חוזרים להתחברות. ברירת המחדל של MySQL היא 60 שניות.
masterHeartbeatPeriod

string (Int64Value format)

המרווח באלפיות השנייה בין פעימות הלב של השכפול.
caCertificate

string

ייצוג PEM של אישור x509 של רשות האישורים המהימנה.
clientCertificate

string

ייצוג PEM של אישור x509 של העותק המשוכפל.
clientKey

string

ייצוג PEM של המפתח הפרטי של העותק. המפתח הציבורי המתאים מקודד באישור של הלקוח.
sslCipher

string

רשימה של הצפנות מותרות לשימוש בהצפנת SSL.
verifyServerCertificate

boolean

האם לבדוק את הערך של השם הנפוץ (CN) במופע הראשי באישור שהוא שולח במהלך לחיצת היד של SSL.
kind

string

הערך הזה תמיד יהיה sql#mysqlReplicaConfiguration.

DiskEncryptionConfiguration

ייצוג ב-JSON 
{
  "kmsKeyName": string,
  "kind": string
}
שדות
kmsKeyName

string

שם המשאב של מפתח KMS להצפנת הדיסק
kind

string

הערך הזה תמיד יהיה sql#diskEncryptionConfiguration.

DiskEncryptionStatus

ייצוג ב-JSON 
{
  "kmsKeyVersionName": string,
  "kind": string
}
שדות
kmsKeyVersionName

string

גרסת מפתח KMS שמשמשת להצפנה של משאב מכונת Cloud SQL
kind

string

הערך הזה תמיד יהיה sql#diskEncryptionStatus.

SqlScheduledMaintenance

ייצוג ב-JSON 
{
  "startTime": string,
  "canDefer": boolean,
  "canReschedule": boolean,

  // Union field _schedule_deadline_time can be only one of the following:
  "scheduleDeadlineTime": string
  // End of list of possible types for union field _schedule_deadline_time.
}
שדות
startTime

string (Timestamp format)

שעת ההתחלה של כל תחזוקה מתוזמנת קרובה למכונה הזו.

הפורמט הוא 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".
canDefer
(deprecated)

boolean
canReschedule

boolean

אם אפשר לשנות את המועד של עבודות התחזוקה.

שדה איחוד _schedule_deadline_time.

הערך _schedule_deadline_time יכול להיות רק אחד מהבאים:
scheduleDeadlineTime

string (Timestamp format)

אי אפשר לקבוע מחדש את מועד התחלת התחזוקה אחרי המועד האחרון הזה.

הפורמט הוא 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".

SqlOutOfDiskReport

ייצוג ב-JSON 
{

  // Union field _sql_out_of_disk_state can be only one of the following:
  "sqlOutOfDiskState": enum (SqlOutOfDiskState)
  // End of list of possible types for union field _sql_out_of_disk_state.

  // Union field _sql_min_recommended_increase_size_gb can be only one of the
  // following:
  "sqlMinRecommendedIncreaseSizeGb": integer
  // End of list of possible types for union field
  // _sql_min_recommended_increase_size_gb.
}
שדות

שדה איחוד _sql_out_of_disk_state.

הערך _sql_out_of_disk_state יכול להיות רק אחד מהבאים:
sqlOutOfDiskState

enum (SqlOutOfDiskState)

השדה הזה מייצג את המצב שנוצר על ידי משימת הבדיקה הפרואקטיבית של תקינות מסד הנתונים, לגבי בעיות של חוסר מקום בדיסק. * פעולות כתיבה: * משימת הבדיקה הפרואקטיבית של מסד הנתונים ל-OOD. * קוראים: * משימת הבריאות היזומה של מסד הנתונים

שדה איחוד _sql_min_recommended_increase_size_gb.

הערך _sql_min_recommended_increase_size_gb יכול להיות רק אחד מהבאים:
sqlMinRecommendedIncreaseSizeGb

integer

הגודל המינימלי המומלץ להגדלה בגיגה-בייט. השדה הזה משמש את הקצה הקדמי * כותבים: * עבודת הבדיקה הפרואקטיבית של תקינות מסד הנתונים עבור OOD. * קוראים:

AvailableDatabaseVersion

ייצוג ב-JSON 
{

  // Union field _major_version can be only one of the following:
  "majorVersion": string
  // End of list of possible types for union field _major_version.

  // Union field _name can be only one of the following:
  "name": string
  // End of list of possible types for union field _name.

  // Union field _display_name can be only one of the following:
  "displayName": string
  // End of list of possible types for union field _display_name.
}
שדות

שדה איחוד _major_version.

הערך _major_version יכול להיות רק אחד מהבאים:
majorVersion

string

השם של הגרסה הראשית.

שדה איחוד _name.

הערך _name יכול להיות רק אחד מהבאים:
name

string

שם גרסת מסד הנתונים. ב-MySQL 8.0, המחרוזת הזו מספקת את הגרסה הראשית והמשנית של מסד הנתונים.

שדה איחוד _display_name.

הערך _display_name יכול להיות רק אחד מהבאים:
displayName

string

השם המוצג של גרסת מסד הנתונים.

ReplicationCluster

ייצוג ב-JSON 
{
  "psaWriteEndpoint": string,
  "failoverDrReplicaName": string,
  "drReplica": boolean
}
שדות
psaWriteEndpoint

string

פלט בלבד. אם השדה הזה מוגדר, הוא מציין שלמופע הזה יש נקודת קצה של DNS לגישה פרטית לשירות (PSA) שמצביעה על המופע הראשי של האשכול. אם המופע הזה הוא הראשי, נקודת הקצה של ה-DNS מפנה למופע הזה. אחרי פעולת מעבר או פעולת מעבר לגיבוי (failover) של רפליקה, נקודת הקצה הזו של ה-DNS מצביעה על המופע שקודם. זהו שדה לקריאה בלבד, שמוחזר למשתמש כמידע. השדה הזה יכול להתקיים גם אם למופע עצמאי עדיין אין רפליקת DR או אם רפליקת ה-DR נמחקת.
failoverDrReplicaName

string

זה שינוי אופציונלי. אם המופע הוא מופע ראשי, השדה הזה מזהה את הרפליקה של התאוששות מאסון (DR). שכפול לצורך התאוששות מאסון הוא הגדרה אופציונלית למכונות במהדורת Enterprise Plus. אם המכונה היא רפליקה לקריאה, השדה לא מוגדר. כדי להגדיר רפליקה לשחזור מאסון (DR) למופע ראשי, צריך להגדיר את השדה הזה לשם של רפליקה. מסירים את שם הרפליקה כדי להסיר את ייעוד הרפליקה להתאוששות מאסון.
drReplica

boolean

פלט בלבד. שדה לקריאה בלבד שמציין אם העותק הוא עותק DR. השדה הזה לא מוגדר אם המופע הוא מופע ראשי.

GeminiInstanceConfig

ייצוג ב-JSON 
{

  // Union field _entitled can be only one of the following:
  "entitled": boolean
  // End of list of possible types for union field _entitled.

  // Union field _google_vacuum_mgmt_enabled can be only one of the following:
  "googleVacuumMgmtEnabled": boolean
  // End of list of possible types for union field _google_vacuum_mgmt_enabled.

  // Union field _oom_session_cancel_enabled can be only one of the following:
  "oomSessionCancelEnabled": boolean
  // End of list of possible types for union field _oom_session_cancel_enabled.

  // Union field _active_query_enabled can be only one of the following:
  "activeQueryEnabled": boolean
  // End of list of possible types for union field _active_query_enabled.

  // Union field _index_advisor_enabled can be only one of the following:
  "indexAdvisorEnabled": boolean
  // End of list of possible types for union field _index_advisor_enabled.

  // Union field _flag_recommender_enabled can be only one of the following:
  "flagRecommenderEnabled": boolean
  // End of list of possible types for union field _flag_recommender_enabled.
}
שדות

שדה איחוד _entitled.

הערך _entitled יכול להיות רק אחד מהבאים:
entitled

boolean

פלט בלבד. האם Gemini מופעל.

שדה איחוד _google_vacuum_mgmt_enabled.

הערך _google_vacuum_mgmt_enabled יכול להיות רק אחד מהבאים:
googleVacuumMgmtEnabled

boolean

פלט בלבד. האם ניהול השואב מופעל.

שדה איחוד _oom_session_cancel_enabled.

הערך _oom_session_cancel_enabled יכול להיות רק אחד מהבאים:
oomSessionCancelEnabled

boolean

פלט בלבד. האם מופעלת האפשרות לבטל את הסשן של חוסר זיכרון (OOM).

שדה איחוד _active_query_enabled.

הערך _active_query_enabled יכול להיות רק אחד מהבאים:
activeQueryEnabled

boolean

פלט בלבד. האם השאילתה הפעילה מופעלת.

שדה איחוד _index_advisor_enabled.

הערך _index_advisor_enabled יכול להיות רק אחד מהבאים:
indexAdvisorEnabled

boolean

פלט בלבד. האם כלי הייעוץ בנושא אינדקסים מופעל.

שדה איחוד _flag_recommender_enabled.

הערך _flag_recommender_enabled יכול להיות רק אחד מהבאים:
flagRecommenderEnabled

boolean

פלט בלבד. האם הכלי להמלצה על תכונות ניסיוניות מופעל.

TagsEntry

ייצוג ב-JSON 
{
  "key": string,
  "value": string
}
שדות
key

string
value

string

PoolNodeConfig

ייצוג ב-JSON 
{
  "ipAddresses": [
    {
      object (IpMapping)
    }
  ],
  "dnsNames": [
    {
      object (DnsNameMapping)
    }
  ],
  "pscAutoConnections": [
    {
      object (PscAutoConnectionConfig)
    }
  ],

  // Union field _name can be only one of the following:
  "name": string
  // End of list of possible types for union field _name.

  // Union field _gce_zone can be only one of the following:
  "gceZone": string
  // End of list of possible types for union field _gce_zone.

  // Union field _dns_name can be only one of the following:
  "dnsName": string
  // End of list of possible types for union field _dns_name.

  // Union field _state can be only one of the following:
  "state": enum (SqlInstanceState)
  // End of list of possible types for union field _state.

  // Union field _psc_service_attachment_link can be only one of the following:
  "pscServiceAttachmentLink": string
  // End of list of possible types for union field _psc_service_attachment_link.
}
שדות
ipAddresses[]

object (IpMapping)

פלט בלבד. מיפויים שמכילים כתובות IP שאפשר להשתמש בהן כדי להתחבר לצומת של מאגר הקריאה.
dnsNames[]

object (DnsNameMapping)

פלט בלבד. רשימת שמות ה-DNS שמשמשים את הצומת הזה במאגר לקריאה.
pscAutoConnections[]

object (PscAutoConnectionConfig)

פלט בלבד. רשימת ההגדרות של נקודות קצה של צרכני Private Service Connect ‏ (PSC) שהוגדרו אוטומטית, שאפשר להשתמש בהן כדי להתחבר לצומת הזה של מאגר הקריאה.

שדה איחוד _name.

הערך _name יכול להיות רק אחד מהבאים:
name

string

פלט בלבד. השם של צומת מאגר הקריאה, שישמש לאחזור מדדים ויומנים.

שדה איחוד _gce_zone.

הערך _gce_zone יכול להיות רק אחד מהבאים:
gceZone

string

פלט בלבד. האזור של הצומת במאגר לקריאה.

שדה איחוד _dns_name.

הערך _dns_name יכול להיות רק אחד מהבאים:
dnsName

string

פלט בלבד. שם ה-DNS של הצומת במאגר לקריאה.

שדה איחוד _state.

הערך _state יכול להיות רק אחד מהבאים:
state

enum (SqlInstanceState)

פלט בלבד. המצב הנוכחי של צומת מאגר הקריאה.

שדה איחוד _psc_service_attachment_link.

הערך _psc_service_attachment_link יכול להיות רק אחד מהבאים:
pscServiceAttachmentLink

string

פלט בלבד. קובץ מצורף עם השירות Private Service Connect ‏ (PSC) של צומת מאגר הקריאה.

DnsNameMapping

ייצוג ב-JSON 
{
  "name": string,
  "connectionType": enum (ConnectionType),
  "dnsScope": enum (DnsScope),
  "recordManager": enum (RecordManager)
}
שדות
name

string

פלט בלבד. שם ה-DNS.
connectionType

enum (ConnectionType)

פלט בלבד. סוג החיבור של שם ה-DNS.
dnsScope

enum (DnsScope)

פלט בלבד. ההיקף ששם ה-DNS חל עליו.
recordManager

enum (RecordManager)

פלט בלבד. הגורם המנהל של רשומת ה-DNS הזו.

הערות על כלי

רמז הרסני: ❌ | רמז אידמפוטנטי: ❌ | רמז לקריאה בלבד: ✅ | רמז לעולם פתוח: ❌