Installare e configurare BigQuery Connector per SAP su una VM di Compute Engine

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 una macchina virtuale (VM) Compute Engine su Google Cloud.

Questa guida illustra come preparare BigQuery, SAP Landscape Transformation Replication Server (SAP LT Replication Server) e BigQuery Connector per SAP al fine di replicare i dati SAP da applicazioni SAP direttamente e in modo sicuro in BigQuery in tempo reale.

Questa guida è rivolta agli amministratori SAP, a 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 soddisfatti i seguenti prerequisiti:

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

Vai al selettore progetti
La fatturazione è abilitata per il tuo progetto. Scopri come verificare che la fatturazione sia abilitata per il tuo progetto. È necessario un account di fatturazione per l'API BigQuery Streaming, BigQuery, e per scaricare BigQuery Connector per SAP.
La manutenzione del software SAP installato è aggiornata e le versioni di tutti i software SAP sono compatibili tra loro, come documentato nella matrice di disponibilità dei prodotti SAP.
Le versioni del software SAP che stai utilizzando sono supportate 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.
Il server di replica SAP LT è installato. Per informazioni sull'installazione del server di replica SAP LT, consulta la documentazione di SAP LT.
La connessione RFC o al database tra il server di replica SAP LT e il sistema di origine è configurata. Se necessario, verifica 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 descritte 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 SAP per installare un server SAP Landscape Transformation Replication.	Amministratore SAP.
Se necessario, installa il componente aggiuntivo dell'interfaccia utente (UI) per SAP NetWeaver. Per maggiori informazioni, consulta i requisiti di versione del software SAP.	Amministratore SAP.
Abilita le API Google Cloud richieste.	Amministratore di Google Cloud.
Se necessario, installa gcloud CLI sull'host del server di replica SAP LT.	Amministratore SAP.
Crea un set di dati BigQuery.	Amministratore di Google Cloud o Data Engineer.
Configura l'autenticazione e l'autorizzazione di Google Cloud.	Amministratore della sicurezza di Google Cloud.
Scarica il pacchetto di installazione BigQuery Connector per SAP SAP.	Titolare dell'account di fatturazione Google Cloud.
Installa il connettore BigQuery per SAP.	Amministratore SAP.
Crea ruoli e autorizzazioni SAP per BigQuery Connector for SAP.	Amministratore SAP.
Configura la replica.	Data engineer o amministratori.
Verifica la replica.	Data engineer o amministratori.
Convalida della replica.	Data engineer o amministratori.

Abilita le API Google Cloud richieste

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

L'API BigQuery
API IAM Service Account Credentials

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

Installa gcloud CLI

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

gcloud CLI è installato sulla maggior parte delle VM di Compute Engine per impostazione predefinita. Puoi confermarne l'installazione assegnando

gcloud
components list

. Se il comando non è riconosciuto, devi installare gcloud CLI.

Un amministratore SAP può installare gcloud CLI.

Per installare gcloud CLI, completa questi passaggi:

Segui le istruzioni di installazione dell'interfaccia a riga di comando gcloud.
Segui le istruzioni di configurazione dell'interfaccia a riga di comando gcloud.
Autorizza l'account utente sidadm ad accedere alla directory di installazione di gcloud CLI.
Facoltativamente, come sidadm, imposta il progetto predefinito per gcloud CLI:
```
gcloud config set project PROJECT_ID
```
Sostituisci PROJECT_ID con l'ID del progetto che contiene il set di dati BigQuery. Ad esempio, example-project-123456.

Se non imposti un progetto predefinito per gcloud CLI, è necessario specificare la proprietà --project in ogni comando gcloud emesso.

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

Crea un set di dati BigQuery

Prima di poter testare l'autenticazione e l'autorizzazione di Google Cloud per BigQuery o creare tabelle BigQuery di destinazione, è necessario che tu o un data engineer o un amministratore crei 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 ulteriori informazioni, consulta la sezione Autorizzazioni richieste.

Nella console Google Cloud, vai alla pagina BigQuery:

Vai a BigQuery
Accanto all'ID progetto, fai clic sull'icona Visualizza azioni, e poi su Crea set di dati.
Nel campo ID set di dati, inserisci un nome univoco. Per ulteriori informazioni, consulta Nomi dei set di dati.

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

Per ulteriori informazioni 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 su Google Cloud e l'autorizzazione ad accedere a BigQuery, un amministratore della sicurezza di Google Cloud e un amministratore SAP devono:

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

Crea un account di servizio

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

Questo account di servizio deve essere un'entità nel progetto Google Cloud contenente 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 IAM e amministratore.

