Partilhar via


SQLConfigDataSource (Driver do Access)

Observação

Este tópico fornece informações específicas do Driver de Acesso. Para obter informações gerais sobre essa função, consulte o tópico apropriado em Referência de API ODBC.

A função SQLConfigDataSource usada para adicionar, modificar ou excluir uma fonte de dados usa dinamicamente as palavras-chave a seguir.

Palavra-chave Descrição
COLLATINGSEQUENCE A sequência na qual os campos são classificados.

Isso define a mesma opção que Agrupar Sequência na caixa de diálogo de configuração.
COMPACT_DB Executa a compactação de dados em um arquivo de banco de dados. Tem o seguinte formato: COMPACT_DB=<path_name><optionaL_sort_order><palavra-chave> ENCRYPT opcional.

Ao usar o COMPACT_DB palavra-chave na mesma instrução com um palavra-chave DSN, esse driver ignora o palavra-chave DSN. Portanto, compactar um banco de dados e especificar um DSN é um processo de duas etapas.
CREATE_DB Cria um arquivo de banco de dados. Tem o seguinte formato: CREATE_DB=<path_name><optional_sort de optional_ENCRYPT palavra-chave ordem><de optional_sort>, em que o nome do caminho é o caminho completo para um banco de dados do Microsoft Access. Um erro será retornado se o nome do caminho especificar um banco de dados existente. A ordem de classificação será como configurada na caixa de diálogo Novo Banco de Dados exibida quando o botão Criar for pressionado na caixa de diálogo Configuração do Microsoft Access. Se nenhuma ordem de classificação for especificada, Geral será usado.

Ao usar o CREATE_DB palavra-chave na mesma instrução com um palavra-chave DSN, esse driver ignora o palavra-chave DSN. Portanto, criar um banco de dados e especificar um DSN é um processo de duas etapas. Ao usar o CREATE_DB palavra-chave, se o nome do caminho do banco de dados do Microsoft Access a ser criado contiver um ou mais espaços, todo o nome do caminho deverá ser colocado entre aspas duplas, conforme mostrado nos seguintes exemplos:

"C:\PROGRAM FILES\COMMON FILES\ MyAccess.mdb"

"C:\PROGRAM FILES\Access2.mdb"

CREATE_DB=C:\TEMP\test.mdb (sem aspas necessárias)
CREATE_SYSDB Cria um arquivo de banco de dados do sistema. Tem o seguinte formato: CREATE_SYSDB=<path-name><optional-sort-order>, em que o nome do caminho é o caminho completo para um banco de dados do Microsoft Access. Um erro será retornado se o nome do caminho especificar um banco de dados existente. A ordem de classificação será configurada na caixa de diálogo Novo Banco de Dados exibida quando o botão Criar for clicado na caixa de diálogo Configuração do Microsoft Access ODBC . Se nenhuma ordem de classificação for especificada, Geral será usado.
CREATE_V2DB Cria um arquivo de banco de dados compatível com o Microsoft Access 2.0. Tem o seguinte formato: CREATE_V2DB=<path-name><optional-sort-order>, em que o nome do caminho é o caminho completo para um banco de dados do Microsoft Access. Um erro será retornado se o nome do caminho especificar um banco de dados existente. A ordem de classificação será como configurada na caixa de diálogo Novo Banco de Dados exibida quando o botão Criar for pressionado na caixa de diálogo Configuração do Microsoft Access. Se nenhuma ordem de classificação for especificada, Geral será usado.

Ao usar o CREATE_V2DB palavra-chave na mesma instrução com um palavra-chave DSN, esse driver ignora o palavra-chave DSN. Portanto, criar um banco de dados e especificar um DSN é um processo de duas etapas.

Ao usar o CREATE_V2DB palavra-chave, se o nome do caminho do banco de dados do Microsoft Access a ser criado contiver um ou mais espaços, todo o nome do caminho deverá ser colocado entre aspas duplas, conforme mostrado nos seguintes exemplos:

"C:\PROGRAM FILES\COMMON FILES\ MyAccess.mdb"

