> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Workbench 5でODBCデータに接続する

export const InlineImage = ({src, alt = '', height = '1.6em'}) => {
  return <img noZoom src={src} alt={alt} style={{
    display: 'inline',
    verticalAlign: 'start',
    height: height,
    margin: '0'
  }} />;
};

## はじめに

Workbench 5では、ODBC DataSetジョブを作成できます。データソースタイプにODBCを選択したら、接続の詳細を指定してクエリを設定することができます。

<Note>
  **注記：** Workbench 5の実行時に、使用しているWindowsが32ビット版なのか64ビット版なのかが判定されます。ユーザーがどちらかのWindowsを指定するよう求められることはありません。
</Note>

## ODBCデータに接続する

**Workbench 5でODBC DataSetジョブを作成するには、**

1. 左側のアイコンバーにある
   <InlineImage src="/images/kb/ka05w00000123sE-00N5w00000Ri7BU-0EM5w000005vPOU.png" /> アイコンをクリックします。

2. ジョブリストペインの右上にある［+］ボタンをクリックします。

3. **［Domoドメイン］**
   ドロップダウンメニューで、必要なアカウント（Domoインスタンス）を選択します。

   アカウントが1つしか設定されていない場合は、そのアカウントが既に選択されているため、メニューは使用できません。

4. **［名前］**
   フィールドに、DataSetジョブの名前を入力します。

   これは、Workbenchで表示されるジョブ名です。DomoにアップロードされたDataSet名では *ありません* 。

5. **［トランスポートタイプ］**
   メニューで、 **［ODBC接続プロバイダー］** を選択します。

6. **［読み取りタイプ］**
   メニューで、 **［データベースクエリ］** を選択します。

7. **［DataSet名］**
   フィールドに、DataSet名を入力します。これは、DomoにアップロードされたDataSet名です。

   新しいジョブを保存した後に変更できるのは、 *この設定のみ* です。

8. **［DataSetタイプ］**
   フィールドに、ドロップダウンからDataSetのタイプを選択します。

   ここで選択 または入力するDataSetのタイプは、ジョブ実行後のDomoの コネクタータイプに反映されます。

9. 適宜DataSetの説明を入力します。

   Domoに表示されるDataSetの説明です。

10. **［作成］**
    をクリックします。

    現在認証されているアカウントのジョブリストに、ODBC DataSetジョブが新規に追加されます。ジョブを作成した後は、DataSet名以外の設定は編集できません。他の設定を変更する場合は、新しいジョブを作成する必要があります。

11. **［設定］**
    サブタブをクリックします。

12. 「ソース」の下の
    **［編集］** をクリックします。

    ODBC接続を設定し、クエリを定義するためのパネルが開きます。

    <Note>
      **注記：** Workbenchで実行されるクエリは1つのみです。1つのクエリで処理できる範囲以上のことを行う必要がある場合は、ストアドプロシージャを作成し、Workbenchでそれを実行してください。
    </Note>

13. **［接続タイプ］**
    フィールドで、接続オプションを選択します。

    以下の表に、利用可能なオプションを説明しています。

    <table border="1" cellpadding="1" cellspacing="1">
      <thead>
        <tr><th colspan="1" rowspan="1"><p> オプション </p></th><th colspan="1" rowspan="1"><p> 説明 </p></th></tr>
      </thead>

      <tbody>
        <tr>
          <td colspan="1" rowspan="1">
            <p> システムのDSN </p>
          </td>

          <td colspan="1" rowspan="1">
            <p> システムで利用可能なDSNから、目的のDataSetに使用するDSNを指定します。認証が必要かどうかを指定できます。 </p>

            <Note>
              <div class="info-box-wrapper"><div class="info-box-icon-container"><span class="info-box-icon" /></div><div class="info-box-content-container"><div class="info-box-content"><p><span><b> 注記： </b></span></p><ul><li><p><span> ODBC DataSetからデータをアップロードするとき、既存のデータソース名（DSN）を指定する必要があります。DSNは、Windows ODBCデータソースアドミニストレーターを使用して作成できます。（Windows ODBCデータソースアドミニストレーターにアクセスするには、スタートメニューの検索で「ODBC」と入力し、［データソース（ODBC）］を選択します）。DSNの作成に関する詳細は、Windows ODBCヘルプ（Windowsヘルプとサポートで「ODBC」を検索）を参照するか、 <a target="_blank" title="Workbench 4"> 上記 </a> のトレーニング動画を参照してください。MySQLドライバの設定について詳しくは、「 <a class="confluence-link" href="/s/article/360043437373" target="_self" title="Workbench 4に関するよくある質問"> MySQLドライバのパフォーマンスを向上させるには </a></span> 」を参照してください。 </p></li><li><p><span> DataSet名（DSN）の定義方法、およびOpen Database Connectivity（ODBC）を使用したデータへのアクセスに関する情報は、ODBCの資料を参照してください。 </span></p></li><li><p><span> デフォルトでは、ODBC接続はDSNで定義された設定を使用します。つまり、データベースにとって潜在的に有害なクエリでも、ジョブをプレビューや実行したりするときにODBC接続を通して送信することが許されてしまいます。これには、 <span class="mt-font-courier-new"> alter </span> や <span class="mt-font-courier-new"> delete </span> 、 <span class="mt-font-courier-new"> create table </span> 、 <span class="mt-font-courier-new"> insert into </span> などのステートメントも含まれます。Workbenchがこういったコマンドを実行するのを防ぎたい場合は、DSNにこの変更を行う必要があります。 </span></p></li></ul></div></div></div>
            </Note>
          </td>
        </tr>

        <tr><td colspan="1" rowspan="1"><p> Connection Builder </p></td><td colspan="1" rowspan="1"><p> ログイン認証やドライバー、サーバーURL、データベース名、ポート、タイムアウト値、接続パラメーターなど、ODBC接続の詳細を入力します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> 接続文字列 </p></td><td colspan="1" rowspan="1"><p> 接続のための文字列を1つ入力します。 </p></td></tr>
      </tbody>
    </table>

