Azure Data Factory または Synapse Analytics を使用して Sybase からデータをコピーする

[アーティクル]
11/17/2023

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

企業向けのオールインワン分析ソリューション、Microsoft Fabric の Data Factory をお試しください。 Microsoft Fabric は、データ移動からデータサイエンス、リアルタイム分析、ビジネスインテリジェンス、レポートまで、あらゆるものをカバーしています。無料で新しい試用版を開始する方法について説明します。

この記事では、Azure Data Factory または Synapse Analytics パイプラインで Copy アクティビティを使用して、Sybase データベースからデータをコピーする方法について説明します。この記事は、コピーアクティビティの概要を示しているコピーアクティビティの概要に関する記事に基づいています。

サポートされる機能

この Sybase コネクタでは、次の機能がサポートされています。

サポートされる機能	IR
Copy アクティビティ (ソース/-)	1
Lookup アクティビティ	1

① Azure 統合ランタイム ② セルフホステッド統合ランタイム

コピーアクティビティによってソースまたはシンクとしてサポートされているデータストアの一覧については、サポートされているデータストアに関する記事の表をご覧ください。

具体的には、この Sybase コネクタは以下をサポートします。

SAP Sybase SQL Anywhere (ASA) バージョン 16 以降。
基本または Windows 認証を使用したデータのコピー。

Sybase IQ と ASE はサポートされていません。代わりに、Sybase ドライバーと共に汎用 ODBC コネクタを使用できます。

前提条件

この Sybase コネクタを使用するには、次の手順が必要です。

セルフホステッド統合ランタイムをセットアップする。詳細については、セルフホステッド統合ランタイムに関する記事をご覧ください。
統合ランタイムのコンピューターに、Sybase iAnywhere.Data.SQLAnywhere 用データプロバイダー (16 以降) をインストールします。

作業の開始

パイプラインでコピーアクティビティを実行するには、次のいずれかのツールまたは SDK を使用します。

UI を使用して Sybase のリンクサービスを作成する

次の手順を使用して、Azure portal UI で Sybase のリンクサービスを作成します。

Azure Data Factory または Synapse ワークスペースの [管理] タブに移動し、[リンクサービス] を選択して、[新規] をクリックします。
- Azure Data Factory
- Azure Synapse
Sybase を検索し、Sybase コネクタを選択します。
サービスの詳細を構成し、接続をテストして、新しいリンクサービスを作成します。

コネクタの構成の詳細

次のセクションでは、Sybase コネクタに固有の Data Factory エンティティの定義に使用されるプロパティについて詳しく説明します。

リンクされたサービスのプロパティ

Sybase のリンクされたサービスでは、次のプロパティがサポートされます。

プロパティ	Description	必須
type	type プロパティは、次のように設定する必要があります:Sybase	はい
server	Sybase サーバーの名前です。	はい
database	Sybase データベースの名前です。	はい
authenticationType	Sybase データベースへの接続に使用される認証の種類です。使用できる値は、以下のとおりです。Basic および Windows。	はい
username	Sybase データベースに接続するユーザー名を指定します。	はい
password	ユーザー名に指定したユーザーアカウントのパスワードを指定します。このフィールドを SecureString とマークして安全に保存するか、Azure Key Vault に保存されているシークレットを参照します。	はい
connectVia	データストアに接続するために使用される統合ランタイム。「前提条件」に記されているように、セルフホステッド統合ランタイムが必要です。	はい

例:

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

データセットのプロパティ

データセットを定義するために使用できるセクションとプロパティの完全な一覧については、データセットに関する記事をご覧ください。このセクションでは、Sybase データセットでサポートされるプロパティの一覧を示します。

Sybase からデータをコピーするために、次のプロパティがサポートされています。

プロパティ	Description	必須
type	データセットの type プロパティは、次のように設定する必要があります:SybaseTable	はい
tableName	Sybase データベースのテーブルの名前。	いいえ (アクティビティソースの "query" が指定されている場合)

例

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

RelationalTable 型のデータセットを使用していた場合、現状のまま引き続きサポートされますが、今後は新しいものを使用することをお勧めします。

コピーアクティビティのプロパティ

アクティビティの定義に利用できるセクションとプロパティの完全な一覧については、パイプラインに関する記事を参照してください。このセクションでは、Sybase ソースでサポートされるプロパティの一覧を示します。

ソースとしての Sybase

Sybase からデータをコピーするために、コピーアクティビティの source セクションでは次のプロパティがサポートされています。

プロパティ	Description	必須
type	コピーアクティビティのソースの type プロパティは、次のように設定する必要があります:SybaseSource	はい
query	カスタム SQL クエリを使用してデータを読み取ります。 (例: `"SELECT * FROM MyTable"`)。	いいえ (データセットの "tableName" が指定されている場合)

例:

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

RelationalSource 型のソースを使用していた場合は現状のまま引き続きサポートされますが、今後は新しいものを使用することをお勧めします。

Sybase のデータ型マッピング

Sybase からデータをコピーするとき、Sybase のデータ型からサービス内で内部的に使用される中間データ型への、以下のマッピングが使用されます。コピーアクティビティでソースのスキーマとデータ型がシンクにマッピングされるしくみについては、スキーマとデータ型のマッピングに関する記事を参照してください。

Sybase では、T-SQL 型をサポートします。 SQL 型から中間サービスデータ型へのマッピングテーブルについては、Azure SQL Database のデータ型のマッピングに関するセクションを参照してください。

Lookup アクティビティのプロパティ

プロパティの詳細については、Lookup アクティビティに関するページを参照してください。

Copy アクティビティでソースおよびシンクとしてサポートされるデータストアの一覧については、サポートされるデータストアに関するセクションを参照してください。