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. Knowledge Catalog ist eine Plattform, auf der Sie Metadaten speichern, verwalten und darauf zugreifen können. Mit dieser Integration können Sie Ihre AlloyDB-Metadaten ermitteln und nachvollziehen. Sie unterstützt die folgenden Anwendungsfälle:

Analyse:Abhängigkeiten nachvollziehen und Eignung für verschiedene Anwendungsfälle bewerten.
Change Management:Metadatenänderungen effektiv nachverfolgen und verwalten.
Schemaentwicklung:Schemaänderungen beobachten 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
Anzahl der CPUs 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
Letzte Änderung

Arten der Metadatenerkennung

Die Metadatenermittlung in 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 werden technische Metadaten wie Schemas, Beschreibungen und Standorte aus den Assets in Knowledge Catalog extrahiert.

Bei diesem Prozess werden Metadaten nahezu in Echtzeit synchronisiert, sodass der Katalog mit den Quellsystemen synchronisiert bleibt. Bei AlloyDB werden Cluster- und Instanzmetadaten standardmäßig erkannt. Die Erkennung von Datenbank-, Schema-, Tabellen- und Ansichtsmetadaten ist in 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.

Keyword- und Suche in natürlicher Sprache

Der Wissenskatalog unterstützt Stichwort- und Suchanfragen 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 (Vorabversion) wird KI verwendet, um semantische Anfragen zu verstehen. Sie können Ressourcen in Alltagssprache suchen, ohne dass eine komplexe Syntax erforderlich ist. Geben Sie beispielsweise eine Anfrage wie List all AlloyDB tables related to sales ein.

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

Beispiel: AlloyDB-Datenbankschema ermitteln

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

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

Cluster
Spalten
Datenbanken
Instanzen
Tabellen
Aufrufe

Nach Abschluss der Erkennung können Sie auf der Seite „Knowledge Catalog“ der Google Cloud -Konsole oder über die API nach diesen Assets suchen: customers-Tabelle und active_users. Anschließend können Sie sich die Schemas ansehen und mit zusätzlichen geschäftlichen oder betrieblichen Metadaten anreichern.

Metadaten mit Aspekten anreichern

Aspekttypen sind wiederverwendbare Ressourcen, die als Vorlagen für Aspekte dienen. Aspekttypen helfen, doppelte Arbeit und unvollständige Aspekte zu 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 zur Metadatenerkennung

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

Aktivieren Sie die Knowledge Catalog-Integration 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.
Suchen Sie in der Google Cloud Console auf der Knowledge Catalog-Suchseite nach Ihren AlloyDB-Assets. Weitere Informationen finden Sie unter Nach Ressourcen im Knowledge Catalog suchen.
Wenn Sie Ihren AlloyDB-Assets mehr Kontext hinzufügen möchten, können Sie Aspekte daran anhängen. Aspekte sind benutzerdefinierte Metadateneinträge, die bei der Data Governance und Analyse helfen. Sie können beispielsweise einen Aspekt verwenden, um eine Spalte mit personenidentifizierbaren Informationen zu kennzeichnen. Weitere Informationen finden Sie unter Aspekte verwalten und Metadaten anreichern.
Navigieren Sie anhand dieser Hierarchie durch Ihre AlloyDB-Ressourcen: Cluster > Datenbank > Schema > Tabelle oder Ansicht > Spalte. Diese Hierarchie bietet eine detaillierte Ansicht Ihrer Datenlandschaft. Weitere Informationen finden Sie unter Nach Ressourcen im Knowledge Catalog suchen.

Hinweis

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.

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

Verify that billing is enabled for your Google Cloud project.

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

Verify that billing is enabled for your Google Cloud project.

Aktivieren Sie die Dataplex API für das Projekt.

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

Erforderliche IAM-Rollen

