Cloud SQL-Ressourcen mit Knowledge Catalog verwalten

Auf dieser Seite wird erläutert, wie Sie mit Knowledge Catalog (früher Dataplex Universal Catalog) Cloud SQL-Ressourcen suchen und verwalten können.

Knowledge Catalog ist eine Plattform zum Speichern, Verwalten und Aufrufen Ihrer Metadaten. Knowledge Catalog ruft die folgenden Metadaten automatisch aus Cloud SQL-Instanzen, ‑Datenbanken, ‑Tabellen, ‑Spalten und ‑Ansichten ab:

  • Name
  • Standort (Region)
  • Erstellungsdatum und Datum der letzten Änderung
  • Schema (für Tabellen und Ansichten)
  • Beschreibung
  • Beschränkungen für Primärschlüssel und Fremdschlüssel

Knowledge Catalog ruft Metadaten nur aus primären Cloud SQL-Instanzen, nicht aus Lesereplikaten oder externen Serverreplikaten ab.

Mit Knowledge Catalog können Sie Ihre Cloud SQL-Metadaten ermitteln und analysieren. Mit Knowledge Catalog können Sie die folgenden Aktivitäten unterstützen:

  • Datenerkennung
  • Klassifizierung
  • Analyse, einschließlich Abhängigkeiten und Eignung für einen Anwendungsfall
  • Änderungsmanagement
  • Datenverschiebung (Pipelines)
  • Schemaentwicklung

Mit Knowledge Catalog können Sie Metadaten kuratieren, indem Sie Cloud SQL-Metadateneinträgen Aspekte zuweisen. Jeder Aspekt kann mehrere Metadatenfelder enthalten und auf einem vordefinierten oder benutzerdefinierten Aspekttyp basieren.

Sie können beispielsweise den folgenden Aspekt an eine Spalte anhängen, die eine Sozialversicherungsnummer enthält, also eine personenidentifizierbare Information:

  pii:true
  pii_type:SSN

Weitere Informationen zu Knowledge Catalog finden Sie unter Metadatenverwaltung in Knowledge Catalog.

Datenaktualität der Knowledge Catalog-Einbindung

Die erwartete Aktualität Ihrer Instanzmetadaten in Knowledge Catalog hängt vom Erstellungsdatum der Instanz, ihrer Datenbankversion und ihrer Netzwerkarchitektur ab.

Nahezu in Echtzeit

Die Einbindung in Knowledge Catalog ist standardmäßig aktiviert, wenn die Instanz erstellt wird und alle der folgenden Kriterien erfüllt:

  1. Erstellungszeitpunkt: Am oder nach dem 9. November 2026

  2. Version: Alle SQL Server-Versionen
  3. Netzwerkarchitektur: Neue Netzwerkarchitektur

Bei vorhandenen Instanzen, die vor dem 18. April 2026 erstellt wurden und die Kriterien für die Version und die neue Netzwerkarchitektur erfüllen, wird die Integration von Knowledge Catalog durch Knowledge Catalog-Integration in einer vorhandenen Cloud SQL-Instanz aktivieren nahezu in Echtzeit aktiviert. Wenn für eine solche Instanz die Knowledge Catalog-Einbindung bereits einmal pro Tag aktiviert ist, können Sie die Einbindung deaktivieren und wieder aktivieren, um von einmal pro Tag auf nahezu in Echtzeit umzustellen.

Wenn Ihre Instanz die Kriterien für die Integration nahezu in Echtzeit nicht erfüllt, lesen Sie den Abschnitt Einmal täglich.

