리소스: 데이터베이스
Cloud Firestore 데이터베이스입니다.
JSON 표현 |
---|
{ "name": string, "uid": string, "createTime": string, "updateTime": string, "deleteTime": string, "locationId": string, "type": enum ( |
필드 | |
---|---|
name |
데이터베이스의 리소스 이름입니다. 형식: |
uid |
출력 전용입니다. 이 데이터베이스의 시스템 생성 UUID4입니다. |
createTime |
출력 전용입니다. 이 데이터베이스가 생성된 타임스탬프입니다. 2016년 이전에 생성된 데이터베이스는 createTime을 채우지 않습니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
updateTime |
출력 전용입니다. 이 데이터베이스가 가장 최근에 업데이트된 타임스탬프입니다. 여기에는 데이터베이스 리소스의 업데이트만 포함되며 데이터베이스에 포함된 데이터는 포함되지 않습니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
deleteTime |
출력 전용입니다. 이 데이터베이스가 삭제된 타임스탬프입니다. 데이터베이스가 삭제된 경우에만 설정됩니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
locationId |
데이터베이스의 위치입니다. 사용 가능한 위치는 https://cloud.google.com/firestore/docs/locations에서 확인할 수 있습니다. |
type |
데이터베이스의 유형입니다. 선택 방법에 대한 자세한 내용은 https://cloud.google.com/datastore/docs/firestore-or-datastore를 참조하세요. |
concurrencyMode |
이 데이터베이스에 사용할 동시 실행 제어 모드입니다. |
versionRetentionPeriod |
출력 전용입니다. 이전 버전의 데이터가 데이터베이스에 보관되는 기간입니다. 모든 PITR 기능이 사용 설정된 경우 보관 기간은 7일입니다. 그렇지 않은 경우 보관 기간은 1시간입니다. 소수점 아래가 최대 9자리까지이고 ' |
earliestVersionTime |
출력 전용입니다. 데이터베이스에서 이전 버전의 데이터를 읽을 수 있는 가장 이른 타임스탬프입니다. 위의 [versionRetainPeriod] 를 참고하세요. 이 필드는 이 값은 지속적으로 업데이트되며 쿼리되는 즉시 오래된 상태가 됩니다. 이 값을 사용하여 데이터를 복구하는 경우, 값이 쿼리된 순간부터 복구를 시작하는 순간까지의 기간을 고려해야 합니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
pointInTimeRecoveryEnablement |
이 데이터베이스에서 PITR 기능을 사용 설정할지 여부입니다. |
appEngineIntegrationMode |
이 데이터베이스에 사용할 App Engine 통합 모드입니다. |
keyPrefix |
출력 전용입니다. 이 데이터베이스의 keyPrefix입니다. 이 keyPrefix는 프로젝트 ID (' URL 인코딩 키에 사용할 appid는 projectId (예: v~foo 대신 foo)인 경우 이 값이 비어 있을 수 있습니다. |
deleteProtectionState |
데이터베이스의 삭제 보호 상태입니다. |
cmekConfig |
선택사항입니다. 존재는 이 데이터베이스에 CMEK가 사용 설정되었음을 나타냅니다. |
previousId |
출력 전용입니다. 데이터베이스 리소스의 이전 데이터베이스 ID입니다. 이 필드는 삭제된 데이터베이스에 대해서만 채워집니다. |
etag |
이 체크섬은 서버에서 다른 필드의 값을 기반으로 계산되며, 업데이트 및 삭제 요청 시 전송되기 전에 클라이언트가 최신 값을 유지하도록 할 수 있습니다. |
DatabaseType
데이터베이스의 유형입니다. 선택 방법에 대한 자세한 내용은 https://cloud.google.com/datastore/docs/firestore-or-datastore를 참조하세요.
데이터베이스가 비어 있는 경우에만 모드를 변경할 수 있습니다.
열거형 | |
---|---|
DATABASE_TYPE_UNSPECIFIED |
기본값입니다. 데이터베이스 유형이 생략된 경우 이 값이 사용됩니다. |
FIRESTORE_NATIVE |
Firestore Native 모드 |
DATASTORE_MODE |
Datastore 모드의 Firestore |
ConcurrencyMode
트랜잭션의 동시 실행 제어 모드 유형입니다.
열거형 | |
---|---|
CONCURRENCY_MODE_UNSPECIFIED |
사용되지 않음. |
OPTIMISTIC |
기본적으로 낙관적 동시 실행 제어를 사용합니다. Cloud Firestore 데이터베이스에 이 모드를 사용할 수 있습니다. |
PESSIMISTIC |
기본적으로 비관적 동시 실행 제어를 사용합니다. Cloud Firestore 데이터베이스에 이 모드를 사용할 수 있습니다. 이는 Cloud Firestore의 기본 설정입니다. |
OPTIMISTIC_WITH_ENTITY_GROUPS |
기본적으로 항목 그룹과 함께 낙관적 동시 실행 제어를 사용합니다. Cloud Datastore에 사용할 수 있는 유일한 모드입니다. 이 모드는 Datastore 모드의 Cloud Firestore에도 사용할 수 있지만 권장되지 않습니다. |
PointInTimeRecoveryEnablement
PITR(point-in-time recovery) 기능 사용 설정
열거형 | |
---|---|
POINT_IN_TIME_RECOVERY_ENABLEMENT_UNSPECIFIED |
사용되지 않음. |
POINT_IN_TIME_RECOVERY_ENABLED |
읽기는 지난 7일 이내의 선택한 데이터 버전에서 지원됩니다.
|
POINT_IN_TIME_RECOVERY_DISABLED |
읽기는 지난 1시간 이내의 모든 버전의 데이터에 지원됩니다. |
AppEngineIntegrationMode
App Engine 통합 모드의 유형입니다.
열거형 | |
---|---|
APP_ENGINE_INTEGRATION_MODE_UNSPECIFIED |
사용되지 않음. |
ENABLED |
App Engine 애플리케이션이 이 데이터베이스와 동일한 리전에 있으면 App Engine 구성이 이 데이터베이스에 영향을 줍니다. 여기에는 애플리케이션 및 데이터베이스 사용 중지와 데이터베이스 쓰기 사용 중지가 포함됩니다. |
DISABLED |
App Engine은 이 데이터베이스의 요청 처리 기능에 영향을 미치지 않습니다. Firestore API로 만든 데이터베이스의 기본 설정입니다. |
DeleteProtectionState(삭제 보호 상태)
데이터베이스의 삭제 보호 상태입니다.
열거형 | |
---|---|
DELETE_PROTECTION_STATE_UNSPECIFIED |
기본값입니다. 삭제 보호 유형이 지정되지 않았습니다. |
DELETE_PROTECTION_DISABLED |
삭제 보호가 사용 중지되었습니다. |
DELETE_PROTECTION_ENABLED |
삭제 보호가 사용 설정되었습니다. |
CmekConfig
Firestore 데이터베이스의 CMEK (고객 관리 암호화 키) 구성입니다. 없는 경우 데이터베이스는 기본 Google 암호화 키로 보호됩니다.
JSON 표현 |
---|
{ "kmsKeyName": string, "activeKeyVersion": [ string ] } |
필드 | |
---|---|
kmsKeyName |
필수 항목입니다. 이 데이터베이스와 동일한 위치에 있는 키만 암호화에 사용할 수 있습니다. Firestore의 nam5 멀티 리전의 경우 Cloud KMS 멀티 리전 us에 해당합니다. Firestore의 eur3 멀티 리전의 경우 Cloud KMS 멀티 리전 유럽에 해당합니다. https://cloud.google.com/kms/docs/locations를 참조하세요. 올바른 형식은 |
activeKeyVersion[] |
출력 전용입니다. 현재 사용 중인 KMS 키 버전 키 순환 중에 사용 중인 키 버전이 여러 개 있을 수 있습니다. 올바른 형식은 |
메서드 |
|
---|---|
|
데이터베이스 만들기 |
|
데이터베이스를 삭제합니다. |
|
Google Cloud Firestore의 문서 전체 또는 하위 집합을 Google Cloud Storage와 같은 다른 스토리지 시스템으로 내보냅니다. |
|
데이터베이스에 대한 정보를 가져옵니다. |
|
문서를 Google Cloud Firestore로 가져옵니다. |
|
프로젝트의 모든 데이터베이스를 나열합니다. |
|
데이터베이스를 업데이트합니다. |
|
기존 백업에서 복원하여 새 데이터베이스를 만듭니다. |