Copiar dados de e para o Microsoft Access usando Azure Data FactoryCopy data from and to Microsoft Access using Azure Data Factory

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Este artigo descreve como usar a atividade de cópia no Azure Data Factory para copiar dados de um armazenamento de dados do Microsoft Access.This article outlines how to use the Copy Activity in Azure Data Factory to copy data from a Microsoft Access data store. Ele amplia o artigo Visão geral da atividade de cópia que apresenta uma visão geral da atividade de cópia.It builds on the copy activity overview article that presents a general overview of copy activity.

Funcionalidades com suporteSupported capabilities

Este conector do Microsoft Access tem suporte para as seguintes atividades:This Microsoft Access connector is supported for the following activities:

Você pode copiar dados da fonte do Microsoft Access para qualquer armazenamento de dados de coletor com suporte ou copiar de qualquer armazenamento de dados de origem com suporte para o coletor de acesso da Microsoft.You can copy data from Microsoft Access source to any supported sink data store, or copy from any supported source data store to Microsoft Access sink. 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.For a list of data stores that are supported as sources/sinks by the copy activity, see the Supported data stores table.

Pré-requisitosPrerequisites

Para usar esse conector de acesso da Microsoft, você precisa:To use this Microsoft Access connector, you need to:

  • Configurar um Integration Runtime auto-hospedado.Set up a Self-hosted Integration Runtime. Confira o artigo de Integration Runtime auto-hospedado para obter detalhes.See Self-hosted Integration Runtime article for details.
  • Instale o driver ODBC do Microsoft Access para o armazenamento de dados no computador Integration Runtime.Install the Microsoft Access ODBC driver for the data store on the Integration Runtime machine.

Observação

A versão 2016 do Microsoft Access do driver ODBC não funciona com este conector.Microsoft Access 2016 version of ODBC driver doesn't work with this connector. Use o driver versão 2013 ou 2010 em vez disso.Use driver version 2013 or 2010 instead.

IntroduçãoGetting started

Para executar a atividade de Cópia com um pipeline, será possível usar as ferramentas ou os SDKs abaixo:To perform the Copy activity with a pipeline, you can use one of the following tools or SDKs:

As seções a seguir fornecem detalhes sobre as propriedades que são usadas para definir Data Factory entidades específicas ao conector do Microsoft Access.The following sections provide details about properties that are used to define Data Factory entities specific to Microsoft Access connector.

Propriedades do serviço vinculadoLinked service properties

As propriedades a seguir têm suporte para o serviço vinculado do Microsoft Access:The following properties are supported for Microsoft Access linked service:

PropriedadeProperty DescriçãoDescription ObrigatórioRequired
typetype A propriedade Type deve ser definida como: MicrosoftAccessThe type property must be set to: MicrosoftAccess SimYes
connectionStringconnectionString A cadeia de conexão ODBC excluindo a parte da credencial.The ODBC connection string excluding the credential portion. Você pode especificar a cadeia de conexão ou usar o DSN do sistema (nome da fonte de dados) que você configurou no computador Integration Runtime (você ainda precisa especificar a parte da credencial no serviço vinculado adequadamente).You can specify the connection string or use the system DSN (Data Source Name) you set up on the Integration Runtime machine (you need still specify the credential portion in linked service accordingly).
Você também pode colocar uma senha em Azure Key Vault e extrair a  password   configuração da cadeia de conexão.You can also put a password in Azure Key Vault and pull the password configuration out of the connection string.Consulte armazenar credenciais em Azure Key Vault   com mais detalhes. Refer to Store credentials in Azure Key Vault with more details.
SimYes
authenticationTypeauthenticationType Tipo de autenticação usado para se conectar ao armazenamento de dados do Microsoft Access.Type of authentication used to connect to the Microsoft Access data store.
Os valores permitidos são: Básica e Anônima.Allowed values are: Basic and Anonymous.
SimYes
userNameuserName Especifique o nome de usuário se você estiver usando a autenticação Básica.Specify user name if you are using Basic authentication. NãoNo
passwordpassword Especifique a senha da conta de usuário que você especificou para userName.Specify password for the user account you specified for the userName. Marque este campo como uma SecureString para armazená-la com segurança no Data Factory ou faça referência a um segredo armazenado no Azure Key Vault.Mark this field as a SecureString to store it securely in Data Factory, or reference a secret stored in Azure Key Vault. NãoNo
credencialcredential A parte da credencial de acesso da cadeia de conexão especificada no formato propriedade-valor específico do driver.The access credential portion of the connection string specified in driver-specific property-value format. Marque esse campo como uma SecureString.Mark this field as a SecureString. NãoNo
connectViaconnectVia O Integration Runtime a ser usado para se conectar ao armazenamento de dados.The Integration Runtime to be used to connect to the data store. É necessário um Integration Runtime auto-hospedado, conforme mencionado nos Pré-requisitos.A Self-hosted Integration Runtime is required as mentioned in Prerequisites. SimYes

