

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.

# CreateApplication
<a name="API_CreateApplication"></a>

**catatan**  
Dokumentasi ini ditujukan untuk API Amazon Kinesis Data Analytics versi 1, yang hanya mendukung aplikasi SQL. API versi 2 mendukung aplikasi SQL dan Java. Untuk informasi selengkapnya tentang versi 2, lihat [Dokumentasi V2 API Amazon Kinesis Data Analytics](/kinesisanalytics/latest/apiv2/Welcome.html).

 Membuat aplikasi Amazon Kinesis Analytics. Anda dapat mengonfigurasi setiap aplikasi dengan satu sumber streaming sebagai input, kode aplikasi untuk memproses input, dan hingga tiga tujuan tempat Anda ingin Amazon Kinesis Analytics menulis data output dari aplikasi Anda. Untuk gambaran umum, lihat [Cara Kerjanya](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works.html). 

Dalam konfigurasi input, Anda memetakan sumber streaming ke aliran dalam aplikasi, yang dapat Anda anggap sebagai tabel yang terus diperbarui. Dalam pemetaan, Anda harus menyediakan skema untuk aliran dalam aplikasi dan memetakan setiap kolom data di aliran dalam aplikasi untuk elemen data dalam sumber streaming.

Kode aplikasi Anda adalah satu atau beberapa pernyataan SQL yang membaca data input, mengubahnya, dan menghasilkan output. Kode aplikasi Anda dapat membuat satu atau beberapa artefak SQL seperti aliran atau pompa SQL.

Dalam konfigurasi output, Anda dapat mengonfigurasi aplikasi untuk menulis data dari aliran dalam aplikasi yang dibuat dalam aplikasi Anda hingga tiga tujuan.

 Untuk membaca data dari aliran sumber Anda atau menulis data ke aliran tujuan, Amazon Kinesis Analytics memerlukan izin Anda. Anda memberikan izin ini dengan membuat IAM role. Operasi ini memerlukan izin untuk menjalankan tindakan `kinesisanalytics:CreateApplication`. 

 Untuk latihan pendahuluan untuk membuat aplikasi Amazon Kinesis Analytics, lihat [Memulai](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/getting-started.html). 

## Sintaksis Permintaan
<a name="API_CreateApplication_RequestSyntax"></a>

