> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sync.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 変換ページ
export const cloudEnv = false;
export const siteNameShort = "Sync";
export const siteName = "CData Sync";
*変換*はデータソースから生データを取得して、整形、加工を行い、データパイプラインを実行する際のお客様のニーズを満たす形式にデータを整理します。変換では必要なデータの形式を決めることができ、必要なデータだけを必要な形式で取得できます。
以下のセクションでは、**変換**ページの機能と、次のタスクについて説明します：
* [新しい変換を追加](#新しい変換を追加)
* [変換にラベルを追加](#変換にラベルを追加)
* [SQL Transformation をエクスポート](#sql-transformation-をエクスポート)
* [SQL Transformation をインポート](#sql-transformation-をインポート)
* [スケジューラーを有効化 / 無効化](#スケジューラーを有効化--無効化)
* [変換の起動と停止](#変換の起動と停止)
## 変換を表示
**変換**ページにアクセスするには、{siteName} インターフェースの左側のナビゲーションペインにある**変換**アイコンをクリックします。このページは、すべての変換のリストを表示します。**変換**ページには、変換に関するすべての詳細を表示する2つのタブ（**概要**および**履歴**）があります。以下のセクションでは、これらの各タブに表示される情報について説明します。
### 概要タブ
このページには変換が一覧にまとめられており、1つのアクセスポイントから変換を管理できます。
変換のレコードは行単位で表示され、カラムには各変換の詳細が示されます。上に示したように、ページ下部にある***X* レコードを表示**で数値を選択することで、ページに表示する行数を指定できます。
{siteNameShort} には、変換の詳細を提供するカラムが5つあります：
* **名前** - 変換名、同期先コネクタ、および変換の種類（**SQL** または**dbt Cloud**）をリストします。
* **ラベル** - 変換に割り当てられたラベルを表示します。ラベルは以下のいずれかの方法で追加できます：
* 変換行の右端にある\*\*. . . > ラベルを追加\*\*を選択する。
* 各変換の設定にある**概要**タブの**ラベル**セクションで、**ラベルを追加**をクリックする。
* **スケジュール** - 変換の実行スケジュールを指定します。詳しくは、[スケジューラーを有効化 / 無効化](#スケジューラーを有効化--無効化)を参照してください。
* **最後の実行** - 変換が最後に実行された日時、実行にかかった時間、影響を受けた行数を表示します。
* **次の実行** - 次に変換が実行される日時を表示します。
変換名をクリックすると、{siteNameShort} はその変換の**設定**ページを開きます。
変換リストは、**名前**、**最後の実行**、**次の実行**カラムを使って昇順または降順で並べ替えができます。カラムを並べ替えるには、ソートしたいカラムの横にある上（↑）または下（↓）の矢印をクリックするだけです。
### 変換テーブルのフィルタリング
さらに、変換の種類、ステータス、同期先、およびラベルでテーブルをフィルタできます。フィルタを設定後、フィルタメニューの右側にある**リセット**リンクをクリックすることで、すべてのフィルタオプションをクリアできます。{siteNameShort} では、定義したフィルタを保存しておき後から使用できるようにすることも可能です。
フィルタを保存するには：
1. フィルタのオプションを選択します。
2. **保存済みフィルタ > 保存済みフィルタを追加**を選択します。
**保存済みフィルタを追加**ダイアログボックスが表示されます。
3. フィルタの名前を入力します。次に**保存済みフィルタを追加**をクリックします。
フィルタを保存すると、フィルタ名が**保存済みフィルタ**のリストに表示されます。これで、必要なフィルタをいつでもリストから選択して適用することができます。
### 変換に対する一括操作の実行
複数の変換で一括操作を使用するには：
1. 変換の横にあるチェックボックスを1つ以上の選択します。
2. 以下に示すように、黒いナビゲーションバーで、実行したい一括操作（**削除**、**実行**、**スケジュールを無効化**、**スケジュールを有効化**、**ラベルを追加**、および**選択解除**）をクリックします：
### 履歴タブ
**履歴**タブには、実行した変換の履歴情報が表示されます。このページのテーブルには、変換の詳細を表示する3つのカラムが含まれます：
* **名前** - 変換名および変換の種類をリストします。
* **実行日** - 実行ステータス（**成功**、**失敗**、または**エラー**）、変換が実行された日時、変換の実行にかかった時間、影響を受けた行数を表示します。エラーが発生した場合、このカラムにエラーメッセージが表示されます。
* **インスタンスID** - 変換を実行したインスタンス識別子（Id）を指定します。このId は変換を実行したマシンを示すため、クラスタ環境では重要です。
このタブでは、次の方法で変換履歴を管理することもできます：
* 変換履歴リストは、**実行日**または**インスタンスID** カラムを使って、昇順または降順で並べ替えができます。カラムを並べ替えるには、ソートしたいカラムの横にある上（↑）または下（↓）の矢印をクリックするだけです。
* 変換の種類、ステータス、および同期先接続でテーブルをフィルタできます。ほかのページとは異なり、**履歴**タブではフィルタオプションをリセットしたり保存したりすることはできません。**概要**タブをクリックするかナビゲーションバーの**変換**アイコンをクリックすると、フィルタをクリアして変換テーブルに戻ることができます。
* **履歴をエクスポート**ボタン（ウィンドウの右上）をクリックして、変換履歴をローカルマシンにエクスポートできます。履歴のエクスポートは、過去1日、過去2日、過去5日のいずれかを選択できます。
* 変換行の最後にあるオプションメニュー（**...**）をクリックして必要なオプションを選択することで、変換の設定を編集したり、履歴ログをダウンロードしたり、詳細を取得したりできます。
### 変換の管理
変換行の末尾にカーソルを合わせると表示されるオプションメニュー（**...**）から、変換を管理できます。メニューから次のオプションが利用可能です：
* **編集** - 一般設定の変更、E メールアラートの設定、実行する変換のスケジューリング、変換履歴の表示など、変換の設定を編集します。
* **クローン** - 変換のコピーを作成します。別のワークスペースにクローンを作成したり、別の同期先を選択したり、タスクと設定をコピーしたりできます。
* **エクスポート** - 変換をSYNCJOB ファイルとしてローカルマシンに保存します。パスワードを指定して、機密値をエクスポートおよび暗号化することもできます。
* **移動** - 変換を1つのワークスペースから別のワークスペースに移動します。
* **ラベルを追加** - 変換にラベルを適用します。ラベルは、**変換**概要ページの変換の**ラベル**カラムに表示されます。
* **削除** - 変換を完全に削除します。
これらのメニューオプションの使用方法の詳細については、このページの後のセクションで説明します。
## 新しい変換を追加
変換を追加するには、事前に設定された同期先接続またはdbt 変換が必要です（作成する変換の種類に応じて）。[データベースへのサポートされている同期先接続を定義](../../connections/connections)後、または[dbt 変換を設定](../../transformations/post-job-elt/dbt-transformations)後、次の手順に従って新しい変換を作成します：
1. ナビゲーションバーの**変換**をクリックして**変換**ページを開きます。
2. **変換を追加 > 新しい変換を追加**（右上隅）を選択します。このアクションにより、変換情報を入力できる**変換を追加**ダイアログボックスが開きます。
3. 変換名を入力します。次に、変換の種類（**SQL** または**dbt Cloud** のいずれか）と、同期先（**SQL** の場合）、もしくはdbt 変換（**dbt Cloud** の場合）を選択します。
4. 変換の種類を選択します。
5. **変換を追加**をクリックして、新しい変換を作成します。
特定の変換ページ（**変換 > *YourTransformationName***）から、[実行スケジュールのトリガーの設定](../../transformations/post-job-elt/sql-transformations#trigger-category)、[クエリの追加および管理](../../transformations/post-job-elt/sql-transformations#queries-tab)（SQL クエリのみ）、[カラムのマッピング](../../transformations/etl#mapping-columns)など、特定の機能を設定できます。
## 変換にラベルを追加
{siteNameShort} を使用すると、変換にラベルを追加できます。これは、整理や追跡に役立ちます。ラベルには、任意のものを設定することが可能です。例えば、変換の優先度（例：**優先度高**、**優先度中**、**優先度低**）などを設定できます。
ラベルを追加するには：
1. **変換**ページの**概要**タブをクリックします。
2. エクスポートする変換の行の右端にある\*\*... > ラベルを追加\*\*を選択します。\*\**TransformationName* - ラベルを追加\*\*ダイアログボックスが開きます。
3. **ラベルを検索または追加**テキストボックスで、追加したいラベルを入力します。次に**追加**をクリックします。
新しいテキストは、以下のように、ラベルのリストにアルファベット順で追加されます：
別のラベルを追加したい場合は、この手順を繰り返します。
4. **保存**をクリックすると、追加したラベルが**概要**タブの変換行の**ラベル**カラムに追加されます。
ラベル作成後、変換行にあるオプション（**...**）メニューの**ラベルの編集**をクリックすると、***TransformationName* - ラベルを編集**ダイアログボックスでラベルを編集することもできます。
ラベルを削除することはできません。ただし、次の手順で変換テーブルに表示されないようにすることができます：
- ... > ラベルを編集を選択します。
- TransformationName - ラベルを編集ダイアログボックスで、ラベル名の横にあるチェックボックスをOFF にします。
- 保存をクリックします。ダイアログボックスを終了すると、変換の行のラベルカラムからラベルが削除されます。
## 変換設定を編集
変換を作成後、設定や構成オプションを編集したい場合があります。これらの設定と構成の編集に関する詳細は、[SQL Transformation 設定の指定](../../transformations/post-job-elt/sql-transformations#specifying-sql-transformation-settings)および[DBT Transformation 設定の指定](../../transformations/post-job-elt/dbt-transformations#specifying-dbt-transformation-settings)を参照してください。
## 変換のクローン
変換をクローンするには：
1. **変換**ページの**概要**タブをクリックします。
2. クローンする変換の行の右端にある\*\*... > クローン\*\*を選択します。**変換をクローン**ダイアログボックスが開きます。
3. **名前** フィールドに変換の名前を入力します。デフォルトの名前を使用することも、新しい名前を指定することもできます。
ワークスペースには同じ名前の複数の変換を含めることができないため、元の名前を再利用するにはクローンされた変換を別のワークスペースに移動する必要があります。
4. （オプション）変換を別のワークスペースに配置するか、元の名前を再利用する場合は、**別のワークスペースにクローン**チェックボックスをON にします。このオプションを選択すると、{siteNameShort} はダイアログを展開して**新しいワークスペース**ドロップダウンリストを表示し、ワークスペースを選択できるようになります。**同期先を選択**リストも表示され、同期先（元の同期先か新しい同期先）を選択する必要があります。
5. （オプション）新しい変換で別の同期先を使用する場合は、**別の同期先を選択**チェックボックスをON にします。**別のワークスペースにクローン**オプションと同様に、このチェックボックスをON にすると、**同期先を選択**リストが表示され、同期先を選択する必要があります。
6. （オプション）新しい変換に元の変換のタスクと追加設定を含める場合は、**タスク**、**追加設定**、またはその両方を選択します。
7. **クローン**をクリックして、新しい変換を作成します。
## SQL Transformation をエクスポート
{siteNameShort} では、SQL Transformation のみエクスポート可能です。**変換**ページからマシンの任意の場所に変換をエクスポートすることができます。
SQL Transformation をエクスポートするには：
1. **変換**ページを開き**概要**タブをクリックします。
2. 変換テーブルの変換の行末にある\*\*... > エクスポート\*\*を選択します。**変換をエクスポート**ダイアログボックスが開きます。
デフォルトでは、変換名は**ファイル名**テキストボックスに含まれ、**機密値をエクスポート**の**有効化**オプションは選択されていません。アプリケーション設定は、SYNCJOB ファイル（例：*MySettings*.syncjob）としてエクスポートされます。
機密値のエクスポートを有効化すると、**パスワード**テキストボックスが表示されます。機密値のエクスポートと暗号化に使用されるパスワードを入力する必要があります。後で変換をインポートする場合にもこのパスワードが必要になります。
3. **エクスポート**をクリックして変換をアップロードします。{siteNameShort} は、変換を**ダウンロード**フォルダにエクスポートします。ファイルは、マシンの任意の場所に移動することができます。エクスポートされたSYNCJOB ファイルには、同期先、タスク、追加の設定を含むエクスポートした変換の詳細が含まれています。
## SQL Transformation をインポート
{siteNameShort} では、SQL Transformation のみインポート可能です。マシンから**変換**テーブルにこれらの変換をインポートすることができます。
SQL Transformation をインポートするには：
1. **変換**ページから、**変換を追加 > 変換をインポート**を選択します。**変換をインポート**ダイアログボックスが開きます。
2. **ファイルの選択**をクリックしてエクスプローラを開き、インポートする変換を選択します。（変換ファイルは、以下に示すようにSYNCJOB ファイルである必要があります。）ファイルを選択すると、以下のようにダイアログボックスが展開されます。
3. 元の変換名を使うか、必要に応じて変換名を変更します。次に、新しい同期先を作成するか、既存の同期先を選ぶかを選択します。
4. **インポート**をクリックして、変換を**変換**テーブルにインポートします。
## 変換をワークスペース間で移動
{siteNameShort} では、変換は一度に1つのワークスペースにのみ存在できます。ただし、次のようにして、変換をワークスペースから別のワークスペースに簡単に移動できます：
1. **変換**ページの**概要**タブをクリックします。
2. 移動する変換の行の右端にある\*\*... > 移動\*\*を選択します。これを選択すると、**変換を移動**ダイアログボックスが開き、元のワークスペースが表示されます。
3. **新しいワークスペース**リストから同期先ワークスペースを選択します。
4. **移動**をクリックして、変換を新しいワークスペースに移動します。
## スケジューラーを有効化 / 無効化
以下の2つの方法で、スケジューラーを有効化 / 無効化できます：
* **変換**のメインページにある**スケジュール**カラムを使用する（すべての変換が対象）。このオプションを使用すると、そのページにあるすべての変換に対して、すでに定義されているスケジュールを有効または無効にできます。スケジュールを有効にするには、スイッチを右にスライドします。スケジュール設定が有効になると、スイッチが青色に変わります。
* 設定ページにある**概要**タブの**トリガー**カテゴリを使用する（個々の変換が対象）。このカテゴリを使用すると、変換を実行するためのスケジュールを設定できます。**トリガー**カテゴリの**設定**をクリックして、**トリガーを編集**ダイアログボックスを開きます。
**スケジュール実行**または**ジョブ後**を選択すると、ダイアログボックスが動的に変化し、それぞれの選択に関連する設定オプションが表示されます。**なし**を選択すると、トリガーは設定されず、変換は手動で実行する必要があります。
## 変換の起動と停止
変換行の最後にカーソルを置き、**変換を実行**（▷）アイコンをクリックすることで変換を開始できます。
変換の実行中に、**変換を停止**（■）アイコンをクリックすると、実行をキャンセルできます。
## 詳細について
{siteNameShort} の変換およびその仕組みについての詳細は、[変換](../../transformations/transformations)を参照してください。