Red Hat Training
A Red Hat training course is available for Red Hat JBoss Operations Network
2.2. 動的検索構文について
JBoss ON には動的検索に対する独自の検索構文があります。この構文は、幅広い検索可能な項目をカバーし、異なるフレーズを結合させる一方で、比較的シンプルであることを前提としています。
基本的な動的検索は、一般的なサブストリング検索で検索ボックスにテキストを入力するとどれでも一致しています。検索では、より詳細なターゲットの構文を、以下の形式で許可できます。
[search_area].[search_property] operator value operator additional_search
search_area は、検索しているエントリーのタイプ（リソースまたはグループ）を特定します。検索エリアが検索の場所によって暗示されるため、これは任意の値になります。つまり、Resources エリアの検索はリソース検索を意味するため、検索の resource. 一部を含める必要はありません。
図2.3 リソース特性による検索
2.2.1. 基本的な文字列検索
動的検索を使用した最も簡単な検索は、サブ文字列検索です。検索用語は、返されるすべての部分またはすべてに一致できます。
図2.4 契約条件の一致
検索用語には、名前の任意の場所にその文字列があるすべてのリソースと一致する（大文字と小文字を区別しない）提案を agen 検索し、開始時(Agent Plugin Container)、中(RHQ Agent Launcher Script)、または終了(rhq_agent)を指定します。同様に、結果には、リソースエントリーや属性にある場所に関係なく、その文字列を持つすべてのリソースが含まれます。
複数の単語または用語が一緒に使用されると、検索は各単語を暗示的な AND 検索で個別の検索用語として扱います。（これらの複合検索は、より詳細な検索に対応してい 「複合 AND および OR 検索」 ます。） ただし、マルチ文字の検索用語は単一の検索用語として扱われる場合には、動的検索に引用符を付けることができます。
重要
動的検索は、アスタリスク(*)や正規表現などのワイルドカード文字をサポートし ません。
検索構文は、単一(')または二重引用符のいずれかを使用して、空白を含む検索用語を囲みます。（当然ながら、空白のない検索用語には引用符は必要ありません。） 検索キーワードにスペースで区切られた単語がある場合、各単語は AND 検索で別の検索用語として処理されます。例：
postgres table myexampletable
引用符を使用すると、検索では、個別の検索用語ではなくリテラルフレーズとして扱うことができます。他の検索用語と同様に、フレーズは、スペースで区切ったリストで strung にすることができます。
"My Compatible Group" 'test box' plugin=jboss 123.4.5.6 trait[partitionName]='my example group' server.example.com
検索用語に名前に二重引用符または単一引用符が含まれている場合は、他のタイプの境界文字を使用する必要があります。たとえば、このグループ名には単一引用符(apostrophe)が含まれます。
name="Production's Main Group"
必ず、同じ開始文字と終了文字を使用してください（一重引用符と二重引用符を混在させることはできません）。 また、一重引用符は、検索用語の最初にある検索定義文字としてのみ扱われます。クローズ一重引用符は Production's 不要 'Hello world です。
検索は、結果内で発生する文字列を検索することもできます。このため、検索では、値の先頭または末尾に 文字列の有無を設定する境界文字 や、値との完全一致が必要であるかどうかを設定します。
検索キーワードが結果文字列の最初に表示する必要があるキャレット(^)の文字セット。例：
resource.xml:id=^100
つまり、100 で始まる ID を持つリソースのみが検索で返されます。
同様に、文字列は値の最後にのみ発生する可能性があります。終了値の境界文字はドル記号($)です。例：
script$
これにより、スクリプト で終了する値を持つリソースが返されます。
キャレットとドル記号の両方を使用して、一致する結果は、追加の文字なしで検索用語と完全に一致する必要があります。
検索文字は、結果の値に文字列が表示される場所を設定して検索文字列を 表2.1「文字列 Operator」 制限します。
表2.1 文字列 Operator
| operator | description |
|---|---|
| string | 文字列は結果文字列のどこでも発生する可能性があります。 |
| ^string | 指定の文字列は結果値の最初に表示される必要があります。 |
| string$ | 指定の文字列は結果値の最後に指定されている必要があります。 |
| ^string$ | 結果は、先頭または末尾の文字を含まない指定の文字列と完全に一致している必要があります。 |
注記
動的検索構文は、null を検索に許可される値として扱います。null を渡す検索を実行すると、そのプロパティーの null 値を持つリソースまたはグループを検索します。
resource.trait[Database.startTime] = null
ただし、用語の周りに引用符を付けると、文字列 null の値を持つリソースまたはグループが検索 null されます。
name = "null"
2.2.2. プロパティー検索
検索プロパティーを使用すると、エントリーの特定の値または属性タイプを検索すると、検索を絞り込むことができます。たとえば、CPU 使用率が 50%(trait)のリソースが、80（）が含まれる ID を持つエントリーを検索する場合とは異なりidます。利用可能なプロパティーは 表2.2「リソース検索コンテキスト」 およびに一覧表示され 表2.3「グループ検索コンテキスト」 ます。
注記
検索エリアと適切なプロパティーを指定して、リソース検索でグループ基準を使用し、逆引きで検索できます。たとえば、groups エリアで検索を実行して、特定のリソースが属するグループの一覧を返すことができます。これは、検索コンテキストと search プロパティーを明示的に渡して行います。たとえば、Groups ページで Postgres プラグインによって管理されるリソースが含まれるグループを一覧表示するには、以下のコマンドを実行します。
resource.type.plugin = Postgres
重要
パラメーターは connection configuration、JBoss ON GUI で trait 使用される名前ではなくプロパティー 名(connection[property_name])の内部 プロパティー名を使用し、内部プロパティー名を使用します。
表2.2 リソース検索コンテキスト
| property | description |
|---|---|
| resource.id | JBoss ON によって割り当てられるリソース ID 番号。 |
| resource.name | UI に表示されるリソース名。 |
| resource.version | リソースのバージョン番号。 |
| resource.type.plugin | リソースタイプ。リソースの管理に使用するプラグインで定義されます。 |
| resource.type.name | 名前でリソースタイプ。 |
| resource.type.category | リソースタイプカテゴリー（platform、server、または service）。 |
| resource.availability | UP または DOWN のいずれかのリソースの可用性。 |
| resource.pluginConfiguration[property-name] | プラグイン内の可能な設定エントリーの値。 |
| resource.resourceConfiguration[property-name] | リソース内の可能な設定エントリーの値。 |
| resource.trait[property-name] | リソースの測定特性の値。 |
グループにはリソースよりもシンプルなエントリーがあるため、グループの検索プロパティーは若干少なくなります。
表2.3 グループ検索コンテキスト
| property | description |
|---|---|
| group.name | グループの名前。 |
| group.plug-in | 互換性のあるグループの場合、このグループのリソースタイプを定義するプラグイン。 |
| group.type | 互換性のあるグループの場合、このグループのリソースタイプです。 |
| group.category | リソースタイプカテゴリー（platform、server、または service）。 |
| group.kind | 混在または互換性のあるグループのタイプ。 |
| group.availability | UP または DOWN のいずれかのグループでリソースの可用性。 |
演算子 は、最初に検索結果が検索文字列（値）と一致する方法を参照します。これには、検索文字列に指定された値以外の値に完全一致が必要になります。演算子 は、次に複数の検索文字列が相互にどのように関係するか（AND または OR）、明示的な AND ステートメントと OR ステートメントおよび括弧の両方が許可されます。複雑な検索については、で対応してい 「複合 AND および OR 検索」 ます。
表2.4 Search String Operator
| operator | description |
|---|---|
| = | 大文字と小文字を区別しない一致。 |
| == | case-exact match。 |
| != | 大文字と小文字を区別しない負の一致（つまり、値は文字列では ありません ）。 |
| !== | case-exact negative match（つまり、値は文字列では ありません ）。 |
2.2.3. 複合 AND および OR 検索
動的検索バーは、各単語が検索用語であることを前提としています（引用符で囲まれていない限り）。暗黙的に、マルチテキスト検索は AND 検索として処理されます。例：
postgres server myserver
これは一連の AND 用語として扱われます。
postgres AND server AND myserver
動的検索では、パイプ(|)で区切られた OR 検索も可能です。例：
postgres | jbossas
AND 検索と OR 検索の両方を入力できます。また、複数の検索文字列を組み込むことで複雑な検索を作成できます。AND と OR の両方の検索基準がある場合は、AND 用語が最初に処理されます。たとえば、この検索用語は B と C の両方を検索し、次に A または B/C のいずれかを検索します。
a | b c
注記
複雑な検索で使用される AND と OR の用語の両方がある場合は、AND 用語が優先されます。ただし、括弧で囲まれた用語は AND 表現よりも前に評価されるため、括弧を使用して適切な検索設定を上書きすることができます。
検索フレーズは、検索用語をグループ化するために括弧を使用して複数のレベルにネストできます。これらの括弧を使用して、AND マッチの設定を上書きすることもできます。少なくともいくつかの OR 式を最初に処理する必要があります。たとえば、この式は最初に OR 用語を検索し、OR b と c OR d を照合してから、2 つの OR 検索の結果で AND 検索を実行します。
(a | b) (c | d)
結果には、c、a d、b c、および b d などの複数の値の組み合わせが含まれます。
複数のレベルのネストが許可されます。たとえば、この式に は AND OR c AND d が必要です。
(a) (b | (c d))
一致するリソースには、c d または b に一致する 値を含めることができます。
