• /
  • EnglishEspaΓ±olFranΓ§aisζ—₯本θͺžν•œκ΅­μ–΄PortuguΓͺs
  • λ‘œκ·ΈμΈμ§€κΈˆ μ‹œμž‘ν•˜κΈ°

μ‚¬μš©μžμ˜ 편의λ₯Ό μœ„ν•΄ μ œκ³΅λ˜λŠ” 기계 λ²ˆμ—­μž…λ‹ˆλ‹€.

영문본과 λ²ˆμ—­λ³Έμ΄ μΌμΉ˜ν•˜μ§€ μ•ŠλŠ” 경우 영문본이 μš°μ„ ν•©λ‹ˆλ‹€. 보닀 μžμ„Έν•œ λ‚΄μš©μ€ 이 νŽ˜μ΄μ§€λ₯Ό λ°©λ¬Έν•˜μ‹œκΈ° λ°”λžλ‹ˆλ‹€.

문제 μ‹ κ³ 

AWS DynamoDB μž‘μ—…

|View as Markdown (English)

이 νŽ˜μ΄μ§€λŠ” μ›Œν¬ν”Œλ‘œμš° μžλ™ν™” μ•‘μ…˜ μΉ΄νƒˆλ‘œκ·Έμ—μ„œ μ‚¬μš©ν•  수 μžˆλŠ” AWS DynamoDB μ•‘μ…˜μ— λŒ€ν•œ μ°Έμ‘°λ₯Ό μ œκ³΅ν•©λ‹ˆλ‹€. μ΄λŸ¬ν•œ μ•‘μ…˜μ„ μ‚¬μš©ν•˜μ—¬ DynamoDB ν…Œμ΄λΈ”μ˜ ν•­λͺ©μ„ 읽고, μ“°κ³ , μ—…λ°μ΄νŠΈν•˜κ³ , μ‚­μ œν•˜λ©°, μ›Œν¬ν”Œλ‘œμš° μ •μ˜μ—μ„œ 직접 ν…Œμ΄λΈ” 섀정을 κ²€μ‚¬ν•˜κ±°λ‚˜ μˆ˜μ •ν•˜μ‹­μ‹œμ˜€.

μ „μ œ 쑰건

사전 μš”κ΅¬ 사항 및 자격 증λͺ… 섀정에 λŒ€ν•΄μ„œλŠ” AWS 자격 증λͺ… 섀정을 μ°Έμ‘°ν•˜μ‹­μ‹œμ˜€.

λͺ¨λ“  DynamoDB μž‘μ—…μ€ λ™μΌν•œ 인증 μž…λ ₯을 ν—ˆμš©ν•©λ‹ˆλ‹€. awsRoleArn (ꢌμž₯) λ˜λŠ” μ•‘μ„ΈμŠ€ ν‚€ μŒμ„ μ‚¬μš©ν•˜μ‹­μ‹œμ˜€.

ν•­λͺ© μΆ”κ°€

μž‘μ—… μ‹λ³„μžλŠ” aws.dynamodb.putItemμž…λ‹ˆλ‹€.

DynamoDB ν…Œμ΄λΈ”μ—μ„œ μƒˆ ν•­λͺ©μ„ μƒμ„±ν•˜κ±°λ‚˜ κΈ°μ‘΄ ν•­λͺ©μ„ λŒ€μ²΄ν•©λ‹ˆλ‹€. item 맡에 DynamoDB ν•˜μœ„ μˆ˜μ€€ AttributeValue ν˜•μ‹μ„ μ‚¬μš©ν•©λ‹ˆλ‹€.

λ‹€μŒ ν‘œμ—μ„œλŠ” 이 μž‘μ—…μ˜ μž…λ ₯ ν•„λ“œλ₯Ό μ„€λͺ…ν•©λ‹ˆλ‹€.

μž…λ ₯

μœ ν˜•

μ„€λͺ…

μ˜ˆμ‹œ

region

λ¬Έμžμ—΄

ν•„μˆ˜ ν•­λͺ©μž…λ‹ˆλ‹€. νƒ€κ²Ÿ ν…Œμ΄λΈ”μ˜ AWS λ¦¬μ „μž…λ‹ˆλ‹€.

us-east-2

tableName

λ¬Έμžμ—΄

ν•„μˆ˜ ν•­λͺ©μž…λ‹ˆλ‹€. DynamoDB ν…Œμ΄λΈ”μ˜ μ΄λ¦„μž…λ‹ˆλ‹€.

Orders

item

지도

ν•„μˆ˜ ν•­λͺ©μž…λ‹ˆλ‹€. ν•˜μœ„ μˆ˜μ€€ DynamoDB AttributeValue ν˜•μ‹μ˜ 속성 이름/κ°’ 쌍 λ§΅μž…λ‹ˆλ‹€. κΈ°λ³Έ ν‚€ μ†μ„±λ§Œ ν•„μˆ˜μ΄λ©°, λ‹€λ₯Έ 속성은 선택 μ‚¬ν•­μž…λ‹ˆλ‹€.

{"id": {"S": "123"}, "status": {"S": "PLACED"}}

awsRoleArn

λ¬Έμžμ—΄

선택 사항. AWS API ν˜ΈμΆœμ„ μœ„ν•΄ μˆ˜μž„ν•  IAM μ—­ν•  ARNμž…λ‹ˆλ‹€.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

λ¬Έμžμ—΄

선택 사항. AWS μ•‘μ„ΈμŠ€ ν‚€ IDμž…λ‹ˆλ‹€. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

λ¬Έμžμ—΄

선택 사항. AWS λΉ„λ°€ μ•‘μ„ΈμŠ€ ν‚€μž…λ‹ˆλ‹€. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

λ¬Έμžμ—΄

선택 사항. STS 인증을 μœ„ν•œ μž„μ‹œ μ„Έμ…˜ 토큰. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsSessionToken }}

conditionExpression

λ¬Έμžμ—΄

선택 ν•­λͺ©μž…λ‹ˆλ‹€. PutItem이(κ°€) μ„±κ³΅ν•˜κΈ° μœ„ν•΄ μΆ©μ‘±ν•΄μ•Ό ν•˜λŠ” μ‘°κ±΄μž…λ‹ˆλ‹€. ν•¨μˆ˜(attribute_exists, attribute_not_exists, contains), 비ꡐ μ—°μ‚°μž 및 논리 μ—°μ‚°μž(AND, OR, NOT)λ₯Ό μ§€μ›ν•©λ‹ˆλ‹€.

attribute_not_exists(id)

expressionAttributeNames

지도

선택 ν•­λͺ©μž…λ‹ˆλ‹€. ν‘œν˜„μ‹μ˜ 속성 이름에 λŒ€ν•œ λŒ€μ²΄ ν† ν°μž…λ‹ˆλ‹€. μ˜ˆμ•½μ–΄ λ˜λŠ” 특수 문자λ₯Ό μ°Έμ‘°ν•˜λ €λ©΄ #name ꡬ문을 μ‚¬μš©ν•˜μ‹­μ‹œμ˜€.

{"#n": "name"}

expressionAttributeValues

지도

선택 ν•­λͺ©μž…λ‹ˆλ‹€. ν•˜μœ„ 레벨 AttributeValue ν˜•μ‹μ˜ ν‘œν˜„μ‹μ— λŒ€ν•œ λŒ€μ²΄ κ°’μž…λ‹ˆλ‹€. :value ꡬ문을 μ‚¬μš©ν•˜μ‹­μ‹œμ˜€.

{":id": {"S": "123"}}

parameters

지도

선택 ν•­λͺ©μž…λ‹ˆλ‹€. μœ„μ—μ„œ λͺ¨λΈλ§λ˜μ§€ μ•Šμ€ λͺ¨λ“  put_item ν•„λ“œμ— λŒ€ν•œ νŒ¨μŠ€μŠ€λ£¨μž…λ‹ˆλ‹€. ν•„λ“œ 이름은 boto3 PascalCaseλ₯Ό μ‚¬μš©ν•΄μ•Ό ν•©λ‹ˆλ‹€. 곡톡 κ°’: ReturnValues (NONE κΈ°λ³Έκ°’ | ALL_OLD), ReturnConsumedCapacity (NONE κΈ°λ³Έκ°’ | TOTAL | INDEXES), ReturnValuesOnConditionCheckFailure (NONE κΈ°λ³Έκ°’ | ALL_OLD). PutItem API μ°Έμ‘°λ₯Ό ν™•μΈν•˜μ‹­μ‹œμ˜€.

{"ReturnValues": "ALL_OLD"}

selectors

λͺ©λ‘

