JSON サービスへの接続
JavaScript Object Notation(JSON)は、属性と値のペアと配列データ型から成るデータ オブジェクトを送信するのに使用される標準的なファイル形式です。JSON は Web サービスとの通信によく使用される形式です。
メモ
このコネクターを Analytics から独立して使用することはできません。コネクター ドライバーの DSN は Windows の ODBC データ ソース アドミニストレーターを使って設定できますが、DSN 接続を本コネクターの[Windows DSN configuration(Windows DSN 設定)]ダイアログ 内でなく、Analytics 内でテストする必要があります。
メモ
接続で認証が必要な場合は、ACL Robotics の Professional Edition で JSON コネクターを使用できません。
開始する前に
JSON サービスに接続するには、問い合わせ対象となるファイルの構造を判別すると共に、お使いのファイルを行が含まれる表形式の構造に分割するのに必要な JSONPath または XPath の構文を作成する必要があります。各接続について 1 つのテーブルをインポートできます。
接続の前提条件の収集については、組織の JSON サービスの管理者に支援を仰いでください。管理者から支援を得られない場合は、あなたまたは管理者から接続先となるシステムのサポート サービスにお問い合わせください。
認証が必要な JSON 接続
接続する JSON サービスでトークンまたはユーザー資格情報での認証が必要な場合は、Windows ODBC Data Source Administrator でデータ接続(DSN)を作成する必要があります。認証情報を含む DNS を作成した後、データ アクセス ウィンドウで選択できます。
JSON 接続の作成
- Analytics のメイン メニューから、[インポート > データベースとアプリケーション]を選択します。
- ACL コネクター セクションの[新規の接続 ]タブから、JSONを選択します。
ヒント
使用可能なコネクターのリストをフィルタリングするには、[接続のフィルタリング]ボックスに検索文字列を入力します。コネクターはアルファベット順に表示されます。
- [データ接続の設定]パネルが開いたら、接続設定を入力し、パネルの下部にある[保存して接続]をクリックします。
デフォルトの接続名を使用するか、新しい接続名を入力します。
お使いのコネクターの接続は、[既存の接続]タブに保存されます。今後は、保存したこの接続を使って、お使いのコネクターに再度接続できます。
接続が確立されると、データ アクセス ウィンドウが開いてステージング領域が表示されるので、データのインポートを開始できます。コネクターからのデータのインポートのヘルプについては、データ アクセス ウィンドウを使用したデータのインポートを参照してください。
接続設定
基本設定
設定 | 説明 | 例 |
---|---|---|
テーブル |
JSON ドキュメント内の配列要素の JSONPath(JSON ドキュメントを複数の行に分割するのに使用されます)。 これは、配列要素の JSONPath(または XPath の構文)を指定するもので、JSON ドキュメントを複数の行に分割するのに使用されます。 このプロパティは、スキーマ ファイル(RSD ファイル)が存在しない場合にスキーマ定義を生成するのに使用されます。 メモ
JSONPath と XPath は標準化されたクエリ形式です。この構文とキーワードの詳細については、オンラインのリソースを参照してください。 |
$.<値> |
JSON の場所 |
JSON リソースの Uniform Resource Identifier(URI)または絶対ファイル パス |
http://sample.example.net/examples.json |
詳細設定
設定 | 説明 | 例 |
---|---|---|
鍵サイズの上限 |
主キー列の最大長。サイズを 0 に接続すると、キー長が元の長さに戻ります。 このプロパティでは、コネクターが主キー列のすべての報告された列を無効にします。 |
255 |
Long Varchar にマッピング |
列が SQL_LONGVARCHAR として返されるかどうかを制御します。 この設定を使用すると、指定されたサイズよりも大きい列をマッピングし、SQL_VARCHAR ではなく、SQL_LONGVARCHAR として報告されます。 |
-1 |
WVarchar にマッピング |
文字列タイプを SQL_VARCHAR ではなく、SQL_WVARCHAR にマッピングするかどうかを制御します。デフォルトで設定されます。 文字列を SQL_WVARCHAR にマッピングし、さまざまな国際文字セット格納するため、MapToWVarchar はデフォルトで true に設定されています。false に設定すると、SQL_VARCHAR を使用できます。 |
true |
擬似列 |
擬似列を列としてテーブルに含めるかどうかを指定します。 この設定は、テーブル列ではない場合に、擬似列の値を設定できない Entity Framework で特に有用です。 この接続設定の値は、"Table1=Column1, Table1=Column2, Table2=Column3" の形式です。"*" 文字を使用すると、すべてのテーブルとすべての列を含めることができます。 |
MyTable=* |
SSL サーバー証明書 |
TLS/SSL を使用して接続するときにサーバーから許可される証明書。次のいずれかを指定できます。
TLS/SSL 接続を使用している場合は、このプロパティを使用して、サーバーから許可される TLS/SSL 証明書を指定できます。コンピューターから信頼されない他の認定書はすべて拒否されます。 |
C:\cert.cer |
日付時刻を GMT に変換 | インポート時に日付時刻フィールドを GMT タイムゾーンに変換します。日付時刻値は、false の場合には、Analytics を実行するコンピューターのオペレーティング システム タイムゾーンに変換されます。 | true |
プロキシ認証スキーム |
ProxyServer プロキシで認証するために使用する認証タイプ。 この値は、ProxyServer および ProxyPort で指定された HTTP プロキシで認証するために使用する認証タイプを指定します。 メモ コネクターはデフォルトでシステム プロキシ設定を使用し、さらなる構成は必要ありません。別のプロキシに接続する場合は、ProxyAutoDetect を false に設定し、ProxyServer と ProxyPort も false に設定する必要があります。認証するには、ProxyAuthScheme を設定し、必要に応じて、ProxyUser と ProxyPassword を設定します。 認証タイプは次のいずれかにすることができます。
|
BASIC |
プロキシ自動検出 | システムプロキシ設定を使用するかどうかを指定します。ProxyAutoDetect を FALSE に設定すると、カスタム プロキシ設定を使用します。これは他のプロキシ設定よりも優先されます。 | true |
プロキシ ユーザー |
ProxyServer プロキシで認証するために使用されるユーザー名。 ProxyUser および ProxyPassword オプションは、ProxyServer で指定された HTTP プロキシに対して接続および認証するために使用されます。 ProxyAuthScheme で使用可能な認証タイプのいずれかを選択できます。HTTP 認証を使用している場合は、これを HTTP プロキシで認識されるユーザーのユーザー名に設定します。Windows または Kerberos 認証を使用している場合は、このプロパティを次の形式のいずれかのユーザー名に設定します。
|
john_doe@example.com |
プロキシのパスワード |
ProxyServer プロキシで認証するために使用されるパスワード。 このプロパティは、NTLM (Windows)、Kerberos、または HTTP 認証をサポートする HTTP プロキシ サーバーで認証するために使用されます。HTTP プロキシを指定するには、ProxyServer と ProxyPort を設定できます。認証タイプを指定するには、ProxyAuthScheme を設定します。 HTTP 認証を使用している場合は、追加で、ProxyUser と ProxyPassword を HTTP プロキシに設定します。 NTLM 認証を使用している場合は、ProxyUser と ProxyPassword を Windows パスワードに設定します。Kerberos 認証を完了するためにこれらが必要な場合もあります |
|
プロキシ サーバー |
HTTP トラフィックをルーティングするプロキシのホスト名または IP アドレス。 HTTP トラフィックをルーティングするプロキシのホスト名または IP アドレス。ドライバーは、HTTP、Windows (NTLM)、または Kerberos 認証タイプを使用して、HTTP プロキシで認証できます。 デフォルトでは、ドライバーはシステム プロキシを使用します。別のプロキシを使用する場合は、ProxyAutoDetect を false に設定します。 |
206.174.193.115 |
プロキシのポート | ProxyServer プロキシが実行されている TCP ポート。 | 80 |
プロキシ SSL タイプ |
ProxyServer プロキシに接続するときに使用する SSL タイプ:
|
AUTO |