Pianifica un trasferimento ServiceNow
BigQuery Data Transfer Service for ServiceNow consente di pianificare e i job di caricamento ricorrenti da ServiceNow a BigQuery.
Limitazioni
I trasferimenti ServiceNow sono soggetti alle seguenti limitazioni:
- L'esecuzione di trasferimenti simultanei sulla stessa istanza ServiceNow non consigliato.
- L'intervallo minimo tra un trasferimento ricorrente e l'altro è di 15 minuti. La l'intervallo predefinito per un bonifico ricorrente è 24 ore.
ServiceNow trasferisce le tabelle relative all'attività da tre applicazioni: Approvvigionamento, Catalogo dei prodotti e Gestione dei contratti. Le seguenti che puoi trasferire:
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 ServiceNow, effettua le seguenti configurazioni per ServiceNow e BigQuery.
Prerequisiti di ServiceNow
- Per accedere alle API ServiceNow, crea le credenziali OAuth.
Le seguenti applicazioni ServiceNow devono essere tutte abilitate in ServiceNow istanza:
Prerequisiti di BigQuery
- Completa tutte le azioni richieste per attivare BigQuery Data Transfer Service.
- Crea un set di dati BigQuery per per archiviare i dati.
- Se intendi configurare le notifiche di esecuzione del trasferimento per Pub/Sub,
assicurati di avere l'
pubsub.topics.setIamPolicy
Autorizzazione IAM (Identity and Access Management). Se configuri solo l'email notifiche, le autorizzazioni Pub/Sub non sono necessarie. Per ulteriori informazioni 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
Ruolo IAM Amministratore BigQuery (roles/bigquery.admin
).
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.
Questo ruolo predefinito contiene le autorizzazioni necessarie per creare un trasferimento. Per vedere le autorizzazioni esatte obbligatorie, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per creare un trasferimento sono necessarie le seguenti autorizzazioni:
-
bigquery.transfers.update
sull'utente -
bigquery.datasets.get
sul set di dati di destinazione -
bigquery.datasets.update
sul set di dati di destinazione
Potresti anche riuscire a ottenere queste autorizzazioni con ruoli personalizzati e altri ruoli predefiniti.
Configura un trasferimento di dati ServiceNow
I trasferimenti di dati ServiceNow possono essere creati nella console Google Cloud o nella a riga di comando bq.
Console
Nella console Google Cloud, vai alla pagina BigQuery.
Fai clic su Trasferimenti di dati > Crea un trasferimento.
Nella sezione Tipo di origine, per Origine, seleziona ServiceNow.
Nella sezione Nome configurazione di trasferimento, per Nome visualizzato, inserisci un nome del trasferimento.
Nella sezione Opzioni di pianificazione, segui questi passaggi:
Nell'elenco Frequenza di ripetizione, seleziona un'opzione per specificare la spesso viene eseguito questo trasferimento. Per specificare una frequenza di ripetizione personalizzata, seleziona Personalizzato. Se selezioni On demand, questo trasferimento verrà eseguito quando il trasferimento viene attivato manualmente.
Se applicabile, seleziona Inizia ora o Inizia all'ora impostata. e specificare una data di inizio e un'ora di esecuzione.
Nella sezione Impostazioni destinazione, per Set di dati, seleziona il creato per archiviare i dati.
Nella sezione Dettagli origine dati:
- In ID istanza, inserisci l'ID istanza ServiceNow. Puoi ottenere
questo dal tuo URL ServiceNow, ad esempio
https://INSTANCE_ID.service-now.com
. - In Username (Nome utente), inserisci il nome utente ServiceNow da utilizzare per la connessione.
- Per Password, inserisci la password di ServiceNow.
- In ID client, inserisci l'ID client delle credenziali OAuth. A per generare le credenziali, consulta l'articolo Creare credenziali OAuth.
- In Client secret, inserisci il client secret di OAuth e credenziali.
- In Tipo di valore, scegli una delle seguenti opzioni:
- .
- Per trasferire i valori archiviati nel database, scegli Effettivo.
- Per trasferire i valori di visualizzazione delle colonne, scegli Display.
- In ID istanza, inserisci l'ID istanza ServiceNow. Puoi ottenere
questo dal tuo URL ServiceNow, ad esempio
Nel menu Account di servizio, seleziona un account di servizio del servizio associati al tuo progetto Google Cloud. L'elemento selezionato l'account di servizio deve avere i ruoli richiesti per eseguire l'operazione trasferimento.
Se hai eseguito l'accesso con un'identità federata: per creare un trasferimento è necessario un account di servizio. Se hai firmato con un Account Google, poi l'account di servizio per il trasferimento è facoltativo.
Per ulteriori informazioni sull'utilizzo degli account di servizio con i trasferimenti di dati, vedi Utilizzare gli account di servizio.
(Facoltativo) Nella sezione Opzioni di notifica, procedi nel seguente modo:
- Per attivare le notifiche via email, fai clic su Notifica email pulsante di attivazione/disattivazione. Quando abiliti questa opzione, l'amministratore dei trasferimenti riceve una notifica via email quando un trasferimento non va a buon fine.
- Per attivare Notifiche di esecuzione del trasferimento di Pub/Sub per questo trasferimento, fai clic sull'opzione di attivazione/disattivazione Notifiche Pub/Sub. Tu puoi selezionare argomento personalizzato oppure fai 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:
- (Facoltativo)
PROJECT_ID
: 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 esempio,servicenow
).DISPLAY_NAME
: il nome visualizzato del trasferimento configurazione. Il nome del trasferimento può essere qualsiasi valore che ti consenta di identificare il trasferimento se devi modificarlo in un secondo momento.DATASET
: set di dati di destinazione per il trasferimento configurazione.PARAMETERS
: i parametri per il trasferimento creato configurazione in formato JSON. Ad esempio:--params='{"param":"param_value"}'
. Di seguito sono riportati i parametri un trasferimento 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 del token OAuth generato connector.authentication.oauth.clientSecret
Obbligatorio Client secret del protocollo OAuth generato connector.valueType
Facoltativo Actual
oDisplay
(valore predefinito:Actual
)Ad esempio, il comando seguente crea un trasferimento ServiceNow 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 la projects.locations.transferConfigs.create
e fornisce un'istanza del metodo TransferConfig
risorsa.
Risolvere i problemi di trasferimento
Per ulteriori informazioni, consulta la sezione Risolvere i problemi relativi alle configurazioni di trasferimento.
Il trasferimento non riesce a causa dell'abilitazione di ServiceNow
Si verifica un problema che causa l'esito negativo dei trasferimenti quando Approvvigionamento, Catalogo dei prodotti o Le applicazioni di gestione dei contratti non sono abilitate in ServiceNow. Per risolvere il problema, per abilitare tutte e tre le applicazioni. Ad esempio, attiva Approvvigionamento.
Il problema si verifica durante l'esecuzione del trasferimento
Si verifica un problema a causa del quale l'esecuzione del trasferimento non viene creata come previsto. A risolvere il problema:
- Verifica che le credenziali dell'account ServiceNow, come Username, I valori Password, ID client e Client secret sono validi.
- Verifica che l'ID istanza sia l'ID valido della tua istanza ServiceNow.
Prezzi
Non è previsto alcun costo per il trasferimento dei dati ServiceNow BigQuery mentre questa funzionalità è in Anteprima.
Passaggi successivi
- Per una panoramica di BigQuery Data Transfer Service, consulta Introduzione a BigQuery Data Transfer Service.
- Per informazioni sull'utilizzo dei cambi, inclusa la ricerca di informazioni su un configurazione di trasferimento, elencare le configurazioni di trasferimento e visualizzare cronologia esecuzioni del trasferimento, vedi Utilizzo dei trasferimenti.
- Scopri come caricare i dati con operazioni cross-cloud.