14. （条件付き）以下のいずれかを行ってください。

    * **［接続タイプ］** に **［システムDSN］** を選択した場合は、

      1. **［システムDSN］** メニューで、利用可能なDSNから目的のシステムDSNを選択します。
      2. （条件付き）このDSN接続が接続に認証を必要とする場合は、**［認証が必要］** をオンにし、ユーザー名とパスワードを該当フィールドに入力します。それ以外の場合は、 **［認証が必要］** はオフにします。

    * **［接続タイプ］** に **［Connection Builder］** を選択した場合は、

      1. フィールドに適切な情報を入力します。

         接続によっては、パラメーターが必要となったり、不要となったりする場合があります。

         以下の表を参考にしてください。

         <table border="1" cellpadding="1" cellspacing="1">
           <thead>
             <tr><th colspan="1" rowspan="1"><p> フィールド </p></th><th colspan="1" rowspan="1"><p> 説明 </p></th></tr>
           </thead>

           <tbody>
             <tr>
               <td colspan="1" rowspan="1">
                 <p> ドライバー </p>
               </td>

               <td colspan="1" rowspan="1">
                 <p>
                   データベースへのアクセスに使用するドライバーの名前を指定します。

                   <br />
                 </p>

                 <Note>
                   <div class="info-box-wrapper"><div class="info-box-icon-container"><span class="info-box-icon" /></div><div class="info-box-content-container"><div class="info-box-content"><span><b> 注記： </b> Windowsには、MSSQLなどのMicrosoft製品のドライバーがデフォルトで付属しています。Microsoftではないデータベース（Oracle、MySQL、PostgreSQL、Mongo、DB2、SAP HANAなど）に接続したい場合は、適切なドライバーを入手してインストールする必要があります。 </span></div></div></div>
                 </Note>
               </td>
             </tr>

             <tr><td colspan="1" rowspan="1"><p> サーバー </p></td><td colspan="1" rowspan="1"><p> データベースのサーバー名またはURLを指定します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> データベース </p></td><td colspan="1" rowspan="1"><p> アクセスするデータベースの名前を指定します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> ポート </p></td><td colspan="1" rowspan="1"><p> データベースのポート番号を入力します。デフォルトのポートは、MySQLのポートです。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> タイムアウト </p></td><td colspan="1" rowspan="1"><p> DataSetから更新が行うまで接続を継続するタイムアウト値を、秒数で指定します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> ユーザー名 </p></td><td colspan="1" rowspan="1"><p> データベースの接続に使用するユーザー名を指定します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> パスワード </p></td><td colspan="1" rowspan="1"><p> データベースの接続に使用するパスワードを指定します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> 接続パラメーター </p></td><td colspan="1" rowspan="1"><p> DataSet接続のためのパラメーターを指定します。 </p></td></tr>
           </tbody>
         </table>

    * **［接続タイプ］** に **［接続文字列］** を選択した場合は、

      1. データソースに接続するのに使用する接続文字列を入力します。

15. **［適用］をクリックします。**

16. 「処理中」の下の **［編集］** ボタンをクリックします。

17. **［クエリ実行タイムアウト］** メニューで、タイムアウト値を設定します。

    これは、長時間実行されているジョブがタイムアウトになるまでの秒数です。

18. **［クエリ］** ペインで、取得したいデータのクエリを入力します。 例：

    ```
    SELECT
      
    order_audit_id,
      
    user_name,
      
    customer_name,
      
    order_source,
      
    order_total,
      
    created
      
    FROM order_audit
    ```