Vai ad Account di servizio
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 stai creando 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 ruoli seguenti:
- 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.
Fai clic su Continua.
Se necessario, 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 del 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. Puoi specificare il nome quando aggiungi l'account di servizio al progetto BigQuery. Per ulteriori informazioni, consulta Aggiungi 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:

Nella console Google Cloud, vai alla pagina Autorizzazioni IAM:

Vai alle autorizzazioni IAM
Conferma che il nome del progetto che contiene il set di dati BigQuery di destinazione venga 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", completa i seguenti passaggi:
1. Nel campo Nuove entità, specifica il nome dell'account di servizio.
2. Nel campo Seleziona un ruolo, specifica Editor dati BigQuery.
3. Fai clic su AGGIUNGI UN ALTRO RUOLO. Viene visualizzato 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 sulla pagina IAM.

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

Configura la sicurezza sulla VM host

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

Gli ambiti di accesso della VM host devono essere impostati in modo da consentire l'accesso completo alle API Cloud.
L'account di servizio della VM host deve includere il ruolo IAM Creatore token account di servizio.

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

Per modificare gli ambiti di accesso di una VM, devi arrestare la VM.

Controlla gli ambiti di accesso API della VM host

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

Per controllare l'ambito di accesso di una VM host, completa i seguenti passaggi:

Console Google Cloud

Nella console Google Cloud, apri la pagina Istanze VM:

Vai a Istanze VM
Se necessario, seleziona il progetto Google Cloud che contiene l'host del server di replica SAP LT.
Nella pagina Istanze VM, fai clic sul nome della VM host. Si apre la pagina dei dettagli della VM.
In Gestione di API e identità nella pagina dei dettagli della VM host, controlla l'impostazione attuale degli ambiti di accesso API Cloud:
- Se l'impostazione è Consenti l'accesso completo a tutte le API Cloud, l'impostazione è corretta e non è necessario modificarla.
- Se l'impostazione non è Consenti l'accesso completo a tutte le API Cloud, devi arrestare la VM e modificare l'impostazione. Per istruzioni, consulta la sezione successiva.

Interfaccia a riga di comando gcloud

Visualizza gli ambiti di accesso attuali della VM host:

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

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

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

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

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

Modifica gli ambiti di accesso API della VM host

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

Per modificare l'impostazione degli ambiti di accesso dell'API Cloud per una VM host, segui questi passaggi:

Console Google Cloud

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

Puoi trovare il nome dell'account di sicurezza nella pagina dei dettagli della VM host in Gestione di API e identità. Puoi modificare i ruoli concessi a un account di servizio nella console Google Cloud nella pagina IAM in Entità.
Se necessario, arresta tutti i carichi di lavoro in esecuzione sulla VM host.
Nella console Google Cloud, apri la pagina Istanze VM:

Vai a Istanze VM
Nella pagina dell'istanza VM, fai clic sul nome della VM host per aprire la pagina dei dettagli della VM.
Nella parte superiore della pagina dei dettagli della VM host, arresta la VM host facendo clic su INTERROMPI.
Dopo aver arrestato la VM, fai clic su MODIFICA.
In Sicurezza e accesso > Ambiti di accesso, seleziona Consenti l'accesso completo a tutte le API Cloud.
Fai clic su Salva.
Nella parte superiore della pagina dei dettagli della VM host, avvia la VM host facendo clic su AVVIA/RIPRENDI.
Se necessario, riavvia tutti i carichi di lavoro arrestati sulla VM host.

Interfaccia a riga di comando gcloud

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

Per informazioni su come modificare i ruoli concessi a un account di servizio, consulta Aggiornare un account di servizio.
Se necessario, arresta qualsiasi software SAP in esecuzione sulla VM host.

Arresta la VM:

gcloud compute instances stop VM_NAME --zone=VM_ZONE

Modifica gli ambiti di accesso della VM:

gcloud compute instances set-service-account VM_NAME --scopes=cloud-platform --zone=VM_ZONE

Avvia la VM:

gcloud compute instances start VM_NAME --zone=VM_ZONE

Se necessario, avvia il software SAP in esecuzione sulla VM host.

Abilita la VM host per ottenere i token di accesso

Per ottenere i token di accesso richiesti da BigQuery Connector per SAP per accedere a BigQuery, devi concedere all'account di servizio della VM host l'autorizzazione di accesso alla VM host.

Per concedere l'autorizzazione per creare token di accesso, completa i seguenti passaggi:

Nella console Google Cloud, apri la pagina Istanze VM:

Vai a Istanze VM
Nella pagina dell'istanza VM, fai clic sul nome della VM host per aprire la pagina dei dettagli della VM.
Nella pagina dei dettagli della VM, in Gestione di API e identità, prendi nota del nome dell'account di servizio. Il nome di esempio seguente è relativo a un account di servizio Compute Engine predefinito:
```
SVC-ACCT-NUMBER-compute@developer.gserviceaccount.com
```
Nella console Google Cloud, vai alla pagina IAM:

Vai alle autorizzazioni IAM
Nell'elenco delle entità del progetto, trova il nome dell'account di servizio e fai clic su Modifica entità. Viene visualizzata la finestra di dialogo Modifica autorizzazioni.
Nella finestra di dialogo Modifica autorizzazioni, fai clic su AGGIUNGI UN ALTRO RUOLO. Viene visualizzato il campo Seleziona un ruolo.
Nel campo Seleziona un ruolo, specifica Creatore token account di servizio.
Fai clic su Salva. Tornerai alla pagina delle autorizzazioni IAM.

La VM host ora dispone dell'autorizzazione per creare token di accesso.

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
Nella GUI di SAP, utilizza la transazione STRUST per importare sia il certificato radice sia il certificato subordinato nella cartella PSE di SSL client SSL Client (Standard).

Per maggiori informazioni da SAP, consulta la Guida SAP - Elenco delle certificazioni PSE per la manutenzione.
Nell'host del server di replica SAP LT, verifica che le regole o i proxy firewall siano configurati in modo da consentire il traffico in uscita dalla porta HTTPS all'API BigQuery.

In particolare, SAP LT Replication Server deve poter accedere alle seguenti API Google Cloud:
- https://bigquery.googleapis.com
- https://iamcredentials.googleapis.com
Se vuoi che BigQuery Connector per SAP acceda alle API 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 quelle destinazioni RFC. Per maggiori informazioni, consulta Destinazioni RFC.

Per ulteriori informazioni da SAP sulla configurazione di SSL, consulta la nota SAP 510007 - Considerazioni aggiuntive per la configurazione di SSL su ABAP server applicazioni.

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

I metadati della VM sono archiviati su un server di metadati, accessibile solo tramite una porta HTTP. Pertanto, devi assicurarti che siano create e attive una porta HTTP e una porta HTTPS per poter accedere ai metadati della VM.

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

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

Testare l'autenticazione e l'autorizzazione di Google Cloud

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

Usa la procedura seguente per testare l'autenticazione e l'autorizzazione Google Cloud dalla VM host del server di replica SAP LT:

Nella VM host del server di replica SAP LT, apri una shell della riga di comando.
Passa all'utente sidadm.
Richiedi il primo token di accesso al server metadati della VM host:
```
curl "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/token" -H "Metadata-Flavor: Google"
```
Il server dei metadati restituisce un token di accesso simile all'esempio seguente, in cui ACCESS_TOKEN_STRING_1 è una stringa del token di accesso che copi nel comando nel passaggio seguente:
```
{"access_token":"ACCESS_TOKEN_STRING_1",
"expires_in":3599,"token_type":"Bearer"}
```

Richiedi il secondo token di accesso dall'API IAM inviando il comando seguente dopo aver sostituito i valori segnaposto:

Linux

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

Windows

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

Sostituisci quanto segue:

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

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

{"access_token":"ACCESS_TOKEN_STRING_2","expires_in":3599,"token_type":"Bearer"}

