データコネクタを使ったデータベースへの接続

多数のODBC互換データベースに対して、予めJMPで準備されている基本設定を利用できます。これらの設定をカスタマイズして共有することで、特定のデータソースからJMPにデータを読み込む際に、複数のユーザが同じ設定を利用できます。

使用可能なデータコネクタ

JMPは、WindowsレジストリまたはODBC.ini（Apple macOSの場合）にあるODBCを使用する既存のDSN（Data Source Names）を検索し、それらをデータコネクタに変換します。これらのコネクタは、その後JMP内からアクセスできるようになります。これにより、マシンごとに既存のDSNに手動で設定をしなくても、データソースへのアクセスが簡単に行えます。

次の表は、DSNがローカルコンピュータに登録されている場合に、JMP内で標準的に利用できるデータコネクタを一覧にしたものです。いくつかのデータコネクタについては、複数のものから選択が可能です。ドライバ名に「_new」が付いたドライバが利用可能な場合は、その新しいドライバを使用することをお勧めします。

接続の確立

JMPでデータコネクタを用いてデータベースに接続するには、選択したデータソースのODBCドライバをインストールした後、以下の手順に従います。

1. ［ファイル］>［接続］>［データコネクタ］を選択します。

「コネクタ」ボックスに、接続が確立されているデータソースが一覧表示されます。

2. ［新規接続］をクリックします。

データコネクタの新規接続ウィンドウが表示されます。

図3.51 新規接続ウィンドウ 

3. 3種類のコネクタ（ビルトインコネクタ、アドインコネクタ、ユーザ作成コネクタ）からのいずれかのコネクタを選択します。ビルトインコネクタは、JMPが予め提供しているデータコネクタの集合です。アドインコネクタは、他の人が作成したアドインからインストールされたデータコネクタの集合です。

ビルトインコネクタは、com.jmpという接頭辞になっています。アドインコネクタは、アドインIDが接頭辞になっています。ユーザ作成コネクタには、接頭辞がありません。新しく選択したコネクタに対しては、データコネクタの設定にリストされているオプションを設定する必要があります。

4. 設定を済ませたコネクタを選択し、［接続］をクリックします。

新規接続ウィンドウが閉じ、「データコネクタの選択」ウィンドウに戻ります。

データコネクタを使用したデータベースからのデータの読み込み

データベースからデータを読み込むには

1. ［ファイル］>［接続］>［データコネクタ］を選択します。

「データコネクタの選択」ウィンドウが表示されます（Figure 3.52）。

2. データベースにすでに接続している場合は、「コネクタ」ボックスでその接続を選択します。

「コネクタ」ボックスには、JMPが接続しているデータソースが表示されています。「スキーマ - テーブル」ボックスに、スキーマをサポートするデータベースのスキーマが表示されます。

図3.52 接続を確立する前の「データコネクタの選択」ウィンドウ 

3. 目的のデータソースが「コネクタ」ボックスに一覧表示されていない場合は、［新規接続］をクリックしてデータソースを選びます。

データコネクタの設定の手順に従ってください。

4. 「コネクタ」ボックスで、目的のデータソースを選びます。

すると、「テーブル」ボックスのテーブルリストが更新されます。更新には、テーブル数やデータベースへの接続速度に応じて、数秒かかることがあります。データベースがスキーマをサポートする場合、リスト内の最初のスキーマのテーブルが表示されます。他のスキーマのテーブルは、そのスキーマをクリックすると表示されます。

5. 表示されるテーブルを指定するには、［テーブルリストに含める］のオプションを選びます。

メモ: これらのオプションの解釈方法は、ドライバによって異なります。

ユーザテーブル これをクリックすると、使用できるすべてのユーザテーブルが「テーブル」ボックスに表示されます。表示されるユーザテーブルは、コンピュータにログインしたユーザによって異なります。

ビュー これをクリックすると、開くことができる全種類のファイルと「ビュー」が「テーブル」ボックスに表示されます。「ビュー」とは仮想的なテーブルで、開くたびに実行されるクエリーの結果セットです。「ビュー」を使って、1つまたは複数のテーブルから情報を抽出したり、結合したりできます。

