Tujuan ADO NET
Berlaku untuk:
SQL Server SSIS Integration Runtime di Azure Data Factory
Tujuan ADO NET memuat data ke dalam berbagai ADO. Database yang mematuhi NET yang menggunakan tabel atau tampilan database. Anda memiliki opsi untuk memuat data ini ke dalam tabel atau tampilan yang sudah ada, atau Anda dapat membuat tabel baru dan memuat data ke dalam tabel baru.
Anda dapat menggunakan tujuan ADO NET untuk menyambungkan ke Microsoft Azure SQL Database. Menyambungkan ke SQL Database dengan menggunakan OLE DB tidak didukung. Untuk informasi selengkapnya tentang SQL Database, lihat Panduan dan Batasan Umum (Azure SQL Database).
Pemecahan masalah Tujuan ADO NET
Anda dapat mencatat panggilan yang dilakukan tujuan ADO NET ke penyedia data eksternal. Anda dapat menggunakan kemampuan pengelogan ini untuk memecahkan masalah penyimpanan data ke sumber data eksternal yang dilakukan tujuan ADO NET. Untuk mencatat panggilan yang dilakukan tujuan ADO NET ke penyedia data eksternal, aktifkan pengelogan paket dan pilih peristiwa Diagnostik di tingkat paket. Untuk informasi selengkapnya, lihat Alat Pemecahan Masalah untuk Eksekusi Paket.
Mengonfigurasi Tujuan ADO NET
Tujuan ini menggunakan pengelola koneksi ADO.NET untuk menyambungkan ke sumber data dan manajer koneksi menentukan penyedia ADO.NET untuk digunakan. Untuk informasi selengkapnya, lihat ADO.NET Pengelola Sambungan.
Tujuan ADO NET mencakup pemetaan antara kolom input dan kolom di sumber data tujuan. Anda tidak perlu memetakan kolom input ke semua kolom tujuan. Namun, properti beberapa kolom tujuan dapat memerlukan pemetaan kolom input. Jika tidak, kesalahan mungkin terjadi. Misalnya, jika kolom tujuan tidak mengizinkan nilai null, Anda harus memetakan kolom input ke kolom tujuan tersebut. Selain itu, jenis data kolom yang dipetakan harus kompatibel. Misalnya, Anda tidak dapat memetakan kolom input dengan jenis data string ke kolom tujuan dengan jenis data numerik jika penyedia ADO.NET tidak mendukung pemetaan ini.
Catatan
SQL Server tidak mendukung penyisipan teks ke dalam kolom yang tipe datanya diatur ke gambar. Untuk informasi selengkapnya tentang jenis data SQL Server, lihat Jenis Data (Transact-SQL).
Catatan
Tujuan ADO NET tidak mendukung pemetaan kolom input yang jenisnya diatur ke DT_DBTIME ke kolom database yang jenisnya diatur ke datetime. Untuk informasi selengkapnya tentang jenis data Integration Services, lihat Jenis Data Integration Services.
Tujuan ADO NET memiliki satu input reguler dan satu output kesalahan.
Anda dapat mengatur properti melalui SSIS Designer atau secara terprogram.
Kotak dialog Editor Lanjutan mencerminkan properti yang dapat diatur secara terprogram. Untuk informasi selengkapnya tentang properti yang bisa Anda atur dalam kotak dialog Editor Lanjutan atau secara terprogram, klik salah satu topik berikut ini:
Untuk informasi selengkapnya tentang cara mengatur properti, lihat Mengatur Properti Komponen Aliran Data.
Editor Tujuan ADO NET (Halaman Pengelola Sambungan)
Gunakan halaman Pengelola Sambungan kotak dialog Editor Tujuan ADO NET untuk memilih koneksi ADO.NET untuk tujuan. Halaman ini juga memungkinkan Anda memilih tabel atau tampilan dari database.
Untuk membuka halaman Pengelola Sambungan
Di SQL Server Data Tools (SSDT), buka paket Layanan Integrasi yang memiliki tujuan ADO NET.
Pada tab Aliran Data, klik dua kali tujuan ADO NET.
Di Editor Tujuan ADO NET, klik Pengelola Sambungan.
Opsi Statis
Manajer sambungan
Pilih manajer koneksi yang sudah ada dari daftar, atau buat koneksi baru dengan mengklik Baru.
Baru
Buat manajer koneksi baru dengan menggunakan kotak dialog Konfigurasikan ADO.NET Pengelola Sambungan.
Menggunakan tabel atau tampilan
Pilih tabel atau tampilan yang sudah ada dari daftar, atau buat tabel baru dengan mengklik Baru.
Baru
Buat tabel atau tampilan baru dengan menggunakan kotak dialog Buat Tabel .
Catatan
Saat Anda mengklik Baru, Integration Services menghasilkan pernyataan CREATE TABLE default berdasarkan sumber data yang tersambung. Pernyataan CREATE TABLE default ini tidak akan menyertakan atribut FILESTREAM meskipun tabel sumber menyertakan kolom dengan atribut FILESTREAM yang dideklarasikan. Untuk menjalankan komponen Layanan Integrasi dengan atribut FILESTREAM, pertama-tama terapkan penyimpanan FILESTREAM pada database tujuan. Kemudian, tambahkan atribut FILESTREAM ke pernyataan CREATE TABLE dalam kotak dialog Buat Tabel . Untuk informasi selengkapnya, lihat Data Objek Besar Biner (Blob) (SQL Server).
Pratinjau
Pratinjau hasil dengan menggunakan kotak dialog Pratinjau Hasil Kueri. Pratinjau dapat menampilkan hingga 200 baris.
Gunakan sisipan massal jika tersedia
Tentukan apakah akan menggunakan SqlBulkCopy antarmuka untuk meningkatkan performa operasi penyisipan massal.
Hanya penyedia ADO.NET yang mengembalikan objek yang SqlConnection mendukung penggunaan SqlBulkCopy antarmuka. Penyedia Data .NET untuk SQL Server (SqlClient) mengembalikan SqlConnection objek, dan penyedia kustom dapat mengembalikan SqlConnection objek.
Anda dapat menggunakan Penyedia Data .NET untuk SQL Server (SqlClient) untuk menyambungkan ke Microsoft Azure SQL Database.
Jika Anda memilih Gunakan sisipan massal saat tersedia, dan atur opsi Kesalahan untuk Mengalihkan baris, batch data yang dialihkan tujuan ke output kesalahan mungkin menyertakan baris yang baik. Untuk informasi selengkapnya tentang menangani kesalahan dalam operasi massal, lihat Penanganan Kesalahan di Data. Untuk informasi selengkapnya tentang opsi Kesalahan , lihat Editor Tujuan ADO NET (Halaman Output Kesalahan).
Catatan
Jika tabel sumber SQL Server atau Sybase menyertakan kolom identitas, Anda harus menggunakan tugas Jalankan SQL untuk mengaktifkan IDENTITY_INSERT sebelum tujuan ADO NET dan menonaktifkannya lagi setelahnya. (Properti kolom identitas menentukan nilai inkremental untuk kolom. Pernyataan SET IDENTITY_INSERT memungkinkan nilai eksplisit dari tabel sumber disisipkan ke dalam kolom identitas di tabel tujuan.)
Untuk menjalankan pernyataan set IDENTITY_INSERT dan pemuatan data dengan sukses, Anda harus melakukan hal-hal berikut.
1. Gunakan pengelola koneksi ADO.NET yang sama untuk tugas Jalankan SQL dan untuk tujuan ADO.NET.
2. Pada manajer koneksi, atur properti RetainSameConnection dan properti MultipleActiveResultSets ke True.
3. Pada tujuan ADO.NET, atur properti UseBulkInsertWhenPossible ke False.
Untuk informasi selengkapnya, lihat SET IDENTITY_INSERT (Transact-SQL) dan IDENTITY (Property) (Transact-SQL).
Sumber Daya Eksternal
Artikel teknis, Memuat data ke Azure SQL Database dengan cara cepat, pada sqlcat.com
Editor Tujuan ADO NET (Halaman Pemetaan)
Gunakan halaman Pemetaan kotak dialog Editor Tujuan ADO NET untuk memetakan kolom input ke kolom tujuan.
Untuk membuka halaman Pemetaan
Di SQL Server Data Tools (SSDT), buka paket Layanan Integrasi yang memiliki tujuan ADO NET.
Pada tab Aliran Data, klik dua kali tujuan ADO NET.
Di Editor Tujuan ADO NET, klik Pemetaan.
Opsi
Kolom Input yang Tersedia
Lihat daftar kolom input yang tersedia. Gunakan operasi seret dan letakkan untuk memetakan kolom input yang tersedia dalam tabel ke kolom tujuan.
Kolom Tujuan yang Tersedia
Tampilkan daftar kolom tujuan yang tersedia. Gunakan operasi seret dan letakkan untuk memetakan kolom tujuan yang tersedia dalam tabel untuk memasukkan kolom.
Kolom Input
Lihat kolom input yang Anda pilih. Anda dapat menghapus pemetaan dengan memilih <abaikan> untuk mengecualikan kolom dari output.
Kolom Tujuan
Lihat setiap kolom tujuan yang tersedia, terlepas dari apakah kolom tersebut dipetakan atau tidak.
Editor Tujuan ADO NET (Halaman Output Kesalahan)
Gunakan halaman Output Kesalahan dari kotak dialog Editor Tujuan ADO NET untuk menentukan opsi penanganan kesalahan.
Untuk membuka halaman Output Kesalahan
Di SQL Server Data Tools (SSDT), buka paket Layanan Integrasi yang memiliki tujuan ADO NET.
Pada tab Aliran Data, klik dua kali tujuan ADO NET.
Di Editor Tujuan ADO NET, klik Output Kesalahan.
Opsi
Input atau Output
Lihat nama input.
Kolom
Tidak digunakan.
Kesalahan
Tentukan apa yang harus terjadi ketika kesalahan terjadi: abaikan kegagalan, alihkan baris, atau gagalkan komponen.
Topik Terkait: Penanganan Kesalahan dalam Data
Pemotongan
Tidak digunakan.
Keterangan
Lihat deskripsi operasi.
Atur nilai ini ke sel terpilih
Tentukan apa yang harus terjadi pada semua sel yang dipilih saat terjadi kesalahan atau pemotongan: abaikan kegagalan, alihkan baris, atau gagalkan komponen.
Terapkan
Terapkan opsi penanganan kesalahan ke sel terpilih.
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk