REST Resource: projects.locations.corpora.dataSchemas

리소스: DataSchema

데이터 스키마는 사용자가 지정한 주석이 시스템에서 어떻게 해석되는지 나타냅니다.

JSON 표현 
{
  "name": string,
  "key": string,
  "schemaDetails": {
    object (DataSchemaDetails)
  }
}
필드
name

string

데이터 스키마의 리소스 이름으로, projects/{project_number}/locations/{location}/corpora/{corpus}/dataSchemas/{dataSchema} 형식이며 {dataSchema} 부분은 아래의 key 필드와 동일해야 합니다.
key

string

필수 입력란입니다. 이 데이터 스키마의 키입니다. 이 키는 사용자가 지정한 주석의 키와 일치해야 하며 자료 내에서 고유해야 합니다. 이 값은 최대 63자(영문 기준)까지 가능하며 유효한 문자는 /[a-z][0-9]-/입니다. 첫 번째 글자는 문자여야 하며 마지막 글자는 문자 또는 숫자여도 됩니다.
schemaDetails

object (DataSchemaDetails)

키에 매핑되는 스키마 세부정보입니다.

DataSchemaDetails

데이터 스키마 세부정보는 사용자 지정 주석의 키에 해당하는 데이터 유형과 데이터 구조를 나타냅니다.

JSON 표현 
{
  "type": enum (DataType),
  "protoAnyConfig": {
    object (ProtoAnyConfig)
  },
  "listConfig": {
    object (ListConfig)
  },
  "customizedStructConfig": {
    object (CustomizedStructConfig)
  },
  "granularity": enum (Granularity),
  "searchStrategy": {
    object (SearchStrategy)
  }
}
필드
type

enum (DataType)

주석의 유형입니다.
protoAnyConfig

object (ProtoAnyConfig)

protobuf 모든 유형의 구성입니다.
listConfig

object (ListConfig)

목록 데이터 유형의 구성입니다.
customizedStructConfig

object (CustomizedStructConfig)

CustomizedStruct 데이터 유형의 구성입니다.
granularity

enum (Granularity)

이 DataSchema와 연결된 세부사항입니다.
searchStrategy

object (SearchStrategy)

위의 key에 적용할 검색 전략입니다.

DataType

주석의 데이터 유형입니다.

열거형
DATA_TYPE_UNSPECIFIED 알 수 없는 유형.
INTEGER 정수 유형입니다. 허용되는 검색 전략: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH. IntRangeArray를 통한 쿼리를 지원합니다.
FLOAT 부동 유형입니다. 허용되는 검색 전략: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH. FloatRangeArray를 통한 쿼리를 지원합니다.
STRING 문자열 유형입니다. 허용되는 검색 전략: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH, - DataSchema.SearchStrategy.SMART_SEARCH
DATETIME 지원되는 형식: %Y-%m-%dT%H:%M:%E*S%E*z (absl::RFC3339_full) %Y-%m-%dT%H:%M:%E*S %Y-%m-%dT%H:%M%E*z %Y-%m-%dT%H:%M %Y-%m-%dT%H%E*z %Y-%m-%dT%H %Y-%m-%d%E*z %Y-%m-%d %Y-%m %Y 허용되는 검색 전략: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH DateTimeRangeArray를 통한 쿼리를 지원합니다.
GEO_COORDINATE 지리적 좌표 유형입니다. 허용되는 검색 전략: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH. GeoLocationArray를 통한 쿼리를 지원합니다.
PROTO_ANY annotations.proto에서 사용 가능한 proto를 전달하도록 입력합니다. 내부에서만 사용하세요. 사용 가능한 proto 유형 및 해당 검색 동작: - ImageObjectDetectionPredictionResult: displayNames 및 NO_SEARCH에서 SMART_SEARCH를 허용합니다. - ClassificationPredictionResult: displayNames 및 NO_SEARCH에서 SMART_SEARCH를 허용합니다. - ImageSegmentationPredictionResult: NO_SEARCH를 허용합니다. - VideoActionRecognitionPredictionResult: displayName 및 NO_SEARCH에서 SMART_SEARCH를 허용합니다. - VideoObjectTrackingPredictionResult: displayName 및 NO_SEARCH에서 SMART_SEARCH를 허용합니다. - VideoClassificationPredictionResult: displayName 및 NO_SEARCH에서 SMART_SEARCH를 허용합니다. - OccupancyCountingPredictionResult: stats.full_frame_count.count 및 NO_SEARCH에서 EXACT_SEARCH를 허용합니다. - ObjectDetectionPredictionResult: identifiedBoxes.entity.label_string 및 NO_SEARCH에서 SMART_SEARCH를 허용합니다.
BOOLEAN 불리언 유형입니다. 허용되는 검색 전략: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH.
LIST 목록 유형 - 목록의 각 요소는 정확히 동일한 데이터 스키마여야 합니다. 그러지 않으면 잘못된 인수가 됩니다. - 목록 수준에서는 검색 전략을 설정할 수 없습니다. 리프 노드 수준에서는 가능합니다. - 요소는 다른 목록이 될 수 없습니다 (목록의 목록 없음). - 요소는 CUSTOMIZED_STRUCT일 수 있으며 최대 레이어 수는 10개입니다.
CUSTOMIZED_STRUCT 구조체 유형입니다. - SearchStrategy: * CUSTOMIZED_STRUCT인 데이터 스키마는 검색 전략을 설정할 수 없습니다. * 리프 노드 요소는 요소의 SearchStrategy 제한사항에 따라 검색 전략을 설정할 수 있습니다. - 중첩된 레이어 제한: * CUSTOMIZED_STRUCT인 데이터 스키마는 필드가 CUSTOMIZED_STRUCT일 수도 있지만 전체 레이어 제한은 10입니다.