Recupera le informazioni sul tuo set di dati BigQuery dall'API BigQuery inviando il seguente comando dopo aver sostituito i valori segnaposto:
Linux
```
curl "https://bigquery.googleapis.com/bigquery/v2/projects/PROJECT_ID/datasets/DATASET_NAME" \
-H "Accept: application/json" -H "Authorization: Bearer ACCESS_TOKEN_STRING_2"
```
Windows
```
curl "https://bigquery.googleapis.com/bigquery/v2/projects/PROJECT_ID/datasets/DATASET_NAME" `
-H "Accept: application/json" -H "Authorization: Bearer ACCESS_TOKEN_STRING_2"
```
Sostituisci quanto segue:
- PROJECT_ID: l'ID del progetto che contiene il set di dati BigQuery.
- DATASET_NAME: il nome del set di dati di destinazione definito in BigQuery.
- ACCESS_TOKEN_STRING_2: la stringa del token di accesso restituita dall'API IAM nel passaggio precedente.
Se l'autenticazione Google Cloud è configurata correttamente, vengono restituite le informazioni sul set di dati.

Se non è configurato correttamente, consulta la pagina relativa alla risoluzione dei problemi del connettore BigQuery per SAP.

Scarica il pacchetto di installazione

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

Per completare il download è necessario il tuo numero di fatturazione Cloud. Per informazioni sugli account di fatturazione, consulta l'articolo sulla fatturazione Cloud e il profilo pagamenti.

Il pacchetto di installazione include i file di trasporto copiati nella directory di trasporto appropriata per il server di replica SAP LT.

Installare BigQuery Connector per SAP

Dopo aver ricevuto il pacchetto di installazione che contiene i file di trasporto 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 server di replica SAP LT sia supportato da BigQuery Connector per SAP, come documentato in Requisiti software.

Nonostante utilizzi una versione supportata del server di replica SAP LT, in alcuni casi è possibile che venga visualizzato il messaggio di errore Requests do not match the component version of the target system durante l'importazione dei file di trasporto. In questi casi, devi reimportare i file di trasporto nel server di replica SAP LT 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.

La seguente procedura è una procedura generale. Ogni sistema SAP è diverso, quindi rivolgiti al tuo amministratore SAP per determinare eventuali modifiche alla procedura che potrebbero essere necessarie per il tuo sistema SAP:

Copia il connettore BigQuery per i file di trasporto 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 o STMS per importare i file nel sistema SAP.
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 del pacchetto, seleziona /GOOG/SLT_SDK.
3. Nel campo Nome oggetto, fai clic con il tasto destro del mouse sul pacchetto /GOOG/SLT_SDK, quindi scegli Seleziona > Verifica pacchetto > Oggetti del pacchetto.
  
  Un segno di spunta verde nella colonna Risultato indica che tutti gli oggetti hanno superato il controllo del pacchetto.

Conferma che BigQuery Connector per SAP sia pronto per la configurazione

Per confermare ulteriormente che i file di trasporto siano stati importati correttamente e che il connettore BigQuery per SAP sia pronto per la configurazione, verifica che l'implementazione del connettore BigQuery per il componente aggiuntivo aziendale SAP (BAdI) sia attiva e che le applicazioni di replica di BigQuery Connector per SAP siano presenti nella tabella IUUC_REPL_APPL.

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. di implementazione sul lato destro della pagina.
3. In Comportamento di runtime, verifica che l'opzione Implementazione attiva sia selezionata.
Controlla le applicazioni di replica:
1. Utilizza il browser di dati SAP o la transazione SE16 per visualizzare la tabella IUUC_REPL_APPL.
2. Conferma che nella tabella IUUC_REPL_APPL vengano visualizzate le seguenti applicazioni:
  - /GOOG/SLT_BQ
  - ZGOOG_SLT_BQ, da utilizzare quando lo spazio dei nomi /GOOG/ non è registrato

Creare ruoli e autorizzazioni SAP per BigQuery Connector per SAP

Per 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 del carico, 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.

Il connettore BigQuery per i file di trasporto SAP include 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:

Utilizzando il codice di transazione SAP PFCG, definisci un ruolo per il BigQuery Connector per SAP.
Concedi il ruolo 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 può accedere il ruolo 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 valori definiti nella configurazione del server di replica SAP LT.

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

Creare 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, segui questi passaggi:

Utilizzando il codice di transazione SAP PFCG, definisci un ruolo per la visualizzazione delle impostazioni 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.

Configura replica

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

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:

Nella GUI di SAP, inserisci il codice transazione SM30.
Seleziona la tabella di configurazione /GOOG/CLIENT_KEY.

Inserisci 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, nel formato dell'indirizzo email, creato per BigQuery Connector per SAP nel passaggio Crea un account di servizio. Ad esempio: `sap-example-svc-acct@example-project-123456.iam.gserviceaccount.com`.
Ambito	Stringa	Specifica l'ambito di accesso all'API `https://www.googleapis.com/auth/cloud-platform`, come consigliato da Compute Engine. Questo ambito di accesso corrisponde all'impostazione `Allow full access to all Cloud APIs` sulla VM host. Per ulteriori informazioni, consulta Impostare gli ambiti di accesso sulla VM host.
ID progetto	Stringa	L'ID del progetto che contiene il set di dati BigQuery di destinazione.
Nome comando	Stringa	Lascia vuoto questo campo.
Classe di autorizzazione	Stringa	La classe di autorizzazione da utilizzare per la replica. Specifica `/GOOG/CL_GCP_AUTH_GOOGLE`.
Campo autorizzazione	Non applicabile	Lascia vuoto questo campo.
Secondi di aggiornamento del token	Numero intero	Il tempo, in secondi, prima che un token di accesso scada e deve essere aggiornato. Il valore predefinito è `3500`. Se specifichi un valore da `1` a `3599`, la scadenza predefinita di `3500` secondi viene sostituita. 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 memorizzati o meno nella cache. Ti consigliamo di attivare la memorizzazione nella cache del token dopo aver configurato 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:

Nella GUI di SAP, inserisci il codice transazione SM59.
(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 utilizzarli nei passaggi successivi.

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

Se vuoi testare la connettività basata sulla destinazione RFC, puoi saltare questo passaggio e utilizzare le destinazioni RFC di esempio.
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 utilizzata 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 CampaignULT (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 Connection Test (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. Una risposta di questo tipo indica che il servizio Google Cloud di destinazione è raggiungibile e che non è stata trovata alcuna risorsa di destinazione.
Nella GUI di SAP, 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 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 del 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 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:

Nella GUI di SAP, 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 destinazioni RFC per connetterti a Google Cloud, puoi attivare la compressione HTTP.

Se non desideri attivare questa funzione, puoi saltare questo passaggio.

Per attivare la compressione HTTP, procedi nel seguente modo:

Nella GUI di SAP, inserisci il codice transazione SM59.
Seleziona la destinazione RFC che ha come target BigQuery.
Vai alla scheda Opzioni speciali.
Nel 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 determinati documenti.

Specifica gli endpoint Private Service Connect

Se vuoi che BigQuery Connector per SAP utilizzi 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, ignora questo passaggio.

Per configurare BigQuery Connector per SAP in modo da utilizzare gli endpoint Private Service Connect, completa questi passaggi:

Nella GUI di SAP, inserisci il codice transazione SM59.
Verifica di aver creato nuove destinazioni RFC per BigQuery e IAM. Per le istruzioni per creare queste destinazioni RFC, consulta Configurare le destinazioni RFC.
Seleziona la destinazione RFC che ha come target BigQuery, quindi completa i seguenti passaggi:
1. Vai alla scheda Impostazioni tecniche.
2. Nel campo 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 CampaignULT (Standard).
Seleziona la destinazione RFC che ha come target IAM, quindi completa i seguenti passaggi:
1. Vai alla scheda Impostazioni tecniche.
2. Nel campo 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 CampaignULT (Standard).

Abilita memorizzazione nella cache dei token

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

L'abilitazione 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 abilitare la memorizzazione nella cache dei token, seleziona il flag Memorizzazione nella cache dei token nella tabella delle chiavi client /GOOG/CLIENT_KEY.

Quando abiliti la memorizzazione nella cache, il token di accesso viene memorizzato nella cache nella memoria condivisa del server di applicazioni SAP LT Replication Server per la durata impostata per il campo Secondi di aggiornamento dei 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 in esecuzione su Google Cloud e che utilizzano un account di servizio gestito dall'utente per accedere a BigQuery, la memorizzazione nella cache dei token può apportare un miglioramento significativo in quanto il recupero di un token di accesso in questo scenario prevede l'esecuzione di due chiamate HTTP. Per informazioni sul recupero del token, consulta Test dell'autenticazione e dell'autorizzazione di Google Cloud.

Cancella il token di accesso memorizzato nella cache

Quando la memorizzazione nella cache dei token è abilitata e aggiorni i ruoli assegnati all'account di servizio che BigQuery Connector per SAP utilizza per accedere a BigQuery, il nuovo token di accesso che corrisponde ai ruoli aggiornati viene recuperato solo dopo la scadenza del token memorizzato nella cache esistente. 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 delle impostazioni della configurazione della replica influiscono sulle prestazioni. Per determinare i valori di impostazione appropriati per la tua installazione, consulta la Performance Optimization Guide per la tua versione di SAP LT Replication Server nel Portale di assistenza SAP.

Le opzioni di interfaccia e configurazione per il server di replica SAP LT potrebbero essere leggermente diverse a seconda della versione in uso.

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

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

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

I passaggi seguenti consentono di configurare 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.

Nella GUI di SAP, inserisci il codice transazione LTRC.
Fai clic sull'icona Crea configurazione. Si apre 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 al sistema di origine:
- Seleziona il pulsante di opzione RFC Connection (Connessione RFC).
- Nel campo RFCDestination (Destinazione RFC), 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 relativa al server di replica SAP LT.
- Tocca Avanti.
Questi passaggi riguardano una connessione RFC, ma se l'origine è un database, puoi selezionare Connessione DB se hai già definito una connessione utilizzando la transazione DBACOCKPIT.
Nel riquadro Target System Connection Details (Dettagli connessione sistema di destinazione):
- Seleziona il pulsante di opzione Altro.
- Nel campo Scenario, seleziona SDK SLT dal menu a discesa.
- Tocca Avanti.
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 trasferimento dati
  - Numero di job di caricamento iniziale
  - Numero di job di calcolo
3. Nella sezione Opzioni di replica, seleziona il pulsante di opzione In tempo reale.
4. Tocca Avanti.
Dopo aver esaminato la configurazione, fai clic su Salva.
Prendi nota dell'ID a tre cifre nella colonna Trasferimento di massa. Potrai utilizzarlo in un passaggio successivo.

Per ulteriori informazioni, consulta il PDF allegato alla nota SAP 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 seguenti consentono di configurare 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.

Nella GUI di SAP, inserisci il codice transazione LTRC.
Fai clic su New (Nuovo). Viene visualizzata una finestra di dialogo in cui puoi specificare una nuova configurazione.
Nel passaggio Specifica il sistema di origine:
- Scegli RFC Connection 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 RFC Connection come tipo di connessione.
- Nel campo Scenario for RFC Communication, seleziona il valore Write Data to Target Usage BAdI dall'elenco a discesa. La connessione RFC viene impostata automaticamente su NONE.
Nel passaggio Specifica le impostazioni di trasferimento, premi Guida F4. L'applicazione che hai definito in precedenza viene visualizzata nel campo Applicazione.
Prendi nota dell'ID a tre cifre nella colonna Trasferimento di massa. Potrai utilizzarlo 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.

Creazione di 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 le mappature di tabelle e campi.

Seleziona le opzioni iniziali per il trasferimento di massa

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

Per selezionare la parte della configurazione del trasferimento di massa:

Nella GUI di SAP, inserisci la transazione /GOOG/SLT_SETTINGS preceduta da /n:
```
/n/GOOG/SLT_SETTINGS
```
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.
Fai clic sull'icona Esegui. Viene visualizzata la schermata Manutenzione delle impostazioni BigQuery - Trasferimenti di massa.

Specifica la creazione della tabella e altri attributi generali

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

Il server di replica SAP LT salva la configurazione del trasferimento di massa come record nella tabella di configurazione personalizzata /GOOG/BQ_MASTR.

I campi specificati nei passaggi seguenti sono obbligatori.

Nella schermata Manutenzione delle impostazioni BigQuery - Trasferimenti di massa, fai clic sull'icona Aggiungi riga.
Nella riga visualizzata, specifica le seguenti impostazioni:
1. Nel campo 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 SAP LT 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, consulta Opzioni di denominazione predefinite per i campi.
4. Per archiviare il tipo di modifica che ha attivato un inserimento e per abilitare la convalida dei conteggi di 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 modifiche ai record e query di conteggio.
5. Per interrompere l'invio dei dati quando si verifica un record con un errore relativo ai dati, la casella di controllo Interrompi al primo flag di errore è selezionata per impostazione predefinita. Ti consigliamo di lasciarla selezionata. Per ulteriori informazioni, vedi Il flag BREAK.
6. Facoltativamente, per ridurre automaticamente le dimensioni del blocco quando la sua dimensione in byte supera quella massima per le richieste HTTP accettate da BigQuery, fai clic sulla casella di controllo Flag per dimensioni dei blocchi dinamici. Per ulteriori informazioni sulla dimensione dinamica del blocco, consulta Dimensioni dinamiche del blocco.
7. Quando viene rilevato 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 ulteriori informazioni, consulta l'articolo 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 del progetto Google Cloud dalla configurazione /GOOG/CLIENT_KEY.
9. Nel campo Set di dati BigQuery, inserisci il nome del set di dati BigQuery di destinazione che hai creato in precedenza in questa procedura.
10. Nel campo Is Setting Active Flag (Impostazione del flag attivo), abilita la configurazione del trasferimento di massa facendo clic sulla casella di controllo.
11. Fai clic su Salva.
  
  Un record del trasferimento di massa viene aggiunto alla tabella /GOOG/BQ_MASTR e i campi Modificato da, Modificato il e Modificato alle vengono compilati automaticamente.
12. Fai clic su Tabella di visualizzazione.
  
  Il nuovo record del trasferimento di massa viene visualizzato seguito dal riquadro degli attributi della tabella.

Specifica gli attributi della tabella

Puoi specificare gli attributi della tabella, come il nome e il partizionamento della tabella, 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 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 crea la tabella con questo nome. Per le convenzioni di denominazione di BigQuery per le tabelle, consulta Denominazione delle tabelle.
Il campo Invia flag non compresso disabilita la compressione dei record. Specifica questo flag solo se hai bisogno BigQuery Connector per SAP per replicare eventuali campi vuoti nei record di origine con i valori con cui i campi sono stati inizializzati nella tabella di origine. Per migliorare le prestazioni, non specificare questo flag. Per ulteriori informazioni, consulta la sezione Compressione dei record.
Facoltativamente, nel campo Dimensioni blocco, specifica il numero massimo di record da includere in ogni blocco inviato a BigQuery. Ti consigliamo di utilizzare la dimensione predefinita del blocco 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 del blocco 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 blocchi, il che può causare errori nei blocchi. In questo caso, prova a ridurre le dimensioni del blocco per ridurre le dimensioni in byte. Per saperne di più, consulta Dimensioni specifiche nel connettore BigQuery per SAP. In alternativa, per regolare automaticamente la dimensione del blocco, abilita la dimensione dinamica. Per ulteriori informazioni, consulta Dimensioni dinamiche del blocco.
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 saperne di più, consulta la sezione Partizionamento delle tabelle.
Facoltativamente, nel campo Partition Field (Campo di partizione), specifica il nome di un campo nella tabella BigQuery di destinazione contenente un timestamp da utilizzare per il partizionamento. Quando specifichi Partition Field, devi specificare anche Partition Type. Per saperne di più, consulta la sezione Partizionamento delle tabelle.
Nel campo Is Setting Active Flag (Impostazione del flag attivo), abilita gli attributi della tabella facendo clic sulla casella di controllo. Se la casella È impostato un flag attivo non è selezionata, BigQuery Connector per SAP crea la tabella BigQuery con il nome della tabella di origine SAP, la dimensione predefinita del blocco e nessuna partizionamento.
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 alle vengono compilati automaticamente.
Fai clic su Campi di visualizzazione.

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

Personalizzare la mappatura predefinita dei campi

Se la tabella SAP di origine contiene campi timestamp o valori booleani, modifica la mappatura predefinita del tipo di dati in modo che rifletta accuratamente il tipo di dati nella tabella BigQuery di destinazione.

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

Puoi modificare il mapping predefinito direttamente nella GUI di SAP oppure esportarlo in un foglio di lavoro o in un file di testo in modo che altri utenti 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 il mapping predefinito per i campi BigQuery di destinazione:

Nella pagina Manutenzione impostazioni BigQuery - Campi della transazione /GOOG/SLT_SETTINGS, visualizza le mappature predefinite dei campi per il trasferimento di massa che stai configurando.
Modifica i tipi di dati di destinazione predefiniti nella colonna Elemento dati esterni in base alle esigenze. In particolare, modifica il tipo di dati di destinazione per i seguenti tipi di dati:
- Timestamp. Cambia 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.
- Caratteri esadecimali. Modifica il tipo di dati di destinazione predefinito da STRING a BYTES.
Per modificare la mappatura predefinita del tipo di dati:
1. Nella riga del campo da modificare, fai clic sul campo Elemento 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 e fai clic su Salva.
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 in base alle tue esigenze.

I valori specificati sostituiscono i nomi predefiniti visualizzati nella colonna Nome campo esterno.
Modifica in base alle tue esigenze le descrizioni dei campi di destinazione predefiniti nella colonna Descrizione campo.
Se vuoi, esporta la mappa dei campi per la modifica esterna. Per le istruzioni, consulta Modificare la mappa dei campi di BigQuery in un file CSV.
Dopo aver completato tutte le modifiche e caricato gli eventuali valori modificati esternamente, verifica che la casella di controllo È impostato un flag attivo sia selezionata. Se Is Setting Active Flag non è selezionato, BigQuery Connector per SAP crea tabelle di destinazione con i valori predefiniti.
Fai clic su Salva.

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

Testa replica

Testa la configurazione della replica avviando il provisioning dei dati:

Apri il Cockpit del server di replica SAP LT (transazione LTRC) nella GUI di SAP.
Fai clic sulla configurazione del trasferimento di massa per la replica della tabella che stai testando.
Fai clic su Provisioning dei dati.
Nel riquadro Provisioning di 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 verificare. ad esempio Avvia caricamento.
3. Fai clic sull'icona Esegui. Il trasferimento di 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 creato a partire dagli attributi di tabella e campo che hai definito in precedenza con la transazione /GOOG/SLT_SETTINGS.
  
  Il tempo necessario per il caricamento iniziale di una tabella dipende dalle dimensioni della tabella e dei relativi record.
  
  I messaggi vengono scritti nella sezione Log delle applicazioni del server di replica SAP LT nella transazione LTRC.

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

Convalida replica

Puoi convalidare la replica utilizzando i seguenti metodi:

Nel server di replica SAP LT:
- Monitora la replica nella schermata Provisioning dei dati.
- Verifica se sono presenti messaggi di errore nella schermata Log delle applicazioni.
Nella scheda Informazioni della tabella in BigQuery:
- Controlla la scheda Schema per verificare 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 la casella di controllo Flag campi aggiuntivi è stata selezionata quando è stata configurata la tabella BigQuery, esegui lo strumento 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 caricamento nella scheda Carica statistiche e l'avanzamento del job nella scheda Monitoraggio trasferimento dati di SAP LT Replication Server.

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 in SAP LT Replication Server 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.

Nella console Google Cloud, vai alla pagina BigQuery.

Vai a BigQuery
Nel campo di ricerca della sezione Explorer, digita il nome della tabella BigQuery di destinazione e poi premi Enter.

Le informazioni della tabella vengono visualizzate in una scheda del riquadro dei contenuti sul lato destro della pagina.
Nella sezione delle informazioni della tabella, fai clic sulle seguenti intestazioni per controllare l'inserimento della tabella e della 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.

Eseguire lo strumento di convalida della replica

Se il Flag campi aggiuntivi è stato selezionato quando è stata configurata la tabella BigQuery, puoi utilizzare lo strumento Convalida della replica per generare report che confrontano il numero di record nella tabella BigQuery con i conteggi di record nelle statistiche del server di replica SAP LT o nella tabella di origine.

Per eseguire lo strumento Convalida della replica:

Nella GUI di SAP, inserisci la transazione /GOOG/REPLIC_VALID preceduta da /n:
```
/n/GOOG/REPLIC_VALID
```
Nella sezione Opzioni di elaborazione, fai clic sul pulsante di opzione Esegui convalida.
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:
  - Numero di caricamenti iniziali
  - Numero di repliche
  - Conteggi attuali
- Se viene visualizzato il campo Data del controllo, specifica la data per la quale vuoi visualizzare i conteggi.
- Nel campo Mass Transfer Key (Chiave di 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.
Esegui lo strumento di convalida della replica facendo clic sull'icona Esegui.
Al termine del controllo di convalida, per visualizzare il report nella sezione Opzioni di elaborazione fai clic sul pulsante di opzione Visualizza report, quindi sull'icona Esegui.

Per ulteriori informazioni, consulta il documento 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 per il connettore BigQuery per SAP.

Richiedere assistenza

Se hai bisogno di aiuto per risolvere 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 Ricevere assistenza per SAP su Google Cloud.

Installare e configurare BigQuery Connector per SAP su una VM di Compute Engine

Prerequisiti

Panoramica del processo di installazione e configurazione

Abilita le API Google Cloud richieste

Installa gcloud CLI

Crea un set di dati BigQuery

Configura l'autenticazione e l'autorizzazione di Google Cloud

Crea un account di servizio

Aggiungi l'account di servizio al progetto BigQuery

Configura la sicurezza sulla VM host

Controlla gli ambiti di accesso API della VM host

Console Google Cloud

Interfaccia a riga di comando gcloud

Modifica gli ambiti di accesso API della VM host

Console Google Cloud

Interfaccia a riga di comando gcloud

Abilita la VM host per ottenere i token di accesso

Configurare i certificati SSL e HTTPS

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

Testare l'autenticazione e l'autorizzazione di Google Cloud

Linux

Windows

Linux

Windows

Scarica il pacchetto di installazione

Installare BigQuery Connector per SAP

Conferma che BigQuery Connector per SAP sia pronto per la configurazione

Creare ruoli e autorizzazioni SAP per BigQuery Connector per SAP

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

Configura replica

Specifica le impostazioni di accesso in /GOOG/CLIENT_KEY

Configura destinazioni RFC

Configura le impostazioni del proxy

Attiva la compressione HTTP

Specifica gli endpoint Private Service Connect

Abilita memorizzazione nella cache dei token

Cancella il token di accesso memorizzato nella cache

Crea una configurazione di replica del server di replica SAP LT

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

Creazione di una configurazione di trasferimento di massa per BigQuery

Seleziona le opzioni iniziali per il trasferimento di massa

Specifica la creazione della tabella e altri attributi generali

Specifica gli attributi della tabella

Personalizzare la mappatura predefinita dei campi

Testa replica

Convalida replica

Controlla la replica in SAP LT Replication Server

Controlla la replica in BigQuery

Eseguire lo strumento di convalida della replica

Risoluzione dei problemi

Richiedere assistenza

Specifica le impostazioni di accesso in `/GOOG/CLIENT_KEY`