DokumentationCampaignCampaign Classic v7 – Dokumentation

Zugriff auf Google BigQuery konfigurieren configure-fda-google-big-query

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Verwenden Sie die Option Adobe Campaign Classic Federated Data Access (FDA), um in einer externen Datenbank gespeicherte Informationen zu verarbeiten. Gehen Sie wie folgt vor, um den Zugriff auf Google BigQuery zu konfigurieren.

  1. Konfigurieren Sie Google BigQuery für Windows oder Linux
  2. Konfigurieren des externen Google BigQuery -Kontos in Adobe Campaign Classic
  3. Richten Sie Google BigQuery Massenladevorgänge des Connectors unter Windows oder Linux ein.
NOTE
Der Google BigQuery-Connector ist für gehostete, hybride und On-Premise-Implementierungen verfügbar. Weitere Informationen hierzu finden Sie auf dieser Seite.

Google BigQuery unter Windows google-windows

Treiber unter Windows eingerichtet driver-window

  1. Laden Sie den ODBC-Treiber für Windows🔗 herunter.

  2. Konfigurieren Sie den ODBC-Treiber unter Windows. Weitere Informationen hierzu finden Sie auf dieser Seite.

  3. Damit der Google BigQuery -Connector funktioniert, müssen für Adobe Campaign Classic die folgenden Parameter für die Verbindung verwendet werden:

    • Projekt: Erstellen oder Verwenden eines vorhandenen Projekts.

      Weiterführende Informationen dazu finden Sie auf dieser Seite.

    • Dienstkonto: Erstellen Sie ein Dienstkonto.

      Weiterführende Informationen dazu finden Sie auf dieser Seite.

    • Pfad der Schlüsseldatei: Für das Dienstkonto ist eine Schlüsseldatei für eine Google BigQuery-Verbindung über ODBC erforderlich.

      Weiterführende Informationen dazu finden Sie auf dieser Seite.

    • Datensatz: Datensatz ist für eine ODBC-Verbindung optional. Da jede Abfrage den Datensatz bereitstellen muss, in dem sich die Tabelle befindet, ist die Angabe eines Datensatzes für den Google BigQuery FDA-Connector in Adobe Campaign Classic obligatorisch.

      Weiterführende Informationen dazu finden Sie auf dieser Seite.

  4. In Adobe Campaign Classic können Sie dann Ihr externes Google BigQuery -Konto konfigurieren. Weiterführende Informationen zur Konfiguration Ihres externen Kontos finden Sie in diesem Abschnitt.

Massenladeeinrichtung unter Windows bulk-load-window

NOTE
Damit das Google Cloud SDK funktioniert, muss Python installiert sein.
Wir empfehlen die Verwendung von Python3, siehe diese Seite.

Das Bulk Load-Dienstprogramm ermöglicht eine schnellere Übertragung, die über das Google Cloud SDK erreicht wird.

  1. Laden Sie das 64-Bit-Archiv für Windows (x86_64) von dieser Seite herunter und extrahieren Sie es in das entsprechende Verzeichnis.

  2. Führen Sie das Skript google-cloud-sdk\install.sh aus. Sie müssen die Einstellung der Pfadvariablen akzeptieren.

  3. Überprüfen Sie nach der Installation, ob die Pfadvariable ...\google-cloud-sdk\bin festgelegt ist. Wenn nicht, fügen Sie es manuell hinzu.

  4. Fügen Sie in der Datei ..\google-cloud-sdk\bin\bq.cmd die lokale Variable CLOUDSDK_PYTHON hinzu, die zum Speicherort der Python-Installation umgeleitet wird.

    Beispiel:

  5. Starten Sie Adobe Campaign Classic neu, damit die Änderungen berücksichtigt werden.

Google BigQuery unter Linux google-linux

Treiber für Linux eingerichtet driver-linux

Beachten Sie vor dem Einrichten des Treibers, dass Skript und Befehle vom Root-Benutzer ausgeführt werden müssen. Es wird außerdem empfohlen, während der Skripterstellung das Google DNS 8.8.8.8 zu verwenden.

Gehen Sie wie folgt vor, um Google BigQuery unter Linux zu konfigurieren:

  1. Überprüfen Sie vor der ODBC-Installation, ob die folgenden Pakete auf Ihrer Linux-Distribution installiert sind:

    • Für Red Hat/CentOS:

      code language-none 
      yum update
yum upgrade
yum install -y grep sed tar wget perl curl

    • Für Debian:

      code language-none 
      apt-get update
apt-get upgrade
apt-get install -y grep sed tar wget perl curl

  2. Aktualisieren Sie das System vor der Installation:

    • Für Red Hat/CentOS:

      code language-none 
      # install unixODBC driver manager
yum install -y unixODBC

    • Für Debian:

      code language-none 
      # install unixODBC driver manager
apt-get install -y odbcinst1debian2 libodbc1 odbcinst unixodbc

  3. Bevor Sie das Skript ausführen, können Sie weitere Informationen abrufen, indem Sie das —help-Argument angeben:

    code language-none 
    cd /usr/local/neolane/nl6/bin/fda-setup-scripts
./bigquery_odbc-setup.sh --help

  4. Rufen Sie den Ordner auf, in dem sich das Skript befindet, und führen Sie das folgende Skript als Stammbenutzer aus:

    code language-none 
    cd /usr/local/neolane/nl6/bin/fda-setup-scripts
./bigquery_odbc-setup.sh

Massenladeeinrichtung unter Linux bulk-load-linux

