Zugriff auf Google BigQuery konfigurieren

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. Google BigQuery unter Windows oder Linux konfigurieren
  2. Google BigQuery Externes Konto in Adobe Campaign Classic konfigurieren
  3. Google BigQuery Connector-Massen-Load auf Windows oder Linux einrichten
HINWEIS

Google BigQuery Connector ist für hybride und On-Premise-Implementierungen verfügbar. Weitere Informationen hierzu finden Sie auf dieser Seite.

Google BigQuery unter Windows

Treiber unter Windows eingerichtet

  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 Connector Google BigQuery funktioniert, müssen für Adobe Campaign Classic die folgenden Parameter zum Verbinden verwendet werden:

    • Projekt: ein vorhandenes Projekt erstellen oder verwenden.

      Weiterführende Informationen dazu finden Sie auf dieser Seite.

    • Dienstkonto: ein Dienstkonto erstellen.

      Weiterführende Informationen dazu finden Sie auf dieser Seite.

    • Pfad der Schlüsseldatei: der Dienst erfordert eine Schlüsseldatei für eine Google BigQuery Verbindung über ODBC.

      Weiterführende Informationen dazu finden Sie auf dieser Seite.

    • Datensatz: ​Datensätze sind 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 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

HINWEIS

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 von 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

Treiber für Linux eingerichtet

  1. Vor der Installation des ODBC-Treibers müssen Sie Ihr System aktualisieren. Führen Sie unter Linux oder CentOS den folgenden Befehl aus:

    yum update
    # install unixODBC driver manager
    yum install unixODBC
    
  2. Anschließend müssen Sie den UnixODBC-Treiber-Manager mit dem folgenden Befehl installieren:

    # switch to root user
    sudo su
    

    Unter Debian:

    apt-get update
    apt-get upgrade
    # install unixODBC driver manager
    apt-get install unixODBC
    
  3. Laden Sie den Magnitude Simba Linux ODBC-Treiber (.tar.gz) herunter. Übertragen Sie dann die Tarball-Datei in einen temporären Ordner auf Ihrem Computer oder verwenden Sie den Befehl wget :

    # in this example driver version is 2.3.1.1001
    wget https://storage.googleapis.com/simba-bq-release/odbc/SimbaODBCDriverforGoogleBigQuery_[Version]-Linux.tar.gz
    
  4. Extrahieren Sie die Haupt-Tarball-Datei wie folgt, wobei TarballName der Name des Tarball-Pakets ist, das den Treiber enthält:

    tar --directory=/tmp -zxvf [TarballName]
    
  5. Rufen Sie den Ordner auf, den Sie extrahiert haben, und extrahieren Sie die innere Tarball-Datei, die der Version des Treibers entspricht. Installieren Sie es in einen anderen temporären Ordner, im folgenden Beispiel BigQueryDriver:

    mkdir /tmp/BigQueryDriver/
    cd /tmp/SimbaODBCDriverforGoogleBigQuery_[Version]-Linux/
    tar --directory=/tmp/BigQueryDriver/ -zxvf SimbaODBCDriverforGoogleBigQuery[Bitness]_[Version].tar.gz
    
  6. Greifen Sie auf den temporären Speicherort zu, an dem die Haupt-Tarball-Datei extrahiert wurde, und kopieren Sie die Dateien GoogleBigQueryODBC.did und setup/simba.googlebigqueryodbc.ini in den neuen Ordner, der im vorherigen Schritt erstellt wurde:

    cd /tmp/SimbaODBCDriverforGoogleBigQuery_[Version]-Linux/
    cp GoogleBigQueryODBC.did /tmp/BigQueryDriver/SimbaODBCDriverforGoogleBigQuery[Bitness]_[Version]/lib/
    cp setup/simba.googlebigqueryodbc.ini /tmp/BigQueryDriver/SimbaODBCDriverforGoogleBigQuery[Bitness]_[Version]/lib/
    
  7. Erstellen Sie den Installationsordner wie folgt:

    mkdir -p /opt/simba/googlebigqueryodbc/
    
  8. Kopieren Sie den Inhalt des Ordners in den neuen Installationsordner:

    cp -r /tmp/BigQueryDriver/SimbaODBCDriverforGoogleBigQuery[Bitness]_[Version]/* /opt/simba/googlebigqueryodbc/
    
  9. Ersetzen Sie <INSTALLDIR> durch /opt/simba/googlebigqueryodbc in simba.googlebigqueryodbc.ini im Installationsverzeichnis:

    cd /opt/simba/googlebigqueryodbc/lib/
    sed -i 's/<INSTALLDIR>/\/opt\/simba\/googlebigqueryodbc/g' simba.googlebigqueryodbc.ini
    
  10. Ändern Sie DriverManagerEncoding in UTF-16 und SwapFilePath in simba.googlebigqueryodbc.ini. Bei Bedarf können Sie auch die Protokollierungseinstellungen ändern.

    Im Folgenden finden Sie ein Beispiel für eine aktualisierte Konfigurationsdatei für den gesamten Treiber:

    # /opt/simba/googlebigqueryodbc/lib/simba.googlebigqueryodbc.ini
    [Driver]
    DriverManagerEncoding=UTF-16
    ErrorMessagesPath=opt/simba/googlebigqueryodbc/ErrorMessages
    LogLevel=6
    LogPath=/tmp
    SwapFilePath=/tmp
    
  11. Wenn Sie eine Systemtreiberdatei oder eine aktuelle odbcinst.ini-Datei verwenden, konfigurieren Sie /etc/odbcinst.ini so, dass auf den Google BigQuery-Treiberspeicherort /opt/simba/googlebigqueryodbc/lib/libgooglebigqueryodbc_sb[Bitness].so verwiesen wird.

    Beispiel:

    # /etc/odbcinst.ini
    # Make sure to use Simba ODBC Driver for Google BigQuery as a driver name.
    
    [ODBC Drivers]
    Simba ODBC Driver for Google BigQuery=Installed
    
    [Simba ODBC Driver for Google BigQuery]
    Description=Simba ODBC Driver for Google BigQuery(64-bit)
    Driver=/opt/simba/googlebigqueryodbc/lib/libgooglebigqueryodbc_sb64.so
    
  12. Suchen Sie den Speicherort der unixODBC-Treiber-Manager-Bibliotheken und fügen Sie die Bibliothekspfade unixODBC und googlebigqueryodbc zur Variable LD_LIBRARY_PATH environment hinzu.

    find / -name 'lib*odbc*.so*' -print
    #output:
    /usr/lib/x86_64-linux-gnu/libodbccr.so.2
    /usr/lib/x86_64-linux-gnu/libodbcinst.so.2.0.0
    /usr/lib/x86_64-linux-gnu/libodbccr.so.1
    .
    .
    /opt/simba/googlebigqueryodbc/lib/libgooglebigqueryodbc_sb64.so
    
    #the command would look like this
    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/simba/googlebigqueryodbc:/usr/lib
    
  13. 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 Linux

HINWEIS

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 von Linux (x86_64) in 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. Wenn Sie die Variable PATH nicht verwenden möchten oder den Ordner google-cloud-sdk an einen anderen Speicherort verschieben möchten, verwenden Sie bei der Konfiguration des externen Kontos den Optionswert bqpath , um den genauen Pfad zum Ordner "bin"auf Ihrem System anzugeben.

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

Externes Google BigQuery-Konto

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 Google Cloud-Dokumentation.

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

    • Pfad der Schlüsseldatei:

      • Laden Sie die Schlüsseldatei auf den Server hoch: Wählen Sie Klicken Sie hier , um den Schlüssel über Adobe Campaign Classic hochzuladen .

      • 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 Google Cloud-Dokumentation.

Auf dieser Seite