Esta página descreve 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 pela API Java Database Connectivity (JDBC).
Nesta página, respondemos às perguntas frequentes sobre o driver JDBC do Spanner. Para saber como usar o driver, consulte Conectar o JDBC a um banco de dados do GoogleSQL.
Suporte para a linguagem de manipulação de dados (DML) e a linguagem de definição de dados (DDL)
O driver JDBC do Spanner oferece suporte a instruções DML e DDL.
Relações de tabelas pai-filho e intercaladas
Os relacionamentos de tabelas intercaladas são mapeados para relacionamentos de chave estrangeira no JDBC.
No Spanner, um registro na tabela filha intercalada com um pai tem
a chave primária dependente da chave primária do registro da tabela pai 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 os esquemas.
Suporte a tipos de dados
O driver JDBC do Spanner não é compatível com o tipo de dados STRUCT
do Spanner. 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 é compatível com a parametrização posicional.
Pools de conexões
O driver JDBC do Spanner processa o pooling internamente, monitorando todas as conexões abertas, bem como as propriedades de conexão 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
do Spanner válido.
Limitações
Os recursos desse driver têm limites definidos pelo sistema subjacente. Consulte as cotas e os 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 do dialeto GoogleSQL.