Skip to content

Commit

Permalink
Remove lang codes from URLs
Browse files Browse the repository at this point in the history
  • Loading branch information
blvckcoffee committed Mar 14, 2023
1 parent b6640e9 commit a4de074
Show file tree
Hide file tree
Showing 17 changed files with 94 additions and 95 deletions.
2 changes: 1 addition & 1 deletion docs/src/main/sphinx/admin/spill.rst
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ is running and writing logs. Doing so may lead to cluster instability. Additiona
it is recommended to monitor the disk saturation of the configured spill paths.

Trino treats spill paths as independent disks (see `JBOD
<https://en.wikipedia.org/wiki/Non-RAID_drive_architectures#JBOD>`_), so
<https://wikipedia.org/wiki/Non-RAID_drive_architectures#JBOD>`_), so
there is no need to use RAID for spill.

Spill compression
Expand Down
2 changes: 1 addition & 1 deletion docs/src/main/sphinx/client/cli.rst
Original file line number Diff line number Diff line change
Expand Up @@ -199,7 +199,7 @@ mode:
:doc:`/admin/resource-groups`.
* - ``--timezone``
- Sets the time zone for the session using the `time zone name
<https://en.wikipedia.org/wiki/List_of_tz_database_time_zones>`_. Defaults
<https://wikipedia.org/wiki/List_of_tz_database_time_zones>`_. Defaults
to the timezone set on your workstation.
* - ``--user``
- Sets the username for :ref:`cli-username-password-auth`. Defaults to your
Expand Down
2 changes: 1 addition & 1 deletion docs/src/main/sphinx/client/jdbc.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
JDBC driver
===========

The Trino `JDBC driver <https://en.wikipedia.org/wiki/JDBC_driver>`_ allows
The Trino `JDBC driver <https://wikipedia.org/wiki/JDBC_driver>`_ allows
users to access Trino using Java-based applications, and other non-Java
applications running in a JVM. Both desktop and server-side applications, such
as those used for reporting and database development, use the JDBC driver.
Expand Down
2 changes: 1 addition & 1 deletion docs/src/main/sphinx/connector/bigquery.rst
Original file line number Diff line number Diff line change
Expand Up @@ -220,7 +220,7 @@ to the following table:
- Time zone is UTC
* - ``GEOGRAPHY``
- ``VARCHAR``
- In `Well-known text (WKT) <https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry>`_ format
- In `Well-known text (WKT) <https://wikipedia.org/wiki/Well-known_text_representation_of_geometry>`_ format
* - ``ARRAY``
- ``ARRAY``
-
Expand Down
2 changes: 1 addition & 1 deletion docs/src/main/sphinx/connector/hive-azure.rst
Original file line number Diff line number Diff line change
Expand Up @@ -78,7 +78,7 @@ catalog configuration.
secret for your ADLS Gen1 account's App Registration, and save this value
because you won't able to retrieve the key later. Refer to the Azure
`documentation
<https://docs.microsoft.com/en-us/azure/data-lake-store/data-lake-store-service-to-service-authenticate-using-active-directory>`_
<https://docs.microsoft.com/azure/data-lake-store/data-lake-store-service-to-service-authenticate-using-active-directory>`_
for details.

.. list-table:: ADLS properties
Expand Down
12 changes: 6 additions & 6 deletions docs/src/main/sphinx/connector/sqlserver.rst
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ appropriate for your setup:
The ``connection-url`` defines the connection information and parameters to pass
to the SQL Server JDBC driver. The supported parameters for the URL are
available in the `SQL Server JDBC driver documentation
<https://docs.microsoft.com/en-us/sql/connect/jdbc/building-the-connection-url>`_.
<https://docs.microsoft.com/sql/connect/jdbc/building-the-connection-url>`_.

The ``connection-user`` and ``connection-password`` are typically required and
determine the user credentials for the connection, often a service user. You can
Expand All @@ -67,7 +67,7 @@ encryption in the connection string with the ``encrypt`` property:
Further parameters like ``trustServerCertificate``, ``hostNameInCertificate``,
``trustStore``, and ``trustStorePassword`` are details in the `TLS section of
SQL Server JDBC driver documentation
<https://docs.microsoft.com/en-us/sql/connect/jdbc/using-ssl-encryption>`_.
<https://docs.microsoft.com/sql/connect/jdbc/using-ssl-encryption>`_.

.. include:: jdbc-authentication.fragment

