Bagikan melalui

Tujuan Teradata

Berlaku untuk: SQL Server SSIS Integration Runtime di Azure Data Factory

Tujuan Teradata memuat data secara massal ke Dalam Database Teradata.

Tujuan menggunakan manajer koneksi Teradata untuk menyambungkan ke sumber data. Untuk informasi selengkapnya, lihat Pengelola koneksi Teradata.

Opsi pemuatan

Tujuan Teradata mendukung dua mode pemuatan data:

  • Aliran TPT: Mode ini menggunakan operator TPT API Stream (protokol Teradata TPump).

  • Beban TPT (beban massal cepat): Mode ini menggunakan operator Beban API TPT (protokol Teradata FastLoad) untuk pemuatan massal yang cepat.

Mode beban cepat memiliki batasan di bawah ini:

  • Batas sesi untuk database Teradata ditentukan oleh faktor mana pun di bawah ini yang ditemui terlebih dahulu:

    • Batas sesi diatur menggunakan perintah SESSIONS
    • Batas Database Teradata dari satu sesi per AMP
    • Batas platform pada jumlah maksimum sesi per aplikasi: Ditentukan oleh variabel MaxSess dalam file perangkat lunak Antarmuka prosesor komunikasi (COP), CLISPB.DAT. Anda dapat menggunakan perintah TDP SET MAXSESSIONS untuk menentukan batas platform. Batas default sama dengan MAXSESS server.

  • Indeks gabungan tidak didukung.

  • Referensi kunci asing dalam tabel target tidak didukung.

  • Tabel target yang ditentukan dengan indeks sekunder tidak didukung.

Untuk informasi selengkapnya tentang pembatasan beban cepat Teradata, lihat referensi beban cepat Teradata.

Anda dapat mengatur mode di Editor Tujuan Teradata (Halaman Pengelola Sambungan).

Penanganan kesalahan

Kesalahan yang dikembalikan selama proses pemuatan ditulis ke tabel kesalahan sementara yang dikunci selama proses pemuatan. Jumlah maksimum properti kesalahan (MaxErrors) dalam Editor Lanjutan mengatur jumlah maksimum kesalahan yang dapat ditulis ke tabel ini.

Jika Jumlah maksimum kesalahan lebih besar dari nol, tabel kesalahan dengan nama unik dihasilkan, dan pesan informasi dicetak ke log paket. Kesalahan dapat diambil oleh output kesalahan komponen SSIS standar.

Tabel sementara dihilangkan setelah proses pemuatan selesai. Jika tabel temporal tidak dapat dibaca oleh tujuan Teradata, tabel tersebut tidak dihilangkan kecuali properti Tabel kesalahan selalu dicentang. Jika proses pemuatan dihentikan sebelum selesai, Anda perlu menjatuhkan tabel ini secara manual jika diperlukan. Tabel ini terletak di database yang sama dengan tabel tujuan.

Ketika Jumlah maksimum kesalahan tercapai, status tabel target bergantung pada mode yang digunakan.

  • Dalam mode pemuatan cepat, tabel target tidak dapat digunakan. Untuk menjalankan lagi, Anda harus memotong atau menghilangkan dan membuat ulang tabel target. Pembatalan tidak didukung.
  • Dalam mode operator TPT Steam, tujuan Teradata dijalankan melalui mekanisme baris buffer. Jika pekerjaan gagal, semua perubahan yang selesai (buffer dikirim) pada saat kegagalan bersifat permanen dalam tabel target. Tidak ada konsep putar kembali. Tabel kesalahan akan dihilangkan.

Tujuan Teradata memiliki output kesalahan. Untuk informasi selengkapnya, lihat Editor Tujuan Teradata (Halaman Output Kesalahan).

Paralelisme

Paralelisme dibatasi dalam mode beban cepat, beberapa pekerjaan beban cepat independen tidak dapat mengakses tabel yang sama secara bersamaan. Juga jumlah pekerjaan beban cepat bersamaan dibatasi oleh variabel database MaxLoadTasks.

Tidak ada batasan paralelisme dalam mode Aliran TPT. Dimungkinkan untuk menjalankan beberapa tujuan Teradata secara bersamaan terhadap tabel yang sama, sementara ini dapat mengurangi performa per Teradata. Lihat Dokumentasi Teradata untuk informasi selengkapnya.

Pemecahan masalah tujuan Teradata

