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 outros idiomas baseados 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 autenticar através de uma conta de serviço. Selecione No Auth no menu pendente Credenciais se quiser usar as suas credenciais predefinidas. Estabeleça ligação à janela de ferramentas do 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.

    Estabeleça ligação à janela de ferramentas do Spanner

Estabeleça ligação ao emulador do Spanner

Também pode associar 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.

    Estabeleça ligação à janela de ferramentas do 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?