선택 사항. μž‘μ—… 좜λ ₯μ—μ„œ νŠΉμ • ν•„λ“œλ₯Ό μΆ”μΆœν•˜κΈ° μœ„ν•œ JQ μ„ νƒμžμž…λ‹ˆλ‹€.

[{"name": "attributes", "expression": ".response.Attributes"}]

λ‹€μŒ ν‘œλŠ” 이 μž‘μ—…μ˜ 좜λ ₯ ν•„λ“œλ₯Ό μ„€λͺ…ν•©λ‹ˆλ‹€.

μ‚°μΆœ

μœ ν˜•

μ˜ˆμ‹œ

success

λΆ€μšΈ

true λ˜λŠ” false

response

물체

μ›μ‹œ put_item μ‘λ‹΅μž…λ‹ˆλ‹€. parameters을(λ₯Ό) 톡해 ReturnValues이(κ°€) μ„€μ •λœ 경우 Attributes을(λ₯Ό) ν¬ν•¨ν•©λ‹ˆλ‹€. PutItem API μ°Έμ‘°λ₯Ό ν™•μΈν•˜μ‹­μ‹œμ˜€.

errorMessage

λ¬Έμžμ—΄

μ‹€νŒ¨ μ‹œ 였λ₯˜ λ©”μ‹œμ§€μž…λ‹ˆλ‹€.

μ˜ˆμ‹œ

name: put-dynamodb-item
description: Write an order item to DynamoDB
steps:
- name: putOrderItem
type: action
action: aws.dynamodb.putItem
version: '1'
inputs:
awsRoleArn: ${{ :secrets:awsRoleArn }}
region: us-east-2
tableName: Orders
item:
orderId: { "S": "123" }
status: { "S": "PLACED" }
next: end

ν•­λͺ© κ°€μ Έμ˜€κΈ°

μž‘μ—… μ‹λ³„μžλŠ” aws.dynamodb.getItemμž…λ‹ˆλ‹€.

κΈ°λ³Έ ν‚€λ‘œ DynamoDB ν…Œμ΄λΈ”μ—μ„œ 단일 ν•­λͺ©μ„ κ°€μ Έμ˜΅λ‹ˆλ‹€.

λ‹€μŒ ν‘œμ—μ„œλŠ” 이 μž‘μ—…μ˜ μž…λ ₯ ν•„λ“œλ₯Ό μ„€λͺ…ν•©λ‹ˆλ‹€.

μž…λ ₯

μœ ν˜•

μ„€λͺ…

μ˜ˆμ‹œ

region

λ¬Έμžμ—΄

ν•„μˆ˜ ν•­λͺ©μž…λ‹ˆλ‹€. νƒ€κ²Ÿ ν…Œμ΄λΈ”μ˜ AWS λ¦¬μ „μž…λ‹ˆλ‹€.

us-east-2

tableName

λ¬Έμžμ—΄

ν•„μˆ˜ ν•­λͺ©μž…λ‹ˆλ‹€. DynamoDB ν…Œμ΄λΈ”μ˜ μ΄λ¦„μž…λ‹ˆλ‹€.

Orders

key

지도

ν•„μˆ˜ ν•­λͺ©μž…λ‹ˆλ‹€. 검색할 ν•­λͺ©μ˜ κΈ°λ³Έ 킀이며, ν•˜μœ„ μˆ˜μ€€ AttributeValue ν˜•μ‹μž…λ‹ˆλ‹€.

{"orderId": {"S": "123"}}

awsRoleArn

λ¬Έμžμ—΄

선택 사항. AWS API ν˜ΈμΆœμ„ μœ„ν•΄ μˆ˜μž„ν•  IAM μ—­ν•  ARNμž…λ‹ˆλ‹€.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

λ¬Έμžμ—΄

선택 사항. AWS μ•‘μ„ΈμŠ€ ν‚€ IDμž…λ‹ˆλ‹€. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

λ¬Έμžμ—΄

선택 사항. AWS λΉ„λ°€ μ•‘μ„ΈμŠ€ ν‚€μž…λ‹ˆλ‹€. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

λ¬Έμžμ—΄

선택 사항. STS 인증을 μœ„ν•œ μž„μ‹œ μ„Έμ…˜ 토큰. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsSessionToken }}

projectionExpression

λ¬Έμžμ—΄

선택 ν•­λͺ©μž…λ‹ˆλ‹€. μ‰Όν‘œλ‘œ κ΅¬λΆ„λœ 검색할 속성 λͺ©λ‘μž…λ‹ˆλ‹€. μƒλž΅ν•˜λ©΄ λͺ¨λ“  속성이 λ°˜ν™˜λ©λ‹ˆλ‹€.

id, #n

expressionAttributeNames

지도

선택 ν•­λͺ©μž…λ‹ˆλ‹€. ν‘œν˜„μ‹μ˜ 속성 이름에 λŒ€ν•œ λŒ€μ²΄ ν† ν°μž…λ‹ˆλ‹€. μ˜ˆμ•½μ–΄ λ˜λŠ” 특수 문자λ₯Ό μ°Έμ‘°ν•˜λ €λ©΄ #name ꡬ문을 μ‚¬μš©ν•˜μ‹­μ‹œμ˜€.

{"#n": "name"}

consistentRead

λΆ€μšΈ

선택 ν•­λͺ©μž…λ‹ˆλ‹€. true인 경우, κ°•λ ₯ν•œ μΌκ΄€λœ 읽기λ₯Ό μ‚¬μš©ν•©λ‹ˆλ‹€. κΈ°λ³Έκ°’: false (μ΅œμ’…μ  일관성).

false

parameters

지도

선택 ν•­λͺ©μž…λ‹ˆλ‹€. μœ„μ—μ„œ λͺ¨λΈλ§λ˜μ§€ μ•Šμ€ λͺ¨λ“  get_item ν•„λ“œμ— λŒ€ν•œ νŒ¨μŠ€μŠ€λ£¨μž…λ‹ˆλ‹€. 일반적인 κ°’: ReturnConsumedCapacity (NONE κΈ°λ³Έκ°’ | TOTAL | INDEXES). GetItem API μ°Έμ‘°λ₯Ό ν™•μΈν•˜μ‹­μ‹œμ˜€.

{"ReturnConsumedCapacity": "TOTAL"}

selectors

λͺ©λ‘

선택 사항. μž‘μ—… 좜λ ₯μ—μ„œ νŠΉμ • ν•„λ“œλ₯Ό μΆ”μΆœν•˜κΈ° μœ„ν•œ JQ μ„ νƒμžμž…λ‹ˆλ‹€.

[{"name": "item", "expression": ".response.Item"}]

λ‹€μŒ ν‘œλŠ” 이 μž‘μ—…μ˜ 좜λ ₯ ν•„λ“œλ₯Ό μ„€λͺ…ν•©λ‹ˆλ‹€.

μ‚°μΆœ

μœ ν˜•

μ˜ˆμ‹œ

success

λΆ€μšΈ

true λ˜λŠ” false

response

물체

ν•­λͺ©μ„ 찾은 경우 Item을(λ₯Ό) ν¬ν•¨ν•©λ‹ˆλ‹€. GetItem API μ°Έμ‘°λ₯Ό ν™•μΈν•˜μ‹­μ‹œμ˜€.

errorMessage

λ¬Έμžμ—΄

μ‹€νŒ¨ μ‹œ 였λ₯˜ λ©”μ‹œμ§€μž…λ‹ˆλ‹€.

μ˜ˆμ‹œ

name: get-dynamodb-item
description: Retrieve an order item from DynamoDB by primary key
steps:
- name: getOrderItem
type: action
action: aws.dynamodb.getItem
version: '1'
inputs:
awsRoleArn: ${{ :secrets:awsRoleArn }}
region: us-east-2
tableName: Orders
key:
orderId: { "S": "123" }
selectors:
- name: item
expression: '.response.Item'
next: end

ν•­λͺ© μ—…λ°μ΄νŠΈ

μž‘μ—… μ‹λ³„μžλŠ” aws.dynamodb.updateItemμž…λ‹ˆλ‹€.

κΈ°μ‘΄ ν•­λͺ©μ˜ 속성을 νŽΈμ§‘ν•˜κ±°λ‚˜, ν•­λͺ©μ΄ 아직 μ—†λŠ” 경우 μƒˆ ν•­λͺ©μ„ μΆ”κ°€ν•©λ‹ˆλ‹€.

λ‹€μŒ ν‘œμ—μ„œλŠ” 이 μž‘μ—…μ˜ μž…λ ₯ ν•„λ“œλ₯Ό μ„€λͺ…ν•©λ‹ˆλ‹€.

μž…λ ₯

μœ ν˜•

μ„€λͺ…

μ˜ˆμ‹œ

region

λ¬Έμžμ—΄

