AlloyDB-Ressourcen mit Knowledge Catalog verwalten

Die Knowledge Catalog-Integration ist standardmäßig für alle neuen AlloyDB-Cluster aktiviert. So können Sie Ihre AlloyDB for PostgreSQL-Ressourcen mit Knowledge Catalog suchen und verwalten, einer Plattform, mit der Sie Metadaten speichern, verwalten und darauf zugreifen können. Diese Integration hilft Ihnen, Ihre AlloyDB-Metadaten zu finden und zu verstehen, und unterstützt die folgenden Anwendungsfälle:

  • Analyse: Abhängigkeiten verstehen und Eignung für verschiedene Anwendungsfälle bewerten.
  • Änderungsmanagement: Metadatenänderungen effektiv verfolgen und verwalten.
  • Schemaentwicklung: Schemaänderungen überwachen und planen.

Knowledge Catalog ruft automatisch die folgenden Metadaten aus AlloyDB-Clustern, -Instanzen, -Datenbanken, -Tabellen, -Spalten und -Ansichten ab:

  • Name
  • Standort (Region)
  • Labels (für Cluster und Instanzen)
  • Dataplex-Integration aktiviert (für Cluster)
  • Datenbankversion
  • CPU-Anzahl der Maschine (für Instanzen)
  • Verfügbarkeitstyp (für Instanzen)
  • Zeichensatz (für Datenbanken)
  • Sortierung (für Datenbanken)
  • Inhaber
  • Beschreibung (für Tabellen, Ansichten, Spalten und Fremdschlüssel)
  • Typ (für Cluster, Instanzen und Maschinen)
  • Spalten
    • Datentyp
    • Modus
  • Primärschlüssel
  • Fremdschlüssel
    • Referenzierte Tabelle
    • Spaltenzuordnungen
  • Erstellungszeitpunkt
  • Zeitpunkt der letzten Änderung

Weitere Informationen finden Sie unter Metadatenverwaltung in Knowledge Catalog.

Arten der Metadatenerkennung

Die Metadatenerkennung von Knowledge Catalog ist ein automatisierter Prozess, bei dem verbundene Datenquellen wie AlloyDB gescannt werden, um Daten-Assets wie Tabellen, Ansichten und Datenbanken zu identifizieren. Anschließend extrahiert Knowledge Catalog technische Metadaten aus den Assets, z. B. Schemas, Beschreibungen und Standorte, in Knowledge Catalog.

Bei diesem Prozess werden Metadaten nahezu in Echtzeit synchronisiert, sodass der Katalog mit den Quellsystemen synchronisiert bleibt. Für AlloyDB werden Cluster- und Instanzmetadaten standardmäßig erkannt. Die Erkennung von Metadaten für Datenbanken, Schemas, Tabellen und Ansichten ist bei neuen Clustern standardmäßig aktiviert. Für Cluster, die vor der Implementierung dieser Standardeinstellung (26. Februar 2026) erstellt wurden, müssen Sie die Integration manuell aktivieren.

Knowledge Catalog unterstützt die Suche nach Stichwörtern und in natürlicher Sprache.

  • Mit der Keyword-Suche können Sie Ressourcen mithilfe bestimmter Keywords, Filter und einer definierten Syntax finden. Wenn Sie beispielsweise alle AlloyDB-Datenbanken aufrufen möchten, geben Sie system=AlloyDB AND type=Database ein.
  • Bei der Suche in natürlicher Sprache wird KI verwendet, um semantische Suchanfragen zu verstehen. Sie können damit Ressourcen in Alltagssprache finden, ohne komplexe Syntax verwenden zu müssen. Geben Sie beispielsweise eine Abfrage wie List all AlloyDB tables related to sales ein.

Weitere Informationen finden Sie unter Suchsyntax für Knowledge Catalog.

Beispiel: AlloyDB-Datenbankschema erkennen

Sehen Sie sich das Beispiel eines AlloyDB-Clusters mit dem Namen user-data-cluster an, für den die Knowledge Catalog-Integration aktiviert ist, um den Prozess der Metadatenerkennung zu verstehen. In der primären Instanz dieses Clusters gibt es eine Datenbank mit dem Namen profiles, die eine Tabelle customers (id, email, signup_date) und eine Ansicht active_users (id, email) enthält.

