Criar um modelo de machine learning no BigQuery ML usando o Trusted Cloud console

Neste documento, mostramos como usar o console Trusted Cloud para criar um modelo do BigQuery ML.

Funções exigidas

  • Para criar um modelo e executar a inferência, você precisa ter as seguintes funções:

    • Editor de dados do BigQuery (roles/bigquery.dataEditor)
    • Usuário do BigQuery (roles/bigquery.user)

Antes de começar

  1. In the Trusted Cloud console, on the project selector page, select or create a Trusted Cloud project.

    Go to project selector

  2. Verify that billing is enabled for your Trusted Cloud project.

  3. Enable the BigQuery and BigQuery Connection APIs.

    Enable the APIs

Pré-requisitos específicos do modelo

Antes de criar um modelo, verifique se você atendeu a todos os pré-requisitos para o tipo de modelo que está criando:

crie um conjunto de dados

Crie um conjunto de dados do BigQuery para conter seus recursos:

Console

  1. No console Trusted Cloud , acesse a página BigQuery.

    Acessar a página do BigQuery

  2. No painel Explorer, clique no nome do seu projeto.

  3. Clique em Conferir ações > Criar conjunto de dados.

  4. Na página Criar conjunto de dados, faça o seguinte:

    • Em ID do conjunto de dados, digite um nome para o conjunto de dados.

    • Em Tipo de local, selecione um local para o conjunto de dados.

    • Clique em Criar conjunto de dados.

bq

  1. Para criar um conjunto de dados, use o comando bq mk com a flag --location:

    bq --location=LOCATION mk -d DATASET_ID

    Substitua:

    • LOCATION: o local do conjunto de dados.
    • DATASET_ID é o ID do conjunto de dados que você está criando.

  2. Confirme se o conjunto de dados foi criado:

    bq ls

Criar um modelo treinado internamente ou externamente

Use este procedimento para criar os seguintes tipos de modelos:

Esses modelos têm diferentes conjuntos de opções de acordo com o tipo. Embora o ajuste automático do BigQuery ML funcione bem na maioria dos casos, você pode ajustar manualmente o modelo como parte do procedimento. Se quiser fazer isso, consulte a documentação do tipo de modelo para saber mais sobre as opções.

Para criar um modelo:

  1. Acessar a página do BigQuery.

    Acessar o BigQuery

  2. No painel Explorer, clique no conjunto de dados que você criou.

  3. Clique em Ver ações ao lado do conjunto de dados e em Criar modelo BQML.

    O painel Criar novo modelo é aberto.

  4. Em Nome do modelo, digite um nome para o modelo.

  5. Se quiser criar uma consulta salva que contenha a instrução CREATE MODEL para o modelo, selecione Salvar consulta .

    1. Em Nome da consulta, digite um nome para a consulta salva.
    2. Em Região, escolha uma região para a consulta salva.

  6. Clique em Continuar.

  7. Na seção Método de criação, selecione Treinar um modelo no BigQuery.

  8. Na seção Objetivo da modelagem, selecione um objetivo para o modelo.

  9. Clique em Continuar.

  10. Na página Opções de modelo, selecione um tipo de modelo. O tipo de modelo que você pode selecionar varia de acordo com o objetivo de modelagem escolhido.

  11. Na seção Dados de treinamento, faça o seguinte:

    • Selecione Tabela/Visualização para receber dados de treinamento de uma tabela ou visualização e, em seguida, selecione o projeto, o conjunto de dados e o nome da visualização ou tabela.
    • Selecione Consulta para receber dados de treinamento de uma consulta salva e selecione a consulta salva.

  12. Em Colunas de rótulo de entrada selecionadas, escolha as colunas da tabela, visualização ou consulta que você quer usar como entrada para o modelo.

  13. Se houver uma seção Opções obrigatórias, especifique as informações da coluna solicitada:

    • Para modelos de classificação e regressão, em INPUT_LABEL_COLS, selecione a coluna que contém os dados de rótulo.

    • Para modelos de fatoração de matrizes, selecione o seguinte:

      • Em RATING_COL, selecione a coluna que contém os dados de classificação.
      • Em USER_COL, selecione a coluna que contém os dados do usuário.
      • Em ITEM_COL, selecione a coluna que contém os dados do item.

    • Para modelos de previsão de série temporal, selecione o seguinte:

      • Para TIME_SERIES_TIMESTAMP_COL, selecione a coluna que contém os pontos de tempo a serem usados no treinamento do modelo.
      • Em TIME_SERIES_DATA_COL, selecione a coluna que contém os dados para previsão.

  14. Opcional: na seção Opcional, especifique valores para outros argumentos de ajuste do modelo. Os argumentos disponíveis variam de acordo com o tipo de modelo que você está criando.

  15. Clique em Criar modelo.

  16. Quando a criação do modelo for concluída, clique em Acessar modelo para conferir os detalhes.