Instanzen, die nahezu in Echtzeit integriert werden, enthalten eine Zeitstempeltabelle, um die Erstellungs- und Aktualisierungszeiten für Ihre Assets zu erfassen. Die Zeitstempeltabelle ist die Tabelle resource_timestamps in der Datenbank gcloud_cloudsqladmin. Die Zeitstempeltabelle kann über Cloud SQL in der Google Cloud Console abgefragt werden. Wenn in Ihrer Instanz eine DDL- oder Schemaänderung vorgenommen wird, fragt die Integration die Zeitstempeltabelle ab, um kürzlich geänderte Assets zu identifizieren. Anschließend werden die neuesten Schemaaktualisierungen nahezu in Echtzeit in Knowledge Catalog geladen. In seltenen Fällen, z. B. bei Netzwerkinstabilität, kann es vorkommen, dass Knowledge Catalog ein Update verpasst. Dies ist zwar selten, aber alle verpassten Änderungen werden schließlich konsistent, normalerweise innerhalb von 24 Stunden. Weitere Informationen zu Szenarien, die zu verpassten Änderungen führen können, finden Sie auf dieser Seite unter Einschränkungen.

Wenn Sie sich Abfragen ansehen, die in einer Instanz ausgeführt wurden, werden Abfragen angezeigt, die die Knowledge Catalog-Integration unterstützen. Sie erkennen diese Abfragen am Kommentar --Dataplex, den sie enthalten. Informationen zum Aufrufen von Abfragen für eine Instanz finden Sie unter Aktive Abfragen aufrufen.

Sie können die Integration deaktivieren und später gemäß der Anleitung unter Instanz aktualisieren wieder aktivieren.

Einmal pro Tag

Die Einbindung in Knowledge Catalog kann für Instanzen aktiviert werden, die eines der folgenden Kriterien erfüllen:

  1. Erstellungszeitpunkt: Vor dem 18. April 2026
  2. Version: Alle SQL Server-Versionen
  3. Netzwerkarchitektur: Alte Netzwerkarchitektur

Nachdem Sie die Einbindung in Knowledge Catalog aktiviert haben, werden die Metadaten für Instanzen, die eines dieser Kriterien erfüllen, in der Regel etwa einmal täglich in Knowledge Catalog aktualisiert.

Wenn Ihre Instanz nach dem 24. März 2026 erstellt wurde, ist die Einbindung in Knowledge Catalog standardmäßig aktiviert. Für Instanzen, die vor dem 18. April 2026 erstellt wurden, können Sie die Einbindung von Knowledge Catalog in eine vorhandene Cloud SQL-Instanz aktivieren.

Wenn eine vorhandene Instanz, die vor dem 18. April 2026 erstellt wurde, die Kriterien für die Version und die neue Netzwerkarchitektur in Nahezu in Echtzeit erfüllt, wird die Instanz durch Aktivieren der Knowledge Catalog-Integration (oder durch Deaktivieren der Integration und erneutes Aktivieren, wenn sie bereits einmal täglich integriert wurde) stattdessen für Aktualisierungen nahezu in Echtzeit konfiguriert.

Sie können die Integration deaktivieren und später gemäß der Anleitung unter Instanz aktualisieren wieder aktivieren.

Hinweis

  1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Google Cloud project.

  3. Aktivieren Sie die Dataplex API für das Projekt.

    Dataplex API aktivieren

  4. Prüfen Sie die Berechtigungen.

    Sie benötigen bestimmte IAM-Rollen und -Berechtigungen (Identity and Access Management), um Einträge für Cloud SQL-Assets zu suchen und an sie anzuhängen. Weitere Informationen finden Sie unter Erforderliche IAM-Rollen und -Berechtigungen für Knowledge Catalog.

Erforderliche IAM-Rollen und -Berechtigungen für Knowledge Catalog

Cloud SQL verwendet die Berechtigung cloudsql.schemas.view, um Zugriff auf die Metadaten in Knowledge Catalog zu gewähren.

Wenn Sie diese Berechtigung gewähren möchten, erstellen Sie eine benutzerdefinierte Rolle, die diese Berechtigung enthält, oder verwenden Sie eine der vordefinierten Rollen, die diese Berechtigung haben.

Weitere Informationen finden Sie unter Vordefinierte Cloud SQL-IAM-Rollen.

Instanz mit aktivierter Knowledge Catalog-Einbindung erstellen

