Installa e configura BigQuery Connector per SAP su un host esterno a Google Cloud

Questa guida mostra come installare e configurare la versione 2.7 (più recente) di BigQuery Connector per SAP in un server di replica SAP LT in esecuzione su un host on-premise, su un altro cloud provider o in un altro ambiente esterno a Google Cloud.

Se la tua casella di SAP LT Replication Server è gestita da SAP tramite il programma SAP RISE, segui questa guida per installare e configurare BigQuery Connector per SAP.

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 da applicazioni SAP direttamente e in sicurezza in BigQuery in tempo reale.

Questa guida è rivolta agli amministratori SAP, agli amministratori di Google Cloud e ad altri professionisti della sicurezza e dei dati SAP e Google Cloud.

Prerequisiti

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

• Devi aver letto la guida alla pianificazione di BigQuery Connector per SAP. La guida alla pianificazione illustra le opzioni di BigQuery Connector per SAP, le considerazioni sulle prestazioni, la mappatura dei campi e altre informazioni necessarie per una configurazione ottimale di BigQuery Connector per SAP.

• Se non hai già un progetto Google Cloud, creane uno:

  Vai al selettore progetti

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

• La manutenzione del software SAP installato è aggiornata e le versioni di tutto il 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 da BigQuery Connector per SAP, come documentato in Requisiti software.

• Disponi delle licenze SAP corrette necessarie per replicare i dati in qualsiasi destinazione 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 del server di replica SAP LT, consulta la documentazione SAP.

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

Panoramica del processo di installazione e configurazione

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

Nota: a seconda della versione di SAP LT Replication Server, alcuni dettagli delle procedure documentate in questa guida potrebbero essere diversi da quelli che vedi quando esegui i passaggi.

Procedura	Ruolo
Se necessario, dopo aver convalidato tutte le licenze appropriate da SAP, segui le istruzioni 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 maggiori informazioni, consulta i requisiti relativi alla versione software SAP.	Amministratore SAP.
Stabilisci una connessione di rete tra il tuo sistema SAP e Google Cloud.	Amministratore di rete.
Abilita le API Google Cloud richieste.	amministratore di Google Cloud.
Abilitare l'accesso privato alle API Google Cloud.	Amministratore di rete Google Cloud.
Crea un set di dati BigQuery.	amministratore o data engineer di Google Cloud.
Configurare 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 ruoli e autorizzazioni SAP per BigQuery Connector per SAP.	Amministratore SAP.
Configura la replica.	Data engineer o amministratori.
Testa la replica.	Data engineer o amministratori.
Convalida la replica.	Data engineer o amministratori.

Stabilisci una connessione di rete a Google Cloud

Se il carico di lavoro SAP non è in esecuzione su Google Cloud, tu o un amministratore di rete dovete stabilire una connessione sicura, a bassa latenza e a larghezza di banda elevata.

Sono disponibili le due opzioni di connessione seguenti:

• Cloud Interconnect (consigliato)
• Cloud VPN

Per configurare una connessione, segui le istruzioni fornite dal servizio di connessione Google Cloud selezionato.

Ogni servizio di connessione ha istruzioni diverse per scenari diversi, quindi consulta la documentazione del servizio e segui le istruzioni per il tuo scenario.

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.

Abilita l'accesso privato alle API Google Cloud

Se il carico di lavoro SAP non è in esecuzione su Google Cloud, dopo aver stabilito una connessione di rete a Google Cloud, devi abilitare l'accesso privato alle API Google Cloud.

Per abilitare l'accesso privato all'API, vedi Configurare l'accesso privato Google per gli host on-premise.

Crea un set di dati BigQuery

Prima di poter testare l'autenticazione e l'autorizzazione di Google Cloud per BigQuery o creare tabelle BigQuery di destinazione, tu, un data engineer o un amministratore dovete creare un set di dati BigQuery.

Per creare un set di dati BigQuery, l'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 fai clic su Crea set di dati.

   

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

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

Per saperne di più sulla creazione di set di dati BigQuery, consulta Creazione di set di dati.

Configura l'autenticazione e l'autorizzazione di Google Cloud

Per l'autenticazione in Google Cloud e l'autorizzazione per accedere a BigQuery, un amministratore della sicurezza di Google Cloud e un amministratore SAP devono configurare l'autenticazione mediante token web JSON (JWT) firmati da Google Cloud.

Di seguito sono riportati i passaggi per la configurazione generale:

• Crea un account di servizio per l'autenticazione basata su JWT in Google Cloud.
  • Concedi all'account di servizio il ruolo IAM necessario per creare i token.
  • Crea una chiave dell'account di servizio (P12).
  • Abilita la firma JWT per l'account di servizio nell'host del server di replica SAP LT.
• Configura le impostazioni di sicurezza per Google Cloud sull'host del server di replica SAP LT.
  • Crea una nuova applicazione SSF e abilita il nodo STRUST per l'applicazione SSF.
  • Importa la chiave dell'account di servizio in STRUST.
• Crea un altro account di servizio per l'autorizzazione di accesso a BigQuery.
  • Concedi all'account di servizio i ruoli IAM necessari per accedere a BigQuery.
  • Aggiungi l'account di servizio BigQuery Connector per SAP come entità al progetto BigQuery.
  • Configura i certificati SSL e HTTPS.