システムテーブル これをクリックすると、使用できるすべてのシステムテーブルが「テーブル」ボックスに表示されます。システムテーブルとは、すべてのユーザが使用できるか、またはシステムレベルのサービスで使用されるテーブルです。

シノニム これをクリックすると、使用できるすべてのORACLEシノニムが「テーブル」ボックスに表示されます。

6. 「テーブル」リストから目的のテーブルを選びます。

7. ［テーブルを開く］をクリックして、選択したテーブルのすべてのデータを読み込むか、［クエリービルダー］をクリックして、読み込むテーブルのサブセットを指定します。

詳細については、クエリービルダーでのSQLクエリーの作成を参照してください。

大きいテーブルを開く場合は、表示に時間がかかる場合があります。アクティブなODBCクエリーのステータスを確認するには、［表示］>［実行中のクエリー］を選択します。

メモ: データが以前JMPでデータベースに書き出されたものであり、式タイプの列を含んでいる場合は、その列が文字タイプとして読み込まれます。［列］>［列情報］を選択し、データタイプを［式］に変更してください。

データコネクタの設定

「データコネクタの選択」ウィンドウで［新規作成］を選択すると、「データコネクタエディタ」ウィンドウが表示されます。このウィンドウで、ログイン情報やSQL形式など、データベースに接続するためのオプションを設定します。

「接続」グループのフィールドについては、そこで［値なし］に設定すると、そのODBC接続文字列に何も指定しないことになります。ブール値を受け入れるオプションは、［オン］と［オフ］のいずれかを設定できます。

図3.53 「データコネクタエディタ」ウィンドウ 

「データコネクタエディタ」ウィンドウのオプション

基準

基本設定として用いる設定の種類を指定します。

なし

すべてのフィールドを、デフォルト値である空白の設定とします。

ID

提供されたIDの設定を各フィールドに用います。

ファイル

提供されたファイルパスの設定を各フィールドに用います。

指定

テキストで指定された設定を各フィールドに用います。ここでのテキスト指定では、
KEY1 = VALUE1; KEY2 = VALUE2;という構文で指定します。ここで、KEYは「ID」や「Server」などのキーワードを指し、VALUEには、データ接続する際のIDの値やServerの値を指定します。［指定］は、特定の設定をもつデータコネクタを、そのIDを指定しながらテストするのに役立ちます。

接続

データベースに接続するためのオプションを提供します。

接続

ODBC接続における接続文字列を指定します。

データベース

接続先のデータベースの名前を指定します。

ドライバ

ドライバの名前を指定します。

パスワード

データベースにアクセスするためのパスワードを指定します。

パスワードキー

「パスワード」フィールドの値にマッピングする接続文字列キーを指定します。

ポート

ポートの値を指定します。

サーバー

サーバーインスタンスの名前を指定します。

サーバーキー

「サーバー」フィールドの値にマッピングする接続文字列キーを指定します。

テーブル

開くテーブルの名前を指定します。

ユーザ

サーバーへのログイン名を指定します。

ユーザキー

「ユーザキー」フィールドの値にマッピングする接続文字列キーを指定します。

ODBC

非同期実行の対応

（ブール値|自動）ドライバが非同期実行をサポートするかどうかを指定します。［自動］オプションが選択されている場合、JMPはこれを自動的に決定しようとします。

ブロックフェッチ

（ブール値）ドライバがブロックフェッチをサポートするかどうかを指定します。

ブロックフェッチに8バイトアライメントが必要

（ブール値）ブロックフェッチメモリにおいて8バイトアライメントを用いていることをドライバが想定するかどうかを指定します。

シノニムテーブルのリスト

「データコネクタの選択」ウィンドウの「テーブルリストに含める」パネルでの指定に応じて、テーブルリストにシノニムテーブルを含めるかどうかを示します。

常に

ユーザの好みに関係なく、シノニムテーブルを含めます。

しない

ユーザの好みに関係なく、シノニムテーブルを除外します。

ユーザ設定による

ユーザの好みに応じてシノニムテーブルを含めます。

システムテーブルのリスト

「データコネクタの選択」ウィンドウの「テーブルリストに含める」パネルでの指定に基づいて、テーブルリストにシステムテーブルを含めるかどうかを示します。