Criar um modelo remoto em um modelo pré-treinado

Use este procedimento para criar os seguintes tipos de modelos remotos:

Para criar um modelo:

  1. Acessar a página do BigQuery.

    Acessar o BigQuery

  2. No painel Explorer, clique no conjunto de dados que você criou.

  3. Clique em Ver ações ao lado do conjunto de dados e em Criar modelo BQML.

    O painel Criar novo modelo é aberto.

  4. Em Nome do modelo, digite um nome para o modelo.

  5. Se quiser criar uma consulta salva que contenha a instrução CREATE MODEL para o modelo, selecione Salvar consulta .

    1. Em Nome da consulta, digite um nome para a consulta salva.
    2. Em Região, escolha uma região para a consulta salva.

  6. Clique em Continuar.

  7. Na seção Método de criação, selecione Conectar ao serviço LLM da Vertex AI e aos serviços da IA do Cloud.

  8. Na página Opções de modelo, selecione Modelos do Google e de parceiros ou Modelos abertos para o tipo de modelo, conforme apropriado para seu caso de uso.

  9. Na seção Conexão remota, faça o seguinte:

    • Se você tiver uma conexão padrão configurada ou se tiver as funções de administrador do BigQuery e administrador do IAM do projeto, selecione Conexão padrão.

    • Se você não tiver uma conexão padrão configurada ou não tiver as funções adequadas, selecione Conexão de recursos do Cloud.

      1. Em Projeto, selecione o projeto que contém a conexão que você quer usar.
      2. Em Local, selecione o local usado pela conexão.

      3. Em Conexão, selecione a conexão a ser usada para o modelo remoto ou Criar nova conexão.

  10. Na seção Opções obrigatórias, faça o seguinte:

    • Para modelos remotos do Google e de parceiros, especifique o endpoint a ser usado. Por exemplo, gemini-2.0-flash. Para mais informações sobre modelos compatíveis, consulte ENDPOINT.
    • Para modelos remotos em modelos abertos, copie e cole o endpoint a ser usado. Esse é o endpoint público compartilhado de um modelo implantado na Vertex AI, no formato https://location-aiplatform.googleapis.com/v1/projects/project/locations/location/endpoints/endpoint_id. Para mais informações, consulte ENDPOINT.

  11. Clique em Criar modelo.

  12. Quando a criação do modelo for concluída, clique em Acessar modelo para conferir os detalhes.

Criar um modelo remoto em um modelo personalizado

Use este procedimento para criar modelos remotos em modelos personalizados implantados na Vertex AI.

Para criar um modelo:

  1. Acessar a página do BigQuery.

    Acessar o BigQuery

  2. No painel Explorer, clique no conjunto de dados que você criou.

  3. Clique em Ver ações ao lado do conjunto de dados e em Criar modelo BQML.

    O painel Criar novo modelo é aberto.

  4. Em Nome do modelo, digite um nome para o modelo.

  5. Se quiser criar uma consulta salva que contenha a instrução CREATE MODEL para o modelo, selecione Salvar consulta .

    1. Em Nome da consulta, digite um nome para a consulta salva.
    2. Em Região, escolha uma região para a consulta salva.

  6. Clique em Continuar.

  7. Na seção Método de criação, selecione Conectar aos endpoints da Vertex AI gerenciados pelo usuário.

  8. Na seção Conexão remota da página Opções de modelo, faça uma das seguintes ações:

    • Se você tiver uma conexão padrão configurada ou se tiver as funções de administrador do BigQuery e administrador do IAM do projeto, selecione Conexão padrão.

    • Se você não tiver uma conexão padrão configurada ou não tiver as funções adequadas, selecione Conexão de recursos do Cloud.

      1. Em Projeto, selecione o projeto que contém a conexão que você quer usar.
      2. Em Local, selecione o local usado pela conexão.

      3. Em Conexão, selecione a conexão a ser usada para o modelo remoto ou Criar nova conexão.

  9. Na seção Opções obrigatórias, especifique o endpoint a ser usado. Este é o endpoint público compartilhado de um modelo implantado na Vertex AI, no formato https://location-aiplatform.googleapis.com/v1/projects/project/locations/location/endpoints/endpoint_id. Veja mais informações em ENDPOINT.

  10. Clique em Criar modelo.

  11. Quando a criação do modelo for concluída, clique em Acessar modelo para conferir os detalhes.

