Menyalin data dari tabel SAP menggunakan Azure Data Factory atau Azure Synapse Analytics

BERLAKU UNTUK: Azure Data Factory Azure Synapse Analytics

Artikel ini menguraikan cara menggunakan aktivitas salin di alur Azure Data Factory dan Azure Synapse Analytics untuk menyalin data dari tabel SAP. Untuk informasi lebih lanjut, lihat Gambaran Umum aktivitas salin.

Kemampuan yang didukung

Konektor tabel SAP ini didukung untuk kemampuan berikut:

① Runtime integrasi Azure ② Runtime integrasi yang dihost sendiri

Untuk daftar penyimpanan data yang didukung sebagai sumber atau sink oleh aktivitas salin, lihat tabel Penyimpanan data yang didukung.

Secara khusus, konektor tabel SAP ini mendukung:

• Menyalin data dari tabel SAP di:

  • SAP ERP Central Component (SAP ECC) versi 7.01 atau yang lebih baru (dalam SAP Support Package Stack terbaru yang dirilis setelah 2015).
  • SAP Business Warehouse (SAP BW) versi 7.01 atau lebih tinggi (dalam SAP Support Package Stack terbaru yang dirilis setelah tahun 2015).
  • SAP S/4HANA.
  • Produk lain dalam SAP Business Suite versi 7.01 atau lebih tinggi (dalam SAP Support Package Stack terbaru yang dirilis setelah tahun 2015).

• Menyalin data baik dari tabel transparan SAP, tabel yang dikumpulkan, tabel berkluster, dan tampilan.

• Menyalin data dengan menggunakan autentikasi dasar atau Secure Network Communication (SNC), jika SNC dikonfigurasi.

• Menyambungkan ke server aplikasi SAP atau server pesan SAP.

• Mengambil data melalui RFC default atau kustom.

Untuk informasi selengkapnya tentang SNC, lihat Mulai menggunakan SAP SNC untuk integrasi RFC - blog SAP.

Versi 7.01 atau yang lebih baru mengacu pada versi SAP NetWeaver, bukan versi SAP ECC. Misalnya, SAP ECC 6.0 EHP 7 secara umum memiliki NetWeaver versi >=7.4. Jika Anda tidak yakin tentang lingkungan Anda, berikut adalah langkah-langkah untuk mengonfirmasi versi dari sistem SAP Anda:

1. Gunakan SAP GUI untuk menyambungkan ke Sistem SAP.
2. Buka Sistem ->Status.
3. Periksa rilis SAP_BASIS, pastikan sama dengan atau lebih besar dari 701.
   

Prasyarat

Untuk menggunakan konektor tabel SAP ini, Anda perlu:

• Menyiapkan runtime integrasi yang dihost sendiri (versi 3.17 atau yang lebih baru). Untuk informasi selengkapnya, lihat Buat dan konfigurasi runtime integrasi yang dihost sendiri.

• Unduh Konektor SAP 64-bit untuk Microsoft .NET 3.0 dari situs web SAP, dan pasang di komputer IR yang dihost sendiri. Selama penginstalan, pastikan Anda memilih opsi Instal Rakitan ke GAC di jendela Langkah persiapan opsional.

  

• Pengguna SAP yang sedang digunakan di konektor tabel SAP harus memiliki izin berikut:

  • Otorisasi untuk menggunakan tujuan Remote Function Call (RFC).
  • Izin untuk aktivitas Eksekusi dari objek otorisasi S_SDSAUTH. Anda dapat merujuk ke SAP Note 460089 pada objek otorisasi mayoritas. RFC tertentu diperlukan oleh konektor NCo yang mendasarinya, misalnya RFC_FUNCTION_SEARCH.

Memulai

Untuk melakukan aktivitas Salin dengan alur, Anda dapat menggunakan salah satu alat atau SDK berikut:

• Alat Penyalinan Data
• Portal Microsoft Azure
• SDK .NET
• SDK Python
• Azure PowerShell
• REST API
• Templat Azure Resource Manager

Membuat layanan tertaut ke tabel SAP menggunakan UI

Gunakan langkah-langkah berikut untuk membuat layanan tertaut ke tabel SAP di UI portal Azure.

1. Telusuri ke tab Kelola di ruang kerja Azure Data Factory atau Synapse Anda dan pilih Layanan Tertaut, lalu klik Baru:

   • Azure Data Factory
   • Azure Synapse

   

2. Cari SAP dan pilih konektor tabel SAP.

   

3. Konfigurasikan detail layanan, uji koneksi, dan buat layanan tertaut baru.

   

Detail konfigurasi konektor

Bagian berikut memberikan detail tentang properti yang digunakan untuk menentukan entitas khusus untuk konektor tabel SAP.

Properti layanan tertaut

Properti berikut didukung untuk layanan tertaut SAP BW Open Hub:

Contoh 1: Sambungkan ke server aplikasi SAP

