참고: 자격 증명의 설정 필드가 주어지지 않으면, 자격 증명은 환경 변수, ~/.aws/credentials, 또는 EC2 인스턴스 역할에서 가져옵니다. 자격 증명의 설정 필드가 주어지면, 주어진 설정에서 자격 증명을 가져옵니다. 자격 증명 지정을 참조하세요.
참고: Go 1.19 이상이 필요합니다
Table of Contents
Signatures
Installation
Examples
Config
Default Config
Signatures
func New(config Config) Storage
func (s *Storage) Get(key string) ([]byte, error)
func (s *Storage) Set(key string, val []byte, exp time.Duration) error
func (s *Storage) Delete(key string) error
func (s *Storage) Reset() error
func (s *Storage) Close() error
func (s *Storage) Conn() *awsdynamodb.Client
Installation
DynamoDB는 모듈을 지원하는 2개의 최신 Go 버전에서 테스트되었습니다. 아직 초기화하지 않았다면, 다음을 실행하여 먼저 초기화하세요:
go mod init github.com/<user>/<repo>
그리고 dynamodb 구현을 설치하세요:
go get github.com/gofiber/storage/dynamodb/v2
Examples
스토리지 패키지를 가져옵니다.
import "github.com/gofiber/storage/dynamodb/v2"
다음과 같은 방법으로 스토리지를 생성할 수 있습니다:
// dynamodb 초기화
store := dynamodb.New(dynamodb.Config{
})
Config
type Config struct {
// 사용할 DynamoDB 서비스의 리전입니다.
// 유효한 값: https://docs.aws.amazon.com/general/latest/gr/rande.html#ddb_region.
// 예: "us-west-2".
// 선택 사항 (설정되지 않은 경우 공유 설정 파일이나 환경 변수에서 읽음).
// 환경 변수: "AWS_REGION".
Region string
// DynamoDB 테이블의 이름입니다.
// 선택 사항 ("fiber_storage" 기본값).
Table string
// CustomEndpoint를 사용하면 사용자 정의 DynamoDB 서비스 엔드포인트를 설정할 수 있습니다.
// 이는 로컬 테스트를 위해 "DynamoDB local" Docker 컨테이너를 실행할 때 특히 유용합니다.
// Docker 컨테이너의 일반적인 값: "http://localhost:8000".
// https://hub.docker.com/r/amazon/dynamodb-local/ 참조.
// 선택 사항 ("" 기본값).
Endpoint string
// Credentials는 AWS 액세스 키와 AWS 비밀 액세스 키를 오버라이드합니다. 권장되지 않습니다.
//
// 선택 사항. 기본값은 Credentials{} 입니다.
Credentials Credentials
// 재시도 가능한 실패를 만나는 요청을 시도해야 하는 최대 횟수입니다.
//
// 선택 사항. 기본값은 3입니다.
MaxAttempts int
// Reset은 기존 Bucket의 기존 키를 모두 삭제합니다.
//
// 선택 사항. 기본값은 false입니다.
Reset bool
// 테이블의 ReadCapacityUnits입니다.
// 테이블이 아직 없고 gokv에 의해 생성될 때만 필요합니다.
// 선택 사항 (웹 콘솔에서 테이블을 생성할 때의 기본값과 동일한 5가 기본값임)
// 무료 계층에는 25 RCU가 포함됩니다 (모든 테이블에 걸쳐서).
// 계산 예는 https://github.com/awsdocs/amazon-dynamodb-developer-guide/blob/c420420a59040c5b3dd44a6e59f7c9e55fc922ef/doc_source/HowItWorks.ProvisionedThroughput 참조.
// 제한은 https://github.com/awsdocs/amazon-dynamodb-developer-guide/blob/c420420a59040c5b3dd44a6e59f7c9e55fc922ef/doc_source/Limits.md#capacity-units-and-provisioned-throughput 참조.
ReadCapacityUnits int64
// 테이블의 WriteCapacityUnits입니다.
// 테이블이 아직 없고 gokv에 의해 생성될 때만 필요합니다.
// 선택 사항 (웹 콘솔에서 테이블을 생성할 때의 기본값과 동일한 5가 기본값임)
// 무료 계층에는 25 WCU가 포함됩니다 (모든 테이블에 걸쳐서).
// 계산 예는 https://github.com/awsdocs/amazon-dynamodb-developer-guide/blob/c420420a59040c5b3dd44a6e59f7c9e55fc922ef/doc_source/HowItWorks.ProvisionedThroughput 참조.
// 제한은 https://github.com/awsdocs/amazon-dynamodb-developer-guide/blob/c420420a59040c5b3dd44a6e59f7c9e55fc922ef/doc_source/Limits.md#capacity-units-and-provisioned-throughput 참조.
WriteCapacityUnits int64
// 테이블이 아직 없는 경우, gokv가 생성합니다.
// WaitForTableCreation이 true이면, gokv는 15초의 타임아웃으로 테이블이 생성될 때까지 대기합니다.
// 15초 후에도 테이블이 존재하지 않으면 오류가 반환됩니다.
// WaitForTableCreation이 false이면, gokv는 클라이언트를 즉시 반환합니다.
// 후자의 경우 테이블이 생성되기 전에 테이블에서 읽거나 쓰면 안 되는데,
// 그렇지 않으면 ResourceNotFoundException 오류가 발생하기 때문입니다.
// 선택 사항 (기본값은 true).
WaitForTableCreation *bool
}
type Credentials struct {
AccessKey string
SecretAccessKey string
}
