Menyalin data dari SAP Business Warehouse menggunakan Azure Data Factory atau Azure Synapse Analytics

BERLAKU UNTUK:Azure Data Factory Azure Synapse Analytics

Tip

Cobalah Data Factory di Microsoft Fabric, solusi analitik all-in-one untuk perusahaan. Microsoft Fabric mencakup semuanya mulai dari pergerakan data hingga ilmu data, analitik real time, kecerdasan bisnis, dan pelaporan. Pelajari cara memulai uji coba baru secara gratis!

Artikel ini menguraikan cara menggunakan Aktivitas Salin di alur Azure Data Factory dan Azure Synapse Analytics untuk menyalin data dari SAP Business Warehouse (BW). Artikel tersebut dibuat berdasarkan artikel gambaran umum aktivitas salin yang menyajikan gambaran umum aktivitas salin.

Tip

Untuk mempelajari dukungan keseluruhan pada skenario integrasi data SAP, lihat laporan resmi Integrasi data SAP menggunakan Azure Data Factory dengan pengenalan mendetail pada setiap konektor, perbandingan, dan panduan SAP.

Kemampuan yang didukung

Konektor SAP Business Warehouse ini didukung untuk kemampuan berikut:

Kemampuan yang didukung IR
Aktivitas penyalinan (sumber/-)
Aktivitas pencarian

① Runtime integrasi Azure ② Runtime integrasi yang dihost sendiri

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

Secara khusus, konektor SAP Business Warehouse ini mendukung:

  • SAP Business Warehouse versi 7.x.
  • Menyalin data dari InfoCubes dan QueryCubes (termasuk kueri BEx) menggunakan kueri MDX.
  • Menyalin data menggunakan autentikasi dasar.

Catatan

Konektor SAP Business Warehouse saat ini tidak mendukung parameter dengan MDX. Jika pemfilteran dengan parameter MDX diperlukan, Anda dapat mempertimbangkan untuk menggunakan konektor SAP Open Hub alternatif sebagai gantinya.

Prasyarat

Untuk menggunakan konektor SAP Business Warehouse ini, Anda perlu:

  • Menyiapkan IR yang dihost sendiri. Lihat Artikel Integration Runtime yang dihost sendiri untuk detailnya.
  • Menginstal pustaka SAP NetWeaver di komputer Integration Runtime. Anda bisa mendapatkan perpustakaan SAP Netweaver dari administrator SAP Anda, atau langsung dari Pusat Unduhan Perangkat Lunak SAP. Cari SAP Note #1025361 untuk mendapatkan lokasi unduhan untuk versi terbaru. Pastikan Anda memilih pustaka SAP NetWeaver 64-bit yang cocok dengan instalasi Integration Runtime Anda. Kemudian instal semua file yang disertakan dalam SAP NetWeaver RFC SDK sesuai dengan SAP Note. Perpustakaan SAP NetWeaver juga disertakan dalam instalasi SAP Client Tools.

Tip

Untuk memecahkan masalah konektivitas ke SAP Business Warehouse, pastikan:

  • Semua pustaka dependensi yang diekstrak dari NetWeaver RFC SDK berada di folder %windir%\system32. Biasanya memiliki icudt34.dll, icuin34.dll, icuuc34.dll, libicudecnumber.dll, librfc32.dll, libsapucum.dll, sapcrypto.dll, sapcryto_old.dll, sapnwrfc.dll.
  • Port yang diperlukan yang digunakan untuk tersambung ke Server SAP diaktifkan pada komputer Runtime integrasi yang dihost sendiri, yang biasanya port 3300 dan 3201.

Memulai

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

Membuat layanan tertaut ke SAP BW menggunakan UI

Gunakan langkah-langkah berikut untuk membuat layanan tertaut ke SAP BW 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:

  2. Cari SAP dan pilih SAP BW melalui konektor MDX.

    Select the SAP BW via MDX connector.

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

    Configure a linked service to SAP BW.

Detail konfigurasi konektor

Bagian berikut ini menyediakan detail tentang properti yang digunakan untuk menentukan entitas Data Factory khusus untuk konektor SAP Business Warehouse.

