Pianificare un trasferimento di ServiceNow

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Nota: per ricevere assistenza o fornire feedback per questa funzionalità, contatta [e-mail].

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 ServiceNow sono soggetti alle seguenti limitazioni:

• L'esecuzione simultanea di trasferimenti di dati sulla stessa istanza ServiceNow consigliato.
• L'intervallo di tempo minimo tra i trasferimenti di dati ricorrenti è di 15 minuti. L'intervallo predefinito per un trasferimento ricorrente è di 24 ore.

• ServiceNow consente di trasferire i dati di tabelle relative all'attività da tre applicazioni: Approvvigionamento, Catalogo dei prodotti e Gestione dei contratti. È 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:

  • Approvvigionamento
  • Catalogo dei prodotti
  • Gestione dei contratti

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 maggiori 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 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 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 nel set di dati di destinazione
• bigquery.datasets.update nel set di dati di destinazione

Potresti anche riuscire a ottenere queste autorizzazioni con ruoli personalizzati altri ruoli predefiniti.

Configura un trasferimento di dati ServiceNow

I trasferimenti di dati di ServiceNow possono essere creati nella console Google Cloud o nello strumento a riga di comando bq.

Console

1. Vai alla pagina Trasferimenti di dati nella console Google Cloud.

   Vai a Trasferimenti di dati

2. Fai clic su Crea trasferimento.

3. Nella sezione Tipo di origine, in Origine, seleziona ServiceNow.

4. 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 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 credenziali OAuth. Per generare le credenziali, consulta Creare le 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 Visualizza.

5. Nella sezione Impostazioni destinazione, per Set di dati, seleziona il creato per archiviare i dati.

6. Nella sezione Nome configurazione di trasferimento, per Nome visualizzato, inserisci un per il trasferimento di dati.

7. Nella sezione Opzioni di pianificazione, segui questi passaggi:

   • 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 Personalizzato. 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.

8. Nel menu Account di servizio, seleziona un account di servizio dagli account di servizio associati al tuo progetto Google Cloud. L'elemento selezionato l'account di servizio deve avere i ruoli richiesti per eseguire l'operazione 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 service account per il trasferimento è facoltativo.

   Per ulteriori informazioni sull'utilizzo degli account di servizio con i trasferimenti di dati, consulta Utilizzare gli account di servizio.

9. (Facoltativo) Nella sezione Opzioni di notifica, segui questi passaggi:

   • 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 di dati, 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.

10. 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 per la configurazione del trasferimento. Il nome del trasferimento di dati può essere qualsiasi valore che 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 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 del token OAuth generato
  connector.authentication.oauth.clientSecret	Obbligatorio	Client secret del token OAuth generato
  connector.valueType	Facoltativo	Actual o Display (valore predefinito: Actual)

  Ad esempio, il comando seguente crea un trasferimento di dati 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 il metodo projects.locations.transferConfigs.create e fornisci un'istanza della risorsa TransferConfig.

Risolvere i problemi di trasferimento

Per saperne di più, consulta la sezione 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'esito negativo dei trasferimenti di dati durante Approvvigionamento, Catalogo dei prodotti o Le applicazioni di gestione dei contratti non sono abilitate in ServiceNow. Per risolvere il problema, attiva tutte e tre le applicazioni. Ad esempio, attiva Approvvigionamento.

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

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.