Copiar dados do Sybase usando o Azure Data FactoryCopy data from Sybase 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 banco de dados Sybase.This article outlines how to use the Copy Activity in Azure Data Factory to copy data from a Sybase database. 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 Sybase tem suporte para as seguintes atividades:This Sybase connector is supported for the following activities:

Você pode copiar dados de um banco de dados Sybase para qualquer armazenamento de dados de coletor com suporte.You can copy data from Sybase database to any supported sink data store. 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.

Especificamente, este conector do Sybase dá suporte a:Specifically, this Sybase connector supports:

  • SAP Sybase SQL Anywhere (ASA) versão 16 e superior.SAP Sybase SQL Anywhere (ASA) version 16 and above.
  • Cópia de dados usando a autenticação Básica ou do Windows.Copying data using Basic or Windows authentication.

Não há suporte para Sybase IQ e ASE.Sybase IQ and ASE are not supported. Em vez disso, você pode usar o conector ODBC genérico com o driver Sybase.You can use generic ODBC connector with Sybase driver instead.

Pré-requisitosPrerequisites

Para usar esse conector do Sybase, você precisa:To use this Sybase connector, you need to:

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 que a seguir fornecem detalhes sobre as propriedades usadas para definir entidades do Data Factory específicas ao Sybase.The following sections provide details about properties that are used to define Data Factory entities specific to Sybase connector.

Propriedades do serviço vinculadoLinked service properties

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

PropriedadeProperty DescriçãoDescription ObrigatórioRequired
typetype A propriedade type deve ser definida como: SybaseThe type property must be set to: Sybase SimYes
Servidorserver Nome do servidor do Sybase.Name of the Sybase server. SimYes
Banco de Dadosdatabase Nome do banco de dados do Sybase.Name of the Sybase database. SimYes
authenticationTypeauthenticationType Tipo de autenticação usado para se conectar ao banco de dados Sybase.Type of authentication used to connect to the Sybase database.
Os valores permitidos são: Básico e Windows.Allowed values are: Basic, and Windows.
SimYes
Nome de Usuáriousername Especifique o nome de usuário para se conectar ao banco de dados Sybase.Specify user name to connect to the Sybase database. SimYes
passwordpassword Especifique a senha da conta de usuário que você especificou para o nome de usuário.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. SimYes
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": "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"
        }
    }
}

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 dados do Sybase.This section provides a list of properties supported by Sybase dataset.

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

PropriedadeProperty DescriçãoDescription ObrigatórioRequired
typetype A propriedade Type do conjunto de conjuntos deve ser definida como: sybasetableThe type property of the dataset must be set to: SybaseTable SimYes
tableNametableName Nome da tabela no banco de dados do Sybase.Name of the table in the Sybase database. Não (se "query" na fonte da atividade for especificada)No (if "query" in activity source is specified)

ExemploExample

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

Se você estava usando o conjunto de dados com tipos RelationalTable, ele ainda tem suporte como está, mas é recomendável usar o novo de agora em diante.If you were using RelationalTable typed dataset, it is still supported as-is, while you are suggested to use the new one going forward.

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 origem do Sybase.This section provides a list of properties supported by Sybase source.

Sybase como origemSybase as source

Para copiar dados do Sybase, há suporte para as seguintes propriedades na seção origem da atividade de cópia:To copy data from Sybase, 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: SybaseThe type property of the copy activity source must be set to: SybaseSource SimYes
Consultaquery Utiliza a consulta SQL personalizada para ler os dados.Use the custom SQL 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": "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>"
            }
        }
    }
]

Se você estava usando a fonte com tipos RelationalSource, ela ainda tem suporte como está, mas é recomendável usar a nova no futuro.If you were using RelationalSource typed source, it is still supported as-is, while you are suggested to use the new one going forward.

Mapeamento de tipo de dados para SybaseData type mapping for Sybase

Ao copiar dados do Sybase, os seguintes mapeamentos são usados de tipos de dados do Sybase para tipos de dados provisórios do Azure Data Factory.When copying data from Sybase, the following mappings are used from Sybase data types to Azure Data Factory interim data types. Consulte Mapeamentos de tipo de dados e esquema para saber mais sobre como a atividade de cópia mapeia o tipo de dados e esquema de origem para o coletor.See Schema and data type mappings to learn about how copy activity maps the source schema and data type to the sink.

O Sybase dá suporte a tipos T-SQL.Sybase supports T-SQL types. Para uma tabela de mapeamento de tipos SQL para tipos de dados provisórios do Azure Data Factory, consulte a seção Conector do banco de dados SQL do Azure – mapeamento de tipo de dados.For a mapping table from SQL types to Azure Data Factory interim data types, see Azure SQL Database Connector - data type mapping section.

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.