• Crea configurazioni ABAP.
  • Crea nuove destinazioni RFC.
  • Specifica le impostazioni di accesso in /GOOG/CLIENT_KEY.
  • Specifica le destinazioni RFC in /GOOG/SERVIC_MAP.

Crea un account di servizio per il recupero dei token basato su JWT

Crea un service account

Per l'autenticazione basata su JWT in Google Cloud, BigQuery Connector per SAP richiede un account di servizio IAM.

Per creare un account di servizio per il recupero di token basato su JWT, completa i seguenti passaggi:

1. Nella console Google Cloud, vai alla pagina Account di servizio di IAM e amministrazione.

   Vai ad Account di servizio

2. Se richiesto, seleziona il 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. Nel riquadro Concedi a questo account di servizio l'accesso al progetto, seleziona il ruolo Creatore token account di servizio.

7. Fai clic su Continua.

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

9. Fai clic su Fine. L'account di servizio viene visualizzato nell'elenco degli account di servizio per il progetto Google Cloud.

Crea una chiave dell'account di servizio

Devi creare una chiave dell'account di servizio P12 per l'account di servizio utilizzato per il recupero dei token basato su JWT.

Nota: Le chiavi dell'account di servizio comportano un rischio per la sicurezza se non vengono gestite correttamente. Sei responsabile della sicurezza della chiave privata e delle altre operazioni descritte nelle Best practice per la gestione delle chiavi degli account di servizio. Se non ti è consentito creare una chiave dell'account di servizio, la creazione delle chiavi dell'account di servizio potrebbe essere disabilitata per la tua organizzazione. Per maggiori informazioni, consulta Gestire le risorse dell'organizzazione sicure per impostazione predefinita.

Per creare una chiave dell'account di servizio, completa i seguenti passaggi:

1. Nella console Google Cloud, vai alla pagina Account di servizio di IAM e amministrazione.

   Vai ad Account di servizio

2. Selezionare il tuo progetto Google Cloud.

3. Fai clic sull'indirizzo email dell'account di servizio che hai creato per il recupero dei token basati su JWT nella sezione precedente Crea un account di servizio.

4. Sotto il nome dell'account di servizio, fai clic sulla scheda Chiavi.

5. Fai clic sul menu a discesa Aggiungi chiave e seleziona Crea nuova chiave per creare una chiave dell'account di servizio.

6. Accettare P12 come tipo di chiave e fare clic su Crea.

   Una chiave privata viene salvata sul computer.

7. Prendi nota della password del file della chiave privata, notasecret.

   Fornisci la chiave privata e la password all'amministratore SAP per importare la chiave privata in STRUST, come descritto in Importare la chiave dell'account di servizio in STRUST.

Abilita la firma JWT per l'account di servizio sull'host del server di replica SAP LT

Per abilitare la firma JWT per l'account di servizio che hai creato per il recupero di token basato su JWT, devi aggiungere il parametro JWT_SERVC_ACCT alla tabella /GOOG/BQ_PARAM e configurare l'account di servizio.

Per abilitare la firma JWT per un account di servizio, completa i seguenti passaggi:

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

   /n/GOOG/SLT_SETTINGS

2. Dal menu a discesa Tabella delle impostazioni nella schermata di avvio della transazione /GOOG/SLT_SETTINGS, seleziona Parametri.

3. Fai clic sull'icona Esegui. Viene visualizzata la schermata Manutenzione delle impostazioni di BigQuery: Parametri.

4. Fai clic sull'icona Inserisci riga.

5. Nella riga visualizzata specifica le seguenti impostazioni:

   1. Nel campo Nome parametro, inserisci JWT_SERVC_ACCT. La descrizione del parametro viene compilata automaticamente.
   2. Nel campo Valore parametro, inserisci l'indirizzo email dell'account di servizio che hai creato per il recupero dei token basati su JWT nella sezione precedente, Crea un account di servizio.

6. Fai clic su Salva.

   Le impostazioni vengono archiviate come record nella tabella di configurazione /GOOG/BQ_PARAM e i campi Modificato da, Modificato in data e Modificato alle vengono compilati automaticamente.

Configura le impostazioni di sicurezza per Google Cloud sull'host del server di replica SAP LT

Crea una nuova applicazione Secure Store and Forward (SSF)

Nella tabella SSFAPPLIC, la voce ZG_JWT viene importata come parte del connettore BigQuery per il trasporto SAP. Nel caso in cui la voce ZG_JWT non venga importata, devi creare una nuova voce con il nome ZG_JWT utilizzando la transazione SE16.

Per creare una nuova voce nella tabella SSFAPPLIC:

1. Nella GUI di SAP, inserisci il codice della transazione SE16.
2. Nel campo Nome tabella, inserisci SSFAPPLIC e crea una nuova voce.
3. Nel campo APPLIC (APPLICA), inserisci ZG_JWT.
4. Ad eccezione dei campi B_INCCERTS, B_DETACHED, B_ASKPWD e B_DISTRIB, seleziona tutti gli altri campi.
5. Nel campo DESCRIPT, inserisci JWT Signature for GCP.

6. Salva la nuova voce.

   Questa voce diventa un nuovo nodo nella transazione STRUST, in cui importi la chiave dell'account di servizio.

