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

# AddApplicationReferenceDataSource
<a name="API_AddApplicationReferenceDataSource"></a>

Menambahkan sumber data referensi ke aplikasi Kinesis Data Analytics berbasis SQL yang ada.

Kinesis Data Analytics membaca data referensi (yaitu objek Amazon S3) dan membuat tabel dalam aplikasi dalam aplikasi Anda. Dalam permintaan, Anda memberikan sumber (nama bucket S3 dan nama kunci objek), nama tabel dalam aplikasi yang dibuat, dan informasi pemetaan yang diperlukan yang menjelaskan cara memetakan data di objek Amazon S3 ke kolom di tabel dalam aplikasi yang dihasilkan.

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

```
{
   "ApplicationName": "string",
   "CurrentApplicationVersionId": number,
   "ReferenceDataSource": { 
      "ReferenceSchema": { 
         "RecordColumns": [ 
            { 
               "Mapping": "string",
               "Name": "string",
               "SqlType": "string"
            }
         ],
         "RecordEncoding": "string",
         "RecordFormat": { 
            "MappingParameters": { 
               "CSVMappingParameters": { 
                  "RecordColumnDelimiter": "string",
                  "RecordRowDelimiter": "string"
               },
               "JSONMappingParameters": { 
                  "RecordRowPath": "string"
               }
            },
            "RecordFormatType": "string"
         }
      },
      "S3ReferenceDataSource": { 
         "BucketARN": "string",
         "FileKey": "string"
      },
      "TableName": "string"
   }
}
```

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

Permintaan menerima data berikut dalam format JSON.

 ** [ApplicationName](#API_AddApplicationReferenceDataSource_RequestSyntax) **   <a name="APIReference-AddApplicationReferenceDataSource-request-ApplicationName"></a>
Nama aplikasi yang ada.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.  
Pola: `[a-zA-Z0-9_.-]+`   
Wajib: Ya

 ** [CurrentApplicationVersionId](#API_AddApplicationReferenceDataSource_RequestSyntax) **   <a name="APIReference-AddApplicationReferenceDataSource-request-CurrentApplicationVersionId"></a>
Versi aplikasi yang Anda tambahkan sumber data referensi. Anda dapat menggunakan [DescribeApplication](API_DescribeApplication.md) operasi untuk mendapatkan versi aplikasi saat ini. Jika versi yang ditentukan bukan versi saat ini, `ConcurrentModificationException` dikembalikan.  
Tipe: Long  
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 999999999.  
Wajib: Ya

 ** [ReferenceDataSource](#API_AddApplicationReferenceDataSource_RequestSyntax) **   <a name="APIReference-AddApplicationReferenceDataSource-request-ReferenceDataSource"></a>
Sumber data referensi dapat berupa objek dalam bucket Amazon S3 Anda. Kinesis Data Analytics membaca objek dan menyalin data ke dalam tabel dalam aplikasi yang dibuat. Anda menyediakan bucket S3, objek kunci nama, dan tabel dalam aplikasi yang dihasilkan yang dibuat.   
Tipe: Objek [ReferenceDataSource](API_ReferenceDataSource.md)  
Wajib: Ya

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

```
{
   "ApplicationARN": "string",
   "ApplicationVersionId": number,
   "ReferenceDataSourceDescriptions": [ 
      { 
         "ReferenceId": "string",
         "ReferenceSchema": { 
            "RecordColumns": [ 
               { 
                  "Mapping": "string",
                  "Name": "string",
                  "SqlType": "string"
               }
            ],
            "RecordEncoding": "string",
            "RecordFormat": { 
               "MappingParameters": { 
                  "CSVMappingParameters": { 
                     "RecordColumnDelimiter": "string",
                     "RecordRowDelimiter": "string"
                  },
                  "JSONMappingParameters": { 
                     "RecordRowPath": "string"
                  }
               },
               "RecordFormatType": "string"
            }
         },
         "S3ReferenceDataSourceDescription": { 
            "BucketARN": "string",
            "FileKey": "string",
            "ReferenceRoleARN": "string"
         },
         "TableName": "string"
      }
   ]
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [ApplicationARN](#API_AddApplicationReferenceDataSource_ResponseSyntax) **   <a name="APIReference-AddApplicationReferenceDataSource-response-ApplicationARN"></a>
Aplikasi Amazon Resource Name (ARN).  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.  
Pola: `arn:.*` 

 ** [ApplicationVersionId](#API_AddApplicationReferenceDataSource_ResponseSyntax) **   <a name="APIReference-AddApplicationReferenceDataSource-response-ApplicationVersionId"></a>
ID versi aplikasi yang diperbarui. Kinesis Data Analytics menambah ID ini saat aplikasi diperbarui.  
Tipe: Long  
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 999999999.

 ** [ReferenceDataSourceDescriptions](#API_AddApplicationReferenceDataSource_ResponseSyntax) **   <a name="APIReference-AddApplicationReferenceDataSource-response-ReferenceDataSourceDescriptions"></a>
Menjelaskan sumber data referensi yang dikonfigurasi untuk aplikasi.   
Tipe: Array objek [ReferenceDataSourceDescription](API_ReferenceDataSourceDescription.md)

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

 ** ConcurrentModificationException **   
Pengecualian dilemparkan sebagai hasil dari modifikasi bersamaan ke aplikasi. Kesalahan ini dapat disebabkan oleh upaya memodifikasi aplikasi tanpa menggunakan ID aplikasi saat ini.  
Kode Status HTTP: 400

 ** InvalidArgumentException **   
Nilai parameter input yang ditentukan tidak valid.  
Kode Status HTTP: 400

 ** InvalidRequestException **   
Permintaan JSON tidak valid untuk operasi.  
Kode Status HTTP: 400

 ** ResourceInUseException **   
Aplikasi ini tidak tersedia untuk operasi ini.  
Kode Status HTTP: 400

 ** ResourceNotFoundException **   
Aplikasi yang ditentukan tidak dapat ditemukan.  
Kode Status HTTP: 400

## Lihat Juga
<a name="API_AddApplicationReferenceDataSource_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/kinesisanalyticsv2-2018-05-23/AddApplicationReferenceDataSource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalyticsv2-2018-05-23/AddApplicationReferenceDataSource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalyticsv2-2018-05-23/AddApplicationReferenceDataSource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalyticsv2-2018-05-23/AddApplicationReferenceDataSource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalyticsv2-2018-05-23/AddApplicationReferenceDataSource) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalyticsv2-2018-05-23/AddApplicationReferenceDataSource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalyticsv2-2018-05-23/AddApplicationReferenceDataSource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalyticsv2-2018-05-23/AddApplicationReferenceDataSource) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalyticsv2-2018-05-23/AddApplicationReferenceDataSource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalyticsv2-2018-05-23/AddApplicationReferenceDataSource)