Copiar dados de uma tabela SAP usando Azure Data FactoryCopy data from an SAP table by using Azure Data Factory

• 09/01/2020
• 9 minutos para o fim da leitura
• • l
  • o

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Este artigo descreve como usar a atividade de cópia em Azure Data Factory para copiar dados de uma tabela SAP.This article outlines how to use the copy activity in Azure Data Factory to copy data from an SAP table. Para obter mais informações, confira Visão geral da atividade de cópia.For more information, see Copy activity overview.

Funcionalidades com suporteSupported capabilities

Há suporte para este conector de tabela SAP para as seguintes atividades:This SAP table connector is supported for the following activities:

• Atividade de cópia com matriz de fonte/coletor com suporteCopy activity with supported source/sink matrix
• Atividade de pesquisaLookup activity

Você pode copiar dados de uma tabela SAP para qualquer armazenamento de dados de coletor com suporte.You can copy data from an SAP table to any supported sink data store. Para obter uma lista dos armazenamentos de dados com suporte como fontes ou coletores pela atividade de cópia, consulte a tabela armazenamentos de dados com suporte .For a list of the data stores that are supported as sources or sinks by the copy activity, see the Supported data stores table.

Especificamente, esse conector de tabela SAP dá suporte a:Specifically, this SAP table connector supports:

• Copiando dados de uma tabela SAP em:Copying data from an SAP table in:

  • Componente central SAP ERP (SAP ECC) versão 7, 1 ou posterior (em uma pilha recente de pacotes de suporte SAP lançada após 2015).SAP ERP Central Component (SAP ECC) version 7.01 or later (in a recent SAP Support Package Stack released after 2015).
  • SAP Business Warehouse (SAP BW) versão 7, 1 ou posterior (em uma pilha recente de pacotes de suporte SAP lançada após 2015).SAP Business Warehouse (SAP BW) version 7.01 or later (in a recent SAP Support Package Stack released after 2015).
  • SAP S/4HANA.SAP S/4HANA.
  • Outros produtos no SAP Business Suite versão 7, 1 ou posterior (em uma pilha recente do pacote de suporte SAP lançado após 2015).Other products in SAP Business Suite version 7.01 or later (in a recent SAP Support Package Stack released after 2015).

• Copiar dados de uma tabela transparente do SAP, uma tabela em pool, uma tabela clusterizada e uma exibição.Copying data from both an SAP transparent table, a pooled table, a clustered table, and a view.

• Copiar dados usando a autenticação básica ou a SNC (comunicações de rede segura) se a SNC estiver configurada.Copying data by using basic authentication or Secure Network Communications (SNC), if SNC is configured.

• Conectando-se a um servidor de aplicativos SAP ou servidor de mensagens SAP.Connecting to an SAP application server or SAP message server.

• Recuperando dados por meio da RFC padrão ou personalizada.Retrieving data via default or custom RFC.

A versão 7, 1 ou posterior refere-se à versão do SAP NetWeaver em vez da versão do SAP ECC.The version 7.01 or later refers to SAP NetWeaver version instead of SAP ECC version. Por exemplo, o SAP ECC 6,0 EHP 7 em geral tem a versão NetWeaver >= 7,4.For example, SAP ECC 6.0 EHP 7 in general has NetWeaver version >=7.4. Caso você não tenha certeza sobre o seu ambiente, aqui estão as etapas para confirmar a versão do seu sistema SAP:In case you are unsure about your environment, here are the steps to confirm the version from your SAP system:

1. Use a GUI do SAP para se conectar ao sistema SAP.Use SAP GUI to connect to the SAP System.
2. Vá para System -> status do sistema.Go to System -> Status.
3. Verifique o lançamento do SAP_BASIS, verifique se ele é igual ou maior que 701.Check the release of the SAP_BASIS, ensure it is equal to or larger than 701.
   

Pré-requisitosPrerequisites

Para usar esse conector de tabela SAP, você precisa:To use this SAP table connector, you need to:

• Configure um tempo de execução de integração auto-hospedado (versão 3,17 ou posterior).Set up a self-hosted integration runtime (version 3.17 or later). Para obter mais informações, consulte criar e configurar um tempo de execução de integração auto-hospedado.For more information, see Create and configure a self-hosted integration runtime.

• Baixe o conector SAP de 64 bits para Microsoft .NET 3,0 do site da SAP e instale-o no computador do Integration Runtime de hospedagem interna.Download the 64-bit SAP Connector for Microsoft .NET 3.0 from SAP's website, and install it on the self-hosted integration runtime machine. Durante a instalação, certifique-se de selecionar a opção instalar assemblies no GAC na janela etapas de instalação opcionais .During installation, make sure you select the Install Assemblies to GAC option in the Optional setup steps window.

  

• O usuário SAP que está sendo usado no conector de tabela do SAP Data Factory deve ter as seguintes permissões:The SAP user who's being used in the Data Factory SAP table connector must have the following permissions:

  • Autorização para usar destinos de chamada de função remota (RFC).Authorization for using Remote Function Call (RFC) destinations.
  • Permissões para a atividade executar do objeto de autorização S_SDSAUTH.Permissions to the Execute activity of the S_SDSAUTH authorization object.

