Coleções

Na pesquisa vetorial 2.0, as coleções são usadas para armazenar objetos de dados relacionados. Fornecem uma fonte de informações verdadeiras que pode consultar para determinar o estado exato dos objetos de dados que contêm.

Esquema de coleção

Quando cria uma coleção, tem de fornecer os seguintes esquemas JSON:

  • Um esquema de dados, que fornece a estrutura definida pelo utilizador dos seus dados.

  • Um esquema vetorial que define e configura os campos vetoriais para os seus objetos de dados.

Em conjunto, estes elementos são denominados esquema de recolha.

Criar uma coleção

O exemplo seguinte demonstra como criar uma coleção com o ID movies, especificando um esquema de dados e um esquema de vetores.

curl -X POST \
  'https://vectorsearch.googleapis.com/v1beta/projects/PROJECT_ID/locations/LOCATION/collections?collection_id=movies' \
  -H 'Bearer $(gcloud auth print-access-token)' \
  -H 'Content-Type: application/json' \
  -d '{  \
    "data_schema": { \
      "type": "object", \
      "properties": { \
        "year": { \
          "type": "number" \
        }, \
        "genre": { \
          "type": "string" \
        }, \
        "director": { \
          "type": "string" \
        }, \
        "title": { \
          "type": "string" \
        } \
      } \
    }, \
    "vector_schema": { \
      "plot_embedding": { \
        "dense_vector": { \
          "dimensions": 3 \
        } \
      }, \
      "soundtrack_embedding": { \
        "dense_vector": { \
          "dimensions": 5 \
        } \
      }, \
      "genre_embedding": { \
        "dense_vector": { \
          "dimensions": 4 \
        } \
      }, \
      "sparse_embedding": { \
        "sparse_vector": {} \
      } \
    } \
  }'

No exemplo, é feito um pedido com collection_id definido como movies e o seguinte como parte do corpo do pedido JSON:

  1. data_schema - Especifica a estrutura do objeto de dados.

  2. vector_schema - Configura e define os campos vetoriais.

Obter uma coleção

O exemplo seguinte demonstra como obter uma referência a uma coleção existente com o ID movies.

curl -X GET \
'https://vectorsearch.googleapis.com/v1beta/projects/PROJECT_ID/locations/LOCATION/collections/movies' \
    -H 'Bearer $(gcloud auth print-access-token)' \
    -H 'Content-Type: application/json'

Coleções de fichas

O exemplo seguinte demonstra como obter uma lista de coleções existentes.

curl -X GET \
'https://vectorsearch.googleapis.com/v1beta/projects/PROJECT_ID/locations/LOCATION/collections' \
    -H 'Bearer $(gcloud auth print-access-token)' \
    -H 'Content-Type: application/json'

Eliminar uma coleção

O exemplo seguinte demonstra como eliminar uma coleção existente com o ID movies.

curl -X DELETE \
'https://vectorsearch.googleapis.com/v1beta/projects/PROJECT_ID/locations/us-central1/collections/movies' \
    -H 'Bearer $(gcloud auth print-access-token)' \
    -H 'Content-Type: application/json'

O que se segue?