REST Resource: projects.databases.collectionGroups.fields

리소스: 필드

데이터베이스의 단일 필드를 나타냅니다.

필드는 ID가 동일한 데이터베이스의 모든 컬렉션을 나타내는 '컬렉션 그룹'으로 그룹화됩니다.

JSON 표현
{
  "name": string,
  "indexConfig": {
    object (IndexConfig)
  },
  "ttlConfig": {
    object (TtlConfig)
  }
}
필드
name

string

필수 항목입니다. projects/{projectId}/databases/{databaseId}/collectionGroups/{collectionId}/fields/{fieldPath} 형식의 필드 이름

필드 경로는 다음과 같은 간단한 필드 이름일 수 있습니다. address 또는 mapValue 내의 필드 경로(예: address.city 또는 특수 필드 경로입니다. 유일하게 유효한 특수 필드는 모든 필드를 나타내는 *입니다.

필드 경로는 ASCII 기호 문자뿐 아니라 (backtick). The only character that needs to be escaped within a quoted field path is the backtick character itself, escaped using a backslash. Special characters in field paths that must be quoted include:*,., ``` (backtick),[,]`를 사용하여 따옴표로 묶을 수 있습니다.

예: (참고: 이 주석은 마크다운 구문으로 작성되므로 코드 블록을 나타내는 추가 백틱 레이어가 있음) \address.city`represents a field namedaddress.city, not the map key cityin the fieldaddress. `*`represents a field named*`(필드가 아님)

특별한 Field에는 모든 필드의 기본 색인 생성 설정이 포함되어 있습니다. 이 필드의 리소스 이름: projects/{projectId}/databases/{databaseId}/collectionGroups/__default__/fields/*Field에 정의된 색인은 자체 Field 색인 구성이 없는 모든 필드에 적용됩니다.

indexConfig

object (IndexConfig)

이 필드의 색인 구성입니다. 설정하지 않으면 필드 색인 생성이 ancestorField에서 정의한 구성으로 되돌아갑니다. 이 필드의 모든 색인을 명시적으로 삭제하려면 빈 색인 목록을 사용하여 색인 구성을 지정하세요.

ttlConfig

object (TtlConfig)

Field의 TTL 구성입니다. 이를 설정하거나 설정 해제하면 이 Field이 있는 문서의 TTL이 사용 설정 또는 사용 중지됩니다.

색인 구성

이 필드의 색인 구성입니다.

JSON 표현
{
  "indexes": [
    {
      object (Index)
    }
  ],
  "usesAncestorConfig": boolean,
  "ancestorField": string,
  "reverting": boolean
}
필드
indexes[]

object (Index)

이 필드에 지원되는 색인입니다.

usesAncestorConfig

boolean

출력 전용입니다. true인 경우 Field의 색인 구성은 ancestorField에 지정된 구성에서 설정됩니다. false인 경우 Field의 색인 구성이 명시적으로 정의됩니다.

ancestorField

string

출력 전용입니다. 이 필드의 색인 구성이 설정되거나 (usesAncestorConfig이 true인 경우) 이 필드에 색인 구성이 없는 경우 (usesAncestorConfig가 false인 경우) 설정될 Field의 리소스 이름을 지정합니다.

reverting

boolean

출력 전용 true인 경우 Field의 색인 구성을 되돌리는 중입니다. 완료되면 색인 구성이 ancestorField로 지정된 필드와 동일한 상태로 전환되며 이때 usesAncestorConfigtrue이 되고 revertingfalse이 됩니다.

TTL 구성

Field가 설정된 문서의 TTL (수명) 구성입니다.

TTL이 사용 설정된 필드에 타임스탬프 값을 저장하면 문서의 절대 만료 시간으로 처리됩니다. 과거의 타임스탬프 값은 문서가 즉시 만료될 수 있음을 나타냅니다. 다른 데이터 유형을 사용하거나 필드를 비워두면 개별 문서의 만료가 사용 중지됩니다.

JSON 표현
{
  "state": enum (State)
}
필드
state

enum (State)

출력 전용입니다. TTL 구성 상태입니다.

모든 문서에 TTL 구성이 적용되는 상태입니다.

열거형
STATE_UNSPECIFIED 상태가 지정되지 않았거나 알 수 없습니다.
CREATING TTL을 적용하는 중입니다. 변경사항을 추적하는 활성 장기 실행 작업이 있습니다. 새로 작성된 문서에는 요청에 따라 TTL이 적용됩니다. 기존 문서에서 요청된 TTL을 아직 처리 중입니다. 모든 기존 문서의 TTL이 처리되면 상태가 '활성'으로 이동합니다.
ACTIVE TTL은 모든 문서에 대해 활성화됩니다.
NEEDS_REPAIR 모든 기존 문서에 TTL 구성을 사용 설정할 수 없습니다. 새로 작성된 문서에는 TTL이 계속 적용됩니다. 이 Field에 TTL을 사용 설정하려고 마지막으로 시도했을 때 LRO가 반환되었으며 세부정보가 포함되어 있을 수 있습니다.

메소드

get

필드의 메타데이터 및 구성을 가져옵니다.

list

이 데이터베이스의 필드 구성과 메타데이터를 나열합니다.

patch

필드 구성을 업데이트합니다.