Installa e configura BigQuery Connector per SAP su una VM di Compute Engine

Questa guida mostra come installare e configurare la versione 2.7 (ultima) di BigQuery Connector per SAP in un SAP LT Replication Server in esecuzione su una macchina virtuale (VM) Compute Engine su Google Cloud.

Questa guida spiega come preparare BigQuery, SAP Landscape Transformation Replication Server (SAP LT Replication Server) e BigQuery Connector per SAP per replicare i dati SAP dalle applicazioni SAP in modo diretto e sicuro in BigQuery in tempo reale.

Questa guida è rivolta agli amministratori SAP, Google Cloud e altre risorse per la sicurezza professionisti.

Prerequisiti

Prima di installare BigQuery Connector per SAP, assicurati che i seguenti prerequisiti siano soddisfatti:

  • Hai letto la guida alla pianificazione di BigQuery Connector per SAP. La guida alla pianificazione spiega le opzioni di BigQuery Connector per SAP, le considerazioni sulle prestazioni, la mappatura dei campi e altre informazioni necessarie per la configurazione ottimale di BigQuery Connector per SAP.
  • Se non hai ancora un progetto Google Cloud, creane uno:

    Vai al selettore dei progetti

  • La fatturazione è abilitata per il tuo progetto. Scopri come verificare che la fatturazione sia abilitate per il tuo progetto. È necessario un account di fatturazione per l'API di streaming BigQuery, per BigQuery e per scaricare BigQuery Connector per SAP.

  • La manutenzione del software SAP installato è aggiornata e le versioni di tutti i software SAP sono compatibili tra loro, come documentato nella matrice di disponibilità dei prodotti SAP.

  • Le versioni del software SAP che stai utilizzando sono supportate dal BigQuery Connector per SAP, come documentato in Requisiti software.

  • Hai le licenze SAP corrette necessarie per replicare i dati in qualsiasi target tramite l'SDK SAP LT Replication Server. Per ulteriori informazioni sulle licenze SAP, consulta la nota SAP 2707835.

  • SAP LT Replication Server è installato. Per informazioni sull'installazione di SAP LT Replication Server, consulta la documentazione SAP.

  • La connessione RFC o del database tra SAP LT Replication Server e il sistema di origine è configurata. Se necessario, testa le connessioni RFC utilizzando la transazione SAPSM59. Testa le connessioni ai database utilizzando la transazione SAP DBACOCKPIT.

Panoramica del processo di installazione e configurazione

La seguente tabella mostra le procedure trattate in questa guida e i ruoli che in genere le eseguono.

Procedura Ruolo
Se necessario, dopo aver convalidato tutte le licenze SAP appropriate, segui le istruzioni di SAP per installare un server di replica SAP Landscape Transformation. Amministratore SAP.
Se necessario, installa il componente aggiuntivo dell'interfaccia utente (UI) per SAP NetWeaver. Per ulteriori informazioni, consulta Requisiti delle versioni del software SAP. Amministratore SAP.
Abilita le API Google Cloud richieste. Amministratore Google Cloud.
Se necessario, installa l'interfaccia a riga di comando gcloud sull'hosting SAP LT Replication Server. Amministratore SAP.
Crea un set di dati BigQuery. amministratore o data engineer di Google Cloud.
Configura l'autenticazione e l'autorizzazione di Google Cloud. Amministratore della sicurezza di Google Cloud.
Scarica il pacchetto di installazione BigQuery Connector per SAP SAP. Titolare dell'account di fatturazione Google Cloud.
Installa BigQuery Connector per SAP. Amministratore SAP.
Crea i ruoli e le autorizzazioni SAP per BigQuery Connector per SAP. Amministratore SAP.
Configura la replica. Data engineer o amministratori.
Esegui la verifica della replica. Data engineer o amministratori.
Convalida la replica. Data engineer o amministratori.

Abilita le API Google Cloud richieste

Prima che BigQuery Connector per SAP possa accedere a BigQuery, devi abilitare le seguenti API Google Cloud:

  • L'API BigQuery
  • API IAM Service Account Credentials

Per informazioni su come abilitare le API Google Cloud, consulta Abilitazione delle API.

Installa l'interfaccia a riga di comando gcloud

Per la replica in BigQuery, l'account sidadm dell'utente deve avere accesso a Google Cloud CLI (gcloud CLI) sull'host di SAP LT Replication Server.

L'interfaccia a riga di comando gcloud è installata per impostazione predefinita sulla maggior parte delle VM Compute Engine. Puoi confermarne l'installazione emettendo gcloud components list. Se il comando non viene riconosciuto, devi installare con gcloud CLI.

Un amministratore SAP può installare gcloud CLI.

Per installare gcloud CLI, completa questi passaggi:

  1. Segui le istruzioni di installazione di gcloud CLI.

  2. Segui le istruzioni di configurazione di gcloud CLI.

  3. Autorizza l'account utente sidadm ad accedere a nella directory di installazione di gcloud CLI.

  4. Se vuoi, come sidadm, imposta il progetto predefinito per gcloud CLI:

    gcloud config set project PROJECT_ID

    Sostituisci PROJECT_ID con l'ID del progetto contenente il set di dati BigQuery. Ad esempio, example-project-123456.

    Se non imposti un progetto predefinito per l'interfaccia a riga di comando gcloud, la proprietà --project deve essere specificata in ogni comando gcloud emesso.

Per ulteriori informazioni sul requisito di BigQuery Connector per SAP per il gcloud CLI, consulta il requisito dell'interfaccia a riga di comando gcloud.

Crea un set di dati BigQuery

Prima di poter testare l'autenticazione e l'autorizzazione di Google Cloud per BigQuery o crea BigQuery di destinazione tabelle, è necessario che tu o un data engineer o un amministratore creiate set di dati BigQuery.

Per creare un set di dati BigQuery, il tuo account utente deve disporre delle autorizzazioni IAM appropriate per BigQuery. Per ulteriori informazioni, consulta la sezione Autorizzazioni obbligatorie.

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

    Vai a BigQuery

  2. Accanto all'ID progetto, fai clic sull'icona Visualizza azioni, quindi su Crea set di dati.

    Il diagramma è descritto nel testo precedente

  3. Nel campo ID set di dati, inserisci un nome univoco. Per ulteriori informazioni, consulta Nominare i set di dati.

Dopo aver configurato l'autenticazione e l'autorizzazione di Google Cloud, prova l'accesso a Google Cloud recuperando informazioni su questo set di dati.

Per ulteriori informazioni sulla creazione di set di dati BigQuery, consulta Creare set di dati.

Configurare l'autenticazione e l'autorizzazione di Google Cloud

Per l'autenticazione in Google Cloud e l'autorizzazione all'accesso BigQuery, un amministratore della sicurezza di Google Cloud un amministratore SAP deve:

  • Creare un account di servizio per BigQuery Connector per SAP.
  • Concedi all'account di servizio i ruoli IAM necessari per accedere a BigQuery.
  • Aggiungi l'account di servizio BigQuery Connector per SAP come entità nel progetto BigQuery.
  • Configura le impostazioni di sicurezza per Google Cloud sull'host del server di replica SAP LT:
    • Concedi alla VM host l'autorizzazione per ottenere i token di accesso.
    • Se necessario, modifica gli ambiti di accesso API della VM host.

Crea un account di servizio

BigQuery Connector per SAP richiede una Account di servizio IAM per autenticazione e autorizzazione per accedere a BigQuery.

Questo account di servizio deve essere un'entità nel progetto Google Cloud che contiene il tuo set di dati BigQuery. Se crei l'account di servizio nello stesso progetto di BigQuery l'account di servizio viene aggiunto come entità al progetto automaticamente.

Se crei l'account di servizio in un progetto diverso da quello che contiene il set di dati BigQuery, devi aggiungerlo al progetto del set di dati BigQuery in un passaggio aggiuntivo.

