必須条件

外部ツールを SQL API ドライバーに接続する前に、次の手順を完了していることを確認してください。

• SQL API プラグインが ServiceNow インスタンスにインストールされている。
• サービスアカウントの作成、ACL の設定、IP フィルターの設定など SQL API がインスタンスで構成されます。
• 適切な SQL API ドライバー (ODBC または JDBC) がダウンロードされ、クライアントマシンにインストールされます。
• ドライバーは、インスタンス URL、サービスアカウント認証情報、および接続パラメーターで構成されます。
• クライアントマシンの IP アドレスは、 SQL API IP フィルター構成に含まれています。
• サービスアカウントには、必要なロール (sn_odbc_rest_access または sn_jdbc_rest_access) とテーブルレベルのアクセス権限があります。

一般的な接続に関する考慮事項

外部 BI ツールを ServiceNow SQL API ドライバーに接続する場合は、次の考慮事項に留意してください。

• すべての接続は読み取り専用です。外部ツールは、SQL APIを介してServiceNowデータを変更することはできません。
• クエリのパフォーマンスは、ネットワーク接続、クエリの複雑さ、取得されるデータの量によって異なります。WHERE 句と列の選択を使用して、パフォーマンスを最適化します。
• セキュリティ権限は ServiceNow レベルで適用されます。接続されたツールは、サービスアカウントのロールと ACL 構成で許可されているテーブルとレコードにのみアクセスできます。
• 厳格なセキュリティはデフォルトで有効になっています。データをクエリすると、 SQL API は ACL を使用して行レベルとフィールドレベルでアクセスを検証します。その結果、クエリの応答時間が長くなる場合があります。これは想定される動作であり、 GlideRecordSecure の動作と一致しています。ロール sn_sql_api_privileged_mode を追加して、サービスアカウントレベルで厳格なセキュリティを無効にすることができます。
• デフォルトのクエリタイムアウトは 5 分です。クエリがこの制限を超えると、クエリは終了します。
• 1 時間あたり 500 クエリの制限内に収まるように、SQL クエリレートを監視します。
• きめ細かなアクセス制御を維持するために、さまざまなチームまたはプロジェクトにサービスアカウント固有の接続を使用することを検討してください。

サポートされている BI ツール

Power BI Desktop と DB Visualizer は、このガイドで具体的に文書化された例ですが、 SQL API ドライバーは ODBC または JDBC 互換アプリケーションをサポートしています。その他一般的に使用されるツールには次のようなものがあります。

• Tableau デスクトップサーバーと Tableau サーバー
• Looker および Looker スタジオ
• Microsoft Excel (ODBC 接続経由)
• SQL Server 管理 スタジオ
• DBeaver およびその他のユニバーサル・データベース・ツール
• ODBC または JDBC API を使用するカスタムアプリケーション

各ツールには独自の接続構成インターフェイスがありますが、基礎となる接続パラメーター (インスタンス URL、サービスアカウント認証情報、ドライバーの選択) はすべてのプラットフォームで一貫しています。