Abilita il nodo STRUST

Utilizza la transazione SSFA per abilitare il nodo STRUST per JWT Signature for GCP.

Per abilitare il nodo STRUST, completa i seguenti passaggi:

1. Nella GUI di SAP, inserisci la transazione SSFA.
2. Fai clic su Nuove voci.

3. Nell'elenco a discesa SSF Application, seleziona JWT Signature for GCP. Questa è la nuova voce che hai creato nella tabella SSFAPPLIC.

   Il seguente screenshot mostra i parametri SSF specifici dell'applicazione che vengono compilati automaticamente da SAP.

   

4. Salva la nuova voce.

   Un nuovo nodo SSF JWT Signature for GCP è abilitato nella transazione STRUST. Ora importi la chiave dell'account di servizio in questo nodo.

Importa la chiave dell'account di servizio in STRUST

Per importare la chiave dell'account di servizio in STRUST, completa i seguenti passaggi:

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

   Verifica che il nuovo nodo nella transazione STRUST sia SSF JWT Signature for GCP.

2. Importa il file della chiave privata:

   1. Seleziona PSE > Importa dalla barra dei menu.
   2. A seconda del tipo di sistema di origine, seleziona la chiave privata appropriata:
      • S4/HANA
        1. Seleziona la chiave privata P12.
        2. Inserisci la password del file notasecret e fai clic su OK.
      • ECC
        1. Seleziona la chiave privata PSE. Devi convertire la chiave privata P12 scaricata in precedenza in una chiave privata PSE. Per ulteriori informazioni sulla conversione di una chiave P12 in una chiave PSE, consulta Convertire la chiave P12 in chiave PSE.
        2. Inserisci il PIN del file che hai creato durante la conversione della chiave privata dalla chiave P12 alla chiave PSE, quindi fai clic su OK.

3. Seleziona PSE > Salva con nome.

4. Seleziona il pulsante di opzione SSF Application e, nel campo corrispondente, seleziona il nuovo nodo dell'applicazione SSF creato in Creare una nuova applicazione Secure Store and Forward (SSF).

5. Salva la nuova voce.

   La chiave di servizio è collegata al nodo dell'applicazione SSF SSF JWT Signature for GCP.

Converti la chiave privata P12 in chiave PSE

Se il sistema di origine è SAP NetWeaver 7.0x (SAP ECC), devi convertire la chiave P12 in una chiave PSE.

Per convertire la chiave P12 in una chiave PSE, completa i seguenti passaggi:

1. Vai al percorso:

   /usr/sap/SID/SYS/exe/run/

   Sostituisci SID con l'ID di sistema SAP.

2. Esegui questo comando dopo aver sostituito i segnaposto:

   sapgenpse import_p12 -p PSE_PATH_AND_FILE_NAME P12_PATH_AND_FILE_NAME.p12

   Sostituisci quanto segue:

   • PSE_PATH_AND_FILE_NAME: specifica il percorso e il nome del file PSE
   • P12_PATH_AND_FILE_NAME: specifica il percorso e il nome del file per il file di chiave P12

3. Inserisci la password del file della chiave privata P12, notasecret.

4. Crea un nuovo PIN per la chiave privata del PSE e inseriscilo di nuovo.

5. Prendi nota del PIN, che dovrai fornire quando importi il file della chiave privata PSE in STRUST.

Per informazioni da SAP su come convertire una chiave P12 in una chiave PSE, consulta:

• SAP Nota 2148457 - Come convertire la coppia di chiavi di un container PKCS#12 / PFX in un file PSE
• SAP Nota 2976401 - Errore "import_p12: Errore durante la creazione di PSE" durante la conversione della coppia di chiavi del container PKCS#12 / PFX in un file PSE

Crea un account di servizio per l'autorizzazione ad accedere a BigQuery

Crea un service account

BigQuery Connector per SAP richiede un account di servizio IAM per l'autenticazione e l'autorizzazione per accedere a BigQuery.

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

Se crei l'account di servizio in un progetto diverso da quello contenente il set di dati BigQuery, devi aggiungere l'account di servizio 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 pagina Account di servizio di IAM e amministrazione.

   Vai ad Account di servizio

2. Se richiesto, seleziona il 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 stai creando l'account di servizio nello stesso progetto del set di dati BigQuery, seleziona i ruoli seguenti nel riquadro Concedi a questo account di servizio l'accesso al progetto:

   • Editor dati BigQuery
   • Utente job BigQuery

   Se stai creando l'account di servizio in un progetto diverso dal set di dati BigQuery, non concedere alcun ruolo all'account di servizio.

7. Fai clic su Continua.

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

9. Fai clic su Fine. L'account di servizio viene visualizzato nell'elenco degli account di servizio del progetto.

10. Se hai creato l'account di servizio in un progetto diverso da quello contenente il set di dati BigQuery, prendi nota del nome dell'account di servizio. Puoi specificare il nome quando aggiungi l'account di servizio al progetto BigQuery. Per saperne di più, 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 l'account di servizio.

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 aggiungere l'account di servizio 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.

Per aggiungere un account di servizio esistente al progetto del set di dati BigQuery, completa questi passaggi:

1. Nella console Google Cloud, vai alla pagina Autorizzazioni IAM:

   Vai alle autorizzazioni IAM

