Skip to content

Commit fb6e7a3

Browse files
authored
SQL: remove beta marker from documentation (#38661)
1 parent de65982 commit fb6e7a3

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

45 files changed

+13
-115
lines changed

docs/reference/sql/appendix/syntax-reserved.asciidoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-syntax-reserved]]
44
== Reserved keywords
55

6-
beta[]
7-
86
Table with reserved keywords that need to be quoted. Also provide an example to make it more obvious.
97

108
The following table lists all of the keywords that are reserved in Presto,

docs/reference/sql/concepts.asciidoc

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-concepts]]
44
== Conventions and Terminology
55

6-
beta[]
7-
86
For clarity, it is important to establish the meaning behind certain words as, the same wording might convey different meanings to different readers depending on one's familiarity with SQL versus {es}.
97

108
NOTE: This documentation while trying to be complete, does assume the reader has _basic_ understanding of {es} and/or SQL. If that is not the case, please continue reading the documentation however take notes and pursue the topics that are unclear either through the main {es} documentation or through the plethora of SQL material available in the open (there are simply too many excellent resources here to enumerate).
@@ -15,8 +13,6 @@ Last but not least, {es-sql} tries to obey the https://en.wikipedia.org/wiki/Pri
1513

1614
=== Mapping concepts across SQL and {es}
1715

18-
beta[]
19-
2016
While SQL and {es} have different terms for the way the data is organized (and different semantics), essentially their purpose is the same.
2117

2218
So let's start from the bottom; these roughly are:

docs/reference/sql/endpoints/cli.asciidoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-cli]]
44
== SQL CLI
55

6-
beta[]
7-
86
Elasticsearch ships with a script to run the SQL CLI in its `bin` directory:
97

108
[source,bash]

docs/reference/sql/endpoints/client-apps/dbeaver.asciidoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-client-apps-dbeaver]]
44
=== DBeaver
55

6-
beta[]
7-
86
[quote, https://dbeaver.io/]
97
____
108
https://dbeaver.io/[DBeaver] DBeaver is free and open source universal database tool for developers and database administrators.

docs/reference/sql/endpoints/client-apps/dbvis.asciidoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-client-apps-dbvis]]
44
=== DbVisualizer
55

6-
beta[]
7-
86
[quote, http://www.dbvis.com/]
97
____
108
https://www.dbvis.com/[DbVisualizer] is a database management and analysis tool for all major databases.

docs/reference/sql/endpoints/client-apps/excel.asciidoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-client-apps-excel]]
44
=== Microsoft Excel
55

6-
experimental[]
7-
86
[quote, https://www.techopedia.com/definition/5430/microsoft-excel]
97
____
108
https://products.office.com/en/excel[Microsoft Excel] is a software program [...] that allows users to organize, format and calculate data

docs/reference/sql/endpoints/client-apps/index.asciidoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-client-apps]]
44
== SQL Client Applications
55

6-
beta[]
7-
86
Thanks to its <<sql-jdbc, JDBC>> and <<sql-odbc, ODBC>> interfaces, a broad range of third-party applications can use {es}'s SQL capabilities.
97
This section lists, in alphabetical order, a number of them and their respective configuration - the list however is by no means comprehensive (feel free to https://www.elastic.co/blog/art-of-pull-request[submit a PR] to improve it):
108
as long as the app can use the {es-sql} driver, it can use {es-sql}.

docs/reference/sql/endpoints/client-apps/microstrat.asciidoc

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-client-apps-microstrat]]
44
=== MicroStrategy Desktop
55

6-
experimental[]
7-
86
[quote, https://www.microstrategy.com/us/resources/library/videos/new-microstrategy-desktop]
97
____
108
https://www.microstrategy.com/us/get-started/desktop[MicroStrategy Desktop] is a free data discovery tool that helps people bring data to
@@ -19,7 +17,7 @@ ____
1917

2018
==== Data loading
2119

22-
To use the {product} to load data into MicroStrategy Desktop perform the following steps in sequence.
20+
To use the {odbc} to load data into MicroStrategy Desktop perform the following steps in sequence.
2321

2422
. Create a New Dossier
2523
+

docs/reference/sql/endpoints/client-apps/powerbi.asciidoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-client-apps-powerbi]]
44
=== Microsoft Power BI Desktop
55

