Pianificare un trasferimento di ServiceNow
Il connettore BigQuery Data Transfer Service per ServiceNow consente di pianificare e gestire automaticamente i job di caricamento ricorrenti da ServiceNow in BigQuery.
Limitazioni
I trasferimenti di dati di ServiceNow sono soggetti alle seguenti limitazioni:
- Non è consigliabile eseguire trasferimenti di dati simultanei sulla stessa istanza ServiceNow.
- L'intervallo di tempo minimo tra i trasferimenti di dati ricorrenti è di 15 minuti. L'intervallo predefinito per un trasferimento ricorrente è di 24 ore.
I dati di ServiceNow trasferiscono le tabelle correlate all'attività da tre applicazioni: Procurement, Product Catalog e Contract Management. È possibile trasferire le seguenti tabella:
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
Prima di iniziare
Prima di creare un trasferimento di dati di ServiceNow, esegui le seguenti configurazioni per ServiceNow e BigQuery.
Prerequisiti di ServiceNow
- Per accedere alle API ServiceNow, crea le credenziali OAuth.
Nell'istanza ServiceNow devono essere attivate tutte le seguenti applicazioni ServiceNow:
Prerequisiti di BigQuery
- Completa tutte le azioni necessarie per abilitare BigQuery Data Transfer Service.
- Crea un set di dati BigQuery per memorizzare i dati.
- Se intendi configurare le notifiche di esecuzione del trasferimento per Pub/Sub, assicurati di disporre dell'autorizzazione
pubsub.topics.setIamPolicy
Identity and Access Management (IAM). Se configuri solo le notifiche via email, le autorizzazioni Pub/Sub non sono necessarie. Per ulteriori informazioni, consulta Notifiche di esecuzione di BigQuery Data Transfer Service.
Ruoli BigQuery obbligatori
Per ottenere le autorizzazioni necessarie per creare un trasferimento,
chiedi all'amministratore di concederti il ruolo IAM Amministratore BigQuery (roles/bigquery.admin
).
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.
Questo ruolo predefinito contiene le autorizzazioni necessarie per creare un trasferimento. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:
Autorizzazioni obbligatorie
Per creare un trasferimento sono necessarie le seguenti autorizzazioni:
-
bigquery.transfers.update
sull'utente -
bigquery.datasets.get
nel set di dati di destinazione -
bigquery.datasets.update
nel set di dati di destinazione
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Configurare un trasferimento di dati di ServiceNow
I trasferimenti di dati di ServiceNow possono essere creati nella console Google Cloud o nello strumento a riga di comando bq.
Console
Vai alla pagina Trasferimenti dati nella console Google Cloud.
Fai clic su
Crea trasferimento.Nella sezione Tipo di origine, in Origine, seleziona ServiceNow.
Nella sezione Dettagli origine dati:
- In ID istanza, inserisci l'ID istanza ServiceNow. Puoi recuperarlo dall'URL di ServiceNow, ad esempio
https://INSTANCE_ID.service-now.com
. - In Nome utente, inserisci il nome utente ServiceNow da utilizzare per la connessione.
- In Password, inserisci la password di ServiceNow.
- In ID client, inserisci l'ID client delle tue credenziali OAuth. Per generare le credenziali, consulta Creare le credenziali OAuth.
- In Client secret, inserisci il client secret dalle tue credenziali OAuth.
- In Tipo di valore, scegli una delle seguenti opzioni:
- Per trasferire i valori memorizzati nel database, scegli Reale.
- Per trasferire i valori di visualizzazione delle colonne, scegli Visualizza.
- In ID istanza, inserisci l'ID istanza ServiceNow. Puoi recuperarlo dall'URL di ServiceNow, ad esempio
Nella sezione Impostazioni di destinazione, per Set di dati, seleziona il set di dati che hai creato per archiviare i dati.
Nella sezione Nome configurazione di trasferimento, in Nome visualizzato, inserisci un nome per il trasferimento dei dati.
Nella sezione Opzioni di programmazione:
Nell'elenco Frequenza di ripetizione, seleziona un'opzione per specificare la frequenza con cui viene eseguito questo trasferimento di dati. Per specificare una frequenza di ripetizione personalizzata, seleziona Personalizzata. Se selezioni On demand, questo trasferimento di dati viene eseguito quando attivi manualmente il trasferimento.
Se applicabile, seleziona Inizia ora o Inizia all'ora impostata e fornisci una data di inizio e un'ora di esecuzione.
Nel menu Account di servizio, seleziona un account di servizio dagli account di servizio associati al tuo progetto Google Cloud. L'account di servizio selezionato deve disporre dei ruoli richiesti per eseguire questo trasferimento di dati.
Se hai eseguito l'accesso con un'identità federata, è necessario un account di servizio per creare un trasferimento di dati. Se hai eseguito l'accesso con un Account Google, un account di servizio per il trasferimento è facoltativo.
Per ulteriori informazioni sull'utilizzo degli account di servizio con i trasferimenti di dati, consulta Utilizzare gli account di servizio.
(Facoltativo) Nella sezione Opzioni di notifica, segui questi passaggi:
- Per attivare le notifiche via email, fai clic sull'opzione di attivazione/disattivazione Notifica via email. Quando attivi questa opzione, l'amministratore dei trasferimenti riceve una notifica via email quando un'esecuzione del trasferimento non va a buon fine.
- Per attivare le notifiche di esecuzione del trasferimento Pub/Sub per questo trasferimento di dati, fai clic sul pulsante di attivazione/disattivazione Notifiche Pub/Sub. Puoi selezionare il nome del tuo argomento oppure fare clic su Crea un argomento per crearne uno.
Fai clic su Salva.
bq
Inserisci il comando bq mk
e fornisci il flag di creazione del trasferimento --transfer_config
:
bq mk \
--transfer_config \
--project_id=PROJECT_ID \
--data_source=DATA_SOURCE \
--display_name=DISPLAY_NAME \
--target_dataset=DATASET \
--params='PARAMETERS'
Sostituisci quanto segue:
PROJECT_ID
(facoltativo): l'ID del tuo progetto Google Cloud. Se non viene specificato un ID progetto, viene utilizzato il progetto predefinito.DATA_SOURCE
: l'origine dati (ad es.servicenow
).DISPLAY_NAME
: il nome visualizzato per la configurazione del trasferimento. Il nome del trasferimento dati può essere qualsiasi valore che ti consenta di identificare il trasferimento se devi modificarlo in un secondo momento.DATASET
: il set di dati di destinazione per la configurazione del trasferimento.PARAMETERS
: i parametri per la configurazione del trasferimento creata in formato JSON. Ad esempio:--params='{"param":"param_value"}'
. Di seguito sono riportati i parametri per un trasferimento di dati ServiceNow:Parametro ServiceNow Obbligatorio o facoltativo Descrizione connector.instanceId
Obbligatorio ID istanza dell'istanza ServiceNow connector.authentication.username
Obbligatorio Nome utente delle credenziali connector.authentication.password
Obbligatorio Password delle credenziali connector.authentication.oauth.clientId
Obbligatorio ID client dell'OAuth generato connector.authentication.oauth.clientSecret
Obbligatorio Client secret dell'OAuth generato connector.valueType
Facoltativo Actual
oDisplay
(valore predefinito:Actual
)Ad esempio, il seguente comando crea un trasferimento di dati ServiceNow nel progetto predefinito con tutti i parametri richiesti:
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
Utilizza il metodo projects.locations.transferConfigs.create
e fornisci un'istanza della risorsa TransferConfig
.
Risolvere i problemi di trasferimento
Per ulteriori informazioni, consulta Risolvere i problemi relativi alle configurazioni di trasferimento.
Il trasferimento non riesce a causa dell'attivazione di ServiceNow
Si verifica un problema che causa l'interruzione dei trasferimenti di dati quando le applicazioni Procurement, Catalogo dei prodotti o Contract Management non sono attivate in ServiceNow. Per risolvere il problema, attiva tutte e tre le applicazioni. Ad esempio, attiva Procurement.
Si verifica un problema durante l'esecuzione del trasferimento
Si verifica un problema che impedisce la creazione dell'esecuzione del trasferimento come previsto. Per risolvere il problema:
- Verifica che le credenziali dell'account ServiceNow, ad esempio Nome utente, Password, ID client e Client secret, siano valide.
- Verifica che l'ID istanza sia l'ID valido della tua istanza ServiceNow.
Prezzi
Il trasferimento dei dati di ServiceNow in BigQuery non prevede costi mentre questa funzionalità è in fase di anteprima.
Passaggi successivi
- Per una panoramica di BigQuery Data Transfer Service, consulta Introduzione a BigQuery Data Transfer Service.
- Per informazioni sull'utilizzo dei trasferimenti, tra cui come ottenere informazioni su una configurazione di trasferimento, elencare le configurazioni di trasferimento e visualizzare la cronologia di esecuzione di un trasferimento, consulta Utilizzare i trasferimenti.
- Scopri come caricare i dati con operazioni cross-cloud.