Excelドライバなどの一部のドライバは、すべてのテーブルをシステムテーブルとみなします。これらのテーブルがいつもリストに表示されるようにするには、［常に］を選択します。

常に

ユーザの好みに関係なく、システムテーブルを含めます。

しない

ユーザの好みに関係なく、システムテーブルを除外します。

ユーザ設定による

ユーザの好みに応じてシステムテーブルを含めます。

スクロール可能なカーソル

（ブール値|自動）ドライバがスクロール可能なカーソルの使用をサポートするかどうかを指定します。［自動］オプションが選択されている場合、JMPはこれを自動的に決定しようとします。

JMPは、SQLFetchの代わりにSQLFetchScroll ODBC関数を使用します（スクロール可能なカーソルがサポートされている場合）。

SQLDescribeColがテーブル名を含む可能性あり

（ブール値）SQLDescribeCol ODBC関数によって返される列名にテーブル名を含めることができるかどうかを指定します。クラウドデータソース用の一部のドライバでは、列名にテーブル名を含めることができます。［オン］オプションが選択されている場合、JMPはSQLDescribeCol ODBC関数によって返された値を解析します。

スキーマのサポート

（ブール値|自動）ドライバがスキーマをサポートするかどうかを指定します。［自動］オプションが選択されている場合、JMPはこの関数を自動的に決定しようとします。

値の末尾の空白に意味あり

（ブール値）末尾の空白を除くと値は同じだが、末尾の空白の有無や文字数が異なっている場合、それらの値を異なるものとみなすかどうかを指定します。多くのデータベースでは、末尾の空白だけが異なる値は等しい値だと見なされます。これらを一意な値とみなすために、JMPはこのオプションを使用します。

Success with Infoをフェッチエラーとして扱う

（ブール値）「Success with Info」という結果をエラーとして扱うかどうかを指定します。データをフェッチするときに、一部のドライバはデータを切り詰めて、エラーではなく「Success with Info」という結果を返します。

SQL

SQLコマンドをフォーマットするためのオプションを提供します。

デフォルトのケース(大文字/小文字)

（なし|大文字|小文字）引用符で囲まれていないSQL識別子を、引用符で囲んだコードにする際に、そららのSQL識別子を大文字にするか、小文字にするかを指定します。たとえば、SQL Serverは、select colname from ...とselect COLNAME from ...を引用符で囲まれたselect [COLNAME] from ...と同じように扱うため、このオプションを［大文字］に設定する必要があります。このオプションは、SQLコード内の識別子を引用符で囲む際に、それらを大文字に変換するか、小文字に変換するかを決めるために用います。

日付リテラル形式

（関数）ここで指定された関数に基づいて、日付と時刻のデータを分かりやすい形式に変換します。「Default」という文字列を指定した場合、JMPは独自の変換を使用します。

ここで指定する関数には、日付または時刻のデータに加えて、「DATE」、「TIME」、または「TIMESTAMP」のいずれかの文字列での条件分岐が必要です。

計算式エディタのモード

クエリービルダーで計算列の式を編集する際に、計算式エディタに表示する関数のセットを決定します。

Generic

一般的に使用できる関数のセットを指定します。

Access

Access SQLで使用できる関数のセットを指定します。

DB2

IBM Db2で使用できる関数のセットを指定します。

JMP

JMPで使用できる関数のセットを指定します。

MySQL

MySQLで使用できる関数のセットを指定します。

Oracle

Oracle Database SQLで使用できる関数のセットを指定します。

SAS

SASで使用できる関数のセットを指定します。

SQL Server

SQL Serverで使用できる関数のセットを指定します。

すべて

上記のオプションで使用可能なすべての関数を含めます。

行数をカウントするSQL

（関数）ここで指定した関数に基づき、テーブル内の行数が数えられます。関数の内部で、行数を数えるためのSQLクエリーを定義します。なお、［値なし］オプションを選択すると、行数は計算されません。クエリービルダーは、ここで指定された関数に基づきテーブル内の行数を表示します。

この関数では、スキーマとテーブル名という2つの引数を指定し、SQLクエリーで行数を数えた後、また、その文字列を戻り値で返す必要があります。スキーマが使用されていない場合、スキーマ名は空白にしてもかまいません。行数が不明な場合には、戻り値は空であるか、値が-1である必要があります。