Da AlloyDB nahezu in Echtzeit mit Knowledge Catalog synchronisiert wird, sind die folgenden Ressourcen verfügbar:

  • Cluster
  • Spalten
  • Datenbanken
  • Instanzen
  • Tabellen
  • Aufrufe

Suchen Sie nach Abschluss der Erkennung auf der Knowledge Catalog-Seite der Google Cloud Console oder mithilfe der API nach diesen Assets: der Tabelle customers und active_users. Anschließend können Sie sich die Schemas ansehen und sie mit zusätzlichen geschäftlichen oder betrieblichen Metadaten anreichern.

Metadaten mit Aspekten anreichern

Aspekttypen sind wiederverwendbare Ressourcen, die als Vorlagen für Aspekte dienen. Mit Aspekttypen lassen sich doppelte Arbeit und unvollständige Aspekte vermeiden. Erstellen Sie die erforderlichen Aspekttypen mit Knowledge Catalog.

Nachdem Sie benutzerdefinierte Aspekttypen erstellt haben, hängen Sie Aspekte an Ihre AlloyDB-Assets an. Wenn Sie AlloyDB-Assets Aspekte zuweisen, haben Sie folgende Möglichkeiten:

  • 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 AlloyDB finden Sie unter Aspekte verwalten und Metadaten anreichern.

Workflow für die Metadatenerkennung

Standardmäßig werden Cluster- und Instanzressourcen aufgenommen und sind auffindbar. So nehmen Sie Datenbank-, Schema-, Tabellen- und Ansichtsressourcen auf und erkennen sie:

  1. Aktivieren Sie die Knowledge Catalog-Einbindung für Ihren AlloyDB-Cluster mit der AlloyDB API, falls sie noch nicht aktiviert ist. Dies ist für Cluster erforderlich, die vor dem 26. Februar 2026 erstellt wurden.

  2. Suchen Sie in der Google Cloud Console auf der Knowledge Catalog-Suchseite nach Ihren AlloyDB-Assets. Weitere Informationen finden Sie unter Ressourcen in Knowledge Catalog suchen.

  3. Wenn Sie Ihren AlloyDB-Assets mehr Kontext hinzufügen möchten, hängen Sie Aspekte an Ihre Assets an. Aspekte sind benutzerdefinierte Metadateneinträge, die bei der Data Governance und Analyse helfen. Verwenden Sie beispielsweise einen Aspekt, um eine Spalte mit personenidentifizierbaren Informationen zu kennzeichnen. Weitere Informationen finden Sie unter Aspekte verwalten und Metadaten anreichern.

  4. Navigieren Sie durch Ihre AlloyDB-Ressourcen. Folgen Sie dabei dieser Hierarchie: Cluster > Datenbank > Schema > Tabelle oder Ansicht > Spalte. Diese Hierarchie bietet eine detaillierte Ansicht Ihrer Datenlandschaft. Weitere Informationen finden Sie unter Ressourcen in Knowledge Catalog suchen.

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 AlloyDB-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

In diesem Abschnitt werden die Rollen und Berechtigungen beschrieben, die für die Suche nach Ressourcen und den Zugriff auf die Suchergebnisse erforderlich sind.

Erforderliche Rollen für den Zugriff auf Suchergebnisse

Um AlloyDB-Metadaten in Knowledge Catalog zu suchen und aufzurufen, benötigen Hauptkonten Berechtigungen zum Aufrufen von AlloyDB-Ressourcen, einschließlich der Berechtigung dataplex.projects.search.

Wenn Sie Hauptkonten wie Nutzern, Gruppen oder Dienstkonten diese Berechtigungen gewähren möchten, weisen Sie ihnen die IAM-Rolle AlloyDB-Betrachter (roles/alloydb.viewer) für das Projekt zu, das die AlloyDB-Ressourcen enthält.

