Cloud SQL-Ressourcen mit Dataplex Catalog verwalten

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

Dataplex Catalog ist eine Plattform zum Speichern, Verwalten und Zugreifen auf Ihre Metadaten. Nachdem Sie die Dataplex Catalog-Einbindung für Ihre Cloud SQL-Instanz aktiviert haben, ruft Dataplex Catalog automatisch die folgenden Metadaten aus Cloud SQL-Instanzen, Datenbanken, Tabellen, Spalten und Ansichten ab:

  • Name
  • Standort (Region)
  • Erstellungsdatum und Datum der letzten Änderung
  • Schema (für Tabellen und Ansichten)
  • Beschreibung

Dataplex Catalog ruft Metadaten nur aus primären Cloud SQL-Instanzen, nicht aus Lesereplikaten ab.

Mit Dataplex Catalog können Sie Ihre Cloud SQL-Metadaten ermitteln und verstehen. Verwenden Sie Dataplex Catalog, um Sie bei den folgenden Aktivitäten zu unterstützen:

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

Mit Dataplex Catalog können Sie Metadaten auswählen, indem Sie Aspekte an Cloud SQL-Metadateneinträge anhängen. Jeder Aspekt kann mehrere Metadatenfelder haben und auf einem vordefinierten oder benutzerdefinierten Aspekttyp basieren.

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

  pii:true
  pii_type:SSN

Weitere Informationen zu Dataplex Catalog finden Sie in der Dataplex Catalog-Übersicht.

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.

    Go to project selector

  3. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

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

    Go to project selector

  5. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

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

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

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

Erstellen Sie zum Bereitstellen dieser Berechtigung eine benutzerdefinierte Rolle mit dieser Berechtigung oder verwenden Sie eine vordefinierte Rolle mit dieser Berechtigung.

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

Einbindung von Dataplex Catalog in Ihre Cloud SQL-Instanz aktivieren

Verwenden Sie eines der folgenden Verfahren, um die Einbindung von Dataplex Catalog in Ihre Cloud SQL-Instanz zu aktivieren.

gcloud

Die Instanz erstellen

Verwenden Sie zum Erstellen einer Cloud SQL-Instanz den Befehl gcloud sql instances create.

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

Ersetzen Sie die folgenden Werte:

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

Instanz aktualisieren

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

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

Wenn Sie alle Cloud SQL-Instanzen in Ihrem Projekt aktivieren und aktualisieren müssen, können Sie ein Skript wie das folgende ausführen:

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

Dieses Beispiel ist Linux-basiert.

REST Version 1

Die Instanz erstellen

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

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

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

HTTP-Methode und URL:

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

JSON-Text anfordern:

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

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

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

Instanz aktualisieren

In diesem Beispiel wird eine vorhandene Instanz aktualisiert. Eine vollständige Liste der Parameter, die für diesen Aufruf verfügbar sind, finden Sie auf der Seite instances.patch.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

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

HTTP-Methode und URL:

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

JSON-Text anfordern:

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

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

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

REST v1beta4

Die Instanz erstellen

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

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

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

HTTP-Methode und URL:

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

JSON-Text anfordern:

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

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

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

Instanz aktualisieren

In diesem Beispiel wird eine vorhandene Instanz aktualisiert. Eine vollständige Liste der Parameter, die für diesen Aufruf verfügbar sind, finden Sie auf der Seite instances.patch.

In diesem Beispiel wird eine vorhandene Instanz aktualisiert. Eine vollständige Liste der Parameter, die für diesen Aufruf verfügbar sind, finden Sie auf der Seite "instances.patch".

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

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

HTTP-Methode und URL:

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

JSON-Text anfordern:

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

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

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

Dataplex Catalog-Einbindung in Ihrer Cloud SQL-Instanz prüfen

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

gcloud

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

gcloud sql instances describe INSTANCE_NAME

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

REST Version 1

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

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

HTTP-Methode und URL:

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

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

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

REST v1beta4

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

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

HTTP-Methode und URL:

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

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

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

Einbindung von Dataplex Catalog in Ihre Cloud SQL-Instanz deaktivieren

Verwenden Sie eines der folgenden Verfahren, um die Einbindung von Dataplex Catalog in Ihrer Cloud SQL-Instanz zu deaktivieren.

gcloud

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

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

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

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

Dieses Beispiel ist Linux-basiert.

REST Version 1

In diesem Beispiel können Sie die Einbindung deaktivieren.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

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

HTTP-Methode und URL:

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

JSON-Text anfordern:

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

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

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

REST v1beta4

In diesem Beispiel können Sie die Einbindung deaktivieren.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

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

HTTP-Methode und URL:

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

JSON-Text anfordern:

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

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

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

Cloud SQL-Assets mit Aspekten anreichern

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

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

  • Geschäftliche Metadaten zu Assets hinzufügen
  • Anhand von geschäftlichen Metadaten und anderen benutzerdefinierten Metadaten nach Assets suchen

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

