Cloud SQL-Ressourcen mit Knowledge Catalog verwalten

Auf dieser Seite wird erläutert, wie Sie mit Knowledge Catalog nach Ihren Cloud SQL-Ressourcen suchen und diese verwalten können.

Knowledge Catalog ist eine Plattform zum Speichern, Verwalten und Aufrufen von Metadaten. Knowledge Catalog ruft automatisch die folgenden Metadaten 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
  • Einschränkungen für Primärschlüssel und Fremdschlüssel

Knowledge Catalog ruft Metadaten nur aus primären Cloud SQL-Instanzen ab, nicht aus Lesereplikaten oder Replikaten externer Server.

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 verwalten, 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 bei der Knowledge Catalog-Einbindung

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

Echtzeitnah

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

  1. Erstellungszeitpunkt:am oder nach dem 18. April 2026

  2. Version:Cloud SQL for PostgreSQL-Version 14.0 oder höher
  3. Netzwerkarchitektur:Neue Netzwerkarchitektur

Wenn Ihre Instanz nicht alle diese Kriterien erfüllt, lesen Sie den Abschnitt Einmal täglich.

Für Instanzen, die alle diese Kriterien erfüllen, wird eine Zeitstempeltabelle erstellt, um die Erstellungs- und Aktualisierungszeiten Ihrer Assets zu erfassen. Die Zeitstempeltabelle befindet sich in der Datenbank cloudsqladmin. Wenn in Ihrer Instanz eine DDL- oder Schemaänderung erfolgt, fragt die Integration die Zeitstempeltabelle ab, um kürzlich geänderte Assets zu ermitteln. Anschließend werden die neuesten Schemaaktualisierungen nahezu in Echtzeit in den Knowledge Catalog geladen. In seltenen Fällen, z. B. bei Netzwerkinstabilität, kann es vorkommen, dass Knowledge Catalog eine Aktualisierung nicht erfasst. Das kommt zwar selten vor, aber alle Änderungen, die nicht berücksichtigt wurden, werden in der Regel innerhalb von 24 Stunden übernommen. Weitere Informationen zu Szenarien, die zu fehlenden Ä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, sehen Sie Abfragen, die die Knowledge Catalog-Integration unterstützen. Sie erkennen diese Anfragen am Kommentar --Dataplex. Informationen zum Aufrufen von Abfragen für eine Instanz finden Sie unter Aktive Abfragen ansehen.

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

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:Cloud SQL for PostgreSQL-Version vor 14.0
  3. Netzwerkarchitektur:Alte Netzwerkarchitektur

Wenn Ihre Instanz nach dem 18. April 2026 erstellt wurde, ist die Integration mit Knowledge Catalog standardmäßig aktiviert. Bei Instanzen, die vor dem 18. April 2026 erstellt wurden, können Sie die Integration von Knowledge Catalog in einer vorhandenen Cloud SQL-Instanz aktivieren .

Nachdem Sie die Einbindung in Knowledge Catalog aktiviert haben, werden die Metadaten für Instanzen, die eines dieser Kriterien erfüllen, in der Regel einmal täglich in Knowledge Catalog aktualisiert. Sie können die Knowledge Catalog-Integration deaktivieren und bei Bedarf wieder aktivieren.

Hinweis

  1. Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

  2. 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

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

  4. 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

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

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

    Dataplex API aktivieren

  7. 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 anzuhängen. Weitere Informationen finden Sie unter Erforderliche IAM-Rollen und -Berechtigungen für den Knowledge Catalog.

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

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

Um diese Berechtigung zu gewähren, 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. Damit Sie eine Instanz mit Knowledge Catalog-Integration in Echtzeit erstellen können, muss Ihre neue Instanz alle der folgenden Kriterien erfüllen:

  1. Erstellungszeitpunkt:am oder nach dem 18. April 2026

  2. Version:Cloud SQL for PostgreSQL-Version 14.0 oder höher
  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 einem Backup 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. POSTGRES_14). 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 basiert auf Linux.

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

Dieser Abschnitt gilt für Instanzen, die eines der folgenden Kriterien erfüllen:
  1. Erstellungszeitpunkt:vor dem 18. April 2026
  2. Version:Cloud SQL for PostgreSQL-Version vor 14.0
  3. Netzwerkarchitektur:Alte Netzwerkarchitektur

Sie können auch der Updateanleitung in diesem Abschnitt folgen, um die Knowledge Catalog-Integration für eine Instanz wieder zu aktivieren, die zuvor nahezu in Echtzeit in Knowledge Catalog eingebunden war. Nachdem die Integration wieder aktiviert wurde, kann es bis zu 10 Minuten dauern, bis Daten nahezu in Echtzeit im Knowledge Catalog angezeigt werden.

Verwenden Sie eines der folgenden Verfahren, um die Einbindung von Knowledge Catalog in eine vorhandene Cloud SQL-Instanz zu aktivieren oder wieder zu aktivieren.

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 basiert auf Linux.

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 Ihrer Cloud SQL-Instanz überprüfen

Verwenden Sie eines der folgenden Verfahren, um zu 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

