Cloud SQL-Ressourcen mit Dataplex Universal Catalog verwalten

MySQL   |  PostgreSQL   |  SQL Server

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

Dataplex Universal Catalog ist eine Plattform zum Speichern, Verwalten und Aufrufen von Metadaten. Dataplex Universal Catalog ruft automatisch die folgenden Metadaten aus Cloud SQL-Instanzen, ‑Datenbanken, ‑Tabellen, ‑Spalten und ‑Ansichten ab:

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

In Dataplex Universal Catalog können Metadaten auf Cloud SQL-Instanzebene aufgenommen werden, auch wenn Sie die Einbindung nicht aktivieren. Dataplex Universal Catalog ruft jedoch erst Metadaten aus den Ressourcen der Instanz ab, z. B. aus den zugehörigen Datenbanken, Tabellen, Spalten und Ansichten, wenn Sie die Integration aktivieren.

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

Mit Dataplex Universal Catalog können Sie Ihre Cloud SQL-Metadaten ermitteln und analysieren. Mit Dataplex Universal Catalog können Sie die folgenden Aktivitäten unterstützen:

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

Mit Dataplex Universal Catalog können Sie Metadaten verwalten, indem Sie Cloud SQL-Metadateneinträgen Aspekte zuweisen. Jeder Aspekt kann mehrere Metadatenfelder enthalten und auf einem vordefinierten oder benutzerdefinierten Aspekttyp basieren.

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

  pii:true
  pii_type:SSN

Weitere Informationen zu Dataplex Universal Catalog finden Sie unter Data Catalog-Verwaltung im Dataplex Universal Catalog.

Hinweis: In Dataplex Universal Catalog werden die Ressourcen in Cloud SQL und in anderen Google Cloud -Diensten als Assets bezeichnet. Auf dieser Seite werden Cloud SQL-Ressourcen – Instanzen, Datenbanken, Tabellen und Ansichten – als Cloud SQL-Assets bezeichnet. Der Begriff Assets bezieht sich sowohl auf die Ressourcen als auch auf die Dataplex Universal Catalog-Metadaten für die Ressourcen.

Hinweise

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.

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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

   Dataplex API aktivieren

2. Prüfen Sie die Berechtigungen.

   Sie benötigen bestimmte IAM-Rollen und -Berechtigungen (Identity and Access Management), um Einträge für Cloud SQL-Assets zu suchen und anzuhängen. Weitere Informationen finden Sie unter Erforderliche IAM-Rollen und -Berechtigungen für Dataplex Universal Catalog.

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

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

Um diese Berechtigung zu gewähren, erstellen Sie eine benutzerdefinierte Rolle, die diese Berechtigung enthält, oder verwenden Sie eine der vordefinierten Rollen, die diese Berechtigung haben.

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

Achtung :Die Berechtigung cloudsql.schemas.view muss auf Projektebene erteilt werden. Nutzer mit dieser Berechtigung können die Metadaten für alle Cloud SQL-Instanzen im Projekt ansehen.

Einbindung von Dataplex Universal Catalog in Ihre Cloud SQL-Instanz aktivieren

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

gcloud

Die Instanz erstellen

Verwenden Sie den Befehl gcloud sql instances create, um eine Cloud SQL-Instanz zu erstellen.

gcloud sql instances create INSTANCE_NAME \
  --database-version=DATABASE_VERSION \
  --tier=MACHINE_TYPE \
  --region=REGION_NAME \
  --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 ähnlich dem folgenden ausführen:

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

Dieses Beispiel basiert auf Linux.

REST Version 1

Die Instanz erstellen

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

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

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

HTTP-Methode und URL:

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

JSON-Text anfordern:

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

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

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

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": "[e-mail]",
  "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

Verwenden Sie dieses Beispiel, um eine vorhandene Instanz zu aktualisieren. Eine vollständige Liste der Parameter, die für diesen Aufruf verfügbar sind, finden Sie auf der Seite instances.patch.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

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

HTTP-Methode und URL:

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

JSON-Text anfordern:

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

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

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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": "[e-mail]",
  "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 den Namen der Instanz
• REGION_NAME: Name der Region für die Instanz
• DATABASE_VERSION: Enum-String der Datenbankversion (z. B. POSTGRES_13) Eine vollständige Liste der verfügbaren Strings finden Sie unter SqlDatabaseVersion.
• PASSWORD: Passwort für den root-Nutzer
• MACHINE_TYPE: Enum-String des Maschinentyps (Stufe), z. B.: db-custom-[CPUS]-[MEMORY_MBS]
• EDITION_TYPE: Ihre Cloud SQL-Version.

HTTP-Methode und URL:

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

JSON-Text anfordern:

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

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

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances" | Select-Object -Expand Content

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": "[e-mail]",
  "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

Verwenden Sie dieses Beispiel, um eine vorhandene Instanz zu aktualisieren. Eine vollständige Liste der Parameter, die für diesen Aufruf verfügbar sind, finden Sie auf der Seite instances.patch.

Verwenden Sie dieses Beispiel, um eine vorhandene Instanz zu aktualisieren. Eine vollständige Liste der Parameter, die für diesen Aufruf verfügbar sind, finden Sie auf der Seite "instances.patch".

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

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

HTTP-Methode und URL:

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

JSON-Text anfordern:

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

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

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "[e-mail]",
  "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 Universal Catalog-Einbindung in Ihrer Cloud SQL-Instanz prüfen

