Nesta página, descrevemos o driver JDBC do Spanner, que é recomendado e criado pelo Google.
O Google oferece um driver JDBC de código aberto para o Spanner. O driver de código aberto permite que os aplicativos acessem o Spanner por meio da API Java Database Connectivity (JDBC).
Nesta página, você encontra respostas a perguntas frequentes sobre o driver JDBC do Spanner. Para aprender a usar o driver, consulte Conectar o JDBC a um banco de dados de dialeto GoogleSQL.
Suporte às linguagens de manipulação de dados (DML) e à linguagem de definição de dados (DDL)
O driver JDBC do Spanner oferece suporte a instruções DML e DDL.
Relacionamentos pai-filho e tabela intercalada
Os relacionamentos de tabelas intercaladas são mapeados para relacionamentos de chave estrangeira no JDBC.
No Spanner, um registro na tabela filha intercalada com uma mãe tem a chave primária dependente da chave primária do registro da tabela mãe associada.
O Spanner define a parte da chave primária mãe da tabela filha da chave primária dela como a chave externa, fazendo referência à chave primária da tabela mãe. Dessa forma, é possível navegar pelos relacionamentos de tabela intercalada usando as chamadas de metadados de chave externa em DatabaseMetaData. Leia mais detalhes em Sobre esquemas.
Suporte a tipos de dados
O driver JDBC do Spanner não é compatível com o tipo de dados STRUCT. Todos os outros tipos têm mapeamentos apropriados.
Compatibilidade de índice
É possível usar índices em consultas SELECT usando a sintaxe de consulta apropriada. O driver de código aberto também pode criar e modificar índices como instruções DDL. É possível acessar informações sobre índices específicos usando o método DatabaseMetaData.getIndexInfo().
Suporte a consultas parametrizadas
Esse driver oferece suporte à parametrização de posicionamento.
Pools de conexões
O driver JDBC do Spanner processa o pool internamente monitorando todas as conexões que foram abertas, bem como as propriedades usadas para abrir essas conexões. Essas conexões de pool são reutilizadas, por exemplo, quando é necessária uma nova conexão que tenha as mesmas propriedades de uma conexão atual. Uma conexão é fechada automaticamente se não é usada nos últimos 60 segundos.
Se você quiser fornecer seu próprio pool, use qualquer pool de conexões JDBC padrão. Configure o pool para usar a classe de driver com.google.cloud.spanner.jdbc.JdbcDriver e defina um URL de conexão JDBC válido do Spanner.
Limitações
Os recursos desse driver têm limites definidos pelo sistema subjacente. Consulte as cotas e limites do Spanner.
Suporte
Consulte a página de suporte para mais as opções.
A seguir
Saiba como conectar o JDBC a um banco de dados de dialeto GoogleSQL.