6-
experimental[]
7-
86
[quote, https://powerbi.microsoft.com/en-us/what-is-power-bi/]
97
____
108
https://powerbi.microsoft.com/en-us/desktop/[Power BI] is a business analytics solution that lets you visualize your data and share

docs/reference/sql/endpoints/client-apps/ps1.asciidoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-client-apps-ps1]]
44
=== Microsoft PowerShell
55

6-
experimental[]
7-
86
[quote, https://docs.microsoft.com/en-us/powershell/scripting/powershell-scripting]
97
____
108
https://docs.microsoft.com/en-us/powershell/[PowerShell] is a task-based command-line shell and scripting language built on .NET.

docs/reference/sql/endpoints/client-apps/qlik.asciidoc

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-client-apps-qlik]]
44
=== Qlik Sense Desktop
55

6-
experimental[]
7-
86
[quote, https://help.qlik.com/en-US/sense/February2018/Subsystems/Hub/Content/Introduction/at-a-glance.htm]
97
____
108
https://www.qlik.com/us/try-or-buy/download-qlik-sense[Qlik Sense Desktop] is a Windows application that gives individuals the opportunity
@@ -20,7 +18,7 @@ ____
2018

2119
==== Data loading
2220

23-
To use the {product} to load data into Qlik Sense Desktop perform the following steps in sequence.
21+
To use the {odbc} to load data into Qlik Sense Desktop perform the following steps in sequence.
2422

2523
. Create new app
2624
+

docs/reference/sql/endpoints/client-apps/squirrel.asciidoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-client-apps-squirrel]]
44
=== SQuirreL SQL
55

6-
beta[]
7-
86
[quote, http://squirrel-sql.sourceforge.net/]
97
____
108
http://squirrel-sql.sourceforge.net/[SQuirreL SQL] is a graphical, [multi-platform] Java program that will allow you to view the structure of a JDBC compliant database [...].

docs/reference/sql/endpoints/client-apps/tableau.asciidoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-client-apps-tableau]]
44
=== Tableau Desktop
55

6-
experimental[]
7-
86
[quote, https://www.tableau.com/products/what-is-tableau]
97
____
108
https://www.tableau.com/products/desktop[Tableau] is the most powerful, secure, and flexible end-to-end analytics platform

docs/reference/sql/endpoints/client-apps/workbench.asciidoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-client-apps-workbench]]
44
=== SQL Workbench/J
55

6-
beta[]
7-
86
[quote, https://www.sql-workbench.eu/]
97
____
108
https://www.sql-workbench.eu/[SQL Workbench/J] is a free, DBMS-independent, cross-platform SQL query tool.

docs/reference/sql/endpoints/jdbc.asciidoc

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-jdbc]]
44
== SQL JDBC
55

6-
beta[]
7-
86
{es}'s SQL jdbc driver is a rich, fully featured JDBC driver for {es}.
97
It is Type 4 driver, meaning it is a platform independent, stand-alone, Direct to Database,
108
pure Java driver that converts JDBC calls to {es-sql}.
@@ -136,8 +134,6 @@ Opens up a {es-sql} connection to `server` on port `3456`, setting the JDBC conn
136134

137135
=== API usage
138136

139-
beta[]
140-
141137
One can use JDBC through the official `java.sql` and `javax.sql` packages:
142138

143139
==== `java.sql`

docs/reference/sql/endpoints/odbc.asciidoc

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,4 @@
1-
:es: Elasticsearch
2-
:es-sql: {es} SQL
3-
:version: 6.5.0
4-
:product: {es-sql} ODBC Driver
1+
:odbc: {es-sql} ODBC Driver
52

63
[role="xpack"]
74
[testenv="platinum"]
@@ -12,9 +9,7 @@
129
[float]
1310
=== Overview
1411