2. Verifica che il nome del progetto che contiene 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", completa questi 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 di nuovo il campo Seleziona un ruolo.
   4. Nel campo Seleziona un ruolo, specifica Utente job BigQuery.
   5. Fai clic su Salva. L'account di servizio viene visualizzato nell'elenco delle entità del progetto nella pagina IAM.

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

Configurazione dei certificati SSL e HTTPS

La comunicazione tra BigQuery Connector per SAP e l'API BigQuery è 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 il certificato radice che il certificato subordinato nella cartella SSL client SSL Client (Standard) PSE.

   Per ulteriori informazioni su SAP, consulta la guida SAP - Elenco delle certificazioni PSE.

3. Nell'host SAP LT Replication Server, verifica che eventuali regole firewall o proxy siano configurati per consentire il traffico in uscita dalla porta HTTPS all'API BigQuery.

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

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

   Se vuoi che BigQuery Connector per SAP acceda alle API di Google Cloud tramite gli endpoint Private Service Connect nella tua rete VPC, devi configurare le destinazioni RFC e specificare gli endpoint Private Service Connect in queste 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.

Creazione configurazioni ABAP

Crea destinazioni RFC

Le destinazioni RFC GOOG_OAUTH2_TOKEN, GOOG_IAMCREDENTIALS e GOOG_BIGQUERY vengono importate nell'ambito del connettore BigQuery per il trasporto SAP. Se queste destinazioni RFC non vengono importate, devi creare nuove destinazioni RFC GOOG_OAUTH2_TOKEN, GOOG_IAMCREDENTIALS e GOOG_BIGQUERY utilizzando la transazione SM59.

Per informazioni sulla creazione di destinazioni RFC, consulta l'articolo Configurare le destinazioni RFC.

Specifica le impostazioni di accesso in /GOOG/CLIENT_KEY

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

Per specificare le impostazioni di accesso, completa i seguenti passaggi:

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

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

3. Inserisci i valori nei seguenti campi della tabella:

   Campo	Tipo di dati	Descrizione
   Nome	String	Il nome di questa configurazione CLIENT_KEY.
   Nome account di servizio	String	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: [e-mail].
   Ambito	String	L'ambito di accesso. Specifica l'ambito di accesso all'API https://www.googleapis.com/auth/cloud-platform come consigliato da Compute Engine.
   ID progetto	String	L'ID del progetto che contiene il set di dati BigQuery di destinazione.
   Nome comando	String	Lascia vuoto questo campo.
   Classe di autorizzazione	String	La classe di autorizzazione. Specifica /GOOG/CL_GCP_AUTH_JWT.
   Campo di autorizzazione	Non applicabile	Lascia vuoto questo campo.
   Secondi di aggiornamento del token	Integer	Lascia vuoto questo campo.

Specifica le destinazioni RFC in /GOOG/SERVIC_MAP

Utilizza la transazione SM30 per specificare le destinazioni RFC nella tabella di mappatura dei servizi /GOOG/SERVIC_MAP.

Per specificare le destinazioni RFC, completa i seguenti passaggi:

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

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

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

Nome	Nome servizio	Destinazione RFC
CLIENT_KEY_TABLE_NAME	googleapis.com/oauth2	GOOG_OAUTH2_TOKEN
CLIENT_KEY_TABLE_NAME	iamcredentials.googleapis.com	GOOG_IAMCREDENTIALS

Sostituisci CLIENT_KEY_TABLE_NAME con il nome della tabella che hai annotato nel passaggio precedente.

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 e profilo pagamenti Cloud.

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

Installa BigQuery Connector per SAP

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

Il trasporto SAP per BigQuery Connector for 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 tuo SAP LT Replication Server sia supportato da BigQuery Connector per SAP, come documentato in Requisiti software.

Nonostante l'utilizzo di una versione supportata di SAP LT Replication Server, in alcuni casi, durante l'importazione dei file di trasporto, potrebbe essere visualizzato il messaggio di errore Requests do not match the component version of the target system. In questi casi, devi reimportare i file di trasporto in SAP LT Replication Server e, durante la reimportazione, nella schermata Importa richiesta di trasporto vai alla scheda Opzioni e seleziona la casella di controllo Ignora versione componente non valida.

Avviso:

Se devi installare BigQuery Connector per SAP su una macchina host in cui l'SDK ABAP per Google Cloud è già installato, contatta l'assistenza clienti Google Cloud per ricevere le istruzioni di installazione appropriate per la tua configurazione. L'installazione di BigQuery Connector per SAP senza seguire le istruzioni dell'assistenza clienti può rendere inutilizzabile l'SDK ABAP per Google Cloud.

Per trovare i dati di contatto per l'assistenza clienti, vai alla pagina Panoramica dell'assistenza nella console Google Cloud. Per ulteriori informazioni, consulta la pagina relativa all'assistenza per SAP su Google Cloud.

