Menyalin data dari Couchbase menggunakan Azure Data Factory (Pratinjau)

BERLAKU UNTUK: Azure Data Factory Azure Synapse Analytics

Artikel ini menguraikan cara menggunakan Copy Activity di Azure Data Factory untuk menyalin data dari Couchbase. Artikel tersebut dibuat berdasarkan artikel ringkasan aktivitas penyalinan yang menyajikan ringkasan aktivitas penyalinan umum.

Penting

Konektor ini saat ini dalam pratinjau. Anda dapat mencobanya dan memberi kami umpan balik. Jika Anda ingin mengambil dependensi pada konektor pratinjau dalam solusi Anda, hubungi Dukungan Azure.

Kemampuan yang didukung

Konektor Couchbase ini didukung untuk aktivitas berikut:

Anda dapat menyalin data dari Couchbase ke penyimpanan data sink yang didukung. Untuk daftar penyimpanan data yang didukung sebagai sumber/sink oleh aktivitas penyalinan, lihat tabel Penyimpanan data yang didukung.

Azure Data Factory memberikan driver bawaan untuk mengaktifkan konektivitas, oleh karena itu Anda tidak perlu memasang driver apa pun secara manual menggunakan konektor ini.

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.

Memulai

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

Membuat layanan tertaut ke Couchbase menggunakan Antarmuka Pengguna

Gunakan langkah-langkah berikut untuk membuat layanan tertaut ke Couchbase di Antarmuka Pengguna portal Microsoft Azure.

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

  2. Cari Couchbase dan pilih konektor Couchbase.

    Cuplikan layar konektor Couchbase.

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

    Cuplikan layar konfigurasi layanan tertaut untuk Couchbase.

Detail konfigurasi konektor

Bagian berikut ini memberikan detail tentang properti yang digunakan untuk menentukan entitas Data Factory khusus untuk konektor Couchbase.

Properti layanan tertaut

Properti berikut ini didukung untuk layanan tertaut Couchbase:

Properti Deskripsi Diperlukan
jenis Properti jenis harus diatur ke: Couchbase Ya
connectionString String koneksi ODBC untuk terhubung ke Couchbase.
Anda juga dapat meletakkan string info masuk di Azure Key Vault dan menarik credString konfigurasi keluar dari string koneksi. Lihat sampel berikut dan artikel Menyimpan informasi masuk di Azure Key Vault untuk detail lengkapnya.
Ya
connectVia Runtime integrasi yang akan digunakan untuk menyambungkan ke penyimpanan data. Pelajari lebih lanjut dari bagian Prasyarat. Jika tidak ditentukan, Azure Integration Runtime default akan digunakan. Tidak

Contoh:

{
    "name": "CouchbaseLinkedService",
    "properties": {
        "type": "Couchbase",
        "typeProperties": {
            "connectionString": "Server=<server>; Port=<port>;AuthMech=1;CredString=[{\"user\": \"JSmith\", \"pass\":\"access123\"}, {\"user\": \"Admin\", \"pass\":\"simba123\"}];"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Contoh: menyimpan string info masuk di Azure Key Vault

{
    "name": "CouchbaseLinkedService",
    "properties": {
        "type": "Couchbase",
        "typeProperties": {
            "connectionString": "Server=<server>; Port=<port>;AuthMech=1;",
            "credString": { 
                "type": "AzureKeyVaultSecret", 
                "store": { 
                    "referenceName": "<Azure Key Vault linked service name>", 
                    "type": "LinkedServiceReference" 
                }, 
                "secretName": "<secretName>" 
            }
        },
        "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 memberikan daftar properti yang didukung oleh himpunan data Couchbase.

Untuk menyalin data dari Couchbase, atur properti jenis himpunan data ke CouchbaseTable. Berikut ini adalah properti yang didukung:

Properti Deskripsi Diperlukan
jenis Properti jenis himpunan data harus diatur ke: CouchbaseTable Ya
tableName Nama tabel. Tidak (jika "query" di sumber aktivitas ditentukan)

Contoh

{
    "name": "CouchbaseDataset",
    "properties": {
        "type": "CouchbaseTable",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Couchbase linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Properti aktivitas penyalinan

Untuk daftar lengkap bagian dan properti yang tersedia untuk menentukan aktivitas, lihat artikel Alur. Bagian ini memberikan daftar properti yang didukung oleh sumber Couchbase.

CouchbaseSource sebagai sumber

Untuk menyalin data dari Couchbase, atur jenis sumber dalam aktivitas penyalinan ke CouchbaseSource. Berikut ini properti yang didukung di bagian sumber aktivitas penyalinan:

Properti Deskripsi Diperlukan
jenis Properti jenis sumber aktivitas penyalinan harus diatur ke: CouchbaseSource Ya
kueri Gunakan kueri SQL kustom untuk membaca data. Contoh: "SELECT * FROM MyTable". Tidak (jika tableName dari himpunan data ditentukan)

Contoh:

"activities":[
    {
        "name": "CopyFromCouchbase",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Couchbase input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "CouchbaseSource",
                "query": "SELECT * FROM MyTable"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Properti aktivitas pencarian

Untuk mempelajari detail tentang properti ini, periksaAktivitas pencarian.

Langkah berikutnya

Untuk daftar penyimpanan data yang didukung sebagai sumber dan sink oleh aktivitas penyalinan di Azure Data Factory, lihat penyimpanan data yang didukung.