ν•„μˆ˜ ν•­λͺ©μž…λ‹ˆλ‹€. νƒ€κ²Ÿ ν…Œμ΄λΈ”μ˜ AWS λ¦¬μ „μž…λ‹ˆλ‹€.

us-east-2

tableName

λ¬Έμžμ—΄

ν•„μˆ˜ ν•­λͺ©μž…λ‹ˆλ‹€. DynamoDB ν…Œμ΄λΈ”μ˜ μ΄λ¦„μž…λ‹ˆλ‹€.

Orders

key

지도

ν•„μˆ˜ ν•­λͺ©μž…λ‹ˆλ‹€. ν•˜μœ„ μˆ˜μ€€ AttributeValue ν˜•μ‹μœΌλ‘œ 된 μ—…λ°μ΄νŠΈν•  ν•­λͺ©μ˜ κΈ°λ³Έ ν‚€μž…λ‹ˆλ‹€.

{"orderId": {"S": "123"}}

awsRoleArn

λ¬Έμžμ—΄

선택 사항. AWS API ν˜ΈμΆœμ„ μœ„ν•΄ μˆ˜μž„ν•  IAM μ—­ν•  ARNμž…λ‹ˆλ‹€.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

λ¬Έμžμ—΄

선택 사항. AWS μ•‘μ„ΈμŠ€ ν‚€ IDμž…λ‹ˆλ‹€. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

λ¬Έμžμ—΄

선택 사항. AWS λΉ„λ°€ μ•‘μ„ΈμŠ€ ν‚€μž…λ‹ˆλ‹€. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

λ¬Έμžμ—΄

선택 사항. STS 인증을 μœ„ν•œ μž„μ‹œ μ„Έμ…˜ 토큰. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsSessionToken }}

updateExpression

λ¬Έμžμ—΄

선택 ν•­λͺ©μž…λ‹ˆλ‹€. μ—…λ°μ΄νŠΈν•  속성을 μ •μ˜ν•©λ‹ˆλ‹€. SET, REMOVE, ADD 및 DELETE μž‘μ—…μ„ μ§€μ›ν•©λ‹ˆλ‹€.

SET #s = :status

conditionExpression

λ¬Έμžμ—΄

선택 ν•­λͺ©μž…λ‹ˆλ‹€. UpdateItem이(κ°€) μ„±κ³΅ν•˜κΈ° μœ„ν•΄ μΆ©μ‘±ν•΄μ•Ό ν•˜λŠ” μ‘°κ±΄μž…λ‹ˆλ‹€.

attribute_exists(orderId)

expressionAttributeNames

지도

선택 ν•­λͺ©μž…λ‹ˆλ‹€. ν‘œν˜„μ‹μ˜ 속성 이름에 λŒ€ν•œ λŒ€μ²΄ ν† ν°μž…λ‹ˆλ‹€. μ˜ˆμ•½μ–΄ λ˜λŠ” 특수 문자λ₯Ό μ°Έμ‘°ν•˜λ €λ©΄ #name ꡬ문을 μ‚¬μš©ν•˜μ‹­μ‹œμ˜€.

{"#s": "status"}

expressionAttributeValues

지도

선택 ν•­λͺ©μž…λ‹ˆλ‹€. ν•˜μœ„ μˆ˜μ€€ AttributeValue ν˜•μ‹μ˜ ν‘œν˜„μ‹μ— λŒ€ν•œ λŒ€μ²΄ κ°’μž…λ‹ˆλ‹€.

{":status": {"S": "SHIPPED"}}

parameters

지도

선택 ν•­λͺ©μž…λ‹ˆλ‹€. μœ„μ—μ„œ λͺ¨λΈλ§λ˜μ§€ μ•Šμ€ λͺ¨λ“  update_item ν•„λ“œμ— λŒ€ν•œ νŒ¨μŠ€μŠ€λ£¨μž…λ‹ˆλ‹€. 곡톡 κ°’: ReturnValues (NONE κΈ°λ³Έκ°’ | ALL_OLD | UPDATED_OLD | ALL_NEW | UPDATED_NEW). UpdateItem API μ°Έμ‘°λ₯Ό 확인해 μ£Όμ‹­μ‹œμ˜€.

{"ReturnValues": "UPDATED_NEW"}

selectors

λͺ©λ‘

선택 사항. μž‘μ—… 좜λ ₯μ—μ„œ νŠΉμ • ν•„λ“œλ₯Ό μΆ”μΆœν•˜κΈ° μœ„ν•œ JQ μ„ νƒμžμž…λ‹ˆλ‹€.

[{"name": "attributes", "expression": ".response.Attributes"}]

λ‹€μŒ ν‘œλŠ” 이 μž‘μ—…μ˜ 좜λ ₯ ν•„λ“œλ₯Ό μ„€λͺ…ν•©λ‹ˆλ‹€.

μ‚°μΆœ

μœ ν˜•

μ˜ˆμ‹œ

success

λΆ€μšΈ

true λ˜λŠ” false

response

물체

parameters을(λ₯Ό) 톡해 ReturnValues이(κ°€) μ„€μ •λœ 경우 Attributes을(λ₯Ό) ν¬ν•¨ν•©λ‹ˆλ‹€. UpdateItem API μ°Έμ‘°λ₯Ό ν™•μΈν•˜μ‹­μ‹œμ˜€.

errorMessage

λ¬Έμžμ—΄

μ‹€νŒ¨ μ‹œ 였λ₯˜ λ©”μ‹œμ§€μž…λ‹ˆλ‹€.

μ˜ˆμ‹œ

name: update-dynamodb-item
description: Update the status of an order in DynamoDB
steps:
- name: updateOrderStatus
type: action
action: aws.dynamodb.updateItem
version: '1'
inputs:
awsRoleArn: ${{ :secrets:awsRoleArn }}
region: us-east-2
tableName: Orders
key:
orderId: { "S": "123" }
updateExpression: 'SET #s = :status'
expressionAttributeNames:
'#s': status
expressionAttributeValues:
':status': { "S": "SHIPPED" }
parameters:
ReturnValues: UPDATED_NEW
selectors:
- name: attributes
expression: '.response.Attributes'
next: end

ν•­λͺ© μ‚­μ œ

μž‘μ—… μ‹λ³„μžλŠ” aws.dynamodb.deleteItemμž…λ‹ˆλ‹€.

κΈ°λ³Έ ν‚€λ₯Ό μ‚¬μš©ν•˜μ—¬ DynamoDB ν…Œμ΄λΈ”μ—μ„œ 단일 ν•­λͺ©μ„ μ‚­μ œν•©λ‹ˆλ‹€.

λ‹€μŒ ν‘œμ—μ„œλŠ” 이 μž‘μ—…μ˜ μž…λ ₯ ν•„λ“œλ₯Ό μ„€λͺ…ν•©λ‹ˆλ‹€.

μž…λ ₯

μœ ν˜•

μ„€λͺ…

μ˜ˆμ‹œ

region

λ¬Έμžμ—΄

ν•„μˆ˜ ν•­λͺ©μž…λ‹ˆλ‹€. νƒ€κ²Ÿ ν…Œμ΄λΈ”μ˜ AWS λ¦¬μ „μž…λ‹ˆλ‹€.

us-east-2

tableName

λ¬Έμžμ—΄

ν•„μˆ˜ ν•­λͺ©μž…λ‹ˆλ‹€. DynamoDB ν…Œμ΄λΈ”μ˜ μ΄λ¦„μž…λ‹ˆλ‹€.

Orders

key

지도

ν•„μˆ˜ ν•­λͺ©μž…λ‹ˆλ‹€. ν•˜μœ„ μˆ˜μ€€ AttributeValue ν˜•μ‹μœΌλ‘œ 된, μ‚­μ œν•  ν•­λͺ©μ˜ κΈ°λ³Έ ν‚€μž…λ‹ˆλ‹€.

{"orderId": {"S": "123"}}

awsRoleArn

λ¬Έμžμ—΄

선택 사항. AWS API ν˜ΈμΆœμ„ μœ„ν•΄ μˆ˜μž„ν•  IAM μ—­ν•  ARNμž…λ‹ˆλ‹€.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

λ¬Έμžμ—΄

선택 사항. AWS μ•‘μ„ΈμŠ€ ν‚€ IDμž…λ‹ˆλ‹€. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

λ¬Έμžμ—΄

선택 사항. AWS λΉ„λ°€ μ•‘μ„ΈμŠ€ ν‚€μž…λ‹ˆλ‹€. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

λ¬Έμžμ—΄

선택 사항. STS 인증을 μœ„ν•œ μž„μ‹œ μ„Έμ…˜ 토큰. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsSessionToken }}

