AlloyDB-Ressourcen mit Dataplex Universal Catalog verwalten

Sie können mit Dataplex Universal Catalog, einer Plattform zum Speichern, Verwalten und Aufrufen Ihrer Metadaten, nach Ihren AlloyDB for PostgreSQL-Ressourcen suchen und diese verwalten. Mit Dataplex Universal Catalog können Sie Ihre AlloyDB-Metadaten ermitteln und analysieren. Dataplex Universal Catalog kann Ihnen bei Folgendem helfen:

  • Analyse, einschließlich Abhängigkeiten und Eignung für einen Anwendungsfall
  • Änderungsmanagement
  • Schema-Evolution

Dataplex Universal Catalog ruft automatisch die folgenden Metadaten aus AlloyDB ab:

Ressourcentyp Abgerufene Metadaten
Cluster, Datenbanken und Instanzen
  • Name
  • Standort (Region)
Schema, Spalten, Tabellen, Ansichten
  • Name
  • Standort (Region)
  • Beschreibung
  • Schema

Arten der Metadatenerkennung

Die Metadatenerkennung im Kontext von Dataplex Universal Catalog ist der automatisierte Prozess, bei dem Dataplex Universal Catalog verbundene Datenquellen wie AlloyDB scannt, um Daten-Assets wie Tabellen, Ansichten und Datenbanken zu identifizieren und ihre technischen Metadaten wie Schemas, Beschreibungen und Speicherorte in den Katalog zu extrahieren.

Dieser Prozess wird regelmäßig ausgeführt, um den Katalog mit den Quellsystemen zu synchronisieren. Bei AlloyDB werden Cluster- und Instanzmetadaten standardmäßig erkannt, während Datenbank-, Schema-, Tabellen- und Ansichtsmetadaten nur erkannt werden, wenn Sie die Integration im Cluster aktivieren.

Dataplex Universal Catalog unterstützt die Suche mit Schlüsselwö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 system=AlloyDB AND type=Database eingeben, werden alle AlloyDB-Datenbanken angezeigt.
  • Bei der Suche in natürlicher Sprache (Vorabversion) wird KI verwendet, um semantische Anfragen zu verstehen. Sie können Ressourcen in Alltagssprache finden, ohne dass eine komplexe Syntax erforderlich ist. Sie können beispielsweise Abfragen wie List all AlloyDB tables related to sales eingeben.

Weitere Informationen finden Sie unter Suchsyntax für Dataplex Universal Catalog.

Beispiel: AlloyDB-Datenbankschema ermitteln

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

AlloyDB wird regelmäßig mit Dataplex Universal Catalog synchronisiert. Die folgenden Ressourcen sind verfügbar:

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

Nach Abschluss der Ermittlung können Sie auf der Seite „Dataplex Universal Catalog“ der Google Cloud Console oder über die API nach diesen Assets (customers-Tabelle und active_users) suchen, ihre Schemas ansehen und sie mit zusätzlichen geschäftlichen oder betrieblichen Metadaten anreichern.

Metadaten 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 Dataplex Universal Catalog können Sie die benötigten Aspekttypen erstellen.

Nachdem Sie benutzerdefinierte Aspekttypen erstellt haben, können Sie Ihren AlloyDB-Assets Aspekte zuweisen. 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.

Workflow für die Metadatenerkennung

Standardmäßig werden Cluster- und Instanzressourcen aufgenommen und sind auffindbar. Sie müssen die Dataplex Universal Catalog-Integration für Ihren AlloyDB-Cluster nur aktivieren, wenn Sie Datenbank-, Schema-, Tabellen- und Ansichtsressourcen aufnehmen und ermitteln möchten.

  1. Wenn Sie AlloyDB-Datenbank-, Schema-, Tabellen- und Ansichtsressourcen ermitteln möchten, müssen Sie die Dataplex Universal Catalog-Integration für Ihren AlloyDB-Cluster über die AlloyDB API aktivieren, wenn Sie einen neuen Cluster erstellen oder einen vorhandenen Cluster aktualisieren. Weitere Informationen finden Sie unter Cluster und primäre Instanz erstellen.

  2. Suchen Sie mit der Dataplex Universal Catalog-Suchseite in der Google Cloud Console nach Ihren AlloyDB-Assets. Weitere Informationen finden Sie unter Nach Ressourcen in Dataplex Universal Catalog suchen.

  3. Sie können Ihren AlloyDB-Assets Aspekte hinzufügen, um ihnen mehr Kontext zu geben. Aspekte sind benutzerdefinierte Metadateneinträge, die bei der Data Governance und Analyse helfen. Sie können beispielsweise einen Aspekt verwenden, um eine Spalte zu kennzeichnen, die personenidentifizierbare Informationen enthält. Weitere Informationen finden Sie unter Aspekte verwalten und Metadaten anreichern.

  4. Sie können jetzt in dieser Hierarchie durch Ihre AlloyDB-Ressourcen navigieren: Cluster > Datenbank > Schema > Tabelle oder Ansicht > Spalte. So erhalten Sie einen detaillierten Überblick über Ihre Datenlandschaft. Weitere Informationen finden Sie unter Nach Ressourcen im Dataplex Universal Catalog suchen.

