# Sintaxe da URL de conexão com banco de dados para aplicativos com bancos de dados incorporados

Para aplicativos com bancos de dados incorporados, a sintaxe da URL de conexão com banco de dados é

    jdbc:derby: [subsubprotocolo:][nomeBancoDados][;atributos]*

- jdbc:derby:

  No jargão do JDBC, derby é o subprotocolo para conectar a um banco de dados Derby. O subprotocolo é sempre derby, não variando.

- O subsubprotocolo:

  O subsubprotocolo, que normalmente não é especificado, especifica onde o Derby procura pelo banco de dados: em um diretório, em um caminho de classe, ou em um arquivo jar. É usado raramente, geralmente em bancos de dado apenas-de-leitura. O subsubprotocolo é um dos seguintes:

  - directory
  - classpath: Os bancos de dados são tratados como apenas-de-leitura, e todos os nomeBancoDados devem começar com pelo menos uma barra, porque são especificados como "relativos" ao diretório do caminho de classes ou arquivo (Não é necessário especificar classpath como sendo o subsubprotocolo; está implícito).
  - Os bancos de dados jar são tratados como bancos de dados apenas-de-leitura.
  jar: requer um elemento adicional, imediatamente antes do nomeBancoDados:

      (caminhoArquivo)

  O caminhoArquivo é o caminho para o arquivo jar ou zip que contém o banco de dados, e inclui o nome do arquivo jar ou zip.

  Para obter exemplos de URLs de conexão com bancos de dados apenas-de-leitura deve ser consultado o Guia do Desenvolvedor do Derby.

- nomeBancoDados

  Deve ser especificado o nomeBancoDados para se conectar a um banco de dados existente ou a um banco de dados novo.

  Pode ser especificado apenas o nome do banco de dados, ou junto com um caminho absoluto ou relativo. Consulte "Conexões padrão - Conectar a bancos de dados no sistema de arquivos", no capítulo 1 do Guia do Desenvolvedor do Derby.

- atributos

  São especificados zero ou mais atributos da URL de conexão com banco de dados, conforme detalhado em Atributos da URL de conexão com o banco de dados Derby.

Tópico pai: java.sql.DriverManager.getConnection
Conceitos relacionados
Sintaxe SQL adicional
Referências relacionadas
Sintaxe da URL de conexão com banco de dados Derby
Atributos da URL de conexão com o banco de dados Derby