```
{
   "ApplicationCode": "string",
   "ApplicationDescription": "string",
   "ApplicationName": "string",
   "CloudWatchLoggingOptions": [ 
      { 
         "LogStreamARN": "string",
         "RoleARN": "string"
      }
   ],
   "Inputs": [ 
      { 
         "InputParallelism": { 
            "Count": number
         },
         "InputProcessingConfiguration": { 
            "InputLambdaProcessor": { 
               "ResourceARN": "string",
               "RoleARN": "string"
            }
         },
         "InputSchema": { 
            "RecordColumns": [ 
               { 
                  "Mapping": "string",
                  "Name": "string",
                  "SqlType": "string"
               }
            ],
            "RecordEncoding": "string",
            "RecordFormat": { 
               "MappingParameters": { 
                  "CSVMappingParameters": { 
                     "RecordColumnDelimiter": "string",
                     "RecordRowDelimiter": "string"
                  },
                  "JSONMappingParameters": { 
                     "RecordRowPath": "string"
                  }
               },
               "RecordFormatType": "string"
            }
         },
         "KinesisFirehoseInput": { 
            "ResourceARN": "string",
            "RoleARN": "string"
         },
         "KinesisStreamsInput": { 
            "ResourceARN": "string",
            "RoleARN": "string"
         },
         "NamePrefix": "string"
      }
   ],
   "Outputs": [ 
      { 
         "DestinationSchema": { 
            "RecordFormatType": "string"
         },
         "KinesisFirehoseOutput": { 
            "ResourceARN": "string",
            "RoleARN": "string"
         },
         "KinesisStreamsOutput": { 
            "ResourceARN": "string",
            "RoleARN": "string"
         },
         "LambdaOutput": { 
            "ResourceARN": "string",
            "RoleARN": "string"
         },
         "Name": "string"
      }
   ],
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Parameter Permintaan
<a name="API_CreateApplication_RequestParameters"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [ApplicationCode](#API_CreateApplication_RequestSyntax) **   <a name="analytics-CreateApplication-request-ApplicationCode"></a>
Satu atau beberapa pernyataan SQL yang membaca data input, mengubahnya, dan menghasilkan output. Misalnya, Anda dapat menulis pernyataan SQL yang membaca data dari satu pengaliran dalam aplikasi, menghasilkan rata-rata jumlah klik iklan oleh vendor yang berjalan, dan menyisipkan baris yang dihasilkan di pengaliran dalam aplikasi lainnya menggunakan pompa. Untuk informasi lebih lanjut tentang pola umum, lihat [Kode Aplikasi](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-app-code.html).   
Anda dapat menyediakan serangkaian pernyataan SQL tersebut, di mana output dari satu pernyataan dapat digunakan sebagai input untuk pernyataan berikutnya. Anda menyimpan hasil antara dengan membuat pengaliran dalam aplikasi dan pompa.  
Perhatikan bahwa kode aplikasi harus membuat pengaliran dengan nama yang ditentukan di `Outputs`. Misalnya, jika `Outputs` menentukan aliran output bernama `ExampleOutputStream1` dan `ExampleOutputStream2`, kode aplikasi Anda harus membuat aliran ini.   
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 102400.  
Wajib: Tidak

 ** [ApplicationDescription](#API_CreateApplication_RequestSyntax) **   <a name="analytics-CreateApplication-request-ApplicationDescription"></a>
Deskripsi ringkasan dari aplikasi.  
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 1024.  
Wajib: Tidak

 ** [ApplicationName](#API_CreateApplication_RequestSyntax) **   <a name="analytics-CreateApplication-request-ApplicationName"></a>
Nama dari aplikasi Amazon Kinesis Analytics Anda (misalnya, `sample-app`).  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.  
Pola: `[a-zA-Z0-9_.-]+`   
Wajib: Ya

 ** [CloudWatchLoggingOptions](#API_CreateApplication_RequestSyntax) **   <a name="analytics-CreateApplication-request-CloudWatchLoggingOptions"></a>
Gunakan parameter ini untuk mengonfigurasi aliran CloudWatch log untuk memantau kesalahan konfigurasi aplikasi. Untuk informasi selengkapnya, lihat [Bekerja dengan CloudWatch Log Amazon](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/cloudwatch-logs.html).  
Tipe: Array objek [CloudWatchLoggingOption](API_CloudWatchLoggingOption.md)  
Wajib: Tidak

 ** [Inputs](#API_CreateApplication_RequestSyntax) **   <a name="analytics-CreateApplication-request-Inputs"></a>
Gunakan parameter ini untuk mengonfigurasi input aplikasi.  
Anda dapat mengonfigurasi aplikasi Anda untuk menerima input dari sumber streaming tunggal. Dalam konfigurasi ini, Anda memetakan sumber streaming ini ke pengaliran dalam aplikasi yang dibuat. Kode aplikasi Anda kemudian dapat mengkueri pengaliran dalam aplikasi seperti tabel (Anda dapat menganggapnya sebagai tabel yang terus memperbarui).  
Untuk sumber streaming, Anda menyediakan Amazon Resource Name (ARN) dan format data pada pengaliran (misalnya, JSON, CSV, dll.). Anda juga harus menyediakan IAM role yang dapat diasumsikan Amazon Kinesis Analytics untuk membaca pengaliran ini atas nama Anda.  
Untuk membuat pengaliran dalam aplikasi, Anda perlu menentukan skema untuk mengubah data Anda menjadi versi skematis yang digunakan di SQL. Dalam skema tersebut, Anda menyediakan pemetaan dari elemen data yang diperlukan dalam sumber streaming untuk mencatat kolom di aliran dalam aplikasi.  
Tipe: Array objek [Input](API_Input.md)  
Wajib: Tidak

 ** [Outputs](#API_CreateApplication_RequestSyntax) **   <a name="analytics-CreateApplication-request-Outputs"></a>
Anda dapat mengonfigurasi output aplikasi untuk menulis data dari salah satu aliran dalam aplikasi hingga tiga tujuan.  
Tujuan ini bisa berupa Amazon Kinesis streams, aliran pengiriman Amazon Kinesis Firehose, tujuan Lambda AWS , atau kombinasi ketiganya.  
Dalam konfigurasi, Anda menentukan nama aliran dalam aplikasi, aliran tujuan, atau fungsi Lambda Amazon Resource Name (ARN), dan format yang akan digunakan saat menulis data. Anda juga harus menyediakan IAM role yang dapat diambil Amazon Kinesis Analytics untuk menulis ke aliran tujuan atau fungsi Lambda atas nama Anda.  
Dalam konfigurasi output, Anda juga menyediakan aliran output atau fungsi Lambda ARN. Untuk tujuan aliran, Anda menyediakan format data dalam aliran (misalnya, JSON, CSV). Anda juga harus menyediakan IAM role yang dapat diambil Amazon Kinesis Analytics untuk menulis ke aliran atau fungsi Lambda atas nama Anda.  
Tipe: Array objek [Output](API_Output.md)  
Wajib: Tidak

 ** [Tags](#API_CreateApplication_RequestSyntax) **   <a name="analytics-CreateApplication-request-Tags"></a>
Daftar satu atau beberapa tanda yang ditetapkan ke aplikasi. Tanda adalah pasangan nilai kunci yang mengidentifikasi aplikasi. Perhatikan bahwa jumlah maksimum tanda aplikasi mencakup tanda sistem. Jumlah maksimum tanda aplikasi yang ditentukan pengguna adalah 50. Untuk informasi selengkapnya, lihat [Menggunakan Penandaan](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-tagging.html).  
Tipe: Array objek [Tag](API_Tag.md)  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 200 item.  
Wajib: Tidak

## Sintaksis Respons
<a name="API_CreateApplication_ResponseSyntax"></a>

```
{
   "ApplicationSummary": { 
      "ApplicationARN": "string",
      "ApplicationName": "string",
      "ApplicationStatus": "string"
   }
}
```

## Elemen Respons
<a name="API_CreateApplication_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [ApplicationSummary](#API_CreateApplication_ResponseSyntax) **   <a name="analytics-CreateApplication-response-ApplicationSummary"></a>
Untuk merespons permintaan `CreateApplication` Anda, Amazon Kinesis Analytics mengembalikan respons dengan ringkasan aplikasi yang dibuatnya, termasuk aplikasi Amazon Resource Name (ARN), nama, dan status.  
Tipe: Objek [ApplicationSummary](API_ApplicationSummary.md)

## Kesalahan
<a name="API_CreateApplication_Errors"></a>

 ** CodeValidationException **   
Kode aplikasi yang disediakan pengguna (kueri) tidak valid. Ini bisa menjadi kesalahan sintaksis sederhana.    
 ** message **   
Uji
Kode Status HTTP: 400

 ** ConcurrentModificationException **   
Pengecualian yang dibuat sebagai hasil modifikasi konkuren ke aplikasi. Sebagai contoh, dua individu yang mencoba untuk mengedit aplikasi yang sama pada waktu yang sama.    
 ** message **   

Kode Status HTTP: 400

 ** InvalidArgumentException **   
Nilai parameter input yang ditentukan tidak valid.    
 ** message **   

Kode Status HTTP: 400

 ** LimitExceededException **   
Melebihi jumlah aplikasi yang diizinkan.    
 ** message **   

Kode Status HTTP: 400

 ** ResourceInUseException **   
Aplikasi ini tidak tersedia untuk operasi ini.    
 ** message **   

Kode Status HTTP: 400

 ** TooManyTagsException **   
Aplikasi yang dibuat dengan terlalu banyak tanda, atau terlalu banyak tanda yang ditambahkan ke aplikasi. Perhatikan bahwa jumlah maksimum tanda aplikasi termasuk tanda sistem. Jumlah maksimum tanda aplikasi yang ditentukan pengguna adalah 50.  
Kode Status HTTP: 400

 ** UnsupportedOperationException **   
Permintaan ditolak karena parameter tertentu tidak didukung atau sumber daya tertentu tidak valid untuk operasi ini.   
Kode Status HTTP: 400

## Lihat Juga
<a name="API_CreateApplication_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/CreateApplication) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/CreateApplication) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/CreateApplication) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/CreateApplication) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/CreateApplication) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/CreateApplication) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/CreateApplication) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/CreateApplication) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/CreateApplication) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/CreateApplication) 