15-
experimental[]
16-
17-
{product} is a feature-rich 3.80 ODBC driver for {es}.
12+
{odbc} is a feature-rich 3.80 ODBC driver for {es}.
1813
It is a core level driver, exposing all of the functionality accessible through the {es}'s SQL ODBC API, converting ODBC calls into
1914
{es-sql}.
2015

docs/reference/sql/endpoints/odbc/configuration.asciidoc

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-odbc-setup]]
44
=== Configuration
55

6-
experimental[]
7-
86
Once the driver has been installed, in order for an application to be able to connect to {es} through ODBC, a set of configuration parameters must be provided to the driver. Depending on the application, there are generally three ways of providing these parameters:
97

108
* through a connection string;
@@ -63,7 +61,7 @@ Such a file can be then shared among multiple systems and the user will need to
6361
The configuration steps are similar for all the above points. Following is an example of configuring a System DSN.
6462

6563
[float]
66-
===== 2.1 Launch {product} DSN Editor
64+
===== 2.1 Launch {odbc} DSN Editor
6765
Click on the _System DSN_ tab, then on the _Add..._ button:
6866

6967
[[system_add]]
@@ -76,10 +74,10 @@ A new window will open, listing all available installed drivers. Click on _{es}
7674
.Launch the DSN Editor
7775
image:images/sql/odbc/administrator_launch_editor.png[]
7876

79-
This action closes the previously opened second window and open a new one instead, {product}'s DSN Editor:
77+
This action closes the previously opened second window and open a new one instead, {odbc}'s DSN Editor:
8078

8179
[[dsn_editor]]
82-
.{product} DSN Editor
80+
.{odbc} DSN Editor
8381
image:images/sql/odbc/dsn_editor_basic.png[]
8482

8583
This new window has three tabs, each responsible for a set of configuration parameters, as follows.
@@ -173,7 +171,7 @@ image:images/sql/odbc/dsn_editor_security_cert.png[]
173171

174172
[float]
175173
===== 2.4 Logging parameters
176-
For troubleshooting purposes, the {product} offers functionality to log the API calls that an application makes; this is enabled in the Administrator application:
174+
For troubleshooting purposes, the {odbc} offers functionality to log the API calls that an application makes; this is enabled in the Administrator application:
177175

178176
[[administrator_tracing]]
179177
.Enable Application ODBC API logging
@@ -241,7 +239,7 @@ image:images/sql/odbc/administrator_system_added.png[]
241239
Due to the specification of the ODBC API, the driver will receive the configured DSN parameters - including the logging ones - only once a
242240
connection API is invoked (such as _SQLConnect_ or _SQLDriverConnect_). The _Driver Manager_ will however always make a set of API calls
243241
into the driver before attempting to establish a connection. To capture those calls as well, one needs to pass logging configuration
244-
parameters in an alternative way. The {product} will use an environment variable for this purpose.
242+
parameters in an alternative way. The {odbc} will use an environment variable for this purpose.
245243

246244
Configuring an environment variable is OS specific and not detailed in this guide. Whether the variable should be configured system-wide
247245
or user-specific depends on the way the ODBC-enabled application is being run and if logging should affect the current user only or not.

docs/reference/sql/endpoints/odbc/installation.asciidoc

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,14 +3,12 @@
33
[[sql-odbc-installation]]
44
=== Driver installation
55

6-
experimental[]
7-
8-
The {product} can be installed on Microsoft Windows using an MSI package. The installation process is simple and is composed of standard MSI wizard steps.
6+
The {odbc} can be installed on Microsoft Windows using an MSI package. The installation process is simple and is composed of standard MSI wizard steps.
97

108
[[prerequisites]]
119
==== Installation Prerequisites
1210

13-
Before you install the {product} you need to meet the following prerequisites;
11+
Before you install the {odbc} you need to meet the following prerequisites;
1412

1513
* Windows 10 64 bit _or_ Windows Server 2016 64 bit operating system
1614
* .NET Framework 4.0 full - https://www.microsoft.com/en-au/download/details.aspx?id=17718
@@ -26,7 +24,7 @@ NOTE: It is not possible to inline upgrade using the MSI. In order to upgrade, y
2624
[[download]]
2725
==== Download the `.msi` package(s)
2826

