Adds Dev Tools Console documentation (#1576)
* Adds Dev Tools Console documentation Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Images for console Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Separate directory for dev tools images Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Update _dashboards/run-queries.md Co-authored-by: Alice Williams <88908598+alicejw-aws@users.noreply.github.com> * Update _dashboards/run-queries.md Co-authored-by: Alice Williams <88908598+alicejw-aws@users.noreply.github.com> * Implemented doc review feedback Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Formatting dev tools Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Update _dashboards/run-queries.md Co-authored-by: Nate Bower <nbower@amazon.com> * Update _dashboards/run-queries.md Co-authored-by: Nate Bower <nbower@amazon.com> * Update _dashboards/run-queries.md Co-authored-by: Nate Bower <nbower@amazon.com> * Update _dashboards/run-queries.md Co-authored-by: Nate Bower <nbower@amazon.com> * Update run-queries.md Incorporated editorial comments. Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> Co-authored-by: Alice Williams <88908598+alicejw-aws@users.noreply.github.com> Co-authored-by: Nate Bower <nbower@amazon.com>
|
@ -0,0 +1,115 @@
|
|||
---
|
||||
layout: default
|
||||
title: Running queries in the console
|
||||
nav_order: 110
|
||||
---
|
||||
|
||||
# Running queries in the console
|
||||
|
||||
You can use the OpenSearch Dev Tools Console to send queries to OpenSearch.
|
||||
|
||||
## Navigating to the console
|
||||
|
||||
To open the console, select **Dev Tools** on the main OpenSearch Dashboards page:
|
||||
|
||||
<img src="{{site.url}}{{site.baseurl}}/images/dev-tools/dev-tools-main.png" alt="Dev Tools Console from main page">{: .img-fluid }
|
||||
|
||||
You can open the console from any other page by navigating to the main menu and selecting **Management** > **Dev Tools**.
|
||||
|
||||
<img src="{{site.url}}{{site.baseurl}}/images/dev-tools/dev-tools-left.png" width=200 alt="Dev Tools Console from all pages">
|
||||
|
||||
## Writing queries
|
||||
|
||||
Write your queries in the editor pane on the left side of the console:
|
||||
|
||||
<img src="{{site.url}}{{site.baseurl}}/images/dev-tools/dev-tools-request.png" alt="Request pane">{: .img-fluid }
|
||||
|
||||
You can collapse and expand parts of your query by selecting the small triangles next to the line numbers.
|
||||
{: .tip}
|
||||
|
||||
To learn more about writing queries in OpenSearch domain-specific language (DSL), see [Query DSL]({{site.url}}{{site.baseurl}}/opensearch/query-dsl).
|
||||
|
||||
### Comments
|
||||
|
||||
Use `#` at the beginning of a line to write single-line comments.
|
||||
|
||||
### Autocomplete
|
||||
|
||||
OpenSearch provides autocomplete suggestions for fields, indexes and their aliases, and templates. To configure autocomplete preferences, update them in [Console Settings](#updating-console-settings).
|
||||
|
||||
## Sending the request
|
||||
|
||||
To send a query to OpenSearch, select the query by placing the cursor anywhere in the query text. Then choose the triangle on the top right of the request or press `Ctrl/Cmd+Enter`:
|
||||
|
||||
<img src="{{site.url}}{{site.baseurl}}/images/dev-tools/dev-tools-send.png" alt="Send request">
|
||||
|
||||
OpenSearch displays the response in the response pane on the right side of the console:
|
||||
|
||||
<img src="{{site.url}}{{site.baseurl}}/images/dev-tools/dev-tools-response.png" alt="Response pane">{: .img-fluid }
|
||||
|
||||
## Working in the cURL and console formats
|
||||
|
||||
The console uses an easier syntax to format REST requests than the `curl` command.
|
||||
|
||||
For example, the following `curl` command runs a search query:
|
||||
|
||||
```bash
|
||||
curl -XGET http://localhost:9200/shakespeare/_search?pretty -H 'Content-Type: application/json' -d'
|
||||
{
|
||||
"query": {
|
||||
"match": {
|
||||
"text_entry": "To be, or not to be"
|
||||
}
|
||||
}
|
||||
}'
|
||||
```
|
||||
|
||||
The same query has a simpler syntax in the console format:
|
||||
|
||||
```json
|
||||
GET shakespeare/_search
|
||||
{
|
||||
"query": {
|
||||
"match": {
|
||||
"text_entry": "To be, or not to be"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
If you paste a `curl` command directly into the console, the command is automatically converted into the format the console uses.
|
||||
|
||||
To import a query in cURL format, select the query, then select the wrench icon and choose **Copy as cURL**:
|
||||
|
||||
<img src="{{site.url}}{{site.baseurl}}/images/dev-tools/dev-tools-tools.png" alt="Console tools">
|
||||
|
||||
## Viewing documentation
|
||||
|
||||
To view the OpenSearch documentation, select the wrench icon, and choose **Open documentation**.
|
||||
|
||||
## Auto indenting
|
||||
|
||||
To use auto indent, select the queries that you want to format, select the wrench icon, and choose **Auto indent**.
|
||||
|
||||
Auto indenting a collapsed query expands it.
|
||||
|
||||
Auto indenting a well-formatted query puts the request body on a single line. This is useful for working with [bulk APIs]({{site.url}}{{site.baseurl}}/opensearch/rest-api/document-apis/bulk/).
|
||||
{: .tip}
|
||||
|
||||
## Viewing your request history
|
||||
|
||||
You can view up to the 500 most recent requests that OpenSearch ran successfully. To view request history, select **History** from the top menu. If you select the request you want to view from the left pane, the query is shown in the right pane.
|
||||
|
||||
To copy the query into the editor pane, select the query text and then select **Apply**.
|
||||
|
||||
To clear the history, select **Clear**.
|
||||
|
||||
## Updating the console settings
|
||||
|
||||
To update your preferences, select **Settings** from the top menu:
|
||||
|
||||
<img src="{{site.url}}{{site.baseurl}}/images/dev-tools/dev-tools-settings.png" width=400 alt="Settings">
|
||||
|
||||
## Using keyboard shortcuts
|
||||
|
||||
To view all available keyboard shortcuts, select **Help** from the top menu.
|
After Width: | Height: | Size: 36 KiB |
After Width: | Height: | Size: 31 KiB |
After Width: | Height: | Size: 22 KiB |
After Width: | Height: | Size: 45 KiB |
After Width: | Height: | Size: 15 KiB |
After Width: | Height: | Size: 33 KiB |
After Width: | Height: | Size: 20 KiB |