Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Koneksi Teradata Vantage NOS
Koneksi Teradata NOS (Native Object Store) adalah koneksi baru untuk Teradata Vantage yang memanfaatkan kueri Teradata WRITE\_NOS untuk dibaca dari tabel yang ada dan kueri READ\_NOS untuk ditulis ke tabel. Kueri ini menggunakan Amazon S3 sebagai direktori pementasan, dan oleh karena itu konektor Teradata NOS lebih cepat daripada konektor Teradata JDBC-based () yang ada terutama dalam menangani sejumlah besar data.
Anda dapat menggunakan koneksi Teradata NOS AWS Glue untuk Spark untuk membaca dan menulis ke tabel yang ada di Teradata Vantage di 5.0 dan versi yang lebih baru. AWS Glue Anda dapat menentukan apa yang harus dibaca dari Teradata dengan query SQL. Anda dapat terhubung ke Teradata menggunakan kredenal nama pengguna dan kata sandi yang disimpan melalui koneksi. AWS Secrets Manager AWS Glue
Untuk informasi lebih lanjut tentang Teradata, lihat dokumentasi [Teradata](https://docs.teradata.com/).
**Topics**
+ [Membuat koneksi NOS Teradata](#creating-teradata-nos-connection)
+ [Membaca dari tabel Teradata](#reading-from-teradata-nos-tables)
+ [Menulis ke tabel Teradata](#writing-to-teradata-nos-tables)
+ [Referensi opsi koneksi Teradata](#teradata-nos-connection-option-reference)
+ [Menyediakan Pilihan di AWS Glue Visual ETL UI](#teradata-nos-connection-option-visual-etl-ui)
## Membuat koneksi NOS Teradata
Untuk terhubung ke Teradata NOS dari AWS Glue, Anda harus membuat dan menyimpan kredenal Teradata Anda secara AWS Secrets Manager rahasia, lalu mengaitkan rahasia itu dengan koneksi Teradata NOS. AWS Glue Jika instans Teradata Anda ada di VPC Amazon, Anda juga perlu memberikan opsi jaringan ke koneksi Teradata NOS Anda AWS Glue .
**Prasyarat**:
+ Jika Anda mengakses lingkungan Teradata Anda melalui Amazon VPC, konfigurasikan Amazon VPC untuk memungkinkan pekerjaan AWS Glue Anda berkomunikasi dengan lingkungan Teradata. Kami tidak menyarankan mengakses lingkungan Teradata melalui internet publik.
+ Di Amazon VPC, identifikasi atau buat grup VPC, Subnet, dan Keamanan yang AWS Glue akan digunakan saat menjalankan pekerjaan. Selain itu, Anda perlu memastikan Amazon VPC dikonfigurasi untuk mengizinkan lalu lintas jaringan antara instans Teradata Anda dan lokasi ini. Pekerjaan Anda perlu membuat koneksi TCP dengan port klien Teradata Anda. Untuk informasi selengkapnya tentang port Teradata, lihat [Grup Keamanan untuk Teradata](https://docs.teradata.com/r/Teradata-VantageTM-on-AWS-DIY-Installation-and-Administration-Guide/April-2020/Before-Deploying-Vantage-on-AWS-DIY/Security-Groups-and-Ports) Vantage.
+ Berdasarkan tata letak jaringan Anda, konektivitas VPC yang aman mungkin memerlukan perubahan di Amazon VPC dan layanan jaringan lainnya. Untuk informasi selengkapnya tentang AWS konektivitas, lihat [Opsi AWS Konektivitas](https://docs.teradata.com/r/Teradata-VantageCloud-Enterprise/Get-Started/Connecting-Your-Environment/AWS-Connectivity-Options) di dokumentasi Teradata.
### Untuk mengkonfigurasi AWS Glue Koneksi Teradata NOS:
1. Dalam konfigurasi Teradata Anda, identifikasi atau buat {{teradataUsername}} dan {{teradataPassword}} AWS Glue akan terhubung dengannya. Untuk informasi selengkapnya, lihat [Ikhtisar Keamanan Vantage](https://docs.teradata.com/r/Configuring-Teradata-VantageTM-After-Installation/January-2021/Security-Overview/Vantage-Security-Overview) di dokumentasi Teradata.
1. Di AWS Secrets Manager, buat rahasia menggunakan kredenal Teradata Anda. Untuk membuat rahasia AWS Secrets Manager, ikuti tutorial yang tersedia di [Buat AWS Secrets Manager rahasia dalam AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_secret.html) dokumentasi. Setelah membuat rahasia, simpan nama Rahasia, {{secretName}} untuk langkah selanjutnya.
+ Saat memilih Key/value pasangan, buat pasangan untuk USERNAME kunci dengan nilainya{{teradataUsername}}.
+ Saat memilih Key/value pasangan, buat pasangan untuk kata sandi kunci dengan nilainya{{teradataPassword}}.
1. Di AWS Glue konsol, buat koneksi dengan mengikuti langkah-langkah di [Menambahkan AWS Glue koneksi](https://docs.aws.amazon.com/glue/latest/dg/console-connections.html). Setelah membuat koneksi, pertahankan nama koneksi,{{connectionName}}, untuk langkah selanjutnya.
+ Saat memilih **jenis Koneksi**, pilih Teradata Vantage NOS.
+ Saat memberikan URL JDBC, berikan URL untuk instance Anda. Anda juga dapat membuat hardcode parameter koneksi yang dipisahkan koma tertentu di URL JDBC Anda. URL harus sesuai dengan format berikut:` jdbc:teradata://teradataHostname/ParameterName=ParameterValue,ParameterName=ParameterValue `.
+ Parameter URL yang didukung meliputi:
+ `DATABASE`— nama database pada host untuk mengakses secara default.
+ `DBS_PORT`— port database, digunakan saat berjalan pada port yang tidak standar.
+ Saat memilih **jenis Credential**, pilih AWS Secrets Manager, lalu atur ** AWS Secret** ke{{secretName}}.
1. Dalam situasi berikut, Anda mungkin memerlukan konfigurasi tambahan:
+ Untuk instans Teradata AWS yang di-host di VPC Amazon, Anda harus memberikan informasi koneksi VPC Amazon ke koneksi yang menentukan kredenal keamanan Teradata Anda. AWS Glue **Saat membuat atau memperbarui koneksi Anda, atur **grup **VPC**, **Subnet**, dan Keamanan** dalam opsi Jaringan.**
Setelah membuat koneksi AWS Glue Teradata Vantage NOS, Anda perlu melakukan langkah-langkah berikut sebelum memanggil metode koneksi Anda.
1. Berikan peran IAM yang terkait dengan izin AWS Glue pekerjaan Anda untuk membaca{{secretName}}.
1. Dalam konfigurasi AWS Glue pekerjaan Anda, berikan {{connectionName}} sebagai **koneksi jaringan tambahan** di bawah **koneksi**.
## Membaca dari tabel Teradata
### Prasyarat:
+ Tabel Teradata yang ingin Anda baca. Anda akan membutuhkan nama tabel,{{tableName}}.
+ Lingkungan Teradata memiliki akses tulis ke jalur Amazon S3 yang ditentukan `staging_fs_url` oleh opsi,. {{stagingFsUrl}}
+ Peran IAM yang terkait dengan AWS Glue pekerjaan memiliki akses tulis ke lokasi Amazon S3 yang ditentukan `staging_fs_url` oleh opsi.
+ Koneksi NOS AWS Glue Teradata yang dikonfigurasi untuk memberikan informasi autentikasi. Selesaikan langkah-langkah [Untuk mengkonfigurasi AWS Glue Koneksi Teradata NOS:](#creating-teradata-nos-connection-procedure) untuk mengonfigurasi informasi autentikasi Anda. Anda akan membutuhkan nama AWS Glue koneksi,{{connectionName}}.
Contoh:
```
teradata_read_table = glueContext.create_dynamic_frame.from_options(
connection_type= {{"teradatanos"}},
connection_options={
"connectionName": {{"connectionName"}},
"dbtable": {{"tableName"}},
"staging_fs_url": {{"stagingFsUrl"}}
}
)
```
Anda juga dapat memberikan kueri SELECT SQL, untuk memfilter hasil yang dikembalikan ke Anda DynamicFrame. Anda perlu mengkonfigurasi kueri. Jika Anda mengonfigurasi DbTable dan kueri, konektor gagal membaca data. Contoh:
```
teradata_read_query = glueContext.create_dynamic_frame.from_options(
connection_type={{"teradatanos"}},
connection_options={
"connectionName": {{"connectionName"}},
"query": {{"query"}},
"staging_fs_url": {{"stagingFsUrl"}}
}
)
```
Selain itu, Anda dapat menggunakan Spark DataFrame API untuk membaca dari tabel Teradata. Contoh:
```
options = {
"url": {{"JDBC_URL"}},
"dbtable": {{"tableName"}},
"user": {{"teradataUsername"}}, # or use "username" as key here
"password": {{"teradataPassword"}},
"staging_fs_url": {{"stagingFsUrl}}"
}
teradata_read_table = spark.read.format("teradatanos").option(**options).load()
```
## Menulis ke tabel Teradata
### Prasyarat
+ Tabel Teradata yang ingin Anda tulis:. {{tableName}}
+ Lingkungan Teradata memiliki akses baca ke lokasi Amazon S3 yang ditentukan `staging_fs_url` oleh opsi,. {{ stagingFsUrl }}
+ Peran IAM yang terkait dengan AWS Glue pekerjaan memiliki akses tulis ke lokasi Amazon S3 yang ditentukan `staging_fs_url` oleh opsi.
+ Koneksi AWS Glue Teradata yang dikonfigurasi untuk memberikan informasi autentikasi. Selesaikan langkah-langkah [Untuk mengkonfigurasi AWS Glue Koneksi Teradata NOS:](#creating-teradata-nos-connection-procedure) untuk mengonfigurasi informasi autentikasi Anda. Anda akan membutuhkan nama AWS Glue koneksi,{{connectionName}}.
Contoh:
```
teradata_write = glueContext.write_dynamic_frame.from_options(
frame=dynamicFrame,
connection_type= {{"teradatanos"}},
connection_options={
"connectionName": {{"connectionName"}},
"dbtable": {{"tableName"}},
"staging_fs_url": {{"stagingFsUrl"}}
}
)
```
## Referensi opsi koneksi Teradata
**Opsi Koneksi dan Operasi:**
+ `connectionName` — Diperlukan. Digunakan untuk Read/Write. Nama koneksi AWS Glue Teradata yang dikonfigurasi untuk memberikan informasi autentikasi dan jaringan ke metode koneksi Anda.
+ `staging_fs_url` — Diperlukan. Digunakan untuk Read/Write. Lokasi yang dapat ditulis di Amazon S3, yang akan digunakan untuk data yang dibongkar saat membaca dari Teradata, dan untuk data Parket yang akan dimuat ke Redshift saat menulis ke Teradata. Bucket S3 harus berada di wilayah yang sama dengan wilayah AWS Glue pekerjaan Anda.
+ `dbtable`— Diperlukan untuk menulis, diperlukan untuk membaca kecuali `query` disediakan. Digunakan untuk Read/Write. Nama tabel metode koneksi Anda akan berinteraksi dengan.
+ `query`— Digunakan untuk Baca. Kueri SELECT SQL yang mendefinisikan apa yang harus diambil saat membaca dari Teradata. Anda tidak dapat lulus jika `dbtable` opsi disediakan.
+ `clean_staging_s3_dir`- Opsional. Digunakan untuk Read/Write. Jika benar, bersihkan pementasan objek Amazon S3 setelah membaca atau menulis. Nilai default-nya adalah betul.
+ `pre_actions`- Opsional. Digunakan untuk menulis. Semicolon-separated daftar perintah SQL yang dijalankan sebelum data ditransfer antara Spark dan Teradata Vantage.
+ `post_actions`- Opsional. Digunakan untuk menulis. Semicolon-separated daftar perintah SQL yang dijalankan setelah data ditransfer antara Spark dan Teradata Vantage.
+ `truncate`- Opsional. Digunakan untuk menulis. Jika benar, konektor memotong tabel saat menulis dalam mode overwrite. Jika salah, konektor menjatuhkan tabel saat menulis dalam mode overwrite. Nilai default adalah false.
+ `create_table_script`- Opsional. Digunakan untuk menulis. Pernyataan SQL untuk membuat tabel saat menulis ke Teradata Vantage. Berguna bila Anda ingin membuat tabel dengan metadata kustom (misalnya CREATE MULTISET atau SET table atau ubah indeks primer). Perhatikan bahwa nama tabel yang digunakan dalam membuat skrip tabel harus sesuai dengan nama tabel yang ditentukan dalam `dbtable` opsi.
+ `partition_size_in_mb`- Opsional. Digunakan untuk Baca. Ukuran maksimum partisi Spark dalam megabyte saat membaca pementasan objek Amazon S3. Nilai default-nya adalah 128.
Anda dapat memberikan opsi lanjutan saat membuat simpul Teradata. Opsi ini sama dengan yang tersedia saat pemrograman AWS Glue untuk skrip Spark.
Lihat [Koneksi Teradata Vantage](aws-glue-programming-etl-connect-teradata-home.md).
**Opsi Otorisasi:**
Di bawah ini adalah opsi yang digunakan untuk memberikan kredenal AWS akun yang digunakan konektor untuk mengakses bucket Amazon S3 pementasan. Anda dapat memilih untuk (1) tidak memberikan opsi otorisasi sama sekali, dan menggunakan kredensil sementara yang dihasilkan dari peran AWS Glue eksekusi Anda; atau (2) menyediakan objek otorisasi, yang `auth_object` Anda buat; atau (3) menyediakan `aws_access_key_id and aws_secret_access_key` jika menggunakan kredensil jangka panjang, atau menyediakan,, dan jika menggunakan kredensil `aws_access_key` sementara. `aws_secret_access_key` `aws_session_token`
+ `auth_object` – Opsional. Digunakan untuk mengakses bucket Amazon S3 pementasan. Sebuah string objek otorisasi dibuat dalam contoh Teradata. Jika disediakan, konektor akan menggunakan objek otorisasi ini untuk mengakses bucket Amazon S3 pementasan. Jika tidak disediakan, dan `aws_access_key_id` dan `aws_secret_access_key` juga tidak disediakan, kredensi sementara akan diambil dari peran AWS Glue eksekusi dan digunakan oleh konektor. AWS Akun yang terkait dengan objek otorisasi ini harus berada di wilayah yang sama dengan AWS Glue pekerjaan Anda dan bucket Amazon S3 pementasan Anda atau dikonfigurasi dengan kepercayaan lintas akun.
+ `aws_access_key_id` – Opsional. Digunakan untuk mengakses bucket Amazon S3 pementasan. Bagian dari kredensi keamanan AWS akun. Jika tidak `auth_object` disediakan, dan `aws_access_key_id` dilengkapi`aws_secret_access_key`, konektor akan menggunakannya untuk mengakses bucket Amazon S3 pementasan. AWS Akun yang terkait dengan kunci akses ini harus berada di wilayah yang sama dengan AWS Glue pekerjaan Anda dan bucket Amazon S3 pementasan Anda atau dikonfigurasi dengan kepercayaan lintas akun.
+ `aws_secret_access_key` – Opsional. Digunakan untuk mengakses bucket Amazon S3 pementasan. Bagian dari kredensi keamanan AWS akun. Jika tidak `auth_object` disediakan, dan `aws_secret_access_key` dilengkapi`aws_access_key_id`, konektor akan menggunakannya untuk mengakses bucket Amazon S3 pementasan. AWS Akun yang terkait dengan kunci rahasia ini harus berada di wilayah yang sama dengan AWS Glue pekerjaan Anda dan bucket Amazon S3 pementasan Anda atau dikonfigurasi dengan kepercayaan lintas akun.
+ `aws_session_token` – Opsional. Digunakan untuk mengakses bucket Amazon S3 pementasan. Bagian dari kredensi keamanan AWS akun sementara. Harus disediakan dengan `aws_access_key_id` dan`aws_secret_access_key`.
## Menyediakan Pilihan di AWS Glue Visual ETL UI
Anda dapat memberikan semua opsi di atas di UI pekerjaan ETL visual Anda. Untuk opsi connectionName, Anda harus memilihnya dari daftar drop-down koneksi Teradata Vantage NOS. Untuk semua opsi lain, Anda harus menyediakannya melalui properti Custom Teradata Vantage NOS sebagai pasangan nilai kunci.
