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
- Erstellen Sie OAuth-Anmeldedaten, um auf ServiceNow APIs zuzugreifen.
Die folgenden ServiceNow-Anwendungen müssen alle in der ServiceNow-Instanz aktiviert sein:
Voraussetzungen für BigQuery
- Führen Sie alle zum Aktivieren des BigQuery Data Transfer Service erforderlichen Aktionen aus.
- Erstellen Sie ein BigQuery-Dataset zum Speichern der Daten.
- Wenn Sie Benachrichtigungen zur Übertragungsausführung für Pub/Sub einrichten möchten, benötigen Sie die IAM-Berechtigung (Identity and Access Management)
pubsub.topics.setIamPolicy
. Wenn Sie nur E-Mail-Benachrichtigungen einrichten, sind keine Pub/Sub-Berechtigungen erforderlich. Weitere Informationen finden Sie unter BigQuery Data Transfer Service-Ausführungsbenachrichtigungen.
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 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
Rufen Sie in der Google Cloud Console die Seite Datenübertragungen auf.
Klicken Sie auf
Übertragung erstellen.Wählen Sie im Abschnitt Source type (Quelltyp) für Source (Quelle) die Option ServiceNow aus.
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.
- Geben Sie als Instanz-ID die ServiceNow-Instanz-ID ein. Sie finden diese in Ihrer ServiceNow-URL, z. B.
Wählen Sie im Abschnitt Zieleinstellungen für Dataset das Dataset aus, das Sie zum Speichern Ihrer Daten erstellt haben.
Geben Sie im Abschnitt Konfigurationsname für Übertragung für Anzeigename einen Namen für die Datenübertragung ein.
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.
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.
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.
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
oderDisplay
(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 Beschaffung.
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
- Eine Übersicht über BigQuery Data Transfer Service finden Sie unter Einführung in BigQuery Data Transfer Service.
- Informationen zum Verwenden von Übertragungen, einschließlich des Abrufs von Informationen zu einer Übertragungskonfiguration, des Auflistens von Übertragungskonfigurationen und des Aufrufs des Ausführungsverlaufs der Übertragung finden Sie unter Mit Übertragungen arbeiten.
- Daten mit cloudübergreifenden Vorgängen laden