Copier des données à partir de Sybase à l’aide d’Azure Data FactoryCopy data from Sybase using Azure Data Factory

Cet article décrit comment utiliser l’activité de copie dans Azure Data Factory pour copier des données à partir d’une base de données Sybase.This article outlines how to use the Copy Activity in Azure Data Factory to copy data from a Sybase database. Il s’appuie sur l’article Vue d’ensemble de l’activité de copie.It builds on the copy activity overview article that presents a general overview of copy activity.

Fonctionnalités prises en chargeSupported capabilities

Vous pouvez copier des données d’une base de données Sybase vers tout magasin de données récepteur pris en charge.You can copy data from Sybase database to any supported sink data store. Pour obtenir la liste des magasins de données pris en charge en tant que sources ou récepteurs par l’activité de copie, consultez le tableau Magasins de données pris en charge.For a list of data stores that are supported as sources/sinks by the copy activity, see the Supported data stores table.

Plus précisément, ce connecteur Sybase prend en charge :Specifically, this Sybase connector supports:

  • SAP Sybase SQL Anywhere (ASA) version 16 et versions ultérieures ; IQ et ASE ne sont pas pris en charge.SAP Sybase SQL Anywhere (ASA) version 16 and above; IQ and ASE are not supported.
  • Copie des données avec l’authentification De base ou Windows.Copying data using Basic or Windows authentication.

PrérequisPrerequisites

Pour utiliser ce connecteur Sybase, vous devez :To use this Sybase connector, you need to:

Prise en mainGetting started

Vous pouvez vous servir de l’un des outils ou SDK suivants pour utiliser l’activité de copie avec un pipeline.You can use one of the following tools or SDKs to use the copy activity with a pipeline. Sélectionnez un lien pour obtenir des instructions étape par étape :Select a link for step-by-step instructions:

Les sections suivantes fournissent des informations sur les propriétés utilisées pour définir les entités Data Factory propres au connecteur Sybase.The following sections provide details about properties that are used to define Data Factory entities specific to Sybase connector.

Propriétés du service liéLinked service properties

Les propriétés suivantes sont prises en charge pour le service lié Sybase :The following properties are supported for Sybase linked service:

PropriétéProperty DescriptionDescription ObligatoireRequired
typetype La propriété type doit être définie sur : SybaseThe type property must be set to: Sybase OUIYes
serverserver Nom du serveur Sybase.Name of the Sybase server. OUIYes
databasedatabase Nom de la base de données Sybase.Name of the Sybase database. OUIYes
authenticationTypeauthenticationType Type d'authentification utilisé pour se connecter à la base de données Sybase.Type of authentication used to connect to the Sybase database.
Les valeurs autorisées sont les suivantes : Basic et Windows.Allowed values are: Basic, and Windows.
OUIYes
usernameusername Spécifiez le nom d’utilisateur associé à la connexion à la base de données Sybase.Specify user name to connect to the Sybase database. OUIYes
passwordpassword Spécifiez le mot de passe du compte d’utilisateur que vous avez spécifié pour le nom d’utilisateur.Specify password for the user account you specified for the username. Marquez ce champ en tant que SecureString afin de le stocker en toute sécurité dans Data Factory, ou référencez un secret stocké dans 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. OUIYes
connectViaconnectVia Runtime d’intégration à utiliser pour la connexion à la banque de données.The Integration Runtime to be used to connect to the data store. Un Runtime d’intégration autohébergé est nécessaire comme indiqué dans Prérequis.A Self-hosted Integration Runtime is required as mentioned in Prerequisites. OUIYes

Exemple :Example:

{
    "name": "SybaseLinkedService",
    "properties": {
        "type": "Sybase",
        "typeProperties": {
            "server": "<server>",
            "database": "<database>",
            "authenticationType": "Basic",
            "username": "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Propriétés du jeu de donnéesDataset properties

Pour obtenir la liste complète des sections et propriétés disponibles pour la définition de jeux de données, consultez l’article sur les jeux de données.For a full list of sections and properties available for defining datasets, see the datasets article. Cette section fournit une liste des propriétés prises en charge par le jeu de données Sybase.This section provides a list of properties supported by Sybase dataset.

Pour copier des données à partir de Sybase, les propriétés suivantes sont prises en charge :To copy data from Sybase, the following properties are supported:

PropriétéProperty DescriptionDescription ObligatoireRequired
typetype La propriété type du jeu de données doit être définie sur : SybaseTableThe type property of the dataset must be set to: SybaseTable OUIYes
tableNametableName Nom de la table dans la base de données Sybase.Name of the table in the Sybase database. Non (si « query » dans la source de l’activité est spécifié)No (if "query" in activity source is specified)

ExempleExample

{
    "name": "SybaseDataset",
    "properties": {
        "type": "SybaseTable",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Sybase linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Si vous utilisiez un dataset typé RelationalTable, il reste pris en charge tel quel, mais nous vous suggérons d’utiliser désormais le nouveau dataset.If you were using RelationalTable typed dataset, it is still supported as-is, while you are suggested to use the new one going forward.

Propriétés de l’activité de copieCopy activity properties

Pour obtenir la liste complète des sections et des propriétés disponibles pour la définition des activités, consultez l’article Pipelines.For a full list of sections and properties available for defining activities, see the Pipelines article. Cette section fournit une liste des propriétés prises en charge par la source Sybase.This section provides a list of properties supported by Sybase source.

Sybase en tant que sourceSybase as source

Pour copier des données à partir de Sybase, les propriétés prises en charge dans la section source de l’activité de copie sont les suivantes :To copy data from Sybase, the following properties are supported in the copy activity source section:

PropriétéProperty DescriptionDescription ObligatoireRequired
typetype La propriété type de la source d’activité de copie doit être définie sur : SybaseSourceThe type property of the copy activity source must be set to: SybaseSource OUIYes
queryquery Utiliser la requête SQL personnalisée pour lire les données.Use the custom SQL query to read data. Par exemple : "SELECT * FROM MyTable".For example: "SELECT * FROM MyTable". Non (si « tableName » est spécifié dans dataset)No (if "tableName" in dataset is specified)

Exemple :Example:

"activities":[
    {
        "name": "CopyFromSybase",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Sybase input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SybaseSource",
                "query": "SELECT * FROM MyTable"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Si vous utilisiez une source de données typée RelationalSource, elle reste prise en charge telle quelle, mais nous vous suggérons d’utiliser désormais la nouvelle source.If you were using RelationalSource typed source, it is still supported as-is, while you are suggested to use the new one going forward.

Mappage de type de données pour SybaseData type mapping for Sybase

Lors de la copie des données à partir de Sybase, les mappages suivants sont utilisés entre les types de données Sybase et les types de données intermédiaires d’Azure Data Factory.When copying data from Sybase, the following mappings are used from Sybase data types to Azure Data Factory interim data types. Pour découvrir comment l’activité de copie mappe le schéma source et le type de données au récepteur, consultez Mappages de types de données et de schémas.See Schema and data type mappings to learn about how copy activity maps the source schema and data type to the sink.

Sybase prend en charge les types T-SQL.Sybase supports T-SQL types. Pour obtenir une table de mappage entre les types SQL et les types de données intermédiaires d’Azure Data Factory, consultez la section Connecteur Azure SQL Database - Mappage de type de données.For a mapping table from SQL types to Azure Data Factory interim data types, see Azure SQL Database Connector - data type mapping section.

Étapes suivantesNext steps

Pour obtenir la liste des banques de données prises en charge en tant que sources et récepteurs par l’activité de copie dans Azure Data Factory, consultez le tableau banques de données prises en charge.For a list of data stores supported as sources and sinks by the copy activity in Azure Data Factory, see supported data stores.