RDB ツール

← ShimoDocs Suite デプロイメント文書

Tip

RDB は、オペレーションプラットフォームでリレーショナルデータベースのデータを表示およびトラブルシューティングするために使用され、ビジネス記録、構成記録、タスクの状態、操作ログ、その他の構造化データを確認するために一般的に使用されます。

使用する前に、現在のアカウントにミドルウェアツールの権限があり、正しい展開環境が選択されていることを確認してください。

RDB ツールはデータベースデータに直接アクセスします。クエリを実行する前に、テーブルとフィルタ条件を確認して、高コストのクエリを実行したり、本番データを誤操作したりしないようにしてください。

1. アクセス RDB

1. にログイン MDP 操作プラットフォーム.
2. 選択 システムサービス 上部にあります。
3. 展開 ミドルウェアツール 左側のナビゲーションパネルにあります。
4. 選択 RDB.

ページには通常、データベース接続、テーブル選択、 SQL 入力、およびクエリ結果の領域が含まれています。

2. データベース接続の選択

1. ページで、 RDB アクセスする必要があるデータベースインスタンスを選択します。
2. インスタンス名、データベースアドレス、または環境識別子が現在のトラブルシューティング対象と一致していることを確認してください。
3. 対象のデータベースを選択します。
4. テーブルリストを展開し、対象のテーブルが存在することを確認します。

データベースインスタンスが空であるか、接続に失敗した場合は、まずミドルウェアの設定、アカウント権限、ネットワーク接続を確認してください。

3. テーブル構造の確認

1. 左側のテーブルリストから対象のテーブルを選択します。
2. フィールド名、フィールドタイプ、主キー、インデックス情報を確認します。
3. フィールドの意味に基づいて、以降のクエリ条件を確認します。

以下の情報に注目することをお勧めします:

情報	説明
主キー	単一のレコードを正確にクエリするために使用します。
ビジネスID	テナントID、ユーザーID、タスクID、ファイルIDなど。
ステータスフィールド	ビジネスの現在のフロー状況を確認するために使用します。
時間フィールド	クエリの時間範囲を制限するために使用します。
インデックス付きフィールド	可能であれば、全表スキャンを減らすためにクエリフィルターとして使用してください。

4. 一般的な使用 SQL

「共通」 SQLは、証明書、申請書、ファイル、ユーザーなどの高頻度チェックシナリオに適した、事前設定されたクエリを迅速に実行するために使用されます。

1. クリック 一般 SQL 編集者の上に。 SQL
2. 選択 SQL ドロップダウンリストから使用する必要があります。
3. まず明細内容を確認する必要がある場合は、クリックしてください プレビュー 対応するものの隣に SQL.
4. プレビュウウィンドウで説明、データベース、テーブル名、および SQL 内容を確認します。
5. すべてが正しいことを確認したら、 実行.

よく使われる SQL プレースホルダーが含まれている場合があります：

プレースホルダー	パラメータータイプ	例
%s	文字列	アプリID、プロバイダーファイルID、履歴GUID、プロバイダーユーザーID
%d	数値	内部ユーザーID

もし SQL プレースホルダーが含まれている場合は、 入力 SQL パラメーター 実行時にウィンドウが表示されます。

1. プロンプトに従って各パラメーターを入力してください。
2. 文字列パラメーターの場合は、追加の引用符を付けずに完全なIDを入力してください。
3. 数値パラメーターには純粋な数字を入力してください。
4. クリック クエリを実行.

よく使用される SQL 現在主に以下のシナリオが含まれます:

シナリオ	説明
証明書の照会	アプリケーション証明書およびアプリケーションIDを照会します。
指定されたappidによる照会	アプリケーションIDによるアプリケーションの詳細を照会します。
指定されたカスタマーファイルguidによる照会	ファイルの詳細を照会します provider_file_id.
指定された内部ファイルguidによる照会	ファイルの詳細を照会します history_guid.
指定された内部ユーザーIDによる照会	内部ユーザーIDによるユーザーの詳細を照会します。
指定されたカスタマーユーザーIDによる照会	ユーザーの詳細を照会します provider_user_id.

よく使用されるものを使用する前であっても SQL、対象環境やパラメータ値を確認する必要があります。よく使用されるものは SQL 手動で記述するコストを削減するためだけであり、この照会結果が調査の目的を満たすことを保証するものではありません。

5. 照会の実行

