設定の管理

設定を使用して、スプレッドシート・アドインのログ情報を格納および管理します。

「Oracle Database」メニューから、「設定」をクリックして次のオプションを構成します。

通常、ほとんどのオプションはスプレッドシートで使用できますが、一部のオプションはMicrosoft ExcelまたはGoogle Sheetsのみに固有です。

コンシューマ・グループの選択の表示

このオプションを使用すると、スプレッドシートから実行される問合せの優先度を設定できます。

デフォルトでは、クエリーは LOW優先度で実行されます。有効にすると、アドインには、問合せに対して「MEDIUM」または「HIGH」優先度を選択するオプションがあります。HIGH優先度を使用するクエリーは、より多くのリソースを消費し、結果をより速く取得する可能性があります。

ログ・レベル

各ログ・メッセージは、ログの重要度および緊急度を示す重大度レベルに関連付けられます。

ログ・レベルには、影響の最小値から最大値までの範囲の値を指定できます。次の表では、影響の降順でログ・レベルについて説明します。

ログ・レベル	説明
停止	情報を記録しません。これは最も低い影響です。
エラー	コンポーネントが使用できないなど、修正アクションを必要とする可能性のあるイベントを記録します。
WARNING	将来のある時点でエラーを引き起こす、または修正アクションを必要とする可能性のある問題を記録します。これは、デフォルトのログ・レベルです。
INFORMATION	コンポーネントの初期化中など、コンポーネントの完了したアクションまたは現在の状態を記録します。
詳細	エラー、警告、および情報を含む詳細な処理情報を表示します。これは最も大きな影響を与えます。

各レベルは累積されます。つまり、下位レベルによって生成されたすべてのデータが含まれます。たとえば、警告ログには、エラー・カテゴリに固有のイベントを含む、エラー・ログによって生成されたすべてのデータが含まれます。

ログ・メッセージのフォーマット

「ログ設定」は、指定されたログ・ファイルにメッセージを書き込みます。ログ・ファイルには、モジュール、タイムスタンプ、重大度、サーバー名、接続、メッセージなどの情報と、スタック・トレース(ある場合)が含まれます。各属性は、中カッコの間に指定します。

サーバー・ログ・ファイルの例を次に示します。

{
  "module": "ServerHelper",
  "logMessage": "New settings saved",
  "timestamp": 1688901058020,
  "level": 3,
  "payload": {
    "conAlias": "Excel Connection",
    "status": 400
  },
  "id": 161,
  "timeString": "19 Jun 20XX 16:40:58"
},
{
  "module": "ServerHelper",
  "logMessage": "serverRequest - success",
  "timestamp": 1688901059724,
  "level": 3
}

ログを保持する時間

ログ情報をログ・ファイルに格納するための時間制限を設定できます。このフィールドで指定した値より古いログは自動的にクリアされます。デフォルト値は12時間です。つまり、12時間より古いレコードは削除されます。

クリーン・ログ

このオプションは、すべてのログを削除します。

エクスポート・ログ

ログをエクスポートして、情報をJSON形式でファイルに保存できます。Windowsでは、エクスポート・オプションによって、ログ・ファイルがDownloadsなどのフォルダに直接保存されます。Macでは、ログ情報がクリップボードにコピーされます。ファイルに貼り付けて、ログを保存できます。

ログは、アドインが実行されているシステムにローカルに格納されます。これらは、サーバーまたはリモートの場所に存在しません。

その後、エラーを診断およびトラブルシューティングするために、ログ・ファイルをサポート・チームと共有できます。

ノート:

JSONログ・ファイルには、個人情報または機密データを含めることができます。ログ・ファイルを共有する前に、機密情報を保護してください。

リダイレクトURL

「PL/SQLのコピー」オプションを使用し、接続を手動で作成できます。このオプションは、Excelで使用できます。

親トピック: スプレッドシート・アドインでのOracle Databaseの使用