Metadaten aus PostgreSQL importieren

In diesem Dokument wird beschrieben, wie Sie mit einem Knowledge Catalog-Connector Metadaten aus PostgreSQL in Knowledge Catalog (ehemals Dataplex Universal Catalog) importieren.

Dieser Connector unterstützt PostgreSQL-Instanzen, die lokal, in Cloud SQL oder in anderen Cloud-Umgebungen gehostet werden.

Hinweis

Bevor Sie Metadaten aus PostgreSQL importieren können, müssen Sie die folgenden Aufgaben ausführen:

1. Erteilen Sie die erforderlichen Rollen und Berechtigungen.
2. Aktivieren Sie die Knowledge Catalog und BigQuery Data Transfer Service APIs.
3. Erfüllen Sie die PostgreSQL-Voraussetzungen.
4. Erfüllen Sie die Netzwerkvoraussetzungen.

IAM-Rollen und -Berechtigungen

Zum Erstellen und Verwalten eines Knowledge Catalog-Connector-Jobs benötigen Sie Identity and Access Management (IAM)-Rollen, die Berechtigungen für Knowledge Catalog und BigQuery Data Transfer Service gewähren.

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Konfigurieren eines PostgreSQL-Connectors benötigen:

• Zum Erstellen und Verwalten von Eintragsgruppen: Dataplex Catalog-Administrator (roles/dataplex.catalogAdmin), Dataplex Catalog-Bearbeiter (roles/dataplex.catalogEditor) oder Dataplex-Eintragsgruppeninhaber (roles/dataplex.entryGroupOwner) für das Projekt.
• Zum Erstellen und Verwalten von BigQuery Data Transfer Service-Übertragungsjobs: BigQuery-Administrator (roles/bigquery.admin) für das Projekt.
• Zum Ansehen von Logs in Cloud Logging: Loganzeige (roles/logging.viewer) für das Projekt.

Außerdem müssen Sie dem Dienst-Agent für BigQuery Data Transfer Service (service-PROJECT_NUMBER@gcp-sa-bigquerydatatransfer.iam.gserviceaccount.com) die dataplex.entryGroups.import Berechtigung oder die Dataplex-Eintragsgruppen importeur (roles/dataplex.entryGroupImporter) Rolle gewähren. Sie können diese Rolle entweder auf Projekt- oder auf Eintragsgruppenebene gewähren.

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

APIs aktivieren

Aktivieren Sie die Knowledge Catalog und BigQuery Data Transfer Service APIs.

APIs aktivieren

PostgreSQL-Voraussetzungen

Achten Sie darauf, dass Sie die Voraussetzungen für PostgreSQL-Übertragungen erfüllen. Weitere Informationen finden Sie unter PostgreSQL Voraussetzungen in der BigQuery Data Transfer Service-Dokumentation.

Zusätzlich zu den BigQuery Data Transfer Service-Voraussetzungen muss Ihre PostgreSQL-Datenbank die folgenden Anforderungen für die Metadatenextraktion erfüllen:

• Mindestversion:PostgreSQL-Version 15 oder höher.
• Mindestberechtigungen:Das Extraktionstool benötigt bestimmte Berechtigungen, um Metadaten zu erfassen.

Führen Sie die folgenden SQL-Anweisungen aus, um diese Berechtigungen zu erteilen:

1. Verbindung zur Datenbank gewähren:

   GRANT CONNECT ON DATABASE DATABASE_NAME TO USERNAME;
   

2. Nutzung für das Schema gewähren:

   GRANT USAGE ON SCHEMA SCHEMA_NAME TO USERNAME;
   

3. Weisen Sie dem Nutzer die erforderlichen Leseberechtigungen zu:

   GRANT pg_read_all_data TO USERNAME;
   GRANT pg_read_all_settings TO USERNAME;
   GRANT pg_read_all_stats TO USERNAME;
   

Ersetzen Sie Folgendes:

• DATABASE_NAME: der Name der PostgreSQL-Datenbank, auf die Sie zugreifen möchten.
• USERNAME: der Datenbanknutzer, den Sie konfigurieren möchten.
• SCHEMA_NAME: der Name des Schemas, auf das Sie zugreifen möchten.

Netzwerkvoraussetzungen

Ein Netzwerkanhang für die Verbindung über Private Service Connect ist erforderlich, wenn Sie eine sichere Verbindung zu externen Datenbanken oder Cloud-Datenquellen von Drittanbietern mit einer privaten IP-Adresse in einem privaten Netzwerk herstellen, damit BigQuery Data Transfer Service auf Ihre Datenbank zugreifen kann.

Wenn Sie über eine öffentliche IP-Adresse eine Verbindung zu einer lokalen Umgebung oder einer in der Cloud gehosteten Instanz herstellen, ist kein Netzwerkanhang erforderlich.

PostgreSQL-Connector konfigurieren

Konfigurieren Sie einen PostgreSQL-Connector über die Google Cloud console oder die API.

1. Klicken Sie im Navigationsmenü im Bereich Verwalten auf Connectors.
2. Klicken Sie auf Verbindung hinzufügen.
3. Wählen Sie in der Liste Connectors die Karte PostgreSQL aus.
4. Geben Sie im Abschnitt Details zur Datenquelle die Verbindungsdetails für Ihre PostgreSQL-Instanz an:
   • Wählen Sie unter Netzwerkanhang einen vorhandenen Netzwerkanhang aus, falls erforderlich, oder erstellen Sie einen.
   • Geben Sie Host, Port, Datenbankname,