Consulta cómo crear, mostrar, describir, actualizar y eliminar almacenes de características. Una featurestore es un contenedor de nivel superior para tipos de entidades, características y valores de características.
Almacenamiento online y sin conexión
Vertex AI Feature Store (antigua) usa dos métodos de almacenamiento clasificados como almacenamiento online y almacenamiento offline, que tienen precios diferentes. Todos los almacenes de características tienen almacenamiento offline y, opcionalmente, almacenamiento online.
El almacenamiento online conserva los valores de marca de tiempo más recientes de tus funciones para gestionar de forma eficiente las solicitudes de servicio online. Cuando ejecutas un trabajo de importación mediante la API, puedes controlar el trabajo si los datos se escriben en la tienda online. Si se omite la tienda online, no se producirá ninguna carga en los nodos de servicio online. Por ejemplo, cuando ejecutas trabajos de relleno, puedes inhabilitar las escrituras en la tienda online y escribir solo en la tienda offline. Para obtener más información, consulta la marca disableOnlineServing
en la referencia de la API.
Vertex AI Feature Store (antigua) usa el almacenamiento offline para almacenar datos hasta que estos alcancen el límite de conservación o hasta que los elimines. Puedes almacenar datos ilimitados en el almacén sin conexión. Puedes controlar los costes de almacenamiento sin conexión gestionando la cantidad de datos que conservas. También puedes anular el límite de conservación de datos predeterminado de la tienda online de tu almacén de características y el límite de conservación de datos offline de un tipo de entidad. Consulta más información sobre las cuotas y los límites de Vertex AI Feature Store (antigua).
Usa la Google Cloud consola para ver la cantidad de almacenamiento online y offline que estás usando. Consulta las métricas de monitorización Almacenamiento online total y Almacenamiento offline total de tu almacén de características para determinar el uso.
Nodos de entrega online
Los nodos de servicio online proporcionan los recursos de computación que se usan para almacenar y ofrecer valores de características para el servicio online de baja latencia. Estos nodos siempre están en funcionamiento, aunque no estén sirviendo datos. Se te cobra por cada hora de nodo.
El límite de almacenamiento de los nodos de servicio online es de 5 TB por nodo. Consulta más información sobre las cuotas y los límites de Vertex AI Feature Store (antigua).
El número de nodos de servicio online que necesitas es directamente proporcional a los dos factores siguientes:
- Número de solicitudes de publicación online (consultas por segundo) que recibe el almacén de características.
- Número de trabajos de importación que escriben en el almacenamiento online.
Ambos factores influyen en la utilización de la CPU y el rendimiento de los nodos. En la Google Cloud consola, consulte las métricas de lo siguiente:
- Consultas por segundo: número de consultas por segundo a tu almacén de características.
- Recuento de nodos: número de nodos de servicio online.
- Uso de CPU: uso de CPU de los nodos.
Si la utilización de la CPU es constantemente alta, considera aumentar el número de nodos de servicio online de tu almacén de características.
Probar el rendimiento de los nodos de entrega online
Puedes probar el rendimiento de los nodos de servicio online para el servicio de funciones en tiempo real. De esta forma, puede asegurarse de que el almacén de características tenga suficientes recursos de máquina para funcionar dentro de los umbrales de latencia o QPS predeterminados. Puedes realizar estas pruebas en función de varios parámetros de referencia, como QPS, latencia y API. Para consultar directrices y prácticas recomendadas para probar el rendimiento de los nodos de servicio online, consulta Probar el rendimiento de los nodos de servicio online para el servicio en tiempo real en Prácticas recomendadas de Vertex AI Feature Store (antigua).
Además, puedes usar la herramienta de código abierto Vertex AI Benchmarker para hacer pruebas de carga del rendimiento de tus recursos de Feature Store. 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 escalado
Puedes elegir entre las siguientes opciones para configurar el número de nodos de servicio online:
Escalado automático
Si eliges el autoescalado, el almacén de características cambia automáticamente el número de nodos en función del uso de la CPU. El escalado automático analiza los patrones de tráfico para mantener el rendimiento y optimizar los costes añadiendo nodos cuando el tráfico aumenta y eliminándolos cuando disminuye.
El autoescalado funciona bien con patrones de tráfico que experimentan un crecimiento y un descenso graduales. Si usas Vertex AI Feature Store (antigua) de forma intensiva para patrones de tráfico que experimentan fluctuaciones de carga frecuentes, usa el escalado automático para mejorar la eficiencia de los costes.
Asignar un número fijo de nodos
Si asignas un número fijo de nodos, Vertex AI Feature Store (antigua) mantendrá un número constante de nodos independientemente de los patrones de tráfico. El número fijo de nodos permite predecir los costes, y los nodos deberían funcionar bien cuando haya suficientes para gestionar el tráfico. Puedes cambiar manualmente el número de nodos fijos para gestionar los cambios en los patrones de tráfico.
Consideraciones adicionales sobre el autoescalado
Si eliges el autoescalado, debes tener en cuenta cuatro aspectos adicionales:
Después de añadir nodos de publicación online, la tienda online necesita tiempo para reequilibrar los datos. Puede tardar hasta 20 minutos en condiciones de carga antes de que notes una mejora significativa en el rendimiento. Por lo tanto, escalar el número de nodos puede no ser útil para ráfagas cortas de tráfico. Esta limitación se aplica tanto al escalado manual como al autoescalado.
Si envías solicitudes de servicio online al almacén de características sin nodos de servicio online, la operación devuelve un error.
Desactivar el servicio online en tu almacén de características
Si no necesitas el servicio online y quieres evitar que se produzcan cambios en los nodos de servicio online, define el número de nodos de servicio online en cero. Para desactivar el servicio online en tu almacén de características, define la siguiente configuración:
Si usas el ajuste de escala automático, elimina el parámetro
scaling
.Define el número fijo de nodos de servicio online en
0
.
Para obtener más información sobre cómo crear un almacén de características, consulta Crear un almacén de características. Para obtener más información sobre cómo modificar la configuración de un almacén de características, consulta Actualizar un almacén de características.
Si asignas el valor 0
al número de nodos de servicio online, se eliminará toda la tienda online, incluidos sus datos. Si quieres desactivar temporalmente tu tienda online y, después, restaurarla, debes volver a importar los datos eliminados.
Por ejemplo, si defines el número de nodos de entrega online de tu almacén de características en 0
y, a continuación, aprovisionas nodos de entrega online definiendo el número de nodos en 1
o en un valor superior, Vertex AI Feature Store (antigua) no migrará los datos de características eliminados al almacén online. Para volver a llenar su tienda online, debe volver a importar sus datos. Una forma de volver a importar los datos es exportar el historial antes de inhabilitar los nodos de servicio online y, a continuación, importar los datos exportados después de aprovisionar los nodos.
Cuando aprovisione nodos de servicio online, debe esperar a que se complete la operación antes de importar datos nuevos. Las tareas de importación en curso solo se reanudan una vez que se ha completado el aprovisionamiento del nodo de publicación online.
Si envías una solicitud de servicio online al almacén de características sin nodos de servicio online, la solicitud devuelve un error.
Crear un almacén de características
Crea un recurso de featurestore que contenga tipos de entidades y funciones. El
feature store debe estar en la misma ubicación que los datos de origen.
Por ejemplo, si tu almacén de características está en us-central,
, puedes importar datos de archivos de segmentos de Cloud Storage que estén en us-central1
o en la ubicación multirregional de EE. UU., aunque no se admiten datos de origen de segmentos de dos regiones. Del mismo modo, en BigQuery puedes importar datos de tablas que se encuentren en us-central1
o en la multirregión de EE. UU. Para obtener más información, consulta los requisitos de los datos de origen.
La disponibilidad de Vertex AI Feature Store (antigua) puede variar según la ubicación. Para obtener más información, consulta Disponibilidad de las funciones.
UI web
Puedes crear un almacén de características mediante la Google Cloud consola si aún no se ha creado en el Google Cloud proyecto de la región seleccionada. Si ya existe un almacén de características para el proyecto y la región, utiliza otro método.
Para crear un almacén de características con la Google Cloud consola, sigue estos pasos:
- En la sección Vertex AI de la Google Cloud consola, ve a la página Funciones.
- Haz clic en Create featurestore (Crear almacén de características).
- Especifica un nombre para el almacén de características.
- Si quieres activar el servicio online para el almacén de características, haz clic en el interruptor Activar servicio online y define las opciones de escalado.
Para obtener más información sobre las opciones de publicación y escalado online, consulta Nodos de publicación online. - Haz clic en Crear.
Terraform
En el siguiente ejemplo se usa el recurso de Terraform google_vertex_ai_featurestore
para crear un almacén de características con un número de nodos fijo. El nombre del almacén de características es featurestore_yyyyyyyy
, donde yyyyyyyy
es un identificador alfanumérico generado de forma aleatoria.
Para saber cómo aplicar o quitar una configuración de Terraform, consulta Comandos básicos de Terraform.
REST
Para crear un almacén de características, envía una solicitud POST mediante el método featurestores.create.
En el siguiente ejemplo se crea un almacén de características con un recuento de nodos fijo de 1
. El recuento de nodos especifica el número de nodos de servicio online, lo que afecta al número de solicitudes de servicio online que puede gestionar el almacén de características. La latencia podría aumentar si el número de nodos no puede admitir el número de solicitudes entrantes.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- LOCATION_ID: región en la que se crea el almacén de características. Por ejemplo,
us-central1
. - PROJECT_ID: tu ID de proyecto.
- FEATURESTORE_ID: ID del almacén de características.
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ía ver un resultado similar al siguiente. Puedes usar el OPERATION_ID de 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
Para saber cómo instalar o actualizar el SDK de Vertex AI para Python, consulta Instalar el SDK de Vertex AI para Python. Para obtener más información, consulta la documentación de referencia de la API Python.
Java
Antes de probar este ejemplo, sigue las Java instrucciones de configuración de la guía de inicio rápido de Vertex AI con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Java de Vertex AI.
Para autenticarte en Vertex AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Node.js
Antes de probar este ejemplo, sigue las Node.js instrucciones de configuración de la guía de inicio rápido de Vertex AI con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Node.js de Vertex AI.
Para autenticarte en Vertex AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Crear un almacén de características que use una CMEK
Antes de empezar, si no tienes una CMEK (clave de cifrado gestionada por el cliente), usa Cloud Key Management Service para configurar una clave de cifrado gestionada por el cliente y definir los permisos. En el siguiente ejemplo se crea un almacén de características que usa una clave CMEK.
Si Vertex AI pierde el permiso de la clave CMEK asociada, no se podrá acceder a los recursos y valores de los almacenes de características que se hayan cifrado con esa clave hasta que Vertex AI pueda volver a usarla.
Transcurridos 30 días, si Vertex AI sigue sin tener acceso a la clave CMEK, Vertex AI eliminará todos los almacenes de características que se hayan cifrado con esa clave. Cuando crees nuevos almacenes de características, no podrás reutilizar esos nombres.
UI web
Utiliza otro método. No puedes crear un almacén de características desde la consolaGoogle Cloud .
REST
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- LOCATION_ID: región en la que se crea el almacén de características. Por ejemplo,
us-central1
. - PROJECT_ID: .
- FEATURESTORE_ID: ID del almacén de características.
- CMEK_PROJECT: el ID o el número del proyecto que contiene tu CMEK.
- KEY_RING: nombre del conjunto de claves de Cloud Key Management Service en el que se encuentra tu clave de cifrado.
- KEY_NAME: nombre de la clave de cifrado que se va a 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ía ver un resultado similar al siguiente. Puedes usar el OPERATION_ID de 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" } } }
Permiso para mostrar featurestores.
Muestra todas las featurestores de un proyecto.
UI web
- En la sección Vertex AI de la Google Cloud consola, ve a la página Funciones.
- Selecciona una región en la lista desplegable Región.
- En la tabla de funciones, consulta la columna Feature Store para ver los almacenes de características de tu proyecto en la región seleccionada.
REST
Para ver las featurestores de una región concreta de tu proyecto, envía una solicitud GET mediante el método featurestores.list.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- LOCATION_ID: región en la que se encuentra el almacén de características, como
us-central1
. - PROJECT_ID: .
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 comando siguiente:
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 comando siguiente:
$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 siguiente:
{ "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 Java instrucciones de configuración de la guía de inicio rápido de Vertex AI con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Java de Vertex AI.
Para autenticarte en Vertex AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Node.js
Antes de probar este ejemplo, sigue las Node.js instrucciones de configuración de la guía de inicio rápido de Vertex AI con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Node.js de Vertex AI.
Para autenticarte en Vertex AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Idiomas adicionales
Para saber cómo instalar y usar el SDK de Vertex AI para Python, consulta el artículo Usar el SDK de Vertex AI para Python. Para obtener más información, consulta la documentación de referencia de la API del SDK de Vertex AI para Python.
Ver los detalles de Feature Store
Obtiene detalles sobre un almacén de características, como su nombre y su configuración de servicio online. Si usas la Google Cloud consola, también puedes ver las métricas de Cloud Monitoring de los almacenes de características.
UI web
- En la sección Vertex AI de la Google Cloud consola, ve a la página Funciones.
- Selecciona una región en la lista desplegable Región.
- En la tabla de funciones, consulta la columna Feature Store y busca el almacén de características del que quieras ver información.
- Haga clic en el nombre del almacén de características para ver sus métricas de monitorización.
- Haga clic en la pestaña Propiedades para ver la configuración de publicación online de featurestore.
REST
Para obtener detalles sobre un único almacén de características, envía una solicitud GET mediante el método featurestores.get.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- LOCATION_ID: región en la que se encuentra el almacén de características, como
us-central1
. - PROJECT_ID: .
- FEATURESTORE_ID: ID del almacén de características.
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 comando siguiente:
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 comando siguiente:
$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 siguiente:
{ "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 Java instrucciones de configuración de la guía de inicio rápido de Vertex AI con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Java de Vertex AI.
Para autenticarte en Vertex AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Node.js
Antes de probar este ejemplo, sigue las Node.js instrucciones de configuración de la guía de inicio rápido de Vertex AI con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Node.js de Vertex AI.
Para autenticarte en Vertex AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Idiomas adicionales
Para saber cómo instalar y usar el SDK de Vertex AI para Python, consulta el artículo Usar el SDK de Vertex AI para Python. Para obtener más información, consulta la documentación de referencia de la API del SDK de Vertex AI para Python.
Permiso para actualizar una featurestore.
Actualizar una featurestore, por ejemplo, para cambiar el número de nodos de servicio online o actualizar las etiquetas de una featurestore.
UI web
Solo puedes actualizar el número de nodos de servicio online. Para actualizar las etiquetas, usa la API.
- En la sección Vertex AI de la Google Cloud consola, ve a la página Funciones.
- Selecciona una región en la lista desplegable Región.
- En la tabla de funciones, consulte la columna Feature Store y haga clic en el nombre del almacén de características que quiera actualizar.
- Haz clic en Editar configuración para abrir el panel Editar configuración de almacén de características.
- Edita la configuración de Feature Store.
- Haz clic en Actualizar para aplicar los cambios.
REST
Para actualizar un almacén de características, envía una solicitud PATCH mediante el método featurestores.patch.
En el siguiente ejemplo se actualiza el número de nodos de servicio online a 2
para la featurestore. El resto de los ajustes no cambiarán.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- LOCATION_ID: región en la que se encuentra el almacén de características, como
us-central1
. - PROJECT_ID: .
- FEATURESTORE_ID: ID del almacén de características.
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ía ver un resultado similar al siguiente. Puedes usar el OPERATION_ID de 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 Java instrucciones de configuración de la guía de inicio rápido de Vertex AI con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Java de Vertex AI.
Para autenticarte en Vertex AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Node.js
Antes de probar este ejemplo, sigue las Node.js instrucciones de configuración de la guía de inicio rápido de Vertex AI con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Node.js de Vertex AI.
Para autenticarte en Vertex AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Idiomas adicionales
Para saber cómo instalar y usar el SDK de Vertex AI para Python, consulta el artículo Usar el SDK de Vertex AI para Python. Para obtener más información, consulta la documentación de referencia de la API del SDK de Vertex AI para Python.
Eliminar un almacén de características
Elimina una featurestore. Si la featurestore incluye tipos de entidades y características, habilita el parámetro de consulta force
para eliminar la featurestore y todo su contenido.
UI web
Utiliza otro método. No puedes eliminar un almacén de características desde la consolaGoogle Cloud .
REST
Para eliminar un almacén de características y todo su contenido, envía una solicitud DELETE mediante el método featurestores.delete.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- LOCATION_ID: región en la que se encuentra el almacén de características, como
us-central1
. - PROJECT_ID: .
- FEATURESTORE_ID: ID del almacén de características.
- BOOLEAN: indica si se debe eliminar la featurestore aunque contenga tipos de entidades y funciones. El parámetro de consulta
force
es opcional y tiene el valorfalse
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 comando siguiente:
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 comando siguiente:
$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 siguiente:
{ "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
Para saber cómo instalar o actualizar el SDK de Vertex AI para Python, consulta Instalar el SDK de Vertex AI para Python. Para obtener más información, consulta la documentación de referencia de la API Python.
Java
Antes de probar este ejemplo, sigue las Java instrucciones de configuración de la guía de inicio rápido de Vertex AI con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Java de Vertex AI.
Para autenticarte en Vertex AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Node.js
Antes de probar este ejemplo, sigue las Node.js instrucciones de configuración de la guía de inicio rápido de Vertex AI con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Node.js de Vertex AI.
Para autenticarte en Vertex AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Siguientes pasos
- Consulta cómo gestionar tipos de entidades y funciones.
- Soluciona problemas habituales de Vertex AI Feature Store (antigua).