29-
Download the `.msi` package for {product} {version} from:
27+
Download the `.msi` package for {odbc} {version} from:
3028
https://www.elastic.co/downloads/odbc-client
3129

3230
There are two versions of the installer available:

docs/reference/sql/endpoints/rest.asciidoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-rest]]
44
== SQL REST API
55

6-
beta[]
7-
86
The SQL REST API accepts SQL in a JSON document, executes it,
97
and returns the results. For example:
108

docs/reference/sql/endpoints/translate.asciidoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-translate]]
44
== SQL Translate API
55

6-
beta[]
7-
86
The SQL Translate API accepts SQL in a JSON document and translates it
97
into native Elasticsearch queries. For example:
108

docs/reference/sql/functions/aggs.asciidoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-functions-aggs]]
44
=== Aggregate Functions
55

6-
beta[]
7-
86
Functions for computing a _single_ result from a set of input values.
97
{es-sql} supports aggregate functions only alongside <<sql-syntax-group-by,grouping>> (implicit or explicit).
108

docs/reference/sql/functions/conditional.asciidoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-functions-conditional]]
44
=== Conditional Functions
55

6-
beta[]
7-
86
Functions that return one of their arguments by evaluating in an if-else manner.
97

108
[[sql-functions-conditional-coalesce]]

docs/reference/sql/functions/date-time.asciidoc

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-functions-datetime]]
44
=== Date/Time and Interval Functions and Operators
55

6-
beta[]
7-
86
{es-sql} offers a wide range of facilities for performing date/time manipulations.
97

108
[[sql-functions-datetime-interval]]
@@ -91,7 +89,7 @@ include-tagged::{sql-specs}/docs.csv-spec[dtIntervalMul]
9189

9290
==== Functions
9391

94-
beta[]
92+
Functions that target date/time.
9593

9694
[[sql-functions-current-date]]
9795
==== `CURRENT_DATE/CURDATE`

docs/reference/sql/functions/grouping.asciidoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-functions-grouping]]
44
=== Grouping Functions
55

6-
beta[]
7-
86
Functions for creating special __grouping__s (also known as _bucketing_); as such these need to be used
97
as part of the <<sql-syntax-group-by, grouping>>.
108

docs/reference/sql/functions/index.asciidoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-functions]]
44
== Functions and Operators
55

6-
beta[]
7-
86
{es-sql} provides a comprehensive set of built-in operators and functions:
97

108
* <<sql-operators, Operators>>

docs/reference/sql/functions/math.asciidoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-functions-math]]
44
=== Math Functions
55

6-
beta[]
7-
86
All math and trigonometric functions require their input (where applicable)
97
to be numeric.
108

docs/reference/sql/functions/operators.asciidoc

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-operators]]
44
=== Comparison Operators
55

6-
beta[]
7-
86
Boolean operator for comparing against one or multiple expressions.
97

108
* Equality (`=`)
@@ -64,8 +62,6 @@ include-tagged::{sql-specs}/filter.sql-spec[whereWithInAndMultipleValues]
6462
[[sql-operators-logical]]
6563
=== Logical Operators
6664

67-
beta[]
68-
6965
Boolean operator for evaluating one or two expressions.
7066

7167
* `AND`
@@ -92,8 +88,6 @@ include-tagged::{sql-specs}/filter.sql-spec[whereFieldEqualityNot]
9288
[[sql-operators-math]]
9389
=== Math Operators
9490

95-
beta[]
96-
9791
Perform mathematical operations affecting one or two values.
9892
The result is a value of numeric type.
9993

docs/reference/sql/functions/search.asciidoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-functions-search]]
44
=== Full-Text Search Functions
55

6-
beta[]
7-
86
Search functions should be used when performing full-text search, namely
97
when the `MATCH` or `QUERY` predicates are being used.
108
Outside a, so-called, search context, these functions will return default values

docs/reference/sql/functions/string.asciidoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
[[sql-functions-string]]
44
=== String Functions
55

6-
beta[]
7-
86
Functions for performing string manipulation.
97

108
[[sql-functions-string-ascii]]

0 commit comments

Comments
 (0)