"C:\PROGRAM FILES\Access2.mdb"

CREATE_V2DB=C:\TEMP\test.mdb (sem aspas necessárias)
DBQ O nome do arquivo de banco de dados.

Isso define a mesma opção que o Banco de Dados na caixa de diálogo de configuração.
DEFAULTDIR A especificação de caminho para o arquivo de banco de dados.
DESCRIPTION Uma descrição dos dados na fonte de dados.

Isso define a mesma opção que Descrição na caixa de diálogo de configuração.
DRIVER A especificação de caminho para a DLL do driver.
DRIVERID Uma ID de inteiro para o driver. 25 (Microsoft Access)
FIL Tipo de arquivo MS Access para Microsoft Access
IMPLICITCOMMITSYNC Determina se o driver do Microsoft Access executará commits internos ou implícitos de forma assíncrona. Esse valor é definido inicialmente como "Sim", o que significa que o driver do Microsoft Access aguardará a conclusão de commits em uma transação interna/implícita.

O valor dessa opção não deve ser alterado sem uma consideração cuidadosa das consequências. Para obter mais informações sobre a opção, consulte o Guia do Programador do Mecanismo de Banco de Dados do Microsoft Jet.

Isso define a mesma opção que ImplicitCommitSync na caixa de diálogo de configuração.
MAXBUFFERSIZE O tamanho do buffer interno, em quilobytes, que é usado pelo Microsoft Access para transferir dados de e para o disco. O tamanho do buffer padrão é 2048 KB (exibido como 2048). Qualquer valor inteiro divisível por 256 pode ser usado. Isso define a mesma opção que o Tamanho do Buffer na caixa de diálogo de configuração.
MAXSCANROWS O número de linhas a serem verificadas ao definir o tipo de dados de uma coluna com base nos dados existentes.

Um número de 1 a 16 pode ser inserido para as linhas verificarem. O valor padrão é 8; se estiver definido como 0, todas as linhas serão verificadas. (Um número fora do limite retornará um erro.)

Isso define a mesma opção que Linhas para Verificar na caixa de diálogo de configuração.
PAGETIMEOUT Especifica o período de tempo, em milissegundos, que uma página (se não for usada) permanece no buffer antes de ser removida. O padrão é cinco décimos de segundo (0,5 segundos). Observe que essa opção se aplica a todas as fontes de dados que usam o driver ODBC.

Isso define a mesma opção que o Tempo Limite da Página na caixa de diálogo de configuração.
PWD A senha.
READONLY TRUE para tornar o arquivo somente leitura; FALSE para tornar o arquivo não somente leitura.

Isso define a mesma opção que Somente Leitura na caixa de diálogo de configuração.
REPAIR_DB Repara um banco de dados danificado por uma falha que ocorre durante o processo de confirmação.

Ao usar o REPAIR_DB palavra-chave na mesma instrução com um palavra-chave DSN, esse driver ignora o palavra-chave DSN. Portanto, reparar um banco de dados e especificar um DSN é um processo de duas etapas.
SYSTEMDB Para o driver do Microsoft Access, a especificação de caminho para o arquivo de banco de dados do sistema.

Isso define a mesma opção que o Banco de Dados do Sistema na caixa de diálogo de configuração.
TÓPICOS O número de threads em segundo plano para o mecanismo usar. Esse valor usa como padrão 3, mas pode ser alterado.

Isso define a mesma opção que Threads na caixa de diálogo de configuração.
UID Para o driver do Microsoft Access, o nome de ID de usuário usado para logon.
USERCOMMITSYNC Determina se o driver do Microsoft Access executará transações definidas pelo usuário de forma assíncrona. Esse valor é inicialmente definido como "Sim", o que significa que o driver do Microsoft Access aguardará a conclusão das confirmações em uma transação definida pelo usuário.

O valor dessa opção não deve ser alterado sem considerar cuidadosamente as consequências. Para obter mais informações sobre a opção, consulte o Guia do Programador do Mecanismo de Banco de Dados do Microsoft Jet.

Isso define a mesma opção que UserCommitSync na caixa de diálogo de instalação.