次の方法で共有


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

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

Data Factory in Microsoft Fabric は、よりシンプルなアーキテクチャ、組み込みの AI、および新機能を備えた次世代のAzure Data Factoryです。 データ統合を初めて使用する場合は、Fabric Data Factory から始めます。 既存の ADF ワークロードをFabricにアップグレードして、データ サイエンス、リアルタイム分析、レポートの新機能にアクセスできます。

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

サポートされる機能

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

サポートされる機能 IR
コピー アクティビティ (ソース/-)
ルックアップ アクティビティ

(1) Azure統合ランタイム (2) セルフホステッド統合ランタイム

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

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

  • SAP Sybase SQL Anywhere (ASA) バージョン 16 以降
  • Basic または Windows 認証を使用してデータをコピーする。

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

前提条件

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

作業の開始

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

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

Azure ポータル UI で Sybase へのリンクされたサービスを作成するには、次の手順に従います。

  1. Azure Data Factoryまたは Synapse ワークスペースの [管理] タブを参照し、[リンクされたサービス] を選択し、[新規] をクリックします。

  2. Sybase を検索し、Sybase コネクタを選択します。

    Sybase コネクタを選択します。

  3. サービスの詳細を構成し、接続をテストして、新しいリンク サービスを作成します。

    Sybase のリンク サービスを構成します。

コネクタの構成の詳細

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

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

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

プロパティ 内容 必須
type プロパティは、次のように設定する必要があります:Sybase はい
サーバー Sybase サーバーの名前です。 はい
データベース Sybase データベースの名前です。 はい
認証タイプ Sybase データベースへの接続に使用される認証の種類です。
使用できる値は、Basic、および Windows です。
はい
ユーザー名 Sybase データベースに接続するユーザー名を指定します。 はい
パスワード ユーザー名に指定したユーザー アカウントのパスワードを指定します。 このフィールドを SecureString としてマークして安全に格納するか、Azure Key Vault はい
connectVia データ ストアへの接続に使用するIntegration RuntimePrerequisitesで説明されているように、セルフホステッド Integration Runtime が必要です。 はい

例:

{
    "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 からデータ をコピーするために、次のプロパティがサポートされています。

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

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

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

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

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

ソースとしての Sybase

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

プロパティ 内容 必須
コピー アクティビティのソースの type プロパティは、次のように設定する必要があります:SybaseSource はい
クエリ カスタム 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 アクティビティでソースおよびシンクとしてサポートされるデータ ストアの一覧については、サポートされるデータ ストアに関するセクションを参照してください。