Verwenden Sie eines der folgenden Verfahren, um zu prüfen, ob die Dataplex Universal Catalog-Einbindung für Ihre Instanz aktiviert ist.

gcloud

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

gcloud sql instances describe INSTANCE_NAME

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

REST Version 1

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

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

HTTP-Methode und URL:

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

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

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Einbindung von Dataplex Universal Catalog in Ihre Cloud SQL-Instanz deaktivieren

Verwenden Sie eines der folgenden Verfahren, um die Einbindung von Dataplex Universal Catalog in Ihre 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 basiert auf Linux.

REST Version 1

In diesem Beispiel können Sie die Einbindung deaktivieren.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

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

HTTP-Methode und URL:

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

JSON-Text anfordern:

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

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

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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": "[e-mail]",
  "insertTime": "2024-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

In diesem Beispiel können Sie die Einbindung deaktivieren.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

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

HTTP-Methode und URL:

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

JSON-Text anfordern:

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

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

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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": "[e-mail]",
  "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. Aspekttypen helfen Ihnen, doppelte Arbeit und unvollständige Aspekte zu vermeiden. Mit Dataplex Universal 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:

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

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

Nach Cloud SQL-Assets suchen

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

1. Rufen Sie die Seite Suche in 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 Cloud SQL aus.

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

   • Datenbank
   • Datenbankschema
   • Dienst
   • Tabelle
   • Ansicht
   Hinweis: Service ist ein Typalias für eine Cloud SQL-Instanz.

Suchen über Anfragen ausführen

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

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

system=Cloud_SQL AND type=Database

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 Universal Catalog.

Sie können direkt Suchanfragen für bestimmte Cloud SQL-Assets in das Suchfeld eingeben. Der Abfragestring hat folgendes Format:

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

Ersetzen Sie QUERY_STRING durch einen Abfragestring, der auf der Cloud SQL-Engine und dem Typ des Assets basiert, das Sie abfragen möchten. In der folgenden Tabelle finden Sie den entsprechenden Abfragestring.

Cloud SQL-Engine	Abfragestrings
Cloud SQL for MySQL	cloudsql-mysql-database cloudsql-mysql-instance cloudsql-mysql-table cloudsql-mysql-view Hinweis: Das Schema wird für MySQL nicht unterstützt.
Cloud SQL for PostgreSQL	cloudsql-postgresql-database cloudsql-postgresql-instance cloudsql-postgresql-table cloudsql-postgresql-schema cloudsql-postgresql-view
Cloud SQL for SQL Server	cloudsql-sqlserver-database cloudsql-sqlserver-instance cloudsql-sqlserver-table cloudsql-sqlserver-schema cloudsql-sqlserver-view

Eine Beispielabfrage könnte etwa so aussehen:

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

Cloud SQL-Assets nach Cloud SQL-Dialekt filtern

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

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

2. Wählen Sie SQL-Zugriff aus.

3. Klicken Sie auf OK.

4. Klicke 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 die Option SQL Server aus, um nach SQL Server-Assets zu filtern.
5. Optional. Wählen Sie das Feld Version aus und geben Sie eine bestimmte SQL Server-Version ein.

6. Klicken Sie auf Übernehmen. In Dataplex Universal Catalog werden nur SQL Server-Assets angezeigt.

Nach Aspekttyp suchen

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

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

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

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

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

4. Klicken Sie auf OK.

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

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

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

Beispielworkflow – Von Instanz zu Spalten aufschlüsseln

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

1. Rufen Sie die Seite Suche in 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 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. In Dataplex Universal Catalog werden die Datenbanken in der Instanz angezeigt.

   Hinweis: Wenn der Tab Eintragsliste nicht angezeigt wird, kehren Sie zur Seite Suche zurück und wählen Sie einen anderen Instanz aus.

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

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

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

Dieser Workflow zeigt das Aufschlüsseln von Instanz zu einer Tabelle. Sie können direkt zu einer Liste von Tabellen gelangen, indem Sie system=Cloud_SQL AND type=Table in das Suchfeld eingeben.

Preise

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

Ressourcennutzung

Dataplex Universal Catalog extrahiert regelmäßig Daten aus Ihren Instanzen. Für den Extraktionsprozess ist eine bestimmte CPU-Auslastung erforderlich. 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 Universal Catalog aufgeführt.

• Die Einbindung von Dataplex Universal Catalog in Cloud SQL ist für alle Instanzen deaktiviert, die den Zugriff auf Ressourcen aufgrund der Registrierung von Ressourcen in Assured Workloads einschränken.

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

• SQL Server-Datenbanken, für die die Option Auto Close aktiviert ist, können Schemainformationen nicht mit Dataplex Universal Catalog synchronisieren. Als allgemeine Best Practice und aus Leistungsgründen empfehlen wir, die Option Auto Close in SQL Server auf „false“ zu setzen. Wenn Sie Dataplex Universal Catalog verwenden möchten, muss die Option Auto Close auf „false“ gesetzt sein. Bei Express-Versionen ist die Option Auto Close standardmäßig auf „true“ gesetzt, wie von der SQL Server-Engine vorgesehen.

Nächste Schritte

• Data Catalog-Verwaltung im Dataplex Universal Catalog
• IAM-Identity and Access Management für Dataplex Universal Catalog