Per creare un account di servizio, completa i seguenti passaggi:

  1. Nella console Google Cloud, vai alla sezione IAM e Account di servizio amministratore .

    Vai ad Account di servizio

  2. Se richiesto, seleziona il tuo progetto Google Cloud.

  3. Fai clic su Crea account di servizio.

  4. Specifica un nome per l'account di servizio e, facoltativamente, una descrizione.

  5. Fai clic su Crea e continua.

  6. Se crei l'account di servizio nello stesso progetto della Set di dati BigQuery, nella sezione Concedi a questo account di servizio accesso al progetto, seleziona i ruoli seguenti:

    • Editor dati BigQuery
    • Utente job BigQuery

    Se crei l'account di servizio in un progetto diverso da quello del set di dati BigQuery, non concedere alcun ruolo all'account di servizio.

  7. Fai clic su Continua.

  8. Se opportuno, concedi ad altri utenti l'accesso all'account di servizio.

  9. Fai clic su Fine. L'account di servizio viene visualizzato nell'elenco dei servizi per il progetto.

  10. Se hai creato l'account di servizio in un progetto diverso da quello che contiene il set di dati BigQuery, prendi nota del nome dell'account di servizio. Il nome viene specificato quando aggiungi il servizio al progetto BigQuery. Per ulteriori informazioni, consulta Aggiungere l'account di servizio al progetto BigQuery.

L'account di servizio ora è elencato come entità nella pagina Autorizzazioni IAM del progetto Google Cloud in cui è stato creato.

Aggiungi l'account di servizio al progetto BigQuery

Se hai creato l'account di servizio per BigQuery Connector per SAP in un progetto diverso da quello che contiene il set di dati BigQuery di destinazione, devi aggiungerlo al progetto del set di dati BigQuery.

Se hai creato l'account di servizio nello stesso progetto del set di dati BigQuery, puoi saltare questo passaggio.

Aggiungere un account di servizio esistente al set di dati BigQuery. completa i seguenti passaggi:

  1. Nella console Google Cloud, vai alla pagina Permissions (Autorizzazioni) di IAM:

    Vai alle autorizzazioni IAM

  2. Verifica che il nome del progetto contenente il set di dati BigQuery di destinazione sia visualizzato nella parte superiore della pagina. Ad esempio:

    Autorizzazioni per il progetto "PROJECT_NAME"

    In caso contrario, cambia progetto.

  3. Nella pagina IAM, fai clic su Aggiungi. Si apre la finestra di dialogo Aggiungi entità a "PROJECT_NAME".

  4. Nella finestra di dialogo Aggiungi entità a "PROJECT_NAME", compila i seguenti passaggi:

    1. Nel campo Nuove entità, specifica il nome dell'account di servizio.
    2. Nel campo Seleziona un ruolo, specifica Editor dati BigQuery.
    3. Fai clic su AGGIUNGI UN ALTRO RUOLO. Viene visualizzato il campo Seleziona un ruolo di nuovo.
    4. Nel campo Seleziona un ruolo, specifica Utente job BigQuery.
    5. Fai clic su Salva. L'account di servizio viene visualizzato nell'elenco dei principali del progetto nella pagina IAM.

Ora l'account di servizio può essere utilizzato per accedere al set di dati BigQuery in questo progetto.

Configura la sicurezza sulla VM host

BigQuery Connector per SAP richiede che Da configurare la VM di Compute Engine che ospita il server di replica SAP LT con le seguenti opzioni di sicurezza:

  • Gli ambiti di accesso della VM host devono essere impostati per consentire l'accesso completo alle API Cloud.
  • L'account di servizio della VM host deve includere i dati IAM Creatore token account di servizio.

Se queste opzioni non sono configurate sulla VM host, devi configurarle.

Per modificare gli ambiti di accesso di una VM, devi arrestarla.

Controlla gli ambiti di accesso API della VM host

Controlla l'impostazione dell'ambito di accesso corrente della VM host del server di replica SAP LT. Se la VM ha già accesso completo a tutte le API Cloud, non è necessario modificare gli ambiti di accesso.

Per controllare l'ambito di accesso di una VM host:

Console Google Cloud

  1. Nella console Google Cloud, apri la pagina Istanze VM:

    Vai a Istanze VM

  2. Se necessario, seleziona il progetto Google Cloud che contiene Host del server di replica SAP LT.

  3. Nella pagina delle istanze VM, fai clic sul nome della VM host. Viene visualizzata la pagina dei dettagli della VM.

  4. In Gestione API e identità nella pagina dei dettagli della VM host, controlla l'impostazione corrente degli ambiti di accesso alle API Cloud:

    • Se l'impostazione è Consenti l'accesso completo a tutte le API Cloud, è corretta e non devi modificarla.
    • Se l'impostazione non è Consenti l'accesso completo a tutte le API di Cloud, devi arrestare la VM e modificare l'impostazione. Per istruzioni, vedi nella prossima sezione.

Interfaccia a riga di comando gcloud

  1. Mostra gli ambiti di accesso attuali della VM host:

    gcloud compute instances describe VM_NAME --zone=VM_ZONE --format="yaml(serviceAccounts)"

    Se gli ambiti di accesso non includono https://www.googleapis.com/auth/cloud-platform, devi modificare gli ambiti di accesso della VM host. Ad esempio, se dovessi creare un'istanza VM con un account di servizio Compute Engine predefinito, dovresti modificare i seguenti ambiti di accesso predefiniti:

    serviceAccounts:
    - email: 600915385160-compute@developer.gserviceaccount.com
      scopes:
      - https://www.googleapis.com/auth/devstorage.read_only
      - https://www.googleapis.com/auth/logging.write
      - https://www.googleapis.com/auth/monitoring.write
      - https://www.googleapis.com/auth/servicecontrol
      - https://www.googleapis.com/auth/service.management.readonly
      - https://www.googleapis.com/auth/trace.append

    Se l'unico ambito elencato in scopes è https://www.googleapis.com/auth/cloud-platform, come riportato di seguito Ad esempio, non è necessario modificare gli ambiti:

    serviceAccounts:
    - email: 600915385160-compute@developer.gserviceaccount.com
      scopes:
      - https://www.googleapis.com/auth/cloud-platform

Modifica gli ambiti di accesso API della VM host

Se la VM host di SAP LT Replication Server non ha accesso completo alle API Google Cloud, modifica gli ambiti di accesso per consentire l'accesso completo a tutte le API Cloud.

Per modificare l'impostazione degli ambiti di accesso all'API Cloud per una VM host, completa i seguenti passaggi:

Console Google Cloud

  1. Se necessario, limita i ruoli concessi all'account di sicurezza della VM host.

    Puoi trovare il nome dell'account di sicurezza nella pagina dei dettagli di VM host in Gestione di API e identità. Puoi cambiare i ruoli concessi a un account di servizio nella console Google Cloud della pagina IAM in Entità.

  2. Se necessario, arresta i carichi di lavoro in esecuzione sulla VM host.

  3. Nella console Google Cloud, apri la pagina Istanze VM:

    Vai a Istanze VM

  4. Nella pagina dell'istanza VM, fai clic sul nome della VM host per aprire la pagina dei dettagli della VM.

  5. Nella parte superiore della pagina dei dettagli della VM host, arresta la VM host facendo clic INTERROMPI.

  6. Una volta arrestata la VM, fai clic su MODIFICA.

  7. In Sicurezza e accesso > In Ambiti di accesso, seleziona Consenti l'accesso completo a tutte le API Cloud.

  8. Fai clic su Salva.

  9. Nella parte superiore della pagina dei dettagli della VM host, avvia la VM host facendo clic AVVIA/RIPRENDI.

  10. Se necessario, riavvia i carichi di lavoro arrestati sulla VM host.

Interfaccia a riga di comando gcloud

  1. Se necessario, modifica i ruoli IAM concessi all'account di servizio della VM per assicurarti che l'accesso ai servizi Google Cloud dalla VM host sia limitato in modo appropriato.

    Per informazioni su come modificare i ruoli concessi a un account di servizio, consulta Aggiornare un account di servizio.

  2. Se necessario, arresta qualsiasi software SAP in esecuzione sulla VM host.

  3. Arresta la VM:

    gcloud compute instances stop VM_NAME --zone=VM_ZONE
  4. Modifica gli ambiti di accesso della VM:

    gcloud compute instances set-service-account VM_NAME --scopes=cloud-platform --zone=VM_ZONE
  5. Avvia la VM:

    gcloud compute instances start VM_NAME --zone=VM_ZONE
  6. Se necessario, avvia il software SAP in esecuzione sulla VM host.

