Copiare dati da SAP HANA usando Azure Data FactoryCopy data from SAP HANA using Azure Data Factory

Questo articolo illustra come usare l'attività di copia in Azure Data Factory per copiare dati da un database SAP HANA.This article outlines how to use the Copy Activity in Azure Data Factory to copy data from an SAP HANA database. Si basa sull'articolo di panoramica dell'attività di copia che presenta una panoramica generale sull'attività di copia.It builds on the copy activity overview article that presents a general overview of copy activity.

Suggerimento

Per informazioni sul supporto generale di ADF sullo scenario di integrazione dei dati SAP, vedere l'articolo relativo all' integrazione dei dati SAP con Azure Data Factory whitepaper con informazioni dettagliate introduttive, comparsing e linee guida.To learn ADF's overall support on SAP data integration scenario, see SAP data integration using Azure Data Factory whitepaper with detailed introduction, comparsion and guidance.

Funzionalità supportateSupported capabilities

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

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

In particolare, il connettore SAP HANA supporta:Specifically, this SAP HANA connector supports:

  • La copia di dati da qualsiasi versione del database SAP HANA.Copying data from any version of SAP HANA database.
  • Copia di dati da modelli di informazioni Hana (ad esempio, viste analitiche e di calcolo) e tabelle righe/colonne.Copying data from HANA information models (such as Analytic and Calculation views) and Row/Column tables.
  • La copia di dati usando l'autenticazione Di base o Windows.Copying data using Basic or Windows authentication.

Suggerimento

Per copiare dati in un archivio dati SAP HANA, usare il connettore ODBC generico.To copy data into SAP HANA data store, use generic ODBC connector. Per i dettagli, vedere Sink SAP HANA.See SAP HANA sink with details. I servizi collegati per i connettori SAP HANA e ODBC sono associati a tipi diversi e pertanto non possono essere riusati.Note the linked services for SAP HANA connector and ODBC connector are with different type thus cannot be reused.

PrerequisitiPrerequisites

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

  • Configurare un runtime di integrazione self-hosted.Set up a Self-hosted Integration Runtime. Per i dettagli, vedere l'articolo Runtime di integrazione self-hosted.See Self-hosted Integration Runtime article for details.
  • Installare il driver ODBC di SAP HANA nel computer del runtime di integrazione.Install the SAP HANA ODBC driver on the Integration Runtime machine. È possibile scaricare il driver ODBC di SAP HANA dall'area per il download di software SAP.You can download the SAP HANA ODBC driver from the SAP Software Download Center. Per cercare il driver, usare la parola chiave SAP HANA CLIENT for Windows.Search with the keyword SAP HANA CLIENT for Windows.

IntroduzioneGetting 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:

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

Proprietà del servizio collegatoLinked service properties

Per il servizio collegato di SAP HANA sono supportate le proprietà seguenti:The following properties are supported for SAP HANA linked service:

ProprietàProperty DescrizioneDescription ObbligatorioRequired
typetype La proprietà type deve essere impostata su: SapHanaThe type property must be set to: SapHana Yes
connectionStringconnectionString Specificare le informazioni necessarie per connettersi al SAP HANA usando l' autenticazione di base o l'autenticazione di Windows.Specify information that's needed to connect to the SAP HANA by using either basic authentication or Windows authentication. Vedere gli esempi seguenti.Refer to the following samples.
In stringa di connessione, il server/porta è obbligatorio (la porta predefinita è 30015) e il nome utente e la password sono obbligatori quando si usa l'autenticazione di base.In connection string, server/port is mandatory (default port is 30015), and username and password is mandatory when using basic authentication. Per altre impostazioni avanzate, vedere SAP Hana proprietà di connessione ODBCFor additional advanced settings, refer to SAP HANA ODBC Connection Properties
È anche possibile inserire la password in Azure Key Vault ed estrarre la configurazione della password dalla stringa di connessione.You can also put password in Azure Key Vault and pull the password configuration out of the connection string. Per informazioni dettagliate, vedere archiviare le credenziali in Azure Key Vault articolo.Refer to Store credentials in Azure Key Vault article with more details.
Yes
userNameuserName Specificare il nome utente quando si utilizza l'autenticazione di Windows.Specify user name when using Windows authentication. Esempio: user@domain.comExample: user@domain.com NoNo
passwordpassword Specifica la password per l'account utente.Specify password for the user account. Contrassegnare questo campo come SecureString per archiviarlo in modo sicuro in Azure Data Factory oppure fare riferimento a un segreto archiviato in 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. NoNo
connectViaconnectVia Il runtime di integrazione da usare per la connessione all'archivio dati.The Integration Runtime to be used to connect to the data store. È necessario un runtime di integrazione self-hosted come indicato in Prerequisiti.A Self-hosted Integration Runtime is required as mentioned in Prerequisites. Yes

Esempio: uso dell'autenticazione di baseExample: use basic authentication

