Setelah mempertimbangkan dengan cermat, kami memutuskan untuk menghentikan Amazon Kinesis Data Analytics untuk aplikasi SQL:
1. Mulai **1 September 2025,** kami tidak akan memberikan perbaikan bug untuk Amazon Kinesis Data Analytics untuk aplikasi SQL karena kami akan memiliki dukungan terbatas untuk itu, mengingat penghentian yang akan datang.
2. Mulai **15 Oktober 2025,** Anda tidak akan dapat membuat Kinesis Data Analytics baru untuk aplikasi SQL.
3. Kami akan menghapus aplikasi Anda mulai **27 Januari 2026**. Anda tidak akan dapat memulai atau mengoperasikan Amazon Kinesis Data Analytics untuk aplikasi SQL. Support tidak akan lagi tersedia untuk Amazon Kinesis Data Analytics untuk SQL sejak saat itu. Untuk informasi selengkapnya, lihat [Amazon Kinesis Data Analytics untuk penghentian Aplikasi SQL](discontinuation.md).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Contoh: Menambahkan Data Referensi ke Aplikasi Kinesis Data Analytics
Dalam latihan ini, Anda menambahkan data referensi ke aplikasi Kinesis Data Analytics yang ada. Untuk informasi tentang data referensi, lihat topik berikut:
+ [Amazon Kinesis Data Analytics untuk Aplikasi SQL: Cara Kerjanya](how-it-works.md)
+ [Mengonfigurasi Input Aplikasi](how-it-works-input.md)
Dalam latihan ini, Anda menambahkan data referensi ke aplikasi yang Anda buat di latihan [Memulai](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/get-started-exercise.html) Kinesis Data Analytics. Data referensi memberi perusahaan nama untuk setiap simbol ticker; sebagai contoh:
```
Ticker, Company
AMZN,Amazon
ASD, SomeCompanyA
MMB, SomeCompanyB
WAS, SomeCompanyC
```
Pertama, selesaikan langkah-langkah di latihan [Memulai](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/get-started-exercise.html) untuk membuat aplikasi starter. Kemudian ikuti langkah ini untuk menyiapkan dan menambahkan data referensi ke aplikasi Anda:
1. **Siapkan datanya**
+ Simpan data referensi sebelumnya sebagai objek di Amazon Simple Storage Service (Amazon S3).
+ Buat IAM role yang dapat diambil oleh Kinesis Data Analytics untuk membaca objek Amazon S3 atas nama Anda.
1. **Tambahkan sumber data referensi ke aplikasi Anda.**
Kinesis Data Analytics membaca objek Amazon S3 dan membuat tabel referensi dalam aplikasi yang dapat Anda kueri dalam kode aplikasi Anda.
1. **Uji kodenya.**
Dalam kode aplikasi Anda, Anda menulis kueri bergabung untuk menggabungkan aliran dalam aplikasi dengan tabel referensi dalam aplikasi, untuk mendapatkan nama perusahaan untuk setiap simbol ticker.
**Topics**
+ [Langkah 1: Siapkan](#add-refdata-prepare)
+ [Langkah 2: Tambahkan Sumber Data Referensi ke Konfigurasi Aplikasi](#add-refdata-create-iamrole)
+ [Langkah 3: Uji: Kuerikan Tabel Referensi dalam Aplikasi](#add-refdata-test)
## Langkah 1: Siapkan
Di bagian ini, Anda menyimpan data referensi sampel sebagai objek di bucket Amazon S3. Anda juga membuat IAM role yang dapat diambil oleh Kinesis Data Analytics untuk membaca objek atas nama Anda.
### Simpan Data Referensi sebagai Objek Amazon S3
Di langkah ini, Anda menyimpan data referensi sampel sebagai objek Amazon S3.
1. Buka editor teks, tambahkan data berikut, dan simpan file sebagai `TickerReference.csv`.
```
Ticker, Company
AMZN,Amazon
ASD, SomeCompanyA
MMB, SomeCompanyB
WAS, SomeCompanyC
```
1. Unggah file `TickerReference.csv` ke bucket S3 Anda. Untuk petunjuk, lihat [Mengunggah Objek ke Amazon](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UploadingObjectsintoAmazonS3.html) S3 di Panduan Pengguna *Layanan Penyimpanan Sederhana Amazon*.
### Buat IAM Role
Selanjutnya, buat IAM role yang dapat diambil oleh Kinesis Data Analytics dan membaca objek Amazon S3 atas nama Anda.
1. Dalam AWS Identity and Access Management (IAM), buat peran IAM bernama. **KinesisAnalytics-ReadS3Object** Untuk membuat peran, ikuti petunjuk di [Membuat Peran untuk Layanan Amazon (Konsol Manajemen AWS)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html#roles-creatingrole-service-console) dalam *Panduan Pengguna IAM*.
Di konsol IAM, tentukan hal berikut:
+ Untuk **Select Role Type** (Pilih Tipe Peran), pilih **AWS Lambda**. Setelah membuat peran, Anda akan mengubah kebijakan kepercayaan untuk memungkinkan Kinesis Data Analytics ( AWS Lambda bukan) untuk mengambil peran.
+ Jangan lampirkan kebijakan apa pun di halaman **Lampirkan Kebijakan**.
1. Perbarui kebijakan IAM role:
1. Di konsol IAM, pilih peran yang Anda buat.
1. Di tab **Trust Relationships** (Hubungan Kepercayaan), perbarui kebijakan kepercayaan untuk memberi Kinesis Data Analytics izin mengambil peran. Kebijakan kepercayaan ditampilkan sebagai berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "kinesisanalytics.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
1. **Pada tab **Izin**, lampirkan kebijakan yang dikelola Amazon yang disebut AmazonS3. ReadOnlyAccess** Kebijakan ini peran izin untuk membaca objek Amazon S3. Kebijakan ini ditampilkan sebagai berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:Get*",
"s3:List*"
],
"Resource": "*"
}
]
}
```
------
## Langkah 2: Tambahkan Sumber Data Referensi ke Konfigurasi Aplikasi
Di langkah ini, Anda akan menambahkan sumber data referensi ke konfigurasi aplikasi Anda. Untuk memulai, Anda memerlukan informasi berikut:
+ Nama bucket S3 dan nama kunci objek Anda
+ Amazon Resource Name (ARN) IAM role
1. Di halaman utama aplikasi, pilih **Connect reference data** (Sambungkan data referensi).
1. Di halaman **Sambungkan sumber data referensi**, pilih bucket Amazon S3 yang berisi objek data referensi Anda, dan masukkan nama kunci objek.
1. Masukkan **CompanyName** untuk **Nama tabel referensi dalam aplikasi**.
1. Di bagian **Akses ke sumber daya yang dipilih**, pilih **Pilih dari peran IAM yang dapat diasumsikan oleh Kinesis Analytics**, dan pilih peran IAM -reads3Object yang Anda buat **KinesisAnalyticsdi** bagian sebelumnya.
1. Pilih **Discover schema** (Temukan skema). Konsol mendeteksi dua kolom dalam data referensi.
1. Pilih **Save and close** (Simpan dan pilih).
## Langkah 3: Uji: Kuerikan Tabel Referensi dalam Aplikasi
Anda sekarang dapat mengkueri tabel referensi dalam aplikasi, `CompanyName`. Anda dapat menggunakan informasi referensi untuk memperkaya aplikasi Anda dengan menggabungkan data harga ticker dengan tabel referensi. Hasilnya menunjukkan nama perusahaan.
1. Ganti kode aplikasi Anda dengan hal berikut. Kueri menggabungkan aliran input dalam aplikasi dengan tabel referensi dalam aplikasi. Kode aplikasi menulis hasil ke aliran dalam aplikasi lainnya, `DESTINATION_SQL_STREAM`.
```
CREATE OR REPLACE STREAM "DESTINATION_SQL_STREAM" (ticker_symbol VARCHAR(4), "Company" varchar(20), sector VARCHAR(12), change DOUBLE, price DOUBLE);
CREATE OR REPLACE PUMP "STREAM_PUMP" AS INSERT INTO "DESTINATION_SQL_STREAM"
SELECT STREAM ticker_symbol, "c"."Company", sector, change, price
FROM "SOURCE_SQL_STREAM_001" LEFT JOIN "CompanyName" as "c"
ON "SOURCE_SQL_STREAM_001".ticker_symbol = "c"."Ticker";
```
1. Verifikasi bahwa output aplikasi muncul di **SQLResults**tab. Pastikan beberapa baris menunjukkan nama perusahaan (data referensi sampel Anda tidak memiliki semua nama perusahaan).