Inicializando o driver de Fonte de Dados de Texto

Artigo
04/04/2023

Aplica-se ao: Access 2013, Office 2013

O mesmo driver de banco de dados é usado para fontes de dados de texto e para fontes de dados HTML.

Quando você instala o driver de banco de dados fonte de texto, o programa de instalação grava um conjunto de valores padrão no Registro do Microsoft Windows nas subchaves Mecanismos e Formatos ISAM. Você não deve modificar essas configurações diretamente; use o programa de instalação de seu aplicativo para adicionar, remover ou alterar essas configurações. As seções a seguir descrevem a inicialização e as configurações do ISAM Format no driver de banco de dados da fonte de dados de texto.

Configurações de inicialização de fonte de dados de texto

A pasta Access Connectivity Engine\ISAM Formats\Text inclui configurações de inicialização do driver Acetxt.dll, usado para acesso externo ao arquivos de dados de texto. As configurações normais das entradas nessa pasta são mostradas no exemplo a seguir.

    win32=<path>\ ACETXT.DLL 
    
    MaxScanRows=25 
    
    FirstRowHasNames=True 
    
    CharacterSet= ANSI 
    
    Format=CSVDelimited 
    
    Extensions= txt,csv,tab,asc 
    
    ExportCurrencySymbols=Yes

O mecanismo de banco de dados do Microsoft Access usa as entradas da pasta Text da seguinte maneira:

Entrada	Descrição
win32	A localização do arquivo Acetxt.dll. O caminho completo é determinado no momento da instalação. Os valores são do tipo REG_SZ.
MaxScanRows	O número de linhas a serem verificadas ao determinar os tipos de coluna. Se for 0, o arquivo inteiro será pesquisado. O padrão é 25. Os valores são do tipo REG_DWORD.
FirstRowHasNames	Um valor binário que indica se a primeira linha da tabela contém nomes de coluna. Um valor 0 indica que, durante a importação, os nomes de coluna serão extraídos da primeira linha.
Characterset	Um indicador de como as páginas de texto são armazenadas. As configurações possíveis são: ANSI — a página de código ANSI do computador. São feitas as conversões AnsiToUnicode e UnicodeToAnsi. OEM — a página de código OEM do computador. São feitas as conversões OemToUnicode e UnicodeToOem. Unicode — não são feitas conversões de página de código. <número> decimal – o número da página de código de um conjunto de caracteres específico. As conversões de e para Unicode serão feitas. O padrão é ANSI. Os valores são do tipo REG_SZ.
Formatar	Pode ser qualquer um dos seguintes: TabDelimited, CSVDelimited, Delimitado (<caractere> único). O delimitador de um caractere no formato Delimited pode ser qualquer caractere com exceção de aspas ("). O padrão é CSVDelimited. Os valores são do tipo REG_SZ.
Extensões	A extensão de qualquer arquivo a ser pesquisado ao procurar dados baseados em texto. O padrão é txt, csv, tab, asc. Os valores são do tipo REG_SZ.
ExportCurrencySymbols	Um valor binário que indica se o símbolo de moeda apropriado é incluído quando os campos de moeda são exportados. Um valor 01 indica que o símbolo é incluído. Um valor 00 indica que apenas os dados numéricos são exportados. O valor padrão é 01. Os valores são do tipo REG_BINARY.

Formatos ISAM de fonte de dados de texto

A pasta Access Connectivity Engine\ISAM Formats\Text contém as entradas a seguir.

Nome da entrada	Tipo	Valor
Motor	REG_SZ	Texto
ExportFilter	REG_SZ	Arquivos de texto (.txt; .csv; .tab; .asc)
ImportFilter	REG_SZ	Arquivos de texto (.txt; .csv; .tab; .asc)
CanLink	REG_BINARY	01
OneTablePerFile	REG_BINARY	01
IsamType	REG_DWORD	2
IndexDialog	REG_BINARY	00
CreateDBOnExport	REG_BINARY	00
ResultTextImport	REG_SZ	Importar dados do arquivo externo para o banco de dados atual. Alterar dados no banco de dados atual não os alterará no arquivo externo.
ResultTextLink	REG_SZ	Criar uma tabela no banco de dados atual vinculada ao arquivo externo. Alterar dados no banco de dados atual não os alterará no arquivo externo.
ResultTextExport	REG_SZ	Exportar dados do banco de dados atual para um arquivo de texto. Esse processo substituirá os dados quando exportados para um arquivo já existente.
SupportsLongNames	REG_BINARY	01

Observação

[!OBSERVAçãO] When you change Windows Registry settings, you must exit and then restart the database engine for the new settings to take effect.

Formatos ISAM de importação de HTML

A pasta Access Connectivity Engine\ISAM Formats\HTML Import contém as entradas a seguir.

Nome da entrada	Tipo	Valor
Motor	REG_SZ	Texto
ImportFilter	REG_SZ	Arquivos HTML (.ht)
CanLink	REG_BINARY	01
OneTablePerFile	REG_BINARY	00
IsamType	REG_DWORD	2
IndexDialog	REG_BINARY	00
CreateDBOnExport	REG_BINARY	00
ResultTextImport	REG_SZ	Importar dados do arquivo externo para o banco de dados atual. Alterar dados no banco de dados atual não os alterará no arquivo externo.
ResultTextLink	REG_SZ	Criar uma tabela no banco de dados atual vinculada ao arquivo externo. Alterar dados no banco de dados atual não os alterará no arquivo externo.
SupportsLongNames	REG_BINARY	01

Observação

[!OBSERVAçãO] When you change Windows Registry settings, you must exit and then restart the database engine for the new settings to take effect.

Formatos ISAM de exportação html

A pasta Access Connectivity Engine\ISAM Formats\HTML Export contém as entradas a seguir.

Nome da entrada	Tipo	Valor
Motor	REG_SZ	Texto
ExportFilter	REG_SZ	Arquivos HTML (*.htm)
CanLink	REG_BINARY	00
OneTablePerFile	REG_BINARY	01
IsamType	REG_DWORD	2
IndexDialog	REG_BINARY	00
CreateDBOnExport	REG_BINARY	00
ResultTextExport	REG_SZ	Exportar dados do banco de dados atual para um arquivo de texto. Esse processo substituirá os dados quando exportados para um arquivo já existente.
SupportsLongNames	REG_BINARY	01

Observação

[!OBSERVAçãO] When you change Windows Registry settings, you must exit and then restart the database engine for the new settings to take effect.

Personalizando o arquivo Schema.ini para dados de texto e HTML

Para ler, importar ou exportar dados HTML e de texto, você precisa criar um arquivo Schema.ini, bem como incluir as informações ISAM do texto no arquivo .ini. O arquivo Schema.ini contém informações específicas da fonte de dados: como o arquivo de texto está formatado, como ele é lido no momento da importação e o formato de exportação padrão dos arquivos. Os exemplos a seguir mostram o layout de um arquivo de largura fixa, Filename.txt:

    [Filename.txt] 
    
    ColNameHeader=False 
    
    Format=FixedLength 
    
    FixedFormat= RaggedEdge 
    
    MaxScanRows=25 
    
    CharacterSet=OEM 
    
    Col1=columnname Char Width 24 
    
    Col2=columnname2 Date Width 9 
    
    Col3=columnname7 Float Width 10 
    
    Col4=columnname8 Integer Width 10 
    Col5=columnname9 LongChar Width 10

Da mesma maneira, o formato de um arquivo delimitado é especificado assim:

    [Delimit.txt] 
    
    ColNameHeader=True 
    
    Format=Delimited() 
    
    MaxScanRows=0 
    
    CharacterSet=OEM 
    
    Col1=username char width 50 
    
    Col2=dateofbirth Date width 9

Se estiver exportando dados para um arquivo de texto delimitado, especifique o formato desse arquivo também:

    [Export: My Special Export] 
    
    ColNameHeader=True 
    
    Format=TabDelimited 
    
    MaxScanRows=25 
    
    CharacterSet=OEM 
    
    DateTimeFormat=mm.dd.yy.hh.mm.ss 
    
    CurrencySymbol=Dm 
    
    CurrencyPosFormat=0 
    
    CurrencyDigits=2 
    
    CurrencyNegFormat=0 
    
    CurrencyThousandSymbol=, 
    
    CurrencyDecimalSymbol=. 
    
    DecimalSymbol=, 
    
    NumberDigits=2 
    
    NumberLeadingZeros=0 
    
    TextDelimeter="

O exemplo My Special Export refere-se a uma opção de exportação específica; você pode determinar qualquer variação das opções de exportação no momento da conexão. Este último exemplo também corresponde ao nome da fonte de dados (DSN) que pode ser opcionalmente passado no momento da conexão. Todas as três seções de formato podem ser incluídas no arquivo .ini.

O mecanismo de banco de dados do Microsoft Access usa as entradas do Schema.ini da seguinte maneira:

Entrada	Descrição
ColNameHeader	Pode ser True (indicando que o primeiro registro dos dados especifica os nomes das colunas) ou False.
Formatar	Pode ser definido como um dos seguintes valores: TabDelimited, CSVDelimited, Delimitado (<caractere> único) ou FixedLength. O delimitador especificado para o formato de arquivo delimitado pode ser qualquer caractere com exceção de aspas (").
FixedFormat	Usado somente quando Format é FixedLength; pode ser definido como: RaggedEdge ou TrueFixedLength. RaggedEdge permite que as linhas terminem com um caractere de retorno de carro. TrueFixedLength exige que cada linha tenha um número exato de caracteres e qualquer caractere de retorno de carro que não estiver no limite da linha será considerado incorporado ao campo. Se essa configuração não estiver presente, o valor padrão será RaggedEdge.
MaxScanRows	Indica o número de linhas a serem verificadas ao determinar os tipos de dados da coluna. Se estiver definido como 0, o arquivo inteiro será pesquisado.
Characterset	Pode ser definido como OEM, ANSI, UNICODE ou o número decimal de uma página de código válida e indica o conjunto de caracteres do arquivo de origem.
Datetimeformat	Pode ser definida como uma cadeia de caracteres de formatação indicando datas e horas. Essa entrada deverá ser especificada se todos os campos de data/hora na importação/exportação forem tratados como sendo do mesmo formato. Há suporte para todos os formatos do mecanismo de banco de dados Microsoft Jet, com exceção de AM e PM. Na ausência de uma cadeia de caracteres de formatação, as opções de data e hora curtas do Painel de Controle do Windows serão usadas.
CurrencySymbol	Indica o símbolo de moeda a ser usado nos valores de moeda do arquivo de texto. Os exemplos incluem o símbolo do dólar ($) e Dm. Na ausência dessa entrada, o valor padrão do Painel de Controle do Windows será usado.
CurrencyPosFormat	Pode ser definido como qualquer um dos seguintes valores: Conversor de Moedas prefixo de símbolo sem separação (US$ 1) Conversor de Moedas sufixo de símbolo sem separação (1$) Conversor de Moedas prefixo de símbolo com uma separação de caractere (US$ 1) Conversor de Moedas sufixo de símbolo com uma separação de caractere (1 $) Se essa entrada estiver ausente, o valor padrão no Windows Painel de Controle será usado.
CurrencyDigits	Especifica o número de dígitos usados na parte fracional do valor da moeda. Na ausência dessa entrada, o valor padrão do Painel de Controle do Windows será usado.
CurrencyNegFormat	Pode ser um dos seguintes valores: ($1) –$1 $-1 $1– (1$) –1$ 1 a $ 1$– –1 $ –$ 1 $– $1– $–1– $–1– $ ($ 1) ($ 1) ($) (1 $) O sinal de dólar é mostrado para fins deste exemplo, mas deve ser substituído pelo valor currencySymbol apropriado no programa real. Na ausência dessa entrada, o valor padrão do Painel de Controle do Windows será usado.
CurrencyThousandSymbol	Indica o símbolo de um caractere a ser usado para separar os milhares dos valores de moeda no arquivo de texto. Na ausência dessa entrada, o valor padrão do Painel de Controle do Windows será usado.
CurrencyDecimalSymbol	Pode ser definido como qualquer caractere usado para separar a parte fracional do valor da moeda. Na ausência dessa entrada, o valor padrão do Painel de Controle do Windows será usado.
DecimalSymbol	Pode ser definido como qualquer caractere usado para separar o inteiro da parte fracional de um número. Na ausência dessa entrada, o valor padrão do Painel de Controle do Windows será usado.
NumberDigits	Indica o número de dígitos decimais usados na parte fracional de um número. Na ausência dessa entrada, o valor padrão do Painel de Controle do Windows será usado.
NumberLeadingZeros	Especifica se um valor decimal inferior a 1 e superior a –1 deve conter zeros à esquerda; esse valor pode ser False (sem zeros à esquerda) ou True.
Col1, Col2, ...	Lista as colunas do arquivo de texto que devem ser lidas. O formato dessa entrada deve ser: Coln=columnName type [Width #] columnName: nomes de coluna com espaços inseridos devem ser colocados entre aspas. type: pode ser Bit, Byte, Short, Long, Decimal, Currency, Single, Double, DateTime. Binary, OLE, Text ou Memo. Além disso, há suporte para os seguintes tipos de Driver de Texto ODBC: Char (mesmo que Texto) Float (mesmo que Double) Inteiro (mesmo que Short) LongChar (mesmo que Memorando) Formato de data de data No caso de um tipo de memorando, um marcador de formato adicional [Attribute Hyperlink] pode ser usado para especificar colunas que devem ser URLs ativas no Microsoft Access. No caso de um tipo Decimal, marcadores de formato adicionais [Scale #] Precision #] devem ser usados.
TextDelimiter	Pode ser qualquer caractere usado para delimitar cadeias de caracteres que contenham qualquer um dos outros caracteres especiais. Por exemplo, "abc", "xyz,pqr", "hij" Se essa entrada não estiver presente, o delimitador padrão será uma citação dupla. Se essa entrada for a cadeia de caracteres "none", nenhum caractere será tratado como delimitador.

Observação

[!OBSERVAçãO] Ao alterar as configurações do arquivo Schema.ini, você deve fechar e reiniciar o mecanismo de banco de dados para que as novas configurações entrem em vigor.

Inicializando o driver de Fonte de Dados de Texto

Configurações de inicialização de fonte de dados de texto

Formatos ISAM de fonte de dados de texto

Formatos ISAM de importação de HTML

Formatos ISAM de exportação html

Personalizando o arquivo Schema.ini para dados de texto e HTML

Recursos adicionais