Visualizações de recursos em lista

É possível recuperar uma lista de todas as instâncias de visualização de recursos criadas em uma loja on-line no projeto Google Cloud . Para cada visualização de recurso, também é possível ver a fonte de dados de recursos, que pode ser uma das seguintes:

  • Um ou mais grupos de recursos e os elementos constituintes deles. Cada grupo de recursos está associado a uma fonte de dados de elementos, como uma tabela ou visualização do BigQuery. Cada recurso designa uma coluna na fonte de dados do BigQuery.

  • Uma tabela ou visualização do BigQuery diretamente associada à visualização do recurso.

Se uma visualização de recursos estiver configurada para usar uma conta de serviço dedicada, os detalhes dela também vão incluir o endereço de e-mail da conta de serviço associada. Para mais informações sobre como criar visualizações de recursos com configurações de conta de serviço dedicadas, consulte Configurar a conta de serviço para uma visualização de recursos.

Antes de começar

Faça a autenticação na Vertex AI, a menos que já tenha feito isso.

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 as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.

    After installing the Google Cloud CLI, initialize it by running the following command: 

    gcloud init

    If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Listar visualizações de recursos em uma loja on-line

Use os exemplos a seguir para recuperar uma lista de visualizações de atributos criadas para uma loja on-line no seu projeto para um local específico.

Console

Use as instruções a seguir para consultar a lista de visualizações de recursos em uma loja on-line usando o Google Cloud console.

  1. Na seção Vertex AI do Google Cloud console, acesse a página Feature Store.

    Acessar a página da Feature Store

  2. Clique em Loja on-line.

  3. Clique no nome da loja on-line para ver as informações na página Detalhes da loja on-line.

  4. Na seção Visualizações de recursos, é possível visualizar a lista de todas as lojas on-line do local selecionado.

REST

Para recuperar uma lista de todas as instâncias de FeatureView criadas em uma loja on-line específica do projeto, envie uma solicitação GET usando featureViews.list.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • LOCATION_ID: região em que a loja on-line está localizada, como us-central1.
  • PROJECT_ID: o ID do projeto.
  • FEATUREONLINESTORE_NAME: o nome da loja on-line que contém a lista de visualizações de elementos que você quer ver.

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 a solicitação, 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
Você receberá uma resposta JSON semelhante a seguinte. Se alguma das visualizações de recursos listadas na resposta tiver uma configuração de conta de serviço dedicada, o endereço de e-mail da conta de serviço também será listado nos detalhes. Neste exemplo, SERVICE_ACCOUNT_EMAIL é o endereço de e-mail da conta de serviço associado à visualização 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",
            ]
          }
        ]
      }
    }
  ]
}

A seguir