Anda dapat mencatat panggilan yang dilakukan sumber Teradata ke TERadata Parallel Transporter API (TPT API). Anda dapat mengaktifkan pengelogan paket dan memilih peristiwa Diagnostik di tingkat paket untuk mencatat panggilan.

Anda dapat mencatat panggilan ODBC yang dilakukan sumber Teradada ke driver TERadata ODBC dengan mengaktifkan jejak manajer driver ODBC. Untuk informasi selengkapnya, lihat dokumentasi Microsoft tentang Cara Membuat Jejak ODBC dengan ODBC Administrator Sumber Data.

Properti kustom tujuan Teradata

Tabel berikut ini menjelaskan properti kustom tujuan Teradata. Semua properti bersifat baca/tulis.

Nama properti Jenis Data Deskripsi
AlwaysDropErrorTable Boolean Defaultnya adalah False. Hilangkan semua tabel kesalahan jika True, meskipun tujuan Teradata gagal dibaca.
ArraySupport Boolean Defaultnya adalah True. Grup DML menggunakan ArraySupport jika True. Hanya berlaku untuk Aliran TPT. Properti ini berada dalam Editor Lanjutan.
Buffer Bilangan bulat Jumlah buffer permintaan yang akan ditingkatkan, nilai dapat diatur dari 2 ke 64. Hanya berlaku untuk Aliran TPT. Properti ini berada dalam Editor Lanjutan.
BufferMode Boolean Defaultnya adalah True. Harus Benar jika fitur PutBuffer digunakan. Properti ini berada dalam Editor Lanjutan.
BufferSize Bilangan bulat Ukuran buffer output (dalam KB) yang digunakan untuk mengirim parsel beban. Nilai defaultnya adalah 1024. Hanya berlaku untuk Beban TPT. Properti ini berada dalam Editor Lanjutan.
DataEncryption Boolean Defaultnya adalah False. Enkripsi keamanan penuh digunakan jika True.
DefaultCodePage Bilangan bulat Halaman kode yang akan digunakan ketika sumber data tidak memiliki informasi halaman kode.
Catatan: Properti ini berada dalam Editor Lanjutan.
DetailedTracingLevel Bilangan bulat (Enumerasi) Pilih salah satu opsi berikut untuk pelacakan tingkat lanjut:
Nonaktif: Tidak ada pengelogan lanjutan.
Umum: Pelacakan umum aktivitas khusus driver dicatat.
CLI: Pelacakan aktivitas terkait CLIv2 dicatat.
Metode Pemberitahuan: Memberi tahu pelacakan aktivitas terkait fitur dicatat.
Pustaka Umum: pelacakan aktivitas pustaka opcommon dicatat.
Semua: Semua pelacakan aktivitas di atas dicatat.
File log pelacakan tingkat lanjut ditentukan dalam properti DetailedTracingFile .
Properti DetailedTracingFile harus diatur jika opsi tidak Nonaktif.
Properti ini berada dalam Editor Lanjutan.
DetailedTracingFile String Jalur file log yang dihasilkan secara otomatis ketika DetailedTracingLevel tidak Nonaktif. Properti ini berada dalam Editor Lanjutan.
DiscardLargeRow Boolean Defaultnya adalah False. Buang baris besar (lebih besar dari 64K) jika Benar
ErrorTableName String Nama tabel kesalahan. Defaultnya adalah nama tabel target
ExtendedStringColumnsAllocation Boolean Faktor Alokasi Karakter Transfer Maksimal digunakan jika True.
Nilai ini harus diatur ke True jika properti ID Tabel Lebar Ekspor database Teradata diatur ke Default Maksimal.
Defaultnya adalah False.
FastLoad Boolean Pemuatan Cepat digunakan jika True. Nilai default-nya adalah salah. Ini juga dapat diatur di Editor Tujuan Teradata (Halaman Pengelola Sambungan).
MaxErrors Bilangan bulat Jumlah kesalahan yang dapat terjadi sebelum aliran data dihentikan. Nilai defaultnya adalah 0, yang berarti tidak ada batasan nomor kesalahan.
Jika Alur pengalihan dipilih di halaman Penanganan kesalahan . Sebelum batas nomor kesalahan tercapai, semua kesalahan dikembalikan dalam output kesalahan. Untuk informasi selengkapnya, lihat Editor Tujuan Teradata (Halaman Output Kesalahan).
MaxSessions Bilangan bulat Jumlah maksimum sesi yang masuk. Nilai ini harus lebih besar dari satu. Nilai default adalah satu sesi untuk setiap AMP yang tersedia.
MinSessions Bilangan bulat Jumlah minimum sesi yang masuk. Nilai ini harus lebih besar dari satu. Nilai default adalah satu sesi untuk setiap AMP yang tersedia.
Paket Bilangan bulat Jumlah pernyataan yang akan dikemas ke dalam permintaan multi-pernyataan. Defaultnya adalah 20, maksimum yang diizinkan adalah 2400. Hanya berlaku untuk Aliran TPT. Properti ini berada dalam Editor Lanjutan.
PackMaximum Boolean Tentukan faktor paket maksimum secara dinamis untuk pekerjaan Stream saat ini jika True. Hanya berlaku untuk Aliran TPT. Properti ini berada dalam Editor Lanjutan.
QueryBandSessInfo Varchar Ekspresi band kueri berbasis sesi yang ditentukan pengguna, untuk mengaktifkan pemantauan dan tata kelola penagihan balik. Properti ini harus dalam format string koneksi. Properti ini berada dalam Editor Lanjutan.
ReplikasiOveride Bilangan bulat (enumerasi) Opsi:
Default: Tidak ada pernyataan SET SESSION OVERRIDE REPLICATION yang dikirim ke database. Pengaturan default database digunakan.
Aktif: Kontrol layanan replikasi normal ditimpa.
Nonaktif: Kontrol layanan replikasi normal digunakan.
Properti ini hanya berlaku untuk Aliran TPT.
Properti ini berada dalam Editor Lanjutan.
Kuat Boolean Logika hidupkan ulang yang kuat digunakan untuk pemulihan dan operasi hidupkan ulang jika True. Properti ini hanya berlaku untuk Aliran TPT. Properti ini berada dalam Editor Lanjutan.
TableName String Nama tabel dengan data yang sedang digunakan.
TenacityHours Bilangan bulat Jumlah jam driver TPT mencoba masuk ketika jumlah maksimum operasi beban/ekspor sudah berjalan. Waktu default adalah 4 jam. Properti ini berada dalam Editor Lanjutan
TenacitySleep Bilangan bulat Menit driver TPT berhenti sejenak sebelum mencoba masuk ketika batas tercapai. Batas ditentukan oleh properti MaxSessions dan TenacityHours . Defaultnya adalah enam menit. Properti ini berada dalam Editor Lanjutan
UnicodePassThrough Boolean Nonaktif (default): Nonaktifkan Pass Through Unicode.
Aktif: Aktifkan Pass Through Unicode.

