データベース インポート

このページの内容

お困りですか?

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

コミュニティに質問

You might want to import data from an internal or third-party system, like BMC Remedy or Service Now. This article guides you through importing data from another database. More about importing

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

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

はじめる前に

Here are some additional details that you might need to know to import a database:

  • Predefined structure and configuration aren’t available for this import type.

  • You can add any SQL to join multiple tables and conditions to extract the necessary fields.

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

We're using a common framework (JDBC) to connect to the database. For database address location, port, and database name, go to Connecting Jira applications to a database.

To connect to the Jira database, check the dbconfig.xml in your Jira_HOME directory to find the correct configuration and URL. Below are examples of URL configurations for different database types.

データベース タイプ

ドライバー

URL example

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

Importing data from databases

For testing purposes, you can use the following example of a database table. In this case, the attributes are the columns: name, color, and date.

#

name

created_on

1

apple

red

2023-03-02 13:32:22.455

2

lemon

green

2023-03-02 13:32:22.455

If the attribute “name” is selected as the Label, two objects will be created: “apple” and “lemon”. This will result in a configuration like this:

Database import example

インポート構造を作成するには、次の手順に従います。
  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. Select Save Import Configuration.

Next, you’ll need to manually create or review the object type and attribute mapping of your import configuration.

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

You can now view your import configuration, but it's not ready yet. Because the predefined structure and configuration aren’t available for this import type, you need to manually create or review the object type and attribute mapping, and make sure there are no problems with your import configuration.

Create object type mapping button

You need to select the object type you created earlier and add the database query that will return the data you want to import. After that, you can map the fields.

Make sure the identifier is set in the right database column. At least one column must be set as an identifier.

 Example of created object type mapping

When you're ready, go to 2. Create object type and attribute mapping.

最後に一言

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

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

The construction of the selector (the SQL statement) depends on the configuration of your database connection. Below are some examples that should guide you in the right direction when setting this up.

データベースタイプ

Microsoft SQL Server

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

<schema-name> is dbo by default. An example could be:

select * from dbname.dbo.Application
Oracle

select * from <schema-name>.Application

If <schema-name> is Jiraschema, the query will be:

select * from Jiraschema.Application


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

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

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