You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Mar 31, 2021. It is now read-only.
By default, the `odfesql` command connects to http://localhost:9200.
58
+
By default, the `odfesql` command connects to [http://localhost:9200](http://localhost:9200/).
59
+
52
60
53
61
54
62
## Configure
@@ -57,65 +65,72 @@ When you first launch the SQL CLI, a configuration file is automatically created
57
65
58
66
You can also configure the following connection properties:
59
67
60
-
- `endpoint`: You do not need to specify an option, anything that follows the launch command `odfesql` is considered as the endpoint. If you do not provide an endpoint, by default, the SQL CLI connects to http://localhost:9200.
61
-
- `-u/-w`: Supports username and password for HTTP basic authentication, such as:
62
-
- Elasticsearch with X-pack security enabled
63
-
- Elasticsearch OSS with [Open Distro Security Plugin](https://opendistro.github.io/for-elasticsearch-docs/docs/install/plugins/) installed
64
-
- Amazon Elasticsearch domain with [Fine Grained Access Control](https://docs.aws.amazon.com/elasticsearch-service/latest/developerguide/fgac.html) enabled
65
-
- `--aws-auth`: Turns on AWS sigV4 authentication to connect to an Amazon Elasticsearch endpoint. Use with the AWS CLI (`aws configure`) to retrieve the local AWS configuration to authenticate and connect.
68
+
69
+
* `endpoint`: You do not need to specify an option, anything that follows the launch command `odfesql` is considered as the endpoint. If you do not provide an endpoint, by default, the SQL CLI connects to [http://localhost:9200](http://localhost:9200/).
70
+
* `-u/-w`: Supports username and password for HTTP basic authentication, such as:
71
+
* Elasticsearch OSS with [Open Distro for Elasticsearch Security Plugin](https://opendistro.github.io/for-elasticsearch-docs/docs/install/plugins/) installed
72
+
* Amazon Elasticsearch Service domain with [Fine Grained Access Control](https://docs.aws.amazon.com/elasticsearch-service/latest/developerguide/fgac.html) enabled
73
+
* Elasticsearch with X-pack security enabled
74
+
* `--aws-auth`: Turns on AWS sigV4 authentication to connect to an Amazon Elasticsearch Service endpoint. Use with the AWS CLI (`aws configure`) to retrieve the local AWS configuration to authenticate and connect.
66
75
67
76
For a list of all available configurations, see [clirc](https://github.com/opendistro-for-elasticsearch/sql-cli/blob/master/src/conf/clirc).
68
77
69
78
79
+
70
80
## Using the CLI
71
81
72
82
1. Save the sample [accounts test data](https://github.com/opendistro-for-elasticsearch/sql/blob/master/src/test/resources/doctest/testdata/accounts.json) file.
By default, you see a maximum output of 200 rows. To show more results, add a `LIMIT` clause with the desired value.
84
97
85
-
The CLI supports all types of query that ODFE SQL supports. Refer to [ODFE SQL basic usage](https://github.com/opendistro-for-elasticsearch/sql#basic-usage)
98
+
The CLI supports all types of query that ODFE SQL supports. Refer to [ODFE SQL basic usage documentation.](https://github.com/opendistro-for-elasticsearch/sql#basic-usage)
99
+
86
100
87
101
## Query options
88
102
89
103
Run single query from command line with options
90
104
91
-
- `--help`: help page for options
92
-
- `-q`: follow by a single query
93
-
- `-f`: support *jdbc/raw* format output
94
-
- `-v`: display data vertically
95
-
- `-e`: translate sql to DSL
105
+
106
+
* `--help`: help page for options
107
+
* `-q`: follow by a single query
108
+
* `-f`: support *jdbc/raw* format output
109
+
* `-v`: display data vertically
110
+
* `-e`: translate sql to DSL
96
111
97
112
## CLI Options
98
-
- `-p`: always use pager to display output
99
-
- `--clirc`: provide path of config file to load
100
113
114
+
* `-p`: always use pager to display output
115
+
* `--clirc`: provide path of config file to load
101
116
102
117
## Code of Conduct
103
118
104
119
This project has adopted an [Open Source Code of Conduct](https://opendistro.github.io/for-elasticsearch/codeofconduct.html).
105
120
106
121
107
-
## Security issue notifications
108
122
109
-
If you discover a potential security issue in this project we ask that you notify AWS/Amazon Security
110
-
via our [vulnerability reporting page](http://aws.amazon.com/security/vulnerability-reporting/).
111
-
Please do **not** create a public GitHub issue.
123
+
## Security issue notifications
112
124
125
+
If you discover a potential security issue in this project we ask that you notify AWS/Amazon Security via our [vulnerability reporting page](http://aws.amazon.com/security/vulnerability-reporting/). Please do **not** create a public GitHub issue for security bugs you report.
113
126
114
127
## Licensing
115
128
116
-
See the [LICENSE](./LICENSE.TXT) file for our project's licensing. We will ask you to confirm the licensing of your contribution.
129
+
See the [LICENSE](https://github.com/opendistro-for-elasticsearch/sql-cli/blob/master/LICENSE.TXT) file for our project's licensing. We will ask you to confirm the licensing of your contribution.
130
+
117
131
118
132
119
133
## Copyright
120
134
121
135
Copyright 2020 Amazon.com, Inc. or its affiliates. All Rights Reserved.
1. Register an account on [PyPI](https://pypi.org/), note that these are two separate servers and the credentials from the test server are not shared with the main server.
55
55
2. Use `twine upload dist/*` to upload your package and enter your credentials for the account you registered on PyPI.You don’t need to specify --repository; the package will upload to https://pypi.org/ by default.
0 commit comments