NOTE
Damit das Google Cloud SDK funktioniert, muss Python installiert sein.
Wir empfehlen die Verwendung von Python3, siehe diese Seite.

Das Bulk Load-Dienstprogramm ermöglicht eine schnellere Übertragung, die über das Google Cloud SDK erreicht wird.

  1. Überprüfen Sie vor der ODBC-Installation, ob die folgenden Pakete auf Ihrer Linux-Distribution installiert sind:

    • Für Red Hat/CentOS:

      code language-none 
      yum update
yum upgrade
yum install -y python3

    • Für Debian:

      code language-none 
      apt-get update
apt-get upgrade
apt-get install -y python3

  2. Rufen Sie den Ordner auf, in dem sich das Skript befindet, und führen Sie das folgende Skript aus:

    code language-none 
    cd /usr/local/neolane/nl6/bin/fda-setup-scripts
./bigquery_sdk-setup.sh

Externes Google BigQuery-Konto google-external

Sie müssen ein externes Google BigQuery -Konto erstellen, um Ihre Adobe Campaign Classic-Instanz mit Ihrer externen Google BigQuery-Datenbank zu verbinden.

  1. Klicken Sie in Adobe Campaign Classic Explorer auf Administration '>' Plattform '>' Externe Konten.

  2. Wählen Sie Neu aus.

  3. Wählen Sie Externe Datenbank als Typ Ihres externen Kontos aus.

  4. Konfigurieren Sie das externe Google BigQuery-Konto; geben Sie dazu Folgendes an:

    • Typ: Google BigQuery

    • Dienstkonto: E-Mail Ihres Dienstkontos. Weitere Informationen hierzu finden Sie in der Dokumentation zur Google Cloud.

    • Projekt: Name Ihres Projekts. Weitere Informationen hierzu finden Sie in der Dokumentation zur Google Cloud.

    • Pfad der Schlüsseldatei:

      • Laden Sie die Schlüsseldatei auf den Server hoch: Wählen Sie Hier klicken, um den Schlüssel hochzuladen , wenn Sie den Schlüssel über Adobe Campaign Classic hochladen möchten.

      • Geben Sie den Pfad der Schlüsseldatei manuell ein: Kopieren/fügen Sie Ihren absoluten Pfad in dieses Feld ein, wenn Sie einen bereits vorhandenen Schlüssel verwenden möchten.

    • Datensatz: Name Ihres Datensatzes. Weitere Informationen hierzu finden Sie in der Dokumentation zur Google Cloud.

Der Connector unterstützt die folgenden Optionen:

Option
Beschreibung
ProxyType
Typ des Proxys, der für die Verbindung mit BigQuery über ODBC- und SDK-Connectoren verwendet wird.
HTTP (Standard), http_no_tunnel, socks4 und socks5 werden derzeit unterstützt.
ProxyHost
Hostname oder IP-Adresse, an der der Proxy erreicht werden kann.
ProxyPort
Anschlussnummer, auf der der Proxy ausgeführt wird, z. B. 8080
ProxyUid
Benutzername für den authentifizierten Proxy
ProxyPwd
ProxyUid-Kennwort
bqpath
Beachten Sie, dass dies nur für Tools mit Massenladevorgang (Cloud SDK) gilt.
Um die Verwendung der PATH-Variablen zu vermeiden oder den Ordner google-cloud-sdk an einen anderen Speicherort zu verschieben, können Sie mit dieser Option den genauen Pfad zum Ordner "cloud sdk bin"auf dem Server angeben.
GCloudConfigName
Beachten Sie, dass dies ab Version 7.3.4 und nur für Tools mit Massenladevorgang (Cloud SDK) gilt.
Das Google Cloud-SDK verwendet Konfigurationen zum Laden von Daten in BigQuery-Tabellen. Die Konfiguration mit dem Namen accfda speichert die Parameter zum Laden der Daten. Mit dieser Option können Benutzer jedoch einen anderen Namen für die Konfiguration angeben.
GCloudDefaultConfigName
Beachten Sie, dass dies ab Version 7.3.4 und nur für Tools mit Massenladevorgang (Cloud SDK) gilt.
Die aktive Google Cloud SDK-Konfiguration kann nicht gelöscht werden, ohne dass das aktive Tag zuerst in eine neue Konfiguration übertragen wird. Diese temporäre Konfiguration ist erforderlich, um die Hauptkonfiguration für das Laden von Daten neu zu erstellen. Der Standardname für die temporäre Konfiguration ist default. Dieser kann bei Bedarf geändert werden.
GCloudRecreateConfig
Beachten Sie, dass dies ab Version 7.3.4 und nur für Tools mit Massenladevorgang (Cloud SDK) gilt.
Wenn der Wert auf false festgelegt ist, verhindert der Mechanismus zum Laden von Massengütern nicht den Versuch, die Google Cloud SDK-Konfigurationen neu zu erstellen, zu löschen oder zu ändern. Stattdessen wird das Laden der Daten mit der vorhandenen Konfiguration auf dem Computer fortgesetzt. Diese Funktion ist nützlich, wenn andere Vorgänge von Google Cloud SDK-Konfigurationen abhängig sind.
Wenn der Benutzer diese Engine-Option ohne ordnungsgemäße Konfiguration aktiviert, gibt der Massenlademechanismus eine Warnmeldung aus: No active configuration found. Please either create it manually or remove the GCloudRecreateConfig option. Um weitere Fehler zu vermeiden, wird dann der standardmäßige ODBC-Array-Einfügemechanismus für Massen-Ladevorgänge verwendet.
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1