Criar e consultar um banco de dados do Cloud SQL para PostgreSQL usando o consoleGoogle Cloud

Aprenda a criar e consultar um banco de dados do Cloud SQL para PostgreSQL usando o consoleGoogle Cloud . Este guia de início rápido é destinado a profissionais de banco de dados que buscam uma introdução rápida ao Cloud SQL para PostgreSQL. O guia de início rápido mostra as etapas necessárias para concluir as seguintes tarefas:

  • Criar uma instância do Cloud SQL para PostgreSQL
  • Criar um banco de dados
  • criar um esquema
  • Criar uma tabela
  • Inserir dados
  • Consultar os dados inseridos
  • Limpe seus recursos

Ao longo do tutorial, mantenha os valores padrão das configurações, a menos que especificado de outra forma.

Antes de começar

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Se você estiver usando um projeto atual para este guia, verifique se tem as permissões necessárias para concluir este guia. Se você criou um novo projeto, já tem as permissões necessárias.

  4. Verify that billing is enabled for your Google Cloud project.

  5. Enable the Cloud SQL, Cloud SQL Admin, and Compute Engine APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

  6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  7. Se você estiver usando um projeto atual para este guia, verifique se tem as permissões necessárias para concluir este guia. Se você criou um novo projeto, já tem as permissões necessárias.

  8. Verify that billing is enabled for your Google Cloud project.

  9. Enable the Cloud SQL, Cloud SQL Admin, and Compute Engine APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

  10. Funções exigidas

    Para receber as permissões necessárias para concluir este guia de início rápido, peça ao administrador para conceder a você o papel do IAM de Administrador do Cloud SQL (roles/cloudsql.admin) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

    Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

    Criar uma instância do Cloud SQL para PostgreSQL

    Crie uma instância no console Google Cloud usando as seguintes configurações. Para todas as outras configurações, mantenha o padrão.

    1. Acesse a página "Instâncias do Cloud SQL" no Google Cloud console.
      Acessar a página "Instâncias" do Cloud SQL
    2. Clique em Criar instância.
    3. Clique em Escolher Cloud SQL para PostgreSQL.
    4. Em Escolher uma edição do Cloud SQL, selecione Enterprise.
    5. Em Predefinição de edição, selecione Sandbox.
    6. Em ID da instância, insira quickstart-instance.
    7. Insira uma senha para a conta de usuário padrão e salve-a para uso futuro.
    8. Escolha uma região perto de você.
    9. Em Disponibilidade por zona, selecione Zona única.
    10. Clique em Criar instância e aguarde até que a instância seja inicializada e iniciada. O processo de inicialização pode levar mais de cinco minutos.

    Criar um banco de dados

    Depois que quickstart-instance for criado, você poderá criar um banco de dados na sua instância do Cloud SQL para PostgreSQL.

    1. No menu de navegação da instância, clique em Bancos de dados.
    2. Clique em Criar um banco de dados.
    3. No campo de texto Nome do banco de dados, insira quickstartdb.
    4. Clique em Criar.

    Adicionar um usuário

    Antes de ler ou gravar no banco de dados, crie um usuário diferente do usuário raiz.

    1. No menu de navegação da instância, clique em Usuários.
    2. Clique em Adicionar conta de usuário.
    3. No painel aberto, selecione Autenticação integrada.
    4. No campo Nome de usuário, digite quickstart-user.
    5. Insira uma senha para o novo usuário. Salve essa senha para uso futuro.
    6. Clique em Adicionar.

    criar um esquema

    Depois de criar a instância e o banco de dados, navegue até o Cloud SQL Studio e use o editor de consultas para criar um esquema.

    1. No menu de navegação da instância, clique em Cloud SQL Studio. Uma caixa de diálogo vai aparecer.
    2. No menu suspenso Banco de dados, escolha quickstartdb.
    3. Selecione Autenticação de banco de dados integrada.
    4. No menu suspenso Usuário, selecione quickstart-user.
    5. No campo Senha, insira a senha escolhida para o usuário na seção Adicionar um usuário.
    6. Clique em Autenticar. O Cloud SQL Studio é aberto.
    7. Clique em Consulta sem título para abrir o editor de consultas.
    8. Cole o seguinte código no editor de consultas:

      CREATE SCHEMA IF NOT EXISTS "myschema";
      
    9. Opcional: para formatar corretamente a instrução SQL, clique em Formatar.

    10. Clique em Executar. O painel de resultados mostra uma mensagem de sucesso.

    Criar uma tabela

    Agora crie uma tabela usando o esquema que você criou.

    1. Clique em Nova guia para abrir uma guia do editor de consultas.
    2. Cole a seguinte instrução no editor de consultas:

      CREATE TABLE IF NOT EXISTS
        "myschema"."quickstart_table" ( "UserId" SERIAL
        PRIMARY KEY
          ,
          "FirstName" VARCHAR(255),
          "LastInitial" VARCHAR(1),
          "BirthDate" DATE );
      
    3. Opcional: para formatar corretamente a instrução SQL, clique em Formatar.

    4. Clique em Executar. O painel de resultados mostra uma mensagem de sucesso.

    O banco de dados quickstartdb agora tem uma tabela com as colunas para armazenar os seguintes dados:

    • Uma coluna de ID do usuário com incremento automático configurada como a chave primária da tabela
    • Nome
    • Última inicial
    • Data de nascimento

    Inserir dados

    Para preencher a tabela quickstart_table com alguns dados, siga estas etapas:

    1. Clique em Nova guia para abrir uma guia do editor de consultas.
    2. Cole a seguinte instrução no editor de consultas:

      INSERT INTO
        "myschema"."quickstart_table" ("FirstName",
          "LastInitial",
          "BirthDate")
      VALUES
        ('Yuri', 'Z', '1999-05-24'),
        ('Cruz', 'S', '1978-11-01'),
        ('Kai', 'D', '1965-12-09'),
        ('Luka', 'L', '2003-04-19'),
        ('Taylor', 'S', '2001-01-31');
      
    3. Opcional: para formatar a instrução SQL corretamente, clique em Formatar.

    4. Clique em Executar. O painel de resultados mostra uma mensagem de sucesso.

    Consultar o banco de dados

    Agora você pode executar consultas nos dados da tabela criada.

    Selecionar todos os registros

    Para recuperar todos os registros na tabela, faça o seguinte:

    1. Clique em Nova guia para abrir uma guia do editor de consultas.

    2. Cole a seguinte instrução no editor de consultas:

      SELECT
        *
      FROM
        "myschema"."quickstart_table"
      
    3. Clique em Executar.

      Os resultados da consulta são semelhantes a estes:

      UserID

      FirstName

      LastInitial

      BirthDate

      1

      Yuri

      Z

      1999-05-24 00:00:00

      2

      Cruz

      S

      1978-11-01 00:00:00

      3

      Kai

      D

      1965-12-09 00:00:00

      4

      Luka

      L

      2003-04-19 00:00:00

      5

      Taylor

      S

      2001-01-31 00:00:00

    Executar uma instrução SELECT filtrada

    Para recuperar o ID e o nome dos usuários nascidos em 1º de janeiro de 2000 ou depois, especifique as colunas e use uma cláusula WHERE:

    1. Clique em Nova guia para abrir uma guia do editor de consultas.
    2. Cole a seguinte instrução no editor de consultas:

      SELECT
        "UserId",
        "FirstName"
      FROM
        "myschema"."quickstart_table"
      WHERE
        "BirthDate" > '1999-12-31';
      
    3. Clique em Executar.

      Os resultados da consulta são semelhantes a estes:

      UserID

      FirstName

      4

      Luka

      5

      Taylor

    Limpar

    Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga as etapas abaixo.

    Desative a proteção contra exclusão e exclua a instância do guia de início rápido:

    1. No menu de navegação da instância, clique em Visão geral.
    2. Clique em Editar.
    3. Expanda a seção Proteção de dados.
    4. Em Proteção contra exclusão de instâncias, desmarque todas as opções.
    5. Clique em Salvar. Agora é possível selecionar Excluir.
    6. Clique em Excluir. Uma caixa de diálogo será exibida.
    7. No campo ID da instância, insira quickstart-instance.
    8. Clique em Excluir.

    A seguir