Menyalin data dari DB2 menggunakan Azure Data Factory atau 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 atau Azure Synapse Analytics untuk menyalin data dari database DB2. Artikel tersebut dibuat berdasarkan artikel gambaran umum aktivitas salin yang menyajikan gambaran umum aktivitas salin.
Kemampuan yang didukung
Konektor DB2 ini didukung untuk kemampuan berikut ini:
Kemampuan yang didukung | IR |
---|---|
Aktivitas penyalinan (sumber/-) | (1) (2) |
Aktivitas pencarian | (1) (2) |
① 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 DB2 ini mendukung platform dan versi IBM DB2 berikut dengan Arsitektur Basis Data Relasional Terdistribusi (DRDA) SQL Access Manager (SQLAM) versi 9, 10 dan 11. Ini menggunakan protokol DDM/DRDA.
- IBM DB2 untuk z/OS 12.1
- IBM DB2 untuk z/OS 11.1
- IBM DB2 untuk i 7.3
- IBM DB2 untuk i 7.2
- IBM DB2 untuk i 7.1
- IBM DB2 untuk LUW 11
- IBM DB2 untuk LUW 10.5
- IBM DB2 untuk LUW 10.1
Prasyarat
Jika penyimpanan data Anda terletak di dalam jaringan lokal, jaringan virtual Azure, atau Amazon Virtual Private Cloud, Anda harus mengonfigurasi runtime integrasi yang dihosting sendiri untuk menghubungkannya.
Jika penyimpanan data Anda adalah layanan data cloud terkelola, Anda dapat menggunakan Azure Integration Runtime. Jika akses dibatasi untuk IP yang disetujui dalam aturan firewall, Anda dapat menambahkan IP Azure Integration Runtime ke daftar izinkan.
Anda juga dapat menggunakan fitur runtime integrasi jaringan virtual terkelola di Azure Data Factory untuk mengakses jaringan lokal tanpa menginstal dan mengonfigurasi runtime integrasi yang dihosting sendiri.
Untuk informasi selengkapnya tentang mekanisme dan opsi keamanan jaringan yang didukung oleh Data Factory, lihat Strategi akses data.
Integration Runtime menyediakan driver DB2 bawaan, oleh karena itu Anda tidak perlu menginstal driver apa pun secara manual saat menyalin data dari DB2.
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
Buat layanan tertaut ke DB2 menggunakan Antarmuka Pengguna
Gunakan langkah-langkah berikut untuk membuat layanan tertaut ke DB2 di antarmuka pengguna portal Microsoft Azure.
Telusuri ke tab Kelola di ruang kerja Azure Data Factory atau Synapse Anda dan pilih Layanan Tertaut, lalu klik Baru:
Cari DB2 dan pilih konektor DB2.
Konfigurasikan detail layanan, uji koneksi, dan buat layanan tertaut baru.
Detail konfigurasi konektor
Bagian berikut ini menyediakan detail tentang properti yang digunakan untuk menentukan entitas Data Factory khusus untuk konektor DB2.
Properti layanan tertaut
Properti berikut ini didukung untuk layanan tertaut DB2:
Properti | Deskripsi | Wajib |
---|---|---|
jenis | Properti jenis harus diatur ke: Db2 | Ya |
connectionString | Tentukan informasi yang diperlukan untuk menyambungkan ke instans DB2. Anda juga dapat menyimpan kata sandi di Azure Key Vault dan mengeluarkan konfigurasi password dari string koneksi. Lihat sampel berikut dan artikel Menyimpan info masuk di Azure Key Vault untuk detail selengkapnya. |
Ya |
connectVia | Runtime integrasi yang akan digunakan untuk menyambungkan ke penyimpanan data. Pelajari selengkapnya dari bagian Prasyarat. Jika tidak ditentukan, Azure Integration Runtime default akan digunakan. | No |
Properti umum di dalam string koneksi:
Properti | Deskripsi | Wajib diisi |
---|---|---|
server | Nama server DB2. Anda dapat menentukan nomor port setelah nama server dibatasi oleh titik dua misalnya server:port .Konektor DB2 menggunakan protokol DDM/DRDA, dan secara default menggunakan port 50000 jika tidak ditentukan. Port yang digunakan database DB2 spesifik Anda mungkin berbeda berdasarkan versi dan pengaturan Anda, misalnya untuk DB2 LUW port{i> DB2 z/OS, DB2 iSeries, dan DB2 LUW. |
Ya |
database | Nama database DB2. | Ya |
authenticationType | Jenis autentikasi yang digunakan untuk menyambungkan ke database DB2. Nilai yang diizinkan adalah: Dasar. |
Ya |
Nama pengguna | Tentukan nama pengguna untuk menyambungkan ke database{i> | Ya |
kata sandi | Tentukan kata sandi untuk akun pengguna yang Anda tentukan untuk username. Tandai bidang ini sebagai SecureString untuk menyimpannya dengan aman, atau mereferensikan rahasia yang disimpan di Azure Key Vault. | Ya |
packageCollection | Tentukan di bawah di mana paket yang diperlukan dibuat secara otomatis oleh layanan saat membuat kueri database. Jika tidak diatur, layanan menggunakan {nama pengguna} sebagai nilai default. | No |
certificateCommonName | Saat menggunakan enkripsi Lapisan Soket Aman (SSL) atau Keamanan Lapisan Transportasi (TLS), Anda harus memasukkan nilai untuk nama umum Sertifikat. | No |
Tip
Jika menerima pesan kesalahan yang menyatakan The package corresponding to an SQL statement execution request was not found. SQLSTATE=51002 SQLCODE=-805
, alasannya adalah paket yang diperlukan tidak dibuat untuk pengguna. Secara default, layanan akan mencoba membuat paket di bawah koleksi yang ditetapkan sebagai pengguna yang Anda gunakan untuk menyambungkan ke DB2. Tentukan properti pengumpulan paket untuk menunjukkan di mana Anda ingin layanan membuat paket yang diperlukan saat membuat kueri database. Jika Anda tidak dapat menentukan nama koleksi paket, coba atur packageCollection=NULLID
.
Contoh:
{
"name": "Db2LinkedService",
"properties": {
"type": "Db2",
"typeProperties": {
"connectionString": "server=<server:port>;database=<database>;authenticationType=Basic;username=<username>;password=<password>;packageCollection=<packagecollection>;certificateCommonName=<certname>;"
},
"connectVia": {
"referenceName": "<name of Integration Runtime>",
"type": "IntegrationRuntimeReference"
}
}
}
Contoh: simpan kata sandi di Azure Key Vault
{
"name": "Db2LinkedService",
"properties": {
"type": "Db2",
"typeProperties": {
"connectionString": "server=<server:port>;database=<database>;authenticationType=Basic;username=<username>;packageCollection=<packagecollection>;certificateCommonName=<certname>;",
"password": {
"type": "AzureKeyVaultSecret",
"store": {
"referenceName": "<Azure Key Vault linked service name>",
"type": "LinkedServiceReference"
},
"secretName": "<secretName>"
}
},
"connectVia": {
"referenceName": "<name of Integration Runtime>",
"type": "IntegrationRuntimeReference"
}
}
}
Jika menggunakan layanan tertaut DB2 dengan muatan berikut, layanan ini masih didukung apa adanya, sementara Anda disarankan untuk menggunakan yang baru ke depannya.
Payload sebelumnya:
{
"name": "Db2LinkedService",
"properties": {
"type": "Db2",
"typeProperties": {
"server": "<servername:port>",
"database": "<dbname>",
"authenticationType": "Basic",
"username": "<username>",
"password": {
"type": "SecureString",
"value": "<password>"
}
},
"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 DB2.
Untuk menyalin data dari DB2, properti berikut ini didukung:
Properti | Deskripsi | Wajib |
---|---|---|
jenis | Properti jenis himpunan data harus diatur ke: Db2Table | Ya |
skema | Nama skema. | Tidak (jika "kueri" di sumber aktivitas ditentukan) |
tabel | Nama tabel. | Tidak (jika "kueri" di sumber aktivitas ditentukan) |
tableName | Nama tabel dengan skema. Properti ini didukung untuk kompatibilitas mundur. Untuk beban kerja baru, gunakan schema dan table . |
Tidak (jika "kueri" di sumber aktivitas ditentukan) |
Contoh
{
"name": "DB2Dataset",
"properties":
{
"type": "Db2Table",
"typeProperties": {},
"schema": [],
"linkedServiceName": {
"referenceName": "<DB2 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 data DB2.
DB2 sebagai sumber data
Untuk menyalin data dari DB2, properti berikut ini didukung di bagian sumber aktivitas salin:
Properti | Deskripsi | Wajib |
---|---|---|
jenis | Properti jenis dari sumber aktivitas salin harus diatur ke: Db2Source | Ya |
pertanyaan | Gunakan kueri SQL kustom untuk membaca data. Misalnya: "query": "SELECT * FROM \"DB2ADMIN\".\"Customers\"" . |
Tidak (jika "tableName" di himpunan data ditentukan) |
Contoh:
"activities":[
{
"name": "CopyFromDB2",
"type": "Copy",
"inputs": [
{
"referenceName": "<DB2 input dataset name>",
"type": "DatasetReference"
}
],
"outputs": [
{
"referenceName": "<output dataset name>",
"type": "DatasetReference"
}
],
"typeProperties": {
"source": {
"type": "Db2Source",
"query": "SELECT * FROM \"DB2ADMIN\".\"Customers\""
},
"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 jenis data untuk DB2
Saat menyalin data dari DB2, pemetaan berikut digunakan dari jenis data DB2 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.
Jenis Database DB2 | Jenis data layanan sementara |
---|---|
Bigint | Int64 |
Biner | Byte[] |
Blob | Byte[] |
Char | String |
Clob | String |
Tanggal | Tanggalwaktu |
DB2DynArray | String |
DbClob | String |
Decimal | Decimal |
DecimalFloat | Decimal |
Laju | Laju |
Float | Laju |
Graphic | String |
Bilangan bulat | Int32 |
LongVarBinary | Byte[] |
LongVarChar | String |
LongVarGraphic | String |
Numerik | Decimal |
Riil | Tunggal |
SmallInt | Int16 |
Waktu | TimeSpan |
Tanda Waktu | DateTime |
VarBinary | Byte[] |
VarChar | String |
VarGraphic | String |
Xml | Byte[] |
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.