Properti layanan tertaut

Properti berikut ini didukung untuk layanan tertaut SAP Business Warehouse (BW):

Properti Deskripsi Wajib
jenis Properti type harus diatur ke: SapBw Ya
server Nama server tempat instans SAP Business Warehouse berada. Ya
systemNumber Nomor sistem SAP Business Warehouse.
Nilai yang diizinkan: angka desimal dua digit direpresentasikan sebagai string (karakter).
Ya
clientId ID klien dalam sistem SAP W.
Nilai yang diizinkan: angka desimal tiga digit yang direpresentasikan sebagai string (karakter).
Ya
userName Nama pengguna yang memiliki akses ke server SAP. Ya
kata sandi Kata sandi untuk pengguna. Tandai bidang ini sebagai SecureString untuk menyimpannya dengan aman, atau mereferensikan rahasia yang disimpan di Azure Key Vault. Ya
connectVia Runtime integrasi yang akan digunakan untuk menyambungkan ke penyimpanan data. Runtime integrasi yang dihost sendiri diperlukan seperti yang disebutkan dalam Prasyarat. Ya

Contoh:

{
    "name": "SapBwLinkedService",
    "properties": {
        "type": "SapBw",
        "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"
        }
    }
}

Properti himpunan data

Untuk daftar lengkap bagian dan properti yang tersedia untuk menentukan himpunan data, lihat artikel himpunan data. Bagian ini menyediakan daftar properti yang didukung oleh himpunan data SAP Business Warehouse.

Untuk menyalin data dari SAP Business Warehouse, atur properti type himpunan data ke SapBwCube. Meskipun tidak ada properti spesifik jenis yang didukung untuk himpunan data SAP Business Warehouse jenis RelationalTable.

Contoh:

{
    "name": "SAPBWDataset",
    "properties": {
        "type": "SapBwCube",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<SAP BW linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Jika Anda menggunakan himpunan data berjenis RelationalTable, himpunan data tersebut masih didukung apa adanya, sementara Anda disarankan untuk menggunakan yang baru ke depannya.

Properti aktivitas salin

Untuk daftar lengkap bagian dan properti yang tersedia untuk menentukan aktivitas, lihat artikel Alur. Bagian ini menyediakan daftar properti yang didukung oleh sumber SAP Business Warehouse.

SAP Business Warehouse sebagai sumber

Untuk menyalin data dari SAP Business Warehouse, properti berikut ini didukung di bagian sumber aktivitas salin:

Properti Deskripsi Wajib
jenis Properti type dari sumber aktivitas salin harus diatur ke: SapBwSource Ya
pertanyaan Menentukan kueri MDX untuk membaca data dari instans SAP Business Warehouse. Ya

Contoh:

"activities":[
    {
        "name": "CopyFromSAPBW",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<SAP BW input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SapBwSource",
                "query": "<MDX query for SAP BW>"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Jika Anda menggunakan sumber berjenis RelationalSource, sumber ini masih didukung apa adanya, sementara Anda disarankan untuk menggunakan yang baru ke depannya.

Pemetaan tipe data untuk SAP Business Warehouse

Saat menyalin data dari SAP Business Warehouse, pemetaan berikut digunakan dari jenis data SAP Business Warehouse ke jenis data sementara yang digunakan secara internal dalam layanan. Lihat Pemetaan skema dan jenis data untuk mempelajari bagaimana aktivitas penyalinan memetakan skema sumber dan jenis data ke sink.

Tipe data SAP Business Warehouse Jenis data layanan sementara
ACCP Int
CHAR String
CLNT String
CURR Decimal
CUKY String
DEC Decimal
FLTP Laju
INT1 Byte
INT2 Int16
INT4 Int
LANG String
LCHR String
LRAW Byte[]
PREC Int16
QUAN Decimal
RAW Byte[]
RAWSTRING Byte[]
STRING String
UNIT String
DATS String
NUMC String
TIMS String

Properti aktivitas pencarian

Untuk mempelajari detail tentang properti, lihat Aktivitas pencarian.

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