IntroduçãoGet 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:

• A ferramenta Copiar DadosThe Copy Data tool
• O portal do AzureThe Azure portal
• O SDK do .NETThe .NET SDK
• O SDK do PythonThe Python SDK
• PowerShell do AzureAzure PowerShell
• A API RESTThe REST API
• O modelo do Azure Resource ManagerThe Azure Resource Manager template

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

Propriedades do serviço vinculadoLinked service properties

As propriedades a seguir têm suporte para o serviço vinculado de Hub aberto do SAP BW:The following properties are supported for the SAP BW Open Hub linked service:

Exemplo 1: conectar-se a um servidor de aplicativos SAPExample 1: Connect to an SAP application server

{
    "name": "SapTableLinkedService",
    "properties": {
        "type": "SapTable",
        "typeProperties": {
            "server": "<server name>",
            "systemNumber": "<system number>",
            "clientId": "<client ID>",
            "userName": "<SAP user>",
            "password": {
                "type": "SecureString",
                "value": "<Password for SAP user>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Exemplo 2: conectar-se a um servidor de mensagens SAPExample 2: Connect to an SAP message server

{
    "name": "SapTableLinkedService",
    "properties": {
        "type": "SapTable",
        "typeProperties": {
            "messageServer": "<message server name>",
            "messageServerService": "<service name or port>",
            "systemId": "<system ID>",
            "logonGroup": "<logon group>",
            "clientId": "<client ID>",
            "userName": "<SAP user>",
            "password": {
                "type": "SecureString",
                "value": "<Password for SAP user>"
            }
        },
        "connectVia": {
            "referenceName": "<name of integration runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Exemplo 3: conectar usando o SNCExample 3: Connect by using SNC

{
    "name": "SapTableLinkedService",
    "properties": {
        "type": "SapTable",
        "typeProperties": {
            "server": "<server name>",
            "systemNumber": "<system number>",
            "clientId": "<client ID>",
            "userName": "<SAP user>",
            "password": {
                "type": "SecureString",
                "value": "<Password for SAP user>"
            },
            "sncMode": 1,
            "sncMyName": "<SNC myname>",
            "sncPartnerName": "<SNC partner name>",
            "sncLibraryPath": "<SNC library path>",
            "sncQop": "8"
        },
        "connectVia": {
            "referenceName": "<name of integration runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Propriedades do conjunto de dadosDataset properties

Para obter uma lista completa das seções e propriedades para definir conjuntos de os, consulte DataSets.For a full list of the sections and properties for defining datasets, see Datasets. A seção a seguir fornece uma lista das propriedades compatíveis pelo conjunto de dados da tabela do SAP.The following section provides a list of the properties supported by the SAP table dataset.

Para copiar dados de e para o SAP BW serviço vinculado de Hub aberto, há suporte para as seguintes propriedades:To copy data from and to the SAP BW Open Hub linked service, the following properties are supported:

ExemploExample

{
    "name": "SAPTableDataset",
    "properties": {
        "type": "SapTableResource",
        "typeProperties": {
            "tableName": "<SAP table name>"
        },
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<SAP table linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Propriedades da atividade de cópiaCopy activity properties

Para obter uma lista completa das seções e propriedades para definir atividades, consulte pipelines.For a full list of the sections and properties for defining activities, see Pipelines. A seção a seguir fornece uma lista das propriedades com suporte pela origem da tabela do SAP.The following section provides a list of the properties supported by the SAP table source.

Tabela SAP como fonteSAP table as source

Para copiar dados de uma tabela SAP, há suporte para as seguintes propriedades:To copy data from an SAP table, the following properties are supported:

No rfcTableOptions , você pode usar os seguintes operadores de consulta SAP comuns para filtrar as linhas:In rfcTableOptions, you can use the following common SAP query operators to filter the rows:

ExemploExample

"activities":[
    {
        "name": "CopyFromSAPTable",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<SAP table input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SapTableSource",
                "partitionOption": "PartitionOnInt",
                "partitionSettings": {
                     "partitionColumnName": "<partition column name>",
                     "partitionUpperBound": "2000",
                     "partitionLowerBound": "1",
                     "maxPartitionsNumber": 500
                 }
            },
            "sink": {
                "type": "<sink type>"
            },
            "parallelCopies": 4
        }
    }
]

Mapeamentos de tipo de dados para uma tabela SAPData type mappings for an SAP table

Quando você está copiando dados de uma tabela SAP, os seguintes mapeamentos são usados dos tipos de dados de tabela SAP para os tipos de dados provisórios Azure Data Factory.When you're copying data from an SAP table, the following mappings are used from the SAP table data types to the Azure Data Factory interim data types. Para saber mais sobre como a atividade de cópia mapeia o tipo de dados e esquema de origem para o coletor, consulte Mapeamentos de tipo de dados e esquema.To learn how the copy activity maps the source schema and data type to the sink, see Schema and data type mappings.

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 dos armazenamentos de dados compatíveis como fontes e coletores com a atividade de cópia no Azure Data Factory, confira Armazenamentos de dados compatíveis.For a list of the data stores supported as sources and sinks by the copy activity in Azure Data Factory, see Supported data stores.