REST Resource: projects.locations.corpora.dataSchemas

Risorsa: DataSchema

Lo schema di dati indica in che modo l'annotazione specificata dall'utente viene interpretata nel sistema.

Rappresentazione JSON 
{
  "name": string,
  "key": string,
  "schemaDetails": {
    object (DataSchemaDetails)
  }
}
Campi
name

string

Nome della risorsa dello schema di dati nel formato: projects/{project_number}/locations/{location}/corpora/{corpus}/dataSchemas/{dataSchema} dove la parte {dataSchema} deve essere uguale al campo key di seguito.
key

string

Obbligatorio. La chiave di questo schema dati. Questa chiave deve corrispondere alla chiave dell'annotazione specificata dall'utente e deve essere univoca all'interno del corpus. Questo valore può contenere fino a 63 caratteri e i caratteri validi sono /[a-z][0-9]-/. Il primo carattere deve essere una lettera, l'ultimo può essere una lettera o un numero.
schemaDetails

object (DataSchemaDetails)

I dettagli dello schema mappati alla chiave.

DataSchemaDetails

I dettagli dello schema di dati indicano il tipo di dati e la struttura di dati corrispondente alla chiave dell'annotazione specificata dall'utente.

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

enum (DataType)

Tipo di annotazione.
protoAnyConfig

object (ProtoAnyConfig)

Configurazione per qualsiasi tipo di protobuf.
listConfig

object (ListConfig)

Configurazione per il tipo di dati Elenco.
customizedStructConfig

object (CustomizedStructConfig)

Configurazione per il tipo di dati CustomizedStruct.
granularity

enum (Granularity)

La granularità associata a questo DataSchema.
searchStrategy

object (SearchStrategy)

La strategia di ricerca da applicare al key sopra.

DataType

Tipo di dati dell'annotazione.

Enum
DATA_TYPE_UNSPECIFIED Tipo non specificato.
INTEGER Tipo di numero intero. Strategie di ricerca consentite: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH. Supporta la query per IntRangeArray.
FLOAT Tipo di numero in virgola mobile. Strategie di ricerca consentite: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH. Supporta la query per FloatRangeArray.
STRING Tipo di stringa. Strategie di ricerca consentite: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH, - DataSchema.SearchStrategy.SMART_SEARCH.
DATETIME Formati supportati: %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 Strategie di ricerca consentite: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH. Supporta la query per DateTimeRangeArray.
GEO_COORDINATE Tipo di coordinate geografiche. Strategie di ricerca consentite: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH. Supporta la query per GeoLocationArray.
PROTO_ANY Digita per passare qualsiasi proto come disponibile in annotations.proto. Da utilizzare solo internamente. Tipi di proto disponibili e relativo comportamento di ricerca corrispondente: - ImageObjectDetectionPredictionResult, consente SMART_SEARCH su displayNames e NO_SEARCH. - ClassificationPredictionResult, consente SMART_SEARCH su displayNames e NO_SEARCH. - ImageSegmentationPredictionResult, consente NO_SEARCH. - VideoActionRecognitionPredictionResult, consente SMART_SEARCH su displayName e NO_SEARCH. - VideoObjectTrackingPredictionResult, consente SMART_SEARCH su displayName e NO_SEARCH. - VideoClassificationPredictionResult, consente SMART_SEARCH su displayName e NO_SEARCH. - OccupancyCountingPredictionResult, consente la ricerca ESATTA su stats.full_frame_count.count e NO_SEARCH. - ObjectDetectionPredictionResult, consente la ricerca SMART su identifiedBoxes.entity.label_string e NO_SEARCH.
BOOLEAN Tipo booleano. Strategie di ricerca consentite: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH.
LIST Tipo di elenco. - Ogni elemento nell'elenco deve avere lo stesso schema dei dati; altrimenti, si tratta di argomenti non validi. - A livello di elenco non è possibile impostare la strategia di ricerca. Il livello del nodo foglia può essere utilizzato. - Gli elementi non possono essere un altro elenco (nessun elenco di elenchi). - Gli elementi possono essere CUSTOMIZED_STRUCT e il numero massimo di livelli è 10.
CUSTOMIZED_STRUCT Tipo di struct. - SearchStrategy: * lo schema di dati CUSTOMIZED_STRUCT non può impostare la strategia di ricerca. * Gli elementi del nodo foglia consentono di impostare la strategia di ricerca in base alla limitazione SearchStrategy dell'elemento. - Restrizioni dei livelli nidificati: * lo schema di dati CUSTOMIZED_STRUCT consente anche ai campi di essere di tipo CUSTOMIZED_STRUCT, ma la restrizione complessiva dei livelli è 10.

ProtoAnyConfig

La configurazione per il tipo di dati PROTO_ANY.

Rappresentazione JSON 
{
  "typeUri": string
}
Campi
typeUri

string

L'URI del tipo del messaggio proto.

ListConfig

La configurazione per il tipo di dati LIST.

Rappresentazione JSON 
{
  "valueSchema": {
    object (DataSchemaDetails)
  }
}
Campi
valueSchema

object (DataSchemaDetails)

Lo schema di dati del valore nell'elenco.

CustomizedStructConfig

La configurazione per il tipo di dati CUSTOMIZED_STRUCT.

Rappresentazione JSON 
{
  "fieldSchemas": {
    string: {
      object (DataSchemaDetails)
    },
    ...
  }
}
Campi
fieldSchemas

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

Schemi di dati diretti per gli elementi secondari.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Granularità

La granularità delle annotazioni in questo DataSchema.

Enum
GRANULARITY_UNSPECIFIED Granularità non specificata.
GRANULARITY_ASSET_LEVEL Granularità a livello di asset (le annotazioni non devono contenere informazioni sulla partizione).
GRANULARITY_PARTITION_LEVEL Granularità a livello di partizione (le annotazioni devono contenere informazioni sulla partizione).

SearchStrategy

La strategia di ricerca per il valore delle annotazioni di key.

Rappresentazione JSON 
{
  "searchStrategyType": enum (SearchStrategyType)
}
Campi
searchStrategyType

enum (SearchStrategyType)

Il tipo di strategia di ricerca da applicare al key riportato sopra. Il valore searchStrategyType consentito è diverso per i diversi tipi di dati, come documentato in DataSchemaDetails.DataType. Se specifichi searchStrategyType non supportato per i tipi di dati, verrà restituito l'errore INVALID_ARGUMENT.

SearchStrategyType

I tipi di strategie di ricerca da applicare alla chiave di annotazione.

Enum

Metodi

create

 Crea lo schema di dati all'interno del corpus.

delete

 Elimina lo schema dei dati all'interno del corpus.

get

 Recupera lo schema dei dati all'interno del corpus.

list

 Elenca un elenco di schemi di dati all'interno del corpus.

patch

 Aggiorna lo schema dei dati all'interno del corpus.