conditionExpression

λ¬Έμžμ—΄

선택 ν•­λͺ©μž…λ‹ˆλ‹€. DeleteItem이(κ°€) μ„±κ³΅ν•˜κΈ° μœ„ν•΄ μΆ©μ‘±ν•΄μ•Ό ν•˜λŠ” μ‘°κ±΄μž…λ‹ˆλ‹€.

attribute_exists(orderId)

expressionAttributeNames

지도

선택 ν•­λͺ©μž…λ‹ˆλ‹€. ν‘œν˜„μ‹ λ‚΄ 속성 이름에 λŒ€ν•œ λŒ€μ²΄ ν† ν°μž…λ‹ˆλ‹€.

{"#n": "name"}

expressionAttributeValues

지도

선택 ν•­λͺ©μž…λ‹ˆλ‹€. ν•˜μœ„ μˆ˜μ€€ AttributeValue ν˜•μ‹μ˜ ν‘œν˜„μ‹μ— λŒ€ν•œ λŒ€μ²΄ κ°’μž…λ‹ˆλ‹€.

{":id": {"S": "123"}}

parameters

지도

선택 ν•­λͺ©μž…λ‹ˆλ‹€. μœ„μ—μ„œ λͺ¨λΈλ§λ˜μ§€ μ•Šμ€ λͺ¨λ“  delete_item ν•„λ“œμ— λŒ€ν•œ νŒ¨μŠ€μŠ€λ£¨μž…λ‹ˆλ‹€. 곡톡 κ°’: ReturnValues (κΈ°λ³Έκ°’ NONE | ALL_OLD). DeleteItem API μ°Έμ‘°λ₯Ό ν™•μΈν•˜μ‹­μ‹œμ˜€.

{"ReturnValues": "ALL_OLD"}

selectors

λͺ©λ‘

선택 사항. μž‘μ—… 좜λ ₯μ—μ„œ νŠΉμ • ν•„λ“œλ₯Ό μΆ”μΆœν•˜κΈ° μœ„ν•œ JQ μ„ νƒμžμž…λ‹ˆλ‹€.

[{"name": "attributes", "expression": ".response.Attributes"}]

λ‹€μŒ ν‘œλŠ” 이 μž‘μ—…μ˜ 좜λ ₯ ν•„λ“œλ₯Ό μ„€λͺ…ν•©λ‹ˆλ‹€.

μ‚°μΆœ

μœ ν˜•

μ˜ˆμ‹œ

success

λΆ€μšΈ

true λ˜λŠ” false

response

물체

ReturnValues이(κ°€) parameters을(λ₯Ό) 톡해 μ„€μ •λœ 경우 Attributes을(λ₯Ό) ν¬ν•¨ν•©λ‹ˆλ‹€. DeleteItem API μ°Έμ‘°λ₯Ό ν™•μΈν•˜μ‹­μ‹œμ˜€.

errorMessage

λ¬Έμžμ—΄

μ‹€νŒ¨ μ‹œ 였λ₯˜ λ©”μ‹œμ§€μž…λ‹ˆλ‹€.

μ˜ˆμ‹œ

name: delete-dynamodb-item
description: Delete an order item from DynamoDB
steps:
- name: deleteOrderItem
type: action
action: aws.dynamodb.deleteItem
version: '1'
inputs:
awsRoleArn: ${{ :secrets:awsRoleArn }}
region: us-east-2
tableName: Orders
key:
orderId: { "S": "123" }
next: end

ν…Œμ΄λΈ” μŠ€μΊ”

μž‘μ—… μ‹λ³„μžλŠ” aws.dynamodb.scanμž…λ‹ˆλ‹€.

선택적 필터링을 μ‚¬μš©ν•˜μ—¬ 전체 ν…Œμ΄λΈ”μ„ μŠ€μΊ”ν•¨μœΌλ‘œμ¨ DynamoDB ν…Œμ΄λΈ” λ˜λŠ” μΈλ±μŠ€μ—μ„œ ν•­λͺ©μ„ λ°˜ν™˜ν•©λ‹ˆλ‹€. 단일 μŠ€μΊ” 응닡은 μ›Œν¬ν”Œλ‘œμš° μžλ™ν™”μ— μ˜ν•΄ 100KB둜 μ œν•œλ©λ‹ˆλ‹€(DynamoDB 자체 ν•œλ„λŠ” 1MBμž…λ‹ˆλ‹€). λŒ€κ·œλͺ¨ ν…Œμ΄λΈ”μ˜ νŽ˜μ΄μ§€λ₯Ό λ§€κΈ°λ €λ©΄ limit 및 exclusiveStartKey을(λ₯Ό) μ‚¬μš©ν•˜μ‹­μ‹œμ˜€.

μ€‘μš”

μ›Œν¬ν”Œλ‘œμš° μžλ™ν™”λŠ” μ•‘μ…˜λ‹Ή 100KB의 좜λ ₯ 크기 μ œν•œμ„ μ μš©ν•©λ‹ˆλ‹€. aws.dynamodb.scan은(λŠ”) 응닡이 이 μ œν•œμ„ μ΄ˆκ³Όν•  λ•Œ DynamoDB 자체의 응닡당 1MB μ œν•œ 내에 μžˆλ”λΌλ„ 좜λ ₯ 크기 μ œν•œ 초과 μ˜ˆμ™Έλ₯Ό λ°œμƒμ‹œν‚΅λ‹ˆλ‹€. κ²°κ³Όλ₯Ό νŽ˜μ΄μ§€λ‘œ λ‚˜λˆ„κ³  이 μ œν•œμ„ μœ μ§€ν•˜λ €λ©΄ limit 및 exclusiveStartKey을(λ₯Ό) μ‚¬μš©ν•˜μ‹­μ‹œμ˜€.

λ‹€μŒ ν‘œμ—μ„œλŠ” 이 μž‘μ—…μ˜ μž…λ ₯ ν•„λ“œλ₯Ό μ„€λͺ…ν•©λ‹ˆλ‹€.

μž…λ ₯

μœ ν˜•

μ„€λͺ…

μ˜ˆμ‹œ

region

λ¬Έμžμ—΄

ν•„μˆ˜ ν•­λͺ©μž…λ‹ˆλ‹€. νƒ€κ²Ÿ ν…Œμ΄λΈ”μ˜ AWS λ¦¬μ „μž…λ‹ˆλ‹€.

us-east-2

tableName

λ¬Έμžμ—΄

ν•„μˆ˜ ν•­λͺ©μž…λ‹ˆλ‹€. DynamoDB ν…Œμ΄λΈ”μ˜ μ΄λ¦„μž…λ‹ˆλ‹€.

Orders

awsRoleArn

λ¬Έμžμ—΄

선택 사항. AWS API ν˜ΈμΆœμ„ μœ„ν•΄ μˆ˜μž„ν•  IAM μ—­ν•  ARNμž…λ‹ˆλ‹€.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

λ¬Έμžμ—΄

선택 사항. AWS μ•‘μ„ΈμŠ€ ν‚€ IDμž…λ‹ˆλ‹€. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

λ¬Έμžμ—΄

선택 사항. AWS λΉ„λ°€ μ•‘μ„ΈμŠ€ ν‚€μž…λ‹ˆλ‹€. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

λ¬Έμžμ—΄

선택 사항. STS 인증을 μœ„ν•œ μž„μ‹œ μ„Έμ…˜ 토큰. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsSessionToken }}

indexName

λ¬Έμžμ—΄

선택 ν•­λͺ©μž…λ‹ˆλ‹€. κΈ°λ³Έ ν…Œμ΄λΈ” λŒ€μ‹  μŠ€μΊ”ν•  둜컬 λ˜λŠ” κΈ€λ‘œλ²Œ 보쑰 인덱슀의 μ΄λ¦„μž…λ‹ˆλ‹€.

my-gsi

filterExpression

λ¬Έμžμ—΄

선택 ν•­λͺ©μž…λ‹ˆλ‹€. ν•­λͺ©μ„ 읽은 ν›„ μ μš©λ˜λŠ” μ‘°κ±΄μž…λ‹ˆλ‹€. ν•„ν„°λ§λœ ν•­λͺ©μ€ λ°˜ν™˜λ˜μ§€ μ•Šμ§€λ§Œ μ—¬μ „νžˆ 읽기 μš©λŸ‰μ„ μ†ŒλΉ„ν•©λ‹ˆλ‹€.

#s = :status

projectionExpression

λ¬Έμžμ—΄

선택 ν•­λͺ©μž…λ‹ˆλ‹€. μ‰Όν‘œλ‘œ κ΅¬λΆ„λœ 검색할 속성 λͺ©λ‘μž…λ‹ˆλ‹€. μƒλž΅ν•˜λ©΄ λͺ¨λ“  속성이 λ°˜ν™˜λ©λ‹ˆλ‹€.