Criar um modelo remoto em um serviço de IA do Cloud

Use este procedimento para criar modelos remotos em serviços de IA do Cloud.

Para criar um modelo:

  1. Acessar a página do BigQuery.

    Acessar o BigQuery

  2. No painel Explorer, clique no conjunto de dados que você criou.

  3. Clique em Ver ações ao lado do conjunto de dados e em Criar modelo BQML.

    O painel Criar novo modelo é aberto.

  4. Em Nome do modelo, digite um nome para o modelo.

  5. Se quiser criar uma consulta salva que contenha a instrução CREATE MODEL para o modelo, selecione Salvar consulta .

    1. Em Nome da consulta, digite um nome para a consulta salva.
    2. Em Região, escolha uma região para a consulta salva.

  6. Clique em Continuar.

  7. Na seção Método de criação, selecione Conectar ao serviço LLM da Vertex AI e aos serviços da IA do Cloud.

  8. Na página Opções de modelo, selecione Serviços de IA do Cloud.

  9. Na seção Conexão remota, faça o seguinte:

    • Se você tiver uma conexão padrão configurada ou se tiver as funções de administrador do BigQuery e administrador do IAM do projeto, selecione Conexão padrão.

    • Se você não tiver uma conexão padrão configurada ou não tiver as funções adequadas, selecione Conexão de recursos do Cloud.

      1. Em Projeto, selecione o projeto que contém a conexão que você quer usar.
      2. Em Local, selecione o local usado pela conexão.

      3. Em Conexão, selecione a conexão a ser usada para o modelo remoto ou Criar nova conexão.

  10. Na seção Opções obrigatórias, selecione o tipo de serviço de IA do Cloud a ser usado.

  11. Na seção Opcional, especifique as informações do processador de documentos se você estiver usando o serviço CLOUD_AI_DOCUMENT_V1. Opcionalmente, você pode especificar informações do reconhecedor de voz se estiver usando o serviço CLOUD_AI_SPEECH_TO_TEXT_V2.

  12. Clique em Criar modelo.

  13. Quando a criação do modelo for concluída, clique em Acessar modelo para conferir os detalhes.

Criar um modelo importado

Use este procedimento para criar modelos do BigQuery ML importando os seguintes tipos de modelos:

Para criar um modelo:

  1. Acessar a página do BigQuery.

    Acessar o BigQuery

  2. No painel Explorer, clique no conjunto de dados que você criou.

  3. Clique em Ver ações ao lado do conjunto de dados e em Criar modelo BQML.

    O painel Criar novo modelo é aberto.

  4. Em Nome do modelo, digite um nome para o modelo.

  5. Se quiser criar uma consulta salva que contenha a instrução CREATE MODEL para o modelo, selecione Salvar consulta .

    1. Em Nome da consulta, digite um nome para a consulta salva.
    2. Em Região, escolha uma região para a consulta salva.

  6. Clique em Continuar.

  7. Na seção Método de criação, selecione Importar modelo.

  8. Na página Opções de modelo, selecione o tipo de modelo que você quer importar.

  9. Em Caminho do GCS, procure ou cole o URI do bucket do Cloud Storage que contém o modelo.

  10. Clique em Criar modelo.

  11. Quando a criação do modelo for concluída, clique em Acessar modelo para conferir os detalhes.