Crie uma instância de loja online

Para configurar a publicação online, primeiro tem de criar uma instância da loja online para a publicação online do Bigtable ou a publicação online otimizada. Para compreender as diferenças entre a publicação online do Bigtable e a publicação online otimizada, consulte Tipos de publicação online.

Tenha em atenção que não pode alterar o tipo de publicação online depois de escolher a publicação online do Bigtable ou a publicação online otimizada ao criar a sua loja online. No entanto, pode alterar a configuração do ponto final de publicação para uma instância da loja online criada para a publicação online otimizada.

Depois de criar a loja online, pode adicionar visualizações de propriedades e associar essas visualizações de propriedades a origens de dados de propriedades no BigQuery.

Pode encriptar a instância da sua loja online especificando uma chave de encriptação gerida pelo cliente (CMEK) quando cria a instância da loja online. Apenas o serviço online do Bigtable suporta a encriptação com uma CMEK. Para saber mais sobre as vantagens de usar uma CMEK e perceber se uma CMEK é útil para a sua loja online, consulte o artigo Vantagens da CMEK.

A utilização de uma CMEK pode envolver custos de utilização adicionais, consoante o tipo de chave que está a ser usada. Para mais informações sobre os preços, consulte os preços do Cloud Key Management Service.

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.

Python

Para usar os Python exemplos nesta página num ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure as Credenciais predefinidas da aplicação com as suas credenciais de utilizador.

    Instale a CLI Google Cloud.

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

    If you're using a local shell, then create local authentication credentials for your user account: 

    gcloud auth application-default login

    You don't need to do this if you're using Cloud Shell.

    If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

Para mais informações, consulte Set up authentication for a local development environment.

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.

    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.

Crie uma loja online para o serviço online do Bigtable

Quando usa o serviço online do Bigtable, tem a opção de encriptar a loja online através de uma CMEK.

Crie uma loja online para o serviço online do Bigtable sem CMEK

Para criar uma instância da loja online para o serviço online do Bigtable com escalabilidade automática, sem especificar uma CMEK, use a Google Cloud consola ou a API REST.

Consola

Use as seguintes instruções para criar uma loja online para a publicação online do Bigtable 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 para aceder à secção Loja online.

  3. Clique em Criar para abrir a página Criar loja online.

  4. Especifique um nome para a loja online.

  5. Opcional: para adicionar etiquetas, clique em Adicionar etiqueta e especifique o nome e o valor da etiqueta. Pode adicionar várias etiquetas a uma loja online.

  6. No campo Escolha uma solução de armazenamento para a sua loja online, clique em Bigtable.

  7. Modifique o número mínimo de nós, o número máximo de nós e o objetivo de utilização da CPU, conforme necessário.

  8. Clique em Criar.

Python

Para saber como instalar ou atualizar o SDK Vertex AI para Python, consulte o artigo Instale o SDK Vertex AI para Python. Para mais informações, consulte a Python documentação de referência da API. 


from google.cloud import aiplatform
from vertexai.resources.preview import feature_store


def create_bigtable_feature_online_store_sample(
    project: str,
    location: str,
    feature_online_store_id: str,
):
    aiplatform.init(project=project, location=location)
    fos = feature_store.FeatureOnlineStore.create_bigtable_store(
        feature_online_store_id
    )
    return fos
  • project: o ID do seu projeto.
  • location: região onde a loja online está localizada, como us-central1.
  • feature_online_store_id: o nome da nova instância do FeatureOnlineStore.

REST

Para criar um recurso FeatureOnlineStore, envie um pedido POST através do método featureOnlineStores.create.

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

  • LOCATION_ID: região onde quer criar a loja online, como us-central1.
  • PROJECT_ID: o ID do seu projeto.
  • FEATUREONLINESTORE_NAME: o nome da nova instância da loja online.
  • BOOLEAN: opcional: para criar uma loja online que suporte a gestão de incorporações, introduza true. O valor predefinido é false.

Método HTTP e URL: 

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

Corpo JSON do pedido: 

{
  "bigtable": {
    "auto_scaling": {
      "min_node_count": 1,
      "max_node_count": 3,
      "cpu_utilization_target": 50
    }
  }
}

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

curl

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte 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/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

PowerShell

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte 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/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

Crie uma loja online que use uma CMEK

Use os passos seguintes para criar uma instância da loja online para o serviço online do Bigtable encriptada com uma CMEK.