Expand Down Expand Up @@ -281,7 +281,7 @@ The connector maps Trino types to the corresponding SQL Server types following t
- ``0 <= n <= 7``

Complete list of `SQL Server data types
<https://msdn.microsoft.com/en-us/library/ms187752.aspx>`_.
<https://msdn.microsoft.com/library/ms187752.aspx>`_.

.. _sqlserver-numeric-mapping:

Expand Down Expand Up @@ -444,12 +444,12 @@ Bulk insert
^^^^^^^^^^^

You can optionally use the `bulk copy API
<https://docs.microsoft.com/en-us/sql/connect/jdbc/use-bulk-copy-api-batch-insert-operation>`_
<https://docs.microsoft.com/sql/connect/jdbc/use-bulk-copy-api-batch-insert-operation>`_
to drastically speed up write operations.

Enable bulk copying and a lock on the destination table to meet `minimal
logging requirements
<https://docs.microsoft.com/en-us/sql/relational-databases/import-export/prerequisites-for-minimal-logging-in-bulk-import>`_.
<https://docs.microsoft.com/sql/relational-databases/import-export/prerequisites-for-minimal-logging-in-bulk-import>`_.

The following table shows the relevant catalog configuration properties and
their default values:
Expand Down Expand Up @@ -481,7 +481,7 @@ Data compression
----------------

You can specify the `data compression policy for SQL Server tables
<https://docs.microsoft.com/en-us/sql/relational-databases/data-compression/data-compression>`_
<https://docs.microsoft.com/sql/relational-databases/data-compression/data-compression>`_
with the ``data_compression`` table property. Valid policies are ``NONE``, ``ROW`` or ``PAGE``.

Example::
Expand Down
2 changes: 1 addition & 1 deletion docs/src/main/sphinx/functions/binary.rst
Original file line number Diff line number Diff line change
Expand Up @@ -180,7 +180,7 @@ Hashing functions

.. function:: murmur3(binary) -> varbinary

Computes the 128-bit `MurmurHash3 <https://en.wikipedia.org/wiki/MurmurHash>`_
Computes the 128-bit `MurmurHash3 <https://wikipedia.org/wiki/MurmurHash>`_
hash of ``binary``.

SELECT murmur3(from_base64('aaaaaa'));
Expand Down
2 changes: 1 addition & 1 deletion docs/src/main/sphinx/functions/datetime.rst
Original file line number Diff line number Diff line change
Expand Up @@ -527,7 +527,7 @@ Convenience extraction functions
Returns the `ISO week`_ of the year from ``x``.
The value ranges from ``1`` to ``53``.

.. _ISO week: https://en.wikipedia.org/wiki/ISO_week_date
.. _ISO week: https://wikipedia.org/wiki/ISO_week_date

.. function:: week_of_year(x) -> bigint

Expand Down
2 changes: 1 addition & 1 deletion docs/src/main/sphinx/functions/geospatial.rst
Original file line number Diff line number Diff line change
Expand Up @@ -439,7 +439,7 @@ Bing tiles
----------

These functions convert between geometries and
`Bing tiles <https://msdn.microsoft.com/en-us/library/bb259689.aspx>`_.
`Bing tiles <https://msdn.microsoft.com/library/bb259689.aspx>`_.

.. function:: bing_tile(x, y, zoom_level) -> BingTile

Expand Down
2 changes: 1 addition & 1 deletion docs/src/main/sphinx/functions/hyperloglog.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ HyperLogLog functions
=====================

Trino implements the :func:`approx_distinct` function using the
`HyperLogLog <https://en.wikipedia.org/wiki/HyperLogLog>`_ data structure.
`HyperLogLog <https://wikipedia.org/wiki/HyperLogLog>`_ data structure.

Data structures
---------------
Expand Down
14 changes: 7 additions & 7 deletions docs/src/main/sphinx/functions/setdigest.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,10 @@ Set Digest functions
====================

Trino offers several functions that deal with the
`MinHash <https://en.wikipedia.org/wiki/MinHash>`_ technique.
`MinHash <https://wikipedia.org/wiki/MinHash>`_ technique.

MinHash is used to quickly estimate the
`Jaccard similarity coefficient <https://en.wikipedia.org/wiki/Jaccard_index>`_
`Jaccard similarity coefficient <https://wikipedia.org/wiki/Jaccard_index>`_
between two sets.