Nach Cloud SQL-Assets suchen

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

  1. Rufen Sie in Dataplex die Seite Suche auf.

    Zu Dataplex

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

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

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

    • Datenbank
    • Dienst
    • Tabelle
    • Ansicht

Suchen über Anfragen ausführen

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

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

system=Cloud_SQL AND type=Database

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

system=Cloud_SQL AND type=Table

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

Sie können Suchanfragen für bestimmte Cloud SQL-Assets direkt in das Suchfeld eingeben. Das Format des Abfragestrings sieht so aus:

type="projects/PROJECT_ID/locations/global/entryTypes/QUERY_STRING"

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID

  • QUERY_STRING: Verwenden Sie die folgende Tabelle, um einen Abfragestring basierend auf der Cloud SQL-Engine und dem abzufragenden Asset-Typ zu identifizieren.

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

Eine Beispielabfrage könnte etwa so aussehen:

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

Cloud SQL-Assets nach Cloud SQL-Dialekt filtern

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

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

  2. Wählen Sie SQL-Zugriff aus.

  3. Klicken Sie auf OK.

  4. Klicken Sie auf die Schaltfläche zum Bearbeiten des Aspekts playlist_add . Führen Sie auf der Seite SQL-Zugriff die folgenden Schritte aus:

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

  5. Klicken Sie auf Anwenden. Dataplex Catalog zeigt nur Cloud SQL for MySQL-Assets an.

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

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

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

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

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

  4. Klicken Sie auf OK.

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

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

    • Klicken Sie in der Übersicht auf Hinzufügen, um eine RTF-Beschreibung des Assets hinzuzufügen.
    • Klicken Sie unter Aspekte auf Hinzufügen, um dem Asset einen Aspekt hinzuzufügen.
    • Wenn Sie für eine Instanz Mitgliederdatenbanken aufrufen möchten, klicken Sie auf den Tab Eintragsliste und dann auf Alle untergeordneten Einträge in der Suche anzeigen. Wenn der Tab Eintragsliste nicht angezeigt wird, hat die Instanz keine Datenbanken.
    • Unter Details zum Eintrag sehen Sie alle Details des Assets. Klicken Sie auf den Namen des Eintrags, um die Daten nach weiteren Einträgen aufzuschlüsseln.

Beispielworkflow – Aufschlüsselung von Instanz zu Spalten

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

  1. Rufen Sie in Dataplex die Seite Suche auf.

    Zu Dataplex

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

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

  4. Wählen Sie einen Instanznamen aus.

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

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

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

  8. Optional: Wenn Sie einer Spalte einen Aspekttyp hinzufügen möchten, klicken Sie auf die Schaltfläche Aspekt hinzufügen.

Dieser Workflow zeigt das Aufschlüsseln von Instanz zu einer Tabelle. Wenn Sie direkt zu einer Liste der Tabellen wechseln möchten, geben Sie system=Cloud_SQL AND type=Table in das Suchfeld ein.

Preise

Für das Speichern technischer Metadaten von Cloud SQL im Dataplex Catalog fallen keine Gebühren an. Für API-Aufrufe und zusätzliche Anreicherung von Geschäftsmetadaten gelten die Standard-Dataplex-Preise. Weitere Informationen finden Sie auf der Seite mit den Dataplex-Preisen.

Ressourcennutzung

Dataplex Catalog extrahiert regelmäßig Daten aus Ihren Instanzen. Der Extraktionsprozess erfordert eine gewisse CPU-Auslastung. Instanzen mit kleineren Maschinentypen, z. B. Maschinen mit gemeinsam genutzten Kernen und größeren Schemas (10.000 oder mehr Tabellen), können während des Extraktionsprozesses bis zu 40 % ihrer CPU nutzen.

Beschränkungen

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

  • Die Dataplex Catalog-Einbindung in Cloud SQL ist für jede Instanz deaktiviert, die den Zugriff auf Ressourcen aufgrund der Ressourcenregistrierung in Assured Workloads einschränkt.

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

  • Wenn Sie eine Cloud SQL for MySQL-Datenbank, -Tabelle oder -Ansicht löschen und dann diese Datenbank, Tabelle oder Ansicht mit dem vorherigen Namen neu erstellen, bleiben alle vorhandenen Dataplex-Catalog-einträge der ursprünglichen Datenbank, Tabelle oder Ansicht in Dataplex-Catalog erhalten. Wenn Sie dieselben Vorgänge zum Löschen und Neuerstellen einer Cloud SQL for PostgreSQL- oder SQL Server-Datenbank ausführen, werden die Einträge aus Dataplex Catalog entfernt. Dies ist das erwartete Verhalten.
  • Wenn Sie einen TRUNCATE-Vorgang für eine Cloud SQL for MySQL-Datenbank ausführen, werden alle Dataplex Catalog-Einträge aus der Datenbank entfernt.

Nächste Schritte