Crie e consulte uma base de dados do Cloud SQL para PostgreSQL através da Google Cloud consola

Saiba como criar e consultar uma base de dados do Cloud SQL para PostgreSQL através da Google Cloud consola. Este início rápido destina-se a profissionais de bases de dados que procuram uma introdução rápida ao Cloud SQL para PostgreSQL. O início rápido explica os passos necessários para concluir as seguintes tarefas:

  • Crie uma instância do Cloud SQL para PostgreSQL
  • Crie uma base de dados
  • Crie um esquema
  • Criar uma tabela
  • Inserir dados
  • Consultar os dados que inseriu
  • Limpe os seus recursos

À medida que avança, mantenha os valores predefinidos das definições, salvo indicação em contrário.

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 estiver a usar um projeto existente para este guia, verifique se tem as autorizações necessárias para concluir este guia. Se criou um novo projeto, já tem as autorizaçõ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 estiver a usar um projeto existente para este guia, verifique se tem as autorizações necessárias para concluir este guia. Se criou um novo projeto, já tem as autorizaçõ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 necessárias

    Para receber as autorizações de que precisa para concluir este início rápido, peça ao seu administrador para lhe conceder a função de IAM administrador do Cloud SQL (roles/cloudsql.admin) no projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

    Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

    Crie uma instância do Cloud SQL para PostgreSQL

    Crie uma instância na Google Cloud consola com as seguintes definições. Para todas as outras definições, mantenha os valores predefinidos.

    1. Aceda à página Instâncias do Cloud SQL na Google Cloud consola.
      Aceda à página Instâncias do Cloud SQL
    2. Clique em Criar instância.
    3. Clique em Escolher Cloud SQL para PostgreSQL.
    4. Em Escolha uma edição do Cloud SQL, escolha Enterprise.
    5. Para Predefinição de edição, selecione Sandbox.
    6. Para o ID da instância, introduza quickstart-instance.
    7. Introduza uma palavra-passe para a conta de utilizador predefinida e guarde-a para utilização futura.
    8. Escolha uma região perto de si.
    9. Em Disponibilidade zonal, selecione Zona única.
    10. Clique em Criar instância e, de seguida, aguarde até que a instância seja inicializada e iniciada. O processo de inicialização pode demorar mais de cinco minutos.

    Crie uma base de dados

    Depois de criar o quickstart-instance, pode criar uma base de dados na sua instância do Cloud SQL para PostgreSQL.

    1. No menu de navegação da instância, clique em Bases de dados.
    2. Clique em Criar uma base de dados.
    3. No campo de texto Nome da base de dados, introduza quickstartdb.
    4. Clique em Criar.

    Adicionar um utilizador

    Antes de poder ler ou escrever na base de dados, tem de criar um utilizador da base de dados que seja diferente do utilizador raiz.

    1. No menu de navegação da instância, clique em Utilizadores.
    2. Clique em Adicionar conta de utilizador.
    3. No painel apresentado, selecione Autenticação integrada.
    4. No campo Nome de utilizador, introduza quickstart-user.
    5. Introduza uma palavra-passe para o novo utilizador. Guarde esta palavra-passe para utilização futura.
    6. Clique em Adicionar.

    Crie um esquema

    Depois de criar a instância e a base de dados, pode navegar para o Cloud SQL Studio e usar o editor de consultas para criar um esquema.

    1. No menu de navegação da instância, clique em Cloud SQL Studio. É apresentada uma caixa de diálogo.
    2. No menu pendente Base de dados, escolha quickstartdb.
    3. Selecione Autenticação de base de dados incorporada.
    4. No menu pendente Utilizador, selecione quickstart-user.
    5. No campo Palavra-passe, introduza a palavra-passe que escolheu para o utilizador na secção Adicionar um utilizador.
    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 declaração SQL, clique em Formatar.

    10. Clique em Executar. O painel de resultados apresenta uma mensagem de êxito.

    Criar uma tabela

    Agora, crie uma tabela com o esquema que criou.

    1. Clique em Novo separador para abrir um novo separador do editor de consultas.
    2. Cole a seguinte declaraçã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 declaração SQL, clique em Formatar.

    4. Clique em Executar. O painel de resultados apresenta uma mensagem de êxito.

    A base de dados quickstartdb tem agora uma tabela com as colunas para armazenar os seguintes dados:

    • Uma coluna de ID do utilizador com incremento automático configurada para ser a chave principal da tabela
    • Nome próprio
    • Última inicial
    • Data de nascimento

    Inserir dados

    Para preencher a tabela quickstart_table com alguns dados, siga estes passos:

    1. Clique em Novo separador para abrir um novo separador do editor de consultas.
    2. Cole a seguinte declaraçã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 corretamente a declaração SQL, clique em Formatar.

    4. Clique em Executar. O painel de resultados apresenta uma mensagem de êxito.

    Consultar a base de dados

    Agora, pode executar consultas nos dados da tabela que criou.

    Selecionar todos os registos

    Para obter todos os registos na tabela, faça o seguinte:

    1. Clique em Novo separador para abrir um novo separador do editor de consultas.

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

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

      Os resultados da consulta são semelhantes aos seguintes:

      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

    Execute uma declaração de seleção filtrada

    Para obter o User ID e o nome próprio dos utilizadores nascidos a 1 de janeiro de 2000 ou após essa data, especifique as colunas e use uma cláusula WHERE:

    1. Clique em Novo separador para abrir um novo separador do editor de consultas.
    2. Cole a seguinte declaraçã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 aos seguintes:

      UserID

      FirstName

      4

      Luka

      5

      Taylor

    Limpar

    Para evitar incorrer em cobranças na sua Google Cloud conta pelos recursos usados nesta página, siga estes passos.

    Desative a proteção contra eliminação e, em seguida, elimine a instância de início rápido:

    1. No menu de navegação da instância, clique em Vista geral.
    2. Clique em Edit.
    3. Expanda a secção Proteção de dados.
    4. Em Proteção contra eliminação de instâncias, desmarque todas as opções.
    5. Clique em Guardar. A opção Eliminar já está selecionável.
    6. Clique em Eliminar. É apresentada uma caixa de diálogo.
    7. No campo ID da instância, introduza quickstart-instance.
    8. Clique em Eliminar.

    O que se segue?