1. 入力エリアに照会文を入力します。 SQL 入力エリアに照会文を入力します。
2. できるだけ使用してください SELECT 照会を行い、insert、update、delete文を実行しないでください。
3. デフォルトの照会 LIMIT は10で、手動で調整可能です。
4. クリック クエリを実行.
5. できるだけ実行してください EXPLAIN、および 照会を開始する前に実行を確認します 。

例：

SELECT *
FROM example_table
WHERE id = 'example-id';

6. クエリ結果の表示

1. 結果エリアで返されたレコードを表示します。
2. キー項目が期待通りであるか確認します。
3. 結果が空の場合は、データベース、テーブル名、クエリ条件、時間範囲を確認してください。
4. 結果が多すぎる場合は、より正確なフィルタ条件を追加して再クエリ実行してください。

7. クエリ履歴の使用

「クエリ履歴」は、現在のページで実行された SQL ステートメントを見るために使用され、トラブルシューティング用のステートメントの再利用、実行結果の確認、コピーが便利です。 SQL."

Note

クエリ履歴は現在のブラウザにローカル保存され、永続的には保存されません。各データベース/テーブルの次元では最新100件まで保存され、自動的な時間経過による削除は現時点ではありません。ブラウザのサイトデータを消去、ブラウザを変更、デバイスを変更、または別のデータベース/テーブルに切り替えると、異なる履歴レコードが表示されます。

1. に切り替える 結果エリアのクエリ履歴 で表示します。
2. 実行状況、時間、データベース、テーブルを表示します。 SQL、履歴記録に返された行数と経過時間。
3. ステートメントを再実行するには、 SQL そのレコードの操作列で「エディタに挿入して実行」をクリックします。 **** ステートメントを再利用するだけの場合は、
4. クリックしてください。 コピー SQL.

クエリ履歴フィールドの説明:

フィールド	説明
ステータス	実行が成功したかどうか; 失敗した場合は、エラープロンプトと連携してトラブルシューティングを行います。 SQL
時間	現在のクエリの実行時間。
データベース	実行中に選択されたデータベース。 SQL
テーブル	関連するテーブル SQL
SQL	実際に実行されたクエリ文
行数を返します	このクエリによって返されたデータ行数
経過時間	SQL 実行にかかる時間であり、遅いクエリのリスクがあるかどうかを判断するために使用できます
操作	再挿入と実行、またはコピーのサポート SQL.

クエリ履歴の問題をトラブルシューティングする際には、次に焦点を当てることが推奨されます:

状況	対応の提案
ステータス失敗	まず、以下を確認してください SQL 構文、データベース・テーブルの存在、およびフィールドが正しいかどうか。
時間がかかる	フィルター条件を追加するか、まずテーブル構造とインデックスフィールドを確認してください。
返される行が多すぎる	’ を追加WHERE’ 条件と ’ を追加LIMIT’.
複数のクエリ結果が一致しない	データベース、テーブル、または環境が切り替わっているか確認してください。

クエリ履歴は、現在のトラブルシューティングプロセスを確認するために使用されます。履歴を再実行する前に SQL、内容、対象データベース、および現在の環境をまだ確認する必要があります。 SQL

8. 一般的なトラブルシューティングのシナリオ

シナリオ	操作の提案
業務記録が存在するか確認してください	ビジネスIDを使用して正確にクエリを実行します。
タスクの状態を確認する	タスクIDでステータスフィールドと更新時間をクエリします。
効果のない設定をトラブルシューティング	設定テーブルで現在の値と更新時間をクエリします。
最近の変更を確認します	時間フィールドで降順にクエリし、返されるエントリの数を制限します。
アプリケーションまたは証明書情報をクエリします	「共通」で証明書クエリまたはappidクエリを使用することを優先します SQL”.
トラブルシューティング文を再利用します	コピー SQL 「クエリ履歴」から、パラメータを確認し、再実行します。

9. 注意事項

1. 本番環境での大規模テーブルへの無条件クエリは禁止されています。
2. 影響が不明な場合は、 SQL まず低リスク環境で確認してください。
3. 明確な変更計画と承認がある場合を除き、 RDB ツールを通じて業務データを直接修正しないでください。
4. よく使われるパラメータ SQL 環境間で誤ったクエリを避けるために、現在の環境の実際の値で入力する必要があります。
5. SQL クエリ履歴には機密性の高いIDが含まれている場合があります。コピーや転送を行う前に範囲を確認してください。
6. クエリ結果に機密情報が含まれる場合、全画面のスクリーンショットやプレーンテキストデータを外部に共有しないでください。