id, #n

expressionAttributeNames

지도

선택 ν•­λͺ©μž…λ‹ˆλ‹€. ν‘œν˜„μ‹ λ‚΄ 속성 이름에 λŒ€ν•œ λŒ€μ²΄ ν† ν°μž…λ‹ˆλ‹€.

{"#s": "status"}

expressionAttributeValues

지도

선택 ν•­λͺ©μž…λ‹ˆλ‹€. ν•˜μœ„ μˆ˜μ€€ AttributeValue ν˜•μ‹μ˜ ν‘œν˜„μ‹μ— λŒ€ν•œ λŒ€μ²΄ κ°’μž…λ‹ˆλ‹€.

{":status": {"S": "ACTIVE"}}

select

λ¬Έμžμ—΄

선택 ν•­λͺ©μž…λ‹ˆλ‹€. λ°˜ν™˜ν•  μ†μ„±μž…λ‹ˆλ‹€. ν—ˆμš©λ˜λŠ” κ°’: ALL_ATTRIBUTES, ALL_PROJECTED_ATTRIBUTES, SPECIFIC_ATTRIBUTES, COUNT.

ALL_ATTRIBUTES

limit

μ •μˆ˜

선택 ν•­λͺ©μž…λ‹ˆλ‹€. 평가할 μ΅œλŒ€ ν•­λͺ© μˆ˜μž…λ‹ˆλ‹€(λ°˜λ“œμ‹œ λ°˜ν™˜λ˜λŠ” ν•­λͺ©μ€ μ•„λ‹˜). μ΅œμ†Œ: 1.

100

consistentRead

λΆ€μšΈ

선택 ν•­λͺ©μž…λ‹ˆλ‹€. true인 경우, κ°•λ ₯ν•œ μΌκ΄€λœ 읽기λ₯Ό μ‚¬μš©ν•©λ‹ˆλ‹€. κΈ€λ‘œλ²Œ 보쑰 μΈλ±μŠ€μ—μ„œλŠ” μ§€μ›λ˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€. κΈ°λ³Έκ°’: false.

false

exclusiveStartKey

지도

선택 ν•­λͺ©μž…λ‹ˆλ‹€. 평가할 첫 번째 ν•­λͺ©μ˜ κΈ°λ³Έ ν‚€μž…λ‹ˆλ‹€. νŽ˜μ΄μ§€λ₯Ό λ§€κΈ°λ €λ©΄ 이전 μŠ€μΊ”μ˜ LastEvaluatedKey을(λ₯Ό) μ‚¬μš©ν•˜μ‹­μ‹œμ˜€.

{"orderId": {"S": "123"}}

totalSegments

μ •μˆ˜

선택 ν•­λͺ©μž…λ‹ˆλ‹€. 병렬 μŠ€μΊ”μ„ μœ„ν•œ 총 μ„Έκ·Έλ¨ΌνŠΈ μˆ˜μž…λ‹ˆλ‹€. segment와(κ³Ό) ν•¨κ»˜ μ‚¬μš©ν•΄μ•Ό ν•©λ‹ˆλ‹€. ν—ˆμš© λ²”μœ„: 1~1,000,000.

4

segment

μ •μˆ˜

선택 ν•­λͺ©μž…λ‹ˆλ‹€. 병렬 μŠ€μΊ”μ„ μœ„ν•œ 0 기반 μ„Έκ·Έλ¨ΌνŠΈ IDμž…λ‹ˆλ‹€. totalSegments와(κ³Ό) ν•¨κ»˜ μ‚¬μš©ν•΄μ•Ό ν•©λ‹ˆλ‹€.

0

parameters

지도

선택 ν•­λͺ©μž…λ‹ˆλ‹€. μœ„μ—μ„œ λͺ¨λΈλ§λ˜μ§€ μ•Šμ€ λͺ¨λ“  scan ν•„λ“œμ— λŒ€ν•œ νŒ¨μŠ€μŠ€λ£¨μž…λ‹ˆλ‹€. Scan API μ°Έμ‘°λ₯Ό ν™•μΈν•˜μ‹­μ‹œμ˜€.

{"ReturnConsumedCapacity": "TOTAL"}

selectors

λͺ©λ‘

선택 사항. μž‘μ—… 좜λ ₯μ—μ„œ νŠΉμ • ν•„λ“œλ₯Ό μΆ”μΆœν•˜κΈ° μœ„ν•œ JQ μ„ νƒμžμž…λ‹ˆλ‹€.

[{"name": "items", "expression": ".response.Items"}]

λ‹€μŒ ν‘œλŠ” 이 μž‘μ—…μ˜ 좜λ ₯ ν•„λ“œλ₯Ό μ„€λͺ…ν•©λ‹ˆλ‹€.

μ‚°μΆœ

μœ ν˜•

μ˜ˆμ‹œ

success

λΆ€μšΈ

true λ˜λŠ” false

response

물체

Items (μΌμΉ˜ν•˜λŠ” ν•­λͺ©) 및 LastEvaluatedKey (더 λ§Žμ€ νŽ˜μ΄μ§€κ°€ μ‘΄μž¬ν•  λ•Œ ν‘œμ‹œλ¨)을(λ₯Ό) ν¬ν•¨ν•©λ‹ˆλ‹€. Scan API μ°Έμ‘°λ₯Ό ν™•μΈν•˜μ‹­μ‹œμ˜€.

errorMessage

λ¬Έμžμ—΄

μ‹€νŒ¨ μ‹œ 였λ₯˜ λ©”μ‹œμ§€μž…λ‹ˆλ‹€.

μ˜ˆμ‹œ

name: scan-dynamodb-table
description: Scan for active orders in DynamoDB
steps:
- name: scanActiveOrders
type: action
action: aws.dynamodb.scan
version: '1'
inputs:
awsRoleArn: ${{ :secrets:awsRoleArn }}
region: us-east-2
tableName: Orders
filterExpression: '#s = :status'
expressionAttributeNames:
'#s': status
expressionAttributeValues:
':status': { "S": "ACTIVE" }
limit: 50
selectors:
- name: items
expression: '.response.Items'
- name: lastKey
expression: '.response.LastEvaluatedKey'
next: end

ν…Œμ΄λΈ” 쿼리

μž‘μ—… μ‹λ³„μžλŠ” aws.dynamodb.queryμž…λ‹ˆλ‹€.

νŒŒν‹°μ…˜ 킀와 μΌμΉ˜ν•˜λŠ” DynamoDB ν…Œμ΄λΈ” λ˜λŠ” 인덱슀의 ν•­λͺ©μ„ λ°˜ν™˜ν•˜λ©°, μ„ νƒμ μœΌλ‘œ μ •λ ¬ ν‚€ 쑰건 λ˜λŠ” ν•„ν„° ν‘œν˜„μ‹μœΌλ‘œ λ²”μœ„λ₯Ό 쒁힐 수 μžˆμŠ΅λ‹ˆλ‹€. ν‚€ 기반 쑰회의 경우 μŠ€μΊ”λ³΄λ‹€ 더 νš¨μœ¨μ μž…λ‹ˆλ‹€.

μ€‘μš”

μ›Œν¬ν”Œλ‘œμš° μžλ™ν™”λŠ” μ•‘μ…˜λ‹Ή 100KB의 좜λ ₯ 크기 μ œν•œμ„ μ μš©ν•©λ‹ˆλ‹€. aws.dynamodb.query은(λŠ”) 응닡이 이 μ œν•œμ„ μ΄ˆκ³Όν•  λ•Œ DynamoDB 자체의 응닡당 1MB μ œν•œ 내에 μžˆλ”λΌλ„ 좜λ ₯ 크기 μ œν•œ 초과 μ˜ˆμ™Έλ₯Ό λ°œμƒμ‹œν‚΅λ‹ˆλ‹€. κ²°κ³Όλ₯Ό νŽ˜μ΄μ§€λ‘œ λ‚˜λˆ„κ³  이 μ œν•œμ„ μœ μ§€ν•˜λ €λ©΄ limit 및 exclusiveStartKey을(λ₯Ό) μ‚¬μš©ν•˜μ‹­μ‹œμ˜€.

λ‹€μŒ ν‘œμ—μ„œλŠ” 이 μž‘μ—…μ˜ μž…λ ₯ ν•„λ“œλ₯Ό μ„€λͺ…ν•©λ‹ˆλ‹€.

μž…λ ₯

μœ ν˜•

μ„€λͺ…

μ˜ˆμ‹œ

region

λ¬Έμžμ—΄

