---
title: Jira
description: Jiraを接続して同期の動作を把握し、書き込まれるすべてのテーブルと列をクエリします。
species: reference
---
# Jira

メールアドレス、テナントのドメイン、API トークンを使って Jira を接続します。このソースは `titan.jira` に 23 個の基本テーブルと検出したカスタムフィールドを書き込みます。
## Jiraを接続する

1. **アプリ**を開き、**アプリを接続**を選択してから、**Jira**を選択します。
2. メールアドレス、テナントのドメイン、API トークンを入力します。
3. テーブルを確認してからソースを保存します。
4. 初回の実行が完了するまで**同期履歴**を確認します。

認証情報はシークレットとして保存されます。レイクの列になったり、クエリ結果に表示されたりすることはありません。

## 同期の動作

課題のカスタムフィールドは型付きの列と補助テーブルに展開されます。ソースのドメインが衝突した場合は、テナントのデータを混在させず、設定を停止します。

新しいソースは接続時に同期し、その後はスケジュールに従います。デフォルトの繰り返し間隔は 4 時間です。実行が中断しても、完了した進捗を保持して安全に再試行します。

すべてのレイクのテーブルには[システム列](/docs/concepts/your-lake#システム列) `_synced_at` と `_deleted` もあります。以下の列リファレンスにはソースの列のみを記載しています。

## テーブルリファレンス

Supernova は接続したアカウントからこのリファレンスの情報を検出します。Jira のフィールドメタデータからカスタム列を定義します。課題のリンク、スプリント、コメント、複数選択の値は関連テーブルになります。

初回の検出が完了したら、**アプリ → Jira → テーブル**を開き、すべての正確なテーブル名、列名、型、同期対象を確認します。アカウントを接続するまでは、動的なフィールドを正確に一覧化できません。

## 削除と履歴

行はソースのキーでマージされます。ソース側で行の削除を確認できた場合、Supernova は行を残して `_deleted` を設定します。クエリで履歴を含めるかどうかを選べます。現在の状態だけを取得するには `where not _deleted` で絞り込んでください。