In diesem Dokument wird beschrieben, wie Sie mit einem Knowledge Catalog-Connector Metadaten aus MySQL in Knowledge Catalog (früher Dataplex Universal Catalog) importieren.
Dieser Connector unterstützt MySQL-Instanzen, die lokal, in Cloud SQL oder in anderen Cloud-Umgebungen gehostet werden.
Hinweis
IAM-Rollen und -Berechtigungen
Zum Erstellen und Verwalten eines Knowledge Catalog-Connector-Jobs benötigen Sie IAM-Rollen (Identity and Access Management), 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 MySQL-Connectors benötigen:
- Zum Erstellen und Verwalten von Eintragsgruppen benötigen Sie die Rolle Dataplex Catalog Admin (
roles/dataplex.catalogAdmin), Dataplex Catalog Editor (roles/dataplex.catalogEditor) oder Dataplex Entry Group Owner (roles/dataplex.entryGroupOwner) für das Projekt. - So erstellen und verwalten Sie BigQuery Data Transfer Service-Übertragungsjobs:
BigQuery-Administrator (
roles/bigquery.admin) für das Projekt. - So rufen Sie Logs in Cloud Logging auf:
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 Berechtigung dataplex.entryGroups.import oder die Rolle Dataplex Entry Group Importer (roles/dataplex.entryGroupImporter) zuweisen. Sie können diese Rolle entweder auf Projektebene oder auf Ebene der Eintragsgruppe zuweisen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.
APIs aktivieren
Aktivieren Sie die Knowledge Catalog API und die BigQuery Data Transfer Service API.
MySQL-Voraussetzungen
Prüfen Sie, ob Sie die Voraussetzungen für MySQL-Übertragungen erfüllen. Weitere Informationen finden Sie in der Dokumentation zum BigQuery Data Transfer Service unter MySQL-Voraussetzungen.
Netzwerkvoraussetzungen
Eine Netzwerkverbindung 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 möchten, 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 keine Netzwerkverbindung erforderlich.
MySQL-Connector konfigurieren
Rufen Sie in der Google Cloud Console die Seite Knowledge Catalog auf.
Klicken Sie im Navigationsmenü im Bereich Verwalten auf Connectors.
Klicken Sie auf Verbindung hinzufügen.
Wählen Sie in der Liste Connectors die Karte MySQL aus.
Geben Sie im Abschnitt Details zur Datenquelle die Verbindungsdetails für Ihre MySQL-Instanz an:
- Wählen Sie unter Netzwerkanhang einen vorhandenen Netzwerkanhang aus oder erstellen Sie einen.
- Geben Sie den Host, den Port, den Datenbanknamen, den Nutzernamen und das Passwort ein.
- Wenn Sie TLS verwenden, wählen Sie einen TLS-Modus aus und geben Sie ein vertrauenswürdiges PEM-Zertifikat an.
- Klicken Sie unter Zu importierende MySQL-Metadatenobjekte auf Durchsuchen, um Objekte auszuwählen.
Gehen Sie im Abschnitt Zieleinstellungen so vor:
- Klicken Sie auf Durchsuchen und wählen Sie eine vorhandene Knowledge Catalog-Eintragsgruppe aus, in der die importierten Metadaten gespeichert werden sollen. Alternativ können Sie auf Neue Eintragsgruppe erstellen klicken.
- Wählen Sie aus, ob Sie die Berechtigungen für die Eintragsgruppe jetzt oder später festlegen möchten.
Wir empfehlen, Berechtigungen so festzulegen, dass Nutzer die importierten Metadaten sehen können. Wenn Sie dem Dienst-Agent für BigQuery Data Transfer Service (
service-PROJECT_NUMBER@gcp-sa-bigquerydatatransfer.iam.gserviceaccount.com) die Rolle Dataplex Entry Group Importer (roles/dataplex.entryGroupImporter) oder die Berechtigungdataplex.entryGroups.importnicht auf Projektebene gewährt haben, müssen Sie sie auf Ebene der Eintragsgruppe gewähren.
Geben Sie im Abschnitt Connector config name (Name der Connector-Konfiguration) für Display name (Anzeigename) einen Namen für den Metadaten-Importjob ein.
Konfigurieren Sie im Abschnitt Zeitplanoptionen die Häufigkeit für den Metadaten-Importjob. Wenn Sie On-Demand auswählen, wird der Job nur ausgeführt, wenn Sie ihn manuell auslösen.
Optional: Konfigurieren Sie im Abschnitt Benachrichtigungsoptionen E-Mail- oder Pub/Sub-Benachrichtigungen für Jobfehler.
Optional: Konfigurieren Sie im Abschnitt Erweiterte Optionen die Verschlüsselungseinstellungen. Wenn Sie einen vom Kunden verwalteten Verschlüsselungsschlüssel (Customer-Managed Encryption Key, CMEK) auswählen, wird der Schlüssel zum Verschlüsseln aller temporären Daten verwendet, die vor dem Starten der Importjobs für Knowledge Catalog-Metadaten bereitgestellt werden. Sie wird nicht verwendet, um die Metadaten in der Ziel-Eintragsgruppe des Knowledge Catalog zu verschlüsseln.
Klicken Sie auf Speichern.
Nachdem Sie den Job erstellt haben, plant Knowledge Catalog die erste Ausführung entsprechend Ihrer Konfiguration oder Sie können sie manuell starten.