Knowledge Catalog-Vorgang AlloyDB-Ressource Erforderliche Rollen oder Berechtigungen
Nach AlloyDB-Ressourcen suchen Cluster alloydb.clusters.get
Spalten alloydb.databases.get
Instanz alloydb.instances.get
Datenbank alloydb.databases.get
Tabellen alloydb.databases.get
Aufrufe alloydb.databases.get

Wenn Sie die vordefinierte Rolle AlloyDB Viewer nicht verwenden möchten, weisen Sie eine benutzerdefinierte Rolle zu, die die Berechtigungen alloydb.clusters.get, alloydb.instances.get und alloydb.databases.get enthält.

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten. Weitere Informationen zu AlloyDB-IAM-Rollen finden Sie unter IAM-Rollen und -Berechtigungen für AlloyDB.

Erforderliche Rollen für die Suche nach Einträgen

Sie benötigen mindestens eine der folgenden IAM-Rollen für das Projekt, das für die Suche verwendet wird:

Berechtigungen für Suchergebnisse werden unabhängig vom ausgewählten Projekt geprüft. Weitere Informationen finden Sie unter Mit Knowledge Catalog nach Daten-Assets suchen.

Datenaktualität der Knowledge Catalog-Einbindung

Standardmäßig werden in Knowledge Catalog Cluster- und Instanzressourcen aufgenommen und erkannt. Die Metadaten werden nahezu in Echtzeit aktualisiert.

Die Knowledge Catalog-Integration für Datenbank-, Schema-, Tabellen- und Ansichtsressourcen ist standardmäßig aktiviert, wenn Sie einen neuen AlloyDB-Cluster erstellen. Wenn Sie nicht möchten, dass diese Metadaten synchronisiert werden, deaktivieren Sie die Integration.

Wenn Sie die Integration aktivieren, werden AlloyDB-Metadaten wie Datenbanken, Schemas und Tabellen in Cloud Storage-Buckets für die regelmäßige Synchronisierung oder in Pub/Sub-Themen für die Synchronisierung nahezu in Echtzeit exportiert. Dadurch werden sie für Knowledge Catalog verfügbar gemacht. Diese Funktion gilt nur für primäre Cluster. Sekundäre Cluster, die für die regionenübergreifende Replikation verwendet werden, unterstützen die Knowledge Catalog-Integration für Datenbank-, Schema-, Tabellen- und Ansichtsmetadaten nicht.

Die Aktualität der Metadaten für diese Ressourcen hängt davon ab, wann der Cluster erstellt oder wiederhergestellt wurde:

  • Nahezu in Echtzeit: Cluster, die am oder nach dem 3. April 2026 erstellt oder wiederhergestellt werden, synchronisieren Metadaten nahezu in Echtzeit mit Knowledge Catalog. Aktualisierungen sind in Knowledge Catalog innerhalb von 5 Minuten verfügbar. Der Extraktionsvorgang dauert in der Regel einige Sekunden.

  • Alle paar Stunden: Bei Clustern, die zwischen dem 26. Februar 2026 und dem 3. April 2026 erstellt oder wiederhergestellt wurden, werden die Metadaten in Knowledge Catalog alle paar Stunden aktualisiert. Aktualisierungen sind in Knowledge Catalog innerhalb von 48 Stunden verfügbar. Der Extraktionsvorgang dauert in der Regel einige Minuten. Die Zeit bis zum Abschluss hängt jedoch von der CPU-Größe und der Anzahl der Tabellen ab.

AlloyDB mit deaktivierter Knowledge Catalog-Einbindung erstellen

Sie können diese Integration steuern, wenn Sie einen Cluster mit der Google Cloud CLI oder der AlloyDB API erstellen oder aktualisieren:

gcloud

Verwenden Sie den Befehl gcloud alloydb clusters create, um einen AlloyDB-Cluster zu erstellen. Wenn Sie das Flag --enable-dataplex-integration weglassen, ist die Knowledge Catalog-Integration standardmäßig für Datenbank-, Schema-, Tabellen- und Ansichtsmetadaten aktiviert. Eine vollständige Liste der Parameter für diesen Aufruf finden Sie unter gcloud alloydb clusters create. Informationen zu Clustereinstellungen finden Sie unter Cluster- und Instanzeinstellungen aufrufen.