{
    "name": "SapHanaLinkedService",
    "properties": {
        "type": "SapHana",
        "typeProperties": {
            "connectionString": "SERVERNODE=<server>:<port (optional)>;UID=<userName>;PWD=<Password>"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Esempio: uso dell'autenticazione di WindowsExample: use Windows authentication

{
    "name": "SapHanaLinkedService",
    "properties": {
        "type": "SapHana",
        "typeProperties": {
            "connectionString": "SERVERNODE=<server>:<port (optional)>;",
            "userName": "<username>", 
            "password": { 
                "type": "SecureString", 
                "value": "<password>" 
            } 
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Se si usa SAP HANA servizio collegato con il payload seguente, è ancora supportato così com'è, mentre si consiglia di usare quello nuovo in futuro.If you were using SAP HANA linked service with the following payload, it is still supported as-is, while you are suggested to use the new one going forward.

Esempio:Example:

{
    "name": "SapHanaLinkedService",
    "properties": {
        "type": "SapHana",
        "typeProperties": {
            "server": "<server>:<port (optional)>",
            "authenticationType": "Basic",
            "userName": "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Proprietà del set di datiDataset properties

Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione di set di dati, vedere l'articolo sui set di dati.For a full list of sections and properties available for defining datasets, see the datasets article. Questa sezione presenta un elenco delle proprietà supportate dal set di dati SAP HANA.This section provides a list of properties supported by SAP HANA dataset.

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

ProprietàProperty DescrizioneDescription ObbligatorioRequired
typetype La proprietà Type del set di dati deve essere impostata su: SapHanaTableThe type property of the dataset must be set to: SapHanaTable Yes
schemaschema Nome dello schema nel database SAP HANA.Name of the schema in the SAP HANA database. No (se nell'origine dell'attività è specificato "query")No (if "query" in activity source is specified)
tabletable Nome della tabella nel database SAP HANA.Name of the table in the SAP HANA database. No (se nell'origine dell'attività è specificato "query")No (if "query" in activity source is specified)

Esempio:Example:

{
    "name": "SAPHANADataset",
    "properties": {
        "type": "SapHanaTable",
        "typeProperties": {
            "schema": "<schema name>",
            "table": "<table name>"
        },
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<SAP HANA linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Se si usa RelationalTable DataSet tipizzato, è ancora supportato così com'è, mentre si consiglia di usare quello nuovo in futuro.If you were using RelationalTable typed dataset, it is still supported as-is, while you are suggested to use the new one going forward.

Proprietà dell'attività di copiaCopy activity properties

Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione delle attività, vedere l'articolo sulle pipeline.For a full list of sections and properties available for defining activities, see the Pipelines article. Questa sezione presenta un elenco delle proprietà supportate dall'origine SAP HANA.This section provides a list of properties supported by SAP HANA source.

SAP HANA come origineSAP HANA as source

Per copiare dati da SAP HANA, nella sezione origine dell'attività di copia sono supportate le proprietà seguenti:To copy data from SAP HANA, the following properties are supported in the copy activity source section:

ProprietàProperty DescrizioneDescription ObbligatorioRequired
typetype La proprietà Type dell'origine dell'attività di copia deve essere impostata su: SapHanaSourceThe type property of the copy activity source must be set to: SapHanaSource Yes
queryquery Specifica la query SQL che consente di leggere i dati dall'istanza di SAP HANA.Specifies the SQL query to read data from the SAP HANA instance. Yes
packetSizepacketSize Specifica le dimensioni del pacchetto di rete (in kilobyte) per suddividere i dati in più blocchi.Specifies the network packet size (in Kilobytes) to split data to multiple blocks. Se è presente una grande quantità di dati da copiare, l'aumento delle dimensioni del pacchetto può aumentare la velocità di lettura da SAP HANA nella maggior parte dei casi.If you have large amount of data to copy, increasing packet size can increase reading speed from SAP HANA in most cases. Il test delle prestazioni è consigliato per la regolazione delle dimensioni del pacchetto.Performance testing is recommended when adjusting the packet size. No.No.
Il valore predefinito è 2048 (2MB).Default value is 2048 (2MB).

Esempio:Example:

"activities":[
    {
        "name": "CopyFromSAPHANA",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<SAP HANA input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SapHanaSource",
                "query": "<SQL query for SAP HANA>"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Se si usa RelationalSource origine della copia tipizzata, questo è ancora supportato così com'è, mentre si consiglia di usare quello nuovo in futuro.If you were using RelationalSource typed copy source, it is still supported as-is, while you are suggested to use the new one going forward.

Mapping dei tipi di dati per SAP HANAData type mapping for SAP HANA

Quando si copiano dati da SAP HANA, vengono usati i mapping seguenti tra i tipi di dati di SAP HANA e i tipi di dati provvisori di Azure Data Factory.When copying data from SAP HANA, the following mappings are used from SAP HANA data types to 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.See Schema and data type mappings to learn about how copy activity maps the source schema and data type to the sink.

Tipo di dati di SAP HANASAP HANA data type Tipo di dati provvisori di Data FactoryData factory interim data type
ALPHANUMALPHANUM StringString
BIGINTBIGINT Int64Int64
BINARYBINARY Byte[]Byte[]
BintextBINTEXT StringString
BLOBBLOB Byte[]Byte[]
BOOLBOOL ByteByte
CLOBCLOB StringString
DATEDATE DateTimeDateTime
DECIMALDECIMAL DecimalDecimal
DOUBLEDOUBLE DoubleDouble
FLOATFLOAT DoubleDouble
INTEGERINTEGER Int32Int32
NCLOBNCLOB StringString
NVARCHARNVARCHAR StringString
REALREAL SingleSingle
SECONDDATESECONDDATE DateTimeDateTime
SHORTTEXTSHORTTEXT StringString
SMALLDECIMALSMALLDECIMAL DecimalDecimal
SMALLINTSMALLINT Int16Int16
STGEOMETRYTYPESTGEOMETRYTYPE Byte[]Byte[]
STPOINTTYPESTPOINTTYPE Byte[]Byte[]
TEXTTEXT StringString
TIMETIME TimeSpanTimeSpan
TINYINTTINYINT ByteByte
VARCHARVARCHAR StringString
TIMESTAMPTIMESTAMP DateTimeDateTime
VARBINARYVARBINARY Byte[]Byte[]

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 o sink dall'attività di copia in Azure Data Factory, vedere gli archivi dati supportati.For a list of data stores supported as sources and sinks by the copy activity in Azure Data Factory, see supported data stores.