Menyalin data dari dan ke penyimpanan data ODBC menggunakan Azure Data Factory atau Synapse Analytics

BERLAKU UNTUK: Azure Data Factory Azure Synapse Analytics

Artikel ini menguraikan cara menggunakan Aktivitas Salin di Azure Data Factory untuk menyalin data dari dan ke penyimpanan data Konektivitas Database Terbuka. Artikel tersebut dibuat berdasarkan artikel gambaran umum aktivitas salin yang menyajikan gambaran umum aktivitas salin.

Kemampuan yang didukung

Konektor ODBC ini didukung untuk kemampuan berikut:

① Runtime integrasi Azure ② Runtime integrasi yang dihost sendiri

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

Secara khusus, konektor ODBC ini mendukung penyalinan data dari/ke penyimpanan data yang kompatibel dengan ODBC menggunakan autentikasi Dasar atau Anonim. Diperlukan pengandar ODBC 64-bit. Untuk sink ODBC, dukungan layanan ODBC versi 2.0 standar.

Prasyarat

Untuk menggunakan konektor ODBC ini, Anda perlu:

• Menyiapkan IR yang dihost sendiri. Lihat Artikel Integration Runtime yang dihost sendiri untuk detailnya.
• Instal pengandar ODBC 64-bit untuk penyimpanan data pada komputer Integration Runtime.

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 penyimpanan data ODBC menggunakan UI

Gunakan langkah-langkah berikut untuk membuat layanan tertaut ke penyimpanan data ODBC di UI portal Microsoft 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 ODBC dan pilih konektor ODBC.

   

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 Data Factory khusus untuk konektor ODBC.

Properti layanan tertaut

Berikut ini properti yang didukung untuk layanan tertaut ODBC:

Contoh 1: Menggunakan autentikasi Dasar

{
    "name": "ODBCLinkedService",
    "properties": {
        "type": "Odbc",
        "typeProperties": {
            "connectionString": "<connection string>",
            "authenticationType": "Basic",
            "userName": "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Contoh 2: menggunakan autentikasi Anonim

{
    "name": "ODBCLinkedService",
    "properties": {
        "type": "Odbc",
        "typeProperties": {
            "connectionString": "<connection string>",
            "authenticationType": "Anonymous",
            "credential": {
                "type": "SecureString",
                "value": "RefreshToken=<secret refresh token>;"
            }
        },
        "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 ODBC.

Untuk menyalin data dari/ke penyimpanan data yang kompatibel dengan ODBC, berikut properti yang didukung:

Contoh

{
    "name": "ODBCDataset",
    "properties": {
        "type": "OdbcTable",
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<ODBC linked service name>",
            "type": "LinkedServiceReference"
        },
        "typeProperties": {
            "tableName": "<table name>"
        }
    }
}

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 himpunan data ODBC.

ODBC sebagai sumber

Untuk menyalin data dari penyimpanan data yang kompatibel dengan ODBC, berikut properti yang didukung di bagiansumberaktivitas salin:

Contoh:

"activities":[
    {
        "name": "CopyFromODBC",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<ODBC input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "OdbcSource",
                "query": "SELECT * FROM MyTable"
            },
            "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.

ODBC sebagai sink

Untuk menyalin data ke penyimpanan data yang kompatibel dengan ODBC, atur jenis sink dalam aktivitas salin ke OdbcSink. Berikut adalah properti yang didukung di bagian sink aktivitas salin:

Contoh:

"activities":[
    {
        "name": "CopyToODBC",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<ODBC output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "<source type>"
            },
            "sink": {
                "type": "OdbcSink",
                "writeBatchSize": 100000
            }
        }
    }
]

Properti aktivitas pencarian

Untuk mempelajari detail tentang properti, lihat Aktivitas pencarian.

Memecahkan masalah konektivitas

Untuk memecahkan masalah koneksi, gunakan tab DiagnostikIntegration Runtime Configuration Manager..

1. Luncurkan Integration Runtime Configuration Manager.
2. Beralih ke tab Diagnostik.
3. Di bagian "Koneksi Uji", pilih jenis penyimpanan data (layanan tertaut).
4. Tentukan string koneksi yang digunakan untuk menyambungkan ke penyimpanan data, pilih autentikasi dan masukkan nama pengguna, kata sandi,dan/atau informasi masuk.
5. Klik Uji koneksi untuk menguji koneksi ke penyimpanan data.

Konten terkait

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