ν•„μˆ˜ ν•­λͺ©μž…λ‹ˆλ‹€. νƒ€κ²Ÿ ν…Œμ΄λΈ”μ˜ AWS λ¦¬μ „μž…λ‹ˆλ‹€.

us-east-2

tableName

λ¬Έμžμ—΄

ν•„μˆ˜ ν•­λͺ©μž…λ‹ˆλ‹€. DynamoDB ν…Œμ΄λΈ”μ˜ μ΄λ¦„μž…λ‹ˆλ‹€.

Orders

awsRoleArn

λ¬Έμžμ—΄

선택 사항. AWS API ν˜ΈμΆœμ„ μœ„ν•΄ μˆ˜μž„ν•  IAM μ—­ν•  ARNμž…λ‹ˆλ‹€.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

λ¬Έμžμ—΄

선택 사항. AWS μ•‘μ„ΈμŠ€ ν‚€ IDμž…λ‹ˆλ‹€. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

λ¬Έμžμ—΄

선택 사항. AWS λΉ„λ°€ μ•‘μ„ΈμŠ€ ν‚€μž…λ‹ˆλ‹€. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

λ¬Έμžμ—΄

선택 사항. STS 인증을 μœ„ν•œ μž„μ‹œ μ„Έμ…˜ 토큰. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsSessionToken }}

indexName

λ¬Έμžμ—΄

선택 ν•­λͺ©μž…λ‹ˆλ‹€. 쿼리할 둜컬 λ˜λŠ” κΈ€λ‘œλ²Œ 보쑰 인덱슀의 μ΄λ¦„μž…λ‹ˆλ‹€.

customerId-index

keyConditionExpression

λ¬Έμžμ—΄

선택 ν•­λͺ©μž…λ‹ˆλ‹€. νŒŒν‹°μ…˜ ν‚€(ν•„μˆ˜) 및 μ„ νƒμ μœΌλ‘œ μ •λ ¬ 킀에 λŒ€ν•œ μ‘°κ±΄μž…λ‹ˆλ‹€.

customerId = :cid

filterExpression

λ¬Έμžμ—΄

선택 ν•­λͺ©μž…λ‹ˆλ‹€. ν•­λͺ©μ„ 읽은 ν›„ μ μš©λ˜λŠ” μ‘°κ±΄μž…λ‹ˆλ‹€. ν‚€ 속성을 μ°Έμ‘°ν•  수 μ—†μŠ΅λ‹ˆλ‹€. ν•„ν„°λ§λœ ν•­λͺ©μ€ λ°˜ν™˜λ˜μ§€ μ•Šμ§€λ§Œ μ—¬μ „νžˆ 읽기 μš©λŸ‰μ„ μ†ŒλΉ„ν•©λ‹ˆλ‹€.

#s = :status

projectionExpression

λ¬Έμžμ—΄

선택 ν•­λͺ©μž…λ‹ˆλ‹€. μ‰Όν‘œλ‘œ κ΅¬λΆ„λœ 검색할 속성 λͺ©λ‘μž…λ‹ˆλ‹€.

id, #n

expressionAttributeNames

지도

선택 ν•­λͺ©μž…λ‹ˆλ‹€. ν‘œν˜„μ‹ λ‚΄ 속성 이름에 λŒ€ν•œ λŒ€μ²΄ ν† ν°μž…λ‹ˆλ‹€.

{"#s": "status"}

expressionAttributeValues

지도

선택 ν•­λͺ©μž…λ‹ˆλ‹€. ν•˜μœ„ μˆ˜μ€€ AttributeValue ν˜•μ‹μ˜ ν‘œν˜„μ‹μ— λŒ€ν•œ λŒ€μ²΄ κ°’μž…λ‹ˆλ‹€.

{":cid": {"S": "cust-1"}}

select

λ¬Έμžμ—΄

선택 ν•­λͺ©μž…λ‹ˆλ‹€. λ°˜ν™˜ν•  μ†μ„±μž…λ‹ˆλ‹€. ν—ˆμš©λ˜λŠ” κ°’: ALL_ATTRIBUTES, ALL_PROJECTED_ATTRIBUTES, SPECIFIC_ATTRIBUTES, COUNT.

ALL_ATTRIBUTES

limit

μ •μˆ˜

선택 ν•­λͺ©μž…λ‹ˆλ‹€. 평가할 μ΅œλŒ€ ν•­λͺ© μˆ˜μž…λ‹ˆλ‹€. μ΅œμ†Œ: 1.

100

scanIndexForward

λΆ€μšΈ

선택 ν•­λͺ©μž…λ‹ˆλ‹€. true (κΈ°λ³Έκ°’)인 경우, κ²°κ³Όλ₯Ό μ •λ ¬ ν‚€ μ˜€λ¦„μ°¨μˆœμœΌλ‘œ λ°˜ν™˜ν•©λ‹ˆλ‹€. false인 경우, λ‚΄λ¦Όμ°¨μˆœμœΌλ‘œ λ°˜ν™˜ν•©λ‹ˆλ‹€.

true

consistentRead

λΆ€μšΈ

선택 ν•­λͺ©μž…λ‹ˆλ‹€. true인 경우, κ°•λ ₯ν•œ μΌκ΄€λœ 읽기λ₯Ό μ‚¬μš©ν•©λ‹ˆλ‹€. κΈ€λ‘œλ²Œ 보쑰 μΈλ±μŠ€μ—μ„œλŠ” μ§€μ›λ˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€. κΈ°λ³Έκ°’: false.

false

exclusiveStartKey

지도

선택 ν•­λͺ©μž…λ‹ˆλ‹€. 평가할 첫 번째 ν•­λͺ©μ˜ κΈ°λ³Έ ν‚€μž…λ‹ˆλ‹€. νŽ˜μ΄μ§€λ₯Ό λ‚˜λˆ„λ €λ©΄ 이전 쿼리의 LastEvaluatedKey을(λ₯Ό) μ‚¬μš©ν•˜μ‹­μ‹œμ˜€.

{"orderId": {"S": "123"}}

parameters

지도

선택 ν•­λͺ©μž…λ‹ˆλ‹€. μœ„μ—μ„œ λͺ¨λΈλ§λ˜μ§€ μ•Šμ€ λͺ¨λ“  query ν•„λ“œμ— λŒ€ν•œ νŒ¨μŠ€μŠ€λ£¨μž…λ‹ˆλ‹€. 쿼리 API μ°Έμ‘°λ₯Ό μ°Έμ‘°ν•˜μ‹­μ‹œμ˜€.

{"ReturnConsumedCapacity": "TOTAL"}

selectors

λͺ©λ‘

선택 사항. μž‘μ—… 좜λ ₯μ—μ„œ νŠΉμ • ν•„λ“œλ₯Ό μΆ”μΆœν•˜κΈ° μœ„ν•œ JQ μ„ νƒμžμž…λ‹ˆλ‹€.

[{"name": "items", "expression": ".response.Items"}]

λ‹€μŒ ν‘œλŠ” 이 μž‘μ—…μ˜ 좜λ ₯ ν•„λ“œλ₯Ό μ„€λͺ…ν•©λ‹ˆλ‹€.

μ‚°μΆœ

μœ ν˜•

μ˜ˆμ‹œ

success

λΆ€μšΈ

true λ˜λŠ” false

response

물체

Items (μΌμΉ˜ν•˜λŠ” ν•­λͺ©) 및 LastEvaluatedKey (더 λ§Žμ€ νŽ˜μ΄μ§€κ°€ μ‘΄μž¬ν•  λ•Œ ν‘œμ‹œλ¨)을(λ₯Ό) ν¬ν•¨ν•©λ‹ˆλ‹€. 쿼리 API μ°Έμ‘°λ₯Ό ν™•μΈν•˜μ‹­μ‹œμ˜€.

errorMessage

λ¬Έμžμ—΄

μ‹€νŒ¨ μ‹œ 였λ₯˜ λ©”μ‹œμ§€μž…λ‹ˆλ‹€.

μ˜ˆμ‹œ

name: query-dynamodb-table
description: Query orders by customer ID
steps:
- name: queryCustomerOrders
type: action
action: aws.dynamodb.query
version: '1'
inputs:
awsRoleArn: ${{ :secrets:awsRoleArn }}
region: us-east-2
tableName: Orders
indexName: customerId-index
keyConditionExpression: 'customerId = :cid'
expressionAttributeValues:
':cid': { "S": "cust-1" }
selectors:
- name: items
expression: '.response.Items'
next: end

ν…Œμ΄λΈ” μ„€λͺ…

μž‘μ—… μ‹λ³„μžλŠ” aws.dynamodb.describeTableμž…λ‹ˆλ‹€.