In diesem Abschnitt werden die Rollen und Berechtigungen beschrieben, die zum Suchen nach Ressourcen und zum Zugreifen auf die Suchergebnisse erforderlich sind.

Erforderliche Rollen für den Zugriff auf Suchergebnisse

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

Weisen Sie Hauptkonten wie Nutzern, Gruppen oder Dienstkonten die IAM-Rolle AlloyDB Viewer (roles/alloydb.viewer) für das Projekt zu, das die AlloyDB-Ressourcen enthält, um ihnen diese Berechtigungen zu erteilen.

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 mit den Berechtigungen alloydb.clusters.get, alloydb.instances.get und alloydb.databases.get zu.

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:

Dataplex Catalog Admin (roles/dataplex.catalogAdmin)
Dataplex Catalog Editor (roles/dataplex.catalogEditor)
Dataplex Catalog Viewer (roles/dataplex.catalogViewer)

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

Datenaktualität bei der Knowledge Catalog-Einbindung

Standardmäßig werden Cluster- und Instanzressourcen sowie deren Metadaten von Knowledge Catalog aufgenommen und ermittelt. Die Aktualität der Metadaten ist nahezu in Echtzeit.

Die Knowledge Catalog-Integration für Datenbank-, Schema-, Tabellen- und Ansichtsressourcen ist standardmäßig aktiviert, wenn Sie einen neuen AlloyDB-Cluster erstellen. Wenn Sie verhindern 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 und sind so für Knowledge Catalog verfügbar. Diese Funktion gilt nur für primäre Cluster. Sekundäre Cluster, die für die regionsübergreifende Replikation verwendet werden, unterstützen keine Knowledge Catalog-Integration für Datenbank-, Schema-, Tabellen- und Ansichtsmetadaten.

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

Nahezu in Echtzeit:Bei Clustern, die am oder nach dem 3. April 2026 erstellt oder wiederhergestellt wurden, werden Metadaten nahezu in Echtzeit mit dem Knowledge Catalog synchronisiert. Updates sind innerhalb von 5 Minuten im Wissenskatalog verfügbar. Die Extraktion dauert in der Regel nur wenige Sekunden.
Alle paar Stunden:Bei Clustern, die zwischen dem 26. Februar 2026 und dem 3. April 2026 erstellt oder wiederhergestellt wurden, werden die Metadaten im Knowledge Catalog alle paar Stunden aktualisiert. Aktualisierungen sind innerhalb von 48 Stunden im Knowledge Catalog verfügbar. Der Extraktionsvorgang dauert in der Regel einige Minuten. Die Dauer hängt jedoch von der CPU-Größe und der Anzahl der Tabellen ab.

AlloyDB-Instanz erstellen, bei der die Knowledge Catalog-Einbindung deaktiviert ist

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 aktiviert für Datenbank-, Schema-, Tabellen- und Ansichtsmetadaten. 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 Informationen oder personenidentifizierbaren Informationen enthalten, da sie in verschiedenen betrieblichen Kontexten sichtbar sein kann, z. B. in Systemlogs, Monitoring-Dashboards und Supportkommunikation. Die Projekt-ID muss im Clusternamen nicht angegeben werden. Das System fügt diese Informationen bei Bedarf automatisch 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 die dataplexConfig aus 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.

Wenn Sie die Knowledge Catalog-Integration für Datenbank-, Schema-, Tabellen- und Ansichtsressourcen deaktivieren möchten, fügen Sie "dataplexConfig": { "enabled": false } in den Anfragebody 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 Standard-Postgres-Nutzer 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, verwenden 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 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 der folgenden:

Antwort

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

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

Verwenden Sie eines der folgenden Verfahren, um die Knowledge Catalog-Einbindung in einem vorhandenen Cluster zu aktivieren:

gcloud

Verwenden Sie den Befehl gcloud alloydb clusters update mit dem Flag --enable-dataplex-integration, um die Knowledge Catalog-Einbindung für einen 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