Mengonfigurasi tujuan Teradata

Tujuan Teradata dapat dikonfigurasi secara terprogram atau melalui SSIS Designer.

Editor Tujuan Teradata diperlihatkan dalam gambar di bawah ini. Ini berisi Halaman Pengelola Sambungan, Halaman Pemetaan, dan Halaman Output Kesalahan.

Untuk informasi selengkapnya, lihat salah satu topik berikut:

editor tujuan

Kotak dialog Editor Lanjutan berisi properti yang dapat diatur secara terprogram. Untuk membuka kotak dialog Editor Lanjutan:

  • Di layar Aliran Data proyek Layanan Integrasi Anda, klik kanan tujuan Teradata dan pilih Perlihatkan Editor Lanjutan.

Untuk informasi selengkapnya tentang properti yang bisa Anda atur dalam kotak dialog Editor Lanjutan, lihat Properti kustom tujuan Teradata.

Editor Tujuan Teradata (Halaman Pengelola Sambungan)

Gunakan halaman Pengelola Sambungan kotak dialog Editor Tujuan Teradata untuk memilih manajer koneksi Teradata untuk tujuan. Halaman ini juga memungkinkan Anda memilih tabel atau tampilan dari database.

Untuk membuka Halaman Pengelola Sambungan Editor Tujuan Teradata

  • Di SQL Server Data Tools, buka paket SQL Server Integration Services (SSIS) yang memiliki tujuan Teradata.

  • Pada tab Aliran Data, klik dua kali tujuan Teradata.

  • Di Editor Tujuan Teradata, klik Pengelola Sambungan.

Opsi

Manajer sambungan

Pilih manajer koneksi yang sudah ada dari daftar, atau klik Baru untuk membuat manajer koneksi Teradata baru.

Baru

Klik Baru. Kotak dialog Teradata Pengelola Sambungan Editor terbuka di mana Anda dapat membuat manajer koneksi baru.

