クラウド
Data Center 5.14
バージョン

データベース インポート

1. インポート設定を作成する

このページの内容

関連コンテンツ

  • 関連コンテンツがありません

お困りですか?

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

コミュニティに質問

社内のシステムやサードパーティのシステム (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. From your service project, go to Assets, then Object Schemas.

  2. From the Object Schemas list, select More actions and then select Configure.
    Configure an object schema window

  3. In the Schema configuration view, open the Import tab.

  4. Under the Import tab:

    • If there’s no import structure, you’ll see the message “You don't have any import connections yet”. Select Create Import configuration to create a new import structure.

    • If an import structure has already been created, select Create Configuration.
      Create import configuration window

  5. Select CSV import, then select Next.

  6. Fill in the General, Module, and Scheduling import fields.
    General fields of the import configuration

一般フィールド

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

名前

説明

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

You can specify a default concatenator. When joining multiple data locators into one Assets attribute, this will be the default concatenator. One example could be to join two columns like "First name" and "Last name" into one attribute. So "Mathias" (first name) and "Edblom" (last name) will be concatenated as "Mathias Edblom" if using \s as concatenator.

Enter \s for space-concatenated. To include a concatenate character, place the value between double quotes (i.e "\s").

空の値

Defines what should happen when a Data Locator is empty:

  • Ignore - the existing value in the object will be retained and not overridden by an empty value.

  • Remove - the existing value for the object will be removed, and replaced with an empty field value.

Defines what should happen if a Data Locator is unknown. This could happen with attribute types like "Status" and "Select". 

  • Ignore - the value from CSV will be ignored and the object attribute will be left empty.

  • Add - the value passed in the CSV file will be added to the list and the object attribute will be updated with the new value.

インポート ソースの日付フィールドを 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 式自動同期の間隔。
自動同期インポートを自動で同期するようにスケジュールするかどうか。

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.