μƒνƒœ, κΈ°λ³Έ ν‚€ μŠ€ν‚€λ§ˆ, ν”„λ‘œλΉ„μ €λ‹λœ μ²˜λ¦¬λŸ‰ 및 (κΈ€λ‘œλ²Œ ν…Œμ΄λΈ”μ˜ 경우) 볡제본 μƒνƒœλ₯Ό ν¬ν•¨ν•œ ν…Œμ΄λΈ” 정보λ₯Ό λ°˜ν™˜ν•©λ‹ˆλ‹€.

λ‹€μŒ ν‘œμ—μ„œλŠ” 이 μž‘μ—…μ˜ μž…λ ₯ ν•„λ“œλ₯Ό μ„€λͺ…ν•©λ‹ˆλ‹€.

μž…λ ₯

μœ ν˜•

μ„€λͺ…

μ˜ˆμ‹œ

region

λ¬Έμžμ—΄

ν•„μˆ˜ ν•­λͺ©μž…λ‹ˆλ‹€. νƒ€κ²Ÿ ν…Œμ΄λΈ”μ˜ AWS λ¦¬μ „μž…λ‹ˆλ‹€.

us-east-2

tableName

λ¬Έμžμ—΄

ν•„μˆ˜ ν•­λͺ©μž…λ‹ˆλ‹€. DynamoDB ν…Œμ΄λΈ”μ˜ μ΄λ¦„μž…λ‹ˆλ‹€.

Orders

awsRoleArn

λ¬Έμžμ—΄

선택 사항. AWS API ν˜ΈμΆœμ„ μœ„ν•΄ μˆ˜μž„ν•  IAM μ—­ν•  ARNμž…λ‹ˆλ‹€.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

λ¬Έμžμ—΄

선택 사항. AWS μ•‘μ„ΈμŠ€ ν‚€ IDμž…λ‹ˆλ‹€. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

λ¬Έμžμ—΄

선택 사항. AWS λΉ„λ°€ μ•‘μ„ΈμŠ€ ν‚€μž…λ‹ˆλ‹€. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

λ¬Έμžμ—΄

선택 사항. STS 인증을 μœ„ν•œ μž„μ‹œ μ„Έμ…˜ 토큰. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsSessionToken }}

selectors

λͺ©λ‘

선택 사항. μž‘μ—… 좜λ ₯μ—μ„œ νŠΉμ • ν•„λ“œλ₯Ό μΆ”μΆœν•˜κΈ° μœ„ν•œ JQ μ„ νƒμžμž…λ‹ˆλ‹€.

[{"name": "tableStatus", "expression": ".response.Table.TableStatus"}]

λ‹€μŒ ν‘œλŠ” 이 μž‘μ—…μ˜ 좜λ ₯ ν•„λ“œλ₯Ό μ„€λͺ…ν•©λ‹ˆλ‹€.

μ‚°μΆœ

μœ ν˜•

μ˜ˆμ‹œ

success

λΆ€μšΈ

true λ˜λŠ” false

response

물체

κΈ€λ‘œλ²Œ ν…Œμ΄λΈ”μ— λŒ€ν•œ TableStatus, KeySchema, ProvisionedThroughput 및 Replicas와(κ³Ό) ν•¨κ»˜ Table을(λ₯Ό) ν¬ν•¨ν•©λ‹ˆλ‹€. DescribeTable API μ°Έμ‘°λ₯Ό ν™•μΈν•˜μ‹­μ‹œμ˜€.

errorMessage

λ¬Έμžμ—΄

μ‹€νŒ¨ μ‹œ 였λ₯˜ λ©”μ‹œμ§€μž…λ‹ˆλ‹€.

μ˜ˆμ‹œ

name: describe-dynamodb-table
description: Get the status and configuration of a DynamoDB table
steps:
- name: describeOrdersTable
type: action
action: aws.dynamodb.describeTable
version: '1'
inputs:
awsRoleArn: ${{ :secrets:awsRoleArn }}
region: us-east-2
tableName: Orders
selectors:
- name: tableStatus
expression: '.response.Table.TableStatus'
next: end

ν…Œμ΄λΈ” λͺ©λ‘

μž‘μ—… μ‹λ³„μžλŠ” aws.dynamodb.listTablesμž…λ‹ˆλ‹€.

ν˜„μž¬ AWS 계정 및 λ¦¬μ „μ˜ DynamoDB ν…Œμ΄λΈ” 이름 λͺ©λ‘μ„ λ°˜ν™˜ν•©λ‹ˆλ‹€. κ²°κ³ΌλŠ” νŽ˜μ΄μ§€ λ‹¨μœ„λ‘œ μ œκ³΅λ©λ‹ˆλ‹€ β€” κ²°κ³Όλ₯Ό νŽ˜μ΄μ§€ λ‹¨μœ„λ‘œ νƒμƒ‰ν•˜λ €λ©΄ 이전 μ‘λ‹΅μ˜ LastEvaluatedTableName와(κ³Ό) ν•¨κ»˜ exclusiveStartTableName을(λ₯Ό) μ‚¬μš©ν•˜μ‹­μ‹œμ˜€.

λ‹€μŒ ν‘œμ—μ„œλŠ” 이 μž‘μ—…μ˜ μž…λ ₯ ν•„λ“œλ₯Ό μ„€λͺ…ν•©λ‹ˆλ‹€.

μž…λ ₯

μœ ν˜•

μ„€λͺ…

μ˜ˆμ‹œ

region

λ¬Έμžμ—΄

ν•„μˆ˜ ν•­λͺ©μž…λ‹ˆλ‹€. ν…Œμ΄λΈ”μ„ λ‚˜μ—΄ν•  AWS λ¦¬μ „μž…λ‹ˆλ‹€.

us-east-2

awsRoleArn

λ¬Έμžμ—΄

선택 사항. AWS API ν˜ΈμΆœμ„ μœ„ν•΄ μˆ˜μž„ν•  IAM μ—­ν•  ARNμž…λ‹ˆλ‹€.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

λ¬Έμžμ—΄

선택 사항. AWS μ•‘μ„ΈμŠ€ ν‚€ IDμž…λ‹ˆλ‹€. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

λ¬Έμžμ—΄

선택 사항. AWS λΉ„λ°€ μ•‘μ„ΈμŠ€ ν‚€μž…λ‹ˆλ‹€. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

λ¬Έμžμ—΄

선택 사항. STS 인증을 μœ„ν•œ μž„μ‹œ μ„Έμ…˜ 토큰. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsSessionToken }}

exclusiveStartTableName

λ¬Έμžμ—΄

선택 ν•­λͺ©μž…λ‹ˆλ‹€. 평가할 첫 번째 ν…Œμ΄λΈ” μ΄λ¦„μž…λ‹ˆλ‹€. νŽ˜μ΄μ§€λ₯Ό λ§€κΈ°λ €λ©΄ 이전 μ‘λ‹΅μ˜ LastEvaluatedTableName을(λ₯Ό) μ‚¬μš©ν•˜μ‹­μ‹œμ˜€.

my-table

limit

μ •μˆ˜

선택 ν•­λͺ©μž…λ‹ˆλ‹€. λ°˜ν™˜ν•  ν…Œμ΄λΈ” μ΄λ¦„μ˜ μ΅œλŒ€ μˆ˜μž…λ‹ˆλ‹€(1-100). κΈ°λ³Έ: 100.

50

selectors

λͺ©λ‘

선택 사항. μž‘μ—… 좜λ ₯μ—μ„œ νŠΉμ • ν•„λ“œλ₯Ό μΆ”μΆœν•˜κΈ° μœ„ν•œ JQ μ„ νƒμžμž…λ‹ˆλ‹€.

[{"name": "tableNames", "expression": ".response.TableNames"}]

λ‹€μŒ ν‘œλŠ” 이 μž‘μ—…μ˜ 좜λ ₯ ν•„λ“œλ₯Ό μ„€λͺ…ν•©λ‹ˆλ‹€.

μ‚°μΆœ

μœ ν˜•

μ˜ˆμ‹œ

success

λΆ€μšΈ

true λ˜λŠ” false

response

물체

μΆ”κ°€ νŽ˜μ΄μ§€κ°€ μ‘΄μž¬ν•  λ•Œ TableNames (ν…Œμ΄λΈ” 이름 λ¬Έμžμ—΄ λͺ©λ‘) 및 LastEvaluatedTableName을(λ₯Ό) ν¬ν•¨ν•©λ‹ˆλ‹€. ListTables API μ°Έμ‘°λ₯Ό ν™•μΈν•˜μ‹­μ‹œμ˜€.

errorMessage

λ¬Έμžμ—΄

μ‹€νŒ¨ μ‹œ 였λ₯˜ λ©”μ‹œμ§€μž…λ‹ˆλ‹€.