Abilita la VM host per ottenere i token di accesso

Devi concedere all'account di servizio dell'autorizzazione della VM host per ottenere I token di accesso richiesti da BigQuery Connector per SAP in BigQuery.

Per concedere l'autorizzazione alla creazione di token di accesso, completa i seguenti passaggi:

  1. Nella console Google Cloud, apri la pagina Istanze VM:

    Vai a Istanze VM

  2. Nella pagina dell'istanza VM, fai clic sul nome della VM host per aprire la pagina dei dettagli della VM.

  3. Nella pagina dei dettagli della VM, in Gestione di API e identità, prendi nota del nome dell'account di servizio. Nell'esempio che segue nome corrisponde a un account di servizio Compute Engine predefinito:

    SVC-ACCT-NUMBER-compute@developer.gserviceaccount.com
  4. Nella console Google Cloud, vai alla pagina IAM:

    Vai alle autorizzazioni IAM

  5. Nell'elenco delle entità del progetto, trova il nome dell'account di servizio fai clic su Modifica entità. Viene visualizzata la finestra di dialogo Modifica autorizzazioni.

  6. Nella finestra di dialogo Modifica autorizzazioni, fai clic su AGGIUNGI UN ALTRO RUOLO. La Viene visualizzato il campo Seleziona un ruolo.

  7. Nel campo Seleziona un ruolo, specifica Creatore token account di servizio.

  8. Fai clic su Salva. Tornerai a IAM pagina delle autorizzazioni.

La VM host ora ha l'autorizzazione per creare token di accesso.

Configurare i certificati SSL e HTTPS

Comunicazione tra BigQuery Connector per SAP e BigQuery L'API è protetta tramite SSL e HTTPS.

  1. Scarica i seguenti certificati dal repository di Google Trust Services:

    • GTS Root R1
    • GTS CA 1C3
  2. Nella GUI di SAP, utilizza la transazione STRUST per importare sia l'elemento principale certificato subordinato nel SSL client SSL Client (Standard) PSE .

    Per ulteriori informazioni da SAP, consulta la guida di SAP - Mantenere PSE Elenco delle certificazioni.

  3. Sull'host SAP LT Replication Server, verifica che eventuali regole firewall o sono configurati in modo da consentire il traffico in uscita dalla porta HTTPS l'API BigQuery.

    In particolare, SAP LT Replication Server deve essere in grado di accedere ai seguenti API Google Cloud:

    • https://bigquery.googleapis.com
    • https://iamcredentials.googleapis.com

    Se vuoi che BigQuery Connector per SAP acceda alle API Google Cloud attraverso gli endpoint Private Service Connect sulla rete VPC, allora devi configurare le destinazioni RFC e Specificare gli endpoint Private Service Connect nelle destinazioni RFC. Per ulteriori informazioni, consulta Destinazioni RFC.

Per ulteriori informazioni da SAP sulla configurazione di SSL, consulta la Nota SAP 510007 - Ulteriori considerazioni per la configurazione di SSL su Application Server ABAP.

Convalida le porte HTTP e HTTPS in Internet Communication Manager (ICM)

I metadati della VM vengono archiviati su un server metadati a cui è possibile accedere solo tramite una porta HTTP. Pertanto, devi assicurarti che una porta HTTP e una porta HTTPS siano create e attive per accedere ai metadati della VM.

  1. In SAP GUI, inserisci il codice transazione SMICM.
  2. Nella barra dei menu, fai clic su Vai > Servizi. Un segno di spunta verde nella colonna Actv indica che le porte HTTP e HTTPS sono attive.

Per informazioni sulla configurazione delle porte HTTP e HTTPS, consulta Impostazioni HTTP(S) in ICM.

Testare l'autenticazione e l'autorizzazione di Google Cloud

Verifica di aver configurato correttamente l'autenticazione Google Cloud richiedendo un token di accesso e recuperando le informazioni sul tuo set di dati BigQuery.