A utilização de uma encriptação CMEK pode envolver custos de utilização adicionais, consoante o tipo de chave que está a ser usada. Para mais informações sobre os preços, consulte os preços do Cloud Key Management Service.

  1. Use o Cloud Key Management Service para configurar uma chave de encriptação gerida pelo cliente.

  2. Para criar um recurso FeatureOnlineStore, envie o seguinte pedido POST através do método featureOnlineStores.create e especificando a CMEK.

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

    • LOCATION_ID: região onde quer criar a loja online, como us-central1.
    • PROJECT_ID: o ID do seu projeto.
    • FEATUREONLINESTORE_NAME: o nome da nova instância da loja online.
    • BOOLEAN: opcional: para criar uma loja online que suporte a gestão de incorporações, introduza true. O valor predefinido é false.
    • KEY_NAME: o nome da chave de encriptação que quer usar para esta loja de metadados.

    Método HTTP e URL: 

    POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

    Corpo JSON do pedido: 

    {
  "bigtable": {
    "auto_scaling": {
      "min_node_count": 1,
      "max_node_count": 3,
      "cpu_utilization_target": 50
    }
  },
  "encryption_spec": {
    "kms_key_name": "KEY_NAME"
  }
}

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

    curl

    Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte 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/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

    PowerShell

    Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte 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/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

    Deve receber uma resposta JSON semelhante à seguinte:

    {
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

Crie uma loja online para o serviço online otimizado

Quando usa a publicação online otimizada, pode configurar a loja online para publicar caraterísticas a partir de um ponto final público ou de um ponto final do Private Service Connect dedicado. Use um ponto final do Private Service Connect se quiser publicar funcionalidades numa rede VPC com latências inferiores às de um ponto final público.

Crie uma loja online para publicação online otimizada com um ponto final público

Use os exemplos seguintes para criar uma loja online para publicação online otimizada com um ponto final público.

Consola

Siga as instruções abaixo para criar uma loja online para publicação online otimizada 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 para aceder à secção Loja online.

  3. Clique em Criar para abrir a página Criar loja online.

  4. Especifique um nome para a loja online.

  5. Opcional: para adicionar etiquetas, clique em Adicionar etiqueta e especifique o nome e o valor da etiqueta. Pode adicionar várias etiquetas a uma loja online.

  6. No campo Escolha uma solução de armazenamento para a sua loja online, clique em Otimizado.

  7. Clique em Criar.

Python

Para saber como instalar ou atualizar o SDK Vertex AI para Python, consulte o artigo Instale o SDK Vertex AI para Python. Para mais informações, consulte a Python documentação de referência da API. 


from google.cloud import aiplatform
from vertexai.resources.preview import feature_store


def create_optimized_public_feature_online_store_sample(
    project: str,
    location: str,
    feature_online_store_id: str,
):
    aiplatform.init(project=project, location=location)
    fos = feature_store.FeatureOnlineStore.create_optimized_store(
        feature_online_store_id
    )
    return fos
  • project: o ID do seu projeto.
  • location: região onde quer criar a instância do FeatureOnlineStore, como us-central1.
  • feature_online_store_id: o nome da nova instância do FeatureOnlineStore.

REST

Para criar uma instância de loja online, envie um pedido POST através do método featureOnlineStores.create.

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

  • LOCATION_ID: região onde quer criar a instância do FeatureOnlineStore, como us-central1.
  • PROJECT_ID: o ID do seu projeto.
  • FEATUREONLINESTORE_NAME: o nome da nova instância do FeatureOnlineStore.

Método HTTP e URL: 

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

Corpo JSON do pedido: 

{
  "optimized": {}
}

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

curl

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte 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/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

PowerShell

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte 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/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

Crie uma loja online para o serviço online otimizado com um ponto final do Private Service Connect

Use os seguintes exemplos para criar uma loja online para o serviço online otimizado com o Private Service Connect.

Python

Para saber como instalar ou atualizar o SDK Vertex AI para Python, consulte o artigo Instale o SDK Vertex AI para Python. Para mais informações, consulte a Python documentação de referência da API. 


from typing import List

from google.cloud import aiplatform
from vertexai.resources.preview import feature_store


def create_optimized_private_feature_online_store_sample(
    project: str,
    location: str,
    feature_online_store_id: str,
    project_allowlist: List[str],
):
    aiplatform.init(project=project, location=location)
    fos = feature_store.FeatureOnlineStore.create_optimized_store(
        name=feature_online_store_id,
        enable_private_service_connect=True,
        project_allowlist=project_allowlist,
    )
    return fos
  • project: o ID do seu projeto.
  • location: região onde quer criar a instância do FeatureOnlineStore, como us-central1.
  • feature_online_store_id: o nome da nova instância do FeatureOnlineStore.
  • project_allowlist: a lista de nomes de projetos a serem incluídos na lista de autorizações para o Private Service Connect (PSC).

REST

Para criar uma instância de loja online, envie um pedido POST através do método featureOnlineStores.create.

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

  • LOCATION_ID: região onde quer criar a instância do FeatureOnlineStore, como us-central1.
  • PROJECT_ID: o ID do seu projeto.
  • FEATUREONLINESTORE_NAME: o nome da nova instância do FeatureOnlineStore.
  • PROJECT_NAMES: a lista de nomes de projetos a serem incluídos na lista de autorizações para o Private Service Connect (PSC).

Método HTTP e URL: 

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

Corpo JSON do pedido: 

{
  "optimized": {},
  "dedicated_serving_endpoint": {
    "private_service_connect_config": {
      "enable_private_service_connect": true,
      "project_allowlist": ["PROJECT_NAMES"]
    }
  }
}

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

curl

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte 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/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

PowerShell

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte 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/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

O que se segue?