Die Cluster-ID sollte keine vertraulichen oder personenidentifizierbaren Informationen enthalten, da sie in verschiedenen betrieblichen Kontexten sichtbar sein kann, z. B. in Systemprotokollen, Monitoring-Dashboards und Supportkommunikation. Die Projekt-ID muss im Clusternamen nicht angegeben werden. Das System fügt sie automatisch an gegebener Stelle ein, z. B. in den Logdateien.

Wenn Sie die Knowledge Catalog-Integration für Datenbank-, Schema-, Tabellen- und Ansichtsressourcen deaktivieren möchten, fügen Sie das Flag --no-enable-dataplex-integration ein:

gcloud alloydb clusters create CLUSTER_ID \
    --password=PASSWORD \
    --region=REGION \
    --no-enable-dataplex-integration

Ersetzen Sie die folgenden Werte:

  • CLUSTER_ID: Die ID des Clusters, den Sie erstellen. Die Cluster-ID muss mit einem Kleinbuchstaben beginnen und darf Kleinbuchstaben, Ziffern und Bindestriche enthalten.
  • PASSWORD: das Passwort, das Sie für den Standardnutzer postgres verwenden.
  • REGION: die ID der Region des Clusters.

REST

Verwenden Sie die Methode POST, um einen AlloyDB-Cluster zu erstellen. Wenn Sie dataplexConfig in der Anfrage weglassen, wird die Knowledge Catalog-Integration standardmäßig für Datenbank-, Schema-, Tabellen- und Ansichtsmetadaten aktiviert. Eine vollständige Liste der Parameter für diesen Aufruf finden Sie unter Methode: projects.locations.clusters.create. Informationen zu Clustereinstellungen finden Sie unter Cluster- und Instanzeinstellungen aufrufen.

Die Cluster-ID sollte keine vertraulichen oder personenidentifizierbaren Informationen enthalten, da sie in verschiedenen betrieblichen Kontexten sichtbar sein kann, z. B. in Systemprotokollen, Monitoring-Dashboards und Supportkommunikation. Die Projekt-ID muss im Clusternamen nicht angegeben werden. Das System fügt sie automatisch an gegebener Stelle ein, z. B. in den Logdateien.

Wenn Sie die Knowledge Catalog-Einbindung für Datenbank-, Schema-, Tabellen- und Ansichtsressourcen deaktivieren möchten, fügen Sie "dataplexConfig": { "enabled": false } in den Anfragetext ein:

{
  "databaseVersion": "DATABASE_VERSION",
  "initialUser": {
    "user": "INITIAL_USERNAME",
    "password": "INITIAL_USER_PASSWORD"
  },
  "labels": {
    "test": "alloydb-cluster-full"
  },
  "dataplexConfig" : {
    "enabled" : false
  }
}

Ersetzen Sie die folgenden Werte:

  • DATABASE_VERSION: Enum-String der Datenbankversion, z. B. POSTGRES_16.
  • INITIAL_USERNAME: der Nutzername, den Sie für den Postgres-Standardnutzer verwenden.
  • INITIAL_USER_PASSWORD: das Passwort, das Sie für den Standard-Postgres-Nutzer verwenden.

Verwenden Sie die folgende HTTP-Methode und URL:

POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID

Ersetzen Sie die folgenden Werte:

  • PROJECT_ID: die ID oder Projektnummer des Google Cloud -Projekts, das den Cluster enthält.
  • LOCATION_ID: die ID der Region des Clusters.
  • CLUSTER_ID: Die ID des Clusters, den Sie erstellen. Die Cluster-ID muss mit einem Kleinbuchstaben beginnen und darf Kleinbuchstaben, Ziffern und Bindestriche enthalten.

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

    curl -X POST \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d @request.json \
        "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID"

PowerShell (Windows)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID"| Select-Object -Expand Content

Sie erhalten eine JSON-Antwort ähnlich wie diese:

Antwort

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.alloydb.v1.OperationMetadata",
    "createTime": "2024-09-25T22:19:33.735Z",
    "target": "projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Knowledge Catalog-Einbindung für Ihren AlloyDB-Cluster aktivieren

