Origine batch della tabella SAP

Il plug-in di origine batch della tabella SAP (plug-in della tabella SAP) consente di leggere i dati dalle tabelle o dalle viste standard e personalizzate di SAP. Consente l'importazione collettiva dei dati dalle applicazioni SAP in BigQuery o in qualsiasi altro sistema di destinazione supportato utilizzando Cloud Data Fusion. Il plug-in ha le seguenti funzionalità principali:

• Utilizza SAP ECC, SAP S4/HANA o SAP BW come sistema di origine
• Non utilizza SAP CDC (Change Data Capture) per monitorare ed estrarre i dati nuovi e delta nelle origini dati
• Utilizza la modalità di estrazione batch
• Supporta tabelle SAP e viste ABAP CDS come origini dati
• Accede ai dati SAP tramite il livello applicazione

Puoi leggere i dati da:

• Tabelle trasparenti
• Tabelle in cluster
• Tavoli da biliardo
• Visualizzazioni ABAP CDS
• Oggetti SAP BW ADSO

Per saperne di più su SAP su Google Cloud, consulta la panoramica di SAP su Google Cloud.

Prima di iniziare

Configura i seguenti sistemi e servizi utilizzati dal plug-in SAP Table:

1. Configura il sistema SAP ERP. Questa procedura include i seguenti passaggi:
   • Installa i file di trasporto SAP.
   • Configura le autorizzazioni e i ruoli SAP richiesti.
   • Configura SAP Java Connector.

2. Esegui il deployment del plug-in in Cloud Data Fusion.

   • Importante: scegli una versione del plug-in compatibile con la versione di Cloud Data Fusion.
   • Se esegui l'upgrade della versione dell'istanza o del plug-in Cloud Data Fusion, valuta l'impatto delle modifiche sull'ambito funzionale e sul rendimento della pipeline.

3. Stabilisci la connettività RFC tra Cloud Data Fusion e SAP.

   • Assicurati che la comunicazione sia abilitata tra l'istanza Cloud Data Fusion e il server SAP.
   • Per le istanze private, configura il peering di rete VPC.
   • Sia il sistema SAP sia l'istanza Cloud Data Fusion devono trovarsi nello stesso progetto.

Configurare il plug-in

1. Vai all'interfaccia web di Cloud Data Fusion e fai clic su Studio.
2. Verifica che sia selezionata l'opzione Pipeline di dati - Batch (non In tempo reale).
3. Nel menu Origine, fai clic su Tabella SAP. Il nodo SAP Table viene visualizzato nella pipeline.
4. Per configurare l'origine, vai al nodo Tabella SAP e fai clic su Proprietà.