Exemplo:Example:

{
    "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 dadosDataset properties

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.For a full list of sections and properties available for defining datasets, see the datasets article. Esta seção fornece uma lista das propriedades com suporte pelo conjunto de Microsoft Access.This section provides a list of properties supported by Microsoft Access dataset.

Para copiar dados do Microsoft Access, há suporte para as seguintes propriedades:To copy data from Microsoft Access, the following properties are supported:

PropriedadeProperty DescriçãoDescription ObrigatórioRequired
typetype A propriedade Type do conjunto de conjuntos deve ser definida como: MicrosoftAccessTableThe type property of the dataset must be set to: MicrosoftAccessTable SimYes
tableNametableName Nome da tabela no Microsoft Access.Name of the table in the Microsoft Access. Não para fonte (se "query" na fonte da atividade for especificada);No for source (if "query" in activity source is specified);
Sim para coletorYes for sink

ExemploExample

{
    "name": "MicrosoftAccessDataset",
    "properties": {
        "type": "MicrosoftAccessTable",
        "linkedServiceName": {
            "referenceName": "<Microsoft Access linked service name>",
            "type": "LinkedServiceReference"
        },
        "typeProperties": {
            "tableName": "<table name>"
        }
    }
}

Propriedades da atividade de cópiaCopy activity properties

Para obter uma lista completa das seções e propriedades disponíveis para definir atividades, confia o artigo Pipelines.For a full list of sections and properties available for defining activities, see the Pipelines article. Esta seção fornece uma lista das propriedades com suporte pela fonte do Microsoft Access.This section provides a list of properties supported by Microsoft Access source.

Microsoft Access como fonteMicrosoft Access as source

Para copiar dados do Microsoft Access, há suporte para as seguintes propriedades na seção origem da atividade de cópia:To copy data from Microsoft Access, the following properties are supported in the copy activity source section:

PropriedadeProperty DescriçãoDescription ObrigatórioRequired
typetype A propriedade Type da fonte da atividade de cópia deve ser definida como: MicrosoftAccessSourceThe type property of the copy activity source must be set to: MicrosoftAccessSource SimYes
Consultaquery Utiliza a consulta personalizada para ler os dados.Use the custom query to read data. Por exemplo: "SELECT * FROM MyTable".For example: "SELECT * FROM MyTable". Não (se "tableName" no conjunto de dados for especificado)No (if "tableName" in dataset is specified)

Exemplo:Example:

"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 coletorMicrosoft Access as sink

Para copiar dados para o Microsoft Access, há suporte para as seguintes propriedades na seção coletor de atividade de cópia:To copy data to Microsoft Access, the following properties are supported in the copy activity sink section:

PropriedadeProperty DescriçãoDescription ObrigatórioRequired
typetype A propriedade Type do coletor da atividade de cópia deve ser definida como: MicrosoftAccessSinkThe type property of the copy activity sink must be set to: MicrosoftAccessSink SimYes
writeBatchTimeoutwriteBatchTimeout Tempo de espera para a operação de inserção em lotes ser concluída antes de atingir o tempo limite.Wait time for the batch insert operation to complete before it times out.
Os valores permitidos são: período.Allowed values are: timespan. Exemplo: "00:30:00" (30 minutos).Example: “00:30:00” (30 minutes).
NãoNo
writeBatchSizewriteBatchSize Insere dados na tabela SQL quando o tamanho do buffer atinge writeBatchSize.Inserts data into the SQL table when the buffer size reaches writeBatchSize.
Os valores permitidos são: inteiro (número de linhas).Allowed values are: integer (number of rows).
Não (o padrão é 0 – detectado automaticamente)No (default is 0 - auto detected)
preCopyScriptpreCopyScript 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.Specify a SQL query for Copy Activity to execute before writing data into data store in each run. Você pode usar essa propriedade para limpar os dados previamente carregados.You can use this property to clean up the pre-loaded data. NãoNo

Exemplo:Example:

"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 atividadeLookup activity properties

Para saber detalhes sobre as propriedades, verifique Pesquisar atividade.To learn details about the properties, check Lookup activity.

Próximas etapasNext steps

Para obter uma lista de armazenamentos de dados com suporte como origens e coletores pela atividade de cópia no Azure Data Factory, consulte Armazenamentos de dados com suporte.For a list of data stores supported as sources and sinks by the copy activity in Azure Data Factory, see supported data stores.