기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 데이터 소스
<a name="sam-property-graphqlapi-datasource"></a>

GraphQL API 해석기가 연결할 수 있는 데이터 소스를 구성하십시오. AWS Serverless Application Model (AWS SAM) 템플릿을 사용하여 다음 데이터 소스에 대한 연결을 구성할 수 있습니다.
+ Amazon DynamoDB
+ AWS Lambda

데이터 소스에 대해 자세히 알아보려면 *AWS AppSync 개발자 안내서*의 [데이터 소스 연결](https://docs.aws.amazon.com/appsync/latest/devguide/attaching-a-data-source.html)을 참조하세요.

## 구문
<a name="sam-property-graphqlapi-datasource-syntax"></a>

 AWS Serverless Application Model (AWS SAM) 템플릿에서이 개체를 선언하려면 다음 구문을 사용합니다.

### YAML
<a name="sam-property-graphqlapi-datasource-syntax-yaml"></a>

```
DynamoDb: DynamoDb
Lambda: Lambda
```

## 속성
<a name="sam-property-graphqlapi-datasource-properties"></a>

`DynamoDb`  <a name="sam-graphqlapi-datasource-dynamodb"></a>
DynamoDB 테이블을 GraphQL API 해석기의 데이터 소스로 구성합니다.  
*유형*: [DynamoDB](sam-property-graphqlapi-datasource-dynamodb.md)  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다.

`Lambda`  <a name="sam-graphqlapi-datasource-lambda"></a>
Lambda 함수를 귀하의 GraphQL API 해석기의 데이터 소스로 구성합니다.  
*유형*: [Lambda](sam-property-graphqlapi-datasource-lambda.md)  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다.

# DynamoDb
<a name="sam-property-graphqlapi-datasource-dynamodb"></a>

Amazon DynamoDB 테이블을 귀하의 GraphQLAPI 해석기의 데이터 소스로 구성합니다. 

## 구문
<a name="sam-property-graphqlapi-datasource-dynamodb-syntax"></a>

 AWS Serverless Application Model (AWS SAM) 템플릿에서이 개체를 선언하려면 다음 구문을 사용합니다.

### YAML
<a name="sam-property-graphqlapi-datasource-dynamodb-syntax-yaml"></a>

```
LogicalId:
  DeltaSync: [DeltaSyncConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-datasource-deltasyncconfig.html)
  Description: String
  Name: String
  Permissions: List
  Region: String
  ServiceRoleArn: String
  TableArn: String
  TableName: String
  UseCallerCredentials: Boolean
  Versioned: Boolean
```

## 속성
<a name="sam-property-graphqlapi-datasource-dynamodb-properties"></a>

`DeltaSync`  <a name="sam-graphqlapi-datasource-dynamodb-deltasync"></a>
델타 동기화 구성에 대해 설명합니다.  
*유형*: [DeltaSyncConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-datasource-deltasyncconfig.html)  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource DynamoDBConfig` 객체의 `[DeltaSyncConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-datasource-dynamodbconfig.html#cfn-appsync-datasource-dynamodbconfig-deltasyncconfig)` 속성으로 직접 전달됩니다.

`Description`  <a name="sam-graphqlapi-datasource-dynamodb-description"></a>
귀하의 데이터 소스에 대한 설명.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource` 리소스의 `[Description](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-datasource.html#cfn-appsync-datasource-description)` 속성으로 직접 전달됩니다.

`LogicalId`  <a name="sam-graphqlapi-datasource-dynamodb-logicalid"></a>
귀하의 데이터 소스의 고유한 이름.  
*유형*: 문자열  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource` 리소스의 `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-datasource.html#cfn-appsync-datasource-name)` 속성으로 직접 전달됩니다.

`Name`  <a name="sam-graphqlapi-datasource-dynamodb-name"></a>
귀하의 데이터 소스의 이름. 이 속성을 지정하여 `LogicalId` 값을 재정의합니다.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource` 리소스의 `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-datasource.html#cfn-appsync-datasource-name)` 속성으로 직접 전달됩니다.

`Permissions`  <a name="sam-graphqlapi-datasource-dynamodb-permissions"></a>
[AWS SAM 커넥터](managing-permissions-connectors.md)를 사용하여 데이터 소스에 권한을 제공합니다. 다음 값 중 하나를 목록에 제공할 수 있습니다.  
+ `Read` – 귀하의 리졸버가 데이터 소스를 읽을 수 있도록 허용합니다.
+ `Write` – 귀하의 리졸버가 데이터 소스에 쓸 수 있도록 허용합니다.
AWS SAM 는 배포 시 변환된 `AWS::Serverless::Connector` 리소스를 사용하여 권한을 프로비저닝합니다. 생성된 리소스에 대한 자세한 내용은을 참조하세요[CloudFormation 지정할 때 생성된 리소스 AWS::Serverless::Connector](sam-specification-generated-resources-connector.md).  
`Permissions` 또는 `ServiceRoleArn`을 지정할 수 있지만 둘 다 함께 지정할 수는 없습니다. 둘 다 지정하지 않으면 AWS SAM 는 `Read` 및의 기본값을 생성합니다`Write`. 데이터 소스에 대한 액세스를 취소하려면 AWS SAM 템플릿에서 DynamoDB 객체를 제거합니다.
*유형*: 목록  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다. 이것은 `AWS::Serverless::Connector` 리소스의 `Permissions` 속성과 유사합니다.

`Region`  <a name="sam-graphqlapi-datasource-dynamodb-region"></a>
DynamoDB 테이블 AWS 리전 의 입니다. 지정하지 않으면에서를 AWS SAM 사용합니다`[AWS::Region](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/pseudo-parameter-reference.html#cfn-pseudo-param-region)`.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource DynamoDBConfig` 객체의 `[AwsRegion](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-datasource-dynamodbconfig.html#cfn-appsync-datasource-dynamodbconfig-awsregion)` 속성으로 직접 전달됩니다.

`ServiceRoleArn`  <a name="sam-graphqlapi-datasource-dynamodb-servicerolearn"></a>
데이터 소스에 대한 AWS Identity and Access Management (IAM) 서비스 역할 ARN입니다. 시스템은 데이터 소스에 액세스할 때 이 역할을 사용합니다.  
`Permissions` 또는 `ServiceRoleArn`을 지정할 수 있지만 둘 다 함께 지정할 수는 없습니다.  
*유형*: 문자열  
*필수*: 아니요. 지정하지 않으면의 기본값을 AWS SAM 적용합니다`Permissions`.  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource` 리소스의 `[ServiceRoleArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-datasource.html#cfn-appsync-datasource-servicerolearn)` 속성으로 직접 전달됩니다.

`TableArn`  <a name="sam-graphqlapi-datasource-dynamodb-tablearn"></a>
DynamoDB 테이블의 ARN.  
*유형*: 문자열  
*필수 항목 여부*: 조건부. `ServiceRoleArn`를 지정하지 않는 경우 `TableArn`가 필수입니다.  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다.

`TableName`  <a name="sam-graphqlapi-datasource-dynamodb-tablename"></a>
테이블 이름.  
*유형*: 문자열  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource DynamoDBConfig` 객체의 `[TableName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-datasource-dynamodbconfig.html#cfn-appsync-datasource-dynamodbconfig-tablename)` 속성으로 직접 전달됩니다.

`UseCallerCredentials`  <a name="sam-graphqlapi-datasource-dynamodb-usecallercredentials"></a>
이 데이터 소스로 IAM을 사용하려면 `true`로 설정합니다.  
*유형*: 부울  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource DynamoDBConfig` 객체의 `[UseCallerCredentials](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-datasource-dynamodbconfig.html#cfn-appsync-datasource-dynamodbconfig-usecallercredentials)` 속성으로 직접 전달됩니다.

`Versioned`  <a name="sam-graphqlapi-datasource-dynamodb-versioned"></a>
이 데이터 소스로 [충돌 감지 및 충돌 해결 및 동기화](https://docs.aws.amazon.com/appsync/latest/devguide/conflict-detection-and-sync.html)를 사용하려면 `true`로 설정합니다.  
*유형*: 부울  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource DynamoDBConfig` 객체의 `[Versioned](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-datasource-dynamodbconfig.html#cfn-appsync-datasource-dynamodbconfig-versioned)` 속성으로 직접 전달됩니다.

# Lambda
<a name="sam-property-graphqlapi-datasource-lambda"></a>

 AWS Lambda 함수를 GraphQL API 해석기의 데이터 소스로 구성합니다.

## 구문
<a name="sam-property-graphqlapi-datasource-lambda-syntax"></a>

 AWS Serverless Application Model (AWS SAM) 템플릿에서이 개체를 선언하려면 다음 구문을 사용합니다.

### YAML
<a name="sam-property-graphqlapi-datasource-lambda-syntax-yaml"></a>

```
LogicalId:
  Description: String
  FunctionArn: String
  Name: String
  ServiceRoleArn: String
```

## 속성
<a name="sam-property-graphqlapi-datasource-lambda-properties"></a>

`Description`  <a name="sam-graphqlapi-datasource-lambda-description"></a>
귀하의 데이터 소스에 대한 설명.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource` 리소스의 `[Description](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-datasource.html#cfn-appsync-datasource-description)` 속성으로 직접 전달됩니다.

`FunctionArn`  <a name="sam-graphqlapi-datasource-lambda-functionarn"></a>
Lambda 함수의 ARN입니다.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource LambdaConfig` 객체의 `[LambdaFunctionArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-datasource-lambdaconfig.html#cfn-appsync-datasource-lambdaconfig-lambdafunctionarn)` 속성으로 직접 전달됩니다.

`LogicalId`  <a name="sam-graphqlapi-datasource-lambda-logicalid"></a>
귀하의 데이터 소스의 고유한 이름.  
*유형*: 문자열  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource` 리소스의 `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-datasource.html#cfn-appsync-datasource-name)` 속성으로 직접 전달됩니다.

`Name`  <a name="sam-graphqlapi-datasource-lambda-name"></a>
귀하의 데이터 소스의 이름. 이 속성을 지정하여 `LogicalId` 값을 재정의합니다.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource` 리소스의 `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-datasource.html#cfn-appsync-datasource-name)` 속성으로 직접 전달됩니다.

`ServiceRoleArn`  <a name="sam-graphqlapi-datasource-lambda-servicerolearn"></a>
데이터 소스에 대한 AWS Identity and Access Management (IAM) 서비스 역할 ARN입니다. 시스템은 데이터 소스에 액세스할 때 이 역할을 사용합니다.  
데이터 소스에 대한 액세스 권한을 취소하려면 귀하의 AWS SAM 템플릿에서 Lambda 객체를 제거하십시오. 
*유형*: 문자열  
*필수*: 아니요. 지정하지 않으면 AWS SAM 가를 사용하여 `Write` 권한을 프로비저닝합니다[AWS SAM 커넥터](managing-permissions-connectors.md).  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource` 리소스의 `[ServiceRoleArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-datasource.html#cfn-appsync-datasource-servicerolearn)` 속성으로 직접 전달됩니다.