Integre o Spanner com o IntelliJ

Esta página descreve como estabelecer ligação a uma base de dados do Spanner no IntelliJ e noutros produtos da JetBrains.

O IntelliJ IDEA é um ambiente de programação integrado para desenvolver software em Java, Kotlin, Groovy e outras linguagens baseadas na JVM.

Esta página pressupõe que já tem o IntelliJ ou outro IDE da JetBrains instalado no seu computador.

Associe ao Spanner

A ligação do IntelliJ à sua base de dados do Spanner permite-lhe executar consultas e outras declarações SQL na sua base de dados do Spanner diretamente a partir do IntelliJ. Também permite a conclusão e a validação de código para nomes de tabelas e colunas no seu código.

Pode estabelecer ligação a bases de dados com dialeto GoogleSQL e bases de dados com dialeto PostgreSQL seguindo estes passos:

  1. No IntelliJ, clique na opção de menu File > New > Datasource > Google Spanner. O controlador Google Spanner encontra-se no submenu Other se não tiver usado este controlador anteriormente.

  2. Na janela Origens de dados, introduza o ID do projeto, da instância e da base de dados.

  3. Opcional: selecione um ficheiro de chave de conta de serviço se quiser fazer a autenticação através de uma conta de serviço. Selecione No Auth no menu pendente Credenciais se quiser usar as suas credenciais predefinidas. Associe à janela
da ferramenta Spanner

  4. Clique em OK para criar a origem de dados. A base de dados do Spanner é adicionada à janela Database no IntelliJ.

  5. Na janela Bases de dados, expanda a origem de dados que acabou de adicionar. Em seguida, clique no botão ... junto ao texto No schemas selected.

  6. Selecione a opção All schemas para dar instruções ao IntelliJ para inspecionar todos os esquemas na base de dados. Em seguida, o IntelliJ preenche a vista da base de dados com todas as tabelas e vistas na sua base de dados.

    Ligue à janela da ferramenta Spanner

Estabeleça ligação ao Spanner Emulator

Também pode ligar o IntelliJ a uma base de dados no emulador do Spanner:

  1. Primeiro, inicie o emulador com um dos seguintes comandos:

    1. gcloud emulators spanner start
    2. docker run -p 9010:9010 -p 9020:9020 gcr.io/cloud-spanner-emulator/emulator
  2. Clique na opção de menu File > New > Datasource > Google Spanner. O controlador Google Spanner encontra-se no submenu Other se não tiver usado este controlador anteriormente.

  3. Introduza o ID do projeto, da instância e da base de dados. NOTE: o projeto, a instância e a base de dados não têm de existir no emulador.

  4. Selecione No Auth no menu pendente Credenciais.

  5. Clique no separador Advanced na janela Origens de dados.

  6. Modifique o valor de autoConfigEmulator para true.

  7. Clique em OK para aceitar todas as alterações. O projeto, a instância e a base de dados são criados automaticamente no emulador se ainda não existirem.

    Ligue à janela da ferramenta Spanner

  8. Na janela Bases de dados, expanda a origem de dados que acabou de adicionar. Clique no botão ... junto ao texto No schemas selected.

  9. Selecione a opção All schemas para dar instruções ao IntelliJ para inspecionar todos os esquemas na base de dados. Em seguida, o IntelliJ preenche a vista da base de dados com todas as tabelas e vistas na sua base de dados.

O que se segue?