19. （オプション）**［置換変数］** タブと **［グローバル置換変数］** サブタブで、DataSetの列の置換変数を定義します。それぞれの置換変数に対して、

    1. 該当する列を **［列］** から選択します。

       <Note>
         **注記：** **［列］** の名前は、大文字と小文字が区別され、 **［スキーマ］** サブタブにある列の名前と一致している必要があります。
       </Note>

    2. 選択した列の置換変数を、**［値］** セクションで定義します。

       <table border="1" cellpadding="1" cellspacing="1">
         <thead>
           <tr>
             <th colspan="1" rowspan="1"><p> 変数タイプ </p></th><th colspan="1" rowspan="1"><p> 説明 </p></th>
           </tr>
         </thead>

         <tbody>
           <tr>
             <td colspan="1" rowspan="1">
               <p><span class="mt-font-courier-new"> lastvalue </span></p>
             </td>

             <td colspan="1" rowspan="1">
               <p>
                 <span class="mt-font-courier-new"> lastvalue </span> 変数は、関連付けられたジョブの最新のアップロードとともに送信されたデータ行の最終列について、関連するフィールドの変化を追跡します。構文は次のとおりです。
               </p>

               <p><code>!\{lastvalue:*name*}! </code></p><p><span class="mt-font-courier-new"> lastvalue </span> 変数の値は、アップロードの終了後にWorkbenchで更新されます。 <span class="mt-font-courier-new"> lastvalue </span> 変数は、ジョブ（ <span class="mt-font-courier-new">.xml </span> ）ファイルに保存されます。この変数を使って、実行のたびに「新しい」行のみを取得するクエリを作成することができます。例えば、新しい行が増えるに従って増えていく行の「id」を持つ列がデータに存在する場合、 </p><p><code>!\{lastvalue:id}! </code></p><p> を含むクエリを作成することができます。以下のようになります。 </p><p><code> select id, name, type, sales from tablename where id >!{}! order by id </code></p><p> この例では、「id」列が <span class="mt-font-courier-new"> SELECT </span> 、 <span class="mt-font-courier-new"> WHERE </span> 、 <span class="mt-font-courier-new"> ORDER BY </span> 節に必ず含まれていないと、変数を使用して更新することが <em> できません </em> 。 </p><p> このジョブをアップロードするときにWorkbenchは、 </p><p><code>!\{lastvalue:id}! </code></p><p> 変数を現在の「id」値と置き換えます。アップロード終了後、Workbenchは最後にアップロードされた「id」の値をジョブ（ <span class="mt-font-courier-new">.xml </span> ）ファイルに保存します。 </p>

               <Note>
                 <div class="info-box-wrapper"><div class="info-box-icon-container"><span class="info-box-icon" /></div><div class="info-box-content-container"><div class="info-box-content"><b> 注記： </b><span class="mt-font-courier-new"> SELECT </span> 、 <span class="mt-font-courier-new"> WHERE </span> 、 <span class="mt-font-courier-new"> ORDER BY </span> 節の中で <span class="mt-font-courier-new"> lastvalue </span> 変数を使って参照した列は必ず含めないと、データのアップロード後に変数を使用して更新することが <em> できません </em> 。 </div></div></div>
               </Note>
             </td>
           </tr>

           <tr><td colspan="1" rowspan="1"><p><span class="mt-font-courier-new"> previewonly </span></p></td><td colspan="1" rowspan="1"><p> Workbenchのプレビューを読み込む際、特定の操作が必要であることを示します。例えば、プレビューでは、データソースに存在する1,000,000件のデータではなく100行のみ返すように要求することができます。構文は次のとおりです。 </p><p><code>!\{previewonly:Statement}! </code></p></td></tr>
         </tbody>
       </table>

20. **［適用］** をクリックします。

21. **［更新方法］** メニューで、更新する方法を選択します。

    * 更新時に、DataSetを完全に入れ替えたい場合は、**［DataSetを置換］** を選択します。
    * 更新データを既存のデータに追加したい場合は、**［DataSetに追加］** を選択します。

これでDomoにODBC DataSetが作成され、DataSetジョブを実行する準備ができました。しかし、Domoに送信する前にDataSetジョブでできる操作はたくさんあります。例えば以下のような操作があります。

* [Workbench 5でジョブをスケジューリングする](/ja/s/article/360043212294 "Workbench 4でジョブをスケジューリングする")
* [ジョブの更新が成功または失敗したら通知するよう設定する](/ja/s/article/360043437333 "Workbench 4で通知を設定する")
* [Workbenchデータの暗号化と復号を行う](/ja/s/article/360043437413 "Workbench 4データの暗号化と復号を行う")
* [計算を使用して新しい列を作成する](/ja/s/article/360042932794 "Workbench 4で計算を使用して列を作成する")
* [列にカスタム日付形式を設定する](/ja/s/article/360043437473 "Workbench 4で列にカスタム日付形式を設定する")
* [列の値を置き換える](/ja/s/article/360043437433 "Workbench 4で列の値を置き換える")
* [DataSetを結合する](/ja/s/article/360043437193 "Workbench 4でDataSetを結合する")
* [列にフィルターをかける](/ja/s/article/360042932814 "Workbench 4で列にフィルターをかける")
* [偽装を設定する](/ja/s/article/360043437173)
  （WorkbenchのジョブをActive Directoryユーザーとして実行します）。
