

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Koneksi Teradata Vantage
<a name="aws-glue-programming-etl-connect-teradata-home"></a>

Anda dapat menggunakan AWS Glue for Spark untuk membaca dan menulis ke tabel yang ada di Teradata Vantage di AWS Glue 4.0 dan versi yang lebih baru. Anda dapat menentukan apa yang akan dibaca dari Teradata dengan query SQL. Anda dapat terhubung ke Teradata menggunakan kredensibilitas nama pengguna dan kata sandi yang disimpan AWS Secrets Manager melalui koneksi AWS Glue.

Untuk informasi lebih lanjut tentang Teradata, lihat dokumentasi Teradata [https://docs.teradata.com/](https://docs.teradata.com/)

## Mengkonfigurasi koneksi Teradata
<a name="aws-glue-programming-etl-connect-teradata-configure"></a>

Untuk terhubung ke Teradata dari AWS Glue, Anda harus membuat dan menyimpan kredenSIAL Teradata Anda secara AWS Secrets Manager rahasia, lalu mengaitkan rahasia itu dengan koneksi Glue Teradata AWS . Jika instance Teradata Anda berada di Amazon VPC, Anda juga perlu memberikan opsi jaringan ke koneksi Glue Teradata Anda AWS .

Untuk terhubung ke Teradata dari AWS Glue, Anda mungkin memerlukan beberapa prasyarat:
+ Jika Anda mengakses lingkungan Teradata 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 akan digunakan AWS Glue saat menjalankan pekerjaan. Selain itu, Anda perlu memastikan Amazon VPC dikonfigurasi untuk mengizinkan lalu lintas jaringan antara instance Teradata Anda dan lokasi ini. Pekerjaan Anda perlu membuat koneksi TCP dengan port klien Teradata Anda. Untuk informasi selengkapnya tentang port Teradata, lihat dokumentasi [ 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)

  Berdasarkan tata letak jaringan Anda, konektivitas VPC yang aman mungkin memerlukan perubahan pada Amazon VPC dan layanan jaringan lainnya. Untuk informasi selengkapnya tentang AWS konektivitas, lihat [AWS Opsi Konektivitas ](https://docs.teradata.com/r/Teradata-VantageCloud-Enterprise/Get-Started/Connecting-Your-Environment/AWS-Connectivity-Options) di dokumentasi Teradata.

**Untuk mengkonfigurasi a AWS Koneksi lem Teradata:**

1. Dalam konfigurasi Teradata Anda, identifikasi atau buat pengguna dan kata sandi AWS Glue akan terhubung dengan, {{teradataUser}} dan. {{teradataPassword}} Untuk informasi lebih lanjut, lihat Ikh [ tisar 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 kredenSIAL Teradata Anda. Untuk membuat rahasia di Secrets Manager, ikuti tutorial yang tersedia di [ Buat AWS Secrets Manager rahasia ](https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_secret.html) dalam AWS Secrets Manager dokumentasi. Setelah membuat rahasia, simpan nama Rahasia, {{secretName}} untuk langkah selanjutnya. 
   + Saat memilih ** Key/value pasangan**, buat pasangan untuk kunci `user` dengan nilai{{teradataUsername}}.
   + Saat memilih ** Key/value pasangan**, buat pasangan untuk kunci `password` dengan nilainya{{teradataPassword}}.

1. Di konsol AWS Glue, buat koneksi dengan mengikuti langkah-langkah di[Menambahkan AWS Glue koneksi](console-connections.md). Setelah membuat koneksi, simpan nama koneksi,{{connectionName}}, untuk langkah selanjutnya. 
   + Saat memilih jenis ** koneksi**, pilih Teradata.
   + Saat memberikan URL ** JDBC**, berikan URL untuk instance Anda. Anda juga dapat membuat hardcode parameter koneksi tertentu yang dipisahkan koma 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 ** Kredensi**, pilih **AWS Secrets Manager**, lalu setel **AWS Rahasia ** ke{{secretName}}.

1. Dalam situasi berikut, Anda mungkin memerlukan konfigurasi tambahan:
   + 

     Untuk instans Teradata yang dihosting AWS di Amazon VPC
     + Anda harus memberikan informasi koneksi Amazon VPC ke koneksi Glue yang menentukan AWS kredenSIAL keamanan Teradata Anda. Saat membuat atau memperbarui koneksi Anda, atur grup ** VPC**, ** Subnet, ** dan ** Keamanan ** di opsi ** Jaringan. **

Setelah membuat koneksi AWS Glue Teradata, Anda harus melakukan langkah-langkah berikut sebelum memanggil metode koneksi Anda.
+ Berikan peran IAM yang terkait dengan izin pekerjaan AWS Glue Anda untuk membaca{{secretName}}.
+ Dalam konfigurasi pekerjaan AWS Glue Anda, berikan {{connectionName}} sebagai koneksi jaringan ** tambahan**.

## Membaca dari Teradata
<a name="aws-glue-programming-etl-connect-teradata-read"></a>

**Prasyarat: **
+ Tabel Teradata yang ingin Anda baca. Anda akan membutuhkan nama tabel,{{tableName}}.
+ Koneksi AWS Glue Teradata dikonfigurasi untuk memberikan informasi autentikasi. Selesaikan langkah-langkah * Untuk mengonfigurasi koneksi ke Teradata * untuk mengonfigurasi informasi autentikasi Anda. Anda akan membutuhkan nama koneksi AWS Glue,{{connectionName}}. 

Contoh: 

```
teradata_read_table = glueContext.create_dynamic_frame.from_options(
    connection_type="teradata",
    connection_options={
        "connectionName": "{{connectionName}}",
        "dbtable": "{{tableName}}"
    }
)
```

Anda juga dapat memberikan kueri SELECT SQL, untuk memfilter hasil yang dikembalikan ke Anda DynamicFrame. Anda perlu mengkonfigurasi`query`.

Contoh:

```
teradata_read_query = glueContext.create_dynamic_frame.from_options(
    connection_type="teradata",
    connection_options={
        "connectionName": "{{connectionName}}",
        "query": "{{query}}"
    }
)
```

## Menulis ke tabel Teradata
<a name="aws-glue-programming-etl-connect-teradata-write"></a>

**Pras ** yarat: Tabel Teradata yang ingin Anda tulis,. {{tableName}} **Anda harus membuat tabel sebelum memanggil metode koneksi. **

Contoh:

```
teradata_write = glueContext.write_dynamic_frame.from_options(
    connection_type="teradata",
    connection_options={
        "connectionName": "{{connectionName}}", 
        "dbtable": "{{tableName}}"
    }
)
```

## Referensi opsi koneksi Teradata
<a name="aws-glue-programming-etl-connect-teradata-reference"></a>
+ `connectionName` — Diperlukan. Digunakan untuk Read/Write. Nama koneksi AWS Glue Teradata dikonfigurasi untuk memberikan informasi autentikasi dan jaringan ke metode koneksi Anda.
+ `dbtable`- Diperlukan untuk menulis, diperlukan untuk membaca kecuali `query` disediakan. Digunakan untuk Read/Write. Nama tabel yang akan berinteraksi dengan metode koneksi Anda.
+ `query`— Digunakan untuk membaca. Kueri SELECT SQL mendefinisikan apa yang harus diambil saat membaca dari Teradata.