Wenn Sie bestimmte Felder eines vorhandenen Clusters aktualisieren möchten, verwenden Sie die Methode PATCH für projects.locations.clusters resource.

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, verwenden 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 der folgenden:

Antwort

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

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

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

gcloud

Verwenden Sie den Befehl gcloud alloydb clusters describe, um zu prüfen, ob die Knowledge Catalog-Einbindung in 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 gleich true ist, ist die Knowledge Catalog-Einbindung aktiviert:

dataplexConfig:
  enabled: true

REST

Verwenden Sie die Methode GET, um zu prüfen, ob die Knowledge Catalog-Einbindung in 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, verwenden 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 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, einschließlich der dataplexConfig-Nachricht:

{
  "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

In diesem Beispiel können Sie die Einbindung 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 der folgenden:

Antwort

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

AlloyDB-Assets mit Aspekten anreichern

Nachdem Sie benutzerdefinierte Aspekttypen erstellt haben, weisen Sie Ihren AlloyDB-Assets Aspekte zu. Wenn Sie AlloyDB-Assets Aspekte zuweisen, 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 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.

Rufen Sie die Seite Suche im Knowledge Catalog auf.

Zur Suche
Wählen Sie unter Suchplattform auswählen die Option Knowledge Catalog aus.
Klicken Sie im Bereich Filter auf Systeme und wählen Sie dann AlloyDB aus.
Optional. Filtern Sie die Suchergebnisse in Type aliases (Typ-Aliase) nach einem bestimmten AlloyDB-Asset-Typ, indem Sie einen oder mehrere der folgenden Typ-Aliase auswählen:
- Datenbank
- Datenbankschema
- Cluster
- Instanz
- Dienst
- Tabelle
- Ansehen
Hinweis : „Service“ ist ein Typalias für eine AlloyDB-Instanz.

Suchen über Anfragen ausführen

Verwenden Sie das Suchfeld im Knowledge Catalog, um Suchbegriffe einzugeben. 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 die gewünschten Keywords ein. So rufen Sie beispielsweise alle AlloyDB-Datenbanken auf:

system=AlloyDB AND type=Database

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

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 direkt Suchanfragen für bestimmte AlloyDB-Assets 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/1234567890/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:

Klicken Sie im Bereich Aspekte auf das Menü Weitere Aspekttypen hinzufügen.
Optional. Wählen Sie AlloyDB Access aus, um die Ergebnisse nach AlloyDB-Dialekt zu filtern.
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-Ansicht
- AlloyDB-Schema
- AlloyDB-Tabelle
Klicken Sie auf OK.
Klicken Sie in der Ergebnistabelle auf den Namen des Assets, um die Metadaten für dieses Asset aufzurufen.
Optional: Sie können Ihre 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 (Vorabversion) wird KI verwendet, um semantische Anfragen zu verstehen. Sie können Ressourcen in Alltagssprache suchen, ohne dass Sie eine komplexe Syntax benötigen. Geben Sie beispielsweise Anfragen 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 – Cluster in Spalten aufschlüsseln

So führen Sie einen Drilldown von Clustern zu Spalten durch:

Rufen Sie die Seite Suche im Knowledge Catalog auf.

Zur Suche
Wählen Sie für die Option Suchplattform auswählen die Option Knowledge Catalog aus.
Wählen Sie im Bereich Filter die Option Systeme und dann AlloyDB aus. Alternativ können Sie system=AlloyDB in das Suchfeld eingeben.
Wählen Sie einen Clusternamen aus.
Klicken Sie auf der Seite AlloyDB-Details auf den Tab Eintragsliste und dann auf Alle untergeordneten Einträge in der Suche anzeigen. Im Knowledge Catalog werden die Datenbanken im Cluster angezeigt.

Hinweis :Wenn der Tab Eintragsliste nicht angezeigt wird, kehren Sie zur Seite Suche zurück und wählen Sie einen anderen Cluster aus.
Klicken Sie auf der Seite AlloyDB-Datenbankdetails auf den Tab Eintragsliste und dann auf Untergeordnete Einträge in der Suche ansehen. Im Knowledge Catalog werden die Tabellen im Cluster angezeigt.
Wählen Sie einen Tabellennamen aus und klicken Sie dann auf der Seite AlloyDB-Tabellendetails auf Schema, um die Tabellenspalten aufzurufen.
Optional: Wenn Sie einer Spalte einen Aspekttyp hinzufügen möchten, klicken Sie auf die Schaltfläche Aspekt hinzufügen.

Preise

Für das Speichern technischer AlloyDB-Metadaten in Knowledge Catalog fallen keine Gebühren an. Für API-Aufrufe und die Anreicherung zusätzlicher Unternehmensmetadaten gelten die Standardpreise für Knowledge Catalog. Weitere Informationen finden Sie auf der Preisseite für den Knowledge Catalog.

Ressourcennutzung

Knowledge Catalog extrahiert regelmäßig Metadaten aus Ihren AlloyDB-Clustern. Bei diesem Extraktionsvorgang werden CPU-Ressourcen in Ihrem Cluster verbraucht. Die CPU-Auslastung ist in der Regel minimal. Bei Clustern mit kleineren Maschinentypen (z. B. n2-highmem-2-icelake), die große Schemas (z. B. mit 100.000 oder mehr Tabellen) verwalten,kann 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. Wird eines dieser Limits überschritten, werden keine Metadaten für Ressourcen wie Datenbanken, Schemas, Tabellen und Ansichten extrahiert. Im 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.
Bei einer hohen Rate an Metadatenänderungen (über 100 DDL-Änderungen pro Sekunde) in Ihrer Datenbank kann die nahezu in Echtzeit erfolgende Metadatensynchronisierung mit dem Knowledge Catalog für bis zu 30 Minuten pausieren, bevor sie fortgesetzt wird.
Falls aufgrund einer hohen Anzahl von Metadatenänderungen, Netzwerkproblemen oder einer Unterbrechung des Synchronisierungsvorgangs ein Update nicht erfolgt, werden die Änderungen innerhalb von 48 Stunden im Wissenskatalog sichtbar.
Wenn eine Instanz nicht vorhanden ist oder nicht ausgeführt wird, kann es bis zu 7 Tage dauern, bis Metadaten gelöscht werden.
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 innerhalb von 48 Stunden im Knowledge Catalog aktualisiert.

AlloyDB-Ressourcen mit Knowledge Catalog verwalten Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Arten der Metadatenerkennung

Keyword- und Suche in natürlicher Sprache

Beispiel: AlloyDB-Datenbankschema ermitteln

Metadaten mit Aspekten anreichern

Workflow zur Metadatenerkennung

Hinweis

Erforderliche IAM-Rollen

Erforderliche Rollen für den Zugriff auf Suchergebnisse

Erforderliche Rollen für die Suche nach Einträgen

Datenaktualität bei der Knowledge Catalog-Einbindung

AlloyDB-Instanz erstellen, bei der die Knowledge Catalog-Einbindung deaktiviert ist

gcloud

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

Antwort

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

gcloud

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

Antwort

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

gcloud

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

Einbindung von Knowledge Catalog in Ihren AlloyDB-Cluster deaktivieren

gcloud

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

Antwort

AlloyDB-Assets mit Aspekten anreichern

Nach AlloyDB-Assets suchen

Suchen über Anfragen ausführen

Nach Aspekttyp suchen

Suche in natürlicher Sprache in AlloyDB

Syntaxsuche in AlloyDB

Beispielworkflow – Cluster in Spalten aufschlüsseln

Preise

Ressourcennutzung

Beschränkungen

Nächste Schritte

AlloyDB-Ressourcen mit Knowledge Catalog verwalten