Pianifica un trasferimento 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].

BigQuery Data Transfer Service for ServiceNow consente di pianificare e gestire automaticamente i job di caricamento ricorrenti da ServiceNow a BigQuery.

Limitazioni

I trasferimenti ServiceNow sono soggetti alle seguenti limitazioni:

• Non è consigliabile eseguire trasferimenti simultanei sulla stessa istanza di ServiceNow.
• L'intervallo minimo tra un trasferimento ricorrente e l'altro è di 15 minuti. L'intervallo predefinito per un trasferimento ricorrente è di 24 ore.

• ServiceNow trasferisce le tabelle relative all'attività da tre applicazioni: Approvvigionamento, Catalogo prodotti e Gestione dei contratti. È possibile trasferire le seguenti tabelle:

  • 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 nell'istanza 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 l'archiviazione dei 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 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.

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare un trasferimento. Per visualizzare esattamente le autorizzazioni necessarie, 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 i ruoli personalizzati o altri ruoli predefiniti.

Configura un trasferimento di dati ServiceNow

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

Console

1. Nella console Google Cloud, vai alla pagina BigQuery.

   Vai a BigQuery

2. Fai clic su Trasferimenti di dati > Crea un trasferimento.

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

4. Nella sezione Nome configurazione di trasferimento, in Nome visualizzato, inserisci un nome per il trasferimento.

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

   • Nell'elenco Frequenza di ripetizione, seleziona un'opzione per specificare la frequenza di esecuzione di questo trasferimento. Per specificare una frequenza di ripetizione personalizzata, seleziona Personalizzata. Se selezioni On demand, questo trasferimento verrà 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.

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

7. Nella sezione Dettagli origine dati:

   • In ID istanza, inserisci l'ID istanza ServiceNow. Puoi recuperarlo dall'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 tue credenziali OAuth. Per generare le credenziali, consulta Creare credenziali OAuth.
   • In Client secret, inserisci il client secret indicato nelle credenziali OAuth.
   • 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.

8. Nel menu Account di servizio, seleziona un account di servizio dagli account di servizio associati al progetto Google Cloud. L'account di servizio selezionato deve disporre dei ruoli richiesti per eseguire questo trasferimento.

   Se hai eseguito l'accesso con un'identità federata, sarà necessario un account di servizio per creare un trasferimento. 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, vedi Utilizzare gli account di servizio.

9. (Facoltativo) Nella sezione Opzioni di notifica, procedi nel seguente modo:

   • Per attivare le notifiche via email, fai clic sul pulsante di attivazione/disattivazione Notifica via email. Se abiliti questa opzione, l'amministratore dei trasferimenti riceve una notifica via email quando un trasferimento non va a buon fine.
   • Per abilitare le notifiche di esecuzione del trasferimento Pub/Sub per questo trasferimento, fai clic sull'opzione di attivazione/disattivazione Notifiche Pub/Sub. Puoi selezionare il nome dell'argomento o fare 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 della configurazione di trasferimento. Il nome del trasferimento 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 di trasferimento.

• PARAMETERS: i parametri per la configurazione di trasferimento creata in formato JSON. Ad esempio: --params='{"param":"param_value"}'. Di seguito sono riportati i parametri per 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 o Display (valore predefinito: Actual)

  Ad esempio, il comando seguente crea un trasferimento 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 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 le applicazioni Approvvigionamento, Catalogo dei prodotti o Gestione dei contratti non sono abilitate in ServiceNow. Per risolvere il problema, abilita 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. Per risolvere il problema:

• Verifica che le credenziali dell'account ServiceNow, come Username, Password, Client ID 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 in 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 trasferimenti, tra cui la ricezione di informazioni sulla configurazione di trasferimento, l'elenco delle configurazioni di trasferimento e la visualizzazione della cronologia di esecuzione di un trasferimento, consulta la sezione Utilizzo dei trasferimenti.
• Scopri come caricare i dati con operazioni cross-cloud.