Crea una instancia de tienda en línea

Para configurar la entrega en línea, primero debes crear una instancia de tienda en línea para la entrega en línea de Bigtable o la entrega en línea optimizada.

Ten en cuenta que no puedes cambiar el tipo de entrega en línea una vez que elijas la entrega en línea de Bigtable o la entrega en línea optimizada mientras creas tu tienda en línea. Sin embargo, puedes cambiar la configuración del extremo de entrega para una instancia de almacén en línea creado para la entrega en línea optimizada.

Después de crear el almacén en línea, puedes agregar vistas de atributos y asociarlas con fuentes de datos de atributos en BigQuery.

Configura la administración de incorporaciones para un almacén en línea

Vertex AI Feature Store te permite realizar búsquedas de similitud de vectores mediante incorporaciones en una vista de atributos dentro de una tienda en línea. Para realizar una búsqueda de similitud vectorial, debes configurar tu instancia de tienda en línea a fin de que admita la administración de incorporaciones mediante el parámetro FeatureOnlineStore.embedding_management y, luego, Configura la recuperación vector para al menos una vista de atributos dentro de la tienda en línea.

Para obtener más información sobre cómo buscar vecinos más cercanos aproximados a través de incorporaciones en Vertex AI Feature Store, consulta Busca con el uso de incorporaciones.

Crea una tienda en línea para la entrega en línea de Bigtable

Usa el siguiente ejemplo para crear una instancia de tienda en línea para la entrega en línea de Bigtable con ajuste de escala automático.

Console

Usa las siguientes instrucciones para crear una tienda en línea para la entrega en línea de Bigtable con la consola de Google Cloud.

En la sección de Vertex AI de la consola de Google Cloud, ve a la página Feature Store.

Ir a la página Feature Store
Haz clic en Tienda en línea para ir a la sección Tienda en línea.
Haz clic en Crear para abrir la página Crear tienda en línea.
Especifica un nombre para la tienda en línea.
Opcional: Para agregar etiquetas, haz clic en Agregar etiqueta y especifica su nombre y valor. Puedes agregar varias etiquetas a una tienda en línea.
En el campo Elige una solución de almacenamiento para tu tienda en línea, haz clic en Bigtable.
Modifica el Recuento mínimo de nodos, el Recuento máximo de nodos y el Objetivo de uso de CPU, según sea necesario.
Haz clic en Crear.

REST

Para crear un recurso FeatureOnlineStore, envía una solicitud POST mediante el método featureOnlineStores.create.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

LOCATION_ID: Es la región en la que deseas crear la tienda en línea, como us-central1.
PROJECT_ID: ID del proyecto
FEATUREONLINESTORE_NAME: el nombre de la nueva instancia de tienda en línea.
BOOLEAN: Opcional: Para crear una tienda en línea que admita la administración de incorporaciones, ingresa true. El valor predeterminado es false.

HTTP method and URL:

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

Cuerpo JSON de la solicitud:

{
  "bigtable": {
    "auto_scaling": {
      "min_node_count": 1,
      "max_node_count": 3,
      "cpu_utilization_target": 50
    }
  }
  "embedding_management": {
    "enabled": BOOLEAN
  }
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

PowerShell

Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

Crea una tienda en línea para la entrega en línea optimizada

Cuando usas la entrega en línea optimizada, puedes configurar la tienda en línea para entregar funciones desde un extremo público o desde un extremo dedicado de Private Service Connect. Usa un extremo de Private Service Connect si deseas entregar funciones dentro de una red de VPC con latencias más bajas las de que un extremo público.

Crea una tienda en línea para la entrega en línea optimizada con un extremo público

Usa el siguiente ejemplo a fin de crear un almacén en línea para la entrega en línea optimizada con un extremo público.

IU web

Usa las siguientes instrucciones para crear un almacén en línea para la entrega en línea optimizada con la consola de Google Cloud.

En la sección de Vertex AI de la consola de Google Cloud, ve a la página Feature Store.

Ir a la página Feature Store
Haz clic en Tienda en línea para ir a la sección Tienda en línea.
Haz clic en Crear para abrir la página Crear tienda en línea.
Especifica un nombre para la tienda en línea.
Opcional: Para agregar etiquetas, haz clic en Agregar etiqueta y especifica su nombre y valor. Puedes agregar varias etiquetas a una tienda en línea.
En el campo Elige una solución de almacenamiento para tu tienda en línea, haz clic en Optimizada.
Haz clic en Crear.

REST

Para crear una instancia de tienda en línea, envía una solicitud POST con el método featureOnlineStores.create.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

LOCATION_ID: Es la región en la que deseas crear la instancia FeatureOnlineStore, como us-central1.
PROJECT_ID: ID del proyecto
FEATUREONLINESTORE_NAME: es el nombre de la instancia FeatureOnlineStore nueva.

HTTP method and URL:

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

Cuerpo JSON de la solicitud:

{
  "optimized": {}
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

PowerShell

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

Crea un almacén en línea para la entrega en línea optimizada con un extremo de Private Service Connect

Usa la siguiente muestra a fin de crear un almacén en línea para la entrega en línea optimizada con Private Service Connect.

REST

Para crear una instancia de tienda en línea, envía una solicitud POST con el método featureOnlineStores.create.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

LOCATION_ID: Es la región en la que deseas crear la instancia FeatureOnlineStore, como us-central1.
PROJECT_ID: ID del proyecto
FEATUREONLINESTORE_NAME: es el nombre de la instancia FeatureOnlineStore nueva.

HTTP method and URL:

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

Cuerpo JSON de la solicitud:

{
  "optimized": {},
  "dedicated_serving_endpoint": {
    "private_service_connect_config": {
      "enable_private_service_connect": true,
      "project_allowlist": ["PROJECT_NAME"]
    }
  }
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

PowerShell

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

¿Qué sigue?

Obtén información para crear una vista de funciones.
Obtén más información sobre cómo actualizar una tienda en línea.