5. Inserisci le seguenti proprietà. Per un elenco completo, consulta Proprietà.

   1. Inserisci un'etichetta per il nodo Tabella SAP, ad esempio SAP tables.

   2. Inserisci i dettagli della connessione. Puoi configurare una nuova connessione una tantum o una connessione esistente riutilizzabile.

      Nuova connessione

      Per aggiungere una connessione una tantum a SAP:

      1. Mantieni disattivata l'opzione Usa connessione.

      2. Nella sezione Connessione, inserisci le seguenti informazioni dell'account SAP in questi campi:

         1. Nel campo Nome di riferimento, inserisci un nome per la connessione che identifica questa origine per la derivazione.
         2. Nel campo Client SAP, inserisci il nome client di un'istanza o un ambiente specifico in SAP. Un amministratore SAP può fornire il nome del client.
         3. Nel campo Lingua SAP, inserisci una lingua di accesso SAP. Il valore predefinito è EN (inglese).

         4. Seleziona uno dei seguenti tipi di connessione.

            • Diretto (tramite il server delle applicazioni SAP). Se scegli questo tipo predefinito, inserisci le informazioni nei seguenti campi: Host del server delle applicazioni SAP, Numero di sistema SAP e SAP Router.
            • Bilanciamento del carico (tramite SAP Message Server). Se scegli questo tipo, inserisci le informazioni nei seguenti campi: Host SAP Message Server, Servizio SAP Message Server o numero di porta, ID sistema SAP (SID) e Nome gruppo di accesso SAP.

         5. Nel campo Nome tabella/vista SAP, inserisci il nome della tabella o della vista del tuo sistema SAP.

         6. Fornisci le credenziali SAP: chiedi all'amministratore SAP Nome utente di accesso SAP e Password.

         7. Nel campo Percorso Cloud Storage della libreria JCo, inserisci il percorso di SAP Java Connector (SAP JCo) in Cloud Storage che contiene i file della libreria SAP JCo che hai caricato.

         8. Per generare uno schema basato sui metadati di SAP che mappano i tipi di dati SAP ai tipi di dati Cloud Data Fusion corrispondenti, fai clic su Ottieni schema. Per saperne di più, consulta Mappature dei tipi di dati.

         9. (Facoltativo) Per ottimizzare il carico di importazione da SAP, inserisci le informazioni nei seguenti campi:

            1. L'utilizzo delle opzioni di filtro consente di estrarre i record in base a condizioni di selezione, ad esempio colonne con un insieme definito di valori. Definisci le condizioni nella sintassi OpenSQL in una clausola WHERE. Ad esempio, questa query restituisce tutte le righe della tabella Roster in cui la colonna SchoolID ha il valore SchoolID > 52:

               SELECT * FROM Roster WHERE SchoolID > 52;
               

               Per ulteriori informazioni, vedi Filtri supportati.

            2. Nel campo Numero di righe da recuperare, puoi limitare i dati estratti fornendo un numero intero positivo di righe.

            3. Nel campo Numero di suddivisioni, puoi creare partizioni per estrarre i record di dati in parallelo, il che migliora il rendimento. Il numero di suddivisioni può influire sui processi di lavoro SAP e deve essere selezionato con attenzione.

            4. Nel campo Dimensioni pacchetto, specifica il numero di record da estrarre in una singola chiamata di rete SAP. Le dimensioni del pacchetto influiscono sulle prestazioni e sulle risorse disponibili e devono essere selezionate con attenzione.

      Connessione riutilizzabile

      Per riutilizzare una connessione esistente:

      1. Attiva l'opzione Usa connessione.
      2. Fai clic su Browse connections (Sfoglia connessioni).

      3. Fai clic sul nome della connessione.

      Se non esiste una connessione, per crearne una riutilizzabile, segui questi passaggi:

      1. Fai clic su Aggiungi connessione > SapTable.
      2. Nella pagina Crea una connessione SapTable che si apre, inserisci un nome e una descrizione per la connessione.
      3. Nel campo Client SAP, inserisci il nome client di un'istanza o di un ambiente specifico in SAP. Un amministratore SAP può fornire il nome del cliente.
      4. Nel campo Lingua SAP, inserisci una lingua di accesso SAP. Il valore predefinito è EN (inglese).

      5. Seleziona uno dei seguenti tipi di connessione.

         • Diretto (tramite il server delle applicazioni SAP). Se scegli questo tipo predefinito, inserisci le informazioni nei seguenti campi: Host del server applicazioni SAP, Numero di sistema SAP e SAP Router.
         • Bilanciamento del carico (tramite SAP Message Server). Se scegli questo tipo, inserisci le informazioni nei seguenti campi: Host SAP Message Server, Servizio SAP Message Server o numero di porta, ID sistema SAP (SID) e Nome del gruppo di accesso SAP.

      6. Fornisci le credenziali SAP: chiedi all'amministratore SAP i valori Nome utente di accesso SAP e Password.

      7. Nel campo Percorso Cloud Storage della libreria JCo, inserisci il percorso di SAP Java Connector (SAP JCo) in Cloud Storage che contiene i file della libreria SAP JCo che hai caricato.

      8. (Facoltativo) Nel campo Proprietà di connessione SAP aggiuntive, inserisci le coppie chiave-valore che devono sostituire i valori predefiniti di SAP JCo.

      9. Fai clic su Crea.