以下のスクリプトは関数の例です。

//以下のようなクエリーで行数を数えます:

//     SELECT NUM_ROWS FROM all_tables WHERE

//     table_name = 'my_table' AND owner = 'my_schema';

Function({schema, table}, {quote string},

    quote string = Function({str}, "'" || Substitute(str, "'", "''") || "'");

    Concat(

        "SELECT NUM_ROWS FROM all_tables WHERE table_name = ",

        quote string(table),

        If(schema == "", "", " AND owner = " || quote string(schema)),

        ";"

    )

);

キーワード

（関数）SQLコード内で、SQL識別子ではなくキーワードとみなされる文字列を指定します。このオプションは、SQL識別子がキーワードとして解釈されるのを避けるために、キーワードと同じ名前のSQL識別子に引用符で囲むために使用されます。

引用符の種類

（二重 (“id”)|一重 ('id')|SAS ('id'n)|角括弧 ([id])|バッククォート (‘id‘)）識別子に使用されるエスケープ文字と引用符の種類を指定します。

NullとInの併用のサポート

（ブール値）INに指定する値にNULLを使用できるかどうかを指定します。

次の例は、［オン］オプションを指定したときに生成されるコードの一例を示しています。

col IN ("val1", "val2", NULL)

次の例は、［オフ］オプションを指定したときに生成されるコードの一例を示しています。

col IS NULL OR col IN ("val1", "val2")

末尾のセミコロン

（ブール値）セミコロンで終わるSQLクエリーをドライバが処理するかどうかを指定します。このオプションは、クエリービルダーによって生成されるSQLコードには直接影響しません。

引用符なしの名前のRegex

（正規表現）引用符で囲みたいSQL識別子を正規表現で指定します。キーワードと一致する識別子も含め、SQLコードにおいて引用符で囲まれていない識別子に対して、ここで指定した正規表現と一致する名前が引用符で囲まれます。デフォルトの正規表現は
^[A-Za-z_][A-Za-z_0-9]*$で、これはアルファベット文字またはアンダースコアの後に0個以上の文字、アンダースコア、または数字が続くものと正確に一致します。

SQL集計関数

SQL集計関数を指定するためのオプションを提供します。各オプションには、「値あり」として、関数または関数セットを示す文字列を指定するか、または「値なし」として、サポートされないことを指定します。