Neue Instanzen werden standardmäßig in Knowledge Catalog eingebunden. Wenn Sie eine neue Instanz mit aktivierter Knowledge Catalog-Integration erstellen möchten, müssen Sie nur eine neue Instanz erstellen. Wenn Sie eine Instanz mit Knowledge Catalog erstellen möchten, die nahezu in Echtzeit eingebunden ist, muss Ihre neue Instanz alle der folgenden Kriterien erfüllen:

  1. Erstellungszeitpunkt: Am oder nach dem 9. November 2026

  2. Version: Alle SQL Server-Versionen
  3. Netzwerkarchitektur: Neue Netzwerkarchitektur

Wenn Sie den Knowledge Catalog nahezu in Echtzeit für eine neue Instanz mit einer früheren Datenbankversion oder der alten Netzwerkarchitektur aktivieren möchten, können Sie die Instanz klonen oder aus einer Sicherung in einer neuen Instanz wiederherstellen.

gcloud

Die Instanz erstellen

Verwenden Sie den Befehl gcloud sql instances create, um eine Cloud SQL-Instanz zu erstellen.

gcloud sql instances create INSTANCE_NAME \
  --database-version=DATABASE_VERSION \
  --tier=MACHINE_TYPE \
  --region=REGION_NAME

Ersetzen Sie die folgenden Werte:

  • INSTANCE_NAME den Namen der Instanz
  • DATABASE_VERSION: die Datenbankversion für die Instanz (z. B. SQLSERVER_2019_ENTERPRISE). Eine vollständige Liste der verfügbaren Strings finden Sie unter SqlDatabaseVersion.
  • MACHINE_TYPE: der gewünschte Maschinentyp für die Instanz
  • REGION_NAME: Name der Region für die Instanz

Dieses Beispiel ist Linux-basiert.

REST Version 1

Die Instanz erstellen

Verwenden Sie dieses Beispiel, um eine Instanz mit aktivierter Einbindung zu erstellen. Eine vollständige Liste der Parameter, die für diesen Aufruf verfügbar sind, finden Sie auf der Seite instances.insert.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die ID oder Projektnummer des Google Cloud -Projekts, das die Instanz enthält
  • INSTANCE_NAME den Namen der Instanz
  • REGION_NAME: Name der Region für die Instanz
  • DATABASE_VERSION: Enum-String der Datenbankversion (z. B. POSTGRES_13). Eine vollständige Liste der verfügbaren Strings finden Sie unter SqlDatabaseVersion.
  • PASSWORD: Passwort für den root-Nutzer
  • MACHINE_TYPE: Enum-String des Maschinentyps (Stufe), z. B.: db-custom-[CPUS]-[MEMORY_MBS]
  • EDITION_TYPE: Ihre Cloud SQL-Version.

HTTP-Methode und URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

JSON-Text anfordern:

{
  "name": "INSTANCE_NAME",
  "region": "REGION_NAME",
  "databaseVersion": "DATABASE_VERSION",
  "rootPassword": "PASSWORD",
  "settings": {
    "tier": "MACHINE_TYPE",
    "edition": "EDITION_TYPE",
    "enableDataplexIntegration": true
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-09-25T22:19:33.735Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

Die Instanz erstellen

Verwenden Sie dieses Beispiel, um eine Instanz mit aktivierter Einbindung zu erstellen. Eine vollständige Liste der Parameter, die für diesen Aufruf verfügbar sind, finden Sie auf der Seite instances.insert.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die ID oder Projektnummer des Google Cloud -Projekts, das die Instanz enthält
  • INSTANCE_NAME den Namen der Instanz
  • REGION_NAME: Name der Region für die Instanz
  • DATABASE_VERSION: Enum-String der Datenbankversion (z. B. POSTGRES_13) Eine vollständige Liste der verfügbaren Strings finden Sie unter SqlDatabaseVersion.
  • PASSWORD: Passwort für den root-Nutzer
  • MACHINE_TYPE: Enum-String des Maschinentyps (Stufe), z. B.: db-custom-[CPUS]-[MEMORY_MBS]
  • EDITION_TYPE: Ihre Cloud SQL-Version.

HTTP-Methode und URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances

JSON-Text anfordern:

{
  "name": "INSTANCE_NAME",
  "region": "REGION_NAME",
  "databaseVersion": "DATABASE_VERSION",
  "rootPassword": "PASSWORD",
  "settings": {
    "tier": "MACHINE_TYPE",
    "edition": "EDITION_TYPE",
    "enableDataplexIntegration": true
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-09-25T22:19:33.735Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Einbindung von Knowledge Catalog in eine vorhandene Cloud SQL-Instanz aktivieren

Sie können die Aktualisierungsanleitung in diesem Abschnitt befolgen, um die Knowledge Catalog-Integration für eine vorhandene Instanz zu aktivieren, die vor dem 18. April 2026 erstellt wurde.

Wenn Sie die Knowledge Catalog-Einbindung für eine vorhandene Instanz aktivieren, geschieht Folgendes:

  • Für Instanzen, die eines der folgenden Kriterien erfüllen, werden durch die Aktivierung der Knowledge Catalog-Integration einmal täglich Aktualisierungen aktiviert:

  • Für Instanzen, die alle der folgenden Kriterien erfüllen, werden durch die Aktivierung der Knowledge Catalog-Integration Aktualisierungen nahezu in Echtzeit ermöglicht:

    Nachdem Sie die Integration nahezu in Echtzeit aktiviert haben, werden neue DDL- und Schemaänderungen innerhalb von 10 Minuten angezeigt. Vorhandene Ressourcen auf der Instanz werden innerhalb von 24 Stunden ausgefüllt.

Wenn Sie die Einbindung von Knowledge Catalog in eine vorhandene Cloud SQL-Instanz aktivieren oder wieder aktivieren möchten, verwenden Sie eines der folgenden Verfahren.

gcloud

Instanz aktualisieren

Verwenden Sie den Befehl gcloud sql instances patch, um die Einbindung für eine vorhandene Instanz zu aktivieren.

gcloud sql instances patch INSTANCE_NAME \
  --enable-dataplex-integration

Wenn Sie alle Cloud SQL-Instanzen in Ihrem Projekt aktivieren und aktualisieren müssen, können Sie ein Skript ähnlich dem folgenden ausführen:

gcloud sql instances list --format="(NAME)" \
| tail -n +2 | xargs -t -I %
gcloud sql instances patch % --enable-dataplex-integration

Dieses Beispiel ist Linux-basiert.

REST Version 1

Instanz aktualisieren

Verwenden Sie dieses Beispiel, um eine vorhandene Instanz zu aktualisieren. Eine vollständige Liste der Parameter, die für diesen Aufruf verfügbar sind, finden Sie auf der Seite instances.patch.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die ID oder Projektnummer des Google Cloud -Projekts, das die Instanz enthält
  • INSTANCE_NAME den Namen der Instanz

HTTP-Methode und URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON-Text anfordern:

{
  "settings":
  {
    "enableDataplexIntegration": true
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

Instanz aktualisieren

Verwenden Sie dieses Beispiel, um eine vorhandene Instanz zu aktualisieren. Eine vollständige Liste der Parameter, die für diesen Aufruf verfügbar sind, finden Sie auf der Seite instances.patch.

Verwenden Sie dieses Beispiel, um eine vorhandene Instanz zu aktualisieren. Eine vollständige Liste der Parameter, die für diesen Aufruf verfügbar sind, finden Sie auf der Seite "instances.patch".

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die ID oder Projektnummer des Google Cloud -Projekts, das die Instanz enthält
  • INSTANCE_NAME den Namen der Instanz

HTTP-Methode und URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON-Text anfordern:

{
  "settings":
  {
    "enableDataplexIntegration": true
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Knowledge Catalog-Integration in Ihre Cloud SQL-Instanz prüfen

Mit einem der folgenden Verfahren können Sie prüfen, ob die Knowledge Catalog-Einbindung auf Ihrer Instanz aktiviert ist.

gcloud

Verwenden Sie den Befehl gcloud sql instances describe, um zu prüfen, ob die Knowledge Catalog-Einbindung auf einer vorhandenen Instanz aktiviert ist.

gcloud sql instances describe INSTANCE_NAME

Ersetzen Sie INSTANCE_NAME durch den Namen der Instanz. Suchen Sie in der Ausgabe nach der Konfigurationseinstellung enableDataplexIntegration, die auf true festgelegt ist.

REST Version 1

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die Projekt-ID
  • INSTANCE_ID: die Instanz-ID

HTTP-Methode und URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
"settings":
  {
  "enableDataplexIntegration": true
  }
}

REST v1beta4

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die Projekt-ID
  • INSTANCE_ID: die Instanz-ID

HTTP-Methode und URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
"settings":
  {
  "enableDataplexIntegration": true
  }
}

Einbindung von Knowledge Catalog in Ihre Cloud SQL-Instanz deaktivieren

Wenn Sie die Einbindung von Knowledge Catalog in Ihre Cloud SQL-Instanz deaktivieren möchten, verwenden Sie eines der folgenden Verfahren.

Das Deaktivieren der Knowledge Catalog-Einbindung auf einer Instanz, die nahezu in Echtzeit eingebunden ist, dauert bis zu 10 Minuten.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Cloud SQL-Instanzen auf.

    Cloud SQL-Instanzen aufrufen

  2. Klicken Sie auf den Instanznamen, um die Übersichtsseite einer Instanz zu öffnen.
  3. Klicken Sie auf Bearbeiten.
  4. Maximieren Sie im Abschnitt Instanz anpassen das Menü Konfigurationsoptionen einblenden.

  5. Entfernen Sie im Bereich Flags und Parameter das Häkchen aus dem Kästchen Knowledge Catalog-Einbindung aktivieren.

  6. Klicken Sie auf Speichern.

gcloud

Verwenden Sie den Befehl gcloud sql instances patch, um die Einbindung für eine vorhandene Instanz zu deaktivieren.

gcloud sql instances patch INSTANCE_NAME \
  --no-enable-dataplex-integration

Wenn Sie die Einbindung deaktivieren und alle Cloud SQL-Instanzen in Ihrem Projekt aktualisieren müssen, können Sie ein Skript ähnlich dem folgenden ausführen:

gcloud sql instances list --format="(NAME)" \
| tail -n +2 | xargs -t -I %
gcloud sql instances patch % --no-enable-dataplex-integration

Dieses Beispiel ist Linux-basiert.

REST Version 1

In diesem Beispiel können Sie die Einbindung deaktivieren.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die ID oder Projektnummer des Google Cloud -Projekts, das die Instanz enthält
  • INSTANCE_NAME den Namen der Instanz

HTTP-Methode und URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON-Text anfordern:

{
  "settings":
  {
    "enableDataplexIntegration": false
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

In diesem Beispiel können Sie die Einbindung deaktivieren.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die ID oder Projektnummer des Google Cloud -Projekts, das die Instanz enthält
  • INSTANCE_NAME den Namen der Instanz

HTTP-Methode und URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON-Text anfordern:

{
  "settings":
  {
    "enableDataplexIntegration": false
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Cloud SQL-Assets mit Aspekten anreichern

Aspekttypen sind wiederverwendbare Ressourcen, die Sie als Vorlagen für Aspekte verwenden können. Mit Aspekttypen können Sie doppelte Arbeit und unvollständige Aspekte vermeiden. Mit Knowledge Catalog können Sie die erforderlichen Aspekttypen erstellen.

Nachdem Sie benutzerdefinierte Aspekttypen erstellt haben, können Sie Ihren Cloud SQL-Assets Aspekte hinzufügen. Wenn Sie Aspekte an Cloud SQL-Assets anhängen, können Sie Folgendes tun:

  • Fügen Sie den Assets geschäftliche Metadaten hinzu.
  • Sie können anhand von geschäftlichen Metadaten und anderen benutzerdefinierten Metadaten nach Assets suchen.

Weitere Informationen zum Erstellen von Aspekttypen und zum Anhängen von Aspekten an Cloud SQL finden Sie unter Aspekte verwalten und Metadaten anreichern.

Nach Cloud SQL-Assets suchen

Verwenden Sie die Knowledge Catalog-Suchseite in der Google Cloud Console, um nach Cloud SQL-Assets zu suchen.

  1. Rufen Sie im Knowledge Catalog die Seite Suchen auf.

    Zur Suche

  2. Wählen Sie unter Suchplattform auswählen die Option Knowledge Catalog aus.

  3. Klicken Sie im Bereich Filter auf Systeme und wählen Sie dann Cloud SQL aus.

  4. Optional. Unter Typ-Aliasse können Sie die Suchergebnisse nach einem bestimmten Cloud SQL-Asset-Typ filtern, indem Sie einen oder mehrere der folgenden Typ-Aliasse auswählen:

    • Datenbank
    • Datenbankschema
    • Dienst
    • Tabelle
    • Ansicht

Suchen über Anfragen ausführen

Sie können auch das Suchfeld in Knowledge Catalog verwenden, um Suchanfragen auszuführen. Geben Sie system=Cloud_SQL ein, um alle Cloud SQL-Assets aufzurufen.

Anschließend können Sie bestimmte Keywords eingeben. So rufen Sie beispielsweise alle Cloud SQL-Datenbanken auf:

system=Cloud_SQL AND type=Database

Geben Sie die folgende Abfrage ein, um alle Cloud SQL-Tabellen aufzurufen:

system=Cloud_SQL AND type=Table

Sie können auch Klammern und die logischen Operatoren AND und OR für komplexe Ausdrücke verwenden. Weitere Informationen zu den Ausdrücken, die Sie im Suchfeld verwenden können, finden Sie unter Suchsyntax für Knowledge Catalog.

Sie können Suchanfragen für bestimmte Cloud SQL-Assets direkt in das Suchfeld eingeben. Der Abfragestring hat folgendes Format:

type="projects/dataplex-types/locations/global/entryTypes/QUERY_STRING"

Ersetzen Sie QUERY_STRING durch einen Abfragestring, der auf der Cloud SQL-Engine und dem Asset-Typ basiert, den Sie abfragen möchten. Verwenden Sie die folgende Tabelle, um den entsprechenden Abfragestring zu ermitteln.

Cloud SQL-Engine Abfragestrings
Cloud SQL for MySQL
  • cloudsql-mysql-database
  • cloudsql-mysql-instance
  • cloudsql-mysql-table
  • cloudsql-mysql-view
Cloud SQL for PostgreSQL
  • cloudsql-postgresql-database
  • cloudsql-postgresql-instance
  • cloudsql-postgresql-table
  • cloudsql-postgresql-schema
  • cloudsql-postgresql-view
Cloud SQL for SQL Server
  • cloudsql-sqlserver-database
  • cloudsql-sqlserver-instance
  • cloudsql-sqlserver-table
  • cloudsql-sqlserver-schema
  • cloudsql-sqlserver-view

Eine Beispielabfrage könnte etwa so aussehen:

type="projects/dataplex-types/locations/global/entryTypes/cloudsql-postgresql-instance"

Cloud SQL-Assets nach Cloud SQL-Dialekt filtern

Standardmäßig werden in Knowledge Catalog alle Cloud SQL-Assets angezeigt. Führen Sie die folgenden Schritte aus, um nur die Assets für Cloud SQL for MySQL, Cloud SQL for PostgreSQL und SQL Server zu filtern.

  1. Klicken Sie im Bereich Aspekte auf das Menü Weitere Aspekttypen hinzufügen.

  2. Wählen Sie SQL-Zugriff aus.

  3. Klicken Sie auf OK.

  4. Klicken Sie auf den Button playlist_add „Aspekt bearbeiten“. Führen Sie auf der Seite SQL-Zugriff die folgenden Schritte aus:

    • Wählen Sie im Feld Dialekt die Option SQL Server aus, um nach SQL Server-Assets zu filtern.
  5. Optional. Wählen Sie das Feld Version aus und geben Sie eine bestimmte SQL Server-Version ein.

  6. Klicken Sie auf Übernehmen. Knowledge Catalog zeigt nur SQL Server-Assets an.

Knowledge Catalog umfasst einige integrierte Aspekttypen, die Sie für Suchvorgänge nutzen können.

  1. Klicken Sie im Bereich Aspekte auf das Menü Weitere Aspekttypen hinzufügen.

  2. Optional. Wählen Sie SQL-Zugriff aus, um die Ergebnisse nach Cloud SQL-Dialekt zu filtern. Weitere Informationen finden Sie im vorherigen Verfahren Cloud SQL-Assets nach Cloud SQL-Dialekt filtern.

  3. Wählen Sie einen oder mehrere der folgenden Aspekttypen aus, um die Suchergebnisse auf diesen Typ zu beschränken.

    • Cloud SQL-Datenbank
    • Cloud SQL-Instanz
    • Cloud SQL-Ansicht
    • Cloud SQL-Schema
    • Cloud SQL-Tabelle

  4. Klicken Sie auf OK.

  5. Klicken Sie in der Ergebnistabelle auf den Namen des Assets, um die Metadaten für dieses Asset aufzurufen.

  6. Optional: Assets optimieren oder ansehen. Sie haben folgende Möglichkeiten:

    • Klicken Sie unter Übersicht auf Hinzufügen, um eine RTF-Beschreibung des Assets hinzuzufügen.
    • Klicken Sie unter Aspekte auf Hinzufügen, um dem Asset einen Aspekt hinzuzufügen.
    • Wenn Sie beispielsweise Mitgliedsdatenbanken aufrufen möchten, klicken Sie auf den Tab Eintragsliste und dann auf Alle untergeordneten Einträge in der Suche anzeigen. Wenn der Tab Eintragsliste nicht angezeigt wird, hat die Instanz keine Datenbanken.
    • Unter Details zum Eintrag sehen Sie alle Details des Assets. Klicken Sie auf den Eintragsnamen, um weitere Einträge aufzurufen.

Beispielworkflow – Aufschlüsselung von Instanz zu Spalten

In diesem Beispielworkflow suchen Sie zuerst nach einer Cloud SQL-Instanz, rufen dann eine Mitgliederdatenbank und dann eine Tabelle in dieser Datenbank auf und rufen dann die Spalten in der Tabelle auf.

  1. Rufen Sie im Knowledge Catalog die Seite Suchen auf.

    Zur Suche

  2. Wählen Sie für die Option Suchplattform auswählen die Option Knowledge Catalog aus.

  3. Wählen Sie im Bereich Filter die Option Systeme und dann Cloud SQL aus. Alternativ können Sie system=Cloud_SQL in das Suchfeld eingeben.

  4. Wählen Sie einen Instanznamen aus.

  5. Klicken Sie auf der Seite Cloud SQL-Details auf den Tab Eintragsliste und dann auf Alle untergeordneten Einträge in der Suche anzeigen. Knowledge Catalog zeigt die Datenbanken in der Instanz an.

  6. Klicken Sie auf der Seite Cloud SQL-Datenbankdetails auf den Tab Eintragsliste und dann auf Untergeordnete Einträge in der Suche ansehen. Knowledge Catalog zeigt die Tabellen in der Datenbank an.

  7. Wählen Sie einen Tabellennamen aus und klicken Sie dann auf der Seite Cloud SQL-Tabellendetails auf Schema, um die Tabellenspalten aufzurufen.

  8. Optional: Wenn Sie einer Spalte einen Aspekttyp hinzufügen möchten, klicken Sie auf den Button Aspekt hinzufügen.

Dieser Workflow zeigt das Aufschlüsseln von Instanz zu einer Tabelle. Sie können direkt zu einer Liste von Tabellen gelangen, indem Sie system=Cloud_SQL AND type=Table in das Suchfeld eingeben.

Preise

Für das Speichern technischer Cloud SQL-Metadaten in Knowledge Catalog fallen keine Kosten an. Für API-Aufrufe und die zusätzliche Anreicherung von Geschäftsmetadaten gelten die Standardpreise für Knowledge Catalog. Weitere Informationen finden Sie auf der Preisseite für Knowledge Catalog.

Ressourcennutzung

Wenn die Knowledge Catalog-Einbindung aktiviert ist, extrahiert Knowledge Catalog regelmäßig Daten aus Ihren Instanzen. Der Extraktionsprozess erfordert eine gewisse CPU-Auslastung.

Instanzen, die nahezu in Echtzeit in Knowledge Catalog eingebunden sind, haben in der Regel nur minimale Auswirkungen auf die CPU-Auslastung. Bei Instanzen, die einmal täglich in Knowledge Catalog eingebunden werden, kann die CPU-Auslastung höher sein. Dies macht sich besonders bei Instanzen mit kleineren Maschinentypen bemerkbar, z. B. bei Maschinen mit gemeinsam genutzten Kernen und größeren Schemas (10.000 oder mehr Tabellen), die während des Extraktionsprozesses bis zu 40 % ihrer CPU nutzen können. Instanzen mit kleineren Maschinentypen, z. B. Maschinen mit gemeinsam genutzten Kernen und größeren Schemas (10.000 oder mehr Tabellen), können während des Extraktionsprozesses bis zu 40 % ihrer CPU nutzen.

Beschränkungen

In diesem Abschnitt werden die Einschränkungen bei der Verwendung von Cloud SQL und Knowledge Catalog aufgeführt.

  • Bei Instanzen, die vor dem 18. April 2026 erstellt wurden, ist die Knowledge Catalog-Integration in Cloud SQL für alle Instanzen deaktiviert, die den Zugriff auf Ressourcen aufgrund der Ressourcenregistrierung in Assured Workloads einschränken.

  • Nachdem Sie Knowledge Catalog für eine Instanz aktiviert haben, kann es je nach Maschinengröße, Version und Typ der verwendeten Cloud SQL-Engine zwischen 2 und 48 Stunden dauern, bis Ihre Cloud SQL-Ressourcen in Knowledge Catalog als Assets angezeigt werden.

Diese Einschränkung gilt nicht, wenn Ihre Instanz nahezu in Echtzeit aktualisiert wird, wie unter Nahezu in Echtzeit beschrieben.

  • SQL Server-Datenbanken, für die die Option Auto Close aktiviert ist, können Schemainformationen nicht mit Knowledge Catalog synchronisieren. Als allgemeine Best Practice und aus Leistungsgründen empfehlen wir, die Option Auto Close in SQL Server auf „false“ festzulegen. Wenn Sie Knowledge Catalog verwenden möchten, muss die Option Auto Close auf „false“ gesetzt sein. Bei Express-Versionen ist die Option Auto Close standardmäßig auf „true“ gesetzt, wie von der SQL Server-Engine vorgesehen.

Die folgenden Einschränkungen gelten nur, wenn Ihre Instanz nahezu in Echtzeit aktualisiert wird, wie unter Nahezu in Echtzeit beschrieben:

  • Wenn eine Datenbank umbenannt wird, ist nur die Datenbankaktualisierung nahezu in Echtzeit in Knowledge Catalog verfügbar. Die zugrunde liegende Zuordnung der Datenbank und aller zugehörigen Tabellen wird in Knowledge Catalog schließlich konsistent sein.
  • Eine Instanz kann Nachrichten verwerfen, was dazu führen kann, dass die Daten in Knowledge Catalog nur noch „eventually consistent“ sind. Wenn Nachrichten verworfen werden, werden die verpassten Aktualisierungen schließlich in Knowledge Catalog sichtbar. In folgenden Fällen kann eine Instanz Nachrichten verwerfen:
    • Instanzen, bei denen in kurzer Zeit eine hohe Anzahl von DDLs auftritt.
    • Instanzen, die Klone einer vorhandenen Instanz sind.
    • Instanzen, die aus einer Sicherung wiederhergestellt werden.
    • Instanzen, bei denen der Arbeitsspeicher knapp wird.
    • Instanzen, die neu gestartet werden oder deren Datenbanken neu gestartet werden.
    • Instanzen, bei denen Netzwerkprobleme oder eine Unterbrechung des Synchronisierungsprozesses mit Knowledge Catalog auftreten.

Nächste Schritte