Copiar dados do Sybase usando o Azure Data Factory ou o Synapse Analytics

Artigo
11/16/2023

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Gorjeta

Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um para empresas. O Microsoft Fabric abrange tudo, desde a movimentação de dados até ciência de dados, análises em tempo real, business intelligence e relatórios. Saiba como iniciar uma nova avaliação gratuitamente!

Este artigo descreve como usar a Atividade de Cópia em um pipeline do Azure Data Factory ou do Synapse Analytics para copiar dados de um banco de dados Sybase. Ele se baseia no artigo de visão geral da atividade de cópia que apresenta uma visão geral da atividade de cópia.

Capacidades suportadas

Este conector Sybase é suportado para os seguintes recursos:

Capacidades suportadas	IR
Atividade de cópia (fonte/-)	②
Atividade de Pesquisa	②

(1) Tempo de execução de integração do Azure (2) Tempo de execução de integração auto-hospedado

Para obter uma lista de armazenamentos de dados suportados como fontes/coletores pela atividade de cópia, consulte a tabela Armazenamentos de dados suportados.

Especificamente, este conector Sybase suporta:

SAP Sybase SQL Anywhere (ASA) versão 16 e superior.
Copiar dados usando autenticação básica ou do Windows .

Sybase IQ e ASE não são suportados. Você pode usar conector ODBC genérico com driver Sybase em vez disso.

Pré-requisitos

Para usar este conector Sybase, você precisa:

Configure um tempo de execução de integração auto-hospedado. Consulte o artigo Self-hosted Integration Runtime para obter detalhes.
Instale o provedor de dados para Sybase iAnywhere.Data.SQLAnywhere 16 ou superior na máquina Integration Runtime.

Introdução

Para executar a atividade Copiar com um pipeline, você pode usar uma das seguintes ferramentas ou SDKs:

Criar um serviço vinculado ao Sybase usando a interface do usuário

Use as etapas a seguir para criar um serviço vinculado ao Sybase na interface do usuário do portal do Azure.

Navegue até a guia Gerenciar em seu espaço de trabalho do Azure Data Factory ou Synapse e selecione Serviços Vinculados e clique em Novo:
- Fábrica de Dados do Azure
- Azure Synapse
Procure Sybase e selecione o conector Sybase.
Configure os detalhes do serviço, teste a conexão e crie o novo serviço vinculado.

Detalhes de configuração do conector

As seções a seguir fornecem detalhes sobre as propriedades que são usadas para definir entidades do Data Factory específicas para o conector Sybase.

Propriedades do serviço vinculado

As seguintes propriedades são suportadas para o serviço vinculado Sybase:

Propriedade	Descrição	Necessário
tipo	A propriedade type deve ser definida como: Sybase	Sim
servidor	Nome do servidor Sybase.	Sim
base de dados	Nome do banco de dados Sybase.	Sim
authenticationType	Tipo de autenticação usado para se conectar ao banco de dados Sybase. Os valores permitidos são: Basic e Windows.	Sim
nome de utilizador	Especifique o nome de usuário para se conectar ao banco de dados Sybase.	Sim
password	Especifique a senha para a conta de usuário que você especificou para o nome de usuário. Marque este campo como um SecureString para armazená-lo com segurança ou faça referência a um segredo armazenado no Cofre de Chaves do Azure.	Sim
ConecteVia	O tempo de execução de integração a ser usado para se conectar ao armazenamento de dados. Um tempo de execução de integração auto-hospedado é necessário, conforme mencionado em Pré-requisitos.	Sim

Exemplo:

{
    "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 dados

Para obter uma lista completa de seções e propriedades disponíveis para definir conjuntos de dados, consulte o artigo sobre conjuntos de dados. Esta seção fornece uma lista de propriedades suportadas pelo conjunto de dados Sybase.

Para copiar dados do Sybase, as seguintes propriedades são suportadas:

Propriedade	Descrição	Necessário
tipo	A propriedade type do conjunto de dados deve ser definida como: SybaseTable	Sim
tableName	Nome da tabela no banco de dados Sybase.	Não (se "consulta" na fonte da atividade for especificado)

Exemplo

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

Se você estava usando RelationalTable o conjunto de dados digitado, ele ainda é suportado como está, enquanto você é sugerido para usar o novo no futuro.

Propriedades da atividade Copy

Para obter uma lista completa de seções e propriedades disponíveis para definir atividades, consulte o artigo Pipelines . Esta seção fornece uma lista de propriedades suportadas pela fonte Sybase.

Sybase como fonte

Para copiar dados do Sybase, as seguintes propriedades são suportadas na seção fonte de atividade de cópia:

Propriedade	Descrição	Necessário
tipo	A propriedade type da fonte de atividade de cópia deve ser definida como: SybaseSource	Sim
query	Use a consulta SQL personalizada para ler dados. Por exemplo: `"SELECT * FROM MyTable"`.	Não (se "tableName" no conjunto de dados for especificado)

Exemplo:

"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 RelationalSource fonte digitada, ela ainda é suportada como está, enquanto você é sugerido para usar a nova no futuro.

Mapeamento de tipo de dados para Sybase

Ao copiar dados do Sybase, os mapeamentos a seguir são usados de tipos de dados Sybase para tipos de dados provisórios usados internamente no serviço. Consulte Mapeamentos de esquema e tipo de dados para saber como a atividade de cópia mapeia o esquema de origem e o tipo de dados para o coletor.

Sybase suporta tipos T-SQL. Para obter uma tabela de mapeamento de tipos SQL para tipos de dados de serviço provisórios, consulte a seção Azure SQL Database Connector - data type mapping .

Propriedades da atividade de pesquisa

Para saber detalhes sobre as propriedades, verifique Atividade de pesquisa.

Para obter uma lista de armazenamentos de dados suportados como fontes e coletores pela atividade de cópia, consulte Armazenamentos de dados suportados.