La seguente è una procedura generale. Ogni sistema SAP è diverso, quindi collabora con l'amministratore SAP per determinare le 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 nel pacchetto /GOOG/SLT_SDK siano attivi e coerenti:

   1. Nell'interfaccia SAP, inserisci il codice transazione SE80.
   2. Nel selettore di pacchetti, seleziona /GOOG/SLT_SDK.

   3. Nel campo Nome oggetto, fai clic con il tasto destro del mouse sul pacchetto /GOOG/SLT_SDK, quindi scegli Verifica > Controllo pacchetti > 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 verificare ulteriormente che i file di trasporto siano stati importati correttamente e che BigQuery Connector per SAP sia pronto per la configurazione, verifica che l'implementazione del componente aggiuntivo BigQuery Connector per SAP Business Add-In (BAdI) sia attiva e che le applicazioni di replica BigQuery Connector per SAP contengano voci nella tabella IUUC_REPL_APPL.

1. Controlla l'implementazione di BAdI:
   1. Utilizza la transazione SE80 per accedere alla cartella dell'oggetto di miglioramento /GOOG/EI_IUUC_REPL_RUNTIME_BQ e selezionarla.
   2. Seleziona Enh. 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 dati SAP o la transazione SE16, visualizza la tabella IUUC_REPL_APPL.
   2. Verifica che le seguenti applicazioni siano visualizzate nella tabella IUUC_REPL_APPL:
      • /GOOG/SLT_BQ
      • ZGOOG_SLT_BQ, da utilizzare se lo spazio dei nomi /GOOG/ non è registrato

Creazione di ruoli e autorizzazioni SAP per BigQuery Connector per SAP

Per lavorare con BigQuery Connector per SAP, oltre alle autorizzazioni standard del server di replica SAP LT, gli utenti devono accedere alle transazioni personalizzate fornite con BigQuery Connector per SAP: /GOOG/SLT_SETTINGS e /GOOG/REPLIC_VALID.

Per utilizzare lo strumento di simulazione di caricamento, gli utenti devono accedere alla transazione personalizzata /GOOG/LOAD_SIMULATE fornita con BigQuery Connector 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. Agli utenti che devono solo visualizzare le impostazioni di BigQuery Connector per SAP, puoi concedere loro 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 specifiche di BigQuery Connector per SAP.

Per concedere l'accesso alle transazioni personalizzate e limitare l'accesso a configurazioni specifiche, segui questi passaggi:

1. Utilizzando il codice della 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 di autorizzazione ZGOOG_MTID. 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 i 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 SAPS_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 alla transazione personalizzata /GOOG/SLT_SETT_DISP, esegui questi passaggi:

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

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

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

   • Activity 03
   • Authorization Group = *

4. Generare il profilo di ruolo e assegnare gli utenti pertinenti a quel ruolo.

Configura replica

Per configurare la replica, devi specificare le impostazioni di BigQuery Connector per SAP e SAP LT Replication Server.

Specifica le impostazioni di accesso in /GOOG/CLIENT_KEY

Utilizza la transazione SM30 per specificare le impostazioni di 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. Nella GUI di SAP, inserisci il codice della transazione SM30.

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

3. Inserisci i valori nei seguenti campi della tabella:

   Campo	Tipo di dati	Descrizione
   Nome	String	Il nome di questa configurazione CLIENT_KEY.
   Nome account di servizio	String	Lascia vuoto questo campo.
   Ambito	String	Lascia vuoto questo campo.
   ID progetto	String	L'ID del progetto che contiene il set di dati BigQuery di destinazione.
   Nome comando	String	Il nome del comando del sistema operativo esterno che hai definito nel passaggio Creare un comando del sistema operativo per stampare il token di accesso.
   Classe di autorizzazione	String	La classe di autorizzazione da utilizzare per la replica. Specifica /GOOG/CL_GCP_AUTH.
   Campo di autorizzazione	Non applicabile	Lascia vuoto questo campo.
   Secondi di aggiornamento del token	Integer	La quantità di tempo, in secondi, prima della scadenza di un token di accesso e che deve essere aggiornato. Il valore predefinito è 3500. Puoi sovrascrivere questo valore predefinito impostando un valore per il parametro CMD_SECS_DEFLT nelle impostazioni avanzate. Se specifichi un valore compreso tra 1 e 3599, la scadenza predefinita verrà ignorata. Se specifichi 0, BigQuery Connector per SAP utilizza il valore predefinito.
   Memorizzazione nella cache dei token	Booleano	Il flag che determina se i token di accesso recuperati da Google Cloud vengono o meno memorizzati nella cache. Ti consigliamo di attivare la memorizzazione nella cache dei token dopo aver completato la configurazione di BigQuery Connector per SAP e aver testato la connessione a Google Cloud. Per maggiori informazioni sulla memorizzazione nella cache dei token, consulta Abilitare la memorizzazione nella cache dei token.

Configura destinazioni RFC

Per connettere 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.

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

   Se vuoi testare la connettività basata su destinazione 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 campo N.servizio sia impostato con il valore 443. Questa è la porta usata dalla destinazione RFC per le comunicazioni sicure.

   2. Vai alla scheda Accesso e sicurezza e assicurati che il campo Certificato SSL sia impostato con l'opzione Client SSL DCM (Standard).

   3. Facoltativamente, 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 un servizio Google Cloud e non a una risorsa specifica ospitata dal servizio. Questa risposta indica che il servizio Google Cloud di destinazione è raggiungibile e che non è stata trovata alcuna risorsa di destinazione.

