REST Resource: projects.locations.corpora.dataSchemas

Resource: DataSchema

Skema data menunjukkan cara anotasi yang ditentukan pengguna ditafsirkan dalam sistem.

Representasi JSON
{
  "name": string,
  "key": string,
  "schemaDetails": {
    object (DataSchemaDetails)
  }
}
Kolom
name

string

Nama resource skema data dalam bentuk: projects/{project_number}/locations/{location}/corpora/{corpus}/dataSchemas/{dataSchema} dengan bagian {dataSchema} harus sama dengan kolom key di bawah.

key

string

Wajib. Kunci skema data ini. Kunci ini harus cocok dengan kunci anotasi yang ditentukan pengguna dan unik di dalam korpus. Nilai ini dapat mencapai maksimum 63 karakter, dan karakter yang valid adalah /[a-z][0-9]-/. Karakter pertama harus berupa huruf, karakter terakhir dapat berupa huruf atau angka.

schemaDetails

object (DataSchemaDetails)

Detail skema yang dipetakan ke kunci.

DataSchemaDetails

Detail skema data menunjukkan jenis data dan struktur data yang sesuai dengan kunci anotasi yang ditentukan pengguna.

Representasi JSON
{
  "type": enum (DataType),
  "protoAnyConfig": {
    object (ProtoAnyConfig)
  },
  "listConfig": {
    object (ListConfig)
  },
  "customizedStructConfig": {
    object (CustomizedStructConfig)
  },
  "granularity": enum (Granularity),
  "searchStrategy": {
    object (SearchStrategy)
  }
}
Kolom
type

enum (DataType)

Jenis anotasi.

protoAnyConfig

object (ProtoAnyConfig)

Konfigurasi untuk jenis protobuf apa pun.

listConfig

object (ListConfig)

Konfigurasi untuk jenis data Daftar.

customizedStructConfig

object (CustomizedStructConfig)

Konfigurasi untuk jenis data CustomizedStruct.

granularity

enum (Granularity)

Tingkat perincian yang terkait dengan DataSchema ini.

searchStrategy

object (SearchStrategy)

Strategi penelusuran yang akan diterapkan pada key di atas.

DataType

Jenis data anotasi.

Enum
DATA_TYPE_UNSPECIFIED Jenis tidak ditentukan.
INTEGER Jenis bilangan bulat. Strategi penelusuran yang diizinkan: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH. Mendukung kueri menurut IntRangeArray.
FLOAT Jenis float. Strategi penelusuran yang diizinkan: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH. Mendukung kueri menurut FloatRangeArray.
STRING Jenis string. Strategi penelusuran yang diizinkan: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH, - DataSchema.SearchStrategy.SMART_SEARCH.
DATETIME Format yang didukung: %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 Strategi penelusuran yang diizinkan: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH. Mendukung kueri menurut DateTimeRangeArray.
GEO_COORDINATE Jenis koordinat geografis. Strategi penelusuran yang diizinkan: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH. Mendukung kueri menurut GeoLocationArray.
PROTO_ANY Ketik untuk meneruskan proto apa pun yang tersedia di annotations.proto. Hanya digunakan secara internal. Jenis proto yang tersedia dan perilaku penelusuran yang sesuai: - ImageObjectDetectionPredictionResult, memungkinkan SMART_SEARCH pada displayNames dan NO_SEARCH. - ClassificationPredictionResult, mengizinkan SMART_SEARCH pada displayNames dan NO_SEARCH. - ImageSegmentationPredictionResult, memungkinkan NO_SEARCH. - VideoActionRecognitionPredictionResult, memungkinkan SMART_SEARCH di displayName dan NO_SEARCH. - VideoObjectTrackingPredictionResult, memungkinkan SMART_SEARCH di displayName dan NO_SEARCH. - VideoClassificationPredictionResult, memungkinkan SMART_SEARCH di displayName dan NO_SEARCH. - OccupancyCountingPredictionResult, memungkinkan EXACT_SEARCH di stats.full_frame_count.count dan NO_SEARCH. - ObjectDetectionPredictionResult, memungkinkan SMART_SEARCH di identifiedBoxes.entity.label_string dan NO_SEARCH.
BOOLEAN Jenis boolean. Strategi penelusuran yang diizinkan: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH.
LIST Jenis daftar. - Setiap elemen dalam daftar harus memiliki skema data yang sama persis; jika tidak, elemen tersebut adalah argumen yang tidak valid. - Tingkat daftar tidak dapat menetapkan strategi penelusuran. Tingkat node daun dapat melakukannya. - Elemen tidak boleh berupa daftar lain (tidak ada daftar daftar). - Elemen dapat berupa CUSTOMIZED_STRUCT, dan jumlah maksimum lapisan adalah 10.
CUSTOMIZED_STRUCT Jenis struct. - SearchStrategy: * Skema Data yang CUSTOMIZED_STRUCT tidak dapat menetapkan strategi penelusuran. * Elemen node daun memungkinkan penetapan strategi penelusuran berdasarkan batasan SearchStrategy elemen. - Pembatasan lapisan bertingkat: * Skema Data yang CUSTOMIZED_STRUCT memungkinkan kolomnya juga berupa CUSTOMIZED_STRUCT, tetapi batasan lapisan secara keseluruhan adalah 10.

ProtoAnyConfig

Konfigurasi untuk jenis data PROTO_ANY.

Representasi JSON
{
  "typeUri": string
}
Kolom
typeUri

string

URI jenis pesan proto.

ListConfig

Konfigurasi untuk jenis data LIST.

Representasi JSON
{
  "valueSchema": {
    object (DataSchemaDetails)
  }
}
Kolom
valueSchema

object (DataSchemaDetails)

Skema data nilai dalam daftar.

CustomizedStructConfig

Konfigurasi untuk jenis data CUSTOMIZED_STRUCT.

Representasi JSON
{
  "fieldSchemas": {
    string: {
      object (DataSchemaDetails)
    },
    ...
  }
}
Kolom
fieldSchemas

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

Skema data elemen turunan langsung.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Perincian

Tingkat perincian anotasi dalam DataSchema ini.

Enum
GRANULARITY_UNSPECIFIED Perincian tidak ditentukan.
GRANULARITY_ASSET_LEVEL Perincian tingkat aset (anotasi tidak boleh berisi info partisi).
GRANULARITY_PARTITION_LEVEL Perincian tingkat partisi (anotasi harus berisi info partisi).

SearchStrategy

Strategi penelusuran untuk nilai anotasi key.

Representasi JSON
{
  "searchStrategyType": enum (SearchStrategyType)
}
Kolom
searchStrategyType

enum (SearchStrategyType)

Jenis strategi penelusuran yang akan diterapkan pada key di atas. searchStrategyType yang diizinkan berbeda untuk jenis data yang berbeda, yang didokumentasikan dalam DataSchemaDetails.DataType. Menentukan searchStrategyType yang tidak didukung untuk jenis data akan menyebabkan error INVALID_ARGUMENT.

SearchStrategyType

Jenis strategi penelusuran yang akan diterapkan pada kunci anotasi.

Enum

Metode

create

Membuat skema data di dalam korpus.

delete

Menghapus skema data di dalam korpus.

get

Mendapatkan skema data di dalam korpus.

list

Mencantumkan daftar skema data di dalam korpus.

patch

Memperbarui skema data di dalam korpus.