Driver JDBC do Spanner

Nesta página, descrevemos o driver JDBC do Spanner, recomendada e criada 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, você encontra respostas a perguntas frequentes sobre o driver JDBC do Spanner. Para aprender a usar o motorista, consulte Conecte 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.

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 sua chave primária dependente da chave primária do registro da tabela pai associado. 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 não oferece suporte ao STRUCT do Spanner tipo de dados. 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 de posicionamento.

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. Configurar o pool para usar a classe do driver com.google.cloud.spanner.jdbc.JdbcDriver e definir um Spanner válido URL de conexão JDBC.

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 de dialeto GoogleSQL.