4. Nella GUI di SAP, inserisci il codice della transazione SM30.

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

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

   Nome chiave Google Cloud	Nome servizio Google	Destinazione RFC
   CLIENT_KEY_TABLE_NAME	bigquery.googleapis.com	Specifica il nome della destinazione RFC che ha come target 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 a scopo di test, specifica GOOG_IAMCREDENTIALS.

   Sostituisci CLIENT_KEY_TABLE_NAME con il nome della chiave client che hai annotato nel passaggio precedente.

Configura le impostazioni del proxy

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

Se non vuoi utilizzare un server proxy o non ne hai uno nel tuo panorama SAP, puoi saltare questo passaggio.

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

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

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

3. Vai alla scheda Impostazioni tecniche, quindi inserisci i valori per i campi 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 destinazioni RFC per connetterti a Google Cloud, puoi attivare la 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. Nel campo Versione HTTP, seleziona HTTP 1.1.

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

   Per informazioni sulle opzioni di compressione, consulta 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 gli endpoint 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 gli endpoint API pubbliche predefiniti per connettersi a BigQuery e IAM, 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 istruzioni su come creare queste destinazioni RFC, consulta Configurare le destinazioni RFC.

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

   1. Vai alla scheda Impostazioni tecniche.

   2. Nel campo Target Host (Host di destinazione), 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 DCM (Standard).

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

   1. Vai alla scheda Impostazioni tecniche.

   2. Nel campo Target Host (Host di destinazione), inserisci il nome dell'endpoint Private Service Connect che hai creato 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 sia selezionata l'opzione Client SSL DCM (Standard).

Abilita memorizzazione nella cache dei token

Per migliorare le prestazioni di replica, ti consigliamo di abilitare la memorizzazione nella cache del token di accesso recuperato da Google Cloud per accedere a BigQuery.

L'attivazione della memorizzazione nella cache dei token assicura che un token di accesso venga riutilizzato fino alla scadenza o alla revoca del token di accesso, il che a sua volta riduce il numero di chiamate HTTP effettuate per recuperare nuovi token di accesso.

Per attivare la memorizzazione nella cache dei token, seleziona il flag 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 applicazioni SAP LT Replication Server per il periodo di tempo impostato nel campo Secondi di aggiornamento del token nella tabella /GOOG/CLIENT_KEY. Se l'opzione Secondi di aggiornamento del token non è specificata o è impostata su 0, il token di accesso viene memorizzato nella cache per il valore specificato nel parametro CMD_SECS_DEFLT nelle impostazioni avanzate.

Per i carichi di lavoro SAP che non sono in esecuzione su Google Cloud, i token di accesso memorizzati nella cache impediscono anche problemi tecnici che potrebbero verificarsi durante la replica di enormi carichi di dati, laddove diversi processi di SAP LT Replication Server possono richiedere contemporaneamente un token di accesso in qualsiasi momento.

Cancella il token di accesso memorizzato nella cache

Quando la memorizzazione nella cache dei token è attivata e si aggiornano i ruoli assegnati all'account di servizio che BigQuery Connector per SAP utilizza per accedere a BigQuery, il nuovo token di accesso corrispondente ai ruoli aggiornati viene recuperato solo dopo la scadenza del token esistente memorizzato nella cache. In questi casi, puoi cancellare il token di accesso manualmente.

Per cancellare il token di accesso memorizzato nella cache, inserisci la transazione SE38 ed 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 configurazione di replica del server di replica SAP LT.

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

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

Le opzioni dell'interfaccia e di configurazione di SAP LT Replication Server potrebbero essere leggermente diverse a seconda della versione che utilizzi.

Per configurare la replica, utilizza la procedura per la tua versione del server di replica SAP LT:

• Configura la replica in DMIS 2011 SP17, DMIS 2018 SP02 o versioni successive
• Configura la replica in DMIS 2011 SP16, DMIS 2018 SP01 o versioni precedenti

Configurare la replica in DMIS 2011 SP17, DMIS 2018 SP02 o versione successiva

I passaggi seguenti consentono di configurare la replica nelle versioni successive del server di replica SAP LT. Se utilizzi una versione precedente, consulta Configurare 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, quindi fai clic su Avanti.

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

4. Nel riquadro Dettagli connessione sistema di origine:

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

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

5. Nel riquadro Dettagli connessione 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 Applicazione della sezione Impostazioni Data Transfer, 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 iniziali
      • Numero di job di calcolo

   3. Nella sezione Opzioni di replica, seleziona il pulsante di opzione In tempo reale.

   4. Fai clic su Avanti.

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

8. Prendi nota dell'ID a tre cifre nella colonna Trasferimento di massa. Lo userai in un passaggio successivo.

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

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