{
    "name": "SapTableLinkedService",
    "properties": {
        "type": "SapTable",
        "typeProperties": {
            "server": "<server name>",
            "systemNumber": "<system number>",
            "clientId": "<client ID>",
            "userName": "<SAP user>",
            "password": {
                "type": "SecureString",
                "value": "<Password for SAP user>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Contoh 2: Sambungkan ke server pesan SAP

{
    "name": "SapTableLinkedService",
    "properties": {
        "type": "SapTable",
        "typeProperties": {
            "messageServer": "<message server name>",
            "messageServerService": "<service name or port>",
            "systemId": "<system ID>",
            "logonGroup": "<logon group>",
            "clientId": "<client ID>",
            "userName": "<SAP user>",
            "password": {
                "type": "SecureString",
                "value": "<Password for SAP user>"
            }
        },
        "connectVia": {
            "referenceName": "<name of integration runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Contoh 3: Sambungkan dengan menggunakan SNC

{
    "name": "SapTableLinkedService",
    "properties": {
        "type": "SapTable",
        "typeProperties": {
            "server": "<server name>",
            "systemNumber": "<system number>",
            "clientId": "<client ID>",
            "userName": "<SAP user>",
            "password": {
                "type": "SecureString",
                "value": "<Password for SAP user>"
            },
            "sncMode": 1,
            "sncMyName": "<SNC myname>",
            "sncPartnerName": "<SNC partner name>",
            "sncLibraryPath": "<SNC library path>",
            "sncQop": "8"
        },
        "connectVia": {
            "referenceName": "<name of integration runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Untuk informasi selengkapnya tentang SNC, lihat Mulai menggunakan SAP SNC untuk integrasi RFC - blog SAP.

Properti himpunan data

Untuk daftar lengkap bagian dan properti untuk menentukan himpunan data, lihat Himpunan data. Bagian berikut berisi daftar properti yang didukung oleh himpunan data tabel SAP.

Untuk menyalin data dari dan ke layanan tertaut SAP BW Open Hub, properti berikut ini didukung:

Contoh

{
    "name": "SAPTableDataset",
    "properties": {
        "type": "SapTableResource",
        "typeProperties": {
            "tableName": "<SAP table name>"
        },
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<SAP table linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Properti aktivitas salin

Untuk daftar lengkap bagian dan properti untuk menentukan aktivitas, lihat Alur. Bagian berikut berisi daftar properti yang didukung oleh sumber tabel SAP.

Tabel SAP sebagai sumber

Untuk menyalin data dari tabel SAP, properti berikut didukung:

Dalam rfcTableOptions, Anda bisa menggunakan operator kueri SAP umum berikut ini untuk memfilter baris:

Contoh

"activities":[
    {
        "name": "CopyFromSAPTable",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<SAP table input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SapTableSource",
                "partitionOption": "PartitionOnInt",
                "partitionSettings": {
                     "partitionColumnName": "<partition column name>",
                     "partitionUpperBound": "2000",
                     "partitionLowerBound": "1",
                     "maxPartitionsNumber": 500
                 }
            },
            "sink": {
                "type": "<sink type>"
            },
            "parallelCopies": 4
        }
    }
]

Gabungkan tabel SAP

Saat ini konektor Tabel SAP hanya mendukung satu tabel dengan modul fungsi default. Untuk mendapatkan data yang digabungkan dari beberapa tabel, Anda bisa memanfaatkan properti customRfcReadTableFunctionModule di konektor Tabel SAP dengan langkah-langkah berikut:

• Tulis modul fungsi kustom, yang dapat mengambil kueri sebagai OPTIONS dan menerapkan logika Anda sendiri untuk mengambil data.
• Untuk "Modul fungsi kustom", masukkan nama modul fungsi kustom Anda.
• Untuk "opsi tabel RFC", tentukan pernyataan gabungan tabel untuk menyalurkan ke modul fungsi Anda sebagai OPTIONS, misalnya "<TABLE1> INNER JOIN <TABLE2> ON COLUMN0".

Di Bawah ini adalah contohnya:

Buat modul fungsi kustom

Untuk tabel SAP, saat ini kami mendukung properti customRfcReadTableFunctionModule di sumber salinan, yang memungkinkan Anda memanfaatkan data logika dan proses Anda sendiri.

Sebagai panduan singkat, berikut adalah beberapa persyaratan untuk memulai dengan "Modul fungsi kustom":

• Definisi:

  

• Ekspor data ke salah satu tabel di bawah ini:

  

  

Di bawah ini adalah ilustrasi tentang cara kerja konektor tabel SAP dengan modul fungsi kustom:

1. Bangun koneksi dengan server SAP melalui SAP NCO.

2. Panggil "Modul fungsi kustom" dengan parameter yang diatur seperti di bawah ini:

   • QUERY_TABLE: nama tabel yang Anda tetapkan di himpunan data Tabel SAP;
   • Pemisah: pemisah yang Anda tetapkan di Sumber Tabel SAP;
   • ROWCOUNT/Option/Fields: Rowcount/Aggregated Option/Fields yang Anda atur di sumber Tabel.

3. Dapatkan hasilnya dan pilah data dengan cara di bawah ini:

   1. Pilah nilai dalam tabel Fields untuk mendapatkan skema.

      

   2. Dapatkan nilai tabel output untuk melihat tabel mana yang berisi nilai-nilai ini.

      

   3. Dapatkan nilai dalam OUT_TABLE, pilah data lalu tulis ke sink.

Pemetaan jenis data untuk tabel SAP

Saat Anda menyalin data dari tabel SAP, pemetaan berikut digunakan dari jenis data tabel SAP ke jenis data sementara yang digunakan dalam layanan. Untuk mempelajari bagaimana aktivitas salin memetakan skema sumber dan jenis data ke sink, lihat Pemetaan skema dan jenis data.

Properti aktivitas pencarian

Untuk mempelajari detail tentang properti, lihat Aktivitas pencarian.

Konten terkait

Untuk daftar penyimpanan data yang didukung sebagai sumber dan sink oleh aktivitas salin, lihat Penyimpanan data yang didukung.