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

適用対象: Azure Data Factory Azure Synapse Analytics

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

サポートされる機能

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

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

ソースおよびシンクとしてサポートされているデータ ストアの一覧については、「サポートされているデータ ストア」の表を参照してください。

このサービスでは接続を有効にする組み込みのドライバーが提供されるので、このコネクタを使用してドライバーを手動でインストールする必要はありません。

概要

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

• データのコピー ツール
• Azure Portal
• .NET SDK
• Python SDK
• Azure PowerShell
• REST API
• Azure Resource Manager テンプレート

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

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

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

   • Azureデータファクトリー
   • Azure Synapse

   

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

   

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

   

コネクタの構成の詳細

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

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

Jira コネクタでバージョン 2.0 がサポートされるようになりました。 Jira コネクタのバージョンをバージョン 1.0 からアップグレードするには、この セクション を参照してください。 プロパティの詳細については、対応するセクションを参照してください。

• バージョン 2.0
• バージョン 1.0

バージョン 2.0

Jira のリンクされたサービスでは、バージョン 2.0 の適用時に次のプロパティがサポートされます。

例:

{
    "name": "JiraLinkedService",
    "properties": {
        "type": "Jira",
        "version": "2.0",
        "typeProperties": {
            "host" : "<host>",
            "port" : "<port>",
            "username" : "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        }
    }
}

バージョン 1.0

Jira のリンクされたサービスでは、バージョン 1.0 の適用時に次のプロパティがサポートされます。

例:

{
    "name": "JiraLinkedService",
    "properties": {
        "type": "Jira",
        "typeProperties": {
            "host" : "<host>",
            "port" : "<port>",
            "username" : "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        }
    }
}

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

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

Jira からデータをコピーするには、データセットの type プロパティを JiraObject に設定します。 次のプロパティがサポートされています。

例

{
    "name": "JiraDataset",
    "properties": {
        "type": "JiraObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Jira linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

コネクタ バージョン 2.0 では、次の Jira テーブルがサポートされています。

• AdvancedSettings
• すべてのアクセス可能なプロジェクトタイプ
• AllApplicationRoles
• すべての利用可能なダッシュボードガジェット
• AllDashboards
• AllFieldConfigurations
• 全フィールド構成スキーム
• AllIssueTypeSchemes
• AllLabels
• すべての権限
• すべての権限スキーム
• すべてのプロジェクトカテゴリー
• AllProjectRoles
• AllProjectTypes
• AllUserDataClassificationLevels
• AllUsers
• AllUsersDefault
• AllWorkflowSchemes
• アプリケーションプロパティ
• おおよそのライセンス数
• 添付メタデータ
• オートコンプリート
• 使用可能な時間追跡実装
• バナー
• BulkGetGroups
• Configuration (構成)
• 現在のユーザー
• DashboardsPaginated
• DefaultEditor
• デフォルト共有範囲
• Events (イベント)
• FavouriteFilters
• FieldAutoCompleteForQueryString
• フィールド設定スキームマッピング
• Fields (フィールド)
• FieldsPaginated
• FiltersPaginated
• プロジェクトのコンポーネントを探す
• グループ検索
• IdsOfWorklogsDeletedSince
• IdsOfWorklogsModifiedSince
• IssueAllTypes
• 発行制限レポート
• IssueLinkTypes
• IssueNavigatorDefaultColumns
• IssuePickerResource
• 課題セキュリティスキーム
• IssueTypeSchemesMapping
• IssueTypeScreenSchemeMappings
• 課題タイプ画面スキーム
• ライセンス
• ロケール
• MyFilters
• 通知スキーム (NotificationSchemes)
• 通知スキームからプロジェクトマッピングへの対応付け
• Plans (プラン)
• 優先順位方式
• 最近
• 画面
• ScreenSchemes
• Search (検索)
• SearchProjects
• SearchProjectsUsingSecuritySchemes
• 検索解決策
• SearchSecuritySchemes
• SearchWorkflows
• セキュリティレベルメンバー
• セキュリティレベル
• 選択された時間追跡実装
• ServerInfo
• 共有時間追跡設定
• ステータスカテゴリ
• ステータス
• TrashedFieldsPaginated
• ユーザーデフォルトカラムズ

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

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

ソースとしての Jira

Jira からデータをコピーするは、コピー アクティビティのソースの種類を JiraSource に設定します。 コピー アクティビティの source セクションでは、次のプロパティがサポートされます。

例:

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

Jira のデータ型マッピング

Jira からデータをコピーする場合、Jira のデータ型からサービスで使用される内部データ型へのマッピングが次のように適用されます。 コピー アクティビティでソースのスキーマとデータ型がシンクにマッピングされるしくみについては、スキーマとデータ型のマッピングに関する記事を参照してください。

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

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

Jira コネクタのライフサイクルとアップグレード

次の表に、Jira コネクタのさまざまなバージョンのリリース ステージと変更ログを示します。

Jira コネクタをバージョン 1.0 からバージョン 2.0 にアップグレードする

1. [ リンクされたサービスの編集] ページで、バージョン 2.0 を選択し、リンクされたサービス プロパティバージョン 2.0 を参照してリンクされたサービスを構成します。

2. Jira のリンクされたサービス バージョン 2.0 のデータ型マッピングは、バージョン 1.0 とは異なります。 最新のデータ型マッピングについては、 Jira のデータ型マッピングに関するページを参照してください。

3. セルフホステッド統合ランタイムを使用する場合、そのバージョンは 5.61 以上である必要があります。

4. query はバージョン 1.0 でのみサポートされています。 バージョン 2.0 ではschemaではなく、tableとqueryを使用する必要があります。

関連コンテンツ

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