Tujuan Teradata

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

Destinasi Teradata memuat data dalam jumlah besar ke dalam Teradata Database.

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 untuk 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 diperoleh melalui keluaran kesalahan standar komponen SSIS.

Tabel sementara dihilangkan setelah proses pemuatan selesai. Jika tabel temporal tidak dapat dibaca oleh tujuan Teradata, tabel tersebut tidak akan dihapus kecuali properti Always drop error table 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. Pengembalian ke versi sebelumnya tidak didukung.
  • Dalam mode operator TPT Steam, tujuan Teradata beroperasi menggunakan mekanisme buffer baris. Jika pekerjaan gagal, semua perubahan yang selesai (buffer dikirim) pada saat kegagalan bersifat permanen dalam tabel target. Tidak ada konsep rollback. Tabel kesalahan akan dihilangkan.

Tujuan Teradata memiliki keluaran 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 destinasi Teradata secara bersamaan pada tabel yang sama, meskipun hal ini dapat mengurangi kinerja pada masing-masing 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 menghasilkan trace ODBC dengan Administrator Sumber Data ODBC.

Properti kustom tujuan Teradata

Tabel berikut ini menjelaskan properti kustom tujuan Teradata. Semua properti dapat dibaca/ditulis.

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 TPT Stream. 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 TPT Stream. 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 keluaran (dalam KB) yang digunakan untuk mengirim paket muatan. Nilai defaultnya adalah 1024. Hanya berlaku untuk TPT Load. 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.
Tingkat Pelacakan Terperinci Bilangan bulat (Enumerasi) Pilih salah satu opsi berikut untuk pelacakan tingkat lanjut:
Nonaktif: Tidak ada pengelogan lanjutan.
Umum: Pelacakan umum untuk aktivitas spesifik driver dicatat.
CLI: Pelacakan aktivitas terkait CLIv2 dicatat.
Metode Notifikasi: Pelacakan aktivitas yang terkait dengan fitur notifikasi dicatat.
Common Library: pelacakan aktivitas pustaka opcommon dicatat dalam log.
Semua: Semua pelacakan aktivitas di atas dicatat.
File log pelacakan tingkat lanjut ditentukan dalam properti DetailedTracingFile .
properti DetailedTracingFile harus ditetapkan jika opsi bukan Nonaktif.
Properti ini berada dalam Editor Lanjutan.
File Pelacakan Terperinci String Jalur file log yang dihasilkan secara otomatis ketika DetailedTracingLevel tidak Nonaktif. Properti ini berada dalam Editor Lanjutan.
Buang Baris Besar Boolean Defaultnya adalah False. Buang baris besar (lebih besar dari 64K) jika Benar
ErrorTableName String Nama tabel galat. Nilai bawaan adalah nama tabel target
ExtendedStringColumnsAllocation Boolean Faktor Alokasi Transfer Karakter Maksimal digunakan jika True.
Nilai ini harus disetel ke True jika properti ID Tabel Lebar Ekspor dari database Teradata disetel ke Default Maksimal.
Defaultnya adalah False.
FastLoad Boolean Fast Loading 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. Nilai default adalah 20, dan nilai maksimum yang diizinkan adalah 2400. Hanya berlaku untuk TPT Stream. Properti ini berada dalam Editor Lanjutan.
PackMaximum Boolean Tentukan faktor paket maksimum secara dinamis untuk pekerjaan Stream saat ini jika True. Hanya berlaku untuk TPT Stream. Properti ini berada dalam Editor Lanjutan.
QueryBandSessInfo Varchar Ekspresi query band berbasis sesi yang ditentukan oleh pengguna, untuk mengaktifkan pemantauan dan tata kelola pembebanan balik. Properti ini harus dalam format string koneksi. Properti ini berada dalam Editor Lanjutan.
ReplicationOveride Bilangan bulat (enumerasi) Opsi:
Default: Tidak ada SET statement SESSION OVERRIDE REPLICATION yang dikirim ke database. Pengaturan bawaan database digunakan.
Aktif: Kontrol normal layanan replikasi dikesampingkan.
Nonaktif: Kontrol layanan replikasi normal digunakan.
Properti ini hanya berlaku untuk TPT Stream.
Properti ini berada dalam Editor Lanjutan.
Kuat Boolean Logika mulai ulang yang andal digunakan untuk operasi pemulihan dan mulai ulang jika True. Properti ini hanya berlaku untuk TPT Stream. Properti ini berada dalam Editor Lanjutan.
TableName String Nama tabel dengan data yang sedang digunakan.
TenacityHours Bilangan bulat Jumlah jam driver TPT mencoba log masuk ketika jumlah maksimum operasi muat/ekspor sudah berjalan. Waktu default adalah 4 jam. Properti ini berada dalam Editor Lanjutan
TenacitySleep Bilangan bulat Jumlah menit driver TPT menunggu sebelum mencoba log masuk saat 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 penerusan 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 Manajer Koneksi)

Gunakan halaman Manajer Koneksi pada kotak dialog Editor Tujuan Teradata untuk memilih manajer koneksi Teradata bagi tujuan tersebut. Halaman ini juga memungkinkan Anda memilih tabel atau tampilan dari database.

Untuk membuka halaman Manajer Koneksi Editor Tujuan Teradata

  • Di SQL Server Data Tools, buka paket Layanan Integrasi SQL Server (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 - TPT Stream Mode inkremental dengan 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 – TPL Load Mode pemuatan Cepat (Jalur Langsung) menggunakan operator Load API TPT (protokol Teradata FastLoad), yang mengharuskan tabel target dalam keadaan 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.

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

Selalu hapus tabel kesalahan Kotak centang untuk menghapus tabel kesalahan di semua instans.

Tabel kesalahan Nama tabel tempat kesalahan dicatat.

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 pada Editor Tujuan Teradata

  • Di SQL Server Data Tools, buka paket Layanan Integrasi SQL Server (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 Error)

Gunakan halaman Keluaran Kesalahan pada kotak dialog Editor Tujuan Teradata untuk memilih opsi penanganan kesalahan.

Untuk membuka halaman keluaran kesalahan Editor Tujuan Teradata

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

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

  • Di Editor Tujuan Teradata, klik Keluaran Kesalahan.

Opsi

Perilaku kesalahan

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

Topik Terkait: Penanganan Kesalahan pada Data

Pemotongan

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