ServiceNow-Übertragung planen

Mit BigQuery Data Transfer Service für den Connector ServiceNow können Sie wiederkehrende Ladejobs von ServiceNow in BigQuery automatisch planen und verwalten.

Beschränkungen

ServiceNow-Datenübertragungen unterliegen den folgenden Einschränkungen:

  • Es wird nicht empfohlen, gleichzeitige Datenübertragungen auf derselben ServiceNow-Instanz auszuführen.
  • Das Mindestintervall zwischen wiederkehrenden Datenübertragungen beträgt 15 Minuten. Das Standardintervall für eine wiederkehrende Übertragung beträgt 24 Stunden.

  • ServiceNow überträgt geschäftsbezogene Tabellen aus drei Anwendungen: Beschaffung, Produktkatalog und Vertragsverwaltung. Die folgenden Tabellen können übertragen werden:

    • ast_contract
    • clm_condition_check
    • clm_condition_checker
    • clm_contract_history
    • clm_m2m_contract_and_terms
    • clm_m2m_contract_asset
    • clm_m2m_contract_user
    • clm_m2m_rate_card_asset
    • clm_terms_and_conditions
    • pc_hardware_cat_item
    • pc_product_cat_item
    • pc_software_cat_item
    • pc_vendor_cat_item
    • proc_po
    • proc_po_item
    • proc_rec_slip
    • proc_rec_slip_item

Hinweise

Bevor Sie eine ServiceNow-Datenübertragung erstellen, müssen Sie die folgenden Konfigurationen für ServiceNow und BigQuery vornehmen.

Voraussetzungen für ServiceNow

Voraussetzungen für BigQuery

Erforderliche BigQuery-Rollen

Bitten Sie Ihren Administrator, Ihnen den IAM-Rolle BigQuery-Administrator (roles/bigquery.admin) zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Erstellen einer Übertragung benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Erstellen einer Übertragung erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind zum Erstellen einer Übertragung erforderlich:

  • bigquery.transfers.update für den Nutzer
  • bigquery.datasets.get für das Ziel-Dataset
  • bigquery.datasets.update für das Ziel-Dataset

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

ServiceNow-Datenübertragung einrichten

ServiceNow-Datenübertragungen können in der Google Cloud Console oder im bq-Befehlszeilentool erstellt werden.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Datenübertragungen auf.

    Zu „Datenübertragungen”

  2. Klicken Sie auf Übertragung erstellen.

  3. Wählen Sie im Abschnitt Source type (Quelltyp) für Source (Quelle) die Option ServiceNow aus.

  4. Führen Sie im Abschnitt Details zur Datenquelle folgende Schritte aus:

    • Geben Sie als Instanz-ID die ServiceNow-Instanz-ID ein. Sie finden diese in Ihrer ServiceNow-URL, z. B. https://INSTANCE_ID.service-now.com.
    • Geben Sie unter Nutzername den ServiceNow-Nutzernamen ein, der für die Verbindung verwendet werden soll.
    • Geben Sie unter Passwort das ServiceNow-Passwort ein.
    • Geben Sie für Client-ID die Client-ID aus Ihren OAuth-Anmeldedaten ein. Informationen zum Generieren von Anmeldedaten finden Sie unter OAuth-Anmeldedaten erstellen.
    • Geben Sie unter Clientschlüssel den Clientschlüssel aus Ihren OAuth-Anmeldedaten ein.
    • Wählen Sie unter Werttyp eine der folgenden Optionen aus:
      • Um die in der Datenbank gespeicherten Werte zu übertragen, wählen Sie Tatsächlich aus.
      • Wählen Sie Anzeige aus, um die Anzeigewerte der Spalten zu übertragen.

  5. Wählen Sie im Abschnitt Zieleinstellungen für Dataset das Dataset aus, das Sie zum Speichern Ihrer Daten erstellt haben.

  6. Geben Sie im Abschnitt Konfigurationsname für Übertragung für Anzeigename einen Namen für die Datenübertragung ein.

  7. Führen Sie im Abschnitt Zeitplanoptionen folgende Schritte aus:

    • Wählen Sie in der Liste Wiederholungshäufigkeit aus, wie oft diese Datenübertragung ausgeführt werden soll. Wenn Sie eine benutzerdefinierte Wiederholungshäufigkeit angeben möchten, wählen Sie Benutzerdefiniert aus. Wenn Sie On-Demand auswählen, wird diese Datenübertragung ausgeführt, wenn Sie die Übertragung manuell auslösen.

    • Wählen Sie gegebenenfalls Jetzt starten oder Zu festgelegter Zeit starten aus und geben Sie ein Startdatum und eine Laufzeit an.

  8. Wählen Sie im Menü Dienstkonto ein Dienstkonto aus den Dienstkonten aus, die mit Ihrem Google Cloud-Projekt verknüpft sind. Das ausgewählte Dienstkonto muss die erforderlichen Rollen für diese Datenübertragung haben.

    Wenn Sie sich mit einer föderierten Identität angemeldet haben, ist ein Dienstkonto zum Erstellen einer Datenübertragung erforderlich. Wenn Sie sich mit einem Google-Konto angemeldet haben, ist ein Dienstkonto für die Übertragung optional.

    Weitere Informationen zur Verwendung von Dienstkonten mit Datenübertragungen finden Sie unter Dienstkonten verwenden.

  9. Optional: Gehen Sie im Abschnitt Benachrichtigungsoptionen so vor:

    • Klicken Sie zum Aktivieren von E-Mail-Benachrichtigungen auf die Ein/Aus-Schaltfläche E-Mail-Benachrichtigung. Wenn Sie diese Option aktivieren, erhält der Übertragungsadministrator eine E-Mail-Benachrichtigung, wenn eine Übertragung fehlschlägt.
    • Klicken Sie auf die Ein/Aus-Schaltfläche Pub/Sub-Benachrichtigungen, um Pub/Sub-Benachrichtigungen über die Ausführung von Übertragungen für diese Datenübertragung zu aktivieren. Sie können den Namen für das Thema auswählen oder auf Thema erstellen klicken, um eines zu erstellen.

  10. Klicken Sie auf Speichern.

