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

Prerequisiti di BigQuery

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

  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, per Nome visualizzato, inserisci un nome del trasferimento.

  5. 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.

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

  7. 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.
  8. 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.

  9. (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.
  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 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 o Display (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