Aprende a crear, enumerar, describir, actualizar y borrar almacenes de atributos. Un almacén de atributos es el contenedor de nivel superior para los tipos de entidades, los atributos y los valores de atributos.
Almacenamiento en línea y sin conexión
Vertex AI Feature Store (Heredado) usa dos métodos de almacenamiento clasificados como almacenamiento en línea y almacenamiento sin conexión, que tienen precios diferentes. Todos los almacenes de atributos tienen almacenamiento sin conexión y, de forma opcional, almacenamiento en línea.
El almacenamiento en línea conserva los valores de marca de tiempo más recientes de tus atributos para controlar las solicitudes de entrega en línea de manera eficiente. Cuando ejecutas un trabajo de transferencia con la API, puedes controlar el trabajo si los datos se escriben en el almacén en línea. Si omites la tienda en línea, se evita cualquier carga en los nodos de entrega en línea. Por ejemplo, cuando ejecutas trabajos de reabastecimiento, puedes inhabilitar las operaciones de escritura en el almacén en línea y escribir solo en la almacén sin conexión. Para obtener más información, consulta la marca disableOnlineServing
en la referencia de la API.
Vertex AI Feature Store (Heredado) usa el almacenamiento sin conexión para almacenar datos de forma permanente hasta que los datos alcancen el límite de retención o hasta que los borres. Puedes almacenar datos ilimitados en la tienda sin conexión. Puedes controlar los costos de almacenamiento sin conexión mediante la administración de la cantidad de datos que conservas. También puedes anular el límite predeterminado de retención de datos de la tienda en línea para tu almacén de atributos y el límite de retención de datos sin conexión para un tipo de entidad. Obtén más información sobre las cuotas y límites de Vertex AI Feature Store (Heredado).
Usa la consola de Google Cloud para ver la cantidad de almacenamiento en línea y sin conexión que usas en la actualidad. Visualiza las métricas de supervisión de Almacenamiento en línea total y Almacenamiento sin conexión total de tu almacén de atributos para determinar tu uso.
Nodos de entrega en línea
Los nodos de entrega en línea proporcionan los recursos de procesamiento que se usan a fin de entregar y almacenar valores de atributos para la entrega en línea de latencia baja. Estos nodos siempre se ejecutan, incluso cuando no entregan datos. Se te cobra por cada hora de procesamiento de nodo.
El límite de almacenamiento para los nodos de entrega en línea es de 5 TB por nodo. Obtén más información sobre las cuotas y límites de Vertex AI Feature Store (Heredado).
La cantidad de nodos de entrega en línea que necesitas es directamente proporcional a los siguientes dos factores:
- La cantidad de solicitudes de entrega en línea (consultas por segundo) que recibe el almacén de atributos.
- La cantidad de trabajos de transferencia que escriben en el almacenamiento en línea.
Ambos factores contribuyen al uso de CPU y al rendimiento de los nodos. En la consola de Google Cloud, consulta las métricas de lo siguiente:
- Consultas por segundo: cantidad de consultas por segundo a tu almacén de atributos.
- Recuento de nodos: la cantidad de nodos de entrega en línea
- Uso de CPU: uso de CPU de tus nodos
Si el uso de CPU se mantiene alto, considera aumentar la cantidad de nodos de entrega en línea para tu almacén de atributos.
Prueba el rendimiento de los nodos de entrega en línea
Puedes probar el rendimiento de los nodos de entrega en línea para la entrega de atributos en tiempo real. Esto te permite asegurarte de que el almacén de atributos tenga suficientes recursos de máquina para realizar dentro de límites de latencia o QPS predeterminados. Puedes realizar estas pruebas en función de varios parámetros de comparativas, como QPS, latencia y API. Si deseas obtener pautas y prácticas recomendadas para probar el rendimiento de los nodos de entrega en línea, consulta lo siguiente: Prueba el rendimiento de los nodos de entrega en línea para la entrega en tiempo real en Prácticas recomendadas para Vertex AI Feature Store (heredado).
Además, puedes usar la herramienta de código abierto Vertex AI Benchmarker para realizar una prueba de carga del rendimiento de los recursos de tu almacén de atributos. La herramienta de código abierto Vertex AI Benchmarker consta de una herramienta de línea de comandos de Python y un trabajador de Java.
Opciones de escalamiento
Puedes alternar entre las opciones siguientes para configurar la cantidad de nodos de entrega en línea:
Ajuste de escala automático
Si eliges el ajuste de escala automático, el almacén de atributos cambia de forma automática la cantidad de nodos según el uso de CPU. El ajuste de escala automático revisa los patrones de tráfico para mantener el rendimiento y optimizar tu costo, ya que agrega nodos cuando el tráfico aumenta y los quita cuando este disminuye.
El ajuste de escala automático funciona bien para los patrones de tráfico que experimentan un crecimiento y una disminución graduales. Si usas Vertex AI Feature Store (Heredado) ampliamente para los patrones de tráfico que encuentran fluctuaciones de carga frecuentes, usa el ajuste de escala automático a fin de mejorar la rentabilidad.
Asignación de un recuento de nodos fijos
Si asignas un recuento fijo de nodos, Vertex AI Feature Store (heredado) mantiene una cantidad coherente de nodos sin importar los patrones de tráfico. El recuento de nodos fijos mantiene los costos predecibles, y los nodos deberían funcionar bien cuando haya suficientes nodos para manejar el tráfico. Puedes cambiar el recuento de nodos fijos de forma manual para controlar los cambios en los patrones de tráfico.
Consideraciones adicionales para el ajuste de escala automático
Si eliges el ajuste de escala automático, debes considerar cuatro puntos adicionales que incluyen lo siguiente:
Después de agregar nodos de entrega en línea, la tienda en línea necesita tiempo para volver a balancear los datos. Pueden pasar hasta 20 minutos con carga antes de que veas una mejora significativa en el rendimiento. Como resultado, es posible que el escalamiento de la cantidad de nodos no sea útil para los aumentos de actividad de tráfico breves. Esta limitación se aplica tanto al escalamiento manual como al ajuste de escala automático.
Si envías solicitudes de entrega en línea al almacén de atributos sin nodos de entrega en línea, la operación muestra un error.
Desactiva la entrega en línea en tu almacén de atributos
Si no necesitas la entrega en línea y quieres evitar que se generen cambios en los nodos de entrega en línea, define la cantidad de nodos de entrega en línea en cero. Para desactivar la entrega en línea en tu almacén de atributos, establece la siguiente configuración:
Si usas el ajuste de escala automático, quita el parámetro
scaling
.Establece la cantidad fija de nodos de entrega en línea en
0
.
Para obtener más información sobre cómo crear un almacén de atributos, consulta Crea un almacén de atributos. Para obtener más información sobre cómo modificar la configuración de un almacén de atributos existente, consulta Actualiza un almacén de atributos.
Si configuras la cantidad de nodos de entrega en línea como 0
, se borrará toda la tienda en línea, incluidos sus datos. Si deseas desactivar tu tienda en línea de forma temporal y, luego, restablecerla, debes volver a transferir los datos borrados.
Por ejemplo, si configuras el recuento de nodos de entrega en línea de tu almacén de atributos en 0
y aprovisionas los nodos de entrega en línea mediante la configuración de este recuento en 1
o una versión posterior, Vertex AI Feature Store (heredado) no migra los datos de atributos borrados a la tienda en línea. Para volver a propagar tu tienda en línea, debes volver a transferir tus datos. Una forma de transferir los datos es exportar los datos históricos antes de inhabilitar los nodos de entrega en línea y, luego, transferir los datos exportados después de aprovisionarlos.
Cuando aprovisionas nodos de entrega en línea, debes esperar a que se complete la operación antes de transferir datos nuevos. Los trabajos de transferencia en curso se reanudan solo después de que se completa el aprovisionamiento del nodo de entrega en línea.
Si envías una solicitud de entrega en línea al almacén de atributos sin nodos de entrega en línea, la solicitud muestra un error.
Crear un almacén de atributos
Crea un recurso de featurestore para contener atributos y tipos de entidad. La ubicación de tu almacén de atributos debe estar en la misma ubicación que los datos de origen.
Por ejemplo, si tu almacén de atributos está en us-central,
, puedes transferir datos de archivos en buckets de Cloud Storage que se encuentran en us-central1
o en la ubicación multirregión US, aunque los datos de origen provenientes de buckets de regiones dobles no son compatibles. De manera similar, para BigQuery puedes transferir datos desde tablas que se encuentran en us-central1
o en la ubicación multirregión US. Para obtener más información, consulta Requisitos de datos de origen.
La disponibilidad de Vertex AI Feature Store (heredado) puede variar según la ubicación. Para obtener más información, consulta Disponibilidad de las funciones.
IU web
Puedes crear un almacén de atributos con la consola de Google Cloud si aún no se creó un almacén de atributos en el proyecto de Google Cloud para la región seleccionada. Si ya existe un almacén de atributos para el proyecto y la región, usa otro método.
Para crear un almacén de atributos con la consola de Google Cloud, sigue estos pasos:
- En la sección de Vertex AI de la consola de Google Cloud, ve a la página Funciones.
- Haga clic en Crear almacén de atributos
- Especifica un nombre para el almacén de atributos.
- Si deseas activar la entrega en línea para el almacén de atributos, haz clic en el botón de activación Activar la entrega en línea y configura las opciones de escalamiento.
Para obtener más información sobre las opciones de entrega y escalamiento en línea, consulta Nodos de entrega en línea. - Haz clic en Crear.
Terraform
En el siguiente ejemplo, se usa el recurso google_vertex_ai_featurestore
de Terraform para crear un almacén de atributos con un recuento de nodos fijo. El nombre del almacén de atributos es featurestore_xxxxxxxx
, en el que xxxxxxxx
es un identificador alfanumérico generado de forma aleatoria.
Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.
REST
Para crear un featurestore, envía una solicitud POST con el método featurestores.create.
En el siguiente ejemplo, se crea un featurestore con un recuento de nodos fijo de 1
. El recuento de nodos especifica la cantidad de nodos de entrega en línea que afectan la cantidad de solicitudes de entrega en línea que puede controlar el featurestore. La latencia podría aumentar si la cantidad de nodos no admite la cantidad de solicitudes entrantes.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- LOCATION_ID: Región en la que se crea el featurestore. Por ejemplo,
us-central1
- PROJECT_ID: El ID del proyecto.
- FEATURESTORE_ID: ID del featurestore.
Método HTTP y URL:
POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores?featurestoreId=FEATURESTORE_ID
Cuerpo JSON de la solicitud:
{ "online_serving_config": { "fixed_node_count": 1 }, "labels": { "environment": "testing" } }
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/featurestores?featurestoreId=FEATURESTORE_ID"
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/featurestores?featurestoreId=FEATURESTORE_ID" | Select-Object -Expand Content
Deberías ver un resultado similar al siguiente. Puedes usar el OPERATION_ID en la respuesta para obtener el estado de la operación.
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeaturestoreOperationMetadata", "genericMetadata": { "createTime": "2021-02-26T00:44:40.722474Z", "updateTime": "2021-02-26T00:44:40.722474Z" } } }
Python
Si deseas obtener información para instalar o actualizar el SDK de Vertex AI para Python, consulta Instala el SDK de Vertex AI para Python. Si deseas obtener más información, consulta la documentación de referencia de la API de Python.
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración para Java incluidas en la guía de inicio rápido de Vertex AI sobre cómo usar bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Vertex AI Java.
Para autenticarte en Vertex AI, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración para Node.js incluidas en la guía de inicio rápido de Vertex AI sobre cómo usar bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Vertex AI Node.js.
Para autenticarte en Vertex AI, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Crea un almacén de atributos que use una CMEK
Antes de comenzar, si no tienes una CMEK (clave de encriptación administrada por el cliente) existente, usa Cloud Key Management Service para configurar una clave de encriptación administrada por el cliente y configurar permisos. En el siguiente ejemplo, se crea un almacén de atributos que usa una clave de CMEK.
Si Vertex AI pierde permiso para la clave de CMEK asociada, cualquier recurso y valor dentro de los almacenes de atributos que se encriptaron con esa clave se vuelve inaccesible hasta que Vertex AI pueda volver a usar esa clave.
Después de 30 días, si Vertex AI aún no tiene acceso a la clave de CMEK, Vertex AI borra todos los almacenes de atributos que se encriptaron con esa clave. Cuando creas tiendas de funciones nuevas, no puedes volver a usar esos nombres de tiendas de funciones.
IU web
Usa otro método. No puedes crear un featurestore desde la consola de Google Cloud.
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- LOCATION_ID: Región en la que se crea el featurestore. Por ejemplo,
us-central1
- PROJECT_ID: El ID del proyecto.
- FEATURESTORE_ID: ID del featurestore.
- CMEK_PROJECT: El ID o el número del proyecto que contiene tus CMEK.
- KEY_RING: El nombre del llavero de claves de Cloud Key Management Service en el que está activada tu clave de encriptación.
- KEY_NAME: El nombre de la clave de encriptación que se usará.
Método HTTP y URL:
POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores?featurestoreId=FEATURESTORE_ID
Cuerpo JSON de la solicitud:
{ "online_serving_config": { "fixed_node_count": 1 }, "encryption_spec":{ "kms_key_name": "projects/CMEK_PROJECT/locations/LOCATION_ID/keyRings/KEY_RING/cryptoKeys/KEY_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/featurestores?featurestoreId=FEATURESTORE_ID"
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/featurestores?featurestoreId=FEATURESTORE_ID" | Select-Object -Expand Content
Deberías ver un resultado similar al siguiente. Puedes usar el OPERATION_ID en la respuesta para obtener el estado de la operación.
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeaturestoreOperationMetadata", "genericMetadata": { "createTime": "2021-02-26T00:44:40.722474Z", "updateTime": "2021-02-26T00:44:40.722474Z" } } }
Enumera almacenes de atributos
Enumera todos los featurestores en un proyecto.
IU web
- En la sección de Vertex AI de la consola de Google Cloud, ve a la página Funciones.
- Selecciona una región de la lista desplegable Región.
- En la tabla de funciones, consulta la columna Featurestore para ver los featurestores de tu proyecto en la región seleccionada.
REST
Para enumerar los featurestores de una región en particular en tu proyecto, envía una solicitud GET con el método featurestores.list.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- LOCATION_ID: Región donde se encuentra el featurestore, como
us-central1
. - PROJECT_ID: El ID del proyecto.
Método HTTP y URL:
GET https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores"
PowerShell
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "featurestores": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featurestores/test", "createTime": "2021-02-26T00:44:44.216805Z", "updateTime": "2021-02-26T00:44:44.364916Z", "etag": "AMEw9yNL0s7qZh8lZVZ5T3BEuhoEgFR7JmjbbCSAkRZjeKDXkkIYnxxA4POe5BWT8cCn", "labels": { "environment": "testing" }, "onlineServingConfig": { "fixedNodeCount": 2 }, "state": "STABLE" }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featurestores/featurestore_demo", "createTime": "2021-02-25T00:39:40.598781Z", "updateTime": "2021-02-25T00:39:40.744038Z", "etag": "AMEw9yO_e0vm-9W_yeCz4rJm-XnnEMYQ-vQesevxya_sz-FckuysnDwo3cEXHdWWSeda", "labels": { "environment": "testing" }, "onlineServingConfig": { "fixedNodeCount": 3 }, "state": "STABLE" } ] }
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración para Java incluidas en la guía de inicio rápido de Vertex AI sobre cómo usar bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Vertex AI Java.
Para autenticarte en Vertex AI, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración para Node.js incluidas en la guía de inicio rápido de Vertex AI sobre cómo usar bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Vertex AI Node.js.
Para autenticarte en Vertex AI, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Idiomas adicionales
Si deseas obtener información sobre cómo instalar y usar el SDK de Vertex AI para Python, consulta Cómo usar el SDK de Vertex AI para Python. Si deseas obtener más información, consulta la documentación de referencia del SDK de IA de Vertex para Python.
Ver detalles del almacén de atributos
Obtén detalles sobre un featurestore, como su nombre y la configuración de entrega en línea. Si usas la consola de Google Cloud, puedes ver las métricas de Cloud Monitoring para los almacenes de atributos.
IU web
- En la sección de Vertex AI de la consola de Google Cloud, ve a la página Funciones.
- Selecciona una región de la lista desplegable Región.
- En la tabla de atributos, consulta la columna Almacenes de atributos y busca el almacén de atributos sobre la que deseas ver información.
- Haz clic en el nombre del almacén de atributos para ver sus métricas de Monitoring.
- Haz clic en la pestaña Propiedades para ver la configuración de entrega en línea del almacén de atributos.
REST
Para obtener detalles sobre un solo featurestore, envía una solicitud GET con el método featurestores.get.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- LOCATION_ID: Región donde se encuentra el featurestore, como
us-central1
. - PROJECT_ID: El ID del proyecto.
- FEATURESTORE_ID: ID del featurestore.
Método HTTP y URL:
GET https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID"
PowerShell
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID" | 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/featurestores/FEATURESTORE_ID", "createTime": "2021-02-25T00:39:40.598781Z", "updateTime": "2021-02-25T00:39:40.744038Z", "etag": "AMEw9yNy_b4IaMIvw1803ZT38cpUtjfwlyLkR709oBCY6pQrm6dHophLcqhrvsNqkQQZ", "onlineServingConfig": { "fixedNodeCount": 3 }, "state": "STABLE" }
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración para Java incluidas en la guía de inicio rápido de Vertex AI sobre cómo usar bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Vertex AI Java.
Para autenticarte en Vertex AI, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración para Node.js incluidas en la guía de inicio rápido de Vertex AI sobre cómo usar bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Vertex AI Node.js.
Para autenticarte en Vertex AI, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Idiomas adicionales
Si deseas obtener información sobre cómo instalar y usar el SDK de Vertex AI para Python, consulta Cómo usar el SDK de Vertex AI para Python. Si deseas obtener más información, consulta la documentación de referencia del SDK de IA de Vertex para Python.
Actualiza un almacén de atributos
Actualiza un featurestore, por ejemplo, para cambiar la cantidad de nodos de entrega en línea o actualizar las etiquetas de un featurestore.
IU web
Solo puedes actualizar la cantidad de nodos de entrega en línea. Para actualizar las etiquetas, usa la API.
- En la sección de Vertex AI de la consola de Google Cloud, ve a la página Funciones.
- Selecciona una región de la lista desplegable Región.
- En la tabla de atributos, consulta la columna Almacén de atributos y haz clic en el nombre del almacén de atributos que deseas actualizar.
- Haz clic en Editar configuración para abrir el panel Editar la configuración del almacén de atributos.
- Edita la configuración del almacén de atributos.
- Haz clic en Actualizar para aplicar los cambios.
REST
Para actualizar un featurestore, envía una solicitud PATCH con el método featurestores.patch.
En el siguiente ejemplo, se actualiza la cantidad de nodos de entrega en línea a 2
para featurestore. No se modifica el resto de la configuración.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- LOCATION_ID: Región donde se encuentra el featurestore, como
us-central1
. - PROJECT_ID: El ID del proyecto.
- FEATURESTORE_ID: ID del featurestore.
Método HTTP y URL:
PATCH https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID
Cuerpo JSON de la solicitud:
{ "online_serving_config": { "fixed_node_count": 2 } }
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 PATCH \
-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/featurestores/FEATURESTORE_ID"
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 PATCH `
-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/featurestores/FEATURESTORE_ID" | Select-Object -Expand Content
Deberías ver un resultado similar al siguiente. Puedes usar el OPERATION_ID en la respuesta para obtener el estado de la operación.
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.UpdateFeaturestoreOperationMetadata", "genericMetadata": { "createTime": "2021-03-18T21:12:08.373664Z", "updateTime": "2021-03-18T21:12:08.373664Z" } } }
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración para Java incluidas en la guía de inicio rápido de Vertex AI sobre cómo usar bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Vertex AI Java.
Para autenticarte en Vertex AI, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración para Node.js incluidas en la guía de inicio rápido de Vertex AI sobre cómo usar bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Vertex AI Node.js.
Para autenticarte en Vertex AI, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Idiomas adicionales
Si deseas obtener información sobre cómo instalar y usar el SDK de Vertex AI para Python, consulta Cómo usar el SDK de Vertex AI para Python. Si deseas obtener más información, consulta la documentación de referencia del SDK de IA de Vertex para Python.
Borra un almacén de atributos
Borra un almacén de atributos. Si el almacén de atributos incluye tipos y atributos de entidades existentes, habilita el parámetro de consulta force
para borrar el almacén de atributos y todo su contenido.
IU web
Usa otro método. No puedes crear un almacén de atributos desde la consola de Google Cloud.
REST
Para borrar un featurestore y todo su contenido, envía una solicitud DELETE con el método featurestores.delete.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- LOCATION_ID: Región donde se encuentra el featurestore, como
us-central1
. - PROJECT_ID: El ID del proyecto.
- FEATURESTORE_ID: ID del featurestore.
- BOOLEAN: Indica si se debe borrar el almacén de atributos incluso si contiene tipos y características de entidades. El parámetros de búsqueda
force
es opcional y esfalse
de forma predeterminada.
Método HTTP y URL:
DELETE https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID?force=BOOLEAN
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente comando:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID?force=BOOLEAN"
PowerShell
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID?force=BOOLEAN" | 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/operations/OPERATIONS_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.DeleteOperationMetadata", "genericMetadata": { "createTime": "2021-05-03T17:50:21.813112Z", "updateTime": "2021-05-03T17:50:21.813112Z" } }, "done": true, "response": { "@type": "type.googleapis.com/google.protobuf.Empty" } }
Python
Si deseas obtener información para instalar o actualizar el SDK de Vertex AI para Python, consulta Instala el SDK de Vertex AI para Python. Si deseas obtener más información, consulta la documentación de referencia de la API de Python.
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración para Java incluidas en la guía de inicio rápido de Vertex AI sobre cómo usar bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Vertex AI Java.
Para autenticarte en Vertex AI, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración para Node.js incluidas en la guía de inicio rápido de Vertex AI sobre cómo usar bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Vertex AI Node.js.
Para autenticarte en Vertex AI, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
¿Qué sigue?
- Aprende a administrar tipos de entidades y atributos.
- Soluciona problemas comunes de Vertex AI Feature Store (Heredado).