μ˜ˆμ‹œ

name: list-dynamodb-tables
description: List all DynamoDB tables in a region
steps:
- name: listDynamoTables
type: action
action: aws.dynamodb.listTables
version: '1'
inputs:
awsRoleArn: ${{ :secrets:awsRoleArn }}
region: us-east-2
selectors:
- name: tableNames
expression: '.response.TableNames'
next: end

ν…Œμ΄λΈ” μ—…λ°μ΄νŠΈ

μž‘μ—… μ‹λ³„μžλŠ” aws.dynamodb.updateTableμž…λ‹ˆλ‹€.

DynamoDB ν…Œμ΄λΈ”μ˜ ν”„λ‘œλΉ„μ €λ‹λœ μ²˜λ¦¬λŸ‰ μ„€μ •, 결제 λͺ¨λ“œ, κΈ€λ‘œλ²Œ 보쑰 인덱슀, 볡제 리전 λ˜λŠ” 기타 섀정을 μˆ˜μ •ν•©λ‹ˆλ‹€.

λ‹€μŒ ν‘œμ—μ„œλŠ” 이 μž‘μ—…μ˜ μž…λ ₯ ν•„λ“œλ₯Ό μ„€λͺ…ν•©λ‹ˆλ‹€.

μž…λ ₯

μœ ν˜•

μ„€λͺ…

μ˜ˆμ‹œ

region

λ¬Έμžμ—΄

ν•„μˆ˜ ν•­λͺ©μž…λ‹ˆλ‹€. νƒ€κ²Ÿ ν…Œμ΄λΈ”μ˜ AWS λ¦¬μ „μž…λ‹ˆλ‹€.

us-east-2

tableName

λ¬Έμžμ—΄

ν•„μˆ˜ ν•­λͺ©μž…λ‹ˆλ‹€. DynamoDB ν…Œμ΄λΈ”μ˜ μ΄λ¦„μž…λ‹ˆλ‹€.

Orders

awsRoleArn

λ¬Έμžμ—΄

선택 사항. AWS API ν˜ΈμΆœμ„ μœ„ν•΄ μˆ˜μž„ν•  IAM μ—­ν•  ARNμž…λ‹ˆλ‹€.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

λ¬Έμžμ—΄

선택 사항. AWS μ•‘μ„ΈμŠ€ ν‚€ IDμž…λ‹ˆλ‹€. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

λ¬Έμžμ—΄

선택 사항. AWS λΉ„λ°€ μ•‘μ„ΈμŠ€ ν‚€μž…λ‹ˆλ‹€. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

λ¬Έμžμ—΄

선택 사항. STS 인증을 μœ„ν•œ μž„μ‹œ μ„Έμ…˜ 토큰. μ‹œν¬λ¦ΏμœΌλ‘œ μ „λ‹¬ν•˜μ‹­μ‹œμ˜€.

${{ :secrets:awsSessionToken }}

attributeDefinitions

λͺ©λ‘

선택 ν•­λͺ©μž…λ‹ˆλ‹€. ν…Œμ΄λΈ” 및 μΈλ±μŠ€μ— λŒ€ν•œ 속성 μ •μ˜ μ–΄λ ˆμ΄μž…λ‹ˆλ‹€. μƒˆ κΈ€λ‘œλ²Œ 보쑰 인덱슀λ₯Ό μΆ”κ°€ν•  λ•Œ ν•„μš”ν•©λ‹ˆλ‹€.

[{"AttributeName": "id", "AttributeType": "S"}]

billingMode

λ¬Έμžμ—΄

선택 ν•­λͺ©μž…λ‹ˆλ‹€. μ²˜λ¦¬λŸ‰μ΄ μ²­κ΅¬λ˜λŠ” 방식을 μ œμ–΄ν•©λ‹ˆλ‹€. ν—ˆμš©λ˜λŠ” κ°’: PROVISIONED, PAY_PER_REQUEST.

PAY_PER_REQUEST

provisionedThroughput

지도

선택 ν•­λͺ©μž…λ‹ˆλ‹€. billingMode이(κ°€) PROVISIONED인 경우 ν•„μˆ˜ ν•­λͺ©μž…λ‹ˆλ‹€. billingMode이(κ°€) PAY_PER_REQUEST인 경우 μ„€μ •ν•  수 μ—†μŠ΅λ‹ˆλ‹€.

{"ReadCapacityUnits": 5, "WriteCapacityUnits": 5}

globalSecondaryIndexUpdates

λͺ©λ‘

선택 ν•­λͺ©μž…λ‹ˆλ‹€. ν•˜λ‚˜ μ΄μƒμ˜ κΈ€λ‘œλ²Œ 보쑰 인덱슀 μ—…λ°μ΄νŠΈ μž‘μ—…(생성, μ—…λ°μ΄νŠΈ λ˜λŠ” μ‚­μ œ)μž…λ‹ˆλ‹€. ν…Œμ΄λΈ”λ‹Ή μ΅œλŒ€ 20개의 GSIμž…λ‹ˆλ‹€.

[{"Update": {"IndexName": "my-gsi", "ProvisionedThroughput": {"ReadCapacityUnits": 5, "WriteCapacityUnits": 5}}}]

streamSpecification

지도

선택 ν•­λͺ©μž…λ‹ˆλ‹€. DynamoDB Streams μ„€μ •μž…λ‹ˆλ‹€.

{"StreamEnabled": true, "StreamViewType": "NEW_AND_OLD_IMAGES"}

sseSpecification

지도

선택 ν•­λͺ©μž…λ‹ˆλ‹€. μ„œλ²„ μΈ‘ μ•”ν˜Έν™” μ„€μ •μž…λ‹ˆλ‹€.

{"Enabled": true, "SSEType": "KMS"}

deletionProtectionEnabled

λΆ€μšΈ

선택 ν•­λͺ©μž…λ‹ˆλ‹€. ν…Œμ΄λΈ”μ˜ μ‚­μ œ 보호λ₯Ό ν™œμ„±ν™”ν•˜κ±°λ‚˜ λΉ„ν™œμ„±ν™”ν•©λ‹ˆλ‹€.

true

parameters

지도

선택 ν•­λͺ©μž…λ‹ˆλ‹€. μœ„μ—μ„œ λͺ¨λΈλ§λ˜μ§€ μ•Šμ€ λͺ¨λ“  update_table ν•„λ“œμ— λŒ€ν•œ νŒ¨μŠ€μŠ€λ£¨μž…λ‹ˆλ‹€. 곡톡 κ°’: ReplicaUpdates (κΈ€λ‘œλ²Œ ν…Œμ΄λΈ” 볡제본 μΆ”κ°€/제거), TableClass (STANDARD | STANDARD_INFREQUENT_ACCESS). UpdateTable API μ°Έμ‘°λ₯Ό ν™•μΈν•˜μ‹­μ‹œμ˜€.

{"ReplicaUpdates": [{"Create": {"RegionName": "eu-west-1"}}]}

selectors

λͺ©λ‘

선택 사항. μž‘μ—… 좜λ ₯μ—μ„œ νŠΉμ • ν•„λ“œλ₯Ό μΆ”μΆœν•˜κΈ° μœ„ν•œ JQ μ„ νƒμžμž…λ‹ˆλ‹€.

[{"name": "tableStatus", "expression": ".response.TableDescription.TableStatus"}]

λ‹€μŒ ν‘œλŠ” 이 μž‘μ—…μ˜ 좜λ ₯ ν•„λ“œλ₯Ό μ„€λͺ…ν•©λ‹ˆλ‹€.

μ‚°μΆœ

μœ ν˜•

μ˜ˆμ‹œ

success

λΆ€μšΈ

true λ˜λŠ” false

response

물체

TableDescription을(λ₯Ό) ν¬ν•¨ν•©λ‹ˆλ‹€. UpdateTable API μ°Έμ‘°λ₯Ό ν™•μΈν•˜μ‹­μ‹œμ˜€.

errorMessage

λ¬Έμžμ—΄

μ‹€νŒ¨ μ‹œ 였λ₯˜ λ©”μ‹œμ§€μž…λ‹ˆλ‹€.

μ˜ˆμ‹œ

name: update-dynamodb-table
description: Switch a DynamoDB table to on-demand billing
steps:
- name: setPayPerRequest
type: action
action: aws.dynamodb.updateTable
version: '1'
inputs:
awsRoleArn: ${{ :secrets:awsRoleArn }}
region: us-east-2
tableName: Orders
billingMode: PAY_PER_REQUEST
selectors:
- name: tableStatus
expression: '.response.TableDescription.TableStatus'
next: end
Copyright Β© 2026 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.