Crea un atributo

Puedes crear un atributo después de crear un grupo de atributos y asociar una tabla de BigQuery o una vista de BigQuery con él. Puedes crear varios atributos para un grupo de atributos y asociar cada uno con una columna específica en la fuente de datos de BigQuery. Para obtener información sobre cómo usar BigQuery, consulta la documentación de BigQuery.

Por ejemplo, si el grupo de atributosfeaturegroup1 está asociado con la tabla de BigQuerydatasource_1 que contenga valores de atributos en las columnasfval1 yfval2 puede crear una funciónfeature_1 enfeaturegroup1 y asociarlo con los valores de atributos en la columnafval1. De manera similar, puedes crear otro atributo llamado feature_2 y asociarlo con los valores de los atributos de la columna fval2.

Registrar tu fuente de datos mediante grupos de funciones y funciones tiene las siguientes ventajas:

  • Puedes definir una vista de atributos para la entrega en línea mediante columnas de atributos específicas de varias fuentes de datos de BigQuery.

  • Puedes dar formato a tus datos como una serie temporal si incluyes la columna feature_timestamp. Vertex AI Feature Store solo entrega los valores de atributos más recientes de los datos de los atributos y excluye los valores históricos.

Usa las siguientes muestras para crear un atributo dentro de un grupo de atributos y asociar una columna que contenga valores de atributos de la fuente de datos de BigQuery registrada para el grupo de atributos.

Console

Usa las siguientes instrucciones para agregar funciones a un grupo de funciones existente con la consola de Google Cloud.

  1. 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

  2. En la sección Grupos de atributos, haz clic en en la fila correspondiente al grupo de atributos en el que deseas agregar un atributo y, luego, haz clic en Agregar funciones.

  3. Para cada atributo, ingresa un Nombre del atributo y haz clic en el nombre de la columna de origen de BigQuery correspondiente en la lista. Para agregar más atributos, haz clic en Agregar otro atributo.

  4. Haz clic en Crear.

REST

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

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

  • LOCATION_ID: región donde se encuentra el grupo de atributos, como us-central1.
  • PROJECT_ID: ID del proyecto
  • FEATUREGROUP_NAME: Es el nombre del grupo de atributos en el que deseas crear el atributo.
  • FEATURE_NAME: El nombre del atributo nuevo que deseas crear.
  • VERSION_COLUMN_NAME: Es la columna de la tabla o vista de BigQuery que deseas asociar a la función (opcional). Si no especificas este parámetro, se establece de forma predeterminada en FEATURE_NAME.

Método HTTP y URL: 

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATUREGROUP_NAME/features?feature_id=FEATURE_NAME

Cuerpo JSON de la solicitud:

{
  "version_column_name": "VERSION_COLUMN_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/featureGroups/FEATUREGROUP_NAME/features?feature_id=FEATURE_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/featureGroups/FEATUREGROUP_NAME/features?feature_id=FEATURE_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/featureGroups/FEATUREGROUP_NAME/features/FEATURE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.UpdateFeatureOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T02:36:22.870679Z",
      "updateTime": "2023-09-18T02:36:22.870679Z"
    }
  }
}

¿Qué sigue?