Utilizza la seguente procedura per verificare l'autenticazione e l'autorizzazione di Google Cloud dalla VM host SAP LT Replication Server:

  1. Nella VM host SAP LT Replication Server, apri una shell a riga di comando.

  2. Passa all'utente sidadm.

  3. Richiedi il primo token di accesso dal server dei metadati della VM host:

    curl "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/token" -H "Metadata-Flavor: Google"

    Il server dei metadati restituisce un token di accesso simile al nell'esempio seguente, in cui ACCESS_TOKEN_STRING_1 è una stringa del token di accesso che copi nel comando passaggio successivo:

    {"access_token":"ACCESS_TOKEN_STRING_1",
    "expires_in":3599,"token_type":"Bearer"}
  4. Richiedi il secondo token di accesso dall'API IAM emettendo il seguente comando dopo aver sostituito i valori segnaposto:

    Linux

    curl --request POST \
    "https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/SERVICE_ACCOUNT:generateAccessToken" \
      --header "Authorization: Bearer ACCESS_TOKEN_STRING_1" \
      --header "Accept: application/json" \
      --header "Content-Type: application/json" \
      --data "{"scope":["https://www.googleapis.com/auth/bigquery"],"lifetime":"300s"}" \
      --compressed
    

    Windows

    curl --request POST `
    "https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/SERVICE_ACCOUNT:generateAccessToken" `
      --header "Authorization: Bearer ACCESS_TOKEN_STRING_1" `
      --header "Accept: application/json" `
      --header "Content-Type: application/json" `
      --data "{"scope":["https://www.googleapis.com/auth/bigquery"],"lifetime":"300s"}" `
      --compressed
    

    Sostituisci quanto segue:

    • SERVICE_ACCOUNT: l'account di servizio creato per BigQuery Connector per SAP in un passaggio precedente.
    • ACCESS_TOKEN_STRING_1: la prima stringa del token di accesso del passaggio precedente.

    L'API IAM restituisce un secondo token di accesso,ACCESS_TOKEN_STRING_2, simile all'esempio riportato di seguito. Nel passaggio successivo, copia questa seconda stringa di token in una richiesta all'API BigQuery.

    {"access_token":"ACCESS_TOKEN_STRING_2","expires_in":3599,"token_type":"Bearer"}
  5. Recupera le informazioni sul tuo set di dati BigQuery dall'API BigQuery emettendo il seguente comando dopo aver sostituito i valori segnaposto:

    Linux

    curl "https://bigquery.googleapis.com/bigquery/v2/projects/PROJECT_ID/datasets/DATASET_NAME" \
    -H "Accept: application/json" -H "Authorization: Bearer ACCESS_TOKEN_STRING_2"
    

    Windows

    curl "https://bigquery.googleapis.com/bigquery/v2/projects/PROJECT_ID/datasets/DATASET_NAME" `
    -H "Accept: application/json" -H "Authorization: Bearer ACCESS_TOKEN_STRING_2"
    

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del progetto che contiene il set di dati BigQuery.
    • DATASET_NAME: il nome del set di dati di destinazione come definito in BigQuery.
    • ACCESS_TOKEN_STRING_2: la stringa del token di accesso restituito dall'API IAM nel passaggio precedente.

    Se l'autenticazione Google Cloud è configurata correttamente, vengono restituite le informazioni sul set di dati.

    Se non è configurato correttamente, consulta Connettore BigQuery per SAP risoluzione dei problemi.

Scarica il pacchetto di installazione

Scarica il pacchetto di installazione di BigQuery Connector per SAP più recente dal portale di download di BigQuery Connector per SAP.

Per completare il download, devi disporre del tuo numero di fatturazione Cloud. Per informazioni sugli account di fatturazione, consulta Fatturazione Cloud e profilo pagamenti.

Il pacchetto di installazione include i file di trasporto che devi copiare nella directory di trasporto appropriata per SAP LT Replication Server.

Installa BigQuery Connector per SAP

Dopo aver ricevuto il pacchetto di installazione Connettore BigQuery per file di trasporto SAP, l'amministratore SAP può installare BigQuery Connector per SAP importando il trasportare i file in SAP LT Replication Server.

Il trasporto SAP per BigQuery Connector per SAP contiene tutti gli oggetti necessari per BigQuery Connector per SAP, tra cui lo spazio dei nomi /GOOG/, gli oggetti DDIC, l'implementazione e le classi BADI dell'SDK SLT, i programmi di report e altro ancora.

Prima di importare i file di trasporto in SAP LT Replication Server, verifica che il server di replica SAP LT è supportato da BigQuery Connector per SAP, come documentato nei Requisiti software.

Nonostante l'utilizzo di una versione supportata di SAP LT Replication Server, in alcuni casi, durante l'importazione dei file di trasporto, potresti visualizzare il messaggio di erroreRequests do not match the component version of the target system. In tale casi, devi reimportare i file di trasporto SAP LT Replication Server e durante la reimportazione, Schermata Import Transport Request (Importa richiesta di trasporto), vai alla scheda Options (Opzioni) e seleziona la casella di controllo Ignora versione componente non valida.

La procedura riportata di seguito è una procedura generale. Ogni sistema SAP è diverso, quindi collabora con l'amministratore SAP per determinare eventuali modifiche alla procedura che potrebbero essere necessarie per il tuo sistema SAP:

  1. Copia i file di trasporto di BigQuery Connector per SAP nelle seguenti directory di importazione del trasporto di SAP LT Replication Server:

    • /usr/sap/trans/cofiles/KXXXXXX.ED1
    • /usr/sap/trans/data/RXXXXXX.ED1

    Negli esempi precedenti, XXXXXX rappresenta il nome del file numerato.

  2. Nella GUI di SAP, utilizza il codice transazione STMS_IMPORT o STMS per importare i file nel sistema SAP.

  3. Assicurati che tutti gli oggetti in /GOOG/SLT_SDK sono attivi e coerenti:

    1. Nell'interfaccia SAP, inserisci il codice transazione SE80.
    2. Nel selettore dei pacchetti, seleziona /GOOG/SLT_SDK.
    3. Nel campo Nome oggetto, fai clic con il tasto destro del mouse sul pacchetto /GOOG/SLT_SDK, poi scegli Seleziona > Pacchetto Seleziona > Oggetti del pacchetto.

      Un segno di spunta verde nella colonna Risultato indica che tutti gli oggetti hanno superato il controllo del pacchetto.

Verifica che BigQuery Connector per SAP sia pronto per la configurazione

Per confermare ulteriormente che i file di trasporto sono stati importati correttamente e che BigQuery Connector per SAP sia pronto configurare, confermare che il componente aggiuntivo BigQuery Connector per SAP Business (BAdI) sia attiva e che BigQuery Connector per SAP le applicazioni di replica contengono voci nella tabella IUUC_REPL_APPL.

  1. Controlla l'implementazione di BAdI:
    1. Utilizza la transazione SE80 per accedere alla /GOOG/EI_IUUC_REPL_RUNTIME_BQ cartella dell'oggetto di miglioramento e selezionarla.
    2. Seleziona Migliora. Elementi di implementazione sul lato destro della pagina.
    3. In Comportamento di runtime, verifica che l'opzione Implementazione sia attiva sia selezionata.
  2. Controlla le applicazioni di replica:
    1. Utilizzando il Browser dei dati di SAP o la transazione SE16, visualizza la tabella IUUC_REPL_APPL.
    2. Verifica che le seguenti applicazioni appaiano nella tabella IUUC_REPL_APPL:
      • /GOOG/SLT_BQ
      • ZGOOG_SLT_BQ, da utilizzare quando lo spazio dei nomi /GOOG/ non è registrato

Creare ruoli e autorizzazioni SAP per BigQuery Connector per SAP

Per utilizzare BigQuery Connector per SAP, oltre alle autorizzazioni standard di SAP LT Replication Server, gli utenti devono avere accesso alle transazioni personalizzate fornite con BigQuery Connector per SAP:/GOOG/SLT_SETTINGS e /GOOG/REPLIC_VALID.

Per utilizzare lo strumento di simulazione del carico, gli utenti devono avere accesso alla transazione personalizzata /GOOG/LOAD_SIMULATE fornita con il connettore BigQuery per SAP.

Per impostazione predefinita, gli utenti che hanno accesso alle transazioni personalizzate /GOOG/SLT_SETTINGS e /GOOG/REPLIC_VALID possono modificare le impostazioni di qualsiasi configurazione, quindi, se necessario, puoi limitare l'accesso a configurazioni specifiche. Per gli utenti che hanno bisogno solo per visualizzare le impostazioni di BigQuery Connector per SAP, concedi l'accesso di sola lettura alla transazione personalizzata /GOOG/SLT_SETT_DISP.

I file di trasporto BigQuery Connector per SAP includono l'oggetto Google BigQuery Settings Authorization, ZGOOG_MTID, per le autorizzazioni che sono specifici di BigQuery Connector per SAP.

Per concedere l'accesso alle transazioni personalizzate e limitare l'accesso a configurazioni specifiche:

  1. Utilizzando il codice transazione SAP PFCG, definisci un ruolo per BigQuery Connector per SAP.

  2. Concedi il ruolo di accesso alle transazioni personalizzate /GOOG/SLT_SETTINGS, /GOOG/REPLIC_VALID e /GOOG/LOAD_SIMULATE.

  3. Per limitare l'accesso di un ruolo, specifica il gruppo di autorizzazione di ogni configurazione a cui il ruolo può accedere utilizzando l'oggetto ZGOOG_MTID authorization. Ad esempio:

    • Oggetto di autorizzazione per BigQuery Connector per SAP (ZGOOG_MTID):
      • Activity 01
      • Authorization Group AUTH_GROUP_1,AUTH_GROUP_N

    AUTH_GROUP_01 e AUTH_GROUP_N sono valori definiti nella configurazione di SAP LT Replication Server.

    I gruppi di autorizzazione specificati per ZGOOG_MTID devono corrispondere ai gruppi di autorizzazione specificati per il ruolo nell'oggetto di autorizzazione SAP S_DMIS_SLT.

Creazione di ruoli e autorizzazioni SAP per la visualizzazione delle impostazioni di BigQuery Connector per SAP

Per concedere l'accesso di sola lettura per la transazione personalizzata /GOOG/SLT_SETT_DISP: segui questi passaggi:

  1. Utilizzando il codice transazione SAP PFCG, definisci un ruolo per la visualizzazione Impostazioni di BigQuery Connector per SAP.

  2. Concedi il ruolo di accesso alla transazione personalizzata /GOOG/SLT_SETT_DISP.

  3. Aggiungi l'oggetto di autorizzazione per BigQuery Connector per SAP (ZGOOG_MTID) con i seguenti attributi:

    • Activity 03
    • Authorization Group = *
  4. Genera il profilo del ruolo e assegna gli utenti pertinenti al ruolo.

Configura replica

Per configurare la replica, devi specificare sia BigQuery Connector per SAP Impostazioni del server di replica SAP LT.

Specificare le impostazioni di accesso in /GOOG/CLIENT_KEY

Utilizza la transazione SM30 per specificare le impostazioni per l'accesso a BigQuery. BigQuery Connector per SAP archivia le impostazioni come record nella tabella di configurazione personalizzata /GOOG/CLIENT_KEY.

Per specificare le impostazioni di accesso:

  1. In SAP GUI, inserisci il codice transazione SM30.

  2. Seleziona la tabella di configurazione /GOOG/CLIENT_KEY.

  3. Inserisci i valori per i seguenti campi della tabella:

    Campo Tipo di dati Descrizione
    Nome Stringa Il nome di questa configurazione CLIENT_KEY.
    Nome account di servizio Stringa

    Il nome dell'account di servizio, in formato indirizzo email, creato per BigQuery Connector per SAP nel passaggio Crea un account di servizio. Ad esempio: sap-example-svc-acct@example-project-123456.iam.gserviceaccount.com.

    Ambito Stringa

    Specifica Accesso API https://www.googleapis.com/auth/cloud-platform , come consigliato in Compute Engine. Questo ambito di accesso corrisponde all'impostazione Allow full access to all Cloud APIs sulla VM host. Per maggiori informazioni informazioni, consulta Impostare gli ambiti di accesso sulla VM host.

    ID progetto Stringa L'ID del progetto che contiene il target set di dati BigQuery.
    Nome del comando Stringa

    Lascia vuoto questo campo.

    Classe di autorizzazione Stringa La classe di autorizzazione da utilizzare per la replica.

    Specifica /GOOG/CL_GCP_AUTH_GOOGLE.

    Campo di autorizzazione Non applicabile Lascia vuoto questo campo.
    Secondi di aggiornamento del token Numero intero

    La quantità di tempo, in secondi, prima che il token di accesso scade e deve essere aggiornato. Il valore predefinito è 3500.

    Specificare un valore compreso tra 1 e 3599 esegue l'override la scadenza predefinita di 3500 secondi. Se specificare 0, BigQuery Connector per SAP utilizza il valore predefinito.

    Memorizzazione nella cache dei token Booleano Il flag che determina se i token di accesso sono stati recuperati o meno di Google Cloud vengono memorizzate nella cache.

    Ti consigliamo di attivare la memorizzazione nella cache dei token al termine della configurazione di BigQuery Connector per SAP e del test della connessione a Google Cloud. Per ulteriori informazioni sulla memorizzazione nella cache dei token, consulta Attivare la memorizzazione nella cache dei token.

Configura le destinazioni RFC

Per collegare BigQuery Connector per SAP a Google Cloud, ti consigliamo di utilizzare le destinazioni RFC.

Per configurare le destinazioni RFC per la replica:

  1. Nella GUI di SAP, inserisci il codice della transazione SM59.

  2. (Consigliato) Crea nuove destinazioni RFC copiando le destinazioni RFC di esempio GOOG_BIGQUERY e GOOG_IAMCREDENTIALS, quindi prendi nota dei nuovi nomi delle destinazioni RFC. Potrai utilizzarle nei passaggi successivi.

    Il connettore BigQuery per SAP utilizza le destinazioni RFC per connettersi rispettivamente alle API BigQuery e IAM.

    Se vuoi testare la connettività basata sulle destinazioni RFC, puoi saltare questo passaggio e utilizzare le destinazioni RFC di esempio.

  3. Per le destinazioni RFC che hai creato, completa i seguenti passaggi:

    1. Vai alla scheda Impostazioni tecniche e assicurati che il valore 443 sia impostato per il campo N. servizio. Questa è la porta utilizzata Destinazione RFC per le comunicazioni sicure.

    2. Vai alla pagina Logon & Sicurezza e assicurati che il Il campo SSL Certificate (Certificato SSL) è impostato con l'opzione Client SSL DLP (standard).

    3. Se vuoi, puoi configurare le impostazioni del proxy, abilitare la compressione HTTP e specificare gli endpoint Private Service Connect.

    4. Salva le modifiche.

    5. Per testare la connessione, fai clic su Test connessione.

      Una risposta contenente 404 Not Found è accettabile e prevista perché l'endpoint specificato nella destinazione RFC corrisponde a servizio Google Cloud e non è una risorsa specifica ospitata dal completamente gestito di Google Cloud. Una risposta di questo tipo indica che il target Google Cloud è raggiungibile e non è stata trovata alcuna risorsa di destinazione.

  4. In SAP GUI, inserisci il codice transazione SM30.

  5. Nella tabella /GOOG/CLIENT_KEY creata nella sezione precedente, prendi nota del valore del campo Nome.

  6. Nella tabella /GOOG/SERVIC_MAP, crea voci con i seguenti valori di campo:

    Nome della chiave Google Cloud Nome del servizio Google Destinazione RFC
    CLIENT_KEY_TABLE_NAME bigquery.googleapis.com Specifica il nome della destinazione RFC a cui si rivolge in BigQuery. Se utilizzi la destinazione RFC di esempio a scopo di test, specifica GOOG_BIGQUERY.
    CLIENT_KEY_TABLE_NAME iamcredentials.googleapis.com Specifica il nome della destinazione RFC che ha come target IAM. Se utilizzi la destinazione RFC di esempio per scopi di test, specifica GOOG_IAMCREDENTIALS.

    Sostituisci CLIENT_KEY_TABLE_NAME con la chiave client che hai annotato nel passaggio precedente.

Configura le impostazioni del proxy

Quando utilizzi le destinazioni RFC per collegarti a Google Cloud, puoi instradare la comunicazione da BigQuery Connector per SAP tramite il server proxy che utilizzi nel tuo panorama SAP.

Se non vuoi utilizzare un server proxy o non ne hai uno in SAP orizzontale, quindi puoi saltare questo passaggio.

Per configurare le impostazioni del server proxy per BigQuery Connector per SAP, completa la seguenti passaggi:

  1. In SAP GUI, inserisci il codice transazione SM59.

  2. Seleziona la destinazione RFC che ha come target IAM.

  3. Vai alla scheda Impostazioni tecniche e inserisci i valori per i campi in nella sezione Opzioni proxy HTTP.

  4. Ripeti il passaggio precedente per la destinazione RFC che ha come target BigQuery.

Attiva la compressione HTTP

Quando utilizzi le destinazioni RFC per connettersi a Google Cloud, puoi abilitare compressione HTTP.

Se non vuoi attivare questa funzionalità, puoi saltare questo passaggio.

Per attivare la compressione HTTP, completa i seguenti passaggi:

  1. Nella GUI di SAP, inserisci il codice della transazione SM59.

  2. Seleziona la destinazione RFC che ha come target BigQuery.

  3. Vai alla scheda Opzioni speciali.

  4. Per il campo Versione HTTP, seleziona HTTP 1.1.

  5. Per il campo Compressione, seleziona un valore appropriato.

    Per informazioni sulle opzioni di compressione, consulta la Nota SAP 1037677 - La compressione HTTP comprime solo alcuni documenti

Specifica gli endpoint di Private Service Connect

Se vuoi che BigQuery Connector per SAP utilizzi Private Service Connect per consentire il consumo privato di BigQuery e IAM, devi creare questi endpoint nel tuo progetto Google Cloud e specificarli nelle rispettive destinazioni RFC.

Se vuoi che BigQuery Connector per SAP continui a utilizzare il tipo di account pubblico predefinito Endpoint API per la connessione a BigQuery e IAM, quindi salta questo passaggio.

Per configurare BigQuery Connector per SAP in modo che utilizzi i tuoi endpoint Private Service Connect, completa i seguenti passaggi:

  1. Nella GUI di SAP, inserisci il codice della transazione SM59.

  2. Verifica di aver creato nuove destinazioni RFC per BigQuery e IAM. Per le istruzioni su come creare queste destinazioni RFC, consulta Configurare le destinazioni RFC.

  3. Seleziona la destinazione RFC che ha come target BigQuery e quindi completa i seguenti passaggi:

    1. Vai alla scheda Impostazioni tecniche.

    2. Per il campo Host target, inserisci il nome dell'endpoint Private Service Connect che hai creato per accedere a BigQuery.

    3. Vai alla scheda Accesso e sicurezza.

    4. Per il campo N. servizio, assicurati che sia specificato il valore 443.

    5. Per il campo Certificato SSL, assicurati che sia selezionata l'opzione Client SSL predefinito (standard).

  4. Seleziona la destinazione RFC che ha come target IAM e poi completa i seguenti passaggi:

    1. Vai alla scheda Impostazioni tecniche.

    2. Nel campo Target Host (Host di destinazione), inserisci il nome del Endpoint Private Service Connect creato in per accedere a IAM.

    3. Vai alla scheda Accesso e sicurezza.

    4. Per il campo N. servizio, assicurati che sia specificato il valore 443.

    5. Per il campo Certificato SSL, assicurati che l'opzione L'opzione Client SSLDFAULT (standard) è selezionata.

Attiva la memorizzazione nella cache dei token

Per migliorare le prestazioni di replica, ti consigliamo di abilitare la memorizzazione nella cache per token di accesso che il servizio o l'account della VM host che ottiene per accedere a BigQuery.

L'attivazione della memorizzazione nella cache dei token assicura che un token di accesso venga riutilizzato il token di accesso scade o viene revocato, il che a sua volta riduce il numero per recuperare nuovi token di accesso.

Per abilitare la memorizzazione nella cache dei token, seleziona Memorizzazione nella cache dei token nella tabella delle chiavi client /GOOG/CLIENT_KEY.

Quando attivi la memorizzazione nella cache dei token, il token di accesso viene memorizzato nella memoria condivisa del server dell'applicazione SAP LT Replication Server per la durata impostata per il campo Secondi di aggiornamento token nella tabella /GOOG/CLIENT_KEY. Se Token di aggiornamento in secondi non è specificato o è impostato su 0, quindi l'accesso viene memorizzato nella cache per il valore specificato nel parametro CMD_SECS_DEFLT in impostazioni avanzate.

Per i carichi di lavoro SAP in esecuzione su Google Cloud e che utilizzano un account di servizio gestito dall'utente per accedere a BigQuery, la memorizzazione nella cache dei token può apportare un miglioramento significativo poiché il recupero di un token di accesso in questo scenario comporta la realizzazione di due chiamate HTTP. Per informazioni sul recupero del token, consulta Testare l'autenticazione e l'autorizzazione di Google Cloud.

Cancella il token di accesso memorizzato nella cache

Quando la memorizzazione nella cache dei token è abilitata e aggiorni i ruoli assegnati al servizio utilizzato da BigQuery Connector per SAP per accedere a BigQuery, il nuovo token di accesso corrispondente ai ruoli aggiornati viene recuperato alla scadenza del token memorizzato nella cache esistente. In questi casi, puoi cancellare manualmente il token di accesso.

Per cancellare il token di accesso memorizzato nella cache, inserisci la transazione SE38, quindi esegui il programma /GOOG/R_CLEAR_TOKEN_CACHE.

Crea una configurazione di replica del server di replica SAP LT

Utilizza la transazione SAP LTRC per creare una replica del server di replica SAP LT configurazione.

Se SAP LT Replication Server è in esecuzione su un server diverso rispetto al SAP di origine di sistema, prima di creare una configurazione di replica, verifica di avere connessione RFC tra i due sistemi.

Alcune delle impostazioni nella configurazione della replica influiscono sulle prestazioni. Per determinare i valori di impostazione appropriati per l'installazione, consulta la Guida all'ottimizzazione delle prestazioni per la tua versione di SAP LT Replication Server nel SAP Help Portal.

L'interfaccia e le opzioni di configurazione di SAP LT Replication Server potrebbero essere leggermente diverse a seconda della versione in uso.

Per configurare la replica, utilizza la procedura per la tua versione di SAP LT Replication Server:

Configura la replica in DMIS 2011 SP17, DMIS 2018 SP02 o versioni successive

I passaggi seguenti per configurare la replica nelle versioni successive di SAP LT Replication Server. Se utilizzi una versione precedente, consulta Configura la replica in DMIS 2011 SP16, DMIS 2018 SP01 o versioni precedenti.

  1. Nella GUI di SAP, inserisci il codice della transazione LTRC.

  2. Fai clic sull'icona Crea configurazione. Viene visualizzata la procedura guidata Crea configurazione.

  3. Nei campi Nome configurazione e Descrizione, inserisci un nome. e una descrizione per la configurazione, poi fai clic su Avanti.

    Puoi specificare il Gruppo di autorizzazione per limitare l'accesso a un gruppo di autorizzazione specifico ora o in un secondo momento.

  4. Nel riquadro Dettagli connessione sistema di origine:

    • Seleziona il pulsante di opzione Connessione RFC.
    • Nel campo Destinazione RFC, specifica il nome della connessione RFC al sistema di origine.
    • Seleziona le caselle di controllo Consenti utilizzo multiplo e Leggi da un singolo client a seconda dei casi. Per ulteriori informazioni, consulta la documentazione di SAP LT Replication Server.
    • Fai clic su Avanti.

    Questi passaggi si riferiscono a una connessione RFC, ma se l'origine è un database, puoi selezionare Connessione DB se hanno già definito una connessione utilizzando la transazione DBACOCKPIT.

  5. Nel riquadro Dettagli connessione al sistema di destinazione:

    • Seleziona il pulsante di opzione Altro.
    • Nel campo Scenario, seleziona SDK SLT dal menu a discesa.
    • Fai clic su Avanti.
  6. Nel riquadro Specifica impostazioni di trasferimento:

    1. Nel campo Application (Applicazione) della sezione Data Transfer Settings (Impostazioni di trasferimento dati), inserisci /GOOG/SLT_BQ o ZGOOG_SLT_BQ.

    2. Nella sezione Opzioni job, inserisci i valori iniziali in ciascuno dei seguenti campi:

      • Numero di job di Data Transfer
      • Numero di job di caricamento iniziale
      • Numero di job di calcolo
    3. Nella sezione Opzioni di replica, seleziona la radio In tempo reale. .

    4. Fai clic su Avanti.

  7. Dopo aver controllato la configurazione, fai clic su Salva.

  8. Prendi nota dell'ID di tre cifre nella colonna Trasferimento collettivo. Lo utilizzerai in un passaggio successivo.

Per ulteriori informazioni, consulta il PDF allegato alla SAP Note 2652704: Replicating Data Using SLT SDK - DMIS 2011 SP17, DMIS 2018 SP02.pdf.

Configurare la replica in DMIS 2011 SP16, DMIS 2018 SP01 o versioni precedenti

I passaggi che seguono configurano la replica nelle versioni precedenti di SAP LT Replication Server. Se utilizzi una versione successiva, consulta Configura la replica in DMIS 2011 SP17, DMIS 2018 SP02 o versioni successive.

  1. Nella GUI di SAP, inserisci il codice della transazione LTRC.
  2. Fai clic su New (Nuovo). Viene visualizzata una finestra di dialogo per specificare una nuova configurazione.
  3. Nel passaggio Specifica il sistema di origine:
    • Scegli Connessione RFC come tipo di connessione.
    • Inserisci il nome della connessione RFC.
    • Assicurati che il campo Consenti utilizzo multiplo sia selezionato.
  4. Nel passaggio Specifica il sistema di destinazione:
    • Inserisci i dati di connessione al sistema di destinazione.
    • Scegli Connessione RFC come tipo di connessione.
    • Nel campo Scenario per comunicazione RFC, seleziona la Scrivi i dati nel target utilizzando BAdI dall'elenco a discesa. La connessione RFC viene impostata automaticamente su NONE.
  5. Nel passaggio Specificare le impostazioni di trasferimento, premi la Guida F4. La un'applicazione definita in precedenza viene visualizzata nell'area Applicazione .
  6. Prendi nota dell'ID a tre cifre riportato nel trasferimento di massa colonna. Lo utilizzerai in un passaggio successivo.

Per ulteriori informazioni, consulta il PDF allegato alla nota SAP 2652704: Replicating Data Using SLT SDK - DMIS 2011 SP15, SP16, DMIS 2018 SP00, SP01.pdf.

Crea una configurazione di trasferimento di massa per BigQuery

Utilizza la transazione /GOOG/SLT_SETTINGS personalizzata per configurare un per BigQuery e specifica la tabella e il campo mapping.

Seleziona le opzioni di trasferimento collettivo iniziale

Quando inserisci per la prima volta la transazione /GOOG/SLT_SETTINGS, seleziona la parte della configurazione del trasferimento collettivo di BigQuery da modificare.

Per selezionare la parte della configurazione del trasferimento collettivo:

  1. Nella GUI di SAP, inserisci la transazione /GOOG/SLT_SETTINGS preceduta da /n:

    /n/GOOG/SLT_SETTINGS
  2. Nel menu a discesa Tabella delle impostazioni nella schermata di lancio della transazione/GOOG/SLT_SETTINGS, seleziona Trasferimenti collettivi.

    Per una nuova configurazione del trasferimento collettivo, lascia vuoto il campo Mass Transfer Key.

  3. Fai clic sull'icona Esegui. Viene visualizzata la schermata BigQuery Settings Maintenance - Mass Transfers (Manutenzione impostazioni BigQuery - Trasferimenti collettivi).

Specifica la creazione delle tabelle e altri attributi generali

Nella sezione iniziale di un trasferimento di massa BigQuery configurazione del trasferimento di massa, identifichi la configurazione del trasferimento di massa e la chiave client associata, nonché alcune proprietà relative della tabella BigQuery di destinazione.

SAP LT Replication Server salva la configurazione del trasferimento collettivo come record nella tabella di configurazione personalizzata/GOOG/BQ_MASTR.

I campi specificati nei passaggi che seguono sono obbligatori.

  1. Nella schermata BigQuery Settings Maintenance - Mass Transfers (Manutenzione delle impostazioni BigQuery - Trasferimenti collettivi), fai clic sull'icona Aggiungi riga.

  2. Nella riga visualizzata specifica le seguenti impostazioni:

    1. Nel campo Mass Transfer Key (Chiave trasferimento di massa), definisci un nome per questo trasferimento. Questo nome diventa la chiave principale del trasferimento collettivo.
    2. Nel campo ID trasferimento collettivo, inserisci l'ID di tre cifre che è stato generato quando hai creato la configurazione di replica del server di replica SAP LT corrispondente.
    3. Per utilizzare etichette o brevi descrizioni dei campi di origine come nomi Per i campi target in BigQuery, fai clic Casella di controllo Usa flag nomi personalizzati. Per ulteriori informazioni sui nomi di campo, consulta Opzioni di denominazione predefinite per i campi.
    4. Per memorizzare il tipo di modifica che ha attivato un'inserzione e per attivare la convalida dei conteggi dei record tra la tabella di origine, le statistiche di SAP LT Replication Server e la tabella BigQuery, seleziona la casella di controllo Extra Fields Flag.

      Se questo flag è impostato, BigQuery Connector per SAP aggiunge colonne a schema della tabella BigQuery. Per ulteriori informazioni, vedi Campi aggiuntivi per le modifiche dei record e conteggio delle query.

    5. Per interrompere l'invio dei dati quando viene rilevato un record con un errore, la casella di controllo Interrompi al primo indicatore di errore è selezionata per impostazione predefinita. Ti consigliamo di lasciarla selezionata. Per ulteriori informazioni, consulta la sezione Il flag BREAK.

    6. Facoltativamente, per ridurre automaticamente la dimensione del chunk quando la dimensione in byte un blocco supera la dimensione byte massima per le richieste HTTP BigQuery accetta, fai clic sul flag dinamico per la dimensione del chunk casella di controllo. Per ulteriori informazioni sulla dimensione dinamica del chunk, consulta Dimensione dinamica del chunk.

    7. Quando viene rilevato un record con un errore nei dati, per saltarlo e continuare a inserire record nella tabella BigQuery, fai clic sulla casella di controllo Salta indicatore record non validi. I nostri suggerimenti lasciando deselezionata questa opzione. Per maggiori informazioni, consulta la sezione Il flag SKIP.

    8. Nel campo Nome della chiave Google Cloud, inserisci il nome della configurazione /GOOG/CLIENT_KEY corrispondente.

      BigQuery Connector per SAP recupera automaticamente l'Identifier progetto Google Cloud dalla configurazione /GOOG/CLIENT_KEY.

    9. Nel campo Set di dati BigQuery, inserisci il nome del set di dati BigQuery di destinazione che hai creato in precedenza in questa procedura.

    10. Nel campo Is Setting Active Flag (Imposta flag attivo), abilita il trasferimento di massa facendo clic sulla casella di controllo.

    11. Fai clic su Salva.

      Un record del trasferimento di massa viene aggiunto alla /GOOG/BQ_MASTR e Modificato da, Modificato in data, e Modificato alle vengono compilati automaticamente.

    12. Fai clic su Visualizza tabella.

      Il nuovo record del trasferimento di massa viene visualizzato seguito dal riquadro di immissione degli attributi della tabella.

Specifica gli attributi della tabella

Puoi specificare attributi delle tabelle, come il nome e il partizionamento delle tabelle, così come il numero di record da includere in ogni trasmissione o chunk che viene inviato a BigQuery, nella seconda sezione /GOOG/SLT_SETTINGS transazione.

Le impostazioni specificate vengono memorizzate come record nel Tabella di configurazione /GOOG/BQ_TABLE.

Queste impostazioni sono facoltative.

Per specificare gli attributi della tabella:

  1. Fai clic sull'icona Aggiungi riga.

  2. Nel campo Nome tabella SAP, inserisci il nome della tabella SAP di origine.

  3. Nel campo Nome tabella esterna, inserisci il nome della tabella BigQuery di destinazione. Se la tabella di destinazione non esiste già, BigQuery Connector per SAP la crea con questo nome. Per le convenzioni di denominazione delle tabelle BigQuery, consulta Nomi delle tabelle.

  4. Il campo Invia flag non compresso disattiva la compressione dei record. Specifica questo flag solo se hai bisogno di BigQuery Connector per SAP replicare tutti i campi vuoti nei record di origine con i valori che con cui i campi sono stati inizializzati nella tabella di origine. Per un miglior rendimento, non specificare questo flag. Per ulteriori informazioni, consulta la sezione Compressione record.

  5. Facoltativamente, nel campo Dimensione chunk, specifica il numero massimo di record da includere in ogni chunk inviato a BigQuery. Ti consigliamo di utilizzare la dimensione del chunk predefinita con BigQuery Connector per SAP, ovvero 10.000 record. Se necessario, puoi aumentare la dimensione del chunk fino a 50.000 record, che è la dimensione massima consentita da BigQuery Connector per SAP.

    Se i record di origine contengono molti campi, il numero di campi può aumenta la dimensione complessiva in byte dei chunk, il che può causare errori nei chunk. In questo caso, prova a ridurre la dimensione del chunk per ridurre la dimensione in byte. Per ulteriori informazioni, vedi Dimensioni del blocco nel connettore BigQuery per SAP. In alternativa, per regolare automaticamente le dimensioni dei chunk, attiva la dimensione dei chunk dinamica. Per ulteriori informazioni, consulta Dimensione dinamica del chunk.

  6. (Facoltativo) Nel campo Tipo di partizione, specifica un incremento di tempo da utilizzare per il partizionamento. I valori validi sono HOUR, DAY, MONTH o YEAR. Per ulteriori informazioni, vedi Partizionamento delle tabelle.

  7. Facoltativamente, nel campo Campo partizione, specifica il nome di un campo nella tabella BigQuery di destinazione che contiene un timestamp da utilizzare per la partizione. Quando specifichi un Campo di partizione, devi anche specifica Partition Type (Tipo di partizione). Per ulteriori informazioni, consulta Partizionamento delle tabelle.

  8. Nel campo Is Setting Active Flag (È un indicatore di impostazione attivo), attiva gli attributi della tabella facendo clic sulla casella di controllo. Se la casella Is Setting Active Flag non è selezionata, BigQuery Connector per SAP crea la tabella BigQuery con il nome della tabella di origine SAP, la dimensione del chunk predefinita e nessuna partizione.

  9. Fai clic su Salva.

    I tuoi attributi vengono memorizzati come record in /GOOG/BQ_TABLE di configurazione automatica e Modificato da, Modificato il giorno, e Modificato alle vengono compilati automaticamente.

  10. Fai clic su Mostra campi.

    Viene visualizzato il nuovo record di attributi della tabella, seguito dal riquadro di immissione della mappatura dei campi.

Personalizzare la mappatura predefinita dei campi

Se la tabella SAP di origine contiene campi timestamp o booleani, modifica la mappatura predefinita dei tipi di dati per riflettere accuratamente il tipo di dati nella tabella BigQuery di destinazione.

Puoi anche modificare altri tipi di dati, oltre ai nomi utilizzati per i campi target.

Puoi modificare il mapping predefinito direttamente nella GUI di SAP oppure esportarlo la mappatura predefinita a un foglio di lavoro o a un file di testo in modo che gli altri possano modificare i valori senza richiedere l'accesso a SAP LT Replication Server.

Per ulteriori informazioni sulla mappatura dei campi predefinita e sulle modifiche che puoi apportare, consulta Mappatura dei campi.

Per personalizzare la mappatura predefinita per i campi BigQuery di destinazione:

  1. Nella pagina BigQuery Settings Maintenance - Fields (Manutenzione impostazioni BigQuery - Campi) della transazione/GOOG/SLT_SETTINGS, vengono visualizzate le mappature dei campi predefinite per il trasferimento collettivo che stai configurando.

  2. Modifica i tipi di dati target predefiniti nella colonna Elemento dati esterni come necessario. In particolare, modifica il tipo di dati target per i seguenti tipi di dati:

    • Timestamp. Modificare il tipo di dati di destinazione predefinito da NUMERIC a TIMESTAMP o TIMESTAMP (LONG).
    • Valori booleani. Modifica il tipo di dati di destinazione predefinito Da STRING a BOOLEAN.
    • Numeri esadecimali. Modifica il tipo di dati di destinazione predefinito da STRING a BYTES.

    Per modificare la mappatura predefinita dei tipi di dati:

    1. Nella riga del campo da modificare, fai clic sull'icona Campo Elemento dati esterno.
    2. Nella finestra di dialogo per i tipi di dati, seleziona BigQuery il tipo di dati necessario.
    3. Conferma le modifiche, quindi fai clic su Salva.
  3. Se hai specificato il flag Nomi personalizzati nelle Impostazioni BigQuery Manutenzione, modifica i nomi predefiniti dei campi di destinazione nella sezione Nome campo a seconda delle esigenze.

    I valori specificati sostituiscono i nomi predefiniti visualizzati nella colonna Nome campo esterno.

  4. Modifica le descrizioni dei campi target predefiniti in Descrizione campo. colonna in base alle esigenze.

  5. Se vuoi, esporta la mappa dei campi per la modifica esterna. Per istruzioni, consulta Modificare la mappa dei campi BigQuery in un file CSV.

  6. Dopo aver apportato tutte le modifiche e aver modificato esternamente tutti i valori verifica che la casella di controllo Is Setting Active Flag (Imposta flag attivo) sia selezionato. Se l'opzione Is Setting Active Flag (Imposta flag attivo) non è selezionata, BigQuery Connector per SAP crea tabelle di destinazione con i valori predefiniti.

  7. Fai clic su Salva.

    Le modifiche vengono memorizzate nella tabella di configurazione /GOOG/BQ_FIELD e i campi Modificato da, Modificato il e Modificato il vengono compilati automaticamente.

Testa replica

Testa la configurazione della replica avviando il provisioning dei dati:

  1. Apri il SAP LT Replication Server Cockpit (transazione LTRC) in la GUI di SAP.

  2. Fai clic sulla configurazione del trasferimento collettivo per la replica della tabella che stai testando.

  3. Fai clic su Provisioning dei dati.

  4. Nel riquadro Provisioning dei dati, avvia il provisioning dei dati:

    1. Inserisci il nome della tabella di origine.
    2. Fai clic sul pulsante di opzione relativo al tipo di provisioning dei dati che vuoi da testare. Ad esempio, Avvia caricamento.
    3. Fai clic sull'icona Esegui. Inizia il trasferimento dei dati e l'avanzamento viene visualizzata nella schermata Oggetti partecipanti.

      Se la tabella non esiste in BigQuery, il valore BigQuery Connector per SAP crea la tabella da uno schema dalle build dalla tabella e dagli attributi dei campi che hai precedentemente definito con la transazione /GOOG/SLT_SETTINGS.

      La durata del caricamento iniziale di una tabella dipende dalle dimensioni della tabella e dei relativi record.

      I messaggi vengono scritti nella sezione Log delle applicazioni di SAP LT Replication Server nella transazione LTRC.

In alternativa, puoi testare la replica in BigQuery usando lo strumento di simulazione di caricamento. Per ulteriori informazioni, consulta lo strumento di simulazione del carico.

Convalida la replica

Puoi convalidare la replica utilizzando i seguenti metodi:

  • In SAP LT Replication Server:
    • Monitora la replica nella schermata Provisioning dei dati.
    • Verifica la presenza di messaggi di errore nella schermata Log delle applicazioni.
  • Nella scheda delle informazioni sulla tabella in BigQuery:
    • Controlla la scheda Schema per assicurarti che lo schema sia corretto.
    • Controlla la scheda Anteprima per visualizzare un'anteprima delle righe inserite.
    • Nella scheda Dettagli, controlla il numero di righe inserite, le dimensioni della tabella e altre informazioni.
  • Se la casella di controllo Extra Fields Flag (Indicatore campi aggiuntivi) è stata selezionata durante la configurazione della tabella BigQuery, esegui lo strumento di convalida della replica inserendo la transazione personalizzata /GOOG/REPLIC_VALID.

Controlla la replica in SAP LT Replication Server

Utilizza la transazione LTRC per visualizzare l'avanzamento del caricamento iniziale o dei job di replica dopo il loro avvio e per controllare la presenza di messaggi di errore.

Puoi visualizzare lo stato del caricamento nella scheda Statistiche caricamento e lo stato di avanzamento del job nella scheda Monitoraggio trasferimento dati in SAP LT Replication Server.

Nella schermata Log delle applicazioni della transazione LTRC puoi visualizzare tutti dei messaggi che vengono restituiti da BigQuery, BigQuery Connector per SAP e SAP LT Replication Server.

Messaggi emessi dal connettore BigQuery per il codice SAP in SAP LT Replication Server inizia con il prefisso /GOOG/SLT. Messaggi che sono restituiti dall'API BigQuery iniziano con prefisso /GOOG/MSG.

I messaggi restituiti da SAP LT Replication Server non iniziano con un prefisso /GOOG/.

Controllare la replica in BigQuery

Nella console Google Cloud, verifica che la tabella sia stata creata e che BigQuery sta inserendo dati al suo interno.

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

    Vai a BigQuery

  2. Nel campo di ricerca della sezione Spazio di esplorazione, digita il nome della tabella BigQuery di destinazione premi Enter.

    Le informazioni della tabella vengono visualizzate in una scheda del riquadro dei contenuti sul lato destro della pagina.

  3. Nella sezione delle informazioni sulla tabella, fai clic sulle seguenti intestazioni per controllare l'inserimento della tabella e delle righe:

    • Anteprima, che mostra le righe e i campi inseriti nella tabella BigQuery.
    • Schema, che mostra i nomi dei campi e i tipi di dati.
    • Dettagli, che mostra le dimensioni della tabella, il numero totale di righe e altri dettagli.

Esegui lo strumento Replication Validation

Se l'opzione Extra Fields Flag è stata selezionata durante la configurazione della tabella BigQuery, puoi utilizzare lo strumento di convalida della replica per generare report che confrontano il numero di record nella tabella BigQuery con i conteggi dei record nelle statistiche di SAP LT Replication Server o nella tabella di origine.

Per eseguire lo strumento Replication Validation:

  1. Nella GUI di SAP, inserisci la transazione /GOOG/REPLIC_VALID preceduta da /n:

    /n/GOOG/REPLIC_VALID
  2. Nella sezione Processing Options (Opzioni di elaborazione), fai clic sul pulsante di opzione Esegui convalida.

  3. Nella sezione Opzioni di selezione, inserisci le seguenti specifiche:

    • Nel menu a discesa del campo Identificatore partner Google Cloud, seleziona BigQuery.
    • Nel menu a discesa del campo Tipo di controllo, seleziona il tipo di report da generare:
      • Conteggi caricamenti iniziali
      • Conteggi delle repliche
      • Conteggi attuali
    • Se viene visualizzato il campo Data di controllo, specifica la data che ti serve. il conteggio.
    • Nel campo Mass Transfer Key, inserisci il trasferimento di massa. del nome della configurazione.
    • Se vuoi, nel campo Nomi tabelle specifica i nomi delle tabelle nella configurazione del trasferimento collettivo per cui devi generare il report.
  4. Esegui lo strumento di convalida della replica facendo clic sull'icona Esegui.

  5. Al termine del controllo di convalida, nella sezione Opzioni di elaborazione Per visualizzare il report, fai clic sul pulsante di opzione Visualizza report. e facendo clic sull'icona Esegui.

Per ulteriori informazioni, consulta lo strumento di convalida della replica.

Risoluzione dei problemi

Per informazioni su come diagnosticare e risolvere i problemi che potresti riscontrare durante la configurazione ed esecuzione di caricamenti o repliche tra SAP e BigQuery con BigQuery Connector per SAP, consulta la guida alla risoluzione dei problemi di BigQuery Connector per SAP.

Assistenza

Se hai bisogno di aiuto per risolvere problemi di replica BigQuery Connector per SAP, raccogli tutte le informazioni diagnostiche disponibili e contatta l'assistenza clienti Google Cloud. Per informazioni su come contattare il servizio clienti, consulta Assistenza per SAP su Google Cloud.