Class QueryingClientBase
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
Base class for querying clients.
Inheritance
Implements
Namespace: Stylelabs.M.Sdk.Models.Clients
Assembly: Stylelabs.M.Sdk.dll
Syntax
Constructors
QueryingClientBase(IMClient)
Declaration
Parameters
| Type | Name | Description |
|---|---|---|
| IMClient | client |
Methods
CreateEntityIdIterator(Query)
Creates an IEntityIterator that iterates over all ids matched by the Query.
Declaration
Parameters
| Type | Name | Description |
|---|---|---|
| Query | query |
The query to iterate. |
Returns
| Type | Description |
|---|---|
| IIdIterator |
An iterator. |
CreateEntityIdScroller(Query, Nullable<TimeSpan>)
Creates an IIdScroller that scrolls over all ids of entities that match the Query.
Declaration
Parameters
| Type | Name | Description |
|---|---|---|
| Query | query |
The query to scroll. |
| System.Nullable<TimeSpan> | scrollTime |
The time for the scroll to live. If it is not specified, ScrollTime will be used. The scroll time should not be too long, just enough to process each batch of results. |
Returns
| Type | Description |
|---|---|
| IIdScroller |
An IIdScroller instance. |
Remarks
Use scrolling wisely and try to limit the scrollTime for the scroll to live.
Using scrolling inappropriately can cause performance issues.
See https://www.elastic.co/guide/en/elasticsearch/reference/current/search-request-scroll.html for more information.
CreateEntityIterator(Query, IEntityLoadConfiguration)
Creates an IEntityIterator that iterates over all results matched by the Query.
Declaration
Parameters
| Type | Name | Description |
|---|---|---|
| Query | query |
The query to iterate. |
| IEntityLoadConfiguration | loadConfiguration |
The load configuration. If it is null, then Default will be used. |
Returns
| Type | Description |
|---|---|
| IEntityIterator |
An iterator. |
Remarks
For compatibility with the 3.0 SDK, the loading configuration is resolved as follows:
- The
loadConfigurationwill be used, if not null. - The IQueryLoadConfiguration from the
querywill be used, if not null and if applicable. - Otherwise, defaults to Default.
CreateEntityScroller(Query, Nullable<TimeSpan>, IEntityLoadConfiguration)
Creates an IEntityScroller that scrolls over all entities that match the Query.
Declaration
Parameters
| Type | Name | Description |
|---|---|---|
| Query | query |
The query to scroll. |
| System.Nullable<TimeSpan> | scrollTime |
The time for the scroll to live. If it is not specified, ScrollTime will be used. The scroll time should not be too long, just enough to process each batch of results. |
| IEntityLoadConfiguration | loadConfiguration |
The load configuration. If it is null, then Default will be used. |
Returns
| Type | Description |
|---|---|
| IEntityScroller |
An IEntityScroller instance. |
Remarks
Use scrolling wisely and try to limit the scrollTime for the scroll to live.
Using scrolling inappropriately can cause performance issues.
See https://www.elastic.co/guide/en/elasticsearch/reference/current/search-request-scroll.html for more information.
GetEntityScrollEngine()
Gets the implementation specific scrolling engine for entity retrieval.
Declaration
Returns
| Type | Description |
|---|---|
| IScrollEngine<IEntityScrollResult> |
GetIdScrollEngine()
Gets the implementation specific scrolling engine for id retrieval.
Declaration
Returns
| Type | Description |
|---|---|
| IScrollEngine<IIdScrollResult> |
QueryAsync(Query, IEntityLoadConfiguration)
Retrieves entities matching the query.
Declaration
Parameters
| Type | Name | Description |
|---|---|---|
| Query | query |
The query to execute. |
| IEntityLoadConfiguration | loadConfiguration |
The load configuration. If it is null, then Default will be used. |
Returns
| Type | Description |
|---|---|
| Task<IEntityQueryResult> |
An IEntityQueryResult containing the results of the query. |
Remarks
For compatibility with the 3.0 SDK, the loading configuration is resolved as follows:
- The
loadConfigurationwill be used, if not null. - The IQueryLoadConfiguration from the
querywill be used, if not null and if applicable. - Otherwise, defaults to Default.
QueryIdsAsync(Query)
Retrieves the ids of entities matching the query.
Declaration
Parameters
| Type | Name | Description |
|---|---|---|
| Query | query |
The query to execute. |
Returns
| Type | Description |
|---|---|
| Task<IIdQueryResult> |
An IEntityQueryResult containing the results of the query. |
ResolveLoadConfiguration(Query, IEntityLoadConfiguration)
Declaration
Parameters
| Type | Name | Description |
|---|---|---|
| Query | query | |
| IEntityLoadConfiguration | loadConfiguration |
Returns
| Type | Description |
|---|---|
| IQueryLoadConfiguration |
SingleAsync(Query, IEntityLoadConfiguration)
Gets a single entity that matches the query.
Declaration
Parameters
| Type | Name | Description |
|---|---|---|
| Query | query |
The query to execute. |
| IEntityLoadConfiguration | loadConfiguration |
The load configuration. If it is null, then Default will be used. |
Returns
| Type | Description |
|---|---|
| Task<IEntity> |
The entity that matches the query or null if there are no results. |
Remarks
For compatibility with the 3.0 SDK, the loading configuration is resolved as follows:
- The
loadConfigurationwill be used, if not null. - The IQueryLoadConfiguration from the
querywill be used, if not null and if applicable. - Otherwise, defaults to Default.
SingleIdAsync(Query)
Gets a the id of the entity that matches the query.
Declaration
Parameters
| Type | Name | Description |
|---|---|---|
| Query | query |
The query to execute |
Returns
| Type | Description |
|---|---|
| Task<System.Nullable<System.Int64>> |
The id of the entity that matches the query or null if there are no results. |