Mostrar vistas de funciones

Puede obtener una lista de todas las instancias de vista de características creadas en una tienda online de su Google Cloud proyecto. En cada vista de características, también puedes ver la fuente de datos de la característica, que puede ser una de las siguientes:

  • Uno o varios grupos de funciones y las funciones que los componen. Cada grupo de características se asocia a una fuente de datos de características, como una tabla o una vista de BigQuery. Cada característica designa una columna de la fuente de datos de BigQuery.

  • Una tabla o vista de BigQuery asociada directamente a la vista de características.

Si una vista de características se configura para usar una cuenta de servicio específica, los detalles de esa vista de características también incluyen la dirección de correo de la cuenta de servicio asociada. Para obtener más información sobre cómo crear vistas de características con configuraciones de cuentas de servicio específicas, consulta Configurar la cuenta de servicio de una vista de características.

Antes de empezar

Autentícate en Vertex AI, a menos que ya lo hayas hecho.

Select the tab for how you plan to use the samples on this page:

Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

REST

Para usar las muestras de la API REST de esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la CLI de gcloud.

    Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando: 

    gcloud init

    Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .

Permiso para mostrar las vistas de características de una tienda online.

Usa los siguientes ejemplos para obtener una lista de vistas de características creadas para una tienda online de tu proyecto en una ubicación específica.

Consola

Sigue estas instrucciones para ver la lista de vistas de funciones de una tienda online mediante la Google Cloud consola.

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

    Ir a la página Feature Store

  2. Haz clic en Tienda online.

  3. Haga clic en el nombre de la tienda online para ver sus detalles en la página Detalles de la tienda online.

  4. En la sección Vistas de funciones, puede ver la lista de todas las tiendas online de la ubicación seleccionada.

REST

Para obtener una lista de todas las instancias de FeatureView creadas en una tienda online específica de tu proyecto, envía una solicitud GET mediante el método featureViews.list.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • LOCATION_ID: región en la que se encuentra la tienda online, como us-central1.
  • PROJECT_ID: tu ID de proyecto.
  • FEATUREONLINESTORE_NAME: el nombre de la tienda online de la que quiere ver la lista de vistas de funciones.

Método HTTP y URL: 

GET https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews

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/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews"

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/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la siguiente. Si alguna de las vistas de características que se enumeran en la respuesta tiene una configuración de cuenta de servicio específica, la dirección de correo de la cuenta de servicio también se incluye en sus detalles. En este ejemplo, SERVICE_ACCOUNT_EMAIL es la dirección de correo de la cuenta de servicio asociada a la vista de la función FEATUREVIEW_NAME_1. 
{
  "featureViews": [
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME_1",
      "createTime": "2023-09-06T23:46:49.936284Z",
      "updateTime": "2023-09-06T23:46:49.936284Z",
      "etag": "sample_etag",
      "featureRegistrySource": {
        "featureGroups": [
          {
            "featureGroupId": "FEATUREGROUP_ID",
            "featureIds": [
              "FEATURE_ID_1",
              "FEATURE_ID_2",
            ]
          }
        ]
      }
      "serviceAccountEmail": "SERVICE_ACCOUNT_EMAIL"
    },
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME_2",
      "createTime": "2024-02-05T23:48:49.936284Z",
      "updateTime": "2024-02-05T23:48:49.936284Z",
      "etag": "sample_etag",
      "featureRegistrySource": {
        "featureGroups": [
          {
            "featureGroupId": "FEATUREGROUP_ID",
            "featureIds": [
              "FEATURE_ID_3",
              "FEATURE_ID_4",
            ]
          }
        ]
      }
    }
  ]
}

Siguientes pasos