I passaggi seguenti consentono di configurare la replica nelle versioni precedenti del server di replica SAP LT. Se utilizzi una versione successiva, consulta Configurare 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). Si apre 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 il valore Write Data to Target Using BAdI (Scrivi dati sul targeting 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. L'applicazione definita in precedenza viene visualizzata nel campo Applicazione.
6. Prendi nota dell'ID a tre cifre nella colonna Trasferimento di massa. Lo userai in un passaggio successivo.

Per ulteriori informazioni, consulta il PDF allegato a SAP Note 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 trasferimento di massa per BigQuery e specificare la mappatura della tabella e dei campi.

Seleziona le opzioni iniziali del trasferimento di massa

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

Per selezionare la parte della configurazione del trasferimento di massa:

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

   /n/GOOG/SLT_SETTINGS

2. Dal menu a discesa Tabella delle impostazioni nella schermata di avvio della transazione /GOOG/SLT_SETTINGS, seleziona Trasferimenti di massa.

   Per una nuova configurazione di trasferimento di massa, lascia vuoto il campo Chiave trasferimento di massa.

3. Fai clic sull'icona Esegui. Viene visualizzata la schermata Manutenzione delle impostazioni di BigQuery - Trasferimenti di massa.

Specifica la creazione delle tabelle e altri attributi generali

Nella sezione iniziale di una configurazione del trasferimento di massa di BigQuery, devi identificare la configurazione del trasferimento di massa e specificare la chiave client associata, nonché alcune proprietà relative alla creazione della tabella BigQuery di destinazione.

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

I campi specificati nei seguenti passaggi sono obbligatori.

1. Nella schermata Manutenzione impostazioni BigQuery - Trasferimenti di massa, 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 primaria del trasferimento di massa.
   2. Nel campo ID trasferimento di massa, inserisci l'ID a tre cifre generato al momento della creazione della configurazione di replica di SAP LT Replication Server corrispondente.
   3. Per utilizzare le etichette o le brevi descrizioni dei campi di origine come nomi dei campi di destinazione in BigQuery, fai clic sulla casella di controllo Utilizza flag nomi personalizzati. Per ulteriori informazioni sui nomi dei campi, vedi Opzioni di denominazione predefinite per i campi.

   4. Per archiviare il tipo di modifica che ha attivato un inserimento e per abilitare la convalida del conteggio dei record tra la tabella di origine, le statistiche del server di replica SAP LT e la tabella BigQuery, seleziona la casella di controllo Flag campi aggiuntivi.

      Se questo flag è impostato, BigQuery Connector per SAP aggiunge colonne allo schema della tabella BigQuery. Per ulteriori informazioni, consulta Campi aggiuntivi per le modifiche apportate al record e conteggia le query.

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

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

   7. Quando si verifica un record con un errore nei dati, per ignorarlo e continuare a inserire record nella tabella BigQuery, fai clic sulla casella di controllo Ignora flag record non validi. Ti consigliamo di lasciarla deselezionata. Per maggiori informazioni, consulta la sezione Il flag SKIP.

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

      BigQuery Connector per SAP recupera automaticamente l'identificatore di 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 creato in precedenza in questa procedura.

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

   11. Fai clic su Salva.

       Alla tabella /GOOG/BQ_MASTR viene aggiunto un record del trasferimento di massa e i campi Modificato da, Modificato in data e Modificato alle vengono compilati automaticamente.

   12. Fai clic su Mostra tabella.

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

Specifica gli attributi della tabella

Puoi specificare gli attributi delle tabelle, come il nome della tabella e il partizionamento delle tabelle, nonché il numero di record da includere in ogni trasmissione o blocco inviato a BigQuery, nella seconda sezione della transazione /GOOG/SLT_SETTINGS.

Le impostazioni specificate vengono archiviate come record nella tabella di configurazione /GOOG/BQ_TABLE.

Queste impostazioni sono facoltative.

Per specificare gli attributi di una 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 crea la tabella con questo nome. Per le convenzioni di denominazione di BigQuery per le tabelle, consulta Denominazione delle tabelle.

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

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

   Se i record di origine hanno un numero elevato di campi, il numero di campi può aumentare la dimensione complessiva in byte dei chunk, causando 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 la dimensione del blocco, abilita la dimensione dinamica del chunk. Per maggiori informazioni, consulta Dimensione dinamica del chunk.

6. Facoltativamente, 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 di partizione, specifica il nome di un campo nella tabella BigQuery di destinazione contenente un timestamp da utilizzare per il partizionamento. Quando specifichi il Campo di partizione, devi specificare anche il Tipo di partizione. Per ulteriori informazioni, vedi Partizionamento delle tabelle.

8. Nel campo Is Setting Active Flag (Imposta flag attivo), abilita 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 predefinita del blocco e nessun partizionamento.

9. Fai clic su Salva.

   Gli attributi vengono archiviati come record nella tabella di configurazione /GOOG/BQ_TABLE e i campi Modificato da, Modificato in data e Modificato alle vengono compilati automaticamente.

10. Fai clic su Campi di visualizzazione.

    Viene visualizzato il nuovo record dell'attributo 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 in modo che rifletta accuratamente il tipo di dati nella tabella BigQuery di destinazione.

Puoi anche modificare altri tipi di dati, nonché i nomi utilizzati per i campi di destinazione.

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

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

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

1. Nella pagina Manutenzione impostazioni BigQuery - Campi della transazione /GOOG/SLT_SETTINGS, visualizza le mappature dei campi predefinite per il trasferimento di massa che stai attualmente configurando.

2. Modifica i tipi di dati di destinazione predefiniti nella colonna Elemento di dati esterno a seconda delle esigenze. In particolare, modifica il tipo di dati di destinazione per i seguenti tipi di dati:

   • Timestamp. Modifica 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.
   • 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 sul campo Elemento di dati esterno.
   2. Nella finestra di dialogo per i tipi di dati, seleziona il tipo di dati BigQuery di cui hai bisogno.
   3. Conferma le modifiche, quindi fai clic su Salva.

3. Se hai specificato il flag Nomi personalizzati nella pagina Manutenzione impostazioni BigQuery, modifica i nomi dei campi di destinazione predefiniti nella colonna Nome campo temporaneo, se necessario.

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

4. Modifica le descrizioni dei campi di destinazione predefinite nella colonna Descrizione campo a seconda delle esigenze.

5. Se vuoi, puoi esportare la mappa dei campi per apportare modifiche esterne. Per istruzioni, consulta Modificare la mappa dei campi BigQuery in un file CSV.

6. Dopo aver apportato tutte le modifiche e aver caricato tutti i valori modificati esternamente, verifica che sia selezionata la casella di controllo Is Setting Active Flag (Impostazione del flag attivo). Se l'opzione 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 archiviate nella tabella di configurazione /GOOG/BQ_FIELD e i campi Modificato da, Modificato in data e Modificato alle vengono compilati automaticamente.

Testa replica

Testa la configurazione della replica avviando il provisioning dei dati:

1. Apri SAP LT Replication Server Cockpit (transazione LTRC) nella GUI SAP.

2. Fai clic sulla configurazione del trasferimento di massa 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 corrispondente al tipo di provisioning dei dati che vuoi testare. ad esempio Avvia caricamento.

   3. Fai clic sull'icona Esegui. Il trasferimento dei dati inizia e lo stato di avanzamento viene visualizzato nella schermata Oggetti partecipanti.

      Se la tabella non esiste in BigQuery, BigQuery Connector per SAP crea la tabella da uno schema generato dagli attributi della tabella e del campo che hai definito in precedenza con la transazione /GOOG/SLT_SETTINGS.

      Il tempo richiesto per il caricamento iniziale di una tabella dipende dalle dimensioni della tabella e dei suoi 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 maggiori informazioni, consulta la sezione Carica lo strumento di simulazione.

Convalida 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 della 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.
  • Verifica nella scheda Dettagli il numero di righe inserite, le dimensioni della tabella e altre informazioni.
• Se al momento della configurazione della tabella BigQuery è stata selezionata la casella di controllo Flag campi aggiuntivi, 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 l'avvio e per verificare la presenza di messaggi di errore.

Puoi visualizzare lo stato del carico nella scheda Load Statistics e l'avanzamento del job nella scheda Data Transfer Monitor nel server di replica SAP LT.

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

I messaggi emessi dal connettore BigQuery per il codice SAP nel server di replica SAP LT iniziano con il prefisso /GOOG/SLT. I messaggi restituiti dall'API BigQuery iniziano con il prefisso /GOOG/MSG.

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

Controlla la replica in BigQuery

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

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

   Vai a BigQuery

2. Nel campo di ricerca della sezione Explorer, digita il nome della tabella BigQuery di destinazione, quindi 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 della tabella, fai clic sulle seguenti intestazioni per controllare la tabella e l'inserimento riga:

   • 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 al momento della configurazione della tabella BigQuery è stato selezionato il Flag campi aggiuntivi, puoi utilizzare lo strumento Replication Validation 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 Opzioni di elaborazione, fai clic sul pulsante di opzione Esegui convalida.

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

   • Dal menu a discesa nel campo Identificatore partner Google Cloud, seleziona BigQuery.
   • Dal menu a discesa nel campo Tipo di controllo, seleziona il tipo di report da generare:
     • Conteggi caricamenti iniziali
     • Numero di repliche
     • Conteggi attuali
   • Se viene visualizzato il campo Data di controllo, specifica la data per la quale vuoi ricevere i conteggi.
   • Nel campo Mass Transfer Key (Chiave trasferimento di massa), inserisci il nome della configurazione del trasferimento di massa.
   • Facoltativamente, nel campo Nomi tabelle, specifica i nomi delle tabelle nella configurazione del trasferimento di massa per cui devi generare il report.

4. Esegui lo strumento Replication Validation facendo clic sull'icona Esegui.

5. Una volta completato il controllo di convalida, nella sezione Opzioni di elaborazione visualizza il report facendo clic sul pulsante di opzione Visualizza report e poi sull'icona Esegui.

Conteggi dei record BigQuery: lo strumento Replication Validation segnala qualsiasi numero di record non corrispondente con un cerchio rosso. Tuttavia, una mancata corrispondenza nei conteggi delle repliche non sempre indica un problema.

Un conteggio dei record in BigQuery leggermente superiore a quello nella tabella di origine è normale.

Per ulteriori informazioni, consulta la sezione Conteggi di record disuguali.

Per ulteriori informazioni, vedi Strumento di convalida della replica.

Risoluzione dei problemi

Per informazioni su come diagnosticare e risolvere i problemi che potresti riscontrare durante la configurazione e l'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.

Richiedi assistenza

Se hai bisogno di aiuto per risolvere i problemi di replica e di BigQuery Connector per SAP, raccogli tutte le informazioni di diagnostica disponibili e contatta l'assistenza clienti Google Cloud. Per informazioni su come contattare l'assistenza clienti, vedi Ottenere assistenza per SAP su Google Cloud.