Questa guida mostra come installare e configurare la versione 2.8 (ultima) di BigQuery Connector per SAP in un SAP LT Replication Server in esecuzione su un host on-premise, su un altro provider cloud o in un altro ambiente al di fuori di Google Cloud.
Se la tua casella 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 illustra 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 ad amministratori SAP, amministratori Google Cloud e altri professionisti della sicurezza e dei dati di SAP e Google Cloud.
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:
La fatturazione è attivata per il progetto. Scopri come verificare che la fatturazione sia attivata 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 tutto il software SAP sono compatibili tra loro, come documentato nella matrice di disponibilità dei prodotti SAP.
Le versioni del software SAP in uso sono supportate da BigQuery Connector per SAP, come descritto in Requisiti del software.
Disponi delle licenze SAP corrette necessarie per replicare i dati su 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 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 SAP
SM59
. Testa le connessioni al database utilizzando la transazione SAPDBACOCKPIT
.
Panoramica della procedura di installazione e configurazione
La tabella seguente 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. |
Stabilisci una connessione di rete tra il sistema SAP e Google Cloud. | Amministratore di rete. |
Abilita le API Google Cloud richieste. | Amministratore Google Cloud. |
Abilita l'accesso privato alle API Google Cloud. | Amministratore della rete Google Cloud. |
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 di BigQuery Connector per 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 il test di replica. | Data engineer o amministratori. |
Convalida la replica. | Data engineer o amministratori. |
Stabilisci una connessione di rete a Google Cloud
Se il tuo carico di lavoro SAP non è in esecuzione su Google Cloud, tu o un amministratore di rete dovete stabilire una connessione sicura, ad alta larghezza di banda e a bassa latenza a Google Cloud.
Hai a disposizione le seguenti due opzioni di connessione:
- Cloud Interconnect (opzione consigliata)
- 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
- L'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 tuo carico di lavoro SAP non è in esecuzione su Google Cloud, dopo aver stabilito una connessione di rete a Google Cloud, devi attivare l'accesso privato alle API Google Cloud.
Per attivare l'accesso alle API private, consulta la sezione Configurazione dell'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 o un data engineer o un amministratore dovete creare un set di dati BigQuery.
Per creare un set di dati BigQuery, il tuo account utente deve disporre delle autorizzazioni IAM appropriate per BigQuery. Per maggiori informazioni, consulta la sezione Autorizzazioni richieste.
Nella console Google Cloud, vai alla pagina BigQuery:
Accanto all'ID progetto, fai clic sull'icona Visualizza azioni,
quindi su Crea set di dati.Nel campo Dataset ID (ID set di dati), inserisci un nome univoco. Per ulteriori informazioni, consulta Assegnare un nome ai 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 a Google Cloud e l'autorizzazione di accesso a BigQuery, un amministratore della sicurezza di Google Cloud e un amministratore SAP devono configurare l'autenticazione utilizzando token JWT (JSON Web Token) firmati da Google Cloud.
I passaggi di configurazione di alto livello sono i seguenti:
- Crea un account di servizio per l'autenticazione basata su JWT a Google Cloud.
- Configura le impostazioni di sicurezza per Google Cloud sull'host del server di replica SAP LT.
- Crea un altro account di servizio per l'autorizzazione di accesso a BigQuery.
- Creare configurazioni ABAP.
Creare un account di servizio per il recupero dei token basati su JWT
Crea un account di servizio
Per l'autenticazione basata su JWT a Google Cloud, BigQuery Connector per SAP necessita di un account di servizio IAM.
Per creare un account di servizio per il recupero dei token basati su JWT, completa i seguenti passaggi:
Nella console Google Cloud, vai alla pagina Account di servizio di IAM e amministrazione.
Se richiesto, seleziona il tuo progetto Google Cloud.
Fai clic su Crea account di servizio.
Specifica un nome per l'account di servizio e, facoltativamente, una descrizione.
Fai clic su Crea e continua.
Nel riquadro Concedi a questo account di servizio l'accesso al progetto, seleziona il ruolo Creatore token account di servizio.
Fai clic su Continua.
Se opportuno, concedi ad altri utenti l'accesso all'account di servizio.
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 account di servizio P12 per l'account di servizio utilizzato per il recupero dei token basati su JWT.
Per creare una chiave dell'account di servizio, completa i seguenti passaggi:
Nella console Google Cloud, vai alla pagina Account di servizio di IAM e amministrazione.
Selezionare il tuo progetto Google Cloud.
Fai clic sull'indirizzo email dell'account di servizio che hai creato per il recupero dei token basati su JWT nella sezione precedente Creare un account di servizio.
Sotto il nome dell'account di servizio, fai clic sulla scheda Chiavi.
Fai clic sul menu a discesa Aggiungi chiave, quindi seleziona Crea nuova chiave per creare una chiave dell'account di servizio.
Accetta P12 come tipo di chiave e fai clic su Crea.
Una chiave privata viene salvata sul computer.
Prendi nota della password per il 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.
Attiva la firma JWT per l'account di servizio sull'host SAP LT Replication Server
Per attivare la firma JWT per l'account di servizio che hai creato per il recupero dei token basati su JWT, devi aggiungere il parametro JWT_SERVC_ACCT
alla tabella /GOOG/BQ_PARAM
e configurare l'account di servizio.
Per attivare la firma JWT per un account di servizio, completa i seguenti passaggi:
Nella GUI di SAP, inserisci la transazione
/GOOG/SLT_SETTINGS
preceduta da/n
:/n/GOOG/SLT_SETTINGS
Nel menu a discesa Tabella delle impostazioni nella schermata di lancio della transazione
/GOOG/SLT_SETTINGS
, seleziona Parametri.Fai clic sull'icona Esegui. Viene visualizzata la schermata BigQuery Settings Maintenance - Parameters (Manutenzione impostazioni BigQuery - parametri).
Fai clic sull'icona Inserisci riga.
Nella riga visualizzata, specifica le seguenti impostazioni:
- Nel campo Nome parametro, inserisci
JWT_SERVC_ACCT
. La descrizione del parametro viene compilata automaticamente. - 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 Creare un account di servizio.
- Nel campo Nome parametro, inserisci
Fai clic su Salva.
Le impostazioni vengono memorizzate come record nella tabella di configurazione
/GOOG/BQ_PARAM
e i campi Modificato da, Modificato il e Modificato il vengono compilati automaticamente.
Configura le impostazioni di sicurezza per Google Cloud sull'host SAP LT Replication Server
Creare una nuova applicazione SSF (Secure Store and Forward)
Nella tabella SSFAPPLIC
, la voce ZG_JWT
viene importata come parte del trasporto di BigQuery Connector per SAP. Se la voce ZG_JWT
non viene importata, devi creare una nuova voce con il nome ZG_JWT
utilizzando la transazione SE16
.
Per creare una nuova voce nella tabella SSFAPPLIC
:
- In SAP GUI, inserisci il codice transazione
SE16
. - Nel campo Nome tabella, inserisci
SSFAPPLIC
e crea una nuova voce. - Per il campo APPLIC, inserisci
ZG_JWT
. - Seleziona tutti gli altri campi, ad eccezione di B_INCCERTS, B_DETACHED, B_ASKPWD e B_DISTRIB.
- Nel campo DESCRIPT, inserisci
JWT Signature for GCP
. Salva la nuova voce.
Questa voce diventa un nuovo nodo nella transazione
STRUST
, in cui importi la chiave dell'account di servizio.
Attiva il nodo STRUST
Utilizza la transazione SSFA
per attivare il nodo STRUST
per JWT Signature for GCP
.
Per attivare il nodo STRUST
, completa i seguenti passaggi:
- Nella GUI di SAP, inserisci la transazione
SSFA
. - Fai clic su Nuove voci.
Nell'elenco a discesa Applicazione SSF, seleziona
JWT Signature for GCP
. Questa è la nuova voce che hai creato nella tabellaSSFAPPLIC
.Lo screenshot seguente mostra i parametri SSF specifici per l'applicazione che vengono compilati automaticamente da SAP.
Salva la nuova voce.
Un nuovo nodo
SSF JWT Signature for GCP
è attivato nella transazioneSTRUST
. Ora importa 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:
In SAP GUI, inserisci il codice transazione
STRUST
.Verifica che il nuovo nodo nella transazione
STRUST
siaSSF JWT Signature for GCP
.Importa il file della chiave privata:
- Seleziona PSE > Importa dalla barra dei menu.
- A seconda del tipo di sistema di origine, seleziona la chiave privata appropriata:
- S4/HANA
- Seleziona la chiave privata P12.
- Inserisci la password del file
notasecret
e fai clic su OK.
- ECC
- 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 una chiave P12 in una chiave PSE.
- Inserisci il PIN del file che hai creato durante la conversione della chiave privata dalla chiave P12 alla chiave PSE e poi fai clic su OK.
- S4/HANA
Seleziona PSE > Salva con nome.
Seleziona il pulsante di opzione Applicazione SSF e, nel campo corrispondente, seleziona il nuovo nodo dell'applicazione SSF che hai creato in Creare una nuova applicazione Secure Store and Forward (SSF).
Salva la nuova voce.
La chiave di servizio è associata 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:
Vai al percorso:
/usr/sap/SID/SYS/exe/run/
Sostituisci SID con l'ID sistema SAP.
Esegui il seguente 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 PSEP12_PATH_AND_FILE_NAME
: specifica il percorso e il nome del file per il file della chiave P12
Inserisci la password del file della chiave privata P12,
notasecret
.Crea un nuovo PIN per la chiave privata PSE e inserisci di nuovo il PIN.
Prendi nota del PIN, che dovrai fornire quando importi il file della chiave privata PSE in
STRUST
.
Per informazioni di SAP su come convertire una chiave P12 in una chiave PSE, consulta:
- Nota SAP 2148457 - Come convertire la coppia di chiavi di un contenitore PKCS#12 / PFX in un file PSE
- Nota SAP 2976401 - Errore "import_p12: Error creating PSE" durante la conversione della coppia di chiavi del contenitore PKCS#12 / PFX in file PSE
Crea un account di servizio per l'autorizzazione ad accedere a BigQuery
Crea un account di servizio
BigQuery Connector per SAP ha bisogno di un account di servizio IAM per l'autenticazione e l'autorizzazione per accedere a BigQuery.
Questo account di servizio deve essere un principale nel progetto Google Cloud che contiene il 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 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:
Nella console Google Cloud, vai alla pagina Account di servizio di IAM e amministrazione.
Se richiesto, seleziona il tuo progetto Google Cloud.
Fai clic su Crea account di servizio.
Specifica un nome per l'account di servizio e, facoltativamente, una descrizione.
Fai clic su Crea e continua.
Se crei l'account di servizio nello stesso progetto del set di dati BigQuery, nel riquadro Concedi a questo account di servizio l'accesso al progetto, seleziona i seguenti ruoli:
- BigQuery Data Editor
- 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.
Fai clic su Continua.
Se opportuno, concedi ad altri utenti l'accesso all'account di servizio.
Fai clic su Fine. L'account di servizio viene visualizzato nell'elenco degli account di servizio per il progetto.
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. Specifica il nome quando aggiungi l'account di 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.
Per aggiungere un account di servizio esistente al progetto del set di dati BigQuery:
Nella console Google Cloud, vai alla pagina Permissions (Autorizzazioni) di IAM:
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.
Nella pagina IAM, fai clic su
Aggiungi. Si apre la finestra di dialogo Aggiungi entità a "PROJECT_NAME
".Nella finestra di dialogo Aggiungi entità a "
PROJECT_NAME
", compila i seguenti passaggi:- Nel campo Nuove entità, specifica il nome dell'account di servizio.
- Nel campo Seleziona un ruolo, specifica Editor dati BigQuery.
- Fai clic su AGGIUNGI UN ALTRO RUOLO. Il campo Seleziona un ruolo viene visualizzato nuovamente.
- Nel campo Seleziona un ruolo, specifica Utente job BigQuery.
- 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.
Configurare i certificati SSL e HTTPS
La comunicazione tra BigQuery Connector per SAP e l'API BigQuery è protetta tramite SSL e HTTPS.
Scarica i seguenti certificati dal repository di Google Trust Services:
GTS Root R1
GTS CA 1C3
In SAP GUI, utilizza la transazione
STRUST
per importare sia il certificato radice sia quello subordinato nella cartella PSESSL client SSL Client (Standard)
.Per ulteriori informazioni di SAP, consulta la Guida di SAP - Mantenere aggiornato l'elenco delle certificazioni PSE.
Nell'host del server di replica SAP LT, verifica che eventuali regole o proxy firewall siano configurati per consentire il traffico in uscita dalla porta HTTPS all'API BigQuery.
Nello specifico, 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 i tuoi endpoint Private Service Connect in queste destinazioni RFC. Per ulteriori informazioni, consulta Destinazioni RFC.
Per ulteriori informazioni di SAP sulla configurazione di SSL, consulta la nota SAP 510007 - Considerazioni aggiuntive per la configurazione di SSL su Application Server ABAP.
Creare configurazioni ABAP
Creare destinazioni RFC
Le destinazioni RFC GOOG_OAUTH2_TOKEN
, GOOG_IAMCREDENTIALS
e GOOG_BIGQUERY
vengono importate nell'ambito del trasporto di BigQuery Connector per 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 Configurare le destinazioni RFC.
Specificare le impostazioni di accesso in /GOOG/CLIENT_KEY
Utilizza la transazione SM30
per specificare le impostazioni per l'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:
In SAP GUI, inserisci il codice transazione
SM30
.Seleziona la tabella di configurazione
/GOOG/CLIENT_KEY
.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 L'ambito di accesso. Specifica l'ambito di accesso all'
https://www.googleapis.com/auth/cloud-platform
API, come consigliato da Compute Engine.ID progetto Stringa L'ID del progetto contenente il set di dati BigQuery di destinazione. Nome del comando Stringa Lascia vuoto questo campo. Classe di autorizzazione Stringa La classe di autorizzazione. Specifica
/GOOG/CL_GCP_AUTH_JWT
.Campo di autorizzazione Non applicabile Lascia vuoto questo campo. Secondi di aggiornamento token Numero intero 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:
In SAP GUI, inserisci il codice transazione
SM30
.Nella tabella
/GOOG/CLIENT_KEY
creata nella sezione precedente, prendi nota del valore del campo Nome.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 avere il tuo numero di fatturazione Cloud. Per informazioni sugli account di fatturazione, consulta Profilo pagamenti e fatturazione Cloud.
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 contenente i file di trasporto di BigQuery Connector per 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 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 tuo SAP LT Replication Server sia supportato da BigQuery Connector per SAP, come descritto nella sezione 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 questi
casi, devi importare di nuovo i file di trasporto in
SAP LT Replication Server e, durante l'importazione, nella
schermata Import Transport Request, vai alla scheda Options e poi seleziona
la casella di controllo Ignore Invalid Component Version.
La procedura riportata di seguito è una procedura generale. Ogni sistema SAP è diverso, quindi collabora con il tuo amministratore SAP per determinare eventuali modifiche alla procedura che potrebbero essere necessarie per il tuo sistema SAP:
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.Nella GUI di SAP, utilizza il codice transazione
STMS_IMPORT
oSTMS
per importare i file nel sistema SAP.Assicurati che tutti gli oggetti nel pacchetto
/GOOG/SLT_SDK
siano attivi e coerenti:- Nell'interfaccia SAP, inserisci il codice transazione
SE80
. - Nel selettore dei pacchetti, seleziona
/GOOG/SLT_SDK
. Nel campo Nome dell'oggetto, fai clic con il tasto destro del mouse sul pacchetto
/GOOG/SLT_SDK
e poi scegli Controlla > Pacchetto Controlla > Oggetti del pacchetto.Un segno di spunta verde nella colonna Risultato indica che tutti gli oggetti hanno superato il controllo del pacchetto.
- Nell'interfaccia SAP, inserisci il codice transazione
Verificare 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 essere
configurato, verifica che l'implementazione di BigQuery Connector per il componente aggiuntivo SAP (BAdI) sia attiva e che le applicazioni di replica di BigQuery Connector per SAP abbiano voci nella tabella IUUC_REPL_APPL
.
- Controlla l'implementazione di BAdI:
- Utilizza la transazione SE80 per accedere alla
/GOOG/EI_IUUC_REPL_RUNTIME_BQ
cartella dell'oggetto di miglioramento e selezionarla. - Seleziona Migliora. Elementi di implementazione sul lato destro della pagina.
- In Comportamento di runtime, verifica che l'opzione L'implementazione è attiva sia selezionata.
- Utilizza la transazione SE80 per accedere alla
- Controlla le applicazioni di replica:
- Utilizzando il Browser dei dati di SAP o la transazione
SE16
, visualizza la tabellaIUUC_REPL_APPL
. - 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
- Utilizzando il Browser dei dati di SAP o la transazione
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 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. Per gli 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 di 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:
Utilizzando il codice transazione SAP
PFCG
, definisci un ruolo per il BigQuery Connector per SAP.Concedi al ruolo l'accesso alle transazioni personalizzate
/GOOG/SLT_SETTINGS
,/GOOG/REPLIC_VALID
e/GOOG/LOAD_SIMULATE
.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
eAUTH_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 SAPS_DMIS_SLT
.- Oggetto di autorizzazione per BigQuery Connector per SAP (
Creare ruoli e autorizzazioni SAP per visualizzare le impostazioni di BigQuery Connector per SAP
Per concedere l'accesso di sola lettura per la transazione personalizzata /GOOG/SLT_SETT_DISP
:
segui questi passaggi:
Utilizzando il codice transazione SAP
PFCG
, definisci un ruolo per visualizzare le impostazioni di BigQuery Connector per SAP.Concedi al ruolo l'accesso alla transazione personalizzata
/GOOG/SLT_SETT_DISP
.Aggiungi l'oggetto di autorizzazione per BigQuery Connector per SAP (
ZGOOG_MTID
) con i seguenti attributi:Activity 03
Authorization Group = *
Genera il profilo del ruolo e assegna gli utenti pertinenti al ruolo.
Configura la replica
Per configurare la replica, specifica sia le impostazioni di BigQuery Connector per SAP sia quelle di SAP LT Replication Server.
Specifica 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:
In SAP GUI, inserisci il codice transazione
SM30
.Seleziona la tabella di configurazione
/GOOG/CLIENT_KEY
.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 Lascia vuoto questo campo.
Ambito Stringa Lascia vuoto questo campo.
ID progetto Stringa L'ID del progetto contenente il set di dati BigQuery di destinazione. Nome del comando Stringa 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 Stringa 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 token Numero intero Il periodo di tempo, in secondi, prima che un token di accesso scada e debba essere aggiornato. Il valore predefinito è
3500
. Puoi sovrascrivere questo valore predefinito impostando un valore per il parametroCMD_SECS_DEFLT
nelle impostazioni avanzate.La specifica di un valore compreso tra
1
e3599
sostituisce la data e l'ora di scadenza predefinite. Se specifichi0
, il 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 memorizzati nella cache o meno. 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:
In SAP GUI, inserisci il codice transazione
SM59
.(Consigliato) Crea nuove destinazioni RFC copiando le destinazioni RFC di esempio
GOOG_BIGQUERY
eGOOG_IAMCREDENTIALS
, quindi prendi nota dei nuovi nomi delle destinazioni RFC. che utilizzerai 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 sulle destinazioni RFC, puoi saltare questo passaggio e utilizzare le destinazioni RFC di esempio.
Per le destinazioni RFC che hai creato, completa i seguenti passaggi:
Vai alla scheda Impostazioni tecniche e assicurati che il valore
443
sia impostato per il campo N.servizio. Si tratta della porta utilizzata dalla destinazione RFC per la comunicazione sicura.Vai alla scheda Accesso e sicurezza e assicurati che il campo Certificato SSL sia impostato sull'opzione Client SSL predefinito (standard).
Facoltativamente, puoi configurare le impostazioni del proxy, abilitare la compressione HTTP e specificare gli endpoint Private Service Connect.
Salva le modifiche.
Per testare la connessione, fai clic su Test di 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.
In SAP GUI, inserisci il codice transazione
SM30
.Nella tabella
/GOOG/CLIENT_KEY
creata nella sezione precedente, prendi nota del valore del campo Nome.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 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 per scopi di test, specifica GOOG_IAMCREDENTIALS
.Sostituisci
CLIENT_KEY_TABLE_NAME
con il nome della chiave del 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 nel tuo panorama SAP, puoi saltare questo passaggio.
Per configurare le impostazioni del server proxy per BigQuery Connector per SAP, completa i seguenti passaggi:
In SAP GUI, inserisci il codice transazione
SM59
.Seleziona la destinazione RFC che ha come target IAM.
Vai alla scheda Impostazioni tecniche, quindi inserisci i valori per i campi nella sezione Opzioni proxy HTTP.
Ripeti il passaggio precedente per la destinazione RFC che ha come target BigQuery.
Attiva la compressione HTTP
Quando utilizzi le destinazioni RFC per collegarti 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:
In SAP GUI, inserisci il codice transazione
SM59
.Seleziona la destinazione RFC che ha come target BigQuery.
Vai alla scheda Opzioni speciali.
Per il campo Versione HTTP, seleziona HTTP 1.1.
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
Specificare 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 pubblici 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:
In SAP GUI, inserisci il codice transazione
SM59
.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.
Seleziona la destinazione RFC che ha come target BigQuery, quindi completa i seguenti passaggi:
Vai alla scheda Impostazioni tecniche.
Per il campo Host target, inserisci il nome dell'endpoint Private Service Connect che hai creato per accedere a BigQuery.
Vai alla scheda Accesso e sicurezza.
Per il campo N.servizio, assicurati che sia specificato il valore
443
.Per il campo Certificato SSL, assicurati che sia selezionata l'opzione Client SSL predefinito (standard).
Seleziona la destinazione RFC che ha come target IAM e poi completa i seguenti passaggi:
Vai alla scheda Impostazioni tecniche.
Per il campo Host target, inserisci il nome dell'endpoint Private Service Connect che hai creato per accedere a IAM.
Vai alla scheda Accesso e sicurezza.
Per il campo N.servizio, assicurati che sia specificato il valore
443
.Per il campo Certificato SSL, assicurati che sia selezionata l'opzione Client SSL predefinito (standard).
Attiva la memorizzazione nella cache dei token
Per migliorare le prestazioni della replica, ti consigliamo di attivare la memorizzazione nella cache per il token di accesso recuperato da Google Cloud per accedere a BigQuery.
L'attivazione della memorizzazione nella cache dei token garantisce che un token di accesso venga riutilizzato fino alla sua scadenza o al suo ritiro, 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 l'indicatore 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 il valore Token Refresh Seconds non è specificato o è impostato 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 vengono eseguiti su Google Cloud, i token di accesso memorizzati nella cache impediscono anche i problemi tecnici che potrebbero verificarsi durante la replica di enormi carichi di dati, in cui più processi di SAP LT Replication Server possono richiedere contemporaneamente un token di accesso in qualsiasi momento.
Cancellare il token di accesso memorizzato nella cache
Quando la memorizzazione nella cache dei token è attivata e aggiorni i ruoli assegnati all'account di servizio utilizzato da BigQuery Connector per SAP per accedere a BigQuery, il nuovo token di accesso corrispondente ai ruoli aggiornati viene recuperato solo dopo la scadenza del token memorizzato nella cache esistente. In questi casi, puoi cancellare manualmente il token di accesso.
Per svuotare il token di accesso memorizzato nella cache, inserisci la transazione SE38
e poi
esegui il programma /GOOG/R_CLEAR_TOKEN_CACHE
.
Crea una configurazione di replica di SAP LT Replication Server
Utilizza la transazione SAP LTRC
per creare una configurazione di replica di SAP LT Replication Server.
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 disporre di una connessione RFC tra i due sistemi.
Alcune 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:
- Configurare la replica in DMIS 2011 SP17, DMIS 2018 SP02 o versioni successive
- Configurare la replica in DMIS 2011 SP16, DMIS 2018 SP01 o versioni precedenti
Configura la replica in DMIS 2011 SP17, DMIS 2018 SP02 o versioni successive
I passaggi che seguono configurano la replica nelle versioni successive di SAP LT Replication Server. Se utilizzi una versione precedente, consulta Configurare la replica in DMIS 2011 SP16, DMIS 2018 SP01 o versioni precedenti.
In SAP GUI, inserisci il codice transazione
LTRC
.Fai clic sull'icona Crea configurazione. Viene visualizzata la procedura guidata Crea configurazione.
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 un gruppo di autorizzazione specifico ora o in un secondo momento.
Nel riquadro Dettagli connessione del 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 riguardano una connessione RFC, ma se l'origine è un database, puoi selezionare Connessione a DB se hai già definito una connessione utilizzando la transazione
DBACOCKPIT
.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.
Nel riquadro Specifica impostazioni trasferimento:
Nel campo Application (Applicazione) della sezione Data Transfer Settings (Impostazioni di trasferimento dati), inserisci
/GOOG/SLT_BQ
oZGOOG_SLT_BQ
.Nella sezione Opzioni job, inserisci i valori iniziali in ciascuno dei seguenti campi:
- Numero di job di trasferimento dati
- Numero di job di caricamento iniziale
- Numero di job di calcolo
Nella sezione Opzioni di replica, seleziona il pulsante di opzione In tempo reale.
Fai clic su Avanti.
Dopo aver esaminato la configurazione, fai clic su Salva.
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 Configurare la replica in DMIS 2011 SP17, DMIS 2018 SP02 o versioni successive.
- In SAP GUI, inserisci il codice transazione
LTRC
. - Fai clic su New (Nuovo). Viene visualizzata una finestra di dialogo per specificare una nuova configurazione.
- 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.
- 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 for RFC Communication (Scenario per la comunicazione RFC), seleziona il valore Write Data to Target Using BAdI (Scrivere dati nel target utilizzando BAdI) dall'elenco a discesa. La connessione RFC viene impostata automaticamente su NESSUNO.
- Nel passaggio Specifica le impostazioni di trasferimento, premi F4 Guida. L'applicazione che hai definito in precedenza viene visualizzata nel campo Application.
- 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 nota SAP 2652704: Replicating Data Using SLT SDK - DMIS 2011 SP15, SP16, DMIS 2018 SP00, SP01.pdf.
Creare una configurazione di trasferimento collettivo per BigQuery
Utilizza la transazione /GOOG/SLT_SETTINGS
personalizzata per configurare un
trasferimento collettivo per BigQuery e specificare le mappature di tabelle e campi.
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:
Nella GUI di SAP, inserisci la transazione
/GOOG/SLT_SETTINGS
preceduta da/n
:/n/GOOG/SLT_SETTINGS
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.
Fai clic sull'icona Esegui. Viene visualizzata la schermata BigQuery Settings Maintenance - Mass Transfers (Manutenzione impostazioni BigQuery - Trasferimenti collettivi).
Specifica la creazione della tabella e altri attributi generali
Nella sezione iniziale di una configurazione del trasferimento collettivo BigQuery, identifica la configurazione del trasferimento collettivo e specifica la chiave client associata, nonché alcune proprietà relative alla creazione 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.
Nella schermata BigQuery Settings Maintenance - Mass Transfers (Manutenzione delle impostazioni BigQuery - Trasferimenti collettivi), fai clic sull'icona Aggiungi riga.
Nella riga visualizzata, specifica le seguenti impostazioni:
- Nel campo Mass Transfer Key (Chiave trasferimento collettivo), definisci un nome per questo trasferimento. Questo nome diventa la chiave primaria del trasferimento collettivo.
- 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.
- Per utilizzare le etichette o le descrizioni brevi dei campi di origine come nomi per i campi di destinazione in BigQuery, fai clic sulla casella di controllo Utilizza il flag Nomi personalizzati. Per ulteriori informazioni sui nomi di campo, consulta Opzioni di denominazione predefinite per i campi.
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.
Quando questo flag è impostato, BigQuery Connector per SAP aggiunge colonne allo schema della tabella BigQuery. Per ulteriori informazioni, consulta Campi aggiuntivi per le modifiche ai record e le query di conteggio.
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.
Se vuoi, per ridurre automaticamente le dimensioni del chunk quando le dimensioni in byte di un chunk superano le dimensioni in byte massime per le richieste HTTP accettate da BigQuery, fai clic sulla casella di controllo Dynamic Chunk Size Flag. Per ulteriori informazioni sulle dimensioni dei chunk dinamici, consulta Dimensioni dei chunk dinamici.
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. Ti consigliamo di lasciare questa opzione deselezionata. Per ulteriori informazioni, consulta la sezione Il flag SKIP.
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
.Nel campo Set di dati BigQuery, inserisci il nome del set di dati BigQuery di destinazione che hai creato in precedenza in questa procedura.
Nel campo Is Setting Active Flag (È un flag di impostazione attivo), attiva la configurazione del trasferimento collettivo facendo clic sulla casella di controllo.
Fai clic su Salva.
Un record di trasferimento collettivo viene aggiunto alla tabella
/GOOG/BQ_MASTR
e i campi Modificato da, Modificato il e Modificato il vengono compilati automaticamente.Fai clic su Visualizza tabella.
Viene visualizzato il nuovo record di trasferimento collettivo, seguito dal riquadro di immissione degli attributi della tabella.
Specifica gli attributi della tabella
Nella seconda sezione della transazione /GOOG/SLT_SETTINGS
puoi specificare gli attributi della tabella, come il nome e la partizione della tabella, nonché il numero di record da includere in ogni trasmissione o chunk inviato a BigQuery.
Le impostazioni specificate vengono memorizzate come record nella tabella di configurazione/GOOG/BQ_TABLE
.
Queste impostazioni sono facoltative.
Per specificare gli attributi della tabella:
Fai clic sull'icona Aggiungi riga.
Nel campo Nome tabella SAP, inserisci il nome della tabella SAP di origine.
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.
Per inviare dati non compressi per tutti i campi di una tabella, seleziona Invia flag non compresso. Con questa impostazione abilitata, BigQuery Connector per SAP replica i campi vuoti nei record di origine con i valori con cui vengono inizializzati nella tabella di origine. Per migliorare il rendimento, non selezionare questo flag.
Se devi inviare dati non compressi solo per campi specifici, non selezionare Invia indicatore non compresso a livello di tabella. Seleziona invece Invia flag non compresso per questi campi specifici a livello di campo. Questa opzione ti consente di conservare i valori iniziali di campi specifici durante la replica dei dati in BigQuery, anche se comprimi il resto dei dati della tabella. Per informazioni su come modificare la compressione dei record a livello di campo, consulta Modificare la compressione dei record a livello di campo.
Per ulteriori informazioni sul comportamento della compressione dei record, consulta Compressione dei record.
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 hanno un numero elevato di campi, il numero di campi può aumentare le dimensioni complessive in byte dei chunk, il che può causare errori nei chunk. In questo caso, prova a ridurre le dimensioni del chunk per ridurre le dimensioni in byte. Per ulteriori informazioni, consulta Dimensione del chunk nel connettore BigQuery per SAP. In alternativa, per regolare automaticamente le dimensioni dei chunk, attiva la dimensione dei chunk dinamica. Per ulteriori informazioni, consulta Dimensioni dei chunk dinamici.
(Facoltativo) Nel campo Tipo di partizione, specifica un incremento di tempo da utilizzare per il partizionamento. I valori validi sono
HOUR
,DAY
,MONTH
oYEAR
. Per ulteriori informazioni, consulta Partizionamento delle tabelle.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 Campo partizione, devi anche specificare Tipo partizione. Per ulteriori informazioni, consulta Partizionamento delle tabelle.
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.
Fai clic su Salva.
Gli attributi vengono archiviati come record nella tabella di configurazione
/GOOG/BQ_TABLE
e i campi Modificato da, Modificato il e Modificato il vengono compilati automaticamente.Fai clic su Mostra campi.
Viene visualizzato il nuovo record dell'attributo della tabella, seguito dal riquadro di immissione della mappatura dei campi.
Personalizzare la mappatura dei campi predefinita
Se la tabella SAP di origine contiene campi timestamp o booleani, modifica la mappatura del tipo di dati predefinito in modo che rifletta con precisione il tipo di dati nella tabella BigQuery di destinazione.
Puoi anche modificare altri tipi di dati, nonché i nomi utilizzati per i campi target.
Puoi modificare la mappatura predefinita direttamente nella GUI di SAP o esportarla in un foglio di lavoro o in un file di testo in modo che altri utenti possano modificarne i valori senza dover accedere 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:
Nella pagina BigQuery Settings Maintenance - Fields (Manutenzione impostazioni BigQuery - Campi) della transazione
/GOOG/SLT_SETTINGS
, visualizza le mappature dei campi predefinite per il trasferimento collettivo che stai configurando.Modifica i tipi di dati target predefiniti nella colonna Elemento dati esterni come necessario. 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
aTIMESTAMP
oTIMESTAMP (LONG)
. - Valori booleani. Modifica il tipo di dati di destinazione predefinito da
STRING
aBOOLEAN
. - Numeri esadecimali. Modifica il tipo di dati di destinazione predefinito da
STRING
aBYTES
.
Per modificare la mappatura del tipo di dati predefinito:
- Nella riga del campo da modificare, fai clic sul campo Elemento dati esterni.
- Nella finestra di dialogo dei tipi di dati, seleziona il tipo di dato BigQuery di cui hai bisogno.
- Conferma le modifiche e fai clic su Salva.
- Timestamp. Modifica il tipo di dati di destinazione predefinito da
Se hai specificato il flag Nomi personalizzati nella pagina Manutenzione delle impostazioni di BigQuery, modifica i nomi dei campi target predefiniti nella colonna Nome campo provvisorio, se necessario.
I valori specificati sostituiscono i nomi predefiniti visualizzati nella colonna Nome campo esterno.
Modifica le descrizioni dei campi target predefiniti nella colonna Descrizione campo come necessario.
Se vuoi, esporta la mappa dei campi per la modifica esterna. Per istruzioni, consulta Modificare la mappa dei campi BigQuery in un file CSV.
Una volta completate tutte le modifiche e caricati eventuali valori modificati esternamente, verifica che la casella di controllo Is Setting Active Flag (È un indicatore di impostazione attivo) sia selezionata. Se l'opzione Is Setting Active Flag non è selezionata, BigQuery Connector per SAP crea le tabelle di destinazione con i valori predefiniti.
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.
Modificare la compressione dei record a livello di campo
Per migliorare le prestazioni della replica, BigQuery Connector per SAP comprime i record omettendo tutti i campi vuoti nel record di origine, che vengono poi inizializzati con null
nella tabella di destinazione in BigQuery.
Tuttavia, se devi replicare alcuni campi vuoti con i relativi valori iniziali in BigQuery continuando a utilizzare la compressione dei record, puoi selezionare Invia indicatore non compresso per questi campi specifici.
Per ulteriori informazioni sul comportamento della compressione dei record, consulta Compressione dei record.
Per modificare la compressione dei record a livello di campo:
Nella pagina BigQuery Settings Maintenance - Fields (Manutenzione impostazioni BigQuery - Campi) della transazione
/GOOG/SLT_SETTINGS
, viene visualizzato l'elenco dei campi della tabella di cui stai configurando il trasferimento collettivo.Per inviare dati non compressi per un campo, seleziona Invia indicatore non compresso corrispondente al campo.
Fai clic su Salva.
Testare la replica
Testa la configurazione della replica avviando il provisioning dei dati:
Apri la Cockpit di SAP LT Replication Server (transazione
LTRC
) in la GUI di SAP.Fai clic sulla configurazione del trasferimento collettivo per la replica della tabella che stai testando.
Fai clic su Provisioning dei dati.
Nel riquadro Provisioning dei dati, avvia il provisioning dei dati:
- Inserisci il nome della tabella di origine.
- Fai clic sul pulsante di opzione relativo al tipo di provisioning dei dati che vuoi testare. Ad esempio, Avvia caricamento.
Fai clic sull'icona Esegui. Il trasferimento dei dati inizia e l'avanzamento viene visualizzato nella schermata Oggetti partecipanti.
Se la tabella non esiste in BigQuery, BigQuery Connector per SAP la crea da uno schema che viene costruito dagli attributi della tabella e dei campi che hai definito in precedenza 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 utilizzando lo strumento di simulazione del 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.
- Controlla la presenza di messaggi di errore nella schermata Log dell'applicazione.
- 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
.
Controllare la replica in SAP LT Replication Server
Utilizza la transazione LTRC
per visualizzare l'avanzamento dei job di caricamento iniziale o di replica dopo averli avviati 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 vedere tutti i messaggi restituiti da BigQuery, da BigQuery Connector per SAP e da SAP LT Replication Server.
I messaggi emessi dal codice di BigQuery Connector per SAP in
SAP LT Replication Server iniziano con il prefisso /GOOG/SLT
. I messaggi
retitrati dall'API BigQuery iniziano con il
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 stia inserendo i dati al suo interno.
Nella console Google Cloud, vai alla pagina BigQuery.
Nel campo di ricerca della sezione Explorer, digita il nome della tabella BigQuery di destinazione e premi
Enter
.Le informazioni della tabella vengono visualizzate in una scheda del riquadro dei contenuti sul lato destro della pagina.
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 di convalida della replica
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 di convalida della replica:
Nella GUI di SAP, inserisci la transazione
/GOOG/REPLIC_VALID
preceduta da/n
:/n/GOOG/REPLIC_VALID
Nella sezione Processing Options (Opzioni di elaborazione), fai clic sul pulsante di opzione Esegui convalida.
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 caricamento iniziale
- Conteggi delle repliche
- Conteggi attuali
- Se viene visualizzato il campo Data controllo, specifica la data per la quale ti servono i conteggi.
- Nel campo Mass Transfer Key (Chiave trasferimento collettivo), inserisci il nome della configurazione del trasferimento collettivo.
- Se vuoi, nel campo Nomi tabelle specifica i nomi delle tabelle nella configurazione del trasferimento collettivo per cui devi generare il report.
Esegui lo strumento di convalida della replica facendo clic sull'icona Esegui.
Al termine del controllo di convalida, nella sezione Opzioni di elaborazione, visualizza il report facendo clic sul pulsante di opzione Visualizza report e poi 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 i problemi relativi alla replica e a BigQuery Connector per SAP, raccogli tutte le informazioni di diagnostica disponibili e contatta l'assistenza clienti Google Cloud. Per informazioni su come contattare il team dell'assistenza clienti, consulta Assistenza per SAP su Google Cloud.