Verwenden Sie eines der folgenden Verfahren, um die Knowledge Catalog-Einbindung für einen vorhandenen Cluster zu aktivieren:

gcloud

Verwenden Sie den Befehl gcloud alloydb clusters update mit dem Flag --enable-dataplex-integration, um die Knowledge Catalog-Einbindung auf einem vorhandenen Cluster zu aktivieren.

gcloud alloydb clusters update CLUSTER_ID \
    --region=REGION \
    --enable-dataplex-integration

Ersetzen Sie die folgenden Werte:

  • CLUSTER_ID ist der Name des Clusters.
  • REGION: die ID der Region des Clusters.

REST

Verwenden Sie die Methode PATCH für projects.locations.clusters resource, um bestimmte Felder eines vorhandenen Clusters zu aktualisieren.

Verwenden Sie die folgende HTTP-Methode und URL:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled

Ersetzen Sie die folgenden Werte:

  • PROJECT_ID: die ID oder Projektnummer des Google Cloud -Projekts, das den Cluster enthält.
  • LOCATION_ID: die ID der Region des Clusters.
  • CLUSTER_ID ist der Name des Clusters.

JSON-Text der Anfrage:

{
  "dataplexConfig": {
    "enabled": true
  }
}

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

    curl -X PATCH \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d @request.json \
        "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"

PowerShell (Windows)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"| Select-Object -Expand Content

Sie erhalten eine JSON-Antwort ähnlich wie diese:

Antwort

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.alloydb.v1.OperationMetadata",
    "createTime": "2024-09-25T22:19:33.735Z",
    "target": "projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Knowledge Catalog-Integration in Ihrem AlloyDB-Cluster prüfen

Verwenden Sie eines der folgenden Verfahren, um zu prüfen, ob die Knowledge Catalog-Einbindung auf einem vorhandenen Cluster aktiviert ist:

gcloud

Verwenden Sie den Befehl gcloud alloydb clusters describe, um zu prüfen, ob die Knowledge Catalog-Einbindung auf einem vorhandenen Cluster aktiviert ist.

gcloud alloydb clusters describe CLUSTER_ID --region=REGION

Ersetzen Sie die folgenden Werte:

  • CLUSTER_ID: die Cluster-ID.
  • REGION: die ID der Region des Clusters.

Die Ausgabe enthält den Abschnitt dataplexConfig im YAML-Format. Wenn enabled den Wert true hat, ist die Knowledge Catalog-Einbindung aktiviert:

dataplexConfig:
  enabled: true

REST

Verwenden Sie die Methode GET, um zu prüfen, ob die Knowledge Catalog-Einbindung auf einem vorhandenen Cluster aktiviert ist.

Verwenden Sie die folgende HTTP-Methode und URL:

GET https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID

Ersetzen Sie die folgenden Werte:

  • PROJECT_ID: die ID oder Projektnummer des Google Cloud -Projekts, das den Cluster enthält.
  • LOCATION_ID: die ID der Region des Clusters.
  • CLUSTER_ID: die Cluster-ID.

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID"

PowerShell (Windows)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content

Sie erhalten eine JSON-Antwort für das gesamte Cluster-Proto, das die dataplexConfig-Nachricht enthält:

{
  "dataplexConfig": {
    "enabled": true
  }
}

Einbindung von Knowledge Catalog in Ihren AlloyDB-Cluster deaktivieren

Wenn Sie die Einbindung von Knowledge Catalog in Ihren AlloyDB-Cluster deaktivieren, sind nur die Cluster- und Instanzmetadaten verfügbar.

gcloud

Verwenden Sie den Befehl gcloud alloydb clusters update mit dem Flag --no-enable-dataplex-integration, um die Integration zu deaktivieren.

gcloud alloydb clusters update CLUSTER_ID \
    --region=REGION \
    --no-enable-dataplex-integration

Ersetzen Sie die folgenden Werte:

  • CLUSTER_ID: die ID des Clusters.
  • REGION: die ID der Region des Clusters.

