データベース インポート

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

社内のシステムやサードパーティのシステム (BMC Remedy や Service Now など) からデータをインポートする必要がある場合があります。この記事では、別のデータベースからデータをインポートする方法を説明します。インポートについての詳細をご確認ください。

データベース インポートを作成し、設定して有効化するには、Jira 管理者である必要があります。

次のセクションにジャンプ:

はじめる前に

データベースをインポートするには、以下のことについても把握しておく必要があります。

  • 事前定義済みの構造と設定は、このインポート タイプでは利用できません。

  • 任意の SQL を追加することで、複数のテーブルや条件を結合して必要なフィールドを抽出することができます。

サポート対象データベース

データベースへの接続には共通フレームワーク (JDBC) を使用しています。データベースのアドレスの場所、ポート、データベース名については、「Jira アプリケーションのデータベースへの接続」をご確認ください。

Jira データベースに接続するには、Jira_HOME ディレクトリの dbconfig.xml をチェックして、正しい設定と URL を見つけてください。以下は、さまざまなデータベースタイプの URL 構成の例です。

データベース タイプ

ドライバー

URL の例

Microsoft SQL Server

com.microsoft.sqlserver.jdbc.SQLServerDriver

jdbc:sqlserver://localhost:1433;databaseName=Jiradb

Oracle

oracle.jdbc.OracleDriver

jdbc:oracle:thin:@//localhost:1521/ORCL

PostgreSQL

org.postgresql.Driver

jdbc:postgresql://localhost:5433/Jiradb

MySQL

com.mysql.jdbc.Driver

jdbc:mysql://localhost:3306/Jiradb?useUnicode=true&characterEncoding=UTF8&sessionVariables=storage_engine=InnoDB

データベースからデータをインポートする

テスト目的で、以下のデータベース テーブルの例を使用できます。この場合、属性は名前、色、日付の列です。

#

name

created_on

1

Apple

2023-03-02 13:32:22.455

2

lemon

green

2023-03-02 13:32:22.455

属性「名前」がラベルとして選択されると、「apple」と「lemon」という 2 つのオブジェクトが作成されます。これにより、次のような設定になります。

データベースのインポート例

インポート構造を作成するには、次の手順に従います。
  1. サービス プロジェクトから、[アセット] > [オブジェクト スキーマ] の順に移動します。

  2. [オブジェクト スキーマ] リストから [ その他のアクション] > [構成] の順に選択します。
    オブジェクト スキーマ ウィンドウを構成する

  3. スキーマ構成ビューで [インポート] タブを開きます。

  4. [インポート] タブで、次の手順に従います。

    • インポート構造がない場合は、「インポート接続はまだありません」というメッセージが表示されます。新しいインポート構造を作成するには、[インポート設定を作成] を選択します。

    • インポート構造が作成済みである場合は、[設定を作成] を選択します。
      インポート構成ウィンドウを作成する

  5. [CSV インポート] > [次へ] の順に選択します。

  6. [一般]、[モジュール]、[スケジュール] の各インポート フィールドに入力します。
    インポート構成の一般的なフィールド

一般フィールド

次は、すべてのインポート タイプに共通する一般的なフィールドです。

名前

説明

名前インポートの名前。
説明 参考用の説明。
連結子

既定の連結子を指定できます。複数のデータ ロケーターを結合して 1 つのアセット属性を作成すると、これが既定の連結子となります。たとえば、"姓" と "名" のような 2 つの列を 1 つの属性に結合できます。つまり、"Mathias" (名) と "Edblom" (姓) は、連結子である \s によって "Mathias Edblom" として連結されます。

スペースの連結には \s を入力します。連結文字を含めるには、その値を二重引用符で囲みます ("\s")。

空の値

データ ロケーターが空である場合の処理は、次のように定義されます。

  • 無視 - オブジェクト内の既存の値は保持され、空の値で上書きされません。

  • 削除 - オブジェクトの既存の値が削除され、空のフィールド値に置き換えられます。

データ ロケーターが不明である場合の処理を定義しましょう。これは、"ステータス" や "選択" などの属性タイプで発生する可能性があります。 

  • 無視 - CSV の値は無視され、オブジェクト属性は空のままになります。

  • 追加 - CSV ファイルで渡された値がリストに追加され、オブジェクト属性が新しい値で更新されます。

インポート ソースの日付フィールドを Insight の日付に変換する際の形式。空のままにすると、Insight で正しい形式が自動で検索されます。
この形式は、Java の SimpleDateFormat のガイドラインに従って指定する必要があります。

インポート ソースの日付/時刻フィールドを Insight の日付に変換する際の形式。空のままにすると、Assets で正しい形式が自動で検索されます。
この形式は、Java の SimpleDateFormat のガイドラインに従って指定する必要があります。

モジュール フィールド

これらのフィールドはインポート タイプ (モジュール) に固有です。

設定

説明

URL

データベース接続 URL。Jira データベースに接続する場合は、Jira_HOME の dbconfig.xml で正しい設定と URL を確認できます。

ドライバー

データベースへの接続に使用するドライバー クラス。

JDBC ドライバー (*.jar) を <Jira_INSTALL>/lib フォルダーに配置します。

lib フォルダーにドライバーを追加後、Jira を必ず再起動してください。

ユーザ名

認証に使用するユーザー名。

パスワード

認証に使用するパスワード。

データベースのパスワードを入力します。

Jira データベースをクエリする場合は、Jira_HOME ディレクトリの dbconfig.xml で正しい設定を確認できます。

スケジュール フィールド

スケジュール フィールドは、データの同期を維持するために使用されます。

名前説明
同期アカウント

データをアセットに同期する際に使用する Jira ユーザー。

LDAP およびデータベースのインポートでは、同期に使用するアカウントに Jira 管理者権限が必要です。

cron 式The interval for the automatic synchronization. Explore cron expressions
自動同期インポートを自動で同期するようにスケジュールするかどうか。

7. [インポート設定を保存] を選択します。

次に、インポート設定のオブジェクト タイプと属性マッピングを手動で作成または確認する必要があります。

作成されたインポート設定

これでインポート設定を表示できるようになりましたが、まだ準備が完了していません。このインポート タイプでは定義済みの構造と設定を使用できないため、オブジェクト タイプと属性マッピングを手動で作成または確認して、インポート設定に問題がないことを確認する必要があります。

オブジェクト タイプ マッピング ボタンを作成する

作成したオブジェクト タイプを選択し、インポートしたいデータを返すデータベース クエリを追加する必要があります。その後、フィールドをマッピングできます

識別子がデータベースの右列に設定されていることを確認してください。少なくとも 1 つの列を識別子として設定する必要があります。

 作成されたオブジェクト タイプ マッピングの例

準備ができたら、「2. オブジェクト タイプと属性マッピングを作成する」に進みます。

最後に一言

次のステップでは、オブジェクト タイプと属性マッピングを作成します。データベース インポート タイプに固有の設定をいくつか紹介します。

オブジェクト タイプ マッピングの設定

セレクター (SQL ステートメント) の構造は、データベース接続の設定によって異なります。次に、セットアップ時にこれを正しく設定するガイドとなる例をいくつか示します。

データベースタイプ

Microsoft SQL Server

select * from <database.name>.<schema-name>.Application

<schema-name> は初期設定では dbo です。以下に例を示します。

select * from dbname.dbo.Application
Oracle

select * from <schema-name>.Application

<schema-name>Jiraschema の場合、クエリは次のようになります。

select * from Jiraschema.Application


PostgreSQL
select * from "Application"
MySQL
select * from Application
最終更新日: 2024 年 12 月 30 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.