Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
APLICA-SE A:
Azure Data Factory
Azure Synapse Analytics
Gorjeta
Data Factory em Microsoft Fabric é a próxima geração de Azure Data Factory, com uma arquitetura mais simples, IA incorporada e novas funcionalidades. Se és novo na integração de dados, começa pelo Fabric Data Factory. As cargas de trabalho existentes do ADF podem atualizar para o Fabric para aceder a novas capacidades em ciência de dados, análise em tempo real e relatórios.
Este artigo descreve como utilizar a Atividade de Cópia nos pipelines Azure Data Factory e Synapse Analytics para copiar dados de um armazenamento de dados Microsoft Access. Ele se baseia no artigo de visão geral da atividade de cópia que apresenta uma visão geral da atividade de cópia.
Capacidades suportadas
Este conector Microsoft Access é suportado para as seguintes capacidades:
| Capacidades suportadas | IR |
|---|---|
| atividade Copy (fonte/sumidouro) | (2) |
| Atividade de Pesquisa | (2) |
(1) Runtime de integração Azure (2) Runtime de integração auto-hospedado
Para obter uma lista dos repositórios de dados suportados como origens/destinos pela atividade de cópia, consulte a tabela de repositórios de dados suportados.
Pré-requisitos
Para usar este conector Microsoft Access, precisa de:
- Configurar um Self-hosted Integration Runtime. Consulte o artigo Self-hosted Integration Runtime para mais detalhes.
- Instale o driver Microsoft Access ODBC para o armazenamento de dados na máquina de Integration Runtime.
Nota
Este conector funciona com a versão Microsoft Access 2016 do driver ODBC. A versão recomendada do driver é 16.00.5378.1000 ou superior.
Começar
Para executar a atividade de cópia com um pipeline, você pode usar uma das seguintes ferramentas ou SDKs:
- Ferramenta Copiar dados
- Portal do Azure
- .NET SDK
- Python SDK
- Azure PowerShell
- API REST
- Modelo do Azure Resource Manager
Criar um serviço ligado ao Microsoft Access usando a interface de utilizador
Use os passos seguintes para criar um serviço ligado ao Microsoft Access na interface do portal Azure.
Navegue até ao separador Gerir no seu espaço de trabalho Azure Data Factory ou Synapse e selecione Serviços Ligados, depois clique em Novo:
Procure por Access e selecione o conector Microsoft Access.
Configure os detalhes do serviço, teste a conexão e crie o novo serviço vinculado.
Detalhes de configuração do conector
As secções seguintes fornecem detalhes sobre propriedades que são usadas para definir entidades Data Factory específicas do conector Microsoft Access.
Propriedades do serviço vinculado
As seguintes propriedades são suportadas para o serviço ligado ao Microsoft Access:
| Propriedade | Descrição | Obrigatório |
|---|---|---|
| tipo | A propriedade type deve ser definida como: MicrosoftAccess | Sim |
| connectionString | A string de conexão ODBC excluindo a parte das credenciais. Pode especificar a cadeia de conexão ou usar o DSN do sistema (Data Source Name) que configurou na máquina Integration Runtime (precisa ainda de especificar a parte das credenciais no serviço ligado em conformidade). Também pode colocar uma palavra-passe no Azure Key Vault e extrair a configuração password da cadeia de ligação. Consulte a secção Guardar credenciais no Azure Key Vault para mais detalhes. |
Sim |
| tipoDeAutenticação | Tipo de autenticação usado para se ligar ao armazenamento de dados do Microsoft Access. Os valores permitidos são: Básico e Anônimo. |
Sim |
| nome de utilizador | Especifique o nome de usuário se estiver usando a autenticação Básica. | Não |
| palavra-passe | Especifique a senha para a conta de usuário que você especificou para o userName. Marque este campo como um SecureString para o armazenar de forma segura, ou referencia um segredo guardado em Azure Key Vault. | Não |
| credencial | A parte de credenciais de acesso da cadeia de ligação especificada no formato valor-propriedade específico do driver. Marque este campo como SecureString. | Não |
| conectarVia | O Integration Runtime para ser usado para se ligar ao armazenamento de dados. É necessário um Integration Runtime auto-hospedado, conforme mencionado em Pré-requisitos. | Sim |
Exemplo:
{
"name": "MicrosoftAccessLinkedService",
"properties": {
"type": "MicrosoftAccess",
"typeProperties": {
"connectionString": "Driver={Microsoft Access Driver (*.mdb, *.accdb)};Dbq=<path to your DB file e.g. C:\\mydatabase.accdb>;",
"authenticationType": "Basic",
"userName": "<username>",
"password": {
"type": "SecureString",
"value": "<password>"
}
},
"connectVia": {
"referenceName": "<name of Integration Runtime>",
"type": "IntegrationRuntimeReference"
}
}
}
Propriedades do conjunto de dados
Para obter uma lista completa de seções e propriedades disponíveis para definir conjuntos de dados, consulte o artigo sobre conjuntos de dados. Esta secção fornece uma lista de propriedades suportadas pelo conjunto de dados Microsoft Access.
Para copiar dados do Microsoft Access, são suportadas as seguintes propriedades:
| Propriedade | Descrição | Obrigatório |
|---|---|---|
| tipo | A propriedade type do conjunto de dados deve ser definida como: MicrosoftAccessTable | Sim |
| tableName | Nome da tabela no Microsoft Access. | Não para a origem (se "consulta" na origem da atividade for especificada); Sim para lavatório |
Exemplo
{
"name": "MicrosoftAccessDataset",
"properties": {
"type": "MicrosoftAccessTable",
"linkedServiceName": {
"referenceName": "<Microsoft Access linked service name>",
"type": "LinkedServiceReference"
},
"typeProperties": {
"tableName": "<table name>"
}
}
}
Propriedades da atividade de cópia
Para obter uma lista completa de seções e propriedades disponíveis para definir atividades, consulte o artigo Pipelines . Esta secção fornece uma lista de propriedades suportadas pelo código-fonte Microsoft Access.
Microsoft Access como fonte
Para copiar dados de Microsoft Access, as seguintes propriedades são suportadas na secção de atividade de cópia fonte:
| Propriedade | Descrição | Obrigatório |
|---|---|---|
| tipo | A propriedade type da fonte de atividade de cópia deve ser definida como: MicrosoftAccessSource | Sim |
| consulta | Use a consulta personalizada para ler dados. Por exemplo: "SELECT * FROM MyTable". |
Não (se "tableName" estiver especificado no conjunto de dados) |
Exemplo:
"activities":[
{
"name": "CopyFromMicrosoftAccess",
"type": "Copy",
"inputs": [
{
"referenceName": "<Microsoft Access input dataset name>",
"type": "DatasetReference"
}
],
"outputs": [
{
"referenceName": "<output dataset name>",
"type": "DatasetReference"
}
],
"typeProperties": {
"source": {
"type": "MicrosoftAccessSource",
"query": "SELECT * FROM MyTable"
},
"sink": {
"type": "<sink type>"
}
}
}
]
Microsoft Access como destino
Para copiar dados para Microsoft Access, as seguintes propriedades são suportadas na secção de atividade de cópia sink:
| Propriedade | Descrição | Obrigatório |
|---|---|---|
| tipo | A propriedade type do destino da atividade de cópia deve ser definida como: MicrosoftAccessSink | Sim |
| writeBatchTimeout | Aguarde o tempo para que a operação de inserção em lote seja concluída antes que ela atinja o tempo limite. Os valores permitidos são: timespan. Exemplo: "00:30:00" (30 minutos). |
Não |
| writeBatchSize | Insere dados na tabela SQL quando o tamanho do buffer atinge writeBatchSize. Os valores permitidos são: inteiro (número de linhas). |
Não (o padrão é 0 - detetado automaticamente) |
| preCopyScript | Especifique uma consulta SQL para Atividade de Cópia a ser executada antes de gravar dados no armazenamento de dados em cada execução. Você pode usar essa propriedade para limpar os dados pré-carregados. | Não |
| maxConcurrentConnections | O limite superior de conexões simultâneas estabelecidas para o armazenamento de dados durante a execução da atividade. Especifique um valor somente quando quiser limitar conexões simultâneas. | Não |
Exemplo:
"activities":[
{
"name": "CopyToMicrosoftAccess",
"type": "Copy",
"inputs": [
{
"referenceName": "<input dataset name>",
"type": "DatasetReference"
}
],
"outputs": [
{
"referenceName": "<Microsoft Access output dataset name>",
"type": "DatasetReference"
}
],
"typeProperties": {
"source": {
"type": "<source type>"
},
"sink": {
"type": "MicrosoftAccessSink"
}
}
}
]
Propriedades da atividade de consulta
Para saber detalhes sobre as propriedades, verifique Atividade de pesquisa.
Conteúdos relacionados
Para obter uma lista de armazenamentos de dados suportados como fontes e coletores pela atividade de cópia, consulte Armazenamentos de dados suportados.