REST

Verwenden Sie das folgende Beispiel, um die Integration zu deaktivieren.

Verwenden Sie die folgende HTTP-Methode und URL:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled

Ersetzen Sie die folgenden Werte:

  • PROJECT_ID: die ID oder Projektnummer des Google Cloud -Projekts, das den Cluster enthält.
  • LOCATION_ID: die ID der Region des Clusters.
  • CLUSTER_ID: die Cluster-ID.

JSON-Text der Anfrage:

{
  "dataplexConfig": {
    "enabled": false
  }
}

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

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"

PowerShell (Windows)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"| Select-Object -Expand Content

Sie erhalten eine JSON-Antwort ähnlich wie diese:

Antwort

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.alloydb.v1.OperationMetadata",
    "createTime": "2024-01-16T02:32:12.281Z",
    "target": "projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

AlloyDB-Assets mit Aspekten anreichern

Aspekttypen sind wiederverwendbare Ressourcen, die als Vorlagen für Aspekte dienen. Mit Aspekttypen lassen sich doppelte Arbeit und unvollständige Aspekte vermeiden. Erstellen Sie die erforderlichen Aspekttypen mit Knowledge Catalog.

Nachdem Sie benutzerdefinierte Aspekttypen erstellt haben, hängen Sie Aspekte an Ihre AlloyDB-Assets an. Das Anhängen von Aspekten an AlloyDB-Assets bietet die folgenden Funktionen:

  • 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 AlloyDB finden Sie unter Aspekte verwalten und Metadaten anreichern.

Nach AlloyDB-Assets suchen

Verwenden Sie die Knowledge Catalog-Suchseite in der Google Cloud Console, um nach AlloyDB-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 AlloyDB aus.

  4. Optional. Filtern Sie die Suchergebnisse unter Typ-Aliasse nach einem bestimmten AlloyDB-Asset-Typ, indem Sie einen oder mehrere der folgenden Typ-Aliasse auswählen:

    • Datenbank
    • Datenbankschema
    • Cluster
    • Instanz
    • Dienst
    • Tabelle
    • Ansehen

Verwenden Sie das Suchfeld im Knowledge Catalog, um Suchanfragen mit Suchbegriffen auszuführen. Geben Sie beispielsweise system=AlloyDB AND type=Database ein, um alle AlloyDB-Datenbanken aufzurufen.

Weitere Informationen finden Sie unter Suchsyntax für Knowledge Catalog.

Geben Sie system=AlloyDB ein, um alle AlloyDB-Assets aufzurufen.

Geben Sie dann bestimmte Keywords ein. So rufen Sie beispielsweise alle AlloyDB-Datenbanken auf:

system=AlloyDB AND type=Database

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

system=AlloyDB 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 AlloyDB-Assets direkt in das Suchfeld eingeben. Der Abfragestring hat folgendes Format:

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

Ersetzen Sie Folgendes:

  • QUERY_STRING: Verwenden Sie die folgende Liste, um einen Abfragestring basierend auf dem Typ des AlloyDB-Assets zu identifizieren, das Sie abfragen möchten:

    • alloydb-database
    • alloydb-cluster
    • alloydb-instance
    • alloydb-table
    • alloydb-schema
    • alloydb-view

Eine Beispielabfrage könnte etwa so aussehen:

type="projects/dataplex-types/locations/global/entryTypes/alloydb-cluster"

Nach Aspekttyp suchen

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

So suchen Sie nach Aspekttyp:

  1. Klicken Sie im Bereich Aspekte auf das Menü Weitere Aspekttypen hinzufügen.
  2. Optional. Wählen Sie AlloyDB-Zugriff aus, um die Ergebnisse nach AlloyDB-Dialekt zu filtern.
  3. Wählen Sie einen oder mehrere der folgenden Aspekttypen aus, um die Suchergebnisse auf diesen Typ zu beschränken.
    • AlloyDB-Datenbank
    • AlloyDB-Cluster
    • AlloyDB-Instanz
    • AlloyDB View
    • AlloyDB-Schema
    • AlloyDB-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, Ihre Assets zu optimieren oder anzusehen:
    • Wenn Sie eine Rich-Text-Beschreibung des Assets hinzufügen möchten, klicken Sie unter Übersicht auf Hinzufügen.
    • Wenn Sie dem Asset einen Aspekt hinzufügen möchten, klicken Sie unter Aspekte auf Hinzufügen.
    • Wenn Sie die Mitgliedsdatenbanken für eine Instanz 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, enthält der Cluster keine Datenbanken.
    • Unter Details zum Eintrag sehen Sie alle Details des Assets. Klicken Sie auf den Namen des Eintrags, um weitere Einträge aufzurufen.

