Visualizações de funcionalidades de listas

Pode obter uma lista de todas as instâncias de visualização de funcionalidades criadas numa loja online no seu Google Cloud projeto. Para cada visualização de recursos, também pode ver a origem de dados do recurso, que pode ser uma das seguintes:

  • Um ou mais grupos de funcionalidades e as respetivas funcionalidades constituintes. Cada grupo de funcionalidades está associado a uma origem de dados de funcionalidades, como uma tabela ou uma visualização de propriedade do BigQuery. Cada funcionalidade designa uma coluna na origem de dados do BigQuery.

  • Uma tabela ou uma vista do BigQuery diretamente associada à vista de recursos.

Se uma visualização de funcionalidades estiver configurada para usar uma conta de serviço dedicada, os detalhes dessa visualização de funcionalidades também incluem o endereço de email da conta de serviço associada. Para mais informações sobre a criação de visualizações de recursos com configurações de contas de serviço dedicadas, consulte o artigo Configure a conta de serviço para uma visualização de recursos.

Antes de começar

Autentique o Vertex AI, a menos que já o tenha feito.

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 os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

    Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

    gcloud init

    Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

Para mais informações, consulte o artigo Autenticar para usar REST na Google Cloud documentação de autenticação.

Apresente vistas de funcionalidades numa loja online

Use os exemplos seguintes para obter uma lista de visualizações de funcionalidades criadas para uma loja online no seu projeto para uma localização específica.

Consola

Siga as instruções abaixo para ver a lista de visualizações de funcionalidades numa loja online através da Google Cloud consola.

  1. Na secção do Vertex AI da Google Cloud consola, aceda à página Feature Store.

    Aceda à página da Feature Store

  2. Clique em Loja online.

  3. Clique no nome da loja online para ver os respetivos detalhes na página Detalhes da loja online.

  4. Na secção Vistas de recursos, pode ver a lista de todas as lojas online para a localização selecionada.

REST

Para obter uma lista de todas as instâncias de FeatureView criadas numa loja online específica no seu projeto, envie um pedido GET através do método featureViews.list.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • LOCATION_ID: região onde a loja online está localizada, como us-central1.
  • PROJECT_ID: o ID do seu projeto.
  • FEATUREONLINESTORE_NAME: o nome da loja online para a qual quer ver a lista de visualizações de funcionalidades.

Método HTTP e URL: 

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

Para enviar o seu pedido, escolha uma destas opções:

curl

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

PowerShell

Execute o seguinte 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/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews" | Select-Object -Expand Content
Deve receber uma resposta JSON semelhante à seguinte. Se alguma das visualizações de funcionalidades listadas na resposta tiver uma configuração de conta de serviço dedicada, o endereço de email da conta de serviço também é apresentado nos respetivos detalhes. Neste exemplo, SERVICE_ACCOUNT_EMAIL é o endereço de email da conta de serviço associado à vista de recursos 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",
            ]
          }
        ]
      }
    }
  ]
}

O que se segue?