# ReferenceDataSourceProperty

For a SQL-based Kinesis Data Analytics application, describes the reference data source by providing the source information (Amazon S3 bucket name and object key name), the resulting in-application table name that is created, and the necessary schema to map the data elements in the Amazon S3 object to the in-application table.

- Source: Generated code
- Type last changed: v2.93.0 · 23 Aug 2023

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_kinesisanalyticsv2 as kinesisanalyticsv2 } from 'aws-cdk-lib';
const referenceDataSourceProperty: kinesisanalyticsv2.CfnApplicationReferenceDataSource.ReferenceDataSourceProperty = {
  referenceSchema: {
    recordColumns: [{
      name: 'name',
      sqlType: 'sqlType',

      // the properties below are optional
      mapping: 'mapping',
    }],
    recordFormat: {
      recordFormatType: 'recordFormatType',

      // the properties below are optional
      mappingParameters: {
        csvMappingParameters: {
          recordColumnDelimiter: 'recordColumnDelimiter',
          recordRowDelimiter: 'recordRowDelimiter',
        },
        jsonMappingParameters: {
          recordRowPath: 'recordRowPath',
        },
      },
    },

    // the properties below are optional
    recordEncoding: 'recordEncoding',
  },

  // the properties below are optional
  s3ReferenceDataSource: {
    bucketArn: 'bucketArn',
    fileKey: 'fileKey',
  },
  tableName: 'tableName',
};
```

## Properties

- `referenceSchema`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnApplicationReferenceDataSource.ReferenceSchemaProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_kinesisanalyticsv2.CfnApplicationReferenceDataSource.ReferenceSchemaProperty.html) (required) — Describes the format of the data in the streaming source, and how each data element maps to corresponding columns created in the in-application stream.

- `s3ReferenceDataSource`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnApplicationReferenceDataSource.S3ReferenceDataSourceProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_kinesisanalyticsv2.CfnApplicationReferenceDataSource.S3ReferenceDataSourceProperty.html) — Identifies the S3 bucket and object that contains the reference data.

  A Kinesis Data Analytics application loads reference data only once. If the data changes, you call the [UpdateApplication](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_UpdateApplication.html) operation to trigger reloading of data into your application.

- `tableName`: string — The name of the in-application table to create.