It is commonly used in data mining to detect near-duplicate web pages at scale.
Expand All @@ -16,7 +16,7 @@ within the search results two pages that are nearly identical.
The following example showcases how the Set Digest functions can be
used to naively estimate the similarity between texts. The input texts
are split by using the function :func:`ngrams` to
`4-shingles <https://en.wikipedia.org/wiki/W-shingling>`_ which are
`4-shingles <https://wikipedia.org/wiki/W-shingling>`_ which are
used as input for creating a set digest of each initial text.
The set digests are compared to each other to get an
approximation of the similarity of their corresponding
Expand Down Expand Up @@ -85,8 +85,8 @@ Data structures

Trino implements Set Digest data sketches by encapsulating the following components:

- `HyperLogLog <https://en.wikipedia.org/wiki/HyperLogLog>`_
- `MinHash with a single hash function <http://en.wikipedia.org/wiki/MinHash#Variant_with_a_single_hash_function>`_
- `HyperLogLog <https://wikipedia.org/wiki/HyperLogLog>`_
- `MinHash with a single hash function <http://wikipedia.org/wiki/MinHash#Variant_with_a_single_hash_function>`_

The HyperLogLog structure is used for the approximation of the distinct elements
in the original set.
Expand Down Expand Up @@ -152,7 +152,7 @@ Functions

.. function:: jaccard_index(x, y) -> double

Returns the estimation of `Jaccard index <https://en.wikipedia.org/wiki/Jaccard_index>`_ for
Returns the estimation of `Jaccard index <https://wikipedia.org/wiki/Jaccard_index>`_ for
the two set digests.

``x`` and ``y`` must be of type ``setdigest``.
Expand All @@ -165,7 +165,7 @@ Functions

.. function:: hash_counts(x) -> map(bigint, smallint)

Returns a map containing the `Murmur3Hash128 <https://en.wikipedia.org/wiki/MurmurHash#MurmurHash3>`_
Returns a map containing the `Murmur3Hash128 <https://wikipedia.org/wiki/MurmurHash#MurmurHash3>`_
hashed values and the count of their occurences within
the internal ``MinHash`` structure belonging to ``x``.

Expand Down
2 changes: 1 addition & 1 deletion docs/src/main/sphinx/functions/string.rst
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@ String functions
.. function:: luhn_check(string) -> boolean

Tests whether a ``string`` of digits is valid according to the
`Luhn algorithm <https://en.wikipedia.org/wiki/Luhn_algorithm>`_.
`Luhn algorithm <https://wikipedia.org/wiki/Luhn_algorithm>`_.

This checksum function, also known as ``modulo 10`` or ``mod 10``, is
widely applied on credit card numbers and government identification numbers
Expand Down
127 changes: 63 additions & 64 deletions docs/src/main/sphinx/glossary.rst
Original file line number Diff line number Diff line change
Expand Up @@ -23,10 +23,10 @@ Certificate Authority (CA)

Certificate
A public key `certificate
<https://en.wikipedia.org/wiki/Public_key_certificate>`_ issued by a
:ref:`CA <glossCA>`, sometimes abbreviated as cert, that verifies the
ownership of a server's private keys. Certificate format is specified in the
`X.509 <https://en.wikipedia.org/wiki/X.509>`_ standard.
<https://wikipedia.org/wiki/Public_key_certificate>`_ issued by a :ref:`CA
<glossCA>`, sometimes abbreviated as cert, that verifies the ownership of a
server's private keys. Certificate format is specified in the `X.509
<https://wikipedia.org/wiki/X.509>`_ standard.

Cluster
A Trino cluster provides the resources to run queries against numerous data
Expand Down Expand Up @@ -54,47 +54,47 @@ Container
.. _glossDataVirtualization:

Data virtualization
`Data virtualization <https://en.wikipedia.org/wiki/Data_virtualization>`_
is a method of abstracting an interaction with multiple
:ref:`heterogeneous data sources <glossDataSource>`, without needing to know
the distributed nature of the data, its format, or any other technical
details involved in presenting the data.
`Data virtualization <https://wikipedia.org/wiki/Data_virtualization>`_ is a
method of abstracting an interaction with multiple :ref:`heterogeneous data
sources <glossDataSource>`, without needing to know the distributed nature
of the data, its format, or any other technical details involved in
presenting the data.

.. _glossDataSource:

Data source
A system from which data is retrieved, for example, PostgreSQL or Iceberg on S3
data. In Trino, users query data sources with :ref:`catalogs <glossCatalog>`
that connect to each source. See :ref:`trino-concept-data-sources` for more
information.
A system from which data is retrieved, for example, PostgreSQL or Iceberg on
S3 data. In Trino, users query data sources with :ref:`catalogs
<glossCatalog>` that connect to each source. See
:ref:`trino-concept-data-sources` for more information.

.. _glossGzip:

gzip
`gzip <https://en.wikipedia.org/wiki/Gzip>`_ is a compression format and
`gzip <https://wikipedia.org/wiki/Gzip>`_ is a compression format and
software that compresses and decompresses files. This format is used several
ways in Trino, including deployment and compressing files in
:ref:`object storage <glossObjectStorage>`. The most common extension for
gzip-compressed files is ``.gz``.
ways in Trino, including deployment and compressing files in :ref:`object
storage <glossObjectStorage>`. The most common extension for gzip-compressed
files is ``.gz``.

.. _glossHDFS:

HDFS
`Hadoop Distributed Filesystem (HDFS) <https://en.wikipedia.org/wiki/Apache_Hadoop#HDFS>`_
is a scalable :ref:`open source <glossOpenSource>` filesystem that was one
of the earliest distributed big data systems created to store large amounts
of data for the
`Hadoop ecosystem <https://en.wikipedia.org/wiki/Apache_Hadoop>`_.
`Hadoop Distributed Filesystem (HDFS)
<https://wikipedia.org/wiki/Apache_Hadoop#HDFS>`_ is a scalable :ref:`open
source <glossOpenSource>` filesystem that was one of the earliest
distributed big data systems created to store large amounts of data for the
`Hadoop ecosystem <https://wikipedia.org/wiki/Apache_Hadoop>`_.

.. _glossJKS:

Java KeyStore (JKS)
The system of public key cryptography supported as one part of the Java
security APIs. The legacy JKS system recognizes keys and
:ref:`certificates <glossCert>` stored in *keystore* files, typically with
the ``.jks`` extension, and by default relies on a system-level list of
:ref:`CAs <glossCA>` in *truststore* files installed as part of the current
Java installation.
security APIs. The legacy JKS system recognizes keys and :ref:`certificates
<glossCert>` stored in *keystore* files, typically with the ``.jks``
extension, and by default relies on a system-level list of :ref:`CAs
<glossCA>` in *truststore* files installed as part of the current Java
installation.

Key
A cryptographic key specified as a pair of public and private strings
Expand All @@ -112,39 +112,37 @@ Load Balancer (LB)
.. _glossObjectStorage:

Object Storage
`Object storage <https://en.wikipedia.org/wiki/Object_storage>`_ is a file
storage mechanism that stores data in a flat namespace, as opposed
to hierarchical filesystems. Files written in object storage are immutable,
`Object storage <https://wikipedia.org/wiki/Object_storage>`_ is a file
storage mechanism that stores data in a flat namespace, as opposed to
hierarchical filesystems. Files written in object storage are immutable,
meaning you cannot update a file but just overwrite or replace the entire
file. In the context of Trino, object storage commonly refers to
`cloud storage <https://en.wikipedia.org/wiki/Object_storage#Cloud_storage>`_
technologies such as `Amazon S3 <https://aws.amazon.com/s3>`_,
`Google Cloud Storage <https://cloud.google.com/storage>`_, and
`Azure Blob Storage <https://azure.microsoft.com/en-us/products/storage/blobs>`_.
In addition to cloud-hosted services, there are also local object storage
options such as `MinIO <https://min.io/>`_ and
`Ceph <https://docs.ceph.com>`_ that are compatible with S3. Object storage
became a popular replacement to :ref:`HDFS <glossHDFS>`.
file. In the context of Trino, object storage commonly refers to `cloud
storage <https://wikipedia.org/wiki/Object_storage#Cloud_storage>`_
technologies such as `Amazon S3 <https://aws.amazon.com/s3>`_, `Google Cloud
Storage <https://cloud.google.com/storage>`_, and `Azure Blob Storage
<https://azure.microsoft.com/products/storage/blobs>`_. In addition to
cloud-hosted services, there are also local object storage options such as
`MinIO <https://min.io/>`_ and `Ceph <https://docs.ceph.com>`_ that are
compatible with S3. Object storage became a popular replacement to
:ref:`HDFS <glossHDFS>`.

.. _glossOpenSource:

Open-source
Typically refers to
`open-source software <https://en.wikipedia.org/wiki/Open-source_software>`_.
which is software that has the source code made available for others to see,
use, and contribute to. Allowed usage varies depending on the license that
the software is licensed under. Trino is licensed under the
`Apache license <https://en.wikipedia.org/wiki/Apache_License>`_, and is
therefore maintained by a community of contributors from all across the
globe.
Typically refers to `open-source software
<https://wikipedia.org/wiki/Open-source_software>`_. which is software that
has the source code made available for others to see, use, and contribute
to. Allowed usage varies depending on the license that the software is
licensed under. Trino is licensed under the `Apache license
<https://wikipedia.org/wiki/Apache_License>`_, and is therefore maintained
by a community of contributors from all across the globe.

.. _glossPlugin:

Plugin
A bundle of code implementing the Trino
:doc:`Service Provider Interface (SPI) </develop/spi-overview>` that is used
to add new :ref:`connectors <glossConnector>`,
:doc:`data types </develop/types>`, :doc:`functions`,
A bundle of code implementing the Trino :doc:`Service Provider Interface
(SPI) </develop/spi-overview>` that is used to add new :ref:`connectors
<glossConnector>`, :doc:`data types </develop/types>`, :doc:`functions`,
:doc:`access control implementations </develop/system-access-control>`, and
other features of Trino.

Expand All @@ -160,13 +158,14 @@ PEM file format

PKCS #12
A binary archive used to store keys and certificates or certificate chains
that validate a key. `PKCS #12 <https://en.wikipedia.org/wiki/PKCS_12>`_
files have ``.p12`` or ``.pfx`` extensions. This format is a less popular
that validate a key. `PKCS #12 <https://wikipedia.org/wiki/PKCS_12>`_ files
have ``.p12`` or ``.pfx`` extensions. This format is a less popular
alternative to :ref:`PEM <glossPEM>`.

Presto and PrestoSQL
The old name for Trino. To learn more about the name change to Trino, read
`the history <https://en.wikipedia.org/wiki/Trino_(SQL_query_engine)#History>`_.
`the history
<https://wikipedia.org/wiki/Trino_(SQL_query_engine)#History>`_.

Query Federation
A type of :ref:`data virtualization <glossDataVirtualization>` that provides a
Expand All @@ -187,17 +186,17 @@ Structured Query Language (SQL)
see :doc:`SQL </language>`.

Tarball
A common abbreviation for
`TAR file <https://en.wikipedia.org/wiki/Tar_(computing)>`_, which is a
common software distribution mechanism. This file format is a collection of
multiple files distributed as a single file, commonly compressed using
:ref:`gzip <glossGzip>` compression.
A common abbreviation for `TAR file
<https://wikipedia.org/wiki/Tar_(computing)>`_, which is a common software
distribution mechanism. This file format is a collection of multiple files
distributed as a single file, commonly compressed using :ref:`gzip
<glossGzip>` compression.

.. _glossTLS:

Transport Layer Security (TLS)
`TLS <https://en.wikipedia.org/wiki/Transport_Layer_Security>`_ is a
security protocol designed to provide secure communications over a network.
It is the successor to :ref:`SSL <glossSSL>`, and used in many applications
like HTTPS, email, and Trino. These security topics use the term TLS to
refer to both TLS and SSL.
`TLS <https://wikipedia.org/wiki/Transport_Layer_Security>`_ is a security
protocol designed to provide secure communications over a network. It is the
successor to :ref:`SSL <glossSSL>`, and used in many applications like
HTTPS, email, and Trino. These security topics use the term TLS to refer to
both TLS and SSL.
2 changes: 1 addition & 1 deletion docs/src/main/sphinx/installation/kubernetes.rst
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ using tools like `kind <https://kind.sigs.k8s.io>`_, to running on a managed
Kubernetes service on cloud services like
`Amazon Elastic Kubernetes Service <https://aws.amazon.com/eks>`_,
`Google Kubernetes Engine <https://cloud.google.com/kubernetes-engine>`_,
`Azure Kubernetes Service <https://azure.microsoft.com/en-us/services/kubernetes-service>`_,
`Azure Kubernetes Service <https://azure.microsoft.com/services/kubernetes-service>`_,
and others.

The fastest way to run Trino on Kubernetes is to use the
Expand Down
Loading

0 comments on commit a4de074

Please sign in to comment.