Verwenden Sie eines der folgenden Verfahren, um die Einbindung von Knowledge Catalog in Ihre Cloud SQL-Instanz zu deaktivieren. Das Deaktivieren der Knowledge Catalog-Einbindung für eine Instanz, die nahezu in Echtzeit eingebunden ist, dauert bis zu 10 Minuten.

Console

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.

    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 Bereich Instanz anpassen das Menü Konfigurationsoptionen einblenden.

  5. Entfernen Sie im Bereich Flags und Parameter das Häkchen bei Knowledge Catalog-Integration 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 basiert auf Linux.

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. Mithilfe von Aspekttypen lassen sich doppelte Arbeit und unvollständige Aspekte vermeiden. Mit dem Knowledge Catalog können Sie die benötigten Aspekttypen erstellen.

Nachdem Sie benutzerdefinierte Aspekttypen erstellt haben, können Sie Ihren Cloud SQL-Assets Aspekte zuweisen. Wenn Sie Aspekte an Cloud SQL-Assets anhängen, haben Sie folgende Möglichkeiten:

  • Assets geschäftliche Metadaten hinzufügen
  • 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 die Seite Suche im Knowledge Catalog 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 Typ von Cloud SQL-Asset 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 im 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

Wenn Sie alle Cloud SQL-Tabellen aufrufen möchten, geben Sie die folgende Abfrage ein:

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 direkt Suchanfragen für bestimmte Cloud SQL-Assets 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. In der folgenden Tabelle finden Sie den entsprechenden Query-String.

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

Im Wissenskatalog werden standardmäßig 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 die Schaltfläche playlist_add „Aspekt bearbeiten“. Führen Sie auf der Seite SQL-Zugriff die folgenden Schritte aus:

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

  6. Klicken Sie auf Übernehmen. Im Knowledge Catalog werden nur Cloud SQL for PostgreSQL-Assets angezeigt.

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: Sie können Ihre Assets optimieren oder ansehen. Sie haben folgende Möglichkeiten:

    • Klicken Sie unter Übersicht auf Hinzufügen, um eine Rich-Text-Beschreibung des Assets hinzuzufügen.
    • Klicken Sie unter Aspekte auf Hinzufügen, um dem Asset einen Aspekt zuzuweisen.
    • 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 Namen des Eintrags, um weitere Einträge aufzurufen.

Beispielworkflow – Von Instanz zu Spalten aufschlüsseln

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 die Seite Suche im Knowledge Catalog auf.

    Zur Suche

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

  3. Wählen Sie im Filterbereich 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. Im Knowledge Catalog werden die Datenbanken in der Instanz angezeigt.

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

  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 die Schaltfläche 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 von technischen Cloud SQL-Metadaten im Knowledge Catalog fallen keine Gebühren an. Es gelten die Standardpreise für Knowledge Catalog für API-Aufrufe und die zusätzliche Anreicherung von Geschäftsmetadaten. Weitere Informationen finden Sie auf der Preisseite für den Knowledge Catalog.

Ressourcennutzung

Wenn die Knowledge Catalog-Einbindung aktiviert ist, werden regelmäßig Daten aus Ihren Instanzen extrahiert. Für die Extraktion ist eine bestimmte CPU-Auslastung erforderlich. Instanzen, die nahezu in Echtzeit in Knowledge Catalog eingebunden werden, und andere Instanzen, die nach dem 18. April 2026 erstellt wurden, haben in der Regel nur minimale Auswirkungen auf die CPU-Auslastung. Bei den meisten Instanzen, die vor dem 18. April 2026 erstellt wurden, einschließlich aller Instanzen, die vor dem 19. März 2026 erstellt wurden, kann die CPU-Nutzung höher sein. Dies ist besonders bei Instanzen mit kleineren Maschinentypen zu beobachten, 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.

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 mit Cloud SQL für alle Instanzen deaktiviert, bei denen der Zugriff auf Ressourcen aufgrund der Registrierung von Ressourcen in Assured Workloads eingeschränkt ist.

  • 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.

  • Instanzen, die Sie für Hochverfügbarkeit (HA) konfigurieren, werden bei der Erstellung nicht automatisch mit dem Knowledge Catalog aktiviert. Wenn Sie die Hochverfügbarkeit für eine Instanz aktivieren, für die Knowledge Catalog bereits aktiviert ist, bleibt Knowledge Catalog aktiviert, sofern Sie es nicht deaktivieren.

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

  • Wenn eine Datenbank umbenannt wird, ist nur die Datenbankaktualisierung nahezu in Echtzeit im Knowledge Catalog verfügbar. Die zugrunde liegende Zuordnung der Datenbank und aller entsprechenden Tabellen wird im Knowledge Catalog letztendlich konsistent sein.
  • Die Integration von Knowledge Catalog nahezu in Echtzeit wird für Instanzen, in denen VPC Service Controls aktiviert ist, nicht unterstützt.
  • Eine Instanz kann Nachrichten verwerfen, was dazu führen kann, dass die Daten im Knowledge Catalog erst nach einiger Zeit konsistent werden. Wenn Nachrichten verworfen werden, werden die verpassten Aktualisierungen schließlich im Wissenskatalog sichtbar. In den folgenden Fällen werden Nachrichten möglicherweise nicht an eine Instanz gesendet:
    • 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