Proprietà

    SELECT * FROM table_name WHERE column_name > value; \
    SELECT * FROM table_name WHERE column_name BETWEEN value1 AND value2;
    

    SELECT * FROM table_name WHERE column_name LIKE 'pattern%';
    

    SELECT * FROM table_name WHERE column_name \
      IN ('value1', 'value2', 'value3');
    

    SELECT * FROM table_name WHERE condition1 AND condition2; \
      SELECT * FROM table_name WHERE condition1 OR condition2; \
      SELECT * FROM table_name WHERE NOT condition;
    

    SELECT * FROM table_name \
      WHERE datetime_column >= 'start_date' AND datetime_column <= 'end_date';
    

    SELECT * FROM table_name WHERE datetime_column > 'target_date';
    

    SELECT * FROM table_name \
      WHERE datetime_column >= 'target_datetime' \
      AND datetime_column <= 'target_datetime';
    

    SELECT * FROM table_name \
      WHERE (column1 = 'value1' AND column2 > value2) \
      OR (column3 = 'value3' AND column4 < value4);
    

    ( ERNAM EQ 'LEE' AND AUDAT GT '20220722' ) \
      OR ( BSTNK EQ 'PO54321065' AND BSTDK LT '20220714' )
    

    SELECT * FROM table_name \
      WHERE (column1 = 'value1' OR (column2 = 'value2' AND column3 > value3)) \
      AND column4 = 'value4';
    

    ( ERDAT EQ '20220722' OR ( ERNAM EQ 'LEE' AND VDATU GT '20210623' ) ) \
      AND FMBDAT EQ '20220722'
    

    SELECT * FROM table_name \
      WHERE column1 IN (SELECT related_column FROM other_table WHERE condition);
    

    SELECT * FROM table_name \
      WHERE (column1 = 'value1' OR column2 = 'value2') \
      AND datetime_column > 'target_datetime';
    

    ( ERDAT EQ '20220722' OR ERNAM EQ 'LEE' ) AND VDATU GT '20210623'
    

    SELECT * FROM table_name \
      WHERE datetime_column >= 'YYYY-MM-DD HH:MM:SS' \
      AND datetime_column <= 'YYYY-M
    

    SELECT * FROM table_name \
      WHERE datetime_column >= NOW() - INTERVAL X DAY;
    

    WHERE YEAR+0(4) = 2023
    

Casi d'uso

Sono supportati due contesti di estrazione:

• Tabelle e visualizzazioni del database SAP
• SAP ABAP CDS

In ciascuno dei contesti, il plug-in Tabella SAP supporta tabelle e viste di database standard e personalizzate.

Limitazioni

Il plug-in SAP Table presenta le seguenti limitazioni:

• Non supporta l'unione di tabelle.
• Non supporta le viste CDS con parametri.
• Non supporta i campi senza chiave.
• Se la funzionalità Snapshot è abilitata, l'utilizzo di una dimensione del pacchetto superiore a 30.000 potrebbe causare errori della pipeline. Le dimensioni del pacchetto possono variare a seconda del numero di colonne nella tabella SAP. Puoi calcolare una dimensione ottimale del pacchetto per una tabella utilizzando questa formula: dimensione riga (in numero di caratteri) * 5.
• Connection Manager ti consente di sfogliare un massimo di 1000 nomi di tabelle SAP.
• Quando si verifica un errore della pipeline, ad esempio un errore nel sink, il plug-in SAP Table tenta di liberare spazio per tutti i processi lato SAP attivi correlati all'estrazione chiamando la RFM personalizzata destinata alla pulizia: /GOOG/RFC_READ_TABLE_CLEANUP.

Passaggi successivi

• Scopri di più su SAP su Google Cloud.