Copiare dati da una tabella SAP usando Azure Data FactoryCopy data from an SAP table by using Azure Data Factory

• 09/02/2019
• 8 minuti per la lettura
• • 

Questo articolo illustra come usare l'attività di copia in Azure Data Factory per copiare dati da una tabella SAP.This article outlines how to use the copy activity in Azure Data Factory to copy data from an SAP table. Per altre informazioni, vedere Cenni preliminari sull'attività di copia.For more information, see Copy activity overview.

Funzionalità supportateSupported capabilities

Questo connettore della tabella SAP è supportato per le attività seguenti:This SAP table connector is supported for the following activities:

• Attività di copia con matrice di origine/sink supportataCopy activity with supported source/sink matrix
• Attività LookupLookup activity

È possibile copiare dati da una tabella SAP in qualsiasi archivio dati di sink supportato.You can copy data from an SAP table to any supported sink data store. Per un elenco degli archivi dati supportati come origini o sink dall'attività di copia, vedere la tabella relativa agli archivi dati supportati .For a list of the data stores that are supported as sources or sinks by the copy activity, see the Supported data stores table.

In particolare, questo connettore di tabella SAP supporta:Specifically, this SAP table connector supports:

• Copia di dati da una tabella SAP in:Copying data from an SAP table in:

  • SAP ERP Central Component (SAP ECC) versione 7,01 o successiva (in uno stack del pacchetto di supporto SAP recente rilasciato dopo 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) versione 7,01 o successiva (in uno stack di pacchetti di supporto SAP recente rilasciato dopo 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.
  • Altri prodotti in SAP Business Suite versione 7,01 o successiva (in uno stack del pacchetto di supporto SAP recente rilasciato dopo 2015).Other products in SAP Business Suite version 7.01 or later (in a recent SAP Support Package Stack released after 2015).

• Copia di dati da una tabella di SAP trasparente, una tabella in pool, una tabella cluster e una vista.Copying data from both an SAP transparent table, a pooled table, a clustered table, and a view.

• La copia dei dati tramite l'autenticazione di base o le comunicazioni di rete sicure (SNC), se è configurata la SNC.Copying data by using basic authentication or Secure Network Communications (SNC), if SNC is configured.

• Connessione a un server applicazioni SAP o a un server di messaggi SAP.Connecting to an SAP application server or SAP message server.

PrerequisitiPrerequisites

Per usare questo connettore di tabella SAP, è necessario:To use this SAP table connector, you need to:

• Configurare un runtime di integrazione self-hosted (versione 3,17 o successiva).Set up a self-hosted integration runtime (version 3.17 or later). Per altre informazioni, vedere creare e configurare un runtime di integrazione self-hosted.For more information, see Create and configure a self-hosted integration runtime.

• Scaricare il connettore SAP a 64 bit per Microsoft .NET 3,0 dal sito Web di SAP e installarlo nel computer del runtime di integrazione self-hosted.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 l'installazione, assicurarsi di selezionare l'opzione Installa assembly per GAC nella finestra passaggi di installazione facoltativi .During installation, make sure you select the Install Assemblies to GAC option in the Optional setup steps window.

  

• L'utente SAP usato nel connettore Data Factory SAP TABLE deve avere le autorizzazioni seguenti:The SAP user who's being used in the Data Factory SAP table connector must have the following permissions:

  • Autorizzazione per l'utilizzo di destinazioni della chiamata di funzione remota (RFC).Authorization for using Remote Function Call (RFC) destinations.
  • Autorizzazioni per l'attività Execute dell'oggetto di autorizzazione S_SDSAUTH.Permissions to the Execute activity of the S_SDSAUTH authorization object.

Attività inizialiGet started

È possibile usare l'attività di copia con una pipeline tramite uno degli strumenti o degli SDK seguenti.You can use one of the following tools or SDKs to use the copy activity with a pipeline. Per istruzioni dettagliate, selezionare un collegamento:Select a link for step-by-step instructions:

• Strumento copia datiCopy data tool
• Portale di AzureAzure portal
• .NET SDK.NET SDK
• Python SDKPython SDK
• Azure PowerShellAzure PowerShell
• API RESTREST API
• Modello di Azure Resource ManagerAzure Resource Manager template

Le sezioni seguenti riportano informazioni dettagliate sulle proprietà che vengono usate per definire le entità Data Factory specifiche del connettore della tabella SAP.The following sections provide details about properties that are used to define the Data Factory entities specific to the SAP table connector.

Proprietà del servizio collegatoLinked service properties

Per il servizio collegato SAP BW Hub aperto sono supportate le proprietà seguenti:The following properties are supported for the SAP BW Open Hub linked service:

Esempio 1: Connettersi a un server applicazioni 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"
        }
    }
}

Esempio 2 Connettersi a un server di messaggi 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"
        }
    }
}

Esempio 3: Connettersi tramite 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"
        }
    }
}

Proprietà del set di datiDataset properties

Per un elenco completo delle sezioni e delle proprietà per la definizione dei set di impostazioni, vedere Datasets.For a full list of the sections and properties for defining datasets, see Datasets. Nella sezione seguente viene fornito un elenco delle proprietà supportate dal set di dati della tabella SAP.The following section provides a list of the properties supported by the SAP table dataset.

Per copiare dati da e verso il SAP BW servizio collegato Hub aperto, sono supportate le proprietà seguenti:To copy data from and to the SAP BW Open Hub linked service, the following properties are supported:

EsempioExample

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

Proprietà dell'attività di copiaCopy activity properties

Per un elenco completo delle sezioni e delle proprietà per la definizione delle attività, vedere pipeline.For a full list of the sections and properties for defining activities, see Pipelines. Nella sezione seguente viene fornito un elenco delle proprietà supportate dall'origine della tabella SAP.The following section provides a list of the properties supported by the SAP table source.

Tabella SAP come origineSAP table as source

Per copiare dati da una tabella SAP, sono supportate le proprietà seguenti:To copy data from an SAP table, the following properties are supported:

In rfcTableOptionsè possibile utilizzare gli operatori di query SAP comuni seguenti per filtrare le righe:In rfcTableOptions, you can use the following common SAP query operators to filter the rows:

EsempioExample

"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
        }
    }
]

Mapping dei tipi di dati per una tabella SAPData type mappings for an SAP table

Quando si copiano dati da una tabella SAP, vengono usati i mapping seguenti tra i tipi di dati della tabella SAP e i tipi di dati Azure Data Factory interim.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. Vedere Mapping dello schema e del tipo di dati per informazioni su come l'attività di copia esegue il mapping dello schema di origine e del tipo di dati al sink.To learn how the copy activity maps the source schema and data type to the sink, see Schema and data type mappings.

Proprietà attività di ricercaLookup activity properties

Per informazioni dettagliate sulle proprietà, controllare l' attività di ricerca.To learn details about the properties, check Lookup activity.

Passaggi successiviNext steps

Per un elenco degli archivi dati supportati come origini e sink dall'attività di copia in Azure Data Factory, vedere archivi dati supportati.For a list of the data stores supported as sources and sinks by the copy activity in Azure Data Factory, see Supported data stores.