Hinweise

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  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 AlloyDB-Assets zu suchen und an sie anzuhängen. Weitere Informationen finden Sie unter Erforderliche IAM-Rollen und -Berechtigungen für Dataplex Universal Catalog.

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

    Wenn Sie im Dataplex Universal Catalog nach AlloyDB-Metadaten suchen und diese aufrufen möchten, müssen Principals die Berechtigung zum Aufrufen von AlloyDB-Ressourcen haben, 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.

    Dataplex Universal 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, können Sie eine benutzerdefinierte Rolle zuweisen, 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

    Wenn Sie nach Einträgen suchen möchten, benötigen Sie 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 Dataplex Universal Catalog nach Datenassets suchen.

    Einbindung von Dataplex Universal Catalog in Ihren AlloyDB-Cluster aktivieren

    Standardmäßig werden Cluster- und Instanzressourcen aufgenommen und sind auffindbar. Sie müssen die Dataplex Universal Catalog-Integration für Ihren AlloyDB-Cluster nur aktivieren, wenn Sie Datenbank-, Schema-, Tabellen- und Ansichtsressourcen aufnehmen und ermitteln möchten.

    Wenn Sie Ihre Datenbank-, Schema-, Tabellen- und Ansichtsressourcen aufnehmen und auffindbar machen möchten, erstellen oder aktualisieren Sie den Cluster mit der AlloyDB API. Wenn Sie diese Integration aktivieren, werden Datenbank-, Schema-, Tabellen- und Ansichtsressourcen der Datenebene synchronisiert.

    Für die Integration in Dataplex Universal Catalog verwenden Sie das Flag dataplexConfig auf Clusterebene. Wenn Sie Daten für sekundäre Cluster aufrufen möchten, müssen Sie dieses Flag separat aktivieren. Wenn Sie den Export von AlloyDB-Metadaten wie Datenbanken, Schemas und Tabellen in Cloud Storage-Buckets aktivieren möchten, legen Sie enabled auf true fest. Diese Daten können dann von Dataplex Universal Catalog verwendet werden. Diese Funktion gilt nur für primäre Instanzen.

    Dataplex Universal Catalog-Integration beim Erstellen eines Clusters aktivieren

    Wenn Sie einen AlloyDB-Cluster mit aktivierter Dataplex Universal Catalog-Integration erstellen möchten, verwenden Sie die Methode POST und die folgende URL. 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 personenbezogenen Informationen enthalten, da sie extern sichtbar ist. Die Projekt-ID muss im Clusternamen nicht angegeben werden. Dies erfolgt automatisch, wo es erforderlich ist, beispielsweise in den Logdateien.

    Speichern Sie den Anfragetext in einer Datei mit dem Namen cluster_request.json, um die Anfrage zu senden:

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

    Ersetzen Sie die folgenden Werte:

    • DATABASE_VERSION: Enum-String der Datenbankversion, z. B. POSTGRES_16.
    • INITIAL_USERNAME: Der Nutzername, den Sie für den standardmäßigen 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.

    Verwenden Sie eine der folgenden Optionen, um die Anfrage zu senden:

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

    Dataplex Universal Catalog-Integration für Ihren AlloyDB-Cluster aktivieren

    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/clusters/CLUSTER_ID

    Ersetzen Sie die folgenden Werte:

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

    JSON-Text der Anfrage:

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

    Verwenden Sie eine der folgenden Optionen, um die Anfrage zu senden:

    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/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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/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": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "CLUSTER_ID",
  "selfLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

    Dataplex Universal Catalog-Integration in Ihrem AlloyDB-Cluster überprüfen

    Verwenden Sie die Methode GET, um zu prüfen, ob die Dataplex Universal 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/clusters/CLUSTER_ID

    Ersetzen Sie die folgenden Werte:

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

    Verwenden Sie eine der folgenden Optionen, um die Anfrage zu senden:

    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/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/clusters/CLUSTER_ID"| Select-Object -Expand Content

    Sie erhalten eine JSON-Antwort für das gesamte Cluster-Proto. Suchen Sie im Proto nach der Nachricht dataplexConfig:

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

    Einbindung von Dataplex Universal Catalog in Ihren AlloyDB-Cluster deaktivieren

    In diesem Beispiel können Sie die Einbindung deaktivieren. Wenn Sie dieses Feature deaktivieren, sind nur die Cluster- und Instanzmetadaten verfügbar.

    Verwenden Sie die folgende HTTP-Methode und URL:

    PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID

    Ersetzen Sie die folgenden Werte:

    • PROJECT_ID: die ID oder Projektnummer des Google Cloud -Projekts, das den Cluster enthält.
    • 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/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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/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-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

    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 Dataplex Universal Catalog können Sie die benötigten Aspekttypen erstellen.

    Nachdem Sie benutzerdefinierte Aspekttypen erstellt haben, können Sie Ihren AlloyDB-Assets Aspekte zuweisen. 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 Dataplex Universal Catalog-Suchseite in der Google Cloud Console, um nach AlloyDB-Assets zu suchen.

    1. Rufen Sie die Seite Suche im Dataplex Universal Catalog auf.

      Zur Suche

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

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

    4. Optional. Unter Type aliases (Typ-Aliase) können Sie die Suchergebnisse nach einem bestimmten Typ von AlloyDB-Asset filtern, indem Sie einen oder mehrere der folgenden Typ-Aliase auswählen:

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

    Sie können das Suchfeld in Dataplex Universal Catalog verwenden, um Keyword-Suchanfragen auszuführen. Wenn Sie beispielsweise system=AlloyDB AND type=Database eingeben, werden alle AlloyDB-Datenbanken angezeigt.

    Weitere Informationen finden Sie unter Suchsyntax für Dataplex Universal Catalog.

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

    Anschließend können Sie bestimmte Keywords eingeben. 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 Dataplex Universal 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/1234567890/locations/global/entryTypes/alloydb-cluster"

    Nach Aspekttyp suchen

    Dataplex Universal 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 Access 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-Ansicht
      • 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:
      • 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. Damit können Sie Ressourcen in Alltagssprache finden, ohne dass eine komplexe Syntax erforderlich ist. Sie können beispielsweise Abfragen wie List all AlloyDB tables related to sales eingeben.

    Weitere Informationen finden Sie unter Suchsyntax für Dataplex Universal Catalog.

    Syntaxsuche in AlloyDB

    Mit der Keyword-Suche können Sie Ressourcen mithilfe bestimmter Keywords, Filter und einer definierten Syntax finden. Wenn Sie beispielsweise system=AlloyDB AND type=Database eingeben, werden alle AlloyDB-Datenbanken angezeigt.

    Weitere Informationen finden Sie unter Suchsyntax für Dataplex Universal Catalog.

    Beispielworkflow – Cluster in Spalten aufschlüsseln

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

    1. Rufen Sie die Seite Suche im Dataplex Universal Catalog auf.

      Zur Suche

    2. Wählen Sie für die Option Suchplattform auswählen die Option Dataplex Universal 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. Im Dataplex Universal Catalog werden die Datenbanken im Cluster angezeigt.

    6. Klicken Sie auf der Seite AlloyDB-Datenbankdetails auf den Tab Eintragsliste und dann auf Untergeordnete Einträge in der Suche ansehen. In Dataplex Universal Catalog werden die Tabellen im Cluster angezeigt.

    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 die Schaltfläche Aspekt hinzufügen.

    Preise

    Für das Speichern technischer AlloyDB-Metadaten in Dataplex Universal Catalog fallen keine Gebühren an. Für API-Aufrufe und die zusätzliche Anreicherung von Geschäftsmetadaten gelten die Standardpreise für Dataplex Universal Catalog. Weitere Informationen finden Sie auf der Preisseite für Dataplex Universal Catalog.

    Ressourcennutzung

    Dataplex Universal Catalog extrahiert regelmäßig Daten aus Ihren Clustern. Für die Extraktion ist eine bestimmte CPU-Auslastung erforderlich. Cluster mit kleineren Maschinentypen, z. B. Maschinen, die größere Schemas (10.000 oder mehr Tabellen) gemeinsam nutzen, können während des Extraktionsprozesses einen kleinen Teil ihrer CPU nutzen.

    Beschränkungen

    • Pro Datenbank sind maximal eine Million Tabellen zulässig.
    • Es kann bis zu 48 Stunden dauern, bis Aktualisierungen Ihrer Datenbank in Dataplex Universal Catalog angezeigt werden.
    • Der Extraktionsvorgang dauert in der Regel einige Minuten. Die Dauer hängt jedoch von der CPU-Größe und der Anzahl der Tabellen ab.
    • Wenn eine Instanz nicht vorhanden ist oder nicht ausgeführt wird, kann es bis zu 7 Tage dauern, bis Metadaten gelöscht werden.

    Nächste Schritte