bq

Geben Sie den Befehl bq mk ein und geben Sie das Flag --transfer_config für die Übertragungserstellung an.

bq mk \
    --transfer_config \
    --project_id=PROJECT_ID \
    --data_source=DATA_SOURCE \
    --display_name=DISPLAY_NAME \
    --target_dataset=DATASET \
    --params='PARAMETERS'

Ersetzen Sie Folgendes:

  • PROJECT_ID (Optional) Ihre Google Cloud-Projekt-ID. Wenn keine Projekt-ID angegeben ist, wird das Standardprojekt verwendet.
  • DATA_SOURCE: Die Datenquelle (z. B. servicenow).
  • DISPLAY_NAME: Der Anzeigename für die Übertragungskonfiguration. Der Datenübertragungsname kann ein beliebiger Wert sein, mit dem Sie die Übertragung identifizieren können, wenn Sie sie später ändern müssen.
  • DATASET: Das Ziel-Dataset für die Übertragungskonfiguration.

  • PARAMETERS: die Parameter für die erstellte Übertragungskonfiguration im JSON-Format. Beispiel: --params='{"param":"param_value"}'. Im Folgenden finden Sie die Parameter für eine ServiceNow-Datenübertragung:

    ServiceNow-Parameter Erforderlich oder optional Beschreibung
    connector.instanceId Erforderlich Instanz-ID der ServiceNow-Instanz
    connector.authentication.username Erforderlich Nutzername der Anmeldedaten
    connector.authentication.password Erforderlich Das Passwort der Anmeldedaten
    connector.authentication.oauth.clientId Erforderlich Client-ID des generierten OAuth
    connector.authentication.oauth.clientSecret Erforderlich Client-Secret des generierten OAuth-Schlüssels
    connector.valueType Optional Actual oder Display (Standard: Actual)

    Mit dem folgenden Befehl wird beispielsweise eine ServiceNow-Datenübertragung im Standardprojekt mit allen erforderlichen Parametern erstellt:

      bq mk \
    --transfer_config \
    --target_dataset=mydataset \
    --data_source=servicenow \
    --display_name='My Transfer' \
    --params='{"connector.authentication.oauth.clientId": "1234567890",
        "connector.authentication.oauth.clientSecret":"ABC12345",
        "connector.authentication.username":"user1",
        "Connector.authentication.password":"abcdef1234",
        "connector.instanceId":"https://dev-instance.service-now.com"}'

API

Verwenden Sie die Methode projects.locations.transferConfigs.create und geben Sie eine Instanz der Ressource TransferConfig an.

Probleme bei der Übertragung beheben

Weitere Informationen finden Sie unter Fehlerbehebung bei Übertragungskonfigurationen.

Übertragung schlägt aufgrund der ServiceNow-Aktivierung fehl

Ein Problem tritt auf, wenn Datenübertragungen fehlschlagen, wenn die Beschaffungs-, Produktkatalog- oder Vertragsverwaltungsanwendungen in ServiceNow nicht aktiviert sind. Aktivieren Sie alle drei Anwendungen, um das Problem zu beheben. Aktivieren Sie beispielsweise Procurement.

Problem tritt während der Übertragungsausführung auf

Ein Problem tritt auf, weil die Übertragungsausführung nicht wie vorgesehen erstellt wird. So beheben Sie das Problem:

  • Prüfen Sie, ob die Anmeldedaten des ServiceNow-Kontos gültig sind, z. B. Nutzername, Passwort, Client-ID und Clientschlüssel.
  • Prüfen Sie, ob die Instanz-ID die gültige ID Ihrer ServiceNow-Instanz ist.

Preise

Während sich dieses Feature in der Vorschau befindet, fallen keine Kosten für die Übertragung von ServiceNow-Daten in BigQuery an.

Nächste Schritte