たとえば、「Average Distinct関数」にはデフォルトの文字列「AVG(DISTINCT」があります。これは、SELECT AVG(DISTINCT colname) FROM ...のような一意の値の平均を計算するSQLコードを生成するために使用されます。

SQL結合

SQLの結合のオプションを指定します。クエリービルダーはこれらのオプションを使用して、どの種類の結合が想定されるかを判断します。

ペアワイズJoinが必須

（ブール値）結合をペアワイズでのみ実行できるようにするかどうかを指定します。その場合は、括弧で囲む必要があります。

次の例は、このオプションが［オン］に設定されている場合のペアワイズ結合の一例を示しています。

SELECT *

FROM  (( table1  t1

    LEFT OUTER JOIN table2 t2

        ON  ( t1.col2 = t2.col2 ) )

    LEFT OUTER JOIN table3 t3

        ON  ( t1.col3 = t3.col3 )  )  ;

次の例は、このオプションが［オフ］に設定されている場合の結合の一例を示しています。

SELECT *

FROM table1  t1

    LEFT OUTER JOIN table2 t2

        ON  ( t1.col2 = t2.col2 )

    LEFT OUTER JOIN table3 t3

        ON  ( t1.col3 = t3.col3 ) ;

Cross Joinのサポート

（ブール値）Cross JOINsがサポートされるかどうかを指定します。

Full Outer Joinのサポート

（ブール値）Full outer JOINsがサポートされるかどうかを指定します。

Inner Joinのサポート

（ブール値）Inner JOINsがサポートされるかどうかを指定します。

Left Outer Joinのサポート

（ブール値）Left Outer JOINsがサポートされるかどうかを指定します。

Right Outer Joinのサポート

（ブール値）Right Outer JOINsがサポートされるかどうかを指定します。

SQLサンプリング

テーブルから抽出された行を返すSQLサンプリングを実装するためのオプションを提供します。

サンプルを生成する周囲のSQL

（関数）この関数では、サンプリングを行うための元のSQLクエリーに追加する処理を指定します。この関数は、サンプリングの設定を引数とする。また、関数の戻り値としては、空の文字列（追加の処理がないことを示す）、または、プレースホルダーテキスト^QUERYSQLを含む文字列を返すようにします。

次の例では、“First N”（最初のN行）をサンプリングする処理を実装しています。サンプリングの設定が"First N"の場合はクエリーのテンプレートを返し、それ以外の場合は空の文字列を返しています。

Function({qss}, {},

    If(qss << Get Sample Type != "First N", "",

        "SELECT * FROM (^QUERYSQL) WHERE ROWNUM <= "

        || Char(qss << Get Sample Amount)

    )

);

サンプル設定オブジェクトは、次のJSLメッセージをサポートしています。

<< Get Sample Amount

抽出する量を返します。これは、サンプルタイプに応じて、行数またはパーセント値（0～100）となります。

<< Get Sample Is Repeatable

無作為抽出で乱数シード値が明示的に指定されているかどうかを返します。

<< Get Sample Seed

無作為抽出で使われている乱数シード値を返します。

<< Get Sample Type

実行するサンプリングの種類、つまり“Percent”「パーセント」、“N Rows”「行数」、または“First N”「最初のN行」という文字列のいずれかを返します。

<< Get Use Block Sampling

ブロックサンプリング(1)と行サンプリング(0)のどちらを使用しているかを返します。

サンプルを生成するSQL

SQLクエリー内でサンプリングを実行するために使用されるコードと、クエリーにおけるそのコードの場所を決定します。

この関数は、サンプリング設定（上述の「サンプルを生成する周囲のSQL」で説明している）サンプリング設定とコンテキスト（文字列）の2つの引数を受け取ります。コンテキスト引数は、SQLクエリーのどこでJMPがコードを生成するかを示します。

次のコンテキストが利用できます。

“Before Columns”

SELECTと最初の列名との間に、戻り値のコードを埋め込みます。

“Before Alias”

最初のテーブル名とその別名との間に、戻り値のコードを埋め込みます。

“After From”

FROM節の最後と次の何かしらの節の前との間に、戻り値のコードを埋め込みます。

“After Joins”

JOIN節の最後とWHEREなどの追加の節の前との間に、戻り値のコードを埋め込みます。

“As Order By”

ORDER BY節を、戻り値のコードに置き換えます。これは、“At End”と似ていますが、戻り値のコードにORDER BY節が含まれている場合に使用します。

“At End”

SQLクエリーの一番最後に、戻り値のコードを埋め込みます。

ブロックサンプリングのサポート

（ブール値）OracleのSAMPLE BLOCKのように、サンプリングをブロック単位で、つまり個々の行よりも粗いレベルで実行できるかどうか（またはブロック単位でのみ実行できるかどうか）を指定します。

再現可能なサンプリングのサポート

（ブール値）OracleのSEED (123456)のように、シードを使用してサンプリングを再現できるかどうかを指定します。

行によるサンプリングのサポート

（ブール値）サンプリングを行単位で実行できるかどうか（または行単位でのみ実行できるかどうか）を指定します。

「先頭のＮ行」のサンプリングのサポート

（ブール値）PostgreSQLのLIMIT 1000のように、ユーザ指定のNに対して結果の最初のN行の取得がサポートされるかどうかを指定します。

「Ｎ行」のサンプリングのサポート

（ブール値）SQL ServerのTABLESAMPLE (1000 ROWS)のように、ユーザ指定のNに対して結果からランダムなN行を取得することがサポートされるかどうかを指定します。

N RowsとOrder By併用のサンプリングのサポート

（ブール値）ランダムな行数の取得と（ORDER BYを使った）出力の順序付けを同時に使用できるかどうかを指定します。これは、PostgreSQLのようなデータベースでは［オフ］であり、ランダムな行数の取得がORDER BY RANDOM() LIMIT 1000のような操作で実装されているため、ORDER BY節は通常の目的では使用できなくなります。

｢パーセント｣のサンプリングのサポート

（ブール値）SQL ServerのTABLESAMPLE (10 PERCENT)のように、ユーザ指定のNに対してパーセントによるサンプリングの結果の取得がサポートされるかどうかを指定します。

テスト

指定された値を使用して接続を試行し、テストが成功したかどうかを確認するメッセージボックスを表示します。

保存

現在のエディタの状態を指定されたIDで保存し、［データコネクタの選択］ウィンドウの使用可能なコネクタのリストに登録します。

名前を付けて保存

「名前を付けて保存」ウィンドウを表示し、現在のエディタの状態を指定されたIDで保存して、［データコネクタの選択］ウィンドウの使用可能なコネクタのリストに登録します。詳細については、接続の確立を参照してください。

ログに書き出し

エディタの現在の状態をログに書き込みます。ログに書き込まれたテキストは、設定ファイルの作成に使用できます。

データコネクタ設定の編集

既存のデータコネクタは、［データコネクタの選択］ウィンドウから編集できます。すでにデータコネクタを使って接続が確率している場合は、［データコネクタの選択］ウィンドウにそのコネクタが表示されます。

1. ［ファイル］>［接続］>［データコネクタ］を選択します。

2. ［新規接続］を選択します。

3. 事前に設定および接続されたデータコネクタを選択し、次に ［編集］を選択します。

データコネクタ設定の共有

設定済みのデータコネクタはJMPアドインとして保存および共有できます。異なるオペレーティングシステム上も含め、複数のユーザが利用できるようになります。

1. ［ファイル］>［接続］>［データコネクタ］を選択します。

2. 「コネクタ」フィールドの赤い三角ボタンをクリックします。

3. ［コネクタの共有］を選択します。

4. 共有する各コネクタをコネクタレジストリから「選択されたコネクタ」フィールドに追加するには、そのコネクタをダブルクリックするか、またはそのコネクタを選択して>ボタンをクリックします。

5. 「アドインファイルに名前を付けて保存」ウィンドウで［保存］を選択します。

6. データコネクタがJMPアドインファイルとして保存されます。

共有データコネクタアドインのインストール

JMPのアドイン機能を使えば、共有データコネクタを簡単にインストールおよび管理できます。『スクリプトガイド』の「JMPアドインの管理」を参照してください。

データコネクタを使ってExcelファイルに接続する例

データコネクタは、データベース以外にも、CSV、Microsoft Excelなどの種類のファイルにアクセスするためのものが提供されています。これらを使用する場合は、ODBC接続文字列ではなく、ファイルパスを指定する必要があります。

新しいデータコネクタを設定する際は、DBQ={filepath};構文でファイルパスを指定してください。

次の例では、ローカルコンピュータ上のXSLXファイルへの接続方法を紹介します。

1. ［ファイル］>［接続］>［データコネクタ］を選択します。

「データコネクタの選択」ウィンドウが表示されます。

2. ［新規接続］を選択してデータコネクタを選択します。

3. 表示されるダイアログで、利用可能なデータコネクタのリストから「com.jmp.excel」を選択します。

4. ［新規作成］を選択します。

「データコネクタエディタ」ウィンドウが表示されます。

5. 「接続」フィールドに、接続したいファイルへのパスを次の形式で指定します。

DBQ={C:\Users\YourName\Documents\data.xslx};

6. ［接続］を選択して、指定されたXSLXファイルに接続します。

データテーブルのJMP Liveへの発行

データコネクタを用いて読み込んだJMPデータテーブルをJMP Liveに発行すると、JMP Live上において、決められたスケジュールに従ってデータベースに接続し、グラフを描いたり分析したりするデータを自動更新させることができます。データコネクタの機能を用いることにより、複数のユーザがJMPやJMP Liveを使用して1つのデータソースにアクセスし、分析できるようになります。

データコネクタを使用して作成されたデータテーブルは、JMP Liveに発行することができます。また、JMP Live上で、特定のスケジュールに従って更新させることもできます。［テーブルを開く］に比べ、これらのデータテーブルは、適切なODBCドライバを指定することにあまり依存しないため、更新スクリプトの設定が簡単になります。

JMP Liveへのレポートの発行の詳細については、JMP Liveへのレポートの発行を参照してください。

より詳細な情報が必要な場合や、質問があるときは、JMPユーザーコミュニティで答えを見つけましょう (community.jmp.com).