ProtoAnyConfig

PROTO_ANY 데이터 유형의 구성입니다.

JSON 표현 
{
  "typeUri": string
}
필드
typeUri

string

proto 메시지의 유형 URI입니다.

ListConfig

LIST 데이터 유형의 구성입니다.

JSON 표현 
{
  "valueSchema": {
    object (DataSchemaDetails)
  }
}
필드
valueSchema

object (DataSchemaDetails)

목록에 있는 값의 데이터 스키마입니다.

CustomizedStructConfig

CUSTOMIZED_STRUCT 데이터 유형의 구성입니다.

JSON 표현 
{
  "fieldSchemas": {
    string: {
      object (DataSchemaDetails)
    },
    ...
  }
}
필드
fieldSchemas

map (key: string, value: object (DataSchemaDetails))

직접 하위 요소 데이터 스키마

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

세부사항

이 DataSchema 아래의 주석 세부사항입니다.

열거형
GRANULARITY_UNSPECIFIED 지정되지 않은 세부사항입니다.
GRANULARITY_ASSET_LEVEL 애셋 수준 세분성 (주석에 파티션 정보가 포함되어서는 안 됨)
GRANULARITY_PARTITION_LEVEL 파티션 수준 세부사항 (주석에 파티션 정보가 포함되어야 함)

SearchStrategy

key의 주석 값에 대한 검색 전략입니다.

JSON 표현 
{
  "searchStrategyType": enum (SearchStrategyType)
}
필드
searchStrategyType

enum (SearchStrategyType)

위의 key에 적용할 검색 전략의 유형입니다. 허용되는 searchStrategyType는 데이터 유형에 따라 다르며 DataSchemaDetails.DataType에 설명되어 있습니다. 데이터 유형에 지원되지 않는 searchStrategyType를 지정하면 INVALID_ARGUMENT 오류가 발생합니다.

SearchStrategyType

주석 키에 적용할 검색 전략의 유형입니다.

열거형

메서드

create

 자료 내에서 데이터 스키마를 만듭니다.

delete

 자료 내의 데이터 스키마를 삭제합니다.

get

 자료 내 데이터 스키마를 가져옵니다.

list

 코퍼스 내의 데이터 스키마 목록을 나열합니다.

patch

 자료 내 데이터 스키마를 업데이트합니다.