Mode akses data

Pilih metode untuk memilih data dari sumber. Opsi diperlihatkan dalam tabel berikut ini:

Opsi Deskripsi
Nama Tabel - Aliran TPT Mode inkremental menggunakan operator TPT Stream.
Nama tabel atau vie: Pilih tabel atau tampilan yang sudah ada dari daftar. Daftar ini hanya memperlihatkan 1000 tabel pertama. Anda dapat mengetik awalan nama tabel atau menggunakan bagian mana pun dari nama dengan kartubebas (*) untuk mencantumkan tabel atau tabel yang ingin Anda gunakan.
Nama Tabel – Beban TPL Mode beban Cepat (Jalur Langsung) menggunakan operator Beban API TPT (protokol Teradata FastLoad), yang mengharuskan tabel target kosong.
Nama tabel atau tampilan: Pilih tabel atau tampilan yang sudah ada dari daftar. Daftar ini hanya memperlihatkan 1000 tabel pertama. Anda dapat mengetik awalan nama tabel atau menggunakan bagian mana pun dari nama dengan kartubebas (*) untuk mencantumkan tabel atau tabel yang ingin Anda gunakan.

Kotak centang Enkripsi data untuk mengaktifkan enkripsi data. Default tidak dipilih.

Selalu letakkan kotak centang tabel kesalahan untuk menghilangkan tabel kesalahan di semua instans.

Tabel Kesalahan Nama tabel tempat kesalahan ditulis.

Jumlah minimum sesi Jumlah minimum sesi yang masuk. Nilai default adalah satu sesi untuk setiap AMP yang tersedia. Nilai harus lebih besar dari satu.

Jumlah maksimum sesi Jumlah maksimum sesi yang masuk. Nilai default adalah satu sesi untuk setiap AMP yang tersedia. Nilai harus lebih besar dari satu.

Jumlah kesalahan maksimum Jumlah maksimum kesalahan yang dapat dikembalikan sebelum aliran data dihentikan atau dialihkan.

Editor Tujuan Teradata (Halaman Pemetaan)

Gunakan halaman Pemetaan kotak dialog Editor Tujuan Teradata untuk memetakan kolom input ke kolom tujuan.

Untuk membuka Halaman Pemetaan Editor Tujuan Teradata

  • Di SQL Server Data Tools, buka paket SQL Server Integration Services (SSIS) yang memiliki tujuan Teradata.

  • Pada tab Aliran Data, klik dua kali tujuan Teradata.

  • Di Editor Tujuan Teradata, klik Pemetaan.

Opsi

Kolom Input yang Tersedia

Daftar kolom input yang tersedia. Seret dan letakkan kolom input ke kolom tujuan yang tersedia untuk memetakan kolom.

Kolom Tujuan yang Tersedia

Daftar kolom tujuan yang tersedia. Seret dan letakkan kolom tujuan ke kolom input yang tersedia untuk memetakan kolom.

Kolom Input

Lihat kolom input yang Anda pilih. Anda dapat menghapus pemetaan dengan memilih < abaikan > untuk mengecualikan kolom dari output.

Kolom Tujuan

Lihat semua kolom tujuan yang tersedia, baik yang dipetakan maupun tidak dipetakan.

Catatan

Kolom tipe data yang tidak didukung akan dihapus dari pemetaan dengan peringatan.

Editor Tujuan Teradata (Halaman Output Kesalahan)

Gunakan halaman Output Kesalahan dari kotak dialog Editor Tujuan Teradata untuk memilih opsi penanganan kesalahan.

Untuk membuka Halaman Output Kesalahan Editor Tujuan Teradata

  • Di SQL Server Data Tools, buka paket SQL Server Integration Services (SSIS) yang memiliki tujuan Teradata.

  • Pada tab Aliran Data, klik dua kali tujuan Teradata.

  • Di Editor Tujuan Teradata, klik Output Kesalahan.

Opsi

Perilaku kesalahan

Pilih bagaimana tujuan Teradata harus menangani kesalahan dalam alur: abaikan kegagalan, alihkan baris, atau gagalkan komponen.

Topik Terkait: Penyerahan Kesalahan dalam Data

Pemotongan

Pilih bagaimana tujuan Teradata harus menangani pemotongan dalam alur: abaikan kegagalan, alihkan baris, atau gagalkan komponen.

Langkah berikutnya