Copiar dados de/para o Microsoft Access usando o Azure Data Factory ou Synapse Analytics
APLICA-SE A: Azure Data Factory Azure Synapse Analytics
Dica
Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um para empresas. O Microsoft Fabric abrange desde movimentação de dados até ciência de dados, análise em tempo real, business intelligence e relatórios. Saiba como iniciar uma nova avaliação gratuitamente!
Este artigo descreve como usar a atividade de cópia nos pipelines do Azure Data Factory e do Azure Synapse Analytics para copiar dados de um banco de dados do Microsoft Access. Ele amplia o artigo Visão geral da atividade de cópia que apresenta uma visão geral da atividade de cópia.
Funcionalidades com suporte
Esse conector do Microsoft Access é compatível com os seguintes recursos:
Funcionalidades com suporte | IR |
---|---|
Atividade de cópia (origem/coletor) | ② |
Atividade de pesquisa | ② |
① Runtime de integração do Azure ② Runtime de integração auto-hospedada
Para obter uma lista de armazenamentos de dados com suporte como origens/coletores da atividade de cópia, confira a tabela Armazenamentos de dados com suporte.
Pré-requisitos
Para usar esse conector do Microsoft Access, você precisará:
- Configurar um Integration Runtime auto-hospedado. Consulte o artigo Self-hosted integration runtime (Integration Runtime auto-hospedado) para obter detalhes.
- Instalar o driver do Microsoft Access para o armazenamento de dados no computador do Integration Runtime.
Observação
Este conector funciona com a versão do driver ODBC do Microsoft Access 2016. A versão de driver recomendada é 16.00.5378.1000 ou superior.
Introdução
Para executar a atividade de Cópia com um pipeline, será possível usar as ferramentas ou os SDKs abaixo:
- A ferramenta Copiar Dados
- O portal do Azure
- O SDK do .NET
- O SDK do Python
- PowerShell do Azure
- A API REST
- O modelo do Azure Resource Manager
Criar um serviço vinculado para o Microsoft Access usando a interface do usuário
Use as etapas a seguir para criar um serviço vinculado ao Microsoft Access na interface do usuário do portal do Azure.
Navegue até a guia Gerenciar no workspace do Azure Data Factory ou do Synapse e selecione Serviços Vinculados, em seguida, clique em Novo:
Pesquise o Access e selecione o conector do Microsoft Access.
Configure os detalhes do serviço, teste a conexão e crie o novo serviço vinculado.
Detalhes da configuração do conector
As seções a seguir dão detalhes sobre as propriedades que são usadas para definir entidades do Data Factory específicas ao conector do Microsoft Access.
Propriedades do serviço vinculado
As propriedades a seguir são compatíveis com o serviço vinculado do Microsoft Access:
Propriedade | Descrição | Obrigatório |
---|---|---|
type | A propriedade type deve ser definida como: MicrosoftAccess | Sim |
connectionString | A cadeia de conexão ODBC, exceto a parte de credencial. Você pode especificar a cadeia de conexão ou usar o DSN (nome da fonte de dados) do sistema que você configurou no computador do Integration Runtime (ainda assim é preciso especificar a parte da credencial no serviço vinculado adequadamente). Você também pode colocar uma senha no Azure Key Vault e extrair a configuração password da cadeia de conexão. Veja o artigo Credenciais de armazenamento no Azure Key Vault para saber mais detalhes. |
Sim |
authenticationType | Tipo de autenticação usada para se conectar ao armazenamento de dados do Microsoft Access. Os valores permitidos são: Básica e Anônima. |
Sim |
userName | Especifique o nome de usuário se você estiver usando a autenticação Básica. | Não |
password | Especifique a senha da conta de usuário que você especificou para userName. Marque este campo como um SecureString para armazená-lo com segurança ou referencie um segredo armazenado no Azure Key Vault. | Não |
credencial | A parte da credencial de acesso da cadeia de conexão especificada no formato propriedade-valor específico do driver. Marque esse campo como uma SecureString. | Não |
connectVia | O Integration Runtime a ser usado para se conectar ao armazenamento de dados. É necessário um Integration Runtime auto-hospedado, conforme mencionado nos 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 das seções e propriedades disponíveis para definir os conjuntos de dados, confira o artigo sobre conjuntos de dados. Esta seção fornece uma lista das propriedades compatíveis com o conjunto de dados do Microsoft Access.
Para copiar dados do Microsoft Access, as seguintes propriedades são compatíveis:
Propriedade | Descrição | Obrigatório |
---|---|---|
type | A propriedade type do conjunto de dados deve ser definida como: MicrosoftAccessTable | Sim |
tableName | Nome da tabela no Microsoft Access. | Não para fonte (se "query" na fonte da atividade for especificada); Sim para coletor |
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 das seções e propriedades disponíveis para definir atividades, confia o artigo Pipelines. Esta seção fornece uma lista das propriedades compatíveis com a origem do Microsoft Access.
Microsoft Access como origem
Para copiar dados do Microsoft Access, as propriedades a seguir têm suporte na seção origem da atividade de cópia:
Propriedade | Descrição | Obrigatório |
---|---|---|
type | A propriedade type da origem da atividade de cópia deve ser definida como: MicrosoftAccessSource | Sim |
Consulta | Utiliza a consulta personalizada para ler os dados. Por exemplo: "SELECT * FROM MyTable" . |
Não (se "tableName" no conjunto de dados for especificado) |
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 coletor
Para copiar dados do Microsoft Access, as propriedades a seguir têm suporte na seção coletor da atividade de cópia:
Propriedade | Descrição | Obrigatório |
---|---|---|
type | A propriedade type do coletor de atividade de cópia deve ser definida como MicrosoftAccessSink | Sim |
writeBatchTimeout | Tempo de espera para a operação de inserção em lotes ser concluída antes de atingir o tempo limite. Os valores permitidos são: período. 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 – detectado automaticamente) |
preCopyScript | Especifica uma consulta SQL para a 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 previamente carregados. | Não |
maxConcurrentConnections | O limite superior de conexões simultâneas estabelecidas com o armazenamento de dados durante a execução de atividade. Especifique um valor somente quando quiser limitar as conexões simultâneas. | Nenhum |
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"
}
}
}
]
Pesquisar propriedades de atividade
Para saber detalhes sobre as propriedades, verifique Pesquisar atividade.
Conteúdo relacionado
Para obter uma lista de armazenamentos de dados com suporte como coletores e fontes da atividade de cópia, confira os armazenamentos de dados com suporte.