Suche in natürlicher Sprache in AlloyDB

Bei der Suche in natürlicher Sprache wird KI verwendet, um semantische Suchanfragen zu verstehen. Sie können damit Ressourcen in natürlicher Sprache finden, ohne komplexe Syntax verwenden zu müssen. Geben Sie beispielsweise Abfragen wie List all AlloyDB tables related to sales ein.

Weitere Informationen finden Sie unter Suchsyntax für Knowledge Catalog.

Syntaxsuche in AlloyDB

Mit der Keyword-Suche können Sie Ressourcen mithilfe bestimmter Keywords, Filter und einer definierten Syntax finden. Geben Sie beispielsweise system=AlloyDB AND type=Database ein, um alle AlloyDB-Datenbanken aufzurufen.

Weitere Informationen finden Sie unter Suchsyntax für Knowledge Catalog.

Beispielworkflow – Aufschlüsselung von Cluster zu Spalten

So schlüsseln Sie die Daten von Clustern zu Spalten 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 AlloyDB aus. Alternativ können Sie system=AlloyDB in das Suchfeld eingeben.

  4. Wählen Sie einen Clusternamen aus.

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

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

  7. Wählen Sie einen Tabellennamen aus und klicken Sie dann auf der Seite AlloyDB-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.

Preise

Für das Speichern technischer AlloyDB-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

Knowledge Catalog extrahiert regelmäßig Metadaten aus Ihren AlloyDB-Clustern. Dieser Extraktionsprozess verbraucht CPU-Ressourcen in Ihrem Cluster. Die CPU-Auslastung ist im Allgemeinen minimal. Beispielsweise kann bei Clustern mit kleineren Maschinentypen (z. B. n2-highmem-2-icelake), die große Schemas (z. B. mit 100.000 oder mehr Tabellen) verwalten,die CPU-Auslastung während der Extraktion um bis zu 5 % steigen.

Beschränkungen

  • Die Integration unterstützt maximal eine Million Tabellen pro Datenbank und durchschnittlich 150 Spalten pro Tabelle. Wenn eines dieser Limits überschritten wird, werden Metadaten für Ressourcen wie Datenbanken, Schemas, Tabellen und Ansichten nicht extrahiert. In Knowledge Catalog sind nur Cluster- und Instanzmetadaten verfügbar.
  • Wenn ein Cluster zum ersten Mal erstellt wird, kann die erste Synchronisierung aller Metadaten mit Knowledge Catalog bis zu 48 Stunden dauern. Nach der ersten Synchronisierung sind nachfolgende Aktualisierungen nahezu in Echtzeit verfügbar.
  • Wenn in Ihrer Datenbank eine hohe Rate an Metadatenänderungen (über 100 DDL-Änderungen pro Sekunde) auftritt, wird die Metadatensynchronisierung nahezu in Echtzeit mit Knowledge Catalog möglicherweise bis zu 30 Minuten lang pausiert, bevor sie fortgesetzt wird.
  • Wenn ein Update aufgrund einer hohen Rate von Metadatenänderungen, Netzwerkproblemen oder einer Unterbrechung des Synchronisierungsprozesses verpasst wird, wird es innerhalb von 48 Stunden in Knowledge Catalog sichtbar.
  • Wenn eine Instanz nicht vorhanden ist oder nicht ausgeführt wird, kann es sieben Tage dauern, bis die Metadaten gelöscht werden.
  • 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 innerhalb von 48 Stunden in Knowledge Catalog aktualisiert.

Nächste Schritte