From 4fdb36ae7ce1917025d6fb554458ebb6bc85451c Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 20 Mar 2022 14:43:50 +0200 Subject: [PATCH 001/882] Update index.rst Added a line of text to test search feature. --- index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.rst b/index.rst index e1455f21a..26b7459ec 100644 --- a/index.rst +++ b/index.rst @@ -4,7 +4,7 @@ SQream DB Documentation ************************* -For SQream version 2021.2. +The **2022.3 Preview** branch is a private branch designed for internal use only. .. only:: html From 94440c79ec952f53dde1dff744367a3d4eb974d2 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 20 Mar 2022 16:31:25 +0200 Subject: [PATCH 002/882] Started Creating Data Encryption Page --- feature_guides/data_encryption.rst | 115 +++++++++++++++++++++++++++++ feature_guides/index.rst | 1 + 2 files changed, 116 insertions(+) create mode 100644 feature_guides/data_encryption.rst diff --git a/feature_guides/data_encryption.rst b/feature_guides/data_encryption.rst new file mode 100644 index 000000000..02bdf2cea --- /dev/null +++ b/feature_guides/data_encryption.rst @@ -0,0 +1,115 @@ +.. _data_encryption: + +*********************** +Data Encryption +*********************** +The **Data Encryption** page: + +.. contents:: + :local: + :depth: 1 + +Overview +============== +Encryption functionality is an increasing growing demands from customers and new projects prospects (see Customers Specific Requirements section for more information), the functionality manifests in all sorts of ways as seen in the below section (implementation option) and the reason for it to be very important to customers is due to market strive to comply to the GDPR compliance regulations as it shows in the GDPR Compliance section. + +The encryption demand is growing around the world as it can be inserted to our sales pitch to promote vendors which security features is very important for them + +Column/Table-level encryption - More granular approach, encrypt only what you really need to + +Syntax +============== +The following is the correct syntax for encrypting a new table: + +.. code-block:: console + + CREATE TABLE client_name ( + first_name TEXT(128), + last_name TEXT(128), + salary INT(6) ENCRYPT); + +The following is the correct syntax for decrypting a new table: + +.. code-block:: console + + SELECT * FROM TABLE; + +The following is an example of encrypting a new table: + +.. code-block:: console + + EXAMPLE + +The following is an example of decryping a new table: + +.. code-block:: console + + EXAMPLE + +Encrypting Data in Transit +============== + +Encrypting Data at Rest +============== + +Data Types +============== + +How Encryption Works +============== +The **How Encryption Works** page describes the following: + +.. contents:: + :local: + :depth: 1 + +Encryption +---------------- + + + +Decryption +---------------- + + + +Encrypted Columns +---------------- + + + +Constraints +---------------- +Describe these in one of the existing sections. + + + +Use Case Considerations +============== +Include the relevant content from this section in the correct places in this document. + + + +Permissions +============== + + + +Usage Notes +============== +Include the relevant content from this section in the correct places in this document. + + + + + + + +Security Encryption available in one column. +Is there a flag associated with this feature? +There already is a Security page. Are we overriding it? +Give the big picture in the Overview. +Show Inon the before/after example. +Minimum Viable Product MVP +Permissions section - external +Deadline: two weeks minimum \ No newline at end of file diff --git a/feature_guides/index.rst b/feature_guides/index.rst index a0a996fc8..c5f472785 100644 --- a/feature_guides/index.rst +++ b/feature_guides/index.rst @@ -12,6 +12,7 @@ This section describes the following features: :titlesonly: delete_guide + data_encryption compression flexible_data_clustering python_functions From 93b019432b2e557c7c9200b15bcb6bbbea69ae5f Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Mon, 21 Mar 2022 09:34:34 +0200 Subject: [PATCH 003/882] Update data_encryption.rst --- feature_guides/data_encryption.rst | 78 ++++++++++++++++-------------- 1 file changed, 43 insertions(+), 35 deletions(-) diff --git a/feature_guides/data_encryption.rst b/feature_guides/data_encryption.rst index 02bdf2cea..e3e1af5f3 100644 --- a/feature_guides/data_encryption.rst +++ b/feature_guides/data_encryption.rst @@ -3,23 +3,53 @@ *********************** Data Encryption *********************** -The **Data Encryption** page: + +The **Data Encryption** page describes the following: .. contents:: :local: :depth: 1 - + + Overview ============== -Encryption functionality is an increasing growing demands from customers and new projects prospects (see Customers Specific Requirements section for more information), the functionality manifests in all sorts of ways as seen in the below section (implementation option) and the reason for it to be very important to customers is due to market strive to comply to the GDPR compliance regulations as it shows in the GDPR Compliance section. +**Data Encryption** helps protect sensitive data by preventing unauthorized users from reading it in the event of a breach. This is achieved by scrambling the content into an unreadable format based on encryption and decryption keys. + +The demand for confidentiality has steadily increased to protect the growing volumes of private data stored on computer systems and transmitted over the internet. To this end, regulatory bodies such as the **General Data Protection Regulation (GDPR)** have produced requirements to standardize and enforce compliance aimed at protecting customer data. -The encryption demand is growing around the world as it can be inserted to our sales pitch to promote vendors which security features is very important for them +For more information on GDPR compliance requirements, see the `GDPR checklist `_. Column/Table-level encryption - More granular approach, encrypt only what you really need to + + +Encryption Methods +============== +The **Encryption Methods** section describes the following: + +.. contents:: + :local: + :depth: 1 + +Encrypting Data in Transit +---------------- +**In-transit data** refers to data files inserted from customer repositories using the COPY FROM command, and is transmitted to SQream over a TLS-encrypted channel using a JDBC or ODBC connection. + +For more information, see the following: + +* :ref:`copy_from` +* :ref:`jdbc` +* :ref:`odbc` + +Encrypting Data at Rest +---------------- + +Data Types +============== + Syntax ============== -The following is the correct syntax for encrypting a new table: +The following is the correct syntax for **encrypting** a new table: .. code-block:: console @@ -27,33 +57,24 @@ The following is the correct syntax for encrypting a new table: first_name TEXT(128), last_name TEXT(128), salary INT(6) ENCRYPT); - -The following is the correct syntax for decrypting a new table: - -.. code-block:: console - - SELECT * FROM TABLE; - + The following is an example of encrypting a new table: .. code-block:: console EXAMPLE - -The following is an example of decryping a new table: + +The following is the correct syntax for **decrypting** a new table: .. code-block:: console - - EXAMPLE -Encrypting Data in Transit -============== + SELECT * FROM TABLE; -Encrypting Data at Rest -============== +The following is an example of decrypting a new table: -Data Types -============== +.. code-block:: console + + EXAMPLE How Encryption Works ============== @@ -100,16 +121,3 @@ Usage Notes Include the relevant content from this section in the correct places in this document. - - - - - -Security Encryption available in one column. -Is there a flag associated with this feature? -There already is a Security page. Are we overriding it? -Give the big picture in the Overview. -Show Inon the before/after example. -Minimum Viable Product MVP -Permissions section - external -Deadline: two weeks minimum \ No newline at end of file From a9e050e7d935f55a00cb385a732b9d655168bacd Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Mon, 21 Mar 2022 09:58:12 +0200 Subject: [PATCH 004/882] Created Data Encryption Folder Separate page for each section. --- feature_guides/data_encryption.rst | 123 ------------------ .../data_encryption/data_encryption.rst | 18 +++ .../data_encryption/data_encryption_flow.rst | 32 +++++ .../data_encryption_methods.rst | 23 ++++ .../data_encryption_overview.rst | 10 ++ .../data_encryption_syntax.rst | 44 +++++++ .../data_encryption/data_encryption_types.rst | 16 +++ .../data_encryption_use_cases.rst | 14 ++ 8 files changed, 157 insertions(+), 123 deletions(-) delete mode 100644 feature_guides/data_encryption.rst create mode 100644 feature_guides/data_encryption/data_encryption.rst create mode 100644 feature_guides/data_encryption/data_encryption_flow.rst create mode 100644 feature_guides/data_encryption/data_encryption_methods.rst create mode 100644 feature_guides/data_encryption/data_encryption_overview.rst create mode 100644 feature_guides/data_encryption/data_encryption_syntax.rst create mode 100644 feature_guides/data_encryption/data_encryption_types.rst create mode 100644 feature_guides/data_encryption/data_encryption_use_cases.rst diff --git a/feature_guides/data_encryption.rst b/feature_guides/data_encryption.rst deleted file mode 100644 index e3e1af5f3..000000000 --- a/feature_guides/data_encryption.rst +++ /dev/null @@ -1,123 +0,0 @@ -.. _data_encryption: - -*********************** -Data Encryption -*********************** - -The **Data Encryption** page describes the following: - -.. contents:: - :local: - :depth: 1 - - -Overview -============== -**Data Encryption** helps protect sensitive data by preventing unauthorized users from reading it in the event of a breach. This is achieved by scrambling the content into an unreadable format based on encryption and decryption keys. - -The demand for confidentiality has steadily increased to protect the growing volumes of private data stored on computer systems and transmitted over the internet. To this end, regulatory bodies such as the **General Data Protection Regulation (GDPR)** have produced requirements to standardize and enforce compliance aimed at protecting customer data. - -For more information on GDPR compliance requirements, see the `GDPR checklist `_. - -Column/Table-level encryption - More granular approach, encrypt only what you really need to - - - -Encryption Methods -============== -The **Encryption Methods** section describes the following: - -.. contents:: - :local: - :depth: 1 - -Encrypting Data in Transit ----------------- -**In-transit data** refers to data files inserted from customer repositories using the COPY FROM command, and is transmitted to SQream over a TLS-encrypted channel using a JDBC or ODBC connection. - -For more information, see the following: - -* :ref:`copy_from` -* :ref:`jdbc` -* :ref:`odbc` - -Encrypting Data at Rest ----------------- - -Data Types -============== - -Syntax -============== -The following is the correct syntax for **encrypting** a new table: - -.. code-block:: console - - CREATE TABLE client_name ( - first_name TEXT(128), - last_name TEXT(128), - salary INT(6) ENCRYPT); - -The following is an example of encrypting a new table: - -.. code-block:: console - - EXAMPLE - -The following is the correct syntax for **decrypting** a new table: - -.. code-block:: console - - SELECT * FROM TABLE; - -The following is an example of decrypting a new table: - -.. code-block:: console - - EXAMPLE - -How Encryption Works -============== -The **How Encryption Works** page describes the following: - -.. contents:: - :local: - :depth: 1 - -Encryption ----------------- - - - -Decryption ----------------- - - - -Encrypted Columns ----------------- - - - -Constraints ----------------- -Describe these in one of the existing sections. - - - -Use Case Considerations -============== -Include the relevant content from this section in the correct places in this document. - - - -Permissions -============== - - - -Usage Notes -============== -Include the relevant content from this section in the correct places in this document. - - diff --git a/feature_guides/data_encryption/data_encryption.rst b/feature_guides/data_encryption/data_encryption.rst new file mode 100644 index 000000000..e312e7fff --- /dev/null +++ b/feature_guides/data_encryption/data_encryption.rst @@ -0,0 +1,18 @@ +.. _data_encryption: + +*********************** +Data Encryption +*********************** + +The **Data Encryption** page describes the following: + +.. toctree:: + :maxdepth: 1 + :titlesonly: + + data_encryption_overview + data_encryption_methods + data_encryption_types + data_encryption_syntax + data_encryption_flow + data_encryption_use_cases \ No newline at end of file diff --git a/feature_guides/data_encryption/data_encryption_flow.rst b/feature_guides/data_encryption/data_encryption_flow.rst new file mode 100644 index 000000000..f65b1d240 --- /dev/null +++ b/feature_guides/data_encryption/data_encryption_flow.rst @@ -0,0 +1,32 @@ +.. _data_encryption_flow: + +*********************** +Data Encryption Flow +*********************** +The **Data Encryption Flow** page describes the following: + +.. contents:: + :local: + :depth: 1 + +Encryption +---------------- + + + +Decryption +---------------- + + + +Encrypted Columns +---------------- +Column/Table-level encryption - More granular approach, encrypt only what you really need to + + + + +Constraints +---------------- +Describe these in one of the existing sections. + diff --git a/feature_guides/data_encryption/data_encryption_methods.rst b/feature_guides/data_encryption/data_encryption_methods.rst new file mode 100644 index 000000000..031f263b3 --- /dev/null +++ b/feature_guides/data_encryption/data_encryption_methods.rst @@ -0,0 +1,23 @@ +.. _data_encryption_methods: + +*********************** +Encryption Methods +*********************** +The **Encryption Methods** section describes the following: + +.. contents:: + :local: + :depth: 1 + +Encrypting Data in Transit +---------------- +**In-transit data** refers to data files inserted from customer repositories using the COPY FROM command, and is transmitted to SQream over a TLS-encrypted channel using a JDBC or ODBC connection. + +For more information, see the following: + +* :ref:`copy_from` +* :ref:`jdbc` +* :ref:`odbc` + +Encrypting Data at Rest +---------------- diff --git a/feature_guides/data_encryption/data_encryption_overview.rst b/feature_guides/data_encryption/data_encryption_overview.rst new file mode 100644 index 000000000..5b3f3e344 --- /dev/null +++ b/feature_guides/data_encryption/data_encryption_overview.rst @@ -0,0 +1,10 @@ +.. _data_encryption_overview: + +*********************** +Overview +*********************** +**Data Encryption** helps protect sensitive data by preventing unauthorized users from reading it in the event of a breach. This is achieved by scrambling the content into an unreadable format based on encryption and decryption keys. + +The demand for confidentiality has steadily increased to protect the growing volumes of private data stored on computer systems and transmitted over the internet. To this end, regulatory bodies such as the **General Data Protection Regulation (GDPR)** have produced requirements to standardize and enforce compliance aimed at protecting customer data. + +For more information on GDPR compliance requirements, see the `GDPR checklist `_. \ No newline at end of file diff --git a/feature_guides/data_encryption/data_encryption_syntax.rst b/feature_guides/data_encryption/data_encryption_syntax.rst new file mode 100644 index 000000000..8df3e0d33 --- /dev/null +++ b/feature_guides/data_encryption/data_encryption_syntax.rst @@ -0,0 +1,44 @@ +.. _data_encryption_syntax: + +*********************** +Syntax +*********************** + +The **Syntax** page describes the following: + +.. contents:: + :local: + :depth: 1 + +The following is the correct syntax for **encrypting** a new table: + +.. code-block:: console + + CREATE TABLE client_name ( + first_name TEXT(128), + last_name TEXT(128), + salary INT(6) ENCRYPT); + +The following is an example of encrypting a new table: + +.. code-block:: console + + EXAMPLE + +The following is the correct syntax for **decrypting** a new table: + +.. code-block:: console + + SELECT * FROM TABLE; + +The following is an example of decrypting a new table: + +.. code-block:: console + + EXAMPLE + +Usage notes - this should be included on this page. + +When inputting the wrong master key/location in encryption/decryption an error should be raised to the user + +The master key needs to be masked in logs to protect user privacy, the responsibility maintaining the master key for the remote repository is on the user side \ No newline at end of file diff --git a/feature_guides/data_encryption/data_encryption_types.rst b/feature_guides/data_encryption/data_encryption_types.rst new file mode 100644 index 000000000..331b14f58 --- /dev/null +++ b/feature_guides/data_encryption/data_encryption_types.rst @@ -0,0 +1,16 @@ +.. _data_encryption_types: + +*********************** +Data Types +*********************** + + +Per the research done and per customer requirement the data types that should be supported are the following: + +Int + +BigInt + +String + +On most cases this data type, if encrypted, will be populated by PII value (Personal Identifiable Information) such as credit card number and other personal and sensitive information \ No newline at end of file diff --git a/feature_guides/data_encryption/data_encryption_use_cases.rst b/feature_guides/data_encryption/data_encryption_use_cases.rst new file mode 100644 index 000000000..9e9ddeb4a --- /dev/null +++ b/feature_guides/data_encryption/data_encryption_use_cases.rst @@ -0,0 +1,14 @@ +.. _data_encryption_use_cases: + +*********************** +Use Cases +*********************** + + + + + +Use Case Considerations +============== +Include the relevant content from this section in the correct places in this document. + From 8c9a1a4facaddd59b0f40a0a4a1544567a731409 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Mon, 21 Mar 2022 10:08:21 +0200 Subject: [PATCH 005/882] Updated Menu to include Data Encryption --- feature_guides/{data_encryption => }/data_encryption.rst | 0 feature_guides/{data_encryption => }/data_encryption_flow.rst | 0 feature_guides/{data_encryption => }/data_encryption_methods.rst | 0 feature_guides/{data_encryption => }/data_encryption_overview.rst | 0 feature_guides/{data_encryption => }/data_encryption_syntax.rst | 0 feature_guides/{data_encryption => }/data_encryption_types.rst | 0 .../{data_encryption => }/data_encryption_use_cases.rst | 0 7 files changed, 0 insertions(+), 0 deletions(-) rename feature_guides/{data_encryption => }/data_encryption.rst (100%) rename feature_guides/{data_encryption => }/data_encryption_flow.rst (100%) rename feature_guides/{data_encryption => }/data_encryption_methods.rst (100%) rename feature_guides/{data_encryption => }/data_encryption_overview.rst (100%) rename feature_guides/{data_encryption => }/data_encryption_syntax.rst (100%) rename feature_guides/{data_encryption => }/data_encryption_types.rst (100%) rename feature_guides/{data_encryption => }/data_encryption_use_cases.rst (100%) diff --git a/feature_guides/data_encryption/data_encryption.rst b/feature_guides/data_encryption.rst similarity index 100% rename from feature_guides/data_encryption/data_encryption.rst rename to feature_guides/data_encryption.rst diff --git a/feature_guides/data_encryption/data_encryption_flow.rst b/feature_guides/data_encryption_flow.rst similarity index 100% rename from feature_guides/data_encryption/data_encryption_flow.rst rename to feature_guides/data_encryption_flow.rst diff --git a/feature_guides/data_encryption/data_encryption_methods.rst b/feature_guides/data_encryption_methods.rst similarity index 100% rename from feature_guides/data_encryption/data_encryption_methods.rst rename to feature_guides/data_encryption_methods.rst diff --git a/feature_guides/data_encryption/data_encryption_overview.rst b/feature_guides/data_encryption_overview.rst similarity index 100% rename from feature_guides/data_encryption/data_encryption_overview.rst rename to feature_guides/data_encryption_overview.rst diff --git a/feature_guides/data_encryption/data_encryption_syntax.rst b/feature_guides/data_encryption_syntax.rst similarity index 100% rename from feature_guides/data_encryption/data_encryption_syntax.rst rename to feature_guides/data_encryption_syntax.rst diff --git a/feature_guides/data_encryption/data_encryption_types.rst b/feature_guides/data_encryption_types.rst similarity index 100% rename from feature_guides/data_encryption/data_encryption_types.rst rename to feature_guides/data_encryption_types.rst diff --git a/feature_guides/data_encryption/data_encryption_use_cases.rst b/feature_guides/data_encryption_use_cases.rst similarity index 100% rename from feature_guides/data_encryption/data_encryption_use_cases.rst rename to feature_guides/data_encryption_use_cases.rst From cdbd5588263595ef3bb6b5e8276a05a2ffd4ebec Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Mon, 21 Mar 2022 14:06:16 +0200 Subject: [PATCH 006/882] Added Update --- reference/sql/sql_statements/index.rst | 4 + reference/sql/sql_statements/update.rst | 245 ++++++++++++++++++++++++ 2 files changed, 249 insertions(+) create mode 100644 reference/sql/sql_statements/update.rst diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index 955e1212f..e14041385 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -11,6 +11,8 @@ SQream DB supports commands from ANSI SQL. Data Definition Commands (DDL) ================================ + update + .. list-table:: DDL Commands :widths: auto :header-rows: 1 @@ -20,6 +22,8 @@ Data Definition Commands (DDL) - Usage * - :ref:`ADD COLUMN` - Add a new column to a table + * - :ref:`UPDATE` + - Modify the value of certain columns in existing rows without creating a table * - :ref:`ALTER DEFAULT SCHEMA` - Change the default schema for a role * - :ref:`ALTER TABLE` diff --git a/reference/sql/sql_statements/update.rst b/reference/sql/sql_statements/update.rst new file mode 100644 index 000000000..143363b3b --- /dev/null +++ b/reference/sql/sql_statements/update.rst @@ -0,0 +1,245 @@ +.. _update: + +********************** +UPDATE +********************** + +The **UPDATE** statement page describes the following: + +.. contents:: + :local: + :depth: 1 + +Overview +========== +The ``UPDATE`` command is used to modify the value of certain columns in existing rows without creating a table. + +It can be used to do the following: + +* Perform localized changes in existing data, such as correcting mistakes discovered after ingesting data. + +* Setting columns based on the values of others. + +Syntax +========== +The following is the correct syntax for the ``UPDATE`` command: + +.. code-block:: postgres + + UPDATE target_table_name [[AS] alias1] + SET column_name = expression [,...] + [FROM additional_table_name [[AS] alias2][,...]] + [WHERE condition] + +The following is the correct syntax for triggering a clean-up: + +.. code-block:: postgres + + SELECT cleanup_chunks('schema_name','table_name'); + SELECT cleanup_extents('schema_name','table_name'); + +**Comment** - *The cleanup example above is different than the one used on the DELETED page. Is this correct?* + +Parameters +============ +The following table describes the ``UPDATE`` parameters: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``target_table_name`` + - Specifies the table containing the data to be updated. + * - ``column_name`` + - Specifies the column containing the data to be updated. + * - ``additional_table_name`` + - Additional tables used in the WHERE condition for performing complex joins. + * - ``condition`` + - Specifies the condition for updating the data. + +.. note:: Similar to a DELETE statement, an UPDATE statement may leave some uncleaned data behind, which requires a cleanup operation. + +Examples +=========== +The **Examples** section includes the following examples: + +.. contents:: + :local: + :depth: 1 + +Updating an Entire Table +----------------- +The Examples section shows how to modify the value of certain columns in existing rows without creating a table. The examples are based on the following tables: + +.. image:: /_static/images/delete_optimization.png + +The following methods for updating an entire table generate the same output, and result with the ``bands`` record set to ``NULL``: + +.. code-block:: postgres + + UPDATE bands SET records_sold = 0; + +.. code-block:: postgres + + UPDATE bands SET records_sold = 0 WHERE true; + +.. code-block:: postgres + + UPDATE bands SET records_sold = 0 USING countries; + +.. code-block:: postgres + + UPDATE bands SET records_sold = 0 USING countries WHERE 1=1; + +Performing Simple Updates +----------------- +The following is an example of performing a simple update: + +.. code-block:: postgres + + UPDATE bands SET records_sold = records_sold + 1 WHERE name LIKE 'The %'; + +Updating Tables that Contain Multi-Table Conditions +----------------- +The following shows an example of updating tables that contain multi-table conditions: + +.. code-block:: postgres + + UPDATE bands + SET records_sold = records_sold + 1 + WHERE EXISTS ( + SELECT 1 FROM countries + WHERE countries.id=bands.country_id + AND country.name = 'Sweden' + ); + +You can also write the statement above using the FROM clause: + +.. code-block:: psql + + UPDATE bands + SET records_sold = records_sold + 1 + FROM countries + WHERE countries.id=bands.country_id AND country.name = 'Sweden'; + +Updating Tables that Contain Multi-Table Expressions +----------------- +The following shows an example of updating tables that contain multi-table expressions: + +.. code-block:: postgres + + UPDATE bands + SET records_sold = records_sold + + CASE + WHEN c.name = 'Israel' THEN 2 + ELSE 1 + END + FROM countries c + +Configuring Update Behavior +----------------- +The ``failOnNondeterministicUpdate`` flag is used to configure ``UPDATE`` behavior when updating tables containing multi-table expressions. This flag is needed when you use the ``FROM`` clause along with a set expression containing columns from additional tables. Doing this can cause a match to occur between a row from the target table with multiple rows from the additional tables. + +**Note to self** - *Check if the Studio documentation must be updated for this flag.* + +For instance, the example in the previous section sets the records sold to ``2`` when the country name is Israel. If you were to insert a new entry into this table with Israel spelled in Hebrew (using the same country ID), you would have two rows with identical country ID's. + +When this happens, both rows 5 and 6 in the ``bands`` table match both Israel entries. Because no algorithm exists for determining which entry to use, updating this table may either increase ``records_sold`` by 2 (for Israel in English) or 1 (for Israel in Hebrew). + +You must set the ``failOnNondeterministicUpdate`` flag to ``FALSE`` to prevent an error from occuring. + +**Comment** - *Does the system actually choose one, or does it generate an error?* + +Note that a similar ambiguity can occur when the Hebrew spelling is used in the following example: + +.. code-block:: postgres + + UPDATE bands + SET record_count = record_count + 1 + FROM countries c + WHERE c.name = 'Israel' + +However, the ``WHERE`` clause above prevents a match with any entry other than the defined one. Because the target table row must match with the ``WHERE`` condition at least once to be included in the UPDATE statment, this scenario does not require configuring the ``failOnNondeterministicUpdate`` flag. + +**Comment** - *Please review the paragraph above. I'm pretty sure I described this correctly.* + +For more information, see `SQream Acceleration Studio `_. + +Identifying and Cleaning Up Tables +--------------------------------------- +**Comment** - *I copied and pasted this entire section from "DELETE". Does anything have to adjusted here for "UPDATE"?* + +The following section shows examples of each phase required for cleaning up tables: + +* :ref:`Listing tables that require clean-up` +* :ref:`Identifying clean-up predicates` +* :ref:`Triggering a clean-up` + +.. _listing_tables_that_require_cleanup: + +Listing Tables that Require Clean-Up +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +The following shows an example of listing tables that require clean-up: + +.. code-block:: psql + + farm=> SELECT t.table_name FROM sqream_catalog.delete_predicates dp + JOIN sqream_catalog.tables t + ON dp.table_id = t.table_id + GROUP BY 1; + cool_animals + + 1 row + +.. _identifying_cleanup_predicates: + +Identifying Clean-Up Predicates +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +The following shows an example of listing the clean-up predicates: + +.. code-block:: psql + + farm=> SELECT delete_predicate FROM sqream_catalog.delete_predicates dp + JOIN sqream_catalog.tables t + ON dp.table_id = t.table_id + WHERE t.table_name = 'cool_animals'; + weight > 1000 + + 1 row + +.. _triggering_a_cleanup: + +Triggering a Clean-Up +^^^^^^^^^^^^^^^^^^^^^^ +The following shows an example of triggering a clean-up: + +.. code-block:: psql + + -- Chunk reorganization (SWEEP) + farm=> SELECT CLEANUP_CHUNKS('public','cool_animals'); + executed + + -- Delete leftover files (VACUUM) + farm=> SELECT CLEANUP_EXTENTS('public','cool_animals'); + executed + + + farm=> SELECT delete_predicate FROM sqream_catalog.delete_predicates dp + JOIN sqream_catalog.tables t + ON dp.table_id = t.table_id + WHERE t.table_name = 'cool_animals'; + + 0 rows + +Permissions +============= +Executing an ``UPDATE`` statement requires the following permissions: + +* Both ``UPDATE`` and ``SELECT`` permissions on the target table. +* The ``SELECT`` permission for each additional table you reference in the statement (in ither the ``FROM`` clause or ``WHERE`` subquery section). + +Locking and Concurrency +============= +Executing the ``UPDATE`` statement obtains an exclusive UPDATE lock on the target table, but does not lock the destination tables. \ No newline at end of file From fade107ea80f689f5a0d304f6438c9a7ad63d29f Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Wed, 23 Mar 2022 09:59:21 +0200 Subject: [PATCH 007/882] Updated for RN Release - Preview --- data_ingestion/avro.rst | 344 ++++++++++++++++++ data_ingestion/index.rst | 3 +- feature_guides/data_encryption_methods.rst | 2 +- feature_guides/index.rst | 2 +- .../{ => dml_commands}/update.rst | 0 reference/sql/sql_statements/index.rst | 6 +- releases/2022.1.rst | 104 ++++++ releases/index.rst | 5 +- 8 files changed, 458 insertions(+), 8 deletions(-) create mode 100644 data_ingestion/avro.rst rename reference/sql/sql_statements/{ => dml_commands}/update.rst (100%) create mode 100644 releases/2022.1.rst diff --git a/data_ingestion/avro.rst b/data_ingestion/avro.rst new file mode 100644 index 000000000..920b6d44b --- /dev/null +++ b/data_ingestion/avro.rst @@ -0,0 +1,344 @@ +.. _avro: + +************************** +Inserting Data from Avro +************************** +The **Inserting Data from Avro** page describes inserting data from Avro into SQream and includes the following: + +.. contents:: + :local: + :depth: 1 + +Overview +=========== +**Avro** is a well-known data serialization system that relies on schemas. Due to its flexibility and nesting as an efficient data storage method, SQream supports the Avro binary data format as an alternative to JSON. + +Avro Data Types +=========== + +Avro includes the following data types: + +.. contents:: + :local: + :depth: 1 + +Primitive Data Types +-------------- +The following table shows the supported **Primitive** data types: + ++-------------+-------------------------------------------+ +| Avro Type | SQream Type | +| +--------+---------------+--------+---------+ +| | Number | Date/Datetime | String | Boolean | ++=============+========+===============+========+=========+ +| ``null`` | ✓ | ✓ | ✓ | ✓ | ++-------------+--------+---------------+--------+---------+ +| ``boolean`` | | | ✓ | ✓ | ++-------------+--------+---------------+--------+---------+ +| ``int`` | ✓ | | ✓ | | ++-------------+--------+---------------+--------+---------+ +| ``long`` | ✓ | | ✓ | | ++-------------+--------+---------------+--------+---------+ +| ``float`` | ✓ | | ✓ | | ++-------------+--------+---------------+--------+---------+ +| ``double`` | ✓ | | ✓ | | ++-------------+--------+---------------+--------+---------+ +| ``bytes`` | | | | | ++-------------+--------+---------------+--------+---------+ +| ``string`` | | ✓ | ✓ | | ++-------------+--------+---------------+--------+---------+ + + + + + + +Complex Data Types +-------------- +The following table shows the supported **Complex** data types: + ++------------+-------------------------------------------+ +| | SQream Type | +| +--------+---------------+--------+---------+ +|Avro Type | Number | Date/Datetime | String | Boolean | ++============+========+===============+========+=========+ +| ``record`` | | | | | ++------------+--------+---------------+--------+---------+ +| ``enum`` | | | ✓ | | ++------------+--------+---------------+--------+---------+ +| ``array`` | | | | | ++------------+--------+---------------+--------+---------+ +| ``map`` | | | | | ++------------+--------+---------------+--------+---------+ +| ``union`` | ✓ | ✓ | ✓ | ✓ | ++------------+--------+---------------+--------+---------+ +| ``fixed`` | | | | | ++------------+--------+---------------+--------+---------+ + + +Logical Data Types +-------------- +The following table shows the supported **Logical** data types: + ++----------------------------+-------------------------------------------+ +| Avro Type | SQream Type | +| +--------+---------------+--------+---------+ +| | Number | Date/Datetime | String | Boolean | ++============================+========+===============+========+=========+ +| ``decimal`` | ✓ | | ✓ | | ++----------------------------+--------+---------------+--------+---------+ +| ``uuid`` | | | ✓ | | ++----------------------------+--------+---------------+--------+---------+ +| ``date`` | | ✓ | ✓ | | ++----------------------------+--------+---------------+--------+---------+ +| ``time-millis`` | | | | | ++----------------------------+--------+---------------+--------+---------+ +| ``time-micros`` | | | | | ++----------------------------+--------+---------------+--------+---------+ +| ``timestamp-millis`` | | ✓ | ✓ | | ++----------------------------+--------+---------------+--------+---------+ +| ``timestamp-micros`` | | ✓ | ✓ | | ++----------------------------+--------+---------------+--------+---------+ +| ``local-timestamp-millis`` | | | | | ++----------------------------+--------+---------------+--------+---------+ +| ``local-timestamp-micros`` | | | | | ++----------------------------+--------+---------------+--------+---------+ +| ``duration`` | | | | | ++----------------------------+--------+---------------+--------+---------+ + + +Mapping Objects to Rows +=============== +When mapping objects to rows, each Avro object or message must contain one ``record`` type object corresponding to a single row in SQream. The ``record`` fields are associated by name to their target table columns. + +Additional unmapped fields will be ignored. Note that using the JSONPath option overrides this. + +Ingesting Avro Files +==================== +This section describes how to ingest Avro files into SQream and covers the following: + + +.. contents:: + :local: + :depth: 1 + + +Preparing Your Avro Source File +---------- +Prepare your Avro source files according to the following requirements: + +* RFC 4180 standard CSV files, but can also be modified to support non-standard CSVs (with multi-character delimiters, unquoted fields, etc). + + :: + +* Files are encoded with UTF-8 or ASCII. + + :: + +* Field delimiter is an ASCII character or characters. + + :: + +* Record delimiter, also known as a new line separator, is a Unix-style newline (``\n``), DOS-style newline (``\r\n``), or Mac style newline (``\r``). + + :: + +* If a field is quoted, any double quote that appears must be double-quoted (similar to the :ref:`string literals quoting rules`. For example, to encode ``What are "birds"?``, the field should appear as ``"What are ""birds""?"``. + + :: + +* Fields can be enclosed by double-quotes (optional), or mandatory quotes if they contain one of the following characters: + + * The record delimiter or field delimiter. + + :: + + * A double quote character. + + :: + + * A newline. + +SQream does not support other modes of escaping, such as ``1,"What are \"birds\"?"``. + +``NULL`` values can be marked in the following ways in Avro files: + + * An explicit null marker. For example, ``col1,\N,col3``. + + :: + + * An empty field delimited by the field delimiter. For example, ``col1,,col3``. + + .. note:: If a text field is quoted but contains no content (``""``) it is considered an empty text field and not ``NULL``. + +For more information about standard CSV files, see `RFC 4180 standard CSVs `_. + +Making Avro Files Accessible to Workers +--------------------- +To give workers access to files every node must have the same view of the storage being used. + +The following apply for Avro files to be accessible to workers: + +* For files hosted on NFS, ensure that the mount is accessible from all servers. + +* For HDFS, ensure that SQream servers have access to the HDFS name node with the correct **user-id**. For more information, see :ref:`hdfs`. + +* For S3, ensure network access to the S3 endpoint. For more information, see :ref:`s3`. + +For more information about restricted worker access, see :ref:`workload_manager`. + +Basing Your Table Structure on Inserted Tables +--------------------- +Before loading data, you must build the ``CREATE EXTERNAL TABLE`` to correspond with the file structure of the inserted table. + +The example in this section is based on the source ``nba.parquet`` table shown below: + +.. csv-table:: nba.parquet + :file: nba-t10.csv + :widths: auto + :header-rows: 1 + +The following example shows the correct file structure used to create the ``CREATE EXTERNAL TABLE`` statement based on the **nba.parquet** table: + +.. code-block:: postgres + + CREATE FOREIGN TABLE ext_nba + ( + Name VARCHAR(40), + Team VARCHAR(40), + Number BIGINT, + Position VARCHAR(2), + Age BIGINT, + Height VARCHAR(4), + Weight BIGINT, + College VARCHAR(40), + Salary FLOAT + ) + WRAPPER parquet_fdw + OPTIONS + ( + LOCATION = 's3://sqream-demo-data/nba.parquet' + ); + +.. tip:: + + An exact match must exist between the SQream and Avro types. For unsupported column types, you can set the type to any type and exclude it from subsequent queries. + +.. note:: The **nba.parquet** file is stored on S3 at ``s3://sqream-demo-data/nba.parquet``. + +Verifying Your Table Output +--------------------- +Because external tables do not automatically verify the file integrity or structure, you must manually verify that the table output is identical to the original inserted table. + +The following is an example of the output based on the **nba.parquet** table: + +.. code-block:: psql + + t=> SELECT * FROM ext_nba LIMIT 10; + Name | Team | Number | Position | Age | Height | Weight | College | Salary + --------------+----------------+--------+----------+-----+--------+--------+-------------------+--------- + Avery Bradley | Boston Celtics | 0 | PG | 25 | 6-2 | 180 | Texas | 7730337 + Jae Crowder | Boston Celtics | 99 | SF | 25 | 6-6 | 235 | Marquette | 6796117 + John Holland | Boston Celtics | 30 | SG | 27 | 6-5 | 205 | Boston University | + R.J. Hunter | Boston Celtics | 28 | SG | 22 | 6-5 | 185 | Georgia State | 1148640 + Jonas Jerebko | Boston Celtics | 8 | PF | 29 | 6-10 | 231 | | 5000000 + Amir Johnson | Boston Celtics | 90 | PF | 29 | 6-9 | 240 | | 12000000 + Jordan Mickey | Boston Celtics | 55 | PF | 21 | 6-8 | 235 | LSU | 1170960 + Kelly Olynyk | Boston Celtics | 41 | C | 25 | 7-0 | 238 | Gonzaga | 2165160 + Terry Rozier | Boston Celtics | 12 | PG | 22 | 6-2 | 190 | Louisville | 1824360 + Marcus Smart | Boston Celtics | 36 | PG | 22 | 6-4 | 220 | Oklahoma State | 3431040 + +.. note:: If your table output has errors, verify that the structure of the Avro files correctly corresponds to the external table structure that you created. + +Loading Data into SQream +--------------------- + +Syntax +~~~~~~~~~~~~~~~~~~~~~ +The following is the correct syntax for loading data into SQream: + +.. code-block:: postgres + + CREATE TABLE AS + SELECT * FROM ; + +The following is an example of loading data into SQream: + +.. code-block:: postgres + + CREATE TABLE nba AS + SELECT * FROM ext_nba; + +For more information about the **CREATE TABLE AS** statement, see :ref:`create_table_as`. + +Examples +~~~~~~~~~~~~~~~~~~~~~ + +This section includes the following examples of loading data into SQream: + +.. contents:: + :local: + :depth: 1 + +Omitting Unsupported Column Types +********************** +When loading data, you can omit columns using the ``NULL as`` argument. You can use this argument to omit unsupported columns from queries that access external tables. By omitting them, these columns will not be called and will avoid generating a "type mismatch" error. + +In the example below, the ``Position`` column is not supported due its type. + +.. code-block:: postgres + + CREATE TABLE nba AS + SELECT Name, Team, Number, NULL as Position, Age, Height, Weight, College, Salary FROM ext_nba; + + +Modifying Data Before Loading +********************** +One of the main reasons for staging data using the ``EXTERNAL TABLE`` argument is to examine and modify table contents before loading it into SQream. + +For example, we can replace pounds with kilograms using the :ref:`create_table_as` statement + +In the example below, the ``Position`` column is set to the default ``NULL``. + +.. code-block:: postgres + + CREATE TABLE nba AS + SELECT name, team, number, NULL as Position, age, height, (weight / 2.205) as weight, college, salary + FROM ext_nba + ORDER BY weight; + + +Loading a Table from a Directory of Avro Files on HDFS +********************** +The following is an example of loading a table from a directory of Avro files on HDFS: + +.. code-block:: postgres + + CREATE FOREIGN TABLE ext_users + (id INT NOT NULL, name VARCHAR(30) NOT NULL, email VARCHAR(50) NOT NULL) + WRAPPER parquet_fdw + OPTIONS + ( + LOCATION = 'hdfs://hadoop-nn.piedpiper.com/rhendricks/users/*.parquet' + ); + + CREATE TABLE users AS SELECT * FROM ext_users; + +For more configuration option examples, see the `CREATE FOREIGN TABLE parameters `_. + +Loading a Table from a Directory of Avro Files on S3 +********************** +The following is an example of loading a table from a directory of Avro files on S3: + +.. code-block:: postgres + + CREATE FOREIGN TABLE ext_users + (id INT NOT NULL, name VARCHAR(30) NOT NULL, email VARCHAR(50) NOT NULL) + WRAPPER parquet_fdw + OPTIONS + ( LOCATION = 's3://pp-secret-bucket/users/*.parquet', + AWS_ID = 'our_aws_id', + AWS_SECRET = 'our_aws_secret' + ); + + CREATE TABLE users AS SELECT * FROM ext_users; \ No newline at end of file diff --git a/data_ingestion/index.rst b/data_ingestion/index.rst index 83aca40ea..12582b8e4 100644 --- a/data_ingestion/index.rst +++ b/data_ingestion/index.rst @@ -10,9 +10,10 @@ The **Data Ingestion Sources** provides information about the following: :glob: inserting_data + avro csv parquet orc oracle -For information about database tools and interfaces that SQream supports, see `Third Party Tools `_. +For information about database tools and interfaces that SQream supports, see `Third Party Tools `_. \ No newline at end of file diff --git a/feature_guides/data_encryption_methods.rst b/feature_guides/data_encryption_methods.rst index 031f263b3..c0aae030d 100644 --- a/feature_guides/data_encryption_methods.rst +++ b/feature_guides/data_encryption_methods.rst @@ -16,7 +16,7 @@ Encrypting Data in Transit For more information, see the following: * :ref:`copy_from` -* :ref:`jdbc` +* `JDBC `_ * :ref:`odbc` Encrypting Data at Rest diff --git a/feature_guides/index.rst b/feature_guides/index.rst index c5f472785..650638c17 100644 --- a/feature_guides/index.rst +++ b/feature_guides/index.rst @@ -5,7 +5,7 @@ Feature Guides *********************** The **Feature Guides** section describes background processes that SQream uses to manage several areas of operation, such as data ingestion, load balancing, and access control. -This section describes the following features: +This section describes the following features: .. toctree:: :maxdepth: 1 diff --git a/reference/sql/sql_statements/update.rst b/reference/sql/sql_statements/dml_commands/update.rst similarity index 100% rename from reference/sql/sql_statements/update.rst rename to reference/sql/sql_statements/dml_commands/update.rst diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index e14041385..8ecd680df 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -11,8 +11,6 @@ SQream DB supports commands from ANSI SQL. Data Definition Commands (DDL) ================================ - update - .. list-table:: DDL Commands :widths: auto :header-rows: 1 @@ -22,8 +20,6 @@ Data Definition Commands (DDL) - Usage * - :ref:`ADD COLUMN` - Add a new column to a table - * - :ref:`UPDATE` - - Modify the value of certain columns in existing rows without creating a table * - :ref:`ALTER DEFAULT SCHEMA` - Change the default schema for a role * - :ref:`ALTER TABLE` @@ -86,6 +82,8 @@ Data Manipulation Commands (DML) - Select rows and column from a table * - :ref:`TRUNCATE` - Delete all rows from a table + * - :ref:`UPDATE` + - Modify the value of certain columns in existing rows without creating a table * - :ref:`VALUES` - Return rows containing literal values diff --git a/releases/2022.1.rst b/releases/2022.1.rst new file mode 100644 index 000000000..d36bc9463 --- /dev/null +++ b/releases/2022.1.rst @@ -0,0 +1,104 @@ +.. _2022.1: + +************************** +Release Notes 2022.1 +************************** +The 2022.1 release notes were released on x/xx/2022 and describe the following: + +.. contents:: + :local: + :depth: 1 + + +Version Content +---------- +The 2022.1 Release Notes describes the following: + +* Example - Major feature release targeted for all on-premises customers. +* Example - Basic Cloud functionality. + + +New Features +---------- +The 2022.1 Release Notes include the following new features: + +.. contents:: + :local: + :depth: 1 + +Data Encryption +************ + + +Update Feature +************ + + +Avro Ingestion +************ + + + + +Main Features +-------- +The following list describes the main features: + +* xxx +* xx + + +Resolved Issues +--------- +The following list describes the resolved issues: + +The following table lists the issues that were resolved in Version 2021.2: + +.. list-table:: + :widths: 17 200 + :header-rows: 1 + + * - SQ No. + - Description + * - SQ-xxxx + - Text + * - SQ-xxxx + - Text + * - SQ-xxxx + - Text + +Operations and Configuration Changes +-------- + +Subject +************ +Text + + + + +Subject +************ +Text + + + +Naming Changes +------- +No relevant naming changes were made. + +Deprecated Features +------- +No features were depecrated. + +Known Issues and Limitations +-------- +The the list below describes the following known issues and limitations: + +* xxx +* xxx + + +Upgrading to v2022.1 +------- + diff --git a/releases/index.rst b/releases/index.rst index 472197afc..9158933a4 100644 --- a/releases/index.rst +++ b/releases/index.rst @@ -12,7 +12,9 @@ Release Notes * - Version - Release Date - * - :ref:`2021.2` + * - :ref:`2022.1` + - April 17, 2022 + * - :ref:`2022.1` - September 13, 2021 * - :ref:`2021.1` - June 13, 2021 @@ -30,6 +32,7 @@ Release Notes :glob: :hidden: + 2022.1 2021.2_index 2021.1_index 2020.3_index From d80c9427434d4abd73b5879f80e97f34a75e3e0a Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Wed, 23 Mar 2022 10:21:44 +0200 Subject: [PATCH 008/882] Not Published --- releases/2022.1.rst | 41 +++++++++++++++++++++++++++++------------ 1 file changed, 29 insertions(+), 12 deletions(-) diff --git a/releases/2022.1.rst b/releases/2022.1.rst index d36bc9463..51a7333cc 100644 --- a/releases/2022.1.rst +++ b/releases/2022.1.rst @@ -7,8 +7,7 @@ The 2022.1 release notes were released on x/xx/2022 and describe the following: .. contents:: :local: - :depth: 1 - + :depth: 1 Version Content ---------- @@ -17,6 +16,7 @@ The 2022.1 Release Notes describes the following: * Example - Major feature release targeted for all on-premises customers. * Example - Basic Cloud functionality. +**Comment** - *This will be done at the end.* New Features ---------- @@ -28,30 +28,33 @@ The 2022.1 Release Notes include the following new features: Data Encryption ************ +SQream now supports data encryption mechanisms in accordance with **General Data Protection Regulation (GDPR)** standards. +For more information, see `Data Encryption `_. Update Feature ************ +SQream now supports the DML **Update** feature, which is used for modifying the value of certain columns in existing rows without creating a table. +For more information, see `UPDATE `_. Avro Ingestion ************ +SQream now supports ingesting data from Avro files. - - +For more information, see `Inserting Data from Avro `_. Main Features -------- The following list describes the main features: -* xxx -* xx +* Main feature +* Main feature +**Comment** - *This will be done at the end.* Resolved Issues --------- -The following list describes the resolved issues: - The following table lists the issues that were resolved in Version 2021.2: .. list-table:: @@ -65,10 +68,14 @@ The following table lists the issues that were resolved in Version 2021.2: * - SQ-xxxx - Text * - SQ-xxxx - - Text + - Text + +**Comment** - *I will be updated regarding which resolved issues to include.* Operations and Configuration Changes -------- +**Comment** - *TBD* + Subject ************ @@ -85,20 +92,30 @@ Text Naming Changes ------- +**Comment** - *TBD* + No relevant naming changes were made. Deprecated Features ------- +**Comment** - *TBD* + No features were depecrated. Known Issues and Limitations -------- +**Comment** - *TBD* + The the list below describes the following known issues and limitations: -* xxx -* xxx +* Text +* Text + +End of Support +------- +**Comment** - *TBD* Upgrading to v2022.1 ------- - +**Comment** - *TBD* \ No newline at end of file From 3cd71e0265075b7229b2681ca950d08333b326e5 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Wed, 23 Mar 2022 13:02:48 +0200 Subject: [PATCH 009/882] Replaced left menu with multi-layered list Left menu was too long. Running idea by Product. --- .../sql_functions/scalar_functions/index.rst | 93 ++++++++++++++++--- 1 file changed, 80 insertions(+), 13 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/index.rst b/reference/sql/sql_functions/scalar_functions/index.rst index 1a7d639b3..114d26cd6 100644 --- a/reference/sql/sql_functions/scalar_functions/index.rst +++ b/reference/sql/sql_functions/scalar_functions/index.rst @@ -1,20 +1,87 @@ .. _scalar_functions: **************** -Built-In Scalar functions +Built-In Scalar Functions **************** -Built-in scalar functions return one value per call. +The **Built-In Scalar Functions** page describes functions that return one value per call: +.. hlist:: + :columns: 5 -.. toctree:: - :maxdepth: 1 - :caption: Built-in scalar functions - :glob: - - bitwise/* - conditionals/* - conversion/* - date_and_time/* - numeric/* - string/* \ No newline at end of file + + * `AND `_ + * `NOT `_ + * `OR `_ + * `SHIFT_LEFT `_ + * `SHIFT_RIGHT `_ + * `XOR `_ + * :ref:`between` + * :ref:`case` + * :ref:`coalesce` + * :ref:`in` + * :ref:`is_ascii` + * :ref:`is_null` + * :ref:`isnull` + * :ref:`from_unixts` + * :ref:`to_hex` + * :ref:`to_unixts` + * :ref:`curdate` + * :ref:`current_date` + * :ref:`current_timestamp` + * :ref:`dateadd` + * :ref:`datediff` + * :ref:`datepart` + * :ref:`eomonth` + * :ref:`extract` + * :ref:`getdate` + * :ref:`sysdate` + * :ref:`trunc` + * :ref:`abs` + * :ref:`acos` + * :ref:`asin` + * :ref:`atan` + * :ref:`atn2` + * :ref:`ceiling` + * :ref:`cos` + * :ref:`cot` + * :ref:`crc64` + * :ref:`degrees` + * :ref:`exp` + * :ref:`floor` + * :ref:`log` + * :ref:`log10` + * :ref:`mod` + * :ref:`pi` + * :ref:`power` + * :ref:`radians` + * :ref:`round` + * :ref:`sin` + * :ref:`sqrt` + * :ref:`square` + * :ref:`tan` + * :ref:`trunc` + * :ref:`char_length` + * :ref:`charindex` + * :ref:`concat` + * :ref:`isprefixof` + * :ref:`left` + * :ref:`len` + * :ref:`like` + * :ref:`lower` + * :ref:`ltrim` + * :ref:`octet_length` + * :ref:`patindex` + * :ref:`regexp_count` + * :ref:`regexp_instr` + * :ref:`regexp_replace` + * :ref:`regexp_substr` + * :ref:`repeat` + * :ref:`replace` + * :ref:`reverse` + * :ref:`right` + * :ref:`rlike` + * :ref:`rtrim` + * :ref:`substring` + * :ref:`trim` + * :ref:`upper` \ No newline at end of file From 58c097b2b9d0f8eca39b1ca90a85843d176fde3b Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Wed, 23 Mar 2022 13:50:14 +0200 Subject: [PATCH 010/882] Updated System Functions Menu --- .../system_functions/explain.rst | 59 ++++ .../sql_functions/system_functions/index.rst | 12 +- .../system_functions/show_connections.rst | 78 +++++ .../system_functions/show_locks.rst | 79 +++++ .../system_functions/show_node_info.rst | 310 ++++++++++++++++++ .../system_functions/show_server_status.rst | 108 ++++++ .../system_functions/stop_statement.rst | 77 +++++ 7 files changed, 719 insertions(+), 4 deletions(-) create mode 100644 reference/sql/sql_functions/system_functions/explain.rst create mode 100644 reference/sql/sql_functions/system_functions/show_connections.rst create mode 100644 reference/sql/sql_functions/system_functions/show_locks.rst create mode 100644 reference/sql/sql_functions/system_functions/show_node_info.rst create mode 100644 reference/sql/sql_functions/system_functions/show_server_status.rst create mode 100644 reference/sql/sql_functions/system_functions/stop_statement.rst diff --git a/reference/sql/sql_functions/system_functions/explain.rst b/reference/sql/sql_functions/system_functions/explain.rst new file mode 100644 index 000000000..e9b7e7ee9 --- /dev/null +++ b/reference/sql/sql_functions/system_functions/explain.rst @@ -0,0 +1,59 @@ +.. _explain: + +***************** +EXPLAIN +***************** + +``EXPLAIN`` returns a static query plan, which can be used to debug query plans. + +To see an actively running query or statement, use :ref:`show_node_info` instead. + +See also :ref:`show_node_info`, :ref:`show_server_status`. + + +Permissions +============= + +The role must have the ``SELECT`` permissions for any tables referenced by the query. + +Syntax +========== + +.. code-block:: postgres + + explain_statement ::= + SELECT EXPLAIN(query_stmt) + ; + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``query_stmt`` + - The select query to generate the plan for. + +Notes +=========== + +Use dollar-quoting to escape the query text + +Examples +=========== + +Generating a static query plan +---------------------------------- + +.. code-block:: psql + + t=> SELECT EXPLAIN($$SELECT DATEADD(hour,1,dt) FROM cool_dates$$); + Select + Specific (TTNative Gpu) (dateadd@null := dt@null, + dateadd@val := (pure_if dt@null "0" (addHoursdt2dt dt@val "1"))) + Table Scan + public.cool_dates ("dt@null", "dt@val") [] + diff --git a/reference/sql/sql_functions/system_functions/index.rst b/reference/sql/sql_functions/system_functions/index.rst index 734a9133a..a27dfda62 100644 --- a/reference/sql/sql_functions/system_functions/index.rst +++ b/reference/sql/sql_functions/system_functions/index.rst @@ -3,14 +3,18 @@ ******************** System Functions ******************** +**System functions** are used for returning system information, such as version and node information, and for maintenance operations that are not regularly accessed from any interface. -System functions are used for working with database objects, settings, and values. - +The System Functions page describes the following: .. toctree:: :maxdepth: 1 :glob: - :hidden: + explain show_version - + show_connections + show_locks + show_node_info + show_server_status + stop_statement \ No newline at end of file diff --git a/reference/sql/sql_functions/system_functions/show_connections.rst b/reference/sql/sql_functions/system_functions/show_connections.rst new file mode 100644 index 000000000..1bd320a4c --- /dev/null +++ b/reference/sql/sql_functions/system_functions/show_connections.rst @@ -0,0 +1,78 @@ +.. _show_connections: + +******************** +SHOW_CONNECTIONS +******************** + +``SHOW_CONNECTIONS`` returns a list of active sessions on the current worker. + +To see sessions across the cluster, see :ref:`show_server_status`. + +Permissions +============= + +The role must have the ``SUPERUSER`` permissions. + +Syntax +========== + +.. code-block:: postgres + + show_connections_statement ::= + SELECT SHOW_CONNECTIONS() + ; + +Parameters +============ + +None + +Returns +========= + +This function returns a list of active sessions. If no sessions are active on the worker, the result set will be empty. + +.. list-table:: Result columns + :widths: auto + :header-rows: 1 + + * - ``ip`` + - The worker hostname or IP + * - ``conn_id`` + - Connection ID + * - ``conn_start_time`` + - Connection start timestamp + * - ``stmt_id`` + - Statement ID. Connections with no active statement display ``-1``. + * - ``stmt_start_time`` + - Statement start timestamp + * - ``stmt`` + - Statement text + + +Notes +=========== + +* This utility shows the active connections. Some sessions may be actively connected, but not currently running a statement. + +* A connection is typically reused. There could be many statements under a single connection ID. + +Examples +=========== + +Using ``SHOW_CONNECTIONS`` to get statement IDs +---------------------------------------------------- + + +.. code-block:: psql + + t=> SELECT SHOW_CONNECTIONS(); + ip | conn_id | conn_start_time | stmt_id | stmt_start_time | stmt + -------------+---------+---------------------+---------+---------------------+-------------------------- + 192.168.1.91 | 103 | 2019-12-24 00:01:27 | 129 | 2019-12-24 00:38:18 | SELECT GET_DATE(), * F... + 192.168.1.91 | 23 | 2019-12-24 00:01:27 | -1 | 2019-12-24 00:01:27 | + 192.168.1.91 | 22 | 2019-12-24 00:01:27 | -1 | 2019-12-24 00:01:27 | + 192.168.1.91 | 26 | 2019-12-24 00:01:28 | -1 | 2019-12-24 00:01:28 | + + +The statement ID we're interested in is ``129``. We can see the connection started at 00:01:27, while the statement started at 00:38:18. \ No newline at end of file diff --git a/reference/sql/sql_functions/system_functions/show_locks.rst b/reference/sql/sql_functions/system_functions/show_locks.rst new file mode 100644 index 000000000..d5e7c02ec --- /dev/null +++ b/reference/sql/sql_functions/system_functions/show_locks.rst @@ -0,0 +1,79 @@ +.. _show_locks: + +******************** +SHOW_LOCKS +******************** + +``SHOW_LOCKS`` returns a list of locks from across the cluster. + +Read more about locks in :ref:`concurrency_and_locks`. + +Permissions +============= + +The role must have the ``SUPERUSER`` permissions. + +Syntax +========== + +.. code-block:: postgres + + show_locks_statement ::= + SELECT SHOW_LOCKS() + ; + +Parameters +============ + +None + +Returns +========= + +This function returns a list of active locks. If no locks are active in the cluster, the result set will be empty. + +.. list-table:: Result columns + :widths: auto + :header-rows: 1 + + * - ``stmt_id`` + - Statement ID that caused the lock. + * - ``stmt_string`` + - Statement text + * - ``username`` + - The role that executed the statement + * - ``server`` + - The worker node's IP + * - ``port`` + - The worker node's port + * - ``locked_object`` + - The full qualified name of the object being locked, separated with ``$`` (e.g. ``table$t$public$nba2`` for table ``nba2`` in schema ``public``, in database ``t`` + * - ``lockmode`` + - The locking mode (:ref:`inclusive` or :ref:`exclusive`). + * - ``statement_start_time`` + - Timestamp the statement started + * - ``lock_start_time`` + - Timestamp the lock was obtained + + +Examples +=========== + +Using ``SHOW_LOCKS`` to see active locks +--------------------------------------------------- + +In this example, we create a table based on results (:ref:`create_table_as`), but we are also effectively dropping the previous table (by using ``OR REPLACE``). Thus, SQream DB applies locks during the table creation process to prevent the table from being altered during it's creation. + + +.. code-block:: psql + + t=> SELECT SHOW_LOCKS(); + statement_id | statement_string | username | server | port | locked_object | lockmode | statement_start_time | lock_start_time + -------------+-------------------------------------------------------------------------------------------------+----------+--------------+------+---------------------------------+-----------+----------------------+-------------------- + 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | database$t | Inclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 + 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | globalpermission$ | Exclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 + 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | schema$t$public | Inclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 + 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | table$t$public$nba2$Insert | Exclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 + 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | table$t$public$nba2$Update | Exclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 + + diff --git a/reference/sql/sql_functions/system_functions/show_node_info.rst b/reference/sql/sql_functions/system_functions/show_node_info.rst new file mode 100644 index 000000000..345d16440 --- /dev/null +++ b/reference/sql/sql_functions/system_functions/show_node_info.rst @@ -0,0 +1,310 @@ +.. _show_node_info: + +******************** +SHOW_NODE_INFO +******************** + +``SHOW_NODE_INFO`` returns a snapshot of the current query plan, similar to ``EXPLAIN ANALYZE`` from other databases. + +The snapshot provides information about execution which can be used for monitoring and troubleshooting slow running statements by helping identify long-running execution nodes (components that process data), etc. + +See also :ref:`explain`, :ref:`show_server_status`. + +Permissions +============= + +The role must have the ``SUPERUSER`` permissions. + +Syntax +========== + +.. code-block:: postgres + + show_node_info_statement ::= + SELECT SHOW_NODE_INFO(stmt_id) + ; + + stmt_id ::= bigint + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``stmt_id`` + - The statement ID to explore + +Returns +========= + +This utility returns details of the execution nodes, if the statement is still running. + +If the statement has finished, or the statment ID does not exist, the utility returns an empty result set. + +.. list-table:: Result columns + :widths: auto + :header-rows: 1 + + * - Column name + - Description + * - ``stmt_id`` + - The ID for the statement + * - ``node_id`` + - This node's ID in this execution plan + * - ``node_type`` + - The node type + * - ``rows`` + - Total number of rows this node has processed + * - ``chunks`` + - Number of chunks this node has processed + * - ``avg_rows_in_chunk`` + - Average amount of rows that this node processes in each chunk (``rows / chunks``) + * - ``time`` + - Timestamp for this node's creation + * - ``parent_node_id`` + - The ``node_id`` of this node's parent + * - ``read`` + - Total data read from disk + * - ``write`` + - Total data written to disk + * - ``comment`` + - Additional information (e.g. table name for ``ReadTable``) + * - ``timesum`` + - Total elapsed time for this execution node's processing + + +.. _node_types: + +Node types +============= + +This is a full list of node types: + +.. list-table:: Node types + :widths: auto + :header-rows: 1 + + * - Column name + - Execution location + - Description + * - ``AddChunkId`` + - + - Used during insert operations + * - ``AddSequences`` + - + - Used during insert operations, with :ref:`identity columns` + * - ``AddMinMaxMetadata`` + - + - Used to calculate ranges for the :ref:`chunk metadata system` + * - ``AddTopSortFilters`` + - + - An operation to optimize ``LIMIT`` when used alongside ``ORDER BY`` + * - ``Compress`` + - CPU and GPU + - Compress data with both CPU and GPU schemes + * - ``CpuDecompress`` + - CPU + - Decompression operation, common for longer ``VARCHAR`` types + * - ``CpuLoopJoin`` + - CPU + - A non-indexed nested loop join, performed on the CPU + * - ``CpuReduce`` + - CPU + - A reduce process performed on the CPU, primarily with ``DISTINCT`` aggregates (e.g. ``COUNT(DISTINCT ...)``) + * - ``CpuToGpu``, ``GpuToCpu`` + - + - An operation that moves data to or from the GPU for processing + * - ``CpuTransform`` + - CPU + - A transform operation performed on the CPU, usually a :ref:`scalar function` + * - ``CrossJoin`` + - + - A join without a join condition + * - ``DeferredGather`` + - CPU + - Merges the results of GPU operations with a result set [#f0]_ + * - ``Distinct`` + - GPU + - Removes duplicate rows (usually as part of the ``DISTINCT`` operation) + * - ``Distinct_Merge`` + - CPU + - The merge operation of the ``Distinct`` operation + * - ``Filter`` + - GPU + - A filtering operation, such as a ``WHERE`` or ``JOIN`` clause + * - ``GpuCopy`` + - GPU + - Copies data between GPUs or within a single GPU + * - ``GpuDecompress`` + - GPU + - Decompression operation + * - ``GpuReduceMerge`` + - GPU + - An operation to optimize part of the merger phases in the GPU + * - ``GpuTransform`` + - GPU + - A transformation operation such as a type cast or :ref:`scalar function` + * - ``Hash`` + - CPU + - Hashes the output result. Used internally. + * - ``JoinSideMarker`` + - + - Used internally. + * - ``LiteralValues`` + - CPU + - Creates a virtual relation (table), when :ref:`values` is used + * - ``LocateFiles`` + - CPU + - Validates external file paths for foreign data wrappers, expanding directories and GLOB patterns + * - ``LoopJoin`` + - GPU + - A non-indexed nested loop join, performed on the GPU + * - ``MarkMatchedJoinRows`` + - + - Used in outer joins, matches rows for larger join operations + * - ``NullifyDuplicates`` + - + - Replaces duplicate values with ``NULL`` to calculate distinct aggregates + * - ``NullSink`` + - CPU + - Used internally + * - ``ParseCsv`` + - CPU + - A CSV parser, used after ``ReadFiles`` to convert the CSV into columnar data + * - ``PopNetworkQueue`` + - CPU + - Fetches data from the network queue (e.g. when used with :ref:`insert`) + * - ``PushToNetworkQueue`` + - CPU + - Sends result sets to a client connected over the network + * - ``ReadCatalog`` + - CPU + - Converts the :ref:`catalog` into a relation (table) + * - ``ReadFiles`` + - CPU + - Reads external flat-files + * - ``ReadOrc`` + - CPU + - Reads data from an ORC file + * - ``ReadParquet`` + - CPU + - Reads data from a Parquet file + * - ``ReadTable`` + - CPU + - Reads data from a standard table stored on disk + * - ``ReadTableMetadata`` + - CPU + - Reads only table metadata as an optimization + * - ``Rechunk`` + - + - Reorganize multiple small :ref:`chunks` into a full chunk. Commonly found after joins and when :ref:`HIGH_SELECTIVITY` is used + * - ``Reduce`` + - GPU + - A reduction operation, such as a ``GROUP BY`` + * - ``ReduceMerge`` + - GPU + - A merge operation of a reduction operation, helps operate on larger-than-RAM data + * - ``ReorderInput`` + - + - Change the order of arguments in preparation for the next operation + * - ``SeparatedGather`` + - GPU + - Gathers additional columns for the result + * - ``Sort`` + - GPU + - Sort operation [#f1]_ + * - ``SortMerge`` + - CPU + - A merge operation of a sort operation, helps operate on larger-than-RAM data + * - ``SortMergeJoin`` + - GPU + - A sort-merge join, performed on the GPU + * - ``TakeRowsFromChunk`` + - + - Take the first N rows from each chunk, to optimize ``LIMIT`` when used alongside ``ORDER BY`` + * - ``Top`` + - + - Limits the input size, when used with ``LIMIT`` (or its alias ``TOP``) + * - ``UdfTransform`` + - CPU + - Executes a :ref:`user defined function` + * - ``UnionAll`` + - + - Combines two sources of data when ``UNION ALL`` is used + * - ``VarCharJoiner`` + - + - Used internally + * - ``VarCharSplitter`` + - + - Used intenrally + * - ``Window`` + - GPU + - Executes a non-ranking :ref:`window function` + * - ``WindowRanking`` + - GPU + - Executes a ranking :ref:`window function` + * - ``WriteTable`` + - CPU + - Writes the result set to a standard table stored on disk + +.. rubric:: Footnotes + +.. [#f0] Gathers columns which should be returned. This node typically spends most of the time on decompressing additional columns. + +.. [#f1] A GPU sort operation can be added by the statement compiler before ``GROUP BY`` or ``JOIN`` operations. + +Statement statuses +======================= + +.. include:: /reference/sql/sql_statements/monitoring_commands/show_server_status.rst + :start-line: 67 + :end-line: 84 + +Notes +=========== + +* This utility shows the execution information for active statements. Once a query has finished execution, the information is no longer available using this utility. See :ref:`logging` for more information about extracting the information from the logs. + +* This utility is primarily intended for troubleshooting with SQream support. + +Examples +=========== + +Getting execution details for a statement +------------------------------------------------ + + +.. code-block:: psql + + t=> SELECT SHOW_SERVER_STATUS(); + service | instanceid | connection_id | serverip | serverport | database_name | user_name | clientip | statementid | statement | statementstarttime | statementstatus | statementstatusstart + --------+------------+---------------+--------------+------------+---------------+-----------+--------------+-------------+-----------------------------------------------------------------+---------------------+-----------------+--------------------- + sqream | | 152 | 192.168.1.91 | 5000 | t | sqream | 192.168.1.91 | 176 | SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | 25-12-2019 23:53:13 | Executing | 25-12-2019 23:53:13 + sqream | | 151 | 192.168.1.91 | 5000 | t | sqream | 192.168.0.1 | 177 | SELECT show_server_status() | 25-12-2019 23:51:31 | Executing | 25-12-2019 23:53:13 + + +The statement ID we want to reserach is ``176``, running on worker ``192.168.1.91``. + +The query text is ``SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1;`` + +.. code-block:: psql + + t=> SELECT SHOW_NODE_INFO(176); + stmt_id | node_id | node_type | rows | chunks | avg_rows_in_chunk | time | parent_node_id | read | write | comment | timeSum + --------+---------+--------------------+------+--------+-------------------+---------------------+----------------+------+-------+------------+-------- + 176 | 1 | PushToNetworkQueue | 1 | 1 | 1 | 2019-12-25 23:53:13 | -1 | | | | 0.0025 + 176 | 2 | Rechunk | 1 | 1 | 1 | 2019-12-25 23:53:13 | 1 | | | | 0 + 176 | 3 | GpuToCpu | 1 | 1 | 1 | 2019-12-25 23:53:13 | 2 | | | | 0 + 176 | 4 | ReorderInput | 1 | 1 | 1 | 2019-12-25 23:53:13 | 3 | | | | 0 + 176 | 5 | Filter | 1 | 1 | 1 | 2019-12-25 23:53:13 | 4 | | | | 0.0002 + 176 | 6 | GpuTransform | 457 | 1 | 457 | 2019-12-25 23:53:13 | 5 | | | | 0.0002 + 176 | 7 | GpuDecompress | 457 | 1 | 457 | 2019-12-25 23:53:13 | 6 | | | | 0 + 176 | 8 | CpuToGpu | 457 | 1 | 457 | 2019-12-25 23:53:13 | 7 | | | | 0.0003 + 176 | 9 | Rechunk | 457 | 1 | 457 | 2019-12-25 23:53:13 | 8 | | | | 0 + 176 | 10 | CpuDecompress | 457 | 1 | 457 | 2019-12-25 23:53:13 | 9 | | | | 0 + 176 | 11 | ReadTable | 457 | 1 | 457 | 2019-12-25 23:53:13 | 10 | 4MB | | public.nba | 0.0004 + diff --git a/reference/sql/sql_functions/system_functions/show_server_status.rst b/reference/sql/sql_functions/system_functions/show_server_status.rst new file mode 100644 index 000000000..f59f79ccc --- /dev/null +++ b/reference/sql/sql_functions/system_functions/show_server_status.rst @@ -0,0 +1,108 @@ +.. _show_server_status: + +******************** +SHOW_SERVER_STATUS +******************** + +``SHOW_SERVER_STATUS`` returns a list of active sessions across the cluster. + +To list active statements on the current worker only, see :ref:`show_connections`. + +Permissions +============= + +The role must have the ``SUPERUSER`` permissions. + +Syntax +========== + +.. code-block:: postgres + + show_server_status_statement ::= + SELECT SHOW_SERVER_STATUS() + ; + +Parameters +============ + +None + +Returns +========= + +This function returns a list of active sessions. If no sessions are active across the cluster, the result set will be empty. + +.. list-table:: Result columns + :widths: auto + :header-rows: 1 + + * - ``service`` + - The service name for the statement + * - ``instance`` + - The worker ID + * - ``connection_id`` + - Connection ID + * - ``serverip`` + - Worker end-point IP + * - ``serverport`` + - Worker end-point port + * - ``database_name`` + - Database name for the statement + * - ``user_name`` + - Username running the statement + * - ``clientip`` + - Client IP + * - ``statementid`` + - Statement ID + * - ``statement`` + - Statement text + * - ``statementstarttime`` + - Statement start timestamp + * - ``statementstatus`` + - Statement status (see table below) + * - ``statementstatusstart`` + - Last updated timestamp + +.. include from here: 66 + + +.. list-table:: Statement status values + :widths: auto + :header-rows: 1 + + * - Status + - Description + * - ``Preparing`` + - Statement is being prepared + * - ``In queue`` + - Statement is waiting for execution + * - ``Initializing`` + - Statement has entered execution checks + * - ``Executing`` + - Statement is executing + * - ``Stopping`` + - Statement is in the process of stopping + + +.. include until here 86 + +Notes +=========== + +* This utility shows the active sessions. Some sessions may be actively connected, but not running any statements. + +Examples +=========== + +Using ``SHOW_SERVER_STATUS`` to get statement IDs +---------------------------------------------------- + + +.. code-block:: psql + + t=> SELECT SHOW_SERVER_STATUS(); + service | instanceid | connection_id | serverip | serverport | database_name | user_name | clientip | statementid | statement | statementstarttime | statementstatus | statementstatusstart + --------+------------+---------------+--------------+------------+---------------+------------+-------------+-------------+-----------------------------+---------------------+-----------------+--------------------- + sqream | | 102 | 192.168.1.91 | 5000 | t | rhendricks | 192.168.0.1 | 128 | SELECT SHOW_SERVER_STATUS() | 24-12-2019 00:14:53 | Executing | 24-12-2019 00:14:53 + +The statement ID is ``128``, running on worker ``192.168.1.91``. diff --git a/reference/sql/sql_functions/system_functions/stop_statement.rst b/reference/sql/sql_functions/system_functions/stop_statement.rst new file mode 100644 index 000000000..30efc25b5 --- /dev/null +++ b/reference/sql/sql_functions/system_functions/stop_statement.rst @@ -0,0 +1,77 @@ +.. _stop_statement: + +******************** +STOP_STATEMENT +******************** + +``STOP_STATEMENT`` stops or aborts an active statement. + +To find a statement by ID, see :ref:`show_server_status` and :ref:`show_connections`. + +.. tip:: Some DBMSs call this process killing a session, terminating a job, or kill query + +Permissions +============= + +The role must have the ``SUPERUSER`` permissions. + +Syntax +========== + +.. code-block:: postgres + + stop_statement_statement ::= + SELECT STOP_STATEMENT(stmt_id) + ; + + stmt_id ::= bigint + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``stmt_id`` + - The statement ID to stop + +Returns +========= + +This utility does not return any value, and always succeeds even if the statement does not exist, or has already stopped. + + +Notes +=========== + +* This utility always succeeds even if the statement does not exist, or has already stopped. + +Examples +=========== + +Using :ref:`show_connections` to get statement IDs +---------------------------------------------------- + +.. tip:: Use :ref:`show_server_status` to find statments from across the entire cluster, or :ref:`show_connections` to show statements from the current worker the client is connected to. + +.. code-block:: psql + + t=> SELECT SHOW_CONNECTIONS(); + ip | conn_id | conn_start_time | stmt_id | stmt_start_time | stmt + -------------+---------+---------------------+---------+---------------------+-------------------------- + 192.168.1.91 | 103 | 2019-12-24 00:01:27 | 129 | 2019-12-24 00:38:18 | SELECT GET_DATE(), * F... + 192.168.1.91 | 23 | 2019-12-24 00:01:27 | -1 | 2019-12-24 00:01:27 | + 192.168.1.91 | 22 | 2019-12-24 00:01:27 | -1 | 2019-12-24 00:01:27 | + 192.168.1.91 | 26 | 2019-12-24 00:01:28 | -1 | 2019-12-24 00:01:28 | + + +The statement ID we're interested in is ``129``. We can now stop this statement: + +.. code-block:: psql + + t=> SELECT STOP_STATEMENT(129) + executed + From 19b8851e92a8bce01d1651e9664b17bd119942b2 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Wed, 23 Mar 2022 15:55:38 +0200 Subject: [PATCH 011/882] Corrected error in Release Date table --- releases/index.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/releases/index.rst b/releases/index.rst index 9158933a4..d06a7a8bf 100644 --- a/releases/index.rst +++ b/releases/index.rst @@ -14,7 +14,7 @@ Release Notes - Release Date * - :ref:`2022.1` - April 17, 2022 - * - :ref:`2022.1` + * - :ref:`2021.2` - September 13, 2021 * - :ref:`2021.1` - June 13, 2021 @@ -37,4 +37,4 @@ Release Notes 2021.1_index 2020.3_index 2020.2 - 2020.1 + 2020.1 \ No newline at end of file From 103d94bc1e19d29f308d464f01b91ffb26cbb5cd Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 24 Mar 2022 13:01:52 +0200 Subject: [PATCH 012/882] Updated Encryption --- feature_guides/data_encryption.rst | 3 +- feature_guides/data_encryption_flow.rst | 17 +++- feature_guides/data_encryption_methods.rst | 5 +- .../data_encryption_permissions.rst | 19 ++++ feature_guides/data_encryption_process.rst | 88 +++++++++++++++++++ feature_guides/data_encryption_syntax.rst | 25 ++++-- feature_guides/data_encryption_types.rst | 14 ++- 7 files changed, 152 insertions(+), 19 deletions(-) create mode 100644 feature_guides/data_encryption_permissions.rst create mode 100644 feature_guides/data_encryption_process.rst diff --git a/feature_guides/data_encryption.rst b/feature_guides/data_encryption.rst index e312e7fff..3e9f485fb 100644 --- a/feature_guides/data_encryption.rst +++ b/feature_guides/data_encryption.rst @@ -13,6 +13,7 @@ The **Data Encryption** page describes the following: data_encryption_overview data_encryption_methods data_encryption_types + data_encryption_permissions data_encryption_syntax - data_encryption_flow + data_encryption_process data_encryption_use_cases \ No newline at end of file diff --git a/feature_guides/data_encryption_flow.rst b/feature_guides/data_encryption_flow.rst index f65b1d240..03f60fb44 100644 --- a/feature_guides/data_encryption_flow.rst +++ b/feature_guides/data_encryption_flow.rst @@ -1,9 +1,9 @@ -.. _data_encryption_flow: +.. _data_encryption_process: *********************** -Data Encryption Flow +Data Encryption Process *********************** -The **Data Encryption Flow** page describes the following: +The **Data Encryption Process** page describes end-to-end encryption process, and describes the following: .. contents:: :local: @@ -11,8 +11,19 @@ The **Data Encryption Flow** page describes the following: Encryption ---------------- +The following describes the encryption process: +1. Users with the required encryption execution permission access the system (see Permissions & privileges section) +User will choose the specific columns he would like to encrypt in the file in which he will upload (see constraints section), the syntax will encapsulates the hint which will trigger the encryption (see syntax section) + +User will provide the location of the master key from which the encryption will be derived in the remote repository (whether KMS or IBM SKLM) see syntax section for the exact convention (this section will not be applied in the MVP scope) + +User will trigger the copy command and the data will be transported upon TLS session (not yet data at rest encryption) + +Once data arrived to Sqream database it will be encrypted and saved + +For more information, see :ref:`data_encryption_permissions`. Decryption ---------------- diff --git a/feature_guides/data_encryption_methods.rst b/feature_guides/data_encryption_methods.rst index 031f263b3..0069b161c 100644 --- a/feature_guides/data_encryption_methods.rst +++ b/feature_guides/data_encryption_methods.rst @@ -16,8 +16,11 @@ Encrypting Data in Transit For more information, see the following: * :ref:`copy_from` -* :ref:`jdbc` +* `JDBC `_ * :ref:`odbc` Encrypting Data at Rest ---------------- +For **data at rest,** housed physically on computer data, you can encrypt one or more column as needed according to your specifications. Data at rest is encrypted before being written into files, and decrypted after being read from them. All existing unencrypted historical and data inserted into this column at a later time is encrypted for the specified column values. Data at rest is encrypted (**Comment** - *And decrypted?*) using the **AES-256** algorithm. + +**Comment** - *Because the encryption keys are hidden from users, I didn't document them here. Please confirm that this is correct.* \ No newline at end of file diff --git a/feature_guides/data_encryption_permissions.rst b/feature_guides/data_encryption_permissions.rst new file mode 100644 index 000000000..309d75654 --- /dev/null +++ b/feature_guides/data_encryption_permissions.rst @@ -0,0 +1,19 @@ +.. _data_encryption_permissions: + +*********************** +Permissions +*********************** +Any user who granted with the appropriated permission privilege's for encryption + +Implementation notes +Date format is out of the scope of this feature as well as Varchar (due to upcoming deprecation) + +one method to encrypt the data with is the TDE: Transparent data encryption which employed by Microsoft/IBM/Oracle etc. + +management. The requirement is that this will be programmatic via API. + +The centralized key management store should be one of the following (R&D to choose which one in accordance to easiness of deployment): + +KMS (AWS)- https://aws.amazon.com/kms/ + +IBM- IBM Security Guardium Key Lifecycle Manager - Overview \ No newline at end of file diff --git a/feature_guides/data_encryption_process.rst b/feature_guides/data_encryption_process.rst new file mode 100644 index 000000000..b84bb2969 --- /dev/null +++ b/feature_guides/data_encryption_process.rst @@ -0,0 +1,88 @@ +.. _data_encryption_process: + +*********************** +Data Encryption Process +*********************** +The **Data Encryption Process** page describes end-to-end encryption process, and describes the following: + +.. contents:: + :local: + :depth: 1 + +The Encryption Process +---------------- +The following describes the encryption process: + +1. A user with the required encryption execution permission accesses the system. + + :: + +#. In the file to be uploaded, the user selects columns to encrypt. The syntax will (**Comment** - *"should" instead of "will"?)* includes the hint that triggers the encryption (see syntax section). + + :: + +#. The user provides the location of the master key for deriving (**Comment** - *...generating/activating?*) the encryption in the remote repository. This applies to both **KMS** and **IBM SKLM**. + + :: + + **Comment** - *The source doc says, "this section will not be applied in the MVP scope." Should it stay in this doc?* + + :: + +#. The user trigger (**Comment** - *"runs"?*) the COPY command to transport the data upon TLS session (not yet data at rest encryption) (**Comment** - *"Upon TLS session = when the TLS session is activated?"* + + :: + +#. When the data is successfully inserted into the SQream database, it is encrypted and saved. + +For more information, see the following: + +* More information on permissions, see :ref:`data_encryption_permissions`. + + :: + +* More information on which columns to encrypt, see the :ref:`Constraints` section below. + + :: + +* More information on triggering the encryption, and the master key location syntax, see :ref:`data_encryption_syntax`. + +The Decryption Process +---------------- +The following describes the encryption process: + +1. A user with the required encryption execution permission accesses the system. + + :: + +#. The user indicates the decryption. **Comment** - *"Indicates" = "triggers"?*) + + :: + +#. The user can view the data derived from a table holding the encrypted data by decrypting the data by providing the location of the master key and selecting the required fields. + + : + + **Comment** - the source doc said, "this section will not be applied in the MVP scope." Should it stay in this doc?* + +Once the specific statement ends- the user will be able to see the data in a human readable convention (plain text) + +For more information, see the following: + +* More information on triggering the decryption, see :ref:`data_encryption_syntax`. + + + + +Encrypted Columns +---------------- +Column/Table-level encryption - More granular approach, encrypt only what you really need to + + + +.. _constraints: + +Constraints +---------------- +Describe these in one of the existing sections. + diff --git a/feature_guides/data_encryption_syntax.rst b/feature_guides/data_encryption_syntax.rst index 8df3e0d33..85cef25ee 100644 --- a/feature_guides/data_encryption_syntax.rst +++ b/feature_guides/data_encryption_syntax.rst @@ -3,13 +3,14 @@ *********************** Syntax *********************** - The **Syntax** page describes the following: .. contents:: :local: :depth: 1 - + +Encrypting a New Table +---------------- The following is the correct syntax for **encrypting** a new table: .. code-block:: console @@ -24,7 +25,11 @@ The following is an example of encrypting a new table: .. code-block:: console EXAMPLE - + +**Comment** - *Please provide an actual example.* + +Decrypting a New Table +---------------- The following is the correct syntax for **decrypting** a new table: .. code-block:: console @@ -37,8 +42,16 @@ The following is an example of decrypting a new table: EXAMPLE -Usage notes - this should be included on this page. +**Comment** - *Please provide an actual example.* + +Incorrectly Encrypting or Decrypting Your Data +---------------- +Using the incorrect master key or location while encrypting or decrypting generates an error. -When inputting the wrong master key/location in encryption/decryption an error should be raised to the user +**Comment** - *Can I get an example of this error to include in the doc?* + +**Comment** - *I thought that the master key was completely hidden from users... The internal doc says, "Master Key- the key will be generated within the server side, it will reside within a repository which will be hidden from the user."* + +In logs, master keys are masked to protect user privacy. Users are responsible for maintaining their master keys for the remote repository. -The master key needs to be masked in logs to protect user privacy, the responsibility maintaining the master key for the remote repository is on the user side \ No newline at end of file +**Comment** - *I'm not sure I fully understand the part about maintaing the master keys on the remote repository.* \ No newline at end of file diff --git a/feature_guides/data_encryption_types.rst b/feature_guides/data_encryption_types.rst index 331b14f58..3da9071c2 100644 --- a/feature_guides/data_encryption_types.rst +++ b/feature_guides/data_encryption_types.rst @@ -3,14 +3,12 @@ *********************** Data Types *********************** +SQream's data encryption supports the following data types: +* INT +* BIGINT +* TEXT -Per the research done and per customer requirement the data types that should be supported are the following: +Typically speaking, this data pertains to **PII (Personally Identifiable Information)**, which is sensitive information such as credit card numbers and other information related to an identifiable person. -Int - -BigInt - -String - -On most cases this data type, if encrypted, will be populated by PII value (Personal Identifiable Information) such as credit card number and other personal and sensitive information \ No newline at end of file +For more information on the above data types, see :ref:`supported_data_types`. \ No newline at end of file From 190ce170b9c1b09401454d8c2a143ba6c6716b48 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 24 Mar 2022 14:14:25 +0200 Subject: [PATCH 013/882] Updated --- feature_guides/data_encryption.rst | 3 +- feature_guides/data_encryption_flow.rst | 43 ------------------- feature_guides/data_encryption_overview.rst | 22 +++++++++- .../data_encryption_permissions.rst | 5 ++- feature_guides/data_encryption_process.rst | 24 +++++------ feature_guides/data_encryption_use_cases.rst | 14 ------ 6 files changed, 36 insertions(+), 75 deletions(-) delete mode 100644 feature_guides/data_encryption_flow.rst delete mode 100644 feature_guides/data_encryption_use_cases.rst diff --git a/feature_guides/data_encryption.rst b/feature_guides/data_encryption.rst index 3e9f485fb..e8f919217 100644 --- a/feature_guides/data_encryption.rst +++ b/feature_guides/data_encryption.rst @@ -15,5 +15,4 @@ The **Data Encryption** page describes the following: data_encryption_types data_encryption_permissions data_encryption_syntax - data_encryption_process - data_encryption_use_cases \ No newline at end of file + data_encryption_process \ No newline at end of file diff --git a/feature_guides/data_encryption_flow.rst b/feature_guides/data_encryption_flow.rst deleted file mode 100644 index 03f60fb44..000000000 --- a/feature_guides/data_encryption_flow.rst +++ /dev/null @@ -1,43 +0,0 @@ -.. _data_encryption_process: - -*********************** -Data Encryption Process -*********************** -The **Data Encryption Process** page describes end-to-end encryption process, and describes the following: - -.. contents:: - :local: - :depth: 1 - -Encryption ----------------- -The following describes the encryption process: - -1. Users with the required encryption execution permission access the system (see Permissions & privileges section) - -User will choose the specific columns he would like to encrypt in the file in which he will upload (see constraints section), the syntax will encapsulates the hint which will trigger the encryption (see syntax section) - -User will provide the location of the master key from which the encryption will be derived in the remote repository (whether KMS or IBM SKLM) see syntax section for the exact convention (this section will not be applied in the MVP scope) - -User will trigger the copy command and the data will be transported upon TLS session (not yet data at rest encryption) - -Once data arrived to Sqream database it will be encrypted and saved - -For more information, see :ref:`data_encryption_permissions`. - -Decryption ----------------- - - - -Encrypted Columns ----------------- -Column/Table-level encryption - More granular approach, encrypt only what you really need to - - - - -Constraints ----------------- -Describe these in one of the existing sections. - diff --git a/feature_guides/data_encryption_overview.rst b/feature_guides/data_encryption_overview.rst index 5b3f3e344..4c0455291 100644 --- a/feature_guides/data_encryption_overview.rst +++ b/feature_guides/data_encryption_overview.rst @@ -3,8 +3,26 @@ *********************** Overview *********************** -**Data Encryption** helps protect sensitive data by preventing unauthorized users from reading it in the event of a breach. This is achieved by scrambling the content into an unreadable format based on encryption and decryption keys. +**Data Encryption** helps protect sensitive data by preventing unauthorized users from reading it in the event of a breach. This is achieved by scrambling the content into an unreadable format based on encryption and decryption keys. The demand for confidentiality has steadily increased to protect the growing volumes of private data stored on computer systems and transmitted over the internet. To this end, regulatory bodies such as the **General Data Protection Regulation (GDPR)** have produced requirements to standardize and enforce compliance aimed at protecting customer data. -The demand for confidentiality has steadily increased to protect the growing volumes of private data stored on computer systems and transmitted over the internet. To this end, regulatory bodies such as the **General Data Protection Regulation (GDPR)** have produced requirements to standardize and enforce compliance aimed at protecting customer data. +Encryption can be used for the following: + +* Deleting encrypted columns. + + :: + +* Creating tables with one or more encrypted columns. + + :: + +* Joining encrypted columns with other tables. + + :: + +* Encrypting existing data. + + :: + +* Selecting data from an encrypted column. For more information on GDPR compliance requirements, see the `GDPR checklist `_. \ No newline at end of file diff --git a/feature_guides/data_encryption_permissions.rst b/feature_guides/data_encryption_permissions.rst index 309d75654..16f41dc70 100644 --- a/feature_guides/data_encryption_permissions.rst +++ b/feature_guides/data_encryption_permissions.rst @@ -3,10 +3,11 @@ *********************** Permissions *********************** -Any user who granted with the appropriated permission privilege's for encryption +Users with the appropriate encryption permission privilege's can encrypt and decrypt data. + +**Comment** - *The rest of this content seems internal, correct?* Implementation notes -Date format is out of the scope of this feature as well as Varchar (due to upcoming deprecation) one method to encrypt the data with is the TDE: Transparent data encryption which employed by Microsoft/IBM/Oracle etc. diff --git a/feature_guides/data_encryption_process.rst b/feature_guides/data_encryption_process.rst index b84bb2969..e76e6a9cc 100644 --- a/feature_guides/data_encryption_process.rst +++ b/feature_guides/data_encryption_process.rst @@ -61,28 +61,28 @@ The following describes the encryption process: #. The user can view the data derived from a table holding the encrypted data by decrypting the data by providing the location of the master key and selecting the required fields. - : + :: - **Comment** - the source doc said, "this section will not be applied in the MVP scope." Should it stay in this doc?* - -Once the specific statement ends- the user will be able to see the data in a human readable convention (plain text) - -For more information, see the following: - -* More information on triggering the decryption, see :ref:`data_encryption_syntax`. - + **Comment** - *the source doc said, "this section will not be applied in the MVP scope." Should it stay in this doc?* +#. When the statement has ended, the user can view the data in a human readable format as plain text. +For more information on triggering the decryption, see :ref:`data_encryption_syntax`. Encrypted Columns ---------------- -Column/Table-level encryption - More granular approach, encrypt only what you really need to - +**Comment** - *This section and "Constraints" don't really seem like phases in a flow, at least the way they are currently described. If they really are part of a flow, we should discuss how to reword them.* +Tables with encrypted columns are tagged with the ``encrypted`` label, allowing you to select what data to encrypt. .. _constraints: Constraints ---------------- -Describe these in one of the existing sections. +The encryption will be done in the database server- data at rest as the data will be encrypted in transit based on the TLS protocol. + +**Comment** - *I need some clarification on the sentence above.* + +Users without permissions to view tables with one or more encrypted table cannot view the entire table. +**Comment** - *Please confirm that the above sentence is correct. Below is the original sentence:"* \ No newline at end of file diff --git a/feature_guides/data_encryption_use_cases.rst b/feature_guides/data_encryption_use_cases.rst deleted file mode 100644 index 9e9ddeb4a..000000000 --- a/feature_guides/data_encryption_use_cases.rst +++ /dev/null @@ -1,14 +0,0 @@ -.. _data_encryption_use_cases: - -*********************** -Use Cases -*********************** - - - - - -Use Case Considerations -============== -Include the relevant content from this section in the correct places in this document. - From 612d83f08446199608cdaf66cb36e025b7af3149 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 24 Mar 2022 14:15:14 +0200 Subject: [PATCH 014/882] Updated --- feature_guides/data_encryption.rst | 4 +- feature_guides/data_encryption_flow.rst | 32 ------- feature_guides/data_encryption_methods.rst | 5 +- feature_guides/data_encryption_process.rst | 88 ++++++++++++++++++++ feature_guides/data_encryption_syntax.rst | 25 ++++-- feature_guides/data_encryption_types.rst | 14 ++-- feature_guides/data_encryption_use_cases.rst | 14 ---- 7 files changed, 119 insertions(+), 63 deletions(-) delete mode 100644 feature_guides/data_encryption_flow.rst create mode 100644 feature_guides/data_encryption_process.rst delete mode 100644 feature_guides/data_encryption_use_cases.rst diff --git a/feature_guides/data_encryption.rst b/feature_guides/data_encryption.rst index e312e7fff..e8f919217 100644 --- a/feature_guides/data_encryption.rst +++ b/feature_guides/data_encryption.rst @@ -13,6 +13,6 @@ The **Data Encryption** page describes the following: data_encryption_overview data_encryption_methods data_encryption_types + data_encryption_permissions data_encryption_syntax - data_encryption_flow - data_encryption_use_cases \ No newline at end of file + data_encryption_process \ No newline at end of file diff --git a/feature_guides/data_encryption_flow.rst b/feature_guides/data_encryption_flow.rst deleted file mode 100644 index f65b1d240..000000000 --- a/feature_guides/data_encryption_flow.rst +++ /dev/null @@ -1,32 +0,0 @@ -.. _data_encryption_flow: - -*********************** -Data Encryption Flow -*********************** -The **Data Encryption Flow** page describes the following: - -.. contents:: - :local: - :depth: 1 - -Encryption ----------------- - - - -Decryption ----------------- - - - -Encrypted Columns ----------------- -Column/Table-level encryption - More granular approach, encrypt only what you really need to - - - - -Constraints ----------------- -Describe these in one of the existing sections. - diff --git a/feature_guides/data_encryption_methods.rst b/feature_guides/data_encryption_methods.rst index c0aae030d..0069b161c 100644 --- a/feature_guides/data_encryption_methods.rst +++ b/feature_guides/data_encryption_methods.rst @@ -16,8 +16,11 @@ Encrypting Data in Transit For more information, see the following: * :ref:`copy_from` -* `JDBC `_ +* `JDBC `_ * :ref:`odbc` Encrypting Data at Rest ---------------- +For **data at rest,** housed physically on computer data, you can encrypt one or more column as needed according to your specifications. Data at rest is encrypted before being written into files, and decrypted after being read from them. All existing unencrypted historical and data inserted into this column at a later time is encrypted for the specified column values. Data at rest is encrypted (**Comment** - *And decrypted?*) using the **AES-256** algorithm. + +**Comment** - *Because the encryption keys are hidden from users, I didn't document them here. Please confirm that this is correct.* \ No newline at end of file diff --git a/feature_guides/data_encryption_process.rst b/feature_guides/data_encryption_process.rst new file mode 100644 index 000000000..e76e6a9cc --- /dev/null +++ b/feature_guides/data_encryption_process.rst @@ -0,0 +1,88 @@ +.. _data_encryption_process: + +*********************** +Data Encryption Process +*********************** +The **Data Encryption Process** page describes end-to-end encryption process, and describes the following: + +.. contents:: + :local: + :depth: 1 + +The Encryption Process +---------------- +The following describes the encryption process: + +1. A user with the required encryption execution permission accesses the system. + + :: + +#. In the file to be uploaded, the user selects columns to encrypt. The syntax will (**Comment** - *"should" instead of "will"?)* includes the hint that triggers the encryption (see syntax section). + + :: + +#. The user provides the location of the master key for deriving (**Comment** - *...generating/activating?*) the encryption in the remote repository. This applies to both **KMS** and **IBM SKLM**. + + :: + + **Comment** - *The source doc says, "this section will not be applied in the MVP scope." Should it stay in this doc?* + + :: + +#. The user trigger (**Comment** - *"runs"?*) the COPY command to transport the data upon TLS session (not yet data at rest encryption) (**Comment** - *"Upon TLS session = when the TLS session is activated?"* + + :: + +#. When the data is successfully inserted into the SQream database, it is encrypted and saved. + +For more information, see the following: + +* More information on permissions, see :ref:`data_encryption_permissions`. + + :: + +* More information on which columns to encrypt, see the :ref:`Constraints` section below. + + :: + +* More information on triggering the encryption, and the master key location syntax, see :ref:`data_encryption_syntax`. + +The Decryption Process +---------------- +The following describes the encryption process: + +1. A user with the required encryption execution permission accesses the system. + + :: + +#. The user indicates the decryption. **Comment** - *"Indicates" = "triggers"?*) + + :: + +#. The user can view the data derived from a table holding the encrypted data by decrypting the data by providing the location of the master key and selecting the required fields. + + :: + + **Comment** - *the source doc said, "this section will not be applied in the MVP scope." Should it stay in this doc?* + +#. When the statement has ended, the user can view the data in a human readable format as plain text. + +For more information on triggering the decryption, see :ref:`data_encryption_syntax`. + +Encrypted Columns +---------------- +**Comment** - *This section and "Constraints" don't really seem like phases in a flow, at least the way they are currently described. If they really are part of a flow, we should discuss how to reword them.* + +Tables with encrypted columns are tagged with the ``encrypted`` label, allowing you to select what data to encrypt. + +.. _constraints: + +Constraints +---------------- +The encryption will be done in the database server- data at rest as the data will be encrypted in transit based on the TLS protocol. + +**Comment** - *I need some clarification on the sentence above.* + +Users without permissions to view tables with one or more encrypted table cannot view the entire table. + +**Comment** - *Please confirm that the above sentence is correct. Below is the original sentence:"* \ No newline at end of file diff --git a/feature_guides/data_encryption_syntax.rst b/feature_guides/data_encryption_syntax.rst index 8df3e0d33..85cef25ee 100644 --- a/feature_guides/data_encryption_syntax.rst +++ b/feature_guides/data_encryption_syntax.rst @@ -3,13 +3,14 @@ *********************** Syntax *********************** - The **Syntax** page describes the following: .. contents:: :local: :depth: 1 - + +Encrypting a New Table +---------------- The following is the correct syntax for **encrypting** a new table: .. code-block:: console @@ -24,7 +25,11 @@ The following is an example of encrypting a new table: .. code-block:: console EXAMPLE - + +**Comment** - *Please provide an actual example.* + +Decrypting a New Table +---------------- The following is the correct syntax for **decrypting** a new table: .. code-block:: console @@ -37,8 +42,16 @@ The following is an example of decrypting a new table: EXAMPLE -Usage notes - this should be included on this page. +**Comment** - *Please provide an actual example.* + +Incorrectly Encrypting or Decrypting Your Data +---------------- +Using the incorrect master key or location while encrypting or decrypting generates an error. -When inputting the wrong master key/location in encryption/decryption an error should be raised to the user +**Comment** - *Can I get an example of this error to include in the doc?* + +**Comment** - *I thought that the master key was completely hidden from users... The internal doc says, "Master Key- the key will be generated within the server side, it will reside within a repository which will be hidden from the user."* + +In logs, master keys are masked to protect user privacy. Users are responsible for maintaining their master keys for the remote repository. -The master key needs to be masked in logs to protect user privacy, the responsibility maintaining the master key for the remote repository is on the user side \ No newline at end of file +**Comment** - *I'm not sure I fully understand the part about maintaing the master keys on the remote repository.* \ No newline at end of file diff --git a/feature_guides/data_encryption_types.rst b/feature_guides/data_encryption_types.rst index 331b14f58..3da9071c2 100644 --- a/feature_guides/data_encryption_types.rst +++ b/feature_guides/data_encryption_types.rst @@ -3,14 +3,12 @@ *********************** Data Types *********************** +SQream's data encryption supports the following data types: +* INT +* BIGINT +* TEXT -Per the research done and per customer requirement the data types that should be supported are the following: +Typically speaking, this data pertains to **PII (Personally Identifiable Information)**, which is sensitive information such as credit card numbers and other information related to an identifiable person. -Int - -BigInt - -String - -On most cases this data type, if encrypted, will be populated by PII value (Personal Identifiable Information) such as credit card number and other personal and sensitive information \ No newline at end of file +For more information on the above data types, see :ref:`supported_data_types`. \ No newline at end of file diff --git a/feature_guides/data_encryption_use_cases.rst b/feature_guides/data_encryption_use_cases.rst deleted file mode 100644 index 9e9ddeb4a..000000000 --- a/feature_guides/data_encryption_use_cases.rst +++ /dev/null @@ -1,14 +0,0 @@ -.. _data_encryption_use_cases: - -*********************** -Use Cases -*********************** - - - - - -Use Case Considerations -============== -Include the relevant content from this section in the correct places in this document. - From 0a20c1e28ca017b7fef582d9c4415fced9174a5a Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 24 Mar 2022 14:23:43 +0200 Subject: [PATCH 015/882] Create data_encryption_permissions.rst --- .../data_encryption_permissions.rst | 20 +++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 feature_guides/data_encryption_permissions.rst diff --git a/feature_guides/data_encryption_permissions.rst b/feature_guides/data_encryption_permissions.rst new file mode 100644 index 000000000..16f41dc70 --- /dev/null +++ b/feature_guides/data_encryption_permissions.rst @@ -0,0 +1,20 @@ +.. _data_encryption_permissions: + +*********************** +Permissions +*********************** +Users with the appropriate encryption permission privilege's can encrypt and decrypt data. + +**Comment** - *The rest of this content seems internal, correct?* + +Implementation notes + +one method to encrypt the data with is the TDE: Transparent data encryption which employed by Microsoft/IBM/Oracle etc. + +management. The requirement is that this will be programmatic via API. + +The centralized key management store should be one of the following (R&D to choose which one in accordance to easiness of deployment): + +KMS (AWS)- https://aws.amazon.com/kms/ + +IBM- IBM Security Guardium Key Lifecycle Manager - Overview \ No newline at end of file From f57d54e70fdf69de418df37c2c42dd0980657d62 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 24 Mar 2022 15:35:01 +0200 Subject: [PATCH 016/882] Update data_encryption_overview.rst --- feature_guides/data_encryption_overview.rst | 22 +++++++++++++++++++-- 1 file changed, 20 insertions(+), 2 deletions(-) diff --git a/feature_guides/data_encryption_overview.rst b/feature_guides/data_encryption_overview.rst index 5b3f3e344..4c0455291 100644 --- a/feature_guides/data_encryption_overview.rst +++ b/feature_guides/data_encryption_overview.rst @@ -3,8 +3,26 @@ *********************** Overview *********************** -**Data Encryption** helps protect sensitive data by preventing unauthorized users from reading it in the event of a breach. This is achieved by scrambling the content into an unreadable format based on encryption and decryption keys. +**Data Encryption** helps protect sensitive data by preventing unauthorized users from reading it in the event of a breach. This is achieved by scrambling the content into an unreadable format based on encryption and decryption keys. The demand for confidentiality has steadily increased to protect the growing volumes of private data stored on computer systems and transmitted over the internet. To this end, regulatory bodies such as the **General Data Protection Regulation (GDPR)** have produced requirements to standardize and enforce compliance aimed at protecting customer data. -The demand for confidentiality has steadily increased to protect the growing volumes of private data stored on computer systems and transmitted over the internet. To this end, regulatory bodies such as the **General Data Protection Regulation (GDPR)** have produced requirements to standardize and enforce compliance aimed at protecting customer data. +Encryption can be used for the following: + +* Deleting encrypted columns. + + :: + +* Creating tables with one or more encrypted columns. + + :: + +* Joining encrypted columns with other tables. + + :: + +* Encrypting existing data. + + :: + +* Selecting data from an encrypted column. For more information on GDPR compliance requirements, see the `GDPR checklist `_. \ No newline at end of file From a8098779ceca48b97315f701190cc24739e506f7 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 24 Mar 2022 15:50:56 +0200 Subject: [PATCH 017/882] Update data_encryption.rst --- feature_guides/data_encryption.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/feature_guides/data_encryption.rst b/feature_guides/data_encryption.rst index e8f919217..4e51a28aa 100644 --- a/feature_guides/data_encryption.rst +++ b/feature_guides/data_encryption.rst @@ -13,6 +13,6 @@ The **Data Encryption** page describes the following: data_encryption_overview data_encryption_methods data_encryption_types + data_encryption_process data_encryption_permissions - data_encryption_syntax - data_encryption_process \ No newline at end of file + data_encryption_syntax \ No newline at end of file From b673e26fc0d5bcb1aad12e5f207642cac08a1da5 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 24 Mar 2022 15:53:11 +0200 Subject: [PATCH 018/882] Update data_encryption.rst --- feature_guides/data_encryption.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/feature_guides/data_encryption.rst b/feature_guides/data_encryption.rst index e8f919217..4e51a28aa 100644 --- a/feature_guides/data_encryption.rst +++ b/feature_guides/data_encryption.rst @@ -13,6 +13,6 @@ The **Data Encryption** page describes the following: data_encryption_overview data_encryption_methods data_encryption_types + data_encryption_process data_encryption_permissions - data_encryption_syntax - data_encryption_process \ No newline at end of file + data_encryption_syntax \ No newline at end of file From 27b3f7eb1b3aec050bb828f88ef4d39fa3845fe6 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 27 Mar 2022 15:23:30 +0300 Subject: [PATCH 019/882] Added Missing Statements (2) CLUSTER BY and DROP CLUSTERING KEYS were missing from DDL table. --- .../aggregate_functions/index.rst | 38 +++++++++---------- .../sql_functions/scalar_functions/index.rst | 1 + reference/sql/sql_statements/index.rst | 4 ++ 3 files changed, 22 insertions(+), 21 deletions(-) diff --git a/reference/sql/sql_functions/aggregate_functions/index.rst b/reference/sql/sql_functions/aggregate_functions/index.rst index 9bf0527d6..5d3dfc125 100644 --- a/reference/sql/sql_functions/aggregate_functions/index.rst +++ b/reference/sql/sql_functions/aggregate_functions/index.rst @@ -6,31 +6,27 @@ Aggregate Functions Overview =========== - Aggregate functions perform calculations based on a set of values and return a single value. Most aggregate functions ignore null values. Aggregate functions are often used with the ``GROUP BY`` clause of the :ref:`select` statement. Available Aggregate Functions =============== The following list shows the available aggregate functions: - -.. toctree:: - :maxdepth: 1 - :glob: +.. hlist:: + :columns: 2 - - avg - corr - count - covar_pop - covar_samp - max - min - mode - percentile_cont - percentile_disc - stddev_pop - stddev_samp - sum - var_pop - var_samp + * :ref:`AVG` + * :ref:`CORR` + * :ref:`COUNT` + * :ref:`COVAR_POP` + * :ref:`COVAR_SAMP` + * :ref:`MAX` + * :ref:`MIN` + * :ref:`MODE` + * :ref:`PERCENTILE_CONT` + * :ref:`PERCENTILE_DISC` + * :ref:`STDDEV_POP` + * :ref:`STDDEV_SAMP` + * :ref:`SUM` + * :ref:`VAR_POP` + * :ref:`VAR_SAMP` \ No newline at end of file diff --git a/reference/sql/sql_functions/scalar_functions/index.rst b/reference/sql/sql_functions/scalar_functions/index.rst index 114d26cd6..b21071021 100644 --- a/reference/sql/sql_functions/scalar_functions/index.rst +++ b/reference/sql/sql_functions/scalar_functions/index.rst @@ -3,6 +3,7 @@ **************** Built-In Scalar Functions **************** +FF The **Built-In Scalar Functions** page describes functions that return one value per call: diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index 8ecd680df..28096f16a 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -24,6 +24,8 @@ Data Definition Commands (DDL) - Change the default schema for a role * - :ref:`ALTER TABLE` - Change the schema of a table + * - :ref:`CLUSTER BY` + - Change clustering keys in a table * - :ref:`CREATE DATABASE` - Create a new database * - :ref:`CREATE EXTERNAL TABLE` @@ -40,6 +42,8 @@ Data Definition Commands (DDL) - Create a new table in the database using results from a select query * - :ref:`CREATE VIEW` - Create a new view in the database + * - :ref:`DROP CLUSTERING KEY` + - Drops all clustering keys in a table * - :ref:`DROP COLUMN` - Drop a column from a table * - :ref:`DROP DATABASE` From 85f8481db98e14ea9d1fddb8f75c438a7db22540 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 27 Mar 2022 16:02:44 +0300 Subject: [PATCH 020/882] Deleted DDL Files (backed up) Tried method of removing the statements from topic menu, and linking directly to them. The list in topic menu was too long. --- .../ddl_commands/add_column.rst | 91 ------ .../ddl_commands/alter_default_schema.rst | 58 ---- .../ddl_commands/alter_table.rst | 33 --- .../ddl_commands/cluster_by.rst | 69 ----- .../ddl_commands/create_database.rst | 55 ---- .../ddl_commands/create_external_table.rst | 156 ---------- .../ddl_commands/create_foreign_table.rst | 165 ----------- .../ddl_commands/create_function.rst | 103 ------- .../ddl_commands/create_schema.rst | 92 ------ .../ddl_commands/create_table.rst | 278 ------------------ .../ddl_commands/create_table_as.rst | 96 ------ .../ddl_commands/create_view.rst | 79 ----- .../ddl_commands/drop_clustering_key.rst | 64 ---- .../ddl_commands/drop_column.rst | 63 ---- .../ddl_commands/drop_database.rst | 63 ---- .../ddl_commands/drop_function.rst | 66 ----- .../ddl_commands/drop_schema.rst | 77 ----- .../ddl_commands/drop_table.rst | 70 ----- .../sql_statements/ddl_commands/drop_view.rst | 72 ----- .../ddl_commands/rename_column.rst | 65 ---- .../ddl_commands/rename_table.rst | 57 ---- reference/sql/sql_statements/index.rst | 84 +++--- 22 files changed, 42 insertions(+), 1914 deletions(-) delete mode 100644 reference/sql/sql_statements/ddl_commands/add_column.rst delete mode 100644 reference/sql/sql_statements/ddl_commands/alter_default_schema.rst delete mode 100644 reference/sql/sql_statements/ddl_commands/alter_table.rst delete mode 100644 reference/sql/sql_statements/ddl_commands/cluster_by.rst delete mode 100644 reference/sql/sql_statements/ddl_commands/create_database.rst delete mode 100644 reference/sql/sql_statements/ddl_commands/create_external_table.rst delete mode 100644 reference/sql/sql_statements/ddl_commands/create_foreign_table.rst delete mode 100644 reference/sql/sql_statements/ddl_commands/create_function.rst delete mode 100644 reference/sql/sql_statements/ddl_commands/create_schema.rst delete mode 100644 reference/sql/sql_statements/ddl_commands/create_table.rst delete mode 100644 reference/sql/sql_statements/ddl_commands/create_table_as.rst delete mode 100644 reference/sql/sql_statements/ddl_commands/create_view.rst delete mode 100644 reference/sql/sql_statements/ddl_commands/drop_clustering_key.rst delete mode 100644 reference/sql/sql_statements/ddl_commands/drop_column.rst delete mode 100644 reference/sql/sql_statements/ddl_commands/drop_database.rst delete mode 100644 reference/sql/sql_statements/ddl_commands/drop_function.rst delete mode 100644 reference/sql/sql_statements/ddl_commands/drop_schema.rst delete mode 100644 reference/sql/sql_statements/ddl_commands/drop_table.rst delete mode 100644 reference/sql/sql_statements/ddl_commands/drop_view.rst delete mode 100644 reference/sql/sql_statements/ddl_commands/rename_column.rst delete mode 100644 reference/sql/sql_statements/ddl_commands/rename_table.rst diff --git a/reference/sql/sql_statements/ddl_commands/add_column.rst b/reference/sql/sql_statements/ddl_commands/add_column.rst deleted file mode 100644 index d532c956f..000000000 --- a/reference/sql/sql_statements/ddl_commands/add_column.rst +++ /dev/null @@ -1,91 +0,0 @@ -.. _add_column: - -********************** -ADD COLUMN -********************** - -The ``ADD COLUMN`` command is used to add columns to an existing table. - - - -Syntax -========== -The following is the correct syntax for adding a table: - -.. code-block:: postgres - - alter_table_add_column_statement ::= - ALTER TABLE [schema_name.]table_name { ADD COLUMN column_def [, ...] } - ; - - table_name ::= identifier - - schema_name ::= identifier - - column_def :: = { column_name type_name [ default ] [ column_constraint ] } - - column_name ::= identifier - - column_constraint ::= - { NOT NULL | NULL } - - default ::= - DEFAULT default_value - - - -Parameters -============ -The following parameters can be used for adding a table: - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``schema_name`` - - The schema name for the table. Defaults to ``public`` if not specified. - * - ``table_name`` - - The table name to apply the change to. - * - ``ADD COLUMN column_def`` - - A comma separated list of ADD COLUMN commands - * - ``column_def`` - - A column definition. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally. - -.. note:: - * When adding a new column to an existing table, a default (or null constraint) has to be specified, even if the table is empty. - * A new column added to the table can not contain an IDENTITY or be of the TEXT type. - - -Permissions -============= -The role must have the ``DDL`` permission at the database or table level. - -Examples -=========== -This section includes the following examples: - -.. contents:: - :local: - :depth: 1 - -Adding a Simple Column with a Default Value ------------------------------------------ -This example shows how to add a simple column with a default value: - -.. code-block:: postgres - - ALTER TABLE cool_animals - ADD COLUMN number_of_eyes INT DEFAULT 2 NOT NULL; - - -Adding Several Columns in One Command -------------------------------------------- -This example shows how to add several columns in one command: - -.. code-block:: postgres - - ALTER TABLE cool_animals - ADD COLUMN number_of_eyes INT DEFAULT 2 NOT NULL, - ADD COLUMN date_seen DATE DEFAULT '2019-08-01'; diff --git a/reference/sql/sql_statements/ddl_commands/alter_default_schema.rst b/reference/sql/sql_statements/ddl_commands/alter_default_schema.rst deleted file mode 100644 index e40a8af7c..000000000 --- a/reference/sql/sql_statements/ddl_commands/alter_default_schema.rst +++ /dev/null @@ -1,58 +0,0 @@ -.. _alter_default_schema: - -********************** -ALTER DEFAULT SCHEMA -********************** - -The ``ALTER DEFAULT SCHEMA`` command can be used to change a role's default schema. The default schema in SQream is ``public``. - -For more information, see :ref:`create_schema` and :ref:`drop_schema`. - - - -Syntax -========== -The following is the correct syntax for altering a default schema: - -.. code-block:: postgres - - alter_default_schema_statement ::= - ALTER DEFAULT SCHEMA FOR role_name TO schema_name - ; - - role_name ::= identifier - - schema_name ::= identifier - - - -Parameters -============ -The following parameters can be used when altering a default schema: - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``role_name`` - - The name of the role the change will apply to. - * - ``schema_name`` - - The new default schema name. - -Permissions -============= -No special permissions are required. - -Examples -=========== -This section includes an example of **altering the default schema for a role**: - -.. code-block:: postgres - - SELECT * FROM users; -- Refers to public.users - - ALTER DEFAULT SCHEMA FOR bgilfoyle TO staging; - - SELECT * FROM users; -- Now refers to staging.users, rather than public.users diff --git a/reference/sql/sql_statements/ddl_commands/alter_table.rst b/reference/sql/sql_statements/ddl_commands/alter_table.rst deleted file mode 100644 index 6afb84be1..000000000 --- a/reference/sql/sql_statements/ddl_commands/alter_table.rst +++ /dev/null @@ -1,33 +0,0 @@ -.. _alter_table: - -********************** -ALTER TABLE -********************** -You can use the ``ALTER TABLE`` command to make schema changes to a table, and can be used in conjunction with several sub-commands. - -Locks -======= -Making changes to a schema makes an exclusive lock on tables. While these operations do not typically take much time, other statements may have to wait until the schema changes are completed. - -Sub-Commands -============== -The following table shows the sub-commands that can be used with the ``ALTER TABLE`` command: - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Command - - Usage - * - :ref:`ADD COLUMN` - - Adds a new column to a table. - * - :ref:`DROP COLUMN` - - Drops a column from a table. - * - :ref:`RENAME COLUMN` - - Renames a column. - * - :ref:`RENAME TABLE` - - Renames a table. - * - :ref:`CLUSTER BY` - - Modifies (adds or reorders) the clustering keys in a table. - * - :ref:`DROP CLUSTERING KEY` - - Drops all clustering keys. diff --git a/reference/sql/sql_statements/ddl_commands/cluster_by.rst b/reference/sql/sql_statements/ddl_commands/cluster_by.rst deleted file mode 100644 index 1a6972b1e..000000000 --- a/reference/sql/sql_statements/ddl_commands/cluster_by.rst +++ /dev/null @@ -1,69 +0,0 @@ -.. _cluster_by: - -********************** -CLUSTER BY -********************** - -``CLUSTER BY`` can be used to change clustering keys in a table. - - -Read our :ref:`data_clustering` guide for more information. - -See also: :ref:`drop_clustering_key`, :ref:`create_table`. - - -Permissions -============= - -The role must have the ``DDL`` permission at the database or table level. - -Syntax -========== - -.. code-block:: postgres - - alter_table_rename_table_statement ::= - ALTER TABLE [schema_name.]table_name CLUSTER BY column_name [, ...] - ; - - table_name ::= identifier - - column_name ::= identifier - - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``schema_name`` - - The schema name for the table. Defaults to ``public`` if not specified. - * - ``table_name`` - - The table name to apply the change to. - * - ``column_name [, ... ]`` - - Comma separated list of columns to create clustering keys for - - -Usage notes -================= - -Removing clustering keys does not affect existing data. - -To force data to re-cluster, the table has to be recreated (i.e. with :ref:`create_table_as`). - - -Examples -=========== - -Reclustering a table ------------------------------------------ - -.. code-block:: postgres - - ALTER TABLE public.users CLUSTER BY start_date; - - diff --git a/reference/sql/sql_statements/ddl_commands/create_database.rst b/reference/sql/sql_statements/ddl_commands/create_database.rst deleted file mode 100644 index db7ffda3f..000000000 --- a/reference/sql/sql_statements/ddl_commands/create_database.rst +++ /dev/null @@ -1,55 +0,0 @@ -.. _create_database: - -***************** -CREATE DATABASE -***************** - -``CREATE DATABASE`` creates a new database in SQream DB - -Permissions -============= - -Only a superuser can create a new database - -Syntax -========== - -.. code-block:: postgres - - create_database_statement ::= - - CREATE DATABASE database_name ; - - database_name ::= identifier - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``database_name`` - - The name of the database name. The database name must be unique, and follows :ref:`Identifier rules ` - -Examples -=========== - -.. code-block:: postgres - - CREATE DATABASE raviga; - -.. code-block:: postgres - - CREATE DATABASE my_db; - -If the database already exists, an error will appear: - -.. code-block:: psql - - master=> CREATE DATABASE MY_DB; - Database 'my_db' already exists - -.. note:: SQream DB :ref:`identifiers ` are always converted to lowercase, so ``my_db`` is the same as ``MY_DB``, unless explicitly quoted as ``"MY_DB"``. \ No newline at end of file diff --git a/reference/sql/sql_statements/ddl_commands/create_external_table.rst b/reference/sql/sql_statements/ddl_commands/create_external_table.rst deleted file mode 100644 index fc05ca71e..000000000 --- a/reference/sql/sql_statements/ddl_commands/create_external_table.rst +++ /dev/null @@ -1,156 +0,0 @@ -.. _create_external_table: - -*********************** -CREATE EXTERNAL TABLE -*********************** - -.. warning:: - - The ``CREATE EXTERNAL TABLE`` syntax is deprecated, and will be removed in future versions. - - Starting with SQream DB v2020.2, external tables have been renamed to :ref:`foreign tables`, and use a more flexible foreign data wrapper concept. See :ref:`create_foreign_table` instead. - - Upgrading to a new version of SQream DB converts existing tables automatically. When creating a new external tables, use the new foreign table syntax. - - -``CREATE TABLE`` creates a new external table in an existing database. - -See more in the :ref:`External tables guide`. - -.. tip:: - - * Data in an external table can change if the sources change, and frequent access to remote files may harm performance. - - * To create a regular table, see :ref:`CREATE TABLE ` - -Permissions -============= - -The role must have the ``CREATE`` permission at the database level. - -Syntax -========== - -.. code-block:: postgres - - create_table_statement ::= - CREATE [ OR REPLACE ] EXTERNAL TABLE [schema_name].table_name ( - { column_def [, ...] } - ) - USING FORMAT format_def - WITH { external_table_option [ ...] } - ; - - schema_name ::= identifier - - table_name ::= identifier - - format_def ::= { PARQUET | ORC | CSV } - - external_table_option ::= { - PATH '{ path_spec }' - | FIELD DELIMITER '{ field_delimiter }' - | RECORD DELIMITER '{ record_delimiter }' - | AWS_ID '{ AWS ID }' - | AWS_SECRET '{ AWS SECRET }' - } - - path_spec ::= { local filepath | S3 URI | HDFS URI } - - field_delimiter ::= delimiter_character - - record_delimiter ::= delimiter_character - - column_def ::= { column_name type_name [ default ] [ column_constraint ] } - - column_name ::= identifier - - column_constraint ::= - { NOT NULL | NULL } - - default ::= - - DEFAULT default_value - | IDENTITY [ ( start_with [ , increment_by ] ) ] - -.. _cet_parameters: - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``OR REPLACE`` - - Create a new table, and overwrite any existing table by the same name. Does not return an error if the table already exists. ``CREATE OR REPLACE`` does not check the table contents or structure, only the table name. - * - ``schema_name`` - - The name of the schema in which to create the table. - * - ``table_name`` - - The name of the table to create, which must be unique inside the schema. - * - ``column_def`` - - A comma separated list of column definitions. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally. - * - ``USING FORMAT ...`` - - Specifies the format of the source files, such as ``PARQUET``, ``ORC``, or ``CSV``. - * - ``WITH PATH ...`` - - Specifies a path or URI of the source files, such as ``/path/to/*.parquet``. - * - ``FIELD DELIMITER`` - - Specifies the field delimiter for CSV files. Defaults to ``,``. - * - ``RECORD DELIMITER`` - - Specifies the record delimiter for CSV files. Defaults to a newline, ``\n`` - * - ``AWS_ID``, ``AWS_SECRET`` - - Credentials for authenticated S3 access - - -Examples -=========== - -A simple table from Tab-delimited file (TSV) ----------------------------------------------- - -.. code-block:: postgres - - CREATE OR REPLACE EXTERNAL TABLE cool_animals - (id INT NOT NULL, name VARCHAR(30) NOT NULL, weight FLOAT NOT NULL) - USING FORMAT csv - WITH PATH '/home/rhendricks/cool_animals.csv' - FIELD DELIMITER '\t'; - - -A table from a directory of Parquet files on HDFS ------------------------------------------------------ - -.. code-block:: postgres - - CREATE EXTERNAL TABLE users - (id INT NOT NULL, name VARCHAR(30) NOT NULL, email VARCHAR(50) NOT NULL) - USING FORMAT Parquet - WITH PATH 'hdfs://hadoop-nn.piedpiper.com/rhendricks/users/*.parquet'; - -A table from a bucket of files on S3 --------------------------------------- - -.. code-block:: postgres - - CREATE EXTERNAL TABLE users - (id INT NOT NULL, name VARCHAR(30) NOT NULL, email VARCHAR(50) NOT NULL) - USING FORMAT Parquet - WITH PATH 's3://pp-secret-bucket/users/*.parquet' - AWS_ID 'our_aws_id' - AWS_SECRET 'our_aws_secret'; - - -Changing an external table to a regular table ------------------------------------------------- - -Materializes an external table into a regular table. - -.. tip: Using an external table allows you to perform ETL-like operations in SQream DB by applying SQL functions and operations to raw files - -.. code-block:: postgres - - CREATE TABLE real_table - AS SELECT * FROM external_table; - diff --git a/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst b/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst deleted file mode 100644 index d50e13380..000000000 --- a/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst +++ /dev/null @@ -1,165 +0,0 @@ -.. _create_foreign_table: - -*********************** -CREATE FOREIGN TABLE -*********************** - -.. note:: - - Starting with SQream DB v2020.2, external tables have been renamed to foreign tables, and use a more flexible foreign data wrapper concept. - - Upgrading to a new version of SQream DB converts existing external tables automatically. - - -``CREATE FOREIGN TABLE`` creates a new foreign table in an existing database. - -See more in the :ref:`Foreign tables guide`. - -.. tip:: - - * Data in a foreign table can change if the sources change, and frequent access to remote files may harm performance. - - * To create a regular table, see :ref:`CREATE TABLE ` - -Permissions -============= - -The role must have the ``CREATE`` permission at the database level. - -Syntax -========== - -.. code-block:: postgres - - create_table_statement ::= - CREATE [ OR REPLACE ] FOREIGN TABLE [schema_name].table_name ( - { column_def [, ...] } - ) - [ FOREIGN DATA ] WRAPPER fdw_name - [ OPTIONS ( option_def [, ... ] ) ] - ; - - schema_name ::= identifier - - table_name ::= identifier - - fdw_name ::= - { csv_fdw | orc_fdw | parquet_fdw } - - option_def ::= - { - LOCATION = '{ path_spec }' - | DELIMITER = '{ field_delimiter }' -- for CSV only - | RECORD_DELIMITER = '{ record_delimiter }' -- for CSV only - | AWS_ID '{ AWS ID }' - | AWS_SECRET '{ AWS SECRET }' - } - - path_spec ::= { local filepath | S3 URI | HDFS URI } - - field_delimiter ::= delimiter_character - - record_delimiter ::= delimiter_character - - column_def ::= - { column_name type_name [ default ] [ column_constraint ] } - - column_name ::= identifier - - column_constraint ::= - { NOT NULL | NULL } - - default ::= - DEFAULT default_value - | IDENTITY [ ( start_with [ , increment_by ] ) ] - -.. _cft_parameters: - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``OR REPLACE`` - - Create a new table, and overwrite any existing table by the same name. Does not return an error if the table already exists. ``CREATE OR REPLACE`` does not check the table contents or structure, only the table name. - * - ``schema_name`` - - The name of the schema in which to create the table. - * - ``table_name`` - - The name of the table to create, which must be unique inside the schema. - * - ``column_def`` - - A comma separated list of column definitions. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally. - * - ``WRAPPER ...`` - - Specifies the format of the source files, such as ``parquet_fdw``, ``orc_fdw``, or ``csv_fdw``. - * - ``LOCATION = ...`` - - Specifies a path or URI of the source files, such as ``/path/to/*.parquet``. - * - ``DELIMITER = ...`` - - Specifies the field delimiter for CSV files. Defaults to ``,``. - * - ``RECORD_DELIMITER = ...`` - - Specifies the record delimiter for CSV files. Defaults to a newline, ``\n`` - * - ``AWS_ID``, ``AWS_SECRET`` - - Credentials for authenticated S3 access - - -Examples -=========== - -A simple table from Tab-delimited file (TSV) ----------------------------------------------- - -.. code-block:: postgres - - CREATE OR REPLACE FOREIGN TABLE cool_animals - (id INT NOT NULL, name VARCHAR(30) NOT NULL, weight FLOAT NOT NULL) - WRAPPER csv_fdw - OPTIONS - ( LOCATION = '/home/rhendricks/cool_animals.csv', - DELIMITER = '\t' - ) - ; - - -A table from a directory of Parquet files on HDFS ------------------------------------------------------ - -.. code-block:: postgres - - CREATE FOREIGN TABLE users - (id INT NOT NULL, name VARCHAR(30) NOT NULL, email VARCHAR(50) NOT NULL) - WRAPPER parquet_fdw - OPTIONS - ( - LOCATION = 'hdfs://hadoop-nn.piedpiper.com/rhendricks/users/*.parquet' - ); - -A table from a bucket of ORC files on S3 ------------------------------------------- - -.. code-block:: postgres - - CREATE FOREIGN TABLE users - (id INT NOT NULL, name VARCHAR(30) NOT NULL, email VARCHAR(50) NOT NULL) - WRAPPER orc_fdw - OPTIONS - ( - LOCATION = 's3://pp-secret-bucket/users/*.orc', - AWS_ID = 'our_aws_id', - AWS_SECRET = 'our_aws_secret' - ); - - -Changing a foreign table to a regular table ------------------------------------------------- - -Materializes a foreign table into a regular table. - -.. tip: Using a foreign table allows you to perform ETL-like operations in SQream DB by applying SQL functions and operations to raw files - -.. code-block:: postgres - - CREATE TABLE real_table - AS SELECT * FROM some_foreign_table; - diff --git a/reference/sql/sql_statements/ddl_commands/create_function.rst b/reference/sql/sql_statements/ddl_commands/create_function.rst deleted file mode 100644 index 339543a0a..000000000 --- a/reference/sql/sql_statements/ddl_commands/create_function.rst +++ /dev/null @@ -1,103 +0,0 @@ -.. _create_function: - -***************** -CREATE FUNCTION -***************** - -``CREATE FUNCTION`` creates a new user-defined function (UDF) in an existing database. - -See more in our :ref:`Python UDF (user-defined functions)` guide. - -Permissions -============= - -The role must have the ``CREATE FUNCTION`` permission at the database level. - -Syntax -========== - -.. code-block:: postgres - - create_function_statement ::= - CREATE [ OR REPLACE ] FUNCTION function_name (argument_list) - RETURNS return_type - AS $$ - { function_body } - $$ LANGUAGE python - ; - - function_name ::= identifier - - argument_list :: = { value_name type_name [, ...] } - - value_name ::= identifier - - return_type ::= type_name - - function_body ::= Valid Python code - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``OR REPLACE`` - - Create a new function, and overwrite any existing function by the same name. Does not return an error if the function already exists. ``CREATE OR REPLACE`` does not check the function contents or structure, only the function name. - * - ``function_name`` - - The name of the function to create, which must be unique inside the database. - * - ``argument_list`` - - A comma separated list of column definitions. A column definition includes a name identifier and a datatype. - * - ``return_type`` - - The SQL datatype of the return value, such as ``INT``, ``VARCHAR``, etc. - * - ``function_body`` - - Python code, dollar-quoted (``$$``). - -Examples -=========== - -Calculate distance between two points --------------------------------------- - -.. code-block:: postgres - - CREATE OR REPLACE FUNCTION my_distance (x1 float, y1 float, x2 float, y2 float) - RETURNS FLOAT - AS $$ - import math - if y1 < x1: - return 0.0 - else: - return math.sqrt((y2 - y1) ** 2 + (x2 - x1) ** 2) - $$ LANGUAGE PYTHON; - - -- Usage: - SELECT city, my_location, my_distance(x1,y1,x2,y2) from cities; - - -Calling files from other locations ---------------------------------------- - -.. code-block:: postgres - - -- Our script my_code.py is in ~/my_python_stuff - - CREATE FUNCTION write_log() - RETURNS INT - AS $$ - import sys - sys.path.append("/home/user/my_python_stuff") - - import my_code as f - - f.main() - - return 1 - - $$ LANGUAGE PYTHON; - - -- Usage: - SELECT write_log(); diff --git a/reference/sql/sql_statements/ddl_commands/create_schema.rst b/reference/sql/sql_statements/ddl_commands/create_schema.rst deleted file mode 100644 index e85f328a9..000000000 --- a/reference/sql/sql_statements/ddl_commands/create_schema.rst +++ /dev/null @@ -1,92 +0,0 @@ -.. _create_schema: - -***************** -CREATE SCHEMA -***************** -The **CREATE SCHEMA** page describes the following: - - -.. contents:: - :local: - :depth: 2 - -Overview -============ - -``CREATE SCHEMA`` creates a new schema in an existing database. A schema is a virtual space for storing tables. - -The default schema in SQream DB is ``public``. - -.. tip:: Use schemas to separate between use-cases, such as staging and production. - -The **CREATE SCHEMA** statement can be used to query tables from different schemas without providing an alias, as in the following example: - -.. code-block:: postgres - - select .table_name.column_name from .table_name - -See also: :ref:`drop_schema`, :ref:`alter_default_schema`. - -Permissions -============= - -The role must have the ``CREATE`` permission at the database level. - -Syntax -========== -The following example shows the correct syntax for creating a schema: - -.. code-block:: postgres - - create_schema_statement ::= - CREATE SCHEMA schema_name - ; - - schema_name ::= identifier - - -Parameters -============ -The following table shows the ``schema_name`` parameters: - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``schema_name`` - - The name of the schema to create. - -Examples -=========== -This section includes the following examples: - -.. contents:: - :local: - :depth: 1 - - -Creating a Schema --------------------- -The following example shows an example of the syntax for creating a schema: - -.. code-block:: postgres - - CREATE SCHEMA staging; - - CREATE TABLE staging.users AS SELECT * FROM public.users; - - SELECT * FROM staging.users; - -Altering the Default Schema for a Role ------------------------------------------ -The following example shows an example of the syntax for altering the default schema for a role: - -.. code-block:: postgres - - SELECT * FROM users; -- Refers to public.users - - ALTER DEFAULT SCHEMA FOR bgilfoyle TO staging; - - SELECT * FROM users; -- Now refers to staging.users, rather than public.users diff --git a/reference/sql/sql_statements/ddl_commands/create_table.rst b/reference/sql/sql_statements/ddl_commands/create_table.rst deleted file mode 100644 index b660e442c..000000000 --- a/reference/sql/sql_statements/ddl_commands/create_table.rst +++ /dev/null @@ -1,278 +0,0 @@ -.. _create_table: - -***************** -CREATE TABLE -***************** - -The ``CREATE TABLE`` statement is used to create a new table in an existing database. - -.. tip:: - * To create a table based on the result of a select query, see :ref:`CREATE TABLE AS `. - * To create a table based on files like Parquet and ORC, see :ref:`CREATE FOREIGN TABLE ` - - - -Syntax -========== -The following is the correct syntax for creating a table: - -.. code-block:: postgres - - create_table_statement ::= - CREATE [ OR REPLACE ] TABLE [schema_name.]table_name ( - { column_def [, ...] } - ) - [ CLUSTER BY { column_name [, ...] } ] - ; - - schema_name ::= identifier - - table_name ::= identifier - - column_def :: = { column_name type_name [ default ] [ column_constraint ] } - - column_name ::= identifier - - column_constraint ::= - { NOT NULL | NULL } - - default ::= - DEFAULT default_value - | IDENTITY [ ( start_with [ , increment_by ] ) ] - -Parameters -============ -The following parameters can be used when creating a table: - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``OR REPLACE`` - - Creates a new tables and overwrites any existing table by the same name. Does not return an error if the table already exists. ``CREATE OR REPLACE`` does not check the table contents or structure, only the table name. - * - ``schema_name`` - - The name of the schema in which to create the table. - * - ``table_name`` - - The name of the table to create, which must be unique inside the schema. - * - ``column_def`` - - A comma separated list of column definitions. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally. - * - ``CLUSTER BY column_name1 ...`` - - - A commma separated list of clustering column keys. - - See :ref:`data_clustering` for more information. - * - ``LIKE`` - - Duplicates the column structure of an existing table. - - -.. _default_values: - -Default Value Constraints -=============== - -The ``DEFAULT`` value constraint specifies a value to use if one is not defined in an :ref:`insert` or :ref:`copy_from` statement. - -The value may be either a literal or **GETDATE()**, which is evaluated at the time the row is created. - -.. note:: The ``DEFAULT`` constraint only applies if the column does not have a value specified in the :ref:`insert` or :ref:`copy_from` statement. You can still insert a ``NULL`` into an nullable column by explicitly inserting ``NULL``. For example, ``INSERT INTO cool_animals VALUES (1, 'Gnu', NULL)``. - -Syntax ---------- -The following is the correct syntax for using the **DEFAULT** value constraints: - - -.. code-block:: postgres - - column_def :: = { column_name type_name [ default ] [ column_constraint ] } - - column_constraint ::= - { NOT NULL | NULL } - - default ::= - DEFAULT default_value - | IDENTITY [ ( start_with [ , increment_by ] ) ] - - check_specification ::= - CHECK( 'CS compression_spec' ) - - compression_spec ::= - { "default" | "p4d" | "dict" | "rle" | "sequence" | "flat" } - - -.. _identity: - -Identity ------------------------ -The ``Identity`` (or sequence) columns can be used for generating key values. Some databases call this ``AUTOINCREMENT``. - -The **identity** property on a column guarantees that each new row inserted is generated based on the current seed & increment. - -.. warning:: - The identity property on a column does not guarantee uniqueness. The identity value can be bypassed by specifying it in an :ref:`insert` command. - -The following table describes the identity parameters: - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``start_with`` - - A value that is used for the very first row loaded into the table. - * - ``increment_by`` - - Incremental value that is added to the identity value of the previous row that was loaded. - -Examples -=========== -This section includes the following examples: - -.. contents:: - :local: - :depth: 1 - -Creating a Standard Table ------------------ -The following is an example of the syntax used to create a standard table: - -.. code-block:: postgres - - CREATE TABLE cool_animals ( - id INT NOT NULL, - name varchar(30) NOT NULL, - weight FLOAT, - is_agressive BOOL - ); - -Creating a Table with Default Value Constraints for Some Columns ---------------------------------------------------- -The following is an example of the syntax used to create a table with default value constraints for some columns: - - -.. code-block:: postgres - - CREATE TABLE cool_animals ( - id INT NOT NULL, - name varchar(30) NOT NULL, - weight FLOAT, - is_agressive BOOL DEFAULT false NOT NULL - ); - -.. note:: The nullable/non-nullable constraint appears at the end, after the default option - -Creating a Table with an Identity Column ---------------------------------------------------- -The following is an example of the syntax used to create a table with an identity (auto-increment) column: - - -.. code-block:: postgres - - CREATE TABLE users ( - id BIGINT IDENTITY(0,1) NOT NULL , -- Start with 0, increment by 1 - name VARCHAR(30) NOT NULL, - country VARCHAR(30) DEFAULT 'Unknown' NOT NULL - ); - -.. note:: - * Identity columns are supported on ``BIGINT`` columns. - - * Identity does not enforce the uniqueness of values. The identity value can be bypassed by specifying it in an :ref:`insert` command. - -Creating a Table from a SELECT Query ------------------------------------------ -The following is an example of the syntax used to create a table from a SELECT query: - -.. code-block:: postgres - - CREATE TABLE users_uk AS SELECT * FROM users WHERE country = 'United Kingdom'; - -For more information on creating a new table from the results of a SELECT query, see :ref:`CREATE TABLE AS `. - -Creating a Table with a Clustering Key ----------------------------------------------- -When data in a table is stored in a sorted order, the sorted columns are considered clustered. Good clustering can have a significant positive impact on performance. - -In the following example, we expect the ``start_date`` column to be naturally clustered, as new users sign up and get a newer start date. - -When the clustering key is set, if the incoming data isn’t naturally clustered, it will be clustered by SQream DB during insert or bulk load. - -The following is an example of the syntax used to create a table with a clustering key: - -.. code-block:: postgres - - CREATE TABLE users ( - name VARCHAR(30) NOT NULL, - start_date datetime not null, - country VARCHAR(30) DEFAULT 'Unknown' NOT NULL - ) CLUSTER BY start_date; - -For more information on data clustering, see :ref:`data_clustering`. - -Duplicating the Column Structure of an Existing Table ------------------ - -Syntax -************ -The following is the correct syntax for duplicating the column structure of an existing table: - -.. code-block:: postgres - - CREATE [OR REPLACE] TABLE table_name - { - (column_name column_type [{NULL | NOT NULL}] [,...]) - | LIKE source_table_name - } - [CLUSTER BY ...] - ; - -Examples -************** -This section includes the following examples of duplicating the column structure of an existing table using the ``LIKE`` clause: - -.. contents:: - :local: - :depth: 3 - -Creating a Table Using an Explicit Column List -~~~~~~~~~~~~ -The following is an example of creating a table using an explict column list: - -.. code-block:: postgres - - CREATE TABLE t1(x int default 0 not null, y text(10) null); - -Creating a Second Table Based on the Structure of Another Table -~~~~~~~~~~~~ -Either of the following examples can be used to create a second table based on the structure of another table. - -**Example 1** - -.. code-block:: postgres - - CREATE TABLE t2 LIKE t1; - -**Example 2** - -.. code-block:: postgres - - CREATE TABLE t2(x int default 0 not null, y text(10) null); - -The generated output of both of the statements above is identical. - -Creating a Table based on External Tables and Views -~~~~~~~~~~~~ -The following is example of creating a table based on external tables and views: - - -.. code-block:: postgres - - CREATE VIEW v as SELECT x+1,y,y || 'abc' from t1; - CREATE TABLE t3 LIKE v; - -When duplicating the column structure of an existing table, the target table of the ``LIKE`` clause can be a regular or an external table, or a view. - -Permissions -============= -The role must have the ``CREATE`` permission at the schema level. diff --git a/reference/sql/sql_statements/ddl_commands/create_table_as.rst b/reference/sql/sql_statements/ddl_commands/create_table_as.rst deleted file mode 100644 index a7f9dd4d4..000000000 --- a/reference/sql/sql_statements/ddl_commands/create_table_as.rst +++ /dev/null @@ -1,96 +0,0 @@ -.. _create_table_as: - -***************** -CREATE TABLE AS -***************** - -The ``CREATE TABLE AS`` commands creates a new table from the result of a select query. - - -Syntax -========== -The following is the correct syntax for creating a table from the result of a select query: - - -.. CREATE [ OR REPLACE ] TABLE [schema_name].table_name ( -.. { column_def [, ...] } -.. ) AS query - -.. code-block:: postgres - - create_table_statement ::= - CREATE [ OR REPLACE ] TABLE [schema_name].table_name AS query - ; - - schema_name ::= identifier - - table_name ::= identifier - - -.. _ctas_params: - -Parameters -============ -The following parameters can be used when creating a table from the result of a select query: - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``OR REPLACE`` - - Create a new table, and overwrite any existing table by the same name. Does not return an error if the table already exists. ``CREATE OR REPLACE`` does not check the table contents or structure, only the table name. - * - ``schema_name`` - - The name of the schema in which to create the table. - * - ``table_name`` - - The name of the table to create, which must be unique inside the schema. - * - ``query`` - - A select query that returns data - -.. * - ``column_def`` -.. - A comma separated list of column definitions. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally. - -Permissions -============= -The role must have the ``CREATE`` permission at the schema level, as well as ``SELECT`` permissions for any tables referenced by the statement. - - -Examples -=========== -This section includes the following examples: - -.. contents:: - :local: - :depth: 1 - -Creating a Copy of a Foreign Table or View ---------------------------------------------------------------------------- - -.. code-block:: postgres - - CREATE TABLE users AS SELECT * FROM users_source; - -For more information, see :ref:`CREATE FOREIGN TABLE `. - -Filtering ------------- - -.. code-block:: postgres - - CREATE TABLE users_uk AS SELECT * FROM users WHERE country = 'United Kingdom'; - -Adding Columns ------------------------ - -.. code-block:: postgres - - CREATE TABLE users_uk_new AS SELECT GETDATE() as "Date",*,false as is_new FROM users_uk; - -Creating a Table From Values ------------------------------------------ - -.. code-block:: postgres - - CREATE TABLE new_users - AS VALUES(GETDATE(),'Richard','Foxworthy','1984-03-03',True) diff --git a/reference/sql/sql_statements/ddl_commands/create_view.rst b/reference/sql/sql_statements/ddl_commands/create_view.rst deleted file mode 100644 index 9812ddeec..000000000 --- a/reference/sql/sql_statements/ddl_commands/create_view.rst +++ /dev/null @@ -1,79 +0,0 @@ -.. _create_view: - -***************** -CREATE VIEW -***************** - -``CREATE VIEW`` creates a new view in an existing database. A view is a virtual table. - -.. tip:: - * Use views to simplify complex queries or present only partial data to specific roles. - * If an underlying table has changed (new columns, changed names, etc.) - a view may be invalidated. To recompile the view, see :ref:`SELECT RECOMPILE_VIEW(\)` - - -Permissions -============= - -The role must have the ``CREATE`` permission at the database level, as well as ``SELECT`` permissions for any tables referenced by the view. - -Syntax -========== - -.. code-block:: postgres - - create_view_statement ::= - CREATE VIEW [schema_name].view_name [ column_list ] - AS - query - ; - - schema_name ::= identifier - - view_name ::= identifier - - column_list ::= ( { column_name [, ...] } ) - - column_name ::= identifier - - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``schema_name`` - - The name of the schema in which to create the view. - * - ``view_name`` - - The name of the view to create, which must be unique inside the schema. - * - ``column_list`` - - An optional comma separated list of column names for the view. If specified, these column names will override the column names in the response of the query in the ``AS query`` statement. - * - ``AS query`` - - The select query to execute when the view is referenced. - -.. * - ``OR REPLACE`` -.. - Create a new view, and overwrite any existing views by the same name. Does not return an error if the view already exists. - -Examples -=========== - -A simple view ------------------ - -.. code-block:: postgres - - CREATE VIEW only_agressive_animals AS - SELECT * FROM cool_animals WHERE is_agressive=true; - - SELECT * FROM only_agressive_animals; - -Overriding default column names ---------------------------------- - -.. code-block:: postgres - - CREATE VIEW only_relaxed_animals (animal_id, animal_name, should_i_worry) AS - SELECT id, name, is_agressive FROM cool_animals WHERE is_agressive=false; diff --git a/reference/sql/sql_statements/ddl_commands/drop_clustering_key.rst b/reference/sql/sql_statements/ddl_commands/drop_clustering_key.rst deleted file mode 100644 index 41b10bdfa..000000000 --- a/reference/sql/sql_statements/ddl_commands/drop_clustering_key.rst +++ /dev/null @@ -1,64 +0,0 @@ -.. _drop_clustering_key: - -********************** -DROP CLUSTERING KEY -********************** - -``DROP CLUSTERING KEY`` drops all clustering keys in a table. - -Read our :ref:`data_clustering` guide for more information. - -See also: :ref:`cluster_by`, :ref:`create_table`. - - -Permissions -============= - -The role must have the ``DDL`` permission at the database or table level. - -Syntax -========== - -.. code-block:: postgres - - alter_table_rename_table_statement ::= - ALTER TABLE [schema_name.]table_name DROP CLUSTERING KEY - ; - - table_name ::= identifier - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``schema_name`` - - The schema name for the table. Defaults to ``public`` if not specified. - * - ``table_name`` - - The table name to apply the change to. - -Usage notes -================= - -Removing clustering keys does not affect existing data. - -To force data to re-cluster, the table has to be recreated (i.e. with :ref:`create_table_as`). - - - - -Examples -=========== - -Dropping clustering keys in a table ------------------------------------------ - -.. code-block:: postgres - - ALTER TABLE public.users DROP CLUSTERING KEY - - diff --git a/reference/sql/sql_statements/ddl_commands/drop_column.rst b/reference/sql/sql_statements/ddl_commands/drop_column.rst deleted file mode 100644 index 391367e16..000000000 --- a/reference/sql/sql_statements/ddl_commands/drop_column.rst +++ /dev/null @@ -1,63 +0,0 @@ -.. _drop_column: - -********************** -DROP COLUMN -********************** - -``DROP COLUMN`` can be used to remove columns from a table. - -Permissions -============= - -The role must have the ``DDL`` permission at the database or table level. - -Syntax -========== - -.. code-block:: postgres - - alter_table_drop_column_statement ::= - ALTER TABLE [schema_name.]table_name DROP COLUMN column_name - ; - - table_name ::= identifier - - schema_name ::= identifier - - column_name ::= identifier - - - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``schema_name`` - - The schema name for the table. Defaults to ``public`` if not specified. - * - ``table_name`` - - The table name to apply the change to. - * - ``column_name`` - - The column to remove. - -Examples -=========== - -Removing a column ------------------------------------------ - -.. code-block:: postgres - - -- Remove the 'weight' column - ALTER TABLE users DROP COLUMN weight; - -Removing a column with a quoted identifier name ----------------------------------------------------- - -.. code-block:: postgres - - ALTER TABLE users DROP COLUMN "Weight in kilograms"; \ No newline at end of file diff --git a/reference/sql/sql_statements/ddl_commands/drop_database.rst b/reference/sql/sql_statements/ddl_commands/drop_database.rst deleted file mode 100644 index 0cfbbcd30..000000000 --- a/reference/sql/sql_statements/ddl_commands/drop_database.rst +++ /dev/null @@ -1,63 +0,0 @@ -.. _drop_database: - -********************** -DROP DATABASE -********************** - -``DROP DATABASE`` can be used to remove a database and all of its objects. - -Permissions -============= - -The role must have the ``DDL`` permission at the database level. - -Syntax -========== - -.. code-block:: postgres - - drop_database_statement ::= - DROP DATABASE database_name - ; - - database_name ::= identifier - - - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``database_name`` - - The name of the database to drop. This can not be the current database in use. - -Examples -=========== - -Dropping a database and all of its objects ---------------------------------------------- - -.. code-block:: psql - - master=> DROP DATABASE raviga; - executed - - -Dropping the current database --------------------------------- - -The current database in use can't be dropped. Switch to another database first. - -.. code-block:: psql - - raviga=> DROP DATABASE raviga; - Current open database 'raviga' cannot be dropped. - - raviga=> \c master - master=> DROP DATABASE raviga; - executed \ No newline at end of file diff --git a/reference/sql/sql_statements/ddl_commands/drop_function.rst b/reference/sql/sql_statements/ddl_commands/drop_function.rst deleted file mode 100644 index 726085f9f..000000000 --- a/reference/sql/sql_statements/ddl_commands/drop_function.rst +++ /dev/null @@ -1,66 +0,0 @@ -.. _drop_function: - -********************** -DROP FUNCTION -********************** - -``DROP FUNCTION`` can be used to remove a user defined function. - -Permissions -============= - -The role must have the ``DDL`` permission at the database level. - -Syntax -========== - -.. code-block:: postgres - - drop_function_statement ::= - DROP FUNCTION [ IF EXISTS ] function_name(); - ; - - function_name ::= identifier - - - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``IF EXISTS`` - - Drop the function if it exists. Does not error if the function does not exist. - * - ``function_name()`` - - The name of the function to drop. - -Examples -=========== - -Dropping a function ---------------------------------------------- - -.. code-block:: postgres - - DROP FUNCTION my_distance(); - - -Dropping a function (always succeeds) -------------------------------------- - -.. code-block:: psql - - farm=> DROP FUNCTION my_distance(); - executed - - farm=> DROP FUNCTION my_distance(); - Function 'my_distance' not found - - -- This will succeed, even though the function does not exist - farm=> DROP FUNCTION IF EXISTS my_distance(); - executed - diff --git a/reference/sql/sql_statements/ddl_commands/drop_schema.rst b/reference/sql/sql_statements/ddl_commands/drop_schema.rst deleted file mode 100644 index c10ab7f8f..000000000 --- a/reference/sql/sql_statements/ddl_commands/drop_schema.rst +++ /dev/null @@ -1,77 +0,0 @@ -.. _drop_schema: - -********************** -DROP SCHEMA -********************** - -``DROP SCHEMA`` can be used to remove a schema. - -The schema has to be empty before removal. - -SQream DB does not support dropping a schema with objects. - -See also: :ref:`create_schema`, :ref:`alter_default_schema`. - -Permissions -============= - -The role must have the ``DDL`` permission at the database level. - -Syntax -========== - -.. code-block:: postgres - - drop_schema_statement ::= - DROP SCHEMA schema_name - ; - - schema_name ::= identifier - - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``schema_name`` - - The name of the schema to drop - -Examples -=========== - -Dropping a schema ---------------------------------------------- - -.. code-block:: postgres - - DROP SCHEMA test; - -Dropping a schema if it's not empty ----------------------------------------------- - -If a schema contains several tables, SQream DB will alert you that these tables need to be dropped first. - -This prevents accidental dropping of full schemas. - -.. code-block:: psql - - t=> DROP SCHEMA test; - Schema 'test' contains the following objects: - Tables - 'test.foo' , 'test.bar' - Please drop its content and then try again. - -To drop the schema, drop the schema's tables first, and then drop the schema: - -.. code-block:: psql - - t=> DROP TABLE test.foo; - executed - t=> DROP TABLE test.bar; - executed - t=> DROP SCHEMA test; - executed \ No newline at end of file diff --git a/reference/sql/sql_statements/ddl_commands/drop_table.rst b/reference/sql/sql_statements/ddl_commands/drop_table.rst deleted file mode 100644 index e2a704ff8..000000000 --- a/reference/sql/sql_statements/ddl_commands/drop_table.rst +++ /dev/null @@ -1,70 +0,0 @@ -.. _drop_table: - -********************** -DROP TABLE -********************** - -``DROP TABLE`` can be used to remove a table and all of its contents. - -Permissions -============= - -The role must have the ``DDL`` permission at the database or table level. - -Syntax -========== - -.. code-block:: postgres - - drop_table_statement ::= - DROP TABLE [ IF EXISTS ] [schema_name.]table_name - ; - - table_name ::= identifier - - schema_name ::= identifier - - - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``IF EXISTS`` - - Drop the table if it exists. Does not error if the table does not exist. - * - ``schema_name`` - - The name of the schema from which to drop the table. - * - ``table_name`` - - The name of the table to drop. - -Examples -=========== - -Dropping a table ---------------------------------------------- - -.. code-block:: postgres - - DROP TABLE cool_animals; - - -Dropping a table (always succeeds) -------------------------------------- - -.. code-block:: psql - - farm=> DROP TABLE cool_animals; - executed - - farm=> DROP TABLE cool_animals; - Table 'public.cool_animals' not found - - -- This will succeed, even though the table does not exist - farm=> DROP TABLE IF EXISTS cool_animals; - executed - diff --git a/reference/sql/sql_statements/ddl_commands/drop_view.rst b/reference/sql/sql_statements/ddl_commands/drop_view.rst deleted file mode 100644 index e93629ab4..000000000 --- a/reference/sql/sql_statements/ddl_commands/drop_view.rst +++ /dev/null @@ -1,72 +0,0 @@ -.. _drop_view: - -********************** -DROP VIEW -********************** - -``DROP VIEW`` can be used to remove a view. - -Because a view is logical, this does not affect any data in any of the referenced tables. - -Permissions -============= - -The role must have the ``DDL`` permission at the database level. - -Syntax -========== - -.. code-block:: postgres - - drop_view_statement ::= - DROP VIEW [ IF EXISTS ] [schema_name.]view_name - ; - - view_name ::= identifier - - schema_name ::= identifier - - - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``IF EXISTS`` - - Drop the view if it exists. Does not error if the view does not exist. - * - ``schema_name`` - - The name of the schema from which to drop the view. - * - ``view_name`` - - The name of the view to drop. - -Examples -=========== - -Dropping a table ---------------------------------------------- - -.. code-block:: postgres - - DROP VIEW angry_animals; - - -Dropping a view (always succeeds) -------------------------------------- - -.. code-block:: psql - - farm=> DROP VIEW angry_animals; - executed - - farm=> DROP VIEW angry_animals; - View 'public.angry_animals' not found - - -- This will succeed, even though the view does not exist - farm=> DROP VIEW IF EXISTS angry_animals; - executed - diff --git a/reference/sql/sql_statements/ddl_commands/rename_column.rst b/reference/sql/sql_statements/ddl_commands/rename_column.rst deleted file mode 100644 index f91933f71..000000000 --- a/reference/sql/sql_statements/ddl_commands/rename_column.rst +++ /dev/null @@ -1,65 +0,0 @@ -.. _rename_column: - -********************** -RENAME COLUMN -********************** - -``RENAME COLUMN`` can be used to rename columns in a table. - -Permissions -============= - -The role must have the ``DDL`` permission at the database or table level. - -Syntax -========== - -.. code-block:: postgres - - alter_table_rename_column_statement ::= - ALTER TABLE [schema_name.]table_name RENAME COLUMN current_name TO new_name - ; - - table_name ::= identifier - - schema_name ::= identifier - - current_name ::= identifier - - new_name ::= identifier - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``schema_name`` - - The schema name for the table. Defaults to ``public`` if not specified. - * - ``table_name`` - - The table name to apply the change to. - * - ``current_name`` - - The column to rename. - * - ``new_name`` - - The new column name. - -Examples -=========== - -Renaming a column ------------------------------------------ - -.. code-block:: postgres - - -- Remove the 'weight' column - ALTER TABLE users RENAME COLUMN weight TO mass; - -Renaming a quoted name --------------------------- - -.. code-block:: postgres - - ALTER TABLE users RENAME COLUMN "mass" TO "Mass (Kilograms); \ No newline at end of file diff --git a/reference/sql/sql_statements/ddl_commands/rename_table.rst b/reference/sql/sql_statements/ddl_commands/rename_table.rst deleted file mode 100644 index e24ba6efe..000000000 --- a/reference/sql/sql_statements/ddl_commands/rename_table.rst +++ /dev/null @@ -1,57 +0,0 @@ -.. _rename_table: - -********************** -RENAME TABLE -********************** - -``RENAME TABLE`` can be used to rename a table. - -.. warning:: Renaming a table can void existing views that use this table. See more about :ref:`recompiling views `. - -Permissions -============= - -The role must have the ``DDL`` permission at the database or table level. - -Syntax -========== - -.. code-block:: postgres - - alter_table_rename_table_statement ::= - ALTER TABLE [schema_name.]current_name RENAME TO new_name - ; - - current_name ::= identifier - - schema_name ::= identifier - - new_name ::= identifier - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``schema_name`` - - The schema name for the table. Defaults to ``public`` if not specified. - * - ``current_name`` - - The table name to apply the change to. - * - ``new_name`` - - The new table name. - -Examples -=========== - -Renaming a table ------------------------------------------ - -.. code-block:: postgres - - ALTER TABLE public.users RENAME TO former_users; - - diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index 28096f16a..9525955d2 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -18,48 +18,48 @@ Data Definition Commands (DDL) * - Command - Usage - * - :ref:`ADD COLUMN` - - Add a new column to a table - * - :ref:`ALTER DEFAULT SCHEMA` - - Change the default schema for a role - * - :ref:`ALTER TABLE` - - Change the schema of a table - * - :ref:`CLUSTER BY` - - Change clustering keys in a table - * - :ref:`CREATE DATABASE` - - Create a new database - * - :ref:`CREATE EXTERNAL TABLE` - - Create a new external table in the database (deprecated) - * - :ref:`CREATE FOREIGN TABLE` - - Create a new foreign table in the database - * - :ref:`CREATE FUNCTION ` - - Create a new user defined function in the database - * - :ref:`CREATE SCHEMA` - - Create a new schema in the database - * - :ref:`CREATE TABLE` - - Create a new table in the database - * - :ref:`CREATE TABLE AS` - - Create a new table in the database using results from a select query - * - :ref:`CREATE VIEW` - - Create a new view in the database - * - :ref:`DROP CLUSTERING KEY` - - Drops all clustering keys in a table - * - :ref:`DROP COLUMN` - - Drop a column from a table - * - :ref:`DROP DATABASE` - - Drop a database and all of its objects - * - :ref:`DROP FUNCTION` - - Drop a function - * - :ref:`DROP SCHEMA` - - Drop a schema - * - :ref:`DROP TABLE` - - Drop a table and its contents from a database - * - :ref:`DROP VIEW` - - Drop a view - * - :ref:`RENAME COLUMN` - - Rename a column - * - :ref:`RENAME TABLE` - - Rename a table + * - `ADD COLUMN `_ + - Add a new column to a table + * - `ALTER DEFAULT SCHEMA `_ + - Change the default schema for a role + * - `ALTER TABLE `_ + - Change the schema of a table + * - `CLUSTER BY `_ + - Change clustering keys in a table + * - `CREATE DATABASE `_ + - Create a new database + * - `CREATE EXTERNAL TABLE `_ + - Create a new external table in the database (deprecated) + * - `CREATE FOREIGN TABLE `_ + - Create a new foreign table in the database + * - `CREATE FUNCTION `_ + - Create a new user defined function in the database + * - `CREATE SCHEMA `_ + - Create a new schema in the database + * - `CREATE TABLE `_ + - Create a new table in the database + * - `CREATE TABLE AS `_ + - Create a new table in the database using results from a select query + * - `CREATE VIEW `_ + - Create a new view in the database + * - `DROP CLUSTERING KEY `_ + - Drops all clustering keys in a table + * - `DROP COLUMN `_ + - Drop a column from a table + * - `DROP DATABASE `_ + - Drop a database and all of its objects + * - `DROP FUNCTION `_ + - Drop a function + * - `DROP SCHEMA `_ + - Drop a schema + * - `DROP TABLE `_ + - Drop a table and its contents from a database + * - `DROP VIEW `_ + - Drop a view + * - `RENAME COLUMN `_ + - Rename a column + * - `RENAME TABLE `_ + - Rename a table Data Manipulation Commands (DML) ================================ From 8e2ae851867dcd97e61fdbc6d5b407f49813d3c9 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 27 Mar 2022 17:01:05 +0300 Subject: [PATCH 021/882] Returned deleted files --- .../ddl_commands/add_column.rst | 91 ++++++ .../ddl_commands/alter_default_schema.rst | 58 ++++ .../ddl_commands/alter_table.rst | 33 ++ .../ddl_commands/cluster_by.rst | 69 ++++ .../ddl_commands/create_database.rst | 55 ++++ .../ddl_commands/create_external_table.rst | 156 +++++++++ .../ddl_commands/create_foreign_table.rst | 165 ++++++++++ .../ddl_commands/create_function.rst | 103 ++++++ .../ddl_commands/create_schema.rst | 92 ++++++ .../ddl_commands/create_table.rst | 296 ++++++++++++++++++ .../ddl_commands/create_table_as.rst | 96 ++++++ .../ddl_commands/create_view.rst | 79 +++++ .../ddl_commands/drop_clustering_key.rst | 64 ++++ .../ddl_commands/drop_column.rst | 63 ++++ .../ddl_commands/drop_database.rst | 63 ++++ .../ddl_commands/drop_function.rst | 66 ++++ .../ddl_commands/drop_schema.rst | 77 +++++ .../ddl_commands/drop_table.rst | 70 +++++ .../sql_statements/ddl_commands/drop_view.rst | 72 +++++ .../ddl_commands/rename_column.rst | 65 ++++ .../ddl_commands/rename_table.rst | 57 ++++ reference/sql/sql_statements/index.rst | 84 ++--- 22 files changed, 1932 insertions(+), 42 deletions(-) create mode 100644 reference/sql/sql_statements/ddl_commands/add_column.rst create mode 100644 reference/sql/sql_statements/ddl_commands/alter_default_schema.rst create mode 100644 reference/sql/sql_statements/ddl_commands/alter_table.rst create mode 100644 reference/sql/sql_statements/ddl_commands/cluster_by.rst create mode 100644 reference/sql/sql_statements/ddl_commands/create_database.rst create mode 100644 reference/sql/sql_statements/ddl_commands/create_external_table.rst create mode 100644 reference/sql/sql_statements/ddl_commands/create_foreign_table.rst create mode 100644 reference/sql/sql_statements/ddl_commands/create_function.rst create mode 100644 reference/sql/sql_statements/ddl_commands/create_schema.rst create mode 100644 reference/sql/sql_statements/ddl_commands/create_table.rst create mode 100644 reference/sql/sql_statements/ddl_commands/create_table_as.rst create mode 100644 reference/sql/sql_statements/ddl_commands/create_view.rst create mode 100644 reference/sql/sql_statements/ddl_commands/drop_clustering_key.rst create mode 100644 reference/sql/sql_statements/ddl_commands/drop_column.rst create mode 100644 reference/sql/sql_statements/ddl_commands/drop_database.rst create mode 100644 reference/sql/sql_statements/ddl_commands/drop_function.rst create mode 100644 reference/sql/sql_statements/ddl_commands/drop_schema.rst create mode 100644 reference/sql/sql_statements/ddl_commands/drop_table.rst create mode 100644 reference/sql/sql_statements/ddl_commands/drop_view.rst create mode 100644 reference/sql/sql_statements/ddl_commands/rename_column.rst create mode 100644 reference/sql/sql_statements/ddl_commands/rename_table.rst diff --git a/reference/sql/sql_statements/ddl_commands/add_column.rst b/reference/sql/sql_statements/ddl_commands/add_column.rst new file mode 100644 index 000000000..cec4aec7b --- /dev/null +++ b/reference/sql/sql_statements/ddl_commands/add_column.rst @@ -0,0 +1,91 @@ +.. _add_column: + +********************** +ADD COLUMN +********************** + +The ``ADD COLUMN`` command is used to add columns to an existing table. + + + +Syntax +========== +The following is the correct syntax for adding a table: + +.. code-block:: postgres + + alter_table_add_column_statement ::= + ALTER TABLE [schema_name.]table_name { ADD COLUMN column_def [, ...] } + ; + + table_name ::= identifier + + schema_name ::= identifier + + column_def :: = { column_name type_name [ default ] [ column_constraint ] } + + column_name ::= identifier + + column_constraint ::= + { NOT NULL | NULL } + + default ::= + DEFAULT default_value + + + +Parameters +============ +The following parameters can be used for adding a table: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``schema_name`` + - The schema name for the table. Defaults to ``public`` if not specified. + * - ``table_name`` + - The table name to apply the change to. + * - ``ADD COLUMN column_def`` + - A comma separated list of ADD COLUMN commands + * - ``column_def`` + - A column definition. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally. + +.. note:: + * When adding a new column to an existing table, a default (or null constraint) has to be specified, even if the table is empty. + * A new column added to the table can not contain an IDENTITY or be of the TEXT type. + + +Permissions +============= +The role must have the ``DDL`` permission at the database or table level. + +Examples +=========== +This section includes the following examples: + +.. contents:: + :local: + :depth: 1 + +Adding a Simple Column with a Default Value +----------------------------------------- +This example shows how to add a simple column with a default value: + +.. code-block:: postgres + + ALTER TABLE cool_animals + ADD COLUMN number_of_eyes INT DEFAULT 2 NOT NULL; + + +Adding Several Columns in One Command +------------------------------------------- +This example shows how to add several columns in one command: + +.. code-block:: postgres + + ALTER TABLE cool_animals + ADD COLUMN number_of_eyes INT DEFAULT 2 NOT NULL, + ADD COLUMN date_seen DATE DEFAULT '2019-08-01'; diff --git a/reference/sql/sql_statements/ddl_commands/alter_default_schema.rst b/reference/sql/sql_statements/ddl_commands/alter_default_schema.rst new file mode 100644 index 000000000..bca483060 --- /dev/null +++ b/reference/sql/sql_statements/ddl_commands/alter_default_schema.rst @@ -0,0 +1,58 @@ +.. _alter_default_schema: + +********************** +ALTER DEFAULT SCHEMA +********************** + +The ``ALTER DEFAULT SCHEMA`` command can be used to change a role's default schema. The default schema in SQream is ``public``. + +For more information, see :ref:`create_schema` and :ref:`drop_schema`. + + + +Syntax +========== +The following is the correct syntax for altering a default schema: + +.. code-block:: postgres + + alter_default_schema_statement ::= + ALTER DEFAULT SCHEMA FOR role_name TO schema_name + ; + + role_name ::= identifier + + schema_name ::= identifier + + + +Parameters +============ +The following parameters can be used when altering a default schema: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``role_name`` + - The name of the role the change will apply to. + * - ``schema_name`` + - The new default schema name. + +Permissions +============= +No special permissions are required. + +Examples +=========== +This section includes an example of **altering the default schema for a role**: + +.. code-block:: postgres + + SELECT * FROM users; -- Refers to public.users + + ALTER DEFAULT SCHEMA FOR bgilfoyle TO staging; + + SELECT * FROM users; -- Now refers to staging.users, rather than public.users diff --git a/reference/sql/sql_statements/ddl_commands/alter_table.rst b/reference/sql/sql_statements/ddl_commands/alter_table.rst new file mode 100644 index 000000000..4046a31fe --- /dev/null +++ b/reference/sql/sql_statements/ddl_commands/alter_table.rst @@ -0,0 +1,33 @@ +.. _alter_table: + +********************** +ALTER TABLE +********************** +You can use the ``ALTER TABLE`` command to make schema changes to a table, and can be used in conjunction with several sub-commands. + +Locks +======= +Making changes to a schema makes an exclusive lock on tables. While these operations do not typically take much time, other statements may have to wait until the schema changes are completed. + +Sub-Commands +============== +The following table shows the sub-commands that can be used with the ``ALTER TABLE`` command: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Command + - Usage + * - :ref:`ADD COLUMN` + - Adds a new column to a table. + * - :ref:`DROP COLUMN` + - Drops a column from a table. + * - :ref:`RENAME COLUMN` + - Renames a column. + * - :ref:`RENAME TABLE` + - Renames a table. + * - :ref:`CLUSTER BY` + - Modifies (adds or reorders) the clustering keys in a table. + * - :ref:`DROP CLUSTERING KEY` + - Drops all clustering keys. diff --git a/reference/sql/sql_statements/ddl_commands/cluster_by.rst b/reference/sql/sql_statements/ddl_commands/cluster_by.rst new file mode 100644 index 000000000..2a389e254 --- /dev/null +++ b/reference/sql/sql_statements/ddl_commands/cluster_by.rst @@ -0,0 +1,69 @@ +.. _cluster_by: + +********************** +CLUSTER BY +********************** + +``CLUSTER BY`` can be used to change clustering keys in a table. + + +Read our :ref:`data_clustering` guide for more information. + +See also: :ref:`drop_clustering_key`, :ref:`create_table`. + + +Permissions +============= + +The role must have the ``DDL`` permission at the database or table level. + +Syntax +========== + +.. code-block:: postgres + + alter_table_rename_table_statement ::= + ALTER TABLE [schema_name.]table_name CLUSTER BY column_name [, ...] + ; + + table_name ::= identifier + + column_name ::= identifier + + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``schema_name`` + - The schema name for the table. Defaults to ``public`` if not specified. + * - ``table_name`` + - The table name to apply the change to. + * - ``column_name [, ... ]`` + - Comma separated list of columns to create clustering keys for + + +Usage notes +================= + +Removing clustering keys does not affect existing data. + +To force data to re-cluster, the table has to be recreated (i.e. with :ref:`create_table_as`). + + +Examples +=========== + +Reclustering a table +----------------------------------------- + +.. code-block:: postgres + + ALTER TABLE public.users CLUSTER BY start_date; + + diff --git a/reference/sql/sql_statements/ddl_commands/create_database.rst b/reference/sql/sql_statements/ddl_commands/create_database.rst new file mode 100644 index 000000000..a0496feb2 --- /dev/null +++ b/reference/sql/sql_statements/ddl_commands/create_database.rst @@ -0,0 +1,55 @@ +.. _create_database: + +***************** +CREATE DATABASE +***************** + +``CREATE DATABASE`` creates a new database in SQream. + +Permissions +============= + +Only a superuser can create a new database + +Syntax +========== + +.. code-block:: postgres + + create_database_statement ::= + + CREATE DATABASE database_name ; + + database_name ::= identifier + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``database_name`` + - The name of the database name. The database name must be unique, and follows :ref:`Identifier rules ` + +Examples +=========== + +.. code-block:: postgres + + CREATE DATABASE raviga; + +.. code-block:: postgres + + CREATE DATABASE my_db; + +If the database already exists, an error will appear: + +.. code-block:: psql + + master=> CREATE DATABASE MY_DB; + Database 'my_db' already exists + +.. note:: SQream DB :ref:`identifiers ` are always converted to lowercase, so ``my_db`` is the same as ``MY_DB``, unless explicitly quoted as ``"MY_DB"``. \ No newline at end of file diff --git a/reference/sql/sql_statements/ddl_commands/create_external_table.rst b/reference/sql/sql_statements/ddl_commands/create_external_table.rst new file mode 100644 index 000000000..7674889a6 --- /dev/null +++ b/reference/sql/sql_statements/ddl_commands/create_external_table.rst @@ -0,0 +1,156 @@ +.. _create_external_table: + +*********************** +CREATE EXTERNAL TABLE +*********************** + +.. warning:: + + The ``CREATE EXTERNAL TABLE`` syntax is deprecated, and will be removed in future versions. + + Starting with SQream DB v2020.2, external tables have been renamed to :ref:`foreign tables`, and use a more flexible foreign data wrapper concept. See :ref:`create_foreign_table` instead. + + Upgrading to a new version of SQream DB converts existing tables automatically. When creating a new external tables, use the new foreign table syntax. + + +``CREATE TABLE`` creates a new external table in an existing database. + +See more in the :ref:`External tables guide`. + +.. tip:: + + * Data in an external table can change if the sources change, and frequent access to remote files may harm performance. + + * To create a regular table, see :ref:`CREATE TABLE ` + +Permissions +============= + +The role must have the ``CREATE`` permission at the database level. + +Syntax +========== + +.. code-block:: postgres + + create_table_statement ::= + CREATE [ OR REPLACE ] EXTERNAL TABLE [schema_name].table_name ( + { column_def [, ...] } + ) + USING FORMAT format_def + WITH { external_table_option [ ...] } + ; + + schema_name ::= identifier + + table_name ::= identifier + + format_def ::= { PARQUET | ORC | CSV } + + external_table_option ::= { + PATH '{ path_spec }' + | FIELD DELIMITER '{ field_delimiter }' + | RECORD DELIMITER '{ record_delimiter }' + | AWS_ID '{ AWS ID }' + | AWS_SECRET '{ AWS SECRET }' + } + + path_spec ::= { local filepath | S3 URI | HDFS URI } + + field_delimiter ::= delimiter_character + + record_delimiter ::= delimiter_character + + column_def ::= { column_name type_name [ default ] [ column_constraint ] } + + column_name ::= identifier + + column_constraint ::= + { NOT NULL | NULL } + + default ::= + + DEFAULT default_value + | IDENTITY [ ( start_with [ , increment_by ] ) ] + +.. _cet_parameters: + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``OR REPLACE`` + - Create a new table, and overwrite any existing table by the same name. Does not return an error if the table already exists. ``CREATE OR REPLACE`` does not check the table contents or structure, only the table name. + * - ``schema_name`` + - The name of the schema in which to create the table. + * - ``table_name`` + - The name of the table to create, which must be unique inside the schema. + * - ``column_def`` + - A comma separated list of column definitions. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally. + * - ``USING FORMAT ...`` + - Specifies the format of the source files, such as ``PARQUET``, ``ORC``, or ``CSV``. + * - ``WITH PATH ...`` + - Specifies a path or URI of the source files, such as ``/path/to/*.parquet``. + * - ``FIELD DELIMITER`` + - Specifies the field delimiter for CSV files. Defaults to ``,``. + * - ``RECORD DELIMITER`` + - Specifies the record delimiter for CSV files. Defaults to a newline, ``\n`` + * - ``AWS_ID``, ``AWS_SECRET`` + - Credentials for authenticated S3 access + + +Examples +=========== + +A simple table from Tab-delimited file (TSV) +---------------------------------------------- + +.. code-block:: postgres + + CREATE OR REPLACE EXTERNAL TABLE cool_animals + (id INT NOT NULL, name VARCHAR(30) NOT NULL, weight FLOAT NOT NULL) + USING FORMAT csv + WITH PATH '/home/rhendricks/cool_animals.csv' + FIELD DELIMITER '\t'; + + +A table from a directory of Parquet files on HDFS +----------------------------------------------------- + +.. code-block:: postgres + + CREATE EXTERNAL TABLE users + (id INT NOT NULL, name VARCHAR(30) NOT NULL, email VARCHAR(50) NOT NULL) + USING FORMAT Parquet + WITH PATH 'hdfs://hadoop-nn.piedpiper.com/rhendricks/users/*.parquet'; + +A table from a bucket of files on S3 +-------------------------------------- + +.. code-block:: postgres + + CREATE EXTERNAL TABLE users + (id INT NOT NULL, name VARCHAR(30) NOT NULL, email VARCHAR(50) NOT NULL) + USING FORMAT Parquet + WITH PATH 's3://pp-secret-bucket/users/*.parquet' + AWS_ID 'our_aws_id' + AWS_SECRET 'our_aws_secret'; + + +Changing an external table to a regular table +------------------------------------------------ + +Materializes an external table into a regular table. + +.. tip: Using an external table allows you to perform ETL-like operations in SQream DB by applying SQL functions and operations to raw files + +.. code-block:: postgres + + CREATE TABLE real_table + AS SELECT * FROM external_table; + diff --git a/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst b/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst new file mode 100644 index 000000000..3a766852a --- /dev/null +++ b/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst @@ -0,0 +1,165 @@ +.. _create_foreign_table: + +*********************** +CREATE FOREIGN TABLE +*********************** + +.. note:: + + Starting with SQream DB v2020.2, external tables have been renamed to foreign tables, and use a more flexible foreign data wrapper concept. + + Upgrading to a new version of SQream DB converts existing external tables automatically. + + +``CREATE FOREIGN TABLE`` creates a new foreign table in an existing database. + +See more in the :ref:`Foreign tables guide`. + +.. tip:: + + * Data in a foreign table can change if the sources change, and frequent access to remote files may harm performance. + + * To create a regular table, see :ref:`CREATE TABLE ` + +Permissions +============= + +The role must have the ``CREATE`` permission at the database level. + +Syntax +========== + +.. code-block:: postgres + + create_table_statement ::= + CREATE [ OR REPLACE ] FOREIGN TABLE [schema_name].table_name ( + { column_def [, ...] } + ) + [ FOREIGN DATA ] WRAPPER fdw_name + [ OPTIONS ( option_def [, ... ] ) ] + ; + + schema_name ::= identifier + + table_name ::= identifier + + fdw_name ::= + { csv_fdw | orc_fdw | parquet_fdw } + + option_def ::= + { + LOCATION = '{ path_spec }' + | DELIMITER = '{ field_delimiter }' -- for CSV only + | RECORD_DELIMITER = '{ record_delimiter }' -- for CSV only + | AWS_ID '{ AWS ID }' + | AWS_SECRET '{ AWS SECRET }' + } + + path_spec ::= { local filepath | S3 URI | HDFS URI } + + field_delimiter ::= delimiter_character + + record_delimiter ::= delimiter_character + + column_def ::= + { column_name type_name [ default ] [ column_constraint ] } + + column_name ::= identifier + + column_constraint ::= + { NOT NULL | NULL } + + default ::= + DEFAULT default_value + | IDENTITY [ ( start_with [ , increment_by ] ) ] + +.. _cft_parameters: + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``OR REPLACE`` + - Create a new table, and overwrite any existing table by the same name. Does not return an error if the table already exists. ``CREATE OR REPLACE`` does not check the table contents or structure, only the table name. + * - ``schema_name`` + - The name of the schema in which to create the table. + * - ``table_name`` + - The name of the table to create, which must be unique inside the schema. + * - ``column_def`` + - A comma separated list of column definitions. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally. + * - ``WRAPPER ...`` + - Specifies the format of the source files, such as ``parquet_fdw``, ``orc_fdw``, or ``csv_fdw``. + * - ``LOCATION = ...`` + - Specifies a path or URI of the source files, such as ``/path/to/*.parquet``. + * - ``DELIMITER = ...`` + - Specifies the field delimiter for CSV files. Defaults to ``,``. + * - ``RECORD_DELIMITER = ...`` + - Specifies the record delimiter for CSV files. Defaults to a newline, ``\n`` + * - ``AWS_ID``, ``AWS_SECRET`` + - Credentials for authenticated S3 access + + +Examples +=========== + +A simple table from Tab-delimited file (TSV) +---------------------------------------------- + +.. code-block:: postgres + + CREATE OR REPLACE FOREIGN TABLE cool_animals + (id INT NOT NULL, name VARCHAR(30) NOT NULL, weight FLOAT NOT NULL) + WRAPPER csv_fdw + OPTIONS + ( LOCATION = '/home/rhendricks/cool_animals.csv', + DELIMITER = '\t' + ) + ; + + +A table from a directory of Parquet files on HDFS +----------------------------------------------------- + +.. code-block:: postgres + + CREATE FOREIGN TABLE users + (id INT NOT NULL, name VARCHAR(30) NOT NULL, email VARCHAR(50) NOT NULL) + WRAPPER parquet_fdw + OPTIONS + ( + LOCATION = 'hdfs://hadoop-nn.piedpiper.com/rhendricks/users/*.parquet' + ); + +A table from a bucket of ORC files on S3 +------------------------------------------ + +.. code-block:: postgres + + CREATE FOREIGN TABLE users + (id INT NOT NULL, name VARCHAR(30) NOT NULL, email VARCHAR(50) NOT NULL) + WRAPPER orc_fdw + OPTIONS + ( + LOCATION = 's3://pp-secret-bucket/users/*.orc', + AWS_ID = 'our_aws_id', + AWS_SECRET = 'our_aws_secret' + ); + + +Changing a foreign table to a regular table +------------------------------------------------ + +Materializes a foreign table into a regular table. + +.. tip: Using a foreign table allows you to perform ETL-like operations in SQream DB by applying SQL functions and operations to raw files + +.. code-block:: postgres + + CREATE TABLE real_table + AS SELECT * FROM some_foreign_table; + diff --git a/reference/sql/sql_statements/ddl_commands/create_function.rst b/reference/sql/sql_statements/ddl_commands/create_function.rst new file mode 100644 index 000000000..971b51298 --- /dev/null +++ b/reference/sql/sql_statements/ddl_commands/create_function.rst @@ -0,0 +1,103 @@ +.. _create_function: + +***************** +CREATE FUNCTION +***************** + +``CREATE FUNCTION`` creates a new user-defined function (UDF) in an existing database. + +See more in our :ref:`Python UDF (user-defined functions)` guide. + +Permissions +============= + +The role must have the ``CREATE FUNCTION`` permission at the database level. + +Syntax +========== + +.. code-block:: postgres + + create_function_statement ::= + CREATE [ OR REPLACE ] FUNCTION function_name (argument_list) + RETURNS return_type + AS $$ + { function_body } + $$ LANGUAGE python + ; + + function_name ::= identifier + + argument_list :: = { value_name type_name [, ...] } + + value_name ::= identifier + + return_type ::= type_name + + function_body ::= Valid Python code + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``OR REPLACE`` + - Create a new function, and overwrite any existing function by the same name. Does not return an error if the function already exists. ``CREATE OR REPLACE`` does not check the function contents or structure, only the function name. + * - ``function_name`` + - The name of the function to create, which must be unique inside the database. + * - ``argument_list`` + - A comma separated list of column definitions. A column definition includes a name identifier and a datatype. + * - ``return_type`` + - The SQL datatype of the return value, such as ``INT``, ``VARCHAR``, etc. + * - ``function_body`` + - Python code, dollar-quoted (``$$``). + +Examples +=========== + +Calculate distance between two points +-------------------------------------- + +.. code-block:: postgres + + CREATE OR REPLACE FUNCTION my_distance (x1 float, y1 float, x2 float, y2 float) + RETURNS FLOAT + AS $$ + import math + if y1 < x1: + return 0.0 + else: + return math.sqrt((y2 - y1) ** 2 + (x2 - x1) ** 2) + $$ LANGUAGE PYTHON; + + -- Usage: + SELECT city, my_location, my_distance(x1,y1,x2,y2) from cities; + + +Calling files from other locations +--------------------------------------- + +.. code-block:: postgres + + -- Our script my_code.py is in ~/my_python_stuff + + CREATE FUNCTION write_log() + RETURNS INT + AS $$ + import sys + sys.path.append("/home/user/my_python_stuff") + + import my_code as f + + f.main() + + return 1 + + $$ LANGUAGE PYTHON; + + -- Usage: + SELECT write_log(); diff --git a/reference/sql/sql_statements/ddl_commands/create_schema.rst b/reference/sql/sql_statements/ddl_commands/create_schema.rst new file mode 100644 index 000000000..aefa64b4f --- /dev/null +++ b/reference/sql/sql_statements/ddl_commands/create_schema.rst @@ -0,0 +1,92 @@ +.. _create_schema: + +***************** +CREATE SCHEMA +***************** +The **CREATE SCHEMA** page describes the following: + + +.. contents:: + :local: + :depth: 2 + +Overview +============ + +``CREATE SCHEMA`` creates a new schema in an existing database. A schema is a virtual space for storing tables. + +The default schema in SQream DB is ``public``. + +.. tip:: Use schemas to separate between use-cases, such as staging and production. + +The **CREATE SCHEMA** statement can be used to query tables from different schemas without providing an alias, as in the following example: + +.. code-block:: postgres + + select .table_name.column_name from .table_name + +See also: :ref:`drop_schema`, :ref:`alter_default_schema`. + +Permissions +============= + +The role must have the ``CREATE`` permission at the database level. + +Syntax +========== +The following example shows the correct syntax for creating a schema: + +.. code-block:: postgres + + create_schema_statement ::= + CREATE SCHEMA schema_name + ; + + schema_name ::= identifier + + +Parameters +============ +The following table shows the ``schema_name`` parameters: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``schema_name`` + - The name of the schema to create. + +Examples +=========== +This section includes the following examples: + +.. contents:: + :local: + :depth: 1 + + +Creating a Schema +-------------------- +The following example shows an example of the syntax for creating a schema: + +.. code-block:: postgres + + CREATE SCHEMA staging; + + CREATE TABLE staging.users AS SELECT * FROM public.users; + + SELECT * FROM staging.users; + +Altering the Default Schema for a Role +----------------------------------------- +The following example shows an example of the syntax for altering the default schema for a role: + +.. code-block:: postgres + + SELECT * FROM users; -- Refers to public.users + + ALTER DEFAULT SCHEMA FOR bgilfoyle TO staging; + + SELECT * FROM users; -- Now refers to staging.users, rather than public.users diff --git a/reference/sql/sql_statements/ddl_commands/create_table.rst b/reference/sql/sql_statements/ddl_commands/create_table.rst new file mode 100644 index 000000000..10b1a9836 --- /dev/null +++ b/reference/sql/sql_statements/ddl_commands/create_table.rst @@ -0,0 +1,296 @@ +.. _create_table: + +***************** +CREATE TABLE +***************** + +The ``CREATE TABLE`` statement is used to create a new table in an existing database. + +.. tip:: + * To create a table based on the result of a select query, see :ref:`CREATE TABLE AS `. + * To create a table based on files like Parquet and ORC, see :ref:`CREATE FOREIGN TABLE ` + + + +Syntax +========== +The following is the correct syntax for creating a table: + +.. code-block:: postgres + + create_table_statement ::= + CREATE [ OR REPLACE ] TABLE [schema_name.]table_name ( + { column_def [, ...] } + ) + [ CLUSTER BY { column_name [, ...] } ] + ; + + schema_name ::= identifier + + table_name ::= identifier + + column_def :: = { column_name type_name [ default ] [ column_constraint ] } + + column_name ::= identifier + + column_constraint ::= + { NOT NULL | NULL } + + default ::= + DEFAULT default_value + | IDENTITY [ ( start_with [ , increment_by ] ) ] + +Parameters +============ +The following parameters can be used when creating a table: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``OR REPLACE`` + - Creates a new tables and overwrites any existing table by the same name. Does not return an error if the table already exists. ``CREATE OR REPLACE`` does not check the table contents or structure, only the table name. + * - ``schema_name`` + - The name of the schema in which to create the table. + * - ``table_name`` + - The name of the table to create, which must be unique inside the schema. + * - ``column_def`` + - A comma separated list of column definitions. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally. + * - ``CLUSTER BY column_name1 ...`` + - + A commma separated list of clustering column keys. + + See :ref:`data_clustering` for more information. + * - ``LIKE`` + - Duplicates the column structure of an existing table. + + +.. _default_values: + +Default Value Constraints +=============== + +The ``DEFAULT`` value constraint specifies a value to use if one is not defined in an :ref:`insert` or :ref:`copy_from` statement. + +The value may be a literal, which is evaluated at the time the row is created. + +.. note:: The ``DEFAULT`` constraint only applies if the column does not have a value specified in the :ref:`insert` or :ref:`copy_from` statement. You can still insert a ``NULL`` into an nullable column by explicitly inserting ``NULL``. For example, ``INSERT INTO cool_animals VALUES (1, 'Gnu', NULL)``. + +Syntax +--------- +The following is the correct syntax for using the **DEFAULT** value constraints: + + +.. code-block:: postgres + + column_def :: = { column_name type_name [ default ] [ column_constraint ] } + + column_constraint ::= + { NOT NULL | NULL } + + default ::= + DEFAULT default_value + | IDENTITY [ ( start_with [ , increment_by ] ) ] + + check_specification ::= + CHECK( 'CS compression_spec' ) + + compression_spec ::= + { "default" | "p4d" | "dict" | "rle" | "sequence" | "flat" } + + +.. _identity: + +Identity +----------------------- +The ``Identity`` (or sequence) columns can be used for generating key values. Some databases call this ``AUTOINCREMENT``. + +The **identity** property on a column guarantees that each new row inserted is generated based on the current seed & increment. + +.. warning:: + The identity property on a column does not guarantee uniqueness. The identity value can be bypassed by specifying it in an :ref:`insert` command. + +The following table describes the identity parameters: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``start_with`` + - A value that is used for the very first row loaded into the table. + * - ``increment_by`` + - Incremental value that is added to the identity value of the previous row that was loaded. + +Examples +=========== +This section includes the following examples: + +.. contents:: + :local: + :depth: 1 + +Creating a Standard Table +----------------- +The following is an example of the syntax used to create a standard table: + +.. code-block:: postgres + + CREATE TABLE cool_animals ( + id INT NOT NULL, + name varchar(30) NOT NULL, + weight FLOAT, + is_agressive BOOL + ); + +Creating a Table with Default Value Constraints for Some Columns +--------------------------------------------------- +The following is an example of the syntax used to create a table with default value constraints for some columns: + + +.. code-block:: postgres + + CREATE TABLE cool_animals ( + id INT NOT NULL, + name varchar(30) NOT NULL, + weight FLOAT, + is_agressive BOOL DEFAULT false NOT NULL + ); + +.. note:: The nullable/non-nullable constraint appears at the end, after the default option + +Creating a Table with an Identity Column +--------------------------------------------------- +The following is an example of the syntax used to create a table with an identity (auto-increment) column: + + +.. code-block:: postgres + + CREATE TABLE users ( + id BIGINT IDENTITY(0,1) NOT NULL , -- Start with 0, increment by 1 + name VARCHAR(30) NOT NULL, + country VARCHAR(30) DEFAULT 'Unknown' NOT NULL + ); + +.. note:: + * Identity columns are supported on ``BIGINT`` columns. + + * Identity does not enforce the uniqueness of values. The identity value can be bypassed by specifying it in an :ref:`insert` command. + +Creating a Table from a SELECT Query +----------------------------------------- +The following is an example of the syntax used to create a table from a SELECT query: + +.. code-block:: postgres + + CREATE TABLE users_uk AS SELECT * FROM users WHERE country = 'United Kingdom'; + +For more information on creating a new table from the results of a SELECT query, see :ref:`CREATE TABLE AS `. + +Creating a Table with a Clustering Key +---------------------------------------------- +When data in a table is stored in a sorted order, the sorted columns are considered clustered. Good clustering can have a significant positive impact on performance. + +In the following example, we expect the ``start_date`` column to be naturally clustered, as new users sign up and get a newer start date. + +When the clustering key is set, if the incoming data isn’t naturally clustered, it will be clustered by SQream DB during insert or bulk load. + +The following is an example of the syntax used to create a table with a clustering key: + +.. code-block:: postgres + + CREATE TABLE users ( + name VARCHAR(30) NOT NULL, + start_date datetime not null, + country VARCHAR(30) DEFAULT 'Unknown' NOT NULL + ) CLUSTER BY start_date; + +For more information on data clustering, see :ref:`data_clustering`. + +Duplicating the Column Structure of an Existing Table +----------------- + +Syntax +************ +The following is the correct syntax for duplicating the column structure of an existing table: + +.. code-block:: postgres + + CREATE [OR REPLACE] TABLE table_name + { + (column_name column_type [{NULL | NOT NULL}] [,...]) + | LIKE source_table_name + } + [CLUSTER BY ...] + ; + +Examples +************** +This section includes the following examples of duplicating the column structure of an existing table using the ``LIKE`` clause: + +.. contents:: + :local: + :depth: 3 + +Creating a Table Using an Explicit Column List +~~~~~~~~~~~~ +The following is an example of creating a table using an explict column list: + +.. code-block:: postgres + + CREATE TABLE t1(x int default 0 not null, y text(10) null); + +Creating a Second Table Based on the Structure of Another Table +~~~~~~~~~~~~ +Either of the following examples can be used to create a second table based on the structure of another table. + +**Example 1** + +.. code-block:: postgres + + CREATE TABLE t2 LIKE t1; + +**Example 2** + +.. code-block:: postgres + + CREATE TABLE t2(x int default 0 not null, y text(10) null); + +The generated output of both of the statements above is identical. + +Creating a Table based on External Tables and Views +~~~~~~~~~~~~ +The following is example of creating a table based on external tables and views: + + +.. code-block:: postgres + + CREATE VIEW v as SELECT x+1,y,y || 'abc' from t1; + CREATE TABLE t3 LIKE v; + +When duplicating the column structure of an existing table, the target table of the ``LIKE`` clause can be a regular or an external table, or a view. + +The following table describes the properties that must be copied from the target table: + ++-----------------------------+------------------+---------------------------------+---------------------------------+ +| **Property** | **Native Table** | **External Table** | **View** | ++-----------------------------+------------------+---------------------------------+---------------------------------+ +| Column names | Must be copied | Must be copied | Must be copied | ++-----------------------------+------------------+---------------------------------+---------------------------------+ +| Column types | Must be copied | Must be copied | Must be copied | ++-----------------------------+------------------+---------------------------------+---------------------------------+ +| ``NULL``/``NOT NULL`` | Must be copied | Must be copied | Must be copied | ++-----------------------------+------------------+---------------------------------+---------------------------------+ +| ``text`` length constraints | Must be copied | Must be copied | Does not exist in source object | ++-----------------------------+------------------+---------------------------------+---------------------------------+ +| Compression specification | Must be copied | Does not exist in source object | Does not exist in source object | ++-----------------------------+------------------+---------------------------------+---------------------------------+ +| Default/identity | Must be copied | Does not exist in source object | Does not exist in source object | ++-----------------------------+------------------+---------------------------------+---------------------------------+ + +Permissions +============= +The role must have the ``CREATE`` permission at the schema level. diff --git a/reference/sql/sql_statements/ddl_commands/create_table_as.rst b/reference/sql/sql_statements/ddl_commands/create_table_as.rst new file mode 100644 index 000000000..c0d941f21 --- /dev/null +++ b/reference/sql/sql_statements/ddl_commands/create_table_as.rst @@ -0,0 +1,96 @@ +.. _create_table_as: + +***************** +CREATE TABLE AS +***************** + +The ``CREATE TABLE AS`` commands creates a new table from the result of a select query. + + +Syntax +========== +The following is the correct syntax for creating a table from the result of a select query: + + +.. CREATE [ OR REPLACE ] TABLE [schema_name].table_name ( +.. { column_def [, ...] } +.. ) AS query + +.. code-block:: postgres + + create_table_statement ::= + CREATE [ OR REPLACE ] TABLE [schema_name].table_name AS query + ; + + schema_name ::= identifier + + table_name ::= identifier + + +.. _ctas_params: + +Parameters +============ +The following parameters can be used when creating a table from the result of a select query: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``OR REPLACE`` + - Create a new table, and overwrite any existing table by the same name. Does not return an error if the table already exists. ``CREATE OR REPLACE`` does not check the table contents or structure, only the table name. + * - ``schema_name`` + - The name of the schema in which to create the table. + * - ``table_name`` + - The name of the table to create, which must be unique inside the schema. + * - ``query`` + - A select query that returns data + +.. * - ``column_def`` +.. - A comma separated list of column definitions. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally. + +Permissions +============= +The role must have the ``CREATE`` permission at the schema level, as well as ``SELECT`` permissions for any tables referenced by the statement. + + +Examples +=========== +This section includes the following examples: + +.. contents:: + :local: + :depth: 1 + +Creating a Copy of a Foreign Table or View +--------------------------------------------------------------------------- + +.. code-block:: postgres + + CREATE TABLE users AS SELECT * FROM users_source; + +For more information, see :ref:`CREATE FOREIGN TABLE `. + +Filtering +------------ + +.. code-block:: postgres + + CREATE TABLE users_uk AS SELECT * FROM users WHERE country = 'United Kingdom'; + +Adding Columns +----------------------- + +.. code-block:: postgres + + CREATE TABLE users_uk_new AS SELECT GETDATE() as "Date",*,false as is_new FROM users_uk; + +Creating a Table From Values +----------------------------------------- + +.. code-block:: postgres + + CREATE TABLE new_users + AS VALUES(GETDATE(),'Richard','Foxworthy','1984-03-03',True) diff --git a/reference/sql/sql_statements/ddl_commands/create_view.rst b/reference/sql/sql_statements/ddl_commands/create_view.rst new file mode 100644 index 000000000..4c6a98427 --- /dev/null +++ b/reference/sql/sql_statements/ddl_commands/create_view.rst @@ -0,0 +1,79 @@ +.. _create_view: + +***************** +CREATE VIEW +***************** + +``CREATE VIEW`` creates a new view in an existing database. A view is a virtual table. + +.. tip:: + * Use views to simplify complex queries or present only partial data to specific roles. + * If an underlying table has changed (new columns, changed names, etc.) - a view may be invalidated. To recompile the view, see :ref:`SELECT RECOMPILE_VIEW(\)` + + +Permissions +============= + +The role must have the ``CREATE`` permission at the database level, as well as ``SELECT`` permissions for any tables referenced by the view. + +Syntax +========== + +.. code-block:: postgres + + create_view_statement ::= + CREATE VIEW [schema_name].view_name [ column_list ] + AS + query + ; + + schema_name ::= identifier + + view_name ::= identifier + + column_list ::= ( { column_name [, ...] } ) + + column_name ::= identifier + + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``schema_name`` + - The name of the schema in which to create the view. + * - ``view_name`` + - The name of the view to create, which must be unique inside the schema. + * - ``column_list`` + - An optional comma separated list of column names for the view. If specified, these column names will override the column names in the response of the query in the ``AS query`` statement. + * - ``AS query`` + - The select query to execute when the view is referenced. + +.. * - ``OR REPLACE`` +.. - Create a new view, and overwrite any existing views by the same name. Does not return an error if the view already exists. + +Examples +=========== + +A simple view +----------------- + +.. code-block:: postgres + + CREATE VIEW only_agressive_animals AS + SELECT * FROM cool_animals WHERE is_agressive=true; + + SELECT * FROM only_agressive_animals; + +Overriding default column names +--------------------------------- + +.. code-block:: postgres + + CREATE VIEW only_relaxed_animals (animal_id, animal_name, should_i_worry) AS + SELECT id, name, is_agressive FROM cool_animals WHERE is_agressive=false; diff --git a/reference/sql/sql_statements/ddl_commands/drop_clustering_key.rst b/reference/sql/sql_statements/ddl_commands/drop_clustering_key.rst new file mode 100644 index 000000000..06cb848ad --- /dev/null +++ b/reference/sql/sql_statements/ddl_commands/drop_clustering_key.rst @@ -0,0 +1,64 @@ +.. _drop_clustering_key: + +********************** +DROP CLUSTERING KEY +********************** + +``DROP CLUSTERING KEY`` drops all clustering keys in a table. + +Read our :ref:`data_clustering` guide for more information. + +See also: :ref:`cluster_by`, :ref:`create_table`. + + +Permissions +============= + +The role must have the ``DDL`` permission at the database or table level. + +Syntax +========== + +.. code-block:: postgres + + alter_table_rename_table_statement ::= + ALTER TABLE [schema_name.]table_name DROP CLUSTERING KEY + ; + + table_name ::= identifier + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``schema_name`` + - The schema name for the table. Defaults to ``public`` if not specified. + * - ``table_name`` + - The table name to apply the change to. + +Usage notes +================= + +Removing clustering keys does not affect existing data. + +To force data to re-cluster, the table has to be recreated (i.e. with :ref:`create_table_as`). + + + + +Examples +=========== + +Dropping clustering keys in a table +----------------------------------------- + +.. code-block:: postgres + + ALTER TABLE public.users DROP CLUSTERING KEY + + diff --git a/reference/sql/sql_statements/ddl_commands/drop_column.rst b/reference/sql/sql_statements/ddl_commands/drop_column.rst new file mode 100644 index 000000000..f4c4e4504 --- /dev/null +++ b/reference/sql/sql_statements/ddl_commands/drop_column.rst @@ -0,0 +1,63 @@ +.. _drop_column: + +********************** +DROP COLUMN +********************** + +``DROP COLUMN`` can be used to remove columns from a table. + +Permissions +============= + +The role must have the ``DDL`` permission at the database or table level. + +Syntax +========== + +.. code-block:: postgres + + alter_table_drop_column_statement ::= + ALTER TABLE [schema_name.]table_name DROP COLUMN column_name + ; + + table_name ::= identifier + + schema_name ::= identifier + + column_name ::= identifier + + + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``schema_name`` + - The schema name for the table. Defaults to ``public`` if not specified. + * - ``table_name`` + - The table name to apply the change to. + * - ``column_name`` + - The column to remove. + +Examples +=========== + +Removing a column +----------------------------------------- + +.. code-block:: postgres + + -- Remove the 'weight' column + ALTER TABLE users DROP COLUMN weight; + +Removing a column with a quoted identifier name +---------------------------------------------------- + +.. code-block:: postgres + + ALTER TABLE users DROP COLUMN "Weight in kilograms"; \ No newline at end of file diff --git a/reference/sql/sql_statements/ddl_commands/drop_database.rst b/reference/sql/sql_statements/ddl_commands/drop_database.rst new file mode 100644 index 000000000..f45b0a5c4 --- /dev/null +++ b/reference/sql/sql_statements/ddl_commands/drop_database.rst @@ -0,0 +1,63 @@ +.. _drop_database: + +********************** +DROP DATABASE +********************** + +``DROP DATABASE`` can be used to remove a database and all of its objects. + +Permissions +============= + +The role must have the ``DDL`` permission at the database level. + +Syntax +========== + +.. code-block:: postgres + + drop_database_statement ::= + DROP DATABASE database_name + ; + + database_name ::= identifier + + + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``database_name`` + - The name of the database to drop. This can not be the current database in use. + +Examples +=========== + +Dropping a database and all of its objects +--------------------------------------------- + +.. code-block:: psql + + master=> DROP DATABASE raviga; + executed + + +Dropping the current database +-------------------------------- + +The current database in use can't be dropped. Switch to another database first. + +.. code-block:: psql + + raviga=> DROP DATABASE raviga; + Current open database 'raviga' cannot be dropped. + + raviga=> \c master + master=> DROP DATABASE raviga; + executed \ No newline at end of file diff --git a/reference/sql/sql_statements/ddl_commands/drop_function.rst b/reference/sql/sql_statements/ddl_commands/drop_function.rst new file mode 100644 index 000000000..98b957ad8 --- /dev/null +++ b/reference/sql/sql_statements/ddl_commands/drop_function.rst @@ -0,0 +1,66 @@ +.. _drop_function: + +********************** +DROP FUNCTION +********************** + +``DROP FUNCTION`` can be used to remove a user defined function. + +Permissions +============= + +The role must have the ``DDL`` permission at the database level. + +Syntax +========== + +.. code-block:: postgres + + drop_function_statement ::= + DROP FUNCTION [ IF EXISTS ] function_name(); + ; + + function_name ::= identifier + + + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``IF EXISTS`` + - Drop the function if it exists. Does not error if the function does not exist. + * - ``function_name()`` + - The name of the function to drop. + +Examples +=========== + +Dropping a function +--------------------------------------------- + +.. code-block:: postgres + + DROP FUNCTION my_distance(); + + +Dropping a function (always succeeds) +------------------------------------- + +.. code-block:: psql + + farm=> DROP FUNCTION my_distance(); + executed + + farm=> DROP FUNCTION my_distance(); + Function 'my_distance' not found + + -- This will succeed, even though the function does not exist + farm=> DROP FUNCTION IF EXISTS my_distance(); + executed + diff --git a/reference/sql/sql_statements/ddl_commands/drop_schema.rst b/reference/sql/sql_statements/ddl_commands/drop_schema.rst new file mode 100644 index 000000000..0f2dfd454 --- /dev/null +++ b/reference/sql/sql_statements/ddl_commands/drop_schema.rst @@ -0,0 +1,77 @@ +.. _drop_schema: + +********************** +DROP SCHEMA +********************** + +``DROP SCHEMA`` can be used to remove a schema. + +The schema has to be empty before removal. + +SQream DB does not support dropping a schema with objects. + +See also: :ref:`create_schema`, :ref:`alter_default_schema`. + +Permissions +============= + +The role must have the ``DDL`` permission at the database level. + +Syntax +========== + +.. code-block:: postgres + + drop_schema_statement ::= + DROP SCHEMA schema_name + ; + + schema_name ::= identifier + + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``schema_name`` + - The name of the schema to drop + +Examples +=========== + +Dropping a schema +--------------------------------------------- + +.. code-block:: postgres + + DROP SCHEMA test; + +Dropping a schema if it's not empty +---------------------------------------------- + +If a schema contains several tables, SQream DB will alert you that these tables need to be dropped first. + +This prevents accidental dropping of full schemas. + +.. code-block:: psql + + t=> DROP SCHEMA test; + Schema 'test' contains the following objects: + Tables - 'test.foo' , 'test.bar' + Please drop its content and then try again. + +To drop the schema, drop the schema's tables first, and then drop the schema: + +.. code-block:: psql + + t=> DROP TABLE test.foo; + executed + t=> DROP TABLE test.bar; + executed + t=> DROP SCHEMA test; + executed \ No newline at end of file diff --git a/reference/sql/sql_statements/ddl_commands/drop_table.rst b/reference/sql/sql_statements/ddl_commands/drop_table.rst new file mode 100644 index 000000000..53fdc8445 --- /dev/null +++ b/reference/sql/sql_statements/ddl_commands/drop_table.rst @@ -0,0 +1,70 @@ +.. _drop_table: + +********************** +DROP TABLE +********************** + +``DROP TABLE`` can be used to remove a table and all of its contents. + +Permissions +============= + +The role must have the ``DDL`` permission at the database or table level. + +Syntax +========== + +.. code-block:: postgres + + drop_table_statement ::= + DROP TABLE [ IF EXISTS ] [schema_name.]table_name + ; + + table_name ::= identifier + + schema_name ::= identifier + + + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``IF EXISTS`` + - Drop the table if it exists. Does not error if the table does not exist. + * - ``schema_name`` + - The name of the schema from which to drop the table. + * - ``table_name`` + - The name of the table to drop. + +Examples +=========== + +Dropping a table +--------------------------------------------- + +.. code-block:: postgres + + DROP TABLE cool_animals; + + +Dropping a table (always succeeds) +------------------------------------- + +.. code-block:: psql + + farm=> DROP TABLE cool_animals; + executed + + farm=> DROP TABLE cool_animals; + Table 'public.cool_animals' not found + + -- This will succeed, even though the table does not exist + farm=> DROP TABLE IF EXISTS cool_animals; + executed + diff --git a/reference/sql/sql_statements/ddl_commands/drop_view.rst b/reference/sql/sql_statements/ddl_commands/drop_view.rst new file mode 100644 index 000000000..6e18254e6 --- /dev/null +++ b/reference/sql/sql_statements/ddl_commands/drop_view.rst @@ -0,0 +1,72 @@ +.. _drop_view: + +********************** +DROP VIEW +********************** + +``DROP VIEW`` can be used to remove a view. + +Because a view is logical, this does not affect any data in any of the referenced tables. + +Permissions +============= + +The role must have the ``DDL`` permission at the database level. + +Syntax +========== + +.. code-block:: postgres + + drop_view_statement ::= + DROP VIEW [ IF EXISTS ] [schema_name.]view_name + ; + + view_name ::= identifier + + schema_name ::= identifier + + + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``IF EXISTS`` + - Drop the view if it exists. Does not error if the view does not exist. + * - ``schema_name`` + - The name of the schema from which to drop the view. + * - ``view_name`` + - The name of the view to drop. + +Examples +=========== + +Dropping a table +--------------------------------------------- + +.. code-block:: postgres + + DROP VIEW angry_animals; + + +Dropping a view (always succeeds) +------------------------------------- + +.. code-block:: psql + + farm=> DROP VIEW angry_animals; + executed + + farm=> DROP VIEW angry_animals; + View 'public.angry_animals' not found + + -- This will succeed, even though the view does not exist + farm=> DROP VIEW IF EXISTS angry_animals; + executed + diff --git a/reference/sql/sql_statements/ddl_commands/rename_column.rst b/reference/sql/sql_statements/ddl_commands/rename_column.rst new file mode 100644 index 000000000..41f1e1628 --- /dev/null +++ b/reference/sql/sql_statements/ddl_commands/rename_column.rst @@ -0,0 +1,65 @@ +.. _rename_column: + +********************** +RENAME COLUMN +********************** + +``RENAME COLUMN`` can be used to rename columns in a table. + +Permissions +============= + +The role must have the ``DDL`` permission at the database or table level. + +Syntax +========== + +.. code-block:: postgres + + alter_table_rename_column_statement ::= + ALTER TABLE [schema_name.]table_name RENAME COLUMN current_name TO new_name + ; + + table_name ::= identifier + + schema_name ::= identifier + + current_name ::= identifier + + new_name ::= identifier + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``schema_name`` + - The schema name for the table. Defaults to ``public`` if not specified. + * - ``table_name`` + - The table name to apply the change to. + * - ``current_name`` + - The column to rename. + * - ``new_name`` + - The new column name. + +Examples +=========== + +Renaming a column +----------------------------------------- + +.. code-block:: postgres + + -- Remove the 'weight' column + ALTER TABLE users RENAME COLUMN weight TO mass; + +Renaming a quoted name +-------------------------- + +.. code-block:: postgres + + ALTER TABLE users RENAME COLUMN "mass" TO "Mass (Kilograms); \ No newline at end of file diff --git a/reference/sql/sql_statements/ddl_commands/rename_table.rst b/reference/sql/sql_statements/ddl_commands/rename_table.rst new file mode 100644 index 000000000..96cc7102e --- /dev/null +++ b/reference/sql/sql_statements/ddl_commands/rename_table.rst @@ -0,0 +1,57 @@ +.. _rename_table: + +********************** +RENAME TABLE +********************** + +``RENAME TABLE`` can be used to rename a table. + +.. warning:: Renaming a table can void existing views that use this table. See more about :ref:`recompiling views `. + +Permissions +============= + +The role must have the ``DDL`` permission at the database or table level. + +Syntax +========== + +.. code-block:: postgres + + alter_table_rename_table_statement ::= + ALTER TABLE [schema_name.]current_name RENAME TO new_name + ; + + current_name ::= identifier + + schema_name ::= identifier + + new_name ::= identifier + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``schema_name`` + - The schema name for the table. Defaults to ``public`` if not specified. + * - ``current_name`` + - The table name to apply the change to. + * - ``new_name`` + - The new table name. + +Examples +=========== + +Renaming a table +----------------------------------------- + +.. code-block:: postgres + + ALTER TABLE public.users RENAME TO former_users; + + diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index 9525955d2..a8e27cb6e 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -18,48 +18,48 @@ Data Definition Commands (DDL) * - Command - Usage - * - `ADD COLUMN `_ - - Add a new column to a table - * - `ALTER DEFAULT SCHEMA `_ - - Change the default schema for a role - * - `ALTER TABLE `_ - - Change the schema of a table - * - `CLUSTER BY `_ - - Change clustering keys in a table - * - `CREATE DATABASE `_ - - Create a new database - * - `CREATE EXTERNAL TABLE `_ - - Create a new external table in the database (deprecated) - * - `CREATE FOREIGN TABLE `_ - - Create a new foreign table in the database - * - `CREATE FUNCTION `_ - - Create a new user defined function in the database - * - `CREATE SCHEMA `_ - - Create a new schema in the database - * - `CREATE TABLE `_ - - Create a new table in the database - * - `CREATE TABLE AS `_ - - Create a new table in the database using results from a select query - * - `CREATE VIEW `_ - - Create a new view in the database - * - `DROP CLUSTERING KEY `_ - - Drops all clustering keys in a table - * - `DROP COLUMN `_ - - Drop a column from a table - * - `DROP DATABASE `_ - - Drop a database and all of its objects - * - `DROP FUNCTION `_ - - Drop a function - * - `DROP SCHEMA `_ - - Drop a schema - * - `DROP TABLE `_ - - Drop a table and its contents from a database - * - `DROP VIEW `_ - - Drop a view - * - `RENAME COLUMN `_ - - Rename a column - * - `RENAME TABLE `_ - - Rename a table + * - :ref:`add_column` + - Add a new column to a table + * - :ref:`alter_default_schema` + - Change the default schema for a role + * - :ref:`alter_table` + - Change the schema of a table + * - :ref:`cluster_by` + - Change clustering keys in a table + * - :ref:`create_database` + - Create a new database + * - :ref:`create_external_table` + - Create a new external table in the database (deprecated) + * - :ref:`create_foreign_table` + - Create a new foreign table in the database + * - :ref:`create_function` + - Create a new user defined function in the database + * - :ref:`create_schema` + - Create a new schema in the database + * - :ref:`create_table` + - Create a new table in the database + * - :ref:`create_table_as` + - Create a new table in the database using results from a select query + * - :ref:`create_view` + - Create a new view in the database + * - :ref:`drop_clustering_key` + - Drops all clustering keys in a table + * - :ref:`drop_column` + - Drop a column from a table + * - :ref:`drop_database` + - Drop a database and all of its objects + * - :ref:`drop_function` + - Drop a function + * - :ref:`drop_schema` + - Drop a schema + * - :ref:`drop_table` + - Drop a table and its contents from a database + * - :ref:`drop_view` + - Drop a view + * - :ref:`rename_column` + - Rename a column + * - :ref:`rename_table` + - Rename a table Data Manipulation Commands (DML) ================================ From e0d71c1e5b4446c14b394d10da6ecde5e9393316 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 27 Mar 2022 17:23:31 +0300 Subject: [PATCH 022/882] Updated Menus Used new menu documentation method. --- .../sql_functions/scalar_functions/index.rst | 3 -- .../sql_functions/system_functions/index.rst | 19 +++++----- .../user_defined_functions/index.rst | 21 +++-------- .../sql_functions/window_functions/index.rst | 35 ++++++++----------- reference/sql/sql_statements/index.rst | 16 +-------- reference/sql/sql_syntax/index.rst | 24 ++++++------- 6 files changed, 40 insertions(+), 78 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/index.rst b/reference/sql/sql_functions/scalar_functions/index.rst index b21071021..bd05f9bbe 100644 --- a/reference/sql/sql_functions/scalar_functions/index.rst +++ b/reference/sql/sql_functions/scalar_functions/index.rst @@ -3,13 +3,10 @@ **************** Built-In Scalar Functions **************** -FF - The **Built-In Scalar Functions** page describes functions that return one value per call: .. hlist:: :columns: 5 - * `AND `_ * `NOT `_ diff --git a/reference/sql/sql_functions/system_functions/index.rst b/reference/sql/sql_functions/system_functions/index.rst index a27dfda62..ba99610ba 100644 --- a/reference/sql/sql_functions/system_functions/index.rst +++ b/reference/sql/sql_functions/system_functions/index.rst @@ -7,14 +7,13 @@ System Functions The System Functions page describes the following: -.. toctree:: - :maxdepth: 1 - :glob: +.. hlist:: + :columns: 1 - explain - show_version - show_connections - show_locks - show_node_info - show_server_status - stop_statement \ No newline at end of file + * :ref:`explain` + * :ref:`show_version` + * :ref:`show_connections` + * :ref:`show_locks` + * :ref:`show_node_info` + * :ref:`show_server_status` + * :ref:`stop_statement` \ No newline at end of file diff --git a/reference/sql/sql_functions/user_defined_functions/index.rst b/reference/sql/sql_functions/user_defined_functions/index.rst index 225c9614e..028e35a07 100644 --- a/reference/sql/sql_functions/user_defined_functions/index.rst +++ b/reference/sql/sql_functions/user_defined_functions/index.rst @@ -4,22 +4,9 @@ User-Defined Functions ******************** -The following user-defined functions are functions that can be defined and configured by users: +The following user-defined functions are functions that can be defined and configured by users. +The **User-Defined Functions** page describes the following: - -* `Python user-defined functions `_. -* `Scalar SQL user-defined functions `_. - - - - -.. toctree:: - :maxdepth: 8 - :glob: - :hidden: - - - - python_functions - scalar_sql_udf +* `Python user-defined functions `_ +* `Scalar SQL user-defined functions `_ \ No newline at end of file diff --git a/reference/sql/sql_functions/window_functions/index.rst b/reference/sql/sql_functions/window_functions/index.rst index 4061ad239..e949e0e3c 100644 --- a/reference/sql/sql_functions/window_functions/index.rst +++ b/reference/sql/sql_functions/window_functions/index.rst @@ -4,26 +4,21 @@ Window Functions ******************** -Window functions are functions applied over a subset (known as a window) of the rows returned by a :ref:`select` query. +Window functions are functions applied over a subset (known as a window) of the rows returned by a :ref:`select` query and describes the following: -Read more about :ref:`window_functions` in the :ref:`sql_syntax` section. - -.. toctree:: - :maxdepth: 1 - :caption: Window Functions: - :glob: - :hidden: +.. hlist:: + :columns: 1 - lag - lead - row_number - rank - first_value - last_value - nth_value - dense_rank - percent_rank - cume_dist - ntile - + * :ref:`lag` + * :ref:`lead` + * :ref:`row_number` + * :ref:`rank` + * :ref:`first_value` + * :ref:`last_value` + * :ref:`nth_value` + * :ref:`dense_rank` + * :ref:`percent_rank` + * :ref:`cume_dist` + * :ref:`ntile` +For more information, see :ref:`window_functions` in the :ref:`sql_syntax` section. \ No newline at end of file diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index a8e27cb6e..bede1de2e 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -204,18 +204,4 @@ Access Control Commands * - :ref:`revoke` - Revoke permissions from a role * - :ref:`rename_role` - - Rename a role - - -.. toctree:: - :maxdepth: 1 - :titlesonly: - :hidden: - :glob: - - ddl_commands/* - dml_commands/* - utility_commands/* - monitoring_commands/* - wlm_commands/* - access_control_commands/* \ No newline at end of file + - Rename a role \ No newline at end of file diff --git a/reference/sql/sql_syntax/index.rst b/reference/sql/sql_syntax/index.rst index 90caf01e5..9e0422db4 100644 --- a/reference/sql/sql_syntax/index.rst +++ b/reference/sql/sql_syntax/index.rst @@ -4,18 +4,16 @@ SQL Syntax Features ********************** -SQream DB supports SQL from the ANSI 92 syntax. +SQream DB supports SQL from the ANSI 92 syntax and describes the following: -.. toctree:: - :maxdepth: 2 - :caption: SQL Syntax Topics - :glob: +.. hlist:: + :columns: 1 - keywords_and_identifiers - literals - scalar_expressions - joins - common_table_expressions - window_functions - subqueries - null_handling + * :ref:`keywords_and_identifiers` + * :ref:`literals` + * :ref:`scalar_expressions` + * :ref:`joins` + * :ref:`common_table_expressions` + * :ref:`window_functions` + * :ref:`subqueries` + * :ref:`null_handling` \ No newline at end of file From e3dcb2d92dbf1c7415bf5dcb95dc9978ab7d77bf Mon Sep 17 00:00:00 2001 From: YanivGerowitz <82020437+YanivGerowitz@users.noreply.github.com> Date: Mon, 28 Mar 2022 14:33:25 +0300 Subject: [PATCH 023/882] Update running_sqream_in_a_docker_container.rst --- .../running_sqream_in_a_docker_container.rst | 40 ++++++++----------- 1 file changed, 16 insertions(+), 24 deletions(-) diff --git a/installation_guides/running_sqream_in_a_docker_container.rst b/installation_guides/running_sqream_in_a_docker_container.rst index 040223936..8e42c910d 100644 --- a/installation_guides/running_sqream_in_a_docker_container.rst +++ b/installation_guides/running_sqream_in_a_docker_container.rst @@ -1,7 +1,5 @@ .. _running_sqream_in_a_docker_container: - - *********************** Installing and Running SQream in a Docker Container *********************** @@ -519,19 +517,15 @@ Installing the Docker Engine on an IBM Power9 Processor ---------------------------------------- The x86_64 processor only supports installing the **Docker Community Edition (CE)** version 18.03. - **To install the Docker Engine on an IBM Power9 processor:** You can install the Docker Engine on an IBM Power9 processor by running the following command: .. code-block:: console - $ wget http://ftp.unicamp.br/pub/ppc64el/rhel/7_1/docker-ppc64el/container-selinux-2.9-4.el7.noarch.rpm - $ wget http://ftp.unicamp.br/pub/ppc64el/rhel/7_1/docker-ppc64el/docker-ce-18.03.1.ce-1.el7.centos.ppc64le.rpm - $ yum install -y container-selinux-2.9-4.el7.noarch.rpm - $ docker-ce-18.03.1.ce-1.el7.centos.ppc64le.rpm - - + wget http://ftp.unicamp.br/pub/ppc64el/rhel/7_1/docker-ppc64el/container-selinux-2.9-4.el7.noarch.rpm + wget http://ftp.unicamp.br/pub/ppc64el/rhel/7_1/docker-ppc64el/docker-ce-18.03.1.ce-1.el7.centos.ppc64le.rpm + yum install -y container-selinux-2.9-4.el7.noarch.rpm docker-ce-18.03.1.ce-1.el7.centos.ppc64le.rpm For more information on installing the Docker Engine CE on an IBM Power9 processor, see `Install Docker Engine on Ubuntu `_. @@ -576,8 +570,8 @@ After configuring Docker on your local machine you must install the Nvidia Docke This section describes the following: -* :ref:`Installing the NVIDIA Docker2 Toolkit on an x86_64 processor. ` -* :ref:`Installing the NVIDIA Docker2 Toolkit on a PPC64le processor. ` +* :ref:`Installing the NVIDIA Docker2 Toolkit on an x86_64 processor ` +* :ref:`Installing the NVIDIA Docker2 Toolkit on a PPC64le processor ` .. _install_nvidia_docker2_toolkit_x8664_processor: @@ -601,10 +595,9 @@ Installing the NVIDIA Docker2 Toolkit on a CentOS Operating System .. code-block:: console - $ distribution=$(. /etc/os-release;echo $ID$VERSION_ID) - $ curl -s -L - $ https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.repo | \ - $ sudo tee /etc/yum.repos.d/nvidia-docker.repo + distribution=$(. /etc/os-release;echo $ID$VERSION_ID) + curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.repo | \ + sudo tee /etc/yum.repos.d/nvidia-docker.repo 2. Install the ``nvidia-docker2`` package and reload the Docker daemon configuration: @@ -654,13 +647,10 @@ Installing the NVIDIA Docker2 Toolkit on an Ubuntu Operating System .. code-block:: console - $ curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | \ - $ sudo apt-key add - - $ distribution=$(. /etc/os-release;echo $ID$VERSION_ID) - $ curl -s -L - $ https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | \ - $ sudo tee /etc/apt/sources.list.d/nvidia-docker.list - $ sudo apt-get update + curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add - + distribution=$(. /etc/os-release;echo $ID$VERSION_ID) + curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list + sudo apt-get update 2. Install the ``nvidia-docker2`` package and reload the Docker daemon configuration: @@ -668,7 +658,9 @@ Installing the NVIDIA Docker2 Toolkit on an Ubuntu Operating System $ sudo apt-get install nvidia-docker2 $ sudo pkill -SIGHUP dockerd + 3. Do one of the following: + * If you received an error when installing the ``nvidia-docker2`` package, skip to :ref:`Step 4 `. * If you successfully installed the ``nvidia-docker2`` package, skip to :ref:`Step 5 `. @@ -795,8 +787,8 @@ For more information about the correct directory to copy the above files into, s For related information, see the following sections: -* :ref:`Configuring the Hadoop and Kubernetes Configuration Files `. -* :ref:`Setting the Hadoop and Kubernetes Configuration Parameters `. +* :ref:`Configuring the Hadoop and Kubernetes Configuration Files ` +* :ref:`Setting the Hadoop and Kubernetes Configuration Parameters ` .. _installing_sqream_software: From 96086da570ac664009d04d989aa9541ff084ed3d Mon Sep 17 00:00:00 2001 From: YanivGerowitz <82020437+YanivGerowitz@users.noreply.github.com> Date: Mon, 28 Mar 2022 14:33:38 +0300 Subject: [PATCH 024/882] Update running_sqream_in_a_docker_container.rst --- .../running_sqream_in_a_docker_container.rst | 40 ++++++++----------- 1 file changed, 16 insertions(+), 24 deletions(-) diff --git a/installation_guides/running_sqream_in_a_docker_container.rst b/installation_guides/running_sqream_in_a_docker_container.rst index 040223936..8e42c910d 100644 --- a/installation_guides/running_sqream_in_a_docker_container.rst +++ b/installation_guides/running_sqream_in_a_docker_container.rst @@ -1,7 +1,5 @@ .. _running_sqream_in_a_docker_container: - - *********************** Installing and Running SQream in a Docker Container *********************** @@ -519,19 +517,15 @@ Installing the Docker Engine on an IBM Power9 Processor ---------------------------------------- The x86_64 processor only supports installing the **Docker Community Edition (CE)** version 18.03. - **To install the Docker Engine on an IBM Power9 processor:** You can install the Docker Engine on an IBM Power9 processor by running the following command: .. code-block:: console - $ wget http://ftp.unicamp.br/pub/ppc64el/rhel/7_1/docker-ppc64el/container-selinux-2.9-4.el7.noarch.rpm - $ wget http://ftp.unicamp.br/pub/ppc64el/rhel/7_1/docker-ppc64el/docker-ce-18.03.1.ce-1.el7.centos.ppc64le.rpm - $ yum install -y container-selinux-2.9-4.el7.noarch.rpm - $ docker-ce-18.03.1.ce-1.el7.centos.ppc64le.rpm - - + wget http://ftp.unicamp.br/pub/ppc64el/rhel/7_1/docker-ppc64el/container-selinux-2.9-4.el7.noarch.rpm + wget http://ftp.unicamp.br/pub/ppc64el/rhel/7_1/docker-ppc64el/docker-ce-18.03.1.ce-1.el7.centos.ppc64le.rpm + yum install -y container-selinux-2.9-4.el7.noarch.rpm docker-ce-18.03.1.ce-1.el7.centos.ppc64le.rpm For more information on installing the Docker Engine CE on an IBM Power9 processor, see `Install Docker Engine on Ubuntu `_. @@ -576,8 +570,8 @@ After configuring Docker on your local machine you must install the Nvidia Docke This section describes the following: -* :ref:`Installing the NVIDIA Docker2 Toolkit on an x86_64 processor. ` -* :ref:`Installing the NVIDIA Docker2 Toolkit on a PPC64le processor. ` +* :ref:`Installing the NVIDIA Docker2 Toolkit on an x86_64 processor ` +* :ref:`Installing the NVIDIA Docker2 Toolkit on a PPC64le processor ` .. _install_nvidia_docker2_toolkit_x8664_processor: @@ -601,10 +595,9 @@ Installing the NVIDIA Docker2 Toolkit on a CentOS Operating System .. code-block:: console - $ distribution=$(. /etc/os-release;echo $ID$VERSION_ID) - $ curl -s -L - $ https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.repo | \ - $ sudo tee /etc/yum.repos.d/nvidia-docker.repo + distribution=$(. /etc/os-release;echo $ID$VERSION_ID) + curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.repo | \ + sudo tee /etc/yum.repos.d/nvidia-docker.repo 2. Install the ``nvidia-docker2`` package and reload the Docker daemon configuration: @@ -654,13 +647,10 @@ Installing the NVIDIA Docker2 Toolkit on an Ubuntu Operating System .. code-block:: console - $ curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | \ - $ sudo apt-key add - - $ distribution=$(. /etc/os-release;echo $ID$VERSION_ID) - $ curl -s -L - $ https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | \ - $ sudo tee /etc/apt/sources.list.d/nvidia-docker.list - $ sudo apt-get update + curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add - + distribution=$(. /etc/os-release;echo $ID$VERSION_ID) + curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list + sudo apt-get update 2. Install the ``nvidia-docker2`` package and reload the Docker daemon configuration: @@ -668,7 +658,9 @@ Installing the NVIDIA Docker2 Toolkit on an Ubuntu Operating System $ sudo apt-get install nvidia-docker2 $ sudo pkill -SIGHUP dockerd + 3. Do one of the following: + * If you received an error when installing the ``nvidia-docker2`` package, skip to :ref:`Step 4 `. * If you successfully installed the ``nvidia-docker2`` package, skip to :ref:`Step 5 `. @@ -795,8 +787,8 @@ For more information about the correct directory to copy the above files into, s For related information, see the following sections: -* :ref:`Configuring the Hadoop and Kubernetes Configuration Files `. -* :ref:`Setting the Hadoop and Kubernetes Configuration Parameters `. +* :ref:`Configuring the Hadoop and Kubernetes Configuration Files ` +* :ref:`Setting the Hadoop and Kubernetes Configuration Parameters ` .. _installing_sqream_software: From 2e9e91ce5627265a7186b6e1351099fbda087766 Mon Sep 17 00:00:00 2001 From: YanivGerowitz <82020437+YanivGerowitz@users.noreply.github.com> Date: Mon, 28 Mar 2022 14:47:15 +0300 Subject: [PATCH 025/882] Update running_sqream_in_a_docker_container.rst --- installation_guides/running_sqream_in_a_docker_container.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/installation_guides/running_sqream_in_a_docker_container.rst b/installation_guides/running_sqream_in_a_docker_container.rst index 8e42c910d..79caa9f8d 100644 --- a/installation_guides/running_sqream_in_a_docker_container.rst +++ b/installation_guides/running_sqream_in_a_docker_container.rst @@ -3,7 +3,7 @@ *********************** Installing and Running SQream in a Docker Container *********************** -The **Running SQream in a Docker Container** page describes how to prepare your machine's environment for installing and running SQream in a Docker container. +The **Installing and Running SQream in a Docker Container** page describes how to prepare your machine's environment for installing and running SQream in a Docker container. This page describes the following: @@ -102,7 +102,7 @@ You can install the required NTP packages by running the following command: .. code-block:: console - $ sudo yum install ntp pciutils python36 kernel-devel-$(uname -r) kernel-headers-$(uname -r) gcc + $ sudo yum install ntp pciutils python36 kernel-devel-$(uname -r) kernel-headers-$(uname -r) gcc Installing the Recommended Tools ---------------- From 2e48016372f05aa75032fc11670e9bc07fcdee7b Mon Sep 17 00:00:00 2001 From: YanivGerowitz <82020437+YanivGerowitz@users.noreply.github.com> Date: Mon, 28 Mar 2022 14:47:48 +0300 Subject: [PATCH 026/882] Update running_sqream_in_a_docker_container.rst --- installation_guides/running_sqream_in_a_docker_container.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/installation_guides/running_sqream_in_a_docker_container.rst b/installation_guides/running_sqream_in_a_docker_container.rst index 8e42c910d..79caa9f8d 100644 --- a/installation_guides/running_sqream_in_a_docker_container.rst +++ b/installation_guides/running_sqream_in_a_docker_container.rst @@ -3,7 +3,7 @@ *********************** Installing and Running SQream in a Docker Container *********************** -The **Running SQream in a Docker Container** page describes how to prepare your machine's environment for installing and running SQream in a Docker container. +The **Installing and Running SQream in a Docker Container** page describes how to prepare your machine's environment for installing and running SQream in a Docker container. This page describes the following: @@ -102,7 +102,7 @@ You can install the required NTP packages by running the following command: .. code-block:: console - $ sudo yum install ntp pciutils python36 kernel-devel-$(uname -r) kernel-headers-$(uname -r) gcc + $ sudo yum install ntp pciutils python36 kernel-devel-$(uname -r) kernel-headers-$(uname -r) gcc Installing the Recommended Tools ---------------- From d11076aa93cb435131a6a5708ded114e9e29f49a Mon Sep 17 00:00:00 2001 From: YanivGerowitz <82020437+YanivGerowitz@users.noreply.github.com> Date: Mon, 28 Mar 2022 15:04:08 +0300 Subject: [PATCH 027/882] Update running_sqream_in_a_docker_container.rst --- .../running_sqream_in_a_docker_container.rst | 16 +++------------- 1 file changed, 3 insertions(+), 13 deletions(-) diff --git a/installation_guides/running_sqream_in_a_docker_container.rst b/installation_guides/running_sqream_in_a_docker_container.rst index 79caa9f8d..aba0d109f 100644 --- a/installation_guides/running_sqream_in_a_docker_container.rst +++ b/installation_guides/running_sqream_in_a_docker_container.rst @@ -146,7 +146,7 @@ After configuring the NTP package you must configure the performance profile. **To configure the performance profile:** -1. Switch the active profile: +1. *Optional* - Switch the active profile: .. code-block:: console @@ -337,10 +337,6 @@ For installer type, SQream recommends selecting **runfile (local)**. The availab $ sudo systemctl enable nvidia-persistenced.service && sudo systemctl start nvidia-persistenced.service -6. Create a symbolic link from the **/etc/systemd/system/multi-user.target.wants/nvidia-persistenced.service** file to the **/usr/lib/systemd/system/nvidia-persistenced.service** file. - - :: - 7. Reboot the server. :: @@ -418,10 +414,6 @@ Installing the CUDA Driver Version 10.1 for IBM Power9 .. code-block:: console $ sudo systemctl enable nvidia-persistenced.service - -#. Create a symbolic link from the **/etc/systemd/system/multi-user.target.wants/nvidia-persistenced.service** file to the **/usr/lib/systemd/system/nvidia-persistenced.service** file. - - :: #. Reboot your system to initialize the above modifications. @@ -832,7 +824,7 @@ The **sqream_installer-nnn-DBnnn-COnnn-EDnnn-.tar.gz** file includes the f $ tar -xvf sqream_installer-1.1.5-DB2019.2.1-CO1.5.4-ED3.0.0-x86_64.tar.gz -When the tarball file has been extracted, a new folder will be created. The new folder is automatically given the name of the tarball file: + When the tarball file has been extracted, a new folder will be created. The new folder is automatically given the name of the tarball file: .. code-block:: console @@ -1247,7 +1239,7 @@ You can stop your SQream Studio by running the following command: The following is an example of the expected output: -.. code-block:: console +.. code-block:: sqream_admin stopped @@ -1256,8 +1248,6 @@ The following is an example of the expected output: Using the SQream Client ~~~~~~~~~~~~~~~~~ - - You can use the embedded SQream Client on the following nodes: * Master node From a9a152bb8f169bc0e4865bd27e09b327ed854c15 Mon Sep 17 00:00:00 2001 From: YanivGerowitz <82020437+YanivGerowitz@users.noreply.github.com> Date: Mon, 28 Mar 2022 15:11:06 +0300 Subject: [PATCH 028/882] Update running_sqream_in_a_docker_container.rst --- .../running_sqream_in_a_docker_container.rst | 198 +++++++++--------- 1 file changed, 99 insertions(+), 99 deletions(-) diff --git a/installation_guides/running_sqream_in_a_docker_container.rst b/installation_guides/running_sqream_in_a_docker_container.rst index aba0d109f..e85eac925 100644 --- a/installation_guides/running_sqream_in_a_docker_container.rst +++ b/installation_guides/running_sqream_in_a_docker_container.rst @@ -34,19 +34,19 @@ To run SQream in a Docker container you must create a local user. 1. Add a local user: - .. code-block:: console + .. code-block:: $ useradd -m -U 2. Set the local user's password: - .. code-block:: console + .. code-block:: $ passwd 3. Add the local user to the ``wheel`` group: - .. code-block:: console + .. code-block:: $ usermod -aG wheel @@ -62,13 +62,13 @@ After creating a local user you must set a local language. 1. Set the local language: - .. code-block:: console + .. code-block:: $ sudo localectl set-locale LANG=en_US.UTF-8 2. Set the time stamp (time and date) of the locale: - .. code-block:: console + .. code-block:: $ sudo timedatectl set-timezone Asia/Jerusalem @@ -84,13 +84,13 @@ After setting a local language you must add the EPEL repository. 1. RedHat (RHEL 7): - .. code-block:: console + .. code-block:: $ sudo rpm -Uvh http://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm 2. CentOS 7 - .. code-block:: console + .. code-block:: $ sudo yum install epel-release @@ -100,7 +100,7 @@ After adding the EPEL repository, you must install the required NTP packages. You can install the required NTP packages by running the following command: -.. code-block:: console +.. code-block:: $ sudo yum install ntp pciutils python36 kernel-devel-$(uname -r) kernel-headers-$(uname -r) gcc @@ -110,7 +110,7 @@ After installin gthe required NTP packages you must install the recommended tool SQream recommends installing the following recommended tools: -.. code-block:: console +.. code-block:: $ sudo yum install bash-completion.noarch vim-enhanced.x86_64 vim-common.x86_64 net-tools iotop htop psmisc screen xfsprogs wget yum-utils deltarpm dos2unix @@ -134,7 +134,7 @@ After updating to the current version of the operating system you must configure 2. Configure the **ntpd** service to begin running when your machine is started: - .. code-block:: console + .. code-block:: $ sudo systemctl enable ntpd $ sudo systemctl start ntpd @@ -148,13 +148,13 @@ After configuring the NTP package you must configure the performance profile. 1. *Optional* - Switch the active profile: - .. code-block:: console + .. code-block:: $ sudo tuned-adm profile throughput-performance 2. Change the multi-user's default run level: - .. code-block:: console + .. code-block:: $ sudo systemctl set-default multi-user.target @@ -166,19 +166,19 @@ After configuring the performance profile you must configure your security limit 1. Run the **bash** shell as a super-user: - .. code-block:: console + .. code-block:: $ sudo bash 2. Run the following command: - .. code-block:: console + .. code-block:: $ echo -e "sqream soft nproc 500000\nsqream hard nproc 500000\nsqream soft nofile 500000\nsqream hard nofile 500000\nsqream soft core unlimited\nsqream hard core unlimited" >> /etc/security/limits.conf 3. Run the following command: - .. code-block:: console + .. code-block:: $ echo -e "vm.dirty_background_ratio = 5 \n vm.dirty_ratio = 10 \n vm.swappiness = 10 \n vm.zone_reclaim_mode = 0 \n vm.vfs_cache_pressure = 200 \n" >> /etc/sysctl.conf @@ -194,7 +194,7 @@ After configuring your security limits you must disable the following automatic You can abort the above but-reporting tools by running the following command: -.. code-block:: console +.. code-block:: $ for i in abrt-ccpp.service abrtd.service abrt-oops.service abrt-pstoreoops.service abrt-vmcore.service abrt-xorg.service ; do sudo systemctl disable $i; sudo systemctl stop $i; done @@ -203,7 +203,7 @@ Installing the Nvidia CUDA Driver 1. Verify that the Tesla NVIDIA card has been installed and is detected by the system: - .. code-block:: console + .. code-block:: $ lspci | grep -i nvidia @@ -211,7 +211,7 @@ Installing the Nvidia CUDA Driver #. Verify that the open-source upstream Nvidia driver is running: - .. code-block:: console + .. code-block:: $ lsmod | grep nouveau @@ -221,7 +221,7 @@ Installing the Nvidia CUDA Driver 1. Disable the open-source upstream Nvidia driver: - .. code-block:: console + .. code-block:: $ sudo bash $ echo "blacklist nouveau" > /etc/modprobe.d/blacklist-nouveau.conf @@ -231,19 +231,19 @@ Installing the Nvidia CUDA Driver 2. Reboot the server and verify that the Nouveau model has not been loaded: - .. code-block:: console + .. code-block:: $ lsmod | grep nouveau #. Check if the Nvidia CUDA driver has already been installed: - .. code-block:: console + .. code-block:: $ nvidia-smi The following is an example of the correct output: - .. code-block:: console + .. code-block:: nvidia-smi Wed Oct 30 14:05:42 2019 @@ -310,14 +310,14 @@ For installer type, SQream recommends selecting **runfile (local)**. The availab 2. Download the base installer for Linux CentOS 7 x86_64: - .. code-block:: console + .. code-block:: wget http://developer.download.nvidia.com/compute/cuda/10.1/Prod/local_installers/cuda-repo-rhel7-10-1-local-10.1.243-418.87.00-1.0-1.x86_64.rpm 3. Install the base installer for Linux CentOS 7 x86_64 by running the following commands: - .. code-block:: console + .. code-block:: $ sudo yum localinstall cuda-repo-rhel7-10-1-local-10.1.243-418.87.00-1.0-1.x86_64.rpm $ sudo yum clean all @@ -333,7 +333,7 @@ For installer type, SQream recommends selecting **runfile (local)**. The availab 5. Enable the Nvidia service to start at boot and start it: - .. code-block:: console + .. code-block:: $ sudo systemctl enable nvidia-persistenced.service && sudo systemctl start nvidia-persistenced.service @@ -342,13 +342,13 @@ For installer type, SQream recommends selecting **runfile (local)**. The availab :: 8. Verify that the Nvidia driver has been installed and shows all available GPU's: - .. code-block:: console + .. code-block:: $ nvidia-smi The following is the correct output: - .. code-block:: console + .. code-block:: nvidia-smi Wed Oct 30 14:05:42 2019 @@ -381,14 +381,14 @@ Installing the CUDA Driver Version 10.1 for IBM Power9 1. Download the base installer for Linux CentOS 7 PPC64le: - .. code-block:: console + .. code-block:: wget http://developer.download.nvidia.com/compute/cuda/10.1/Prod/local_installers/cuda-repo-rhel7-10-1-local-10.1.243-418.87.00-1.0-1.ppc64le.rpm #. Install the base installer for Linux CentOS 7 x86_64 by running the following commands: - .. code-block:: console + .. code-block:: $ sudo rpm -i cuda-repo-rhel7-10-1-local-10.1.243-418.87.00-1.0-1.ppc64le.rpm $ sudo yum clean all @@ -404,14 +404,14 @@ Installing the CUDA Driver Version 10.1 for IBM Power9 4. If you are using RHEL 7 version (7.6 or later), comment out, remove, or change the hot-pluggable memory rule located in file copied to the **/etc/udev/rules.d** directory by running the following command: - .. code-block:: console + .. code-block:: $ sudo cp /lib/udev/rules.d/40-redhat.rules /etc/udev/rules.d $ sudo sed -i 's/SUBSYSTEM!="memory",.*GOTO="memory_hotplug_end"/SUBSYSTEM=="*", GOTO="memory_hotplug_end"/' /etc/udev/rules.d/40-redhat.rules #. Enable the **nvidia-persisted.service** file: - .. code-block:: console + .. code-block:: $ sudo systemctl enable nvidia-persistenced.service @@ -421,13 +421,13 @@ Installing the CUDA Driver Version 10.1 for IBM Power9 #. Verify that the Nvidia driver and the **nvidia-persistenced.service** files are running: - .. code-block:: console + .. code-block:: $ nvidia smi The following is the correct output: - .. code-block:: console + .. code-block:: nvidia-smi Wed Oct 30 14:05:42 2019 @@ -453,13 +453,13 @@ Installing the CUDA Driver Version 10.1 for IBM Power9 #. Verify that the **nvidia-persistenced** service is running: - .. code-block:: console + .. code-block:: $ systemctl status nvidia-persistenced The following is the correct output: - .. code-block:: console + .. code-block:: root@gpudb ~]systemctl status nvidia-persistenced nvidia-persistenced.service - NVIDIA Persistence Daemon @@ -513,7 +513,7 @@ The x86_64 processor only supports installing the **Docker Community Edition (CE You can install the Docker Engine on an IBM Power9 processor by running the following command: -.. code-block:: console +.. code-block:: wget http://ftp.unicamp.br/pub/ppc64el/rhel/7_1/docker-ppc64el/container-selinux-2.9-4.el7.noarch.rpm wget http://ftp.unicamp.br/pub/ppc64el/rhel/7_1/docker-ppc64el/docker-ce-18.03.1.ce-1.el7.centos.ppc64le.rpm @@ -529,13 +529,13 @@ After installing the Docker engine you must configure Docker on your local machi 1. Enable Docker to start on boot: - .. code-block:: console + .. code-block:: $ sudo systemctl enable docker && sudo systemctl start docker 2. Enable managing Docker as a non-root user: - .. code-block:: console + .. code-block:: $ sudo usermod -aG docker $USER @@ -545,7 +545,7 @@ After installing the Docker engine you must configure Docker on your local machi 4. Verify that you can run the following Docker command as a non-root user (without ``sudo``): - .. code-block:: console + .. code-block:: $ docker run hello-world @@ -585,7 +585,7 @@ Installing the NVIDIA Docker2 Toolkit on a CentOS Operating System 1. Install the repository for your distribution: - .. code-block:: console + .. code-block:: distribution=$(. /etc/os-release;echo $ID$VERSION_ID) curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.repo | \ @@ -593,7 +593,7 @@ Installing the NVIDIA Docker2 Toolkit on a CentOS Operating System 2. Install the ``nvidia-docker2`` package and reload the Docker daemon configuration: - .. code-block:: console + .. code-block:: $ sudo yum install nvidia-docker2 $ sudo pkill -SIGHUP dockerd @@ -610,7 +610,7 @@ Installing the NVIDIA Docker2 Toolkit on a CentOS Operating System 1. Run the ``sudo vi /etc/yum.repos.d/nvidia-docker.repo`` command if the following error is displayed when installing the ``nvidia-docker2`` package: - .. code-block:: console + .. code-block:: https://nvidia.github.io/nvidia-docker/centos7/ppc64le/repodata/repomd.xml: [Errno -1] repomd.xml signature could not be verified for nvidia-docker @@ -621,7 +621,7 @@ Installing the NVIDIA Docker2 Toolkit on a CentOS Operating System 5. Verify that the NVIDIA-Docker run has been installed correctly: - .. code-block:: console + .. code-block:: $ docker run --runtime=nvidia --rm nvidia/cuda:10.1-base nvidia-smi @@ -637,7 +637,7 @@ Installing the NVIDIA Docker2 Toolkit on an Ubuntu Operating System 1. Install the repository for your distribution: - .. code-block:: console + .. code-block:: curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add - distribution=$(. /etc/os-release;echo $ID$VERSION_ID) @@ -646,7 +646,7 @@ Installing the NVIDIA Docker2 Toolkit on an Ubuntu Operating System 2. Install the ``nvidia-docker2`` package and reload the Docker daemon configuration: - .. code-block:: console + .. code-block:: $ sudo apt-get install nvidia-docker2 $ sudo pkill -SIGHUP dockerd @@ -662,7 +662,7 @@ Installing the NVIDIA Docker2 Toolkit on an Ubuntu Operating System 1. Run the ``sudo vi /etc/yum.repos.d/nvidia-docker.repo`` command if the following error is displayed when installing the ``nvidia-docker2`` package: - .. code-block:: console + .. code-block:: https://nvidia.github.io/nvidia-docker/centos7/ppc64le/repodata/repomd.xml: [Errno -1] repomd.xml signature could not be verified for nvidia-docker @@ -673,7 +673,7 @@ Installing the NVIDIA Docker2 Toolkit on an Ubuntu Operating System 5. Verify that the NVIDIA-Docker run has been installed correctly: - .. code-block:: console + .. code-block:: $ docker run --runtime=nvidia --rm nvidia/cuda:10.1-base nvidia-smi @@ -690,7 +690,7 @@ This section describes how to install the NVIDIA Docker2 Toolkit on an IBM RHEL 1. Import the repository and install the ``libnvidia-container`` and the ``nvidia-container-runtime`` containers. - .. code-block:: console + .. code-block:: $ distribution=$(. /etc/os-release;echo $ID$VERSION_ID) $ curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.repo | \ @@ -708,7 +708,7 @@ This section describes how to install the NVIDIA Docker2 Toolkit on an IBM RHEL 1. Run the ``sudo vi /etc/yum.repos.d/nvidia-docker.repo`` command if the following error is displayed when installing the containers: - .. code-block:: console + .. code-block:: https://nvidia.github.io/nvidia-docker/centos7/ppc64le/repodata/repomd.xml: [Errno -1] repomd.xml signature could not be verified for nvidia-docker @@ -719,7 +719,7 @@ This section describes how to install the NVIDIA Docker2 Toolkit on an IBM RHEL 3. Install the ``libnvidia-container`` container. - .. code-block:: console + .. code-block:: $ sudo yum install -y libnvidia-container* @@ -727,13 +727,13 @@ This section describes how to install the NVIDIA Docker2 Toolkit on an IBM RHEL 4. Install the ``nvidia-container-runtime`` container: - .. code-block:: console + .. code-block:: $ sudo yum install -y nvidia-container-runtime* 5. Add ``nvidia runtime`` to the Docker daemon: - .. code-block:: console + .. code-block:: $ sudo mkdir -p /etc/systemd/system/docker.service.d/ $ sudo vi /etc/systemd/system/docker.service.d/override.conf @@ -744,14 +744,14 @@ This section describes how to install the NVIDIA Docker2 Toolkit on an IBM RHEL 6. Restart Docker: - .. code-block:: console + .. code-block:: $ sudo systemctl daemon-reload $ sudo systemctl restart docker 7. Verify that the NVIDIA-Docker run has been installed correctly: - .. code-block:: console + .. code-block:: $ docker run --runtime=nvidia --rm nvidia/cuda-ppc64le nvidia-smi @@ -820,13 +820,13 @@ The **sqream_installer-nnn-DBnnn-COnnn-EDnnn-.tar.gz** file includes the f 2. Extract the tarball file: - .. code-block:: console + .. code-block:: $ tar -xvf sqream_installer-1.1.5-DB2019.2.1-CO1.5.4-ED3.0.0-x86_64.tar.gz When the tarball file has been extracted, a new folder will be created. The new folder is automatically given the name of the tarball file: - .. code-block:: console + .. code-block:: drwxrwxr-x 9 sqream sqream 4096 Aug 11 11:51 sqream_istaller-1.1.5-DB2019.2.1-CO1.5.4-ED3.0.0-x86_64/ -rw-rw-r-- 1 sqream sqream 3130398797 Aug 11 11:20 sqream_installer-1.1.5-DB2019.2.1-CO1.5.4-ED3.0.0-x86_64.tar.gz @@ -837,13 +837,13 @@ The **sqream_installer-nnn-DBnnn-COnnn-EDnnn-.tar.gz** file includes the f 4. Verify that the folder you just created contains all of the required files. - .. code-block:: console + .. code-block:: $ ls -la The following is an example of the files included in the new folder: - .. code-block:: console + .. code-block:: drwxrwxr-x. 10 sqream sqream 198 Jun 3 17:57 . drwx------. 25 sqream sqream 4096 Jun 7 18:11 .. @@ -950,7 +950,7 @@ Installing Your License ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Once you've configured your local environment, you must install your license by copying it into the SQream installation package folder located in the **./license** folder: -.. code-block:: console +.. code-block:: $ sudo ./sqream-install -k @@ -961,19 +961,19 @@ Validating Your License ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You can copy your license package into the SQream console folder located in the **/license** folder by running the following command: -.. code-block:: console +.. code-block:: $ sudo ./sqream-install -K The following mandatory flags must be used in the first run: -.. code-block:: console +.. code-block:: $ sudo ./sqream-install -i -k -v The following is an example of the correct command syntax: -.. code-block:: console +.. code-block:: $ sudo ./sqream-install -i -k -c /etc/sqream -v /home/sqream/sqreamdb -l /var/log/sqream -d /home/sqream/data_ingest @@ -985,13 +985,13 @@ The information in this section is optional, and is only relevant for Hadoop use The following is the correct syntax when setting the Hadoop and Kubernetes connectivity parameters: -.. code-block:: console +.. code-block:: $ sudo ./sqream-install -p -e : The following is an example of setting the Hadoop and Kubernetes connectivity parameters: -.. code-block:: console +.. code-block:: $ sudo ./sqream-install -p -e kdc.sq.com:<192.168.1.111> @@ -1004,7 +1004,7 @@ Modifying Your Data Ingest Folder ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Once you've validated your license, you can modify your data ingest folder after the first run by running the following command: -.. code-block:: console +.. code-block:: $ sudo ./sqream-install -d /home/sqream/data_in @@ -1016,7 +1016,7 @@ Once you've modified your data ingest folder (if needed), you must validate that 1. To verify that your server network and Docker network do not overlap, run the following command: -.. code-block:: console +.. code-block:: $ ifconfig | grep 172. @@ -1025,7 +1025,7 @@ Once you've modified your data ingest folder (if needed), you must validate that * If running the above command output no results, continue the installation process. * If running the above command output results, run the following command: - .. code-block:: console + .. code-block:: $ ifconfig | grep 192.168. @@ -1036,13 +1036,13 @@ Once you've configured your network for Docker, you can check and verify your sy Running the following command shows you all the variables used by your SQream system: -.. code-block:: console +.. code-block:: $ ./sqream-install -s The following is an example of the correct output: -.. code-block:: console +.. code-block:: SQREAM_CONSOLE_TAG=1.5.4 SQREAM_TAG=2019.2.1 @@ -1092,7 +1092,7 @@ Starting Your SQream Console You can start your SQream console by running the following command: -.. code-block:: console +.. code-block:: $ ./sqream-console @@ -1105,13 +1105,13 @@ Starting the SQream Master 1. Start the metadata server (default port 3105) and picker (default port 3108) by running the following command: - .. code-block:: console + .. code-block:: $ sqream master --start The following is the correct output: - .. code-block:: console + .. code-block:: sqream-console> sqream master --start starting master server in single_host mode ... @@ -1120,7 +1120,7 @@ Starting the SQream Master 2. *Optional* - Change the metadata and server picker ports by adding ``-p `` and ``-m ``: - .. code-block:: console + .. code-block:: $ sqream-console>sqream master --start -p 4105 -m 43108 $ starting master server in single_host mode ... @@ -1137,13 +1137,13 @@ Starting SQream Workers When starting SQream workers, setting the ```` value sets how many workers to start. Leaving the ```` value unspecified runs all of the available resources. -.. code-block:: console +.. code-block:: $ sqream worker --start The following is an example of expected output when setting the ```` value to ``2``: - .. code-block:: console + .. code-block:: sqream-console>sqream worker --start 2 started sqream_single_host_worker_0 on port 5000, allocated gpu: 0 @@ -1157,13 +1157,13 @@ Listing the Running Services You can list running SQream services to look for container names and ID's by running the following command: -.. code-block:: console +.. code-block:: $ sqream master --list The following is an example of the expected output: -.. code-block:: console +.. code-block:: sqream-console>sqream master --list container name: sqream_single_host_worker_0, container id: c919e8fb78c8 @@ -1179,13 +1179,13 @@ You can stop running services either for a single SQream worker, or all SQream s The following is the command for stopping a running service for a single SQream worker: -.. code-block:: console +.. code-block:: $ sqream worker --stop The following is an example of expected output when stopping a running service for a single SQream worker: -.. code-block:: console +.. code-block:: sqream worker stop stopped container sqream_single_host_worker_0, id: 892a8f1a58c5 @@ -1193,13 +1193,13 @@ The following is an example of expected output when stopping a running service f You can stop all running SQream services (both master and worker) by running the following command: -.. code-block:: console +.. code-block:: $ sqream-console>sqream master --stop --all The following is an example of expected output when stopping all running services: -.. code-block:: console +.. code-block:: sqream-console>sqream master --stop --all stopped container sqream_single_host_worker_0, id: 892a8f1a58c5 @@ -1216,13 +1216,13 @@ SQream Studio is an SQL statement editor. 1. Run the following command: - .. code-block:: console + .. code-block:: $ sqream studio --start The following is an example of the expected output: - .. code-block:: console + .. code-block:: SQream Acceleration Studio is available at http://192.168.1.62:8080 @@ -1233,7 +1233,7 @@ The following is an example of the expected output: You can stop your SQream Studio by running the following command: -.. code-block:: console +.. code-block:: $ sqream studio --stop @@ -1261,7 +1261,7 @@ When using the SQream Client on the Master node, the following default settings The following is an example: -.. code-block:: console +.. code-block:: $ sqream client --master -u sqream -w sqream @@ -1270,7 +1270,7 @@ When using the SQream Client on a Worker node (or nodes), you should use the ``- The following is an example: -.. code-block:: console +.. code-block:: $ sqream client --worker -p 5000 -u sqream -w sqream @@ -1304,7 +1304,7 @@ From the console you can define a spool size value. The following example shows the spool size being set to ``50``: -.. code-block:: console +.. code-block:: $ sqream-console>sqream worker --start 2 -m 50 @@ -1321,7 +1321,7 @@ You can start more than one sqreamd on a single GPU by splitting it. The following example shows the GPU being split into **two** sqreamd's on the GPU in **slot 0**: -.. code-block:: console +.. code-block:: $ sqream-console>sqream worker --start 2 -g 0 @@ -1332,7 +1332,7 @@ Splitting GPU and Setting the Spool Size You can simultaneously split a GPU and set the spool size by appending the ``-m`` flag: -.. code-block:: console +.. code-block:: $ sqream-console>sqream worker --start 2 -g 0 -m 50 @@ -1349,19 +1349,19 @@ The SQream console does not validate the integrity of your external configuratio When using your custom configuration file, you can use the ``-j`` flag to define the full path to the Configuration file, as in the example below: -.. code-block:: console +.. code-block:: $ sqream-console>sqream worker --start 1 -j /etc/sqream/configfile.json .. note:: To start more than one sqream daemon, you must provide files for each daemon, as in the example below: -.. code-block:: console +.. code-block:: $ sqream worker --start 2 -j /etc/sqream/configfile.json /etc/sqream/configfile2.json .. note:: To split a specific GPU, you must also list the GPU flag, as in the example below: -.. code-block:: console +.. code-block:: $ sqream worker --start 2 -g 0 -j /etc/sqream/configfile.json /etc/sqream/configfile2.json @@ -1372,7 +1372,7 @@ Clustering Your Docker Environment SQream lets you connect to a remote Master node to start Docker in Distributed mode. If you have already connected to a Slave node server in Distributed mode, the **sqream Master** and **Client** commands are only available on the Master node. -.. code-block:: console +.. code-block:: $ --master-host $ sqream-console>sqream worker --start 1 --master-host 192.168.0.1020 @@ -1391,13 +1391,13 @@ Checking the Status of SQream Services from the SQream Console From the SQream console, you can check the status of SQream services by running the following command: -.. code-block:: console +.. code-block:: $ sqream-console>sqream master --list The following is an example of the expected output: -.. code-block:: console +.. code-block:: $ sqream-console>sqream master --list $ checking 3 sqream services: @@ -1412,7 +1412,7 @@ Checking the Status of SQream Services from Outside the SQream Console From outside the Sqream Console, you can check the status of SQream services by running the following commands: -.. code-block:: console +.. code-block:: $ sqream-status $ NAMES STATUS PORTS @@ -1438,19 +1438,19 @@ This section describes how to upgrade your SQream system. 3. Extract the following tarball file received from the SQream Support team, under it with the same user and in the same folder that you used while :ref:`Downloading the SQream Software <_download_sqream_software>`. - .. code-block:: console + .. code-block:: $ tar -xvf sqream_installer-2.0.5-DB2019.2.1-CO1.6.3-ED3.0.0-x86_64/ 4. Navigate to the new folder created as a result of extracting the tarball file: - .. code-block:: console + .. code-block:: $ cd sqream_installer-2.0.5-DB2019.2.1-CO1.6.3-ED3.0.0-x86_64/ 5. Initiate the upgrade process: - .. code-block:: console + .. code-block:: $ ./sqream-install -i From 3f69443d275bc9ddc50e3c654a3ad4f960e4a52d Mon Sep 17 00:00:00 2001 From: YanivGerowitz <82020437+YanivGerowitz@users.noreply.github.com> Date: Mon, 28 Mar 2022 15:15:39 +0300 Subject: [PATCH 029/882] Update running_sqream_in_a_docker_container.rst From 3719aa8ac4c102f462f2aa142b2d0215d455989f Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 29 Mar 2022 11:42:53 +0300 Subject: [PATCH 030/882] Modified Getting Started and Installation Guides menus Modified Getting Started and Installation Guides menus --- getting_started/creating_a_database.rst | 34 + ...eparing_your_machine_to_install_sqream.rst | 2 +- .../installing_and_launching_sqream.rst | 9 +- installation_guides/installing_monit.rst | 319 ---- .../installing_sqream_with_binary.rst | 279 ---- .../running_sqream_in_a_docker_container.rst | 1480 ----------------- 6 files changed, 36 insertions(+), 2087 deletions(-) create mode 100644 getting_started/creating_a_database.rst delete mode 100644 installation_guides/installing_monit.rst delete mode 100644 installation_guides/installing_sqream_with_binary.rst delete mode 100644 installation_guides/running_sqream_in_a_docker_container.rst diff --git a/getting_started/creating_a_database.rst b/getting_started/creating_a_database.rst new file mode 100644 index 000000000..6b208f123 --- /dev/null +++ b/getting_started/creating_a_database.rst @@ -0,0 +1,34 @@ +.. _creating_a_database: + +**************************** +Creating a Database +**************************** +Once you've installed SQream you can create a database. + +**To create a database:** + +1. Write a :ref:`create_database` statement. + + The following is an example of creating a new database: + + .. code-block:: psql + + master=> CREATE DATABASE test; + executed + +2. Reconnect to the newly created database. + + 1. Exit the client by typing ``\q`` and pressing **Enter**. + 2. From the Linux shell, restart the client with the new database name: + + .. code-block:: psql + + $ sqream sql --port=5000 --username=rhendricks -d test + Password: + + Interactive client mode + To quit, use ^D or \q. + + test=> _ + + The name of the new database that you are connected to is displayed in the prompt. \ No newline at end of file diff --git a/getting_started/preparing_your_machine_to_install_sqream.rst b/getting_started/preparing_your_machine_to_install_sqream.rst index 435f35de0..d57861b1a 100644 --- a/getting_started/preparing_your_machine_to_install_sqream.rst +++ b/getting_started/preparing_your_machine_to_install_sqream.rst @@ -32,4 +32,4 @@ To prepare your machine to install SQream, do the following: For more information, see the following: * :ref:`recommended_pre-installation_configurations` -* `Hardware Guide `_ +* :ref:`hardware_guide` \ No newline at end of file diff --git a/installation_guides/installing_and_launching_sqream.rst b/installation_guides/installing_and_launching_sqream.rst index 4ef1ef706..03d5d024f 100644 --- a/installation_guides/installing_and_launching_sqream.rst +++ b/installation_guides/installing_and_launching_sqream.rst @@ -10,11 +10,4 @@ The **Installing SQream Studio** page incudes the following installation guides: :glob: recommended_pre-installation_configurations - installing_sqream_with_binary - running_sqream_in_a_docker_container - installing_sqream_with_kubernetes - installing_monit - launching_sqream_with_monit - - - + installing_sqream_with_kubernetes \ No newline at end of file diff --git a/installation_guides/installing_monit.rst b/installation_guides/installing_monit.rst deleted file mode 100644 index b27800cce..000000000 --- a/installation_guides/installing_monit.rst +++ /dev/null @@ -1,319 +0,0 @@ -.. _installing_monit: - -********************************************* -Installing Monit -********************************************* - -Getting Started -============================== - -Before installing SQream with Monit, verify that you have followed the required :ref:`recommended pre-installation configurations `. - -The procedures in the **Installing Monit** guide must be performed on each SQream cluster node. - - - - - -.. _back_to_top: - -Overview -============================== - - -Monit is a free open source supervision utility for managing and monitoring Unix and Linux. Monit lets you view system status directly from the command line or from a native HTTP web server. Monit can be used to conduct automatic maintenance and repair, such as executing meaningful causal actions in error situations. - -SQream uses Monit as a watchdog utility, but you can use any other utility that provides the same or similar functionality. - -The **Installing Monit** procedures describes how to install, configure, and start Monit. - -You can install Monit in one of the following ways: - -* :ref:`Installing Monit on CentOS ` -* :ref:`Installing Monit on CentOS offline ` -* :ref:`Installing Monit on Ubuntu ` -* :ref:`Installing Monit on Ubuntu offline ` - - - - - - - -.. _installing-monit-on-centos: - -Installing Monit on CentOS: ------------------------------------- - - - -**To install Monit on CentOS:** - -1. Install Monit as a superuser on CentOS: - - .. code-block:: console - - $ sudo yum install monit - - -.. _installing-monit-on-centos-offline: - - - -Installing Monit on CentOS Offline: ------------------------------------- - - -Installing Monit on CentOS offline can be done in either of the following ways: - -* :ref:`Building Monit from Source Code ` -* :ref:`Building Monit from Pre-Built Binaries ` - - - - -.. _building_monit_from_source_code: - -Building Monit from Source Code -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - - -**To build Monit from source code:** - -1. Copy the Monit package for the current version: - - .. code-block:: console - - $ tar zxvf monit-.tar.gz - - The value ``x.y.z`` denotes the version numbers. - -2. Navigate to the directory where you want to store the package: - - .. code-block:: console - - $ cd monit-x.y.z - -3. Configure the files in the package: - - .. code-block:: console - - $ ./configure (use ./configure --help to view available options) - -4. Build and install the package: - - .. code-block:: console - - $ make && make install - -The following are the default storage directories: - -* The Monit package: **/usr/local/bin/** -* The **monit.1 man-file**: **/usr/local/man/man1/** - -5. **Optional** - To change the above default location(s), use the **--prefix** option to ./configure. - -.. - _**Comment - I took this line directly from the external online documentation. Is the "prefix option" referrin gto the "--help" in Step 3? URL: https://mmonit.com/wiki/Monit/Installation** - -6. **Optional** - Create an RPM package for CentOS directly from the source code: - - .. code-block:: console - - $ rpmbuild -tb monit-x.y.z.tar.gz - -.. - _**Comment - Is this an optional or mandatory step?** - - - - -.. _building_monit_from_pre_built_binaries: - -Building Monit from Pre-Built Binaries -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**To build Monit from pre-built binaries:** - -1. Copy the Monit package for the current version: - - .. code-block:: console - - $ tar zxvf monit-x.y.z-linux-x64.tar.gz - - The value ``x.y.z`` denotes the version numbers. - -2. Navigate to the directory where you want to store the package: - - .. code-block:: console$ cd monit-x.y.z - -3. Copy the **bin/monit** and **/usr/local/bin/** directories: - - .. code-block:: console - - $ cp bin/monit /usr/local/bin/ - -4. Copy the **conf/monitrc** and **/etc/** directories: - - .. code-block:: console - - $ cp conf/monitrc /etc/ - -.. - _**Comment - please review this procedure.** - -For examples of pre-built Monit binarties, see :ref:`Download Precompiled Binaries`. - -:ref:`Back to top ` - - - -.. _installing-monit-on-ubuntu: - - - -Installing Monit on Ubuntu: ------------------------------------- - - -**To install Monit on Ubuntu:** - -1. Install Monit as a superuser on Ubuntu: - - .. code-block:: console - - $ sudo apt-get install monit - -:ref:`Back to top ` - - - -.. _installing-monit-on-ubuntu-offline: - - -Installing Monit on Ubuntu Offline: -------------------------------------- - - -You can install Monit on Ubuntu when you do not have an internet connection. - -**To install Monit on Ubuntu offline:** - -1. Compress the required file: - - .. code-block:: console - - $ tar zxvf monit--linux-x64.tar.gz - - **NOTICE:** ** denotes the version number. - -2. Navigate to the directory where you want to save the file: - - .. code-block:: console - - $ cd monit-x.y.z - -3. Copy the **bin/monit** directory into the **/usr/local/bin/** directory: - - .. code-block:: console - - $ cp bin/monit /usr/local/bin/ - -4. Copy the **conf/monitrc** directory into the **/etc/** directory: - - .. code-block:: console - - $ cp conf/monitrc /etc/ - -:ref:`Back to top ` - - -Configuring Monit -==================================== - -When the installation is complete, you can configure Monit. You configure Monit by modifying the Monit configuration file, called **monitrc**. This file contains blocks for each service that you want to monitor. - -The following is an example of a service block: - - .. code-block:: console - - $ #SQREAM1-START - $ check process sqream1 with pidfile /var/run/sqream1.pid - $ start program = "/usr/bin/systemctl start sqream1" - $ stop program = "/usr/bin/systemctl stop sqream1" - $ #SQREAM1-END - -For example, if you have 16 services, you can configure this block by copying the entire block 15 times and modifying all service names as required, as shown below: - - .. code-block:: console - - $ #SQREAM2-START - $ check process sqream2 with pidfile /var/run/sqream2.pid - $ start program = "/usr/bin/systemctl start sqream2" - $ stop program = "/usr/bin/systemctl stop sqream2" - $ #SQREAM2-END - -For servers that don't run the **metadataserver** and **serverpicker** commands, you can use the block example above, but comment out the related commands, as shown below: - - .. code-block:: console - - $ #METADATASERVER-START - $ #check process metadataserver with pidfile /var/run/metadataserver.pid - $ #start program = "/usr/bin/systemctl start metadataserver" - $ #stop program = "/usr/bin/systemctl stop metadataserver" - $ #METADATASERVER-END - -**To configure Monit:** - -1. Copy the required block for each required service. -2. Modify all service names in the block. -3. Copy the configured **monitrc** file to the **/etc/monit.d/** directory: - - .. code-block:: console - - $ cp monitrc /etc/monit.d/ - -4. Set file permissions to **600** (full read and write access): - - .. code-block:: console - - $ sudo chmod 600 /etc/monit.d/monitrc - -5. Reload the system to activate the current configurations: - - .. code-block:: console - - $ sudo systemctl daemon-reload - -6. **Optional** - Navigate to the **/etc/sqream** directory and create a symbolic link to the **monitrc** file: - - .. code-block:: console - - $ cd /etc/sqream - $ sudo ln -s /etc/monit.d/monitrc monitrc - -Starting Monit -==================================== - -After configuring Monit, you can start it. - -**To start Monit:** - -1. Start Monit as a super user: - - .. code-block:: console - - $ sudo systemctl start monit - -2. View Monit's service status: - - .. code-block:: console - - $ sudo systemctl status monit - -3. If Monit is functioning correctly, enable the Monit service to start on boot: - - .. code-block:: console - - $ sudo systemctl enable monit diff --git a/installation_guides/installing_sqream_with_binary.rst b/installation_guides/installing_sqream_with_binary.rst deleted file mode 100644 index dd1207ab7..000000000 --- a/installation_guides/installing_sqream_with_binary.rst +++ /dev/null @@ -1,279 +0,0 @@ -.. _installing_sqream_with_binary: - -********************************************* -Installing SQream Using Binary Packages -********************************************* -This procedure describes how to install SQream using Binary packages and must be done on all servers. - -**To install SQream using Binary packages:** - -1. Copy the SQream package to the **/home/sqream** directory for the current version: - - .. code-block:: console - - $ tar -xf sqream-db-v<2020.2>.tar.gz - -2. Append the version number to the name of the SQream folder. The version number in the following example is **v2020.2**: - - .. code-block:: console - - $ mv sqream sqream-db-v<2020.2> - -3. Move the new version of the SQream folder to the **/usr/local/** directory: - - .. code-block:: console - - $ sudo mv sqream-db-v<2020.2> /usr/local/ - -4. Change the ownership of the folder to **sqream folder**: - - .. code-block:: console - - $ sudo chown -R sqream:sqream /usr/local/sqream-db-v<2020.2> - -5. Navigate to the **/usr/local/** directory and create a symbolic link to SQream: - - .. code-block:: console - - $ cd /usr/local - $ sudo ln -s sqream-db-v<2020.2> sqream - -6. Verify that the symbolic link that you created points to the folder that you created: - - .. code-block:: console - - $ ls -l - -7. Verify that the symbolic link that you created points to the folder that you created: - - .. code-block:: console - - $ sqream -> sqream-db-v<2020.2> - -8. Create the SQream configuration file destination folders and set their ownership to **sqream**: - - .. code-block:: console - - $ sudo mkdir /etc/sqream - $ sudo chown -R sqream:sqream /etc/sqream - -9. Create the SQream service log destination folders and set their ownership to **sqream**: - - .. code-block:: console - - $ sudo mkdir /var/log/sqream - $ sudo chown -R sqream:sqream /var/log/sqream - -10. Navigate to the **/usr/local/** directory and copy the SQream configuration files from them: - - .. code-block:: console - - $ cd /usr/local/sqream/etc/ - $ cp * /etc/sqream - -The configuration files are **service configuration files**, and the JSON files are **SQream configuration files**, for a total of four files. The number of SQream configuration files and JSON files must be identical. - -**NOTICE** - Verify that the JSON files have been configured correctly and that all required flags have been set to the correct values. - -In each JSON file, the following parameters **must be updated**: - -* instanceId -* machineIP -* metadataServerIp -* spoolMemoryGB -* limitQueryMemoryGB -* gpu -* port -* ssl_port - -Note the following: - -* The value of the **metadataServerIp** parameter must point to the IP that the metadata is running on. -* The value of the **machineIP** parameter must point to the IP of your local machine. - -It would be same on server running metadataserver and different on other server nodes. - -11. **Optional** - To run additional SQream services, copy the required configuration files and create additional JSON files: - - .. code-block:: console - - $ cp sqream2_config.json sqream3_config.json - $ vim sqream3_config.json - -**NOTICE:** A unique **instanceID** must be used in each JSON file. IN the example above, the instanceID **sqream_2** is changed to **sqream_3**. - -12. **Optional** - If you created additional services in **Step 11**, verify that you have also created their additional configuration files: - - .. code-block:: console - - $ cp sqream2-service.conf sqream3-service.conf - $ vim sqream3-service.conf - -13. For each SQream service configuration file, do the following: - - 1. Change the **SERVICE_NAME=sqream2** value to **SERVICE_NAME=sqream3**. - - 2. Change **LOGFILE=/var/log/sqream/sqream2.log** to **LOGFILE=/var/log/sqream/sqream3.log**. - -**NOTE:** If you are running SQream on more than one server, you must configure the ``serverpicker`` and ``metadatserver`` services to start on only one of the servers. If **metadataserver** is running on the first server, the ``metadataServerIP`` value in the second server's /etc/sqream/sqream1_config.json file must point to the IP of the server on which the ``metadataserver`` service is running. - -14. Set up **servicepicker**: - - 1. Do the following: - - .. code-block:: console - - $ vim /etc/sqream/server_picker.conf - - 2. Change the IP **127.0.0.1** to the IP of the server that the **metadataserver** service is running on. - - 3. Change the **CLUSTER** to the value of the cluster path. - -15. Set up your service files: - - .. code-block:: console - - $ cd /usr/local/sqream/service/ - $ cp sqream2.service sqream3.service - $ vim sqream3.service - -16. Increment each **EnvironmentFile=/etc/sqream/sqream2-service.conf** configuration file for each SQream service file, as shown below: - - .. code-block:: console - - $ EnvironmentFile=/etc/sqream/sqream<3>-service.conf - -17. Copy and register your service files into systemd: - - .. code-block:: console - - $ sudo cp metadataserver.service /usr/lib/systemd/system/ - $ sudo cp serverpicker.service /usr/lib/systemd/system/ - $ sudo cp sqream*.service /usr/lib/systemd/system/ - -18. Verify that your service files have been copied into systemd: - - .. code-block:: console - - $ ls -l /usr/lib/systemd/system/sqream* - $ ls -l /usr/lib/systemd/system/metadataserver.service - $ ls -l /usr/lib/systemd/system/serverpicker.service - $ sudo systemctl daemon-reload - -19. Copy the license into the **/etc/license** directory: - - .. code-block:: console - - $ cp license.enc /etc/sqream/ - - -If you have an HDFS environment, see :ref:`Configuring an HDFS Environment for the User sqream `. - - - - - - -Upgrading SQream Version -------------------------- -Upgrading your SQream version requires stopping all running services while you manually upgrade SQream. - -**To upgrade your version of SQream:** - -1. Stop all actively running SQream services. - -**Notice-** All SQream services must remain stopped while the upgrade is in process. Ensuring that SQream services remain stopped depends on the tool being used. - -For an example of stopping actively running SQream services, see :ref:`Launching SQream with Monit `. - - - -2. Verify that SQream has stopped listening on ports **500X**, **510X**, and **310X**: - - .. code-block:: console - - $ sudo netstat -nltp #to make sure sqream stopped listening on 500X, 510X and 310X ports. - -3. Replace the old version ``sqream-db-v2020.2``, with the new version ``sqream-db-v2021.1``: - - .. code-block:: console - - $ cd /home/sqream - $ mkdir tempfolder - $ mv sqream-db-v2021.1.tar.gz tempfolder/ - $ tar -xf sqream-db-v2021.1.tar.gz - $ sudo mv sqream /usr/local/sqream-db-v2021.1 - $ cd /usr/local - $ sudo chown -R sqream:sqream sqream-db-v2021.1 - -4. Remove the symbolic link: - - .. code-block:: console - - $ sudo rm sqream - -5. Create a new symbolic link named "sqream" pointing to the new version: - - .. code-block:: console - - $ sudo ln -s sqream-db-v2021.1 sqream - -6. Verify that the symbolic SQream link points to the real folder: - - .. code-block:: console - - $ ls -l - - The following is an example of the correct output: - - .. code-block:: console - - $ sqream -> sqream-db-v2021.1 - -7. **Optional-** (for major versions) Upgrade your version of SQream storage cluster, as shown in the following example: - - .. code-block:: console - - $ cat /etc/sqream/sqream1_config.json |grep cluster - $ ./upgrade_storage - - The following is an example of the correct output: - - .. code-block:: console - - get_leveldb_version path{} - current storage version 23 - upgrade_v24 - upgrade_storage to 24 - upgrade_storage to 24 - Done - upgrade_v25 - upgrade_storage to 25 - upgrade_storage to 25 - Done - upgrade_v26 - upgrade_storage to 26 - upgrade_storage to 26 - Done - validate_leveldb - ... - upgrade_v37 - upgrade_storage to 37 - upgrade_storage to 37 - Done - validate_leveldb - storage has been upgraded successfully to version 37 - -8. Verify that the latest version has been installed: - - .. code-block:: console - - $ ./sqream sql --username sqream --password sqream --host localhost --databasename master -c "SELECT SHOW_VERSION();" - - The following is an example of the correct output: - - .. code-block:: console - - v2021.1 - 1 row - time: 0.050603s - -For more information, see the `upgrade_storage `_ command line program. - -For more information about installing Studio on a stand-alone server, see `Installing Studio on a Stand-Alone Server `_. \ No newline at end of file diff --git a/installation_guides/running_sqream_in_a_docker_container.rst b/installation_guides/running_sqream_in_a_docker_container.rst deleted file mode 100644 index 79caa9f8d..000000000 --- a/installation_guides/running_sqream_in_a_docker_container.rst +++ /dev/null @@ -1,1480 +0,0 @@ -.. _running_sqream_in_a_docker_container: - -*********************** -Installing and Running SQream in a Docker Container -*********************** -The **Installing and Running SQream in a Docker Container** page describes how to prepare your machine's environment for installing and running SQream in a Docker container. - -This page describes the following: - -.. contents:: - :local: - :depth: 1 - -Setting Up a Host -==================================== - -Operating System Requirements ------------------------------------- -SQream was tested and verified on the following versions of Linux: - - * x86 CentOS/RHEL 7.6 - 7.9 - * IBM RHEL 7.6 - -SQream recommends installing a clean OS on the host to avoid any installation issues. - -.. warning:: Docker-based installation supports only single host deployment and cannot be used on a multi-node cluster. Installing Docker on a single host you will not be able to scale it to a multi-node cluster. - - -Creating a Local User ----------------- -To run SQream in a Docker container you must create a local user. - -**To create a local user:** - -1. Add a local user: - - .. code-block:: console - - $ useradd -m -U - -2. Set the local user's password: - - .. code-block:: console - - $ passwd - -3. Add the local user to the ``wheel`` group: - - .. code-block:: console - - $ usermod -aG wheel - - You can remove the local user from the ``wheel`` group when you have completed the installation. - -4. Log out and log back in as the local user. - -Setting a Local Language ----------------- -After creating a local user you must set a local language. - -**To set a local language:** - -1. Set the local language: - - .. code-block:: console - - $ sudo localectl set-locale LANG=en_US.UTF-8 - -2. Set the time stamp (time and date) of the locale: - - .. code-block:: console - - $ sudo timedatectl set-timezone Asia/Jerusalem - -You can run the ``timedatectl list-timezones`` command to see your timezone. - -Adding the EPEL Repository ----------------- -After setting a local language you must add the EPEL repository. - -**To add the EPEL repository:** - -1. As a root user, upgrade the **epel-release-latest-7.noarch.rpm** repository: - - 1. RedHat (RHEL 7): - - .. code-block:: console - - $ sudo rpm -Uvh http://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm - - 2. CentOS 7 - - .. code-block:: console - - $ sudo yum install epel-release - -Installing the Required NTP Packages ----------------- -After adding the EPEL repository, you must install the required NTP packages. - -You can install the required NTP packages by running the following command: - -.. code-block:: console - - $ sudo yum install ntp pciutils python36 kernel-devel-$(uname -r) kernel-headers-$(uname -r) gcc - -Installing the Recommended Tools ----------------- -After installin gthe required NTP packages you must install the recommended tools. - -SQream recommends installing the following recommended tools: - -.. code-block:: console - - $ sudo yum install bash-completion.noarch vim-enhanced.x86_64 vim-common.x86_64 net-tools iotop htop psmisc screen xfsprogs wget yum-utils deltarpm dos2unix - -Updating to the Current Version of the Operating System ----------------- -After installing the recommended tools you must update to the current version of the operating system. - -SQream recommends updating to the current version of the operating system. This is not recommended if the nvidia driver has **not been installed.** - - - -Configuring the NTP Package ----------------- -After updating to the current version of the operating system you must configure the NTP package. - -**To configure the NTP package:** - -1. Add your local servers to the NTP configuration. - - :: - -2. Configure the **ntpd** service to begin running when your machine is started: - - .. code-block:: console - - $ sudo systemctl enable ntpd - $ sudo systemctl start ntpd - $ sudo ntpq -p - -Configuring the Performance Profile ----------------- -After configuring the NTP package you must configure the performance profile. - -**To configure the performance profile:** - -1. Switch the active profile: - - .. code-block:: console - - $ sudo tuned-adm profile throughput-performance - -2. Change the multi-user's default run level: - - .. code-block:: console - - $ sudo systemctl set-default multi-user.target - -Configuring Your Security Limits ----------------- -After configuring the performance profile you must configure your security limits. Configuring your security limits refers to configuring the number of open files, processes, etc. - -**To configure your security limits:** - -1. Run the **bash** shell as a super-user: - - .. code-block:: console - - $ sudo bash - -2. Run the following command: - - .. code-block:: console - - $ echo -e "sqream soft nproc 500000\nsqream hard nproc 500000\nsqream soft nofile 500000\nsqream hard nofile 500000\nsqream soft core unlimited\nsqream hard core unlimited" >> /etc/security/limits.conf - -3. Run the following command: - - .. code-block:: console - - $ echo -e "vm.dirty_background_ratio = 5 \n vm.dirty_ratio = 10 \n vm.swappiness = 10 \n vm.zone_reclaim_mode = 0 \n vm.vfs_cache_pressure = 200 \n" >> /etc/sysctl.conf - -Disabling Automatic Bug-Reporting Tools ----------------- -After configuring your security limits you must disable the following automatic bug-reporting tools: - -* ccpp.service -* oops.service -* pstoreoops.service -* vmcore.service -* xorg.service - -You can abort the above but-reporting tools by running the following command: - -.. code-block:: console - - $ for i in abrt-ccpp.service abrtd.service abrt-oops.service abrt-pstoreoops.service abrt-vmcore.service abrt-xorg.service ; do sudo systemctl disable $i; sudo systemctl stop $i; done - -Installing the Nvidia CUDA Driver -------------------------------------- - -1. Verify that the Tesla NVIDIA card has been installed and is detected by the system: - - .. code-block:: console - - $ lspci | grep -i nvidia - - The correct output is a list of Nvidia graphic cards. If you do not receive this output, verify that an NVIDIA GPU card has been installed. - -#. Verify that the open-source upstream Nvidia driver is running: - - .. code-block:: console - - $ lsmod | grep nouveau - - No output should be generated. - -#. If you receive any output, do the following: - - 1. Disable the open-source upstream Nvidia driver: - - .. code-block:: console - - $ sudo bash - $ echo "blacklist nouveau" > /etc/modprobe.d/blacklist-nouveau.conf - $ echo "options nouveau modeset=0" >> /etc/modprobe.d/blacklist-nouveau.conf - $ dracut --force - $ modprobe --showconfig | grep nouveau - - 2. Reboot the server and verify that the Nouveau model has not been loaded: - - .. code-block:: console - - $ lsmod | grep nouveau - -#. Check if the Nvidia CUDA driver has already been installed: - - .. code-block:: console - - $ nvidia-smi - - The following is an example of the correct output: - - .. code-block:: console - - nvidia-smi - Wed Oct 30 14:05:42 2019 - +-----------------------------------------------------------------------------+ - | NVIDIA-SMI 418.87.00 Driver Version: 418.87.00 CUDA Version: 10.1 | - |-------------------------------+----------------------+----------------------+ - | GPU Name Persistence-M| Bus-Id Disp.A | Volatile Uncorr. ECC | - | Fan Temp Perf Pwr:Usage/Cap| Memory-Usage | GPU-Util Compute M. | - |===============================+======================+======================| - | 0 Tesla V100-SXM2... On | 00000004:04:00.0 Off | 0 | - | N/A 32C P0 37W / 300W | 0MiB / 16130MiB | 0% Default | - +-------------------------------+----------------------+----------------------+ - | 1 Tesla V100-SXM2... On | 00000035:03:00.0 Off | 0 | - | N/A 33C P0 37W / 300W | 0MiB / 16130MiB | 0% Default | - +-------------------------------+----------------------+----------------------+ - - +-----------------------------------------------------------------------------+ - | Processes: GPU Memory | - | GPU PID Type Process name Usage | - |=============================================================================| - | No running processes found | - +-----------------------------------------------------------------------------+ - -#. Verify that the installed CUDA version shown in the output above is ``10.1``. - - :: - - -#. Do one of the following: - - :: - - 1. If CUDA version 10.1 has already been installed, skip to Docktime Runtime (Community Edition). - :: - - 2. If CUDA version 10.1 has not been installed yet, continue with Step 7 below. - -#. Do one of the following: - - * Install :ref:`CUDA Driver version 10.1 for x86_64 `. - - :: - - * Install :ref:`CUDA driver version 10.1 for IBM Power9 `. - -.. _CUDA_10.1_x8664: - -Installing the CUDA Driver Version 10.1 for x86_64 -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**To install the CUDA driver version 10.1 for x86_64:** - -1. Make the following target platform selections: - - :: - - * **Operating system**: Linux - * **Architecture**: x86_64 - * **Distribution**: CentOS - * **Version**: 7 - * **Installer type**: the relevant installer type - -For installer type, SQream recommends selecting **runfile (local)**. The available selections shows only the supported platforms. - -2. Download the base installer for Linux CentOS 7 x86_64: - - .. code-block:: console - - wget http://developer.download.nvidia.com/compute/cuda/10.1/Prod/local_installers/cuda-repo-rhel7-10-1-local-10.1.243-418.87.00-1.0-1.x86_64.rpm - - -3. Install the base installer for Linux CentOS 7 x86_64 by running the following commands: - - .. code-block:: console - - $ sudo yum localinstall cuda-repo-rhel7-10-1-local-10.1.243-418.87.00-1.0-1.x86_64.rpm - $ sudo yum clean all - $ sudo yum install nvidia-driver-latest-dkms - -.. warning:: Verify that the output indicates that driver **418.87** will be installed. - -4. Follow the command line prompts. - - - :: - - -5. Enable the Nvidia service to start at boot and start it: - - .. code-block:: console - - $ sudo systemctl enable nvidia-persistenced.service && sudo systemctl start nvidia-persistenced.service - -6. Create a symbolic link from the **/etc/systemd/system/multi-user.target.wants/nvidia-persistenced.service** file to the **/usr/lib/systemd/system/nvidia-persistenced.service** file. - - :: - -7. Reboot the server. - - :: -8. Verify that the Nvidia driver has been installed and shows all available GPU's: - - .. code-block:: console - - $ nvidia-smi - - The following is the correct output: - - .. code-block:: console - - nvidia-smi - Wed Oct 30 14:05:42 2019 - +-----------------------------------------------------------------------------+ - | NVIDIA-SMI 418.87.00 Driver Version: 418.87.00 CUDA Version: 10.1 | - |-------------------------------+----------------------+----------------------+ - | GPU Name Persistence-M| Bus-Id Disp.A | Volatile Uncorr. ECC | - | Fan Temp Perf Pwr:Usage/Cap| Memory-Usage | GPU-Util Compute M. | - |===============================+======================+======================| - | 0 Tesla V100-SXM2... On | 00000004:04:00.0 Off | 0 | - | N/A 32C P0 37W / 300W | 0MiB / 16130MiB | 0% Default | - +-------------------------------+----------------------+----------------------+ - | 1 Tesla V100-SXM2... On | 00000035:03:00.0 Off | 0 | - | N/A 33C P0 37W / 300W | 0MiB / 16130MiB | 0% Default | - +-------------------------------+----------------------+----------------------+ - - +-----------------------------------------------------------------------------+ - | Processes: GPU Memory | - | GPU PID Type Process name Usage | - |=============================================================================| - | No running processes found | - +-----------------------------------------------------------------------------+ - -.. _CUDA_10.1_IBMPower9: - -Installing the CUDA Driver Version 10.1 for IBM Power9 -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**To install the CUDA driver version 10.1 for IBM Power9:** - -1. Download the base installer for Linux CentOS 7 PPC64le: - - .. code-block:: console - - wget http://developer.download.nvidia.com/compute/cuda/10.1/Prod/local_installers/cuda-repo-rhel7-10-1-local-10.1.243-418.87.00-1.0-1.ppc64le.rpm - - -#. Install the base installer for Linux CentOS 7 x86_64 by running the following commands: - - .. code-block:: console - - $ sudo rpm -i cuda-repo-rhel7-10-1-local-10.1.243-418.87.00-1.0-1.ppc64le.rpm - $ sudo yum clean all - $ sudo yum install nvidia-driver-latest-dkms - -.. warning:: Verify that the output indicates that driver **418.87** will be installed. - - - -3. Copy the file to the **/etc/udev/rules.d** directory. - - :: - -4. If you are using RHEL 7 version (7.6 or later), comment out, remove, or change the hot-pluggable memory rule located in file copied to the **/etc/udev/rules.d** directory by running the following command: - - .. code-block:: console - - $ sudo cp /lib/udev/rules.d/40-redhat.rules /etc/udev/rules.d - $ sudo sed -i 's/SUBSYSTEM!="memory",.*GOTO="memory_hotplug_end"/SUBSYSTEM=="*", GOTO="memory_hotplug_end"/' /etc/udev/rules.d/40-redhat.rules - -#. Enable the **nvidia-persisted.service** file: - - .. code-block:: console - - $ sudo systemctl enable nvidia-persistenced.service - -#. Create a symbolic link from the **/etc/systemd/system/multi-user.target.wants/nvidia-persistenced.service** file to the **/usr/lib/systemd/system/nvidia-persistenced.service** file. - - :: - -#. Reboot your system to initialize the above modifications. - - :: - -#. Verify that the Nvidia driver and the **nvidia-persistenced.service** files are running: - - .. code-block:: console - - $ nvidia smi - - The following is the correct output: - - .. code-block:: console - - nvidia-smi - Wed Oct 30 14:05:42 2019 - +-----------------------------------------------------------------------------+ - | NVIDIA-SMI 418.87.00 Driver Version: 418.87.00 CUDA Version: 10.1 | - |-------------------------------+----------------------+----------------------+ - | GPU Name Persistence-M| Bus-Id Disp.A | Volatile Uncorr. ECC | - | Fan Temp Perf Pwr:Usage/Cap| Memory-Usage | GPU-Util Compute M. | - |===============================+======================+======================| - | 0 Tesla V100-SXM2... On | 00000004:04:00.0 Off | 0 | - | N/A 32C P0 37W / 300W | 0MiB / 16130MiB | 0% Default | - +-------------------------------+----------------------+----------------------+ - | 1 Tesla V100-SXM2... On | 00000035:03:00.0 Off | 0 | - | N/A 33C P0 37W / 300W | 0MiB / 16130MiB | 0% Default | - +-------------------------------+----------------------+----------------------+ - - +-----------------------------------------------------------------------------+ - | Processes: GPU Memory | - | GPU PID Type Process name Usage | - |=============================================================================| - | No running processes found | - +-----------------------------------------------------------------------------+ - -#. Verify that the **nvidia-persistenced** service is running: - - .. code-block:: console - - $ systemctl status nvidia-persistenced - - The following is the correct output: - - .. code-block:: console - - root@gpudb ~]systemctl status nvidia-persistenced - nvidia-persistenced.service - NVIDIA Persistence Daemon - Loaded: loaded (/usr/lib/systemd/system/nvidia-persistenced.service; enabled; vendor preset: disabled) - Active: active (running) since Tue 2019-10-15 21:43:19 KST; 11min ago - Process: 8257 ExecStart=/usr/bin/nvidia-persistenced --verbose (code=exited, status=0/SUCCESS) - Main PID: 8265 (nvidia-persiste) - Tasks: 1 - Memory: 21.0M - CGroup: /system.slice/nvidia-persistenced.service - └─8265 /usr/bin/nvidia-persistenced --verbose - -Installing the Docker Engine (Community Edition) -======================= -After installing the Nvidia CUDA driver you must install the Docker engine. - -This section describes how to install the Docker engine using the following processors: - -* :ref:`Using x86_64 processor on CentOS ` -* :ref:`Using x86_64 processor on Ubuntu ` -* :ref:`Using IBM Power9 (PPC64le) processor ` - - -.. _dockerx8664centos: - -Installing the Docker Engine Using an x86_64 Processor on CentOS ---------------------------------- -The x86_64 processor supports installing the **Docker Community Edition (CE)** versions 18.03 and higher. - -For more information on installing the Docker Engine CE on an x86_64 processor, see `Install Docker Engine on CentOS `_ - - - -.. _dockerx8664ubuntu: - -Installing the Docker Engine Using an x86_64 Processor on Ubuntu ------------------------------------------------------ - - -The x86_64 processor supports installing the **Docker Community Edition (CE)** versions 18.03 and higher. - -For more information on installing the Docker Engine CE on an x86_64 processor, see `Install Docker Engine on Ubuntu `_ - -.. _docker_ibmpower9: - -Installing the Docker Engine on an IBM Power9 Processor ----------------------------------------- -The x86_64 processor only supports installing the **Docker Community Edition (CE)** version 18.03. - -**To install the Docker Engine on an IBM Power9 processor:** - -You can install the Docker Engine on an IBM Power9 processor by running the following command: - -.. code-block:: console - - wget http://ftp.unicamp.br/pub/ppc64el/rhel/7_1/docker-ppc64el/container-selinux-2.9-4.el7.noarch.rpm - wget http://ftp.unicamp.br/pub/ppc64el/rhel/7_1/docker-ppc64el/docker-ce-18.03.1.ce-1.el7.centos.ppc64le.rpm - yum install -y container-selinux-2.9-4.el7.noarch.rpm docker-ce-18.03.1.ce-1.el7.centos.ppc64le.rpm - -For more information on installing the Docker Engine CE on an IBM Power9 processor, see `Install Docker Engine on Ubuntu `_. - -Docker Post-Installation -================================= -After installing the Docker engine you must configure Docker on your local machine. - -**To configure Docker on your local machine:** - -1. Enable Docker to start on boot: - - .. code-block:: console - - $ sudo systemctl enable docker && sudo systemctl start docker - -2. Enable managing Docker as a non-root user: - - .. code-block:: console - - $ sudo usermod -aG docker $USER - -3. Log out and log back in via SSH. This causes Docker to re-evaluate your group membership. - - :: - -4. Verify that you can run the following Docker command as a non-root user (without ``sudo``): - - .. code-block:: console - - $ docker run hello-world - -If you can run the above Docker command as a non-root user, the following occur: - -* Docker downloads a test image and runs it in a container. -* When the container runs, it prints an informational message and exits. - -For more information on installing the Docker Post-Installation, see `Docker Post-Installation `_. - -Installing the Nvidia Docker2 ToolKit -========================================== -After configuring Docker on your local machine you must install the Nvidia Docker2 ToolKit. The NVIDIA Docker2 Toolkit lets you build and run GPU-accelerated Docker containers. The Toolkit includes a container runtime library and related utilities for automatically configuring containers to leverage NVIDIA GPU's. - -This section describes the following: - -* :ref:`Installing the NVIDIA Docker2 Toolkit on an x86_64 processor ` -* :ref:`Installing the NVIDIA Docker2 Toolkit on a PPC64le processor ` - -.. _install_nvidia_docker2_toolkit_x8664_processor: - -Installing the NVIDIA Docker2 Toolkit on an x86_64 Processor ----------------------------------------- - -This section describes the following: - -* :ref:`Installing the NVIDIA Docker2 Toolkit on a CentOS operating system ` - -* :ref:`Installing the NVIDIA Docker2 Toolkit on an Ubuntu operating system ` - -.. _install_nvidia_docker2_toolkit_centos: - -Installing the NVIDIA Docker2 Toolkit on a CentOS Operating System -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**To install the NVIDIA Docker2 Toolkit on a CentOS operating system:** - -1. Install the repository for your distribution: - - .. code-block:: console - - distribution=$(. /etc/os-release;echo $ID$VERSION_ID) - curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.repo | \ - sudo tee /etc/yum.repos.d/nvidia-docker.repo - -2. Install the ``nvidia-docker2`` package and reload the Docker daemon configuration: - - .. code-block:: console - - $ sudo yum install nvidia-docker2 - $ sudo pkill -SIGHUP dockerd - -3. Do one of the following: - - * If you received an error when installing the ``nvidia-docker2`` package, skip to :ref:`Step 4 `. - * If you successfully installed the ``nvidia-docker2`` package, skip to :ref:`Step 5 `. - -.. _step_4_centos: - -4. Do the following: - - 1. Run the ``sudo vi /etc/yum.repos.d/nvidia-docker.repo`` command if the following error is displayed when installing the ``nvidia-docker2`` package: - - - .. code-block:: console - - https://nvidia.github.io/nvidia-docker/centos7/ppc64le/repodata/repomd.xml: - [Errno -1] repomd.xml signature could not be verified for nvidia-docker - - 2. Change ``repo_gpgcheck=1`` to ``repo_gpgcheck=0``. - -.. _step_5_centos: - -5. Verify that the NVIDIA-Docker run has been installed correctly: - - .. code-block:: console - - $ docker run --runtime=nvidia --rm nvidia/cuda:10.1-base nvidia-smi - -For more information on installing the NVIDIA Docker2 Toolkit on a CentOS operating system, see :ref:`Installing the NVIDIA Docker2 Toolkit on a CentOS operating system ` - - -.. _install_nvidia_docker2_toolkit_ubuntu: - -Installing the NVIDIA Docker2 Toolkit on an Ubuntu Operating System -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**To install the NVIDIA Docker2 Toolkit on an Ubuntu operating system:** - -1. Install the repository for your distribution: - - .. code-block:: console - - curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add - - distribution=$(. /etc/os-release;echo $ID$VERSION_ID) - curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list - sudo apt-get update - -2. Install the ``nvidia-docker2`` package and reload the Docker daemon configuration: - - .. code-block:: console - - $ sudo apt-get install nvidia-docker2 - $ sudo pkill -SIGHUP dockerd - -3. Do one of the following: - - * If you received an error when installing the ``nvidia-docker2`` package, skip to :ref:`Step 4 `. - * If you successfully installed the ``nvidia-docker2`` package, skip to :ref:`Step 5 `. - - .. _step_4_ubuntu: - -4. Do the following: - - 1. Run the ``sudo vi /etc/yum.repos.d/nvidia-docker.repo`` command if the following error is displayed when installing the ``nvidia-docker2`` package: - - .. code-block:: console - - https://nvidia.github.io/nvidia-docker/centos7/ppc64le/repodata/repomd.xml: - [Errno -1] repomd.xml signature could not be verified for nvidia-docker - - 2. Change ``repo_gpgcheck=1`` to ``repo_gpgcheck=0``. - -.. _step_5_ubuntu: - -5. Verify that the NVIDIA-Docker run has been installed correctly: - - .. code-block:: console - - $ docker run --runtime=nvidia --rm nvidia/cuda:10.1-base nvidia-smi - -For more information on installing the NVIDIA Docker2 Toolkit on a CentOS operating system, see :ref:`Installing the NVIDIA Docker2 Toolkit on an Ubuntu operating system ` - -.. _install_nvidia_docker2_toolkit_ppc64le_processor: - -Installing the NVIDIA Docker2 Toolkit on a PPC64le Processor --------------------------------------- - -This section describes how to install the NVIDIA Docker2 Toolkit on an IBM RHEL operating system: - -**To install the NVIDIA Docker2 Toolkit on an IBM RHEL operating system:** - -1. Import the repository and install the ``libnvidia-container`` and the ``nvidia-container-runtime`` containers. - - .. code-block:: console - - $ distribution=$(. /etc/os-release;echo $ID$VERSION_ID) - $ curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.repo | \ - sudo tee /etc/yum.repos.d/nvidia-docker.repo - $ sudo yum install -y libnvidia-container* - -2. Do one of the following: - - * If you received an error when installing the containers, skip to :ref:`Step 3 `. - * If you successfully installed the containers, skip to :ref:`Step 4 `. - -.. _step_3_installing_nvidia_docker2_toolkit_ppc64le_processor: - -3. Do the following: - - 1. Run the ``sudo vi /etc/yum.repos.d/nvidia-docker.repo`` command if the following error is displayed when installing the containers: - - .. code-block:: console - - https://nvidia.github.io/nvidia-docker/centos7/ppc64le/repodata/repomd.xml: - [Errno -1] repomd.xml signature could not be verified for nvidia-docker - - 2. Change ``repo_gpgcheck=1`` to ``repo_gpgcheck=0``. - - :: - - 3. Install the ``libnvidia-container`` container. - - .. code-block:: console - - $ sudo yum install -y libnvidia-container* - - .. _step_4_installing_nvidia_docker2_toolkit_ppc64le_processor: - -4. Install the ``nvidia-container-runtime`` container: - - .. code-block:: console - - $ sudo yum install -y nvidia-container-runtime* - -5. Add ``nvidia runtime`` to the Docker daemon: - - .. code-block:: console - - $ sudo mkdir -p /etc/systemd/system/docker.service.d/ - $ sudo vi /etc/systemd/system/docker.service.d/override.conf - - $ [Service] - $ ExecStart= - $ ExecStart=/usr/bin/dockerd - -6. Restart Docker: - - .. code-block:: console - - $ sudo systemctl daemon-reload - $ sudo systemctl restart docker - -7. Verify that the NVIDIA-Docker run has been installed correctly: - - .. code-block:: console - - $ docker run --runtime=nvidia --rm nvidia/cuda-ppc64le nvidia-smi - -.. _accessing_hadoop_kubernetes_configuration_files: - -Accessing the Hadoop and Kubernetes Configuration Files --------------------------------------- -The information this section is optional and is only relevant for Hadoop users. If you require Hadoop and Kubernetes (Krb5) connectivity, contact your IT department for access to the following configuration files: - -* Hadoop configuration files: - - * core-site.xml - * hdfs-site.xml - - :: - -* Kubernetes files: - - * Configuration file - krb.conf - * Kubernetes Hadoop client certificate - hdfs.keytab - -Once you have the above files, you must copy them into the correct folders in your working directory. - -For more information about the correct directory to copy the above files into, see the :ref:`Installing the SQream Software ` section below. - -For related information, see the following sections: - -* :ref:`Configuring the Hadoop and Kubernetes Configuration Files ` -* :ref:`Setting the Hadoop and Kubernetes Configuration Parameters ` - -.. _installing_sqream_software: - -Installing the SQream Software -============================== - -Preparing Your Local Environment -------------------------- -After installing the Nvidia Docker2 toolKit you must prepare your local environment. - -.. note:: You must install the SQream software under a *sqream* and not a *root* user. - -The Linux user preparing the local environment must have **read/write** access to the following directories for the SQream software to correctly read and write the required resources: - -* **Log directory** - default: /var/log/sqream/ -* **Configuration directory** - default: /etc/sqream/ -* **Cluster directory** - the location where SQream writes its DB system, such as */mnt/sqreamdb* -* **Ingest directory** - the location where the required data is loaded, such as */mnt/data_source/* - -.. _download_sqream_software: - -Deploying the SQream Software -------------------------- -After preparing your local environment you must deploy the SQream software. Deploying the SQream software requires you to access and extract the required files and to place them in the correct directory. - -**To deploy the SQream software:** - -1. Contact the SQream Support team for access to the **sqream_installer-nnn-DBnnn-COnnn-EDnnn-.tar.gz** file. - -The **sqream_installer-nnn-DBnnn-COnnn-EDnnn-.tar.gz** file includes the following parameter values: - -* **sqream_installer-nnn** - sqream installer version -* **DBnnn** - SQreamDB version -* **COnnn** - SQream console version -* **EDnnn** - SQream editor version -* **arch** - server arch (applicable to X86.64 and ppc64le) - -2. Extract the tarball file: - - .. code-block:: console - - $ tar -xvf sqream_installer-1.1.5-DB2019.2.1-CO1.5.4-ED3.0.0-x86_64.tar.gz - -When the tarball file has been extracted, a new folder will be created. The new folder is automatically given the name of the tarball file: - - .. code-block:: console - - drwxrwxr-x 9 sqream sqream 4096 Aug 11 11:51 sqream_istaller-1.1.5-DB2019.2.1-CO1.5.4-ED3.0.0-x86_64/ - -rw-rw-r-- 1 sqream sqream 3130398797 Aug 11 11:20 sqream_installer-1.1.5-DB2019.2.1-CO1.5.4-ED3.0.0-x86_64.tar.gz - -3. Change the directory to the new folder that you created in the previous step. - -:: - -4. Verify that the folder you just created contains all of the required files. - - .. code-block:: console - - $ ls -la - - The following is an example of the files included in the new folder: - - .. code-block:: console - - drwxrwxr-x. 10 sqream sqream 198 Jun 3 17:57 . - drwx------. 25 sqream sqream 4096 Jun 7 18:11 .. - drwxrwxr-x. 2 sqream sqream 226 Jun 7 18:09 .docker - drwxrwxr-x. 2 sqream sqream 64 Jun 3 12:55 .hadoop - drwxrwxr-x. 2 sqream sqream 4096 May 31 14:18 .install - drwxrwxr-x. 2 sqream sqream 39 Jun 3 12:53 .krb5 - drwxrwxr-x. 2 sqream sqream 22 May 31 14:18 license - drwxrwxr-x. 2 sqream sqream 82 May 31 14:18 .sqream - -rwxrwxr-x. 1 sqream sqream 1712 May 31 14:18 sqream-console - -rwxrwxr-x. 1 sqream sqream 4608 May 31 14:18 sqream-install - -For information relevant to Hadoop users, see the following sections: - -* :ref:`Accessing the Hadoop and Kubernetes Configuration Files `. -* :ref:`Configuring the Hadoop and Kubernetes Configuration Files `. -* :ref:`Setting the Hadoop and Kubernetes Configuration Parameters `. - -.. _configure_hadoop_kubernetes_configuration_files: - -Configuring the Hadoop and Kubernetes Configuration Files ------------------------------ -The information in this section is optional and is only relevant for Hadoop users. If you require Hadoop and Kubernetes (Krb5) connectivity, you must copy the Hadoop and Kubernetes files into the correct folders in your working directory as shown below: - -* .hadoop/core-site.xml -* .hadoop/hdfs-site.xml -* .krb5/krb5.conf -* .krb5/hdfs.keytab - -For related information, see the following sections: - -* :ref:`Accessing the Hadoop and Kubernetes Configuration Files `. -* :ref:`Setting the Hadoop and Kubernetes Configuration Parameters `. - -Configuring the SQream Software -------------------------------- -After deploying the SQream software, and optionally configuring the Hadoop and Kubernetes configuration files, you must configure the SQream software. - -Configuring the SQream software requires you to do the following: - -* Configure your local environment -* Understand the ``sqream-install`` flags -* Install your SQream license -* Validate your SQream icense -* Change your data ingest folder - -Configuring Your Local Environment -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Once you've downloaded the SQream software, you can begin configuring your local environment. The following commands must be run (as **sudo**) from the same directory that you located your packages. - -For example, you may have saved your packages in **/home/sqream/sqream-console-package/**. - -The following table shows the flags that you can use to configure your local directory: - -.. list-table:: - :widths: 10 50 40 - :header-rows: 1 - - * - Flag - - Function - - Note - * - **-i** - - Loads all software from the hidden folder **.docker**. - - Mandatory - * - **-k** - - Loads all license packages from the **/license** directory. - - Mandatory - * - **-f** - - Overwrites existing folders. **Note** Using ``-f`` overwrites **all files** located in mounted directories. - - Mandatory - * - **-c** - - Defines the origin path for writing/reading SQream configuration files. The default location is ``/etc/sqream/``. - - If you are installing the Docker version on a server that already works with SQream, do not use the default path. - * - **-v** - - The SQream cluster location. If a cluster does not exist yet, ``-v`` creates one. If a cluster already exists, ``-v`` mounts it. - - Mandatory - * - **-l** - - SQream system startup logs location, including startup logs and docker logs. The default location is ``/var/log/sqream/``. - - - * - **-d** - - The directory containing customer data to be imported and/or copied to SQream. - - - * - **-s** - - Shows system settings. - - - * - **-r** - - Resets the system configuration. This value is run without any other variables. - - Mandatory - * - **-h** - - Help. Shows the available flags. - - Mandatory - * - **-K** - - Runs license validation - - - * - **-e** - - Used for inserting your RKrb5 server DNS name. For more information on setting your Kerberos configuration parameters, see :ref:`Setting the Hadoop and Kubernetes Configuration Parameters `. - - - * - **-p** - - Used for inserting your Kerberos user name. For more information on setting your Kerberos configuration parameters, see :ref:`Setting the Hadoop and Kubernetes Configuration Parameters `. - - - - -Installing Your License -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Once you've configured your local environment, you must install your license by copying it into the SQream installation package folder located in the **./license** folder: - -.. code-block:: console - - $ sudo ./sqream-install -k - -You do not need to extract this folder after uploading into the **./license**. - - -Validating Your License -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -You can copy your license package into the SQream console folder located in the **/license** folder by running the following command: - -.. code-block:: console - - $ sudo ./sqream-install -K - -The following mandatory flags must be used in the first run: - -.. code-block:: console - - $ sudo ./sqream-install -i -k -v - -The following is an example of the correct command syntax: - -.. code-block:: console - - $ sudo ./sqream-install -i -k -c /etc/sqream -v /home/sqream/sqreamdb -l /var/log/sqream -d /home/sqream/data_ingest - -.. _setting_hadoop_kubernetes_connectivity_parameters: - -Setting the Hadoop and Kubernetes Connectivity Parameters -------------------------------- -The information in this section is optional, and is only relevant for Hadoop users. If you require Hadoop and Kubernetes (Krb5) connectivity, you must set their connectivity parameters. - -The following is the correct syntax when setting the Hadoop and Kubernetes connectivity parameters: - -.. code-block:: console - - $ sudo ./sqream-install -p -e : - -The following is an example of setting the Hadoop and Kubernetes connectivity parameters: - -.. code-block:: console - - $ sudo ./sqream-install -p -e kdc.sq.com:<192.168.1.111> - -For related information, see the following sections: - -* :ref:`Accessing the Hadoop and Kubernetes Configuration Files `. -* :ref:`Configuring the Hadoop and Kubernetes Configuration Files `. - -Modifying Your Data Ingest Folder -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Once you've validated your license, you can modify your data ingest folder after the first run by running the following command: - -.. code-block:: console - - $ sudo ./sqream-install -d /home/sqream/data_in - -Configuring Your Network for Docker -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Once you've modified your data ingest folder (if needed), you must validate that the server network and Docker network that you are setting up do not overlap. - -**To configure your network for Docker:** - -1. To verify that your server network and Docker network do not overlap, run the following command: - -.. code-block:: console - - $ ifconfig | grep 172. - -2. Do one of the following: - - * If running the above command output no results, continue the installation process. - * If running the above command output results, run the following command: - - .. code-block:: console - - $ ifconfig | grep 192.168. - - -Checking and Verifying Your System Settings -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Once you've configured your network for Docker, you can check and verify your system settings. - -Running the following command shows you all the variables used by your SQream system: - -.. code-block:: console - - $ ./sqream-install -s - -The following is an example of the correct output: - -.. code-block:: console - - SQREAM_CONSOLE_TAG=1.5.4 - SQREAM_TAG=2019.2.1 - SQREAM_EDITOR_TAG=3.0.0 - license_worker_0=f0:cc: - license_worker_1=26:91: - license_worker_2=20:26: - license_worker_3=00:36: - SQREAM_VOLUME=/media/sqreamdb - SQREAM_DATA_INGEST=/media/sqreamdb/data_in - SQREAM_CONFIG_DIR=/etc/sqream/ - LICENSE_VALID=true - SQREAM_LOG_DIR=/var/log/sqream/ - SQREAM_USER=sqream - SQREAM_HOME=/home/sqream - SQREAM_ENV_PATH=/home/sqream/.sqream/env_file - PROCESSOR=x86_64 - METADATA_PORT=3105 - PICKER_PORT=3108 - NUM_OF_GPUS=2 - CUDA_VERSION=10.1 - NVIDIA_SMI_PATH=/usr/bin/nvidia-smi - DOCKER_PATH=/usr/bin/docker - NVIDIA_DRIVER=418 - SQREAM_MODE=single_host - -Using the SQream Console -========================= -After configuring the SQream software and veriying your system settings you can begin using the SQream console. - -SQream Console - Basic Commands ---------------------------------- -The SQream console offers the following basic commands: - -* :ref:`Starting your SQream console ` -* :ref:`Starting Metadata and Picker ` -* :ref:`Starting the running services ` -* :ref:`Listing the running services ` -* :ref:`Stopping the running services ` -* :ref:`Using the SQream editor ` -* :ref:`Using the SQream Client ` - -.. _starting_sqream_console: - -Starting Your SQream Console -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -You can start your SQream console by running the following command: - -.. code-block:: console - - $ ./sqream-console - -.. _starting_metadata_and_picker: - -Starting the SQream Master -~~~~~~~~~~~~~~~~~ - -**To listen to metadata and picker:** - -1. Start the metadata server (default port 3105) and picker (default port 3108) by running the following command: - - .. code-block:: console - - $ sqream master --start - - The following is the correct output: - - .. code-block:: console - - sqream-console> sqream master --start - starting master server in single_host mode ... - sqream_single_host_master is up and listening on ports: 3105,3108 - - -2. *Optional* - Change the metadata and server picker ports by adding ``-p `` and ``-m ``: - - .. code-block:: console - - $ sqream-console>sqream master --start -p 4105 -m 43108 - $ starting master server in single_host mode ... - $ sqream_single_host_master is up and listening on ports: 4105,4108 - - - -.. _starting_running_services: - -Starting SQream Workers -~~~~~~~~~~~~~~~~~ - - -When starting SQream workers, setting the ```` value sets how many workers to start. Leaving the ```` value unspecified runs all of the available resources. - - -.. code-block:: console - - $ sqream worker --start - - The following is an example of expected output when setting the ```` value to ``2``: - - .. code-block:: console - - sqream-console>sqream worker --start 2 - started sqream_single_host_worker_0 on port 5000, allocated gpu: 0 - started sqream_single_host_worker_1 on port 5001, allocated gpu: 1 - - -.. _listing_running_services: - -Listing the Running Services -~~~~~~~~~~~~~~~~~ - -You can list running SQream services to look for container names and ID's by running the following command: - -.. code-block:: console - - $ sqream master --list - -The following is an example of the expected output: - -.. code-block:: console - - sqream-console>sqream master --list - container name: sqream_single_host_worker_0, container id: c919e8fb78c8 - container name: sqream_single_host_master, container id: ea7eef80e038-- - - -.. _stopping_running_services: - -Stopping the Running Services -~~~~~~~~~~~~~~~~~ - -You can stop running services either for a single SQream worker, or all SQream services for both master and worker. - -The following is the command for stopping a running service for a single SQream worker: - -.. code-block:: console - - $ sqream worker --stop - -The following is an example of expected output when stopping a running service for a single SQream worker: - -.. code-block:: console - - sqream worker stop - stopped container sqream_single_host_worker_0, id: 892a8f1a58c5 - - -You can stop all running SQream services (both master and worker) by running the following command: - -.. code-block:: console - - $ sqream-console>sqream master --stop --all - -The following is an example of expected output when stopping all running services: - -.. code-block:: console - - sqream-console>sqream master --stop --all - stopped container sqream_single_host_worker_0, id: 892a8f1a58c5 - stopped container sqream_single_host_master, id: 55cb7e38eb22 - - -.. _using_sqream_editor: - -Using SQream Studio -~~~~~~~~~~~~~~~~~ -SQream Studio is an SQL statement editor. - -**To start SQream Studio:** - -1. Run the following command: - - .. code-block:: console - - $ sqream studio --start - -The following is an example of the expected output: - - .. code-block:: console - - SQream Acceleration Studio is available at http://192.168.1.62:8080 - -2. Click the ``http://192.168.1.62:8080`` link shown in the CLI. - - -**To stop SQream Studio:** - -You can stop your SQream Studio by running the following command: - -.. code-block:: console - - $ sqream studio --stop - -The following is an example of the expected output: - -.. code-block:: console - - sqream_admin stopped - - -.. _using_sqream_client: - -Using the SQream Client -~~~~~~~~~~~~~~~~~ - - -You can use the embedded SQream Client on the following nodes: - -* Master node -* Worker node - - -When using the SQream Client on the Master node, the following default settings are used: - -* **Default port**: 3108. You can change the default port using the ``-p`` variable. -* **Default database**: master. You can change the default database using the ``-d`` variable. - -The following is an example: - -.. code-block:: console - - $ sqream client --master -u sqream -w sqream - - -When using the SQream Client on a Worker node (or nodes), you should use the ``-p`` variable for Worker ports. The default database is ``master``, but you can use the ``-d`` variable to change databases. - -The following is an example: - -.. code-block:: console - - $ sqream client --worker -p 5000 -u sqream -w sqream - - -Moving from Docker Installation to Standard On-Premises Installation ------------------------------------------------ - -Because Docker creates all files and directories on the host at the **root** level, you must grant ownership of the SQream storage folder to the working directory user. - -SQream Console - Advanced Commands ------------------------------ - -The SQream console offers the following advanced commands: - - -* :ref:`Controlling the spool size ` -* :ref:`Splitting a GPU ` -* :ref:`Splitting a GPU and setting the spool size ` -* :ref:`Using a custom configuration file ` -* :ref:`Clustering your Docker environment ` - - - - -.. _controlling_spool_size: - -Controlling the Spool Size -~~~~~~~~~~~~~~~~~~ - -From the console you can define a spool size value. - -The following example shows the spool size being set to ``50``: - -.. code-block:: console - - $ sqream-console>sqream worker --start 2 -m 50 - - -If you don't define the SQream spool size, the SQream console automatically distributes the available RAM between all running workers. - -.. _splitting_gpu: - -Splitting a GPU -~~~~~~~~~~~~~~~~~~ - -You can start more than one sqreamd on a single GPU by splitting it. - - -The following example shows the GPU being split into **two** sqreamd's on the GPU in **slot 0**: - -.. code-block:: console - - $ sqream-console>sqream worker --start 2 -g 0 - -.. _splitting_gpu_setting_spool_size: - -Splitting GPU and Setting the Spool Size -~~~~~~~~~~~~~~~~~~ - -You can simultaneously split a GPU and set the spool size by appending the ``-m`` flag: - -.. code-block:: console - - $ sqream-console>sqream worker --start 2 -g 0 -m 50 - -.. note:: The console does not validate whether the user-defined spool size is available. Before setting the spool size, verify that the requested resources are available. - -.. _using_custom_configuration_file: - -Using a Custom Configuration File -~~~~~~~~~~~~~~~~~~ - -SQream lets you use your own external custom configuration json files. You must place these json files in the path mounted in the installation. SQream recommends placing the json file in the Configuration folder. - -The SQream console does not validate the integrity of your external configuration files. - -When using your custom configuration file, you can use the ``-j`` flag to define the full path to the Configuration file, as in the example below: - -.. code-block:: console - - $ sqream-console>sqream worker --start 1 -j /etc/sqream/configfile.json - -.. note:: To start more than one sqream daemon, you must provide files for each daemon, as in the example below: - -.. code-block:: console - - $ sqream worker --start 2 -j /etc/sqream/configfile.json /etc/sqream/configfile2.json - -.. note:: To split a specific GPU, you must also list the GPU flag, as in the example below: - -.. code-block:: console - - $ sqream worker --start 2 -g 0 -j /etc/sqream/configfile.json /etc/sqream/configfile2.json - -.. _clustering_docker_environment: - -Clustering Your Docker Environment -~~~~~~~~~~~~~~~~~~ - -SQream lets you connect to a remote Master node to start Docker in Distributed mode. If you have already connected to a Slave node server in Distributed mode, the **sqream Master** and **Client** commands are only available on the Master node. - -.. code-block:: console - - $ --master-host - $ sqream-console>sqream worker --start 1 --master-host 192.168.0.1020 - -Checking the Status of SQream Services ---------------------------- -SQream lets you check the status of SQream services from the following locations: - -* :ref:`From the Sqream console ` -* :ref:`From outside the Sqream console ` - -.. _inside_sqream_console: - -Checking the Status of SQream Services from the SQream Console -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -From the SQream console, you can check the status of SQream services by running the following command: - -.. code-block:: console - - $ sqream-console>sqream master --list - -The following is an example of the expected output: - -.. code-block:: console - - $ sqream-console>sqream master --list - $ checking 3 sqream services: - $ sqream_single_host_worker_1 up, listens on port: 5001 allocated gpu: 1 - $ sqream_single_host_worker_0 up, listens on port: 5000 allocated gpu: 1 - $ sqream_single_host_master up listens on ports: 3105,3108 - -.. _outside_sqream_console: - -Checking the Status of SQream Services from Outside the SQream Console -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -From outside the Sqream Console, you can check the status of SQream services by running the following commands: - -.. code-block:: console - - $ sqream-status - $ NAMES STATUS PORTS - $ sqream_single_host_worker_1 Up 3 minutes 0.0.0.0:5001->5001/tcp - $ sqream_single_host_worker_0 Up 3 minutes 0.0.0.0:5000->5000/tcp - $ sqream_single_host_master Up 3 minutes 0.0.0.0:3105->3105/tcp, 0.0.0.0:3108->3108/tcp - $ sqream_editor_3.0.0 Up 3 hours (healthy) 0.0.0.0:3000->3000/tcp - -Upgrading Your SQream System ----------------------------- -This section describes how to upgrade your SQream system. - -**To upgrade your SQream system:** - -1. Contact the SQream Support team for access to the new SQream package tarball file. - - :: - -2. Set a maintenance window to enable stopping the system while upgrading it. - - :: - -3. Extract the following tarball file received from the SQream Support team, under it with the same user and in the same folder that you used while :ref:`Downloading the SQream Software <_download_sqream_software>`. - - - .. code-block:: console - - $ tar -xvf sqream_installer-2.0.5-DB2019.2.1-CO1.6.3-ED3.0.0-x86_64/ - -4. Navigate to the new folder created as a result of extracting the tarball file: - - .. code-block:: console - - $ cd sqream_installer-2.0.5-DB2019.2.1-CO1.6.3-ED3.0.0-x86_64/ - -5. Initiate the upgrade process: - - .. code-block:: console - - $ ./sqream-install -i - - Initiating the upgrade process checks if any SQream services are running. If any services are running, you will be prompted to stop them. - -6. Do one of the following: - - * Select **Yes** to stop all running SQream workers (Master and Editor) and continue the upgrade process. - * Select **No** to stop the upgrade process. - - SQream periodically upgrades the metadata structure. If an upgrade version includes a change to the metadata structure, you will be prompted with an approval request message. Your approval is required to finish the upgrade process. - - Because SQream supports only certain metadata versions, all SQream services must be upgraded at the same time. - -7. When the upgrade is complete, load the SQream console and restart your services. - - For assistance, contact SQream Support. From 14870eec41a11afdd0c17022438632b48b48a030 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 29 Mar 2022 12:34:57 +0300 Subject: [PATCH 031/882] Updated According to V2 Requirements ... According to Shachar's comments in SQream Documentation - Table of Contents sheet --- data_ingestion/index.rst | 3 +- data_ingestion/oracle.rst | 353 ------------ feature_guides/index.rst | 1 - getting_started/index.rst | 1 - .../performing_basic_sqream_operations.rst | 1 + index.rst | 2 - operational_guides/external_data.rst | 1 - operational_guides/hdfs.rst | 252 --------- operational_guides/index.rst | 1 - operational_guides/saved_queries.rst | 122 ----- .../client_drivers/cpp/connect_test.cpp | 34 -- .../client_drivers/cpp/index.rst | 87 --- .../client_drivers/cpp/insert_test.cpp | 39 -- third_party_tools/client_drivers/index.rst | 27 +- .../client_drivers/nodejs/index.rst | 382 ------------- .../client_drivers/nodejs/sample.js | 21 - .../client_drivers/python/api-reference.rst | 191 ------- .../client_drivers/python/index.rst | 502 ------------------ .../client_drivers/python/nba-t10.csv | 10 - .../client_drivers/python/test.py | 37 -- .../client_platforms/connect.sas | 27 - .../client_platforms/connect2.sas | 27 - .../client_platforms/connect3.sas | 17 - third_party_tools/client_platforms/index.rst | 37 -- .../client_platforms/informatica.rst | 173 ------ .../client_platforms/microstrategy.rst | 185 ------- .../client_platforms/odbc-sqream.tdc | 25 - .../client_platforms/pentaho.rst | 249 --------- third_party_tools/client_platforms/php.rst | 46 -- .../client_platforms/power_bi.rst | 143 ----- third_party_tools/client_platforms/r.rst | 151 ------ .../client_platforms/sas_viya.rst | 185 ------- .../client_platforms/sql_workbench.rst | 135 ----- .../client_platforms/tableau.rst | 453 ---------------- third_party_tools/client_platforms/talend.rst | 177 ------ third_party_tools/client_platforms/test.php | 16 - .../client_platforms/tibco_spotfire.rst | 387 -------------- third_party_tools/index.rst | 1 - troubleshooting/index.rst | 5 - troubleshooting/node_js_related_issues.rst | 54 -- troubleshooting/sas_viya_related_issues.rst | 55 -- .../solving_code_126_odbc_errors.rst | 14 - ...sqream_sql_installation_related_issues.rst | 33 -- troubleshooting/tableau_related_issues.rst | 73 --- 44 files changed, 3 insertions(+), 4732 deletions(-) delete mode 100644 data_ingestion/oracle.rst delete mode 100644 operational_guides/hdfs.rst delete mode 100644 operational_guides/saved_queries.rst delete mode 100644 third_party_tools/client_drivers/cpp/connect_test.cpp delete mode 100644 third_party_tools/client_drivers/cpp/index.rst delete mode 100644 third_party_tools/client_drivers/cpp/insert_test.cpp delete mode 100644 third_party_tools/client_drivers/nodejs/index.rst delete mode 100644 third_party_tools/client_drivers/nodejs/sample.js delete mode 100644 third_party_tools/client_drivers/python/api-reference.rst delete mode 100644 third_party_tools/client_drivers/python/index.rst delete mode 100644 third_party_tools/client_drivers/python/nba-t10.csv delete mode 100644 third_party_tools/client_drivers/python/test.py delete mode 100644 third_party_tools/client_platforms/connect.sas delete mode 100644 third_party_tools/client_platforms/connect2.sas delete mode 100644 third_party_tools/client_platforms/connect3.sas delete mode 100644 third_party_tools/client_platforms/index.rst delete mode 100644 third_party_tools/client_platforms/informatica.rst delete mode 100644 third_party_tools/client_platforms/microstrategy.rst delete mode 100644 third_party_tools/client_platforms/odbc-sqream.tdc delete mode 100644 third_party_tools/client_platforms/pentaho.rst delete mode 100644 third_party_tools/client_platforms/php.rst delete mode 100644 third_party_tools/client_platforms/power_bi.rst delete mode 100644 third_party_tools/client_platforms/r.rst delete mode 100644 third_party_tools/client_platforms/sas_viya.rst delete mode 100644 third_party_tools/client_platforms/sql_workbench.rst delete mode 100644 third_party_tools/client_platforms/tableau.rst delete mode 100644 third_party_tools/client_platforms/talend.rst delete mode 100644 third_party_tools/client_platforms/test.php delete mode 100644 third_party_tools/client_platforms/tibco_spotfire.rst delete mode 100644 troubleshooting/node_js_related_issues.rst delete mode 100644 troubleshooting/sas_viya_related_issues.rst delete mode 100644 troubleshooting/solving_code_126_odbc_errors.rst delete mode 100644 troubleshooting/sqream_sql_installation_related_issues.rst delete mode 100644 troubleshooting/tableau_related_issues.rst diff --git a/data_ingestion/index.rst b/data_ingestion/index.rst index 83aca40ea..ffcb60552 100644 --- a/data_ingestion/index.rst +++ b/data_ingestion/index.rst @@ -13,6 +13,5 @@ The **Data Ingestion Sources** provides information about the following: csv parquet orc - oracle -For information about database tools and interfaces that SQream supports, see `Third Party Tools `_. +For information about database tools and interfaces that SQream supports, see `Third Party Tools `_. \ No newline at end of file diff --git a/data_ingestion/oracle.rst b/data_ingestion/oracle.rst deleted file mode 100644 index 0b0e6d5c8..000000000 --- a/data_ingestion/oracle.rst +++ /dev/null @@ -1,353 +0,0 @@ -.. _oracle: - -********************** -Migrating Data from Oracle -********************** - -This guide covers actions required for migrating from Oracle to SQream DB with CSV files. - -.. contents:: In this topic: - :local: - - -1. Preparing the tools and login information -==================================================== - -* Migrating data from Oracle requires a username and password for your Oracle system. - -* In this guide, we'll use the `Oracle Data Pump `_ , specifically the `Data Pump Export utility `_ . - - -2. Export the desired schema -=================================== - -Use the Data Pump Export utility to export the database schema. - -The format for using the Export utility is - - ``expdp / DIRECTORY= DUMPFILE= CONTENT=metadata_only NOLOGFILE`` - -The resulting Oracle-only schema is stored in a dump file. - - -Examples ------------- - -Dump all tables -^^^^^^^^^^^^^^^^^^^^^^ - -.. code-block:: console - - $ expdp rhendricks/secretpassword DIRECTORY=dpumpdir DUMPFILE=tables.dmp CONTENT=metadata_only NOLOGFILE - - -Dump only specific tables -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -In this example, we specify two tables for dumping. - -.. code-block:: console - - $ expdp rhendricks/secretpassword DIRECTORY=dpumpdir DUMPFILE=tables.dmp CONTENT=metadata_only TABLES=employees,jobs NOLOGFILE - -3. Convert the Oracle dump to standard SQL -======================================================= - -Oracle's Data Pump Import utility will help us convert the dump from the previous step to standard SQL. - -The format for using the Import utility is - - ``impdp / DIRECTORY= DUMPFILE= SQLFILE= TRANSFORM=SEGMENT_ATTRIBUTES:N:table PARTITION_OPTIONS=MERGE`` - -* ``TRANSFORM=SEGMENT_ATTRIBUTES:N:table`` excludes segment attributes (both STORAGE and TABLESPACE) from the tables - -* ``PARTITON_OPTIONS=MERGE`` combines all partitions and subpartitions into one table. - -Example ----------- - -.. code-block:: console - - $ impdp rhendricks/secretpassword DIRECTORY=dpumpdir DUMPFILE=tables.dmp SQLFILE=sql_export.sql TRANSFORM=SEGMENT_ATTRIBUTES:N:table PARTITION_OPTIONS=MERGE - -4. Figure out the database structures -=============================================== - -Using the SQL file created in the previous step, write CREATE TABLE statements to match the schemas of the tables. - -Remove unsupported attributes ------------------------------------ - -Trim unsupported primary keys, indexes, constraints, and other unsupported Oracle attributes. - -Match data types ---------------------- - -Refer to the table below to match the Oracle source data type to a new SQream DB type: - -.. list-table:: Data types - :widths: auto - :header-rows: 1 - - * - Oracle Data type - - Precision - - SQream DB data type - * - ``CHAR(n)``, ``CHARACTER(n)`` - - Any ``n`` - - ``VARCHAR(n)`` - * - ``BLOB``, ``CLOB``, ``NCLOB``, ``LONG`` - - - - ``TEXT`` - * - ``DATE`` - - - - ``DATE`` - * - ``FLOAT(p)`` - - p <= 63 - - ``REAL`` - * - ``FLOAT(p)`` - - p > 63 - - ``FLOAT``, ``DOUBLE`` - - * - ``NCHAR(n)``, ``NVARCHAR2(n)`` - - Any ``n`` - - ``TEXT`` (alias of ``NVARCHAR``) - - * - ``NUMBER(p)``, ``NUMBER(p,0)`` - - p < 5 - - ``SMALLINT`` - - * - ``NUMBER(p)``, `NUMBER(p,0)`` - - p < 9 - - ``INT`` - - * - ``NUMBER(p)``, `NUMBER(p,0)`` - - p < 19 - - ``INT`` - - * - ``NUMBER(p)``, `NUMBER(p,0)`` - - p >= 20 - - ``BIGINT`` - - * - ``NUMBER(p,f)``, ``NUMBER(*,f)`` - - f > 0 - - ``FLOAT`` / ``DOUBLE`` - - * - ``VARCHAR(n)``, ``VARCHAR2(n)`` - - Any ``n`` - - ``VARCHAR(n)`` or ``TEXT`` - * - ``TIMESTAMP`` - - - - ``DATETIME`` - -Read more about :ref:`supported data types in SQream DB`. - -Additional considerations ------------------------------ - -* Understand how :ref:`tables are created in SQream DB` - -* Learn how :ref:`SQream DB handles null values`, particularly with regards to constraints. - -* Oracle roles and user management commands need to be rewritten to SQream DB's format. SQream DB supports :ref:`full role-based access control (RBAC)` similar to Oracle. - -5. Create the tables in SQream DB -====================================== - -After rewriting the table strucutres, create them in SQream DB. - -Example ---------- - - -Consider Oracle's ``HR.EMPLOYEES`` sample table: - -.. code-block:: sql - - CREATE TABLE employees - ( employee_id NUMBER(6) - , first_name VARCHAR2(20) - , last_name VARCHAR2(25) - CONSTRAINT emp_last_name_nn NOT NULL - , email VARCHAR2(25) - CONSTRAINT emp_email_nn NOT NULL - , phone_number VARCHAR2(20) - , hire_date DATE - CONSTRAINT emp_hire_date_nn NOT NULL - , job_id VARCHAR2(10) - CONSTRAINT emp_job_nn NOT NULL - , salary NUMBER(8,2) - , commission_pct NUMBER(2,2) - , manager_id NUMBER(6) - , department_id NUMBER(4) - , CONSTRAINT emp_salary_min - CHECK (salary > 0) - , CONSTRAINT emp_email_uk - UNIQUE (email) - ) ; - CREATE UNIQUE INDEX emp_emp_id_pk - ON employees (employee_id) ; - - ALTER TABLE employees - ADD ( CONSTRAINT emp_emp_id_pk - PRIMARY KEY (employee_id) - , CONSTRAINT emp_dept_fk - FOREIGN KEY (department_id) - REFERENCES departments - , CONSTRAINT emp_job_fk - FOREIGN KEY (job_id) - REFERENCES jobs (job_id) - , CONSTRAINT emp_manager_fk - FOREIGN KEY (manager_id) - REFERENCES employees - ) ; - -This table rewritten for SQream DB would be created like this: - -.. code-block:: postgres - - CREATE TABLE employees - ( - employee_id SMALLINT NOT NULL, - first_name VARCHAR(20), - last_name VARCHAR(25) NOT NULL, - email VARCHAR(20) NOT NULL, - phone_number VARCHAR(20), - hire_date DATE NOT NULL, - job_id VARCHAR(10) NOT NULL, - salary FLOAT, - commission_pct REAL, - manager_id SMALLINT, - department_id TINYINT - ); - - -6. Export tables to CSVs -=============================== - -Exporting CSVs from Oracle servers is not a trivial task. - -.. contents:: Options for exporting to CSVs - :local: - -Using SQL*Plus to export data lists ------------------------------------------- - -Here's a sample SQL*Plus script that will export PSVs in a format that SQream DB can read: - -:download:`Download to_csv.sql ` - -.. literalinclude:: to_csv.sql - :language: sql - :caption: Oracle SQL*Plus CSV export script - :linenos: - -Enter SQL*Plus and export tables one-by-one interactively: - -.. code-block:: console - - $ sqlplus rhendricks/secretpassword - - @spool employees - @spool jobs - [...] - EXIT - -Each table is exported as a data list file (``.lst``). - -Creating CSVs using stored procedures -------------------------------------------- - -You can use stored procedures if you have them set-up. - -Examples of `stored procedures for generating CSVs `_` can be found in the Ask The Oracle Mentors forums. - -CSV generation considerations -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -* Files should be a valid CSV. By default, SQream DB's CSV parser can handle `RFC 4180 standard CSVs `_ , but can also be modified to support non-standard CSVs (with multi-character delimiters, unquoted fields, etc). - -* Files are UTF-8 or ASCII encoded - -* Field delimiter is an ASCII character or characters - -* Record delimiter, also known as a new line separator, is a Unix-style newline (``\n``), DOS-style newline (``\r\n``), or Mac style newline (``\r``). - -* Fields are optionally enclosed by double-quotes, or mandatory quoted if they contain one of the following characters: - - * The record delimiter or field delimiter - - * A double quote character - - * A newline - -* - If a field is quoted, any double quote that appears must be double-quoted (similar to the :ref:`string literals quoting rules`. For example, to encode ``What are "birds"?``, the field should appear as ``"What are ""birds""?"``. - - Other modes of escaping are not supported (e.g. ``1,"What are \"birds\"?"`` is not a valid way of escaping CSV values). - -* ``NULL`` values can be marked in two ways in the CSV: - - - An explicit null marker. For example, ``col1,\N,col3`` - - An empty field delimited by the field delimiter. For example, ``col1,,col3`` - - .. note:: If a text field is quoted but contains no content (``""``) it is considered an empty text field. It is not considered ``NULL``. - - -7. Place CSVs where SQream DB workers can access -======================================================= - -During data load, the :ref:`copy_from` command can run on any worker (unless explicitly speficied with the :ref:`workload_manager`). -It is important that every node has the same view of the storage being used - meaning, every SQream DB worker should have access to the files. - -* For files hosted on NFS, ensure that the mount is accessible from all servers. - -* For HDFS, ensure that SQream DB servers can access the HDFS name node with the correct user-id - -* For S3, ensure network access to the S3 endpoint - -8. Bulk load the CSVs -================================= - -Issue the :ref:`copy_from` commands to SQream DB to insert a table from the CSVs created. - -Repeat the ``COPY FROM`` command for each table exported from Oracle. - -Example -------------- - -For the ``employees`` table, run the following command: - -.. code-block:: postgres - - COPY employees FROM 'employees.lst' WITH DELIMITER '|'; - -9. Rewrite Oracle queries -===================================== - -SQream DB supports a large subset of ANSI SQL. - -You will have to refactor much of Oracle's SQL and functions that often are not ANSI SQL. - -We recommend the following resources: - -* :ref:`sql_feature_support` - to understand SQream DB's SQL feature support. - -* :ref:`sql_best_practices` - to understand best practices for SQL queries and schema design. - -* :ref:`common_table_expressions` - CTEs can be used to rewrite complex queries in a compact form. - -* :ref:`concurrency_and_locks` - to understand the difference between Oracle's transactions and SQream DB's concurrency. - -* :ref:`identity` - SQream DB supports sequences, but no triggers for auto-increment. - -* :ref:`joins` - SQream DB supports ANSI join syntax. Oracle uses the ``+`` operator which SQream DB doesn't support. - -* :ref:`saved_queries` - Saved queries can be used to emulate some stored procedures. - -* :ref:`subqueries` - SQream DB supports a limited set of subqueries. - -* :ref:`python_functions` - SQream DB supports Python User Defined Functions which can be used to run complex operations in-line. - -* :ref:`Views` - SQream DB supports logical views, but does not support materialized views. - -* :ref:`window_functions` - SQream DB supports a wide array of window functions. \ No newline at end of file diff --git a/feature_guides/index.rst b/feature_guides/index.rst index c5f472785..9a5c8621d 100644 --- a/feature_guides/index.rst +++ b/feature_guides/index.rst @@ -16,7 +16,6 @@ This section describes the following features: compression flexible_data_clustering python_functions - saved_queries viewing_system_objects_as_ddl workload_manager transactions diff --git a/getting_started/index.rst b/getting_started/index.rst index f9a57a460..e799d047a 100644 --- a/getting_started/index.rst +++ b/getting_started/index.rst @@ -11,6 +11,5 @@ The **Getting Started** page describes the following things you need to start us preparing_your_machine_to_install_sqream installing_sqream - creating_a_database executing_statements_in_sqream performing_basic_sqream_operations \ No newline at end of file diff --git a/getting_started/performing_basic_sqream_operations.rst b/getting_started/performing_basic_sqream_operations.rst index ba0a6fc3f..81ea9b05f 100644 --- a/getting_started/performing_basic_sqream_operations.rst +++ b/getting_started/performing_basic_sqream_operations.rst @@ -11,6 +11,7 @@ After installing SQream you can perform the operations described on this page: running_the_sqream_sql_client creating_your_first_table + creating_a_database listing_tables inserting_rows running_queries diff --git a/index.rst b/index.rst index 26b7459ec..cb7d685b2 100644 --- a/index.rst +++ b/index.rst @@ -72,8 +72,6 @@ SQream DB easily plugs in to third-party tools like :ref:`Tableau` - :ref:`Third party tools integration` - :ref:`connect_to_tableau` - :ref:`troubleshooting` guide diff --git a/operational_guides/external_data.rst b/operational_guides/external_data.rst index 98d157ab2..576e50ea4 100644 --- a/operational_guides/external_data.rst +++ b/operational_guides/external_data.rst @@ -11,5 +11,4 @@ SQream DB supports external data sources for use with :ref:`external_tables`, :r :titlesonly: s3 - hdfs diff --git a/operational_guides/hdfs.rst b/operational_guides/hdfs.rst deleted file mode 100644 index 274926e36..000000000 --- a/operational_guides/hdfs.rst +++ /dev/null @@ -1,252 +0,0 @@ -.. _hdfs: - -.. _back_to_top_hdfs: - -Using SQream in an HDFS Environment -======================================= - -.. _configuring_an_hdfs_environment_for_the_user_sqream: - -Configuring an HDFS Environment for the User **sqream** ----------------------------------------------------------- - -This section describes how to configure an HDFS environment for the user **sqream** and is only relevant for users with an HDFS environment. - -**To configure an HDFS environment for the user sqream:** - -1. Open your **bash_profile** configuration file for editing: - - .. code-block:: console - - $ vim /home/sqream/.bash_profile - -.. - Comment: - see below; do we want to be a bit more specific on what changes we're talking about? - - .. code-block:: console - - $ #PATH=$PATH:$HOME/.local/bin:$HOME/bin - - $ #export PATH - - $ # PS1 - $ #MYIP=$(curl -s -XGET "http://ip-api.com/json" | python -c 'import json,sys; jstr=json.load(sys.stdin); print jstr["query"]') - $ #PS1="\[\e[01;32m\]\D{%F %T} \[\e[01;33m\]\u@\[\e[01;36m\]$MYIP \[\e[01;31m\]\w\[\e[37;36m\]\$ \[\e[1;37m\]" - - $ SQREAM_HOME=/usr/local/sqream - $ export SQREAM_HOME - - $ export JAVA_HOME=${SQREAM_HOME}/hdfs/jdk - $ export HADOOP_INSTALL=${SQREAM_HOME}/hdfs/hadoop - $ export CLASSPATH=`${HADOOP_INSTALL}/bin/hadoop classpath --glob` - $ export HADOOP_COMMON_LIB_NATIVE_DIR=${HADOOP_INSTALL}/lib/native - $ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${SQREAM_HOME}/lib:$HADOOP_COMMON_LIB_NATIVE_DIR - - - $ PATH=$PATH:$HOME/.local/bin:$HOME/bin:${SQREAM_HOME}/bin/:${JAVA_HOME}/bin:$HADOOP_INSTALL/bin - $ export PATH - -3. Verify that the edits have been made: - - .. code-block:: console - - source /home/sqream/.bash_profile - -4. Check if you can access Hadoop from your machine: - - .. code-block:: console - - $ hadoop fs -ls hdfs://:8020/ - -.. - Comment: - - **NOTICE:** If you cannot access Hadoop from your machine because it uses Kerberos, see `Connecting a SQream Server to Cloudera Hadoop with Kerberos `_ - - -5. Verify that an HDFS environment exists for SQream services: - - .. code-block:: console - - $ ls -l /etc/sqream/sqream_env.sh - -.. _step_6: - - -6. If an HDFS environment does not exist for SQream services, create one (sqream_env.sh): - - .. code-block:: console - - $ #!/bin/bash - - $ SQREAM_HOME=/usr/local/sqream - $ export SQREAM_HOME - - $ export JAVA_HOME=${SQREAM_HOME}/hdfs/jdk - $ export HADOOP_INSTALL=${SQREAM_HOME}/hdfs/hadoop - $ export CLASSPATH=`${HADOOP_INSTALL}/bin/hadoop classpath --glob` - $ export HADOOP_COMMON_LIB_NATIVE_DIR=${HADOOP_INSTALL}/lib/native - $ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${SQREAM_HOME}/lib:$HADOOP_COMMON_LIB_NATIVE_DIR - - - $ PATH=$PATH:$HOME/.local/bin:$HOME/bin:${SQREAM_HOME}/bin/:${JAVA_HOME}/bin:$HADOOP_INSTALL/bin - $ export PATH - -:ref:`Back to top ` - - -.. _authenticate_hadoop_servers_that_require_kerberos: - -Authenticating Hadoop Servers that Require Kerberos ---------------------------------------------------- - -If your Hadoop server requires Kerberos authentication, do the following: - -1. Create a principal for the user **sqream**. - - .. code-block:: console - - $ kadmin -p root/admin@SQ.COM - $ addprinc sqream@SQ.COM - -2. If you do not know yor Kerberos root credentials, connect to the Kerberos server as a root user with ssh and run **kadmin.local**: - - .. code-block:: console - - $ kadmin.local - - Running **kadmin.local** does not require a password. - -3. If a password is not required, change your password to **sqream@SQ.COM**. - - .. code-block:: console - - $ change_password sqream@SQ.COM - -4. Connect to the hadoop name node using ssh: - - .. code-block:: console - - $ cd /var/run/cloudera-scm-agent/process - -5. Check the most recently modified content of the directory above: - - .. code-block:: console - - $ ls -lrt - -5. Look for a recently updated folder containing the text **hdfs**. - -The following is an example of the correct folder name: - - .. code-block:: console - - cd -hdfs- - - This folder should contain a file named **hdfs.keytab** or another similar .keytab file. - - - -.. - Comment: - Does "something" need to be replaced with "file name" - - -6. Copy the .keytab file to user **sqream's** Home directory on the remote machines that you are planning to use Hadoop on. - -7. Copy the following files to the **sqream sqream@server:/hdfs/hadoop/etc/hadoop:** directory: - - * core-site.xml - * hdfs-site.xml - -8. Connect to the sqream server and verify that the .keytab file's owner is a user sqream and is granted the correct permissions: - - .. code-block:: console - - $ sudo chown sqream:sqream /home/sqream/hdfs.keytab - $ sudo chmod 600 /home/sqream/hdfs.keytab - -9. Log into the sqream server. - -10. Log in as the user **sqream**. - -11. Navigate to the Home directory and check the name of a Kerberos principal represented by the following .keytab file: - - .. code-block:: console - - $ klist -kt hdfs.keytab - - The following is an example of the correct output: - - .. code-block:: console - - $ sqream@Host-121 ~ $ klist -kt hdfs.keytab - $ Keytab name: FILE:hdfs.keytab - $ KVNO Timestamp Principal - $ ---- ------------------- ------------------------------------------------------ - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM - -12. Verify that the hdfs service named **hdfs/nn1@SQ.COM** is shown in the generated output above. - -13. Run the following: - - .. code-block:: console - - $ kinit -kt hdfs.keytab hdfs/nn1@SQ.COM - - 13. Check the output: - - .. code-block:: console - - $ klist - - The following is an example of the correct output: - - .. code-block:: console - - $ Ticket cache: FILE:/tmp/krb5cc_1000 - $ Default principal: sqream@SQ.COM - $ - $ Valid starting Expires Service principal - $ 09/16/2020 13:44:18 09/17/2020 13:44:18 krbtgt/SQ.COM@SQ.COM - -14. List the files located at the defined server name or IP address: - - .. code-block:: console - - $ hadoop fs -ls hdfs://:8020/ - -15. Do one of the following: - - * If the list below is output, continue with Step 16. - * If the list is not output, verify that your environment has been set up correctly. - -If any of the following are empty, verify that you followed :ref:`Step 6 ` in the **Configuring an HDFS Environment for the User sqream** section above correctly: - - .. code-block:: console - - $ echo $JAVA_HOME - $ echo $SQREAM_HOME - $ echo $CLASSPATH - $ echo $HADOOP_COMMON_LIB_NATIVE_DIR - $ echo $LD_LIBRARY_PATH - $ echo $PATH - -16. Verify that you copied the correct keytab file. - -17. Review this procedure to verify that you have followed each step. - -:ref:`Back to top ` \ No newline at end of file diff --git a/operational_guides/index.rst b/operational_guides/index.rst index b7ea1502d..dcad76172 100644 --- a/operational_guides/index.rst +++ b/operational_guides/index.rst @@ -20,7 +20,6 @@ This section summarizes the following operational guides: logging monitoring_query_performance security - saved_queries seeing_system_objects_as_ddl configuration optimization_best_practices diff --git a/operational_guides/saved_queries.rst b/operational_guides/saved_queries.rst deleted file mode 100644 index d554b4dc8..000000000 --- a/operational_guides/saved_queries.rst +++ /dev/null @@ -1,122 +0,0 @@ -.. _saved_queries: - -*********************** -Saved Queries -*********************** - -Saved queries can be used to reuse a query plan for a query to eliminate compilation times for repeated queries. They also provide a way to implement 'parameterized views'. - -How saved queries work -========================== - -Saved queries are compiled when they are created. When a saved query is run, this query plan is used instead of compiling a query plan at query time. - -Parameters support -=========================== - -Query parameters can be used as substitutes for literal expressions in queries. - -* Parameters cannot be used to substitute things like column names and table names. - -* Query parameters of a string datatype (like ``VARCHAR``) must be of a fixed length, and can be used in equality checks, but not patterns (e.g. :ref:`like`, :ref:`rlike`, etc.) - -Creating a saved query -====================== - -A saved query is created using the :ref:`save_query` utility command. - -Saving a simple query ---------------------------- - -.. code-block:: psql - - t=> SELECT SAVE_QUERY('select_all','SELECT * FROM nba'); - executed - -Saving a parametrized query ------------------------------------------- - -Use parameters to replace them later at execution time. - - - -.. code-block:: psql - - t=> SELECT SAVE_QUERY('select_by_weight_and_team','SELECT * FROM nba WHERE Weight > ? AND Team = ?'); - executed - -.. TODO tip Use dollar quoting (`$$`) to avoid escaping strings. -.. this makes no sense unless you have a query which would otherwise need escaping -.. t=> SELECT SAVE_QUERY('select_by_weight_and_team',$$SELECT * FROM nba WHERE Weight > ? AND Team = ?$$); -.. executed - - -Listing and executing saved queries -====================================== - -Saved queries are saved as a database objects. They can be listed in one of two ways: - -Using the :ref:`catalog`: - -.. code-block:: psql - - t=> SELECT * FROM sqream_catalog.savedqueries; - name | num_parameters - --------------------------+--------------- - select_all | 0 - select_by_weight | 1 - select_by_weight_and_team | 2 - -Using the :ref:`list_saved_queries` utility function: - -.. code-block:: psql - - t=> SELECT LIST_SAVED_QUERIES(); - saved_query - ------------------------- - select_all - select_by_weight - select_by_weight_and_team - -Executing a saved query requires calling it by it's name in a :ref:`execute_saved_query` statement. A saved query with no parameter is called without parameters. - -.. code-block:: psql - - t=> SELECT EXECUTE_SAVED_QUERY('select_all'); - Name | Team | Number | Position | Age | Height | Weight | College | Salary - -------------------------+------------------------+--------+----------+-----+--------+--------+-----------------------+--------- - Avery Bradley | Boston Celtics | 0 | PG | 25 | 6-2 | 180 | Texas | 7730337 - Jae Crowder | Boston Celtics | 99 | SF | 25 | 6-6 | 235 | Marquette | 6796117 - John Holland | Boston Celtics | 30 | SG | 27 | 6-5 | 205 | Boston University | - R.J. Hunter | Boston Celtics | 28 | SG | 22 | 6-5 | 185 | Georgia State | 1148640 - [...] - -Executing a saved query with parameters requires specifying the parameters in the order they appear in the query: - -.. code-block:: psql - - t=> SELECT EXECUTE_SAVED_QUERY('select_by_weight_and_team', 240, 'Toronto Raptors'); - Name | Team | Number | Position | Age | Height | Weight | College | Salary - ------------------+-----------------+--------+----------+-----+--------+--------+-------------+-------- - Bismack Biyombo | Toronto Raptors | 8 | C | 23 | 6-9 | 245 | | 2814000 - James Johnson | Toronto Raptors | 3 | PF | 29 | 6-9 | 250 | Wake Forest | 2500000 - Jason Thompson | Toronto Raptors | 1 | PF | 29 | 6-11 | 250 | Rider | 245177 - Jonas Valanciunas | Toronto Raptors | 17 | C | 24 | 7-0 | 255 | | 4660482 - - -Dropping a saved query -============================= - -When you're done with a saved query, or would like to replace it with another, you can drop it with :ref:`drop_saved_query`: - -.. code-block:: psql - - t=> SELECT DROP_SAVED_QUERY('select_all'); - executed - t=> SELECT DROP_SAVED_QUERY('select_by_weight_and_team'); - executed - - t=> SELECT LIST_SAVED_QUERIES(); - saved_query - ------------------------- - select_by_weight diff --git a/third_party_tools/client_drivers/cpp/connect_test.cpp b/third_party_tools/client_drivers/cpp/connect_test.cpp deleted file mode 100644 index dc199f06b..000000000 --- a/third_party_tools/client_drivers/cpp/connect_test.cpp +++ /dev/null @@ -1,34 +0,0 @@ -// Trivial example - -#include - -#include "sqream.h" - -int main () { - - sqream::driver sqc; - - // Connection parameters: Hostname, Port, Use SSL, Username, Password, - // Database name, Service name - sqc.connect("127.0.0.1", 5000, false, "rhendricks", "Tr0ub4dor&3", - "raviga", "sqream"); - - // create table with data - run_direct_query(&sqc, "CREATE TABLE test_table (x int)"); - run_direct_query(&sqc, "INSERT INTO test_table VALUES (5), (6), (7), (8)"); - - // query it - sqc.new_query("SELECT * FROM test_table"); - sqc.execute_query(); - - // See the results - while (sqc.next_query_row()) { - std::cout << "Received: " << sqc.get_int(0) << std::endl; - } - - sqc.finish_query(); - - // Close the connection completely - sqc.disconnect(); - -} diff --git a/third_party_tools/client_drivers/cpp/index.rst b/third_party_tools/client_drivers/cpp/index.rst deleted file mode 100644 index fbbf6fb39..000000000 --- a/third_party_tools/client_drivers/cpp/index.rst +++ /dev/null @@ -1,87 +0,0 @@ -.. _cpp_native: - -************************* -C++ Driver -************************* - -The SQream DB C++ driver allows C++ programs and tools to connect to SQream DB. - -This tutorial shows how to write a C++ program that uses this driver. - -.. contents:: In this topic: - :depth: 2 - :local: - - -Installing the C++ driver -================================== - -Prerequisites ----------------- - -The SQream DB C++ driver was built on 64-bit Linux, and is designed to work with RHEL 7 and Ubuntu 16.04 and newer. - -Getting the library ---------------------- - -The C++ driver is provided as a tarball containing the compiled ``libsqream.so`` file and a header ``sqream.h``. Get the driver from the `SQream Drivers page `_. The library can be integrated into your C++-based applications or projects. - - -Extract the tarball archive ------------------------------ - -Extract the library files from the tarball - -.. code-block:: console - - $ tar xf libsqream-3.0.tar.gz - -Examples -============================================== - -Assuming there is a SQream DB worker to connect to, we'll connect to it using the application and run some statements. - -Testing the connection to SQream DB --------------------------------------------- - -Download this file by right clicking and saving to your computer :download:`connect_test.cpp `. - -.. literalinclude:: connect_test.cpp - :language: cpp - :caption: Connect to SQream DB - :linenos: - - -Compiling and running the application -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -To build this code, place the library and header file in ./libsqream-3.0/ and run - -.. code-block:: console - - $ g++ -Wall -Ilibsqream-3.0 -Llibsqream-3.0 -lsqream connect_test.cpp -o connect_test - $ ./connect_test - -Modify the ``-I`` and ``-L`` arguments to match the ``.so`` library and ``.h`` file if they are in another directory. - -Creating a table and inserting values --------------------------------------------- - -Download this file by right clicking and saving to your computer :download:`insert_test.cpp `. - -.. literalinclude:: insert_test.cpp - :language: cpp - :caption: Inserting data to a SQream DB table - :linenos: - - -Compiling and running the application -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -To build this code, use - -.. code-block:: console - - $ g++ -Wall -Ilibsqream-3.0 -Llibsqream-3.0 -lsqream insert_test.cpp -o insert_test - $ ./insert_test - diff --git a/third_party_tools/client_drivers/cpp/insert_test.cpp b/third_party_tools/client_drivers/cpp/insert_test.cpp deleted file mode 100644 index 8a16618a4..000000000 --- a/third_party_tools/client_drivers/cpp/insert_test.cpp +++ /dev/null @@ -1,39 +0,0 @@ -// Insert with parameterized statement example - -#include - -#include "sqream.h" - -int main () { - - sqream::driver sqc; - - // Connection parameters: Hostname, Port, Use SSL, Username, Password, - // Database name, Service name - sqc.connect("127.0.0.1", 5000, false, "rhendricks", "Tr0ub4dor&3", - "raviga", "sqream"); - - run_direct_query(&sqc, - "CREATE TABLE animals (id INT NOT NULL, name VARCHAR(10) NOT NULL)"); - - // prepare the statement - sqc.new_query("INSERT INTO animals VALUES (?, ?)"); - sqc.execute_query(); - - // Data to insert - int row0[] = {1,2,3}; - std::string row1[] = {"Dog","Cat","Possum"}; - int len = sizeof(row0)/sizeof(row0[0]); - - for (int i = 0; i < len; ++i) { - sqc.set_int(0, row0[i]); - sqc.set_varchar(1, row1[i]); - sqc.next_query_row(); - } - - // This commits the insert - sqc.finish_query(); - - sqc.disconnect(); - -} diff --git a/third_party_tools/client_drivers/index.rst b/third_party_tools/client_drivers/index.rst index 2b486d47f..102827f22 100644 --- a/third_party_tools/client_drivers/index.rst +++ b/third_party_tools/client_drivers/index.rst @@ -20,23 +20,6 @@ The following are applicable to all operating systems: * `JDBC .jar file `_ - sqream-jdbc-4.5.3 (.jar) * `JDBC driver `_ - -.. _python: - -* **Python** - Recommended installation via ``pip``: - - * `Python .tar file `_ - pysqream v3.1.3 (.tar.gz) - * `Python driver `_ - - -.. _nodejs: - -* **Node.JS** - Recommended installation via ``npm``: - - * `Node.JS `_ - sqream-v4.2.4 (.tar.gz) - * `Node.JS driver `_ - - .. _tableau_connector: * **Tableau**: @@ -57,7 +40,7 @@ Windows -------------- The following are applicable to Windows: -* **ODBC installer** - SQream Drivers v2020.2.0, with Tableau customizations. Please contact your `Sqream represenative `_ for this installer. +* **ODBC installer** - SQream Drivers v2020.2.0, with Tableau customizations. Please contact your `SSream represenative `_ for this installer. For more information on installing and configuring ODBC on Windows, see :ref:`Install and configure ODBC on Windows `. @@ -82,11 +65,6 @@ The following are applicable to Linux: * ODBC Installer - Please contact your SQream representative for this installer. - :: - -* C++ connector - `libsqream-4.0 `_ -* `C++ shared object library `_ - .. toctree:: :maxdepth: 4 @@ -94,10 +72,7 @@ The following are applicable to Linux: :titlesonly: jdbc/index - python/index - nodejs/index odbc/index - cpp/index diff --git a/third_party_tools/client_drivers/nodejs/index.rst b/third_party_tools/client_drivers/nodejs/index.rst deleted file mode 100644 index cb7db193b..000000000 --- a/third_party_tools/client_drivers/nodejs/index.rst +++ /dev/null @@ -1,382 +0,0 @@ -.. _nodejs: - -************************* -Node.JS -************************* - -The SQream DB Node.JS driver allows Javascript applications and tools connect to SQream DB. -This tutorial shows you how to write a Node application using the Node.JS interface. - -The driver requires Node 10 or newer. - -.. contents:: In this topic: - :local: - -Installing the Node.JS driver -================================== - -Prerequisites ----------------- - -* Node.JS 10 or newer. Follow instructions at `nodejs.org `_ . - -Install with NPM -------------------- - -Installing with npm is the easiest and most reliable method. -If you need to install the driver in an offline system, see the offline method below. - -.. code-block:: console - - $ npm install @sqream/sqreamdb - -Install from an offline package -------------------------------------- - -The Node driver is provided as a tarball for download from the `SQream Drivers page `_ . - -After downloading the tarball, use ``npm`` to install the offline package. - -.. code-block:: console - - $ sudo npm install sqreamdb-4.0.0.tgz - - -Connect to SQream DB with a Node.JS application -==================================================== - -Create a simple test ------------------------------------------- - -Replace the connection parameters with real parameters for a SQream DB installation. - -.. code-block:: javascript - :caption: sqreamdb-test.js - - const Connection = require('@sqream/sqreamdb'); - - const config = { - host: 'localhost', - port: 3109, - username: 'rhendricks', - password: 'super_secret_password', - connectDatabase: 'raviga', - cluster: true, - is_ssl: true, - service: 'sqream' - }; - - const query1 = 'SELECT 1 AS test, 2*6 AS "dozen"'; - - const sqream = new Connection(config); - sqream.execute(query1).then((data) => { - console.log(data); - }, (err) => { - console.error(err); - }); - - -Run the test ----------------- - -A successful run should look like this: - -.. code-block:: console - - $ node sqreamdb-test.js - [ { test: 1, dozen: 12 } ] - - -API reference -==================== - -Connection parameters ---------------------------- - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Item - - Optional - - Default - - Description - * - ``host`` - - ✗ - - None - - Hostname for SQream DB worker. For example, ``127.0.0.1``, ``sqream.mynetwork.co`` - * - ``port`` - - ✗ - - None - - Port for SQream DB end-point. For example, ``3108`` for the load balancer, ``5000`` for a worker. - * - ``username`` - - ✗ - - None - - Username of a role to use for connection. For example, ``rhendricks`` - * - ``password`` - - ✗ - - None - - Specifies the password of the selected role. For example, ``Tr0ub4dor&3`` - * - ``connectDatabase`` - - ✗ - - None - - Database name to connect to. For example, ``master`` - * - ``service`` - - ✓ - - ``sqream`` - - Specifices service queue to use. For example, ``etl`` - * - ``is_ssl`` - - ✓ - - ``false`` - - Specifies SSL for this connection. For example, ``true`` - * - ``cluster`` - - ✓ - - ``false`` - - Connect via load balancer (use only if exists, and check port). For example, ``true`` - -Events -------------- - -The connector handles event returns with an event emitter - -getConnectionId - The ``getConnectionId`` event returns the executing connection ID. - -getStatementId - The ``getStatementId`` event returns the executing statement ID. - -getTypes - The ``getTypes`` event returns the results columns types. - -Example -^^^^^^^^^^^^^^^^^ - -.. code-block:: javascript - - const myConnection = new Connection(config); - - myConnection.runQuery(query1, function (err, data){ - myConnection.events.on('getConnectionId', function(data){ - console.log('getConnectionId', data); - }); - - myConnection.events.on('getStatementId', function(data){ - console.log('getStatementId', data); - }); - - myConnection.events.on('getTypes', function(data){ - console.log('getTypes', data); - }); - }); - -Input placeholders -------------------------- - -The Node.JS driver can replace parameters in a statement. - -Input placeholders allow values like user input to be passed as parameters into queries, with proper escaping. - -The valid placeholder formats are provided in the table below. - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Placeholder - - Type - * - ``%i`` - - Identifier (e.g. table name, column name) - * - ``%s`` - - A text string - * - ``%d`` - - A number value - * - ``%b`` - - A boolean value - -See the :ref:`input placeholders example` below. - -Examples -=============== - -Setting configuration flags ------------------------------------ - -SQream DB configuration flags can be set per statement, as a parameter to ``runQuery``. - -For example: - -.. code-block:: javascript - - const setFlag = 'SET showfullexceptioninfo = true;'; - - const query_string = 'SELECT 1'; - - const myConnection = new Connection(config); - myConnection.runQuery(query_string, function (err, data){ - console.log(err, data); - }, setFlag); - - -Lazyloading ------------------------------------ - -To process rows without keeping them in memory, you can lazyload the rows with an async: - -.. code-block:: javascript - - - const Connection = require('@sqream/sqreamdb'); - - const config = { - host: 'localhost', - port: 3109, - username: 'rhendricks', - password: 'super_secret_password', - connectDatabase: 'raviga', - cluster: true, - is_ssl: true, - service: 'sqream' - }; - - const sqream = new Connection(config); - - const query = "SELECT * FROM public.a_very_large_table"; - - (async () => { - const cursor = await sqream.executeCursor(query); - let count = 0; - for await (let rows of cursor.fetchIterator(100)) { - // fetch rows in chunks of 100 - count += rows.length; - } - await cursor.close(); - return count; - })().then((total) => { - console.log('Total rows', total); - }, (err) => { - console.error(err); - }); - - -Reusing a connection ------------------------------------ - -It is possible to execeute multiple queries with the same connection (although only one query can be executed at a time). - -.. code-block:: javascript - - const Connection = require('@sqream/sqreamdb'); - - const config = { - host: 'localhost', - port: 3109, - username: 'rhendricks', - password: 'super_secret_password', - connectDatabase: 'raviga', - cluster: true, - is_ssl: true, - service: 'sqream' - }; - - const sqream = new Connection(config); - - (async () => { - - const conn = await sqream.connect(); - try { - const res1 = await conn.execute("SELECT 1"); - const res2 = await conn.execute("SELECT 2"); - const res3 = await conn.execute("SELECT 3"); - conn.disconnect(); - return {res1, res2, res3}; - } catch (err) { - conn.disconnect(); - throw err; - } - - })().then((res) => { - console.log('Results', res) - }, (err) => { - console.error(err); - }); - - -.. _input_placeholders_example: - -Using placeholders in queries ------------------------------------ - -Input placeholders allow values like user input to be passed as parameters into queries, with proper escaping. - -.. code-block:: javascript - - const Connection = require('@sqream/sqreamdb'); - - const config = { - host: 'localhost', - port: 3109, - username: 'rhendricks', - password: 'super_secret_password', - connectDatabase: 'raviga', - cluster: true, - is_ssl: true, - service: 'sqream' - }; - - const sqream = new Connection(config); - - const sql = "SELECT %i FROM public.%i WHERE name = %s AND num > %d AND active = %b"; - - sqream.execute(sql, "col1", "table2", "john's", 50, true); - - -The query that will run is ``SELECT col1 FROM public.table2 WHERE name = 'john''s' AND num > 50 AND active = true`` - - -Troubleshooting and recommended configuration -================================================ - - -Preventing ``heap out of memory`` errors --------------------------------------------- - -Some workloads may cause Node.JS to fail with the error: - -.. code-block:: none - - FATAL ERROR: CALL_AND_RETRY_LAST Allocation failed - JavaScript heap out of memory - -To prevent this error, modify the heap size configuration by setting the ``--max-old-space-size`` run flag. - -For example, set the space size to 2GB: - -.. code-block:: console - - $ node --max-old-space-size=2048 my-application.js - -BIGINT support ------------------------- - -The Node.JS connector supports fetching ``BIGINT`` values from SQream DB. However, some applications may encounter an error when trying to serialize those values. - -The error that appears is: -.. code-block:: none - - TypeError: Do not know how to serialize a BigInt - -This is because JSON specification do not support BIGINT values, even when supported by Javascript engines. - -To resolve this issue, objects with BIGINT values should be converted to string before serializing, and converted back after deserializing. - -For example: - -.. code-block:: javascript - - const rows = [{test: 1n}] - const json = JSON.stringify(rows, , (key, value) => - typeof value === 'bigint' - ? value.toString() - : value // return everything else unchanged - )); - console.log(json); // [{"test": "1"}] - diff --git a/third_party_tools/client_drivers/nodejs/sample.js b/third_party_tools/client_drivers/nodejs/sample.js deleted file mode 100644 index a8ec3db66..000000000 --- a/third_party_tools/client_drivers/nodejs/sample.js +++ /dev/null @@ -1,21 +0,0 @@ -const Connection = require('@sqream/sqreamdb'); - -const config = { - host: 'localhost', - port: 3109, - username: 'rhendricks', - password: 'super_secret_password', - connectDatabase: 'raviga', - cluster: true, - is_ssl: true, - service: 'sqream' - }; - -const query1 = 'SELECT 1 AS test, 2*6 AS "dozen"'; - -const sqream = new Connection(config); -sqream.execute(query1).then((data) => { - console.log(data); -}, (err) => { - console.error(err); -}); \ No newline at end of file diff --git a/third_party_tools/client_drivers/python/api-reference.rst b/third_party_tools/client_drivers/python/api-reference.rst deleted file mode 100644 index 28e1205e6..000000000 --- a/third_party_tools/client_drivers/python/api-reference.rst +++ /dev/null @@ -1,191 +0,0 @@ -.. _pysqream_api_reference: - -************************* -pysqream API reference -************************* - -The SQream Python connector allows Python programs to connect to SQream DB. - -pysqream conforms to Python DB-API specifications `PEP-249 `_ - - -The main module is pysqream, which contains the :py:meth:`Connection` class. - -.. method:: connect(host, port, database, username, password, clustered = False, use_ssl = False, service='sqream', reconnect_attempts=3, reconnect_interval=10) - - Creates a new :py:meth:`Connection` object and connects to SQream DB. - - host - SQream DB hostname or IP - - port - SQream DB port - - database - database name - - username - Username to use for connection - - password - Password for ``username`` - - clustered - Connect through load balancer, or direct to worker (Default: false - direct to worker) - - use_ssl - use SSL connection (default: false) - - service - Optional service queue (default: 'sqream') - - reconnect_attempts - Number of reconnection attempts to attempt before closing the connection - - reconnect_interval - Time in seconds between each reconnection attempt - -.. class:: Connection - - .. attribute:: arraysize - - Specifies the number of rows to fetch at a time with :py:meth:`~Connection.fetchmany`. Defaults to 1 - one row at a time. - - .. attribute:: rowcount - - Unused, always returns -1. - - .. attribute:: description - - Read-only attribute that contains result set metadata. - - This attribute is populated after a statement is executed. - - .. list-table:: - :widths: auto - :header-rows: 1 - - * - Value - - Description - * - ``name`` - - Column name - * - ``type_code`` - - Internal type code - * - ``display_size`` - - Not used - same as ``internal_size`` - * - ``internal_size`` - - Data size in bytes - * - ``precision`` - - Precision of numeric data (not used) - * - ``scale`` - - Scale for numeric data (not used) - * - ``null_ok`` - - Specifies if ``NULL`` values are allowed for this column - - .. method:: execute(self, query, params=None) - - Execute a statement. - - Parameters are not supported - - self - :py:meth:`Connection` - - query - statement or query text - - params - Unused - - .. method:: executemany(self, query, rows_or_cols=None, data_as='rows', amount=None) - - Prepares a statement and executes it against all parameter sequences found in ``rows_or_cols``. - - self - :py:meth:`Connection` - - query - INSERT statement - - rows_or_cols - Data buffer to insert. This should be a sequence of lists or tuples. - - data_as - (Optional) Read data as rows or columns - - amount - (Optional) count of rows to insert - - .. method:: close(self) - - Close a statement and connection. - After a statement is closed, it must be reopened by creating a new cursor. - - self - :py:meth:`Connection` - - .. method:: cursor(self) - - Create a new :py:meth:`Connection` cursor. - - We recommend creating a new cursor for every statement. - - self - :py:meth:`Connection` - - .. method:: fetchall(self, data_as='rows') - - Fetch all remaining records from the result set. - - An empty sequence is returned when no more rows are available. - - self - :py:meth:`Connection` - - data_as - (Optional) Read data as rows or columns - - .. method:: fetchone(self, data_as='rows') - - Fetch one record from the result set. - - An empty sequence is returned when no more rows are available. - - self - :py:meth:`Connection` - - data_as - (Optional) Read data as rows or columns - - - .. method:: fetchmany(self, size=[Connection.arraysize], data_as='rows') - - Fetches the next several rows of a query result set. - - An empty sequence is returned when no more rows are available. - - self - :py:meth:`Connection` - - size - Number of records to fetch. If not set, fetches :py:obj:`Connection.arraysize` (1 by default) records - - data_as - (Optional) Read data as rows or columns - - .. method:: __iter__() - - Makes the cursor iterable. - - -.. attribute:: apilevel = '2.0' - - String constant stating the supported API level. The connector supports API "2.0". - -.. attribute:: threadsafety = 1 - - Level of thread safety the interface supports. pysqream currently supports level 1, which states that threads can share the module, but not connections. - -.. attribute:: paramstyle = 'qmark' - - The placeholder marker. Set to ``qmark``, which is a question mark (``?``). diff --git a/third_party_tools/client_drivers/python/index.rst b/third_party_tools/client_drivers/python/index.rst deleted file mode 100644 index 1c69752d7..000000000 --- a/third_party_tools/client_drivers/python/index.rst +++ /dev/null @@ -1,502 +0,0 @@ -.. _pysqream: - -************************* -Python (pysqream) -************************* - -The SQream Python connector is a set of packages that allows Python programs to connect to SQream DB. - -* ``pysqream`` is a pure Python connector. It can be installed with ``pip`` on any operating system, including Linux, Windows, and macOS. - -* ``pysqream-sqlalchemy`` is a SQLAlchemy dialect for ``pysqream`` - -The connector supports Python 3.6.5 and newer. - -The base ``pysqream`` package conforms to Python DB-API specifications `PEP-249 `_. - -.. contents:: In this topic: - :local: - -Installing the Python connector -================================== - -Prerequisites ----------------- - -1. Python -^^^^^^^^^^^^ - -The connector requires Python 3.6.5 or newer. To verify your version of Python: - -.. code-block:: console - - $ python --version - Python 3.7.3 - - -.. note:: If both Python 2.x and 3.x are installed, you can run ``python3`` and ``pip3`` instead of ``python`` and ``pip`` respectively for the rest of this guide - -.. warning:: If you're running on an older version, ``pip`` will fetch an older version of ``pysqream``, with version <3.0.0. This version is currently not supported. - -2. PIP -^^^^^^^^^^^^ -The Python connector is installed via ``pip``, the Python package manager and installer. - -We recommend upgrading to the latest version of ``pip`` before installing. To verify that you are on the latest version, run the following command: - -.. code-block:: console - - $ python -m pip install --upgrade pip - Collecting pip - Downloading https://files.pythonhosted.org/packages/00/b6/9cfa56b4081ad13874b0c6f96af8ce16cfbc1cb06bedf8e9164ce5551ec1/pip-19.3.1-py2.py3-none-any.whl (1.4MB) - |████████████████████████████████| 1.4MB 1.6MB/s - Installing collected packages: pip - Found existing installation: pip 19.1.1 - Uninstalling pip-19.1.1: - Successfully uninstalled pip-19.1.1 - Successfully installed pip-19.3.1 - -.. note:: - * On macOS, you may want to use virtualenv to install Python and the connector, to ensure compatibility with the built-in Python environment - * If you encounter an error including ``SSLError`` or ``WARNING: pip is configured with locations that require TLS/SSL, however the ssl module in Python is not available.`` - please be sure to reinstall Python with SSL enabled, or use virtualenv or Anaconda. - -3. OpenSSL for Linux -^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Some distributions of Python do not include OpenSSL. The Python connector relies on OpenSSL for secure connections to SQream DB. - -* To install OpenSSL on RHEL/CentOS - - .. code-block:: console - - $ sudo yum install -y libffi-devel openssl-devel - -* To install OpenSSL on Ubuntu - - .. code-block:: console - - $ sudo apt-get install libssl-dev libffi-dev -y - -4. Cython (optional) -^^^^^^^^^^^^^^^^^^^^^^^^ - -Optional but highly recommended is Cython, which improves performance of Python applications. - - .. code-block:: console - - $ pip install cython - -Install via pip ------------------ - -The Python connector is available via `PyPi `_. - -Install the connector with ``pip``: - -.. code-block:: console - - $ pip install pysqream pysqream-sqlalchemy - -``pip`` will automatically install all necessary libraries and modules. - -Upgrading an existing installation --------------------------------------- - -The Python drivers are updated periodically. -To upgrade an existing pysqream installation, use pip's ``-U`` flag. - -.. code-block:: console - - $ pip install pysqream pysqream-sqlalchemy -U - - -Validate the installation ------------------------------ - -Create a file called ``test.py``, containing the following: - -.. literalinclude:: test.py - :language: python - :caption: pysqream Validation Script - :linenos: - -Make sure to replace the parameters in the connection with the respective parameters for your SQream DB installation. - -Run the test file to verify that you can connect to SQream DB: - -.. code-block:: console - - $ python test.py - Version: v2020.1 - -If all went well, you are now ready to build an application using the SQream DB Python connector! - -If any connection error appears, verify that you have access to a running SQream DB and that the connection parameters are correct. - -SQLAlchemy examples -======================== - -SQLAlchemy is an ORM for Python. - -When you install the SQream DB dialect (``pysqream-sqlalchemy``) you can use frameworks like Pandas, TensorFlow, and Alembic to query SQream DB directly. - -A simple connection example ---------------------------------- - -.. code-block:: python - - import sqlalchemy as sa - from sqlalchemy.engine.url import URL - - engine_url = URL('sqream' - , username='rhendricks' - , password='secret_passwor" - , host='localhost' - , port=5000 - , database='raviga' - , query={'use_ssl': False}) - - engine = sa.create_engine(engine_url) - - res = engine.execute('create table test (ints int)') - res = engine.execute('insert into test values (5), (6)') - res = engine.execute('select * from test') - -Pulling a table into Pandas ---------------------------------- - -In this example, we use the URL method to create the connection string. - -.. code-block:: python - - import sqlalchemy as sa - import pandas as pd - from sqlalchemy.engine.url import URL - - - engine_url = URL('sqream' - , username='rhendricks' - , password='secret_passwor" - , host='localhost' - , port=5000 - , database='raviga' - , query={'use_ssl': False}) - - engine = sa.create_engine(engine_url) - - table_df = pd.read_sql("select * from nba", con=engine) - - -API Examples -=============== - -Explaining the connection example ---------------------------------------- - -First, import the package and create a connection - -.. code-block:: python - - # Import pysqream package - - import pysqream - - """ - Connection parameters include: - * IP/Hostname - * Port - * database name - * username - * password - * Connect through load balancer, or direct to worker (Default: false - direct to worker) - * use SSL connection (default: false) - * Optional service queue (default: 'sqream') - """ - - # Create a connection object - - con = pysqream.connect(host='127.0.0.1', port=3108, database='raviga' - , username='rhendricks', password='Tr0ub4dor&3' - , clustered=True) - -Then, run a query and fetch the results - -.. code-block:: python - - cur = con.cursor() # Create a new cursor - # Prepare and execute a query - cur.execute('select show_version()') - - result = cur.fetchall() # `fetchall` gets the entire data set - - print (f"Version: {result[0][0]}") - -This should print the SQream DB version. For example ``v2020.1``. - -Finally, we will close the connection - -.. code-block:: python - - con.close() - -Using the cursor --------------------------------------------- - -The DB-API specification includes several methods for fetching results from the cursor. - -We will use the ``nba`` example. Here's a peek at the table contents: - -.. csv-table:: nba - :file: nba-t10.csv - :widths: auto - :header-rows: 1 - -Like before, we will import the library and create a :py:meth:`~Connection`, followed by :py:meth:`~Connection.execute` on a simple ``SELECT *`` query. - -.. code-block:: python - - import pysqream - con = pysqream.connect(host='127.0.0.1', port=3108, database='master' - , username='rhendricks', password='Tr0ub4dor&3' - , clustered=True) - - cur = con.cursor() # Create a new cursor - # The select statement: - statement = 'SELECT * FROM nba' - cur.execute(statement) - -After executing the statement, we have a :py:meth:`Connection` cursor object waiting. A cursor is iterable, meaning that everytime we fetch, it advances the cursor to the next row. - -Use :py:meth:`~Connection.fetchone` to get one record at a time: - -.. code-block:: python - - first_row = cur.fetchone() # Fetch one row at a time (first row) - - second_row = cur.fetchone() # Fetch one row at a time (second row) - -To get several rows at a time, use :py:meth:`~Connection.fetchmany`: - -.. code-block:: python - - # executing `fetchone` twice is equivalent to this form: - third_and_fourth_rows = cur.fetchmany(2) - -To get all rows at once, use :py:meth:`~Connection.fetchall`: - -.. code-block:: python - - # To get all rows at once, use `fetchall` - remaining_rows = cur.fetchall() - - # Close the connection when done - con.close() - -Here are the contents of the row variables we used: - -.. code-block:: pycon - - >>> print(first_row) - ('Avery Bradley', 'Boston Celtics', 0, 'PG', 25, '6-2', 180, 'Texas', 7730337) - >>> print(second_row) - ('Jae Crowder', 'Boston Celtics', 99, 'SF', 25, '6-6', 235, 'Marquette', 6796117) - >>> print(third_and_fourth_rows) - [('John Holland', 'Boston Celtics', 30, 'SG', 27, '6-5', 205, 'Boston University', None), ('R.J. Hunter', 'Boston Celtics', 28, 'SG', 22, '6-5', 185, 'Georgia State', 1148640)] - >>> print(remaining_rows) - [('Jonas Jerebko', 'Boston Celtics', 8, 'PF', 29, '6-10', 231, None, 5000000), ('Amir Johnson', 'Boston Celtics', 90, 'PF', 29, '6-9', 240, None, 12000000), ('Jordan Mickey', 'Boston Celtics', 55, 'PF', 21, '6-8', 235, 'LSU', 1170960), ('Kelly Olynyk', 'Boston Celtics', 41, 'C', 25, '7-0', 238, 'Gonzaga', 2165160), - [...] - -.. note:: Calling a fetch command after all rows have been fetched will return an empty array (``[]``). - -Reading result metadata ----------------------------- - -When executing a statement, the connection object also contains metadata about the result set (e.g.column names, types, etc). - -The metadata is stored in the :py:attr:`Connection.description` object of the cursor. - -.. code-block:: pycon - - >>> import pysqream - >>> con = pysqream.connect(host='127.0.0.1', port=3108, database='master' - ... , username='rhendricks', password='Tr0ub4dor&3' - ... , clustered=True) - >>> cur = con.cursor() - >>> statement = 'SELECT * FROM nba' - >>> cur.execute(statement) - - >>> print(cur.description) - [('Name', 'STRING', 24, 24, None, None, True), ('Team', 'STRING', 22, 22, None, None, True), ('Number', 'NUMBER', 1, 1, None, None, True), ('Position', 'STRING', 2, 2, None, None, True), ('Age (as of 2018)', 'NUMBER', 1, 1, None, None, True), ('Height', 'STRING', 4, 4, None, None, True), ('Weight', 'NUMBER', 2, 2, None, None, True), ('College', 'STRING', 21, 21, None, None, True), ('Salary', 'NUMBER', 4, 4, None, None, True)] - -To get a list of column names, iterate over the ``description`` list: - -.. code-block:: pycon - - >>> [ i[0] for i in cur.description ] - ['Name', 'Team', 'Number', 'Position', 'Age (as of 2018)', 'Height', 'Weight', 'College', 'Salary'] - -Loading data into a table ---------------------------- - -This example loads 10,000 rows of dummy data to a SQream DB instance - -.. code-block:: python - - import pysqream - from datetime import date, datetime - from time import time - - con = pysqream.connect(host='127.0.0.1', port=3108, database='master' - , username='rhendricks', password='Tr0ub4dor&3' - , clustered=True) - - # Create a table for loading - create = 'create or replace table perf (b bool, t tinyint, sm smallint, i int, bi bigint, f real, d double, s varchar(12), ss text, dt date, dtt datetime)' - con.execute(create) - - # After creating the table, we can load data into it with the INSERT command - - # Create dummy data which matches the table we created - data = (False, 2, 12, 145, 84124234, 3.141, -4.3, "Marty McFly" , u"キウイは楽しい鳥です" , date(2019, 12, 17), datetime(1955, 11, 4, 1, 23, 0, 0)) - - - row_count = 10**4 - - # Get a new cursor - cur = con.cursor() - insert = 'insert into perf values (?,?,?,?,?,?,?,?,?,?,?)' - start = time() - cur.executemany(insert, [data] * row_count) - print (f"Total insert time for {row_count} rows: {time() - start} seconds") - - # Close this cursor - cur.close() - - # Verify that the data was inserted correctly - # Get a new cursor - cur = con.cursor() - cur.execute('select count(*) from perf') - result = cur.fetchall() # `fetchall` collects the entire data set - print (f"Count of inserted rows: {result[0][0]}") - - # When done, close the cursor - cur.close() - - # Close the connection - con.close() - -Reading data from a CSV file for load into a table ----------------------------------------------------------- - -We will write a helper function to create an :ref:`insert` statement, by reading an existing table's metadata. - -.. code-block:: python - - import pysqream - import datetime - - def insert_from_csv(cur, table_name, csv_filename, field_delimiter = ',', null_markers = []): - """ - We will first ask SQream DB for some table information. - This is important for understanding the number of columns, and will help - to create a matching INSERT statement - """ - - column_info = cur.execute(f"SELECT * FROM {table_name} LIMIT 0").description - - - def parse_datetime(v): - try: - return datetime.datetime.strptime(row[i], '%Y-%m-%d %H:%M:%S.%f') - except ValueError: - try: - return datetime.datetime.strptime(row[i], '%Y-%m-%d %H:%M:%S') - except ValueError: - return datetime.datetime.strptime(row[i], '%Y-%m-%d') - - # Create enough placeholders (`?`) for the INSERT query string - qstring = ','.join(['?'] * len(column_info)) - insert_statement = f"insert into {table_name} values ({qstring})" - - # Open the CSV file - with open(csv_filename, mode='r') as csv_file: - csv_reader = csv.reader(csv_file, delimiter=field_delimiter) - - # Execute the INSERT statement with the CSV data - cur.executemany(insert_statement, [row for row in csv_reader]) - - - con = pysqream.connect(host='127.0.0.1', port=3108, database='master' - , username='rhendricks', password='Tr0ub4dor&3' - , clustered=True) - - cur = con.cursor() - insert_from_csv(cur, 'nba', 'nba.csv', field_delimiter = ',', null_markers = []) - - con.close() - - -Using SQLAlchemy ORM to create tables and fill them with data ------------------------------------------------------------------------ - -You can also use the ORM to create tables and insert data to them from Python objects. - -For example: - -.. code-block:: python - - import sqlalchemy as sa - import pandas as pd - from sqlalchemy.engine.url import URL - - - engine_url = URL('sqream' - , username='rhendricks' - , password='secret_passwor" - , host='localhost' - , port=5000 - , database='raviga' - , query={'use_ssl': False}) - - engine = sa.create_engine(engine_url) - - # Build a metadata object and bind it - - metadata = sa.MetaData() - metadata.bind = engine - - # Create a table in the local metadata - - employees = sa.Table( - 'employees' - , metadata - , sa.Column('id', sa.Integer) - , sa.Column('name', sa.VARCHAR(32)) - , sa.Column('lastname', sa.VARCHAR(32)) - , sa.Column('salary', sa.Float) - ) - - # The create_all() function uses the SQream DB engine object - # to create all the defined table objects. - - metadata.create_all(engine) - - # Now that the table exists, we can insert data into it. - - # Build the data rows - insert_data = [ {'id': 1, 'name': 'Richard','lastname': 'Hendricks', 'salary': 12000.75} - ,{'id': 3, 'name': 'Bertram', 'lastname': 'Gilfoyle', 'salary': 8400.0} - ,{'id': 8, 'name': 'Donald', 'lastname': 'Dunn', 'salary': 6500.40} - ] - - # Build the insert command - ins = employees.insert(insert_data) - - # Execute the command - result = engine.execute(ins) - -.. toctree:: - :maxdepth: 8 - :caption: Further information - - api-reference diff --git a/third_party_tools/client_drivers/python/nba-t10.csv b/third_party_tools/client_drivers/python/nba-t10.csv deleted file mode 100644 index fe9ced442..000000000 --- a/third_party_tools/client_drivers/python/nba-t10.csv +++ /dev/null @@ -1,10 +0,0 @@ -Name,Team,Number,Position,Age,Height,Weight,College,Salary -Avery Bradley,Boston Celtics,0.0,PG,25.0,6-2,180.0,Texas,7730337.0 -Jae Crowder,Boston Celtics,99.0,SF,25.0,6-6,235.0,Marquette,6796117.0 -John Holland,Boston Celtics,30.0,SG,27.0,6-5,205.0,Boston University, -R.J. Hunter,Boston Celtics,28.0,SG,22.0,6-5,185.0,Georgia State,1148640.0 -Jonas Jerebko,Boston Celtics,8.0,PF,29.0,6-10,231.0,,5000000.0 -Amir Johnson,Boston Celtics,90.0,PF,29.0,6-9,240.0,,12000000.0 -Jordan Mickey,Boston Celtics,55.0,PF,21.0,6-8,235.0,LSU,1170960.0 -Kelly Olynyk,Boston Celtics,41.0,C,25.0,7-0,238.0,Gonzaga,2165160.0 -Terry Rozier,Boston Celtics,12.0,PG,22.0,6-2,190.0,Louisville,1824360.0 diff --git a/third_party_tools/client_drivers/python/test.py b/third_party_tools/client_drivers/python/test.py deleted file mode 100644 index 51d0b4a92..000000000 --- a/third_party_tools/client_drivers/python/test.py +++ /dev/null @@ -1,37 +0,0 @@ -#!/usr/bin/env python - -import pysqream - -""" -Connection parameters include: -* IP/Hostname -* Port -* database name -* username -* password -* Connect through load balancer, or direct to worker (Default: false - direct to worker) -* use SSL connection (default: false) -* Optional service queue (default: 'sqream') -""" - -# Create a connection object - -con = pysqream.connect(host='127.0.0.1', port=5000, database='master' - , username='sqream', password='sqream' - , clustered=False) - -# Create a new cursor -cur = con.cursor() - -# Prepare and execute a query -cur.execute('select show_version()') - -result = cur.fetchall() # `fetchall` gets the entire data set - -print (f"Version: {result[0][0]}") - -# This should print the SQream DB version. For example ``Version: v2020.1``. - -# Finally, close the connection - -con.close() \ No newline at end of file diff --git a/third_party_tools/client_platforms/connect.sas b/third_party_tools/client_platforms/connect.sas deleted file mode 100644 index 78c670762..000000000 --- a/third_party_tools/client_platforms/connect.sas +++ /dev/null @@ -1,27 +0,0 @@ -options sastrace='d,d,d,d' -sastraceloc=saslog -nostsuffix -msglevel=i -sql_ip_trace=(note,source) -DEBUG=DBMS_SELECT; - -options validvarname=any; - -libname sqlib jdbc driver="com.sqream.jdbc.SQDriver" - classpath="/opt/sqream/sqream-jdbc-4.0.0.jar" - URL="jdbc:Sqream://sqream-cluster.piedpiper.com:3108/raviga;cluster=true" - user="rhendricks" - password="Tr0ub4dor3" - schema="public" - PRESERVE_TAB_NAMES=YES - PRESERVE_COL_NAMES=YES; - -proc sql; - title 'Customers table'; - select * - from sqlib.customers; -quit; - -data sqlib.customers; - set sqlib.customers; -run; \ No newline at end of file diff --git a/third_party_tools/client_platforms/connect2.sas b/third_party_tools/client_platforms/connect2.sas deleted file mode 100644 index 10fcdb0a2..000000000 --- a/third_party_tools/client_platforms/connect2.sas +++ /dev/null @@ -1,27 +0,0 @@ -options sastrace='d,d,d,d' -sastraceloc=saslog -nostsuffix -msglevel=i -sql_ip_trace=(note,source) -DEBUG=DBMS_SELECT; - -options validvarname=any; - -libname sqlib jdbc driver="com.sqream.jdbc.SQDriver" - classpath="/opt/sqream/sqream-jdbc-4.0.0.jar" - URL="jdbc:Sqream://sqream-cluster.piedpiper.com:3108/raviga;cluster=true" - user="rhendricks" - password="Tr0ub4dor3" - schema="public" - PRESERVE_TAB_NAMES=YES - PRESERVE_COL_NAMES=YES; - -proc sql; - title 'Customers table'; - select * - from sqlib.customers; -quit; - -data sqlib.customers; - set sqlib.customers; -run; \ No newline at end of file diff --git a/third_party_tools/client_platforms/connect3.sas b/third_party_tools/client_platforms/connect3.sas deleted file mode 100644 index c1bf11dcf..000000000 --- a/third_party_tools/client_platforms/connect3.sas +++ /dev/null @@ -1,17 +0,0 @@ -options sastrace='d,d,d,d' -sastraceloc=saslog -nostsuffix -msglevel=i -sql_ip_trace=(note,source) -DEBUG=DBMS_SELECT; - -options validvarname=any; - -libname sqlib jdbc driver="com.sqream.jdbc.SQDriver" - classpath="/opt/sqream/sqream-jdbc-4.0.0.jar" - URL="jdbc:Sqream://sqream-cluster.piedpiper.com:3108/raviga;cluster=true" - user="rhendricks" - password="Tr0ub4dor3" - schema="public" - PRESERVE_TAB_NAMES=YES - PRESERVE_COL_NAMES=YES; \ No newline at end of file diff --git a/third_party_tools/client_platforms/index.rst b/third_party_tools/client_platforms/index.rst deleted file mode 100644 index 30280c788..000000000 --- a/third_party_tools/client_platforms/index.rst +++ /dev/null @@ -1,37 +0,0 @@ -.. _client_platforms: - -************************************ -Client Platforms -************************************ -These topics explain how to install and connect a variety of third party tools. - -Browse the articles below, in the sidebar, or use the search to find the information you need. - -Overview -========== - -SQream DB is designed to work with most common database tools and interfaces, allowing you direct access through a variety of drivers, connectors, tools, vizualisers, and utilities. - -The tools listed have been tested and approved for use with SQream DB. Most 3\ :sup:`rd` party tools that work through JDBC, ODBC, and Python should work. - -If you are looking for a tool that is not listed, SQream and our partners can help. Go to `SQream Support `_ or contact your SQream account manager for more information. - -.. toctree:: - :maxdepth: 4 - :caption: In this section: - :titlesonly: - - power_bi - tibco_spotfire - sas_viya - sql_workbench - tableau - pentaho - microstrategy - informatica - r - php - xxtalend - xxdiagnosing_common_connectivity_issues - -.. image:: /_static/images/connectivity_ecosystem.png \ No newline at end of file diff --git a/third_party_tools/client_platforms/informatica.rst b/third_party_tools/client_platforms/informatica.rst deleted file mode 100644 index 6bc50b22a..000000000 --- a/third_party_tools/client_platforms/informatica.rst +++ /dev/null @@ -1,173 +0,0 @@ -.. _informatica: - -************************* -Connect to SQream Using Informatica Cloud Services -************************* - -Overview -========= -The **Connecting to SQream Using Informatica Cloud Services** page is quick start guide for connecting to SQream using Informatica cloud services. - -It describes the following: - -.. contents:: - :local: - -Establishing a Connection between SQream and Informatica ------------------ -The **Establishing a Connection between SQream and Informatica** page describes how to establish a connection between SQream and the Informatica data integration Cloud. - -**To establish a connection between SQream and the Informatica data integration Cloud:** - -1. Go to the `Informatica Cloud homepage `_. - - :: - -2. Do one of the following: - - 1. Log in using your credentials. - - :: - - 2. Log in using your SAML Identity Provider. - -3. From the **Services** window, select **Administrator** or click **Show all services** to show all services. - - - The SQream dashboard is displayed. - - - :: - - -4. In the menu on the left, click **Runtime Environments**. - - - The **Runtime Environments** panel is displayed. - - :: - -5. Click **Download Secure Agent**. - - :: - -6. When the **Download the Secure Agent** panel is displayed, do the following: - - 1. Select a platform (Windows 64 or Linux 64). - - :: - - - 2. Click **Copy** and save the token on your local hard drive. - - The token is used in combination with your user name to authorize the agent to access your account. - - -7. Click **Download**. - - The installation begins. - - :: - -8. When the **Informatica Cloud Secure Agent Setup** panel is displayed, click **Next**. - - - :: - - -9. Provide your **User Name** and **Install Token** and click **Register**. - - :: - - - -10. From the Runtime Environments panel, click **New Runtime Environment**. - - - The **New Secure Agent Group** window is displayed. - - :: - -11. On the New Secure Agent Group window, click **OK** to connect your Runtime Environment with the running agent. - - .. note:: If you do not download Secure Agent, you will not be able to connect your Runtime Environment with the running agent and continue establishing a connection between SQream and the Informatica data integration Cloud. - -Establishing a Connection In Your Environment ------------------ - -The **Establishing a Connection In Your Environment** describes the following: - -.. contents:: - :local: - -Establishing an ODBC DSN Connection In Your Environment -~~~~~~~~~~~~~ -After establishing a connection between SQream and Informatica you can establish an ODBC DSN connection in your environment. - -**To establish an ODBC connection in your environment:** - -1. Click **Add**. - - :: - -2. Click **Configure**. - - .. note:: Verify that **Use Server Picker** is selected. - -3. Click **Test**. - - :: - -4. Verify that the connection has tested successfully. - - :: - -5. Click **Save**. - - :: - -6. Click **Actions** > **Publish**. - -Establishing a JDBC Connection In Your Environment -~~~~~~~~~~~~~ -After establishing a connection between SQream and Informatica you can establish a JDBC connection in your environment. - -**To establish a JDBC connection in your environment:** - -1. Create a new DB connection by clicking **Connections** > **New Connection**. - - The **New Connection** window is displayed. - - :: - - -2. In the **JDBC_IC Connection Properties** section, in the **JDBC Connection URL** field, establish a JDBC connection by providing the correct connection string. - - For connection string examples, see `Connection Strings `_. - - :: - -3. Click **Test**. - - :: - -4. Verify that the connection has tested successfully. - - :: - -5. Click **Save**. - - :: - -6. Click **Actions** > **Publish**. - -Supported SQream Driver Versions ---------------- - -SQream supports the following SQream driver versions: - -* **JDBC** - Version 4.3.4 and above. - - :: - -* **ODBC** - Version 4.0.0 and above. diff --git a/third_party_tools/client_platforms/microstrategy.rst b/third_party_tools/client_platforms/microstrategy.rst deleted file mode 100644 index 6d2be281f..000000000 --- a/third_party_tools/client_platforms/microstrategy.rst +++ /dev/null @@ -1,185 +0,0 @@ -.. _microstrategy: - - -************************* -Connect to SQream Using MicroStrategy -************************* - -.. _ms_top: - -Overview ---------------- -This document is a Quick Start Guide that describes how to install MicroStrategy and connect a datasource to the MicroStrategy dasbhoard for analysis. - - - -The **Connecting to SQream Using MicroStrategy** page describes the following: - - -.. contents:: - :local: - - - - - - -What is MicroStrategy? -================ -MicroStrategy is a Business Intelligence software offering a wide variety of data analytics capabilities. SQream uses the MicroStrategy connector for reading and loading data into SQream. - -MicroStrategy provides the following: - -* Data discovery -* Advanced analytics -* Data visualization -* Embedded BI -* Banded reports and statements - - -For more information about Microstrategy, see `MicroStrategy `_. - - - -:ref:`Back to Overview ` - - - - - -Connecting a Data Source -======================= - -1. Activate the **MicroStrategy Desktop** app. The app displays the Dossiers panel to the right. - - :: - -2. Download the most current version of the `SQream JDBC driver `_. - - :: - -3. Click **Dossiers** and **New Dossier**. The **Untitled Dossier** panel is displayed. - - :: - -4. Click **New Data**. - - :: - -5. From the **Data Sources** panel, select **Databases** to access data from tables. The **Select Import Options** panel is displayed. - - :: - -6. Select one of the following: - - * Build a Query - * Type a Query - * Select Tables - - :: - -7. Click **Next**. - - :: - -8. In the Data Source panel, do the following: - - 1. From the **Database** dropdown menu, select **Generic**. The **Host Name**, **Port Number**, and **Database Name** fields are removed from the panel. - - :: - - 2. In the **Version** dropdown menu, verify that **Generic DBMS** is selected. - - :: - - 3. Click **Show Connection String**. - - :: - - 4. Select the **Edit connection string** checkbox. - - :: - - 5. From the **Driver** dropdown menu, select a driver for one of the following connectors: - - * **JDBC** - The SQream driver is not integrated with MicroStrategy and does not appear in the dropdown menu. However, to proceed, you must select an item, and in the next step you must specify the path to the SQream driver that you installed on your machine. - * **ODBC** - SQreamDB ODBC - - :: - - 6. In the **Connection String** text box, type the relevant connection string and path to the JDBC jar file using the following syntax: - - .. code-block:: console - - $ jdbc:Sqream:///;user=;password=sqream;[; ...] - - The following example shows the correct syntax for the JDBC connector: - - .. code-block:: console - - jdbc;MSTR_JDBC_JAR_FOLDER=C:\path\to\jdbc\folder;DRIVER=;URL={jdbc:Sqream:///;user=;password=;[; ...];} - - The following example shows the correct syntax for the ODBC connector: - - .. code-block:: console - - odbc:Driver={SqreamODBCDriver};DSN={SQreamDB ODBC};Server=;Port=;Database=;User=;Password=;Cluster=; - - For more information about the available **connection parameters** and other examples, see `Connection Parameters `_. - - 7. In the **User** and **Password** fields, fill out your user name and password. - - :: - - 8. In the **Data Source Name** field, type **SQreamDB**. - - :: - - 9. Click **Save**. The SQreamDB that you picked in the Data Source panel is displayed. - - -9. In the **Namespace** menu, select a namespace. The tables files are displayed. - - :: - -10. Drag and drop the tables into the panel on the right in your required order. - - :: - -11. **Recommended** - Click **Prepare Data** to customize your data for analysis. - - :: - -12. Click **Finish**. - - :: - -13. From the **Data Access Mode** dialog box, select one of the following: - - - * Connect Live - * Import as an In-memory Dataset - -Your populated dashboard is displayed and is ready for data discovery and analytics. - - - - - - -.. _supported_sqream_drivers: - -:ref:`Back to Overview ` - -Supported SQream Drivers -================ - -The following list shows the supported SQream drivers and versions: - -* **JDBC** - Version 4.3.3 and higher. -* **ODBC** - Version 4.0.0. - - -.. _supported_tools_and_operating_systems: - -:ref:`Back to Overview ` diff --git a/third_party_tools/client_platforms/odbc-sqream.tdc b/third_party_tools/client_platforms/odbc-sqream.tdc deleted file mode 100644 index f1bbe279d..000000000 --- a/third_party_tools/client_platforms/odbc-sqream.tdc +++ /dev/null @@ -1,25 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/third_party_tools/client_platforms/pentaho.rst b/third_party_tools/client_platforms/pentaho.rst deleted file mode 100644 index 1cd95866f..000000000 --- a/third_party_tools/client_platforms/pentaho.rst +++ /dev/null @@ -1,249 +0,0 @@ -.. _pentaho_data_integration: - -************************* -Connect to SQream Using Pentaho Data Integration -************************* -.. _pentaho_top: - -Overview -========= -This document is a Quick Start Guide that describes how to install Pentaho, create a transformation, and define your output. - -The Connecting to SQream Using Pentaho page describes the following: - -* :ref:`Installing Pentaho ` -* :ref:`Installing and setting up the JDBC driver ` -* :ref:`Creating a transformation ` -* :ref:`Defining your output ` -* :ref:`Importing your data ` - -.. _install_pentaho: - -Installing Pentaho -~~~~~~~~~~~~~~~~~ -To install PDI, see the `Pentaho Community Edition (CE) Installation Guide `_. - -The **Pentaho Community Edition (CE) Installation Guide** describes how to do the following: - -* Downloading the PDI software. -* Installing the **JRE (Java Runtime Environment)** and **JDK (Java Development Kit)**. -* Setting up the JRE and JDK environment variables for PDI. - -:ref:`Back to Overview ` - -.. _install_set_up_jdbc_driver: - -Installing and Setting Up the JDBC Driver -~~~~~~~~~~~~~~~~~ -After installing Pentaho you must install and set up the JDBC driver. This section explains how to set up the JDBC driver using Pentaho. These instructions use Spoon, the graphical transformation and job designer associated with the PDI suite. - -You can install the driver by copying and pasting the SQream JDBC .jar file into your **/design-tools/data-integration/lib** directory. - -**NOTE:** Contact your SQream license account manager for the JDBC .jar file. - -:ref:`Back to Overview ` - -.. _create_transformation: - -Creating a Transformation -~~~~~~~~~~~~~~~~~~ -After installing Pentaho you can create a transformation. - -**To create a transformation:** - -1. Use the CLI to open the PDI client for your operating system (Windows): - - .. code-block:: console - - $ spoon.bat - -2. Open the spoon.bat file from its folder location. - -:: - -3. In the **View** tab, right-click **Transformations** and click **New**. - -A new transformation tab is created. - -4. In the **Design** tab, click **Input** to show its file contents. - -:: - -5. Drag and drop the **CSV file input** item to the new transformation tab that you created. - -:: - -6. Double-click **CSV file input**. The **CSV file input** panel is displayed. - -:: - -7. In the **Step name** field, type a name. - -:: - -8. To the right of the **Filename** field, click **Browse**. - -:: - -9. Select the file that you want to read from and click **OK**. - -:: - -10. In the CSV file input window, click **Get Fields**. - -:: - -11. In the **Sample data** window, enter the number of lines you want to sample and click **OK**. The default setting is **100**. - -The tool reads the file and suggests the field name and type. - -12. In the CSV file input window, click **Preview**. - -:: - -13. In the **Preview size** window, enter the number of rows you want to preview and click **OK**. The default setting is **1000**. - -:: - -14. Verify that the preview data is correct and click **Close**. - -:: - -15. Click **OK** in the **CSV file input** window. - -:ref:`Back to Overview ` - -.. _define_output: - -Defining Your Output ------------------ -After creating your transformation you must define your output. - -**To define your output:** - -1. In the **Design** tab, click **Output**. - - The Output folder is opened. - -2. Drag and drop **Table output** item to the Transformation window. - -:: - -3. Double-click **Table output** to open the **Table output** dialog box. - -:: - -4. From the **Table output** dialog box, type a **Step name** and click **New** to create a new connection. Your **steps** are the building blocks of a transformation, such as file input or a table output. - -The **Database Connection** window is displayed with the **General** tab selected by default. - -5. Enter or select the following information in the Database Connection window and click **Test**. - -The following table shows and describes the information that you need to fill out in the Database Connection window: - -.. list-table:: - :widths: 6 31 73 - :header-rows: 1 - - * - No. - - Element Name - - Description - * - 1 - - Connection name - - Enter a name that uniquely describes your connection, such as **sampledata**. - * - 2 - - Connection type - - Select **Generic database**. - * - 3 - - Access - - Select **Native (JDBC)**. - * - 4 - - Custom connection URL - - Insert **jdbc:Sqream:///;user=;password=;[; ...];**. The IP is a node in your SQream cluster and is the name or schema of the database you want to connect to. Verify that you have not used any leading or trailing spaces. - * - 5 - - Custom driver class name - - Insert **com.sqream.jdbc.SQDriver**. Verify that you have not used any leading or trailing spaces. - * - 6 - - Username - - Your SQreamdb username. If you leave this blank, you will be prompted to provide it when you connect. - * - 7 - - Password - - Your password. If you leave this blank, you will be prompted to provide it when you connect. - -The following message is displayed: - -.. image:: /_static/images/third_party_connectors/pentaho/connection_tested_successfully_2.png - -6. Click **OK** in the window above, in the Database Connection window, and Table Output window. - -:ref:`Back to Overview ` - -.. _import_data: - -Importing Data ------------------ -After defining your output you can begin importing your data. - -For more information about backing up users, permissions, or schedules, see `Backup and Restore Pentaho Repositories `_ - -**To import data:** - -1. Double-click the **Table output** connection that you just created. - -:: - -2. To the right of the **Target schema** field, click **Browse** and select a schema name. - -:: - -3. Click **OK**. The selected schema name is displayed in the **Target schema** field. - -:: - -4. Create a new hop connection between the **CSV file input** and **Table output** steps: - - 1. On the CSV file input step item, click the **new hop connection** icon. - - .. image:: /_static/images/third_party_connectors/pentaho/csv_file_input_options.png - - 2. Drag an arrow from the **CSV file input** step item to the **Table output** step item. - - .. image:: /_static/images/third_party_connectors/pentaho/csv_file_input_options_2.png - - 3. Release the mouse button. The following options are displayed. - - 4. Select **Main output of step**. - - .. image:: /_static/images/third_party_connectors/pentaho/main_output_of_step.png - -:: - -5. Double-click **Table output** to open the **Table output** dialog box. - -:: - -6. In the **Target table** field, define a target table name. - -:: - -7. Click **SQL** to open the **Simple SQL editor.** - -:: - -8. In the **Simple SQL editor**, click **Execute**. - - The system processes and displays the results of the SQL statements. - -9. Close all open dialog boxes. - -:: - -10. Click the play button to execute the transformation. - - .. image:: /_static/images/third_party_connectors/pentaho/execute_transformation.png - - The **Run Options** dialog box is displayed. - -11. Click **Run**. The **Execution Results** are displayed. - -:ref:`Back to Overview ` diff --git a/third_party_tools/client_platforms/php.rst b/third_party_tools/client_platforms/php.rst deleted file mode 100644 index 599d6a578..000000000 --- a/third_party_tools/client_platforms/php.rst +++ /dev/null @@ -1,46 +0,0 @@ -.. _php: - -***************************** -Connect to SQream Using PHP -***************************** - -You can use PHP to interact with a SQream DB cluster. - -This tutorial is a guide that will show you how to connect a PHP application to SQream DB. - -.. contents:: In this topic: - :local: - -Prerequisites -=============== - -#. Install the :ref:`SQream DB ODBC driver for Linux` and create a DSN. - -#. - Install the `uODBC `_ extension for your PHP installation. - To configure PHP to enable uODBC, configure it with ``./configure --with-pdo-odbc=unixODBC,/usr/local`` when compiling php or install ``php-odbc`` and ``php-pdo`` along with php (version 7.1 minimum for best results) using your distribution package manager. - -Testing the connection -=========================== - -#. - Create a test connection file. Be sure to use the correct parameters for your SQream DB installation. - - Download this :download:`PHP example connection file ` . - - .. literalinclude:: test.php - :language: php - :emphasize-lines: 4 - :linenos: - - .. tip:: - An example of a valid DSN line is: - - .. code:: php - - $dsn = "odbc:Driver={SqreamODBCDriver};Server=192.168.0.5;Port=5000;Database=master;User=rhendricks;Password=super_secret;Service=sqream"; - - For more information about supported DSN parameters, see :ref:`dsn_params`. - -#. Run the PHP file either directly with PHP (``php test.php``) or through a browser. - diff --git a/third_party_tools/client_platforms/power_bi.rst b/third_party_tools/client_platforms/power_bi.rst deleted file mode 100644 index 3b9f662bd..000000000 --- a/third_party_tools/client_platforms/power_bi.rst +++ /dev/null @@ -1,143 +0,0 @@ -.. _power_bi: - -************************* -Connect to SQream Using Power BI Desktop -************************* - -Overview -========= -**Power BI Desktop** lets you connect to SQream and use underlying data as with other data sources in Power BI Desktop. - -SQream integrates with Power BI Desktop to do the following: - -* Extract and transform your datasets into usable visual models in approximately one minute. - - :: - -* Use **DAX** functions **(Data Analysis Expressions)** to analyze your datasets. - - :: - -* Refresh datasets as needed or by using scheduled jobs. - -SQream uses Power BI for extracting data sets using the following methods: - -* **Direct query** - Direct queries lets you connect easily with no errors, and refreshes Power BI artifacts, such as graphs and reports, in a considerable amount of time in relation to the time taken for queries to run using the `SQream SQL CLI Reference guide `_. - - :: - -* **Import** - Lets you extract datasets from remote databases. - -The **Connect to SQream Using Power BI** page describes the following: - -.. contents:: - :local: - :depth: 1 - -Prerequisites -------------------- -To connect to SQream, the following must be installed: - -* **ODBC data source administrator** - 32 or 64, depending on your operating system. For Windows users, the ODBC data source administrator is embedded within the operating system. - -* **SQream driver** - The SQream application required for interacting with the ODBC according to the configuration specified in the ODBC administrator tool. - -Installing Power BI Desktop -------------------- -**To install Power BI Desktop:** - -1. Download `Power BI Desktop 64x `_. - - :: - -2. Download and configure your ODBC driver. - - For more information about configuring your ODBC driver, see `ODBC `_. - -3. Navigate to **Windows** > **Documents** and create a folder called **Power BI Desktop Custom Connectors**. - - :: - -4. In the **Power BI Desktop** folder, create a folder called **Custom Connectors**. - - -5. From the Client Drivers page, download the **PowerQuery.mez** file. - - :: - -5. Save the PowerQuery.mez file in the **Custom Connectors** folder you created in Step 3. - - :: - -6. Open the Power BI application. - - :: - -7. Navigate to **File** > **Options and Settings** > **Option** > **Security** > **Data Extensions**, and select **(Not Recommended) Allow any extension to load without validation or warning**. - - :: - -8. Restart the Power BI Desktop application. - - :: - -9. From the **Get Data** menu, select **SQream**. - - :: - -10. Click **Connect** and provide the information shown in the following table: - - .. list-table:: - :widths: 6 31 - :header-rows: 1 - - * - Element Name - - Description - * - Server - - Provide the network address to your database server. You can use a hostname or an IP address. - * - Port - - Provide the port that the database is responding to at the network address. - * - Database - - Provide the name of your database or the schema on your database server. - * - User - - Provide a SQreamdb username. - * - Passwords - - Provide a password for your user. - -11. Under **Data Connectivity mode**, select **DirectQuery mode**. - - :: - -12. Click **Connect**. - - :: - -13. Provide your user name and password and click **Connect**. - -Best Practices for Power BI ---------------- -SQream recommends using Power BI in the following ways for acquiring the best performance metrics: - -* Creating bar, pie, line, or plot charts when illustrating one or more columns. - - :: - -* Displaying trends and statuses using visual models. - - :: - -* Creating a unified view using **PowerQuery** to connect different data sources into a single dashboard. - -Supported SQream Driver Versions ---------------- -SQream supports the following SQream driver versions: - -* The **PowerQuery Connector** is an additional layer on top of the ODBC. - - :: - -* SQream Driver Installation (ODBC v4.1.1) - Contact your administrator for the link to download ODBC v4.1.1. - -Related Information -------------------- -For more information, see the `Glossary `_. \ No newline at end of file diff --git a/third_party_tools/client_platforms/r.rst b/third_party_tools/client_platforms/r.rst deleted file mode 100644 index 6abe27031..000000000 --- a/third_party_tools/client_platforms/r.rst +++ /dev/null @@ -1,151 +0,0 @@ -.. _r: - -***************************** -Connect to SQream Using R -***************************** - -You can use R to interact with a SQream DB cluster. - -This tutorial is a guide that will show you how to connect R to SQream DB. - -.. contents:: In this topic: - :local: - -JDBC -========= - - -#. Get the :ref:`SQream DB JDBC driver`. - -#. - In R, install RJDBC - - .. code-block:: rconsole - - > install.packages("RJDBC") - Installing package into 'C:/Users/r/...' - (as 'lib' is unspecified) - - package 'RJDBC' successfully unpacked and MD5 sums checked - -#. - Import the RJDBC library - - .. code-block:: rconsole - - > library(RJDBC) - -#. - Set the classpath and initialize the JDBC driver which was previously installed. For example, on Windows: - - .. code-block:: rconsole - - > cp = c("C:\\Program Files\\SQream Technologies\\JDBC Driver\\2020.1-3.2.0\\sqream-jdbc-3.2.jar") - > .jinit(classpath=cp) - > drv <- JDBC("com.sqream.jdbc.SQDriver","C:\\Program Files\\SQream Technologies\\JDBC Driver\\2020.1-3.2.0\\sqream-jdbc-3.2.jar") -#. - Open a connection with a :ref:`JDBC connection string` and run your first statement - - .. code-block:: rconsole - - > con <- dbConnect(drv,"jdbc:Sqream://127.0.0.1:3108/master;user=rhendricks;password=Tr0ub4dor&3;cluster=true") - - > dbGetQuery(con,"select top 5 * from t") - xint xtinyint xsmallint xbigint - 1 1 82 5067 1 - 2 2 14 1756 2 - 3 3 91 22356 3 - 4 4 84 17232 4 - 5 5 13 14315 5 - -#. - Close the connection - - .. code-block:: rconsole - - > close(con) - -A full example ------------------ - -.. code-block:: rconsole - - > library(RJDBC) - > cp = c("C:\\Program Files\\SQream Technologies\\JDBC Driver\\2020.1-3.2.0\\sqream-jdbc-3.2.jar") - > .jinit(classpath=cp) - > drv <- JDBC("com.sqream.jdbc.SQDriver","C:\\Program Files\\SQream Technologies\\JDBC Driver\\2020.1-3.2.0\\sqream-jdbc-3.2.jar") - > con <- dbConnect(drv,"jdbc:Sqream://127.0.0.1:3108/master;user=rhendricks;password=Tr0ub4dor&3;cluster=true") - > dbGetQuery(con,"select top 5 * from t") - xint xtinyint xsmallint xbigint - 1 1 82 5067 1 - 2 2 14 1756 2 - 3 3 91 22356 3 - 4 4 84 17232 4 - 5 5 13 14315 5 - > close(con) - -ODBC -========= - -#. Install the :ref:`SQream DB ODBC driver` for your operating system, and create a DSN. - -#. - In R, install RODBC - - .. code-block:: rconsole - - > install.packages("RODBC") - Installing package into 'C:/Users/r/...' - (as 'lib' is unspecified) - - package 'RODBC' successfully unpacked and MD5 sums checked - -#. - Import the RODBC library - - .. code-block:: rconsole - - > library(RODBC) - -#. - Open a connection handle to an existing DSN (``my_cool_dsn`` in this example) - - .. code-block:: rconsole - - > ch <- odbcConnect("my_cool_dsn",believeNRows=F) - -#. - Run your first statement - - .. code-block:: rconsole - - > sqlQuery(ch,"select top 5 * from t") - xint xtinyint xsmallint xbigint - 1 1 82 5067 1 - 2 2 14 1756 2 - 3 3 91 22356 3 - 4 4 84 17232 4 - 5 5 13 14315 5 - -#. - Close the connection - - .. code-block:: rconsole - - > close(ch) - -A full example ------------------ - -.. code-block:: rconsole - - > library(RODBC) - > ch <- odbcConnect("my_cool_dsn",believeNRows=F) - > sqlQuery(ch,"select top 5 * from t") - xint xtinyint xsmallint xbigint - 1 1 82 5067 1 - 2 2 14 1756 2 - 3 3 91 22356 3 - 4 4 84 17232 4 - 5 5 13 14315 5 - > close(ch) diff --git a/third_party_tools/client_platforms/sas_viya.rst b/third_party_tools/client_platforms/sas_viya.rst deleted file mode 100644 index fc0806296..000000000 --- a/third_party_tools/client_platforms/sas_viya.rst +++ /dev/null @@ -1,185 +0,0 @@ -.. _connect_to_sas_viya: - -************************* -Connect to SQream Using SAS Viya -************************* - -Overview -========== -SAS Viya is a cloud-enabled analytics engine used for producing useful insights. The **Connect to SQream Using SAS Viya** page describes how to connect to SAS Viya, and describes the following: - -.. contents:: - :local: - :depth: 1 - -Installing SAS Viya -------------------- -The **Installing SAS Viya** section describes the following: - -.. contents:: - :local: - :depth: 1 - -Downloading SAS Viya -~~~~~~~~~~~~~~~~~~ -Integrating with SQream has been tested with SAS Viya v.03.05 and newer. - -To download SAS Viya, see `SAS Viya `_. - -Installing the JDBC Driver -~~~~~~~~~~~~~~~~~~ -The SQream JDBC driver is required for establishing a connection between SAS Viya and SQream. - -**To install the JDBC driver:** - -#. Download the `JDBC driver `_. - - :: - -#. Unzip the JDBC driver into a location on the SAS Viya server. - - SQream recommends creating the directory ``/opt/sqream`` on the SAS Viya server. - -Configuring SAS Viya -------------------- -After installing the JDBC driver, you must configure the JDBC driver from the SAS Studio so that it can be used with SQream Studio. - -**To configure the JDBC driver from the SAS Studio:** - -#. Sign in to the SAS Studio. - - :: - -#. From the **New** menu, click **SAS Program**. - - :: - -#. Configure the SQream JDBC connector by adding the following rows: - - .. literalinclude:: connect3.sas - :language: php - -For more information about writing a connection string, see **Connect to SQream DB with a JDBC Application** and navigate to `Connection String `_. - -Operating SAS Viya --------------------- -The **Operating SAS Viya** section describes the following: - -.. contents:: - :local: - :depth: 1 - -Using SAS Viya Visual Analytics -~~~~~~~~~~~~~~~~~~ -This section describes how to use SAS Viya Visual Analytics. - -**To use SAS Viya Visual Analytics:** - -#. Log in to `SAS Viya Visual Analytics `_ using your credentials: - - :: - -2. Click **New Report**. - - :: - -3. Click **Data**. - - :: - -4. Click **Data Sources**. - - :: - -5. Click the **Connect** icon. - - :: - -6. From the **Type** menu, select **Database**. - - :: - -7. Provide the required information and select **Persist this connection beyond the current session**. - - :: - -8. Click **Advanced** and provide the required information. - - :: - -9. Add the following additional parameters by clicking **Add Parameters**: - -.. list-table:: - :widths: 10 90 - :header-rows: 1 - - * - Name - - Value - * - class - - com.sqream.jdbc.SQDriver - * - classPath - - ** - * - url - - \jdbc:Sqream://**:**/**;cluster=true - * - username - - - * - password - - - -10. Click **Test Connection**. - - :: - -11. If the connection is successful, click **Save**. - -If your connection is not successful, see :ref:`troubleshooting_sas_viya` below. - -.. _troubleshooting_sas_viya: - -Troubleshooting SAS Viya -------------------------- -The **Best Practices and Troubleshooting** section describes the following best practices and troubleshooting procedures when connecting to SQream using SAS Viya: - -.. contents:: - :local: - :depth: 1 - -Inserting Only Required Data -~~~~~~~~~~~~~~~~~~ -When using SAS Viya, SQream recommends using only data that you need, as described below: - -* Insert only the data sources you need into SAS Viya, excluding tables that don’t require analysis. - - :: - -* To increase query performance, add filters before analyzing. Every modification you make while analyzing data queries the SQream database, sometimes several times. Adding filters to the datasource before exploring limits the amount of data analyzed and increases query performance. - -Creating a Separate Service for SAS Viya -~~~~~~~~~~~~~~~~~~ -SQream recommends creating a separate service for SAS Viya with the DWLM. This reduces the impact that Tableau has on other applications and processes, such as ETL. In addition, this works in conjunction with the load balancer to ensure good performance. - -Locating the SQream JDBC Driver -~~~~~~~~~~~~~~~~~~ -In some cases, SAS Viya cannot locate the SQream JDBC driver, generating the following error message: - -.. code-block:: text - - java.lang.ClassNotFoundException: com.sqream.jdbc.SQDriver - -**To locate the SQream JDBC driver:** - -1. Verify that you have placed the JDBC driver in a directory that SAS Viya can access. - - :: - -2. Verify that the classpath in your SAS program is correct, and that SAS Viya can access the file that it references. - - :: - -3. Restart SAS Viya. - -For more troubleshooting assistance, see the `SQream Support Portal `_. - -Supporting TEXT -~~~~~~~~~~~~~~~~~~ -In SAS Viya versions lower than 4.0, casting ``TEXT`` to ``CHAR`` changes the size to 1,024, such as when creating a table including a ``TEXT`` column. This is resolved by casting ``TEXT`` into ``CHAR`` when using the JDBC driver. diff --git a/third_party_tools/client_platforms/sql_workbench.rst b/third_party_tools/client_platforms/sql_workbench.rst deleted file mode 100644 index d46d45ae6..000000000 --- a/third_party_tools/client_platforms/sql_workbench.rst +++ /dev/null @@ -1,135 +0,0 @@ -.. _connect_to_sql_workbench: - -***************************** -Connect to SQream Using SQL Workbench -***************************** - -You can use SQL Workbench to interact with a SQream DB cluster. SQL Workbench/J is a free SQL query tool, and is designed to run on any JRE-enabled environment. - -This tutorial is a guide that will show you how to connect SQL Workbench to SQream DB. - -.. contents:: In this topic: - :local: - -Installing SQL Workbench with the SQream DB installer (Windows only) -===================================================================== - -SQream DB's driver installer for Windows can install the Java prerequisites and SQL Workbench for you. - -#. Get the JDBC driver installer available for download from the `SQream Drivers page `_. The Windows installer takes care of the Java prerequisites and subsequent configuration. - -#. Install the driver by following the on-screen instructions in the easy-to-follow installer. - By default, the installer does not install SQL Workbench. Make sure to select the item! - - .. image:: /_static/images/jdbc_windows_installer_screen.png - -.. note:: The installer will install SQL Workbench in ``C:\Program Files\SQream Technologies\SQLWorkbench`` by default. You can change this path during the installation. - -#. Once finished, SQL Workbench is installed and contains the necessary configuration for connecting to SQream DB clusters. - -#. Start SQL Workbench from the Windows start menu. Be sure to select **SQL Workbench (64)** if you're on 64-bit Windows. - - .. image:: /_static/images/sql_workbench_launch.png - -You are now ready to create a profile for your cluster. Continue to :ref:`Creating a new connection profile `. - -Installing SQL Workbench manually (Linux, MacOS) -=================================================== - -Install Java Runtime ------------------------- - -Both SQL Workbench and the SQream DB JDBC driver require Java 1.8 or newer. You can install either Oracle Java or OpenJDK. - -**Oracle Java** - -Download and install Java 8 from Oracle for your platform - https://www.java.com/en/download/manual.jsp - -**OpenJDK** - -For Linux and BSD, see https://openjdk.java.net/install/ - -For Windows, SQream recommends Zulu 8 https://www.azul.com/downloads/zulu-community/?&version=java-8-lts&architecture=x86-64-bit&package=jdk - -Get the SQream DB JDBC driver -------------------------------- - -SQream DB's JDBC driver is provided as a zipped JAR file, available for download from the `SQream Drivers page `_. - -Download and extract the JAR file from the zip archive. - -Install SQL Workbench ------------------------ - -#. Download the latest stable release from https://www.sql-workbench.eu/downloads.html . The **Generic package for all systems** is recommended. - -#. Extract the downloaded ZIP archive into a directory of your choice. - -#. Start SQL workbench. If you are using 64 bit windows, run ``SQLWorkbench64.exe`` instead of ``SQLWOrkbench.exe``. - -Setting up the SQream DB JDBC driver profile ---------------------------------------------- - -#. Define a connection profile - :menuselection:`&File --> &Connect window (Alt+C)` - - .. image:: /_static/images/sql_workbench_connect_window1.png - -#. Open the drivers management window - :menuselection:`&Manage Drivers` - - .. image:: /_static/images/sql_workbench_manage_drivers.png - - - -#. Create the SQream DB driver profile - - .. image:: /_static/images/sql_workbench_create_driver.png - - #. Click on the Add new driver button ("New" icon) - - #. Name the driver as you see fit. We recommend calling it SQream DB , where is the version you have installed. - - #. - Add the JDBC drivers from the location where you extracted the SQream DB JDBC JAR. - - If you used the SQream installer, the file will be in ``C:\Program Files\SQream Technologies\JDBC Driver\`` - - #. Click the magnifying glass button to detect the classname automatically. Other details are purely optional - - #. Click OK to save and return to "new connection screen" - - -.. _new_connection_profile: - -Create a new connection profile for your cluster -===================================================== - - .. image:: /_static/images/sql_workbench_connection_profile.png - -#. Create new connection by clicking the New icon (top left) - -#. Give your connection a descriptive name - -#. Select the SQream Driver that was created in the previous screen - -#. Type in your connection string. To find out more about your connection string (URL), see the :ref:`Connection string documentation `. - -#. Text the connection details - -#. Click OK to save the connection profile and connect to SQream DB - -Suggested optional configuration -================================== - -If you installed SQL Workbench manually, you can set a customization to help SQL Workbench show information correctly in the DB Explorer panel. - -#. Locate your workbench.settings file - On Windows, typically: ``C:\Users\\.sqlworkbench\workbench.settings`` - On Linux, ``$HOME/.sqlworkbench`` - -#. Add the following line at the end of the file: - - .. code-block:: text - - workbench.db.sqreamdb.schema.retrieve.change.catalog=true - -#. Save the file and restart SQL Workbench diff --git a/third_party_tools/client_platforms/tableau.rst b/third_party_tools/client_platforms/tableau.rst deleted file mode 100644 index 666b2f198..000000000 --- a/third_party_tools/client_platforms/tableau.rst +++ /dev/null @@ -1,453 +0,0 @@ -.. _connect_to_tableau: - -************************* -Connecting to SQream Using Tableau -************************* - -Overview -===================== -SQream's Tableau connector plugin, based on standard JDBC, enables storing and fast querying large volumes of data. - -The **Connecting to SQream Using Tableau** page is a Quick Start Guide that describes how install Tableau and the JDBC and ODBC drivers and connect to SQream using the JDBC and ODBC drivers for data analysis. It also describes using best practices and troubleshoot issues that may occur while installing Tableau. SQream supports both Tableau Desktop and Tableau Server on Windows, MacOS, and Linux distributions. - -For more information on SQream's integration with Tableau, see `Tableau's Extension Gallery `_. - -The Connecting to SQream Using Tableau page describes the following: - -.. contents:: - :local: - -Installing the JDBC Driver and Tableau Connector Plugin -------------------- -This section describes how to install the JDBC driver using the fully-integrated Tableau connector plugin (Tableau Connector, or **.taco** file). SQream has been tested with Tableau versions 9.2 and newer. - -**To connect to SQream using Tableau:** - -#. Install the Tableau Desktop application. - - For more information about installing the Tableau Desktop application, see the `Tableau products page `_ and click **Download Free Trial**. Note that Tableau offers a 14-day trial version. - - :: - -#. Do one of the following: - - * **For Windows** - See :ref:`Installing Tableau Using the Windows Installer `. - * **For MacOS or Linux** - See :ref:`Installing the JDBC Driver Manually `. - -.. note:: For Tableau **2019.4 versions and later**, SQream recommends installing the JDBC driver instead of the previously recommended ODBC driver. - -.. _tableau_windows_installer: - -Installing the JDBC Driver Using the Windows Installer -~~~~~~~~~~~~~~~~~~ -If you are using Windows, after installing the Tableau Desktop application you can install the JDBC driver using the Windows installer. The Windows installer is an installation wizard that guides you through the JDBC driver installation steps. When the driver is installed, you can connect to SQream. - -**To install Tableau using the Windows installer**: - -#. Close Tableau Desktop. - - :: - -#. Download the most current version of the `SQream JDBC driver `_. - - :: - -#. Do the following: - - #. Start the installer. - #. Verify that the **Tableau Desktop connector** item is selected. - #. Follow the installation steps. - - :: - -You can now restart Tableau Desktop or Server to begin using the SQream driver by :ref:`connecting to SQream `. - -.. _tableau_jdbc_installer: - -Installing the JDBC Driver Manually -~~~~~~~~~~~~~ -If you are using MacOS, Linux, or the Tableau server, after installing the Tableau Desktop application you can install the JDBC driver manually. When the driver is installed, you can connect to SQream. - -**To install the JDBC driver manually:** - -1. Download the JDBC installer and SQream Tableau connector (.taco) file from the :ref:`from the client drivers page`. - - :: - -#. Install the JDBC driver by unzipping the JDBC driver into a Tableau driver directory. - - Based on the installation method that you used, your Tableau driver directory is located in one of the following places: - - * **Tableau Desktop on Windows:** *C:\\Program Files\\Tableau\\Drivers* - * **Tableau Desktop on MacOS:** *~/Library/Tableau/Drivers* - * **Tableau on Linux**: */opt/tableau/tableau_driver/jdbc* - -.. note:: If the driver includes only a single .jar file, copy it to *C:\\Program Files\\Tableau/Drivers*. If the driver includes multiple files, create a subfolder *A* in *C:\\Program Files\\Tableau/Drivers* and copy all files to folder *A*. - -Note the following when installing the JDBC driver: - -* You must have read permissions on the .jar file. -* Tableau requires a JDBC 4.0 or later driver. -* Tableau requires a Type 4 JDBC driver. -* The latest 64-bit version of Java 8 is installed. - -3. Install the **SQreamDB.taco** file by moving the SQreamDB.taco file into the Tableau connectors directory. - - Based on the installation method that you used, your Tableau driver directory is located in one of the following places: - - * **Tableau Desktop on Windows:** *C:\\Users\\\\My Tableau Repository\\Connectors* - * **Tableau Desktop on Windows:** *~/My Tableau Repository/Connectors* - - :: - -4. *Optional* - If you are using the Tableau Server, do the following: - - 1. Create a directory for Tableau connectors and give it a descriptive name, such as *C:\\tableau_connectors*. - - This directory needs to exist on all Tableau servers. - - :: - - 2. Copy the SQreamDB.taco file into the new directory. - - :: - - 3. Set the **native_api.connect_plugins_path** option to ``tsm`` as shown in the following example: - - .. code-block:: console - - $ tsm configuration set -k native_api.connect_plugins_path -v C:/tableau_connectors - - If a configuration error is displayed, add ``--force-keys`` to the end of the command as shown in the following example: - - .. code-block:: console - - $ tsm configuration set -k native_api.connect_plugins_path -v C:/tableau_connectors--force-keys - - 4. To apply the pending configuration changes, run the following command: - - .. code-block:: console - - $ tsm pending-changes apply - - .. warning:: This restarts the server. - -You can now restart Tableau Desktop or Server to begin using the SQream driver by :ref:`connecting to SQream ` as described in the section below. - -.. _tableau_connect_to_sqream: - - -Installing the ODBC Driver for Tableau Versions 2019.3 and Earlier --------------- - - -This section describes the installation method for Tableau version 2019.3 or earlier and describes the following: - -.. contents:: - :local: - -.. note:: SQream recommends installing the JDBC driver to provide improved connectivity. - -Automatically Reconfiguring the ODBC Driver After Initial Installation -~~~~~~~~~~~~~~~~~~ -If you've already installed the SQream ODBC driver and installed Tableau, SQream recommends reinstalling the ODBC driver with the **.TDC Tableau Settings for SQream DB** configuration shown in the image below: - -.. image:: /_static/images/odbc_windows_installer_tableau.png - -SQream recommends this configuration because Tableau creates temporary tables and runs several discovery queries that may impact performance. The ODBC driver installer avoids this by automatically reconfiguring Tableau. - -For more information about reinstalling the ODBC driver installer, see :ref:`Install and Configure ODBC on Windows `. - -If you want to manually reconfigure the ODBC driver, see :ref:`Manually Reconfiguring the ODBC Driver After Initial Installation ` below. - -.. _manually_reconfigure_odbc_driver: - -Manually Reconfiguring the ODBC Driver After Initial Installation -~~~~~~~~~~~~~~~~~~ -The file **Tableau Datasource Customization (TDC)** file lets you use Tableau make full use of SQream DB's features and capabilities. - -**To manually reconfigure the ODBC driver after initial installation:** - -1. Do one of the following: - - 1. Download the :download:`odbc-sqream.tdc ` file to your machine and open it in a text editor. - - :: - - 2. Copy the text below into a text editor: - - .. literalinclude:: odbc-sqream.tdc - :language: xml - :caption: SQream ODBC TDC File - :emphasize-lines: 2 - -#. Check which version of Tableau you are using. - - :: - -#. In the text of the file shown above, in the highlighted line, replace the version number with the **major** version of Tableau that you are using. - - For example, if you are using Tableau vesion **2019.2.1**, replace it with **2019.2**. - - :: - -#. Do one of the following: - - * If you are using **Tableau Desktop** - save the TDC file to *C:\\Users\\\\Documents\\My Tableau Repository\\Datasources*, where ```` is the Windows username that you have installed Tableau under. - - :: - - * If you are using the **Tableau Server** - save the TDC file to *C:\\ProgramData\\Tableau\\Tableau Server\\data\\tabsvc\\vizqlserver\\Datasources*. - -Configuring the ODBC Connection -~~~~~~~~~~~~ -The ODBC connection uses a DSN when connecting to ODBC data sources, and each DSN represents one SQream database. - -**To configure the ODBC connection:** - -1. Create an ODBC DSN. - - :: - -#. Open the Windows menu by pressing the Windows button (:kbd:`⊞ Win`) or clicking the **Windows** menu button. - - :: - -#. Type **ODBC** and select **ODBC Data Sources (64-bit)**. - - During installation, the installer created a sample user DSN named **SQreamDB**. - - :: - -#. *Optional* - Do one or both of the following: - - * Modify the DSN name. - - :: - - * Create a new DSN name by clicking **Add** and selecting **SQream ODBC Driver**. - -.. image:: /_static/images/odbc_windows_dsns.png - - -5. Click **Finish**. - - :: - -6. Enter your connection parameters. - - The following table describes the connection parameters: - - .. list-table:: - :widths: 15 38 38 - :header-rows: 1 - - * - Item - - Description - - Example - * - Data Source Name - - The Data Source Name. SQream recommends using a descriptive and easily recognizable name for referencing your DSN. Once set, the Data Source Name cannot be changed. - - - * - Description - - The description of your DSN. This field is optional. - - - * - User - - The username of a role to use for establishing the connection. - - ``rhendricks`` - * - Password - - The password of the selected role. - - ``Tr0ub4dor`` - * - Database - - The database name to connect to. For example, ``master`` - - ``master`` - * - Service - - The :ref:`service queue` to use. - - For example, ``etl``. For the default service ``sqream``, leave blank. - * - Server - - The hostname of the SQream worker. - - ``127.0.0.1`` or ``sqream.mynetwork.co`` - * - Port - - The TCP port of the SQream worker. - - ``5000`` or ``3108`` - * - User Server Picker - - Uses the load balancer when establishing a connection. Use only if exists, and check port. - - - * - SSL - - Uses SSL when establishing a connection. - - - * - Logging Options - - Lets you modify your logging options when tracking the ODBC connection for connection issues. - - - -.. tip:: Test the connection by clicking **Test** before saving your DSN. - -7. Save the DSN by clicking **OK.** - -Connecting Tableau to SQream -~~~~~~~~~~~~ -**To connect Tableau to SQream:** - -1. Start Tableau Desktop. - - :: - -#. In the **Connect** menu, in the **To a server** sub-menu, click **More Servers** and select **Other Databases (ODBC)**. - - The **Other Databases (ODBC)** window is displayed. - - :: - -#. In the Other Databases (ODBC) window, select the DSN that you created in :ref:`Setting Up SQream Tables as Data Sources `. - - Tableau may display the **Sqream ODBC Driver Connection Dialog** window and prompt you to provide your username and password. - -#. Provide your username and password and click **OK**. - -.. _tableau_connect_to_sqream_db: - - -Connecting to SQream ---------------------- -After installing the JDBC driver you can connect to SQream. - -**To connect to SQream:** - -#. Start Tableau Desktop. - - :: - -#. In the **Connect** menu, in the **To a Server** sub-menu, click **More...**. - - More connection options are displayed. - - :: - -#. Select **SQream DB by SQream Technologies**. - - The **New Connection** dialog box is displayed. - - :: - -#. In the New Connection dialog box, fill in the fields and click **Sign In**. - - The following table describes the fields: - - .. list-table:: - :widths: 15 38 38 - :header-rows: 1 - - * - Item - - Description - - Example - * - Server - - Defines the server of the SQream worker. - - ``127.0.0.1`` or ``sqream.mynetwork.co`` - * - Port - - Defines the TCP port of the SQream worker. - - ``3108`` when using a load balancer, or ``5100`` when connecting directly to a worker with SSL. - * - Database - - Defines the database to establish a connection with. - - ``master`` - * - Cluster - - Enables (``true``) or disables (``false``) the load balancer. After enabling or disabling the load balance, verify the connection. - - - * - Username - - Specifies the username of a role to use when connecting. - - ``rhendricks`` - * - Password - - Specifies the password of the selected role. - - ``Tr0ub4dor&3`` - * - Require SSL (recommended) - - Sets SSL as a requirement for establishing this connection. - - - -The connection is established and the data source page is displayed. - -.. tip:: - Tableau automatically assigns your connection a default name based on the DSN and table. SQream recommends giving the connection a more descriptive name. - -.. _set_up_sqream_tables_as_data_sources: - -Setting Up SQream Tables as Data Sources ----------------- -After connecting to SQream you must set up the SQream tables as data sources. - -**To set up SQream tables as data sources:** - -1. From the **Table** menu, select the desired database and schema. - - SQream's default schema is **public**. - - :: - -#. Drag the desired tables into the main area (labeled **Drag tables here**). - - This area is also used for specifying joins and data source filters. - - :: - -#. Open a new sheet to analyze data. - -.. tip:: - For more information about configuring data sources, joining, filtering, see Tableau's `Set Up Data Sources `_ tutorials. - -Tableau Best Practices and Troubleshooting ---------------- -This section describes the following best practices and troubleshooting procedures when connecting to SQream using Tableau: - -.. contents:: - :local: - -Inserting Only Required Data -~~~~~~~~~~~~~~~~~~ -When using Tableau, SQream recommends using only data that you need, as described below: - -* Insert only the data sources you need into Tableau, excluding tables that don't require analysis. - - :: - -* To increase query performance, add filters before analyzing. Every modification you make while analyzing data queries the SQream database, sometimes several times. Adding filters to the datasource before exploring limits the amount of data analyze and increases query performance. - -Using Tableau's Table Query Syntax -~~~~~~~~~~~~~~~~~~~ -Dragging your desired tables into the main area in Tableau builds queries based on its own syntax. This helps ensure increased performance, while using views or custom SQL may degrade performance. In addition, SQream recommends using the :ref:`create_view` to create pre-optimized views, which your datasources point to. - -Creating a Separate Service for Tableau -~~~~~~~~~~~~~~~~~~~ -SQream recommends creating a separate service for Tableau with the DWLM. This reduces the impact that Tableau has on other applications and processes, such as ETL. In addition, this works in conjunction with the load balancer to ensure good performance. - -Troubleshooting Workbook Performance Before Deploying to the Tableau Server -~~~~~~~~~~~~~~~~~~~ -Tableau has a built-in `performance recorder `_ that shows how time is being spent. If you're seeing slow performance, this could be the result of a misconfiguration such as setting concurrency too low. - -Use the Tableau Performance Recorder for viewing the performance of queries run by Tableau. You can use this information to identify queries that can be optimized by using views. - -Troubleshooting Error Codes -~~~~~~~~~~~~~~~~~~~ -Tableau may be unable to locate the SQream JDBC driver. The following message is displayed when Tableau cannot locate the driver: - -.. code-block:: console - - Error Code: 37CE01A3, No suitable driver installed or the URL is incorrect - -**To troubleshoot error codes:** - -If Tableau cannot locate the SQream JDBC driver, do the following: - - 1. Verify that the JDBC driver is located in the correct directory: - - * **Tableau Desktop on Windows:** *C:\Program Files\Tableau\Drivers* - * **Tableau Desktop on MacOS:** *~/Library/Tableau/Drivers* - * **Tableau on Linux**: */opt/tableau/tableau_driver/jdbc* - - 2. Find the file path for the JDBC driver and add it to the Java classpath: - - * **For Linux** - ``export CLASSPATH=;$CLASSPATH`` - - :: - - * **For Windows** - add an environment variable for the classpath: - - .. image:: /_static/images/third_party_connectors/tableau/envrionment_variable_for_classpath.png - -If you experience issues after restarting Tableau, see the `SQream support portal `_. diff --git a/third_party_tools/client_platforms/talend.rst b/third_party_tools/client_platforms/talend.rst deleted file mode 100644 index 6e34a7168..000000000 --- a/third_party_tools/client_platforms/talend.rst +++ /dev/null @@ -1,177 +0,0 @@ -.. _talend: - -************************* -Connecting to SQream Using Talend -************************* -.. _top: - -Overview -================= - -This page describes how to use Talend to interact with a SQream DB cluster. The Talend connector is used for reading data from a SQream DB cluster and loading data into SQream DB. - -In addition, this page provides a viability report on Talend's comptability with SQream DB for stakeholders. - -It includes the following: - -* :ref:`A Quick Start guide ` -* :ref:`Information about supported SQream drivers ` -* :ref:`Supported data sources ` and :ref:`tool and operating system versions ` -* :ref:`A description of known issues ` -* :ref:`Related links ` - -About Talend -================= -Talend is an open-source data integration platform. It provides various software and services for Big Data integration and management, enterprise application integration, data quality and cloud storage. - -For more information about Talend, see `Talend `_. - -.. _quickstart_guide: - -Quick Start Guide -======================= - -Creating a New Metadata JDBC DB Connection -------------- -**To create a new metadata JDBC DB connection:** - -1. In the **Repository** panel, nagivate to **Metadata** and right-click **Db connections**. - -:: - -2. Select **Create connection**. - -3. In the **Name** field, type a name. - -The name cannot contain spaces. - -4. In the **Purpose** field, type a purpose and click **Next**. You cannot go to the next step until you define both a Name and a Purpose. - -:: - -5. In the **DB Type** field, select **JDBC**. - -:: - -6. In the **JDBC URL** field, type the relevant connection string. - - For connection string examples, see `Connection Strings `_. - -7. In the **Drivers** field, click the **Add** button. - - The **"newLine** entry is added. - -8. One the **"newLine** entry, click the ellipsis. - -.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_8.png - -The **Module** window is displayed. - -9. From the Module window, select **Artifact repository(local m2/nexus)** and select **Install a new module**. - -:: - -10. Click the ellipsis. - -.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_9.5.png - -Your hard drive is displayed. - -11. Navigate to a **JDBC jar file** (such as **sqream-jdbc-4.4.0.jar**)and click **Open**. - -:: - -12. Click **Detect the module install status**. - -:: - -13. Click **OK**. - -The JDBC that you selected is displayed in the **Driver** field. - -14. Click **Select class name**. - -:: - -15. Click **Test connection**. - -If a driver class is not found (for example, you didn't select a JDBC jar file), the following error message is displayed: - -After creating a new metadata JDBC DB connection, you can do the following: - - * Use your new metadata connection. - * Drag it to the **job** screen. - * Build Talend components. - -For more information on loading data from JSON files to the Talend Open Studio, see `How to Load Data from JSON Files in Talend `_. - -:ref:`Back to top ` - -.. _supported_sqream_drivers: - -Supported SQream Drivers -================ - -The following list shows the supported SQream drivers and versions: - -* **JDBC** - Version 4.3.3 and higher. -* **ODBC** - Version 4.0.0. This version requires a Bridge to connect. For more information on the required Bridge, see `Connecting Talend on Windows to an ODBC Database `_. - -:ref:`Back to top ` - -.. _supported_data_sources: - -Supported Data Sources -============================ -Talend Cloud connectors let you create reusable connections with a wide variety of systems and environments, such as those shown below. This lets you access and read records of a range of diverse data. - -* **Connections:** Connections are environments or systems for storing datasets, including databases, file systems, distributed systems and platforms. Because these systems are reusable, you only need to establish connectivity with them once. - -* **Datasets:** Datasets include database tables, file names, topics (Kafka), queues (JMS) and file paths (HDFS). For more information on the complete list of connectors and datasets that Talend supports, see `Introducing Talend Connectors `_. - -:ref:`Back to top ` - -.. _supported_tools_os_sys_versions: - -Supported Tool and Operating System Versions -====================== -Talend was tested using the following: - -* Talend version 7.4.1M6 -* Windows 10 -* SQream version 2021.1 -* JDBC version - -:ref:`Back to top ` - -.. _known_issues: - -Known Issues -=========================== -The the list below describes the following known issues as of 6/1/2021: - -* Schemas not displayed for tables with identical names. - -:ref:`Back to top ` - -.. _related_links: - -Related Links -=============== -The following is a list of links relevant to the Talend connector: - -* `Talend Home page `_ -* `Talend Community page `_ -* `Talend BugTracker `_ - -Download Links -================== -The following is a list of download links relevant to the Talend connector: - -* `Talend Open Studio for Big Data `_ -* `Latest version of SQream JDBC `_ - -:ref:`Back to top ` - -.. contents:: In this topic: - :local: \ No newline at end of file diff --git a/third_party_tools/client_platforms/test.php b/third_party_tools/client_platforms/test.php deleted file mode 100644 index fef04e699..000000000 --- a/third_party_tools/client_platforms/test.php +++ /dev/null @@ -1,16 +0,0 @@ - diff --git a/third_party_tools/client_platforms/tibco_spotfire.rst b/third_party_tools/client_platforms/tibco_spotfire.rst deleted file mode 100644 index b0a707c51..000000000 --- a/third_party_tools/client_platforms/tibco_spotfire.rst +++ /dev/null @@ -1,387 +0,0 @@ -.. _tibco_spotfire: - - -************************* -Connecting to SQream Using TIBCO Spotfire -************************* -Overview -========= -The **TIBCO Spotfire** software is an analytics solution that enables visualizing and exploring data through dashboards and advanced analytics. - -This document is a Quick Start Guide that describes the following: - -.. contents:: - :local: - :depth: 1 - -Establishing a Connection between TIBCO Spotfire and SQream ------------------ -TIBCO Spotfire supports the following versions: - -* **JDBC driver** - Version 4.5.3 -* **ODBC driver** - Version 4.1.1 - -SQream supports TIBCO Spotfire version 7.12.0. - -The **Establishing a JDBC Connection between TIBCO Spotfire and SQream** section describes the following: - -.. contents:: - :local: - :depth: 1 - -Creating a JDBC Connection -~~~~~~~~~~~ -For TIBCO Spotfire to recognize SQream, you must add the correct JDBC jar file to Spotfire's loaded binary folder. The following is an example of a path to the Spotfire loaded binaries folder: ``C:\tibco\tss\7.12.0\tomcat\bin``. - -For the complete TIBCO Spotfire documentation, see `TIBCO Spotfire® JDBC Data Access Connectivity Details `_. - -Creating an ODBC Connection -~~~~~~~~~~~ -**To create an ODBC connection** - -1. Install and configure ODBC on Windows. - - For more information, see :ref:`Install and Configure ODBC on Windows`. - -#. Launch the TIBCO Spotfire application. - - :: - -#. From the **File** menu click **Add Data Tables**. - - The **Add Database Tables** window is displayed. - -#. Click **Add** and select **Database**. - - The **Open Database** window is displayed. - -#. In the **Data source type** area, select **ODBC SQream** (Odbc Data Provider) and click **Configure**. - - The **Configure Data Source and Connection** window is displayed. - -#. Select **System or user data source** and from the drop-down menu select the DSN of your data source (SQreamDB). - - :: - -#. Provide your database username and password and click **OK**. - - :: - -#. In the **Open Database** window, click **OK**. - - The **Specify Tables and Columns** window is displayed. - -#. In the **Specify Tables and Columns** window, select the checkboxes corresponding to the tables and columns that you want to include in your SQL statement. - - :: - -#. In the **Data source name** field, set your data source name and click **OK**. - - Your data source is displayed in the **Data tables** area. - -#. In the **Add Data Tables** dialog, click **OK** to load the data from your ODBC data source into Spotfire. - -.. note:: Verify that you have checked the SQL statement. - -Creating the SQream Data Source Template -~~~~~~~~~~~ -After creating a connection, you can create your SQream data source template. - -**To create your SQream data source template:** - -1. Log in to the TIBCO Spotfire Server Configuration Tool. - - :: - -#. From the **Configuration** tab, in the **Configuration Start** menu, click **Data Source Templates**. - - The **Data Source Templates** list is displayed. - -#. From the Data Source Templates list do one of the following: - - * Override an existing template: - - 1. In the template text field, select an existing template. - - :: - - 2. Copy and paste your data source template text. - - :: - - * Create a new template: - - 1. Click **New**. - - The **Add Data Source Template** window is displayed. - - .. _creating_sqream_data_source_template: - - 2. In the **Name** field, define your template name. - - :: - - 3. In the **Data Source Template** text field, copy and paste your data source template text. - - The following is an example of a data source template: - - .. code-block:: console - - - SQream - com.sqream.jdbc.SQDriver - jdbc:Sqream://<host>:<port>/database;user=sqream;password=sqream;cluster=true - true - true - false - TABLE,EXTERNAL_TABLE - - - Bool - Integer - - - VARCHAR(2048) - String - - - INT - Integer - - - BIGINT - LongInteger - - - Real - Real - - - Decimal - Float - - - Numeric - Float - - - Date - DATE - - - DateTime - DateTime - - - - - -4. Click **Save configuration**. - - :: - -5. Close and restart your Spotfire server. - -Creating a Data Source -~~~~~~~~~~~ -After creating the SQream data source template, you can create a data source. - -**To create a data source:** - -1. Launch the TIBCO Spotfire application. - - :: - -#. From the **Tools** menu, select **Information Designer**. - - The **Information Designer** window is displayed. - - :: - -#. From the **New** menu, click **Data Source**. - - The **Data Source** tab is displayed. - - :: - -#. Provide the following information: - - * **Name** - define a unique name. - - :: - - * **Type** - use the same type template name you used while configuring your template. See **Step 3** in :ref:`Creating the SQream Data Source Template`. - - :: - - * **Connection URL** - use the standard JDBC connection string, ``:/database``. - - :: - - * **No. of connections** - define a number between **1** and **100**. SQream recommends setting your number of connections to **100**. - - :: - - * **Username and Password** - define your SQream username and password. - -Creating an Information Link -~~~~~~~~~~~ -After creating a data source, you can create an information link. - -**To create an information link**: - -1. From the **Tools** menu, select **Information Designer**. - - The **Information Designer** window is displayed. - - :: - -#. From the **New** menu, click **Information Link**. - - The **Information link** tab is displayed. - -#. From the **Elements** tab, select a column type and click **Add**. - - The column type is added to the **Elements** region as a filter. - - Note the following: - - * You can select procedures from the Elements region. - - :: - - * You can remove an element by selecting an element and clicking **Remove**. - - .. tip:: If the Elements menu is not displayed, you can display it by clicking the **Elements** tab. You can simultaneously select multiple elements by pressing **Ctrl** and making additional selections, and select a range of elements by holding **Shift** and clicking two elements. - -#. If the elements you select originate from more than one data source table, specify a **Join path**. - -5. *Optional* - In the **Description** region, type the description of the information link. - - :: - -#. *Optional* - To filter your data, expand the **Filters** section and do the following: - - 1. From the **Information Link** region, select the element you added in Step 3 above. - - :: - - 2. Click **Add**. - - The **Add Column** window is displayed. - - 3. From the drop-down list, select a column to add a hard filter to and click **OK**. - - The selected column is added to the Filters list. - - 4. Repeat steps 2 and 3 to add filters to additional columns. - - :: - - 5. For each column, from the **Filter Type** drop-down list, select **range** or **values**. - - .. note:: Filtering by range means entering the upper and lower limits of the desired range. Filtering by values means entering the exact values that you want to include in the returned data, separated by semicolon. - - 6. In the **Values** field type the desired values separated with semicolons, or set the upper and lower limits in the **Min Value** and **Max Value** fields. Alternatively, you can type ``?param_name`` in the Values field to use a parameter as the filter for the selected column, where ``param_name`` is the name used to identify the parameter. - - .. note:: Because limits are inclusive, setting the lower limit to **1000** includes the value **1000** in the data table. - - .. note:: When setting upper and lower limits on **String** type columns, ``A`` precedes ``AA``, and a lone letter precedes words beginning with that latter. For example, ``S** precedes **Smith**, indicating that the name ``Smith`` will not be present when you select names from ``D`` to ``S``. The order of characters is standard ASCII. - - For more information on adding filters, see `Adding Hard Filters `_. - -7. *Optional* - To add runtime filtering prompts, expand the **Prompts** section and do the following: - - 1. Click **Add**. - - The **Add Column** window is displayed. - - #. From the **Select column** list, select a column to add a prompt to and click **OK**. - - The selected column is added to the Prompts list. - - #. Repeat **Step 1** to add prompts to additional columns. - - :: - - #. Do the following for each column: - - * Make a selection from the **Prompt Type** drop-down list. - * Select or clear **Mandatory**. - * *Optional* - Set your **Max Selections**. - - For more information on adding prompts, see `Adding Prompts `_. - -8. *Optional* - Expand the **Conditioning** section and specify one of the following conditions: - - * None - * Distinct - * Pivot - - Note that you can edit the Pivot conditioning by selecting **Pivot** and clicking **Edit**. - -9. *Optional* - Expand the **Parameters** section and define your parameters. - - :: - -10. *Optional* - Expand the **Properties** section and define your properties. - - :: - -11. *Optional* - Expand the **Caching** section and enable or disable whether your information link can be cached. - - :: - -12. Click **Save**. - - The **Save As** window is displayed. - -13. In the tree, select where you want to save the information link. - - :: - -14. In the **Name** field, type a name and description for the information link. - - :: - - -15. Click **Save**. - - The new information link is added to the library and can be accessed by other users. - -.. tip:: You can test the information link directly by clicking **Open Data**. You can also view and edit the SQL belonging to the information link by clicking **SQL**. - -For more information on the Information Link attributes, see `Information Link Tab `_. - -Troubleshooting -------------- -The **Troubleshooting** section describes the following scenarios: - -.. contents:: - :local: - :depth: 1 - -The JDBC Driver does not Support Boolean, Decimal, or Numeric Types -~~~~~~~~~~~ -When attempting to load data, the the Boolean, Decimal, or Numeric column types are not supported and generate the following error: - -.. code-block:: console - - Failed to execute query: Unsupported JDBC data type in query result: Bool (HRESULT: 80131500) - -The error above is resolved by casting the columns as follows: - -* ``Bool`` columns to ``INT``. -* ``Decimal`` and ``Numeric`` columns to ``REAL``. - -For more information, see the following: - -* **Resolving this error** - `Details on Change Data Types `_. - -* **Supported data types** - :ref:`Data Types`. - -Information Services do not Support Live Queries -~~~~~~~~~~~ -TIBCO Spotfire data connectors support live queries, but no APIs currently exist for creating custom data connectors. This is resolved by creating a customized SQream adapter using TIBCO's **Data Virtualization (TDV)** or the **Spotfire Advanced Services (ADS)**. These can be used from the built-in TDV connector to enable live queries. - -This resolution applies to JDBC and ODBC drivers. diff --git a/third_party_tools/index.rst b/third_party_tools/index.rst index 1052f9f27..ee581e337 100644 --- a/third_party_tools/index.rst +++ b/third_party_tools/index.rst @@ -12,7 +12,6 @@ This section provides information about the following third party tools: :glob: :titlesonly: - client_platforms/index client_drivers/index If you need a tool that SQream does not support, contact SQream Support or your SQream account manager for more information. \ No newline at end of file diff --git a/troubleshooting/index.rst b/troubleshooting/index.rst index efbcdd412..985008e09 100644 --- a/troubleshooting/index.rst +++ b/troubleshooting/index.rst @@ -15,11 +15,6 @@ The **Troubleshooting** page describes solutions to the following issues: examining_logs identifying_configuration_issues lock_related_issues - sas_viya_related_issues - tableau_related_issues - solving_code_126_odbc_errors log_related_issues - node_js_related_issues core_dumping_related_issues - sqream_sql_installation_related_issues information_for_support \ No newline at end of file diff --git a/troubleshooting/node_js_related_issues.rst b/troubleshooting/node_js_related_issues.rst deleted file mode 100644 index b3b95b2ed..000000000 --- a/troubleshooting/node_js_related_issues.rst +++ /dev/null @@ -1,54 +0,0 @@ -.. _node_js_related_issues: - -*********************** -Node.js Related Issues -*********************** -The **Node.js Related Issues** page describes how to resolve the following common issues: - -.. toctree:: - :maxdepth: 2 - :glob: - :titlesonly: - -Preventing Heap Out of Memory Errors --------------------------------------------- - -Some workloads may cause Node.JS to fail with the error: - -.. code-block:: none - - FATAL ERROR: CALL_AND_RETRY_LAST Allocation failed - JavaScript heap out of memory - -To prevent this error, modify the heap size configuration by setting the ``--max-old-space-size`` run flag. - -For example, set the space size to 2GB: - -.. code-block:: console - - $ node --max-old-space-size=2048 my-application.js - -Providing Support for BIGINT Data Type ------------------------- - -The Node.JS connector supports fetching ``BIGINT`` values from SQream DB. However, some applications may encounter an error when trying to serialize those values. - -The error that appears is: -.. code-block:: none - - TypeError: Do not know how to serialize a BigInt - -This is because JSON specification do not support BIGINT values, even when supported by Javascript engines. - -To resolve this issue, objects with BIGINT values should be converted to string before serializing, and converted back after deserializing. - -For example: - -.. code-block:: javascript - - const rows = [{test: 1n}] - const json = JSON.stringify(rows, , (key, value) => - typeof value === 'bigint' - ? value.toString() - : value // return everything else unchanged - )); - console.log(json); // [{"test": "1"}] \ No newline at end of file diff --git a/troubleshooting/sas_viya_related_issues.rst b/troubleshooting/sas_viya_related_issues.rst deleted file mode 100644 index 6661dec95..000000000 --- a/troubleshooting/sas_viya_related_issues.rst +++ /dev/null @@ -1,55 +0,0 @@ -.. _sas_viya_related_issues: - -*********************** -SAS Viya Related Issues -*********************** - -This section describes the following best practices and troubleshooting procedures when connecting to SQream using SAS Viya: - -.. contents:: - :local: - -Inserting Only Required Data ------- -When using Tableau, SQream recommends using only data that you need, as described below: - -* Insert only the data sources you need into SAS Viya, excluding tables that don’t require analysis. - - :: - - -* To increase query performance, add filters before analyzing. Every modification you make while analyzing data queries the SQream database, sometimes several times. Adding filters to the datasource before exploring limits the amount of data analyze and increases query performance. - - -Creating a Separate Service for SAS Viya ------- -SQream recommends creating a separate service for SAS Viya with the DWLM. This reduces the impact that Tableau has on other applications and processes, such as ETL. In addition, this works in conjunction with the load balancer to ensure good performance. - -Locating the SQream JDBC Driver ------- -In some cases, SAS Viya cannot locate the SQream JDBC driver, generating the following error message: - -.. code-block:: text - - java.lang.ClassNotFoundException: com.sqream.jdbc.SQDriver - -**To locate the SQream JDBC driver:** - -1. Verify that you have placed the JDBC driver in a directory that SAS Viya can access. - - :: - - -2. Verify that the classpath in your SAS program is correct, and that SAS Viya can access the file that it references. - - :: - - -3. Restart SAS Viya. - -For more troubleshooting assistance, see the `SQream Support Portal `_. - - -Supporting TEXT ------- -In SAS Viya versions lower than 4.0, casting ``TEXT`` to ``CHAR`` changes the size to 1,024, such as when creating a table including a ``TEXT`` column. This is resolved by casting ``TEXT`` into ``CHAR`` when using the JDBC driver. diff --git a/troubleshooting/solving_code_126_odbc_errors.rst b/troubleshooting/solving_code_126_odbc_errors.rst deleted file mode 100644 index 2e652b113..000000000 --- a/troubleshooting/solving_code_126_odbc_errors.rst +++ /dev/null @@ -1,14 +0,0 @@ -.. _solving_code_126_odbc_errors: - -*********************** -Solving "Code 126" ODBC Errors -*********************** -After installing the ODBC driver, you may experience the following error: - -.. code-block:: none - - The setup routines for the SQreamDriver64 ODBC driver could not be loaded due to system error - code 126: The specified module could not be found. - (c:\Program Files\SQream Technologies\ODBC Driver\sqreamOdbc64.dll) - -This is an issue with the Visual Studio Redistributable packages. Verify you've correctly installed them, as described in the :ref:`Visual Studio 2015 Redistributables ` section above. diff --git a/troubleshooting/sqream_sql_installation_related_issues.rst b/troubleshooting/sqream_sql_installation_related_issues.rst deleted file mode 100644 index 8225a2f18..000000000 --- a/troubleshooting/sqream_sql_installation_related_issues.rst +++ /dev/null @@ -1,33 +0,0 @@ -.. _sqream_sql_installation_related_issues: - -*********************** -SQream SQL Installation Related Issues -*********************** - -The **SQream SQL Installation Related Issues** page describes how to resolve SQream SQL installation related issues. - -Upon running sqream sql for the first time, you may get an error ``error while loading shared libraries: libtinfo.so.5: cannot open shared object file: No such file or directory``. - -Solving this error requires installing the ncruses or libtinfo libraries, depending on your operating system. - -* Ubuntu: - - #. Install ``libtinfo``: - - ``$ sudo apt-get install -y libtinfo`` - #. Depending on your Ubuntu version, you may need to create a symbolic link to the newer libtinfo that was installed. - - For example, if ``libtinfo`` was installed as ``/lib/x86_64-linux-gnu/libtinfo.so.6.2``: - - ``$ sudo ln -s /lib/x86_64-linux-gnu/libtinfo.so.6.2 /lib/x86_64-linux-gnu/libtinfo.so.5`` - -* CentOS / RHEL: - - #. Install ``ncurses``: - - ``$ sudo yum install -y ncurses-libs`` - #. Depending on your RHEL version, you may need to create a symbolic link to the newer libtinfo that was installed. - - For example, if ``libtinfo`` was installed as ``/usr/lib64/libtinfo.so.6``: - - ``$ sudo ln -s /usr/lib64/libtinfo.so.6 /usr/lib64/libtinfo.so.5`` \ No newline at end of file diff --git a/troubleshooting/tableau_related_issues.rst b/troubleshooting/tableau_related_issues.rst deleted file mode 100644 index 99b4a04dd..000000000 --- a/troubleshooting/tableau_related_issues.rst +++ /dev/null @@ -1,73 +0,0 @@ -.. _tableau_related_issues: - -*********************** -Tableau Related Issues -*********************** -This section describes the following best practices and troubleshooting procedures when connecting to Tableau: - -.. contents:: - :local: - -Inserting Only Required Data -~~~~~~~~~~~~~~~~~~ -When using Tableau, SQream recommends using only data that you need, as described below: - -* Insert only the data sources you need into Tableau, excluding tables that don't require analysis. - - :: - -* To increase query performance, add filters before analyzing. Every modification you make while analyzing data queries the SQream database, sometimes several times. Adding filters to the datasource before exploring limits the amount of data analyze and increases query performance. - -Using Tableau's Table Query Syntax -~~~~~~~~~~~~~~~~~~~ -Dragging your desired tables into the main area in Tableau builds queries based on its own syntax. This helps ensure increased performance, while using views or custom SQL may degrade performance. In addition, SQream recommends using the :ref:`create_view` to create pre-optimized views, which your datasources point to. - -Creating a Separate Service for Tableau -~~~~~~~~~~~~~~~~~~~ -SQream recommends creating a separate service for Tableau with the DWLM. This reduces the impact that Tableau has on other applications and processes, such as ETL. In addition, this works in conjunction with the load balancer to ensure good performance. - -Error Saving Large Quantities of Data as Files -~~~~~~~~~~~~~~~~~~~ -An **FAB9A2C5** error can when saving large quantities of data as files. If you receive this error when writing a connection string, add the ``fetchSize`` parameter to ``1``, as shown below: - -.. code-block:: text - - jdbc:Sqream:///;user=;password=sqream;[; fetchSize=1...] - -For more information on troubleshooting error **FAB9A2C5**, see the `Tableau Knowledge Base `_. - -Troubleshooting Workbook Performance Before Deploying to the Tableau Server -~~~~~~~~~~~~~~~~~~~ -Tableau has a built-in `performance recorder `_ that shows how time is being spent. If you're seeing slow performance, this could be the result of a misconfiguration such as setting concurrency too low. - -Use the Tableau Performance Recorder for viewing the performance of queries run by Tableau. You can use this information to identify queries that can be optimized by using views. - -Troubleshooting Error Codes -~~~~~~~~~~~~~~~~~~~ -Tableau may be unable to locate the SQream JDBC driver. The following message is displayed when Tableau cannot locate the driver: - -.. code-block:: console - - Error Code: 37CE01A3, No suitable driver installed or the URL is incorrect - -**To troubleshoot error codes:** - -If Tableau cannot locate the SQream JDBC driver, do the following: - - 1. Verify that the JDBC driver is located in the correct directory: - - * **Tableau Desktop on Windows:** *C:\Program Files\Tableau\Drivers* - * **Tableau Desktop on MacOS:** *~/Library/Tableau/Drivers* - * **Tableau on Linux**: */opt/tableau/tableau_driver/jdbc* - - 2. Find the file path for the JDBC driver and add it to the Java classpath: - - * **For Linux** - ``export CLASSPATH=;$CLASSPATH`` - - :: - - * **For Windows** - add an environment variable for the classpath: - - - -If you experience issues after restarting Tableau, see the `SQream support portal `_. From 16da90b13dbdcf6e9eaeeacdbd1ba4aa9e290435 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 29 Mar 2022 17:05:38 +0300 Subject: [PATCH 032/882] Update sqream_studio_installation.rst --- installation_guides/sqream_studio_installation.rst | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/installation_guides/sqream_studio_installation.rst b/installation_guides/sqream_studio_installation.rst index 8d6c16546..8646a35ad 100644 --- a/installation_guides/sqream_studio_installation.rst +++ b/installation_guides/sqream_studio_installation.rst @@ -9,11 +9,7 @@ The **Installing SQream Studio** page incudes the following installation guides: :maxdepth: 1 :glob: - installing_studio_on_stand_alone_server installing_prometheus_exporters installing_prometheus_using_binary_packages installing_dashboard_data_collector - - - - + installing_studio_on_stand_alone_server \ No newline at end of file From 4e1393f438ac26520f98726880f4c54bf28dcbf7 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 29 Mar 2022 18:29:02 +0300 Subject: [PATCH 033/882] Replaced VARCHAR with TEXT Replaced *most* instances of VARCHAR with TEXT. I didn't replace all of them because I had some open questions for Shachar (about 20). I am going to merge this now into branch 2020-1 to test if it worked, and will merge it again after updating it in light of Shachar's comments. I will then merge it on the remaining branches. --- data_ingestion/csv.rst | 10 +++---- data_ingestion/inserting_data.rst | 2 +- data_ingestion/orc.rst | 16 ++++++------ data_ingestion/parquet.rst | 14 +++++----- data_type_guides/sql_data_types_string.rst | 2 +- feature_guides/compression.rst | 10 +++---- ...flexible_data_clustering_data_examples.rst | 4 +-- .../performing_basic_sqream_operations.rst | 1 + getting_started/querying_data.rst | 10 +++---- operational_guides/external_tables.rst | 10 +++---- operational_guides/logging.rst | 4 +-- .../optimization_best_practices.rst | 26 ++----------------- operational_guides/s3.rst | 10 +++---- reference/cli/sqream_sql.rst | 4 +-- .../sql_functions/aggregate_functions/avg.rst | 10 +++---- .../aggregate_functions/corr.rst | 10 +++---- .../aggregate_functions/count.rst | 10 +++---- .../aggregate_functions/covar_pop.rst | 10 +++---- .../aggregate_functions/covar_samp.rst | 10 +++---- .../sql_functions/aggregate_functions/max.rst | 10 +++---- .../sql_functions/aggregate_functions/min.rst | 10 +++---- .../aggregate_functions/stddev_pop.rst | 10 +++---- .../aggregate_functions/stddev_samp.rst | 10 +++---- .../sql_functions/aggregate_functions/sum.rst | 10 +++---- .../aggregate_functions/var_pop.rst | 10 +++---- .../aggregate_functions/var_samp.rst | 10 +++---- .../date_and_time/dateadd.rst | 2 +- .../date_and_time/datediff.rst | 2 +- .../date_and_time/datepart.rst | 2 +- .../scalar_functions/date_and_time/trunc.rst | 2 +- .../scalar_functions/numeric/crc64.rst | 5 ++-- .../scalar_functions/string/concat.rst | 17 ++++++------ .../scalar_functions/string/len.rst | 2 +- .../scalar_functions/string/like.rst | 10 +++---- .../scalar_functions/string/regexp_count.rst | 10 +++---- .../scalar_functions/string/regexp_instr.rst | 10 +++---- .../scalar_functions/string/regexp_substr.rst | 10 +++---- .../scalar_functions/string/rlike.rst | 10 +++---- .../scalar_functions/string/substring.rst | 10 +++---- .../window_functions/first_value.rst | 2 +- .../sql_functions/window_functions/lag.rst | 10 +++---- .../sql_functions/window_functions/lead.rst | 10 +++---- .../window_functions/nth_value.rst | 4 +-- .../sql_functions/window_functions/rank.rst | 10 +++---- .../window_functions/row_number.rst | 10 +++---- .../ddl_commands/create_external_table.rst | 6 ++--- .../ddl_commands/create_foreign_table.rst | 6 ++--- .../sql_statements/dml_commands/select.rst | 10 +++---- .../utility_commands/execute_saved_query.rst | 15 +++++------ .../utility_commands/get_ddl.rst | 4 +-- .../utility_commands/save_query.rst | 13 +++++----- reference/sql/sql_syntax/literals.rst | 1 - reference/sql/sql_syntax/subqueries.rst | 10 +++---- reference/sql/sql_syntax/window_functions.rst | 10 +++---- troubleshooting/log_related_issues.rst | 4 +-- 55 files changed, 217 insertions(+), 243 deletions(-) diff --git a/data_ingestion/csv.rst b/data_ingestion/csv.rst index f44c3c9e9..47c6d94a1 100644 --- a/data_ingestion/csv.rst +++ b/data_ingestion/csv.rst @@ -83,14 +83,14 @@ We will make note of the file structure to create a matching ``CREATE TABLE`` st CREATE TABLE nba ( - Name varchar(40), - Team varchar(40), + Name text(40), + Team text(40), Number tinyint, - Position varchar(2), + Position text(2), Age tinyint, - Height varchar(4), + Height text(4), Weight real, - College varchar(40), + College text(40), Salary float ); diff --git a/data_ingestion/inserting_data.rst b/data_ingestion/inserting_data.rst index 660cd61bd..86bd08103 100644 --- a/data_ingestion/inserting_data.rst +++ b/data_ingestion/inserting_data.rst @@ -98,7 +98,7 @@ Unsupported Data Types SQream DB doesn't support the entire set of features that some other database systems may have, such as ``ARRAY``, ``BLOB``, ``ENUM``, ``SET``, etc. -These data types will have to be converted before load. For example, ``ENUM`` can often be stored as a ``VARCHAR``. +These data types will have to be converted before load. For example, ``ENUM`` can often be stored as a ``TEXT``. Handing Extended Errors ---------------------------- diff --git a/data_ingestion/orc.rst b/data_ingestion/orc.rst index d199e958e..de10c5ce4 100644 --- a/data_ingestion/orc.rst +++ b/data_ingestion/orc.rst @@ -186,14 +186,14 @@ We will make note of the file structure to create a matching ``CREATE FOREIGN TA CREATE FOREIGN TABLE ext_nba ( - Name VARCHAR(40), - Team VARCHAR(40), + Name TEXT(40), + Team TEXT(40), Number BIGINT, - Position VARCHAR(2), + Position TEXT(2), Age BIGINT, - Height VARCHAR(4), + Height TEXT(4), Weight BIGINT, - College VARCHAR(40), + College TEXT(40), Salary FLOAT ) WRAPPER orc_fdw @@ -288,7 +288,7 @@ Loading a table from a directory of ORC files on HDFS .. code-block:: postgres CREATE FOREIGN TABLE ext_users - (id INT NOT NULL, name VARCHAR(30) NOT NULL, email VARCHAR(50) NOT NULL) + (id INT NOT NULL, name TEXT(30) NOT NULL, email VARCHAR(50) NOT NULL) WRAPPER orc_fdw OPTIONS ( @@ -303,7 +303,7 @@ Loading a table from a bucket of files on S3 .. code-block:: postgres CREATE FOREIGN TABLE ext_users - (id INT NOT NULL, name VARCHAR(30) NOT NULL, email VARCHAR(50) NOT NULL) + (id INT NOT NULL, name TEXT(30) NOT NULL, email VARCHAR(50) NOT NULL) WRAPPER orc_fdw OPTIONS ( LOCATION = 's3://pp-secret-bucket/users/*.ORC', @@ -312,4 +312,4 @@ Loading a table from a bucket of files on S3 ) ; - CREATE TABLE users AS SELECT * FROM ext_users; + CREATE TABLE users AS SELECT * FROM ext_users; \ No newline at end of file diff --git a/data_ingestion/parquet.rst b/data_ingestion/parquet.rst index 800c3122a..4579deb82 100644 --- a/data_ingestion/parquet.rst +++ b/data_ingestion/parquet.rst @@ -167,14 +167,14 @@ We will make note of the file structure to create a matching ``CREATE EXTERNAL T CREATE FOREIGN TABLE ext_nba ( - Name VARCHAR(40), - Team VARCHAR(40), + Name TEXT(40), + Team TEXT(40), Number BIGINT, - Position VARCHAR(2), + Position TEXT(2), Age BIGINT, - Height VARCHAR(4), + Height TEXT(4), Weight BIGINT, - College VARCHAR(40), + College TEXT(40), Salary FLOAT ) WRAPPER parquet_fdw @@ -269,7 +269,7 @@ Loading a table from a directory of Parquet files on HDFS .. code-block:: postgres CREATE FOREIGN TABLE ext_users - (id INT NOT NULL, name VARCHAR(30) NOT NULL, email VARCHAR(50) NOT NULL) + (id INT NOT NULL, name TEXT(30) NOT NULL, email TEXT(50) NOT NULL) WRAPPER parquet_fdw OPTIONS ( @@ -284,7 +284,7 @@ Loading a table from a bucket of files on S3 .. code-block:: postgres CREATE FOREIGN TABLE ext_users - (id INT NOT NULL, name VARCHAR(30) NOT NULL, email VARCHAR(50) NOT NULL) + (id INT NOT NULL, name TEXT(30) NOT NULL, email TEXT(50) NOT NULL) WRAPPER parquet_fdw OPTIONS ( LOCATION = 's3://pp-secret-bucket/users/*.parquet', diff --git a/data_type_guides/sql_data_types_string.rst b/data_type_guides/sql_data_types_string.rst index beb970b8d..0d977b6d2 100644 --- a/data_type_guides/sql_data_types_string.rst +++ b/data_type_guides/sql_data_types_string.rst @@ -3,7 +3,7 @@ ************************* String ************************* -``TEXT`` and ``VARCHAR`` are types designed for storing text or strings of characters. +``TEXT`` is designed for storing text or strings of characters. SQream separates ASCII (``VARCHAR``) and UTF-8 representations (``TEXT``). diff --git a/feature_guides/compression.rst b/feature_guides/compression.rst index 710641036..96c051ff4 100644 --- a/feature_guides/compression.rst +++ b/feature_guides/compression.rst @@ -108,7 +108,7 @@ The following two are equivalent: CREATE TABLE t ( x INT, - y VARCHAR(50) + y TEXT(50) ); In this version, the default compression is specified explicitly: @@ -117,7 +117,7 @@ In this version, the default compression is specified explicitly: CREATE TABLE t ( x INT CHECK('CS "default"'), - y VARCHAR(50) CHECK('CS "default"') + y TEXT(50) CHECK('CS "default"') ); Forcing no compression (flat) @@ -130,7 +130,7 @@ in order to reduce CPU or GPU resource utilization at the expense of increased I CREATE TABLE t ( x INT NOT NULL CHECK('CS "flat"'), -- This column won't be compressed - y VARCHAR(50) -- This column will still be compressed automatically + y TEXT(50) -- This column will still be compressed automatically ); @@ -146,8 +146,8 @@ For example: CREATE TABLE t ( id BIGINT NOT NULL CHECK('CS "sequence"'), - y VARCHAR(110) CHECK('CS "lz4"'), -- General purpose text compression - z VARCHAR(80) CHECK('CS "dict"'), -- Low cardinality column + y TEXT(110) CHECK('CS "lz4"'), -- General purpose text compression + z TEXT(80) CHECK('CS "dict"'), -- Low cardinality column ); diff --git a/feature_guides/flexible_data_clustering_data_examples.rst b/feature_guides/flexible_data_clustering_data_examples.rst index 0c720ff04..bf08a111a 100644 --- a/feature_guides/flexible_data_clustering_data_examples.rst +++ b/feature_guides/flexible_data_clustering_data_examples.rst @@ -16,7 +16,7 @@ The following is an example of syntax for creating a clustered table on a table .. code-block:: postgres CREATE TABLE users ( - name VARCHAR(30) NOT NULL, + name text(30) NOT NULL, start_date datetime not null, - country VARCHAR(30) DEFAULT 'Unknown' NOT NULL + country text(30) DEFAULT 'Unknown' NOT NULL ) CLUSTER BY country; \ No newline at end of file diff --git a/getting_started/performing_basic_sqream_operations.rst b/getting_started/performing_basic_sqream_operations.rst index 81ea9b05f..1b0f60ba3 100644 --- a/getting_started/performing_basic_sqream_operations.rst +++ b/getting_started/performing_basic_sqream_operations.rst @@ -12,6 +12,7 @@ After installing SQream you can perform the operations described on this page: running_the_sqream_sql_client creating_your_first_table creating_a_database + querying_data listing_tables inserting_rows running_queries diff --git a/getting_started/querying_data.rst b/getting_started/querying_data.rst index 36bf9e78b..7b6b46aed 100644 --- a/getting_started/querying_data.rst +++ b/getting_started/querying_data.rst @@ -11,14 +11,14 @@ To begin familiarizing yourself with querying data, you can create the following CREATE TABLE nba ( - Name varchar(40), - Team varchar(40), + Name text(40), + Team text(40), Number tinyint, - Position varchar(2), + Position text(2), Age tinyint, - Height varchar(4), + Height text(4), Weight real, - College varchar(40), + College text(40), Salary float ); diff --git a/operational_guides/external_tables.rst b/operational_guides/external_tables.rst index 005dc961f..6ee2f67a0 100644 --- a/operational_guides/external_tables.rst +++ b/operational_guides/external_tables.rst @@ -52,14 +52,14 @@ Based on the source file structure, we we :ref:`create an external table create table animals(id int not null, name varchar(30) not null, is_angry bool not null); + farm=> create table animals(id int not null, name text(30) not null, is_angry bool not null); executed time: 0.011940s @@ -303,7 +303,7 @@ Assuming a file containing SQL statements (separated by semicolons): $ cat some_queries.sql CREATE TABLE calm_farm_animals - ( id INT IDENTITY(0, 1), name VARCHAR(30) + ( id INT IDENTITY(0, 1), name TEXT(30) ); INSERT INTO calm_farm_animals (name) diff --git a/reference/sql/sql_functions/aggregate_functions/avg.rst b/reference/sql/sql_functions/aggregate_functions/avg.rst index be0294d46..4768061c8 100644 --- a/reference/sql/sql_functions/aggregate_functions/avg.rst +++ b/reference/sql/sql_functions/aggregate_functions/avg.rst @@ -62,14 +62,14 @@ For these examples, assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - "Name" varchar(40), - "Team" varchar(40), + "Name" text(40), + "Team" text(40), "Number" tinyint, - "Position" varchar(2), + "Position" text(2), "Age" tinyint, - "Height" varchar(4), + "Height" text(4), "Weight" real, - "College" varchar(40), + "College" text(40), "Salary" float ); diff --git a/reference/sql/sql_functions/aggregate_functions/corr.rst b/reference/sql/sql_functions/aggregate_functions/corr.rst index 212ab89d2..5963c835f 100644 --- a/reference/sql/sql_functions/aggregate_functions/corr.rst +++ b/reference/sql/sql_functions/aggregate_functions/corr.rst @@ -51,14 +51,14 @@ For these examples, assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - "Name" varchar(40), - "Team" varchar(40), + "Name" text(40), + "Team" text(40), "Number" tinyint, - "Position" varchar(2), + "Position" text(2), "Age" tinyint, - "Height" varchar(4), + "Height" text(4), "Weight" real, - "College" varchar(40), + "College" text(40), "Salary" float ); diff --git a/reference/sql/sql_functions/aggregate_functions/count.rst b/reference/sql/sql_functions/aggregate_functions/count.rst index 803e529c0..133d658f4 100644 --- a/reference/sql/sql_functions/aggregate_functions/count.rst +++ b/reference/sql/sql_functions/aggregate_functions/count.rst @@ -67,14 +67,14 @@ The examples in this section are based on a table named ``nba``, structured as f CREATE TABLE nba ( - "Name" varchar(40), - "Team" varchar(40), + "Name" text(40), + "Team" text(40), "Number" tinyint, - "Position" varchar(2), + "Position" text(2), "Age" tinyint, - "Height" varchar(4), + "Height" text(4), "Weight" real, - "College" varchar(40), + "College" text(40), "Salary" float ); diff --git a/reference/sql/sql_functions/aggregate_functions/covar_pop.rst b/reference/sql/sql_functions/aggregate_functions/covar_pop.rst index c0d7cd35d..24300b5d7 100644 --- a/reference/sql/sql_functions/aggregate_functions/covar_pop.rst +++ b/reference/sql/sql_functions/aggregate_functions/covar_pop.rst @@ -55,14 +55,14 @@ For these examples, assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - "Name" varchar(40), - "Team" varchar(40), + "Name" text(40), + "Team" text(40), "Number" tinyint, - "Position" varchar(2), + "Position" text(2), "Age" tinyint, - "Height" varchar(4), + "Height" text(4), "Weight" real, - "College" varchar(40), + "College" text(40), "Salary" float ); diff --git a/reference/sql/sql_functions/aggregate_functions/covar_samp.rst b/reference/sql/sql_functions/aggregate_functions/covar_samp.rst index 29d7b7493..2c8451023 100644 --- a/reference/sql/sql_functions/aggregate_functions/covar_samp.rst +++ b/reference/sql/sql_functions/aggregate_functions/covar_samp.rst @@ -56,14 +56,14 @@ For these examples, assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - "Name" varchar(40), - "Team" varchar(40), + "Name" text(40), + "Team" text(40), "Number" tinyint, - "Position" varchar(2), + "Position" text(2), "Age" tinyint, - "Height" varchar(4), + "Height" text(4), "Weight" real, - "College" varchar(40), + "College" text(40), "Salary" float ); diff --git a/reference/sql/sql_functions/aggregate_functions/max.rst b/reference/sql/sql_functions/aggregate_functions/max.rst index 529e2230d..994a3aaca 100644 --- a/reference/sql/sql_functions/aggregate_functions/max.rst +++ b/reference/sql/sql_functions/aggregate_functions/max.rst @@ -53,14 +53,14 @@ For these examples, assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - "Name" varchar(40), - "Team" varchar(40), + "Name" text(40), + "Team" text(40), "Number" tinyint, - "Position" varchar(2), + "Position" text(2), "Age" tinyint, - "Height" varchar(4), + "Height" text(4), "Weight" real, - "College" varchar(40), + "College" text(40), "Salary" float ); diff --git a/reference/sql/sql_functions/aggregate_functions/min.rst b/reference/sql/sql_functions/aggregate_functions/min.rst index d488d87fc..dd4d39177 100644 --- a/reference/sql/sql_functions/aggregate_functions/min.rst +++ b/reference/sql/sql_functions/aggregate_functions/min.rst @@ -53,14 +53,14 @@ For these examples, assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - "Name" varchar(40), - "Team" varchar(40), + "Name" text(40), + "Team" text(40), "Number" tinyint, - "Position" varchar(2), + "Position" text(2), "Age" tinyint, - "Height" varchar(4), + "Height" text(4), "Weight" real, - "College" varchar(40), + "College" text(40), "Salary" float ); diff --git a/reference/sql/sql_functions/aggregate_functions/stddev_pop.rst b/reference/sql/sql_functions/aggregate_functions/stddev_pop.rst index 5a8a7e677..8687c0e76 100644 --- a/reference/sql/sql_functions/aggregate_functions/stddev_pop.rst +++ b/reference/sql/sql_functions/aggregate_functions/stddev_pop.rst @@ -58,14 +58,14 @@ For these examples, assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - "Name" varchar(40), - "Team" varchar(40), + "Name" text(40), + "Team" text(40), "Number" tinyint, - "Position" varchar(2), + "Position" text(2), "Age" tinyint, - "Height" varchar(4), + "Height" text(4), "Weight" real, - "College" varchar(40), + "College" text(40), "Salary" float ); diff --git a/reference/sql/sql_functions/aggregate_functions/stddev_samp.rst b/reference/sql/sql_functions/aggregate_functions/stddev_samp.rst index 0328e2241..81c7a1f51 100644 --- a/reference/sql/sql_functions/aggregate_functions/stddev_samp.rst +++ b/reference/sql/sql_functions/aggregate_functions/stddev_samp.rst @@ -62,14 +62,14 @@ For these examples, assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - "Name" varchar(40), - "Team" varchar(40), + "Name" text(40), + "Team" text(40), "Number" tinyint, - "Position" varchar(2), + "Position" text(2), "Age" tinyint, - "Height" varchar(4), + "Height" text(4), "Weight" real, - "College" varchar(40), + "College" text(40), "Salary" float ); diff --git a/reference/sql/sql_functions/aggregate_functions/sum.rst b/reference/sql/sql_functions/aggregate_functions/sum.rst index e8f648894..51d7f6d97 100644 --- a/reference/sql/sql_functions/aggregate_functions/sum.rst +++ b/reference/sql/sql_functions/aggregate_functions/sum.rst @@ -65,14 +65,14 @@ For these examples, assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - "Name" varchar(40), - "Team" varchar(40), + "Name" text(40), + "Team" text(40), "Number" tinyint, - "Position" varchar(2), + "Position" text(2), "Age" tinyint, - "Height" varchar(4), + "Height" text(4), "Weight" real, - "College" varchar(40), + "College" text(40), "Salary" float ); diff --git a/reference/sql/sql_functions/aggregate_functions/var_pop.rst b/reference/sql/sql_functions/aggregate_functions/var_pop.rst index 4ddf45a1e..de078a3ae 100644 --- a/reference/sql/sql_functions/aggregate_functions/var_pop.rst +++ b/reference/sql/sql_functions/aggregate_functions/var_pop.rst @@ -58,14 +58,14 @@ For these examples, assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - "Name" varchar(40), - "Team" varchar(40), + "Name" text(40), + "Team" text(40), "Number" tinyint, - "Position" varchar(2), + "Position" text(2), "Age" tinyint, - "Height" varchar(4), + "Height" text(4), "Weight" real, - "College" varchar(40), + "College" text(40), "Salary" float ); diff --git a/reference/sql/sql_functions/aggregate_functions/var_samp.rst b/reference/sql/sql_functions/aggregate_functions/var_samp.rst index 6f0c91e63..cc9721225 100644 --- a/reference/sql/sql_functions/aggregate_functions/var_samp.rst +++ b/reference/sql/sql_functions/aggregate_functions/var_samp.rst @@ -63,14 +63,14 @@ For these examples, assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - "Name" varchar(40), - "Team" varchar(40), + "Name" text(40), + "Team" text(40), "Number" tinyint, - "Position" varchar(2), + "Position" text(2), "Age" tinyint, - "Height" varchar(4), + "Height" text(4), "Weight" real, - "College" varchar(40), + "College" text(40), "Salary" float ); diff --git a/reference/sql/sql_functions/scalar_functions/date_and_time/dateadd.rst b/reference/sql/sql_functions/scalar_functions/date_and_time/dateadd.rst index cff5268e6..240b0bf2e 100644 --- a/reference/sql/sql_functions/scalar_functions/date_and_time/dateadd.rst +++ b/reference/sql/sql_functions/scalar_functions/date_and_time/dateadd.rst @@ -106,7 +106,7 @@ For these examples, consider the following table and contents: .. code-block:: postgres - CREATE TABLE cool_dates(name VARCHAR(40), d DATE, dt DATETIME); + CREATE TABLE cool_dates(name TEXT(40), d DATE, dt DATETIME); INSERT INTO cool_dates VALUES ('Marty McFly goes back to this time','1955-11-05','1955-11-05 01:21:00.000') , ('Marty McFly came from this time', '1985-10-26', '1985-10-26 01:22:00.000') diff --git a/reference/sql/sql_functions/scalar_functions/date_and_time/datediff.rst b/reference/sql/sql_functions/scalar_functions/date_and_time/datediff.rst index 5c91a88d9..1af8827de 100644 --- a/reference/sql/sql_functions/scalar_functions/date_and_time/datediff.rst +++ b/reference/sql/sql_functions/scalar_functions/date_and_time/datediff.rst @@ -100,7 +100,7 @@ For these examples, consider the following table and contents: .. code-block:: postgres - CREATE TABLE cool_dates(name VARCHAR(40), d DATE, dt DATETIME); + CREATE TABLE cool_dates(name TEXT(40), d DATE, dt DATETIME); INSERT INTO cool_dates VALUES ('Marty McFly goes back to this time','1955-11-05','1955-11-05 01:21:00.000') , ('Marty McFly came from this time', '1985-10-26', '1985-10-26 01:22:00.000') diff --git a/reference/sql/sql_functions/scalar_functions/date_and_time/datepart.rst b/reference/sql/sql_functions/scalar_functions/date_and_time/datepart.rst index 8a43a1472..a779663b5 100644 --- a/reference/sql/sql_functions/scalar_functions/date_and_time/datepart.rst +++ b/reference/sql/sql_functions/scalar_functions/date_and_time/datepart.rst @@ -109,7 +109,7 @@ For these examples, consider the following table and contents: .. code-block:: postgres - CREATE TABLE cool_dates(name VARCHAR(40), d DATE, dt DATETIME); + CREATE TABLE cool_dates(name TEXT(40), d DATE, dt DATETIME); INSERT INTO cool_dates VALUES ('Marty McFly goes back to this time','1955-11-05','1955-11-05 01:21:00.000') , ('Marty McFly came from this time', '1985-10-26', '1985-10-26 01:22:00.000') diff --git a/reference/sql/sql_functions/scalar_functions/date_and_time/trunc.rst b/reference/sql/sql_functions/scalar_functions/date_and_time/trunc.rst index d9d791cc3..1e888cfe5 100644 --- a/reference/sql/sql_functions/scalar_functions/date_and_time/trunc.rst +++ b/reference/sql/sql_functions/scalar_functions/date_and_time/trunc.rst @@ -104,7 +104,7 @@ For these examples, consider the following table and contents: .. code-block:: postgres - CREATE TABLE cool_dates(name VARCHAR(40), d DATE, dt DATETIME); + CREATE TABLE cool_dates(name TEXT(40), d DATE, dt DATETIME); INSERT INTO cool_dates VALUES ('Marty McFly goes back to this time','1955-11-05','1955-11-05 01:21:00.000') , ('Marty McFly came from this time', '1985-10-26', '1985-10-26 01:22:00.000') diff --git a/reference/sql/sql_functions/scalar_functions/numeric/crc64.rst b/reference/sql/sql_functions/scalar_functions/numeric/crc64.rst index 7dbd6ddf1..105dae47c 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/crc64.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/crc64.rst @@ -25,7 +25,7 @@ Arguments * - Parameter - Description * - ``expr`` - - Text expression (``VARCHAR``, ``TEXT``) + - Text expression (``TEXT``) Returns ============ @@ -54,5 +54,4 @@ Calculate a CRC-64 hash of a string . as t(x); crc64 -------------------- - -9085161068710498500 - + -9085161068710498500 \ No newline at end of file diff --git a/reference/sql/sql_functions/scalar_functions/string/concat.rst b/reference/sql/sql_functions/scalar_functions/string/concat.rst index 0409216cd..c612a9bdd 100644 --- a/reference/sql/sql_functions/scalar_functions/string/concat.rst +++ b/reference/sql/sql_functions/scalar_functions/string/concat.rst @@ -48,14 +48,14 @@ For these examples, assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - Name varchar(40), - Team varchar(40), + Name text(40), + Team text(40), Number tinyint, - Position varchar(2), + Position text(2), Age tinyint, - Height varchar(4), + Height text(4), Weight real, - College varchar(40), + College text(40), Salary float ); @@ -76,7 +76,7 @@ Convert values to string types before concatenation .. code-block:: psql - nba=> SELECT ("Age" :: VARCHAR(2)) || "Name" FROM nba ORDER BY 1 DESC LIMIT 5; + nba=> SELECT ("Age" :: TEXT(2)) || "Name" FROM nba ORDER BY 1 DESC LIMIT 5; ?column? ---------------- 40Tim Duncan @@ -116,12 +116,11 @@ Add a space and concatenate it first to bypass the space trimming issue .. code-block:: psql - nba=> SELECT ("Age" :: VARCHAR(2) || (' ' || "Name")) FROM nba ORDER BY 1 DESC LIMIT 5; + nba=> SELECT ("Age" :: TEXT(2) || (' ' || "Name")) FROM nba ORDER BY 1 DESC LIMIT 5; ?column? ----------------- 40 Tim Duncan 40 Kevin Garnett 40 Andre Miller 39 Vince Carter - 39 Pablo Prigioni - + 39 Pablo Prigioni \ No newline at end of file diff --git a/reference/sql/sql_functions/scalar_functions/string/len.rst b/reference/sql/sql_functions/scalar_functions/string/len.rst index d3cba24b2..fdd671423 100644 --- a/reference/sql/sql_functions/scalar_functions/string/len.rst +++ b/reference/sql/sql_functions/scalar_functions/string/len.rst @@ -49,7 +49,7 @@ For these examples, consider the following table and contents: .. code-block:: postgres - CREATE TABLE jabberwocky(line VARCHAR(50)); + CREATE TABLE jabberwocky(line TEXT(50)); INSERT INTO jabberwocky VALUES ($$'Twas brillig, and the slithy toves$$), (' Did gyre and gimble in the wabe:') diff --git a/reference/sql/sql_functions/scalar_functions/string/like.rst b/reference/sql/sql_functions/scalar_functions/string/like.rst index 4640ba9be..ce5ca4942 100644 --- a/reference/sql/sql_functions/scalar_functions/string/like.rst +++ b/reference/sql/sql_functions/scalar_functions/string/like.rst @@ -83,14 +83,14 @@ For these examples, assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - Name varchar(40), - Team varchar(40), + Name text(40), + Team text(40), Number tinyint, - Position varchar(2), + Position text(2), Age tinyint, - Height varchar(4), + Height text(4), Weight real, - College varchar(40), + College text(40), Salary float ); diff --git a/reference/sql/sql_functions/scalar_functions/string/regexp_count.rst b/reference/sql/sql_functions/scalar_functions/string/regexp_count.rst index 5f3bd75a0..26191eccc 100644 --- a/reference/sql/sql_functions/scalar_functions/string/regexp_count.rst +++ b/reference/sql/sql_functions/scalar_functions/string/regexp_count.rst @@ -99,14 +99,14 @@ For these examples, assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - "Name" varchar(40), - "Team" varchar(40), + "Name" text(40), + "Team" text(40), "Number" tinyint, - "Position" varchar(2), + "Position" text(2), "Age" tinyint, - "Height" varchar(4), + "Height" text(4), "Weight" real, - "College" varchar(40), + "College" text(40), "Salary" float ); diff --git a/reference/sql/sql_functions/scalar_functions/string/regexp_instr.rst b/reference/sql/sql_functions/scalar_functions/string/regexp_instr.rst index f401fdfff..d72f0af4f 100644 --- a/reference/sql/sql_functions/scalar_functions/string/regexp_instr.rst +++ b/reference/sql/sql_functions/scalar_functions/string/regexp_instr.rst @@ -104,14 +104,14 @@ For these examples, assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - "Name" varchar(40), - "Team" varchar(40), + "Name" text(40), + "Team" text(40), "Number" tinyint, - "Position" varchar(2), + "Position" text(2), "Age" tinyint, - "Height" varchar(4), + "Height" text(4), "Weight" real, - "College" varchar(40), + "College" text(40), "Salary" float ); diff --git a/reference/sql/sql_functions/scalar_functions/string/regexp_substr.rst b/reference/sql/sql_functions/scalar_functions/string/regexp_substr.rst index 1730d6ebf..36611424e 100644 --- a/reference/sql/sql_functions/scalar_functions/string/regexp_substr.rst +++ b/reference/sql/sql_functions/scalar_functions/string/regexp_substr.rst @@ -104,14 +104,14 @@ For these examples, assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - "Name" varchar(40), - "Team" varchar(40), + "Name" text(40), + "Team" text(40), "Number" tinyint, - "Position" varchar(2), + "Position" text(2), "Age" tinyint, - "Height" varchar(4), + "Height" text(4), "Weight" real, - "College" varchar(40), + "College" text(40), "Salary" float ); diff --git a/reference/sql/sql_functions/scalar_functions/string/rlike.rst b/reference/sql/sql_functions/scalar_functions/string/rlike.rst index 324a6e525..3c61cb959 100644 --- a/reference/sql/sql_functions/scalar_functions/string/rlike.rst +++ b/reference/sql/sql_functions/scalar_functions/string/rlike.rst @@ -99,14 +99,14 @@ For these examples, assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - Name varchar(40), - Team varchar(40), + Name text(40), + Team text(40), Number tinyint, - Position varchar(2), + Position text(2), Age tinyint, - Height varchar(4), + Height text(4), Weight real, - College varchar(40), + College text(40), Salary float ); diff --git a/reference/sql/sql_functions/scalar_functions/string/substring.rst b/reference/sql/sql_functions/scalar_functions/string/substring.rst index b07d951fb..6e6359167 100644 --- a/reference/sql/sql_functions/scalar_functions/string/substring.rst +++ b/reference/sql/sql_functions/scalar_functions/string/substring.rst @@ -54,14 +54,14 @@ For these examples, assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - Name varchar(40), - Team varchar(40), + Name text(40), + Team text(40), Number tinyint, - Position varchar(2), + Position text(2), Age tinyint, - Height varchar(4), + Height text(4), Weight real, - College varchar(40), + College text(40), Salary float ); diff --git a/reference/sql/sql_functions/window_functions/first_value.rst b/reference/sql/sql_functions/window_functions/first_value.rst index 07708872d..25294040c 100644 --- a/reference/sql/sql_functions/window_functions/first_value.rst +++ b/reference/sql/sql_functions/window_functions/first_value.rst @@ -21,4 +21,4 @@ None Returns --------- -Returns the value located in the selected column of the first row of a segment. +Returns the value located in the selected column of the first row of a segment. \ No newline at end of file diff --git a/reference/sql/sql_functions/window_functions/lag.rst b/reference/sql/sql_functions/window_functions/lag.rst index e93be2821..96ea55bed 100644 --- a/reference/sql/sql_functions/window_functions/lag.rst +++ b/reference/sql/sql_functions/window_functions/lag.rst @@ -59,14 +59,14 @@ For these examples, assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - "Name" varchar(40), - "Team" varchar(40), + "Name" text(40), + "Team" text(40), "Number" tinyint, - "Position" varchar(2), + "Position" text(2), "Age" tinyint, - "Height" varchar(4), + "Height" text(4), "Weight" real, - "College" varchar(40), + "College" text(40), "Salary" float ); diff --git a/reference/sql/sql_functions/window_functions/lead.rst b/reference/sql/sql_functions/window_functions/lead.rst index bc311689f..f1c52e1ec 100644 --- a/reference/sql/sql_functions/window_functions/lead.rst +++ b/reference/sql/sql_functions/window_functions/lead.rst @@ -59,14 +59,14 @@ For these examples, assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - "Name" varchar(40), - "Team" varchar(40), + "Name" text(40), + "Team" text(40), "Number" tinyint, - "Position" varchar(2), + "Position" text(2), "Age" tinyint, - "Height" varchar(4), + "Height" text(4), "Weight" real, - "College" varchar(40), + "College" text(40), "Salary" float ); diff --git a/reference/sql/sql_functions/window_functions/nth_value.rst b/reference/sql/sql_functions/window_functions/nth_value.rst index a2c1dd9a6..75e97a939 100644 --- a/reference/sql/sql_functions/window_functions/nth_value.rst +++ b/reference/sql/sql_functions/window_functions/nth_value.rst @@ -22,8 +22,8 @@ The following example shows the syntax for a table named ``superstore`` used for CREATE TABLE superstore ( - "Section" varchar(40), - "Product_Name" varchar(40), + "Section" text(40), + "Product_Name" text(40), "Sales_In_K" int, ); diff --git a/reference/sql/sql_functions/window_functions/rank.rst b/reference/sql/sql_functions/window_functions/rank.rst index 28856bd04..7699fd399 100644 --- a/reference/sql/sql_functions/window_functions/rank.rst +++ b/reference/sql/sql_functions/window_functions/rank.rst @@ -48,14 +48,14 @@ For these examples, assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - "Name" varchar(40), - "Team" varchar(40), + "Name" text(40), + "Team" text(40), "Number" tinyint, - "Position" varchar(2), + "Position" text(2), "Age" tinyint, - "Height" varchar(4), + "Height" text(4), "Weight" real, - "College" varchar(40), + "College" text(40), "Salary" float ); diff --git a/reference/sql/sql_functions/window_functions/row_number.rst b/reference/sql/sql_functions/window_functions/row_number.rst index ea5786aef..cfcc14b7b 100644 --- a/reference/sql/sql_functions/window_functions/row_number.rst +++ b/reference/sql/sql_functions/window_functions/row_number.rst @@ -48,14 +48,14 @@ For these examples, assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - "Name" varchar(40), - "Team" varchar(40), + "Name" text(40), + "Team" text(40), "Number" tinyint, - "Position" varchar(2), + "Position" text(2), "Age" tinyint, - "Height" varchar(4), + "Height" text(4), "Weight" real, - "College" varchar(40), + "College" text(40), "Salary" float ); diff --git a/reference/sql/sql_statements/ddl_commands/create_external_table.rst b/reference/sql/sql_statements/ddl_commands/create_external_table.rst index fc05ca71e..4e2a3d952 100644 --- a/reference/sql/sql_statements/ddl_commands/create_external_table.rst +++ b/reference/sql/sql_statements/ddl_commands/create_external_table.rst @@ -113,7 +113,7 @@ A simple table from Tab-delimited file (TSV) .. code-block:: postgres CREATE OR REPLACE EXTERNAL TABLE cool_animals - (id INT NOT NULL, name VARCHAR(30) NOT NULL, weight FLOAT NOT NULL) + (id INT NOT NULL, name text(30) NOT NULL, weight FLOAT NOT NULL) USING FORMAT csv WITH PATH '/home/rhendricks/cool_animals.csv' FIELD DELIMITER '\t'; @@ -125,7 +125,7 @@ A table from a directory of Parquet files on HDFS .. code-block:: postgres CREATE EXTERNAL TABLE users - (id INT NOT NULL, name VARCHAR(30) NOT NULL, email VARCHAR(50) NOT NULL) + (id INT NOT NULL, name text(30) NOT NULL, email text(50) NOT NULL) USING FORMAT Parquet WITH PATH 'hdfs://hadoop-nn.piedpiper.com/rhendricks/users/*.parquet'; @@ -135,7 +135,7 @@ A table from a bucket of files on S3 .. code-block:: postgres CREATE EXTERNAL TABLE users - (id INT NOT NULL, name VARCHAR(30) NOT NULL, email VARCHAR(50) NOT NULL) + (id INT NOT NULL, name text(30) NOT NULL, email text(50) NOT NULL) USING FORMAT Parquet WITH PATH 's3://pp-secret-bucket/users/*.parquet' AWS_ID 'our_aws_id' diff --git a/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst b/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst index d50e13380..ecc39f08b 100644 --- a/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst +++ b/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst @@ -113,7 +113,7 @@ A simple table from Tab-delimited file (TSV) .. code-block:: postgres CREATE OR REPLACE FOREIGN TABLE cool_animals - (id INT NOT NULL, name VARCHAR(30) NOT NULL, weight FLOAT NOT NULL) + (id INT NOT NULL, name text(30) NOT NULL, weight FLOAT NOT NULL) WRAPPER csv_fdw OPTIONS ( LOCATION = '/home/rhendricks/cool_animals.csv', @@ -128,7 +128,7 @@ A table from a directory of Parquet files on HDFS .. code-block:: postgres CREATE FOREIGN TABLE users - (id INT NOT NULL, name VARCHAR(30) NOT NULL, email VARCHAR(50) NOT NULL) + (id INT NOT NULL, name text(30) NOT NULL, email text(50) NOT NULL) WRAPPER parquet_fdw OPTIONS ( @@ -141,7 +141,7 @@ A table from a bucket of ORC files on S3 .. code-block:: postgres CREATE FOREIGN TABLE users - (id INT NOT NULL, name VARCHAR(30) NOT NULL, email VARCHAR(50) NOT NULL) + (id INT NOT NULL, name text(30) NOT NULL, email text(50) NOT NULL) WRAPPER orc_fdw OPTIONS ( diff --git a/reference/sql/sql_statements/dml_commands/select.rst b/reference/sql/sql_statements/dml_commands/select.rst index f47ffaec1..03bd20d70 100644 --- a/reference/sql/sql_statements/dml_commands/select.rst +++ b/reference/sql/sql_statements/dml_commands/select.rst @@ -163,14 +163,14 @@ Assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - Name varchar(40), - Team varchar(40), + Name text(40), + Team text(40), Number tinyint, - Position varchar(2), + Position text(2), Age tinyint, - Height varchar(4), + Height text(4), Weight real, - College varchar(40), + College text(40), Salary float ); diff --git a/reference/sql/sql_statements/utility_commands/execute_saved_query.rst b/reference/sql/sql_statements/utility_commands/execute_saved_query.rst index 6fe41fa08..9232a5162 100644 --- a/reference/sql/sql_statements/utility_commands/execute_saved_query.rst +++ b/reference/sql/sql_statements/utility_commands/execute_saved_query.rst @@ -66,14 +66,14 @@ Assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - Name varchar(40), - Team varchar(40), + Name text(40), + Team text(40), Number tinyint, - Position varchar(2), + Position text(2), Age tinyint, - Height varchar(4), + Height text(4), Weight real, - College varchar(40), + College text(40), Salary float ); @@ -109,7 +109,7 @@ Use parameters to replace them later at execution time. .. tip:: Use dollar quoting (`$$`) to avoid escaping strings. - .. code-block:: psql +.. code-block:: psql t=> SELECT SAVE_QUERY('select_by_weight_and_team',$$SELECT * FROM nba WHERE Weight > ? AND Team = ?$$); executed @@ -119,5 +119,4 @@ Use parameters to replace them later at execution time. Bismack Biyombo | Toronto Raptors | 8 | C | 23 | 6-9 | 245 | | 2814000 James Johnson | Toronto Raptors | 3 | PF | 29 | 6-9 | 250 | Wake Forest | 2500000 Jason Thompson | Toronto Raptors | 1 | PF | 29 | 6-11 | 250 | Rider | 245177 - Jonas Valanciunas | Toronto Raptors | 17 | C | 24 | 7-0 | 255 | | 4660482 - + Jonas Valanciunas | Toronto Raptors | 17 | C | 24 | 7-0 | 255 | | 4660482 \ No newline at end of file diff --git a/reference/sql/sql_statements/utility_commands/get_ddl.rst b/reference/sql/sql_statements/utility_commands/get_ddl.rst index f2566e99a..bc3b9ef54 100644 --- a/reference/sql/sql_statements/utility_commands/get_ddl.rst +++ b/reference/sql/sql_statements/utility_commands/get_ddl.rst @@ -55,7 +55,7 @@ The result of the ``GET_DDL`` function is a verbose version of the :ref:`create_ farm=> CREATE TABLE cool_animals ( id INT NOT NULL, - name varchar(30) NOT NULL, + name text(30) NOT NULL, weight FLOAT, is_agressive BOOL DEFAULT false NOT NULL ); @@ -64,7 +64,7 @@ The result of the ``GET_DDL`` function is a verbose version of the :ref:`create_ farm=> SELECT GET_DDL('cool_animals'); create table "public"."cool_animals" ( "id" int not null, - "name" varchar(30) not null, + "name" text(30) not null, "weight" double null, "is_agressive" bool default false not null ) ; diff --git a/reference/sql/sql_statements/utility_commands/save_query.rst b/reference/sql/sql_statements/utility_commands/save_query.rst index be34c33ed..f71f6e025 100644 --- a/reference/sql/sql_statements/utility_commands/save_query.rst +++ b/reference/sql/sql_statements/utility_commands/save_query.rst @@ -70,14 +70,14 @@ Assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - Name varchar(40), - Team varchar(40), + Name text(40), + Team text(40), Number tinyint, - Position varchar(2), + Position text(2), Age tinyint, - Height varchar(4), + Height text(4), Weight real, - College varchar(40), + College text(40), Salary float ); @@ -123,5 +123,4 @@ Use parameters to replace them later at execution time. Bismack Biyombo | Toronto Raptors | 8 | C | 23 | 6-9 | 245 | | 2814000 James Johnson | Toronto Raptors | 3 | PF | 29 | 6-9 | 250 | Wake Forest | 2500000 Jason Thompson | Toronto Raptors | 1 | PF | 29 | 6-11 | 250 | Rider | 245177 - Jonas Valanciunas | Toronto Raptors | 17 | C | 24 | 7-0 | 255 | | 4660482 - + Jonas Valanciunas | Toronto Raptors | 17 | C | 24 | 7-0 | 255 | | 4660482 \ No newline at end of file diff --git a/reference/sql/sql_syntax/literals.rst b/reference/sql/sql_syntax/literals.rst index 906684590..bc5376dd1 100644 --- a/reference/sql/sql_syntax/literals.rst +++ b/reference/sql/sql_syntax/literals.rst @@ -239,7 +239,6 @@ The following is a syntax reference for typed literals: | REAL | DATE | DATETIME - | VARCHAR ( digits ) | TEXT ( digits ) Examples diff --git a/reference/sql/sql_syntax/subqueries.rst b/reference/sql/sql_syntax/subqueries.rst index 4cd995977..7f788ff46 100644 --- a/reference/sql/sql_syntax/subqueries.rst +++ b/reference/sql/sql_syntax/subqueries.rst @@ -28,14 +28,14 @@ The following is an example of table named ``nba`` with the following structure: CREATE TABLE nba ( - "Name" varchar(40), - "Team" varchar(40), + "Name" text(40), + "Team" text(40), "Number" tinyint, - "Position" varchar(2), + "Position" text(2), "Age" tinyint, - "Height" varchar(4), + "Height" text(4), "Weight" real, - "College" varchar(40), + "College" text(40), "Salary" float ); diff --git a/reference/sql/sql_syntax/window_functions.rst b/reference/sql/sql_syntax/window_functions.rst index cb87e085e..39d072d33 100644 --- a/reference/sql/sql_syntax/window_functions.rst +++ b/reference/sql/sql_syntax/window_functions.rst @@ -221,14 +221,14 @@ For these examples, assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - "Name" varchar(40), - "Team" varchar(40), + "Name" text(40), + "Team" text(40), "Number" tinyint, - "Position" varchar(2), + "Position" text(2), "Age" tinyint, - "Height" varchar(4), + "Height" text(4), "Weight" real, - "College" varchar(40), + "College" text(40), "Salary" float ); diff --git a/troubleshooting/log_related_issues.rst b/troubleshooting/log_related_issues.rst index a260f59d5..12623c943 100644 --- a/troubleshooting/log_related_issues.rst +++ b/troubleshooting/log_related_issues.rst @@ -18,7 +18,7 @@ Assuming logs are stored at ``/home/rhendricks/sqream_storage/logs/``, a databas CREATE FOREIGN TABLE logs ( - start_marker VARCHAR(4), + start_marker TEXT(4), row_id BIGINT, timestamp DATETIME, message_level TEXT, @@ -32,7 +32,7 @@ Assuming logs are stored at ``/home/rhendricks/sqream_storage/logs/``, a databas service_name TEXT, message_type_id INT, message TEXT, - end_message VARCHAR(5) + end_message TEXT(5) ) WRAPPER csv_fdw OPTIONS From 4996747e7e8e5ee5486b109bf89905281546867b Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 3 Apr 2022 15:16:23 +0300 Subject: [PATCH 034/882] Replaced VARCHAR with TEXT... ... according to Shachar's comments in the Slack threads. --- data_ingestion/inserting_data.rst | 81 +++++----- data_ingestion/orc.rst | 56 +++---- data_ingestion/parquet.rst | 37 +++-- data_type_guides/sql_data_types_date.rst | 2 +- .../sql_data_types_floating_point.rst | 3 +- data_type_guides/sql_data_types_integer.rst | 2 +- data_type_guides/sql_data_types_string.rst | 30 +--- .../monitoring_query_performance.rst | 4 +- .../conditionals/is_ascii.rst | 15 +- .../scalar_functions/conversion/to_hex.rst | 4 +- .../scalar_functions/numeric/crc64.rst | 19 +-- .../scalar_functions/string/octet_length.rst | 10 +- .../scalar_functions/string/replace.rst | 10 +- .../scalar_functions/string/rtrim.rst | 2 +- .../window_functions/first_value.rst | 2 +- .../window_functions/last_value.rst | 4 +- reference/sql/sql_statements/index.rst | 87 ++++------- reference/sql/sql_syntax/literals.rst | 2 +- reference/sql_feature_support.rst | 141 +++++++++--------- 19 files changed, 209 insertions(+), 302 deletions(-) diff --git a/data_ingestion/inserting_data.rst b/data_ingestion/inserting_data.rst index 86bd08103..42ac36ceb 100644 --- a/data_ingestion/inserting_data.rst +++ b/data_ingestion/inserting_data.rst @@ -53,8 +53,6 @@ SQream therefore recommends: * Applications such as :ref:`Tableau` and others have been tested, and work -* Data types were not over-provisioned (e.g. don't use VARCHAR(2000) to store a short string) - File Soure Location when Loading -------------------------------- @@ -78,20 +76,20 @@ SQream DB's :ref:`COPY FROM` syntax can be used to load CSV files, bu - ORC - Streaming data * - :ref:`copy_from` - - ✓ - - ✗ - - ✗ - - ✗ + - Supported + - Not supported + - Not supported + - Not supported * - :ref:`external_tables` - - ✓ - - ✓ - - ✓ - - ✗ + - Supported + - Supported + - Supported + - Not supported * - :ref:`insert` - - ✗ - - ✗ - - ✗ - - ✓ (Python, JDBC, Node.JS) + - Not supported + - Not supported + - Not supported + - Supported (Python, JDBC, Node.JS) Unsupported Data Types ----------------------------- @@ -262,9 +260,8 @@ Type Support and Behavior Notes * The types should match to some extent within the same "class" (see table below). .. list-table:: - :widths: auto + :widths: 5 5 70 70 70 70 5 5 5 5 5 :header-rows: 1 - :stub-columns: 1 * - SQream DB type → @@ -276,15 +273,15 @@ Type Support and Behavior Notes - ``BIGINT`` - ``REAL`` - ``DOUBLE`` - - Text [#f0]_ + - ``Text`` [#f0]_ - ``DATE`` - ``DATETIME`` * - ``boolean`` - - ✓ - - ✓ [#f5]_ - - ✓ [#f5]_ - - ✓ [#f5]_ - - ✓ [#f5]_ + - Supported + - Supported [#f5]_ + - Supported [#f5]_ + - Supported [#f5]_ + - Supported [#f5]_ - - - @@ -292,10 +289,10 @@ Type Support and Behavior Notes - * - ``tinyint`` - ○ [#f6]_ - - ✓ - - ✓ - - ✓ - - ✓ + - Supported + - Supported + - Supported + - Supported - - - @@ -304,9 +301,9 @@ Type Support and Behavior Notes * - ``smallint`` - ○ [#f6]_ - ○ [#f7]_ - - ✓ - - ✓ - - ✓ + - Supported + - Supported + - Supported - - - @@ -316,8 +313,8 @@ Type Support and Behavior Notes - ○ [#f6]_ - ○ [#f7]_ - ○ [#f7]_ - - ✓ - - ✓ + - Supported + - Supported - - - @@ -328,7 +325,7 @@ Type Support and Behavior Notes - ○ [#f7]_ - ○ [#f7]_ - ○ [#f7]_ - - ✓ + - Supported - - - @@ -340,8 +337,8 @@ Type Support and Behavior Notes - - - - - ✓ - - ✓ + - Supported + - Supported - - - @@ -351,12 +348,12 @@ Type Support and Behavior Notes - - - - - ✓ - - ✓ + - Supported + - Supported - - - - * - ``string`` / ``char`` / ``varchar`` + * - ``string`` / ``char`` / ``text`` - - - @@ -364,7 +361,7 @@ Type Support and Behavior Notes - - - - - ✓ + - Supported - - * - ``date`` @@ -376,8 +373,8 @@ Type Support and Behavior Notes - - - - - ✓ - - ✓ + - Supported + - Supported * - ``timestamp``, ``timestamp`` with timezone - - @@ -388,7 +385,7 @@ Type Support and Behavior Notes - - - - - ✓ + - Supported * If an ORC file has an unsupported type like ``binary``, ``list``, ``map``, and ``union``, but the data is not referenced in the table (it does not appear in the :ref:`SELECT` query), the statement will succeed. If the column is referenced, an error will be thrown to the user, explaining that the type is not supported, but the column may be ommited. @@ -459,7 +456,7 @@ Further Reading and Migration Guides .. rubric:: Footnotes -.. [#f0] Text values include ``TEXT``, ``VARCHAR``, and ``NVARCHAR`` +.. [#f0] Text values include ``TEXT`` .. [#f2] With UTF8 annotation diff --git a/data_ingestion/orc.rst b/data_ingestion/orc.rst index de10c5ce4..61e9237f9 100644 --- a/data_ingestion/orc.rst +++ b/data_ingestion/orc.rst @@ -13,9 +13,9 @@ This guide covers inserting data from ORC files into SQream DB using :ref:`FOREI Prepare the source ORC files, with the following requirements: .. list-table:: - :widths: auto + :widths: 5 5 70 70 70 70 5 5 5 5 5 :header-rows: 1 - :stub-columns: 1 + * - SQream DB type → @@ -27,15 +27,15 @@ Prepare the source ORC files, with the following requirements: - ``BIGINT`` - ``REAL`` - ``DOUBLE`` - - Text [#f0]_ + - ``TEXT`` [#f0]_ - ``DATE`` - ``DATETIME`` * - ``boolean`` - - ✓ - - ✓ [#f5]_ - - ✓ [#f5]_ - - ✓ [#f5]_ - - ✓ [#f5]_ + - Supported + - Supported [#f5]_ + - Supported [#f5]_ + - Supported [#f5]_ + - Supported [#f5]_ - - - @@ -43,10 +43,10 @@ Prepare the source ORC files, with the following requirements: - * - ``tinyint`` - ○ [#f6]_ - - ✓ - - ✓ - - ✓ - - ✓ + - Supported + - Supported + - Supported + - Supported - - - @@ -55,9 +55,9 @@ Prepare the source ORC files, with the following requirements: * - ``smallint`` - ○ [#f6]_ - ○ [#f7]_ - - ✓ - - ✓ - - ✓ + - Supported + - Supported + - Supported - - - @@ -67,8 +67,8 @@ Prepare the source ORC files, with the following requirements: - ○ [#f6]_ - ○ [#f7]_ - ○ [#f7]_ - - ✓ - - ✓ + - Supported + - Supported - - - @@ -79,7 +79,7 @@ Prepare the source ORC files, with the following requirements: - ○ [#f7]_ - ○ [#f7]_ - ○ [#f7]_ - - ✓ + - Supported - - - @@ -91,8 +91,8 @@ Prepare the source ORC files, with the following requirements: - - - - - ✓ - - ✓ + - Supported + - Supported - - - @@ -102,12 +102,12 @@ Prepare the source ORC files, with the following requirements: - - - - - ✓ - - ✓ + - Supported + - Supported - - - - * - ``string`` / ``char`` / ``varchar`` + * - ``string`` / ``char`` / ``text`` - - - @@ -115,7 +115,7 @@ Prepare the source ORC files, with the following requirements: - - - - - ✓ + - Supported - - * - ``date`` @@ -127,8 +127,8 @@ Prepare the source ORC files, with the following requirements: - - - - - ✓ - - ✓ + - Supported + - Supported * - ``timestamp``, ``timestamp`` with timezone - - @@ -139,13 +139,13 @@ Prepare the source ORC files, with the following requirements: - - - - - ✓ + - Supported * If an ORC file has an unsupported type like ``binary``, ``list``, ``map``, and ``union``, but the data is not referenced in the table (it does not appear in the :ref:`SELECT` query), the statement will succeed. If the column is referenced, an error will be thrown to the user, explaining that the type is not supported, but the column may be ommited. This can be worked around. See more information in the examples. .. rubric:: Footnotes -.. [#f0] Text values include ``TEXT``, ``VARCHAR``, and ``NVARCHAR`` +.. [#f0] Text values include ``TEXT`` .. [#f5] Boolean values are cast to 0, 1 diff --git a/data_ingestion/parquet.rst b/data_ingestion/parquet.rst index 4579deb82..c5971e064 100644 --- a/data_ingestion/parquet.rst +++ b/data_ingestion/parquet.rst @@ -15,9 +15,8 @@ This guide covers inserting data from Parquet files into SQream DB using :ref:`F Prepare the source Parquet files, with the following requirements: .. list-table:: - :widths: auto + :widths: 40 5 20 20 20 20 5 5 5 5 10 :header-rows: 1 - :stub-columns: 1 * - SQream DB type → @@ -29,11 +28,11 @@ Prepare the source Parquet files, with the following requirements: - ``BIGINT`` - ``REAL`` - ``DOUBLE`` - - Text [#f0]_ + - ``TEXT`` [#f0]_ - ``DATE`` - ``DATETIME`` * - ``BOOLEAN`` - - ✓ + - Supported - - - @@ -46,7 +45,7 @@ Prepare the source Parquet files, with the following requirements: * - ``INT16`` - - - - ✓ + - Supported - - - @@ -58,7 +57,7 @@ Prepare the source Parquet files, with the following requirements: - - - - - ✓ + - Supported - - - @@ -70,7 +69,7 @@ Prepare the source Parquet files, with the following requirements: - - - - - ✓ + - Supported - - - @@ -82,7 +81,7 @@ Prepare the source Parquet files, with the following requirements: - - - - - ✓ + - Supported - - - @@ -94,7 +93,7 @@ Prepare the source Parquet files, with the following requirements: - - - - - ✓ + - Supported - - - @@ -106,7 +105,7 @@ Prepare the source Parquet files, with the following requirements: - - - - - ✓ + - Supported - - * - ``INT96`` [#f3]_ @@ -119,13 +118,13 @@ Prepare the source Parquet files, with the following requirements: - - - - - ✓ [#f4]_ + - Supported [#f4]_ -* If a Parquet file has an unsupported type like ``enum``, ``uuid``, ``time``, ``json``, ``bson``, ``lists``, ``maps``, but the data is not referenced in the table (it does not appear in the :ref:`SELECT` query), the statement will succeed. If the column is referenced, an error will be thrown to the user, explaining that the type is not supported, but the column may be ommited. This can be worked around. See more information in the examples. +* If a Parquet file has an unsupported type, such as ``enum``, ``uuid``, ``time``, ``json``, ``bson``, ``lists``, ``maps``, but the data is not referenced in the table (it does not appear in the :ref:`SELECT` query), the statement will succeed. If the column is referenced, an error will be thrown to the user, explaining that the type is not Supported, but the column may be ommited. This can be worked around. See more information in the examples. .. rubric:: Footnotes -.. [#f0] Text values include ``TEXT``, ``VARCHAR``, and ``NVARCHAR`` +.. [#f0] Text values include ``TEXT`` .. [#f2] With UTF8 annotation @@ -187,7 +186,7 @@ We will make note of the file structure to create a matching ``CREATE EXTERNAL T Types in SQream DB must match Parquet types exactly. - If the column type isn't supported, a possible workaround is to set it to any arbitrary type and then exclude it from subsequent queries. + If the column type isn't Supported, a possible workaround is to set it to any arbitrary type and then exclude it from subsequent queries. 4. Verify table contents @@ -223,21 +222,21 @@ To load the data into SQream DB, use the :ref:`create_table_as` statement: CREATE TABLE nba AS SELECT * FROM ext_nba; -Working around unsupported column types +Working around unSupported column types --------------------------------------------- -Suppose you only want to load some of the columns - for example, if one of the columns isn't supported. +Suppose you only want to load some of the columns - for example, if one of the columns isn't Supported. -By ommitting unsupported columns from queries that access the ``EXTERNAL TABLE``, they will never be called, and will not cause a "type mismatch" error. +By ommitting unSupported columns from queries that access the ``EXTERNAL TABLE``, they will never be called, and will not cause a "type mismatch" error. -For this example, assume that the ``Position`` column isn't supported because of its type. +For this example, assume that the ``Position`` column isn't Supported because of its type. .. code-block:: postgres CREATE TABLE nba AS SELECT Name, Team, Number, NULL as Position, Age, Height, Weight, College, Salary FROM ext_nba; - -- We ommitted the unsupported column `Position` from this query, and replaced it with a default ``NULL`` value, to maintain the same table structure. + -- We ommitted the unSupported column `Position` from this query, and replaced it with a default ``NULL`` value, to maintain the same table structure. Modifying data during the copy process diff --git a/data_type_guides/sql_data_types_date.rst b/data_type_guides/sql_data_types_date.rst index da83f80cc..88236c113 100644 --- a/data_type_guides/sql_data_types_date.rst +++ b/data_type_guides/sql_data_types_date.rst @@ -108,5 +108,5 @@ The following table shows the possible ``DATE`` and ``DATETIME`` value conversio * - Type - Details - * - ``VARCHAR(n)`` + * - ``TEXT`` - ``'1997-01-01'`` → ``'1997-01-01'``, ``'1955-11-05 01:24'`` → ``'1955-11-05 01:24:00.000'`` \ No newline at end of file diff --git a/data_type_guides/sql_data_types_floating_point.rst b/data_type_guides/sql_data_types_floating_point.rst index 18227140c..3edc8362d 100644 --- a/data_type_guides/sql_data_types_floating_point.rst +++ b/data_type_guides/sql_data_types_floating_point.rst @@ -74,7 +74,6 @@ The following table shows the possible Floating Point value conversions: - ``1.0`` → ``true``, ``0.0`` → ``false`` * - ``TINYINT``, ``SMALLINT``, ``INT``, ``BIGINT`` - ``2.0`` → ``2``, ``3.14159265358979`` → ``3``, ``2.718281828459`` → ``2``, ``0.5`` → ``0``, ``1.5`` → ``1`` - * - ``VARCHAR(n)`` (n > 6 recommended) - - ``1`` → ``'1.0000'``, ``3.14159265358979`` → ``'3.1416'`` + .. note:: As shown in the above examples, casting ``real`` to ``int`` rounds down. \ No newline at end of file diff --git a/data_type_guides/sql_data_types_integer.rst b/data_type_guides/sql_data_types_integer.rst index 9d4210731..cd27f6956 100644 --- a/data_type_guides/sql_data_types_integer.rst +++ b/data_type_guides/sql_data_types_integer.rst @@ -79,5 +79,5 @@ The following table shows the possible Integer value conversions: - Details * - ``REAL``, ``DOUBLE`` - ``1`` → ``1.0``, ``-32`` → ``-32.0`` - * - ``VARCHAR(n)`` (All numberic values must fit in the string length) + * - ``TEXT`` (All numberic values must fit in the string length) - ``1`` → ``'1'``, ``2451`` → ``'2451'`` \ No newline at end of file diff --git a/data_type_guides/sql_data_types_string.rst b/data_type_guides/sql_data_types_string.rst index 0d977b6d2..4b1a1b406 100644 --- a/data_type_guides/sql_data_types_string.rst +++ b/data_type_guides/sql_data_types_string.rst @@ -5,30 +5,7 @@ String ************************* ``TEXT`` is designed for storing text or strings of characters. -SQream separates ASCII (``VARCHAR``) and UTF-8 representations (``TEXT``). - -.. note:: The data type ``NVARCHAR`` has been deprecated by ``TEXT`` as of version 2020.1. - -String Types -^^^^^^^^^^^^^^^^^^^^^^ -The following table describes the String types: - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Name - - Details - - Data Size (Not Null, Uncompressed) - - Example - * - ``TEXT [(n)]``, ``NVARCHAR (n)`` - - Varaiable length string - UTF-8 unicode. ``NVARCHAR`` is synonymous with ``TEXT``. - - Up to ``4*n`` bytes - - ``'キウイは楽しい鳥です'`` - * - ``VARCHAR (n)`` - - Variable length string - ASCII only - - ``n`` bytes - - ``'Kiwis have tiny wings, but cannot fly.'`` +SQream UTF-8 representations (``TEXT``). Length ^^^^^^^^^ @@ -37,8 +14,7 @@ When using ``TEXT``, specifying a size is optional. If not specified, the text f The following apply to setting the String type length: * If the data exceeds the column length limit on ``INSERT`` or ``COPY`` operations, SQream DB will return an error. -* When casting or converting, the string has to fit in the target. For example, ``'Kiwis are weird birds' :: VARCHAR(5)`` will return an error. Use ``SUBSTRING`` to truncate the length of the string. -* ``VARCHAR`` strings are padded with spaces. +* When casting or converting, the string has to fit in the target. For example, ``'Kiwis are weird birds' :: TEXT(5)`` will return an error. Use ``SUBSTRING`` to truncate the length of the string. Syntax ^^^^^^^^ @@ -47,7 +23,7 @@ String types can be written with standard SQL string literals, which are enclose Size ^^^^^^ -``VARCHAR(n)`` can occupy up to *n* bytes, whereas ``TEXT(n)`` can occupy up to *4*n* bytes. However, the size of strings is variable and is compressed by SQream. +``TEXT(n)`` can occupy up to *4*n* bytes. However, the size of strings is variable and is compressed by SQream. String Examples ^^^^^^^^^^ diff --git a/operational_guides/monitoring_query_performance.rst b/operational_guides/monitoring_query_performance.rst index a542f61e6..a38ddc6d0 100644 --- a/operational_guides/monitoring_query_performance.rst +++ b/operational_guides/monitoring_query_performance.rst @@ -200,7 +200,7 @@ Commonly Seen Nodes - Description * - ``CpuDecompress`` - CPU - - Decompression operation, common for longer ``VARCHAR`` types + - Decompression operation, common for longer ``TEXT`` types * - ``CpuLoopJoin`` - CPU - A non-indexed nested loop join, performed on the CPU @@ -621,7 +621,7 @@ Common Solutions for Improving Filtering * Use :ref:`clustering keys and naturally ordered data` in your filters. * Avoid full table scans when possible -4. Joins with ``varchar`` Keys +4. Joins with ``text`` Keys ----------------------------------- Joins on long text keys, such as ``varchar(100)`` do not perform as well as numeric data types or very short text keys. diff --git a/reference/sql/sql_functions/scalar_functions/conditionals/is_ascii.rst b/reference/sql/sql_functions/scalar_functions/conditionals/is_ascii.rst index bb9e3b2f9..495e46e76 100644 --- a/reference/sql/sql_functions/scalar_functions/conditionals/is_ascii.rst +++ b/reference/sql/sql_functions/scalar_functions/conditionals/is_ascii.rst @@ -45,20 +45,19 @@ For these examples, consider the following table and contents: .. code-block:: postgres - CREATE TABLE dictionary (id INT NOT NULL, fw TEXT(30), en VARCHAR(30)); - - INSERT INTO dictionary VALUES (1, '行こう', 'Let''s go'), (2, '乾杯', 'Cheers'), (3, 'L''chaim', 'Cheers'); + CREATE TABLE dictionary (id INT NOT NULL, text TEXT); + INSERT INTO dictionary VALUES (1, '行こう'), (2, '乾杯'), (3, 'L''chaim'); + SELECT id, text, IS_ASCII(text) FROM dictionary; IS NULL ----------- .. code-block:: psql - m=> SELECT id, en, fw, IS_ASCII(fw) FROM dictionary; - id | en | fw | is_ascii + id | text | is_ascii ---+----------+----------+--------- - 1 | Let's go | 行こう | false - 2 | Cheers | 乾杯 | false - 3 | Cheers | L'chaim | true + 1 | 行こう | false + 2 | 乾杯 | false + 3 | L'chaim | true diff --git a/reference/sql/sql_functions/scalar_functions/conversion/to_hex.rst b/reference/sql/sql_functions/scalar_functions/conversion/to_hex.rst index f3cf6fb82..d33643f22 100644 --- a/reference/sql/sql_functions/scalar_functions/conversion/to_hex.rst +++ b/reference/sql/sql_functions/scalar_functions/conversion/to_hex.rst @@ -11,7 +11,7 @@ Syntax .. code-block:: postgres - TO_HEX( expr ) --> VARCHAR + TO_HEX( expr ) --> TEXT Arguments ============ @@ -28,7 +28,7 @@ Arguments Returns ============ -* Representation of the hexadecimal number of type ``VARCHAR``. +* Representation of the hexadecimal number of type ``TEXT``. Examples diff --git a/reference/sql/sql_functions/scalar_functions/numeric/crc64.rst b/reference/sql/sql_functions/scalar_functions/numeric/crc64.rst index 105dae47c..8d067485d 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/crc64.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/crc64.rst @@ -12,8 +12,6 @@ Syntax .. code-block:: postgres CRC64( expr ) --> BIGINT - - CRC64_JOIN( expr ) --> BIGINT Arguments ============ @@ -32,14 +30,7 @@ Returns Returns a CRC-64 hash of the text input, of type ``BIGINT``. -Notes -======= - -* If the input value is NULL, the result is NULL. - -* The ``CRC64_JOIN`` can be used with ``VARCHAR`` only. It can not be used with ``TEXT``. - -* The ``CRC64_JOIN`` variant ignores leading whitespace when used as a ``JOIN`` key. +.. note:: If the input value is NULL, the result is NULL. Examples =========== @@ -49,9 +40,5 @@ Calculate a CRC-64 hash of a string .. code-block:: psql - numbers=> SELECT CRC64(x) FROM - . (VALUES ('This is a relatively long text string, that can be converted to a shorter hash' :: varchar(80))) - . as t(x); - crc64 - -------------------- - -9085161068710498500 \ No newline at end of file + SELECT CRC64(x) FROM (VALUES ('This is a relatively long text string, that can be converted to a shorter hash' :: text)) as t(x); + -8397827068206190216 \ No newline at end of file diff --git a/reference/sql/sql_functions/scalar_functions/string/octet_length.rst b/reference/sql/sql_functions/scalar_functions/string/octet_length.rst index 8bb1e3daf..0836b4685 100644 --- a/reference/sql/sql_functions/scalar_functions/string/octet_length.rst +++ b/reference/sql/sql_functions/scalar_functions/string/octet_length.rst @@ -6,14 +6,10 @@ OCTET_LENGTH Calculates the number of bytes in a string. -.. note:: +.. note:: + + * To get the length in bytes, see :ref:`octet_length`. - * This function is supported on ``TEXT`` strings only. - - * To get the length in characters, see :ref:`char_length`. - - * For ``VARCHAR`` strings, the octet length is the number of characters. Use :ref:`len` instead. - Syntax ========== The following is the correct syntax for the ``OCTET_LENGTH`` function: diff --git a/reference/sql/sql_functions/scalar_functions/string/replace.rst b/reference/sql/sql_functions/scalar_functions/string/replace.rst index 5552be269..d2fab561a 100644 --- a/reference/sql/sql_functions/scalar_functions/string/replace.rst +++ b/reference/sql/sql_functions/scalar_functions/string/replace.rst @@ -6,9 +6,6 @@ REPLACE Replaces all occurrences of a specified string value with another string value. -.. warning:: With ``VARCHAR``, a substring can only be replaced with another substring of equal **byte length**. See :ref:`octet_length`. - - Syntax ========== @@ -37,12 +34,7 @@ Returns Returns the same type as the argument supplied. -Notes -======= - -* In ``VARCHAR`` strings, the ``source_expr`` and ``replacement_expr`` must be the same **byte length**. See :ref:`octet_length`. - -* If the value is NULL, the result is NULL. +.. note:: If the value is NULL, the result is NULL. Examples =========== diff --git a/reference/sql/sql_functions/scalar_functions/string/rtrim.rst b/reference/sql/sql_functions/scalar_functions/string/rtrim.rst index 2bd5bbc38..61fdc877d 100644 --- a/reference/sql/sql_functions/scalar_functions/string/rtrim.rst +++ b/reference/sql/sql_functions/scalar_functions/string/rtrim.rst @@ -35,7 +35,7 @@ Returns the same type as the argument supplied. Notes ======= -* When using ``VARCHAR`` values, SQream DB automatically trims the trailing whitespace. Using ``RTRIM`` on ``VARCHAR`` does not affect the result. +* When using ``TEXT`` values, SQream DB automatically trims the trailing whitespace. Using ``RTRIM`` on ``TEXT`` does not affect the result. * This function is equivalent to the ANSI form ``TRIM( TRAILING FROM expr )`` diff --git a/reference/sql/sql_functions/window_functions/first_value.rst b/reference/sql/sql_functions/window_functions/first_value.rst index 25294040c..78896746a 100644 --- a/reference/sql/sql_functions/window_functions/first_value.rst +++ b/reference/sql/sql_functions/window_functions/first_value.rst @@ -5,7 +5,7 @@ FIRST_VALUE ************************** The **FIRST_VALUE** function returns the value located in the selected column of the first row of a segment. If the table is not segmented, the FIRST_VALUE function returns the value from the first row of the whole table. -This function returns the same type of variable that you input for your requested value. For example, requesting the value for the first employee in a list using an ``int`` type output returns an ``int`` type ID column. If you use a ``varchar`` type, the function returns a ``varchar`` type name column. +This function returns the same type of variable that you input for your requested value. For example, requesting the value for the first employee in a list using an ``int`` type output returns an ``int`` type ID column. If you use a ``text`` type, the function returns a ``text`` type name column. Syntax ------- diff --git a/reference/sql/sql_functions/window_functions/last_value.rst b/reference/sql/sql_functions/window_functions/last_value.rst index 3cadaa9d1..ae1276e79 100644 --- a/reference/sql/sql_functions/window_functions/last_value.rst +++ b/reference/sql/sql_functions/window_functions/last_value.rst @@ -5,7 +5,7 @@ LAST_VALUE ************************** The **LAST_VALUE** function returns the value located in the selected column of the last row of a segment. If the table is not segmented, the LAST_VALUE function returns the value from the last row of the whole table. -This function returns the same type of variable that you input for your requested value. For example, requesting the value for the last employee in a list using an ``int`` type output returns an ``int`` type ID column. If you use a ``varchar`` type, the function returns a ``varchar`` type name column. +This function returns the same type of variable that you input for your requested value. For example, requesting the value for the last employee in a list using an ``int`` type output returns an ``int`` type ID column. If you use a ``text`` type, the function returns a ``text`` type name column. Syntax ------- @@ -21,4 +21,4 @@ None Returns --------- -Returns the value located in the selected column of the last row of a segment. +Returns the value located in the selected column of the last row of a segment. \ No newline at end of file diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index e14041385..ae0139607 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -11,8 +11,6 @@ SQream DB supports commands from ANSI SQL. Data Definition Commands (DDL) ================================ - update - .. list-table:: DDL Commands :widths: auto :header-rows: 1 @@ -20,45 +18,47 @@ Data Definition Commands (DDL) * - Command - Usage - * - :ref:`ADD COLUMN` + * - :ref:`add_column` - Add a new column to a table - * - :ref:`UPDATE` - - Modify the value of certain columns in existing rows without creating a table - * - :ref:`ALTER DEFAULT SCHEMA` + * - :ref:`alter_default_schema` - Change the default schema for a role - * - :ref:`ALTER TABLE` + * - :ref:`alter_table` - Change the schema of a table - * - :ref:`CREATE DATABASE` + * - :ref:`cluster_by` + - Change clustering keys in a table + * - :ref:`create_database` - Create a new database - * - :ref:`CREATE EXTERNAL TABLE` + * - :ref:`create_external_table` - Create a new external table in the database (deprecated) - * - :ref:`CREATE FOREIGN TABLE` + * - :ref:`create_foreign_table` - Create a new foreign table in the database - * - :ref:`CREATE FUNCTION ` + * - :ref:`create_function` - Create a new user defined function in the database - * - :ref:`CREATE SCHEMA` + * - :ref:`create_schema` - Create a new schema in the database - * - :ref:`CREATE TABLE` + * - :ref:`create_table` - Create a new table in the database - * - :ref:`CREATE TABLE AS` + * - :ref:`create_table_as` - Create a new table in the database using results from a select query - * - :ref:`CREATE VIEW` + * - :ref:`create_view` - Create a new view in the database - * - :ref:`DROP COLUMN` + * - :ref:`drop_clustering_key` + - Drops all clustering keys in a table + * - :ref:`drop_column` - Drop a column from a table - * - :ref:`DROP DATABASE` + * - :ref:`drop_database` - Drop a database and all of its objects - * - :ref:`DROP FUNCTION` + * - :ref:`drop_function` - Drop a function - * - :ref:`DROP SCHEMA` + * - :ref:`drop_schema` - Drop a schema - * - :ref:`DROP TABLE` + * - :ref:`drop_table` - Drop a table and its contents from a database - * - :ref:`DROP VIEW` + * - :ref:`drop_view` - Drop a view - * - :ref:`RENAME COLUMN` + * - :ref:`rename_column` - Rename a column - * - :ref:`RENAME TABLE` + * - :ref:`rename_table` - Rename a table Data Manipulation Commands (DML) @@ -86,6 +86,8 @@ Data Manipulation Commands (DML) - Select rows and column from a table * - :ref:`TRUNCATE` - Delete all rows from a table + * - :ref:`UPDATE` + - Modify the value of certain columns in existing rows without creating a table * - :ref:`VALUES` - Return rows containing literal values @@ -111,29 +113,6 @@ Utility Commands * - :ref:`SELECT DUMP_DATABASE_DDL` - View the ``CREATE TABLE`` statement for an current database -Saved Queries -=================== - -.. list-table:: Saved Queries - :widths: auto - :header-rows: 1 - - * - Command - - Usage - * - :ref:`SELECT DROP_SAVED_QUERY` - - Drop a saved query - * - :ref:`SELECT EXECUTE_SAVED_QUERY` - - Executes a saved query - * - :ref:`SELECT LIST_SAVED_QUERIES` - - Returns a list of saved queries - * - :ref:`SELECT RECOMPILE_SAVED_QUERY` - - Recompiles a query that has been invalidated by a schema change - * - :ref:`SELECT SAVE_QUERY` - - Compiles and saves a query for re-use and sharing - * - :ref:`SELECT SHOW_SAVED_QUERY` - - Shows query text for a saved query - -For more information, see :ref:`saved_queries` Monitoring @@ -202,18 +181,4 @@ Access Control Commands * - :ref:`revoke` - Revoke permissions from a role * - :ref:`rename_role` - - Rename a role - - -.. toctree:: - :maxdepth: 1 - :titlesonly: - :hidden: - :glob: - - ddl_commands/* - dml_commands/* - utility_commands/* - monitoring_commands/* - wlm_commands/* - access_control_commands/* \ No newline at end of file + - Rename a role \ No newline at end of file diff --git a/reference/sql/sql_syntax/literals.rst b/reference/sql/sql_syntax/literals.rst index bc5376dd1..d1ec35dbe 100644 --- a/reference/sql/sql_syntax/literals.rst +++ b/reference/sql/sql_syntax/literals.rst @@ -86,7 +86,7 @@ Examples '1997-01-01' -- This is a string -The actual data type of the value changes based on context, the format used, and the value itself. In the example below, the first value is interpreted as a ``DATE``, while the second is interpreted as a ``VARCHAR``. +The actual data type of the value changes based on context, the format used, and the value itself. In the example below, the first value is interpreted as a ``DATE``, while the second is interpreted as a ``TEXT``. .. code-block:: postgres diff --git a/reference/sql_feature_support.rst b/reference/sql_feature_support.rst index ba4ca39e4..4443d631a 100644 --- a/reference/sql_feature_support.rst +++ b/reference/sql_feature_support.rst @@ -14,7 +14,7 @@ To understand which ANSI SQL and other SQL features SQream DB supports, use the Data Types and Values ========================= -Read more about :ref:`supported data types`. +Read more about :ref:`Yes data types`. .. list-table:: Data Types and Values :widths: auto @@ -24,46 +24,43 @@ Read more about :ref:`supported data types`. - Supported - Further information * - ``BOOL`` - - ✓ + - Yes - Boolean values * - ``TINTINT`` - - ✓ + - Yes - Unsigned 1 byte integer (0 - 255) * - ``SMALLINT`` - - ✓ + - Yes - 2 byte integer (-32,768 - 32,767) * - ``INT`` - - ✓ + - Yes - 4 byte integer (-2,147,483,648 - 2,147,483,647) * - ``BIGINT`` - - ✓ + - Yes - 8 byte integer (-9,223,372,036,854,775,808 - 9,223,372,036,854,775,807) * - ``REAL`` - - ✓ + - Yes - 4 byte floating point * - ``DOUBLE``, ``FLOAT`` - - ✓ + - Yes - 8 byte floating point * - ``DECIMAL``, ``NUMERIC`` - - ✓ + - Yes - Fixed-point numbers. - * - ``VARCHAR`` - - ✓ - - Variable length string - ASCII only * - ``TEXT`` - - ✓ + - Yes - Variable length string - UTF-8 encoded * - ``DATE`` - - ✓ + - Yes - Date * - ``DATETIME``, ``TIMESTAMP`` - - ✓ + - Yes - Date and time * - ``NULL`` - - ✓ + - Yes - ``NULL`` values * - ``TIME`` - - ✗ + - No - Can be stored as a text string or as part of a ``DATETIME`` @@ -77,14 +74,14 @@ Contraints * - Item - Supported - Further information - * - Not null - - ✓ + * - ``Not null`` + - Yes - ``NOT NULL`` - * - Default values - - ✓ + * - ``Default values`` + - Yes - ``DEFAULT`` * - ``AUTO INCREMENT`` - - ✓ Different name + - Yes (different name) - ``IDENTITY`` @@ -118,43 +115,43 @@ Schema Changes - Supported - Further information * - ``ALTER TABLE`` - - ✓ + - Yes - :ref:`alter_table` - Add column, alter column, drop column, rename column, rename table, modify clustering keys * - Rename database - - ✗ + - No - * - Rename table - - ✓ + - Yes - :ref:`rename_table` * - Rename column - - ✓ + - Yes - :ref:`rename_column` * - Add column - - ✓ + - Yes - :ref:`add_column` * - Remove column - - ✓ + - Yes - :ref:`drop_column` * - Alter column data type - - ✗ + - No - * - Add / modify clustering keys - - ✓ + - Yes - :ref:`cluster_by` * - Drop clustering keys - - ✓ + - Yes - :ref:`drop_clustering_key` * - Add / Remove constraints - - ✗ + - No - * - Rename schema - - ✗ + - No - * - Drop schema - - ✓ + - Yes - :ref:`drop_schema` * - Alter default schema per user - - ✓ + - Yes - :ref:`alter_default_schema` @@ -169,28 +166,28 @@ Statements - Supported - Further information * - SELECT - - ✓ + - Yes - :ref:`select` * - CREATE TABLE - - ✓ + - Yes - :ref:`create_table` * - CREATE FOREIGN / EXTERNAL TABLE - - ✓ + - Yes - :ref:`create_foreign_table` * - DELETE - - ✓ + - Yes - :ref:`delete_guide` * - INSERT - - ✓ + - Yes - :ref:`insert`, :ref:`copy_from` * - TRUNCATE - - ✓ + - Yes - :ref:`truncate` * - UPDATE - - ✗ + - No - * - VALUES - - ✓ + - Yes - :ref:`values` Clauses @@ -204,19 +201,19 @@ Clauses - Supported - Further information * - ``LIMIT`` / ``TOP`` - - ✓ + - Yes - * - ``LIMIT`` with ``OFFSET`` - - ✗ + - No - * - ``WHERE`` - - ✓ + - Yes - * - ``HAVING`` - - ✓ + - Yes - * - ``OVER`` - - ✓ + - Yes - Table Expressions @@ -230,19 +227,19 @@ Table Expressions - Supported - Further information * - Tables, Views - - ✓ + - Yes - * - Aliases, ``AS`` - - ✓ + - Yes - * - ``JOIN`` - ``INNER``, ``LEFT [ OUTER ]``, ``RIGHT [ OUTER ]``, ``CROSS`` - - ✓ + - Yes - * - Table expression subqueries - - ✓ + - Yes - * - Scalar subqueries - - ✗ + - No - @@ -259,34 +256,34 @@ Read more about :ref:`scalar_expressions`. - Supported - Further information * - Common functions - - ✓ + - Yes - ``CURRENT_TIMESTAMP``, ``SUBSTRING``, ``TRIM``, ``EXTRACT``, etc. * - Comparison operators - - ✓ + - Yes - ``<``, ``<=``, ``>``, ``>=``, ``=``, ``<>, !=``, ``IS``, ``IS NOT`` * - Boolean operators - - ✓ + - Yes - ``AND``, ``NOT``, ``OR`` * - Conditional expressions - - ✓ + - Yes - ``CASE .. WHEN`` * - Conditional functions - - ✓ + - Yes - ``COALESCE`` * - Pattern matching - - ✓ + - Yes - ``LIKE``, ``RLIKE``, ``ISPREFIXOF``, ``CHARINDEX``, ``PATINDEX`` * - REGEX POSIX pattern matching - - ✓ + - Yes - ``RLIKE``, ``REGEXP_COUNT``, ``REGEXP_INSTR``, ``REGEXP_SUBSTR``, * - ``EXISTS`` - - ✗ + - No - * - ``IN``, ``NOT IN`` - Partial - Literal values only * - Bitwise arithmetic - - ✓ + - Yes - ``&``, ``|``, ``XOR``, ``~``, ``>>``, ``<<`` @@ -304,16 +301,16 @@ Read more about :ref:`access_control` in SQream DB. - Supported - Further information * - Roles as users and groups - - ✓ + - Yes - * - Object default permissions - - ✓ + - Yes - * - Column / Row based permissions - - ✗ + - No - * - Object ownership - - ✗ + - No - @@ -329,20 +326,20 @@ Extra Functionality - Supported - Further information * - Information schema - - ✓ + - Yes - :ref:`catalog_reference` * - Views - - ✓ + - Yes - :ref:`create_view` * - Window functions - - ✓ + - Yes - :ref:`window_functions` * - CTEs - - ✓ + - Yes - :ref:`common_table_expressions` * - Saved queries, Saved queries with parameters - - ✓ + - Yes - :ref:`saved_queries` * - Sequences - - ✓ + - Yes - :ref:`identity` From b6b9249dddf1365520566271e6e727a15d6750d2 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 3 Apr 2022 17:16:14 +0300 Subject: [PATCH 035/882] Continued Updating... ... Not done... --- operational_guides/monitoring_query_performance.rst | 2 +- .../sql_functions/scalar_functions/string/char_length.rst | 6 +----- 2 files changed, 2 insertions(+), 6 deletions(-) diff --git a/operational_guides/monitoring_query_performance.rst b/operational_guides/monitoring_query_performance.rst index a38ddc6d0..07897f585 100644 --- a/operational_guides/monitoring_query_performance.rst +++ b/operational_guides/monitoring_query_performance.rst @@ -623,7 +623,7 @@ Common Solutions for Improving Filtering 4. Joins with ``text`` Keys ----------------------------------- -Joins on long text keys, such as ``varchar(100)`` do not perform as well as numeric data types or very short text keys. +Joins on long text keys do not perform as well as numeric data types or very short text keys. Identifying the Situation ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ diff --git a/reference/sql/sql_functions/scalar_functions/string/char_length.rst b/reference/sql/sql_functions/scalar_functions/string/char_length.rst index f89c397ab..47d517975 100644 --- a/reference/sql/sql_functions/scalar_functions/string/char_length.rst +++ b/reference/sql/sql_functions/scalar_functions/string/char_length.rst @@ -7,13 +7,9 @@ CHAR_LENGTH Calculates the number of characters in a string. .. note:: - - * This function is supported on ``TEXT`` only. - + * To get the length in bytes, see :ref:`octet_length`. - * For ``VARCHAR`` strings, the octet length is the number of characters. Use :ref:`len` instead. - Syntax ========== From 15b18684b41d04a14dcc1851f6647f48c9d9b29f Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 5 Apr 2022 13:52:01 +0300 Subject: [PATCH 036/882] Replaced VARCHAR with TEXT --- data_ingestion/avro.rst | 344 ++++++++++++++++++ data_ingestion/orc.rst | 4 +- .../converting_and_casting_types.rst | 2 +- data_type_guides/sql_data_types_string.rst | 2 +- data_type_guides/supported_data_types.rst | 6 +- ...ata_clustering_data_clustering_methods.rst | 6 +- getting_started/creating_your_first_table.rst | 6 +- .../monitoring_query_performance.rst | 36 +- .../seeing_system_objects_as_ddl.rst | 4 +- .../scalar_functions/conditionals/is_null.rst | 2 +- .../date_and_time/eomonth.rst | 2 +- .../date_and_time/extract.rst | 2 +- .../scalar_functions/string/charindex.rst | 4 +- .../scalar_functions/string/isprefixof.rst | 2 +- .../scalar_functions/string/lower.rst | 2 +- .../scalar_functions/string/patindex.rst | 2 +- .../scalar_functions/string/trim.rst | 2 +- .../scalar_functions/string/upper.rst | 2 +- .../ddl_commands/create_function.rst | 2 +- .../ddl_commands/create_table.rst | 12 +- .../monitoring_commands/show_node_info.rst | 2 +- .../utility_commands/drop_saved_query.rst | 55 --- .../utility_commands/dump_database_ddl.rst | 2 +- .../utility_commands/execute_saved_query.rst | 122 ------- .../utility_commands/list_saved_queries.rst | 77 ---- .../recompile_saved_query.rst | 88 ----- .../utility_commands/save_query.rst | 2 +- .../utility_commands/show_saved_query.rst | 61 ---- ...ts_and_running_queries_from_the_editor.rst | 2 +- 29 files changed, 398 insertions(+), 457 deletions(-) create mode 100644 data_ingestion/avro.rst delete mode 100644 reference/sql/sql_statements/utility_commands/drop_saved_query.rst delete mode 100644 reference/sql/sql_statements/utility_commands/execute_saved_query.rst delete mode 100644 reference/sql/sql_statements/utility_commands/list_saved_queries.rst delete mode 100644 reference/sql/sql_statements/utility_commands/recompile_saved_query.rst delete mode 100644 reference/sql/sql_statements/utility_commands/show_saved_query.rst diff --git a/data_ingestion/avro.rst b/data_ingestion/avro.rst new file mode 100644 index 000000000..f74d8875d --- /dev/null +++ b/data_ingestion/avro.rst @@ -0,0 +1,344 @@ +.. _avro: + +************************** +Inserting Data from Avro +************************** +The **Inserting Data from Avro** page describes inserting data from Avro into SQream and includes the following: + +.. contents:: + :local: + :depth: 1 + +Overview +=========== +**Avro** is a well-known data serialization system that relies on schemas. Due to its flexibility and nesting as an efficient data storage method, SQream supports the Avro binary data format as an alternative to JSON. + +Avro Data Types +=========== + +Avro includes the following data types: + +.. contents:: + :local: + :depth: 1 + +Primitive Data Types +-------------- +The following table shows the supported **Primitive** data types: + ++-------------+------------------------------------------------------+ +| Avro Type | SQream Type | +| +-----------+---------------+-----------+--------------+ +| | Number | Date/Datetime | String | Boolean | ++=============+===========+===============+===========+==============+ +| ``null`` | Supported | Supported | Supported | Supported | ++-------------+-----------+---------------+-----------+--------------+ +| ``boolean`` | | | Supported | Supported | ++-------------+-----------+---------------+-----------+--------------+ +| ``int`` | Supported | | Supported | | ++-------------+-----------+---------------+-----------+--------------+ +| ``long`` | Supported | | Supported | | ++-------------+-----------+---------------+-----------+--------------+ +| ``float`` | Supported | | Supported | | ++-------------+-----------+---------------+-----------+--------------+ +| ``double`` | Supported | | Supported | | ++-------------+-----------+---------------+-----------+--------------+ +| ``bytes`` | | | | | ++-------------+-----------+---------------+-----------+--------------+ +| ``string`` | | Supported | Supported | | ++-------------+-----------+---------------+-----------+--------------+ + + + + + + +Complex Data Types +-------------- +The following table shows the supported **Complex** data types: + ++------------+---------------------------------------------------+ +| | SQream Type | +| +-----------+---------------+-----------+-----------+ +|Avro Type | Number | Date/Datetime | String | Boolean | ++============+===========+===============+===========+===========+ +| ``record`` | | | | | ++------------+-----------+---------------+-----------+-----------+ +| ``enum`` | | | Supported | | ++------------+-----------+---------------+-----------+-----------+ +| ``array`` | | | | | ++------------+-----------+---------------+-----------+-----------+ +| ``map`` | | | | | ++------------+-----------+---------------+-----------+-----------+ +| ``union`` | Supported | Supported | Supported | Supported | ++------------+-----------+---------------+-----------+-----------+ +| ``fixed`` | | | | | ++------------+-----------+---------------+-----------+-----------+ + + +Logical Data Types +-------------- +The following table shows the supported **Logical** data types: + ++----------------------------+-------------------------------------------------+ +| Avro Type | SQream Type | +| +-----------+---------------+-----------+---------+ +| | Number | Date/Datetime | String | Boolean | ++============================+===========+===============+===========+=========+ +| ``decimal`` | Supported | | Supported | | ++----------------------------+-----------+---------------+-----------+---------+ +| ``uuid`` | | | Supported | | ++----------------------------+-----------+---------------+-----------+---------+ +| ``date`` | | Supported | Supported | | ++----------------------------+-----------+---------------+-----------+---------+ +| ``time-millis`` | | | | | ++----------------------------+-----------+---------------+-----------+---------+ +| ``time-micros`` | | | | | ++----------------------------+-----------+---------------+-----------+---------+ +| ``timestamp-millis`` | | Supported | Supported | | ++----------------------------+-----------+---------------+-----------+---------+ +| ``timestamp-micros`` | | Supported | Supported | | ++----------------------------+-----------+---------------+-----------+---------+ +| ``local-timestamp-millis`` | | | | | ++----------------------------+-----------+---------------+-----------+---------+ +| ``local-timestamp-micros`` | | | | | ++----------------------------+-----------+---------------+-----------+---------+ +| ``duration`` | | | | | ++----------------------------+-----------+---------------+-----------+---------+ + + +Mapping Objects to Rows +=============== +When mapping objects to rows, each Avro object or message must contain one ``record`` type object corresponding to a single row in SQream. The ``record`` fields are associated by name to their target table columns. + +Additional unmapped fields will be ignored. Note that using the JSONPath option overrides this. + +Ingesting Avro Files +==================== +This section describes how to ingest Avro files into SQream and covers the following: + + +.. contents:: + :local: + :depth: 1 + + +Preparing Your Avro Source File +---------- +Prepare your Avro source files according to the following requirements: + +* RFC 4180 standard CSV files, but can also be modified to support non-standard CSVs (with multi-character delimiters, unquoted fields, etc). + + :: + +* Files are encoded with UTF-8 or ASCII. + + :: + +* Field delimiter is an ASCII character or characters. + + :: + +* Record delimiter, also known as a new line separator, is a Unix-style newline (``\n``), DOS-style newline (``\r\n``), or Mac style newline (``\r``). + + :: + +* If a field is quoted, any double quote that appears must be double-quoted (similar to the :ref:`string literals quoting rules`. For example, to encode ``What are "birds"?``, the field should appear as ``"What are ""birds""?"``. + + :: + +* Fields can be enclosed by double-quotes (optional), or mandatory quotes if they contain one of the following characters: + + * The record delimiter or field delimiter. + + :: + + * A double quote character. + + :: + + * A newline. + +SQream does not support other modes of escaping, such as ``1,"What are \"birds\"?"``. + +``NULL`` values can be marked in the following ways in Avro files: + + * An explicit null marker. For example, ``col1,\N,col3``. + + :: + + * An empty field delimited by the field delimiter. For example, ``col1,,col3``. + + .. note:: If a text field is quoted but contains no content (``""``) it is considered an empty text field and not ``NULL``. + +For more information about standard CSV files, see `RFC 4180 standard CSVs `_. + +Making Avro Files Accessible to Workers +--------------------- +To give workers access to files every node must have the same view of the storage being used. + +The following apply for Avro files to be accessible to workers: + +* For files hosted on NFS, ensure that the mount is accessible from all servers. + +* For HDFS, ensure that SQream servers have access to the HDFS name node with the correct **user-id**. For more information, see :ref:`hdfs`. + +* For S3, ensure network access to the S3 endpoint. For more information, see :ref:`s3`. + +For more information about restricted worker access, see :ref:`workload_manager`. + +Basing Your Table Structure on Inserted Tables +--------------------- +Before loading data, you must build the ``CREATE EXTERNAL TABLE`` to correspond with the file structure of the inserted table. + +The example in this section is based on the source ``nba.parquet`` table shown below: + +.. csv-table:: nba.parquet + :file: nba-t10.csv + :widths: auto + :header-rows: 1 + +The following example shows the correct file structure used to create the ``CREATE EXTERNAL TABLE`` statement based on the **nba.parquet** table: + +.. code-block:: postgres + + CREATE FOREIGN TABLE ext_nba + ( + Name TEXT(40), + Team TEXT(40), + Number BIGINT, + Position TEXT(2), + Age BIGINT, + Height TEXT(4), + Weight BIGINT, + College TEXT(40), + Salary FLOAT + ) + WRAPPER parquet_fdw + OPTIONS + ( + LOCATION = 's3://sqream-demo-data/nba.parquet' + ); + +.. tip:: + + An exact match must exist between the SQream and Avro types. For unsupported column types, you can set the type to any type and exclude it from subsequent queries. + +.. note:: The **nba.parquet** file is stored on S3 at ``s3://sqream-demo-data/nba.parquet``. + +Verifying Your Table Output +--------------------- +Because external tables do not automatically verify the file integrity or structure, you must manually verify that the table output is identical to the original inserted table. + +The following is an example of the output based on the **nba.parquet** table: + +.. code-block:: psql + + t=> SELECT * FROM ext_nba LIMIT 10; + Name | Team | Number | Position | Age | Height | Weight | College | Salary + --------------+----------------+--------+----------+-----+--------+--------+-------------------+--------- + Avery Bradley | Boston Celtics | 0 | PG | 25 | 6-2 | 180 | Texas | 7730337 + Jae Crowder | Boston Celtics | 99 | SF | 25 | 6-6 | 235 | Marquette | 6796117 + John Holland | Boston Celtics | 30 | SG | 27 | 6-5 | 205 | Boston University | + R.J. Hunter | Boston Celtics | 28 | SG | 22 | 6-5 | 185 | Georgia State | 1148640 + Jonas Jerebko | Boston Celtics | 8 | PF | 29 | 6-10 | 231 | | 5000000 + Amir Johnson | Boston Celtics | 90 | PF | 29 | 6-9 | 240 | | 12000000 + Jordan Mickey | Boston Celtics | 55 | PF | 21 | 6-8 | 235 | LSU | 1170960 + Kelly Olynyk | Boston Celtics | 41 | C | 25 | 7-0 | 238 | Gonzaga | 2165160 + Terry Rozier | Boston Celtics | 12 | PG | 22 | 6-2 | 190 | Louisville | 1824360 + Marcus Smart | Boston Celtics | 36 | PG | 22 | 6-4 | 220 | Oklahoma State | 3431040 + +.. note:: If your table output has errors, verify that the structure of the Avro files correctly corresponds to the external table structure that you created. + +Loading Data into SQream +--------------------- + +Syntax +~~~~~~~~~~~~~~~~~~~~~ +The following is the correct syntax for loading data into SQream: + +.. code-block:: postgres + + CREATE TABLE
AS + SELECT * FROM ; + +The following is an example of loading data into SQream: + +.. code-block:: postgres + + CREATE TABLE nba AS + SELECT * FROM ext_nba; + +For more information about the **CREATE TABLE AS** statement, see :ref:`create_table_as`. + +Examples +~~~~~~~~~~~~~~~~~~~~~ + +This section includes the following examples of loading data into SQream: + +.. contents:: + :local: + :depth: 1 + +Omitting Unsupported Column Types +********************** +When loading data, you can omit columns using the ``NULL as`` argument. You can use this argument to omit unsupported columns from queries that access external tables. By omitting them, these columns will not be called and will avoid generating a "type mismatch" error. + +In the example below, the ``Position`` column is not supported due its type. + +.. code-block:: postgres + + CREATE TABLE nba AS + SELECT Name, Team, Number, NULL as Position, Age, Height, Weight, College, Salary FROM ext_nba; + + +Modifying Data Before Loading +********************** +One of the main reasons for staging data using the ``EXTERNAL TABLE`` argument is to examine and modify table contents before loading it into SQream. + +For example, we can replace pounds with kilograms using the :ref:`create_table_as` statement + +In the example below, the ``Position`` column is set to the default ``NULL``. + +.. code-block:: postgres + + CREATE TABLE nba AS + SELECT name, team, number, NULL as Position, age, height, (weight / 2.205) as weight, college, salary + FROM ext_nba + ORDER BY weight; + + +Loading a Table from a Directory of Avro Files on HDFS +********************** +The following is an example of loading a table from a directory of Avro files on HDFS: + +.. code-block:: postgres + + CREATE FOREIGN TABLE ext_users + (id INT NOT NULL, name TEXT(30) NOT NULL, email TEXT(50) NOT NULL) + WRAPPER parquet_fdw + OPTIONS + ( + LOCATION = 'hdfs://hadoop-nn.piedpiper.com/rhendricks/users/*.parquet' + ); + + CREATE TABLE users AS SELECT * FROM ext_users; + +For more configuration option examples, see the `CREATE FOREIGN TABLE parameters `_. + +Loading a Table from a Directory of Avro Files on S3 +********************** +The following is an example of loading a table from a directory of Avro files on S3: + +.. code-block:: postgres + + CREATE FOREIGN TABLE ext_users + (id INT NOT NULL, name TEXT(30) NOT NULL, email TEXT(50) NOT NULL) + WRAPPER parquet_fdw + OPTIONS + ( LOCATION = 's3://pp-secret-bucket/users/*.parquet', + AWS_ID = 'our_aws_id', + AWS_SECRET = 'our_aws_secret' + ); + + CREATE TABLE users AS SELECT * FROM ext_users; \ No newline at end of file diff --git a/data_ingestion/orc.rst b/data_ingestion/orc.rst index 61e9237f9..cfcf6c38b 100644 --- a/data_ingestion/orc.rst +++ b/data_ingestion/orc.rst @@ -288,7 +288,7 @@ Loading a table from a directory of ORC files on HDFS .. code-block:: postgres CREATE FOREIGN TABLE ext_users - (id INT NOT NULL, name TEXT(30) NOT NULL, email VARCHAR(50) NOT NULL) + (id INT NOT NULL, name TEXT(30) NOT NULL, email TEXT(50) NOT NULL) WRAPPER orc_fdw OPTIONS ( @@ -303,7 +303,7 @@ Loading a table from a bucket of files on S3 .. code-block:: postgres CREATE FOREIGN TABLE ext_users - (id INT NOT NULL, name TEXT(30) NOT NULL, email VARCHAR(50) NOT NULL) + (id INT NOT NULL, name TEXT(30) NOT NULL, email TEXT(50) NOT NULL) WRAPPER orc_fdw OPTIONS ( LOCATION = 's3://pp-secret-bucket/users/*.ORC', diff --git a/data_type_guides/converting_and_casting_types.rst b/data_type_guides/converting_and_casting_types.rst index ee5e273da..e4de6eeb7 100644 --- a/data_type_guides/converting_and_casting_types.rst +++ b/data_type_guides/converting_and_casting_types.rst @@ -15,7 +15,7 @@ You can rectify this by casting the value to a larger data type, as shown below: SQream supports the following three data conversion types: -* ``CAST( TO )``, to convert a value from one type to another. For example, ``CAST('1997-01-01' TO DATE)``, ``CAST(3.45 TO SMALLINT)``, ``CAST(some_column TO VARCHAR(30))``. +* ``CAST( TO )``, to convert a value from one type to another. For example, ``CAST('1997-01-01' TO DATE)``, ``CAST(3.45 TO SMALLINT)``, ``CAST(some_column TO TEXT(30))``. :: diff --git a/data_type_guides/sql_data_types_string.rst b/data_type_guides/sql_data_types_string.rst index 4b1a1b406..df4261d8f 100644 --- a/data_type_guides/sql_data_types_string.rst +++ b/data_type_guides/sql_data_types_string.rst @@ -9,7 +9,7 @@ SQream UTF-8 representations (``TEXT``). Length ^^^^^^^^^ -When using ``TEXT``, specifying a size is optional. If not specified, the text field carries no constraints. To limit the size of the input, use ``VARCHAR(n)`` or ``TEXT(n)``, where ``n`` is the permitted number of characters. +When using ``TEXT``, specifying a size is optional. If not specified, the text field carries no constraints. To limit the size of the input, use ``TEXT(n)``, where ``n`` is the permitted number of characters. The following apply to setting the String type length: diff --git a/data_type_guides/supported_data_types.rst b/data_type_guides/supported_data_types.rst index 2743b054b..afc735ad1 100644 --- a/data_type_guides/supported_data_types.rst +++ b/data_type_guides/supported_data_types.rst @@ -51,17 +51,17 @@ The following table shows the supported data types. - 8 bytes - ``0.000003`` - ``FLOAT``/``DOUBLE PRECISION`` - * - ``TEXT [(n)]``, ``NVARCHAR (n)`` + * - ``TEXT [(n)]`` - Variable length string - UTF-8 unicode - Up to ``4*n`` bytes - ``'キウイは楽しい鳥です'`` - - ``CHAR VARYING``, ``CHAR``, ``CHARACTER VARYING``, ``CHARACTER``, ``NATIONAL CHARACTER VARYING``, ``NATIONAL CHARACTER``, ``NCHAR VARYING``, ``NCHAR``, ``NVARCHAR`` + - ``CHAR VARYING``, ``CHAR``, ``CHARACTER VARYING``, ``CHARACTER``, ``NATIONAL CHARACTER VARYING``, ``NATIONAL CHARACTER``, ``NCHAR VARYING``, ``NCHAR`` * - ``NUMERIC`` - 38 digits - 16 bytes - ``0.123245678901234567890123456789012345678`` - ``DECIMAL`` - * - ``VARCHAR (n)`` + * - ``TEXT (n)`` - Variable length string - ASCII only - ``n`` bytes - ``'Kiwis have tiny wings, but cannot fly.'`` diff --git a/feature_guides/flexible_data_clustering_data_clustering_methods.rst b/feature_guides/flexible_data_clustering_data_clustering_methods.rst index 347be830a..6949547ba 100644 --- a/feature_guides/flexible_data_clustering_data_clustering_methods.rst +++ b/feature_guides/flexible_data_clustering_data_clustering_methods.rst @@ -63,7 +63,7 @@ Best Practices for Time-Based Management ~~~~~~~~~~ Data inserted in bulks is automatically timestamped with the insertion date and time. Therefore, inserting data through small and frequent bulks has the effect of naturally ordering data according to timestamp. Frequent bulks generally refers to short time frames, such as at 15-minute, hourly, or daily intervals. As you insert new data, SQream chunks and appends it into your existing tables according to its timestamp. -The ``DATE`` and ``DATETIME`` types were created to improve performance, minimze storage size, and maintain data integrity. SQream recommends using them instead of ``VARCHAR``. +The ``DATE`` and ``DATETIME`` types were created to improve performance, minimze storage size, and maintain data integrity. SQream recommends using them instead of ``TEXT``. Using Clustering Keys ============ @@ -76,9 +76,9 @@ A clustering key is a subset of table columns or expressions and is defined usin .. code-block:: postgres CREATE TABLE users ( - name VARCHAR(30) NOT NULL, + name TEXT(30) NOT NULL, start_date datetime not null, - country VARCHAR(30) DEFAULT 'Unknown' NOT NULL + country TEXT(30) DEFAULT 'Unknown' NOT NULL ) CLUSTER BY country; diff --git a/getting_started/creating_your_first_table.rst b/getting_started/creating_your_first_table.rst index c070b43ed..2837907f8 100644 --- a/getting_started/creating_your_first_table.rst +++ b/getting_started/creating_your_first_table.rst @@ -21,7 +21,7 @@ The ``CREATE TABLE`` syntax is used to create your first table. This table inclu CREATE TABLE cool_animals ( id INT NOT NULL, - name VARCHAR(20), + name TEXT(20), weight INT ); @@ -37,7 +37,7 @@ You can drop an existing table and create a new one by adding the ``OR REPLACE`` CREATE OR REPLACE TABLE cool_animals ( id INT NOT NULL, - name VARCHAR(20), + name TEXT(20), weight INT ); @@ -54,7 +54,7 @@ You can list the full, verbose ``CREATE TABLE`` statement for a table by using t test=> SELECT GET_DDL('cool_animals'); create table "public"."cool_animals" ( "id" int not null, - "name" varchar(20), + "name" text(20), "weight" int ); diff --git a/operational_guides/monitoring_query_performance.rst b/operational_guides/monitoring_query_performance.rst index 07897f585..057512968 100644 --- a/operational_guides/monitoring_query_performance.rst +++ b/operational_guides/monitoring_query_performance.rst @@ -47,7 +47,7 @@ First, create a foreign table for the logs .. code-block:: postgres CREATE FOREIGN TABLE logs ( - start_marker VARCHAR(4), + start_marker TEXT(4), row_id BIGINT, timestamp DATETIME, message_level TEXT, @@ -61,7 +61,7 @@ First, create a foreign table for the logs service_name TEXT, message_type_id INT, message TEXT, - end_message VARCHAR(5) + end_message TEXT(5) ) WRAPPER cdv_fdw OPTIONS @@ -636,20 +636,20 @@ For example, consider these two table structures: amt FLOAT NOT NULL, i INT NOT NULL, ts DATETIME NOT NULL, - country_code VARCHAR(3) NOT NULL, - flag VARCHAR(10) NOT NULL, - fk VARCHAR(50) NOT NULL + country_code TEXT(3) NOT NULL, + flag TEXT(10) NOT NULL, + fk TEXT(50) NOT NULL ); CREATE TABLE t_b ( - id VARCHAR(50) NOT NULL + id TEXT(50) NOT NULL prob FLOAT NOT NULL, j INT NOT NULL, ); #. Run a query. - In this example, we will join ``t_a.fk`` with ``t_b.id``, both of which are ``VARCHAR(50)``. + In this example, we will join ``t_a.fk`` with ``t_b.id``, both of which are ``TEXT(50)``. .. code-block:: postgres @@ -688,7 +688,7 @@ For example, consider these two table structures: Improving Query Performance ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -* In general, try to avoid ``VARCHAR`` as a join key. As a rule of thumb, ``BIGINT`` works best as a join key. +* In general, try to avoid ``TEXT`` as a join key. As a rule of thumb, ``BIGINT`` works best as a join key. * Convert text values on-the-fly before running the query. For example, the :ref:`crc64` function takes a text input and returns a ``BIGINT`` hash. @@ -726,10 +726,10 @@ Improving Query Performance * You can map some text values to numeric types by using a dimension table. Then, reconcile the values when you need them by joining the dimension table. -5. Sorting on big ``VARCHAR`` fields +5. Sorting on big ``TEXT`` fields --------------------------------------- In general, SQream DB automatically inserts a ``Sort`` node which arranges the data prior to reductions and aggregations. -When running a ``GROUP BY`` on large ``VARCHAR`` fields, you may see nodes for ``Sort`` and ``Reduce`` taking a long time. +When running a ``GROUP BY`` on large ``TEXT`` fields, you may see nodes for ``Sort`` and ``Reduce`` taking a long time. Identifying the Situation ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -749,9 +749,9 @@ For example: i INT NOT NULL, amt DOUBLE NOT NULL, ts DATETIME NOT NULL, - country_code VARCHAR(100) NOT NULL, - flag VARCHAR(10) NOT NULL, - string_fk VARCHAR(50) NOT NULL + country_code TEXT(100) NOT NULL, + flag TEXT(10) NOT NULL, + string_fk TEXT(50) NOT NULL ); We will run a query, and inspect it's execution details: @@ -800,16 +800,16 @@ For example: max --- 3 - With a maximum string length of just 3 characters, our ``VARCHAR(100)`` is way oversized. + With a maximum string length of just 3 characters, our ``TEXT(100)`` is way oversized. #. - We can recreate the table with a more restrictive ``VARCHAR(3)``, and can examine the difference in performance: + We can recreate the table with a more restrictive ``TEXT(3)``, and can examine the difference in performance: .. code-block:: psql t=> CREATE TABLE t_efficient . AS SELECT i, . amt, . ts, - . country_code::VARCHAR(3) AS country_code, + . country_code::TEXT(3) AS country_code, . flag . FROM t_inefficient; executed @@ -832,8 +832,8 @@ For example: Improving Sort Performance on Text Keys ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -When using VARCHAR, ensure that the maximum length defined in the table structure is as small as necessary. -For example, if you're storing phone numbers, don't define the field as ``VARCHAR(255)``, as that affects sort performance. +When using TEXT, ensure that the maximum length defined in the table structure is as small as necessary. +For example, if you're storing phone numbers, don't define the field as ``TEXT(255)``, as that affects sort performance. You can run a query to get the maximum column length (e.g. ``MAX(LEN(a_column))``), and potentially modify the table structure. diff --git a/operational_guides/seeing_system_objects_as_ddl.rst b/operational_guides/seeing_system_objects_as_ddl.rst index 4f9f596dd..2aacb49e8 100644 --- a/operational_guides/seeing_system_objects_as_ddl.rst +++ b/operational_guides/seeing_system_objects_as_ddl.rst @@ -22,7 +22,7 @@ Getting the DDL for a table farm=> SELECT GET_DDL('cool_animals'); create table "public"."cool_animals" ( "id" int not null, - "name" varchar(30) not null, + "name" text(30) not null, "weight" double null, "is_agressive" bool default false not null ) ; @@ -142,7 +142,7 @@ Exporting database DDL to a client farm=> SELECT DUMP_DATABASE_DDL(); create table "public"."cool_animals" ( "id" int not null, - "name" varchar(30) not null, + "name" text(30) not null, "weight" double null, "is_agressive" bool default false not null ) diff --git a/reference/sql/sql_functions/scalar_functions/conditionals/is_null.rst b/reference/sql/sql_functions/scalar_functions/conditionals/is_null.rst index c99f4e7d1..94f8605f7 100644 --- a/reference/sql/sql_functions/scalar_functions/conditionals/is_null.rst +++ b/reference/sql/sql_functions/scalar_functions/conditionals/is_null.rst @@ -40,7 +40,7 @@ For these examples, consider the following table and contents: .. code-block:: postgres - CREATE TABLE t (id INT NOT NULL, name VARCHAR(30), weight INT); + CREATE TABLE t (id INT NOT NULL, name TEXT(30), weight INT); INSERT INTO t VALUES (1, 'Kangaroo', 120), (2, 'Koala', 20), (3, 'Wombat', 60) ,(4, 'Kappa', NULL),(5, 'Echidna', 8),(6, 'Chupacabra', NULL) diff --git a/reference/sql/sql_functions/scalar_functions/date_and_time/eomonth.rst b/reference/sql/sql_functions/scalar_functions/date_and_time/eomonth.rst index 92e3f7940..50bcf7410 100644 --- a/reference/sql/sql_functions/scalar_functions/date_and_time/eomonth.rst +++ b/reference/sql/sql_functions/scalar_functions/date_and_time/eomonth.rst @@ -48,7 +48,7 @@ For these examples, consider the following table and contents: .. code-block:: postgres - CREATE TABLE cool_dates(name VARCHAR(40), d DATE, dt DATETIME); + CREATE TABLE cool_dates(name TEXT(40), d DATE, dt DATETIME); INSERT INTO cool_dates VALUES ('Marty McFly goes back to this time','1955-11-05','1955-11-05 01:21:00.000') , ('Marty McFly came from this time', '1985-10-26', '1985-10-26 01:22:00.000') diff --git a/reference/sql/sql_functions/scalar_functions/date_and_time/extract.rst b/reference/sql/sql_functions/scalar_functions/date_and_time/extract.rst index 2fd79ca86..f0ca54a58 100644 --- a/reference/sql/sql_functions/scalar_functions/date_and_time/extract.rst +++ b/reference/sql/sql_functions/scalar_functions/date_and_time/extract.rst @@ -86,7 +86,7 @@ For these examples, consider the following table and contents: .. code-block:: postgres - CREATE TABLE cool_dates(name VARCHAR(40), d DATE, dt DATETIME); + CREATE TABLE cool_dates(name TEXT(40), d DATE, dt DATETIME); INSERT INTO cool_dates VALUES ('Marty McFly goes back to this time','1955-11-05','1955-11-05 01:21:00.000') , ('Marty McFly came from this time', '1985-10-26', '1985-10-26 01:22:00.000') diff --git a/reference/sql/sql_functions/scalar_functions/string/charindex.rst b/reference/sql/sql_functions/scalar_functions/string/charindex.rst index fa9c89027..3ad4ca1f3 100644 --- a/reference/sql/sql_functions/scalar_functions/string/charindex.rst +++ b/reference/sql/sql_functions/scalar_functions/string/charindex.rst @@ -49,7 +49,7 @@ For these examples, consider the following table and contents: .. code-block:: postgres - CREATE TABLE jabberwocky(line VARCHAR(50)); + CREATE TABLE jabberwocky(line TEXT(50)); INSERT INTO jabberwocky VALUES ('''Twas brillig, and the slithy toves '), (' Did gyre and gimble in the wabe: ') @@ -73,4 +73,4 @@ Using ``CHARINDEX`` "Beware the Jabberwock, my son! | 9 The jaws that bite, the claws that catch! | 27 Beware the Jubjub bird, and shun | 8 - The frumious Bandersnatch!" | 0 + The frumious Bandersnatch!" | 0 \ No newline at end of file diff --git a/reference/sql/sql_functions/scalar_functions/string/isprefixof.rst b/reference/sql/sql_functions/scalar_functions/string/isprefixof.rst index 4a978b1ff..3da356969 100644 --- a/reference/sql/sql_functions/scalar_functions/string/isprefixof.rst +++ b/reference/sql/sql_functions/scalar_functions/string/isprefixof.rst @@ -50,7 +50,7 @@ For these examples, consider the following table and contents: .. code-block:: postgres - CREATE TABLE jabberwocky(line VARCHAR(50)); + CREATE TABLE jabberwocky(line TEXT(50)); INSERT INTO jabberwocky VALUES ('''Twas brillig, and the slithy toves '), (' Did gyre and gimble in the wabe: ') diff --git a/reference/sql/sql_functions/scalar_functions/string/lower.rst b/reference/sql/sql_functions/scalar_functions/string/lower.rst index 69dfd4f1a..4318015dc 100644 --- a/reference/sql/sql_functions/scalar_functions/string/lower.rst +++ b/reference/sql/sql_functions/scalar_functions/string/lower.rst @@ -45,7 +45,7 @@ For these examples, consider the following table and contents: .. code-block:: postgres - CREATE TABLE jabberwocky(line VARCHAR(50)); + CREATE TABLE jabberwocky(line TEXT(50)); INSERT INTO jabberwocky VALUES ('''Twas brillig, and the slithy toves'), (' Did gyre and gimble in the wabe:') diff --git a/reference/sql/sql_functions/scalar_functions/string/patindex.rst b/reference/sql/sql_functions/scalar_functions/string/patindex.rst index 063fe6d5c..b1ffcda9b 100644 --- a/reference/sql/sql_functions/scalar_functions/string/patindex.rst +++ b/reference/sql/sql_functions/scalar_functions/string/patindex.rst @@ -69,7 +69,7 @@ Notes * If the value is NULL, the result is NULL. -* PATINDEX works on ``VARCHAR`` text types only. +* PATINDEX works on ``TEXT`` text types only. * PATINDEX does not work on all literal values - only on column values. diff --git a/reference/sql/sql_functions/scalar_functions/string/trim.rst b/reference/sql/sql_functions/scalar_functions/string/trim.rst index d6e90c2f8..d249c8952 100644 --- a/reference/sql/sql_functions/scalar_functions/string/trim.rst +++ b/reference/sql/sql_functions/scalar_functions/string/trim.rst @@ -35,7 +35,7 @@ Returns the same type as the argument supplied. Notes ======= -* When using ``VARCHAR`` values, SQream DB automatically trims the trailing whitespace. +* When using ``TEXT`` values, SQream DB automatically trims the trailing whitespace. * This function is equivalent to the ANSI form ``TRIM( BOTH FROM expr )`` diff --git a/reference/sql/sql_functions/scalar_functions/string/upper.rst b/reference/sql/sql_functions/scalar_functions/string/upper.rst index 219bc854e..1f9cc1b96 100644 --- a/reference/sql/sql_functions/scalar_functions/string/upper.rst +++ b/reference/sql/sql_functions/scalar_functions/string/upper.rst @@ -45,7 +45,7 @@ For these examples, consider the following table and contents: .. code-block:: postgres - CREATE TABLE jabberwocky(line VARCHAR(50)); + CREATE TABLE jabberwocky(line TEXT(50)); INSERT INTO jabberwocky VALUES ('''Twas brillig, and the slithy toves'), (' Did gyre and gimble in the wabe:') diff --git a/reference/sql/sql_statements/ddl_commands/create_function.rst b/reference/sql/sql_statements/ddl_commands/create_function.rst index 339543a0a..a693fc897 100644 --- a/reference/sql/sql_statements/ddl_commands/create_function.rst +++ b/reference/sql/sql_statements/ddl_commands/create_function.rst @@ -52,7 +52,7 @@ Parameters * - ``argument_list`` - A comma separated list of column definitions. A column definition includes a name identifier and a datatype. * - ``return_type`` - - The SQL datatype of the return value, such as ``INT``, ``VARCHAR``, etc. + - The SQL datatype of the return value, such as ``INT``, ``TEXT``, etc. * - ``function_body`` - Python code, dollar-quoted (``$$``). diff --git a/reference/sql/sql_statements/ddl_commands/create_table.rst b/reference/sql/sql_statements/ddl_commands/create_table.rst index b660e442c..2689c6aca 100644 --- a/reference/sql/sql_statements/ddl_commands/create_table.rst +++ b/reference/sql/sql_statements/ddl_commands/create_table.rst @@ -141,7 +141,7 @@ The following is an example of the syntax used to create a standard table: CREATE TABLE cool_animals ( id INT NOT NULL, - name varchar(30) NOT NULL, + name text(30) NOT NULL, weight FLOAT, is_agressive BOOL ); @@ -155,7 +155,7 @@ The following is an example of the syntax used to create a table with default va CREATE TABLE cool_animals ( id INT NOT NULL, - name varchar(30) NOT NULL, + name text(30) NOT NULL, weight FLOAT, is_agressive BOOL DEFAULT false NOT NULL ); @@ -171,8 +171,8 @@ The following is an example of the syntax used to create a table with an identit CREATE TABLE users ( id BIGINT IDENTITY(0,1) NOT NULL , -- Start with 0, increment by 1 - name VARCHAR(30) NOT NULL, - country VARCHAR(30) DEFAULT 'Unknown' NOT NULL + name TEXT(30) NOT NULL, + country TEXT(30) DEFAULT 'Unknown' NOT NULL ); .. note:: @@ -203,9 +203,9 @@ The following is an example of the syntax used to create a table with a clusteri .. code-block:: postgres CREATE TABLE users ( - name VARCHAR(30) NOT NULL, + name TEXT(30) NOT NULL, start_date datetime not null, - country VARCHAR(30) DEFAULT 'Unknown' NOT NULL + country TEXT(30) DEFAULT 'Unknown' NOT NULL ) CLUSTER BY start_date; For more information on data clustering, see :ref:`data_clustering`. diff --git a/reference/sql/sql_statements/monitoring_commands/show_node_info.rst b/reference/sql/sql_statements/monitoring_commands/show_node_info.rst index 345d16440..9c1e1ec11 100644 --- a/reference/sql/sql_statements/monitoring_commands/show_node_info.rst +++ b/reference/sql/sql_statements/monitoring_commands/show_node_info.rst @@ -108,7 +108,7 @@ This is a full list of node types: - Compress data with both CPU and GPU schemes * - ``CpuDecompress`` - CPU - - Decompression operation, common for longer ``VARCHAR`` types + - Decompression operation, common for longer ``TEXT`` types * - ``CpuLoopJoin`` - CPU - A non-indexed nested loop join, performed on the CPU diff --git a/reference/sql/sql_statements/utility_commands/drop_saved_query.rst b/reference/sql/sql_statements/utility_commands/drop_saved_query.rst deleted file mode 100644 index f7faef6c5..000000000 --- a/reference/sql/sql_statements/utility_commands/drop_saved_query.rst +++ /dev/null @@ -1,55 +0,0 @@ -.. _drop_saved_query: - -******************** -DROP_SAVED_QUERY -******************** - -``DROP_SAVED_QUERY`` drops a :ref:`previously saved query`. - -Read more in the :ref:`saved_queries` guide. - -See also: ref:`save_query`, :ref:`execute_saved_query`, ref:`show_saved_query`, ref:`list_saved_queries`. - -Permissions -============= - -Dropping a saved query requires no special permissions. - -Syntax -========== - -.. code-block:: postgres - - drop_saved_query_statement ::= - SELECT DROP_SAVED_QUERY(saved_query_name) - ; - - saved_query_name ::= string_literal - -Returns -========== - -If saved query is dropped successfully, returns nothing. - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``saved_query_name`` - - The name of the query to drop - -Examples -=========== - -Dropping a previously saved query ---------------------------------------- - -.. code-block:: psql - - t=> SELECT DROP_SAVED_QUERY('select_all'); - executed diff --git a/reference/sql/sql_statements/utility_commands/dump_database_ddl.rst b/reference/sql/sql_statements/utility_commands/dump_database_ddl.rst index bf246b803..fc9ca1282 100644 --- a/reference/sql/sql_statements/utility_commands/dump_database_ddl.rst +++ b/reference/sql/sql_statements/utility_commands/dump_database_ddl.rst @@ -51,7 +51,7 @@ Getting the DDL for a database farm=> SELECT DUMP_DATABASE_DDL(); create table "public"."cool_animals" ( "id" int not null, - "name" varchar(30) not null, + "name" text(30) not null, "weight" double null, "is_agressive" bool default false not null ) diff --git a/reference/sql/sql_statements/utility_commands/execute_saved_query.rst b/reference/sql/sql_statements/utility_commands/execute_saved_query.rst deleted file mode 100644 index 9232a5162..000000000 --- a/reference/sql/sql_statements/utility_commands/execute_saved_query.rst +++ /dev/null @@ -1,122 +0,0 @@ -.. _execute_saved_query: - -******************** -EXECUTE_SAVED_QUERY -******************** - -``EXECUTE_SAVED_QUERY`` executes a :ref:`previously saved query`. - -Read more in the :ref:`saved_queries` guide. - -See also: ref:`save_query`, :ref:`drop_saved_query`, ref:`show_saved_query`, ref:`list_saved_queries`. - -Permissions -============= - -Executing a saved query requires ``SELECT`` permissions to access the tables referenced in the query. - -Syntax -========== - -.. code-block:: postgres - - execute_saved_query_statement ::= - SELECT EXECUTE_SAVED_QUERY(saved_query_name, [ , argument [ , ... ] ] ) - ; - - saved_query_name ::= string_literal - - argument ::= string_literal | number_literal - -Returns -========== - -Query execution results, based on the query saved. - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``saved_query_name`` - - The name of the query to execute - * - ``argument`` - - A comma separated list of argument literal values - - -Notes -========= - -* Query parameters can be used as substitutes for literal expressions. Parameters cannot be used to substitute identifiers, column names, table names, or other parts of the query. - -* Query parameters of a string datatype (like ``VARCHAR``) must be of a fixed length, and can be used in equality checks, but not patterns (e.g. :ref:`like`, :ref:`rlike`, etc) - -* Query parameters' types are inferred at compile time. - -Examples -=========== - -Assume a table named ``nba``, with the following structure: - -.. code-block:: postgres - - CREATE TABLE nba - ( - Name text(40), - Team text(40), - Number tinyint, - Position text(2), - Age tinyint, - Height text(4), - Weight real, - College text(40), - Salary float - ); - - -Here's a peek at the table contents (:download:`Download nba.csv `): - -.. csv-table:: nba.csv - :file: nba-t10.csv - :widths: auto - :header-rows: 1 - - -Saving and executing a simple query ---------------------------------------- - -.. code-block:: psql - - t=> SELECT SAVE_QUERY('select_all','SELECT * FROM nba'); - executed - t=> SELECT EXECUTE_SAVED_QUERY('select_all'); - Name | Team | Number | Position | Age | Height | Weight | College | Salary - -------------------------+------------------------+--------+----------+-----+--------+--------+-----------------------+--------- - Avery Bradley | Boston Celtics | 0 | PG | 25 | 6-2 | 180 | Texas | 7730337 - Jae Crowder | Boston Celtics | 99 | SF | 25 | 6-6 | 235 | Marquette | 6796117 - John Holland | Boston Celtics | 30 | SG | 27 | 6-5 | 205 | Boston University | - R.J. Hunter | Boston Celtics | 28 | SG | 22 | 6-5 | 185 | Georgia State | 1148640 - [...] - -Saving and executing parametrized query ------------------------------------------- - -Use parameters to replace them later at execution time. - -.. tip:: Use dollar quoting (`$$`) to avoid escaping strings. - -.. code-block:: psql - - t=> SELECT SAVE_QUERY('select_by_weight_and_team',$$SELECT * FROM nba WHERE Weight > ? AND Team = ?$$); - executed - t=> SELECT EXECUTE_SAVED_QUERY('select_by_weight_and_team', 240, 'Toronto Raptors'); - Name | Team | Number | Position | Age | Height | Weight | College | Salary - ------------------+-----------------+--------+----------+-----+--------+--------+-------------+-------- - Bismack Biyombo | Toronto Raptors | 8 | C | 23 | 6-9 | 245 | | 2814000 - James Johnson | Toronto Raptors | 3 | PF | 29 | 6-9 | 250 | Wake Forest | 2500000 - Jason Thompson | Toronto Raptors | 1 | PF | 29 | 6-11 | 250 | Rider | 245177 - Jonas Valanciunas | Toronto Raptors | 17 | C | 24 | 7-0 | 255 | | 4660482 \ No newline at end of file diff --git a/reference/sql/sql_statements/utility_commands/list_saved_queries.rst b/reference/sql/sql_statements/utility_commands/list_saved_queries.rst deleted file mode 100644 index bb1781840..000000000 --- a/reference/sql/sql_statements/utility_commands/list_saved_queries.rst +++ /dev/null @@ -1,77 +0,0 @@ -.. _list_saved_queries: - -******************** -LIST_SAVED_QUERIES -******************** - -``LIST_SAVED_QUERIES`` lists the available :ref:`previously saved queries`. - -This is an alternative way to using the ``savedqueries`` catalog view. - -Read more in the :ref:`saved_queries` guide. - -See also: ref:`save_query`, :ref:`execute_saved_query`, ref:`drop_saved_query`, ref:`show_saved_query`. - -Permissions -============= - -Listing the saved queries requires no special permissions. - -Syntax -========== - -.. code-block:: postgres - - list_saved_queries_statement ::= - SELECT LIST_SAVED_QUERIES() - ; - -Returns -========== - -List of saved query names, one per row. - -Parameters -============ - -None - -Notes -========= - -This statement returns an empty result set if no saved queries exist in the current database. - -Examples -=========== - -Listing previously saved queries ---------------------------------------- - -.. code-block:: psql - - t=> SELECT LIST_SAVED_QUERIES(); - saved_query - ------------------------- - select_all - select_by_weight - select_by_weight_and_team - - t=> SELECT SHOW_SAVED_QUERY('select_by_weight_and_team'); - saved_query - ----------------------------------------------- - SELECT * FROM nba WHERE Weight > ? AND Team = ? - - -Listing saved queries with the catalog ---------------------------------------------- - -Using the :ref:`catalog` is also possible: - -.. code-block:: psql - - t=> SELECT * FROM sqream_catalog.savedqueries; - name | num_parameters - --------------------------+--------------- - select_all | 0 - select_by_weight | 1 - select_by_weight_and_team | 2 diff --git a/reference/sql/sql_statements/utility_commands/recompile_saved_query.rst b/reference/sql/sql_statements/utility_commands/recompile_saved_query.rst deleted file mode 100644 index d6b63e30e..000000000 --- a/reference/sql/sql_statements/utility_commands/recompile_saved_query.rst +++ /dev/null @@ -1,88 +0,0 @@ -.. _recompile_saved_query: - -************************** -RECOMPILE_SAVED_QUERY -************************** - -``RECOMPILE_SAVED_QUERY`` recompiles a saved query that has been invalidated due to a schema change. - -Permissions -============= - -Recompiling a saved query requires no special permissions. - -Syntax -========== - -.. code-block:: postgres - - recompile_saved_query_statement ::= - SELECT RECOMPILE_SAVED_QUERY(saved_query_name) - ; - - saved_query_name ::= string_literal - -Returns -========== - -If saved query is recompiled successfully, returns nothing. - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``saved_query_name`` - - The name of the query to recompile - -Examples -=========== - -Recreating a query that has been invalidated -------------------------------------------------- - -.. code-block:: psql - - t=> SELECT SAVE_QUERY('select_by_weight_and_team',$$SELECT * FROM nba WHERE Weight > ? AND Team = ?$$); - executed - t=> SELECT EXECUTE_SAVED_QUERY('select_by_weight_and_team', 240, 'Toronto Raptors'); - Name | Team | Number | Position | Age | Height | Weight | College | Salary - ------------------+-----------------+--------+----------+-----+--------+--------+-------------+-------- - Bismack Biyombo | Toronto Raptors | 8 | C | 23 | 6-9 | 245 | | 2814000 - James Johnson | Toronto Raptors | 3 | PF | 29 | 6-9 | 250 | Wake Forest | 2500000 - Jason Thompson | Toronto Raptors | 1 | PF | 29 | 6-11 | 250 | Rider | 245177 - Jonas Valanciunas | Toronto Raptors | 17 | C | 24 | 7-0 | 255 | | 4660482 - - -To invalidate the original saved query, we will change the schema without affecting our original query text: - -.. code-block:: psql - - t=> ALTER TABLE nba RENAME COLUMN age to "Age (as of 2015)"; - executed - -However, because the query was compiled previously, this change invalidates the query and causes it to fail: - -.. code-block:: psql - - t=> SELECT EXECUTE_SAVED_QUERY('select_by_weight_and_team', 240, 'Toronto Raptors'); - Error: column not found {Age@null} - column not found {Age@null} - -Recompiling the query will fix this issue - -.. code-block:: psql - - t=> SELECT RECOMPILE_SAVED_QUERY('select_by_weight_and_team'); - executed - t=> SELECT EXECUTE_SAVED_QUERY('select_by_weight_and_team', 240, 'Toronto Raptors'); - Name | Team | Number | Position | Age (as of 2015) | Height | Weight | College | Salary - ------------------+-----------------+--------+----------+------------------+--------+--------+-------------+-------- - Bismack Biyombo | Toronto Raptors | 8 | C | 23 | 6-9 | 245 | | 2814000 - James Johnson | Toronto Raptors | 3 | PF | 29 | 6-9 | 250 | Wake Forest | 2500000 - Jason Thompson | Toronto Raptors | 1 | PF | 29 | 6-11 | 250 | Rider | 245177 - Jonas Valanciunas | Toronto Raptors | 17 | C | 24 | 7-0 | 255 | | 4660482 diff --git a/reference/sql/sql_statements/utility_commands/save_query.rst b/reference/sql/sql_statements/utility_commands/save_query.rst index f71f6e025..c65cd48ba 100644 --- a/reference/sql/sql_statements/utility_commands/save_query.rst +++ b/reference/sql/sql_statements/utility_commands/save_query.rst @@ -56,7 +56,7 @@ Notes * Query parameters can be used as substitutes for literal expressions. Parameters cannot be used to substitute identifiers, column names, table names, or other parts of the query. -* Query parameters of a string datatype (like ``VARCHAR``) must be of a fixed length, and can be used in equality checks, but not patterns (e.g. :ref:`like`, :ref:`rlike`, etc) +* Query parameters of a string datatype (like ``TEXT``) must be of a fixed length, and can be used in equality checks, but not patterns (e.g. :ref:`like`, :ref:`rlike`, etc) * Query parameters' types are inferred at compile time. diff --git a/reference/sql/sql_statements/utility_commands/show_saved_query.rst b/reference/sql/sql_statements/utility_commands/show_saved_query.rst deleted file mode 100644 index 15ac4c1bd..000000000 --- a/reference/sql/sql_statements/utility_commands/show_saved_query.rst +++ /dev/null @@ -1,61 +0,0 @@ -.. _show_saved_query: - -******************** -SHOW_SAVED_QUERY -******************** - -``SHOW_SAVED_QUERY`` shows the query text for a :ref:`previously saved query`. - -Read more in the :ref:`saved_queries` guide. - -See also: ref:`save_query`, :ref:`execute_saved_query`, ref:`drop_saved_query`, ref:`list_saved_queries`. - -Permissions -============= - -Showing a saved query requires no special permissions. - -Syntax -========== - -.. code-block:: postgres - - show_saved_query_statement ::= - SELECT SHOW_SAVED_QUERY(saved_query_name) - ; - - saved_query_name ::= string_literal - -Returns -========== - -A single row result containing the saved query string. - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``saved_query_name`` - - The name of the query to show - - -Examples -=========== - -Showing a previously saved query ---------------------------------------- - -.. code-block:: psql - - t=> SELECT SAVE_QUERY('select_by_weight_and_team',$$SELECT * FROM nba WHERE Weight > ? AND Team = ?$$); - executed - t=> SELECT SHOW_SAVED_QUERY('select_by_weight_and_team'); - saved_query - ----------------------------------------------- - SELECT * FROM nba WHERE Weight > ? AND Team = ? - diff --git a/sqream_studio_5.4.3/executing_statements_and_running_queries_from_the_editor.rst b/sqream_studio_5.4.3/executing_statements_and_running_queries_from_the_editor.rst index 55369d761..72cbff97b 100644 --- a/sqream_studio_5.4.3/executing_statements_and_running_queries_from_the_editor.rst +++ b/sqream_studio_5.4.3/executing_statements_and_running_queries_from_the_editor.rst @@ -223,7 +223,7 @@ The following table describes the DDL Optimizer screen: * - Column area - Shows the column **names** and **column types** from the selected table. You can scroll down or to the right/left for long column lists. * - Optimization area - - Shows the number of rows to sample as the basis for running an optimization, the default setting (1,000,000) when running an optimization (this is also the overhead threshold used when analyzing ``VARCHAR`` fields), and the default percent buffer to add to ``VARCHAR`` lengths (10%). Attempts to determine field nullability. + - Shows the number of rows to sample as the basis for running an optimization, the default setting (1,000,000) when running an optimization (this is also the overhead threshold used when analyzing ``TEXT`` fields), and the default percent buffer to add to ``TEXT`` lengths (10%). Attempts to determine field nullability. * - Run Optimizer - Starts the optimization process. From 0f8a1b34deb2b9ba4150d81307b08cefd3d94b43 Mon Sep 17 00:00:00 2001 From: YanivGerowitz <82020437+YanivGerowitz@users.noreply.github.com> Date: Sun, 10 Apr 2022 13:26:15 +0300 Subject: [PATCH 037/882] Updated according to TPD-120 Updated according to https://sqream.atlassian.net/browse/TPD-120 (confirmed with Efrat). --- .../sql_syntax/keywords_and_identifiers.rst | 46 ++++++++++--------- 1 file changed, 24 insertions(+), 22 deletions(-) diff --git a/reference/sql/sql_syntax/keywords_and_identifiers.rst b/reference/sql/sql_syntax/keywords_and_identifiers.rst index e5d1a6fcf..bc2cb1de6 100644 --- a/reference/sql/sql_syntax/keywords_and_identifiers.rst +++ b/reference/sql/sql_syntax/keywords_and_identifiers.rst @@ -13,13 +13,13 @@ Regular identifiers must follow these rules: * Must be case-insensitive. SQream converts all identifiers to lowercase unless quoted. * Does not equal any keywords, such as ``SELECT``, ``OR``, or ``AND``, etc. -To bypass the rules above you can surround an identifier with double quotes (``"``). +To bypass the rules above you can surround an identifier with double quotes (``"``) or square brackets (``[]``). Quoted identifiers must follow these rules: -* Must be surrounded with double quotes (``"``). +* Must be surrounded with double quotes (``"``) or square brackets (``[]``). * May contain any ASCII character except ``@``, ``$`` or ``"``. -* Must be case-sensitive and referenced with double quotes. +* Must be case-sensitive and referenced with double quotes or square brackets (``[]``). Identifiers are different than **keywords**, which are predefined words reserved with specific meanings in a statement. Some examples of keywords are ``SELECT``, ``CREATE``, and ``WHERE``. Note that keywords **cannot** be used as identifiers. @@ -28,43 +28,45 @@ The following table shows a full list of the reserved keywords: +-------------------------------------------------------------------------------------------------+ | **Keywords** | +-------------------+---------------------+--------------------+------------------+---------------+ +| **A - C** | **C - G** | **H - N** | **N - S** | **S - W** | ++-------------------+---------------------+--------------------+------------------+---------------+ | ``ALL`` | ``CURRENT_CATALOG`` | ``HASH`` | ``NOT`` | ``SIMILAR`` | +-------------------+---------------------+--------------------+------------------+---------------+ | ``ANALYSE`` | ``CURRENT_ROLE`` | ``HAVING`` | ``NOTNULL`` | ``SOME`` | +-------------------+---------------------+--------------------+------------------+---------------+ | ``ANALYZE`` | ``CURRENT_TIME`` | ``ILIKE`` | ``NULL`` | ``SYMMETRIC`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``AND`` | ``CURRENT_USER`` | ``IN`` | ``OFFSET`` | ``SYMMETRIC`` | -+-------------------+---------------------+--------------------+------------------+---------------+ -| ``ANY`` | ``DEFAULT`` | ``INITIALLY`` | ``ON`` | ``TABLE`` | +| ``AND`` | ``CURRENT_USER`` | ``IN`` | ``OFFSET`` | ``TABLE`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``ARRAY`` | ``DEFERRABLE`` | ``INNER`` | ``ONLY`` | ``THEN`` | +| ``ANY`` | ``DEFAULT`` | ``INITIALLY`` | ``ON`` | ``THEN`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``AS`` | ``DESC`` | ``INTERSECT`` | ``OPTION`` | ``TO`` | +| ``ARRAY`` | ``DEFERRABLE`` | ``INNER`` | ``ONLY`` | ``TO`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``ASC`` | ``DISTINCT`` | ``INTO`` | ``OR`` | ``TRAILING`` | +| ``AS`` | ``DESC`` | ``INTERSECT`` | ``OPTION`` | ``TRAILING`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``AUTHORIZATION`` | ``DO`` | ``IS`` | ``ORDER`` | ``TRUE`` | +| ``ASC`` | ``DISTINCT`` | ``INTO`` | ``OR`` | ``TRUE`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``BINARY`` | ``ELSE`` | ``ISNULL`` | ``OUTER`` | ``UNION`` | +| ``AUTHORIZATION`` | ``DO`` | ``IS`` | ``ORDER`` | ``UNION`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``BOTH`` | ``END`` | ``JOIN`` | ``OVER`` | ``UNIQUE`` | +| ``BINARY`` | ``ELSE`` | ``ISNULL`` | ``OUTER`` | ``UNIQUE`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``CASE`` | ``EXCEPT`` | ``LEADING`` | ``OVERLAPS`` | ``USER`` | +| ``BOTH`` | ``END`` | ``JOIN`` | ``OVER`` | ``USER`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``CAST`` | ``FALSE`` | ``LEFT`` | ``PLACING`` | ``USING`` | +| ``CASE`` | ``EXCEPT`` | ``LEADING`` | ``OVERLAPS`` | ``USING`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``CHECK`` | ``FETCH`` | ``LIKE`` | ``PRIMARY`` | ``VARIADIC`` | +| ``CAST`` | ``FALSE`` | ``LEFT`` | ``PLACING`` | ``VARIADIC`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``COLLATE`` | ``FOR`` | ``LIMIT`` | ``REFERENCES`` | ``VERBOSE`` | +| ``CHECK`` | ``FETCH`` | ``LIKE`` | ``PRIMARY`` | ``VERBOSE`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``COLUMN`` | ``FREEZE`` | ``LOCALTIME`` | ``RETURNING`` | ``WHEN`` | +| ``COLLATE`` | ``FOR`` | ``LIMIT`` | ``REFERENCES`` | ``WHEN`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``CONCURRENTLY`` | ``FROM`` | ``LOCALTIMESTAMP`` | ``RIGHT`` | ``WHERE`` | +| ``COLUMN`` | ``FREEZE`` | ``LOCALTIME`` | ``RETURNING`` | ``WHERE`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``CONSTRAINT`` | ``FULL`` | ``LOOP`` | ``RLIKE`` | ``WINDOW`` | +| ``CONCURRENTLY`` | ``FROM`` | ``LOCALTIMESTAMP`` | ``RIGHT`` | ``WINDOW`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``CREATE`` | ``GRANT`` | ``MERGE`` | ``SELECT`` | ``WITH`` | -+-------------------+---------------------+--------------------+------------------+ | -| ``CROSS`` | ``GROUP`` | ``NATURAL`` | ``SESSION_USER`` | | +| ``CONSTRAINT`` | ``FULL`` | ``LOOP`` | ``RLIKE`` | ``WITH`` | ++-------------------+---------------------+--------------------+------------------+ | +| ``CREATE`` | ``GRANT`` | ``MERGE`` | ``SELECT`` | | ++-------------------+---------------------+--------------------+------------------+ | +| ``CROSS`` | ``GROUP`` | ``NATURAL`` | ``SESSION_USER`` | | +-------------------+---------------------+--------------------+------------------+---------------+ From 5c703a7a07a97efc6a0b3e5edb07c70511ee986c Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 10 Apr 2022 17:11:10 +0300 Subject: [PATCH 038/882] Published Key Evaluation to Private Branch --- feature_guides/index.rst | 6 +- feature_guides/key_evaluation.rst | 13 ++++ .../key_evaluation_operational_modes.rst | 70 +++++++++++++++++++ feature_guides/key_evaluation_overview.rst | 16 +++++ 4 files changed, 102 insertions(+), 3 deletions(-) create mode 100644 feature_guides/key_evaluation.rst create mode 100644 feature_guides/key_evaluation_operational_modes.rst create mode 100644 feature_guides/key_evaluation_overview.rst diff --git a/feature_guides/index.rst b/feature_guides/index.rst index ee10e3ea4..2ba36198d 100644 --- a/feature_guides/index.rst +++ b/feature_guides/index.rst @@ -5,18 +5,18 @@ Feature Guides *********************** The **Feature Guides** section describes background processes that SQream uses to manage several areas of operation, such as data ingestion, load balancing, and access control. -This section describes the following features: +This section describes the following features: .. toctree:: :maxdepth: 1 - :titlesonly: + :titlesonly: delete_guide + key_evaluation data_encryption compression flexible_data_clustering python_functions - viewing_system_objects_as_ddl workload_manager transactions concurrency_and_locks diff --git a/feature_guides/key_evaluation.rst b/feature_guides/key_evaluation.rst new file mode 100644 index 000000000..e016e68c7 --- /dev/null +++ b/feature_guides/key_evaluation.rst @@ -0,0 +1,13 @@ +.. _key_evaluation: + +************************** +Key Evaluation +************************** +The **Key Evaluation** section describes the following: + +.. toctree:: + :maxdepth: 4 + :titlesonly: + + key_evaluation_overview + key_evaluation_operational_modes \ No newline at end of file diff --git a/feature_guides/key_evaluation_operational_modes.rst b/feature_guides/key_evaluation_operational_modes.rst new file mode 100644 index 000000000..feb4fd9c1 --- /dev/null +++ b/feature_guides/key_evaluation_operational_modes.rst @@ -0,0 +1,70 @@ +.. _key_evaluation_operational_modes: + +************************** +Operational Modes +************************** +Key Evaluation can be used to do one of the following: + +**Comment** - *Do users initiate one of these modes, or do they occur in the background on their own? The answer to this question determines whether key evaluation belongs in Feature Guides or Operational Guides.* + +.. contents:: + :local: + :depth: 1 + +View All Problematic Chunk Keys +---------- +You can use the **View** mode to find all problematic keys in the database for all databases and/or tables. + +The following shows the View command options: + +.. code-block:: + + $ select  keys_evaluate ('view'); + +.. code-block:: + + $ select  keys_evaluate ('view', 'master'); + +.. code-block:: + + $ select  keys_evaluate ('view', 'master', 'public.tbl'); + +Find and Clean Problematic Keys from Storage +---------- +You can use the **Clean Storage** mode to find all problematic keys located in the Storage for all databases. + +The following shows the Clean Storage command: + +.. code-block:: + + $ select  keys_evaluate ('clean_storage'); + +.. note:: This mode backs up the levelDB to the **backup** folder in the cluster before finding and cleaning problematic keys from your storage. + +Find and Clean Problematic Keys from a Database +---------- +You can use the **Clean Database** mode to find and clean all problematic keys located for a specific database and/or table. + +The following shows the Clean Database command options: + +.. code-block:: + + $ select keys_evaluate ('clean_database','master'); + +.. code-block:: + + $ select keys_evaluate ('clean_database','master', 'public.tbl'); + +.. note:: This mode backs up the levelDB to the **backup** folder in the cluster before finding and cleaning problematic keys from your database. + +Clean Specifically Defined Chunk Keys +---------- +**Comment** - *Currently not supported. Remove until further notice?* + +You can use the **Clean Chunk Key** mode to clean a specific problematic chunk key. **Comment** - *Note: data_diag vs keys_evaluate.* + +The following shows the Clean Chunk Key command options: + +.. code-block:: + + $ select data_diag (12, ''); \ No newline at end of file diff --git a/feature_guides/key_evaluation_overview.rst b/feature_guides/key_evaluation_overview.rst new file mode 100644 index 000000000..50e3f3eab --- /dev/null +++ b/feature_guides/key_evaluation_overview.rst @@ -0,0 +1,16 @@ +.. _key_evaluation_overview: + +************************** +Overview +************************** +The **Key Evaluation** feature resolves conflicts caused by ingesting and deleting data at the same time. Although this rarely occurs, it causes the leveldb to restore keys pointing to deleted data. In turn, this causes SQream metadata to search for deleted files. + +An indication that this conflict has occurred is SQream's inability to retrieve deleted data pointers, generating the type of error shown below: + +.. code-block:: console + + $ Internal Runtime Error *** Error opening [errno 2 No such file or directory] file name /mnt/disk1/sqream_cluster/databases/******/tables/289/17/17-391270 + +In addition, key evaluation prevents the database from creating phantom keys, which are duplicate chunk keys generated when data is ingested. Under normal circumstances ingesting data creates incrementing chunk keys. + +**Comment** - *Please confirm the reason I provided based on my understanding of the source doc.* \ No newline at end of file From e71871a44a4048c4a7e79be3a8866cba328c524d Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 10 Apr 2022 17:33:39 +0300 Subject: [PATCH 039/882] Corrected syntax --- feature_guides/key_evaluation_overview.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/feature_guides/key_evaluation_overview.rst b/feature_guides/key_evaluation_overview.rst index 50e3f3eab..3d3aabf8a 100644 --- a/feature_guides/key_evaluation_overview.rst +++ b/feature_guides/key_evaluation_overview.rst @@ -9,7 +9,7 @@ An indication that this conflict has occurred is SQream's inability to retrieve .. code-block:: console - $ Internal Runtime Error *** Error opening [errno 2 No such file or directory] file name /mnt/disk1/sqream_cluster/databases/******/tables/289/17/17-391270 + Internal Runtime Error *** Error opening [errno 2 No such file or directory] file name /mnt/disk1/sqream_cluster/databases/******/tables/289/17/17-391270 In addition, key evaluation prevents the database from creating phantom keys, which are duplicate chunk keys generated when data is ingested. Under normal circumstances ingesting data creates incrementing chunk keys. From d349955969ba341c2a2a6699e2f4916362245f59 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 12 Apr 2022 11:05:55 +0300 Subject: [PATCH 040/882] Updated Taco File Link --- third_party_tools/client_drivers/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/third_party_tools/client_drivers/index.rst b/third_party_tools/client_drivers/index.rst index 102827f22..d52b41e95 100644 --- a/third_party_tools/client_drivers/index.rst +++ b/third_party_tools/client_drivers/index.rst @@ -24,7 +24,7 @@ The following are applicable to all operating systems: * **Tableau**: - * `Tableau connector `_ - SQream (.taco) + * `https://sq-ftp-public.s3.amazonaws.com/SQreamTaco.rar>`_ - SQream (.taco) * `Tableau manual installation `_ From 8645e71f82ad5833ab256eaa84bed7a4cfa63014 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Wed, 13 Apr 2022 11:30:41 +0300 Subject: [PATCH 041/882] Added Installing NGINX Proxy Over Secure Connection Private branch - I added this file to this branch to show it to Dor before publishing it on live branches. --- ...ing_nginx_proxy_over_secure_connection.rst | 427 ++++++++++++++++++ .../sqream_studio_installation.rst | 3 +- 2 files changed, 429 insertions(+), 1 deletion(-) create mode 100644 installation_guides/installing_nginx_proxy_over_secure_connection.rst diff --git a/installation_guides/installing_nginx_proxy_over_secure_connection.rst b/installation_guides/installing_nginx_proxy_over_secure_connection.rst new file mode 100644 index 000000000..4596f109e --- /dev/null +++ b/installation_guides/installing_nginx_proxy_over_secure_connection.rst @@ -0,0 +1,427 @@ +.. _installing_nginx_proxy_over_secure_connection: + +************************* +Installing an NGINX Proxy Over a Secure Connection +************************* +Configuring your NGINX server to use a strong encryption for client connections provides you with secure servers requests, preventing outside parties from gaining access to your traffic. + +The **Installing an NGINX Proxy Over a Secure Connection** page describes the following: + +.. contents:: + :local: + :depth: 1 + +Overview +============== +The Node.js platform that SQream uses with our Studio user interface is susceptible to web exposure. This page describes how to implement HTTPS access on your proxy server to establish a secure connection. + +**TLS (Transport Layer Security)**, and its predecessor **SSL (Secure Sockets Layer)**, are standard web protocols used for wrapping normal traffic in a protected, encrypted wrapper. This technology prevents the interception of server-client traffic. It also uses a certificate system for helping users verify the identity of sites they visit. The **Installing an NGINX Proxy Over a Secure Connection** guide describes how to set up a self-signed SSL certificate for use with an NGINX web server on a CentOS 7 server. + +.. note:: A self-signed certificate encrypts communication between your server and any clients. However, because it is not signed by trusted certificate authorities included with web browsers, you cannot use the certificate to automatically validate the identity of your server. + +A self-signed certificate may be appropriate if your domain name is not associated with your server, and in cases where your encrypted web interface is not user-facing. If you do have a domain name, using a CA-signed certificate is generally preferrable. + +For more information on setting up a free trusted certificate, see `How To Secure Nginx with Let's Encrypt on CentOS 7 `_. + +Prerequisites +============== +The following prerequisites are required for installing an NGINX proxy over a secure connection: + +* Super user privileges + + :: + +* A domain name to create a certificate for + +Installing NGINX and Adjusting the Firewall +============== +After verifying that you have the above preriquisites, you must verify that the NGINX web server has been installed on your machine. + +Though NGINX is not available in the default CentOS repositories, it is available from the **EPEL (Extra Packages for Enterprise Linux)** repository. + +**To install NGINX and adjust the firewall:** + +1. Enable the EPEL repository to enable server access to the NGINX package: + + .. code-block:: console + + $ sudo yum install epel-release + +2. Install NGINX: + + .. code-block:: console + + $ sudo yum install nginx + +3. Start the NGINX service: + + .. code-block:: console + + $ sudo systemctl start nginx + +4. Verify that the service is running: + + .. code-block:: console + + $ systemctl status nginx + + The following is an example of the correct output: + + .. code-block:: console + + Output● nginx.service - The nginx HTTP and reverse proxy server + Loaded: loaded (/usr/lib/systemd/system/nginx.service; disabled; vendor preset: disabled) + Active: active (running) since Fri 2017-01-06 17:27:50 UTC; 28s ago + + . . . + + Jan 06 17:27:50 centos-512mb-nyc3-01 systemd[1]: Started The nginx HTTP and reverse proxy server. + +5. Enable NGINX to start when your server boots up: + + .. code-block:: console + + $ sudo systemctl enable nginx + +6. Verify that access to **ports 80 and 443** are not blocked by a firewall. + + :: + +7. Do one of the following: + + * If you are not using a firewall, skip to :ref:`Creating Your SSL Certificate`. + + :: + + * If you have a running firewall, open ports 80 and 443: + + .. code-block:: console + + $ sudo firewall-cmd --add-service=http + $ sudo firewall-cmd --add-service=https + $ sudo firewall-cmd --runtime-to-permanent + +8. If have a running **iptables firewall**, for a basic rule set, add HTTP and HTTPS access: + + .. code-block:: console + + $ sudo iptables -I INPUT -p tcp -m tcp --dport 80 -j ACCEPT + $ sudo iptables -I INPUT -p tcp -m tcp --dport 443 -j ACCEPT + +**Comment** - *Is Step 8 above optional?* + + .. note:: The commands in Step 8 above are highly dependent on your current rule set. + +9. Verify that you can access the default NGINX page from a web browser. + +.. _creating_your_ssl_certificate: + +Creating Your SSL Certificate +============== +After installing NGINX and adjusting your firewall, you must create your SSL certificate. + +TLS/SSL **Comment** - *Why mention "TLS" if we are only speaking about SSL?)* combines public certificates with private keys. The SSL key, kept private on your server, is used to encrypt content sent to clients, while the SSL certificate is publicly shared with anyone requesting content. In addition, the SSL certificate can be used to decrypt the content signed by the associated SSL key. Your public certificate is located in the **/etc/ssl/certs** directory on your server. + +This section describes how to create your **/etc/ssl/private directory**, used for storing your private key file. Because the privacy of this key is essential for security, the permissions must be locked down **(Comment** - *Disabled?*) to prevent unauthorized access: + +**To create your SSL certificate:** + +1. Set the following permissions to **private**: + + .. code-block:: console + + $ sudo mkdir /etc/ssl/private + $ sudo chmod 700 /etc/ssl/private + +2. Create a self-signed key and certificate pair with OpenSSL in a single command: + + .. code-block:: console + + $ sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /etc/ssl/private/nginx-selfsigned.key -out /etc/ssl/certs/nginx-selfsigned.crt + + The following list describes the elements in the command above: + + * **openssl** - The basic command line tool used for creating and managing OpenSSL certificates, keys, and other files. + + :: + + * **req** - A subcommand for using the X.509 **Certificate Signing Request (CSR)** management. A public key infrastructure standard, SSL and TLS adhere X.509 key and certificate management regulations. + + :: + + * **-x509** - Used for modifying the previous subcommand by overriding the default functionality of generating a certificate signing request with making a self-signed certificate. + + :: + + * **-nodes** - Sets **OpenSSL** to skip the option of securing our certificate with a passphrase, letting NGINX read the file without user intervention when the server is activated. If you don't use **-nodes** you must enter your passphrase after every restart. + + :: + + * **-days 365** - Sets the certificate's validation duration to one year. + + :: + + * **-newkey rsa:2048** - Simultaneously generates a new certificate and new key. Because the key required to sign the certificate was not created in the previous step **(Comment** - *Step 1?*), it must be created along with the certificate. The **rsa:2048** generates an RSA 2048 bits long. + + :: + + * **-keyout** - Determines the location of the generated private key file. + + :: + + * **-out** - Determines the location of the certificate. + + After creating a self-signed key and certificate pair with OpenSSL, a series of prompts about your server is presented (**Comment** - *By SSL?*) to correctly embed the information you provided in the certificate. + +**Comment** - *Dor, please confirm that the sentence above is correct.* + +3. Provide the information requested by the prompts. + + The most important piece of information is the **Common Name**, which is either the server **FQDN** or **your** name. You must enter the domain name associated with your server or your server’s public IP address. + + The following is an example of a filled out set of prompts: + + .. code-block:: console + + OutputCountry Name (2 letter code) [AU]:US + State or Province Name (full name) [Some-State]:New York + Locality Name (eg, city) []:New York City + Organization Name (eg, company) [Internet Widgits Pty Ltd]:Bouncy Castles, Inc. + Organizational Unit Name (eg, section) []:Ministry of Water Slides + Common Name (e.g. server FQDN or YOUR name) []:server_IP_address + Email Address []:admin@your_domain.com + + Both files you create are stored in their own subdirectories of the **/etc/ssl** directory. + + While (**Comment** - *"Although" instead of "while"?*) SQream uses OpenSSL, in addition we recommend creating a strong **Diffie-Hellman** group, used for negotiating **Perfect Forward Secrecy** with clients. + + **Comment** - *Please explain what you meant by "negotiating".* + +4. Create a strong Diffie-Hellman group: + + .. code-block:: console + + $ sudo openssl dhparam -out /etc/ssl/certs/dhparam.pem 2048 + + Creating a Diffie-Hellman group takes a few minutes, which is stored as the **dhparam.pem** file in the **/etc/ssl/certs** directory. This file can use in the configuration. + + **Comment** - *Please explain what you meant by that it can be used in the configuration.* + +Configuring NGINX to use SSL +============== +After creating your SSL certificate, you must configure NGINX to use SSL. + +The default CentOS NGINX configuration is fairly unstructured, (**Comment** - *What is the intent of "unstructured"?) with the default HTTP server block located in the main configuration file. NGINX checks for files ending in **.conf** in the **/etc/nginx/conf.d** directory for additional configuration. (**Comment** - *What did you mean by "additional configuration"? How does this work?*) + +SQream creates a new file in the **/etc/nginx/conf.d** directory to configure a server block. This block serves content using the certificate files we generated. In addition, the default server block can be optionally configured to redirect HTTP requests to HTTPS. + +.. note:: The example on this page uses the IP address **127.0.0.1**, which you should replace with your machine's IP address. + +**To configure NGINX to use SSL:** + +1. Create and open a file called **ssl.conf** in the **/etc/nginx/conf.d** directory: + + .. code-block:: console + + $ sudo vi /etc/nginx/conf.d/ssl.conf + +2. Inside, (**Comment** - *In the directory?*) open a server block: + + 1. Listen to **port 443**, which is the TLS/SSL default port. + + :: + + 2. Set the ``server_name`` to the server’s domain name or IP address you used as the Common Name when generating your certificate. + + :: + + 3. Use the ``ssl_certificate``, ``ssl_certificate_key``, and ``ssl_dhparam`` directives to set the location of the SSL files you generated, as shown in the **/etc/nginx/conf.d/ssl.conf** file below: + + **Comment** - *Please confirm Step 3 above.* + + .. code-block:: console + + upstream ui { + server 127.0.0.1:8080; + } + server { + listen 443 http2 ssl; + listen [::]:443 http2 ssl; + + server_name nginx.sq.l; + + ssl_certificate /etc/ssl/certs/nginx-selfsigned.crt; + ssl_certificate_key /etc/ssl/private/nginx-selfsigned.key; + ssl_dhparam /etc/ssl/certs/dhparam.pem; + + root /usr/share/nginx/html; + + # location / { + # } + + location / { + proxy_pass http://ui; + proxy_set_header X-Forwarded-Proto https; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header Host $host; + add_header Front-End-Https on; + add_header X-Cache-Status $upstream_cache_status; + proxy_cache off; + proxy_cache_revalidate off; + proxy_cache_min_uses 1; + proxy_cache_valid 200 302 1h; + proxy_cache_valid 404 3s; + proxy_cache_use_stale error timeout invalid_header updating http_500 http_502 http_503 http_504; + proxy_no_cache $cookie_nocache $arg_nocache $arg_comment $http_pragma $http_authorization; + proxy_redirect default; + proxy_max_temp_file_size 0; + proxy_connect_timeout 90; + proxy_send_timeout 90; + proxy_read_timeout 90; + proxy_buffer_size 4k; + proxy_buffering on; + proxy_buffers 4 32k; + proxy_busy_buffers_size 64k; + proxy_temp_file_write_size 64k; + proxy_intercept_errors on; + + proxy_set_header Upgrade $http_upgrade; + proxy_set_header Connection "upgrade"; + } + + error_page 404 /404.html; + location = /404.html { + } + + error_page 500 502 503 504 /50x.html; + location = /50x.html { + } + } + +4. Open and modify the **nginx.conf** file located in the **/etc/nginx/conf.d** directory as follows: + + .. code-block:: console + + $ sudo vi /etc/nginx/conf.d/nginx.conf + +**Comment** - *Why is this here (below)?* + +**/etc/nginx/nginx.conf** + + .. code-block:: console + + server { + listen 80; + listen [::]:80; + server_name _; + root /usr/share/nginx/html; + + # Load configuration files for the default server block. + include /etc/nginx/default.d/*.conf; + + error_page 404 /404.html; + location = /404.html { + } + + error_page 500 502 503 504 /50x.html; + location = /50x.html { + } + } + +Redirecting Studio Access from HTTP to HTTPS +================== +After configuring NGINX to use SSL, you must redirect Studio access from HTTP to HTTPS. + +According to your current configuration, NGINX responds with encrypted content for requests on port 443, but with **unencrypted** content for requests on **port 80**. This means that our site offers encryption, but does not enforce its usage. This may be fine for some use cases, but it is usually better to require encryption. This is especially important when confidential data like passwords may be transferred between the browser and the server. + +Thankfully, the default Nginx configuration file allows us to easily add directives to the default port 80 server block by adding files in the /etc/nginx/default.d directory. + +**Comment** - *We need to discuss the paragraphs above together.* + +**To create a redirect from HTTP to HTTPS:** + +1. Create a new file called **ssl-redirect.conf** and open it for editing: + + .. code-block:: console + + $ sudo vi /etc/nginx/default.d/ssl-redirect.conf + +2. Copy and paste this line: + + .. code-block:: console + + $ /etc/nginx/default.d/ssl-redirect.conf + + $ return 301 https://$host$request_uri:8080/; + + **Comment** - *Confirm the above.* + +Enabling the Changes in NGINX +============== +**Comment** - *I suggest using "Activating" instead of "Enabling".* + +After redirecting from HTTP to HTTPs, you must restart NGINX to activate your new configuration. + +**To activate your NGINX configuration:** + +1. Verify that your files contain no syntax errors: + + .. code-block:: console + + $ sudo nginx -t + + The following output is generated if your files contain no syntax errors: + + .. code-block:: console + + nginx: the configuration file /etc/nginx/nginx.conf syntax is ok + nginx: configuration file /etc/nginx/nginx.conf test is successful + +2. Restart NGINX to activate your configuration: + + **Comment** - *We need to tell them what to do if they do have syntax errors, i.e., to correct their syntax errors. If it is not obvious how to do this, we should tell them how.* + + .. code-block:: console + + $ sudo systemctl restart nginx + +Verifying that NGINX is Running +============== +After activating your NGINX configuration, you must verify that NGINX is running correctly. + +**To verify that NGINX is running correctly:** + +1. Check that the service is up and running: + + .. code-block:: console + + $ systemctl status nginx + + The following is an example of the correct output: + + .. code-block:: console + + Output● nginx.service - The nginx HTTP and reverse proxy server + Loaded: loaded (/usr/lib/systemd/system/nginx.service; disabled; vendor preset: disabled) + Active: active (running) since Fri 2017-01-06 17:27:50 UTC; 28s ago + + . . . + + Jan 06 17:27:50 centos-512mb-nyc3-01 systemd[1]: Started The nginx HTTP and reverse proxy server. + +2. Run the following command: + + .. code-block:: console + + $ sudo netstat -nltp |grep nginx + + The following is an example of the correct output: + + .. code-block:: console + + [sqream@dorb-pc etc]$ sudo netstat -nltp |grep nginx + tcp 0 0 0.0.0.0:80 0.0.0.0:* LISTEN 15486/nginx: master + tcp 0 0 0.0.0.0:443 0.0.0.0:* LISTEN 15486/nginx: master + tcp6 0 0 :::80 :::* LISTEN 15486/nginx: master + tcp6 0 0 :::443 :::* LISTEN 15486/nginx: master \ No newline at end of file diff --git a/installation_guides/sqream_studio_installation.rst b/installation_guides/sqream_studio_installation.rst index 8646a35ad..53c89772d 100644 --- a/installation_guides/sqream_studio_installation.rst +++ b/installation_guides/sqream_studio_installation.rst @@ -12,4 +12,5 @@ The **Installing SQream Studio** page incudes the following installation guides: installing_prometheus_exporters installing_prometheus_using_binary_packages installing_dashboard_data_collector - installing_studio_on_stand_alone_server \ No newline at end of file + installing_studio_on_stand_alone_server + installing_nginx_proxy_over_secure_connection \ No newline at end of file From c0fb6c5939d61cd93e75f704f3fc6f28d5e761cf Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Wed, 13 Apr 2022 17:43:05 +0300 Subject: [PATCH 042/882] Published Removed all remaining comments and published. --- ...ing_nginx_proxy_over_secure_connection.rst | 48 +++++-------------- 1 file changed, 12 insertions(+), 36 deletions(-) diff --git a/installation_guides/installing_nginx_proxy_over_secure_connection.rst b/installation_guides/installing_nginx_proxy_over_secure_connection.rst index 4596f109e..5aef5eaff 100644 --- a/installation_guides/installing_nginx_proxy_over_secure_connection.rst +++ b/installation_guides/installing_nginx_proxy_over_secure_connection.rst @@ -101,15 +101,13 @@ Though NGINX is not available in the default CentOS repositories, it is availabl $ sudo firewall-cmd --add-service=https $ sudo firewall-cmd --runtime-to-permanent -8. If have a running **iptables firewall**, for a basic rule set, add HTTP and HTTPS access: +8. If you have a running **iptables firewall**, for a basic rule set, add HTTP and HTTPS access: .. code-block:: console $ sudo iptables -I INPUT -p tcp -m tcp --dport 80 -j ACCEPT $ sudo iptables -I INPUT -p tcp -m tcp --dport 443 -j ACCEPT -**Comment** - *Is Step 8 above optional?* - .. note:: The commands in Step 8 above are highly dependent on your current rule set. 9. Verify that you can access the default NGINX page from a web browser. @@ -120,9 +118,9 @@ Creating Your SSL Certificate ============== After installing NGINX and adjusting your firewall, you must create your SSL certificate. -TLS/SSL **Comment** - *Why mention "TLS" if we are only speaking about SSL?)* combines public certificates with private keys. The SSL key, kept private on your server, is used to encrypt content sent to clients, while the SSL certificate is publicly shared with anyone requesting content. In addition, the SSL certificate can be used to decrypt the content signed by the associated SSL key. Your public certificate is located in the **/etc/ssl/certs** directory on your server. +TLS/SSL combines public certificates with private keys. The SSL key, kept private on your server, is used to encrypt content sent to clients, while the SSL certificate is publicly shared with anyone requesting content. In addition, the SSL certificate can be used to decrypt the content signed by the associated SSL key. Your public certificate is located in the **/etc/ssl/certs** directory on your server. -This section describes how to create your **/etc/ssl/private directory**, used for storing your private key file. Because the privacy of this key is essential for security, the permissions must be locked down **(Comment** - *Disabled?*) to prevent unauthorized access: +This section describes how to create your **/etc/ssl/private directory**, used for storing your private key file. Because the privacy of this key is essential for security, the permissions must be locked down to prevent unauthorized access: **To create your SSL certificate:** @@ -133,7 +131,7 @@ This section describes how to create your **/etc/ssl/private directory**, used f $ sudo mkdir /etc/ssl/private $ sudo chmod 700 /etc/ssl/private -2. Create a self-signed key and certificate pair with OpenSSL in a single command: +2. Create a self-signed key and certificate pair with OpenSSL with the following command: .. code-block:: console @@ -161,7 +159,7 @@ This section describes how to create your **/etc/ssl/private directory**, used f :: - * **-newkey rsa:2048** - Simultaneously generates a new certificate and new key. Because the key required to sign the certificate was not created in the previous step **(Comment** - *Step 1?*), it must be created along with the certificate. The **rsa:2048** generates an RSA 2048 bits long. + * **-newkey rsa:2048** - Simultaneously generates a new certificate and new key. Because the key required to sign the certificate was not created in the previous step, it must be created along with the certificate. The **rsa:2048** generates an RSA 2048 bits long. :: @@ -171,9 +169,7 @@ This section describes how to create your **/etc/ssl/private directory**, used f * **-out** - Determines the location of the certificate. - After creating a self-signed key and certificate pair with OpenSSL, a series of prompts about your server is presented (**Comment** - *By SSL?*) to correctly embed the information you provided in the certificate. - -**Comment** - *Dor, please confirm that the sentence above is correct.* + After creating a self-signed key and certificate pair with OpenSSL, a series of prompts about your server is presented to correctly embed the information you provided in the certificate. 3. Provide the information requested by the prompts. @@ -193,9 +189,7 @@ This section describes how to create your **/etc/ssl/private directory**, used f Both files you create are stored in their own subdirectories of the **/etc/ssl** directory. - While (**Comment** - *"Although" instead of "while"?*) SQream uses OpenSSL, in addition we recommend creating a strong **Diffie-Hellman** group, used for negotiating **Perfect Forward Secrecy** with clients. - - **Comment** - *Please explain what you meant by "negotiating".* + Although SQream uses OpenSSL, in addition we recommend creating a strong **Diffie-Hellman** group, used for negotiating **Perfect Forward Secrecy** with clients. 4. Create a strong Diffie-Hellman group: @@ -205,13 +199,11 @@ This section describes how to create your **/etc/ssl/private directory**, used f Creating a Diffie-Hellman group takes a few minutes, which is stored as the **dhparam.pem** file in the **/etc/ssl/certs** directory. This file can use in the configuration. - **Comment** - *Please explain what you meant by that it can be used in the configuration.* - Configuring NGINX to use SSL ============== After creating your SSL certificate, you must configure NGINX to use SSL. -The default CentOS NGINX configuration is fairly unstructured, (**Comment** - *What is the intent of "unstructured"?) with the default HTTP server block located in the main configuration file. NGINX checks for files ending in **.conf** in the **/etc/nginx/conf.d** directory for additional configuration. (**Comment** - *What did you mean by "additional configuration"? How does this work?*) +The default CentOS NGINX configuration is fairly unstructured, with the default HTTP server block located in the main configuration file. NGINX checks for files ending in **.conf** in the **/etc/nginx/conf.d** directory for additional configuration. SQream creates a new file in the **/etc/nginx/conf.d** directory to configure a server block. This block serves content using the certificate files we generated. In addition, the default server block can be optionally configured to redirect HTTP requests to HTTPS. @@ -225,7 +217,7 @@ SQream creates a new file in the **/etc/nginx/conf.d** directory to configure a $ sudo vi /etc/nginx/conf.d/ssl.conf -2. Inside, (**Comment** - *In the directory?*) open a server block: +2. In the file you created in Step 1 above, open a server block: 1. Listen to **port 443**, which is the TLS/SSL default port. @@ -237,8 +229,6 @@ SQream creates a new file in the **/etc/nginx/conf.d** directory to configure a 3. Use the ``ssl_certificate``, ``ssl_certificate_key``, and ``ssl_dhparam`` directives to set the location of the SSL files you generated, as shown in the **/etc/nginx/conf.d/ssl.conf** file below: - **Comment** - *Please confirm Step 3 above.* - .. code-block:: console upstream ui { @@ -304,11 +294,7 @@ SQream creates a new file in the **/etc/nginx/conf.d** directory to configure a .. code-block:: console $ sudo vi /etc/nginx/conf.d/nginx.conf - -**Comment** - *Why is this here (below)?* - -**/etc/nginx/nginx.conf** - + .. code-block:: console server { @@ -335,9 +321,7 @@ After configuring NGINX to use SSL, you must redirect Studio access from HTTP to According to your current configuration, NGINX responds with encrypted content for requests on port 443, but with **unencrypted** content for requests on **port 80**. This means that our site offers encryption, but does not enforce its usage. This may be fine for some use cases, but it is usually better to require encryption. This is especially important when confidential data like passwords may be transferred between the browser and the server. -Thankfully, the default Nginx configuration file allows us to easily add directives to the default port 80 server block by adding files in the /etc/nginx/default.d directory. - -**Comment** - *We need to discuss the paragraphs above together.* +The default NGINX configuration file allows us to easily add directives to the default port 80 server block by adding files in the /etc/nginx/default.d directory. **To create a redirect from HTTP to HTTPS:** @@ -351,16 +335,10 @@ Thankfully, the default Nginx configuration file allows us to easily add directi .. code-block:: console - $ /etc/nginx/default.d/ssl-redirect.conf - $ return 301 https://$host$request_uri:8080/; - **Comment** - *Confirm the above.* - -Enabling the Changes in NGINX +Activating Your NGINX Configuration ============== -**Comment** - *I suggest using "Activating" instead of "Enabling".* - After redirecting from HTTP to HTTPs, you must restart NGINX to activate your new configuration. **To activate your NGINX configuration:** @@ -380,8 +358,6 @@ After redirecting from HTTP to HTTPs, you must restart NGINX to activate your ne 2. Restart NGINX to activate your configuration: - **Comment** - *We need to tell them what to do if they do have syntax errors, i.e., to correct their syntax errors. If it is not obvious how to do this, we should tell them how.* - .. code-block:: console $ sudo systemctl restart nginx From 0a3b758916c1f37d7288b37f3abf8558ae5e9195 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 17 Apr 2022 10:45:19 +0300 Subject: [PATCH 043/882] Update installing_studio_on_stand_alone_server.rst Added lines 159-192 based on discussion with Slavi and Dor. --- ...nstalling_studio_on_stand_alone_server.rst | 40 +++++++++++++++++-- 1 file changed, 36 insertions(+), 4 deletions(-) diff --git a/installation_guides/installing_studio_on_stand_alone_server.rst b/installation_guides/installing_studio_on_stand_alone_server.rst index 874adba8d..ecec67c7f 100644 --- a/installation_guides/installing_studio_on_stand_alone_server.rst +++ b/installation_guides/installing_studio_on_stand_alone_server.rst @@ -5,8 +5,6 @@ *********************** Installing Studio on a Stand-Alone Server *********************** - - The **Installing Studio on a Stand-Alone Server** guide describes how to install SQream Studio on a stand-alone server. A stand-alone server is a server that does not run SQream based on binary files, Docker, or Kubernetes. The Installing Studio on a Stand-Alone Server guide includes the following sections: @@ -147,7 +145,7 @@ After installing the Dashboard Data Collector, you can install Studio. .. code-block:: console - $ npm run setup -- -y --host= --port=3108 + $ npm run setup -- -y --host= --port=3108 --data-collector-url=http://:8100/api/dashboard/data The above command creates the **sqream-admin-config.json** configuration file in the **sqream-admin** folder and shows the following output: @@ -158,6 +156,40 @@ After installing the Dashboard Data Collector, you can install Studio. For more information about the available set-up arguments, see :ref:`Set-Up Arguments`. :: + +5. To access Studio over a secure connection, in your configuration file do the following: + + #. Change your ``port`` value to **3109**. + + :: + + #. Change your ``ssl`` flag value to **true**. + + The following is an example of the correctly modified configuration file: + + .. code-block:: console + + { + "debugSqream": false, + "webHost": "localhost", + "webPort": 8080, + "webSslPort": 8443, + "logsDirectory": "", + "clusterType": "standalone", + "dataCollectorUrl": "", + "connections": [ + { + "host": "127.0.0.1", + "port":3109, + "isCluster": true, + "name": "default", + "service": "sqream", + "ssl":true, + "networkTimeout": 60000, + "connectionTimeout": 3000 + } + ] + } 5. If you have installed Studio on a server where SQream is already installed, move the **sqream-admin-config.json** file to **/etc/sqream/**: @@ -575,4 +607,4 @@ Back to :ref:`Installing Studio in a Docker Container` +Back to :ref:`Installing Studio on a Stand-Alone Server` \ No newline at end of file From f0220f55206229027444bcfbfc82f953d417b99b Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 17 Apr 2022 13:41:20 +0300 Subject: [PATCH 044/882] Update data_encryption_permissions.rst --- .../data_encryption_permissions.rst | 20 ++++++++----------- 1 file changed, 8 insertions(+), 12 deletions(-) diff --git a/feature_guides/data_encryption_permissions.rst b/feature_guides/data_encryption_permissions.rst index 16f41dc70..d7c655ad5 100644 --- a/feature_guides/data_encryption_permissions.rst +++ b/feature_guides/data_encryption_permissions.rst @@ -3,18 +3,14 @@ *********************** Permissions *********************** -Users with the appropriate encryption permission privilege's can encrypt and decrypt data. +The **Permissions** tells you how to create a table with encrypted columns as a superuser. -**Comment** - *The rest of this content seems internal, correct?* +Users with the appropriate encryption permission privilege's can encrypt and decrypt data. In addition, only superusers granted permission can view encrypted tables in the **sqream_catalog**. -Implementation notes +You can create a table with encrypted columns as a superuser as follows: -one method to encrypt the data with is the TDE: Transparent data encryption which employed by Microsoft/IBM/Oracle etc. - -management. The requirement is that this will be programmatic via API. - -The centralized key management store should be one of the following (R&D to choose which one in accordance to easiness of deployment): - -KMS (AWS)- https://aws.amazon.com/kms/ - -IBM- IBM Security Guardium Key Lifecycle Manager - Overview \ No newline at end of file +.. code-block:: console + + $ create or replace table t_enc(c1 int encrypt); + +For more information about the SQream catalog, see the :ref:`catalog_reference`. \ No newline at end of file From 2e37e000af4f732b2cb3da95c37e34e852a8cddc Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 17 Apr 2022 14:14:45 +0300 Subject: [PATCH 045/882] Update data_encryption_permissions.rst Added missing word. --- feature_guides/data_encryption_permissions.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/feature_guides/data_encryption_permissions.rst b/feature_guides/data_encryption_permissions.rst index d7c655ad5..d9a132b45 100644 --- a/feature_guides/data_encryption_permissions.rst +++ b/feature_guides/data_encryption_permissions.rst @@ -3,7 +3,7 @@ *********************** Permissions *********************** -The **Permissions** tells you how to create a table with encrypted columns as a superuser. +The **Permissions** page tells you how to create a table with encrypted columns as a superuser. Users with the appropriate encryption permission privilege's can encrypt and decrypt data. In addition, only superusers granted permission can view encrypted tables in the **sqream_catalog**. From 3ef220402188cbb4c03debd4becb8d28ee133b75 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 17 Apr 2022 17:41:53 +0300 Subject: [PATCH 046/882] Added DECODE Function --- reference/sql/sql_functions/index.rst | 6 +-- .../scalar_functions/string/decode.rst | 47 +++++++++++++++++++ 2 files changed, 50 insertions(+), 3 deletions(-) create mode 100644 reference/sql/sql_functions/scalar_functions/string/decode.rst diff --git a/reference/sql/sql_functions/index.rst b/reference/sql/sql_functions/index.rst index 46d643308..395cdfd59 100644 --- a/reference/sql/sql_functions/index.rst +++ b/reference/sql/sql_functions/index.rst @@ -223,6 +223,8 @@ The following table shows the **string* functions: - Calculates the position where a string starts inside another string * - :ref:`concat` - Concatenates two strings + * - :ref:`decode` + - Decodes or extracts binary data from a textual input string * - :ref:`isprefixof` - Matches if a string is the prefix of another string * - :ref:`left` @@ -416,6 +418,4 @@ The following table shows the **workload management** functions: user_defined_functions/index aggregate_functions/index window_functions/index - system_functions/index - - + system_functions/index \ No newline at end of file diff --git a/reference/sql/sql_functions/scalar_functions/string/decode.rst b/reference/sql/sql_functions/scalar_functions/string/decode.rst new file mode 100644 index 000000000..1ed10e399 --- /dev/null +++ b/reference/sql/sql_functions/scalar_functions/string/decode.rst @@ -0,0 +1,47 @@ +.. _decode: + +******************** +DECODE +******************** +The **DECODE** function is a PostgreSQL function used for decoding or extracting binary data from a textual input string. + +Syntax +========== +The following shows the correct syntax for the DECODE function: + +.. code-block:: postgres + + decode(string input_text, format type_text) + +Parameters +============ +The following table shows the DECODE parameters: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``input_text`` + - Defines the input text string. + * - ``type_text`` + - Defines the format used for decoding the input text. + +Returns +========= +**Comment** - *What does it return?* + +Notes +=========== +**Comment** - *Are there any relevant notes?* + +Examples +=========== +**Comment** - *What does the actual output look like? Can you provide an example?* + +Permissions +============= +**Comment** - *Please confirm what permissions the role requires.* + +The role must have the ``SUPERUSER`` permissions. \ No newline at end of file From a9de45732ef39b5cc7f93e9efb715dfbc6268f9b Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 17 Apr 2022 17:47:59 +0300 Subject: [PATCH 047/882] Update index.rst Added DECODE --- reference/sql/sql_functions/scalar_functions/index.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/reference/sql/sql_functions/scalar_functions/index.rst b/reference/sql/sql_functions/scalar_functions/index.rst index bd05f9bbe..ae70874e3 100644 --- a/reference/sql/sql_functions/scalar_functions/index.rst +++ b/reference/sql/sql_functions/scalar_functions/index.rst @@ -17,6 +17,7 @@ The **Built-In Scalar Functions** page describes functions that return one value * :ref:`between` * :ref:`case` * :ref:`coalesce` + * :ref:`decode` * :ref:`in` * :ref:`is_ascii` * :ref:`is_null` From b2ea112fa7386044871feb78dfc1ae2f1a245560 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 17 Apr 2022 18:16:47 +0300 Subject: [PATCH 048/882] Update index.rst --- reference/sql/sql_statements/index.rst | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index ae0139607..eab8d8f84 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -100,6 +100,8 @@ Utility Commands * - Command - Usage + * - :ref:`EXPLAIN` + - Returns a static query plan, which can be used to debug query plans * - :ref:`SELECT GET_LICENSE_INFO` - View a user's license information * - :ref:`SELECT GET_DDL` @@ -112,7 +114,18 @@ Utility Commands - Recreate a view after schema changes * - :ref:`SELECT DUMP_DATABASE_DDL` - View the ``CREATE TABLE`` statement for an current database - + * - :ref:`SHOW CONNECTIONS` + - Returns a list of active sessions on the current worker + * - :ref:`SHOW LOCKS` + - Returns a list of locks from across the cluster + * - :ref:`SHOW NODE INFO` + - Returns a snapshot of the current query plan, similar to ``EXPLAIN ANALYZE`` from other databases + * - :ref:`SHOW SERVER STATUS` + - Returns a list of active sessions across the cluster + * - :ref:`SHOW VERSION` + - Returns the system version for SQream DB + * - :ref:`STOP STATEMENT` + - Stops or aborts an active statement Monitoring From ab85fac18708fa16c1029524dc9f2c020f0e1929 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 24 Apr 2022 13:13:01 +0300 Subject: [PATCH 049/882] Moved System Functions to SQL Statements > Utility Commands Deleted System Functions section from SQL functions. Deleted System Functions folder (all system functions moved to SQL Syntax > Utility Commands)> --- reference/sql/sql_functions/index.rst | 27 -- .../utility_commands/explain.rst | 59 ++++ .../utility_commands/show_connections.rst | 78 +++++ .../utility_commands/show_locks.rst | 79 +++++ .../utility_commands/show_node_info.rst | 310 ++++++++++++++++++ .../utility_commands/show_server_status.rst | 108 ++++++ .../utility_commands/show_version.rst | 46 +++ .../utility_commands/stop_statement.rst | 77 +++++ 8 files changed, 757 insertions(+), 27 deletions(-) create mode 100644 reference/sql/sql_statements/utility_commands/explain.rst create mode 100644 reference/sql/sql_statements/utility_commands/show_connections.rst create mode 100644 reference/sql/sql_statements/utility_commands/show_locks.rst create mode 100644 reference/sql/sql_statements/utility_commands/show_node_info.rst create mode 100644 reference/sql/sql_statements/utility_commands/show_server_status.rst create mode 100644 reference/sql/sql_statements/utility_commands/show_version.rst create mode 100644 reference/sql/sql_statements/utility_commands/stop_statement.rst diff --git a/reference/sql/sql_functions/index.rst b/reference/sql/sql_functions/index.rst index 395cdfd59..5ef0a7c5f 100644 --- a/reference/sql/sql_functions/index.rst +++ b/reference/sql/sql_functions/index.rst @@ -363,32 +363,6 @@ For more information about window functions, see :ref:`window_functions`. - Returns an integer ranging between ``1`` and the argument value, dividing the partitions as equally as possible -System Functions ------------------- -System functions allow you to execute actions in the system, such as aborting a query or get information about system processes. - -The following table shows the **system** functions: - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Function - - Description - * - :ref:`explain` - - Returns a static query plan for a statement - * - :ref:`show_connections` - - Returns a list of jobs and statements on the current worker - * - :ref:`show_locks` - - Returns any existing locks in the database - * - :ref:`show_node_info` - - Returns a query plan for an actively running statement with timing information - * - :ref:`show_server_status` - - Shows running statements across the cluster - * - :ref:`show_version` - - Returns the version of SQream DB - * - :ref:`stop_statement` - - Stops a query (or statement) if it is currently running Workload Management Functions --------------------------------- @@ -418,4 +392,3 @@ The following table shows the **workload management** functions: user_defined_functions/index aggregate_functions/index window_functions/index - system_functions/index \ No newline at end of file diff --git a/reference/sql/sql_statements/utility_commands/explain.rst b/reference/sql/sql_statements/utility_commands/explain.rst new file mode 100644 index 000000000..e9b7e7ee9 --- /dev/null +++ b/reference/sql/sql_statements/utility_commands/explain.rst @@ -0,0 +1,59 @@ +.. _explain: + +***************** +EXPLAIN +***************** + +``EXPLAIN`` returns a static query plan, which can be used to debug query plans. + +To see an actively running query or statement, use :ref:`show_node_info` instead. + +See also :ref:`show_node_info`, :ref:`show_server_status`. + + +Permissions +============= + +The role must have the ``SELECT`` permissions for any tables referenced by the query. + +Syntax +========== + +.. code-block:: postgres + + explain_statement ::= + SELECT EXPLAIN(query_stmt) + ; + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``query_stmt`` + - The select query to generate the plan for. + +Notes +=========== + +Use dollar-quoting to escape the query text + +Examples +=========== + +Generating a static query plan +---------------------------------- + +.. code-block:: psql + + t=> SELECT EXPLAIN($$SELECT DATEADD(hour,1,dt) FROM cool_dates$$); + Select + Specific (TTNative Gpu) (dateadd@null := dt@null, + dateadd@val := (pure_if dt@null "0" (addHoursdt2dt dt@val "1"))) + Table Scan + public.cool_dates ("dt@null", "dt@val") [] + diff --git a/reference/sql/sql_statements/utility_commands/show_connections.rst b/reference/sql/sql_statements/utility_commands/show_connections.rst new file mode 100644 index 000000000..1bd320a4c --- /dev/null +++ b/reference/sql/sql_statements/utility_commands/show_connections.rst @@ -0,0 +1,78 @@ +.. _show_connections: + +******************** +SHOW_CONNECTIONS +******************** + +``SHOW_CONNECTIONS`` returns a list of active sessions on the current worker. + +To see sessions across the cluster, see :ref:`show_server_status`. + +Permissions +============= + +The role must have the ``SUPERUSER`` permissions. + +Syntax +========== + +.. code-block:: postgres + + show_connections_statement ::= + SELECT SHOW_CONNECTIONS() + ; + +Parameters +============ + +None + +Returns +========= + +This function returns a list of active sessions. If no sessions are active on the worker, the result set will be empty. + +.. list-table:: Result columns + :widths: auto + :header-rows: 1 + + * - ``ip`` + - The worker hostname or IP + * - ``conn_id`` + - Connection ID + * - ``conn_start_time`` + - Connection start timestamp + * - ``stmt_id`` + - Statement ID. Connections with no active statement display ``-1``. + * - ``stmt_start_time`` + - Statement start timestamp + * - ``stmt`` + - Statement text + + +Notes +=========== + +* This utility shows the active connections. Some sessions may be actively connected, but not currently running a statement. + +* A connection is typically reused. There could be many statements under a single connection ID. + +Examples +=========== + +Using ``SHOW_CONNECTIONS`` to get statement IDs +---------------------------------------------------- + + +.. code-block:: psql + + t=> SELECT SHOW_CONNECTIONS(); + ip | conn_id | conn_start_time | stmt_id | stmt_start_time | stmt + -------------+---------+---------------------+---------+---------------------+-------------------------- + 192.168.1.91 | 103 | 2019-12-24 00:01:27 | 129 | 2019-12-24 00:38:18 | SELECT GET_DATE(), * F... + 192.168.1.91 | 23 | 2019-12-24 00:01:27 | -1 | 2019-12-24 00:01:27 | + 192.168.1.91 | 22 | 2019-12-24 00:01:27 | -1 | 2019-12-24 00:01:27 | + 192.168.1.91 | 26 | 2019-12-24 00:01:28 | -1 | 2019-12-24 00:01:28 | + + +The statement ID we're interested in is ``129``. We can see the connection started at 00:01:27, while the statement started at 00:38:18. \ No newline at end of file diff --git a/reference/sql/sql_statements/utility_commands/show_locks.rst b/reference/sql/sql_statements/utility_commands/show_locks.rst new file mode 100644 index 000000000..d5e7c02ec --- /dev/null +++ b/reference/sql/sql_statements/utility_commands/show_locks.rst @@ -0,0 +1,79 @@ +.. _show_locks: + +******************** +SHOW_LOCKS +******************** + +``SHOW_LOCKS`` returns a list of locks from across the cluster. + +Read more about locks in :ref:`concurrency_and_locks`. + +Permissions +============= + +The role must have the ``SUPERUSER`` permissions. + +Syntax +========== + +.. code-block:: postgres + + show_locks_statement ::= + SELECT SHOW_LOCKS() + ; + +Parameters +============ + +None + +Returns +========= + +This function returns a list of active locks. If no locks are active in the cluster, the result set will be empty. + +.. list-table:: Result columns + :widths: auto + :header-rows: 1 + + * - ``stmt_id`` + - Statement ID that caused the lock. + * - ``stmt_string`` + - Statement text + * - ``username`` + - The role that executed the statement + * - ``server`` + - The worker node's IP + * - ``port`` + - The worker node's port + * - ``locked_object`` + - The full qualified name of the object being locked, separated with ``$`` (e.g. ``table$t$public$nba2`` for table ``nba2`` in schema ``public``, in database ``t`` + * - ``lockmode`` + - The locking mode (:ref:`inclusive` or :ref:`exclusive`). + * - ``statement_start_time`` + - Timestamp the statement started + * - ``lock_start_time`` + - Timestamp the lock was obtained + + +Examples +=========== + +Using ``SHOW_LOCKS`` to see active locks +--------------------------------------------------- + +In this example, we create a table based on results (:ref:`create_table_as`), but we are also effectively dropping the previous table (by using ``OR REPLACE``). Thus, SQream DB applies locks during the table creation process to prevent the table from being altered during it's creation. + + +.. code-block:: psql + + t=> SELECT SHOW_LOCKS(); + statement_id | statement_string | username | server | port | locked_object | lockmode | statement_start_time | lock_start_time + -------------+-------------------------------------------------------------------------------------------------+----------+--------------+------+---------------------------------+-----------+----------------------+-------------------- + 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | database$t | Inclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 + 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | globalpermission$ | Exclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 + 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | schema$t$public | Inclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 + 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | table$t$public$nba2$Insert | Exclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 + 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | table$t$public$nba2$Update | Exclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 + + diff --git a/reference/sql/sql_statements/utility_commands/show_node_info.rst b/reference/sql/sql_statements/utility_commands/show_node_info.rst new file mode 100644 index 000000000..345d16440 --- /dev/null +++ b/reference/sql/sql_statements/utility_commands/show_node_info.rst @@ -0,0 +1,310 @@ +.. _show_node_info: + +******************** +SHOW_NODE_INFO +******************** + +``SHOW_NODE_INFO`` returns a snapshot of the current query plan, similar to ``EXPLAIN ANALYZE`` from other databases. + +The snapshot provides information about execution which can be used for monitoring and troubleshooting slow running statements by helping identify long-running execution nodes (components that process data), etc. + +See also :ref:`explain`, :ref:`show_server_status`. + +Permissions +============= + +The role must have the ``SUPERUSER`` permissions. + +Syntax +========== + +.. code-block:: postgres + + show_node_info_statement ::= + SELECT SHOW_NODE_INFO(stmt_id) + ; + + stmt_id ::= bigint + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``stmt_id`` + - The statement ID to explore + +Returns +========= + +This utility returns details of the execution nodes, if the statement is still running. + +If the statement has finished, or the statment ID does not exist, the utility returns an empty result set. + +.. list-table:: Result columns + :widths: auto + :header-rows: 1 + + * - Column name + - Description + * - ``stmt_id`` + - The ID for the statement + * - ``node_id`` + - This node's ID in this execution plan + * - ``node_type`` + - The node type + * - ``rows`` + - Total number of rows this node has processed + * - ``chunks`` + - Number of chunks this node has processed + * - ``avg_rows_in_chunk`` + - Average amount of rows that this node processes in each chunk (``rows / chunks``) + * - ``time`` + - Timestamp for this node's creation + * - ``parent_node_id`` + - The ``node_id`` of this node's parent + * - ``read`` + - Total data read from disk + * - ``write`` + - Total data written to disk + * - ``comment`` + - Additional information (e.g. table name for ``ReadTable``) + * - ``timesum`` + - Total elapsed time for this execution node's processing + + +.. _node_types: + +Node types +============= + +This is a full list of node types: + +.. list-table:: Node types + :widths: auto + :header-rows: 1 + + * - Column name + - Execution location + - Description + * - ``AddChunkId`` + - + - Used during insert operations + * - ``AddSequences`` + - + - Used during insert operations, with :ref:`identity columns` + * - ``AddMinMaxMetadata`` + - + - Used to calculate ranges for the :ref:`chunk metadata system` + * - ``AddTopSortFilters`` + - + - An operation to optimize ``LIMIT`` when used alongside ``ORDER BY`` + * - ``Compress`` + - CPU and GPU + - Compress data with both CPU and GPU schemes + * - ``CpuDecompress`` + - CPU + - Decompression operation, common for longer ``VARCHAR`` types + * - ``CpuLoopJoin`` + - CPU + - A non-indexed nested loop join, performed on the CPU + * - ``CpuReduce`` + - CPU + - A reduce process performed on the CPU, primarily with ``DISTINCT`` aggregates (e.g. ``COUNT(DISTINCT ...)``) + * - ``CpuToGpu``, ``GpuToCpu`` + - + - An operation that moves data to or from the GPU for processing + * - ``CpuTransform`` + - CPU + - A transform operation performed on the CPU, usually a :ref:`scalar function` + * - ``CrossJoin`` + - + - A join without a join condition + * - ``DeferredGather`` + - CPU + - Merges the results of GPU operations with a result set [#f0]_ + * - ``Distinct`` + - GPU + - Removes duplicate rows (usually as part of the ``DISTINCT`` operation) + * - ``Distinct_Merge`` + - CPU + - The merge operation of the ``Distinct`` operation + * - ``Filter`` + - GPU + - A filtering operation, such as a ``WHERE`` or ``JOIN`` clause + * - ``GpuCopy`` + - GPU + - Copies data between GPUs or within a single GPU + * - ``GpuDecompress`` + - GPU + - Decompression operation + * - ``GpuReduceMerge`` + - GPU + - An operation to optimize part of the merger phases in the GPU + * - ``GpuTransform`` + - GPU + - A transformation operation such as a type cast or :ref:`scalar function` + * - ``Hash`` + - CPU + - Hashes the output result. Used internally. + * - ``JoinSideMarker`` + - + - Used internally. + * - ``LiteralValues`` + - CPU + - Creates a virtual relation (table), when :ref:`values` is used + * - ``LocateFiles`` + - CPU + - Validates external file paths for foreign data wrappers, expanding directories and GLOB patterns + * - ``LoopJoin`` + - GPU + - A non-indexed nested loop join, performed on the GPU + * - ``MarkMatchedJoinRows`` + - + - Used in outer joins, matches rows for larger join operations + * - ``NullifyDuplicates`` + - + - Replaces duplicate values with ``NULL`` to calculate distinct aggregates + * - ``NullSink`` + - CPU + - Used internally + * - ``ParseCsv`` + - CPU + - A CSV parser, used after ``ReadFiles`` to convert the CSV into columnar data + * - ``PopNetworkQueue`` + - CPU + - Fetches data from the network queue (e.g. when used with :ref:`insert`) + * - ``PushToNetworkQueue`` + - CPU + - Sends result sets to a client connected over the network + * - ``ReadCatalog`` + - CPU + - Converts the :ref:`catalog` into a relation (table) + * - ``ReadFiles`` + - CPU + - Reads external flat-files + * - ``ReadOrc`` + - CPU + - Reads data from an ORC file + * - ``ReadParquet`` + - CPU + - Reads data from a Parquet file + * - ``ReadTable`` + - CPU + - Reads data from a standard table stored on disk + * - ``ReadTableMetadata`` + - CPU + - Reads only table metadata as an optimization + * - ``Rechunk`` + - + - Reorganize multiple small :ref:`chunks` into a full chunk. Commonly found after joins and when :ref:`HIGH_SELECTIVITY` is used + * - ``Reduce`` + - GPU + - A reduction operation, such as a ``GROUP BY`` + * - ``ReduceMerge`` + - GPU + - A merge operation of a reduction operation, helps operate on larger-than-RAM data + * - ``ReorderInput`` + - + - Change the order of arguments in preparation for the next operation + * - ``SeparatedGather`` + - GPU + - Gathers additional columns for the result + * - ``Sort`` + - GPU + - Sort operation [#f1]_ + * - ``SortMerge`` + - CPU + - A merge operation of a sort operation, helps operate on larger-than-RAM data + * - ``SortMergeJoin`` + - GPU + - A sort-merge join, performed on the GPU + * - ``TakeRowsFromChunk`` + - + - Take the first N rows from each chunk, to optimize ``LIMIT`` when used alongside ``ORDER BY`` + * - ``Top`` + - + - Limits the input size, when used with ``LIMIT`` (or its alias ``TOP``) + * - ``UdfTransform`` + - CPU + - Executes a :ref:`user defined function` + * - ``UnionAll`` + - + - Combines two sources of data when ``UNION ALL`` is used + * - ``VarCharJoiner`` + - + - Used internally + * - ``VarCharSplitter`` + - + - Used intenrally + * - ``Window`` + - GPU + - Executes a non-ranking :ref:`window function` + * - ``WindowRanking`` + - GPU + - Executes a ranking :ref:`window function` + * - ``WriteTable`` + - CPU + - Writes the result set to a standard table stored on disk + +.. rubric:: Footnotes + +.. [#f0] Gathers columns which should be returned. This node typically spends most of the time on decompressing additional columns. + +.. [#f1] A GPU sort operation can be added by the statement compiler before ``GROUP BY`` or ``JOIN`` operations. + +Statement statuses +======================= + +.. include:: /reference/sql/sql_statements/monitoring_commands/show_server_status.rst + :start-line: 67 + :end-line: 84 + +Notes +=========== + +* This utility shows the execution information for active statements. Once a query has finished execution, the information is no longer available using this utility. See :ref:`logging` for more information about extracting the information from the logs. + +* This utility is primarily intended for troubleshooting with SQream support. + +Examples +=========== + +Getting execution details for a statement +------------------------------------------------ + + +.. code-block:: psql + + t=> SELECT SHOW_SERVER_STATUS(); + service | instanceid | connection_id | serverip | serverport | database_name | user_name | clientip | statementid | statement | statementstarttime | statementstatus | statementstatusstart + --------+------------+---------------+--------------+------------+---------------+-----------+--------------+-------------+-----------------------------------------------------------------+---------------------+-----------------+--------------------- + sqream | | 152 | 192.168.1.91 | 5000 | t | sqream | 192.168.1.91 | 176 | SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | 25-12-2019 23:53:13 | Executing | 25-12-2019 23:53:13 + sqream | | 151 | 192.168.1.91 | 5000 | t | sqream | 192.168.0.1 | 177 | SELECT show_server_status() | 25-12-2019 23:51:31 | Executing | 25-12-2019 23:53:13 + + +The statement ID we want to reserach is ``176``, running on worker ``192.168.1.91``. + +The query text is ``SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1;`` + +.. code-block:: psql + + t=> SELECT SHOW_NODE_INFO(176); + stmt_id | node_id | node_type | rows | chunks | avg_rows_in_chunk | time | parent_node_id | read | write | comment | timeSum + --------+---------+--------------------+------+--------+-------------------+---------------------+----------------+------+-------+------------+-------- + 176 | 1 | PushToNetworkQueue | 1 | 1 | 1 | 2019-12-25 23:53:13 | -1 | | | | 0.0025 + 176 | 2 | Rechunk | 1 | 1 | 1 | 2019-12-25 23:53:13 | 1 | | | | 0 + 176 | 3 | GpuToCpu | 1 | 1 | 1 | 2019-12-25 23:53:13 | 2 | | | | 0 + 176 | 4 | ReorderInput | 1 | 1 | 1 | 2019-12-25 23:53:13 | 3 | | | | 0 + 176 | 5 | Filter | 1 | 1 | 1 | 2019-12-25 23:53:13 | 4 | | | | 0.0002 + 176 | 6 | GpuTransform | 457 | 1 | 457 | 2019-12-25 23:53:13 | 5 | | | | 0.0002 + 176 | 7 | GpuDecompress | 457 | 1 | 457 | 2019-12-25 23:53:13 | 6 | | | | 0 + 176 | 8 | CpuToGpu | 457 | 1 | 457 | 2019-12-25 23:53:13 | 7 | | | | 0.0003 + 176 | 9 | Rechunk | 457 | 1 | 457 | 2019-12-25 23:53:13 | 8 | | | | 0 + 176 | 10 | CpuDecompress | 457 | 1 | 457 | 2019-12-25 23:53:13 | 9 | | | | 0 + 176 | 11 | ReadTable | 457 | 1 | 457 | 2019-12-25 23:53:13 | 10 | 4MB | | public.nba | 0.0004 + diff --git a/reference/sql/sql_statements/utility_commands/show_server_status.rst b/reference/sql/sql_statements/utility_commands/show_server_status.rst new file mode 100644 index 000000000..f59f79ccc --- /dev/null +++ b/reference/sql/sql_statements/utility_commands/show_server_status.rst @@ -0,0 +1,108 @@ +.. _show_server_status: + +******************** +SHOW_SERVER_STATUS +******************** + +``SHOW_SERVER_STATUS`` returns a list of active sessions across the cluster. + +To list active statements on the current worker only, see :ref:`show_connections`. + +Permissions +============= + +The role must have the ``SUPERUSER`` permissions. + +Syntax +========== + +.. code-block:: postgres + + show_server_status_statement ::= + SELECT SHOW_SERVER_STATUS() + ; + +Parameters +============ + +None + +Returns +========= + +This function returns a list of active sessions. If no sessions are active across the cluster, the result set will be empty. + +.. list-table:: Result columns + :widths: auto + :header-rows: 1 + + * - ``service`` + - The service name for the statement + * - ``instance`` + - The worker ID + * - ``connection_id`` + - Connection ID + * - ``serverip`` + - Worker end-point IP + * - ``serverport`` + - Worker end-point port + * - ``database_name`` + - Database name for the statement + * - ``user_name`` + - Username running the statement + * - ``clientip`` + - Client IP + * - ``statementid`` + - Statement ID + * - ``statement`` + - Statement text + * - ``statementstarttime`` + - Statement start timestamp + * - ``statementstatus`` + - Statement status (see table below) + * - ``statementstatusstart`` + - Last updated timestamp + +.. include from here: 66 + + +.. list-table:: Statement status values + :widths: auto + :header-rows: 1 + + * - Status + - Description + * - ``Preparing`` + - Statement is being prepared + * - ``In queue`` + - Statement is waiting for execution + * - ``Initializing`` + - Statement has entered execution checks + * - ``Executing`` + - Statement is executing + * - ``Stopping`` + - Statement is in the process of stopping + + +.. include until here 86 + +Notes +=========== + +* This utility shows the active sessions. Some sessions may be actively connected, but not running any statements. + +Examples +=========== + +Using ``SHOW_SERVER_STATUS`` to get statement IDs +---------------------------------------------------- + + +.. code-block:: psql + + t=> SELECT SHOW_SERVER_STATUS(); + service | instanceid | connection_id | serverip | serverport | database_name | user_name | clientip | statementid | statement | statementstarttime | statementstatus | statementstatusstart + --------+------------+---------------+--------------+------------+---------------+------------+-------------+-------------+-----------------------------+---------------------+-----------------+--------------------- + sqream | | 102 | 192.168.1.91 | 5000 | t | rhendricks | 192.168.0.1 | 128 | SELECT SHOW_SERVER_STATUS() | 24-12-2019 00:14:53 | Executing | 24-12-2019 00:14:53 + +The statement ID is ``128``, running on worker ``192.168.1.91``. diff --git a/reference/sql/sql_statements/utility_commands/show_version.rst b/reference/sql/sql_statements/utility_commands/show_version.rst new file mode 100644 index 000000000..8c3e7565e --- /dev/null +++ b/reference/sql/sql_statements/utility_commands/show_version.rst @@ -0,0 +1,46 @@ +.. _show_version: + +***************** +SHOW_VERSION +***************** + +``SHOW_VERSION()`` is a function that returns the system version for SQream DB. + +Permissions +============= + +No special permissions are required. + +Syntax +========== + +.. code-block:: postgres + + show_version_statement ::= + SELECT SHOW_VERSION() + ; + +Parameters +============ + +None + +Notes +========== + +To check the SQream DB version from the shell, run ``$ sqreamd --version`` + +Examples +=========== + +Getting the current SQream DB version +--------------------------------------- + + +.. code-block:: psql + + t=> SELECT SHOW_VERSION(); + bytesread + --------- + v2019.3 + diff --git a/reference/sql/sql_statements/utility_commands/stop_statement.rst b/reference/sql/sql_statements/utility_commands/stop_statement.rst new file mode 100644 index 000000000..30efc25b5 --- /dev/null +++ b/reference/sql/sql_statements/utility_commands/stop_statement.rst @@ -0,0 +1,77 @@ +.. _stop_statement: + +******************** +STOP_STATEMENT +******************** + +``STOP_STATEMENT`` stops or aborts an active statement. + +To find a statement by ID, see :ref:`show_server_status` and :ref:`show_connections`. + +.. tip:: Some DBMSs call this process killing a session, terminating a job, or kill query + +Permissions +============= + +The role must have the ``SUPERUSER`` permissions. + +Syntax +========== + +.. code-block:: postgres + + stop_statement_statement ::= + SELECT STOP_STATEMENT(stmt_id) + ; + + stmt_id ::= bigint + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``stmt_id`` + - The statement ID to stop + +Returns +========= + +This utility does not return any value, and always succeeds even if the statement does not exist, or has already stopped. + + +Notes +=========== + +* This utility always succeeds even if the statement does not exist, or has already stopped. + +Examples +=========== + +Using :ref:`show_connections` to get statement IDs +---------------------------------------------------- + +.. tip:: Use :ref:`show_server_status` to find statments from across the entire cluster, or :ref:`show_connections` to show statements from the current worker the client is connected to. + +.. code-block:: psql + + t=> SELECT SHOW_CONNECTIONS(); + ip | conn_id | conn_start_time | stmt_id | stmt_start_time | stmt + -------------+---------+---------------------+---------+---------------------+-------------------------- + 192.168.1.91 | 103 | 2019-12-24 00:01:27 | 129 | 2019-12-24 00:38:18 | SELECT GET_DATE(), * F... + 192.168.1.91 | 23 | 2019-12-24 00:01:27 | -1 | 2019-12-24 00:01:27 | + 192.168.1.91 | 22 | 2019-12-24 00:01:27 | -1 | 2019-12-24 00:01:27 | + 192.168.1.91 | 26 | 2019-12-24 00:01:28 | -1 | 2019-12-24 00:01:28 | + + +The statement ID we're interested in is ``129``. We can now stop this statement: + +.. code-block:: psql + + t=> SELECT STOP_STATEMENT(129) + executed + From 784aaf0099a629ffe684863c51fe63a6f78ae479 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 24 Apr 2022 13:22:18 +0300 Subject: [PATCH 050/882] Moved System Functions to SQL Statements > Utility Commands Deleted System Functions section from SQL functions. Deleted System Functions folder (all system functions moved to SQL Syntax > Utility Commands)> --- reference/sql/sql_functions/index.rst | 3 +- .../system_functions/explain.rst | 59 ---- .../sql_functions/system_functions/index.rst | 19 -- .../system_functions/show_connections.rst | 78 ----- .../system_functions/show_locks.rst | 79 ----- .../system_functions/show_node_info.rst | 310 ------------------ .../system_functions/show_server_status.rst | 108 ------ .../system_functions/show_version.rst | 46 --- .../system_functions/stop_statement.rst | 77 ----- 9 files changed, 2 insertions(+), 777 deletions(-) delete mode 100644 reference/sql/sql_functions/system_functions/explain.rst delete mode 100644 reference/sql/sql_functions/system_functions/index.rst delete mode 100644 reference/sql/sql_functions/system_functions/show_connections.rst delete mode 100644 reference/sql/sql_functions/system_functions/show_locks.rst delete mode 100644 reference/sql/sql_functions/system_functions/show_node_info.rst delete mode 100644 reference/sql/sql_functions/system_functions/show_server_status.rst delete mode 100644 reference/sql/sql_functions/system_functions/show_version.rst delete mode 100644 reference/sql/sql_functions/system_functions/stop_statement.rst diff --git a/reference/sql/sql_functions/index.rst b/reference/sql/sql_functions/index.rst index 5ef0a7c5f..51d969f40 100644 --- a/reference/sql/sql_functions/index.rst +++ b/reference/sql/sql_functions/index.rst @@ -364,6 +364,7 @@ For more information about window functions, see :ref:`window_functions`. + Workload Management Functions --------------------------------- The following table shows the **workload management** functions: @@ -391,4 +392,4 @@ The following table shows the **workload management** functions: scalar_functions/index user_defined_functions/index aggregate_functions/index - window_functions/index + window_functions/index \ No newline at end of file diff --git a/reference/sql/sql_functions/system_functions/explain.rst b/reference/sql/sql_functions/system_functions/explain.rst deleted file mode 100644 index e9b7e7ee9..000000000 --- a/reference/sql/sql_functions/system_functions/explain.rst +++ /dev/null @@ -1,59 +0,0 @@ -.. _explain: - -***************** -EXPLAIN -***************** - -``EXPLAIN`` returns a static query plan, which can be used to debug query plans. - -To see an actively running query or statement, use :ref:`show_node_info` instead. - -See also :ref:`show_node_info`, :ref:`show_server_status`. - - -Permissions -============= - -The role must have the ``SELECT`` permissions for any tables referenced by the query. - -Syntax -========== - -.. code-block:: postgres - - explain_statement ::= - SELECT EXPLAIN(query_stmt) - ; - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``query_stmt`` - - The select query to generate the plan for. - -Notes -=========== - -Use dollar-quoting to escape the query text - -Examples -=========== - -Generating a static query plan ----------------------------------- - -.. code-block:: psql - - t=> SELECT EXPLAIN($$SELECT DATEADD(hour,1,dt) FROM cool_dates$$); - Select - Specific (TTNative Gpu) (dateadd@null := dt@null, - dateadd@val := (pure_if dt@null "0" (addHoursdt2dt dt@val "1"))) - Table Scan - public.cool_dates ("dt@null", "dt@val") [] - diff --git a/reference/sql/sql_functions/system_functions/index.rst b/reference/sql/sql_functions/system_functions/index.rst deleted file mode 100644 index ba99610ba..000000000 --- a/reference/sql/sql_functions/system_functions/index.rst +++ /dev/null @@ -1,19 +0,0 @@ -.. _system_functions_functions: - -******************** -System Functions -******************** -**System functions** are used for returning system information, such as version and node information, and for maintenance operations that are not regularly accessed from any interface. - -The System Functions page describes the following: - -.. hlist:: - :columns: 1 - - * :ref:`explain` - * :ref:`show_version` - * :ref:`show_connections` - * :ref:`show_locks` - * :ref:`show_node_info` - * :ref:`show_server_status` - * :ref:`stop_statement` \ No newline at end of file diff --git a/reference/sql/sql_functions/system_functions/show_connections.rst b/reference/sql/sql_functions/system_functions/show_connections.rst deleted file mode 100644 index 1bd320a4c..000000000 --- a/reference/sql/sql_functions/system_functions/show_connections.rst +++ /dev/null @@ -1,78 +0,0 @@ -.. _show_connections: - -******************** -SHOW_CONNECTIONS -******************** - -``SHOW_CONNECTIONS`` returns a list of active sessions on the current worker. - -To see sessions across the cluster, see :ref:`show_server_status`. - -Permissions -============= - -The role must have the ``SUPERUSER`` permissions. - -Syntax -========== - -.. code-block:: postgres - - show_connections_statement ::= - SELECT SHOW_CONNECTIONS() - ; - -Parameters -============ - -None - -Returns -========= - -This function returns a list of active sessions. If no sessions are active on the worker, the result set will be empty. - -.. list-table:: Result columns - :widths: auto - :header-rows: 1 - - * - ``ip`` - - The worker hostname or IP - * - ``conn_id`` - - Connection ID - * - ``conn_start_time`` - - Connection start timestamp - * - ``stmt_id`` - - Statement ID. Connections with no active statement display ``-1``. - * - ``stmt_start_time`` - - Statement start timestamp - * - ``stmt`` - - Statement text - - -Notes -=========== - -* This utility shows the active connections. Some sessions may be actively connected, but not currently running a statement. - -* A connection is typically reused. There could be many statements under a single connection ID. - -Examples -=========== - -Using ``SHOW_CONNECTIONS`` to get statement IDs ----------------------------------------------------- - - -.. code-block:: psql - - t=> SELECT SHOW_CONNECTIONS(); - ip | conn_id | conn_start_time | stmt_id | stmt_start_time | stmt - -------------+---------+---------------------+---------+---------------------+-------------------------- - 192.168.1.91 | 103 | 2019-12-24 00:01:27 | 129 | 2019-12-24 00:38:18 | SELECT GET_DATE(), * F... - 192.168.1.91 | 23 | 2019-12-24 00:01:27 | -1 | 2019-12-24 00:01:27 | - 192.168.1.91 | 22 | 2019-12-24 00:01:27 | -1 | 2019-12-24 00:01:27 | - 192.168.1.91 | 26 | 2019-12-24 00:01:28 | -1 | 2019-12-24 00:01:28 | - - -The statement ID we're interested in is ``129``. We can see the connection started at 00:01:27, while the statement started at 00:38:18. \ No newline at end of file diff --git a/reference/sql/sql_functions/system_functions/show_locks.rst b/reference/sql/sql_functions/system_functions/show_locks.rst deleted file mode 100644 index d5e7c02ec..000000000 --- a/reference/sql/sql_functions/system_functions/show_locks.rst +++ /dev/null @@ -1,79 +0,0 @@ -.. _show_locks: - -******************** -SHOW_LOCKS -******************** - -``SHOW_LOCKS`` returns a list of locks from across the cluster. - -Read more about locks in :ref:`concurrency_and_locks`. - -Permissions -============= - -The role must have the ``SUPERUSER`` permissions. - -Syntax -========== - -.. code-block:: postgres - - show_locks_statement ::= - SELECT SHOW_LOCKS() - ; - -Parameters -============ - -None - -Returns -========= - -This function returns a list of active locks. If no locks are active in the cluster, the result set will be empty. - -.. list-table:: Result columns - :widths: auto - :header-rows: 1 - - * - ``stmt_id`` - - Statement ID that caused the lock. - * - ``stmt_string`` - - Statement text - * - ``username`` - - The role that executed the statement - * - ``server`` - - The worker node's IP - * - ``port`` - - The worker node's port - * - ``locked_object`` - - The full qualified name of the object being locked, separated with ``$`` (e.g. ``table$t$public$nba2`` for table ``nba2`` in schema ``public``, in database ``t`` - * - ``lockmode`` - - The locking mode (:ref:`inclusive` or :ref:`exclusive`). - * - ``statement_start_time`` - - Timestamp the statement started - * - ``lock_start_time`` - - Timestamp the lock was obtained - - -Examples -=========== - -Using ``SHOW_LOCKS`` to see active locks ---------------------------------------------------- - -In this example, we create a table based on results (:ref:`create_table_as`), but we are also effectively dropping the previous table (by using ``OR REPLACE``). Thus, SQream DB applies locks during the table creation process to prevent the table from being altered during it's creation. - - -.. code-block:: psql - - t=> SELECT SHOW_LOCKS(); - statement_id | statement_string | username | server | port | locked_object | lockmode | statement_start_time | lock_start_time - -------------+-------------------------------------------------------------------------------------------------+----------+--------------+------+---------------------------------+-----------+----------------------+-------------------- - 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | database$t | Inclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 - 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | globalpermission$ | Exclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 - 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | schema$t$public | Inclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 - 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | table$t$public$nba2$Insert | Exclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 - 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | table$t$public$nba2$Update | Exclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 - - diff --git a/reference/sql/sql_functions/system_functions/show_node_info.rst b/reference/sql/sql_functions/system_functions/show_node_info.rst deleted file mode 100644 index 345d16440..000000000 --- a/reference/sql/sql_functions/system_functions/show_node_info.rst +++ /dev/null @@ -1,310 +0,0 @@ -.. _show_node_info: - -******************** -SHOW_NODE_INFO -******************** - -``SHOW_NODE_INFO`` returns a snapshot of the current query plan, similar to ``EXPLAIN ANALYZE`` from other databases. - -The snapshot provides information about execution which can be used for monitoring and troubleshooting slow running statements by helping identify long-running execution nodes (components that process data), etc. - -See also :ref:`explain`, :ref:`show_server_status`. - -Permissions -============= - -The role must have the ``SUPERUSER`` permissions. - -Syntax -========== - -.. code-block:: postgres - - show_node_info_statement ::= - SELECT SHOW_NODE_INFO(stmt_id) - ; - - stmt_id ::= bigint - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``stmt_id`` - - The statement ID to explore - -Returns -========= - -This utility returns details of the execution nodes, if the statement is still running. - -If the statement has finished, or the statment ID does not exist, the utility returns an empty result set. - -.. list-table:: Result columns - :widths: auto - :header-rows: 1 - - * - Column name - - Description - * - ``stmt_id`` - - The ID for the statement - * - ``node_id`` - - This node's ID in this execution plan - * - ``node_type`` - - The node type - * - ``rows`` - - Total number of rows this node has processed - * - ``chunks`` - - Number of chunks this node has processed - * - ``avg_rows_in_chunk`` - - Average amount of rows that this node processes in each chunk (``rows / chunks``) - * - ``time`` - - Timestamp for this node's creation - * - ``parent_node_id`` - - The ``node_id`` of this node's parent - * - ``read`` - - Total data read from disk - * - ``write`` - - Total data written to disk - * - ``comment`` - - Additional information (e.g. table name for ``ReadTable``) - * - ``timesum`` - - Total elapsed time for this execution node's processing - - -.. _node_types: - -Node types -============= - -This is a full list of node types: - -.. list-table:: Node types - :widths: auto - :header-rows: 1 - - * - Column name - - Execution location - - Description - * - ``AddChunkId`` - - - - Used during insert operations - * - ``AddSequences`` - - - - Used during insert operations, with :ref:`identity columns` - * - ``AddMinMaxMetadata`` - - - - Used to calculate ranges for the :ref:`chunk metadata system` - * - ``AddTopSortFilters`` - - - - An operation to optimize ``LIMIT`` when used alongside ``ORDER BY`` - * - ``Compress`` - - CPU and GPU - - Compress data with both CPU and GPU schemes - * - ``CpuDecompress`` - - CPU - - Decompression operation, common for longer ``VARCHAR`` types - * - ``CpuLoopJoin`` - - CPU - - A non-indexed nested loop join, performed on the CPU - * - ``CpuReduce`` - - CPU - - A reduce process performed on the CPU, primarily with ``DISTINCT`` aggregates (e.g. ``COUNT(DISTINCT ...)``) - * - ``CpuToGpu``, ``GpuToCpu`` - - - - An operation that moves data to or from the GPU for processing - * - ``CpuTransform`` - - CPU - - A transform operation performed on the CPU, usually a :ref:`scalar function` - * - ``CrossJoin`` - - - - A join without a join condition - * - ``DeferredGather`` - - CPU - - Merges the results of GPU operations with a result set [#f0]_ - * - ``Distinct`` - - GPU - - Removes duplicate rows (usually as part of the ``DISTINCT`` operation) - * - ``Distinct_Merge`` - - CPU - - The merge operation of the ``Distinct`` operation - * - ``Filter`` - - GPU - - A filtering operation, such as a ``WHERE`` or ``JOIN`` clause - * - ``GpuCopy`` - - GPU - - Copies data between GPUs or within a single GPU - * - ``GpuDecompress`` - - GPU - - Decompression operation - * - ``GpuReduceMerge`` - - GPU - - An operation to optimize part of the merger phases in the GPU - * - ``GpuTransform`` - - GPU - - A transformation operation such as a type cast or :ref:`scalar function` - * - ``Hash`` - - CPU - - Hashes the output result. Used internally. - * - ``JoinSideMarker`` - - - - Used internally. - * - ``LiteralValues`` - - CPU - - Creates a virtual relation (table), when :ref:`values` is used - * - ``LocateFiles`` - - CPU - - Validates external file paths for foreign data wrappers, expanding directories and GLOB patterns - * - ``LoopJoin`` - - GPU - - A non-indexed nested loop join, performed on the GPU - * - ``MarkMatchedJoinRows`` - - - - Used in outer joins, matches rows for larger join operations - * - ``NullifyDuplicates`` - - - - Replaces duplicate values with ``NULL`` to calculate distinct aggregates - * - ``NullSink`` - - CPU - - Used internally - * - ``ParseCsv`` - - CPU - - A CSV parser, used after ``ReadFiles`` to convert the CSV into columnar data - * - ``PopNetworkQueue`` - - CPU - - Fetches data from the network queue (e.g. when used with :ref:`insert`) - * - ``PushToNetworkQueue`` - - CPU - - Sends result sets to a client connected over the network - * - ``ReadCatalog`` - - CPU - - Converts the :ref:`catalog` into a relation (table) - * - ``ReadFiles`` - - CPU - - Reads external flat-files - * - ``ReadOrc`` - - CPU - - Reads data from an ORC file - * - ``ReadParquet`` - - CPU - - Reads data from a Parquet file - * - ``ReadTable`` - - CPU - - Reads data from a standard table stored on disk - * - ``ReadTableMetadata`` - - CPU - - Reads only table metadata as an optimization - * - ``Rechunk`` - - - - Reorganize multiple small :ref:`chunks` into a full chunk. Commonly found after joins and when :ref:`HIGH_SELECTIVITY` is used - * - ``Reduce`` - - GPU - - A reduction operation, such as a ``GROUP BY`` - * - ``ReduceMerge`` - - GPU - - A merge operation of a reduction operation, helps operate on larger-than-RAM data - * - ``ReorderInput`` - - - - Change the order of arguments in preparation for the next operation - * - ``SeparatedGather`` - - GPU - - Gathers additional columns for the result - * - ``Sort`` - - GPU - - Sort operation [#f1]_ - * - ``SortMerge`` - - CPU - - A merge operation of a sort operation, helps operate on larger-than-RAM data - * - ``SortMergeJoin`` - - GPU - - A sort-merge join, performed on the GPU - * - ``TakeRowsFromChunk`` - - - - Take the first N rows from each chunk, to optimize ``LIMIT`` when used alongside ``ORDER BY`` - * - ``Top`` - - - - Limits the input size, when used with ``LIMIT`` (or its alias ``TOP``) - * - ``UdfTransform`` - - CPU - - Executes a :ref:`user defined function` - * - ``UnionAll`` - - - - Combines two sources of data when ``UNION ALL`` is used - * - ``VarCharJoiner`` - - - - Used internally - * - ``VarCharSplitter`` - - - - Used intenrally - * - ``Window`` - - GPU - - Executes a non-ranking :ref:`window function` - * - ``WindowRanking`` - - GPU - - Executes a ranking :ref:`window function` - * - ``WriteTable`` - - CPU - - Writes the result set to a standard table stored on disk - -.. rubric:: Footnotes - -.. [#f0] Gathers columns which should be returned. This node typically spends most of the time on decompressing additional columns. - -.. [#f1] A GPU sort operation can be added by the statement compiler before ``GROUP BY`` or ``JOIN`` operations. - -Statement statuses -======================= - -.. include:: /reference/sql/sql_statements/monitoring_commands/show_server_status.rst - :start-line: 67 - :end-line: 84 - -Notes -=========== - -* This utility shows the execution information for active statements. Once a query has finished execution, the information is no longer available using this utility. See :ref:`logging` for more information about extracting the information from the logs. - -* This utility is primarily intended for troubleshooting with SQream support. - -Examples -=========== - -Getting execution details for a statement ------------------------------------------------- - - -.. code-block:: psql - - t=> SELECT SHOW_SERVER_STATUS(); - service | instanceid | connection_id | serverip | serverport | database_name | user_name | clientip | statementid | statement | statementstarttime | statementstatus | statementstatusstart - --------+------------+---------------+--------------+------------+---------------+-----------+--------------+-------------+-----------------------------------------------------------------+---------------------+-----------------+--------------------- - sqream | | 152 | 192.168.1.91 | 5000 | t | sqream | 192.168.1.91 | 176 | SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | 25-12-2019 23:53:13 | Executing | 25-12-2019 23:53:13 - sqream | | 151 | 192.168.1.91 | 5000 | t | sqream | 192.168.0.1 | 177 | SELECT show_server_status() | 25-12-2019 23:51:31 | Executing | 25-12-2019 23:53:13 - - -The statement ID we want to reserach is ``176``, running on worker ``192.168.1.91``. - -The query text is ``SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1;`` - -.. code-block:: psql - - t=> SELECT SHOW_NODE_INFO(176); - stmt_id | node_id | node_type | rows | chunks | avg_rows_in_chunk | time | parent_node_id | read | write | comment | timeSum - --------+---------+--------------------+------+--------+-------------------+---------------------+----------------+------+-------+------------+-------- - 176 | 1 | PushToNetworkQueue | 1 | 1 | 1 | 2019-12-25 23:53:13 | -1 | | | | 0.0025 - 176 | 2 | Rechunk | 1 | 1 | 1 | 2019-12-25 23:53:13 | 1 | | | | 0 - 176 | 3 | GpuToCpu | 1 | 1 | 1 | 2019-12-25 23:53:13 | 2 | | | | 0 - 176 | 4 | ReorderInput | 1 | 1 | 1 | 2019-12-25 23:53:13 | 3 | | | | 0 - 176 | 5 | Filter | 1 | 1 | 1 | 2019-12-25 23:53:13 | 4 | | | | 0.0002 - 176 | 6 | GpuTransform | 457 | 1 | 457 | 2019-12-25 23:53:13 | 5 | | | | 0.0002 - 176 | 7 | GpuDecompress | 457 | 1 | 457 | 2019-12-25 23:53:13 | 6 | | | | 0 - 176 | 8 | CpuToGpu | 457 | 1 | 457 | 2019-12-25 23:53:13 | 7 | | | | 0.0003 - 176 | 9 | Rechunk | 457 | 1 | 457 | 2019-12-25 23:53:13 | 8 | | | | 0 - 176 | 10 | CpuDecompress | 457 | 1 | 457 | 2019-12-25 23:53:13 | 9 | | | | 0 - 176 | 11 | ReadTable | 457 | 1 | 457 | 2019-12-25 23:53:13 | 10 | 4MB | | public.nba | 0.0004 - diff --git a/reference/sql/sql_functions/system_functions/show_server_status.rst b/reference/sql/sql_functions/system_functions/show_server_status.rst deleted file mode 100644 index f59f79ccc..000000000 --- a/reference/sql/sql_functions/system_functions/show_server_status.rst +++ /dev/null @@ -1,108 +0,0 @@ -.. _show_server_status: - -******************** -SHOW_SERVER_STATUS -******************** - -``SHOW_SERVER_STATUS`` returns a list of active sessions across the cluster. - -To list active statements on the current worker only, see :ref:`show_connections`. - -Permissions -============= - -The role must have the ``SUPERUSER`` permissions. - -Syntax -========== - -.. code-block:: postgres - - show_server_status_statement ::= - SELECT SHOW_SERVER_STATUS() - ; - -Parameters -============ - -None - -Returns -========= - -This function returns a list of active sessions. If no sessions are active across the cluster, the result set will be empty. - -.. list-table:: Result columns - :widths: auto - :header-rows: 1 - - * - ``service`` - - The service name for the statement - * - ``instance`` - - The worker ID - * - ``connection_id`` - - Connection ID - * - ``serverip`` - - Worker end-point IP - * - ``serverport`` - - Worker end-point port - * - ``database_name`` - - Database name for the statement - * - ``user_name`` - - Username running the statement - * - ``clientip`` - - Client IP - * - ``statementid`` - - Statement ID - * - ``statement`` - - Statement text - * - ``statementstarttime`` - - Statement start timestamp - * - ``statementstatus`` - - Statement status (see table below) - * - ``statementstatusstart`` - - Last updated timestamp - -.. include from here: 66 - - -.. list-table:: Statement status values - :widths: auto - :header-rows: 1 - - * - Status - - Description - * - ``Preparing`` - - Statement is being prepared - * - ``In queue`` - - Statement is waiting for execution - * - ``Initializing`` - - Statement has entered execution checks - * - ``Executing`` - - Statement is executing - * - ``Stopping`` - - Statement is in the process of stopping - - -.. include until here 86 - -Notes -=========== - -* This utility shows the active sessions. Some sessions may be actively connected, but not running any statements. - -Examples -=========== - -Using ``SHOW_SERVER_STATUS`` to get statement IDs ----------------------------------------------------- - - -.. code-block:: psql - - t=> SELECT SHOW_SERVER_STATUS(); - service | instanceid | connection_id | serverip | serverport | database_name | user_name | clientip | statementid | statement | statementstarttime | statementstatus | statementstatusstart - --------+------------+---------------+--------------+------------+---------------+------------+-------------+-------------+-----------------------------+---------------------+-----------------+--------------------- - sqream | | 102 | 192.168.1.91 | 5000 | t | rhendricks | 192.168.0.1 | 128 | SELECT SHOW_SERVER_STATUS() | 24-12-2019 00:14:53 | Executing | 24-12-2019 00:14:53 - -The statement ID is ``128``, running on worker ``192.168.1.91``. diff --git a/reference/sql/sql_functions/system_functions/show_version.rst b/reference/sql/sql_functions/system_functions/show_version.rst deleted file mode 100644 index 8c3e7565e..000000000 --- a/reference/sql/sql_functions/system_functions/show_version.rst +++ /dev/null @@ -1,46 +0,0 @@ -.. _show_version: - -***************** -SHOW_VERSION -***************** - -``SHOW_VERSION()`` is a function that returns the system version for SQream DB. - -Permissions -============= - -No special permissions are required. - -Syntax -========== - -.. code-block:: postgres - - show_version_statement ::= - SELECT SHOW_VERSION() - ; - -Parameters -============ - -None - -Notes -========== - -To check the SQream DB version from the shell, run ``$ sqreamd --version`` - -Examples -=========== - -Getting the current SQream DB version ---------------------------------------- - - -.. code-block:: psql - - t=> SELECT SHOW_VERSION(); - bytesread - --------- - v2019.3 - diff --git a/reference/sql/sql_functions/system_functions/stop_statement.rst b/reference/sql/sql_functions/system_functions/stop_statement.rst deleted file mode 100644 index 30efc25b5..000000000 --- a/reference/sql/sql_functions/system_functions/stop_statement.rst +++ /dev/null @@ -1,77 +0,0 @@ -.. _stop_statement: - -******************** -STOP_STATEMENT -******************** - -``STOP_STATEMENT`` stops or aborts an active statement. - -To find a statement by ID, see :ref:`show_server_status` and :ref:`show_connections`. - -.. tip:: Some DBMSs call this process killing a session, terminating a job, or kill query - -Permissions -============= - -The role must have the ``SUPERUSER`` permissions. - -Syntax -========== - -.. code-block:: postgres - - stop_statement_statement ::= - SELECT STOP_STATEMENT(stmt_id) - ; - - stmt_id ::= bigint - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``stmt_id`` - - The statement ID to stop - -Returns -========= - -This utility does not return any value, and always succeeds even if the statement does not exist, or has already stopped. - - -Notes -=========== - -* This utility always succeeds even if the statement does not exist, or has already stopped. - -Examples -=========== - -Using :ref:`show_connections` to get statement IDs ----------------------------------------------------- - -.. tip:: Use :ref:`show_server_status` to find statments from across the entire cluster, or :ref:`show_connections` to show statements from the current worker the client is connected to. - -.. code-block:: psql - - t=> SELECT SHOW_CONNECTIONS(); - ip | conn_id | conn_start_time | stmt_id | stmt_start_time | stmt - -------------+---------+---------------------+---------+---------------------+-------------------------- - 192.168.1.91 | 103 | 2019-12-24 00:01:27 | 129 | 2019-12-24 00:38:18 | SELECT GET_DATE(), * F... - 192.168.1.91 | 23 | 2019-12-24 00:01:27 | -1 | 2019-12-24 00:01:27 | - 192.168.1.91 | 22 | 2019-12-24 00:01:27 | -1 | 2019-12-24 00:01:27 | - 192.168.1.91 | 26 | 2019-12-24 00:01:28 | -1 | 2019-12-24 00:01:28 | - - -The statement ID we're interested in is ``129``. We can now stop this statement: - -.. code-block:: psql - - t=> SELECT STOP_STATEMENT(129) - executed - From 5f125bc08e51aec194d0482ea0277823adbf99d0 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Wed, 27 Apr 2022 10:08:16 +0300 Subject: [PATCH 051/882] Update index.rst Improved page structure. --- reference/sql/sql_functions/index.rst | 19 ++++++++----------- 1 file changed, 8 insertions(+), 11 deletions(-) diff --git a/reference/sql/sql_functions/index.rst b/reference/sql/sql_functions/index.rst index 51d969f40..a66760b7f 100644 --- a/reference/sql/sql_functions/index.rst +++ b/reference/sql/sql_functions/index.rst @@ -117,9 +117,7 @@ The following table shows the **date and time** functions: Numeric ^^^^^^^^^^^ -The following table shows the **arithmetic operators** - -For more information about arithmetic operator, see :ref:`arithmetic_operators`. +The following table shows the **arithmetic operators**: .. list-table:: Arithmetic Operators :widths: auto @@ -150,6 +148,8 @@ For more information about arithmetic operator, see :ref:`arithmetic_operators`. - ``a % b`` - Modulu of ``a`` by ``b``. See also :ref:`mod` +For more information about arithmetic operators, see :ref:`arithmetic_operators`. + The following table shows the **arithmetic operator** functions: .. list-table:: Arithemtic Operator Functions @@ -209,7 +209,7 @@ The following table shows the **arithmetic operator** functions: Strings ^^^^^^^^^^^ -The following table shows the **string* functions: +The following table shows the **string** functions: .. list-table:: :widths: auto @@ -270,15 +270,13 @@ The following table shows the **string* functions: User-Defined Scalar Functions --------------------- -For more information about user-defined scalar functions, see :ref:`scalar_sql_udf` +For more information about user-defined scalar functions, see :ref:`scalar_sql_udf`. Aggregate Functions --------------------- The following table shows the **aggregate** functions: -For more information about aggregate functions, see :ref:`aggregate_functions`. - .. list-table:: :widths: auto :header-rows: 1 @@ -323,12 +321,12 @@ For more information about aggregate functions, see :ref:`aggregate_functions`. - ``varp`` - Calculates population variance of values +For more information about aggregate functions, see :ref:`aggregate_functions`. + Window Functions ------------------- The following table shows the **window** functions: -For more information about window functions, see :ref:`window_functions`. - .. list-table:: :widths: auto :header-rows: 1 @@ -362,8 +360,7 @@ For more information about window functions, see :ref:`window_functions`. * - :ref:`ntile` - Returns an integer ranging between ``1`` and the argument value, dividing the partitions as equally as possible - - +For more information about window functions, see :ref:`window_functions`. Workload Management Functions --------------------------------- From 981085951fca474428c7b8a4b80090b706d249a0 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 28 Apr 2022 17:48:10 +0300 Subject: [PATCH 052/882] Removed System Functions Moved System Functions to SQL Statements > Utilities, and removed System Functions --- reference/sql/sql_statements/index.rst | 5 + .../utility_commands/drop_saved_query.rst | 55 ++++++++ .../utility_commands/execute_saved_query.rst | 123 ++++++++++++++++++ .../utility_commands/list_saved_queries.rst | 77 +++++++++++ .../recompile_saved_query.rst | 88 +++++++++++++ .../utility_commands/show_saved_query.rst | 61 +++++++++ 6 files changed, 409 insertions(+) create mode 100644 reference/sql/sql_statements/utility_commands/drop_saved_query.rst create mode 100644 reference/sql/sql_statements/utility_commands/execute_saved_query.rst create mode 100644 reference/sql/sql_statements/utility_commands/list_saved_queries.rst create mode 100644 reference/sql/sql_statements/utility_commands/recompile_saved_query.rst create mode 100644 reference/sql/sql_statements/utility_commands/show_saved_query.rst diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index eab8d8f84..6845ae7cd 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -3,6 +3,11 @@ *************** SQL Statements *************** +The **SQL Statements** page describes the following commands: + +.. contents:: + :local: + :depth: 1 SQream DB supports commands from ANSI SQL. diff --git a/reference/sql/sql_statements/utility_commands/drop_saved_query.rst b/reference/sql/sql_statements/utility_commands/drop_saved_query.rst new file mode 100644 index 000000000..f7faef6c5 --- /dev/null +++ b/reference/sql/sql_statements/utility_commands/drop_saved_query.rst @@ -0,0 +1,55 @@ +.. _drop_saved_query: + +******************** +DROP_SAVED_QUERY +******************** + +``DROP_SAVED_QUERY`` drops a :ref:`previously saved query`. + +Read more in the :ref:`saved_queries` guide. + +See also: ref:`save_query`, :ref:`execute_saved_query`, ref:`show_saved_query`, ref:`list_saved_queries`. + +Permissions +============= + +Dropping a saved query requires no special permissions. + +Syntax +========== + +.. code-block:: postgres + + drop_saved_query_statement ::= + SELECT DROP_SAVED_QUERY(saved_query_name) + ; + + saved_query_name ::= string_literal + +Returns +========== + +If saved query is dropped successfully, returns nothing. + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``saved_query_name`` + - The name of the query to drop + +Examples +=========== + +Dropping a previously saved query +--------------------------------------- + +.. code-block:: psql + + t=> SELECT DROP_SAVED_QUERY('select_all'); + executed diff --git a/reference/sql/sql_statements/utility_commands/execute_saved_query.rst b/reference/sql/sql_statements/utility_commands/execute_saved_query.rst new file mode 100644 index 000000000..6fe41fa08 --- /dev/null +++ b/reference/sql/sql_statements/utility_commands/execute_saved_query.rst @@ -0,0 +1,123 @@ +.. _execute_saved_query: + +******************** +EXECUTE_SAVED_QUERY +******************** + +``EXECUTE_SAVED_QUERY`` executes a :ref:`previously saved query`. + +Read more in the :ref:`saved_queries` guide. + +See also: ref:`save_query`, :ref:`drop_saved_query`, ref:`show_saved_query`, ref:`list_saved_queries`. + +Permissions +============= + +Executing a saved query requires ``SELECT`` permissions to access the tables referenced in the query. + +Syntax +========== + +.. code-block:: postgres + + execute_saved_query_statement ::= + SELECT EXECUTE_SAVED_QUERY(saved_query_name, [ , argument [ , ... ] ] ) + ; + + saved_query_name ::= string_literal + + argument ::= string_literal | number_literal + +Returns +========== + +Query execution results, based on the query saved. + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``saved_query_name`` + - The name of the query to execute + * - ``argument`` + - A comma separated list of argument literal values + + +Notes +========= + +* Query parameters can be used as substitutes for literal expressions. Parameters cannot be used to substitute identifiers, column names, table names, or other parts of the query. + +* Query parameters of a string datatype (like ``VARCHAR``) must be of a fixed length, and can be used in equality checks, but not patterns (e.g. :ref:`like`, :ref:`rlike`, etc) + +* Query parameters' types are inferred at compile time. + +Examples +=========== + +Assume a table named ``nba``, with the following structure: + +.. code-block:: postgres + + CREATE TABLE nba + ( + Name varchar(40), + Team varchar(40), + Number tinyint, + Position varchar(2), + Age tinyint, + Height varchar(4), + Weight real, + College varchar(40), + Salary float + ); + + +Here's a peek at the table contents (:download:`Download nba.csv `): + +.. csv-table:: nba.csv + :file: nba-t10.csv + :widths: auto + :header-rows: 1 + + +Saving and executing a simple query +--------------------------------------- + +.. code-block:: psql + + t=> SELECT SAVE_QUERY('select_all','SELECT * FROM nba'); + executed + t=> SELECT EXECUTE_SAVED_QUERY('select_all'); + Name | Team | Number | Position | Age | Height | Weight | College | Salary + -------------------------+------------------------+--------+----------+-----+--------+--------+-----------------------+--------- + Avery Bradley | Boston Celtics | 0 | PG | 25 | 6-2 | 180 | Texas | 7730337 + Jae Crowder | Boston Celtics | 99 | SF | 25 | 6-6 | 235 | Marquette | 6796117 + John Holland | Boston Celtics | 30 | SG | 27 | 6-5 | 205 | Boston University | + R.J. Hunter | Boston Celtics | 28 | SG | 22 | 6-5 | 185 | Georgia State | 1148640 + [...] + +Saving and executing parametrized query +------------------------------------------ + +Use parameters to replace them later at execution time. + +.. tip:: Use dollar quoting (`$$`) to avoid escaping strings. + + .. code-block:: psql + + t=> SELECT SAVE_QUERY('select_by_weight_and_team',$$SELECT * FROM nba WHERE Weight > ? AND Team = ?$$); + executed + t=> SELECT EXECUTE_SAVED_QUERY('select_by_weight_and_team', 240, 'Toronto Raptors'); + Name | Team | Number | Position | Age | Height | Weight | College | Salary + ------------------+-----------------+--------+----------+-----+--------+--------+-------------+-------- + Bismack Biyombo | Toronto Raptors | 8 | C | 23 | 6-9 | 245 | | 2814000 + James Johnson | Toronto Raptors | 3 | PF | 29 | 6-9 | 250 | Wake Forest | 2500000 + Jason Thompson | Toronto Raptors | 1 | PF | 29 | 6-11 | 250 | Rider | 245177 + Jonas Valanciunas | Toronto Raptors | 17 | C | 24 | 7-0 | 255 | | 4660482 + diff --git a/reference/sql/sql_statements/utility_commands/list_saved_queries.rst b/reference/sql/sql_statements/utility_commands/list_saved_queries.rst new file mode 100644 index 000000000..bb1781840 --- /dev/null +++ b/reference/sql/sql_statements/utility_commands/list_saved_queries.rst @@ -0,0 +1,77 @@ +.. _list_saved_queries: + +******************** +LIST_SAVED_QUERIES +******************** + +``LIST_SAVED_QUERIES`` lists the available :ref:`previously saved queries`. + +This is an alternative way to using the ``savedqueries`` catalog view. + +Read more in the :ref:`saved_queries` guide. + +See also: ref:`save_query`, :ref:`execute_saved_query`, ref:`drop_saved_query`, ref:`show_saved_query`. + +Permissions +============= + +Listing the saved queries requires no special permissions. + +Syntax +========== + +.. code-block:: postgres + + list_saved_queries_statement ::= + SELECT LIST_SAVED_QUERIES() + ; + +Returns +========== + +List of saved query names, one per row. + +Parameters +============ + +None + +Notes +========= + +This statement returns an empty result set if no saved queries exist in the current database. + +Examples +=========== + +Listing previously saved queries +--------------------------------------- + +.. code-block:: psql + + t=> SELECT LIST_SAVED_QUERIES(); + saved_query + ------------------------- + select_all + select_by_weight + select_by_weight_and_team + + t=> SELECT SHOW_SAVED_QUERY('select_by_weight_and_team'); + saved_query + ----------------------------------------------- + SELECT * FROM nba WHERE Weight > ? AND Team = ? + + +Listing saved queries with the catalog +--------------------------------------------- + +Using the :ref:`catalog` is also possible: + +.. code-block:: psql + + t=> SELECT * FROM sqream_catalog.savedqueries; + name | num_parameters + --------------------------+--------------- + select_all | 0 + select_by_weight | 1 + select_by_weight_and_team | 2 diff --git a/reference/sql/sql_statements/utility_commands/recompile_saved_query.rst b/reference/sql/sql_statements/utility_commands/recompile_saved_query.rst new file mode 100644 index 000000000..d6b63e30e --- /dev/null +++ b/reference/sql/sql_statements/utility_commands/recompile_saved_query.rst @@ -0,0 +1,88 @@ +.. _recompile_saved_query: + +************************** +RECOMPILE_SAVED_QUERY +************************** + +``RECOMPILE_SAVED_QUERY`` recompiles a saved query that has been invalidated due to a schema change. + +Permissions +============= + +Recompiling a saved query requires no special permissions. + +Syntax +========== + +.. code-block:: postgres + + recompile_saved_query_statement ::= + SELECT RECOMPILE_SAVED_QUERY(saved_query_name) + ; + + saved_query_name ::= string_literal + +Returns +========== + +If saved query is recompiled successfully, returns nothing. + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``saved_query_name`` + - The name of the query to recompile + +Examples +=========== + +Recreating a query that has been invalidated +------------------------------------------------- + +.. code-block:: psql + + t=> SELECT SAVE_QUERY('select_by_weight_and_team',$$SELECT * FROM nba WHERE Weight > ? AND Team = ?$$); + executed + t=> SELECT EXECUTE_SAVED_QUERY('select_by_weight_and_team', 240, 'Toronto Raptors'); + Name | Team | Number | Position | Age | Height | Weight | College | Salary + ------------------+-----------------+--------+----------+-----+--------+--------+-------------+-------- + Bismack Biyombo | Toronto Raptors | 8 | C | 23 | 6-9 | 245 | | 2814000 + James Johnson | Toronto Raptors | 3 | PF | 29 | 6-9 | 250 | Wake Forest | 2500000 + Jason Thompson | Toronto Raptors | 1 | PF | 29 | 6-11 | 250 | Rider | 245177 + Jonas Valanciunas | Toronto Raptors | 17 | C | 24 | 7-0 | 255 | | 4660482 + + +To invalidate the original saved query, we will change the schema without affecting our original query text: + +.. code-block:: psql + + t=> ALTER TABLE nba RENAME COLUMN age to "Age (as of 2015)"; + executed + +However, because the query was compiled previously, this change invalidates the query and causes it to fail: + +.. code-block:: psql + + t=> SELECT EXECUTE_SAVED_QUERY('select_by_weight_and_team', 240, 'Toronto Raptors'); + Error: column not found {Age@null} + column not found {Age@null} + +Recompiling the query will fix this issue + +.. code-block:: psql + + t=> SELECT RECOMPILE_SAVED_QUERY('select_by_weight_and_team'); + executed + t=> SELECT EXECUTE_SAVED_QUERY('select_by_weight_and_team', 240, 'Toronto Raptors'); + Name | Team | Number | Position | Age (as of 2015) | Height | Weight | College | Salary + ------------------+-----------------+--------+----------+------------------+--------+--------+-------------+-------- + Bismack Biyombo | Toronto Raptors | 8 | C | 23 | 6-9 | 245 | | 2814000 + James Johnson | Toronto Raptors | 3 | PF | 29 | 6-9 | 250 | Wake Forest | 2500000 + Jason Thompson | Toronto Raptors | 1 | PF | 29 | 6-11 | 250 | Rider | 245177 + Jonas Valanciunas | Toronto Raptors | 17 | C | 24 | 7-0 | 255 | | 4660482 diff --git a/reference/sql/sql_statements/utility_commands/show_saved_query.rst b/reference/sql/sql_statements/utility_commands/show_saved_query.rst new file mode 100644 index 000000000..15ac4c1bd --- /dev/null +++ b/reference/sql/sql_statements/utility_commands/show_saved_query.rst @@ -0,0 +1,61 @@ +.. _show_saved_query: + +******************** +SHOW_SAVED_QUERY +******************** + +``SHOW_SAVED_QUERY`` shows the query text for a :ref:`previously saved query`. + +Read more in the :ref:`saved_queries` guide. + +See also: ref:`save_query`, :ref:`execute_saved_query`, ref:`drop_saved_query`, ref:`list_saved_queries`. + +Permissions +============= + +Showing a saved query requires no special permissions. + +Syntax +========== + +.. code-block:: postgres + + show_saved_query_statement ::= + SELECT SHOW_SAVED_QUERY(saved_query_name) + ; + + saved_query_name ::= string_literal + +Returns +========== + +A single row result containing the saved query string. + +Parameters +============ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``saved_query_name`` + - The name of the query to show + + +Examples +=========== + +Showing a previously saved query +--------------------------------------- + +.. code-block:: psql + + t=> SELECT SAVE_QUERY('select_by_weight_and_team',$$SELECT * FROM nba WHERE Weight > ? AND Team = ?$$); + executed + t=> SELECT SHOW_SAVED_QUERY('select_by_weight_and_team'); + saved_query + ----------------------------------------------- + SELECT * FROM nba WHERE Weight > ? AND Team = ? + From 0b0604a184e022cedd87a3894bf097a399fce9ed Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 1 May 2022 09:53:06 +0300 Subject: [PATCH 053/882] Removed Global Locks: SQ-10436 https://sqream.atlassian.net/browse/SQ-10436 Capitalized headers --- feature_guides/concurrency_and_locks.rst | 27 ++++-------------------- 1 file changed, 4 insertions(+), 23 deletions(-) diff --git a/feature_guides/concurrency_and_locks.rst b/feature_guides/concurrency_and_locks.rst index e18dea015..2a85d2642 100644 --- a/feature_guides/concurrency_and_locks.rst +++ b/feature_guides/concurrency_and_locks.rst @@ -10,7 +10,7 @@ Read only transactions are never blocked, and never block anything. Even if you .. _locking_modes: -Locking modes +Locking Modes ================ SQream DB has two kinds of locks: @@ -27,7 +27,7 @@ SQream DB has two kinds of locks: This lock allows other statements to insert or delete data from a table, but they'll have to wait in order to run DDL. -When are locks obtained? +When are Locks Obtained? ============================ .. list-table:: @@ -64,23 +64,7 @@ When are locks obtained? Statements that wait will exit with an error if they hit the lock timeout. The default timeout is 3 seconds, see ``statementLockTimeout``. -Global locks ----------------- - -Some operations require exclusive global locks at the cluster level. These usually short-lived locks will be obtained for the following operations: - - * :ref:`create_database` - * :ref:`create_role` - * :ref:`create_table` - * :ref:`alter_role` - * :ref:`alter_table` - * :ref:`drop_database` - * :ref:`drop_role` - * :ref:`drop_table` - * :ref:`grant` - * :ref:`revoke` - -Monitoring locks +Monitoring Locks =================== Monitoring locks across the cluster can be useful when transaction contention takes place, and statements appear "stuck" while waiting for a previous statement to release locks. @@ -101,7 +85,4 @@ In this example, we create a table based on results (:ref:`create_table_as`), bu 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | table$t$public$nba2$Insert | Exclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | table$t$public$nba2$Update | Exclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 -For more information on troubleshooting lock related issues, see - - - +For more information on troubleshooting lock related issues, see :ref:`lock_related_issues`. \ No newline at end of file From b6b65d51a12db74a757a769d622f766bc9bdc2f7 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Mon, 2 May 2022 11:31:21 +0300 Subject: [PATCH 054/882] TPD-123 --- .../ddl_commands/cluster_by.rst | 49 ++++++++++++------- 1 file changed, 32 insertions(+), 17 deletions(-) diff --git a/reference/sql/sql_statements/ddl_commands/cluster_by.rst b/reference/sql/sql_statements/ddl_commands/cluster_by.rst index 2a389e254..3f6023533 100644 --- a/reference/sql/sql_statements/ddl_commands/cluster_by.rst +++ b/reference/sql/sql_statements/ddl_commands/cluster_by.rst @@ -3,28 +3,38 @@ ********************** CLUSTER BY ********************** +The ``CLUSTER BY`` command is used for changing clustering keys in a table. -``CLUSTER BY`` can be used to change clustering keys in a table. +For more information, see the following: +* :ref:`flexible_data_clustering` -Read our :ref:`data_clustering` guide for more information. + :: -See also: :ref:`drop_clustering_key`, :ref:`create_table`. +* :ref:`drop_clustering_key` - -Permissions -============= - -The role must have the ``DDL`` permission at the database or table level. + :: + +* :ref:`create_table` Syntax ========== +The following is the correct syntax for the CLUSTER BY command: .. code-block:: postgres alter_table_rename_table_statement ::= ALTER TABLE [schema_name.]table_name CLUSTER BY column_name [, ...] ; + + create_table_statement ::= + CREATE [ OR REPLACE ] TABLE [schema_name.]table_name ( + { column_def [, ...] } + ) + [ CLUSTER BY { column_name [, ...] } ] + ; + + column_def :: = { column_name type_name [ default ] [ column_constraint ] } table_name ::= identifier @@ -33,6 +43,7 @@ Syntax Parameters ============ +The following table shows the CLUSTER BY parameters: .. list-table:: :widths: auto @@ -42,28 +53,32 @@ Parameters - Description * - ``schema_name`` - The schema name for the table. Defaults to ``public`` if not specified. + * - ``OR REPLACE`` + - Creates a new tables and overwrites any existing table by the same name. Does not return an error if the table already exists. ``CREATE OR REPLACE`` does not check the table contents or structure, only the table name. + * - ``column_def`` + - A comma separated list of column definitions. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally. * - ``table_name`` - The table name to apply the change to. * - ``column_name [, ... ]`` - - Comma separated list of columns to create clustering keys for + - Comma separated list of columns to create clustering keys for. - -Usage notes +Usage Notes ================= - Removing clustering keys does not affect existing data. -To force data to re-cluster, the table has to be recreated (i.e. with :ref:`create_table_as`). +To force data to re-cluster, the table has to be recreated (i.e. with :ref:`create_table`). -Examples +Example =========== - -Reclustering a table +Reclustering a Table ----------------------------------------- +The following example shows how to recluster a table: .. code-block:: postgres ALTER TABLE public.users CLUSTER BY start_date; - +Permissions +============= +The role must have the ``DDL`` permission at the database or table level. \ No newline at end of file From 5c9c1288a0ff89c313474415560bf6d3930235bf Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Mon, 2 May 2022 15:23:28 +0300 Subject: [PATCH 055/882] Update executing_statements_and_running_queries_from_the_editor.rst --- ...ts_and_running_queries_from_the_editor.rst | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/sqream_studio_5.4.3/executing_statements_and_running_queries_from_the_editor.rst b/sqream_studio_5.4.3/executing_statements_and_running_queries_from_the_editor.rst index 72cbff97b..8fa91d945 100644 --- a/sqream_studio_5.4.3/executing_statements_and_running_queries_from_the_editor.rst +++ b/sqream_studio_5.4.3/executing_statements_and_running_queries_from_the_editor.rst @@ -188,23 +188,23 @@ The database object functions are used to perform the following: * - Function - Description * - Insert statement - - Generates an `INSERT `_ statement for the selected table in the editing area. + - Generates an `INSERT `_ statement for the selected table in the editing area. * - Delete statement - - Generates a `DELETE `_ statement for the selected table in the editing area. + - Generates a `DELETE `_ statement for the selected table in the editing area. * - Create Table As statement - - Generates a `CREATE TABLE AS `_ statement for the selected table in the editing area. + - Generates a `CREATE TABLE AS `_ statement for the selected table in the editing area. * - Rename statement - - Generates an `RENAME TABLE AS `_ statement for renaming the selected table in the editing area. + - Generates an `RENAME TABLE AS `_ statement for renaming the selected table in the editing area. * - Adding column statement - - Generates an `ADD COLUMN `_ statement for adding columns to the selected table in the editing area. + - Generates an `ADD COLUMN `_ statement for adding columns to the selected table in the editing area. * - Truncate table statement - - Generates a `TRUNCATE_IF_EXISTS `_ statement for the selected table in the editing area. + - Generates a `TRUNCATE_IF_EXISTS `_ statement for the selected table in the editing area. * - Drop table statement - Generates a ``DROP`` statement for the selected object in the editing area. * - Table DDL - - Generates a DDL statement for the selected object in the editing area. To get the entire database DDL, click the |icon-ddl-edit| icon next to the database name in the tree root. See `Seeing System Objects as DDL `_. + - Generates a DDL statement for the selected object in the editing area. To get the entire database DDL, click the |icon-ddl-edit| icon next to the database name in the tree root. See `Seeing System Objects as DDL `_. * - DDL Optimizer - - The `DDL Optimizer `_ lets you analyze database tables and recommends possible optimizations. + - The `DDL Optimizer `_ lets you analyze database tables and recommends possible optimizations. Optimizing Database Tables Using the DDL Optimizer ----------------------- @@ -223,23 +223,23 @@ The following table describes the DDL Optimizer screen: * - Column area - Shows the column **names** and **column types** from the selected table. You can scroll down or to the right/left for long column lists. * - Optimization area - - Shows the number of rows to sample as the basis for running an optimization, the default setting (1,000,000) when running an optimization (this is also the overhead threshold used when analyzing ``TEXT`` fields), and the default percent buffer to add to ``TEXT`` lengths (10%). Attempts to determine field nullability. + - Shows the number of rows to sample as the basis for running an optimization, the default setting (1,000,000) when running an optimization (this is also the overhead threshold used when analyzing ``VARCHAR`` fields), and the default percent buffer to add to ``VARCHAR`` lengths (10%). Attempts to determine field nullability. * - Run Optimizer - Starts the optimization process. Clicking **Run Optimizer** adds a tab to the Statement panel showing the optimized results of the selected object. -For more information, see `Optimization and Best Practices `_. +For more information, see `Optimization and Best Practices `_. Executing Pre-Defined Queries from the System Queries Panel --------------- The **System Queries** panel lets you execute predefined queries and includes the following system query types: -* **Catalog queries** - used for analyzing table compression rates, users and permissions, etc. +* **Catalog queries** - Used for analyzing table compression rates, users and permissions, etc. :: -* **Admin queries** - queries related to available (describe the functionality in a general way). Queries useful for SQream database management. +* **Admin queries** - Queries useful for SQream database management. Clicking an item pastes the query into the Statement pane, and you can undo a previous operation by pressing **Ctrl + Z**. @@ -274,7 +274,7 @@ You can add and name new tabs for each statement that you need to execute, and S You can also rename the default tab name by double-clicking it and typing a new name and write multiple statements in tandem in the same tab by separating them with semicolons (``;``).If too many tabs to fit into the Statement Pane are open at the same time, the tab arrows are displayed. You can scroll through the tabs by clicking |icon-left| or |icon-right|, and close tabs by clicking |icon-close|. You can also close all tabs at once by clicking **Close all** located to the right of the tabs. -.. tip:: If this is your first time using SQream, see `Getting Started `_. +.. tip:: If this is your first time using SQream, see `Getting Started `_. .. Keyboard shortcuts From 7bb5c634915b411365f9cb244f45681a54dbcf5a Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 10 May 2022 14:10:37 +0300 Subject: [PATCH 056/882] TPD-106 --- .../ddl_commands/rename_column.rst | 27 ++++++++++++------- 1 file changed, 17 insertions(+), 10 deletions(-) diff --git a/reference/sql/sql_statements/ddl_commands/rename_column.rst b/reference/sql/sql_statements/ddl_commands/rename_column.rst index 41f1e1628..1022ce0f2 100644 --- a/reference/sql/sql_statements/ddl_commands/rename_column.rst +++ b/reference/sql/sql_statements/ddl_commands/rename_column.rst @@ -3,16 +3,11 @@ ********************** RENAME COLUMN ********************** - -``RENAME COLUMN`` can be used to rename columns in a table. - -Permissions -============= - -The role must have the ``DDL`` permission at the database or table level. +The ``RENAME COLUMN`` command can be used to rename columns in a table. Syntax ========== +The following is the correct syntax for the ``RENAME_COLUMN`` command: .. code-block:: postgres @@ -30,6 +25,7 @@ Syntax Parameters ============ +The following table describes the `RENAME_COLUMN`` parameters: .. list-table:: :widths: auto @@ -48,18 +44,29 @@ Parameters Examples =========== +The **Examples** section includes the following examples: -Renaming a column +.. contents:: + :local: + :depth: 1 + +Renaming a Column ----------------------------------------- +The following is an example of renaming a column: .. code-block:: postgres -- Remove the 'weight' column ALTER TABLE users RENAME COLUMN weight TO mass; -Renaming a quoted name +Renaming a Quoted Name -------------------------- +The following is an example of renaming a quoted name: .. code-block:: postgres - ALTER TABLE users RENAME COLUMN "mass" TO "Mass (Kilograms); \ No newline at end of file + ALTER TABLE users RENAME COLUMN "mass" TO "Mass (Kilograms); + +Permissions +============= +The role must have the ``DDL`` permission at the database or table level. \ No newline at end of file From dd7d6cfecfa88b7ae19632d67e450c8dded1ce7b Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 10 May 2022 14:42:30 +0300 Subject: [PATCH 057/882] TPD-155 --- .../ddl_commands/add_column.rst | 33 +++++++++---------- 1 file changed, 16 insertions(+), 17 deletions(-) diff --git a/reference/sql/sql_statements/ddl_commands/add_column.rst b/reference/sql/sql_statements/ddl_commands/add_column.rst index cec4aec7b..bac71bd2c 100644 --- a/reference/sql/sql_statements/ddl_commands/add_column.rst +++ b/reference/sql/sql_statements/ddl_commands/add_column.rst @@ -3,14 +3,11 @@ ********************** ADD COLUMN ********************** - -The ``ADD COLUMN`` command is used to add columns to an existing table. - - +The ``ADD COLUMN`` command is used to add columns to an existing table. Syntax ========== -The following is the correct syntax for adding a table: +The following is the correct syntax for adding a column to an existing table: .. code-block:: postgres @@ -32,8 +29,6 @@ The following is the correct syntax for adding a table: default ::= DEFAULT default_value - - Parameters ============ The following parameters can be used for adding a table: @@ -52,19 +47,20 @@ The following parameters can be used for adding a table: - A comma separated list of ADD COLUMN commands * - ``column_def`` - A column definition. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally. + +Usage Notes +=========== +The following usage notes apply when adding a column to an existing table: -.. note:: * When adding a new column to an existing table, a default (or null constraint) has to be specified, even if the table is empty. - * A new column added to the table can not contain an IDENTITY or be of the TEXT type. - -Permissions -============= -The role must have the ``DDL`` permission at the database or table level. + :: + + * New columns you add to the table cannot be TEXT or contain an IDENTITY. Examples =========== -This section includes the following examples: +The **Examples** section includes the following examples: .. contents:: :local: @@ -77,8 +73,7 @@ This example shows how to add a simple column with a default value: .. code-block:: postgres ALTER TABLE cool_animals - ADD COLUMN number_of_eyes INT DEFAULT 2 NOT NULL; - + ADD COLUMN number_of_eyes INT DEFAULT 2 NOT NULL; Adding Several Columns in One Command ------------------------------------------- @@ -88,4 +83,8 @@ This example shows how to add several columns in one command: ALTER TABLE cool_animals ADD COLUMN number_of_eyes INT DEFAULT 2 NOT NULL, - ADD COLUMN date_seen DATE DEFAULT '2019-08-01'; + ADD COLUMN date_seen DATE DEFAULT '2019-08-01'; + +Permissions +============= +The role must have the ``DDL`` permission at the database or table level. \ No newline at end of file From 832934365ee43872388a3501a20eeda2b3a04a31 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 10 May 2022 17:31:35 +0300 Subject: [PATCH 058/882] TPD-88 --- reference/sql/sql_statements/ddl_commands/cluster_by.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/reference/sql/sql_statements/ddl_commands/cluster_by.rst b/reference/sql/sql_statements/ddl_commands/cluster_by.rst index 3f6023533..e4cf42ad4 100644 --- a/reference/sql/sql_statements/ddl_commands/cluster_by.rst +++ b/reference/sql/sql_statements/ddl_commands/cluster_by.rst @@ -40,6 +40,7 @@ The following is the correct syntax for the CLUSTER BY command: column_name ::= identifier +.. note:: SQream does not support clustering by TEXT columns. Parameters ============ From 2a34788254b4702b4d1e4c9f41f3fe1a704fa344 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 12 May 2022 15:50:45 +0300 Subject: [PATCH 059/882] TPD-154: Partial implementation Implemented some of Nadia's comments. Questions remain about others. --- feature_guides/workload_manager.rst | 7 +++---- reference/configuration.rst | 5 ----- reference/sql/sql_statements/index.rst | 2 +- .../sql_statements/wlm_commands/unsubscribe_service.rst | 2 +- .../configuring_your_instance_of_sqream.rst | 2 +- 5 files changed, 6 insertions(+), 12 deletions(-) delete mode 100644 reference/configuration.rst diff --git a/feature_guides/workload_manager.rst b/feature_guides/workload_manager.rst index c8eb2468d..aece3d11f 100644 --- a/feature_guides/workload_manager.rst +++ b/feature_guides/workload_manager.rst @@ -4,12 +4,11 @@ Workload Manager *********************** -The **Workload Manager** allows SQream DB workers to identify their availability to clients with specific service names. The load balancer uses that information to route statements to specific workers. +The **Workload Manager** allows SQream workers to identify their availability to clients with specific service names. The load balancer uses that information to route statements to specific workers. Overview =============================== - -The Workload Manager allows a system engineer or database administrator to allocate specific workers and compute resoucres for various tasks. +The Workload Manager allows a system engineer or database administrator to allocate specific workers and compute resources for various tasks. For example: @@ -60,7 +59,7 @@ The configuration in this example allocates resources as shown below: - ✓ - ✓ -This configuration gives the ETL queue dedicated access to two workers, one of which cannot be used by regular queries. +This configuration gives the ETL queue dedicated access to one worker, which cannot be used.. Queries from management uses any available worker. diff --git a/reference/configuration.rst b/reference/configuration.rst deleted file mode 100644 index bf487496e..000000000 --- a/reference/configuration.rst +++ /dev/null @@ -1,5 +0,0 @@ -.. _configuration_reference: - -************************* -Configuration -************************* diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index 6845ae7cd..04b24a58f 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -171,7 +171,7 @@ Workload Management * - :ref:`subscribe_service` - Add a SQream DB worker to a service queue * - :ref:`unsubscribe_service` - - Remove a SQream DB worker to a service queue + - Remove a SQream DB worker from a service queue * - :ref:`show_subscribed_instances` - Return a list of service queues and workers diff --git a/reference/sql/sql_statements/wlm_commands/unsubscribe_service.rst b/reference/sql/sql_statements/wlm_commands/unsubscribe_service.rst index a26df0554..939d8918a 100644 --- a/reference/sql/sql_statements/wlm_commands/unsubscribe_service.rst +++ b/reference/sql/sql_statements/wlm_commands/unsubscribe_service.rst @@ -47,7 +47,7 @@ Notes * If the service name does not currently exist, it will be created -.. warning:: ``UNSUBSCRIBE_SERVICE`` applies the service subscription immediately, but the setting applies for the duration of the session. To apply a persistent setting, use the ``initialSubscribedServices`` configuration setting. Read the :ref:`Workload manager guide` for more information. +.. warning:: ``UNSUBSCRIBE_SERVICE`` removes the service subscription immediately, but the setting applies for the duration of the session. To apply a persistent setting, use the ``initialSubscribedServices`` configuration setting. Read the :ref:`Workload manager guide` for more information. Examples =========== diff --git a/sqream_studio_5.4.3/configuring_your_instance_of_sqream.rst b/sqream_studio_5.4.3/configuring_your_instance_of_sqream.rst index 2a60146e0..e5f4b11e5 100644 --- a/sqream_studio_5.4.3/configuring_your_instance_of_sqream.rst +++ b/sqream_studio_5.4.3/configuring_your_instance_of_sqream.rst @@ -20,4 +20,4 @@ Exporting and Importing Configuration Files ------------------------- You can also export and import your configuration settings into a .json file. This allows you to easily edit your parameters and to share this file with other users if required. -For more information about configuring your instance of SQream, see `Configuration Guides `_. +For more information about configuring your instance of SQream, see `Configuration Guides `_. \ No newline at end of file From 6e3cfd2bf5f06ef1c97c1b155aa7258cf75773ec Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 15 May 2022 11:21:40 +0300 Subject: [PATCH 060/882] SQ-10052 --- data_type_guides/converting_and_casting_types.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/data_type_guides/converting_and_casting_types.rst b/data_type_guides/converting_and_casting_types.rst index e4de6eeb7..bb6475646 100644 --- a/data_type_guides/converting_and_casting_types.rst +++ b/data_type_guides/converting_and_casting_types.rst @@ -15,7 +15,7 @@ You can rectify this by casting the value to a larger data type, as shown below: SQream supports the following three data conversion types: -* ``CAST( TO )``, to convert a value from one type to another. For example, ``CAST('1997-01-01' TO DATE)``, ``CAST(3.45 TO SMALLINT)``, ``CAST(some_column TO TEXT(30))``. +* ``CAST( TO )``, to convert a value from one type to another. For example, ``CAST('1997-01-01' TO DATE)``, ``CAST(3.45 TO SMALLINT)``, ``CAST(some_column TO VARCHAR(30))``. :: @@ -23,4 +23,6 @@ SQream supports the following three data conversion types: :: -* See the :ref:`SQL functions reference ` for additional functions that convert from a specific value which is not an SQL type, such as :ref:`from_unixts`, etc. \ No newline at end of file +* See the :ref:`SQL functions reference ` for additional functions that convert from a specific value which is not an SQL type, such as :ref:`from_unixts`, etc. + +.. note:: SQream interprets integer constants exceeding the maximum bigint value as float constants, which may cause precision loss. \ No newline at end of file From e648c7b600be1453493cf0e417c0bf819f964f70 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 15 May 2022 11:52:00 +0300 Subject: [PATCH 061/882] Moved show_server_status to Utility Commands --- reference/sql/sql_statements/index.rst | 2 - .../show_server_status.rst | 108 ------------------ 2 files changed, 110 deletions(-) delete mode 100644 reference/sql/sql_statements/monitoring_commands/show_server_status.rst diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index 04b24a58f..cdaf8a94f 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -152,8 +152,6 @@ Monitoring statements allow a database administrator to execute actions in the s - Returns any existing locks in the database * - :ref:`show_node_info` - Returns a query plan for an actively running statement with timing information - * - :ref:`show_server_status` - - Shows running statements across the cluster * - :ref:`show_version` - Returns the version of SQream DB * - :ref:`stop_statement` diff --git a/reference/sql/sql_statements/monitoring_commands/show_server_status.rst b/reference/sql/sql_statements/monitoring_commands/show_server_status.rst deleted file mode 100644 index f59f79ccc..000000000 --- a/reference/sql/sql_statements/monitoring_commands/show_server_status.rst +++ /dev/null @@ -1,108 +0,0 @@ -.. _show_server_status: - -******************** -SHOW_SERVER_STATUS -******************** - -``SHOW_SERVER_STATUS`` returns a list of active sessions across the cluster. - -To list active statements on the current worker only, see :ref:`show_connections`. - -Permissions -============= - -The role must have the ``SUPERUSER`` permissions. - -Syntax -========== - -.. code-block:: postgres - - show_server_status_statement ::= - SELECT SHOW_SERVER_STATUS() - ; - -Parameters -============ - -None - -Returns -========= - -This function returns a list of active sessions. If no sessions are active across the cluster, the result set will be empty. - -.. list-table:: Result columns - :widths: auto - :header-rows: 1 - - * - ``service`` - - The service name for the statement - * - ``instance`` - - The worker ID - * - ``connection_id`` - - Connection ID - * - ``serverip`` - - Worker end-point IP - * - ``serverport`` - - Worker end-point port - * - ``database_name`` - - Database name for the statement - * - ``user_name`` - - Username running the statement - * - ``clientip`` - - Client IP - * - ``statementid`` - - Statement ID - * - ``statement`` - - Statement text - * - ``statementstarttime`` - - Statement start timestamp - * - ``statementstatus`` - - Statement status (see table below) - * - ``statementstatusstart`` - - Last updated timestamp - -.. include from here: 66 - - -.. list-table:: Statement status values - :widths: auto - :header-rows: 1 - - * - Status - - Description - * - ``Preparing`` - - Statement is being prepared - * - ``In queue`` - - Statement is waiting for execution - * - ``Initializing`` - - Statement has entered execution checks - * - ``Executing`` - - Statement is executing - * - ``Stopping`` - - Statement is in the process of stopping - - -.. include until here 86 - -Notes -=========== - -* This utility shows the active sessions. Some sessions may be actively connected, but not running any statements. - -Examples -=========== - -Using ``SHOW_SERVER_STATUS`` to get statement IDs ----------------------------------------------------- - - -.. code-block:: psql - - t=> SELECT SHOW_SERVER_STATUS(); - service | instanceid | connection_id | serverip | serverport | database_name | user_name | clientip | statementid | statement | statementstarttime | statementstatus | statementstatusstart - --------+------------+---------------+--------------+------------+---------------+------------+-------------+-------------+-----------------------------+---------------------+-----------------+--------------------- - sqream | | 102 | 192.168.1.91 | 5000 | t | rhendricks | 192.168.0.1 | 128 | SELECT SHOW_SERVER_STATUS() | 24-12-2019 00:14:53 | Executing | 24-12-2019 00:14:53 - -The statement ID is ``128``, running on worker ``192.168.1.91``. From 4c0b91d170ef76eb295441588e972819d336a086 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 15 May 2022 12:21:33 +0300 Subject: [PATCH 062/882] Moved show_server_status to Utility Commands --- reference/sql/sql_statements/index.rst | 22 -- .../monitoring_commands/explain.rst | 59 ---- .../monitoring_commands/show_connections.rst | 78 ----- .../monitoring_commands/show_locks.rst | 79 ----- .../monitoring_commands/show_node_info.rst | 310 ------------------ .../monitoring_commands/stop_statement.rst | 77 ----- 6 files changed, 625 deletions(-) delete mode 100644 reference/sql/sql_statements/monitoring_commands/explain.rst delete mode 100644 reference/sql/sql_statements/monitoring_commands/show_connections.rst delete mode 100644 reference/sql/sql_statements/monitoring_commands/show_locks.rst delete mode 100644 reference/sql/sql_statements/monitoring_commands/show_node_info.rst delete mode 100644 reference/sql/sql_statements/monitoring_commands/stop_statement.rst diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index cdaf8a94f..d0a6c04c8 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -133,29 +133,7 @@ Utility Commands - Stops or aborts an active statement -Monitoring -=============== -Monitoring statements allow a database administrator to execute actions in the system, such as aborting a query or get information about system processes. - -.. list-table:: Monitoring - :widths: auto - :header-rows: 1 - - * - Command - - Usage - * - :ref:`explain` - - Returns a static query plan for a statement - * - :ref:`show_connections` - - Returns a list of jobs and statements on the current worker - * - :ref:`show_locks` - - Returns any existing locks in the database - * - :ref:`show_node_info` - - Returns a query plan for an actively running statement with timing information - * - :ref:`show_version` - - Returns the version of SQream DB - * - :ref:`stop_statement` - - Stops a query (or statement) if it is currently running Workload Management ====================== diff --git a/reference/sql/sql_statements/monitoring_commands/explain.rst b/reference/sql/sql_statements/monitoring_commands/explain.rst deleted file mode 100644 index e9b7e7ee9..000000000 --- a/reference/sql/sql_statements/monitoring_commands/explain.rst +++ /dev/null @@ -1,59 +0,0 @@ -.. _explain: - -***************** -EXPLAIN -***************** - -``EXPLAIN`` returns a static query plan, which can be used to debug query plans. - -To see an actively running query or statement, use :ref:`show_node_info` instead. - -See also :ref:`show_node_info`, :ref:`show_server_status`. - - -Permissions -============= - -The role must have the ``SELECT`` permissions for any tables referenced by the query. - -Syntax -========== - -.. code-block:: postgres - - explain_statement ::= - SELECT EXPLAIN(query_stmt) - ; - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``query_stmt`` - - The select query to generate the plan for. - -Notes -=========== - -Use dollar-quoting to escape the query text - -Examples -=========== - -Generating a static query plan ----------------------------------- - -.. code-block:: psql - - t=> SELECT EXPLAIN($$SELECT DATEADD(hour,1,dt) FROM cool_dates$$); - Select - Specific (TTNative Gpu) (dateadd@null := dt@null, - dateadd@val := (pure_if dt@null "0" (addHoursdt2dt dt@val "1"))) - Table Scan - public.cool_dates ("dt@null", "dt@val") [] - diff --git a/reference/sql/sql_statements/monitoring_commands/show_connections.rst b/reference/sql/sql_statements/monitoring_commands/show_connections.rst deleted file mode 100644 index 1bd320a4c..000000000 --- a/reference/sql/sql_statements/monitoring_commands/show_connections.rst +++ /dev/null @@ -1,78 +0,0 @@ -.. _show_connections: - -******************** -SHOW_CONNECTIONS -******************** - -``SHOW_CONNECTIONS`` returns a list of active sessions on the current worker. - -To see sessions across the cluster, see :ref:`show_server_status`. - -Permissions -============= - -The role must have the ``SUPERUSER`` permissions. - -Syntax -========== - -.. code-block:: postgres - - show_connections_statement ::= - SELECT SHOW_CONNECTIONS() - ; - -Parameters -============ - -None - -Returns -========= - -This function returns a list of active sessions. If no sessions are active on the worker, the result set will be empty. - -.. list-table:: Result columns - :widths: auto - :header-rows: 1 - - * - ``ip`` - - The worker hostname or IP - * - ``conn_id`` - - Connection ID - * - ``conn_start_time`` - - Connection start timestamp - * - ``stmt_id`` - - Statement ID. Connections with no active statement display ``-1``. - * - ``stmt_start_time`` - - Statement start timestamp - * - ``stmt`` - - Statement text - - -Notes -=========== - -* This utility shows the active connections. Some sessions may be actively connected, but not currently running a statement. - -* A connection is typically reused. There could be many statements under a single connection ID. - -Examples -=========== - -Using ``SHOW_CONNECTIONS`` to get statement IDs ----------------------------------------------------- - - -.. code-block:: psql - - t=> SELECT SHOW_CONNECTIONS(); - ip | conn_id | conn_start_time | stmt_id | stmt_start_time | stmt - -------------+---------+---------------------+---------+---------------------+-------------------------- - 192.168.1.91 | 103 | 2019-12-24 00:01:27 | 129 | 2019-12-24 00:38:18 | SELECT GET_DATE(), * F... - 192.168.1.91 | 23 | 2019-12-24 00:01:27 | -1 | 2019-12-24 00:01:27 | - 192.168.1.91 | 22 | 2019-12-24 00:01:27 | -1 | 2019-12-24 00:01:27 | - 192.168.1.91 | 26 | 2019-12-24 00:01:28 | -1 | 2019-12-24 00:01:28 | - - -The statement ID we're interested in is ``129``. We can see the connection started at 00:01:27, while the statement started at 00:38:18. \ No newline at end of file diff --git a/reference/sql/sql_statements/monitoring_commands/show_locks.rst b/reference/sql/sql_statements/monitoring_commands/show_locks.rst deleted file mode 100644 index d5e7c02ec..000000000 --- a/reference/sql/sql_statements/monitoring_commands/show_locks.rst +++ /dev/null @@ -1,79 +0,0 @@ -.. _show_locks: - -******************** -SHOW_LOCKS -******************** - -``SHOW_LOCKS`` returns a list of locks from across the cluster. - -Read more about locks in :ref:`concurrency_and_locks`. - -Permissions -============= - -The role must have the ``SUPERUSER`` permissions. - -Syntax -========== - -.. code-block:: postgres - - show_locks_statement ::= - SELECT SHOW_LOCKS() - ; - -Parameters -============ - -None - -Returns -========= - -This function returns a list of active locks. If no locks are active in the cluster, the result set will be empty. - -.. list-table:: Result columns - :widths: auto - :header-rows: 1 - - * - ``stmt_id`` - - Statement ID that caused the lock. - * - ``stmt_string`` - - Statement text - * - ``username`` - - The role that executed the statement - * - ``server`` - - The worker node's IP - * - ``port`` - - The worker node's port - * - ``locked_object`` - - The full qualified name of the object being locked, separated with ``$`` (e.g. ``table$t$public$nba2`` for table ``nba2`` in schema ``public``, in database ``t`` - * - ``lockmode`` - - The locking mode (:ref:`inclusive` or :ref:`exclusive`). - * - ``statement_start_time`` - - Timestamp the statement started - * - ``lock_start_time`` - - Timestamp the lock was obtained - - -Examples -=========== - -Using ``SHOW_LOCKS`` to see active locks ---------------------------------------------------- - -In this example, we create a table based on results (:ref:`create_table_as`), but we are also effectively dropping the previous table (by using ``OR REPLACE``). Thus, SQream DB applies locks during the table creation process to prevent the table from being altered during it's creation. - - -.. code-block:: psql - - t=> SELECT SHOW_LOCKS(); - statement_id | statement_string | username | server | port | locked_object | lockmode | statement_start_time | lock_start_time - -------------+-------------------------------------------------------------------------------------------------+----------+--------------+------+---------------------------------+-----------+----------------------+-------------------- - 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | database$t | Inclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 - 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | globalpermission$ | Exclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 - 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | schema$t$public | Inclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 - 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | table$t$public$nba2$Insert | Exclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 - 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | table$t$public$nba2$Update | Exclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 - - diff --git a/reference/sql/sql_statements/monitoring_commands/show_node_info.rst b/reference/sql/sql_statements/monitoring_commands/show_node_info.rst deleted file mode 100644 index 9c1e1ec11..000000000 --- a/reference/sql/sql_statements/monitoring_commands/show_node_info.rst +++ /dev/null @@ -1,310 +0,0 @@ -.. _show_node_info: - -******************** -SHOW_NODE_INFO -******************** - -``SHOW_NODE_INFO`` returns a snapshot of the current query plan, similar to ``EXPLAIN ANALYZE`` from other databases. - -The snapshot provides information about execution which can be used for monitoring and troubleshooting slow running statements by helping identify long-running execution nodes (components that process data), etc. - -See also :ref:`explain`, :ref:`show_server_status`. - -Permissions -============= - -The role must have the ``SUPERUSER`` permissions. - -Syntax -========== - -.. code-block:: postgres - - show_node_info_statement ::= - SELECT SHOW_NODE_INFO(stmt_id) - ; - - stmt_id ::= bigint - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``stmt_id`` - - The statement ID to explore - -Returns -========= - -This utility returns details of the execution nodes, if the statement is still running. - -If the statement has finished, or the statment ID does not exist, the utility returns an empty result set. - -.. list-table:: Result columns - :widths: auto - :header-rows: 1 - - * - Column name - - Description - * - ``stmt_id`` - - The ID for the statement - * - ``node_id`` - - This node's ID in this execution plan - * - ``node_type`` - - The node type - * - ``rows`` - - Total number of rows this node has processed - * - ``chunks`` - - Number of chunks this node has processed - * - ``avg_rows_in_chunk`` - - Average amount of rows that this node processes in each chunk (``rows / chunks``) - * - ``time`` - - Timestamp for this node's creation - * - ``parent_node_id`` - - The ``node_id`` of this node's parent - * - ``read`` - - Total data read from disk - * - ``write`` - - Total data written to disk - * - ``comment`` - - Additional information (e.g. table name for ``ReadTable``) - * - ``timesum`` - - Total elapsed time for this execution node's processing - - -.. _node_types: - -Node types -============= - -This is a full list of node types: - -.. list-table:: Node types - :widths: auto - :header-rows: 1 - - * - Column name - - Execution location - - Description - * - ``AddChunkId`` - - - - Used during insert operations - * - ``AddSequences`` - - - - Used during insert operations, with :ref:`identity columns` - * - ``AddMinMaxMetadata`` - - - - Used to calculate ranges for the :ref:`chunk metadata system` - * - ``AddTopSortFilters`` - - - - An operation to optimize ``LIMIT`` when used alongside ``ORDER BY`` - * - ``Compress`` - - CPU and GPU - - Compress data with both CPU and GPU schemes - * - ``CpuDecompress`` - - CPU - - Decompression operation, common for longer ``TEXT`` types - * - ``CpuLoopJoin`` - - CPU - - A non-indexed nested loop join, performed on the CPU - * - ``CpuReduce`` - - CPU - - A reduce process performed on the CPU, primarily with ``DISTINCT`` aggregates (e.g. ``COUNT(DISTINCT ...)``) - * - ``CpuToGpu``, ``GpuToCpu`` - - - - An operation that moves data to or from the GPU for processing - * - ``CpuTransform`` - - CPU - - A transform operation performed on the CPU, usually a :ref:`scalar function` - * - ``CrossJoin`` - - - - A join without a join condition - * - ``DeferredGather`` - - CPU - - Merges the results of GPU operations with a result set [#f0]_ - * - ``Distinct`` - - GPU - - Removes duplicate rows (usually as part of the ``DISTINCT`` operation) - * - ``Distinct_Merge`` - - CPU - - The merge operation of the ``Distinct`` operation - * - ``Filter`` - - GPU - - A filtering operation, such as a ``WHERE`` or ``JOIN`` clause - * - ``GpuCopy`` - - GPU - - Copies data between GPUs or within a single GPU - * - ``GpuDecompress`` - - GPU - - Decompression operation - * - ``GpuReduceMerge`` - - GPU - - An operation to optimize part of the merger phases in the GPU - * - ``GpuTransform`` - - GPU - - A transformation operation such as a type cast or :ref:`scalar function` - * - ``Hash`` - - CPU - - Hashes the output result. Used internally. - * - ``JoinSideMarker`` - - - - Used internally. - * - ``LiteralValues`` - - CPU - - Creates a virtual relation (table), when :ref:`values` is used - * - ``LocateFiles`` - - CPU - - Validates external file paths for foreign data wrappers, expanding directories and GLOB patterns - * - ``LoopJoin`` - - GPU - - A non-indexed nested loop join, performed on the GPU - * - ``MarkMatchedJoinRows`` - - - - Used in outer joins, matches rows for larger join operations - * - ``NullifyDuplicates`` - - - - Replaces duplicate values with ``NULL`` to calculate distinct aggregates - * - ``NullSink`` - - CPU - - Used internally - * - ``ParseCsv`` - - CPU - - A CSV parser, used after ``ReadFiles`` to convert the CSV into columnar data - * - ``PopNetworkQueue`` - - CPU - - Fetches data from the network queue (e.g. when used with :ref:`insert`) - * - ``PushToNetworkQueue`` - - CPU - - Sends result sets to a client connected over the network - * - ``ReadCatalog`` - - CPU - - Converts the :ref:`catalog` into a relation (table) - * - ``ReadFiles`` - - CPU - - Reads external flat-files - * - ``ReadOrc`` - - CPU - - Reads data from an ORC file - * - ``ReadParquet`` - - CPU - - Reads data from a Parquet file - * - ``ReadTable`` - - CPU - - Reads data from a standard table stored on disk - * - ``ReadTableMetadata`` - - CPU - - Reads only table metadata as an optimization - * - ``Rechunk`` - - - - Reorganize multiple small :ref:`chunks` into a full chunk. Commonly found after joins and when :ref:`HIGH_SELECTIVITY` is used - * - ``Reduce`` - - GPU - - A reduction operation, such as a ``GROUP BY`` - * - ``ReduceMerge`` - - GPU - - A merge operation of a reduction operation, helps operate on larger-than-RAM data - * - ``ReorderInput`` - - - - Change the order of arguments in preparation for the next operation - * - ``SeparatedGather`` - - GPU - - Gathers additional columns for the result - * - ``Sort`` - - GPU - - Sort operation [#f1]_ - * - ``SortMerge`` - - CPU - - A merge operation of a sort operation, helps operate on larger-than-RAM data - * - ``SortMergeJoin`` - - GPU - - A sort-merge join, performed on the GPU - * - ``TakeRowsFromChunk`` - - - - Take the first N rows from each chunk, to optimize ``LIMIT`` when used alongside ``ORDER BY`` - * - ``Top`` - - - - Limits the input size, when used with ``LIMIT`` (or its alias ``TOP``) - * - ``UdfTransform`` - - CPU - - Executes a :ref:`user defined function` - * - ``UnionAll`` - - - - Combines two sources of data when ``UNION ALL`` is used - * - ``VarCharJoiner`` - - - - Used internally - * - ``VarCharSplitter`` - - - - Used intenrally - * - ``Window`` - - GPU - - Executes a non-ranking :ref:`window function` - * - ``WindowRanking`` - - GPU - - Executes a ranking :ref:`window function` - * - ``WriteTable`` - - CPU - - Writes the result set to a standard table stored on disk - -.. rubric:: Footnotes - -.. [#f0] Gathers columns which should be returned. This node typically spends most of the time on decompressing additional columns. - -.. [#f1] A GPU sort operation can be added by the statement compiler before ``GROUP BY`` or ``JOIN`` operations. - -Statement statuses -======================= - -.. include:: /reference/sql/sql_statements/monitoring_commands/show_server_status.rst - :start-line: 67 - :end-line: 84 - -Notes -=========== - -* This utility shows the execution information for active statements. Once a query has finished execution, the information is no longer available using this utility. See :ref:`logging` for more information about extracting the information from the logs. - -* This utility is primarily intended for troubleshooting with SQream support. - -Examples -=========== - -Getting execution details for a statement ------------------------------------------------- - - -.. code-block:: psql - - t=> SELECT SHOW_SERVER_STATUS(); - service | instanceid | connection_id | serverip | serverport | database_name | user_name | clientip | statementid | statement | statementstarttime | statementstatus | statementstatusstart - --------+------------+---------------+--------------+------------+---------------+-----------+--------------+-------------+-----------------------------------------------------------------+---------------------+-----------------+--------------------- - sqream | | 152 | 192.168.1.91 | 5000 | t | sqream | 192.168.1.91 | 176 | SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | 25-12-2019 23:53:13 | Executing | 25-12-2019 23:53:13 - sqream | | 151 | 192.168.1.91 | 5000 | t | sqream | 192.168.0.1 | 177 | SELECT show_server_status() | 25-12-2019 23:51:31 | Executing | 25-12-2019 23:53:13 - - -The statement ID we want to reserach is ``176``, running on worker ``192.168.1.91``. - -The query text is ``SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1;`` - -.. code-block:: psql - - t=> SELECT SHOW_NODE_INFO(176); - stmt_id | node_id | node_type | rows | chunks | avg_rows_in_chunk | time | parent_node_id | read | write | comment | timeSum - --------+---------+--------------------+------+--------+-------------------+---------------------+----------------+------+-------+------------+-------- - 176 | 1 | PushToNetworkQueue | 1 | 1 | 1 | 2019-12-25 23:53:13 | -1 | | | | 0.0025 - 176 | 2 | Rechunk | 1 | 1 | 1 | 2019-12-25 23:53:13 | 1 | | | | 0 - 176 | 3 | GpuToCpu | 1 | 1 | 1 | 2019-12-25 23:53:13 | 2 | | | | 0 - 176 | 4 | ReorderInput | 1 | 1 | 1 | 2019-12-25 23:53:13 | 3 | | | | 0 - 176 | 5 | Filter | 1 | 1 | 1 | 2019-12-25 23:53:13 | 4 | | | | 0.0002 - 176 | 6 | GpuTransform | 457 | 1 | 457 | 2019-12-25 23:53:13 | 5 | | | | 0.0002 - 176 | 7 | GpuDecompress | 457 | 1 | 457 | 2019-12-25 23:53:13 | 6 | | | | 0 - 176 | 8 | CpuToGpu | 457 | 1 | 457 | 2019-12-25 23:53:13 | 7 | | | | 0.0003 - 176 | 9 | Rechunk | 457 | 1 | 457 | 2019-12-25 23:53:13 | 8 | | | | 0 - 176 | 10 | CpuDecompress | 457 | 1 | 457 | 2019-12-25 23:53:13 | 9 | | | | 0 - 176 | 11 | ReadTable | 457 | 1 | 457 | 2019-12-25 23:53:13 | 10 | 4MB | | public.nba | 0.0004 - diff --git a/reference/sql/sql_statements/monitoring_commands/stop_statement.rst b/reference/sql/sql_statements/monitoring_commands/stop_statement.rst deleted file mode 100644 index 30efc25b5..000000000 --- a/reference/sql/sql_statements/monitoring_commands/stop_statement.rst +++ /dev/null @@ -1,77 +0,0 @@ -.. _stop_statement: - -******************** -STOP_STATEMENT -******************** - -``STOP_STATEMENT`` stops or aborts an active statement. - -To find a statement by ID, see :ref:`show_server_status` and :ref:`show_connections`. - -.. tip:: Some DBMSs call this process killing a session, terminating a job, or kill query - -Permissions -============= - -The role must have the ``SUPERUSER`` permissions. - -Syntax -========== - -.. code-block:: postgres - - stop_statement_statement ::= - SELECT STOP_STATEMENT(stmt_id) - ; - - stmt_id ::= bigint - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``stmt_id`` - - The statement ID to stop - -Returns -========= - -This utility does not return any value, and always succeeds even if the statement does not exist, or has already stopped. - - -Notes -=========== - -* This utility always succeeds even if the statement does not exist, or has already stopped. - -Examples -=========== - -Using :ref:`show_connections` to get statement IDs ----------------------------------------------------- - -.. tip:: Use :ref:`show_server_status` to find statments from across the entire cluster, or :ref:`show_connections` to show statements from the current worker the client is connected to. - -.. code-block:: psql - - t=> SELECT SHOW_CONNECTIONS(); - ip | conn_id | conn_start_time | stmt_id | stmt_start_time | stmt - -------------+---------+---------------------+---------+---------------------+-------------------------- - 192.168.1.91 | 103 | 2019-12-24 00:01:27 | 129 | 2019-12-24 00:38:18 | SELECT GET_DATE(), * F... - 192.168.1.91 | 23 | 2019-12-24 00:01:27 | -1 | 2019-12-24 00:01:27 | - 192.168.1.91 | 22 | 2019-12-24 00:01:27 | -1 | 2019-12-24 00:01:27 | - 192.168.1.91 | 26 | 2019-12-24 00:01:28 | -1 | 2019-12-24 00:01:28 | - - -The statement ID we're interested in is ``129``. We can now stop this statement: - -.. code-block:: psql - - t=> SELECT STOP_STATEMENT(129) - executed - From 2fdcb0647adb8d2a30bcd41521be1b18d80b218e Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 19 May 2022 16:09:58 +0300 Subject: [PATCH 063/882] Avro, Encryption, Update Published to private 2022.1 branch to share with Product team. --- _static/images/new.png | Bin 0 -> 1503 bytes _static/images/new_2022.1.png | Bin 0 -> 2056 bytes data_ingestion/avro.rst | 182 +++++++----------- feature_guides/data_encryption.rst | 6 +- .../sql_statements/dml_commands/update.rst | 9 +- 5 files changed, 83 insertions(+), 114 deletions(-) create mode 100644 _static/images/new.png create mode 100644 _static/images/new_2022.1.png diff --git a/_static/images/new.png b/_static/images/new.png new file mode 100644 index 0000000000000000000000000000000000000000..a0df8ff0fc2fc25204895ade1d958e69c4651696 GIT binary patch literal 1503 zcmV<51t9u~P)Px#1ZP1_K>z@;j|==^1poj532;bRa{vGqB>(^xB>_oNB=7(L1$0S7K~!i%<(fTc z6hRcnCqanuBgq-Run=P5MLdHZpDr-+_E{v2;-X6J6-zIktUlO}7esmjx*=FS~+ z|Gs(s+8vfkQR}}+vFJVv1+#0HIe5??W&HA6>m_SFEs0m+E;NPq_V^o%Y;0`~JPZ_Jt(*2t$iSyL`ExtFg6svF+-z zQ&Zjv0Wlw85QeJr{~xVdWhW-QD=IAX5gfF3tv)SLBO`Wt+UeOd+uN&qLye93kv%=S z>+cjY%=ox>NJQWxEV29%6f!%jdqcrHLSLWm`fG(~3Km_nFK_enX5T(DHRTU$qP^XW zjd{B$xS-b6194ESE$57m_+JcJDmHM>>! z=~EP2^>Y2XdGf^DhYx!r52%JH9{?-;!2@&YlGDwb=IvY8xO%nAcOk4Q+qZjzV40)5 z3L7?fBZQ|sdgP5feEeu`+%R_cZtc80B5c9B6Vx(Eiz7xKPK?I|&kAQ_EW|?$!$RWA zjZvoBtE#KZ*v*@DYaS7{aMh?SWtxu=^Fm_kp$C;acqhU}h_eZ5PTT__Eth4et{Y%%Iu{b}M>RE@Z{Pgd`*lV~y-{^b+1u;3 zR6u2%kPjccfx(0+Y0DOG0M3S7Be`tjM)yg!ZS%&xd)}ytI-l~1YRA$L7)pt81Uo+} z0EI9B878o~+Z~Ycf1q2kV-?gQD@xmLz^XKjpfy4OPw8?$S zj(>dIeS)o9y)iK0jfW4tQ4@tilRa|83=aC^{J47-(bVJ(GCgh9uXhGE1jXXdL)7&% zXPg20`poIm&cM>3TN8nUu(t>q88HVAI0M^-9Xp&MKj!XTvv;pE@Mr}OVySj?xWiJ( zueB2=^i+Ak^Mf57{nb6BQn;mroxRr3%f_5iC67~aer9gj0Z8sw)i$S=EV2Fl#=Y3D zRg@QeK(z~KU%trvBTT^ao z7;3N=fk3S}N!p~sK?~(k^pSv=>hHJR-R=dr`i_5Bt*tI_E?-XkN09|s`vX%AH1)Cb8WaEk002ovPDHLk FV1f&!$;JQx literal 0 HcmV?d00001 diff --git a/_static/images/new_2022.1.png b/_static/images/new_2022.1.png new file mode 100644 index 0000000000000000000000000000000000000000..fc043757cd3728088194fbb6951830f5bf7fcc0c GIT binary patch literal 2056 zcmV+j2>17iP)X1^@s6uYt=p00001b5ch_0Itp) z=>Px#1ZP1_K>z@;j|==^1poj532;bRa{vGqB>(^xB>_oNB=7(L2c1boK~#8N?OaVx z<1iF<3P%A6q`5#A9H2;L#{pPm!G;C1n*+>_F4%OzVh+HLNb~?*^a3MMi5>-#dCz{& zdHHeT)ak%5`6R1p+800D@852tx3{-kN!*{Q$;+k67B_Tb#E20FTcxhA)I|LN{g~1{ zr7B9aRFlJ*id3w!%}V7*bbG{z5rAg>n3xyB{ZIG;Ao)>NAn;BHhllFm?4E9TV0#Z8 z0?px>ia>$?X)IwZXEX<&bxd2dk`P5$9-#rxlk256pqE&1*1>NVeVo90Hqdd~cmKijy~*EW`8*g;Zo`7|tH(ws$zGn~SGM+1#H1+<5?GuH%=<$I^vv!h4Xz5&mAOOH}o;a-U z@>(4@=@Uc0eozN4`q2JE={o^ycm^`NrnkWm-sp}L!Dv^Zsg0gScp}q0H2EudqE9~t zVPR_)lbRhv)7r9C-IYGH|4{mlCTMXDvxMb1#1lcY&o$2>PxPuHt*J1g^A;1E%vFX; zsK7Gy$&W_t2is@6ZrLwKHTCF5Wr?|rUS7=wgQJfwdTn_z3c1s-7NPxz(zgLT?BwK@ zJX``EZl$tQ{Yf~E&Q(r&fKi!IBF|7x{RZ{>MJ{%Is}3;f3q>tyKZN(-x~s_~h8*ClAh7>n`gYh5akT)!*S7}3k;=c(v5<_diXQ1X>qkfR3tZm(0BwAsx-rc=y|({LPj^(8ECU-?&ydR5zb``R_l0AM zR@N`5M8aM60todgwF1&BKO%vzZR$#J_y$Z`*w`FHAbmmLP!7D>cT$jANaq{M^#G3p z7ue-FWMbT;*noWgovsE3=7>DzRCv$7h0y*#nty~x2wC<-y)iB4M~#-Y3Kn<((3BGK zQp4jF2%#`GHm`(h?DBPj3_NL;s^4J?I+R5d`R8!W1A$5ekonQ=)o%HbH;Rz1WYsy8;{^GFLP1#)wcc-_P_7T`f>b@|o=_FQ zq4Fz)PjVmH|33NO13-xal19eOO1+cy@3XUv6I4pX8(Zac0EcuoToa)j?{RS`Xmh8+ zYkaEYbRX~)z$2jyuU(oA^XD7#e-#BfHaU+^v90WhIw!LQ3(Ai=H)0E=?X`KvkRhEW zr;Xy$UI&MCR1UWlo)1b+c?&^(^V<*E6}<$I=g6I_S@>4SzKQ}NFqZ`*?&RV1#Y8so zDJhYtdG8Kb6j_P7bHx7$&JmibY@HAx9hSPOY+c*y;E)c#BL+Mi3O+i=L0bsJ_Fus+ z0!VY@-d7{Y0*XtAzLEm@KqEs9aY5tO@R<{Z`B;CYxx-jwzk7~ zO)bG^aqD;{v@A*U(oy?On!od5!Nxu-N84R|`S8)!>_Nj8TG2-~hjGZyYP8~XJG9#RSh*^l;s$UI(UoL+0rCYtsM?0bO1*DV zmB*A@FyMVY$0Ib=(+mO}&o_l~3>&V%i1!sr!B|_zfk&F~G{Qc>xt7M-9X@wKpR7n# zmH@wWOGEPCG{vF)htgv>t*0FL9CUrL=t655&+B<0r3buSBK~7xsm$-kLEzH2kEvpf z81d=BdSZ^OVYOA1xIz24C}7X4jTkYagoghias1oQ=#55boezEA AS + SELECT * FROM ; + +After creating a table you can ingest data from an Avro file into SQream using the following syntax: + +.. code-block:: postgres + + avro_fdw [OPTIONS(option=value[,...])] + +Example +----------- +The following is an example of creating a table: + +.. code-block:: postgres + + CREATE TABLE nba AS + SELECT * FROM ext_nba; + +The following is an example of loading data from an Avro file into SQream: + +.. code-block:: postgres + + WRAPPER avro_fdw + OPTIONS + ( + LOCATION = 's3://sqream-demo-data/nba.avro' + ); + +For more examples, see :ref:`additional_examples`. + +Avro Data Types +=========== Avro includes the following data types: .. contents:: @@ -48,12 +90,6 @@ The following table shows the supported **Primitive** data types: | ``string`` | | Supported | Supported | | +-------------+-----------+---------------+-----------+--------------+ - - - - - - Complex Data Types -------------- The following table shows the supported **Complex** data types: @@ -76,8 +112,6 @@ The following table shows the supported **Complex** data types: | ``fixed`` | | | | | +------------+-----------+---------------+-----------+-----------+ - - Logical Data Types -------------- The following table shows the supported **Logical** data types: @@ -107,72 +141,20 @@ The following table shows the supported **Logical** data types: +----------------------------+-----------+---------------+-----------+---------+ | ``duration`` | | | | | +----------------------------+-----------+---------------+-----------+---------+ + +.. note:: Number types include **tinyint**, **smallint**, **int**, **bigint**, **real** and **float**, and **numeric**. String types include **text**. Mapping Objects to Rows =============== -When mapping objects to rows, each Avro object or message must contain one ``record`` type object corresponding to a single row in SQream. The ``record`` fields are associated by name to their target table columns. - -Additional unmapped fields will be ignored. Note that using the JSONPath option overrides this. +When mapping objects to rows, each Avro object or message must contain one ``record`` type object corresponding to a single row in SQream. The ``record`` fields are associated by name to their target table columns. Additional unmapped fields will be ignored. Note that using the JSONPath option overrides this. -Ingesting Avro Files +Best Practices ==================== -This section describes how to ingest Avro files into SQream and covers the following: - +This section describes the best practices when ingesting Avro files into SQream: .. contents:: :local: :depth: 1 - - -Preparing Your Avro Source File ----------- -Prepare your Avro source files according to the following requirements: - -* RFC 4180 standard CSV files, but can also be modified to support non-standard CSVs (with multi-character delimiters, unquoted fields, etc). - - :: - -* Files are encoded with UTF-8 or ASCII. - - :: - -* Field delimiter is an ASCII character or characters. - - :: - -* Record delimiter, also known as a new line separator, is a Unix-style newline (``\n``), DOS-style newline (``\r\n``), or Mac style newline (``\r``). - - :: - -* If a field is quoted, any double quote that appears must be double-quoted (similar to the :ref:`string literals quoting rules`. For example, to encode ``What are "birds"?``, the field should appear as ``"What are ""birds""?"``. - - :: - -* Fields can be enclosed by double-quotes (optional), or mandatory quotes if they contain one of the following characters: - - * The record delimiter or field delimiter. - - :: - - * A double quote character. - - :: - - * A newline. - -SQream does not support other modes of escaping, such as ``1,"What are \"birds\"?"``. - -``NULL`` values can be marked in the following ways in Avro files: - - * An explicit null marker. For example, ``col1,\N,col3``. - - :: - - * An empty field delimited by the field delimiter. For example, ``col1,,col3``. - - .. note:: If a text field is quoted but contains no content (``""``) it is considered an empty text field and not ``NULL``. - -For more information about standard CSV files, see `RFC 4180 standard CSVs `_. Making Avro Files Accessible to Workers --------------------- @@ -190,16 +172,16 @@ For more information about restricted worker access, see :ref:`workload_manager` Basing Your Table Structure on Inserted Tables --------------------- -Before loading data, you must build the ``CREATE EXTERNAL TABLE`` to correspond with the file structure of the inserted table. +Before loading data, you must build the ``CREATE FOREIGN TABLE`` to correspond with the file structure of the inserted table. -The example in this section is based on the source ``nba.parquet`` table shown below: +The example in this section is based on the source ``nba.avro`` table shown below: -.. csv-table:: nba.parquet +.. csv-table:: nba.avro :file: nba-t10.csv :widths: auto :header-rows: 1 -The following example shows the correct file structure used to create the ``CREATE EXTERNAL TABLE`` statement based on the **nba.parquet** table: +The following example shows the correct file structure used to create the ``CREATE FOREIGN TABLE`` statement based on the **nba.avro** table: .. code-block:: postgres @@ -216,23 +198,23 @@ The following example shows the correct file structure used to create the ``CREA College TEXT(40), Salary FLOAT ) - WRAPPER parquet_fdw + WRAPPER avro_fdw OPTIONS ( - LOCATION = 's3://sqream-demo-data/nba.parquet' + LOCATION = 's3://sqream-demo-data/nba.avro' ); .. tip:: An exact match must exist between the SQream and Avro types. For unsupported column types, you can set the type to any type and exclude it from subsequent queries. -.. note:: The **nba.parquet** file is stored on S3 at ``s3://sqream-demo-data/nba.parquet``. +.. note:: The **nba.avro** file is stored on S3 at ``s3://sqream-demo-data/nba.avro``. Verifying Your Table Output --------------------- Because external tables do not automatically verify the file integrity or structure, you must manually verify that the table output is identical to the original inserted table. -The following is an example of the output based on the **nba.parquet** table: +The following is an example of the output based on the **nba.avro** table: .. code-block:: psql @@ -252,38 +234,18 @@ The following is an example of the output based on the **nba.parquet** table: .. note:: If your table output has errors, verify that the structure of the Avro files correctly corresponds to the external table structure that you created. -Loading Data into SQream ---------------------- +.. _additional_examples: -Syntax -~~~~~~~~~~~~~~~~~~~~~ -The following is the correct syntax for loading data into SQream: - -.. code-block:: postgres - - CREATE TABLE
AS - SELECT * FROM ; - -The following is an example of loading data into SQream: - -.. code-block:: postgres - - CREATE TABLE nba AS - SELECT * FROM ext_nba; - -For more information about the **CREATE TABLE AS** statement, see :ref:`create_table_as`. - -Examples -~~~~~~~~~~~~~~~~~~~~~ - -This section includes the following examples of loading data into SQream: +Additional Examples +=============== +This section includes the following additional examples of loading data into SQream: .. contents:: :local: :depth: 1 Omitting Unsupported Column Types -********************** +-------------- When loading data, you can omit columns using the ``NULL as`` argument. You can use this argument to omit unsupported columns from queries that access external tables. By omitting them, these columns will not be called and will avoid generating a "type mismatch" error. In the example below, the ``Position`` column is not supported due its type. @@ -291,11 +253,10 @@ In the example below, the ``Position`` column is not supported due its type. .. code-block:: postgres CREATE TABLE nba AS - SELECT Name, Team, Number, NULL as Position, Age, Height, Weight, College, Salary FROM ext_nba; - + SELECT Name, Team, Number, NULL as Position, Age, Height, Weight, College, Salary FROM ext_nba; Modifying Data Before Loading -********************** +-------------- One of the main reasons for staging data using the ``EXTERNAL TABLE`` argument is to examine and modify table contents before loading it into SQream. For example, we can replace pounds with kilograms using the :ref:`create_table_as` statement @@ -309,19 +270,18 @@ In the example below, the ``Position`` column is set to the default ``NULL``. FROM ext_nba ORDER BY weight; - Loading a Table from a Directory of Avro Files on HDFS -********************** +-------------- The following is an example of loading a table from a directory of Avro files on HDFS: .. code-block:: postgres CREATE FOREIGN TABLE ext_users (id INT NOT NULL, name TEXT(30) NOT NULL, email TEXT(50) NOT NULL) - WRAPPER parquet_fdw + WRAPPER avro_fdw OPTIONS ( - LOCATION = 'hdfs://hadoop-nn.piedpiper.com/rhendricks/users/*.parquet' + LOCATION = 'hdfs://hadoop-nn.piedpiper.com/rhendricks/users/*.avro' ); CREATE TABLE users AS SELECT * FROM ext_users; @@ -329,16 +289,16 @@ The following is an example of loading a table from a directory of Avro files on For more configuration option examples, see the `CREATE FOREIGN TABLE parameters `_. Loading a Table from a Directory of Avro Files on S3 -********************** +-------------- The following is an example of loading a table from a directory of Avro files on S3: .. code-block:: postgres CREATE FOREIGN TABLE ext_users (id INT NOT NULL, name TEXT(30) NOT NULL, email TEXT(50) NOT NULL) - WRAPPER parquet_fdw + WRAPPER avro_fdw OPTIONS - ( LOCATION = 's3://pp-secret-bucket/users/*.parquet', + ( LOCATION = 's3://pp-secret-bucket/users/*.avro', AWS_ID = 'our_aws_id', AWS_SECRET = 'our_aws_secret' ); diff --git a/feature_guides/data_encryption.rst b/feature_guides/data_encryption.rst index 4e51a28aa..e5b30c94a 100644 --- a/feature_guides/data_encryption.rst +++ b/feature_guides/data_encryption.rst @@ -4,8 +4,12 @@ Data Encryption *********************** -The **Data Encryption** page describes the following: +The **Data Encryption** page |icon-new_2022.1| describes the following: +.. |icon-new_2022.1| image:: /_static/images/new_2022.1.png + :align: middle + :width: 110 + .. toctree:: :maxdepth: 1 :titlesonly: diff --git a/reference/sql/sql_statements/dml_commands/update.rst b/reference/sql/sql_statements/dml_commands/update.rst index 143363b3b..82262d884 100644 --- a/reference/sql/sql_statements/dml_commands/update.rst +++ b/reference/sql/sql_statements/dml_commands/update.rst @@ -3,8 +3,11 @@ ********************** UPDATE ********************** +The **UPDATE** statement page |icon-new_2022.1| describes the following: -The **UPDATE** statement page describes the following: +.. |icon-new_2022.1| image:: /_static/images/new_2022.1.png + :align: middle + :width: 110 .. contents:: :local: @@ -12,7 +15,7 @@ The **UPDATE** statement page describes the following: Overview ========== -The ``UPDATE`` command is used to modify the value of certain columns in existing rows without creating a table. +The ``UPDATE`` statement is used to modify the value of certain columns in existing rows without creating a table. It can be used to do the following: @@ -20,6 +23,8 @@ It can be used to do the following: * Setting columns based on the values of others. +The ``UPDATE`` statement cannot be used to reference other tables in the ``WHERE`` or ``SET`` clauses. + Syntax ========== The following is the correct syntax for the ``UPDATE`` command: From f9cd06dfe305ce662960b59f3858208641f8e19c Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 19 May 2022 16:12:34 +0300 Subject: [PATCH 064/882] Encryption, Update, Avro Published the 2022.1 features and updated the respective pages on the private 2022.1 branch to show Product team. --- releases/2022.1.rst | 42 ++++++++---------------------------------- 1 file changed, 8 insertions(+), 34 deletions(-) diff --git a/releases/2022.1.rst b/releases/2022.1.rst index 51a7333cc..b1b6a61ae 100644 --- a/releases/2022.1.rst +++ b/releases/2022.1.rst @@ -13,10 +13,9 @@ Version Content ---------- The 2022.1 Release Notes describes the following: -* Example - Major feature release targeted for all on-premises customers. -* Example - Basic Cloud functionality. - -**Comment** - *This will be done at the end.* +* Enhanced security features. +* New data manipulation command. +* Additional data ingestion format. New Features ---------- @@ -32,6 +31,8 @@ SQream now supports data encryption mechanisms in accordance with **General Data For more information, see `Data Encryption `_. +**Comment** - *Information regarding performance degradation, pending.* + Update Feature ************ SQream now supports the DML **Update** feature, which is used for modifying the value of certain columns in existing rows without creating a table. @@ -44,18 +45,9 @@ SQream now supports ingesting data from Avro files. For more information, see `Inserting Data from Avro `_. -Main Features --------- -The following list describes the main features: - -* Main feature -* Main feature - -**Comment** - *This will be done at the end.* - Resolved Issues --------- -The following table lists the issues that were resolved in Version 2021.2: +The following table lists the issues that were resolved in Version 2022.1: .. list-table:: :widths: 17 200 @@ -70,36 +62,18 @@ The following table lists the issues that were resolved in Version 2021.2: * - SQ-xxxx - Text -**Comment** - *I will be updated regarding which resolved issues to include.* +**Comment** - *The table above will be updated regarding which resolved issues to include.* Operations and Configuration Changes -------- -**Comment** - *TBD* - - -Subject -************ -Text - - - - -Subject -************ -Text - - +No relevant operations and configuration changes were made. Naming Changes ------- -**Comment** - *TBD* - No relevant naming changes were made. Deprecated Features ------- -**Comment** - *TBD* - No features were depecrated. Known Issues and Limitations From 0bb07df6dc07046aeb3d5f5ca8dd8bc2e73b3366 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 19 May 2022 16:21:29 +0300 Subject: [PATCH 065/882] Added date Needs to be updated on release date --- feature_guides/data_encryption.rst | 1 - releases/index.rst | 2 +- 2 files changed, 1 insertion(+), 2 deletions(-) diff --git a/feature_guides/data_encryption.rst b/feature_guides/data_encryption.rst index e5b30c94a..82e1bf657 100644 --- a/feature_guides/data_encryption.rst +++ b/feature_guides/data_encryption.rst @@ -3,7 +3,6 @@ *********************** Data Encryption *********************** - The **Data Encryption** page |icon-new_2022.1| describes the following: .. |icon-new_2022.1| image:: /_static/images/new_2022.1.png diff --git a/releases/index.rst b/releases/index.rst index d06a7a8bf..e23036f7a 100644 --- a/releases/index.rst +++ b/releases/index.rst @@ -13,7 +13,7 @@ Release Notes * - Version - Release Date * - :ref:`2022.1` - - April 17, 2022 + - MM DD, YYYY * - :ref:`2021.2` - September 13, 2021 * - :ref:`2021.1` From b65615c5287cef86975ff8d2f2c605f099777f42 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 22 May 2022 14:25:50 +0300 Subject: [PATCH 066/882] Replaced missed instances of VARCHAR with TEXT --- data_type_guides/converting_and_casting_types.rst | 2 +- .../utility_commands/execute_saved_query.rst | 14 +++++++------- .../utility_commands/show_node_info.rst | 2 +- ...tements_and_running_queries_from_the_editor.rst | 2 +- 4 files changed, 10 insertions(+), 10 deletions(-) diff --git a/data_type_guides/converting_and_casting_types.rst b/data_type_guides/converting_and_casting_types.rst index bb6475646..44579a068 100644 --- a/data_type_guides/converting_and_casting_types.rst +++ b/data_type_guides/converting_and_casting_types.rst @@ -15,7 +15,7 @@ You can rectify this by casting the value to a larger data type, as shown below: SQream supports the following three data conversion types: -* ``CAST( TO )``, to convert a value from one type to another. For example, ``CAST('1997-01-01' TO DATE)``, ``CAST(3.45 TO SMALLINT)``, ``CAST(some_column TO VARCHAR(30))``. +* ``CAST( TO )``, to convert a value from one type to another. For example, ``CAST('1997-01-01' TO DATE)``, ``CAST(3.45 TO SMALLINT)``, ``CAST(some_column TO TEXT(30))``. :: diff --git a/reference/sql/sql_statements/utility_commands/execute_saved_query.rst b/reference/sql/sql_statements/utility_commands/execute_saved_query.rst index 6fe41fa08..39675d47f 100644 --- a/reference/sql/sql_statements/utility_commands/execute_saved_query.rst +++ b/reference/sql/sql_statements/utility_commands/execute_saved_query.rst @@ -8,7 +8,7 @@ EXECUTE_SAVED_QUERY Read more in the :ref:`saved_queries` guide. -See also: ref:`save_query`, :ref:`drop_saved_query`, ref:`show_saved_query`, ref:`list_saved_queries`. +See also: :ref:`save_query`, :ref:`drop_saved_query`, :ref:`show_saved_query`, :ref:`list_saved_queries`. Permissions ============= @@ -53,7 +53,7 @@ Notes * Query parameters can be used as substitutes for literal expressions. Parameters cannot be used to substitute identifiers, column names, table names, or other parts of the query. -* Query parameters of a string datatype (like ``VARCHAR``) must be of a fixed length, and can be used in equality checks, but not patterns (e.g. :ref:`like`, :ref:`rlike`, etc) +* Query parameters of a string datatype (like ``text``) must be of a fixed length, and can be used in equality checks, but not patterns (e.g. :ref:`like`, :ref:`rlike`, etc) * Query parameters' types are inferred at compile time. @@ -66,14 +66,14 @@ Assume a table named ``nba``, with the following structure: CREATE TABLE nba ( - Name varchar(40), - Team varchar(40), + Name text(40), + Team text(40), Number tinyint, - Position varchar(2), + Position text(2), Age tinyint, - Height varchar(4), + Height text(4), Weight real, - College varchar(40), + College text(40), Salary float ); diff --git a/reference/sql/sql_statements/utility_commands/show_node_info.rst b/reference/sql/sql_statements/utility_commands/show_node_info.rst index 345d16440..9c1e1ec11 100644 --- a/reference/sql/sql_statements/utility_commands/show_node_info.rst +++ b/reference/sql/sql_statements/utility_commands/show_node_info.rst @@ -108,7 +108,7 @@ This is a full list of node types: - Compress data with both CPU and GPU schemes * - ``CpuDecompress`` - CPU - - Decompression operation, common for longer ``VARCHAR`` types + - Decompression operation, common for longer ``TEXT`` types * - ``CpuLoopJoin`` - CPU - A non-indexed nested loop join, performed on the CPU diff --git a/sqream_studio_5.4.3/executing_statements_and_running_queries_from_the_editor.rst b/sqream_studio_5.4.3/executing_statements_and_running_queries_from_the_editor.rst index 8fa91d945..e1b6765eb 100644 --- a/sqream_studio_5.4.3/executing_statements_and_running_queries_from_the_editor.rst +++ b/sqream_studio_5.4.3/executing_statements_and_running_queries_from_the_editor.rst @@ -223,7 +223,7 @@ The following table describes the DDL Optimizer screen: * - Column area - Shows the column **names** and **column types** from the selected table. You can scroll down or to the right/left for long column lists. * - Optimization area - - Shows the number of rows to sample as the basis for running an optimization, the default setting (1,000,000) when running an optimization (this is also the overhead threshold used when analyzing ``VARCHAR`` fields), and the default percent buffer to add to ``VARCHAR`` lengths (10%). Attempts to determine field nullability. + - Shows the number of rows to sample as the basis for running an optimization, the default setting (1,000,000) when running an optimization (this is also the overhead threshold used when analyzing ``TEXT`` fields), and the default percent buffer to add to ``TEXT`` lengths (10%). Attempts to determine field nullability. * - Run Optimizer - Starts the optimization process. From 89e6037be32c759df3487a23fe2af2fc09490b9e Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 22 May 2022 16:06:18 +0300 Subject: [PATCH 067/882] Fixed broken links. --- configuration_guides/current_configuration_method.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/configuration_guides/current_configuration_method.rst b/configuration_guides/current_configuration_method.rst index e7ca5c0d3..078e2dac2 100644 --- a/configuration_guides/current_configuration_method.rst +++ b/configuration_guides/current_configuration_method.rst @@ -704,8 +704,8 @@ Configuration Roles =========== SQream divides flags into the following roles, each with their own set of permissions: -* **`Administration flags `_**: can be modified by administrators on a session and cluster basis using the ``ALTER SYSTEM SET`` command. -* **`Generic flags `_**: can be modified by standard users on a session basis. +* `Administration flags `_: can be modified by administrators on a session and cluster basis using the ``ALTER SYSTEM SET`` command. +* `Generic flags `_: can be modified by standard users on a session basis. Showing All Flags in the Catalog Table ======= From 842860c092fce79c3df27f875cddee91b45a8f80 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 22 May 2022 17:02:43 +0300 Subject: [PATCH 068/882] Update 2022.1.rst --- releases/2022.1.rst | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/releases/2022.1.rst b/releases/2022.1.rst index b1b6a61ae..9a2de884e 100644 --- a/releases/2022.1.rst +++ b/releases/2022.1.rst @@ -35,7 +35,7 @@ For more information, see `Data Encryption `_. @@ -87,8 +87,7 @@ The the list below describes the following known issues and limitations: End of Support ------- -**Comment** - *TBD* - +This section is not relevant to the 2022.1 release notes. Upgrading to v2022.1 ------- From 1fa25d21a222683e65d8d352c691290fbd57cfa4 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 22 May 2022 17:12:48 +0300 Subject: [PATCH 069/882] Updated .Net Driver Link --- third_party_tools/client_drivers/index.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/third_party_tools/client_drivers/index.rst b/third_party_tools/client_drivers/index.rst index d52b41e95..91cb94e8f 100644 --- a/third_party_tools/client_drivers/index.rst +++ b/third_party_tools/client_drivers/index.rst @@ -44,8 +44,7 @@ The following are applicable to Windows: For more information on installing and configuring ODBC on Windows, see :ref:`Install and configure ODBC on Windows `. - -* **Net driver** - `SQream .Net driver v3.0.2 `_ +* **Net driver** - `SQream .Net driver v3.0.2 `_ From 2a4ae2eef990dfd1e7b3c6dfa88ff2b25e5d97d3 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 24 May 2022 10:34:50 +0300 Subject: [PATCH 070/882] Updated --- .../sql_statements/dml_commands/update.rst | 104 +----------------- 1 file changed, 4 insertions(+), 100 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/update.rst b/reference/sql/sql_statements/dml_commands/update.rst index 82262d884..19881d62c 100644 --- a/reference/sql/sql_statements/dml_commands/update.rst +++ b/reference/sql/sql_statements/dml_commands/update.rst @@ -3,7 +3,7 @@ ********************** UPDATE ********************** -The **UPDATE** statement page |icon-new_2022.1| describes the following: +The **UPDATE** statement page |icon-new_2022.1| describes the following: .. |icon-new_2022.1| image:: /_static/images/new_2022.1.png :align: middle @@ -15,7 +15,7 @@ The **UPDATE** statement page |icon-new_2022.1| describes the following: Overview ========== -The ``UPDATE`` statement is used to modify the value of certain columns in existing rows without creating a table. +The ``UPDATE`` command is used to modify the value of certain columns in existing rows without creating a table. It can be used to do the following: @@ -23,8 +23,6 @@ It can be used to do the following: * Setting columns based on the values of others. -The ``UPDATE`` statement cannot be used to reference other tables in the ``WHERE`` or ``SET`` clauses. - Syntax ========== The following is the correct syntax for the ``UPDATE`` command: @@ -33,7 +31,6 @@ The following is the correct syntax for the ``UPDATE`` command: UPDATE target_table_name [[AS] alias1] SET column_name = expression [,...] - [FROM additional_table_name [[AS] alias2][,...]] [WHERE condition] The following is the correct syntax for triggering a clean-up: @@ -74,30 +71,6 @@ The **Examples** section includes the following examples: :local: :depth: 1 -Updating an Entire Table ------------------ -The Examples section shows how to modify the value of certain columns in existing rows without creating a table. The examples are based on the following tables: - -.. image:: /_static/images/delete_optimization.png - -The following methods for updating an entire table generate the same output, and result with the ``bands`` record set to ``NULL``: - -.. code-block:: postgres - - UPDATE bands SET records_sold = 0; - -.. code-block:: postgres - - UPDATE bands SET records_sold = 0 WHERE true; - -.. code-block:: postgres - - UPDATE bands SET records_sold = 0 USING countries; - -.. code-block:: postgres - - UPDATE bands SET records_sold = 0 USING countries WHERE 1=1; - Performing Simple Updates ----------------- The following is an example of performing a simple update: @@ -106,72 +79,6 @@ The following is an example of performing a simple update: UPDATE bands SET records_sold = records_sold + 1 WHERE name LIKE 'The %'; -Updating Tables that Contain Multi-Table Conditions ------------------ -The following shows an example of updating tables that contain multi-table conditions: - -.. code-block:: postgres - - UPDATE bands - SET records_sold = records_sold + 1 - WHERE EXISTS ( - SELECT 1 FROM countries - WHERE countries.id=bands.country_id - AND country.name = 'Sweden' - ); - -You can also write the statement above using the FROM clause: - -.. code-block:: psql - - UPDATE bands - SET records_sold = records_sold + 1 - FROM countries - WHERE countries.id=bands.country_id AND country.name = 'Sweden'; - -Updating Tables that Contain Multi-Table Expressions ------------------ -The following shows an example of updating tables that contain multi-table expressions: - -.. code-block:: postgres - - UPDATE bands - SET records_sold = records_sold + - CASE - WHEN c.name = 'Israel' THEN 2 - ELSE 1 - END - FROM countries c - -Configuring Update Behavior ------------------ -The ``failOnNondeterministicUpdate`` flag is used to configure ``UPDATE`` behavior when updating tables containing multi-table expressions. This flag is needed when you use the ``FROM`` clause along with a set expression containing columns from additional tables. Doing this can cause a match to occur between a row from the target table with multiple rows from the additional tables. - -**Note to self** - *Check if the Studio documentation must be updated for this flag.* - -For instance, the example in the previous section sets the records sold to ``2`` when the country name is Israel. If you were to insert a new entry into this table with Israel spelled in Hebrew (using the same country ID), you would have two rows with identical country ID's. - -When this happens, both rows 5 and 6 in the ``bands`` table match both Israel entries. Because no algorithm exists for determining which entry to use, updating this table may either increase ``records_sold`` by 2 (for Israel in English) or 1 (for Israel in Hebrew). - -You must set the ``failOnNondeterministicUpdate`` flag to ``FALSE`` to prevent an error from occuring. - -**Comment** - *Does the system actually choose one, or does it generate an error?* - -Note that a similar ambiguity can occur when the Hebrew spelling is used in the following example: - -.. code-block:: postgres - - UPDATE bands - SET record_count = record_count + 1 - FROM countries c - WHERE c.name = 'Israel' - -However, the ``WHERE`` clause above prevents a match with any entry other than the defined one. Because the target table row must match with the ``WHERE`` condition at least once to be included in the UPDATE statment, this scenario does not require configuring the ``failOnNondeterministicUpdate`` flag. - -**Comment** - *Please review the paragraph above. I'm pretty sure I described this correctly.* - -For more information, see `SQream Acceleration Studio `_. - Identifying and Cleaning Up Tables --------------------------------------- **Comment** - *I copied and pasted this entire section from "DELETE". Does anything have to adjusted here for "UPDATE"?* @@ -240,11 +147,8 @@ The following shows an example of triggering a clean-up: Permissions ============= -Executing an ``UPDATE`` statement requires the following permissions: - -* Both ``UPDATE`` and ``SELECT`` permissions on the target table. -* The ``SELECT`` permission for each additional table you reference in the statement (in ither the ``FROM`` clause or ``WHERE`` subquery section). +Executing an ``UPDATE`` statement requires both ``UPDATE`` and ``SELECT`` permissions on the target table. Locking and Concurrency ============= -Executing the ``UPDATE`` statement obtains an exclusive UPDATE lock on the target table, but does not lock the destination tables. \ No newline at end of file +Executing the ``UPDATE`` statement obtains an exclusive UPDATE lock on the target table. \ No newline at end of file From 0be3b83caec8bdc6ac8f569104f3fafdfd1a4257 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 24 May 2022 12:18:54 +0300 Subject: [PATCH 071/882] Updated Encryption Pages based on Inon/Maya Meeting --- feature_guides/data_encryption.rst | 2 - feature_guides/data_encryption_methods.rst | 14 +-- feature_guides/data_encryption_overview.rst | 8 +- .../data_encryption_permissions.rst | 16 ---- feature_guides/data_encryption_process.rst | 88 ------------------- feature_guides/data_encryption_syntax.rst | 56 +++--------- feature_guides/data_encryption_types.rst | 6 +- 7 files changed, 26 insertions(+), 164 deletions(-) delete mode 100644 feature_guides/data_encryption_permissions.rst delete mode 100644 feature_guides/data_encryption_process.rst diff --git a/feature_guides/data_encryption.rst b/feature_guides/data_encryption.rst index 82e1bf657..dbc6152ed 100644 --- a/feature_guides/data_encryption.rst +++ b/feature_guides/data_encryption.rst @@ -16,6 +16,4 @@ The **Data Encryption** page |icon-new_2022.1| describes the following: data_encryption_overview data_encryption_methods data_encryption_types - data_encryption_process - data_encryption_permissions data_encryption_syntax \ No newline at end of file diff --git a/feature_guides/data_encryption_methods.rst b/feature_guides/data_encryption_methods.rst index 0069b161c..dc6e7c122 100644 --- a/feature_guides/data_encryption_methods.rst +++ b/feature_guides/data_encryption_methods.rst @@ -3,7 +3,7 @@ *********************** Encryption Methods *********************** -The **Encryption Methods** section describes the following: +Data exists in one of following states and determines the encryption method: .. contents:: :local: @@ -11,16 +11,10 @@ The **Encryption Methods** section describes the following: Encrypting Data in Transit ---------------- -**In-transit data** refers to data files inserted from customer repositories using the COPY FROM command, and is transmitted to SQream over a TLS-encrypted channel using a JDBC or ODBC connection. +**Data in transit** refers to data you use on a regular basis, usually stored on a database and accessed through applications or programs. This data is typically transferred between several physical or remote locations through email or uploading documents to the cloud. This type of data must therefore be protected while **in transit**. SQream encrypts data in transit using SSL when, for example, users insert data files from external repositories over a JDBC or ODBC connection. -For more information, see the following: - -* :ref:`copy_from` -* `JDBC `_ -* :ref:`odbc` +For more information, see :ref:`installing_nginx_proxy_over_secure_connection`. Encrypting Data at Rest ---------------- -For **data at rest,** housed physically on computer data, you can encrypt one or more column as needed according to your specifications. Data at rest is encrypted before being written into files, and decrypted after being read from them. All existing unencrypted historical and data inserted into this column at a later time is encrypted for the specified column values. Data at rest is encrypted (**Comment** - *And decrypted?*) using the **AES-256** algorithm. - -**Comment** - *Because the encryption keys are hidden from users, I didn't document them here. Please confirm that this is correct.* \ No newline at end of file +**Data at rest** refers to data stored on your hard drive or on the cloud. Because this data can be potentially intercepted **physically**, it requires a form of encryption that protects your data wherever you store it. SQream faciliates encryption by letting you encrypt any columns located in your database that you want to keep private. \ No newline at end of file diff --git a/feature_guides/data_encryption_overview.rst b/feature_guides/data_encryption_overview.rst index 4c0455291..58bb7ea40 100644 --- a/feature_guides/data_encryption_overview.rst +++ b/feature_guides/data_encryption_overview.rst @@ -3,7 +3,11 @@ *********************** Overview *********************** -**Data Encryption** helps protect sensitive data by preventing unauthorized users from reading it in the event of a breach. This is achieved by scrambling the content into an unreadable format based on encryption and decryption keys. The demand for confidentiality has steadily increased to protect the growing volumes of private data stored on computer systems and transmitted over the internet. To this end, regulatory bodies such as the **General Data Protection Regulation (GDPR)** have produced requirements to standardize and enforce compliance aimed at protecting customer data. +**Data Encryption** helps protect sensitive data at rest by concealing it from unauthorized users in the event of a breach. This is achieved by scrambling the content into an unreadable format based on encryption and decryption keys. Typically speaking, this data pertains to **PII (Personally Identifiable Information)**, which is sensitive information such as credit card numbers and other information related to an identifiable person. + +Users encrypt their data on a column basis by specifying ``column_name`` in the encryption syntax. + +The demand for confidentiality has steadily increased to protect the growing volumes of private data stored on computer systems and transmitted over the internet. To this end, regulatory bodies such as the **General Data Protection Regulation (GDPR)** have produced requirements to standardize and enforce compliance aimed at protecting customer data. Encryption can be used for the following: @@ -25,4 +29,6 @@ Encryption can be used for the following: * Selecting data from an encrypted column. +For more information on the encryption syntax, see :ref:`data_encryption_syntax`. + For more information on GDPR compliance requirements, see the `GDPR checklist `_. \ No newline at end of file diff --git a/feature_guides/data_encryption_permissions.rst b/feature_guides/data_encryption_permissions.rst deleted file mode 100644 index d9a132b45..000000000 --- a/feature_guides/data_encryption_permissions.rst +++ /dev/null @@ -1,16 +0,0 @@ -.. _data_encryption_permissions: - -*********************** -Permissions -*********************** -The **Permissions** page tells you how to create a table with encrypted columns as a superuser. - -Users with the appropriate encryption permission privilege's can encrypt and decrypt data. In addition, only superusers granted permission can view encrypted tables in the **sqream_catalog**. - -You can create a table with encrypted columns as a superuser as follows: - -.. code-block:: console - - $ create or replace table t_enc(c1 int encrypt); - -For more information about the SQream catalog, see the :ref:`catalog_reference`. \ No newline at end of file diff --git a/feature_guides/data_encryption_process.rst b/feature_guides/data_encryption_process.rst deleted file mode 100644 index e76e6a9cc..000000000 --- a/feature_guides/data_encryption_process.rst +++ /dev/null @@ -1,88 +0,0 @@ -.. _data_encryption_process: - -*********************** -Data Encryption Process -*********************** -The **Data Encryption Process** page describes end-to-end encryption process, and describes the following: - -.. contents:: - :local: - :depth: 1 - -The Encryption Process ----------------- -The following describes the encryption process: - -1. A user with the required encryption execution permission accesses the system. - - :: - -#. In the file to be uploaded, the user selects columns to encrypt. The syntax will (**Comment** - *"should" instead of "will"?)* includes the hint that triggers the encryption (see syntax section). - - :: - -#. The user provides the location of the master key for deriving (**Comment** - *...generating/activating?*) the encryption in the remote repository. This applies to both **KMS** and **IBM SKLM**. - - :: - - **Comment** - *The source doc says, "this section will not be applied in the MVP scope." Should it stay in this doc?* - - :: - -#. The user trigger (**Comment** - *"runs"?*) the COPY command to transport the data upon TLS session (not yet data at rest encryption) (**Comment** - *"Upon TLS session = when the TLS session is activated?"* - - :: - -#. When the data is successfully inserted into the SQream database, it is encrypted and saved. - -For more information, see the following: - -* More information on permissions, see :ref:`data_encryption_permissions`. - - :: - -* More information on which columns to encrypt, see the :ref:`Constraints` section below. - - :: - -* More information on triggering the encryption, and the master key location syntax, see :ref:`data_encryption_syntax`. - -The Decryption Process ----------------- -The following describes the encryption process: - -1. A user with the required encryption execution permission accesses the system. - - :: - -#. The user indicates the decryption. **Comment** - *"Indicates" = "triggers"?*) - - :: - -#. The user can view the data derived from a table holding the encrypted data by decrypting the data by providing the location of the master key and selecting the required fields. - - :: - - **Comment** - *the source doc said, "this section will not be applied in the MVP scope." Should it stay in this doc?* - -#. When the statement has ended, the user can view the data in a human readable format as plain text. - -For more information on triggering the decryption, see :ref:`data_encryption_syntax`. - -Encrypted Columns ----------------- -**Comment** - *This section and "Constraints" don't really seem like phases in a flow, at least the way they are currently described. If they really are part of a flow, we should discuss how to reword them.* - -Tables with encrypted columns are tagged with the ``encrypted`` label, allowing you to select what data to encrypt. - -.. _constraints: - -Constraints ----------------- -The encryption will be done in the database server- data at rest as the data will be encrypted in transit based on the TLS protocol. - -**Comment** - *I need some clarification on the sentence above.* - -Users without permissions to view tables with one or more encrypted table cannot view the entire table. - -**Comment** - *Please confirm that the above sentence is correct. Below is the original sentence:"* \ No newline at end of file diff --git a/feature_guides/data_encryption_syntax.rst b/feature_guides/data_encryption_syntax.rst index 85cef25ee..a7cb3e68d 100644 --- a/feature_guides/data_encryption_syntax.rst +++ b/feature_guides/data_encryption_syntax.rst @@ -3,55 +3,23 @@ *********************** Syntax *********************** -The **Syntax** page describes the following: - -.. contents:: - :local: - :depth: 1 - -Encrypting a New Table ----------------- -The following is the correct syntax for **encrypting** a new table: +The following is the syntax for encrypting a new table: .. code-block:: console - CREATE TABLE client_name ( - first_name TEXT(128), - last_name TEXT(128), - salary INT(6) ENCRYPT); + CREATE TABLE ( + <(maximum string length)>, + + last_name <(maximum string length)>, + salary (<(maximum string length)>) ENCRYPT); The following is an example of encrypting a new table: .. code-block:: console - EXAMPLE - -**Comment** - *Please provide an actual example.* - -Decrypting a New Table ----------------- -The following is the correct syntax for **decrypting** a new table: - -.. code-block:: console - - SELECT * FROM TABLE; - -The following is an example of decrypting a new table: - -.. code-block:: console - - EXAMPLE - -**Comment** - *Please provide an actual example.* - -Incorrectly Encrypting or Decrypting Your Data ----------------- -Using the incorrect master key or location while encrypting or decrypting generates an error. - -**Comment** - *Can I get an example of this error to include in the doc?* - -**Comment** - *I thought that the master key was completely hidden from users... The internal doc says, "Master Key- the key will be generated within the server side, it will reside within a repository which will be hidden from the user."* - -In logs, master keys are masked to protect user privacy. Users are responsible for maintaining their master keys for the remote repository. - -**Comment** - *I'm not sure I fully understand the part about maintaing the master keys on the remote repository.* \ No newline at end of file + CREATE TABLE client_name ( + first_name TEXT(128), + last_name TEXT(128), + salary INT(6) ENCRYPT); + +.. note:: Users without permissions cannot view the entire table as long as at least one column is encrypted. The (unique) encryption/decryption key is relevant only at the system level and is not held by users. \ No newline at end of file diff --git a/feature_guides/data_encryption_types.rst b/feature_guides/data_encryption_types.rst index 3da9071c2..ad6d96dc3 100644 --- a/feature_guides/data_encryption_types.rst +++ b/feature_guides/data_encryption_types.rst @@ -3,12 +3,12 @@ *********************** Data Types *********************** -SQream's data encryption supports the following data types: +Typically speaking, sensitive pertains to **PII (Personally Identifiable Information)**, which is sensitive information such as credit card numbers and other information related to an identifiable person. + +SQream's data encryption feature supports encrypting column-based data belonging to the following data types: * INT * BIGINT * TEXT -Typically speaking, this data pertains to **PII (Personally Identifiable Information)**, which is sensitive information such as credit card numbers and other information related to an identifiable person. - For more information on the above data types, see :ref:`supported_data_types`. \ No newline at end of file From f312568993019bb8eaecdf772fccbfb5dff60566 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 24 May 2022 18:43:11 +0300 Subject: [PATCH 072/882] Updated Updated according to comments by: Avro: Ben Esh, Maya Faibish Update: Maayan Kurz Data Encryption: Inon Maman, Alex Karpov --- data_ingestion/avro.rst | 238 +++++++++++------- feature_guides/data_encryption_methods.rst | 2 +- feature_guides/flexible_data_clustering.rst | 16 -- .../flexible_data_clustering_chunks.rst | 18 -- ...ata_clustering_data_clustering_methods.rst | 180 ------------- ...flexible_data_clustering_data_examples.rst | 22 -- ...e_data_clustering_data_rechunking_data.rst | 11 - .../flexible_data_clustering_overview.rst | 16 -- feature_guides/index.rst | 1 - .../sql_statements/dml_commands/update.rst | 73 +----- releases/2022.1.rst | 38 ++- 11 files changed, 199 insertions(+), 416 deletions(-) delete mode 100644 feature_guides/flexible_data_clustering.rst delete mode 100644 feature_guides/flexible_data_clustering_chunks.rst delete mode 100644 feature_guides/flexible_data_clustering_data_clustering_methods.rst delete mode 100644 feature_guides/flexible_data_clustering_data_examples.rst delete mode 100644 feature_guides/flexible_data_clustering_data_rechunking_data.rst delete mode 100644 feature_guides/flexible_data_clustering_overview.rst diff --git a/data_ingestion/avro.rst b/data_ingestion/avro.rst index 776d44bba..e943fe41c 100644 --- a/data_ingestion/avro.rst +++ b/data_ingestion/avro.rst @@ -17,48 +17,113 @@ Overview =========== **Avro** is a well-known data serialization system that relies on schemas. Due to its flexibility as an efficient data storage method, SQream supports the Avro binary data format as an alternative to JSON. Avro files are represented using the **Object Container File** format, in which the Avro schema is encoded alongside binary data. Multiple files loaded in the same transaction are serialized using the same schema. If they are not serialized using the same schema, an error message is displayed. SQream uses the **.avro** extension for ingested Avro files. -Loading Data into SQream -=========== +Making Avro Files Accessible to Workers +================ +To give workers access to files every node must have the same view of the storage being used. -Syntax ------------ -Before ingesting data into SQream from an Avro file, you must create a table using the following syntax: +The following apply for Avro files to be accessible to workers: -.. code-block:: postgres - - CREATE TABLE
AS - SELECT * FROM ; - -After creating a table you can ingest data from an Avro file into SQream using the following syntax: +* For files hosted on NFS, ensure that the mount is accessible from all servers. -.. code-block:: postgres +* For HDFS, ensure that SQream servers have access to the HDFS name node with the correct **user-id**. For more information, see :ref:`hdfs`. + +* For S3, ensure network access to the S3 endpoint. For more information, see :ref:`s3`. + +For more information about restricted worker access, see :ref:`workload_manager`. + +Preparing Your Table +=============== +You can build your table structure on both local and foreign tables: - avro_fdw [OPTIONS(option=value[,...])] +.. contents:: + :local: + :depth: 1 -Example ------------ -The following is an example of creating a table: +Creating a Table +--------------------- +Before loading data, you must build the ``CREATE TABLE`` to correspond with the file structure of the inserted table. + +The example in this section is based on the source ``nba.avro`` table shown below: + +.. csv-table:: nba.avro + :file: nba-t10.csv + :widths: auto + :header-rows: 1 + +The following example shows the correct file structure used to create the ``CREATE TABLE`` statement based on the **nba.avro** table: .. code-block:: postgres - CREATE TABLE nba AS - SELECT * FROM ext_nba; + CREATE TABLE ext_nba + ( -The following is an example of loading data from an Avro file into SQream: + Name TEXT(40), + Team TEXT(40), + Number BIGINT, + Position TEXT(2), + Age BIGINT, + Height TEXT(4), + Weight BIGINT, + College TEXT(40), + Salary FLOAT + ) + WRAPPER avro_fdw + OPTIONS + ( + LOCATION = 's3://sqream-demo-data/nba.avro' + ); + +.. tip:: + + An exact match must exist between the SQream and Avro types. For unsupported column types, you can set the type to any type and exclude it from subsequent queries. + +.. note:: The **nba.avro** file is stored on S3 at ``s3://sqream-demo-data/nba.avro``. + +Creating a Foreign Table +--------------------- +Before loading data, you must build the ``CREATE FOREIGN TABLE`` to correspond with the file structure of the inserted table. + +The example in this section is based on the source ``nba.avro`` table shown below: + +.. csv-table:: nba.avro + :file: nba-t10.csv + :widths: auto + :header-rows: 1 + +The following example shows the correct file structure used to create the ``CREATE FOREIGN TABLE`` statement based on the **nba.avro** table: .. code-block:: postgres + + CREATE FOREIGN TABLE ext_nba + ( + Name TEXT(40), + Team TEXT(40), + Number BIGINT, + Position TEXT(2), + Age BIGINT, + Height TEXT(4), + Weight BIGINT, + College TEXT(40), + Salary FLOAT + ) WRAPPER avro_fdw OPTIONS ( LOCATION = 's3://sqream-demo-data/nba.avro' ); - -For more examples, see :ref:`additional_examples`. -Avro Data Types -=========== -Avro includes the following data types: +.. tip:: + + An exact match must exist between the SQream and Avro types. For unsupported column types, you can set the type to any type and exclude it from subsequent queries. + +.. note:: The **nba.avro** file is stored on S3 at ``s3://sqream-demo-data/nba.avro``. + +.. note:: The examples in the sections above are identical except for the syntax used to create the tables. + +Mapping Between SQream and Avro Data Types +================= +Mapping between SQream and Avro data types depends on the Avro data type: .. contents:: :local: @@ -94,23 +159,23 @@ Complex Data Types -------------- The following table shows the supported **Complex** data types: -+------------+---------------------------------------------------+ -| | SQream Type | -| +-----------+---------------+-----------+-----------+ -|Avro Type | Number | Date/Datetime | String | Boolean | -+============+===========+===============+===========+===========+ -| ``record`` | | | | | -+------------+-----------+---------------+-----------+-----------+ -| ``enum`` | | | Supported | | -+------------+-----------+---------------+-----------+-----------+ -| ``array`` | | | | | -+------------+-----------+---------------+-----------+-----------+ -| ``map`` | | | | | -+------------+-----------+---------------+-----------+-----------+ -| ``union`` | Supported | Supported | Supported | Supported | -+------------+-----------+---------------+-----------+-----------+ -| ``fixed`` | | | | | -+------------+-----------+---------------+-----------+-----------+ ++------------+-------------------------------------------------------+ +| | SQream Type | +| +---------------+---------------+-----------+-----------+ +|Avro Type | Number | Date/Datetime | String | Boolean | ++============+============+================+=============+===========+ +| ``record`` | | | | | ++------------+------------+----------------+-------------+-----------+ +| ``enum`` | | | Supported | | ++------------+------------+----------------+-------------+-----------+ +| ``array`` | | | | | ++------------+------------+----------------+-------------+-----------+ +| ``map`` | | | | | ++------------+------------+----------------+-------------+-----------+ +| ``union`` | Supported | Supported | Supported | Supported | ++------------+------------+----------------+-------------+-----------+ +| ``fixed`` | | | | | ++------------+------------+----------------+-------------+-----------+ Logical Data Types -------------- @@ -143,76 +208,77 @@ The following table shows the supported **Logical** data types: +----------------------------+-----------+---------------+-----------+---------+ .. note:: Number types include **tinyint**, **smallint**, **int**, **bigint**, **real** and **float**, and **numeric**. String types include **text**. - + Mapping Objects to Rows =============== When mapping objects to rows, each Avro object or message must contain one ``record`` type object corresponding to a single row in SQream. The ``record`` fields are associated by name to their target table columns. Additional unmapped fields will be ignored. Note that using the JSONPath option overrides this. -Best Practices -==================== -This section describes the best practices when ingesting Avro files into SQream: +Ingesting Data into SQream +============== +This section includes the following: .. contents:: :local: :depth: 1 -Making Avro Files Accessible to Workers ---------------------- -To give workers access to files every node must have the same view of the storage being used. - -The following apply for Avro files to be accessible to workers: - -* For files hosted on NFS, ensure that the mount is accessible from all servers. - -* For HDFS, ensure that SQream servers have access to the HDFS name node with the correct **user-id**. For more information, see :ref:`hdfs`. - -* For S3, ensure network access to the S3 endpoint. For more information, see :ref:`s3`. +Syntax +----------- +Before ingesting data into SQream from an Avro file, you must create a table using the following syntax: -For more information about restricted worker access, see :ref:`workload_manager`. +.. code-block:: postgres + + COPY [schema name.]table_name + FROM WRAPPER fdw_name + ; + +After creating a table you can ingest data from an Avro file into SQream using the following syntax: -Basing Your Table Structure on Inserted Tables ---------------------- -Before loading data, you must build the ``CREATE FOREIGN TABLE`` to correspond with the file structure of the inserted table. +.. code-block:: postgres -The example in this section is based on the source ``nba.avro`` table shown below: + avro_fdw + +Example +----------- +The following is an example of creating a table: -.. csv-table:: nba.avro - :file: nba-t10.csv - :widths: auto - :header-rows: 1 +.. code-block:: postgres + + COPY t + FROM WRAPPER fdw_name + OPTIONS + ( + [ copy_from_option [, ...] ] + ) + ; -The following example shows the correct file structure used to create the ``CREATE FOREIGN TABLE`` statement based on the **nba.avro** table: +The following is an example of loading data from an Avro file into SQream: .. code-block:: postgres - - CREATE FOREIGN TABLE ext_nba - ( - Name TEXT(40), - Team TEXT(40), - Number BIGINT, - Position TEXT(2), - Age BIGINT, - Height TEXT(4), - Weight BIGINT, - College TEXT(40), - Salary FLOAT - ) WRAPPER avro_fdw OPTIONS ( LOCATION = 's3://sqream-demo-data/nba.avro' ); + +For more examples, see :ref:`additional_examples`. -.. tip:: - - An exact match must exist between the SQream and Avro types. For unsupported column types, you can set the type to any type and exclude it from subsequent queries. +Parameters +=================== +The following table shows the Avro parameter: -.. note:: The **nba.avro** file is stored on S3 at ``s3://sqream-demo-data/nba.avro``. +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``schema_name`` + - The schema name for the table. Defaults to ``public`` if not specified. -Verifying Your Table Output ---------------------- -Because external tables do not automatically verify the file integrity or structure, you must manually verify that the table output is identical to the original inserted table. +Best Practices +============ +Because external tables do not automatically verify the file integrity or structure, SQream recommends manually verifying your table output when ingesting Avro files into SQream. This lets you determine if your table output is identical to your originally inserted table. The following is an example of the output based on the **nba.avro** table: diff --git a/feature_guides/data_encryption_methods.rst b/feature_guides/data_encryption_methods.rst index dc6e7c122..0e5638058 100644 --- a/feature_guides/data_encryption_methods.rst +++ b/feature_guides/data_encryption_methods.rst @@ -13,7 +13,7 @@ Encrypting Data in Transit ---------------- **Data in transit** refers to data you use on a regular basis, usually stored on a database and accessed through applications or programs. This data is typically transferred between several physical or remote locations through email or uploading documents to the cloud. This type of data must therefore be protected while **in transit**. SQream encrypts data in transit using SSL when, for example, users insert data files from external repositories over a JDBC or ODBC connection. -For more information, see :ref:`installing_nginx_proxy_over_secure_connection`. +For more information, see `Use TLS/SSL When Possible `_. Encrypting Data at Rest ---------------- diff --git a/feature_guides/flexible_data_clustering.rst b/feature_guides/flexible_data_clustering.rst deleted file mode 100644 index ce0f3d321..000000000 --- a/feature_guides/flexible_data_clustering.rst +++ /dev/null @@ -1,16 +0,0 @@ -.. _flexible_data_clustering: - -*********************** -Flexible Data Clustering -*********************** -The **Flexible Data Clustering** section describes the following: - -.. toctree:: - :maxdepth: 4 - :titlesonly: - - flexible_data_clustering_overview - flexible_data_clustering_chunks - flexible_data_clustering_data_clustering_methods - flexible_data_clustering_data_rechunking_data - flexible_data_clustering_data_examples \ No newline at end of file diff --git a/feature_guides/flexible_data_clustering_chunks.rst b/feature_guides/flexible_data_clustering_chunks.rst deleted file mode 100644 index b8146d0fc..000000000 --- a/feature_guides/flexible_data_clustering_chunks.rst +++ /dev/null @@ -1,18 +0,0 @@ -.. _flexible_data_clustering_chunks: - -*********************** -What are Chunks? -*********************** -Chunks, sometimes referred to as **partitions**, are a contiguous number of rows in a specific column. SQream relies on an advanced partitioning method called **chunking**, which provides all static partitioning capabilities without the known limitations. - -The following figure shows a table rows grouped as chunks: - -.. figure:: /_static/images/chunking2.png - :scale: 75 % - :align: center - -The following figure shows the rows from the table above converted into chunks: - -.. figure:: /_static/images/chunking_metadata2.png - :scale: 75 % - :align: center \ No newline at end of file diff --git a/feature_guides/flexible_data_clustering_data_clustering_methods.rst b/feature_guides/flexible_data_clustering_data_clustering_methods.rst deleted file mode 100644 index 6949547ba..000000000 --- a/feature_guides/flexible_data_clustering_data_clustering_methods.rst +++ /dev/null @@ -1,180 +0,0 @@ -.. _flexible_data_clustering_data_clustering_methods: - -*********************** -Data Clustering Methods -*********************** -The following data clustering methods can be used in tandem or separately to enhance query performance: - -.. contents:: - :local: - :depth: 1 - -Using Time-Based Data Management -============ -Overview -~~~~~~~~~~ -**Time-based data management** refers to sorting table data along naturally occuring dimensions. The most common and naturally occuring sorting mechanism is a **timestamp**, which indicates the point in time at which data was inserted into SQream. Because SQream is a columnar storage system, timestamped metadata facilitates quick and easy query processing. - -The following is the correct syntax for timestamping a chunk: - -.. code-block:: postgres - - SELECT DATEPART(HOUR, timestamp), - MIN(transaction_amount), - MAX(transaction_amount), - avg(transaction_amount) - FROM transactions - WHERE timestamp BETWEEN (CURRENT_TIMESTAMP AND DATEADD(MONTH,-3,CURRENT_TIMESTAMP)) - GROUP BY 1; - -Timestamping data includes the following properties: - -* Data is loaded in a natural order while being inserted. - - :: - -* Updates are infrequent or non-existent. Updates occur by inserting new rows, which have their own timestamps. - - :: - -* Queries on timestamped data is typically on continuous time range. - - :: - -* Inserting and reading data are performed independently, not in the operation or transaction. - - :: - -* Timestamped data has a high data volume and accumulates faster than typical online transactional processing workloads. - -The following are some scenarios ideal for timestamping: - -* Running analytical queries spanning specific date ranges (such as the sum of transactions during August-July 2020 versus August-July 2019). - - :: - -* Deleting data older than a specific number of months old. - - :: - -* Regulations require you to maintain several years of data that you do not need to query on a regular basis. - -Best Practices for Time-Based Management -~~~~~~~~~~ -Data inserted in bulks is automatically timestamped with the insertion date and time. Therefore, inserting data through small and frequent bulks has the effect of naturally ordering data according to timestamp. Frequent bulks generally refers to short time frames, such as at 15-minute, hourly, or daily intervals. As you insert new data, SQream chunks and appends it into your existing tables according to its timestamp. - -The ``DATE`` and ``DATETIME`` types were created to improve performance, minimze storage size, and maintain data integrity. SQream recommends using them instead of ``TEXT``. - -Using Clustering Keys -============ -Overview -~~~~~~~~~~ -While data clustering occurs relatively naturally within a table, certain practices can be used to actively enhance query performance and runtime. Defining **clustering keys** increases performance by explicitly co-locating your data, enabling SQream to avoid processing irrelevant chunks. - -A clustering key is a subset of table columns or expressions and is defined using the ``CLUSTER BY`` statement, as shown below: - -.. code-block:: postgres - - CREATE TABLE users ( - name TEXT(30) NOT NULL, - start_date datetime not null, - country TEXT(30) DEFAULT 'Unknown' NOT NULL - ) CLUSTER BY country; - - - -The ``CLUSTER BY`` statement splits ingested data based on the range of data corresponding to the clustering key. This helps create chunks based on specific or related data, avoiding mixed chunks as much as possible. For example, instead of creating chunks based on a fixed number of rows, the ``CLUSTER_BY`` statement creates them based on common values. This optimizes the ``DELETE`` command as well, which deletes rows based on their location in a table. - -For more information, see the following: - -* `The CLUSTER_BY statement `_ -* `The DELETE statement `_ -* `The Deleting Data Guide `_ - -Inspecting Clustered Table Health -~~~~~~~~~~ -You can use the ``clustering_health`` utility function to check how well a table is clustered, as shown below: - -.. code-block:: postgres - - SELECT CLUSTERING_HEALTH('table_name','clustering_keys'); - -The ``CLUSTERING_HEALTH`` function returns the average clustering depth of your table relative to the clustering keys. A lower value indicates a well-clustered table. - -Clustering keys are useful for restructuring large tables not optimally ordered when inserted or as a result of extensive DML. A table that uses clustering keys is referred to as a **clustered table**. Tables that are not clustered require SQream's query optimizer to scan entire tables while running queries, dramatically increasing runtime. Some queries significantly benefit from clustering, such as filtering or joining extensively on clustered columns. - -SQream partially sorts data that you load into a clustered table. Note that while clustering tables increases query performance, clustering during the insertion stage can decrease performance by 75%. Nevertheless, once a table is clustered subsequent queries run more quickly. - -.. note:: - - To determine whether clustering will enhance performance, SQream recommends end-to-end testing your clustering keys on a small subset of your data before committing them to permanent use. This is relevant for testing insert and query performance. - -For more information, see the following: - -* **Data Manipulation commands (DML)** - see `Data Manipulation Commands (DML) `_. - -* **Creating tables** - see :ref:`create_table`. When you create a table, all new data is clustered upon insert. - -* **Modifying tables** - see :ref:`cluster_by`. - -* **Modifying a table schema** - see :ref:`alter_table`. - -Using Metadata -============ -SQream uses an automated and transparent system for collecting metadata describing each chunk. This metadata enables skipping unnecessary chunks and extents during query runtime. The system collects chunk metadata when data is inserted into SQream. This is done by splitting data into chunks and collecting and storing specific parameters to be used later. - -Because collecting metadata is not process-heavy and does not contribute significantly to query processing, it occurs continuously as a background process. Most metadata collection is typically performed by the GPU. For example, for a 10TB dataset, the metadata storage overhead is approximately 0.5GB. - -When a query includes a filter (such as a ``WHERE`` or ``JOIN`` condition) on a range of values spanning a fraction of the table values, SQream scans only the filtered segment of the table. - -Once collected, several metadata parameters are stored for later use, including: - -* The range of values on each column chunk (minimum, maximum). - - :: - -* The number of values. - - :: - -* Additional information for query optimization. - -Data is collected automatically and transparently on every column type. - -Queries filtering highly granular date and time ranges are the most effective, particularly when data is timestamped, and when tables contain a large amount of historical data. - -Using Chunks and Extents -============ -SQream stores data in logical tables made up of rows spanning one or more columns. Internally, data is stored in vertical partitions by column, and horizontally by chunks. The **Using Chunks and Extents** section describes how to leverge chunking to optimize query performance. - -A **chunk** is a contiguous number of rows in a specific column. Depending on data type, a chunk's uncompressed size typically ranges between 1MB and a few hundred megabytes. This size range is suitable for filtering and deleting data from large tables, which may contain between hundreds, millions, or billions of chunks. - -An **extent** is a specific number of contiguous chunks. Extents optimize disk access patterns, at around 20MB uncompressed, on-disk. Extents typically include between one and 25 chunks based on the compressed size of each chunk. - -.. note:: - - SQream compresses all data. In addition, all tables are automatically and transparently chunked. - -Unlike node-partitioning (or sharding), chunks are: - -* Small enough to be read concurrently by multiple workers. - - :: - -* Optimized for inserting data quickly. - - :: - -* Capable of carrying metadata, which narrows down their contents for the query optimizer. - - :: - -* Ideal for data retension because they can be deleted in bulk. - - :: - -* Optimized for reading into RAM and the GPU. - - :: - -* Compressed individually to improve compression and data locality. \ No newline at end of file diff --git a/feature_guides/flexible_data_clustering_data_examples.rst b/feature_guides/flexible_data_clustering_data_examples.rst deleted file mode 100644 index bf08a111a..000000000 --- a/feature_guides/flexible_data_clustering_data_examples.rst +++ /dev/null @@ -1,22 +0,0 @@ -.. _flexible_data_clustering_data_examples: - -*********************** -Examples -*********************** -The **Examples** includes the following examples: - -.. contents:: - :local: - :depth: 1 - -Creating a Clustered Table ------------------------------ -The following is an example of syntax for creating a clustered table on a table naturally ordered by ``start_date``. An alternative cluster key can be defined on such a table to improve performance on queries already ordered by ``country``: - -.. code-block:: postgres - - CREATE TABLE users ( - name text(30) NOT NULL, - start_date datetime not null, - country text(30) DEFAULT 'Unknown' NOT NULL - ) CLUSTER BY country; \ No newline at end of file diff --git a/feature_guides/flexible_data_clustering_data_rechunking_data.rst b/feature_guides/flexible_data_clustering_data_rechunking_data.rst deleted file mode 100644 index 30a74bbaa..000000000 --- a/feature_guides/flexible_data_clustering_data_rechunking_data.rst +++ /dev/null @@ -1,11 +0,0 @@ -.. _flexible_data_clustering_data_rechunking_data: - -*********************** -Rechunking Data -*********************** -SQream performs background storage reorganization operations to optimize I/O and read patterns. - -For example, when small batches of data are inserted, SQream runs two background processes called **rechunk** and **reextent** to reorganize the data into larger contiguous chunks and extents. This is also what happens when data is deleted. - - -Instead of overwriting data, SQream writes new optimized chunks and extents to replace old ones. After rewriting all old data, SQream switches to the new optimized chunks and extents and deletes the old data. \ No newline at end of file diff --git a/feature_guides/flexible_data_clustering_overview.rst b/feature_guides/flexible_data_clustering_overview.rst deleted file mode 100644 index 3ba59a603..000000000 --- a/feature_guides/flexible_data_clustering_overview.rst +++ /dev/null @@ -1,16 +0,0 @@ -.. _flexible_data_clustering_overview: - -*********************** -Overeview -*********************** -**Flexible data clustering** refers to sorting table data along naturally occuring dimensions, such as name, date, or location. Data clustering optimizes table structure to significantly improve query performance, especially on very large tables. A well-clustered table increases the effectivity of the metadata collected by focusing on a specific and limited range of rows, called **chunks**. - -The following are some scenarios ideal for data clustering: - -* Queries containg a ``WHERE`` predicate written as ``column COMPARISON value``, such as ``date_column > '2019-01-01'`` or ``id = 107`` when the columns referenced are clustering keys. - - In such a case SQream reads the portion of data that contain values matching these predicates only. - -* Two clustered tables joined by their respective clustering keys. - - In such a case SQream uses metadata to more easily identify matching chunks. \ No newline at end of file diff --git a/feature_guides/index.rst b/feature_guides/index.rst index 2ba36198d..fb663a336 100644 --- a/feature_guides/index.rst +++ b/feature_guides/index.rst @@ -15,7 +15,6 @@ This section describes the following features: key_evaluation data_encryption compression - flexible_data_clustering python_functions workload_manager transactions diff --git a/reference/sql/sql_statements/dml_commands/update.rst b/reference/sql/sql_statements/dml_commands/update.rst index 19881d62c..f16d90337 100644 --- a/reference/sql/sql_statements/dml_commands/update.rst +++ b/reference/sql/sql_statements/dml_commands/update.rst @@ -31,7 +31,7 @@ The following is the correct syntax for the ``UPDATE`` command: UPDATE target_table_name [[AS] alias1] SET column_name = expression [,...] - [WHERE condition] + [WHERE condition] The following is the correct syntax for triggering a clean-up: @@ -39,9 +39,8 @@ The following is the correct syntax for triggering a clean-up: SELECT cleanup_chunks('schema_name','table_name'); SELECT cleanup_extents('schema_name','table_name'); + SELECT cleanup_discarded_chunks(‘public’,’t’); -**Comment** - *The cleanup example above is different than the one used on the DELETED page. Is this correct?* - Parameters ============ The following table describes the ``UPDATE`` parameters: @@ -79,71 +78,21 @@ The following is an example of performing a simple update: UPDATE bands SET records_sold = records_sold + 1 WHERE name LIKE 'The %'; -Identifying and Cleaning Up Tables +Triggering a Clean-Up --------------------------------------- -**Comment** - *I copied and pasted this entire section from "DELETE". Does anything have to adjusted here for "UPDATE"?* - -The following section shows examples of each phase required for cleaning up tables: - -* :ref:`Listing tables that require clean-up` -* :ref:`Identifying clean-up predicates` -* :ref:`Triggering a clean-up` - -.. _listing_tables_that_require_cleanup: - -Listing Tables that Require Clean-Up -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -The following shows an example of listing tables that require clean-up: +The following section shows an example of triggering a clean-up: .. code-block:: psql - - farm=> SELECT t.table_name FROM sqream_catalog.delete_predicates dp - JOIN sqream_catalog.tables t - ON dp.table_id = t.table_id - GROUP BY 1; - cool_animals - - 1 row -.. _identifying_cleanup_predicates: + SELECT * FROM sqream_catalog.discarded_chunks; + SELECT cleanup_discarded_chunks('public','t'); -Identifying Clean-Up Predicates -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -The following shows an example of listing the clean-up predicates: +The following is an output example: -.. code-block:: psql - - farm=> SELECT delete_predicate FROM sqream_catalog.delete_predicates dp - JOIN sqream_catalog.tables t - ON dp.table_id = t.table_id - WHERE t.table_name = 'cool_animals'; - weight > 1000 - - 1 row - -.. _triggering_a_cleanup: - -Triggering a Clean-Up -^^^^^^^^^^^^^^^^^^^^^^ -The following shows an example of triggering a clean-up: - -.. code-block:: psql - - -- Chunk reorganization (SWEEP) - farm=> SELECT CLEANUP_CHUNKS('public','cool_animals'); - executed - - -- Delete leftover files (VACUUM) - farm=> SELECT CLEANUP_EXTENTS('public','cool_animals'); - executed - - - farm=> SELECT delete_predicate FROM sqream_catalog.delete_predicates dp - JOIN sqream_catalog.tables t - ON dp.table_id = t.table_id - WHERE t.table_name = 'cool_animals'; - - 0 rows +* **database_name** - _discarded_master +* **table_id** - 24 +* **column_id** - 1 +* **extent_ID** - 0 Permissions ============= diff --git a/releases/2022.1.rst b/releases/2022.1.rst index 9a2de884e..7b2d9d4dd 100644 --- a/releases/2022.1.rst +++ b/releases/2022.1.rst @@ -29,9 +29,9 @@ Data Encryption ************ SQream now supports data encryption mechanisms in accordance with **General Data Protection Regulation (GDPR)** standards. -For more information, see `Data Encryption `_. +Using the data encryption feature may lead to a maximum of a 40% increase in performance degradation. -**Comment** - *Information regarding performance degradation, pending.* +For more information, see `Data Encryption `_. Update Feature ************ @@ -91,4 +91,36 @@ This section is not relevant to the 2022.1 release notes. Upgrading to v2022.1 ------- -**Comment** - *TBD* \ No newline at end of file +1. Generate a back-up of the metadata by running the following command: + + .. code-block:: console + + $ select backup_metadata('out_path'); + + .. tip:: SQream recommends storing the generated back-up locally in case needed. + + SQream runs the Garbage Collector and creates a clean backup tarball package. + +2. Shut down all SQream services. + + :: + +3. Extract the recently created back-up file. + + :: + +4. Replace your current metadata with the metadata you stored in the back-up file. + + :: + +5. Navigate to the new SQream package bin folder. + + :: + +6. Run the following command: + + .. code-block:: console + + $ ./upgrade_storage + + .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in **Step 7** of the Upgrading SQream Version procedure. \ No newline at end of file From 5c07b951cb154b32c279d12c2342f6b7dfebae6c Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 24 May 2022 19:15:54 +0300 Subject: [PATCH 073/882] Update new_2022.1.png --- _static/images/new_2022.1.png | Bin 2056 -> 882 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/_static/images/new_2022.1.png b/_static/images/new_2022.1.png index fc043757cd3728088194fbb6951830f5bf7fcc0c..4861ba76a5b6c7d35703267596db1f4c0a8c9fb5 100644 GIT binary patch delta 845 zcmV-T1G4;x5b_2giBL{Q4GJ0x0000DNk~Le0001S0000E2m$~A0GDWFlaV1be**_e zL_t(oN9~tAa_TS;$N%^&K*4YVa{@?1mG*U_Oqz5l)1@&bK0+#**e8fjz))b{#cx+y z%aXA2!6TV@Gx?1QX|>4O)vi{cB?{H18FzjXg%;G(widyENZqDrRiXO@o1?qrQ$1ni zgfTU93?+&D?0VGMzj~8bFsBl1e@~kuQ%Yn+Oh3BL8SEKnLB{oI+h(chCum+#DJ3tW~MlW#m*acZ#|Lt z&oK`(rDT>0Zc3Hie|h!>cy(WwOS`NovP}Pq9)Q%sDopr0bZr^de|MeWWfH6Vy+dR; z_?B|)Fi+y(XC#s4e1q2MU0~FPY%qjxDeXSf0$)3O>2V+G((IdQXsMWfbRFNP?DumW zBJinfctq>!cklb9;FnK8F9+?(L|1L6&i-;SUHuqQ$nwklBWZTwCH;#)|4>$->|f$9 XQ>c)1B;vX600000NkvXXu0mjf(aoL- delta 2028 zcmVPUA2Xb_z!U38c9|795~RWyb+nWWk07vzr6VjxN}A!D0@;j!5(XUGxGY zQHdS}l6lX5&w2TA;?(KDF!>~_Y1$V*+wb3Qqqn!WTuI!YsmaTw$`&_tW5kFN23w`B zuhc~S0R5QKJ*6s2v{aMBnTk}bf3nR=fr32Zg^mO4;=!{;hBm+f&XbNVJv4f2cLCJTeOl8MOYr80nd}`r8c0Q*e+GnM8EVL zXmJ05^ge*+n`d9sjTSV@{8VN07+%+EawYDgCo(O~Go|ue#rgY&?@^n_e{df^Q+YPu zls|K|&D{OGf2pO39edF}*_ePwGuN)x!EYCRoWOcE&~e*$|H1RU$=_r7JQz>o_e5iv zkLQ)o>UvUmqUDqELh)s57#H21fOVobUmoDTXAkBwo-3F%_5OzK6NS3y@qtIPc9KVE z>0E&z0KjsdIIQpTS{*p)e-lH$eozN4`q2JE={o^ycm^`NrnkWm-sp}L!Dv^Zsg0gS zcp}q0H2EudqE9~tVPR_)lbRhv)7r9C-IYGH|4{mlCTMXDvxMb1#1lcY&o$2>PxPuH zt*J1g^A;1E%vFX;sK7Gy$&W_t2is@6ZrLwKHTCF5Wr?|rUS7=we}kisE_!WwF$%fU zuNI;GhtjtJJnZD;mONYn9&V+wQ~gOej?Pt1dVo=xQ6kS!PW=Y;`$aBxeX9;I=?g_I zX+MPb;JT~HB!(SbNuf^xdat=XR(S#; zSG5r2!taU@K5?kpf3fc8@VUM)LQ^2H|6uxd*bs5G0KwO{2EvibztQFEmXzofv;*<& z*u1s@Ed#{L8V|F8{K!;e4rU;z>vF&v=@=Z8>0Sun^un=_jID|u={f61NA(N@mEa!M8f0Zv5r9F!}U|wi>%j+xV z;_}>FxL_?Wtj&{{{Gk2;q4aH-E=*pv+S7jLDS2n`jz)=I%;I@190D0+7eCvv+!osZQZ6|D3F&8C$_jR!2DqY z%f_(dfcZ;OfAJk?GBI!Qj?onu5*>0BwAsx-rc=y|({LPj^(8ECU-Gy?WidNPys6@hD_5uj?DzyUAD?cKEuWjl|aQFsHTG-eeLm+)Y z;7|^{+ILcrT1e*`%Jl$`0~grkIb>qoq}YIb{++G{2Ih!7=2UpkzlG5LKbn7pM+jN= zM7=RBf9FSymbMBOcmU9p67f>Q;}r;@Fg7-?glp{bb%G2$X_l(rVGBBxMHA!b@@y18 zmkfeLp9sJgD1f(yKkX&|wiOTU|D*ZmaLogON(7Mk(e2f4`H?q@kgjCaIh5lB`GP`0 zSrWD0Z=g`F5A1?eJ?NfL6~LkLD}+ySAKL#ufBD}7K#2m9M#jxby_5Ctv$Kp7R7%7f zTjg{Bhjcbv6QLaMad9YUbEm>-R*V{SQgsw7w-H+R|#Y;&eN-+WJ_z zDxKm6a1POxWO@Pe1wN?ShQ&&~e{WKi$CO(z;C(*FBQ(|13<4a_H-&Nx8?L~J_Z3RP zSX;+|N1E_7!al&cmd4s0K6gQ%tVmUs0KargL-OA=#i9L&(qlNSryTekbbYbtLTee% z>vOVvej~wN;e3LHoEUV9%?KLKrckgoghi zas1oQ=#55boezEA Date: Sun, 29 May 2022 11:01:15 +0300 Subject: [PATCH 074/882] Update copy_to.rst Added Avro to COPY TO page. --- reference/sql/sql_statements/dml_commands/copy_to.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/dml_commands/copy_to.rst b/reference/sql/sql_statements/dml_commands/copy_to.rst index 61e6b35b2..85632904f 100644 --- a/reference/sql/sql_statements/dml_commands/copy_to.rst +++ b/reference/sql/sql_statements/dml_commands/copy_to.rst @@ -29,7 +29,7 @@ Syntax ) ; - fdw_name ::= csw_fdw | parquet_fdw | orc_fdw + fdw_name ::= csw_fdw | parquet_fdw | orc_fdw | avro_fdw schema_name ::= identifer From 1cbd8ce0cb4973a7809f40137dbc1c358eb19dab Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 29 May 2022 11:23:56 +0300 Subject: [PATCH 075/882] Updated Delete Guide Moved delete_guide from Feature Guides to Operational guides. Delete delete page and replaced with delete_guide. --- operational_guides/delete.rst | 214 ------------------ .../delete_guide.rst | 0 operational_guides/index.rst | 1 + 3 files changed, 1 insertion(+), 214 deletions(-) delete mode 100644 operational_guides/delete.rst rename {feature_guides => operational_guides}/delete_guide.rst (100%) diff --git a/operational_guides/delete.rst b/operational_guides/delete.rst deleted file mode 100644 index 24ab5a218..000000000 --- a/operational_guides/delete.rst +++ /dev/null @@ -1,214 +0,0 @@ -.. _delete_guide: - -*********************** -Deleting Data -*********************** - -SQream DB supports deleting data, but it's important to understand how this works and how to maintain deleted data. - -How does deleting in SQream DB work? -======================================== - -In SQream DB, when you run a delete statement, any rows that match the delete predicate will no longer be returned when running subsequent queries. -Deleted rows are tracked in a separate location, in *delete predicates*. - -After the delete statement, a separate process can be used to reclaim the space occupied by these rows, and to remove the small overhead that queries will have until this is done. - -Some benefits to this design are: - -#. Delete transactions complete quickly - -#. The total disk footprint overhead at any time for a delete transaction or cleanup process is small and bounded (while the system still supports low overhead commit, rollback and recovery for delete transactions). - - -Phase 1: Delete ---------------------------- - -.. TODO: isn't the delete cleanup able to complete a certain amount of work transactionally, so that you can do a massive cleanup in stages? - -.. TODO: our current best practices is to use a cron job with sqream sql to run the delete cleanup. we should document how to do this, we have customers with very different delete schedules so we can give a few extreme examples and when/why you'd use them - -When a :ref:`delete` statement is run, SQream DB records the delete predicates used. These predicates will be used to filter future statements on this table until all this delete predicate's matching rows have been physically cleaned up. - -This filtering process takes full advantage of SQream's zone map feature. - -Phase 2: Clean-up --------------------- - -The cleanup process is not automatic. This gives control to the user or DBA, and gives flexibility on when to run the clean up. - -Files marked for deletion during the logical deletion stage are removed from disk. This is achieved by calling both utility function commands: ``CLEANUP_CHUNKS`` and ``CLEANUP_EXTENTS`` sequentially. - -.. note:: - * :ref:`alter_table` and other DDL operations are blocked on tables that require clean-up. See more in the :ref:`concurrency_and_locks` guide. - * If the estimated time for a cleanup processs is beyond a threshold, you will get an error message about it. The message will explain how to override this limitation and run the process anywhere. - -Notes on data deletion -========================================= - -.. note:: - * If the number of deleted records crosses the threshold defined by the ``mixedColumnChunksThreshold`` parameter, the delete operation will be aborted. - * This is intended to alert the user that the large number of deleted records may result in a large number of mixed chuncks. - * To circumvent this alert, replace XXX with the desired number of records before running the delete operation: - -.. code-block:: postgres - - set mixedColumnChunksThreshold=XXX; - - -Deleting data does not free up space ------------------------------------------ - -With the exception of a full table delete (:ref:`TRUNCATE`), deleting data does not free up disk space. To free up disk space, trigger the cleanup process. - -``SELECT`` performance on deleted rows ----------------------------------------- - -Queries on tables that have deleted rows may have to scan data that hasn't been cleaned up. -In some cases, this can cause queries to take longer than expected. To solve this issue, trigger the cleanup process. - -Use ``TRUNCATE`` instead of ``DELETE`` ---------------------------------------- -For tables that are frequently emptied entirely, consider using :ref:`truncate` rather than :ref:`delete`. TRUNCATE removes the entire content of the table immediately, without requiring a subsequent cleanup to free up disk space. - -Cleanup is I/O intensive -------------------------------- - -The cleanup process actively compacts tables by writing a complete new version of column chunks with no dead space. This minimizes the size of the table, but can take a long time. It also requires extra disk space for the new copy of the table, until the operation completes. - -Cleanup operations can create significant I/O load on the database. Consider this when planning the best time for the cleanup process. - -If this is an issue with your environment, consider using ``CREATE TABLE AS`` to create a new table and then rename and drop the old table. - - -Example -============= - -Deleting values from a table ------------------------------- - -.. code-block:: psql - - farm=> SELECT * FROM cool_animals; - 1,Dog ,7 - 2,Possum ,3 - 3,Cat ,5 - 4,Elephant ,6500 - 5,Rhinoceros ,2100 - 6,\N,\N - - 6 rows - - farm=> DELETE FROM cool_animals WHERE weight > 1000; - executed - - farm=> SELECT * FROM cool_animals; - 1,Dog ,7 - 2,Possum ,3 - 3,Cat ,5 - 6,\N,\N - - 4 rows - -Deleting values based on more complex predicates ---------------------------------------------------- - -.. code-block:: psql - - farm=> SELECT * FROM cool_animals; - 1,Dog ,7 - 2,Possum ,3 - 3,Cat ,5 - 4,Elephant ,6500 - 5,Rhinoceros ,2100 - 6,\N,\N - - 6 rows - - farm=> DELETE FROM cool_animals WHERE weight > 1000; - executed - - farm=> SELECT * FROM cool_animals; - 1,Dog ,7 - 2,Possum ,3 - 3,Cat ,5 - 6,\N,\N - - 4 rows - -Identifying and cleaning up tables ---------------------------------------- - -List tables that haven't been cleaned up -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -.. code-block:: psql - - farm=> SELECT t.table_name FROM sqream_catalog.delete_predicates dp - JOIN sqream_catalog.tables t - ON dp.table_id = t.table_id - GROUP BY 1; - cool_animals - - 1 row - -Identify predicates for clean-up -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -.. code-block:: psql - - farm=> SELECT delete_predicate FROM sqream_catalog.delete_predicates dp - JOIN sqream_catalog.tables t - ON dp.table_id = t.table_id - WHERE t.table_name = 'cool_animals'; - weight > 1000 - - 1 row - -Triggering a cleanup -^^^^^^^^^^^^^^^^^^^^^^ - -.. code-block:: psql - - -- Chunk reorganization (aka SWEEP) - farm=> SELECT CLEANUP_CHUNKS('public','cool_animals'); - executed - - -- Delete leftover files (aka VACUUM) - farm=> SELECT CLEANUP_EXTENTS('public','cool_animals'); - executed - - - farm=> SELECT delete_predicate FROM sqream_catalog.delete_predicates dp - JOIN sqream_catalog.tables t - ON dp.table_id = t.table_id - WHERE t.table_name = 'cool_animals'; - - 0 rows - - - -Best practices for data deletion -===================================== - -* Run ``CLEANUP_CHUNKS`` and ``CLEANUP_EXTENTS`` after large ``DELETE`` operations. - -* When deleting large proportions of data from very large tables, consider running a ``CREATE TABLE AS`` operation instead, then rename and drop the original table. - -* Avoid killing ``CLEANUP_EXTENTS`` operations after they've started. - -* SQream DB is optimised for time-based data. When data is naturally ordered by a date or timestamp, deleting based on those columns will perform best. For more information, see our :ref:`time based data management guide`. - - - -.. soft update concept - -.. delete cleanup and it's properties. automatic/manual, in transaction or background - -.. automatic background gives fast delete, minimal transaction overhead, -.. small cost to queries until background reorganised - -.. when does delete use the metadata effectively - -.. more examples - diff --git a/feature_guides/delete_guide.rst b/operational_guides/delete_guide.rst similarity index 100% rename from feature_guides/delete_guide.rst rename to operational_guides/delete_guide.rst diff --git a/operational_guides/index.rst b/operational_guides/index.rst index dcad76172..b6d3e50f4 100644 --- a/operational_guides/index.rst +++ b/operational_guides/index.rst @@ -16,6 +16,7 @@ This section summarizes the following operational guides: creating_or_cloning_a_storage_cluster external_data external_tables + delete_guide exporting_data logging monitoring_query_performance From 5ac738294af255e8afaf3185bc8582ff09335cc8 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 29 May 2022 11:38:02 +0300 Subject: [PATCH 076/882] Updated External Tables Page Replaced External Tables with Foreign Tables. Modified content on Foreign Tables page (replaced external tables with foreign tables). In Index, replaced external_tables with foreign_tables. Copied nba-t10.csv file into operational_guides folder (table was missing and therefore causing syntax error). --- ...external_tables.rst => foreign_tables.rst} | 33 ++++++++++--------- operational_guides/index.rst | 2 +- operational_guides/nba-t10.csv | 10 ++++++ 3 files changed, 29 insertions(+), 16 deletions(-) rename operational_guides/{external_tables.rst => foreign_tables.rst} (94%) create mode 100644 operational_guides/nba-t10.csv diff --git a/operational_guides/external_tables.rst b/operational_guides/foreign_tables.rst similarity index 94% rename from operational_guides/external_tables.rst rename to operational_guides/foreign_tables.rst index 6ee2f67a0..b914d7b3c 100644 --- a/operational_guides/external_tables.rst +++ b/operational_guides/foreign_tables.rst @@ -1,37 +1,39 @@ -.. _external_tables: +.. _foreign_tables: *********************** -External Tables +Foreign Tables *********************** -External tables can be used to run queries directly on data without inserting it into SQream DB first. +Foreign tables can be used to run queries directly on data without inserting it into SQream DB first. SQream DB supports read only external tables, so you can query from external tables, but you cannot insert to them, or run deletes or updates on them. + Running queries directly on external data is most effectively used for things like one off querying. If you will be repeatedly querying data, the performance will usually be better if you insert the data into SQream DB first. + Although external tables can be used without inserting data into SQream DB, one of their main use cases is to help with the insertion process. An insert select statement on an external table can be used to insert data into SQream using the full power of the query engine to perform ETL. .. contents:: In this topic: :local: -What kind of data is supported? +Supported Data Formats ===================================== SQream DB supports external tables over: -* text files (e.g. CSV, PSV, TSV) +* Text files (e.g. CSV, PSV, TSV) * ORC * Parquet -What kind of data staging is supported? +Supported Data Staging ============================================ -SQream DB can stage data from: +SQream can stage data from: * a local filesystem (e.g. ``/mnt/storage/....``) * :ref:`s3` buckets (e.g. ``s3://pp-secret-bucket/users/*.parquet``) * :ref:`hdfs` (e.g. ``hdfs://hadoop-nn.piedpiper.com/rhendricks/*.csv``) -Using external tables - a practical example +Using External Tables ============================================== Use an external table to stage data before loading from CSV, Parquet or ORC files. -Planning for data staging +Planning for Data Staging -------------------------------- For the following examples, we will want to interact with a CSV file. Here's a peek at the table contents: @@ -44,7 +46,7 @@ For the following examples, we will want to interact with a CSV file. Here's a p The file is stored on :ref:`s3`, at ``s3://sqream-demo-data/nba_players.csv``. We will make note of the file structure, to create a matching ``CREATE_EXTERNAL_TABLE`` statement. -Creating the external table +Creating an External Table ----------------------------- Based on the source file structure, we we :ref:`create an external table` with the appropriate structure, and point it to the file. @@ -68,7 +70,8 @@ Based on the source file structure, we we :ref:`create an external table SELECT * FROM nba; master=> select * from nba; Record delimiter mismatch during CSV parsing. User defined line delimiter \n does not match the first delimiter \r\n found in s3://sqream-demo-data/nba.csv -* Since the data for an external table is not stored in SQream DB, it can be changed or removed at any time by an external process. As a result, the same query can return different results each time it runs against an external table. Similarly, a query might fail if the external data is moved, removed, or has changed structure. +* Since the data for an external table is not stored in SQream DB, it can be changed or removed at any time by an external process. As a result, the same query can return different results each time it runs against an external table. Similarly, a query might fail if the external data is moved, removed, or has changed structure. \ No newline at end of file diff --git a/operational_guides/index.rst b/operational_guides/index.rst index b6d3e50f4..aca578e8b 100644 --- a/operational_guides/index.rst +++ b/operational_guides/index.rst @@ -15,7 +15,7 @@ This section summarizes the following operational guides: access_control creating_or_cloning_a_storage_cluster external_data - external_tables + foreign_tables delete_guide exporting_data logging diff --git a/operational_guides/nba-t10.csv b/operational_guides/nba-t10.csv new file mode 100644 index 000000000..024530355 --- /dev/null +++ b/operational_guides/nba-t10.csv @@ -0,0 +1,10 @@ +Name,Team,Number,Position,Age,Height,Weight,College,Salary +Avery Bradley,Boston Celtics,0.0,PG,25.0,6-2,180.0,Texas,7730337.0 +Jae Crowder,Boston Celtics,99.0,SF,25.0,6-6,235.0,Marquette,6796117.0 +John Holland,Boston Celtics,30.0,SG,27.0,6-5,205.0,Boston University, +R.J. Hunter,Boston Celtics,28.0,SG,22.0,6-5,185.0,Georgia State,1148640.0 +Jonas Jerebko,Boston Celtics,8.0,PF,29.0,6-10,231.0,,5000000.0 +Amir Johnson,Boston Celtics,90.0,PF,29.0,6-9,240.0,,12000000.0 +Jordan Mickey,Boston Celtics,55.0,PF,21.0,6-8,235.0,LSU,1170960.0 +Kelly Olynyk,Boston Celtics,41.0,C,25.0,7-0,238.0,Gonzaga,2165160.0 +Terry Rozier,Boston Celtics,12.0,PG,22.0,6-2,190.0,Louisville,1824360.0 From 732df57cd53c332b0de03641102ca92382fc5ac5 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 29 May 2022 12:21:57 +0300 Subject: [PATCH 077/882] Modified nba-t10.csv syntax. Tried to get nba-t10.csv file to display properly. --- operational_guides/foreign_tables.rst | 5 +- .../ddl_commands/create_external_table.rst | 156 ------------------ 2 files changed, 2 insertions(+), 159 deletions(-) delete mode 100644 reference/sql/sql_statements/ddl_commands/create_external_table.rst diff --git a/operational_guides/foreign_tables.rst b/operational_guides/foreign_tables.rst index b914d7b3c..739652bfa 100644 --- a/operational_guides/foreign_tables.rst +++ b/operational_guides/foreign_tables.rst @@ -36,12 +36,11 @@ Use an external table to stage data before loading from CSV, Parquet or ORC file Planning for Data Staging -------------------------------- For the following examples, we will want to interact with a CSV file. Here's a peek at the table contents: - + .. csv-table:: nba.csv - :file: nba-t10.csv :widths: auto - :header-rows: 1 + :header-rows: 1 The file is stored on :ref:`s3`, at ``s3://sqream-demo-data/nba_players.csv``. We will make note of the file structure, to create a matching ``CREATE_EXTERNAL_TABLE`` statement. diff --git a/reference/sql/sql_statements/ddl_commands/create_external_table.rst b/reference/sql/sql_statements/ddl_commands/create_external_table.rst deleted file mode 100644 index e877a3983..000000000 --- a/reference/sql/sql_statements/ddl_commands/create_external_table.rst +++ /dev/null @@ -1,156 +0,0 @@ -.. _create_external_table: - -*********************** -CREATE EXTERNAL TABLE -*********************** - -.. warning:: - - The ``CREATE EXTERNAL TABLE`` syntax is deprecated, and will be removed in future versions. - - Starting with SQream DB v2020.2, external tables have been renamed to :ref:`foreign tables`, and use a more flexible foreign data wrapper concept. See :ref:`create_foreign_table` instead. - - Upgrading to a new version of SQream DB converts existing tables automatically. When creating a new external tables, use the new foreign table syntax. - - -``CREATE TABLE`` creates a new external table in an existing database. - -See more in the :ref:`External tables guide`. - -.. tip:: - - * Data in an external table can change if the sources change, and frequent access to remote files may harm performance. - - * To create a regular table, see :ref:`CREATE TABLE ` - -Permissions -============= - -The role must have the ``CREATE`` permission at the database level. - -Syntax -========== - -.. code-block:: postgres - - create_table_statement ::= - CREATE [ OR REPLACE ] EXTERNAL TABLE [schema_name].table_name ( - { column_def [, ...] } - ) - USING FORMAT format_def - WITH { external_table_option [ ...] } - ; - - schema_name ::= identifier - - table_name ::= identifier - - format_def ::= { PARQUET | ORC | CSV } - - external_table_option ::= { - PATH '{ path_spec }' - | FIELD DELIMITER '{ field_delimiter }' - | RECORD DELIMITER '{ record_delimiter }' - | AWS_ID '{ AWS ID }' - | AWS_SECRET '{ AWS SECRET }' - } - - path_spec ::= { local filepath | S3 URI | HDFS URI } - - field_delimiter ::= delimiter_character - - record_delimiter ::= delimiter_character - - column_def ::= { column_name type_name [ default ] [ column_constraint ] } - - column_name ::= identifier - - column_constraint ::= - { NOT NULL | NULL } - - default ::= - - DEFAULT default_value - | IDENTITY [ ( start_with [ , increment_by ] ) ] - -.. _cet_parameters: - -Parameters -============ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``OR REPLACE`` - - Create a new table, and overwrite any existing table by the same name. Does not return an error if the table already exists. ``CREATE OR REPLACE`` does not check the table contents or structure, only the table name. - * - ``schema_name`` - - The name of the schema in which to create the table. - * - ``table_name`` - - The name of the table to create, which must be unique inside the schema. - * - ``column_def`` - - A comma separated list of column definitions. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally. - * - ``USING FORMAT ...`` - - Specifies the format of the source files, such as ``PARQUET``, ``ORC``, or ``CSV``. - * - ``WITH PATH ...`` - - Specifies a path or URI of the source files, such as ``/path/to/*.parquet``. - * - ``FIELD DELIMITER`` - - Specifies the field delimiter for CSV files. Defaults to ``,``. - * - ``RECORD DELIMITER`` - - Specifies the record delimiter for CSV files. Defaults to a newline, ``\n`` - * - ``AWS_ID``, ``AWS_SECRET`` - - Credentials for authenticated S3 access - - -Examples -=========== - -A simple table from Tab-delimited file (TSV) ----------------------------------------------- - -.. code-block:: postgres - - CREATE OR REPLACE EXTERNAL TABLE cool_animals - (id INT NOT NULL, name text(30) NOT NULL, weight FLOAT NOT NULL) - USING FORMAT csv - WITH PATH '/home/rhendricks/cool_animals.csv' - FIELD DELIMITER '\t'; - - -A table from a directory of Parquet files on HDFS ------------------------------------------------------ - -.. code-block:: postgres - - CREATE EXTERNAL TABLE users - (id INT NOT NULL, name text(30) NOT NULL, email text(50) NOT NULL) - USING FORMAT Parquet - WITH PATH 'hdfs://hadoop-nn.piedpiper.com/rhendricks/users/*.parquet'; - -A table from a bucket of files on S3 --------------------------------------- - -.. code-block:: postgres - - CREATE EXTERNAL TABLE users - (id INT NOT NULL, name text(30) NOT NULL, email text(50) NOT NULL) - USING FORMAT Parquet - WITH PATH 's3://pp-secret-bucket/users/*.parquet' - AWS_ID 'our_aws_id' - AWS_SECRET 'our_aws_secret'; - - -Changing an external table to a regular table ------------------------------------------------- - -Materializes an external table into a regular table. - -.. tip: Using an external table allows you to perform ETL-like operations in SQream DB by applying SQL functions and operations to raw files - -.. code-block:: postgres - - CREATE TABLE real_table - AS SELECT * FROM external_table; - From fd1e61a64a2dca4ebf60e00d4e5921c457dbc674 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 29 May 2022 13:12:36 +0300 Subject: [PATCH 078/882] Update update.rst TPD-171: Update - Support Clustering Key --- .../sql/sql_statements/dml_commands/update.rst | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/update.rst b/reference/sql/sql_statements/dml_commands/update.rst index f16d90337..d0f545017 100644 --- a/reference/sql/sql_statements/dml_commands/update.rst +++ b/reference/sql/sql_statements/dml_commands/update.rst @@ -19,10 +19,14 @@ The ``UPDATE`` command is used to modify the value of certain columns in existin It can be used to do the following: -* Perform localized changes in existing data, such as correcting mistakes discovered after ingesting data. +* Performing localized changes in existing data, such as correcting mistakes discovered after ingesting data. + + :: * Setting columns based on the values of others. +.. warning:: Using the ``UPDATE`` command on column clustered using a cluster key can undo your clustering. + Syntax ========== The following is the correct syntax for the ``UPDATE`` command: @@ -60,7 +64,7 @@ The following table describes the ``UPDATE`` parameters: * - ``condition`` - Specifies the condition for updating the data. -.. note:: Similar to a DELETE statement, an UPDATE statement may leave some uncleaned data behind, which requires a cleanup operation. +.. note:: Similar to a ``DELETE`` statement, an ``UPDATE`` statement may leave some uncleaned data behind, which requires a clean-up operation. Examples =========== @@ -87,17 +91,17 @@ The following section shows an example of triggering a clean-up: SELECT * FROM sqream_catalog.discarded_chunks; SELECT cleanup_discarded_chunks('public','t'); -The following is an output example: +The following is an example of the output generated from the above: * **database_name** - _discarded_master * **table_id** - 24 * **column_id** - 1 * **extent_ID** - 0 -Permissions +Locking and Concurrency ============= -Executing an ``UPDATE`` statement requires both ``UPDATE`` and ``SELECT`` permissions on the target table. +Executing the ``UPDATE`` statement obtains an exclusive ``UPDATE`` lock on the target table. -Locking and Concurrency +Permissions ============= -Executing the ``UPDATE`` statement obtains an exclusive UPDATE lock on the target table. \ No newline at end of file +Executing an ``UPDATE`` statement requires both ``UPDATE`` and ``SELECT`` permissions on the target table. \ No newline at end of file From 138e683d0caea04d0534de8e86be73ea539b6fe5 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 29 May 2022 13:33:33 +0300 Subject: [PATCH 079/882] Modified Delete Guide Moved delete_guide from feature_guides to operational_guides --- feature_guides/delete.rst | 214 -------------------------------------- feature_guides/index.rst | 1 - 2 files changed, 215 deletions(-) delete mode 100644 feature_guides/delete.rst diff --git a/feature_guides/delete.rst b/feature_guides/delete.rst deleted file mode 100644 index 24ab5a218..000000000 --- a/feature_guides/delete.rst +++ /dev/null @@ -1,214 +0,0 @@ -.. _delete_guide: - -*********************** -Deleting Data -*********************** - -SQream DB supports deleting data, but it's important to understand how this works and how to maintain deleted data. - -How does deleting in SQream DB work? -======================================== - -In SQream DB, when you run a delete statement, any rows that match the delete predicate will no longer be returned when running subsequent queries. -Deleted rows are tracked in a separate location, in *delete predicates*. - -After the delete statement, a separate process can be used to reclaim the space occupied by these rows, and to remove the small overhead that queries will have until this is done. - -Some benefits to this design are: - -#. Delete transactions complete quickly - -#. The total disk footprint overhead at any time for a delete transaction or cleanup process is small and bounded (while the system still supports low overhead commit, rollback and recovery for delete transactions). - - -Phase 1: Delete ---------------------------- - -.. TODO: isn't the delete cleanup able to complete a certain amount of work transactionally, so that you can do a massive cleanup in stages? - -.. TODO: our current best practices is to use a cron job with sqream sql to run the delete cleanup. we should document how to do this, we have customers with very different delete schedules so we can give a few extreme examples and when/why you'd use them - -When a :ref:`delete` statement is run, SQream DB records the delete predicates used. These predicates will be used to filter future statements on this table until all this delete predicate's matching rows have been physically cleaned up. - -This filtering process takes full advantage of SQream's zone map feature. - -Phase 2: Clean-up --------------------- - -The cleanup process is not automatic. This gives control to the user or DBA, and gives flexibility on when to run the clean up. - -Files marked for deletion during the logical deletion stage are removed from disk. This is achieved by calling both utility function commands: ``CLEANUP_CHUNKS`` and ``CLEANUP_EXTENTS`` sequentially. - -.. note:: - * :ref:`alter_table` and other DDL operations are blocked on tables that require clean-up. See more in the :ref:`concurrency_and_locks` guide. - * If the estimated time for a cleanup processs is beyond a threshold, you will get an error message about it. The message will explain how to override this limitation and run the process anywhere. - -Notes on data deletion -========================================= - -.. note:: - * If the number of deleted records crosses the threshold defined by the ``mixedColumnChunksThreshold`` parameter, the delete operation will be aborted. - * This is intended to alert the user that the large number of deleted records may result in a large number of mixed chuncks. - * To circumvent this alert, replace XXX with the desired number of records before running the delete operation: - -.. code-block:: postgres - - set mixedColumnChunksThreshold=XXX; - - -Deleting data does not free up space ------------------------------------------ - -With the exception of a full table delete (:ref:`TRUNCATE`), deleting data does not free up disk space. To free up disk space, trigger the cleanup process. - -``SELECT`` performance on deleted rows ----------------------------------------- - -Queries on tables that have deleted rows may have to scan data that hasn't been cleaned up. -In some cases, this can cause queries to take longer than expected. To solve this issue, trigger the cleanup process. - -Use ``TRUNCATE`` instead of ``DELETE`` ---------------------------------------- -For tables that are frequently emptied entirely, consider using :ref:`truncate` rather than :ref:`delete`. TRUNCATE removes the entire content of the table immediately, without requiring a subsequent cleanup to free up disk space. - -Cleanup is I/O intensive -------------------------------- - -The cleanup process actively compacts tables by writing a complete new version of column chunks with no dead space. This minimizes the size of the table, but can take a long time. It also requires extra disk space for the new copy of the table, until the operation completes. - -Cleanup operations can create significant I/O load on the database. Consider this when planning the best time for the cleanup process. - -If this is an issue with your environment, consider using ``CREATE TABLE AS`` to create a new table and then rename and drop the old table. - - -Example -============= - -Deleting values from a table ------------------------------- - -.. code-block:: psql - - farm=> SELECT * FROM cool_animals; - 1,Dog ,7 - 2,Possum ,3 - 3,Cat ,5 - 4,Elephant ,6500 - 5,Rhinoceros ,2100 - 6,\N,\N - - 6 rows - - farm=> DELETE FROM cool_animals WHERE weight > 1000; - executed - - farm=> SELECT * FROM cool_animals; - 1,Dog ,7 - 2,Possum ,3 - 3,Cat ,5 - 6,\N,\N - - 4 rows - -Deleting values based on more complex predicates ---------------------------------------------------- - -.. code-block:: psql - - farm=> SELECT * FROM cool_animals; - 1,Dog ,7 - 2,Possum ,3 - 3,Cat ,5 - 4,Elephant ,6500 - 5,Rhinoceros ,2100 - 6,\N,\N - - 6 rows - - farm=> DELETE FROM cool_animals WHERE weight > 1000; - executed - - farm=> SELECT * FROM cool_animals; - 1,Dog ,7 - 2,Possum ,3 - 3,Cat ,5 - 6,\N,\N - - 4 rows - -Identifying and cleaning up tables ---------------------------------------- - -List tables that haven't been cleaned up -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -.. code-block:: psql - - farm=> SELECT t.table_name FROM sqream_catalog.delete_predicates dp - JOIN sqream_catalog.tables t - ON dp.table_id = t.table_id - GROUP BY 1; - cool_animals - - 1 row - -Identify predicates for clean-up -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -.. code-block:: psql - - farm=> SELECT delete_predicate FROM sqream_catalog.delete_predicates dp - JOIN sqream_catalog.tables t - ON dp.table_id = t.table_id - WHERE t.table_name = 'cool_animals'; - weight > 1000 - - 1 row - -Triggering a cleanup -^^^^^^^^^^^^^^^^^^^^^^ - -.. code-block:: psql - - -- Chunk reorganization (aka SWEEP) - farm=> SELECT CLEANUP_CHUNKS('public','cool_animals'); - executed - - -- Delete leftover files (aka VACUUM) - farm=> SELECT CLEANUP_EXTENTS('public','cool_animals'); - executed - - - farm=> SELECT delete_predicate FROM sqream_catalog.delete_predicates dp - JOIN sqream_catalog.tables t - ON dp.table_id = t.table_id - WHERE t.table_name = 'cool_animals'; - - 0 rows - - - -Best practices for data deletion -===================================== - -* Run ``CLEANUP_CHUNKS`` and ``CLEANUP_EXTENTS`` after large ``DELETE`` operations. - -* When deleting large proportions of data from very large tables, consider running a ``CREATE TABLE AS`` operation instead, then rename and drop the original table. - -* Avoid killing ``CLEANUP_EXTENTS`` operations after they've started. - -* SQream DB is optimised for time-based data. When data is naturally ordered by a date or timestamp, deleting based on those columns will perform best. For more information, see our :ref:`time based data management guide`. - - - -.. soft update concept - -.. delete cleanup and it's properties. automatic/manual, in transaction or background - -.. automatic background gives fast delete, minimal transaction overhead, -.. small cost to queries until background reorganised - -.. when does delete use the metadata effectively - -.. more examples - diff --git a/feature_guides/index.rst b/feature_guides/index.rst index fb663a336..2ca100a0f 100644 --- a/feature_guides/index.rst +++ b/feature_guides/index.rst @@ -11,7 +11,6 @@ This section describes the following features: :maxdepth: 1 :titlesonly: - delete_guide key_evaluation data_encryption compression From e2be508ed8dec82a2fa18a5dc91c318a2804d074 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Mon, 30 May 2022 12:06:21 +0300 Subject: [PATCH 080/882] Update data_encryption_overview.rst Integrated Raz Tamir's comments on this page. --- feature_guides/data_encryption_overview.rst | 10 +--------- 1 file changed, 1 insertion(+), 9 deletions(-) diff --git a/feature_guides/data_encryption_overview.rst b/feature_guides/data_encryption_overview.rst index 58bb7ea40..a37325e52 100644 --- a/feature_guides/data_encryption_overview.rst +++ b/feature_guides/data_encryption_overview.rst @@ -11,11 +11,7 @@ The demand for confidentiality has steadily increased to protect the growing vol Encryption can be used for the following: -* Deleting encrypted columns. - - :: - -* Creating tables with one or more encrypted columns. +* Creating tables up to three encrypted columns. :: @@ -23,10 +19,6 @@ Encryption can be used for the following: :: -* Encrypting existing data. - - :: - * Selecting data from an encrypted column. For more information on the encryption syntax, see :ref:`data_encryption_syntax`. From ce49d1129f120de98bb8308fa40df062d2243f31 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Mon, 30 May 2022 12:08:48 +0300 Subject: [PATCH 081/882] Updated for 2022.1 --- index.rst | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/index.rst b/index.rst index cb7d685b2..29ea038b0 100644 --- a/index.rst +++ b/index.rst @@ -4,7 +4,7 @@ SQream DB Documentation ************************* -The **2022.3 Preview** branch is a private branch designed for internal use only. +The **v2022.1** branch is a private branch designed for internal use only until the release date. .. only:: html @@ -57,7 +57,9 @@ SQream DB easily plugs in to third-party tools like :ref:`Tableau` + :ref:`2022.1<2022.1>` + + :ref:`2021.2<2021.2>` :ref:`2021.1<2021.1>` @@ -87,7 +89,7 @@ If you couldn't find what you're looking for, we're always happy to help. Visit .. rubric:: Looking for older versions? -This version of the documentation is for SQream DB Version 2021.2. +This version of the documentation is for SQream DB Version 2022.1. If you're looking for an older version of the documentation, versions 1.10 through 2019.2.1 are available at http://previous.sqream.com . From c675e002792e47bc2c5e9c392c7ca47e13f56095 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Mon, 30 May 2022 13:18:40 +0300 Subject: [PATCH 082/882] Changed 40% to 30% Degradation Raz Tamar email. --- releases/2022.1.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/2022.1.rst b/releases/2022.1.rst index 7b2d9d4dd..53c314faf 100644 --- a/releases/2022.1.rst +++ b/releases/2022.1.rst @@ -29,7 +29,7 @@ Data Encryption ************ SQream now supports data encryption mechanisms in accordance with **General Data Protection Regulation (GDPR)** standards. -Using the data encryption feature may lead to a maximum of a 40% increase in performance degradation. +Using the data encryption feature may lead to a maximum of a 30% increase in performance degradation. For more information, see `Data Encryption `_. From fa271aa442ddc9638db3f6950676a19bc93d4d09 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Mon, 30 May 2022 15:01:47 +0300 Subject: [PATCH 083/882] Update cluster_by.rst --- reference/sql/sql_statements/ddl_commands/cluster_by.rst | 4 ---- 1 file changed, 4 deletions(-) diff --git a/reference/sql/sql_statements/ddl_commands/cluster_by.rst b/reference/sql/sql_statements/ddl_commands/cluster_by.rst index e4cf42ad4..7dcedaaf1 100644 --- a/reference/sql/sql_statements/ddl_commands/cluster_by.rst +++ b/reference/sql/sql_statements/ddl_commands/cluster_by.rst @@ -7,10 +7,6 @@ The ``CLUSTER BY`` command is used for changing clustering keys in a table. For more information, see the following: -* :ref:`flexible_data_clustering` - - :: - * :ref:`drop_clustering_key` :: From 49bb8df32937b571e8af6e37d3f2669e6b20873c Mon Sep 17 00:00:00 2001 From: YanivGerowitz <82020437+YanivGerowitz@users.noreply.github.com> Date: Tue, 7 Jun 2022 14:37:41 +0300 Subject: [PATCH 084/882] Update show_server_status.rst TPD-128 --- .../utility_commands/show_server_status.rst | 78 +++++++++---------- 1 file changed, 39 insertions(+), 39 deletions(-) diff --git a/reference/sql/sql_statements/utility_commands/show_server_status.rst b/reference/sql/sql_statements/utility_commands/show_server_status.rst index f59f79ccc..73902a046 100644 --- a/reference/sql/sql_statements/utility_commands/show_server_status.rst +++ b/reference/sql/sql_statements/utility_commands/show_server_status.rst @@ -3,18 +3,13 @@ ******************** SHOW_SERVER_STATUS ******************** - ``SHOW_SERVER_STATUS`` returns a list of active sessions across the cluster. To list active statements on the current worker only, see :ref:`show_connections`. -Permissions -============= - -The role must have the ``SUPERUSER`` permissions. - Syntax ========== +The following is the correct syntax when showing your server status: .. code-block:: postgres @@ -24,85 +19,90 @@ Syntax Parameters ============ - -None +The Parameters section is not relevant for the ``SHOW_SERVER_STATUS`` statement. Returns ========= +The ``SHOW_SERVER_STATUS`` function returns a list of active sessions. If no sessions are active across the cluster, the result set will be empty. -This function returns a list of active sessions. If no sessions are active across the cluster, the result set will be empty. +The following table shows the ``SHOW_SERVER_STATUS`` result columns; -.. list-table:: Result columns +.. list-table:: Result Columns :widths: auto :header-rows: 1 - * - ``service`` - - The service name for the statement + * - service + - Statement Service Name * - ``instance`` - - The worker ID + - Shows the worker ID. * - ``connection_id`` - - Connection ID + - Shows the connection ID. * - ``serverip`` - - Worker end-point IP + - Shows the worker end-point IP. * - ``serverport`` - - Worker end-point port + - Shows the worker end-point port. * - ``database_name`` - - Database name for the statement + - Shows the statement's database name. * - ``user_name`` - - Username running the statement + - Shows the username running the statement. * - ``clientip`` - - Client IP + - Shows the client IP. * - ``statementid`` - - Statement ID + - Shows the statement ID. * - ``statement`` - - Statement text + - Shows the statement text. * - ``statementstarttime`` - - Statement start timestamp + - Shows the statement start timestamp. * - ``statementstatus`` - - Statement status (see table below) + - Shows the statement status (see table below). * - ``statementstatusstart`` - - Last updated timestamp + - Shows the most recently updated timestamp. .. include from here: 66 +The following table shows the statement status values: -.. list-table:: Statement status values +.. list-table:: Statement Status Values :widths: auto :header-rows: 1 * - Status - Description * - ``Preparing`` - - Statement is being prepared + - The statement is being prepared. * - ``In queue`` - - Statement is waiting for execution + - The statement is waiting for execution. * - ``Initializing`` - - Statement has entered execution checks + - The statement has entered execution checks. * - ``Executing`` - - Statement is executing + - The statement is executing. * - ``Stopping`` - - Statement is in the process of stopping - + - The statement is in the process of stopping. .. include until here 86 Notes =========== +This utility shows the active sessions. Some sessions may be actively connected, but not running any statements. -* This utility shows the active sessions. Some sessions may be actively connected, but not running any statements. - -Examples +Example =========== -Using ``SHOW_SERVER_STATUS`` to get statement IDs +Using SHOW_SERVER_STATUS to Get Statement IDs ---------------------------------------------------- - +The following example shows how to use the ``SHOW_SERVER_STATUS`` statement to get statement IDs: .. code-block:: psql t=> SELECT SHOW_SERVER_STATUS(); - service | instanceid | connection_id | serverip | serverport | database_name | user_name | clientip | statementid | statement | statementstarttime | statementstatus | statementstatusstart - --------+------------+---------------+--------------+------------+---------------+------------+-------------+-------------+-----------------------------+---------------------+-----------------+--------------------- - sqream | | 102 | 192.168.1.91 | 5000 | t | rhendricks | 192.168.0.1 | 128 | SELECT SHOW_SERVER_STATUS() | 24-12-2019 00:14:53 | Executing | 24-12-2019 00:14:53 + service | instanceid | connection_id | serverip | serverport | database_name | user_name | clientip | statementid | statement | statementstarttime | statementstatus | statementstatusstart + --------+------------+---------------+---------------+------------+---------------+------------------+---------------+-------------+-------------------------------------------------------------------------------------------------------+---------------------+-----------------+--------------------- + sqream | sqream_2 | 19 | 192.168.0.111 | 5000 | master | etl | 192.168.0.011 |2484923 | SELECT t1.account, t1.msisd from table a t1 join table b t2 on t1.id = t2.id where t1.msid='123123'; | 17-01-2022 16:19:31 | Executing | 17-01-2022 16:19:32 + sqream | sqream_1 | 2 | 192.168.1.112 | 5000 | master | etl | 192.168.1.112 |2484924 | select show_server_status(); | 17-01-2022 16:19:39 | Executing | 17-01-2022 16:19:39 + sqream | None | 248 | 192.168.1.112 | 5007 | master | maintenance_user | 192.168.1.112 |2484665 | select * from sqream_catalog.tables; | 17-01-2022 15:55:01 | In Queue | 17-01-2022 15:55:02 The statement ID is ``128``, running on worker ``192.168.1.91``. + +Permissions +============= +The role must have the ``SUPERUSER`` permissions. From 1025d496f917f67922b863891adbb1a8949f85da Mon Sep 17 00:00:00 2001 From: YanivGerowitz <82020437+YanivGerowitz@users.noreply.github.com> Date: Sun, 12 Jun 2022 10:44:51 +0300 Subject: [PATCH 085/882] TPD-67 --- .../client_drivers/jdbc/index.rst | 127 ++++++++++-------- 1 file changed, 68 insertions(+), 59 deletions(-) diff --git a/third_party_tools/client_drivers/jdbc/index.rst b/third_party_tools/client_drivers/jdbc/index.rst index 42a04548f..4c35c3eff 100644 --- a/third_party_tools/client_drivers/jdbc/index.rst +++ b/third_party_tools/client_drivers/jdbc/index.rst @@ -3,160 +3,169 @@ ************************* JDBC ************************* +The SQream JDBC driver lets you connect to SQream using many Java applications and tools. This page describes how to write a Java application using the JDBC interface. The JDBC driver requires Java 1.8 or newer. -The SQream DB JDBC driver allows many Java applications and tools connect to SQream DB. -This tutorial shows how to write a Java application using the JDBC interface. +The JDBC page includes the following sections: -The JDBC driver requires Java 1.8 or newer. - -.. contents:: In this topic: +.. contents:: :local: + :depth: 1 -Installing the JDBC driver +Installing the JDBC Driver ================================== +The **Installing the JDBC Driver** section describes the following: + +.. contents:: + :local: + :depth: 1 Prerequisites ---------------- +The SQream JDBC driver requires Java 1.8 or newer, and SQream recommends using Oracle Java or OpenJDK.: -The SQream DB JDBC driver requires Java 1.8 or newer. We recommend either Oracle Java or OpenJDK. - -**Oracle Java** - -Download and install Java 8 from Oracle for your platform +* **Oracle Java** - Download and install `Java 8 `_ from Oracle for your platform. -https://www.java.com/en/download/manual.jsp - -**OpenJDK** - -For Linux and BSD, see https://openjdk.java.net/install/ - -For Windows, SQream recommends Zulu 8 https://www.azul.com/downloads/zulu-community/?&version=java-8-lts&architecture=x86-64-bit&package=jdk + :: + +* **OpenJDK** - Install `OpenJDK `_ -.. _get_jdbc_jar: + :: + +* **Windows** - SQream recommends installing `Zulu 8 `_ Getting the JAR file --------------------- +SQream provides the JDBC driver as a zipped JAR file, available for download from the :ref:`client drivers download page`. This JAR file can be integrated into your Java-based applications or projects. -The JDBC driver is provided as a zipped JAR file, available for download from the :ref:`client drivers download page`. This JAR file can integrate into your Java-based applications or projects. - - -Extract the zip archive +Extracting the ZIP Archive ------------------------- - -Extract the JAR file from the zip archive +Run the following command to extract the JAR file from the ZIP archive: .. code-block:: console $ unzip sqream-jdbc-4.3.0.zip -Setting up the Class Path +Setting Up the Class Path ---------------------------- +To use the driver, you must include the JAR named ``sqream-jdbc-.jar`` in the class path, either by inserting it in the ``CLASSPATH`` environment variable, or by using flags on the relevant Java command line. -To use the driver, the JAR named ``sqream-jdbc-.jar`` (for example, ``sqream-jdbc-4.3.0.jar``) needs to be included in the class path, either by putting it in the ``CLASSPATH`` environment variable, or by using flags on the relevant Java command line. - -For example, if the JDBC driver has been unzipped to ``/home/sqream/sqream-jdbc-4.3.0.jar``, the application should be run as follows: +For example, if the JDBC driver has been unzipped to ``/home/sqream/sqream-jdbc-4.3.0.jar``, the following command is used to run application: .. code-block:: console $ export CLASSPATH=/home/sqream/sqream-jdbc-4.3.0.jar:$CLASSPATH $ java my_java_app -An alternative method is to pass ``-classpath`` to the Java executable: +Alternatively, you can pass ``-classpath`` to the Java executable file: .. code-block:: console $ java -classpath .:/home/sqream/sqream-jdbc-4.3.0.jar my_java_app - -Connect to SQream DB with a JDBC application +Connecting to SQream Using a JDBC Application ============================================== +You can connect to SQream using one of the following JDBC applications: -Driver class +.. contents:: + :local: + :depth: 1 + +Driver Class -------------- - Use ``com.sqream.jdbc.SQDriver`` as the driver class in the JDBC application. - -.. _connection_string: - -Connection string +Connection String -------------------- +JDBC drivers rely on a connection string. -JDBC drivers rely on a connection string. Use the following syntax for SQream DB +The following is the syntax for SQream: .. code-block:: text jdbc:Sqream:///;user=;password=sqream;[; ...] -Connection parameters +Connection Parameters ^^^^^^^^^^^^^^^^^^^^^^^^ +The following table shows the connection string parameters: .. list-table:: :widths: auto :header-rows: 1 * - Item - - Optional + - State - Default - Description * - ```` - - ✗ + - Mandatory - None - Hostname and port of the SQream DB worker. For example, ``127.0.0.1:5000``, ``sqream.mynetwork.co:3108`` * - ```` - - ✗ + - Mandatory - None - Database name to connect to. For example, ``master`` * - ``username=`` - - ✗ + - Mandatory - None - Username of a role to use for connection. For example, ``username=rhendricks`` * - ``password=`` - - ✗ + - Mandatory - None - Specifies the password of the selected role. For example, ``password=Tr0ub4dor&3`` * - ``service=`` - - ✓ + - Optional - ``sqream`` - Specifices service queue to use. For example, ``service=etl`` * - ```` - - ✓ + - Optional - ``false`` - Specifies SSL for this connection. For example, ``ssl=true`` * - ```` - - ✓ + - Optional - ``true`` - Connect via load balancer (use only if exists, and check port). + * - ```` + - Optional + - ``true`` + - Enables on-demand loading, and defines double buffer size for result. The ``fetchSize`` parameter is rounded according to chunk size. For example, ``fetchSize=1`` loads one row and is rounded to one chunk. If the fetchSize is 100,600, a chunk size of 100,000 loads, and is rounded to, two chunks. + * - ```` + - Optional + - ``true`` + - Defines the bytes size for inserting a buffer before flushing data to the server. Clients running a parameterized insert (network insert) can define the amount of data to collect before flushing the buffer. + * - ```` + - Optional + - ``true`` + - Defines the logger level as either ``debug`` or ``trace``. + * - ```` + - Optional + - ``true`` + - Enables the file appender and defines the file name. The file name can be set as either the file name or the file path. -Connection string examples +Connection String Examples ^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -For a SQream DB cluster with load balancer and no service queues, with SSL +The following is an example of a SQream cluster with load balancer and no service queues (with SSL): .. code-block:: text jdbc:Sqream://sqream.mynetwork.co:3108/master;user=rhendricks;password=Tr0ub4dor&3;ssl=true;cluster=true -Minimal example for a local, standalone SQream DB +The following is a minimal example for a local standalone SQream database: .. code-block:: text jdbc:Sqream://127.0.0.1:5000/master;user=rhendricks;password=Tr0ub4dor&3 -For a SQream DB cluster with load balancer and a specific service queue named ``etl``, to the database named ``raviga`` +The following is an example of a SQream cluster with load balancer and a specific service queue named ``etl``, to the database named ``raviga`` .. code-block:: text jdbc:Sqream://sqream.mynetwork.co:3108/raviga;user=rhendricks;password=Tr0ub4dor&3;cluster=true;service=etl - -Sample Java program +Sample Java Program -------------------- - -Download this file by right clicking and saving to your computer :download:`sample.java `. +You can download the :download:`JDBC Application Sample File ` below by right-clicking and saving it to your computer. .. literalinclude:: sample.java :language: java - :caption: JDBC application sample + :caption: JDBC Application Sample :linenos: - From 3abe6527279c7dfd15a3ce07cdcebc5e2b4bf194 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 23 Jun 2022 11:08:59 +0300 Subject: [PATCH 086/882] Added missing table --- .../ddl_commands/create_table.rst | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/reference/sql/sql_statements/ddl_commands/create_table.rst b/reference/sql/sql_statements/ddl_commands/create_table.rst index 788c71b31..51f46582b 100644 --- a/reference/sql/sql_statements/ddl_commands/create_table.rst +++ b/reference/sql/sql_statements/ddl_commands/create_table.rst @@ -3,7 +3,7 @@ ***************** CREATE TABLE ***************** - + The ``CREATE TABLE`` statement is used to create a new table in an existing database. .. tip:: @@ -62,7 +62,7 @@ The following parameters can be used when creating a table: - A commma separated list of clustering column keys. - See :ref:`data_clustering` for more information. + See :ref:`flexible_data_clustering` for more information. * - ``LIKE`` - Duplicates the column structure of an existing table. @@ -141,7 +141,7 @@ The following is an example of the syntax used to create a standard table: CREATE TABLE cool_animals ( id INT NOT NULL, - name text(30) NOT NULL, + name varchar(30) NOT NULL, weight FLOAT, is_agressive BOOL ); @@ -155,7 +155,7 @@ The following is an example of the syntax used to create a table with default va CREATE TABLE cool_animals ( id INT NOT NULL, - name text(30) NOT NULL, + name varchar(30) NOT NULL, weight FLOAT, is_agressive BOOL DEFAULT false NOT NULL ); @@ -171,8 +171,8 @@ The following is an example of the syntax used to create a table with an identit CREATE TABLE users ( id BIGINT IDENTITY(0,1) NOT NULL , -- Start with 0, increment by 1 - name TEXT(30) NOT NULL, - country TEXT(30) DEFAULT 'Unknown' NOT NULL + name VARCHAR(30) NOT NULL, + country VARCHAR(30) DEFAULT 'Unknown' NOT NULL ); .. note:: @@ -203,9 +203,9 @@ The following is an example of the syntax used to create a table with a clusteri .. code-block:: postgres CREATE TABLE users ( - name TEXT(30) NOT NULL, + name VARCHAR(30) NOT NULL, start_date datetime not null, - country TEXT(30) DEFAULT 'Unknown' NOT NULL + country VARCHAR(30) DEFAULT 'Unknown' NOT NULL ) CLUSTER BY start_date; For more information on data clustering, see :ref:`data_clustering`. @@ -261,9 +261,9 @@ Either of the following examples can be used to create a second table based on t The generated output of both of the statements above is identical. -Creating a Table based on External Tables and Views +Creating a Table based on Foreign Tables and Views ~~~~~~~~~~~~ -The following is example of creating a table based on external tables and views: +The following is example of creating a table based on foreign tables and views: .. code-block:: postgres @@ -272,7 +272,7 @@ The following is example of creating a table based on external tables and views: CREATE TABLE t3 LIKE v; When duplicating the column structure of an existing table, the target table of the ``LIKE`` clause can be a regular or an external table, or a view. - + The following table describes the properties that must be copied from the target table: +-----------------------------+------------------+---------------------------------+---------------------------------+ @@ -293,4 +293,4 @@ The following table describes the properties that must be copied from the target Permissions ============= -The role must have the ``CREATE`` permission at the schema level. +The role must have the ``CREATE`` permission at the schema level. \ No newline at end of file From cadff73cb4b1bd196ba74fffc98c00dda54fdad5 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 23 Jun 2022 11:21:16 +0300 Subject: [PATCH 087/882] Added missing varchar --- reference/sql/sql_syntax/literals.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/reference/sql/sql_syntax/literals.rst b/reference/sql/sql_syntax/literals.rst index d1ec35dbe..906684590 100644 --- a/reference/sql/sql_syntax/literals.rst +++ b/reference/sql/sql_syntax/literals.rst @@ -86,7 +86,7 @@ Examples '1997-01-01' -- This is a string -The actual data type of the value changes based on context, the format used, and the value itself. In the example below, the first value is interpreted as a ``DATE``, while the second is interpreted as a ``TEXT``. +The actual data type of the value changes based on context, the format used, and the value itself. In the example below, the first value is interpreted as a ``DATE``, while the second is interpreted as a ``VARCHAR``. .. code-block:: postgres @@ -239,6 +239,7 @@ The following is a syntax reference for typed literals: | REAL | DATE | DATETIME + | VARCHAR ( digits ) | TEXT ( digits ) Examples From 0c1373094a37eb668559673b03df0c7974132758 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 28 Jun 2022 11:06:27 +0300 Subject: [PATCH 088/882] Update 2022.1.rst Changed 30% to 10%. --- releases/2022.1.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/2022.1.rst b/releases/2022.1.rst index 53c314faf..45479026d 100644 --- a/releases/2022.1.rst +++ b/releases/2022.1.rst @@ -29,7 +29,7 @@ Data Encryption ************ SQream now supports data encryption mechanisms in accordance with **General Data Protection Regulation (GDPR)** standards. -Using the data encryption feature may lead to a maximum of a 30% increase in performance degradation. +Using the data encryption feature may lead to a maximum of a 10% increase in performance degradation. For more information, see `Data Encryption `_. From b456263b75d53f853c33e27592592f2ace13e152 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 30 Jun 2022 16:10:36 +0300 Subject: [PATCH 089/882] Update 2022.1.rst --- releases/2022.1.rst | 28 +++++++++++++++++++++++++++- 1 file changed, 27 insertions(+), 1 deletion(-) diff --git a/releases/2022.1.rst b/releases/2022.1.rst index 45479026d..a98a397f8 100644 --- a/releases/2022.1.rst +++ b/releases/2022.1.rst @@ -74,7 +74,31 @@ No relevant naming changes were made. Deprecated Features ------- -No features were depecrated. +In SQream version 2022.1 the ``VARCHAR`` data type has been deprecated and replaced with ``TEXT``. ``VARCHAR`` will be maintained in all previous versions until migration to ``TEXT`` is complete, at which point it will be deprecated in all earlier versions. + +If you are using an earlier version of SQream, see `Using Legacy String Literals `_. + +An automated process is being used to facilitate migration from ``VARCHAR`` to ``TEXT``. For more information, contact SQream. + +**Comment** - *Below is the original text of the VARCHAR deprecation email. I don't think that we need to necessarily expose our logic to our customers, but focus on certain aspects of it (see the first paragraph above). However, I can use more/all of this content if deemed necessary.* + +* SQream has decided to deprecated support in varchar data type, the decision made out of SQream effort to enhance its core functionalities and with respect to ever changing eco system requirements. + + :: + +* For new customers Varchar data type is not supported + + :: + +* The supported data type that will replace this data type is text as all different functionalities encapsulated within this data type + + :: + +* SQream will maintain varchar data type support until the last customer will be fully migrated + + :: + +* In order to enhance the conversion mechanism to be as fast as possible SQream will provide an automated and secured tool to help customers with the conversion phase from VARCHAR to TEXT data type, please address delivery for further information Known Issues and Limitations -------- @@ -87,6 +111,8 @@ The the list below describes the following known issues and limitations: End of Support ------- +**Comment** - *We need to know what to put here.* + This section is not relevant to the 2022.1 release notes. Upgrading to v2022.1 From 24011e664692d0116fd4875a93a980acc7b30bc0 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 3 Jul 2022 11:10:24 +0300 Subject: [PATCH 090/882] Removed FULL OUTER JOIN https://sqream.atlassian.net/browse/SQ-10996 --- reference/sql/sql_syntax/joins.rst | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/reference/sql/sql_syntax/joins.rst b/reference/sql/sql_syntax/joins.rst index 2563e7a5d..b12b08875 100644 --- a/reference/sql/sql_syntax/joins.rst +++ b/reference/sql/sql_syntax/joins.rst @@ -46,8 +46,8 @@ The following shows the correct syntax for creating an **inner join**: .. code-block:: postgres - left_side [ INNER ] JOIN right_side ON value_expr - left_side [ INNER ] JOIN right_side USING ( join_column [, ... ] ) + left_side [ INNER ] JOIN left_side ON value_expr + left_side [ INNER ] JOIN left_side USING ( join_column [, ... ] ) Inner joins are the default join type and return rows from the ``left_side`` and ``right_side`` based on a matching condition. @@ -60,7 +60,6 @@ An inner join can also be specified by listing several tables in the ``FROM`` cl [ { INNER JOIN | LEFT [OUTER] JOIN | RIGHT [OUTER] JOIN - | FULL [OUTER] JOIN } table2 ON table1.column1 = table2.column1 ] Omitting the ``ON`` or ``WHERE`` clause creates a ``CROSS JOIN``, where every ``left_side`` row is matched with every ``right_side`` row. @@ -117,7 +116,7 @@ The ``CROSS JOIN`` clause cannot have an ``ON`` clause, but the ``WHERE`` clause The following is an example of two tables that will be used as the basis for a cross join: -.. image:: /_static/images/joins/color_table.png +.. image:: /_static/images/color_table.png The following is the output result of the cross join: @@ -323,4 +322,4 @@ The following is an example of using a join hint: --+--- 2 | 2 4 | 4 - 5 | 5 + 5 | 5 \ No newline at end of file From dd2da3b8656204245f2349bf8b832df7547c9638 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 3 Jul 2022 11:22:40 +0300 Subject: [PATCH 091/882] Create color_table.png --- _static/images/color_table.png | Bin 0 -> 5672 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 _static/images/color_table.png diff --git a/_static/images/color_table.png b/_static/images/color_table.png new file mode 100644 index 0000000000000000000000000000000000000000..b815f96167688d7c5b770dc427a358bc6169789a GIT binary patch literal 5672 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 literal 0 HcmV?d00001 From 823c64e552c995b1006ac98af4ba145630fbd03a Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 3 Jul 2022 14:11:33 +0300 Subject: [PATCH 092/882] Updated Tableau Connector Link --- third_party_tools/client_drivers/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/third_party_tools/client_drivers/index.rst b/third_party_tools/client_drivers/index.rst index 91cb94e8f..eebeeb003 100644 --- a/third_party_tools/client_drivers/index.rst +++ b/third_party_tools/client_drivers/index.rst @@ -24,7 +24,7 @@ The following are applicable to all operating systems: * **Tableau**: - * `https://sq-ftp-public.s3.amazonaws.com/SQreamTaco.rar>`_ - SQream (.taco) + * `Tableau connector `_ - SQream (.taco) * `Tableau manual installation `_ From bceda57ad26b51c5bd2731796f5d4eae3456f0f7 Mon Sep 17 00:00:00 2001 From: YanivGerowitz <82020437+YanivGerowitz@users.noreply.github.com> Date: Wed, 6 Jul 2022 11:46:13 +0300 Subject: [PATCH 093/882] Tables: https://sqream.atlassian.net/browse/TPD-208 --- .../sql_statements/dml_commands/copy_to.rst | 376 ++++++++++++++++-- 1 file changed, 345 insertions(+), 31 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/copy_to.rst b/reference/sql/sql_statements/dml_commands/copy_to.rst index 85632904f..bd32a325f 100644 --- a/reference/sql/sql_statements/dml_commands/copy_to.rst +++ b/reference/sql/sql_statements/dml_commands/copy_to.rst @@ -3,20 +3,23 @@ ********************** COPY TO ********************** +The **COPY TO** page includes the following sections: +.. contents:: + :local: + :depth: 1 + +Overview +========== ``COPY ... TO`` is a statement that can be used to export data from a SQream database table or query to a file on the filesystem. In general, ``COPY`` moves data between filesystem files and SQream DB tables. .. note:: To copy data from a file to a table, see :ref:`COPY FROM`. -Permissions -============= - -The role must have the ``SELECT`` permission on every table or schema that is referenced by the statement. - Syntax ========== +The following is the correct syntax for using the **COPY TO** statement: .. code-block:: postgres @@ -29,7 +32,7 @@ Syntax ) ; - fdw_name ::= csw_fdw | parquet_fdw | orc_fdw | avro_fdw + fdw_name ::= csw_fdw | parquet_fdw | orc_fdw schema_name ::= identifer @@ -48,6 +51,11 @@ Syntax | AWS_ID = '{ AWS ID }' | AWS_SECRET = '{ AWS Secret }' + + | MAX_FILE_SIZE = '{ size_in_bytes }' + + | ENFORCE_SINGLE_FILE = { true | false } + delimiter ::= string @@ -57,8 +65,13 @@ Syntax AWS Secret ::= string +.. note:: The DELIMITER is applicable to the CSV format only. + +.. note:: In Studio, you must write the parameters using lower case letters. Using upper case letters generates an error. + Elements ============ +The following table shows the ``COPY_TO`` elements: .. list-table:: :widths: auto @@ -80,41 +93,332 @@ Elements - Specifies the character that separates fields (columns) within each row of the file. The default is a comma character (``,``). * - ``AWS_ID``, ``AWS_SECRET`` - Specifies the authentication details for secured S3 buckets + * - ``MAX_FILE_SIZE`` + - Sets the maximum file size (bytes). Default value: 16*2^20 (16MB). + * - ``ENFORCE_SINGLE_FILE`` + - Enforces the maximum file size (bytes). Permitted values: ``true`` - creates one file of unlimited size, ``false`` - permits creating several files together limited by the ``MAX_FILE_SIZE``. When set to ``true``, the single file size is not limited by the ``MAX_FILE_SIZE`` setting. When set to ``false``, the combined file sizes cannot exceed the ``MAX_FILE_SIZE``. Default value: ``FALSE``. -Usage notes +Usage Notes =============== +The **Usage Notes** describes the following: + +.. contents:: + :local: + :depth: 1 -Supported field delimiters +Supported Field Delimiters ------------------------------ +The **Supported Field Delimiters** section describes the following: -Printable characters -^^^^^^^^^^^^^^^^^^^^^ +.. contents:: + :local: + :depth: 1 +Printable ASCII Characters +^^^^^^^^^^^^^^^^^^^^^ Any printable ASCII character can be used as a delimiter without special syntax. The default CSV field delimiter is a comma (``,``). -A printable character is any ASCII character in the range 32 - 126. - -Non-printable characters +The following table shows the supported printable ASCII characters: + ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| **Character** | **Description** | **ASCII** | **Octal** | **Hex** | **Binary** | **HTML Code** | **HTML Name** | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| (Space) | Space | 32 | 40 | 20 | 100000 | | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ! | Exclamation Mark | 33 | 41 | 21 | 100001 | ! | ! | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| # | Hash or Number | 35 | 43 | 23 | 100011 | # | # | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| $ | Dollar Sign | 36 | 44 | 24 | 100100 | $ | $ | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| % | Percentage | 37 | 45 | 25 | 100101 | % | % | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| & | Ampersand | 38 | 46 | 26 | 100110 | & | & | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ( | Left Parenthesis | 40 | 50 | 28 | 101000 | ( | ( | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ) | Right Parenthesis | 41 | 51 | 29 | 101001 | ) | ) | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| * | Asterisk | 42 | 52 | 2A | 101010 | * | * | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| + | Plus Sign | 43 | 53 | 2B | 101011 | + | + | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| , | Comma | 44 | 54 | 2C | 101100 | , | , | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| / | Slash | 47 | 57 | 2F | 101111 | / | / | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ; | Semicolon | 59 | 73 | 3B | 111011 | ; | ; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| < | Less Than | 60 | 74 | 3C | 111100 | < | < | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| = | Equals Sign | 61 | 75 | 3D | 111101 | = | = | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| > | Greater Than | 62 | 76 | 3E | 111110 | > | > | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ? | Question Mark | 63 | 77 | 3F | 111111 | ? | ? | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| @ | At Sign | 64 | 100 | 40 | 1000000 | @ | @ | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| [ | Left Square Bracket | 91 | 133 | 5B | 1011011 | [ | [ | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| \ | Backslash | 92 | 134 | 5C | 1011100 | \ | \ | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ] | Right Square Bracket | 93 | 135 | 5D | 1011101 | ] | ] | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ^ | Caret or Circumflex | 94 | 136 | 5E | 1011110 | ^ | &hat; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| _ | Underscore | 95 | 137 | 5F | 1011111 | _ | _ | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ` | Grave Accent | 96 | 140 | 60 | 1100000 | ` | ` | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| { | Left Curly Bracket | 123 | 173 | 7B | 1111011 | { | { | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| | | Vertical Bar | 124 | 174 | 7C | 1111100 | | | | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| } | Right Curly Bracket | 125 | 175 | 7D | 1111101 | } | } | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ~ | Tilde | 126 | 176 | 7E | 1111110 | ~ | ˜ | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ + +Non-Printable ASCII Characters ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -A non-printable character (1 - 31, 127) can be used in its octal form. - +The following table shows the supported non-printable ASCII characters: + ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| **Character** | **Description** | **Octal** | **ASCII** | **Hex** | **Binary** | **HTML Code** | **HTML Name** | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| NUL | Null | 0 | 0 | 0 | 0 | � | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| SOH | Start of Heading | 1 | 1 | 1 | 1 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| STX | Start of Text | 2 | 2 | 2 | 10 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ETX | End of Text | 3 | 3 | 3 | 11 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| EOT | End of Transmission | 4 | 4 | 4 | 100 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ENQ | Enquiry | 5 | 5 | 5 | 101 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ACK | Acknowledge | 6 | 6 | 6 | 110 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| BEL | Bell | 7 | 7 | 7 | 111 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| BS | Backspace | 10 | 8 | 8 | 1000 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| HT | Horizontal Tab | 11 | 9 | 9 | 1001 | | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| VT | Vertical Tab | 13 | 11 | 0B | 1011 | | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| FF | NP Form Feed, New Page | 14 | 12 | 0C | 1100 | | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| SO | Shift Out | 16 | 14 | 0E | 1110 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| SI | Shift In | 17 | 15 | 0F | 1111 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| DLE | Data Link Escape | 20 | 16 | 10 | 10000 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| DC1 | Device Control 1 | 21 | 17 | 11 | 10001 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| DC2 | Device Control 2 | 22 | 18 | 12 | 10010 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| DC3 | Device Control 3 | 23 | 19 | 13 | 10011 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| DC4 | Device Control 4 | 24 | 20 | 14 | 10100 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| NAK | Negative Acknowledge | 25 | 21 | 15 | 10101 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| SYN | Synchronous Idle | 26 | 22 | 16 | 10110 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ETB | End of Transmission Block | 27 | 23 | 17 | 10111 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| CAN | Cancel | 30 | 24 | 18 | 11000 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| EM | End of Medium | 31 | 25 | 19 | 11001 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| SUB | Substitute | 32 | 26 | 1A | 11010 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ESC | Escape | 33 | 27 | 1B | 11011 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| FS | File Separator | 34 | 28 | 1C | 11100 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| GS | Group Separator | 35 | 29 | 1D | 11101 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| RS | Record Separator | 36 | 30 | 1E | 11110 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| US | Unit Separator | 37 | 31 | 1F | 11111 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| DEL | Delete | 177 | 127 | 7F | 1111111 |  | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ + A tab can be specified by escaping it, for example ``\t``. Other non-printable characters can be specified using their octal representations, by using the ``E'\000'`` format, where ``000`` is the octal value of the character. For example, ASCII character ``15``, known as "shift in", can be specified using ``E'\017'``. +.. note:: Delimiters are only applicable to the CSV file format. -Date format +Unsupported ASCII Field Delimiters +------------------------------ +The following table shows the unsupported ASCII field delimiters: + ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| **ASCII** | **Character** | **Description** | **Octal** | **Hex** | **Binary** | **HTML Code** | **HTML Name** | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 10 | LF | NL Line Feed, New Line | 12 | 0A | 1010 | | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 13 | CR | Carriage Return | 15 | 0D | 1101 | | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 34 | " | Double Quote | 42 | 22 | 100010 | " | " | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 39 | ' | Single Quote | 47 | 27 | 100111 | ' | ' | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 45 | - | Minus Sign | 55 | 2D | 101101 | - | − | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 46 | . | Period | 56 | 2E | 101110 | . | . | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 48 | 0 | Zero | 60 | 30 | 110000 | 0 | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 49 | 1 | Number One | 61 | 31 | 110001 | 1 | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 50 | 2 | Number Two | 62 | 32 | 110010 | 2 | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 51 | 3 | Number Three | 63 | 33 | 110011 | 3 | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 52 | 4 | Number Four | 64 | 34 | 110100 | 4 | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 53 | 5 | Number Five | 65 | 35 | 110101 | 5 | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 54 | 6 | Number Six | 66 | 36 | 110110 | 6 | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 55 | 7 | Number Seven | 67 | 37 | 110111 | 7 | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 56 | 8 | Number Eight | 70 | 38 | 111000 | 8 | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 57 | 9 | Number Nine | 71 | 39 | 111001 | 9 | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 58 | : | Colon | 72 | 3A | 111010 | : | : | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 65 | A | Upper Case Letter A | 101 | 41 | 1000001 | A | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 66 | B | Upper Case Letter B | 102 | 42 | 1000010 | B | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 67 | C | Upper Case Letter C | 103 | 43 | 1000011 | C | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 68 | D | Upper Case Letter D | 104 | 44 | 1000100 | D | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 69 | E | Upper Case Letter E | 105 | 45 | 1000101 | E | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 70 | F | Upper Case Letter F | 106 | 46 | 1000110 | F | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 71 | G | Upper Case Letter G | 107 | 47 | 1000111 | G | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 72 | H | Upper Case Letter H | 110 | 48 | 1001000 | H | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 73 | I | Upper Case Letter I | 111 | 49 | 1001001 | I | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 74 | J | Upper Case Letter J | 112 | 4A | 1001010 | J | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 75 | K | Upper Case Letter K | 113 | 4B | 1001011 | K | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 76 | L | Upper Case Letter L | 114 | 4C | 1001100 | L | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 77 | M | Upper Case Letter M | 115 | 4D | 1001101 | M | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 78 | N | Upper Case Letter N | 116 | 4E | 1001110 | N | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 79 | O | Upper Case Letter O | 117 | 4F | 1001111 | O | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 80 | P | Upper Case Letter P | 120 | 50 | 1010000 | P | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 81 | Q | Upper Case Letter Q | 121 | 51 | 1010001 | Q | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 82 | R | Upper Case Letter R | 122 | 52 | 1010010 | R | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 83 | S | Upper Case Letter S | 123 | 53 | 1010011 | S | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 84 | T | Upper Case Letter T | 124 | 54 | 1010100 | T | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 85 | U | Upper Case Letter U | 125 | 55 | 1010101 | U | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 86 | V | Upper Case Letter V | 126 | 56 | 1010110 | V | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 87 | W | Upper Case Letter W | 127 | 57 | 1010111 | W | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 88 | X | Upper Case Letter X | 130 | 58 | 1011000 | X | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 89 | Y | Upper Case Letter Y | 131 | 59 | 1011001 | Y | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 90 | Z | Upper Case Letter Z | 132 | 5A | 1011010 | Z | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 97 | a | Lower Case Letter a | 141 | 61 | 1100001 | a | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 98 | b | Lower Case Letter b | 142 | 62 | 1100010 | b | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 99 | c | Lower Case Letter c | 143 | 63 | 1100011 | c | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 100 | d | Lower Case Letter d | 144 | 64 | 1100100 | d | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 101 | e | Lower Case Letter e | 145 | 65 | 1100101 | e | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 102 | f | Lower Case Letter f | 146 | 66 | 1100110 | f | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 103 | g | Lower Case Letter g | 147 | 67 | 1100111 | g | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 104 | h | Lower Case Letter h | 150 | 68 | 1101000 | h | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 105 | i | Lower Case Letter i | 151 | 69 | 1101001 | i | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 106 | j | Lower Case Letter j | 152 | 6A | 1101010 | j | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 107 | k | Lower Case Letter k | 153 | 6B | 1101011 | k | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 108 | l | Lower Case Letter l | 154 | 6C | 1101100 | l | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 109 | m | Lower Case Letter m | 155 | 6D | 1101101 | m | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 110 | n | Lower Case Letter n | 156 | 6E | 1101110 | n | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 111 | o | Lower Case Letter o | 157 | 6F | 1101111 | o | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 112 | p | Lower Case Letter p | 160 | 70 | 1110000 | p | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 113 | q | Lower Case Letter q | 161 | 71 | 1110001 | q | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 114 | r | Lower Case Letter r | 162 | 72 | 1110010 | r | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 115 | s | Lower Case Letter s | 163 | 73 | 1110011 | s | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 116 | t | Lower Case Letter t | 164 | 74 | 1110100 | t | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 117 | u | Lower Case Letter u | 165 | 75 | 1110101 | u | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 118 | v | Lower Case Letter v | 166 | 76 | 1110110 | v | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 119 | w | Lower Case Letter w | 167 | 77 | 1110111 | w | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 120 | x | Lower Case Letter x | 170 | 78 | 1111000 | x | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 121 | y | Lower Case Letter y | 171 | 79 | 1111001 | y | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 122 | z | Lower Case Letter z | 172 | 7A | 1111010 | z | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ + +Date Format --------------- - The date format in the output CSV is formatted as ISO 8601 (``2019-12-31 20:30:55.123``), regardless of how it was parsed initially with :ref:`COPY FROM date parsers`. +For more information on the ``datetime`` format, see :ref:`sql_data_types_date`. Examples =========== +The **Examples** section shows the following examples: + +.. contents:: + :local: + :depth: 1 -Export table to a CSV without HEADER +Exporting a Table to a CSV File without a HEADER Row ------------------------------------ +The following is an example of exporting a table to a CSV file without a HEADER row: .. code-block:: psql @@ -130,8 +434,9 @@ Export table to a CSV without HEADER Jonas Jerebko,Boston Celtics,8,PF,29,6-10,231,\N,5000000 Amir Johnson,Boston Celtics,90,PF,29,6-9,240,\N,12000000 -Export table to a CSV with a HEADER row +Exporting a Table to a CSV with a HEADER Row ----------------------------------------- +The following is an example of exporting a table to a CSV file with a HEADER row: .. code-block:: psql @@ -147,8 +452,9 @@ Export table to a CSV with a HEADER row R.J. Hunter,Boston Celtics,28,SG,22,6-5,185,Georgia State,1148640 Jonas Jerebko,Boston Celtics,8,PF,29,6-10,231,\N,5000000 -Export table to a TSV with a header row +Exporting a Table to TSV with a HEADER Row ----------------------------------------- +The following is an example of exporting a table to a TSV file with a HEADER row: .. code-block:: psql @@ -164,8 +470,9 @@ Export table to a TSV with a header row R.J. Hunter Boston Celtics 28 SG 22 6-5 185 Georgia State 1148640 Jonas Jerebko Boston Celtics 8 PF 29 6-10 231 \N 5000000 -Use non-printable ASCII characters as delimiter +Using Non-Printable ASCII Characters as Delimiters ------------------------------------------------------- +The following is an example of using non-printable ASCII characters as delimiters: Non-printable characters can be specified using their octal representations, by using the ``E'\000'`` format, where ``000`` is the octal value of the character. @@ -179,8 +486,9 @@ For example, ASCII character ``15``, known as "shift in", can be specified using COPY nba TO WRAPPER csv_fdw OPTIONS (LOCATION = '/tmp/nba_export.csv', DELIMITER = E'\011'); -- 011 is a tab character -Exporting the result of a query to a CSV +Exporting the Result of a Query to CSV File -------------------------------------------- +The following is an example of exporting the result of a query to a CSV file: .. code-block:: psql @@ -195,40 +503,46 @@ Exporting the result of a query to a CSV Charlotte Hornets,5222728 Chicago Bulls,5785558 -Saving files to an authenticated S3 bucket +Saving Files to an Authenticated S3 Bucket -------------------------------------------- +The following is an example of saving files to an authenticated S3 bucket: .. code-block:: psql COPY (SELECT "Team", AVG("Salary") FROM nba GROUP BY 1) TO WRAPPER csv_fdw OPTIONS (LOCATION = 's3://my_bucket/salaries/nba_export.csv', AWS_ID = 'my_aws_id', AWS_SECRET = 'my_aws_secret'); -Saving files to an HDFS path +Saving Files to an HDFS Path -------------------------------------------- +The following is an example of saving files to an HDFS path: .. code-block:: psql COPY (SELECT "Team", AVG("Salary") FROM nba GROUP BY 1) TO WRAPPER csv_fdw OPTIONS (LOCATION = 'hdfs://pp_namenode:8020/nba_export.csv'); - -Export table to a parquet file +Exporting a Table to a Parquet File ------------------------------ +The following is an example of exporting a table to a Parquet file: .. code-block:: psql COPY nba TO WRAPPER parquet_fdw OPTIONS (LOCATION = '/tmp/nba_export.parquet'); - -Export a query to a parquet file +Exporting a Query to a Parquet File -------------------------------- +The following is an example of exporting a query to a Parquet file: .. code-block:: psql COPY (select x,y from t where z=0) TO WRAPPER parquet_fdw OPTIONS (LOCATION = '/tmp/file.parquet'); - -Export table to a ORC file +Exporting a Table to an ORC File ------------------------------ +The following is an example of exporting a table to an ORC file: .. code-block:: psql COPY nba TO WRAPPER orc_fdw OPTIONS (LOCATION = '/tmp/nba_export.orc'); + +Permissions +============= +The role must have the ``SELECT`` permission on every table or schema that is referenced by the statement. From 315d0c7895a5a3d03da00c9a133e0a1de35d82c6 Mon Sep 17 00:00:00 2001 From: YanivGerowitz <82020437+YanivGerowitz@users.noreply.github.com> Date: Wed, 6 Jul 2022 16:04:20 +0300 Subject: [PATCH 094/882] Updated with Slavi --- operational_guides/hardware_guide.rst | 83 +++++++++++++++++++++------ 1 file changed, 65 insertions(+), 18 deletions(-) diff --git a/operational_guides/hardware_guide.rst b/operational_guides/hardware_guide.rst index d66797223..571d6a6a3 100644 --- a/operational_guides/hardware_guide.rst +++ b/operational_guides/hardware_guide.rst @@ -3,9 +3,7 @@ *********************** Hardware Guide *********************** - -This guide describes the SQream reference architecture, emphasizing the benefits to the technical audience, and provides guidance for end-users on selecting the right configuration for a SQream installation. - +The **Hardware Guide** describes the SQream reference architecture, emphasizing the benefits to the technical audience, and provides guidance for end-users on selecting the right configuration for a SQream installation. .. rubric:: Need help? @@ -15,20 +13,22 @@ Visit `SQream's support portal Date: Wed, 6 Jul 2022 16:19:35 +0300 Subject: [PATCH 095/882] Update hardware_guide.rst From 8127a478798529ae4ae830ecf2f272dedb4fb1a9 Mon Sep 17 00:00:00 2001 From: YanivGerowitz <82020437+YanivGerowitz@users.noreply.github.com> Date: Wed, 6 Jul 2022 16:23:57 +0300 Subject: [PATCH 096/882] Update hardware_guide.rst --- operational_guides/hardware_guide.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/operational_guides/hardware_guide.rst b/operational_guides/hardware_guide.rst index 571d6a6a3..252b71fc2 100644 --- a/operational_guides/hardware_guide.rst +++ b/operational_guides/hardware_guide.rst @@ -78,7 +78,7 @@ The following table shows SQream's recommended hardware specifications: .. list-table:: :widths: 15 65 - :header-rows: 2 + :header-rows: 1 * - Component - Type From 9eb8a69c627052e3d887030fbd173a8b2dbed647 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Wed, 6 Jul 2022 17:08:18 +0300 Subject: [PATCH 097/882] https://sqream.atlassian.net/browse/TPD-168 --- operational_guides/external_data.rst | 15 +- operational_guides/hdfs.rst | 252 +++++++++++++++++++++++++++ operational_guides/s3.rst | 26 +-- 3 files changed, 272 insertions(+), 21 deletions(-) create mode 100644 operational_guides/hdfs.rst diff --git a/operational_guides/external_data.rst b/operational_guides/external_data.rst index 576e50ea4..8bf51f108 100644 --- a/operational_guides/external_data.rst +++ b/operational_guides/external_data.rst @@ -3,12 +3,23 @@ ********************************** Working with External Data ********************************** - -SQream DB supports external data sources for use with :ref:`external_tables`, :ref:`copy_from`, and :ref:`copy_to`. +SQream supports the following external data sources: .. toctree:: :maxdepth: 1 :titlesonly: s3 + hdfs + +For more information, see the following: + +* :ref:`external_tables` + + :: + +* :ref:`copy_from` + + :: +* :ref:`copy_to` \ No newline at end of file diff --git a/operational_guides/hdfs.rst b/operational_guides/hdfs.rst new file mode 100644 index 000000000..a6ffe0ead --- /dev/null +++ b/operational_guides/hdfs.rst @@ -0,0 +1,252 @@ +.. _hdfs: + +.. _back_to_top_hdfs: + +Using SQream in an HDFS Environment +======================================= + +.. _configuring_an_hdfs_environment_for_the_user_sqream: + +Configuring an HDFS Environment for the User **sqream** +---------------------------------------------------------- + +This section describes how to configure an HDFS environment for the user **sqream** and is only relevant for users with an HDFS environment. + +**To configure an HDFS environment for the user sqream:** + +1. Open your **bash_profile** configuration file for editing: + + .. code-block:: console + + $ vim /home/sqream/.bash_profile + +.. + Comment: - see below; do we want to be a bit more specific on what changes we're talking about? + + .. code-block:: console + + $ #PATH=$PATH:$HOME/.local/bin:$HOME/bin + + $ #export PATH + + $ # PS1 + $ #MYIP=$(curl -s -XGET "http://ip-api.com/json" | python -c 'import json,sys; jstr=json.load(sys.stdin); print jstr["query"]') + $ #PS1="\[\e[01;32m\]\D{%F %T} \[\e[01;33m\]\u@\[\e[01;36m\]$MYIP \[\e[01;31m\]\w\[\e[37;36m\]\$ \[\e[1;37m\]" + + $ SQREAM_HOME=/usr/local/sqream + $ export SQREAM_HOME + + $ export JAVA_HOME=${SQREAM_HOME}/hdfs/jdk + $ export HADOOP_INSTALL=${SQREAM_HOME}/hdfs/hadoop + $ export CLASSPATH=`${HADOOP_INSTALL}/bin/hadoop classpath --glob` + $ export HADOOP_COMMON_LIB_NATIVE_DIR=${HADOOP_INSTALL}/lib/native + $ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${SQREAM_HOME}/lib:$HADOOP_COMMON_LIB_NATIVE_DIR + + + $ PATH=$PATH:$HOME/.local/bin:$HOME/bin:${SQREAM_HOME}/bin/:${JAVA_HOME}/bin:$HADOOP_INSTALL/bin + $ export PATH + +2. Verify that the edits have been made: + + .. code-block:: console + + source /home/sqream/.bash_profile + +3. Check if you can access Hadoop from your machine: + + .. code-block:: console + + $ hadoop fs -ls hdfs://:8020/ + +.. + Comment: - + **NOTICE:** If you cannot access Hadoop from your machine because it uses Kerberos, see `Connecting a SQream Server to Cloudera Hadoop with Kerberos `_ + + +4. Verify that an HDFS environment exists for SQream services: + + .. code-block:: console + + $ ls -l /etc/sqream/sqream_env.sh + +.. _step_6: + + +5. If an HDFS environment does not exist for SQream services, create one (sqream_env.sh): + + .. code-block:: console + + $ #!/bin/bash + + $ SQREAM_HOME=/usr/local/sqream + $ export SQREAM_HOME + + $ export JAVA_HOME=${SQREAM_HOME}/hdfs/jdk + $ export HADOOP_INSTALL=${SQREAM_HOME}/hdfs/hadoop + $ export CLASSPATH=`${HADOOP_INSTALL}/bin/hadoop classpath --glob` + $ export HADOOP_COMMON_LIB_NATIVE_DIR=${HADOOP_INSTALL}/lib/native + $ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${SQREAM_HOME}/lib:$HADOOP_COMMON_LIB_NATIVE_DIR + + + $ PATH=$PATH:$HOME/.local/bin:$HOME/bin:${SQREAM_HOME}/bin/:${JAVA_HOME}/bin:$HADOOP_INSTALL/bin + $ export PATH + +:ref:`Back to top ` + + +.. _authenticate_hadoop_servers_that_require_kerberos: + +Authenticating Hadoop Servers that Require Kerberos +--------------------------------------------------- + +If your Hadoop server requires Kerberos authentication, do the following: + +1. Create a principal for the user **sqream**. + + .. code-block:: console + + $ kadmin -p root/admin@SQ.COM + $ addprinc sqream@SQ.COM + +2. If you do not know yor Kerberos root credentials, connect to the Kerberos server as a root user with ssh and run **kadmin.local**: + + .. code-block:: console + + $ kadmin.local + + Running **kadmin.local** does not require a password. + +3. If a password is not required, change your password to **sqream@SQ.COM**. + + .. code-block:: console + + $ change_password sqream@SQ.COM + +4. Connect to the hadoop name node using ssh: + + .. code-block:: console + + $ cd /var/run/cloudera-scm-agent/process + +5. Check the most recently modified content of the directory above: + + .. code-block:: console + + $ ls -lrt + +6. Look for a recently updated folder containing the text **hdfs**. + +The following is an example of the correct folder name: + + .. code-block:: console + + cd -hdfs- + + This folder should contain a file named **hdfs.keytab** or another similar .keytab file. + + + +.. + Comment: - Does "something" need to be replaced with "file name" + + +7. Copy the .keytab file to user **sqream's** Home directory on the remote machines that you are planning to use Hadoop on. + +8. Copy the following files to the **sqream sqream@server:/hdfs/hadoop/etc/hadoop:** directory: + + * core-site.xml + * hdfs-site.xml + +9. Connect to the sqream server and verify that the .keytab file's owner is a user sqream and is granted the correct permissions: + + .. code-block:: console + + $ sudo chown sqream:sqream /home/sqream/hdfs.keytab + $ sudo chmod 600 /home/sqream/hdfs.keytab + +10. Log into the sqream server. + +11. Log in as the user **sqream**. + +12. Navigate to the Home directory and check the name of a Kerberos principal represented by the following .keytab file: + + .. code-block:: console + + $ klist -kt hdfs.keytab + + The following is an example of the correct output: + + .. code-block:: console + + $ sqream@Host-121 ~ $ klist -kt hdfs.keytab + $ Keytab name: FILE:hdfs.keytab + $ KVNO Timestamp Principal + $ ---- ------------------- ------------------------------------------------------ + $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + +13. Verify that the hdfs service named **hdfs/nn1@SQ.COM** is shown in the generated output above. + +14. Run the following: + + .. code-block:: console + + $ kinit -kt hdfs.keytab hdfs/nn1@SQ.COM + +15. Check the output: + + .. code-block:: console + + $ klist + + The following is an example of the correct output: + + .. code-block:: console + + $ Ticket cache: FILE:/tmp/krb5cc_1000 + $ Default principal: sqream@SQ.COM + $ + $ Valid starting Expires Service principal + $ 09/16/2020 13:44:18 09/17/2020 13:44:18 krbtgt/SQ.COM@SQ.COM + +16. List the files located at the defined server name or IP address: + + .. code-block:: console + + $ hadoop fs -ls hdfs://:8020/ + +17. Do one of the following: + + * If the list below is output, continue with Step 16. + * If the list is not output, verify that your environment has been set up correctly. + +If any of the following are empty, verify that you followed :ref:`Step 6 ` in the **Configuring an HDFS Environment for the User sqream** section above correctly: + + .. code-block:: console + + $ echo $JAVA_HOME + $ echo $SQREAM_HOME + $ echo $CLASSPATH + $ echo $HADOOP_COMMON_LIB_NATIVE_DIR + $ echo $LD_LIBRARY_PATH + $ echo $PATH + +18. Verify that you copied the correct keytab file. + +19. Review this procedure to verify that you have followed each step. + +:ref:`Back to top ` \ No newline at end of file diff --git a/operational_guides/s3.rst b/operational_guides/s3.rst index 699f35401..f8bb2dab6 100644 --- a/operational_guides/s3.rst +++ b/operational_guides/s3.rst @@ -1,9 +1,8 @@ .. _s3: *********************** -Amazon S3 +Inserting Data Using Amazon S3 *********************** - SQream uses a native S3 connector for inserting data. The ``s3://`` URI specifies an external file path on an S3 bucket. File names may contain wildcard characters, and the files can be in CSV or columnar format, such as Parquet and ORC. The **Amazon S3** describes the following topics: @@ -13,12 +12,10 @@ The **Amazon S3** describes the following topics: S3 Configuration ============================== - Any database host with access to S3 endpoints can access S3 without any configuration. To read files from an S3 bucket, the database must have listable files. S3 URI Format =============== - With S3, specify a location for a file (or files) when using :ref:`copy_from` or :ref:`external_tables`. The following is an example of the general S3 syntax: @@ -29,12 +26,10 @@ The following is an example of the general S3 syntax: Authentication ================= - SQream supports ``AWS ID`` and ``AWS SECRET`` authentication. These should be specified when executing a statement. Examples ========== - Use a foreign table to stage data from S3 before loading from CSV, Parquet, or ORC files. The **Examples** section includes the following examples: @@ -42,12 +37,8 @@ The **Examples** section includes the following examples: .. contents:: :local: :depth: 1 - - - Planning for Data Staging -------------------------------- - The examples in this section are based on a CSV file, as shown in the following table: .. csv-table:: nba.csv @@ -59,21 +50,20 @@ The file is stored on Amazon S3, and this bucket is public and listable. To crea Creating a Foreign Table ----------------------------- - Based on the source file's structure, you can create a foreign table with the appropriate structure, and point it to your file as shown in the following example: .. code-block:: postgres CREATE FOREIGN TABLE nba ( - Name text(40), - Team text(40), + Name varchar(40), + Team varchar(40), Number tinyint, - Position text(2), + Position varchar(2), Age tinyint, - Height text(4), + Height varchar(4), Weight real, - College text(40), + College varchar(40), Salary float ) WRAPPER csv_fdw @@ -93,7 +83,6 @@ For more information, see the following: Querying Foreign Tables ------------------------------ - The following shows the data in the foreign table: .. code-block:: psql @@ -114,7 +103,6 @@ The following shows the data in the foreign table: Bulk Loading a File from a Public S3 Bucket ---------------------------------------------- - The ``COPY FROM`` command can also be used to load data without staging it first. .. note:: The bucket must be publicly available and objects can be listed. @@ -135,4 +123,4 @@ The following is an example of loading fles from an authenticated S3 bucket: COPY nba FROM 's3://secret-bucket/*.csv' WITH OFFSET 2 RECORD DELIMITER '\r\n' AWS_ID '12345678' - AWS_SECRET 'super_secretive_secret'; + AWS_SECRET 'super_secretive_secret'; \ No newline at end of file From 2b2b6b90a15652d1625f7a19d4a2765ad5bc588d Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Wed, 6 Jul 2022 17:23:22 +0300 Subject: [PATCH 098/882] TPD-221 --- operational_guides/hardware_guide.rst | 23 +---------------------- 1 file changed, 1 insertion(+), 22 deletions(-) diff --git a/operational_guides/hardware_guide.rst b/operational_guides/hardware_guide.rst index 252b71fc2..5337db9cd 100644 --- a/operational_guides/hardware_guide.rst +++ b/operational_guides/hardware_guide.rst @@ -126,27 +126,6 @@ The following table shows SQream's recommended metadata server specifications: * - Operating System - Red Hat Enterprise Linux v7.x or CentOS v7.x or Amazon Linux -Web User Interface Specifications -~~~~~~~~~~~~~~~~~~~~~~~~~ -The following table shows SQream's recommended web user interface server specifications: - -.. list-table:: - :widths: 15 90 - :header-rows: 1 - - * - Component - - Type - * - Processors - - One Intel i7 16C processor or similar - * - RAM - - 64 GB DDR4 RAM 2x32 GB RDIMM or similar - * - Discs - - 256 GB SATA 6Gb SSD drive or similar - * - Network Card (Corporate) - - Two 1 GbE cards or similar - * - Operating System - - Red Hat Enterprise Linux v7.x or CentOS v7.x or Amazon Linux - .. note:: With a NAS connected over GPFS, Lustre, or NFS, each SQream worker can read data at up to 5GB/s. SQream Studio Server Example @@ -246,4 +225,4 @@ For clustered scale-out installations, SQream relies on NAS/SAN storage. For sta SQream recommends using enterprise-grade SAS SSD or NVMe drives. For a 32-user configuration, the number of GPUs should roughly match the number of users. SQream recommends 1 Tesla V100 or A100 GPU per 2 users, for full, uninterrupted dedicated access. -Download the full `SQream Reference Architecture `_ document. +Download the full `SQream Reference Architecture `_ document. \ No newline at end of file From 3e5001a32c650f5189080787903707661cc7f10f Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Wed, 6 Jul 2022 18:26:42 +0300 Subject: [PATCH 099/882] Update index.rst --- third_party_tools/client_drivers/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/third_party_tools/client_drivers/index.rst b/third_party_tools/client_drivers/index.rst index eebeeb003..d0c60d804 100644 --- a/third_party_tools/client_drivers/index.rst +++ b/third_party_tools/client_drivers/index.rst @@ -1,7 +1,7 @@ .. _client_drivers: ************************************ -Client Drivers for |latest_version| +Client Drivers for 2022.1 ************************************ The guides on this page describe how to use the Sqream DB client drivers and client applications with SQream. From 711ae8192c2def0e86346b295e1eeb75916e7db2 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 7 Jul 2022 15:43:23 +0300 Subject: [PATCH 100/882] Updated the following: Delete Guide: improvements SQL Statements > Index: improved tables SQL Statements: created get_extents_file_list_for_chunk page (in review) SQL Statements: created get_metadata_chunk_key page (in review) --- operational_guides/delete_guide.rst | 272 +++++++++++------- reference/sql/sql_statements/index.rst | 84 +++--- .../get_extents_file_list_for_chunk.rst | 60 ++++ .../get_metadata_chunk_key.rst | 59 ++++ 4 files changed, 325 insertions(+), 150 deletions(-) create mode 100644 reference/sql/sql_statements/utility_commands/get_extents_file_list_for_chunk.rst create mode 100644 reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst diff --git a/operational_guides/delete_guide.rst b/operational_guides/delete_guide.rst index 24ab5a218..c24079f8c 100644 --- a/operational_guides/delete_guide.rst +++ b/operational_guides/delete_guide.rst @@ -3,144 +3,183 @@ *********************** Deleting Data *********************** +The **Deleting Data** page describes how the **Delete** statement works and how to maintain data that you delete: -SQream DB supports deleting data, but it's important to understand how this works and how to maintain deleted data. +.. contents:: + :local: + :depth: 1 -How does deleting in SQream DB work? +Overview ======================================== +Deleting data typically refers to deleting rows, but can refer to deleting other table content as well. The general workflow for deleting data is to delete data followed by triggering a cleanup operation. The cleanup operation reclaims the space occupied by the deleted rows, discussed further below. -In SQream DB, when you run a delete statement, any rows that match the delete predicate will no longer be returned when running subsequent queries. -Deleted rows are tracked in a separate location, in *delete predicates*. +The **DELETE** statement deletes rows defined by a predicate that you have specified, preventing them from appearing in subsequent queries. -After the delete statement, a separate process can be used to reclaim the space occupied by these rows, and to remove the small overhead that queries will have until this is done. +For example, the predicate below defines and deletes rows containing animals heavier than 1000 weight units: -Some benefits to this design are: - -#. Delete transactions complete quickly +.. code-block:: psql -#. The total disk footprint overhead at any time for a delete transaction or cleanup process is small and bounded (while the system still supports low overhead commit, rollback and recovery for delete transactions). + farm=> DELETE FROM cool_animals WHERE weight > 1000; +The major benefit of the DELETE statement is that it deletes transactions simply and quickly. -Phase 1: Delete ---------------------------- +The Deletion Process +========== +Deleting rows occurs in the following two phases: -.. TODO: isn't the delete cleanup able to complete a certain amount of work transactionally, so that you can do a massive cleanup in stages? +* **Phase 1 - Deletion** - All rows you mark for deletion are ignored when you run any query. These rows are not deleted until the clean-up phase. -.. TODO: our current best practices is to use a cron job with sqream sql to run the delete cleanup. we should document how to do this, we have customers with very different delete schedules so we can give a few extreme examples and when/why you'd use them + :: -When a :ref:`delete` statement is run, SQream DB records the delete predicates used. These predicates will be used to filter future statements on this table until all this delete predicate's matching rows have been physically cleaned up. +* **Phase 2 - Clean-up** - The rows you marked for deletion in Phase 1 are physically deleted. The clean-up phase is not automated, letting users or DBAs control when to activate it. The files you marked for deletion during Phase 1 are removed from disk, which you do by by sequentially running the utility function commands ``CLEANUP_CHUNKS`` and ``CLEANUP_EXTENTS``. -This filtering process takes full advantage of SQream's zone map feature. +.. TODO: isn't the delete cleanup able to complete a certain amount of work transactionally, so that you can do a massive cleanup in stages? -Phase 2: Clean-up --------------------- +.. TODO: our current best practices is to use a cron job with sqream sql to run the delete cleanup. we should document how to do this, we have customers with very different delete schedules so we can give a few extreme examples and when/why you'd use them. -The cleanup process is not automatic. This gives control to the user or DBA, and gives flexibility on when to run the clean up. +Usage Notes +===================== +The **Usage Notes** section includes important information about the DELETE statement: -Files marked for deletion during the logical deletion stage are removed from disk. This is achieved by calling both utility function commands: ``CLEANUP_CHUNKS`` and ``CLEANUP_EXTENTS`` sequentially. +.. contents:: + :local: + :depth: 1 + +General Notes +---------------- +This section describes the general notes applicable when deleting rows: -.. note:: - * :ref:`alter_table` and other DDL operations are blocked on tables that require clean-up. See more in the :ref:`concurrency_and_locks` guide. - * If the estimated time for a cleanup processs is beyond a threshold, you will get an error message about it. The message will explain how to override this limitation and run the process anywhere. +* The :ref:`alter_table` command and other DDL operations are locked on tables that require clean-up. If the estimated clean-up time exceeds the permitted threshold, an error message is displayed describing how to override the threshold limitation. For more information, see :ref:`concurrency_and_locks`. -Notes on data deletion -========================================= + :: -.. note:: - * If the number of deleted records crosses the threshold defined by the ``mixedColumnChunksThreshold`` parameter, the delete operation will be aborted. - * This is intended to alert the user that the large number of deleted records may result in a large number of mixed chuncks. - * To circumvent this alert, replace XXX with the desired number of records before running the delete operation: +* If the number of deleted records exceeds the threshold defined by the ``mixedColumnChunksThreshold`` parameter, the delete operation is aborted. This alerts users that the large number of deleted records may result in a large number of mixed chunks. To circumvent this alert, use the following syntax (replacing ``XXX`` with the desired number of records) before running the delete operation: -.. code-block:: postgres + .. code-block:: postgres - set mixedColumnChunksThreshold=XXX; + set mixedColumnChunksThreshold=XXX; - -Deleting data does not free up space +Deleting Data does not Free Space ----------------------------------------- +With the exception of running a full table delete, deleting data does not free unused disk space. To free unused disk space you must trigger the clean-up process. -With the exception of a full table delete (:ref:`TRUNCATE`), deleting data does not free up disk space. To free up disk space, trigger the cleanup process. - -``SELECT`` performance on deleted rows ----------------------------------------- - -Queries on tables that have deleted rows may have to scan data that hasn't been cleaned up. -In some cases, this can cause queries to take longer than expected. To solve this issue, trigger the cleanup process. +For more information on running a full table delete, see :ref:`TRUNCATE`. -Use ``TRUNCATE`` instead of ``DELETE`` ---------------------------------------- -For tables that are frequently emptied entirely, consider using :ref:`truncate` rather than :ref:`delete`. TRUNCATE removes the entire content of the table immediately, without requiring a subsequent cleanup to free up disk space. + :: + +For more information on freeing disk space, see :ref:`Triggering a Clean-Up`. -Cleanup is I/O intensive +Clean-Up Operations Are I/O Intensive ------------------------------- +The clean-up process reduces table size by removing all unused space from column chunks. While this reduces query time, it is a time-costly operation occupying disk space for the new copy of the table until the operation is complete. -The cleanup process actively compacts tables by writing a complete new version of column chunks with no dead space. This minimizes the size of the table, but can take a long time. It also requires extra disk space for the new copy of the table, until the operation completes. - -Cleanup operations can create significant I/O load on the database. Consider this when planning the best time for the cleanup process. +.. tip:: Because clean-up operations can create significant I/O load on your database, consider using them sparingly during ideal times. If this is an issue with your environment, consider using ``CREATE TABLE AS`` to create a new table and then rename and drop the old table. - -Example +Examples ============= +The **Examples** section includes the following examples: -Deleting values from a table +.. contents:: + :local: + :depth: 1 + +Deleting Rows from a Table ------------------------------ +The following example shows how to delete rows from a table. -.. code-block:: psql +1. Display the table: + + .. code-block:: psql - farm=> SELECT * FROM cool_animals; - 1,Dog ,7 - 2,Possum ,3 - 3,Cat ,5 - 4,Elephant ,6500 - 5,Rhinoceros ,2100 - 6,\N,\N + farm=> SELECT * FROM cool_animals; - 6 rows + The following table is displayed: + + .. code-block:: psql + + 1,Dog ,7 + 2,Possum ,3 + 3,Cat ,5 + 4,Elephant ,6500 + 5,Rhinoceros ,2100 + 6,\N,\N - farm=> DELETE FROM cool_animals WHERE weight > 1000; - executed +2. Delete rows from the table: + + .. code-block:: psql + + farm=> DELETE FROM cool_animals WHERE weight > 1000; + +3. Display the table: + + .. code-block:: psql + + farm=> SELECT * FROM cool_animals; - farm=> SELECT * FROM cool_animals; - 1,Dog ,7 - 2,Possum ,3 - 3,Cat ,5 - 6,\N,\N + The following table is displayed: + + .. code-block:: psql + + 1,Dog ,7 + 2,Possum ,3 + 3,Cat ,5 + 6,\N,\N - 4 rows - -Deleting values based on more complex predicates +Deleting Values Based on Complex Predicates --------------------------------------------------- +The following example shows how to delete values based on complex predicates. -.. code-block:: psql +1. Display the table: + + .. code-block:: psql - farm=> SELECT * FROM cool_animals; - 1,Dog ,7 - 2,Possum ,3 - 3,Cat ,5 - 4,Elephant ,6500 - 5,Rhinoceros ,2100 - 6,\N,\N + farm=> SELECT * FROM cool_animals; - 6 rows + The following table is displayed: + + .. code-block:: psql + + 1,Dog ,7 + 2,Possum ,3 + 3,Cat ,5 + 4,Elephant ,6500 + 5,Rhinoceros ,2100 + 6,\N,\N - farm=> DELETE FROM cool_animals WHERE weight > 1000; - executed +2. Delete rows from the table: + + .. code-block:: psql + + farm=> DELETE FROM cool_animals WHERE weight > 1000; + +3. Display the table: + + .. code-block:: psql + + farm=> SELECT * FROM cool_animals; - farm=> SELECT * FROM cool_animals; - 1,Dog ,7 - 2,Possum ,3 - 3,Cat ,5 - 6,\N,\N + The following table is displayed: + + .. code-block:: psql + + 1,Dog ,7 + 2,Possum ,3 + 3,Cat ,5 + 6,\N,\N - 4 rows - -Identifying and cleaning up tables +Identifying and Cleaning Up Tables --------------------------------------- +The **Identifying and Cleaning Up Tables** section includes the following examples: -List tables that haven't been cleaned up +.. contents:: + :local: + :depth: 1 + +Listing Tables that Have Not Been Cleaned Up ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +The following example shows how to list tables that have not been cleaned up: .. code-block:: psql @@ -152,8 +191,9 @@ List tables that haven't been cleaned up 1 row -Identify predicates for clean-up +Identifying Predicates for Clean-Up ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +The following example shows how to identify predicates for clean-up: .. code-block:: psql @@ -164,42 +204,55 @@ Identify predicates for clean-up weight > 1000 1 row + +.. _trigger_cleanup: -Triggering a cleanup +Triggering a Clean-Up ^^^^^^^^^^^^^^^^^^^^^^ +The following example shows how to trigger a clean-up: -.. code-block:: psql +1. Run the chunk ``CLEANUP_CHUNKS`` command (also known as ``SWEEP``) to reorganize the chunks: + + .. code-block:: psql + + farm=> SELECT CLEANUP_CHUNKS('public','cool_animals'); - -- Chunk reorganization (aka SWEEP) - farm=> SELECT CLEANUP_CHUNKS('public','cool_animals'); - executed +2. Run the ``CLEANUP_EXTENTS`` command (also known as ``VACUUM``) to delete the leftover files: - -- Delete leftover files (aka VACUUM) - farm=> SELECT CLEANUP_EXTENTS('public','cool_animals'); - executed + .. code-block:: psql + farm=> SELECT CLEANUP_EXTENTS('public','cool_animals'); - farm=> SELECT delete_predicate FROM sqream_catalog.delete_predicates dp - JOIN sqream_catalog.tables t - ON dp.table_id = t.table_id - WHERE t.table_name = 'cool_animals'; +3. Display the table: + + .. code-block:: psql - 0 rows + farm=> SELECT delete_predicate FROM sqream_catalog.delete_predicates dp + JOIN sqream_catalog.tables t + ON dp.table_id = t.table_id + WHERE t.table_name = 'cool_animals'; + +Best Practices +===================================== +This section includes the best practices when deleting rows: +* Run ``CLEANUP_CHUNKS`` and ``CLEANUP_EXTENTS`` after running large ``DELETE`` operations. + :: -Best practices for data deletion -===================================== +* When you delete large segments of data from very large tables, consider running a ``CREATE TABLE AS`` operation instead, renaming, and dropping the original table. -* Run ``CLEANUP_CHUNKS`` and ``CLEANUP_EXTENTS`` after large ``DELETE`` operations. + :: -* When deleting large proportions of data from very large tables, consider running a ``CREATE TABLE AS`` operation instead, then rename and drop the original table. +* Avoid killing ``CLEANUP_EXTENTS`` operations in progress. -* Avoid killing ``CLEANUP_EXTENTS`` operations after they've started. + :: -* SQream DB is optimised for time-based data. When data is naturally ordered by a date or timestamp, deleting based on those columns will perform best. For more information, see our :ref:`time based data management guide`. +* SQream is optimized for time-based data, which is data naturally ordered according to date or timestamp. Deleting rows based on such columns leads to increased performance. + :: +For more information, see `Time-Based Data Management `_. .. soft update concept @@ -210,5 +263,4 @@ Best practices for data deletion .. when does delete use the metadata effectively -.. more examples - +.. more examples \ No newline at end of file diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index d0a6c04c8..67c9db172 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -9,81 +9,81 @@ The **SQL Statements** page describes the following commands: :local: :depth: 1 -SQream DB supports commands from ANSI SQL. +SQream supports commands from ANSI SQL. .. _ddl_commands_list: Data Definition Commands (DDL) ================================ +The following table shows the Data Definition commands: -.. list-table:: DDL Commands - :widths: auto +.. list-table:: + :widths: 10 100 :header-rows: 1 :name: ddl_commands * - Command - Usage - * - :ref:`add_column` + * - :ref:`ADD_COLUMN` - Add a new column to a table - * - :ref:`alter_default_schema` + * - :ref:`ALTER_DEFAULT_SCHEMA` - Change the default schema for a role - * - :ref:`alter_table` + * - :ref:`ALTER_TABLE` - Change the schema of a table - * - :ref:`cluster_by` + * - :ref:`CLUSTER_BY` - Change clustering keys in a table - * - :ref:`create_database` + * - :ref:`CREATE_DATABASE` - Create a new database - * - :ref:`create_external_table` - - Create a new external table in the database (deprecated) - * - :ref:`create_foreign_table` + * - :ref:`CREATE_FOREIGN_TABLE` - Create a new foreign table in the database - * - :ref:`create_function` + * - :ref:`CREATE_FUNCTION` - Create a new user defined function in the database - * - :ref:`create_schema` + * - :ref:`CREATE_SCHEMA` - Create a new schema in the database - * - :ref:`create_table` + * - :ref:`CREATE_TABLE` - Create a new table in the database - * - :ref:`create_table_as` + * - :ref:`CREATE_TABLE_AS` - Create a new table in the database using results from a select query - * - :ref:`create_view` + * - :ref:`CREATE_VIEW` - Create a new view in the database - * - :ref:`drop_clustering_key` + * - :ref:`DROP_CLUSTERING_KEY` - Drops all clustering keys in a table - * - :ref:`drop_column` + * - :ref:`DROP_COLUMN` - Drop a column from a table - * - :ref:`drop_database` + * - :ref:`DROP_DATABASE` - Drop a database and all of its objects - * - :ref:`drop_function` + * - :ref:`DROP_FUNCTION` - Drop a function - * - :ref:`drop_schema` + * - :ref:`DROP_SCHEMA` - Drop a schema - * - :ref:`drop_table` + * - :ref:`DROP_TABLE` - Drop a table and its contents from a database - * - :ref:`drop_view` + * - :ref:`DROP_VIEW` - Drop a view - * - :ref:`rename_column` + * - :ref:`RENAME_COLUMN` - Rename a column - * - :ref:`rename_table` + * - :ref:`RENAME_TABLE` - Rename a table + Data Manipulation Commands (DML) ================================ +The following table shows the Data Manipulation commands: -.. list-table:: DML Commands - :widths: auto +.. list-table:: + :widths: 10 100 :header-rows: 1 :name: dml_commands - * - Command - Usage - * - :ref:`CREATE TABLE AS` + * - :ref:`CREATE_TABLE_AS` - Create a new table in the database using results from a select query * - :ref:`DELETE` - Delete specific rows from a table - * - :ref:`COPY FROM` + * - :ref:`COPY_FROM` - Bulk load CSV data into an existing table - * - :ref:`COPY TO` + * - :ref:`COPY_TO` - Export a select query or entire table to CSV files * - :ref:`INSERT` - Insert rows into a table @@ -98,15 +98,20 @@ Data Manipulation Commands (DML) Utility Commands ================== +The following table shows the Utility commands: -.. list-table:: Utility Commands - :widths: auto +.. list-table:: + :widths: 10 100 :header-rows: 1 * - Command - Usage * - :ref:`EXPLAIN` - Returns a static query plan, which can be used to debug query plans + * - :ref:`GET_EXTENTS_FILE_FOR_CHUNK` + - Points to all files that contain data related to a specific chunk + * - :ref:`GET_METADATA_CHUNK_KEY` + - Returns a list of metadata key values for the chunks that you specify * - :ref:`SELECT GET_LICENSE_INFO` - View a user's license information * - :ref:`SELECT GET_DDL` @@ -132,14 +137,12 @@ Utility Commands * - :ref:`STOP STATEMENT` - Stops or aborts an active statement - - - Workload Management ====================== +The following table shows the Workload Management commands: -.. list-table:: Workload Management - :widths: auto +.. list-table:: + :widths: 10 100 :header-rows: 1 * - Command @@ -153,9 +156,10 @@ Workload Management Access Control Commands ================================ +The following table shows the Access Control commands: -.. list-table:: Access Control Commands - :widths: auto +.. list-table:: + :widths: 10 100 :header-rows: 1 * - Command diff --git a/reference/sql/sql_statements/utility_commands/get_extents_file_list_for_chunk.rst b/reference/sql/sql_statements/utility_commands/get_extents_file_list_for_chunk.rst new file mode 100644 index 000000000..2f872812a --- /dev/null +++ b/reference/sql/sql_statements/utility_commands/get_extents_file_list_for_chunk.rst @@ -0,0 +1,60 @@ +.. _get_extents_file_list_for_chunk: + +******************** +GET_EXTENTS_FILE_FOR_CHUNK +******************** +The ``GET_EXTENTS_FILE_FOR_CHUNK`` command points to all files that contain data related to a specific chunk. This command is used for debugging purposes. + +This reference page includes the following information: + +.. contents:: + :local: + :depth: 1 + +Syntax +========== +The following is the syntax for the ``GET_EXTENTS_FILE_FOR_CHUNK`` command: + +.. code-block:: postgres + + select get_extents_file_list_for_chunk(database_name, " + "table_id, chunk_id);" + +Output +========== +The following is an example of the output generated by the ``GET_EXTENTS_FILE_FOR_CHUNK`` command: + +.. code-block:: postgres + + EXAMPLE NEEDED + +Parameters +============ +The following table shows the ``GET_EXTENTS_FILE_FOR_CHUNK`` parameters: + +.. list-table:: + :widths: 10 100 + :header-rows: 1 + + * - Parameter + - Description + * - ``database_name`` + - The name of the database where the chunk is located. + * - ``table_id`` + - The ID of the table where the chunk is located. + * - ``chunk_id`` + - The ID of the chunk. + +Examples +=========== +The following is an example of the ``GET_EXTENTS_FILE_FOR_CHUNK`` command: + +.. code-block:: postgres + + Example - pending from Eyal W. + +Permissions +============= +The ``GET_EXTENTS_FILE_FOR_CHUNK`` requires no special permissions. + +**Comment** - *Does it require any special permissions?* \ No newline at end of file diff --git a/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst b/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst new file mode 100644 index 000000000..2ccc59132 --- /dev/null +++ b/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst @@ -0,0 +1,59 @@ +.. _get_metadata_chunk_key: + +******************** +GET_METADATA_CHUNK_KEY +******************** +The ``GET_METADATA_CHUNK_KEY`` command returns specific metadata key values for user-specified chunks. + +This reference page includes the following information: + +.. contents:: + :local: + :depth: 1 + +Syntax +========== +The following is the syntax for the ``GET_METADATA_CHUNK_KEY`` command: + +.. code-block:: postgres + + get_metadata_chunk_key(database_name, table_id, chunk_id); + +Output +========== +The following is an example of the output generated by the ``GET_METADATA_CHUNK_KEY`` command: + +.. code-block:: postgres + + EXAMPLE NEEDED + +Parameters +============ +The following table shows the ``GET_METADATA_CHUNK_KEY`` parameters: + +.. list-table:: + :widths: 10 100 + :header-rows: 1 + + * - Parameter + - Description + * - ``database_name`` + - The name of the database where the chunk is located. + * - ``table_id`` + - The ID of the table where the chunk is located. + * - ``chunk_id`` + - The ID of the chunk. + +Examples +=========== +The following is an example of the ``GET_METADATA_CHUNK_KEY`` command: + +.. code-block:: postgres + + Example - pending from Eyal W. + +Permissions +============= +The ``GET_METADATA_CHUNK_KEY`` requires no special permissions. + +**Comment** - *Does it require any special permissions?* \ No newline at end of file From f9eed2503c2e2281f3b861f394aed69ad83f7e49 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 7 Jul 2022 15:52:41 +0300 Subject: [PATCH 101/882] Removed link to uncreated page. This uncreated page is related to Flexible Data Clustering, which is not released yet. The content for Flexible Data Clustering is saved locally for future use. --- operational_guides/delete_guide.rst | 4 ---- 1 file changed, 4 deletions(-) diff --git a/operational_guides/delete_guide.rst b/operational_guides/delete_guide.rst index c24079f8c..0d6c4a41c 100644 --- a/operational_guides/delete_guide.rst +++ b/operational_guides/delete_guide.rst @@ -250,10 +250,6 @@ This section includes the best practices when deleting rows: * SQream is optimized for time-based data, which is data naturally ordered according to date or timestamp. Deleting rows based on such columns leads to increased performance. - :: - -For more information, see `Time-Based Data Management `_. - .. soft update concept .. delete cleanup and it's properties. automatic/manual, in transaction or background From f9a3e9586fe5082fda571f47eace77207331eba0 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 7 Jul 2022 16:22:53 +0300 Subject: [PATCH 102/882] Prepared for 2022.1 release --- _static/images/New_Dark_Gray.png | Bin 0 -> 1073 bytes _static/images/new_2022.1.png | Bin 882 -> 1085 bytes operational_guides/foreign_tables.rst | 10 +++++----- reference/sql/sql_statements/index.rst | 12 ++++++++++-- .../get_extents_file_list_for_chunk.rst | 6 +++++- .../get_metadata_chunk_key.rst | 6 +++++- releases/2022.1.rst | 12 +++++++++++- 7 files changed, 36 insertions(+), 10 deletions(-) create mode 100644 _static/images/New_Dark_Gray.png diff --git a/_static/images/New_Dark_Gray.png b/_static/images/New_Dark_Gray.png new file mode 100644 index 0000000000000000000000000000000000000000..34ac016ebccc01827492455680537addf4b08c9e GIT binary patch literal 1073 zcmV-11kU@3P)m00001b5ch_0Itp) z=>Px#1ZP1_K>z@;j|==^1poj532;bRa{vGqB>(^xB>_oNB=7(L1I9^2K~z{r?O3gH zB0&&t)+M!X5E~+>JOO7Am=J@CJ-3m;#36Ap8yVbLR7^G|0&_e8g@D*R!EJ%u`?_al znO&BdP^37jE??D9^Vc)e|Gm`yESFh0?hy?dl)goDYzTX&L__X1i59;pJzL5A|Ag@5 zgXl+{=rW-+Zectos&$BxjMCPM0@*Ntl=^p?L|=yXVO-YIwB-mwX1=tJ;3q00M3V33nT5BngE;kAx>Bwd~HlM0ZK z$|Uo5C~=C8?WQ)a?v*!I#PmY4HK8M(t`*1buB}(_3fGTtt8J0b*c)~Apa^D6EE5(g z=SxDbxRXO&!4M$qjtOV}JgPhoo$i&In6p62z@2bT7FZb@^dbx)A=j?A2jM4B!Tr zz*2;n5kgdpLx2{ztDrg*OaWsX#YHJ@3BV8=`^C8$8dTBS@U4Fl0tpii*xo3fQvisi z{8ynZZ$>eB1;rs$7bsnv#icP9R9iynA)vlLVMOIzROfdhE!dIgeU2aS$~w{5O0VHt z-xZQKBk010u4e*Cn6Ao+VZ4#8(ZGbuN)OeLJxB<*P^2lISV&WhN1)v`Ph7FmOF3Fs zcDs0VE?}#Q%u&VH1Bb+Zo?o5xfNPzjk`!iE(dR=>WAQD~%{WySH?yo6XZ+8NX<0;Q zNpWrwXBoEJ^OyuJ=6F7DQIU?%=lLWn(G>SpwJeD?-^K^o_gU-tn!c;5<$P>3yc188 zJ+3=E^xk#DzkMdld&_?H9!*n_{hHSrU#dP%tF7uA#|f!=wcY~x80F6hySn?v@x!Vq rRCUUQ%ivME-#C8AUwb`MQxN?HAc-16j1ijA00000NkvXXu0mjfU~=nV literal 0 HcmV?d00001 diff --git a/_static/images/new_2022.1.png b/_static/images/new_2022.1.png index 4861ba76a5b6c7d35703267596db1f4c0a8c9fb5..27b2d285af4bee0337de2888e4bfcf8dbbcc77b1 100644 GIT binary patch delta 1025 zcmV+c1pfQ-2E7Q783+ad000;Y^Td%MHGk4cL_t(oN9|a>YAQh#KJMm40x^Z;3A~U} zh-s|S-fjg6BuzTYbZIOkV7jzcX|jT4;Q9n&p+a87W$$;+%#O3`IukK?g_{pXc4qd> znK?h-9Ji7JG-?w))+qV7rDH?bIU#!Cr#jK%4<)CGjQ>vv!%w1LRicZSlII5cV}GJb zlPFG!u80DnB^(GVb?>x@GF*6q)`zeK8Sh|$10nqE!-4F)l#gm4mGfn-a3(fd zcxla_bo7jZSKc$f4a)9$U1dm;22l@oc^gSTpyfN!B%-8IVxapc{qT>lnBnK*TeDB1 zxH>~ntfbMRhd^oO1GbH*Cyaxnq<=*(a4G@{@X3E^{Q_8qovj$hfg0~i(CMNi(kaqIey@EBx69c34)ymiojSGi#oE=MLS{t(nK#Ki#9tb!hdlmCu2kI z!X`F3xmR+UlAJn42lS3JI>R#zzY}!!)0yfD#9*+K!w>r)c}CVc>X9Tll`Yv2N@btV zmvG_~4|bZ`xO!08SiT-bqV>dH8^WUQ?^MCNrLWRJXvq6f0P9!HAtcVTy0(|p(1NIE~%-bLlz}fin zxEaxMm*Qj(*5>ZIYsZ~k<= zJkSqr$R2**BM?yamDL0u_~iFp--{aTKb^ygK1epg8BeMb$^+xo3V+JotbyA#?MMLJ zKnWs64l_i7(qIbE26q)yhk`C(ILi&r3%n)3fjHRDZH@)X|0jZ|co$W9pE#(^oXa_Wa8~w-##VU^ z-~6tSd-E2)u%YXjKz}YwSLMXWvXP@PLq?aS8LA=g;6iA_ky-J?Mw+5OgzT>O#1%W8 z*Ryo$%5Im8HU_q;NQ1I-JuxMA&Hd_>2VC>aN>Z3vMV}8w#;Q$(-Lj-gd-XJ}_tMpB zWm+1cWQgMY*rKOO32PjKkToTSZc$#2*XQv#Ey(2GD{E;SZEo(37qazP^JY%#Dr@E( z8x8x!*5n?-KHRa{1 vyB{1steT?234Y8Uz<;m_`Lt&~fD`=%VF?q}GPb_U00000NkvXXu0mjfk%{+R delta 821 zcmV-51Iqlp2=WGy83+OZ005V0WRsC0HGc<5L_t(oN9~tAa_TS;$N%^&K*4YVa{@?1 zmG*U_Oqz5l)1@&bK0+#**e8fjz))b{#cx+y%aXA2!6TV@Gx?1QX|>4O)vi{cB?{H1 z8FzjXg%;G(widyENZqDrRiXO@o1?qrQ$1nigfTU93?+&D?0VGMzj~8bFsBl1Pk);u zQ%Yn+Oh3BL8SEKnLB{oI+h(chCum+#DJ3tW~MlW#m*acZ#|Lt&oK`(rDT>0Zc3Hid4Ki>cy(WwOS`No zvP}Pq9)Q%sDopr0bZr^de|MeWWfH6Vy+dR;_?B|)Fi+y(XC#s4e1q2MU0~FPY%qjx zDeXSf0$)3O>2V+G((IdQXsMWfbRFNP?DumWBJinfctq>!cklb9;FnK8F9+?(L|1L6 z&i-;SUHuqQ$nwklX(D#vCH;#)|4>$->|f$9Q>c)1B;vX600000NkvXXu0mjf_%54Y diff --git a/operational_guides/foreign_tables.rst b/operational_guides/foreign_tables.rst index 739652bfa..74c476331 100644 --- a/operational_guides/foreign_tables.rst +++ b/operational_guides/foreign_tables.rst @@ -53,14 +53,14 @@ Based on the source file structure, we we :ref:`create an external table` - Returns a static query plan, which can be used to debug query plans * - :ref:`GET_EXTENTS_FILE_FOR_CHUNK` - - Points to all files that contain data related to a specific chunk + - Points to all files that contain data related to a specific chunk |icon-new_2022.1| * - :ref:`GET_METADATA_CHUNK_KEY` - - Returns a list of metadata key values for the chunks that you specify + - Returns a list of metadata key values for the chunks that you specify |icon-New_Dark_Gray| * - :ref:`SELECT GET_LICENSE_INFO` - View a user's license information * - :ref:`SELECT GET_DDL` @@ -137,6 +137,14 @@ The following table shows the Utility commands: * - :ref:`STOP STATEMENT` - Stops or aborts an active statement +.. |icon-new_2022.1| image:: /_static/images/new_2022.1.png + :align: middle + :width: 110 + +.. |icon-New_Dark_Gray| image:: /_static/images/New_Dark_Gray.png + :align: middle + :width: 110 + Workload Management ====================== The following table shows the Workload Management commands: diff --git a/reference/sql/sql_statements/utility_commands/get_extents_file_list_for_chunk.rst b/reference/sql/sql_statements/utility_commands/get_extents_file_list_for_chunk.rst index 2f872812a..5679e508e 100644 --- a/reference/sql/sql_statements/utility_commands/get_extents_file_list_for_chunk.rst +++ b/reference/sql/sql_statements/utility_commands/get_extents_file_list_for_chunk.rst @@ -3,7 +3,11 @@ ******************** GET_EXTENTS_FILE_FOR_CHUNK ******************** -The ``GET_EXTENTS_FILE_FOR_CHUNK`` command points to all files that contain data related to a specific chunk. This command is used for debugging purposes. +The ``GET_EXTENTS_FILE_FOR_CHUNK`` |icon-new_2022.1| command points to all files that contain data related to a specific chunk. This command is used for debugging purposes. + +.. |icon-new_2022.1| image:: /_static/images/new_2022.1.png + :align: middle + :width: 110 This reference page includes the following information: diff --git a/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst b/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst index 2ccc59132..ee641e3b1 100644 --- a/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst +++ b/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst @@ -3,7 +3,11 @@ ******************** GET_METADATA_CHUNK_KEY ******************** -The ``GET_METADATA_CHUNK_KEY`` command returns specific metadata key values for user-specified chunks. +The ``GET_METADATA_CHUNK_KEY`` |icon-new_2022.1| command returns specific metadata key values for user-specified chunks. + +.. |icon-new_2022.1| image:: /_static/images/new_2022.1.png + :align: middle + :width: 110 This reference page includes the following information: diff --git a/releases/2022.1.rst b/releases/2022.1.rst index a98a397f8..dbf061797 100644 --- a/releases/2022.1.rst +++ b/releases/2022.1.rst @@ -45,6 +45,16 @@ SQream now supports ingesting data from Avro files. For more information, see `Inserting Data from Avro `_. +New Utility Commands +************ +The following two new utility commands have been created: + +* `GET EXTENTS FILE FOR CHUNK `_ - points to all files that contain data related to a specific chunk. This command is used for debugging purposes. + + :: + +* `GET_METADATA_CHUNK_KEY `_ - returns specific metadata key values for user-specified chunks. + Resolved Issues --------- The following table lists the issues that were resolved in Version 2022.1: @@ -76,7 +86,7 @@ Deprecated Features ------- In SQream version 2022.1 the ``VARCHAR`` data type has been deprecated and replaced with ``TEXT``. ``VARCHAR`` will be maintained in all previous versions until migration to ``TEXT`` is complete, at which point it will be deprecated in all earlier versions. -If you are using an earlier version of SQream, see `Using Legacy String Literals `_. +If you are using an earlier version of SQream, see `Using Legacy String Literals `_. An automated process is being used to facilitate migration from ``VARCHAR`` to ``TEXT``. For more information, contact SQream. From 482a45f7b6fd7a5415888ebb7426ef05c160ef02 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Fri, 8 Jul 2022 17:46:17 +0300 Subject: [PATCH 103/882] Two New Utility Commands --- .../get_extents_file_list_for_chunk.rst | 71 +++++++++-- .../get_metadata_chunk_key.rst | 110 ++++++++++++++++-- 2 files changed, 159 insertions(+), 22 deletions(-) diff --git a/reference/sql/sql_statements/utility_commands/get_extents_file_list_for_chunk.rst b/reference/sql/sql_statements/utility_commands/get_extents_file_list_for_chunk.rst index 5679e508e..3c05a48fe 100644 --- a/reference/sql/sql_statements/utility_commands/get_extents_file_list_for_chunk.rst +++ b/reference/sql/sql_statements/utility_commands/get_extents_file_list_for_chunk.rst @@ -23,15 +23,7 @@ The following is the syntax for the ``GET_EXTENTS_FILE_FOR_CHUNK`` command: select get_extents_file_list_for_chunk(database_name, " "table_id, chunk_id);" - -Output -========== -The following is an example of the output generated by the ``GET_EXTENTS_FILE_FOR_CHUNK`` command: - -.. code-block:: postgres - - EXAMPLE NEEDED - + Parameters ============ The following table shows the ``GET_EXTENTS_FILE_FOR_CHUNK`` parameters: @@ -47,15 +39,70 @@ The following table shows the ``GET_EXTENTS_FILE_FOR_CHUNK`` parameters: * - ``table_id`` - The ID of the table where the chunk is located. * - ``chunk_id`` - - The ID of the chunk. + - The ID of the chunk. -Examples +Example =========== The following is an example of the ``GET_EXTENTS_FILE_FOR_CHUNK`` command: .. code-block:: postgres - Example - pending from Eyal W. + master=> select get_extents_file_list_for_chunk('master', 0, 3); + +Output +========== +The following table describes the output generated from the ``GET_EXTENTS_FILE_FOR_CHUNK`` command: + +Database name. table name, table id, column id, chunk id, file path + +.. list-table:: + :widths: 25 25 25 25 + :header-rows: 1 + + * - Parameter + - Description + - Type + - Example + + * - ``database_name`` + - The name of the database where the chunk is located. + - Text + - ``master`` + + * - ``table_name`` + - The ID of the table where the chunk is located. + - Numeric + - ``0`` + + * - ``table_id`` + - The ID of the column. + - Numeric + - ``0`` + + * - ``column_id`` + - The status of the chunk. + - **Comment** - *What is the type?* + - ``1`` + + * - ``chunk_id`` + - Describes the state of the chunk. + - **Comment** - *What is the type?* + - ``chunk_state::`` + + * - ``file_path`` + - Shows the path of the file. + - Text + - **Comment** - *Provide example + +The following is an example of the output generated from the ``GET_EXTENTS_FILE_FOR_CHUNK`` command: + +.. code-block:: postgres + + master,public.t_1,0,0,3,/home/eyalw/sqream_testing_temp/sqreamdb/databases/master/tables/0/0/0-2 + master,public.t_1,0,1,3,/home/eyalw/sqream_testing_temp/sqreamdb/databases/master/tables/0/1/1-2 + master,public.t_1,0,2,3,/home/eyalw/sqream_testing_temp/sqreamdb/databases/master/tables/0/2/2-2 + master,public.t_1,0,3,3,/home/eyalw/sqream_testing_temp/sqreamdb/databases/master/tables/0/3/3-2 + master,public.t_1,0,4,3,/home/eyalw/sqream_testing_temp/sqreamdb/databases/master/tables/0/4/4-2 Permissions ============= diff --git a/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst b/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst index ee641e3b1..c43775de7 100644 --- a/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst +++ b/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst @@ -23,14 +23,6 @@ The following is the syntax for the ``GET_METADATA_CHUNK_KEY`` command: get_metadata_chunk_key(database_name, table_id, chunk_id); -Output -========== -The following is an example of the output generated by the ``GET_METADATA_CHUNK_KEY`` command: - -.. code-block:: postgres - - EXAMPLE NEEDED - Parameters ============ The following table shows the ``GET_METADATA_CHUNK_KEY`` parameters: @@ -48,13 +40,111 @@ The following table shows the ``GET_METADATA_CHUNK_KEY`` parameters: * - ``chunk_id`` - The ID of the chunk. -Examples +Example =========== The following is an example of the ``GET_METADATA_CHUNK_KEY`` command: .. code-block:: postgres - Example - pending from Eyal W. + master=> select get_metadata_chunk_key('master', 0, 1); + +Output +========== +The following table describes the output generated from the ``GET_METADATA_CHUNK_KEY`` command: + +.. list-table:: + :widths: 25 25 25 25 + :header-rows: 1 + + * - Parameter + - Description + - Type + - Example + + * - ``database_name`` + - The name of the database where the chunk is located. + - Text + - ``master`` + + * - ``table_id`` + - The ID of the table where the chunk is located. + - Numeric + - ``0`` + + * - ``column_id`` + - The ID of the column. + - Numeric + - ``0`` + + * - ``chunk_status`` + - The status of the chunk. + - **Comment** - *What is the type?* + - ``1`` + + * - ``chunk_aligned`` + - Describes the state of the chunk. + - **Comment** - *What is the type?* + - ``chunk_state::`` + + * - ``offset_in_file`` + - Shows the file's offset setting. + - Numeric + - ``-1`` + + * - ``compressed_size`` + - Shows the file's compressed size. + - Numeric + - ``0`` + + * - ``uncompressed_size`` + - Shows the file's uncompressed size. + - Numeric + - ``2`` + + * - ``compression_type`` + - Shows the file's compression type. + - Numeric + - ``2`` + + * - ``min_long`` + - **Comment** - What is it? + - **Comment** - What is it? + - ``flat`` + + * - ``max_long`` + - **Comment** - What is it? + - **Comment** - What is it? + - **Comment** - What is it? + + * - ``min_string_max_string`` + - **Comment** - What is it? + - **Comment** - What is it? + - **Comment** - What is it? + + * - ``min_numeric`` + - **Comment** - What is it? + - **Comment** - What is it? + - **Comment** - What is it? + + * - ``max_numeric`` + - **Comment** - What is it? + - **Comment** - What is it? + - **Comment** - What is it? + + * - ``column_aligned`` + - **Comment** - What is it? + - **Comment** - What is it? + - **Comment** - What is it? + +The following is an example of the output generated from the ``GET_METADATA_CHUNK_KEY`` command: + +.. code-block:: postgres + + master,0,0,1,chunk_state::clean,1,0,2,2,flat,0,0,,,0x7f722ffb7c60,0x7f722ffb7c70,1 + master,0,1,1,chunk_state::clean,1,0,8,8,flat,1,2,,,0x7f722ffb7c60,0x7f722ffb7c70,1 + master,0,2,1,chunk_state::clean,1,0,2,2,flat,0,0,,,0x7f722ffb7c60,0x7f722ffb7c70,1 + master,0,3,1,chunk_state::clean,1,0,8,8,flat,3,3,,,0x7f722ffb7c60,0x7f722ffb7c70,1 + master,0,4,1,chunk_state::clean,1,0,16,16,flat,0,0,abc,dfg,0x7f722ffb7c60,0x7f722ffb7c70,1 Permissions ============= From b37d0c0ce6d30e461ae2b63cdba66c969063d9e4 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 10 Jul 2022 13:10:10 +0300 Subject: [PATCH 104/882] Updated Replaced External Tables with Foreign Tables Finalized VARCHAR deprecation text --- operational_guides/foreign_tables.rst | 35 ++++++++++++++------------- releases/2022.1.rst | 27 +++------------------ 2 files changed, 21 insertions(+), 41 deletions(-) diff --git a/operational_guides/foreign_tables.rst b/operational_guides/foreign_tables.rst index 74c476331..bc8c401a6 100644 --- a/operational_guides/foreign_tables.rst +++ b/operational_guides/foreign_tables.rst @@ -4,18 +4,18 @@ Foreign Tables *********************** Foreign tables can be used to run queries directly on data without inserting it into SQream DB first. -SQream DB supports read only external tables, so you can query from external tables, but you cannot insert to them, or run deletes or updates on them. +SQream DB supports read only foreign tables, so you can query from foreign tables, but you cannot insert to them, or run deletes or updates on them. Running queries directly on external data is most effectively used for things like one off querying. If you will be repeatedly querying data, the performance will usually be better if you insert the data into SQream DB first. -Although external tables can be used without inserting data into SQream DB, one of their main use cases is to help with the insertion process. An insert select statement on an external table can be used to insert data into SQream using the full power of the query engine to perform ETL. +Although foreign tables can be used without inserting data into SQream DB, one of their main use cases is to help with the insertion process. An insert select statement on a foreign table can be used to insert data into SQream using the full power of the query engine to perform ETL. .. contents:: In this topic: :local: Supported Data Formats ===================================== -SQream DB supports external tables over: +SQream DB supports foreign tables over: * Text files (e.g. CSV, PSV, TSV) * ORC @@ -29,9 +29,9 @@ SQream can stage data from: * :ref:`s3` buckets (e.g. ``s3://pp-secret-bucket/users/*.parquet``) * :ref:`hdfs` (e.g. ``hdfs://hadoop-nn.piedpiper.com/rhendricks/*.csv``) -Using External Tables +Using Foreign Tables ============================================== -Use an external table to stage data before loading from CSV, Parquet or ORC files. +Use a foreign table to stage data before loading from CSV, Parquet or ORC files. Planning for Data Staging -------------------------------- @@ -45,13 +45,13 @@ For the following examples, we will want to interact with a CSV file. Here's a p The file is stored on :ref:`s3`, at ``s3://sqream-demo-data/nba_players.csv``. We will make note of the file structure, to create a matching ``CREATE_EXTERNAL_TABLE`` statement. -Creating an External Table +Creating a Foreign Table ----------------------------- -Based on the source file structure, we we :ref:`create an external table` with the appropriate structure, and point it to the file. +Based on the source file structure, we we :ref:`create a foreign table` with the appropriate structure, and point it to the file. .. code-block:: postgres - CREATE EXTERNAL TABLE nba + CREATE foreign table nba ( Name varchar, Team varchar, @@ -68,12 +68,13 @@ Based on the source file structure, we we :ref:`create an external table SELECT * FROM nba; master=> select * from nba; Record delimiter mismatch during CSV parsing. User defined line delimiter \n does not match the first delimiter \r\n found in s3://sqream-demo-data/nba.csv -* Since the data for an external table is not stored in SQream DB, it can be changed or removed at any time by an external process. As a result, the same query can return different results each time it runs against an external table. Similarly, a query might fail if the external data is moved, removed, or has changed structure. \ No newline at end of file +* Since the data for a foreign table is not stored in SQream DB, it can be changed or removed at any time by an external process. As a result, the same query can return different results each time it runs against a foreign table. Similarly, a query might fail if the external data is moved, removed, or has changed structure. \ No newline at end of file diff --git a/releases/2022.1.rst b/releases/2022.1.rst index dbf061797..ac180206c 100644 --- a/releases/2022.1.rst +++ b/releases/2022.1.rst @@ -16,6 +16,7 @@ The 2022.1 Release Notes describes the following: * Enhanced security features. * New data manipulation command. * Additional data ingestion format. +* New utility commands. New Features ---------- @@ -84,31 +85,9 @@ No relevant naming changes were made. Deprecated Features ------- -In SQream version 2022.1 the ``VARCHAR`` data type has been deprecated and replaced with ``TEXT``. ``VARCHAR`` will be maintained in all previous versions until migration to ``TEXT`` is complete, at which point it will be deprecated in all earlier versions. +In SQream version 2022.1 the ``VARCHAR`` data type has been deprecated and replaced with ``TEXT``. SQream will maintain ``VARCHAR`` in all previous versions until completing the migration to ``TEXT``, at which point it will be deprecated in all earlier versions. SQream also provides an automated and secure tool to facilitate and simplify migration from ``VARCHAR`` to ``TEXT``. -If you are using an earlier version of SQream, see `Using Legacy String Literals `_. - -An automated process is being used to facilitate migration from ``VARCHAR`` to ``TEXT``. For more information, contact SQream. - -**Comment** - *Below is the original text of the VARCHAR deprecation email. I don't think that we need to necessarily expose our logic to our customers, but focus on certain aspects of it (see the first paragraph above). However, I can use more/all of this content if deemed necessary.* - -* SQream has decided to deprecated support in varchar data type, the decision made out of SQream effort to enhance its core functionalities and with respect to ever changing eco system requirements. - - :: - -* For new customers Varchar data type is not supported - - :: - -* The supported data type that will replace this data type is text as all different functionalities encapsulated within this data type - - :: - -* SQream will maintain varchar data type support until the last customer will be fully migrated - - :: - -* In order to enhance the conversion mechanism to be as fast as possible SQream will provide an automated and secured tool to help customers with the conversion phase from VARCHAR to TEXT data type, please address delivery for further information +If you are using an earlier version of SQream, see the `Using Legacy String Literals `_ configuration flag. Known Issues and Limitations -------- From 1e77017a98e3734dcf60ab1a4d6eeac6494d5006 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 10 Jul 2022 17:33:10 +0300 Subject: [PATCH 105/882] Added Loading and Unloading Data section to menu Modified menu. Added links to Performing Basic SQream Operations page. --- .../performing_basic_sqream_operations.rst | 9 +++-- index.rst | 15 ++++---- loading_and_unloading_data/index.rst | 36 +++++++++++++++++++ 3 files changed, 50 insertions(+), 10 deletions(-) create mode 100644 loading_and_unloading_data/index.rst diff --git a/getting_started/performing_basic_sqream_operations.rst b/getting_started/performing_basic_sqream_operations.rst index 1b0f60ba3..0808c22dd 100644 --- a/getting_started/performing_basic_sqream_operations.rst +++ b/getting_started/performing_basic_sqream_operations.rst @@ -11,10 +11,13 @@ After installing SQream you can perform the operations described on this page: running_the_sqream_sql_client creating_your_first_table - creating_a_database - querying_data listing_tables inserting_rows running_queries deleting_rows - saving_query_results_to_a_csv_or_psv_file \ No newline at end of file + saving_query_results_to_a_csv_or_psv_file + +For more information on other basic SQream operations, see the following: + +* `Creating a Database `_ +* :ref:`data_ingestion` \ No newline at end of file diff --git a/index.rst b/index.rst index 29ea038b0..72731e378 100644 --- a/index.rst +++ b/index.rst @@ -10,7 +10,7 @@ The **v2022.1** branch is a private branch designed for internal use only until .. tip:: Want to read this offline? - `Download the documentation as a single PDF `_ . + `Download the documentation as a single PDF `_ . .. only:: pdf or latex @@ -35,7 +35,7 @@ SQream DB easily plugs in to third-party tools like :ref:`Tableau`_ + `Getting Started `_ :ref:`sql_feature_support` @@ -47,7 +47,7 @@ SQream DB easily plugs in to third-party tools like :ref:`Tableau`_ + `Setting up SQream `_ :ref:`Best practices` @@ -59,7 +59,7 @@ SQream DB easily plugs in to third-party tools like :ref:`Tableau` - :ref:`2021.2<2021.2>` + :ref:`2021.2<2021.2>` :ref:`2021.1<2021.1>` @@ -103,7 +103,8 @@ If you're looking for an older version of the documentation, versions 1.10 throu getting_started/index installation_guides/index data_ingestion/index - third_party_tools/index + connecting_to_sqream/index + loading_and_unloading/index feature_guides/index operational_guides/index sqream_studio_5.4.3/index @@ -116,9 +117,9 @@ If you're looking for an older version of the documentation, versions 1.10 throu glossary .. - Indices and tables + Indices and Tables ================== * :ref:`genindex` * :ref:`modindex` - * :ref:`search` + * :ref:`search` \ No newline at end of file diff --git a/loading_and_unloading_data/index.rst b/loading_and_unloading_data/index.rst new file mode 100644 index 000000000..ae5c506bb --- /dev/null +++ b/loading_and_unloading_data/index.rst @@ -0,0 +1,36 @@ +.. _loading_and_unloading_data: + +*********************** +Loading and Unloading Data +*********************** +The **Loading Data** section describes concepts and operations related to importing data into your SQream database: + +* `Overview of loading data `_ - Describes best practices and considerations for loading data into SQream from a variety of sources and locations. + +* `Alternatives to loading data (foreign tables) `_ - Useful for running queries directly on external data without importing into your SQream database. + +* `Supported data types `_ - Overview of supported data types, including descriptions, examples, and relevant aliases. + +* `Ingesting data from external sources `_ - List of data ingestion sources that SQream supports. + +* `Inserting data from external tables `_ - Inserts one or more rows into a table. + +* `Ingesting data from third party client platforms `_ - Gives you direct access to a variety of drivers, connectors, tools, vizualisers, and utilities.. + +* `Using the COPY FROM statement `_ - Used for loading data from files located on a filesystem into SQream tables. + +* `Importing data using Studio `_ - SQream's web-based client providing users with all functionality available from the command line in an intuitive and easy-to-use format. + +* `Loading data using Amazon S3 `_ - Used for loading data from Amazon S3. + +* Troubleshooting - Describes troubleshooting solutions related to importing data from the following: + + * `SAS Viya `_ + + * `Tableau `_ + +The **Unloading Data** section describes concepts and operations related to exporting data from your SQream database: + +* `Overview of unloading data `_ - Describes best practices and considerations for unloading data from SQream to a variety of sources and locations. + +* `The COPY TO statement `_ - Used for unloading data from a SQream database table or query to a file on a filesystem. \ No newline at end of file From 5889fbaa833656f3bd364d7c011c2574831f7144 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 10 Jul 2022 17:45:18 +0300 Subject: [PATCH 106/882] Corrected the menu --- .../client_drivers/index.rst | 166 +++--- .../client_drivers/jdbc/index.rst | 342 ++++++------ .../client_drivers/jdbc/sample.java | 132 ++--- .../client_drivers/odbc/index.rst | 114 ++-- .../odbc/install_configure_odbc_linux.rst | 506 +++++++++--------- .../odbc/install_configure_odbc_windows.rst | 268 +++++----- .../connectivity_ecosystem.jpg | Bin .../index.rst | 32 +- index.rst | 2 +- 9 files changed, 781 insertions(+), 781 deletions(-) rename {third_party_tools => connecting_to_sqream}/client_drivers/index.rst (97%) rename {third_party_tools => connecting_to_sqream}/client_drivers/jdbc/index.rst (97%) rename {third_party_tools => connecting_to_sqream}/client_drivers/jdbc/sample.java (97%) rename {third_party_tools => connecting_to_sqream}/client_drivers/odbc/index.rst (96%) rename {third_party_tools => connecting_to_sqream}/client_drivers/odbc/install_configure_odbc_linux.rst (96%) rename {third_party_tools => connecting_to_sqream}/client_drivers/odbc/install_configure_odbc_windows.rst (97%) rename {third_party_tools => connecting_to_sqream}/connectivity_ecosystem.jpg (100%) rename {third_party_tools => connecting_to_sqream}/index.rst (95%) diff --git a/third_party_tools/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst similarity index 97% rename from third_party_tools/client_drivers/index.rst rename to connecting_to_sqream/client_drivers/index.rst index d0c60d804..79d1fd176 100644 --- a/third_party_tools/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -1,84 +1,84 @@ -.. _client_drivers: - -************************************ -Client Drivers for 2022.1 -************************************ - -The guides on this page describe how to use the Sqream DB client drivers and client applications with SQream. - -Client Driver Downloads -============================= - -All Operating Systems ---------------------------- -The following are applicable to all operating systems: - -.. _jdbc: - -* **JDBC** - recommended installation via ``mvn``: - - * `JDBC .jar file `_ - sqream-jdbc-4.5.3 (.jar) - * `JDBC driver `_ - -.. _tableau_connector: - -* **Tableau**: - - * `Tableau connector `_ - SQream (.taco) - * `Tableau manual installation `_ - - -.. _powerbi_connector: - -* **Power BI**: - - * `Power BI PowerQuery connector `_ - SQream (.mez) - * `Power BI manual installation `_ - - -Windows --------------- -The following are applicable to Windows: - -* **ODBC installer** - SQream Drivers v2020.2.0, with Tableau customizations. Please contact your `SSream represenative `_ for this installer. - - For more information on installing and configuring ODBC on Windows, see :ref:`Install and configure ODBC on Windows `. - -* **Net driver** - `SQream .Net driver v3.0.2 `_ - - - -Linux --------------- -The following are applicable to Linux: - -* `SQream SQL (x86_64) `_ - sqream-sql-v2020.1.1_stable.x86_64.tar.gz -* `Sqream SQL CLI Reference `_ - Interactive command-line SQL client for Intel-based machines - - :: - -* `SQream SQL*(IBM POWER9) `_ - sqream-sql-v2020.1.1_stable.ppc64le.tar.gz -* `Sqream SQL CLI Reference `_ - Interactive command-line SQL client for IBM POWER9-based machines - - :: - -* ODBC Installer - Please contact your SQream representative for this installer. - - -.. toctree:: - :maxdepth: 4 - :caption: Client Driver Documentation: - :titlesonly: - - jdbc/index - odbc/index - - - -.. rubric:: Need help? - -If you couldn't find what you're looking for, we're always happy to help. Visit `SQream's support portal `_ for additional support. - -.. rubric:: Looking for older drivers? - +.. _client_drivers: + +************************************ +Client Drivers for 2022.1 +************************************ + +The guides on this page describe how to use the Sqream DB client drivers and client applications with SQream. + +Client Driver Downloads +============================= + +All Operating Systems +--------------------------- +The following are applicable to all operating systems: + +.. _jdbc: + +* **JDBC** - recommended installation via ``mvn``: + + * `JDBC .jar file `_ - sqream-jdbc-4.5.3 (.jar) + * `JDBC driver `_ + +.. _tableau_connector: + +* **Tableau**: + + * `Tableau connector `_ - SQream (.taco) + * `Tableau manual installation `_ + + +.. _powerbi_connector: + +* **Power BI**: + + * `Power BI PowerQuery connector `_ - SQream (.mez) + * `Power BI manual installation `_ + + +Windows +-------------- +The following are applicable to Windows: + +* **ODBC installer** - SQream Drivers v2020.2.0, with Tableau customizations. Please contact your `SSream represenative `_ for this installer. + + For more information on installing and configuring ODBC on Windows, see :ref:`Install and configure ODBC on Windows `. + +* **Net driver** - `SQream .Net driver v3.0.2 `_ + + + +Linux +-------------- +The following are applicable to Linux: + +* `SQream SQL (x86_64) `_ - sqream-sql-v2020.1.1_stable.x86_64.tar.gz +* `Sqream SQL CLI Reference `_ - Interactive command-line SQL client for Intel-based machines + + :: + +* `SQream SQL*(IBM POWER9) `_ - sqream-sql-v2020.1.1_stable.ppc64le.tar.gz +* `Sqream SQL CLI Reference `_ - Interactive command-line SQL client for IBM POWER9-based machines + + :: + +* ODBC Installer - Please contact your SQream representative for this installer. + + +.. toctree:: + :maxdepth: 4 + :caption: Client Driver Documentation: + :titlesonly: + + jdbc/index + odbc/index + + + +.. rubric:: Need help? + +If you couldn't find what you're looking for, we're always happy to help. Visit `SQream's support portal `_ for additional support. + +.. rubric:: Looking for older drivers? + If you're looking for an older version of SQream DB drivers, versions 1.10 through 2019.2.1 are available at https://sqream.com/product/client-drivers/. \ No newline at end of file diff --git a/third_party_tools/client_drivers/jdbc/index.rst b/connecting_to_sqream/client_drivers/jdbc/index.rst similarity index 97% rename from third_party_tools/client_drivers/jdbc/index.rst rename to connecting_to_sqream/client_drivers/jdbc/index.rst index 4c35c3eff..832987efa 100644 --- a/third_party_tools/client_drivers/jdbc/index.rst +++ b/connecting_to_sqream/client_drivers/jdbc/index.rst @@ -1,171 +1,171 @@ -.. _java_jdbc: - -************************* -JDBC -************************* -The SQream JDBC driver lets you connect to SQream using many Java applications and tools. This page describes how to write a Java application using the JDBC interface. The JDBC driver requires Java 1.8 or newer. - -The JDBC page includes the following sections: - -.. contents:: - :local: - :depth: 1 - -Installing the JDBC Driver -================================== -The **Installing the JDBC Driver** section describes the following: - -.. contents:: - :local: - :depth: 1 - -Prerequisites ----------------- -The SQream JDBC driver requires Java 1.8 or newer, and SQream recommends using Oracle Java or OpenJDK.: - -* **Oracle Java** - Download and install `Java 8 `_ from Oracle for your platform. - - :: - -* **OpenJDK** - Install `OpenJDK `_ - - :: - -* **Windows** - SQream recommends installing `Zulu 8 `_ - -Getting the JAR file ---------------------- -SQream provides the JDBC driver as a zipped JAR file, available for download from the :ref:`client drivers download page`. This JAR file can be integrated into your Java-based applications or projects. - -Extracting the ZIP Archive -------------------------- -Run the following command to extract the JAR file from the ZIP archive: - -.. code-block:: console - - $ unzip sqream-jdbc-4.3.0.zip - -Setting Up the Class Path ----------------------------- -To use the driver, you must include the JAR named ``sqream-jdbc-.jar`` in the class path, either by inserting it in the ``CLASSPATH`` environment variable, or by using flags on the relevant Java command line. - -For example, if the JDBC driver has been unzipped to ``/home/sqream/sqream-jdbc-4.3.0.jar``, the following command is used to run application: - -.. code-block:: console - - $ export CLASSPATH=/home/sqream/sqream-jdbc-4.3.0.jar:$CLASSPATH - $ java my_java_app - -Alternatively, you can pass ``-classpath`` to the Java executable file: - -.. code-block:: console - - $ java -classpath .:/home/sqream/sqream-jdbc-4.3.0.jar my_java_app - -Connecting to SQream Using a JDBC Application -============================================== -You can connect to SQream using one of the following JDBC applications: - -.. contents:: - :local: - :depth: 1 - -Driver Class --------------- -Use ``com.sqream.jdbc.SQDriver`` as the driver class in the JDBC application. - -Connection String --------------------- -JDBC drivers rely on a connection string. - -The following is the syntax for SQream: - -.. code-block:: text - - jdbc:Sqream:///;user=;password=sqream;[; ...] - -Connection Parameters -^^^^^^^^^^^^^^^^^^^^^^^^ -The following table shows the connection string parameters: - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Item - - State - - Default - - Description - * - ```` - - Mandatory - - None - - Hostname and port of the SQream DB worker. For example, ``127.0.0.1:5000``, ``sqream.mynetwork.co:3108`` - * - ```` - - Mandatory - - None - - Database name to connect to. For example, ``master`` - * - ``username=`` - - Mandatory - - None - - Username of a role to use for connection. For example, ``username=rhendricks`` - * - ``password=`` - - Mandatory - - None - - Specifies the password of the selected role. For example, ``password=Tr0ub4dor&3`` - * - ``service=`` - - Optional - - ``sqream`` - - Specifices service queue to use. For example, ``service=etl`` - * - ```` - - Optional - - ``false`` - - Specifies SSL for this connection. For example, ``ssl=true`` - * - ```` - - Optional - - ``true`` - - Connect via load balancer (use only if exists, and check port). - * - ```` - - Optional - - ``true`` - - Enables on-demand loading, and defines double buffer size for result. The ``fetchSize`` parameter is rounded according to chunk size. For example, ``fetchSize=1`` loads one row and is rounded to one chunk. If the fetchSize is 100,600, a chunk size of 100,000 loads, and is rounded to, two chunks. - * - ```` - - Optional - - ``true`` - - Defines the bytes size for inserting a buffer before flushing data to the server. Clients running a parameterized insert (network insert) can define the amount of data to collect before flushing the buffer. - * - ```` - - Optional - - ``true`` - - Defines the logger level as either ``debug`` or ``trace``. - * - ```` - - Optional - - ``true`` - - Enables the file appender and defines the file name. The file name can be set as either the file name or the file path. - -Connection String Examples -^^^^^^^^^^^^^^^^^^^^^^^^^^^ -The following is an example of a SQream cluster with load balancer and no service queues (with SSL): - -.. code-block:: text - - jdbc:Sqream://sqream.mynetwork.co:3108/master;user=rhendricks;password=Tr0ub4dor&3;ssl=true;cluster=true - -The following is a minimal example for a local standalone SQream database: - -.. code-block:: text - - jdbc:Sqream://127.0.0.1:5000/master;user=rhendricks;password=Tr0ub4dor&3 - -The following is an example of a SQream cluster with load balancer and a specific service queue named ``etl``, to the database named ``raviga`` - -.. code-block:: text - - jdbc:Sqream://sqream.mynetwork.co:3108/raviga;user=rhendricks;password=Tr0ub4dor&3;cluster=true;service=etl - -Sample Java Program --------------------- -You can download the :download:`JDBC Application Sample File ` below by right-clicking and saving it to your computer. - -.. literalinclude:: sample.java - :language: java - :caption: JDBC Application Sample - :linenos: +.. _java_jdbc: + +************************* +JDBC +************************* +The SQream JDBC driver lets you connect to SQream using many Java applications and tools. This page describes how to write a Java application using the JDBC interface. The JDBC driver requires Java 1.8 or newer. + +The JDBC page includes the following sections: + +.. contents:: + :local: + :depth: 1 + +Installing the JDBC Driver +================================== +The **Installing the JDBC Driver** section describes the following: + +.. contents:: + :local: + :depth: 1 + +Prerequisites +---------------- +The SQream JDBC driver requires Java 1.8 or newer, and SQream recommends using Oracle Java or OpenJDK.: + +* **Oracle Java** - Download and install `Java 8 `_ from Oracle for your platform. + + :: + +* **OpenJDK** - Install `OpenJDK `_ + + :: + +* **Windows** - SQream recommends installing `Zulu 8 `_ + +Getting the JAR file +--------------------- +SQream provides the JDBC driver as a zipped JAR file, available for download from the :ref:`client drivers download page`. This JAR file can be integrated into your Java-based applications or projects. + +Extracting the ZIP Archive +------------------------- +Run the following command to extract the JAR file from the ZIP archive: + +.. code-block:: console + + $ unzip sqream-jdbc-4.3.0.zip + +Setting Up the Class Path +---------------------------- +To use the driver, you must include the JAR named ``sqream-jdbc-.jar`` in the class path, either by inserting it in the ``CLASSPATH`` environment variable, or by using flags on the relevant Java command line. + +For example, if the JDBC driver has been unzipped to ``/home/sqream/sqream-jdbc-4.3.0.jar``, the following command is used to run application: + +.. code-block:: console + + $ export CLASSPATH=/home/sqream/sqream-jdbc-4.3.0.jar:$CLASSPATH + $ java my_java_app + +Alternatively, you can pass ``-classpath`` to the Java executable file: + +.. code-block:: console + + $ java -classpath .:/home/sqream/sqream-jdbc-4.3.0.jar my_java_app + +Connecting to SQream Using a JDBC Application +============================================== +You can connect to SQream using one of the following JDBC applications: + +.. contents:: + :local: + :depth: 1 + +Driver Class +-------------- +Use ``com.sqream.jdbc.SQDriver`` as the driver class in the JDBC application. + +Connection String +-------------------- +JDBC drivers rely on a connection string. + +The following is the syntax for SQream: + +.. code-block:: text + + jdbc:Sqream:///;user=;password=sqream;[; ...] + +Connection Parameters +^^^^^^^^^^^^^^^^^^^^^^^^ +The following table shows the connection string parameters: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Item + - State + - Default + - Description + * - ```` + - Mandatory + - None + - Hostname and port of the SQream DB worker. For example, ``127.0.0.1:5000``, ``sqream.mynetwork.co:3108`` + * - ```` + - Mandatory + - None + - Database name to connect to. For example, ``master`` + * - ``username=`` + - Mandatory + - None + - Username of a role to use for connection. For example, ``username=rhendricks`` + * - ``password=`` + - Mandatory + - None + - Specifies the password of the selected role. For example, ``password=Tr0ub4dor&3`` + * - ``service=`` + - Optional + - ``sqream`` + - Specifices service queue to use. For example, ``service=etl`` + * - ```` + - Optional + - ``false`` + - Specifies SSL for this connection. For example, ``ssl=true`` + * - ```` + - Optional + - ``true`` + - Connect via load balancer (use only if exists, and check port). + * - ```` + - Optional + - ``true`` + - Enables on-demand loading, and defines double buffer size for result. The ``fetchSize`` parameter is rounded according to chunk size. For example, ``fetchSize=1`` loads one row and is rounded to one chunk. If the fetchSize is 100,600, a chunk size of 100,000 loads, and is rounded to, two chunks. + * - ```` + - Optional + - ``true`` + - Defines the bytes size for inserting a buffer before flushing data to the server. Clients running a parameterized insert (network insert) can define the amount of data to collect before flushing the buffer. + * - ```` + - Optional + - ``true`` + - Defines the logger level as either ``debug`` or ``trace``. + * - ```` + - Optional + - ``true`` + - Enables the file appender and defines the file name. The file name can be set as either the file name or the file path. + +Connection String Examples +^^^^^^^^^^^^^^^^^^^^^^^^^^^ +The following is an example of a SQream cluster with load balancer and no service queues (with SSL): + +.. code-block:: text + + jdbc:Sqream://sqream.mynetwork.co:3108/master;user=rhendricks;password=Tr0ub4dor&3;ssl=true;cluster=true + +The following is a minimal example for a local standalone SQream database: + +.. code-block:: text + + jdbc:Sqream://127.0.0.1:5000/master;user=rhendricks;password=Tr0ub4dor&3 + +The following is an example of a SQream cluster with load balancer and a specific service queue named ``etl``, to the database named ``raviga`` + +.. code-block:: text + + jdbc:Sqream://sqream.mynetwork.co:3108/raviga;user=rhendricks;password=Tr0ub4dor&3;cluster=true;service=etl + +Sample Java Program +-------------------- +You can download the :download:`JDBC Application Sample File ` below by right-clicking and saving it to your computer. + +.. literalinclude:: sample.java + :language: java + :caption: JDBC Application Sample + :linenos: diff --git a/third_party_tools/client_drivers/jdbc/sample.java b/connecting_to_sqream/client_drivers/jdbc/sample.java similarity index 97% rename from third_party_tools/client_drivers/jdbc/sample.java rename to connecting_to_sqream/client_drivers/jdbc/sample.java index 1b7af5804..3ff670747 100644 --- a/third_party_tools/client_drivers/jdbc/sample.java +++ b/connecting_to_sqream/client_drivers/jdbc/sample.java @@ -1,67 +1,67 @@ -import java.sql.Connection; -import java.sql.DatabaseMetaData; -import java.sql.DriverManager; -import java.sql.Statement; -import java.sql.ResultSet; - -import java.io.IOException; -import java.security.KeyManagementException; -import java.security.NoSuchAlgorithmException; -import java.sql.SQLException; - - - -public class SampleTest { - - // Replace with your connection string - static final String url = "jdbc:Sqream://sqream.mynetwork.co:3108/master;user=rhendricks;password=Tr0ub4dor&3;ssl=true;cluster=true"; - - // Allocate objects for result set and metadata - Connection conn = null; - Statement stmt = null; - ResultSet rs = null; - DatabaseMetaData dbmeta = null; - - int res = 0; - - public void testJDBC() throws SQLException, IOException { - - // Create a connection - conn = DriverManager.getConnection(url,"rhendricks","Tr0ub4dor&3"); - - // Create a table with a single integer column - String sql = "CREATE TABLE test (x INT)"; - stmt = conn.createStatement(); // Prepare the statement - stmt.execute(sql); // Execute the statement - stmt.close(); // Close the statement handle - - // Insert some values into the newly created table - sql = "INSERT INTO test VALUES (5),(6)"; - stmt = conn.createStatement(); - stmt.execute(sql); - stmt.close(); - - // Get values from the table - sql = "SELECT * FROM test"; - stmt = conn.createStatement(); - rs = stmt.executeQuery(sql); - // Fetch all results one-by-one - while(rs.next()) { - res = rs.getInt(1); - System.out.println(res); // Print results to screen - } - rs.close(); // Close the result set - stmt.close(); // Close the statement handle - } - - - public static void main(String[] args) throws SQLException, KeyManagementException, NoSuchAlgorithmException, IOException, ClassNotFoundException{ - - // Load SQream DB JDBC driver - Class.forName("com.sqream.jdbc.SQDriver"); - - // Create test object and run - SampleTest test = new SampleTest(); - test.testJDBC(); - } +import java.sql.Connection; +import java.sql.DatabaseMetaData; +import java.sql.DriverManager; +import java.sql.Statement; +import java.sql.ResultSet; + +import java.io.IOException; +import java.security.KeyManagementException; +import java.security.NoSuchAlgorithmException; +import java.sql.SQLException; + + + +public class SampleTest { + + // Replace with your connection string + static final String url = "jdbc:Sqream://sqream.mynetwork.co:3108/master;user=rhendricks;password=Tr0ub4dor&3;ssl=true;cluster=true"; + + // Allocate objects for result set and metadata + Connection conn = null; + Statement stmt = null; + ResultSet rs = null; + DatabaseMetaData dbmeta = null; + + int res = 0; + + public void testJDBC() throws SQLException, IOException { + + // Create a connection + conn = DriverManager.getConnection(url,"rhendricks","Tr0ub4dor&3"); + + // Create a table with a single integer column + String sql = "CREATE TABLE test (x INT)"; + stmt = conn.createStatement(); // Prepare the statement + stmt.execute(sql); // Execute the statement + stmt.close(); // Close the statement handle + + // Insert some values into the newly created table + sql = "INSERT INTO test VALUES (5),(6)"; + stmt = conn.createStatement(); + stmt.execute(sql); + stmt.close(); + + // Get values from the table + sql = "SELECT * FROM test"; + stmt = conn.createStatement(); + rs = stmt.executeQuery(sql); + // Fetch all results one-by-one + while(rs.next()) { + res = rs.getInt(1); + System.out.println(res); // Print results to screen + } + rs.close(); // Close the result set + stmt.close(); // Close the statement handle + } + + + public static void main(String[] args) throws SQLException, KeyManagementException, NoSuchAlgorithmException, IOException, ClassNotFoundException{ + + // Load SQream DB JDBC driver + Class.forName("com.sqream.jdbc.SQDriver"); + + // Create test object and run + SampleTest test = new SampleTest(); + test.testJDBC(); + } } \ No newline at end of file diff --git a/third_party_tools/client_drivers/odbc/index.rst b/connecting_to_sqream/client_drivers/odbc/index.rst similarity index 96% rename from third_party_tools/client_drivers/odbc/index.rst rename to connecting_to_sqream/client_drivers/odbc/index.rst index 7623b4e99..3ee093692 100644 --- a/third_party_tools/client_drivers/odbc/index.rst +++ b/connecting_to_sqream/client_drivers/odbc/index.rst @@ -1,58 +1,58 @@ -.. _odbc: - -************************* -ODBC -************************* - -.. toctree:: - :maxdepth: 1 - :titlesonly: - :hidden: - - install_configure_odbc_windows - install_configure_odbc_linux - -SQream has an ODBC driver to connect to SQream DB. This tutorial shows how to install the ODBC driver for Linux or Windows for use with applications like Tableau, PHP, and others that use ODBC. - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Platform - - Versions supported - - * - Windows - - * Windows 7 (64 bit) - * Windows 8 (64 bit) - * Windows 10 (64 bit) - * Windows Server 2008 R2 (64 bit) - * Windows Server 2012 - * Windows Server 2016 - * Windows Server 2019 - - * - Linux - - * Red Hat Enterprise Linux (RHEL) 7 - * CentOS 7 - * Ubuntu 16.04 - * Ubuntu 18.04 - -Other distributions may also work, but are not officially supported by SQream. - -.. contents:: In this topic: - :local: - -Downloading the ODBC driver -================================== - -The SQream DB ODBC driver is distributed by your SQream account manager. Before contacting your account manager, verify which platform the ODBC driver will be used on. Go to `SQream Support `_ or contact your SQream account manager to get the driver. - -The driver is provided as an executable installer for Windows, or a compressed tarball for Linux platforms. -After downloading the driver, follow the relevant instructions to install and configure the driver for your platform: - -Install and configure the ODBC driver -======================================= - -Continue based on your platform: - -* :ref:`install_odbc_windows` +.. _odbc: + +************************* +ODBC +************************* + +.. toctree:: + :maxdepth: 1 + :titlesonly: + :hidden: + + install_configure_odbc_windows + install_configure_odbc_linux + +SQream has an ODBC driver to connect to SQream DB. This tutorial shows how to install the ODBC driver for Linux or Windows for use with applications like Tableau, PHP, and others that use ODBC. + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Platform + - Versions supported + + * - Windows + - * Windows 7 (64 bit) + * Windows 8 (64 bit) + * Windows 10 (64 bit) + * Windows Server 2008 R2 (64 bit) + * Windows Server 2012 + * Windows Server 2016 + * Windows Server 2019 + + * - Linux + - * Red Hat Enterprise Linux (RHEL) 7 + * CentOS 7 + * Ubuntu 16.04 + * Ubuntu 18.04 + +Other distributions may also work, but are not officially supported by SQream. + +.. contents:: In this topic: + :local: + +Downloading the ODBC driver +================================== + +The SQream DB ODBC driver is distributed by your SQream account manager. Before contacting your account manager, verify which platform the ODBC driver will be used on. Go to `SQream Support `_ or contact your SQream account manager to get the driver. + +The driver is provided as an executable installer for Windows, or a compressed tarball for Linux platforms. +After downloading the driver, follow the relevant instructions to install and configure the driver for your platform: + +Install and configure the ODBC driver +======================================= + +Continue based on your platform: + +* :ref:`install_odbc_windows` * :ref:`install_odbc_linux` \ No newline at end of file diff --git a/third_party_tools/client_drivers/odbc/install_configure_odbc_linux.rst b/connecting_to_sqream/client_drivers/odbc/install_configure_odbc_linux.rst similarity index 96% rename from third_party_tools/client_drivers/odbc/install_configure_odbc_linux.rst rename to connecting_to_sqream/client_drivers/odbc/install_configure_odbc_linux.rst index 737768756..61919f161 100644 --- a/third_party_tools/client_drivers/odbc/install_configure_odbc_linux.rst +++ b/connecting_to_sqream/client_drivers/odbc/install_configure_odbc_linux.rst @@ -1,253 +1,253 @@ -.. _install_odbc_linux: - -**************************************** -Install and configure ODBC on Linux -**************************************** - -.. toctree:: - :maxdepth: 1 - :titlesonly: - :hidden: - - -The ODBC driver for Windows is provided as a shared library. - -This tutorial shows how to install and configure ODBC on Linux. - -.. contents:: In this topic: - :local: - :depth: 2 - -Prerequisites -============== - -.. _unixODBC: - -unixODBC ------------- - -The ODBC driver requires a driver manager to manage the DSNs. SQream DB's driver is built for unixODBC. - -Verify unixODBC is installed by running: - -.. code-block:: console - - $ odbcinst -j - unixODBC 2.3.4 - DRIVERS............: /etc/odbcinst.ini - SYSTEM DATA SOURCES: /etc/odbc.ini - FILE DATA SOURCES..: /etc/ODBCDataSources - USER DATA SOURCES..: /home/rhendricks/.odbc.ini - SQLULEN Size.......: 8 - SQLLEN Size........: 8 - SQLSETPOSIROW Size.: 8 - -Take note of the location of ``.odbc.ini`` and ``.odbcinst.ini``. In this case, ``/etc``. If ``odbcinst`` is not installed, follow the instructions for your platform below: - -.. contents:: Install unixODBC on: - :local: - :depth: 1 - -Install unixODBC on RHEL 7 / CentOS 7 -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -.. code-block:: console - - $ yum install -y unixODBC unixODBC-devel - -Install unixODBC on Ubuntu -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -.. code-block:: console - - $ sudo apt-get install unixodbc unixodbc-dev - - -Install the ODBC driver with a script -======================================= - -Use this method if you have never used ODBC on your machine before. If you have existing DSNs, see the manual install process below. - -#. Unpack the tarball - Copy the downloaded file to any directory, and untar it to a new directory: - - .. code-block:: console - - $ mkdir -p sqream_odbc64 - $ tar xf sqream_2019.2.1_odbc_3.0.0_x86_64_linux.tar.gz -C sqream_odbc64 - -#. Run the first-time installer. The installer will create an editable DSN. - - .. code-block:: console - - $ cd sqream_odbc64 - ./odbc_install.sh --install - - -#. Edit the DSN created by editing ``/etc/.odbc.ini``. See the parameter explanation in the section :ref:`ODBC DSN Parameters `. - - -Install the ODBC driver manually -======================================= - -Use this method when you have existing ODBC DSNs on your machine. - -#. Unpack the tarball - Copy the file you downloaded to the directory where you want to install it, and untar it: - - .. code-block:: console - - $ tar xf sqream_2019.2.1_odbc_3.0.0_x86_64_linux.tar.gz -C sqream_odbc64 - - Take note of the directory where the driver was unpacked. For example, ``/home/rhendricks/sqream_odbc64`` - -#. Locate the ``.odbc.ini`` and ``.odbcinst.ini`` files, using ``odbcinst -j``. - - #. In ``.odbcinst.ini``, add the following lines to register the driver (change the highlighted paths to match your specific driver): - - .. code-block:: ini - :emphasize-lines: 6,7 - - [ODBC Drivers] - SqreamODBCDriver=Installed - - [SqreamODBCDriver] - Description=Driver DSII SqreamODBC 64bit - Driver=/home/rhendricks/sqream_odbc64/sqream_odbc64.so - Setup=/home/rhendricks/sqream_odbc64/sqream_odbc64.so - APILevel=1 - ConnectFunctions=YYY - DriverODBCVer=03.80 - SQLLevel=1 - IconvEncoding=UCS-4LE - - #. In ``.odbc.ini``, add the following lines to configure the DSN (change the highlighted parameters to match your installation): - - .. code-block:: ini - :emphasize-lines: 6,7,8,9,10,11,12,13,14 - - [ODBC Data Sources] - MyTest=SqreamODBCDriver - - [MyTest] - Description=64-bit Sqream ODBC - Driver=/home/rhendricks/sqream_odbc64/sqream_odbc64.so - Server="127.0.0.1" - Port="5000" - Database="raviga" - Service="" - User="rhendricks" - Password="Tr0ub4dor&3" - Cluster=false - Ssl=false - - Parameters are in the form of ``parameter = value``. For details about the parameters that can be set for each DSN, see the section :ref:`ODBC DSN Parameters `. - - - #. Create a file called ``.sqream_odbc.ini`` for managing the driver settings and logging. - This file should be created alongside the other files, and add the following lines (change the highlighted parameters to match your installation): - - .. code-block:: ini - :emphasize-lines: 5,7 - - # Note that this default DriverManagerEncoding of UTF-32 is for iODBC. unixODBC uses UTF-16 by default. - # If unixODBC was compiled with -DSQL_WCHART_CONVERT, then UTF-32 is the correct value. - # Execute 'odbc_config --cflags' to determine if you need UTF-32 or UTF-16 on unixODBC - [Driver] - DriverManagerEncoding=UTF-16 - DriverLocale=en-US - ErrorMessagesPath=/home/rhendricks/sqream_odbc64/ErrorMessages - LogLevel=0 - LogNamespace= - LogPath=/tmp/ - ODBCInstLib=libodbcinst.so - - -Install the driver dependencies -================================== - -Add the ODBC driver path to ``LD_LIBRARY_PATH``: - -.. code-block:: console - - $ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rhendricks/sqream_odbc64/lib - -You can also add this previous command line to your ``~/.bashrc`` file in order to keep this installation working between reboots without re-entering the command manually - -Testing the connection -======================== - -Test the driver using ``isql``. - -If the DSN created is called ``MyTest`` as the example, run isql in this format: - -.. code-block:: console - - $ isql MyTest - - -.. _dsn_params: - -ODBC DSN Parameters -======================= - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Item - - Default - - Description - * - Data Source Name - - None - - An easily recognizable name that you'll use to reference this DSN. - * - Description - - None - - A description of this DSN for your convenience. This field can be left blank - * - User - - None - - Username of a role to use for connection. For example, ``User="rhendricks"`` - * - Password - - None - - Specifies the password of the selected role. For example, ``User="Tr0ub4dor&3"`` - * - Database - - None - - Specifies the database name to connect to. For example, ``Database="master"`` - * - Service - - ``sqream`` - - Specifices :ref:`service queue` to use. For example, ``Service="etl"``. Leave blank (``Service=""``) for default service ``sqream``. - * - Server - - None - - Hostname of the SQream DB worker. For example, ``Server="127.0.0.1"`` or ``Server="sqream.mynetwork.co"`` - * - Port - - None - - TCP port of the SQream DB worker. For example, ``Port="5000"`` or ``Port="3108"`` for the load balancer - * - Cluster - - ``false`` - - Connect via load balancer (use only if exists, and check port). For example, ``Cluster=true`` - * - Ssl - - ``false`` - - Specifies SSL for this connection. For example, ``Ssl=true`` - * - DriverManagerEncoding - - ``UTF-16`` - - Depending on how unixODBC is installed, you may need to change this to ``UTF-32``. - * - ErrorMessagesPath - - None - - Location where the driver was installed. For example, ``ErrorMessagePath=/home/rhendricks/sqream_odbc64/ErrorMessages``. - * - LogLevel - - 0 - - Set to 0-6 for logging. Use this setting when instructed to by SQream Support. For example, ``LogLevel=1`` - - .. hlist:: - :columns: 3 - - * 0 = Disable tracing - * 1 = Fatal only error tracing - * 2 = Error tracing - * 3 = Warning tracing - * 4 = Info tracing - * 5 = Debug tracing - * 6 = Detailed tracing - - - +.. _install_odbc_linux: + +**************************************** +Install and configure ODBC on Linux +**************************************** + +.. toctree:: + :maxdepth: 1 + :titlesonly: + :hidden: + + +The ODBC driver for Windows is provided as a shared library. + +This tutorial shows how to install and configure ODBC on Linux. + +.. contents:: In this topic: + :local: + :depth: 2 + +Prerequisites +============== + +.. _unixODBC: + +unixODBC +------------ + +The ODBC driver requires a driver manager to manage the DSNs. SQream DB's driver is built for unixODBC. + +Verify unixODBC is installed by running: + +.. code-block:: console + + $ odbcinst -j + unixODBC 2.3.4 + DRIVERS............: /etc/odbcinst.ini + SYSTEM DATA SOURCES: /etc/odbc.ini + FILE DATA SOURCES..: /etc/ODBCDataSources + USER DATA SOURCES..: /home/rhendricks/.odbc.ini + SQLULEN Size.......: 8 + SQLLEN Size........: 8 + SQLSETPOSIROW Size.: 8 + +Take note of the location of ``.odbc.ini`` and ``.odbcinst.ini``. In this case, ``/etc``. If ``odbcinst`` is not installed, follow the instructions for your platform below: + +.. contents:: Install unixODBC on: + :local: + :depth: 1 + +Install unixODBC on RHEL 7 / CentOS 7 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. code-block:: console + + $ yum install -y unixODBC unixODBC-devel + +Install unixODBC on Ubuntu +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. code-block:: console + + $ sudo apt-get install unixodbc unixodbc-dev + + +Install the ODBC driver with a script +======================================= + +Use this method if you have never used ODBC on your machine before. If you have existing DSNs, see the manual install process below. + +#. Unpack the tarball + Copy the downloaded file to any directory, and untar it to a new directory: + + .. code-block:: console + + $ mkdir -p sqream_odbc64 + $ tar xf sqream_2019.2.1_odbc_3.0.0_x86_64_linux.tar.gz -C sqream_odbc64 + +#. Run the first-time installer. The installer will create an editable DSN. + + .. code-block:: console + + $ cd sqream_odbc64 + ./odbc_install.sh --install + + +#. Edit the DSN created by editing ``/etc/.odbc.ini``. See the parameter explanation in the section :ref:`ODBC DSN Parameters `. + + +Install the ODBC driver manually +======================================= + +Use this method when you have existing ODBC DSNs on your machine. + +#. Unpack the tarball + Copy the file you downloaded to the directory where you want to install it, and untar it: + + .. code-block:: console + + $ tar xf sqream_2019.2.1_odbc_3.0.0_x86_64_linux.tar.gz -C sqream_odbc64 + + Take note of the directory where the driver was unpacked. For example, ``/home/rhendricks/sqream_odbc64`` + +#. Locate the ``.odbc.ini`` and ``.odbcinst.ini`` files, using ``odbcinst -j``. + + #. In ``.odbcinst.ini``, add the following lines to register the driver (change the highlighted paths to match your specific driver): + + .. code-block:: ini + :emphasize-lines: 6,7 + + [ODBC Drivers] + SqreamODBCDriver=Installed + + [SqreamODBCDriver] + Description=Driver DSII SqreamODBC 64bit + Driver=/home/rhendricks/sqream_odbc64/sqream_odbc64.so + Setup=/home/rhendricks/sqream_odbc64/sqream_odbc64.so + APILevel=1 + ConnectFunctions=YYY + DriverODBCVer=03.80 + SQLLevel=1 + IconvEncoding=UCS-4LE + + #. In ``.odbc.ini``, add the following lines to configure the DSN (change the highlighted parameters to match your installation): + + .. code-block:: ini + :emphasize-lines: 6,7,8,9,10,11,12,13,14 + + [ODBC Data Sources] + MyTest=SqreamODBCDriver + + [MyTest] + Description=64-bit Sqream ODBC + Driver=/home/rhendricks/sqream_odbc64/sqream_odbc64.so + Server="127.0.0.1" + Port="5000" + Database="raviga" + Service="" + User="rhendricks" + Password="Tr0ub4dor&3" + Cluster=false + Ssl=false + + Parameters are in the form of ``parameter = value``. For details about the parameters that can be set for each DSN, see the section :ref:`ODBC DSN Parameters `. + + + #. Create a file called ``.sqream_odbc.ini`` for managing the driver settings and logging. + This file should be created alongside the other files, and add the following lines (change the highlighted parameters to match your installation): + + .. code-block:: ini + :emphasize-lines: 5,7 + + # Note that this default DriverManagerEncoding of UTF-32 is for iODBC. unixODBC uses UTF-16 by default. + # If unixODBC was compiled with -DSQL_WCHART_CONVERT, then UTF-32 is the correct value. + # Execute 'odbc_config --cflags' to determine if you need UTF-32 or UTF-16 on unixODBC + [Driver] + DriverManagerEncoding=UTF-16 + DriverLocale=en-US + ErrorMessagesPath=/home/rhendricks/sqream_odbc64/ErrorMessages + LogLevel=0 + LogNamespace= + LogPath=/tmp/ + ODBCInstLib=libodbcinst.so + + +Install the driver dependencies +================================== + +Add the ODBC driver path to ``LD_LIBRARY_PATH``: + +.. code-block:: console + + $ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rhendricks/sqream_odbc64/lib + +You can also add this previous command line to your ``~/.bashrc`` file in order to keep this installation working between reboots without re-entering the command manually + +Testing the connection +======================== + +Test the driver using ``isql``. + +If the DSN created is called ``MyTest`` as the example, run isql in this format: + +.. code-block:: console + + $ isql MyTest + + +.. _dsn_params: + +ODBC DSN Parameters +======================= + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Item + - Default + - Description + * - Data Source Name + - None + - An easily recognizable name that you'll use to reference this DSN. + * - Description + - None + - A description of this DSN for your convenience. This field can be left blank + * - User + - None + - Username of a role to use for connection. For example, ``User="rhendricks"`` + * - Password + - None + - Specifies the password of the selected role. For example, ``User="Tr0ub4dor&3"`` + * - Database + - None + - Specifies the database name to connect to. For example, ``Database="master"`` + * - Service + - ``sqream`` + - Specifices :ref:`service queue` to use. For example, ``Service="etl"``. Leave blank (``Service=""``) for default service ``sqream``. + * - Server + - None + - Hostname of the SQream DB worker. For example, ``Server="127.0.0.1"`` or ``Server="sqream.mynetwork.co"`` + * - Port + - None + - TCP port of the SQream DB worker. For example, ``Port="5000"`` or ``Port="3108"`` for the load balancer + * - Cluster + - ``false`` + - Connect via load balancer (use only if exists, and check port). For example, ``Cluster=true`` + * - Ssl + - ``false`` + - Specifies SSL for this connection. For example, ``Ssl=true`` + * - DriverManagerEncoding + - ``UTF-16`` + - Depending on how unixODBC is installed, you may need to change this to ``UTF-32``. + * - ErrorMessagesPath + - None + - Location where the driver was installed. For example, ``ErrorMessagePath=/home/rhendricks/sqream_odbc64/ErrorMessages``. + * - LogLevel + - 0 + - Set to 0-6 for logging. Use this setting when instructed to by SQream Support. For example, ``LogLevel=1`` + + .. hlist:: + :columns: 3 + + * 0 = Disable tracing + * 1 = Fatal only error tracing + * 2 = Error tracing + * 3 = Warning tracing + * 4 = Info tracing + * 5 = Debug tracing + * 6 = Detailed tracing + + + diff --git a/third_party_tools/client_drivers/odbc/install_configure_odbc_windows.rst b/connecting_to_sqream/client_drivers/odbc/install_configure_odbc_windows.rst similarity index 97% rename from third_party_tools/client_drivers/odbc/install_configure_odbc_windows.rst rename to connecting_to_sqream/client_drivers/odbc/install_configure_odbc_windows.rst index 7749b44ab..4972e3057 100644 --- a/third_party_tools/client_drivers/odbc/install_configure_odbc_windows.rst +++ b/connecting_to_sqream/client_drivers/odbc/install_configure_odbc_windows.rst @@ -1,134 +1,134 @@ -.. _install_odbc_windows: - -**************************************** -Install and Configure ODBC on Windows -**************************************** - -The ODBC driver for Windows is provided as a self-contained installer. - -This tutorial shows you how to install and configure ODBC on Windows. - -.. contents:: In this topic: - :local: - :depth: 2 - -Installing the ODBC Driver -================================== - -Prerequisites ----------------- - -.. _vcredist: - -Visual Studio 2015 Redistributables -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -To install the ODBC driver you must first install Microsoft's **Visual C++ Redistributable for Visual Studio 2015**. To install Visual C++ Redistributable for Visual Studio 2015, see the `Install Instructions `_. - -Administrator Privileges -^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -The SQream DB ODBC driver requires administrator privileges on your computer to add the DSNs (data source names). - - -1. Run the Windows installer ------------------------------- - -Install the driver by following the on-screen instructions in the easy-to-follow installer. - -.. image:: /_static/images/odbc_windows_installer_screen1.png - -.. note:: The installer will install the driver in ``C:\Program Files\SQream Technologies\ODBC Driver`` by default. This path is changable during the installation. - -2. Selecting Components -^^^^^^^^^^^^^^^^^^^^^^^^^^ - -The installer includes additional components, like JDBC and Tableau customizations. - -.. image:: /_static/images/odbc_windows_installer_screen2.png - -You can deselect items you don't want to install, but the items named **ODBC Driver DLL** and **ODBC Driver Registry Keys** must remain selected for a complete installation of the ODBC driver. - -Once the installer finishes, you will be ready to configure the DSN for connection. - -.. _create_windows_odbc_dsn: - -3. Configuring the ODBC Driver DSN -====================================== - -ODBC driver configurations are done via DSNs. Each DSN represents one SQream DB database. - -#. Open up the Windows menu by clicking the Windows button on your keyboard (:kbd:`⊞ Win`) or pressing the Windows button with your mouse. - -#. Type **ODBC** and select **ODBC Data Sources (64-bit)**. Click the item to open up the setup window. - - .. image:: /_static/images/odbc_windows_startmenu.png - -#. The installer has created a sample User DSN named **SQreamDB** - - You can modify this DSN, or create a new one (:menuselection:`Add --> SQream ODBC Driver --> Next`) - - .. image:: /_static/images/odbc_windows_dsns.png - -#. Enter your connection parameters. See the reference below for a description of the parameters. - - .. image:: /_static/images/odbc_windows_dsn_config.png - -#. When completed, save the DSN by selecting :menuselection:`OK` - -.. tip:: Test the connection by clicking :menuselection:`Test` before saving. A successful test looks like this: - - .. image:: /_static/images/odbc_windows_dsn_test.png - -#. You can now use this DSN in ODBC applications like :ref:`Tableau `. - - - -Connection Parameters ------------------------ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Item - - Description - * - Data Source Name - - An easily recognizable name that you'll use to reference this DSN. Once you set this, it can not be changed. - * - Description - - A description of this DSN for your convenience. You can leave this blank. - * - User - - Username of a role to use for connection. For example, ``rhendricks`` - * - Password - - Specifies the password of the selected role. For example, ``Tr0ub4dor&3`` - * - Database - - Specifies the database name to connect to. For example, ``master`` - * - Service - - Specifices :ref:`service queue` to use. For example, ``etl``. Leave blank for default service ``sqream``. - * - Server - - Hostname of the SQream DB worker. For example, ``127.0.0.1`` or ``sqream.mynetwork.co`` - * - Port - - TCP port of the SQream DB worker. For example, ``5000`` or ``3108`` - * - User server picker - - Connect via load balancer (use only if exists, and check port) - * - SSL - - Specifies SSL for this connection - * - Logging options - - Use this screen to alter logging options when tracing the ODBC connection for possible connection issues. - - -Troubleshooting -================== - -Solving "Code 126" ODBC errors ---------------------------------- - -After installing the ODBC driver, you may experience the following error: - -.. code-block:: none - - The setup routines for the SQreamDriver64 ODBC driver could not be loaded due to system error - code 126: The specified module could not be found. - (c:\Program Files\SQream Technologies\ODBC Driver\sqreamOdbc64.dll) - -This is an issue with the Visual Studio Redistributable packages. Verify you've correctly installed them, as described in the :ref:`Visual Studio 2015 Redistributables ` section above. +.. _install_odbc_windows: + +**************************************** +Install and Configure ODBC on Windows +**************************************** + +The ODBC driver for Windows is provided as a self-contained installer. + +This tutorial shows you how to install and configure ODBC on Windows. + +.. contents:: In this topic: + :local: + :depth: 2 + +Installing the ODBC Driver +================================== + +Prerequisites +---------------- + +.. _vcredist: + +Visual Studio 2015 Redistributables +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +To install the ODBC driver you must first install Microsoft's **Visual C++ Redistributable for Visual Studio 2015**. To install Visual C++ Redistributable for Visual Studio 2015, see the `Install Instructions `_. + +Administrator Privileges +^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +The SQream DB ODBC driver requires administrator privileges on your computer to add the DSNs (data source names). + + +1. Run the Windows installer +------------------------------ + +Install the driver by following the on-screen instructions in the easy-to-follow installer. + +.. image:: /_static/images/odbc_windows_installer_screen1.png + +.. note:: The installer will install the driver in ``C:\Program Files\SQream Technologies\ODBC Driver`` by default. This path is changable during the installation. + +2. Selecting Components +^^^^^^^^^^^^^^^^^^^^^^^^^^ + +The installer includes additional components, like JDBC and Tableau customizations. + +.. image:: /_static/images/odbc_windows_installer_screen2.png + +You can deselect items you don't want to install, but the items named **ODBC Driver DLL** and **ODBC Driver Registry Keys** must remain selected for a complete installation of the ODBC driver. + +Once the installer finishes, you will be ready to configure the DSN for connection. + +.. _create_windows_odbc_dsn: + +3. Configuring the ODBC Driver DSN +====================================== + +ODBC driver configurations are done via DSNs. Each DSN represents one SQream DB database. + +#. Open up the Windows menu by clicking the Windows button on your keyboard (:kbd:`⊞ Win`) or pressing the Windows button with your mouse. + +#. Type **ODBC** and select **ODBC Data Sources (64-bit)**. Click the item to open up the setup window. + + .. image:: /_static/images/odbc_windows_startmenu.png + +#. The installer has created a sample User DSN named **SQreamDB** + + You can modify this DSN, or create a new one (:menuselection:`Add --> SQream ODBC Driver --> Next`) + + .. image:: /_static/images/odbc_windows_dsns.png + +#. Enter your connection parameters. See the reference below for a description of the parameters. + + .. image:: /_static/images/odbc_windows_dsn_config.png + +#. When completed, save the DSN by selecting :menuselection:`OK` + +.. tip:: Test the connection by clicking :menuselection:`Test` before saving. A successful test looks like this: + + .. image:: /_static/images/odbc_windows_dsn_test.png + +#. You can now use this DSN in ODBC applications like :ref:`Tableau `. + + + +Connection Parameters +----------------------- + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Item + - Description + * - Data Source Name + - An easily recognizable name that you'll use to reference this DSN. Once you set this, it can not be changed. + * - Description + - A description of this DSN for your convenience. You can leave this blank. + * - User + - Username of a role to use for connection. For example, ``rhendricks`` + * - Password + - Specifies the password of the selected role. For example, ``Tr0ub4dor&3`` + * - Database + - Specifies the database name to connect to. For example, ``master`` + * - Service + - Specifices :ref:`service queue` to use. For example, ``etl``. Leave blank for default service ``sqream``. + * - Server + - Hostname of the SQream DB worker. For example, ``127.0.0.1`` or ``sqream.mynetwork.co`` + * - Port + - TCP port of the SQream DB worker. For example, ``5000`` or ``3108`` + * - User server picker + - Connect via load balancer (use only if exists, and check port) + * - SSL + - Specifies SSL for this connection + * - Logging options + - Use this screen to alter logging options when tracing the ODBC connection for possible connection issues. + + +Troubleshooting +================== + +Solving "Code 126" ODBC errors +--------------------------------- + +After installing the ODBC driver, you may experience the following error: + +.. code-block:: none + + The setup routines for the SQreamDriver64 ODBC driver could not be loaded due to system error + code 126: The specified module could not be found. + (c:\Program Files\SQream Technologies\ODBC Driver\sqreamOdbc64.dll) + +This is an issue with the Visual Studio Redistributable packages. Verify you've correctly installed them, as described in the :ref:`Visual Studio 2015 Redistributables ` section above. diff --git a/third_party_tools/connectivity_ecosystem.jpg b/connecting_to_sqream/connectivity_ecosystem.jpg similarity index 100% rename from third_party_tools/connectivity_ecosystem.jpg rename to connecting_to_sqream/connectivity_ecosystem.jpg diff --git a/third_party_tools/index.rst b/connecting_to_sqream/index.rst similarity index 95% rename from third_party_tools/index.rst rename to connecting_to_sqream/index.rst index ee581e337..a790f085d 100644 --- a/third_party_tools/index.rst +++ b/connecting_to_sqream/index.rst @@ -1,17 +1,17 @@ -.. _third_party_tools: - -************************* -Third Party Tools -************************* -SQream supports the most common database tools and interfaces, giving you direct access through a variety of drivers, connectors, and visualiztion tools and utilities. The tools described on this page have been tested and approved for use with SQream. Most third party tools that work through JDBC, ODBC, and Python should work. - -This section provides information about the following third party tools: - -.. toctree:: - :maxdepth: 2 - :glob: - :titlesonly: - - client_drivers/index - +.. _third_party_tools: + +************************* +Connecting to SQream +************************* +SQream supports the most common database tools and interfaces, giving you direct access through a variety of drivers, connectors, and visualiztion tools and utilities. The tools described on this page have been tested and approved for use with SQream. Most third party tools that work through JDBC, ODBC, and Python should work. + +This section provides information about the following third party tools: + +.. toctree:: + :maxdepth: 2 + :glob: + :titlesonly: + + client_drivers/index + If you need a tool that SQream does not support, contact SQream Support or your SQream account manager for more information. \ No newline at end of file diff --git a/index.rst b/index.rst index 72731e378..db8e0fa2a 100644 --- a/index.rst +++ b/index.rst @@ -104,7 +104,7 @@ If you're looking for an older version of the documentation, versions 1.10 throu installation_guides/index data_ingestion/index connecting_to_sqream/index - loading_and_unloading/index + loading_and_unloading_data/index feature_guides/index operational_guides/index sqream_studio_5.4.3/index From 5c18f92de9ad9a0f7427c43a33ff3f0124d40daf Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 10 Jul 2022 17:50:53 +0300 Subject: [PATCH 107/882] Corrected links. --- loading_and_unloading_data/index.rst | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/loading_and_unloading_data/index.rst b/loading_and_unloading_data/index.rst index ae5c506bb..bc515f023 100644 --- a/loading_and_unloading_data/index.rst +++ b/loading_and_unloading_data/index.rst @@ -5,32 +5,32 @@ Loading and Unloading Data *********************** The **Loading Data** section describes concepts and operations related to importing data into your SQream database: -* `Overview of loading data `_ - Describes best practices and considerations for loading data into SQream from a variety of sources and locations. +* `Overview of loading data `_ - Describes best practices and considerations for loading data into SQream from a variety of sources and locations. -* `Alternatives to loading data (foreign tables) `_ - Useful for running queries directly on external data without importing into your SQream database. +* `Alternatives to loading data (foreign tables) `_ - Useful for running queries directly on external data without importing into your SQream database. -* `Supported data types `_ - Overview of supported data types, including descriptions, examples, and relevant aliases. +* `Supported data types `_ - Overview of supported data types, including descriptions, examples, and relevant aliases. -* `Ingesting data from external sources `_ - List of data ingestion sources that SQream supports. +* `Ingesting data from external sources `_ - List of data ingestion sources that SQream supports. -* `Inserting data from external tables `_ - Inserts one or more rows into a table. +* `Inserting data from external tables `_ - Inserts one or more rows into a table. -* `Ingesting data from third party client platforms `_ - Gives you direct access to a variety of drivers, connectors, tools, vizualisers, and utilities.. +* `Ingesting data from third party client platforms `_ - Gives you direct access to a variety of drivers, connectors, tools, vizualisers, and utilities.. -* `Using the COPY FROM statement `_ - Used for loading data from files located on a filesystem into SQream tables. +* `Using the COPY FROM statement `_ - Used for loading data from files located on a filesystem into SQream tables. -* `Importing data using Studio `_ - SQream's web-based client providing users with all functionality available from the command line in an intuitive and easy-to-use format. +* `Importing data using Studio `_ - SQream's web-based client providing users with all functionality available from the command line in an intuitive and easy-to-use format. -* `Loading data using Amazon S3 `_ - Used for loading data from Amazon S3. +* `Loading data using Amazon S3 `_ - Used for loading data from Amazon S3. * Troubleshooting - Describes troubleshooting solutions related to importing data from the following: - * `SAS Viya `_ + * `SAS Viya `_ - * `Tableau `_ + * `Tableau `_ The **Unloading Data** section describes concepts and operations related to exporting data from your SQream database: -* `Overview of unloading data `_ - Describes best practices and considerations for unloading data from SQream to a variety of sources and locations. +* `Overview of unloading data `_ - Describes best practices and considerations for unloading data from SQream to a variety of sources and locations. -* `The COPY TO statement `_ - Used for unloading data from a SQream database table or query to a file on a filesystem. \ No newline at end of file +* `The COPY TO statement `_ - Used for unloading data from a SQream database table or query to a file on a filesystem. \ No newline at end of file From 97c150d3d44aaadc2f7585f52887673b0b6dced8 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 10 Jul 2022 18:54:57 +0300 Subject: [PATCH 108/882] Update inserting_data.rst --- data_ingestion/inserting_data.rst | 196 ++++++++++++++++-------------- 1 file changed, 103 insertions(+), 93 deletions(-) diff --git a/data_ingestion/inserting_data.rst b/data_ingestion/inserting_data.rst index 42ac36ceb..e20e37920 100644 --- a/data_ingestion/inserting_data.rst +++ b/data_ingestion/inserting_data.rst @@ -3,138 +3,161 @@ *************************** Inserting Data Overview *************************** +The **Inserting Data Overview** page provides basic information useful when ingesting data into SQream from a variety of sources and locations, and describes the following: -The **Inserting Data Overview** page describes how to insert data into SQream, specifically how to insert data from a variety of sources and locations. - -.. contents:: In this topic: +.. contents:: :local: - - + :depth: 1 + Getting Started ================================ +SQream supports ingesting data using the following methods: -SQream supports importing data from the following sources: +* Executing the ``INSERT`` statement using a client driver. -* Using :ref:`insert` with :ref:`a client driver` -* Using :ref:`copy_from`: + :: + +* Executing the ``COPY FROM`` statement or ingesting data from foreign tables: - - Local filesystem and locally mounted network filesystems - - :ref:`s3` - - :ref:`hdfs` + * Local filesystem and locally mounted network filesystems + * Inserting Data using the Amazon S3 object storage service + * Inserting Data using an HDFS data storage system -* Using :ref:`external_tables`: +SQream supports loading files from the following formats: - - Local filesystem and locally mounted network filesystems - - :ref:`s3` - - :ref:`hdfs` +* Text - CSV, TSV, and PSV +* Parquet +* ORC +For more information, see the following: -SQream DB supports loading files in the following formats: +* Using the ``INSERT`` statement - :ref:`insert` -* Text - CSV, TSV, PSV -* Parquet -* ORC +* Using client drivers - :ref:`Client drivers` + +* Using the ``COPY FROM`` statement - :ref:`copy_from` + +* Using the Amazon S3 object storage service - :ref:`s3` + +* Using the HDFS data storage system - :ref:`hdfs` + +* Loading data from foreign tables - :ref:`foreign_tables` Data Loading Considerations ================================ +The **Data Loading Considerations** section describes the following: +.. contents:: + :local: + :depth: 1 + Verifying Data and Performance after Loading ----------------------------------------- +Like many RDBMSs, SQream recommends its own set of best practices for table design and query optimization. When using SQream, verify the following: -Like other RDBMSs, SQream DB has its own set of best practcies for table design and query optimization. - -SQream therefore recommends: +* That your data is structured as you expect (row counts, data types, formatting, content). -* Verify that the data is as you expect it (e.g. row counts, data types, formatting, content) +* That your query performance is adequate. -* The performance of your queries is adequate +* That you followed the table design best practices (:ref:`Optimization and Best Practices`). -* :ref:`Best practices` were followed for table design +* That you've tested and verified that your applications work (such as :ref:`Tableau`). -* Applications such as :ref:`Tableau` and others have been tested, and work +* That your data types have not been not over-provisioned. File Soure Location when Loading -------------------------------- +While you are loading data, you can use the ``COPY FROM`` command to let statements run on any worker. If you are running multiple nodes, verify that all nodes can see the source the same. Loading data from a local file that is only on one node and not on shared storage may cause it to fail. If required, you can also control which node a statement runs on using the Workload Manager). -During loading using :ref:`copy_from`, the statement can run on any worker. If you are running multiple nodes, make sure that all nodes can see the source the same. If you load from a local file which is only on 1 node and not on shared storage, it will fail some of the time. (If you need to, you can also control which node a statement runs on using the :ref:`workload_manager`). +For more information, see the following: -Supported load methods +* :ref:`copy_from` + +* :ref:`workload_manager` + +Supported Load Methods ------------------------------- +You can use the ``COPY FROM`` syntax to load CSV files. -SQream DB's :ref:`COPY FROM` syntax can be used to load CSV files, but can't be used for Parquet and ORC. +.. note:: The ``COPY FROM`` cannot be used for loading data from Parquet and ORC files. -:ref:`FOREIGN TABLE` can be used to load text files, Parquet, and ORC files, and can also transform the data prior to materialization as a full table. +You can use foreign tables to load text files, Parquet, and ORC files, and to transform your data before generating a full table, as described in the following table: .. list-table:: :widths: auto :header-rows: 1 :stub-columns: 1 - * - Method / File type + * - Method/File Type - Text (CSV) - Parquet - ORC - - Streaming data - * - :ref:`copy_from` + - Streaming Data + * - COPY FROM - Supported - Not supported - Not supported - Not supported - * - :ref:`external_tables` + * - Foreign tables - Supported - Supported - Supported - Not supported - * - :ref:`insert` + * - INSERT - Not supported - Not supported - Not supported - Supported (Python, JDBC, Node.JS) + +For more information, see the following: -Unsupported Data Types ------------------------------ +* :ref:`COPY FROM` + +* :ref:`Foreign tables` -SQream DB doesn't support the entire set of features that some other database systems may have, such as ``ARRAY``, ``BLOB``, ``ENUM``, ``SET``, etc. +* :ref:`INSERT` -These data types will have to be converted before load. For example, ``ENUM`` can often be stored as a ``TEXT``. +Unsupported Data Types +----------------------------- +SQream does not support certain features that are supported by other databases, such as ``ARRAY``, ``BLOB``, ``ENUM``, and ``SET``. You must convert these data types before loading them. For example, you can store ``ENUM`` as ``TEXT``. Handing Extended Errors ---------------------------- +While you can use foreign tables to load CSVs, the ``COPY FROM`` statement provides more fine-grained error handling options and extended support for non-standard CSVs with multi-character delimiters, alternate timestamp formats, and more. -While :ref:`external tables` can be used to load CSVs, the ``COPY FROM`` statement provides more fine-grained error handling options, as well as extended support for non-standard CSVs with multi-character delimiters, alternate timestamp formats, and more. +For more information, see :ref:`foreign tables`. Best Practices for CSV ------------------------------ +Text files, such as CSV, rarely conform to `RFC 4180 `_ , so you may need to make the following modifications: -Text files like CSV rarely conform to `RFC 4180 `_ , so alterations may be required: - -* Use ``OFFSET 2`` for files containing header rows +* Use ``OFFSET 2`` for files containing header rows. -* Failed rows can be captured in a log file for later analysis, or just to skip them. See :ref:`capturing_rejected_rows` for information on skipping rejected rows. +* You can capture failed rows in a log file for later analysis, or skip them. See :ref:`capturing_rejected_rows` for information on skipping rejected rows. -* Record delimiters (new lines) can be modified with the :ref:`RECORD DELIMITER` syntax. +* You can modify record delimiters (new lines) using the :ref:`RECORD DELIMITER` syntax. -* If the date formats differ from ISO 8601, refer to the :ref:`copy_date_parsers` section to see how to override default parsing. +* If the date formats deviate from ISO 8601, refer to the :ref:`copy_date_parsers` section for overriding the default parsing. -* - Fields in a CSV can be optionally quoted with double-quotes (``"``). However, any field containing a newline or another double-quote character must be quoted. +* *(Optional)* You can quote fields in a CSV using double-quotes (``"``). - If a field is quoted, any double quote that appears must be double-quoted (similar to the :ref:`string literals quoting rules`. For example, to encode ``What are "birds"?``, the field should appear as ``"What are ""birds""?"``. +.. note:: You must quote any field containing a new line or another double-quote character. -* Field delimiters don't have a to be a displayable ASCII character. See :ref:`field_delimiters` for all options. +* If a field is quoted, you must double quote any double quote, similar to the **string literals quoting rules**. For example, to encode ``What are "birds"?``, the field should appear as ``"What are ""birds""?"``. For more information, see :ref:`string literals quoting rules`. +* Field delimiters do not have to be a displayable ASCII character. For all supported field delimiters, see :ref:`field_delimiters`. Best Practices for Parquet -------------------------------- +The following list shows the best practices when inserting data from Parquet files: -* Parquet files are loaded through :ref:`external_tables`. The destination table structure has to match in number of columns between the source files. +* You must load Parquet files through :ref:`foreign_tables`. Note that the destination table structure must be identical to the number of columns between the source files. -* Parquet files support predicate pushdown. When a query is issued over Parquet files, SQream DB uses row-group metadata to determine which row-groups in a file need to be read for a particular query and the row indexes can narrow the search to a particular set of rows. +* Parquet files support **predicate pushdown**. When a query is issued over Parquet files, SQream uses row-group metadata to determine which row-groups in a file must be read for a particular query and the row indexes can narrow the search to a particular set of rows. -Type Support and Behavior Notes +Supported Types and Behavior Notes ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -* Unlike ORC, the column types should match the data types exactly (see table below). +Unlike the ORC format, the column types should match the data types exactly, as shown in the table below: .. list-table:: :widths: auto @@ -155,7 +178,7 @@ Type Support and Behavior Notes - ``DATE`` - ``DATETIME`` * - ``BOOLEAN`` - - ✓ + - Supported - - - @@ -168,7 +191,7 @@ Type Support and Behavior Notes * - ``INT16`` - - - - ✓ + - Supported - - - @@ -180,7 +203,7 @@ Type Support and Behavior Notes - - - - - ✓ + - Supported - - - @@ -192,7 +215,7 @@ Type Support and Behavior Notes - - - - - ✓ + - Supported - - - @@ -204,7 +227,7 @@ Type Support and Behavior Notes - - - - - ✓ + - Supported - - - @@ -216,7 +239,7 @@ Type Support and Behavior Notes - - - - - ✓ + - Supported - - - @@ -228,7 +251,7 @@ Type Support and Behavior Notes - - - - - ✓ + - Supported - - * - ``INT96`` [#f3]_ @@ -241,31 +264,34 @@ Type Support and Behavior Notes - - - - - ✓ [#f4]_ + - Supported [#f4]_ -* If a Parquet file has an unsupported type like ``enum``, ``uuid``, ``time``, ``json``, ``bson``, ``lists``, ``maps``, but the data is not referenced in the table (it does not appear in the :ref:`SELECT` query), the statement will succeed. If the column is referenced, an error will be thrown to the user, explaining that the type is not supported, but the column may be ommited. +If a Parquet file has an unsupported type, such as ``enum``, ``uuid``, ``time``, ``json``, ``bson``, ``lists``, ``maps``, but the table does not reference this data (i.e., the data does not appear in the :ref:`SELECT` query), the statement will succeed. If the table **does** reference a column, an error will be displayed explaining that the type is not supported, but the column may be omitted. Best Practices for ORC -------------------------------- +The following list shows the best practices when inserting data from ORC files: -* ORC files are loaded through :ref:`external_tables`. The destination table structure has to match in number of columns between the source files. +* You must load ORC files through :ref:`foreign_tables`. Note that the destination table structure must be identical to the number of columns between the source files. -* ORC files support predicate pushdown. When a query is issued over ORC files, SQream DB uses ORC metadata to determine which stripes in a file need to be read for a particular query and the row indexes can narrow the search to a particular set of 10,000 rows. +* ORC files support **predicate pushdown**. When a query is issued over ORC files, SQream uses ORC metadata to determine which stripes in a file need to be read for a particular query and the row indexes can narrow the search to a particular set of 10,000 rows. Type Support and Behavior Notes ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +You must load ORC files through foreign table. Note that the destination table structure must be identical to the number of columns between the source files. -* ORC files are loaded through :ref:`external_tables`. The destination table structure has to match in number of columns between the source files. +For more information, see :ref:`foreign_tables`. -* The types should match to some extent within the same "class" (see table below). +The types should match to some extent within the same "class", as shown in the following table: .. list-table:: - :widths: 5 5 70 70 70 70 5 5 5 5 5 + :widths: auto :header-rows: 1 + :stub-columns: 1 - * - SQream DB type → + * - SQream DB Type → - ORC source + ORC Source - ``BOOL`` - ``TINYINT`` - ``SMALLINT`` @@ -273,7 +299,7 @@ Type Support and Behavior Notes - ``BIGINT`` - ``REAL`` - ``DOUBLE`` - - ``Text`` [#f0]_ + - Text [#f0]_ - ``DATE`` - ``DATETIME`` * - ``boolean`` @@ -353,7 +379,7 @@ Type Support and Behavior Notes - - - - * - ``string`` / ``char`` / ``text`` + * - ``string`` / ``char`` / ``varchar`` - - - @@ -432,31 +458,15 @@ Type Support and Behavior Notes Further Reading and Migration Guides ======================================= - -.. toctree:: - :caption: Data loading guides - :titlesonly: - - migration/csv - migration/parquet - migration/orc - -.. toctree:: - :caption: Migration guides - :titlesonly: - - migration/oracle - - -.. rubric:: See also: +For more information, see the following: * :ref:`copy_from` * :ref:`insert` -* :ref:`external_tables` +* :ref:`foreign_tables` .. rubric:: Footnotes -.. [#f0] Text values include ``TEXT`` +.. [#f0] Text values include ``TEXT``, ``VARCHAR``, and ``NVARCHAR`` .. [#f2] With UTF8 annotation @@ -468,4 +478,4 @@ Further Reading and Migration Guides .. [#f6] Will succeed if all values are 0, 1 -.. [#f7] Will succeed if all values fit the destination type +.. [#f7] Will succeed if all values fit the destination type \ No newline at end of file From 00aeb5eed444ba49cdeea40ce957d88c05abc4e9 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 12 Jul 2022 18:21:00 +0300 Subject: [PATCH 109/882] SQ-10818 --- reference/sql/sql_statements/index.rst | 8 +- .../get_role_database_ddl.rst | 61 +++++++++++++++ .../utility_commands/get_role_global_ddl.rst | 61 +++++++++++++++ .../utility_commands/get_role_permissions.rst | 74 +++++++++++++++++++ 4 files changed, 203 insertions(+), 1 deletion(-) create mode 100644 reference/sql/sql_statements/utility_commands/get_role_database_ddl.rst create mode 100644 reference/sql/sql_statements/utility_commands/get_role_global_ddl.rst create mode 100644 reference/sql/sql_statements/utility_commands/get_role_permissions.rst diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index e3ebf5aae..1a075f69e 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -168,7 +168,7 @@ The following table shows the Access Control commands: .. list-table:: :widths: 10 100 - :header-rows: 1 + :header-rows: 1 * - Command - Usage @@ -180,6 +180,12 @@ The following table shows the Access Control commands: - Creates a roles, which lets a database administrator control permissions on tables and databases * - :ref:`drop_role` - Removes roles + * - :ref:`get_role_permissions` + - Returns all permissions granted to a role in table format + * - :ref:`get_role_global_ddl` + - Returns the definition of a global role in DDL format + * - :ref:`get_role_database_ddl` + - Returns the definition of a database role in DDL format * - :ref:`get_statement_permissions` - Returns a list of permissions required to run a statement or query * - :ref:`grant` diff --git a/reference/sql/sql_statements/utility_commands/get_role_database_ddl.rst b/reference/sql/sql_statements/utility_commands/get_role_database_ddl.rst new file mode 100644 index 000000000..e6b806244 --- /dev/null +++ b/reference/sql/sql_statements/utility_commands/get_role_database_ddl.rst @@ -0,0 +1,61 @@ +.. _get_role_database_ddl: + +******************** +GET_ROLE_DATABASE_DDL +******************** +The ``GET_ROLE_DATABASE_DDL`` statement returns the definition of a global role in DDL format. + +The ``GET_ROLE_DATABASE_DDL`` page describes the following: + +.. contents:: + :local: + :depth: 1 + +Syntax +========== +The following is the correct syntax for using the ``GET_ROLE_DATABASE_DDL`` statement: + +.. code-block:: postgres + + select get_role_database_ddl(<'role_name'>) + +Example +=========== +The following is an example of using the ``GET_ROLE_GLOBAL_DDL`` statement: + +.. code-block:: psql + + select get_role_global_ddl('public'); + +Parameters +============ +The following table shows the ``GET_ROLE_DATABASE_DDL`` parameters: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``role_name`` + - The definition of the database role in DDL format. + +Output +========== +The following is an example of the output of the ``GET_ROLE_DATABASE_DDL`` statement: + +.. code-block:: postgres + + grant create, usage on schema "public" to "public" ; alter default schema for "public" to "public"; alter default permissions for "public" for schemas grant superuser to creator_role ; alter default permissions for "public" for tables grant select, insert, delete, ddl to creator_role ; + +Permissions +============= +Using the ``GET_ROLE_DATABASE_DDL`` statement requires no special permissions. + +For more information, see the following: + +* :ref:`get_role_global_ddl` + + :: + +* :ref:`get_role_permissions` \ No newline at end of file diff --git a/reference/sql/sql_statements/utility_commands/get_role_global_ddl.rst b/reference/sql/sql_statements/utility_commands/get_role_global_ddl.rst new file mode 100644 index 000000000..3ba0255d3 --- /dev/null +++ b/reference/sql/sql_statements/utility_commands/get_role_global_ddl.rst @@ -0,0 +1,61 @@ +.. _get_role_global_ddl: + +******************** +GET_ROLE_GLOBAL_DDL +******************** +The ``GET_ROLE_GLOBAL_DDL`` statement returns the definition of a global role in DDL format. + +The ``GET_ROLE_GLOBAL_DDL`` page describes the following: + +.. contents:: + :local: + :depth: 1 + +Syntax +========== +The following is the correct syntax for using the ``GET_ROLE_GLOBAL_DDL`` statement: + +.. code-block:: postgres + + select get_role_global_ddl(<'role_name'>) + +Example +=========== +The following is an example of using the ``GET_ROLE_GLOBAL_DDL`` statement: + +.. code-block:: psql + + select get_role_global_ddl('public'); + +Parameters +============ +The following table shows the ``GET_ROLE_GLOBAL_DDL`` parameters: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``role_name`` + - The definition of the global role in DDL format. + +Output +========== +The following is an example of the output of the ``GET_ROLE_GLOBAL_DDL`` statement: + +.. code-block:: postgres + + create role "public"; + +Permissions +============= +Using the ``GET_ROLE_GLOBAL_DDL`` statement requires no special permissions. + +For more information, see the following: + +* :ref:`get_role_database_ddl` + + :: + +* :ref:`get_role_permissions` \ No newline at end of file diff --git a/reference/sql/sql_statements/utility_commands/get_role_permissions.rst b/reference/sql/sql_statements/utility_commands/get_role_permissions.rst new file mode 100644 index 000000000..8723f98c8 --- /dev/null +++ b/reference/sql/sql_statements/utility_commands/get_role_permissions.rst @@ -0,0 +1,74 @@ +.. _get_role_permissions: + +******************** +GET_ROLE_PERMISSIONS +******************** +The ``GET_ROLE_PERMISSIONS`` statement returns all permissions granted to a role in table format. + +The ``GET_ROLE_PERMISSIONS`` page describes the following: + +.. contents:: + :local: + :depth: 1 + +Syntax +========== +The following is the correct syntax for using the ``GET_ROLE_PERMISSIONS`` statement: + +.. code-block:: postgres + + select get_role_permissions() + +Example +=========== +The following is an example of using the ``GET_ROLE_PERMISSIONS`` statement: + +.. code-block:: psql + + select get_role_permissions(); + +Parameters +============ +The following table shows the ``GET_ROLE_PERMISSIONS`` parameters: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``()`` + - The permissions belonging to the role. + +Output +========== +The following is an example of the output of the ``GET_ROLE_PERMISSIONS`` statement: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + - Example + * - ``permission_type`` + - The permission type granted to the role. + - SUPERUSER + * - ``object_type`` + - The data object type. + - table + * - ``object_name`` + - The name of the object. + - master.public.nba + +Permissions +============= +Using the ``GET_ROLE_PERMISSIONS`` statement requires no special permissions. + +For more information, see the following: + +* :ref:`get_role_database_ddl` + + :: + +* :ref:`get_role_global_ddl` \ No newline at end of file From 90d7637f7116d0399b99fecfb07d00c662936c7f Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Wed, 13 Jul 2022 08:11:03 +0300 Subject: [PATCH 110/882] Update create_table.rst --- .../sql_statements/ddl_commands/create_table.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/reference/sql/sql_statements/ddl_commands/create_table.rst b/reference/sql/sql_statements/ddl_commands/create_table.rst index 51f46582b..eb25baa8a 100644 --- a/reference/sql/sql_statements/ddl_commands/create_table.rst +++ b/reference/sql/sql_statements/ddl_commands/create_table.rst @@ -74,7 +74,7 @@ Default Value Constraints The ``DEFAULT`` value constraint specifies a value to use if one is not defined in an :ref:`insert` or :ref:`copy_from` statement. -The value may be a literal, which is evaluated at the time the row is created. +The value may either be a literal, **GETDATE()**, or Null, which is evaluated at the time the row is created. .. note:: The ``DEFAULT`` constraint only applies if the column does not have a value specified in the :ref:`insert` or :ref:`copy_from` statement. You can still insert a ``NULL`` into an nullable column by explicitly inserting ``NULL``. For example, ``INSERT INTO cool_animals VALUES (1, 'Gnu', NULL)``. @@ -141,7 +141,7 @@ The following is an example of the syntax used to create a standard table: CREATE TABLE cool_animals ( id INT NOT NULL, - name varchar(30) NOT NULL, + name text(30) NOT NULL, weight FLOAT, is_agressive BOOL ); @@ -155,7 +155,7 @@ The following is an example of the syntax used to create a table with default va CREATE TABLE cool_animals ( id INT NOT NULL, - name varchar(30) NOT NULL, + name text(30) NOT NULL, weight FLOAT, is_agressive BOOL DEFAULT false NOT NULL ); @@ -171,8 +171,8 @@ The following is an example of the syntax used to create a table with an identit CREATE TABLE users ( id BIGINT IDENTITY(0,1) NOT NULL , -- Start with 0, increment by 1 - name VARCHAR(30) NOT NULL, - country VARCHAR(30) DEFAULT 'Unknown' NOT NULL + name TEXT(30) NOT NULL, + country TEXT(30) DEFAULT 'Unknown' NOT NULL ); .. note:: @@ -203,9 +203,9 @@ The following is an example of the syntax used to create a table with a clusteri .. code-block:: postgres CREATE TABLE users ( - name VARCHAR(30) NOT NULL, + name TEXT(30) NOT NULL, start_date datetime not null, - country VARCHAR(30) DEFAULT 'Unknown' NOT NULL + country TEXT(30) DEFAULT 'Unknown' NOT NULL ) CLUSTER BY start_date; For more information on data clustering, see :ref:`data_clustering`. From 012d0e9f4debe6c5f58e70ac04ba64916e36b7e0 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 14 Jul 2022 11:56:35 +0300 Subject: [PATCH 111/882] Update 2021.2.1.rst Added Resolved Issues and Known Issues for minor patches: 2021.2.1.1 and 2021.2.1.23. NOTE: These bugs have NOT YET been filtered for external vs internal, which Eyal W is working on now. This means that I will remove some of these bugs once he's created the filter. THIS IS NOT PUBLISHED. --- releases/2021.2.1.rst | 57 ++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 54 insertions(+), 3 deletions(-) diff --git a/releases/2021.2.1.rst b/releases/2021.2.1.rst index f17bdd516..063143529 100644 --- a/releases/2021.2.1.rst +++ b/releases/2021.2.1.rst @@ -45,7 +45,6 @@ For more information, see `Deleting Values that Contain Multi-Table Conditions < For more information, see :ref:`regexp_replace`. - Performance Enhancements ------ The **Performance Enhancements** section is not relevant to Version 2021.2.1. @@ -61,13 +60,65 @@ The following table lists the issues that were resolved in Version 2021.2.1: * - SQ No. - Description * - SQ-8267 - - A method has been provided for including the ``GROUP BY`` and ``DISTINCT COUNT`` statements. - + - A method has been provided for including the ``GROUP BY`` and ``DISTINCT COUNT`` statements. + +The following table lists the issues that were resolved in Version 2021.2.1.1: + +.. list-table:: + :widths: 17 200 + :header-rows: 1 + + * - SQ No. + - Description + * - SQ-9114 + - `cleanup_extents` on empty texts results in a missing file + * - SQ-8849 + - Unclear "Map:at" error for invalid column mapping of Parquet files + +The following table lists the issues that were resolved in Version 2021.2.1.23: + +.. list-table:: + :widths: 17 200 + :header-rows: 1 + + * - SQ No. + - Description + * - SQ-10703 + - it implements a FILTER on delete statements which means that delete statements would not scan the entire metadata but only according to the filter Known Issues ------ The **Known Issues** section is not relevant to 2021.2.1. +The following table lists the issues that were resolved in Version 2021.2.1.1: + +.. list-table:: + :widths: 17 200 + :header-rows: 1 + + * - SQ No. + - Description + * - SQ-9003 + - Insert as Select with Order By - Internal Runtime Error + * - SQ-9121 + - Support cleanup_extents with empty text columns for cloud environment + * - SQ-8954 + - GCP one worker crash when copying a table using 8 workers + * - SQ-5485 + - The compiler has an issue with count being used as an alias and in the select list + * - SQ-7732 + - Fail to read numeric (38,0) from parquet + * - SQ-7800 + - AWS - Creating 4,000,000 chunks in leveldb by a copy operation causes segmentation fault in leveldb + * - SQ-7903 + - Filters and metadata_filters doesn't work well for numeric/float literals without an explicit cast + * - SQ-7931 + - Difference to Postgres when comparing literal float4 and float8 + * - SQ-8274 + - Cast to numeric with default precision doesn't work + +The **Known Issues** section is not relevant to Version 2021.2.1.23. + Naming Convention Modifications ------ The **Naming Convention Modifications** section is not relevant to Version 2021.2.1. From 4e85d0bb5994f907e74d6927ec3bf69f257c5226 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 14 Jul 2022 13:59:38 +0300 Subject: [PATCH 112/882] Made release table on all index pages Improved menu functionality (by adding toctree at bottom of each page to relevant pages) --- releases/2020.1.rst | 9 +++++- releases/2020.2.rst | 7 +++++ releases/2020.3.1.rst | 9 +++++- releases/2020.3.2.1.rst | 9 +++++- releases/2020.3.rst | 7 +++++ releases/2020.3_index.rst | 17 ++++++----- releases/2021.1.1.rst | 9 +++++- releases/2021.1.2.rst | 9 +++++- releases/2021.1.rst | 7 +++++ releases/2021.1_index.rst | 17 ++++++----- releases/2021.2.1.1.rst | 28 ++++++++++++++++++ releases/2021.2.1.23.rst | 26 ++++++++++++++++ releases/2021.2.1.rst | 62 +++++---------------------------------- releases/2021.2.rst | 9 +++++- releases/2021.2_index.rst | 17 +++++++---- releases/2022.1.rst | 9 +++++- releases/2022.1_index.rst | 19 ++++++++++++ releases/index.rst | 39 ++++++++++++------------ 18 files changed, 208 insertions(+), 101 deletions(-) create mode 100644 releases/2021.2.1.1.rst create mode 100644 releases/2021.2.1.23.rst create mode 100644 releases/2022.1_index.rst diff --git a/releases/2020.1.rst b/releases/2020.1.rst index e4928855e..86b619d54 100644 --- a/releases/2020.1.rst +++ b/releases/2020.1.rst @@ -185,4 +185,11 @@ Upgrading to v2020.1 Versions are available for IBM POWER9, RedHat (CentOS) 7, Ubuntu 18.04, and other OSs via Docker. -Contact your account manager to get the latest release of SQream DB. +Contact your account manager to get the latest release of SQream. + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2020.1 \ No newline at end of file diff --git a/releases/2020.2.rst b/releases/2020.2.rst index 3dc25b78a..917d80800 100644 --- a/releases/2020.2.rst +++ b/releases/2020.2.rst @@ -113,3 +113,10 @@ Upgrading to Version 2020.2 Versions are available for IBM POWER9, RedHat (CentOS) 7, Ubuntu 18.04, and other OSs via Docker. Contact your account manager to get the latest release of SQream. + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2020.2 \ No newline at end of file diff --git a/releases/2020.3.1.rst b/releases/2020.3.1.rst index 0667306d7..b66454c75 100644 --- a/releases/2020.3.1.rst +++ b/releases/2020.3.1.rst @@ -69,4 +69,11 @@ Upgrading to v2020.3.1 Versions are available for IBM POWER9, RedHat (CentOS) 7, Ubuntu 18.04, and other OSs via Docker. -Contact your account manager to get the latest release of SQream DB. \ No newline at end of file +Contact your account manager to get the latest release of SQream. + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2020.3.1 \ No newline at end of file diff --git a/releases/2020.3.2.1.rst b/releases/2020.3.2.1.rst index 3c551b636..8fef047f6 100644 --- a/releases/2020.3.2.1.rst +++ b/releases/2020.3.2.1.rst @@ -28,4 +28,11 @@ Upgrading to v2020.3.2.1 Versions are available for IBM POWER9, RedHat (CentOS) 7, Ubuntu 18.04, and other OSs via Docker. -Contact your account manager to get the latest release of SQream DB. \ No newline at end of file +Contact your account manager to get the latest release of SQream. + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2020.3.2.1 \ No newline at end of file diff --git a/releases/2020.3.rst b/releases/2020.3.rst index d072b15da..b51a9955d 100644 --- a/releases/2020.3.rst +++ b/releases/2020.3.rst @@ -100,3 +100,10 @@ Upgrading to v2020.3 Versions are available for IBM POWER9, RedHat (CentOS) 7, Ubuntu 18.04, and other OSs via Docker. Contact your account manager to get the latest release of SQream. + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2020.3 diff --git a/releases/2020.3_index.rst b/releases/2020.3_index.rst index b13340b52..19bf3bd79 100644 --- a/releases/2020.3_index.rst +++ b/releases/2020.3_index.rst @@ -3,16 +3,19 @@ ************************** Release Notes 2020.3 ************************** -The 2020.3 Release Notes describe the following releases: +SQream releases notes are specific to each version of the application. Select your version from the table below to see the related release notes. -.. contents:: - :local: - :depth: 1 ++---------------------------------+----------------------------------+------------------------------------------------------------------+ +| **Major Release** | **Minor Releases** | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+ +| :ref:`2020.3<2020.3>` | :ref:`2020.3.1<2020.3.1>` | :ref:`2020.3.2.1<2020.3.2.1>` | | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+ .. toctree:: - :maxdepth: 1 + :maxdepth: 2 :glob: + :hidden: - 2020.3.2.1 + 2020.3 2020.3.1 - 2020.3 \ No newline at end of file + 2020.3.2.1 \ No newline at end of file diff --git a/releases/2021.1.1.rst b/releases/2021.1.1.rst index 8e6417a43..992b2f850 100644 --- a/releases/2021.1.1.rst +++ b/releases/2021.1.1.rst @@ -61,4 +61,11 @@ The following list describes the resolved issues: * The Decimal column was not supported when inserting data from Parquet files. This was fixed. * Values in Parquet Numeric columns were not being converted correctly. This was fixed. * Converting ``string`` data type to ``datetime`` was not working correctly. This was fixed. -* Casting ``datetime`` to ``text`` truncated the time. This was fixed. \ No newline at end of file +* Casting ``datetime`` to ``text`` truncated the time. This was fixed. + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2021.1.1 \ No newline at end of file diff --git a/releases/2021.1.2.rst b/releases/2021.1.2.rst index 43ce6db7d..448b047df 100644 --- a/releases/2021.1.2.rst +++ b/releases/2021.1.2.rst @@ -58,4 +58,11 @@ The following list describes the resolved issues: * In Parquet files, ``float`` columns could not be mapped to SQream ``double`` columns. This was fixed. * The ``REPLACE`` function only supported constant values as arguments. This was fixed. -* The ``LIKE`` function did not check for incorrect patterns or handle escape characters. This was fixed. \ No newline at end of file +* The ``LIKE`` function did not check for incorrect patterns or handle escape characters. This was fixed. + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2021.1.2 \ No newline at end of file diff --git a/releases/2021.1.rst b/releases/2021.1.rst index b2b0dcfd8..15824d5d5 100644 --- a/releases/2021.1.rst +++ b/releases/2021.1.rst @@ -211,3 +211,10 @@ The the list below describes the following known issues and limitations: Upgrading to v2021.1 ------- Due to the known issue of a limitation on the amount of access requests that can be simultaneously sent to AWS, deploying S3 requires setting the ``ObjectStoreClients`` parameter to ``40``. + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2021.1 \ No newline at end of file diff --git a/releases/2021.1_index.rst b/releases/2021.1_index.rst index 64b06e1d1..5ba66f511 100644 --- a/releases/2021.1_index.rst +++ b/releases/2021.1_index.rst @@ -3,16 +3,19 @@ ************************** Release Notes 2021.1 ************************** -The 2021.1 Release Notes describe the following releases: +SQream releases notes are specific to each version of the application. Select your version from the table below to see the related release notes. -.. contents:: - :local: - :depth: 1 ++---------------------------------+----------------------------------+------------------------------------------------------------------+ +| **Major Release** | **Minor Releases** | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+ +| :ref:`2021.1<2021.1>` | :ref:`2021.1.1<2021.1.1>` | :ref:`2021.1.2<2021.1.2>` | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+ .. toctree:: - :maxdepth: 1 + :maxdepth: 2 :glob: + :hidden: - 2021.1.2 + 2021.1 2021.1.1 - 2021.1 \ No newline at end of file + 2021.1.2 \ No newline at end of file diff --git a/releases/2021.2.1.1.rst b/releases/2021.2.1.1.rst new file mode 100644 index 000000000..a1137e418 --- /dev/null +++ b/releases/2021.2.1.1.rst @@ -0,0 +1,28 @@ +.. _2021.2.1.1: + +****************************** +Release Notes 2021.2.1.1 +****************************** +The 2021.2.1.1 release notes is a patch version released on 9/12/2021. + +The following table lists the issues that were resolved in Version 2021.2.1.1: + +.. list-table:: + :widths: 17 200 + :header-rows: 1 + + * - SQ No. + - Description + * - SQ-9114 + - `cleanup_extents` on empty texts results in a missing file + * - SQ-8849 + - `Unclear "Map:at" error for invalid column mapping of Parquet files + +Version 2021.2.1.1 has no unresolved issues. + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2021.2.1.1 \ No newline at end of file diff --git a/releases/2021.2.1.23.rst b/releases/2021.2.1.23.rst new file mode 100644 index 000000000..ca5e2dcbe --- /dev/null +++ b/releases/2021.2.1.23.rst @@ -0,0 +1,26 @@ +.. _2021.2.1.23: + +****************************** +Release Notes 2021.2.1.23 +****************************** +The 2021.2.1.23 release notes is a patch version released on 27/6/2022. + +The following table lists the issues that were resolved in Version 2021.2.1.23: + +.. list-table:: + :widths: 17 200 + :header-rows: 1 + + * - SQ No. + - Description + * - SQ-10703 + - When the clause is specified, all existing permissions granted on source_table_name are granted on table_name as well. + +Version 2021.2.1.23 has no unresolved issues. + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2021.2.1.23 \ No newline at end of file diff --git a/releases/2021.2.1.rst b/releases/2021.2.1.rst index 063143529..3afba3093 100644 --- a/releases/2021.2.1.rst +++ b/releases/2021.2.1.rst @@ -62,63 +62,10 @@ The following table lists the issues that were resolved in Version 2021.2.1: * - SQ-8267 - A method has been provided for including the ``GROUP BY`` and ``DISTINCT COUNT`` statements. -The following table lists the issues that were resolved in Version 2021.2.1.1: - -.. list-table:: - :widths: 17 200 - :header-rows: 1 - - * - SQ No. - - Description - * - SQ-9114 - - `cleanup_extents` on empty texts results in a missing file - * - SQ-8849 - - Unclear "Map:at" error for invalid column mapping of Parquet files - -The following table lists the issues that were resolved in Version 2021.2.1.23: - -.. list-table:: - :widths: 17 200 - :header-rows: 1 - - * - SQ No. - - Description - * - SQ-10703 - - it implements a FILTER on delete statements which means that delete statements would not scan the entire metadata but only according to the filter - Known Issues ------ The **Known Issues** section is not relevant to 2021.2.1. -The following table lists the issues that were resolved in Version 2021.2.1.1: - -.. list-table:: - :widths: 17 200 - :header-rows: 1 - - * - SQ No. - - Description - * - SQ-9003 - - Insert as Select with Order By - Internal Runtime Error - * - SQ-9121 - - Support cleanup_extents with empty text columns for cloud environment - * - SQ-8954 - - GCP one worker crash when copying a table using 8 workers - * - SQ-5485 - - The compiler has an issue with count being used as an alias and in the select list - * - SQ-7732 - - Fail to read numeric (38,0) from parquet - * - SQ-7800 - - AWS - Creating 4,000,000 chunks in leveldb by a copy operation causes segmentation fault in leveldb - * - SQ-7903 - - Filters and metadata_filters doesn't work well for numeric/float literals without an explicit cast - * - SQ-7931 - - Difference to Postgres when comparing literal float4 and float8 - * - SQ-8274 - - Cast to numeric with default precision doesn't work - -The **Known Issues** section is not relevant to Version 2021.2.1.23. - Naming Convention Modifications ------ The **Naming Convention Modifications** section is not relevant to Version 2021.2.1. @@ -129,4 +76,11 @@ The **End of Support** section is not relevant to Version 2021.2.1. Deprecated Features ------ -The **Deprecated Components** section is not relevant to Version 2021.2.1. \ No newline at end of file +The **Deprecated Components** section is not relevant to Version 2021.2.1. + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2021.2.1 \ No newline at end of file diff --git a/releases/2021.2.rst b/releases/2021.2.rst index ec4773669..1bd6c6223 100644 --- a/releases/2021.2.rst +++ b/releases/2021.2.rst @@ -169,4 +169,11 @@ Configuring Your Instance of SQream ************ A new configuration method is used starting with Version 2021.2. -For more information about configuring your instance of SQream, see :ref:`configuration`. \ No newline at end of file +For more information about configuring your instance of SQream, see :ref:`configuration`. + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2021.2 \ No newline at end of file diff --git a/releases/2021.2_index.rst b/releases/2021.2_index.rst index 77a22b0ae..6e207ee73 100644 --- a/releases/2021.2_index.rst +++ b/releases/2021.2_index.rst @@ -3,15 +3,20 @@ ************************** Release Notes 2021.2 ************************** -The 2021.2 Release Notes describe the following releases: +SQream releases notes are specific to each version of the application. Select your version from the table below to see the related release notes. -.. contents:: - :local: - :depth: 1 ++---------------------------------+---------------------------------+------------------------------------------------------------------+ +| **Major Release** | **Minor Release** | ++---------------------------------+---------------------------------+--------------------------------+---------------------------------+ +| :ref:`2021.2<2021.2>` | :ref:`2021.2.1<2021.2.1>` | :ref:`2021.2.1.1<2021.2.1.1>` | :ref:`2021.2.1.23<2021.2.1.23>` | ++---------------------------------+---------------------------------+--------------------------------+---------------------------------+ .. toctree:: - :maxdepth: 1 + :maxdepth: 2 :glob: + :hidden: + 2021.2 2021.2.1 - 2021.2 \ No newline at end of file + 2021.2.1.1 + 2021.2.1.23 \ No newline at end of file diff --git a/releases/2022.1.rst b/releases/2022.1.rst index ac180206c..52a6722e5 100644 --- a/releases/2022.1.rst +++ b/releases/2022.1.rst @@ -138,4 +138,11 @@ Upgrading to v2022.1 $ ./upgrade_storage - .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in **Step 7** of the Upgrading SQream Version procedure. \ No newline at end of file + .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in **Step 7** of the Upgrading SQream Version procedure. + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2022.1 \ No newline at end of file diff --git a/releases/2022.1_index.rst b/releases/2022.1_index.rst new file mode 100644 index 000000000..c40867102 --- /dev/null +++ b/releases/2022.1_index.rst @@ -0,0 +1,19 @@ +.. _2022.1_index: + +************************** +Release Notes 2022.1 +************************** +The 2022.1 Release Notes describe the following releases: + ++---------------------------------+----------------------------------+------------------------------------------------------------------+ +| **Major Release** | **Minor Releases** | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+ +| :ref:`2022.1<2022.1>` | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+ + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2022.1 \ No newline at end of file diff --git a/releases/index.rst b/releases/index.rst index e23036f7a..d68e0b55b 100644 --- a/releases/index.rst +++ b/releases/index.rst @@ -3,27 +3,26 @@ ********** Release Notes ********** +SQream releases notes are specific to each version of the application. Select your version from the table below to see the related release notes. + ++---------------------------------+----------------------------------+------------------------------------------------------------------+ +| **Major Release** | **Minor Releases** | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+ +| :ref:`2022.1<2022.1>` | | | | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+ +| :ref:`2021.2<2021.2>` | :ref:`2021.2.1<2021.2.1>` | :ref:`2021.2.1.1<2021.2.1.1>` | :ref:`2021.2.1.23<2021.2.1.23>` | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+ +| :ref:`2021.1<2021.1>` | :ref:`2021.1.1<2021.1.1>` | :ref:`2021.1.2<2021.1.2>` | | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+ +| :ref:`2020.3<2020.3>` | :ref:`2020.3.1<2020.3.1>` | :ref:`2020.3.2.1<2020.3.2.1>` | | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+ +| :ref:`2020.2<2020.2>` | | | | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+ +| :ref:`2020.1<2020.1>` | | | | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+ -.. list-table:: - :widths: auto - :header-rows: 1 - - - * - Version - - Release Date - * - :ref:`2022.1` - - MM DD, YYYY - * - :ref:`2021.2` - - September 13, 2021 - * - :ref:`2021.1` - - June 13, 2021 - * - :ref:`2020.3` - - October 8, 2020 - * - :ref:`2020.2` - - July 22, 2020 - * - :ref:`2020.1` - - January 15, 2020 + @@ -32,7 +31,7 @@ Release Notes :glob: :hidden: - 2022.1 + 2022.1_index 2021.2_index 2021.1_index 2020.3_index From 3cc5089a27da69132444777c105a7f3e5d41132d Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 14 Jul 2022 16:04:36 +0300 Subject: [PATCH 113/882] Update index.rst --- releases/index.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/releases/index.rst b/releases/index.rst index d68e0b55b..17fdbb529 100644 --- a/releases/index.rst +++ b/releases/index.rst @@ -8,17 +8,17 @@ SQream releases notes are specific to each version of the application. Select yo +---------------------------------+----------------------------------+------------------------------------------------------------------+ | **Major Release** | **Minor Releases** | +---------------------------------+----------------------------------+--------------------------------+---------------------------------+ -| :ref:`2022.1<2022.1>` | | | | +| :ref:`2022.1<2022.1>` | +---------------------------------+----------------------------------+--------------------------------+---------------------------------+ | :ref:`2021.2<2021.2>` | :ref:`2021.2.1<2021.2.1>` | :ref:`2021.2.1.1<2021.2.1.1>` | :ref:`2021.2.1.23<2021.2.1.23>` | +---------------------------------+----------------------------------+--------------------------------+---------------------------------+ -| :ref:`2021.1<2021.1>` | :ref:`2021.1.1<2021.1.1>` | :ref:`2021.1.2<2021.1.2>` | | +| :ref:`2021.1<2021.1>` | :ref:`2021.1.1<2021.1.1>` | :ref:`2021.1.2<2021.1.2>` | +---------------------------------+----------------------------------+--------------------------------+---------------------------------+ -| :ref:`2020.3<2020.3>` | :ref:`2020.3.1<2020.3.1>` | :ref:`2020.3.2.1<2020.3.2.1>` | | +| :ref:`2020.3<2020.3>` | :ref:`2020.3.1<2020.3.1>` | :ref:`2020.3.2.1<2020.3.2.1>` | +---------------------------------+----------------------------------+--------------------------------+---------------------------------+ -| :ref:`2020.2<2020.2>` | | | | +| :ref:`2020.2<2020.2>` | +---------------------------------+----------------------------------+--------------------------------+---------------------------------+ -| :ref:`2020.1<2020.1>` | | | | +| :ref:`2020.1<2020.1>` | +---------------------------------+----------------------------------+--------------------------------+---------------------------------+ From 708d6676e6db6437a5e751e548832dfb1e07f2c8 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Fri, 15 Jul 2022 01:11:17 +0300 Subject: [PATCH 114/882] Added all bugs (not filtered) --- releases/2021.2.1.22.rst | 26 ++++++ releases/2022.1.rst | 195 ++++++++++++++++++++++++++++++++++++--- releases/index.rst | 30 +++--- 3 files changed, 222 insertions(+), 29 deletions(-) create mode 100644 releases/2021.2.1.22.rst diff --git a/releases/2021.2.1.22.rst b/releases/2021.2.1.22.rst new file mode 100644 index 000000000..029ad0178 --- /dev/null +++ b/releases/2021.2.1.22.rst @@ -0,0 +1,26 @@ +.. _2021.2.1.22: + +****************************** +Release Notes 2021.2.1.22 +****************************** +The 2021.2.1.22 release notes is a patch version released on 27/6/2022. + +The following table lists the issues that were resolved in Version 2021.2.1.23: + +.. list-table:: + :widths: 17 200 + :header-rows: 1 + + * - SQ No. + - Description + * - SQ-10776 + - Out Of Memory invoked during copy from with multiple files. + +Version 2021.2.1.23 has no unresolved issues. + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2021.2.1.22 \ No newline at end of file diff --git a/releases/2022.1.rst b/releases/2022.1.rst index 52a6722e5..74e568fad 100644 --- a/releases/2022.1.rst +++ b/releases/2022.1.rst @@ -60,20 +60,187 @@ Resolved Issues --------- The following table lists the issues that were resolved in Version 2022.1: -.. list-table:: - :widths: 17 200 - :header-rows: 1 - - * - SQ No. - - Description - * - SQ-xxxx - - Text - * - SQ-xxxx - - Text - * - SQ-xxxx - - Text - -**Comment** - *The table above will be updated regarding which resolved issues to include.* +**Comment** - *The items in the table below must be filtered according to external and internal bugs. We CANNOT expose internal bugs to external users.* + ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-7490 | Native Avro file access via a dedicated FDW | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-7718 | Certify LTS Ubuntu versions (18.04 & 20.04) for production usage | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-7732 | Fail to read numeric columns from an external generated parquet file | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-8163 | Performance degradation - tpch1t_external_table_parquet - cases #6079 & #6105 | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-8182 | Encryption Function | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-8984 | Update statement MVP: literal assignment | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-9221 | [Mobicom] PBI - External Tables are not shown on the tables list. | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-9611 | Create a WIN-874 to UTF-8 conversion function | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-9634 | identifier not found | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-9644 | [ACL] Incomplete logs query causing Internal Runtime Error | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-9671 | Trying to read Thai UTF-8 csv file in TEXT column and it not shows Thai | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-9764 | No error when create a foreign table with difference in the column numbers in the table and the file | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-9790 | Encryption - MVP scope | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-9808 | Allowing to set deferredValueIOThresholdFactor flag not in developer Mode=true | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-9823 | [AIS] The user can't use literals when using sqream with Thai varchar | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-9889 | [AIS] Internal runtime Error receive | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-9952 | Removing temp files takes too long - timeout issue at LGU+ | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-9988 | Find a proper solution for data lost during copy from parquet - without reverting previous optimization | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-9990 | Merge v2021.2.1_stable into develop | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10005 | Go / No Go approvals | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10011 | Delete filter optimization chicken flag | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10055 | [SamsungDisplay] Slow loading of sqream after backup compacting | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10061 | compiler side - Implement MVP scope | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10071 | error on exists subqueries with text and varchar equality condition | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10111 | Parquet numeric - Sqream can't import parquet numeric columns from other sources | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10191 | [LGE] ALTER DEFAULT SCHEMA command has a problem. | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10216 | Performance degradation - tpch1t_1mchunk - case #1326 #1345 | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10242 | socket 11 error from "Create as Select~" | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10269 | cleanup_chunk error with text(X) column | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10314 | Unable to load avro file to sqream v1 + v2 from s3 | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10319 | Error on copy from avro file with numeric data | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10425 | Lot of time in copy from, external table parquet file | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10428 | [LGU] Can not execute cleanup_extents on table because there are mixed chunks | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10470 | count distinct on 0 rows doesn't return any value | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10478 | get_ddl disregards encrypted columns | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10479 | create a table with more than three encrypted column with no error | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10492 | Wrong values when select from table have encrypted column and regular column | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10494 | No “encrypted” label when read from table with encrypted column | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10496 | Not able to insert data to encrypted column after performing delete on the column | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10514 | No error when create table with encrypted column for the unsupported data types | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10515 | Run time error when decrypt 1 million rows | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10518 | create foreign table with encrypted column with no error | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10532 | Get Read time out error when try to read avro to wrong ddl (Frozen client) | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10534 | Wrong error message when copy null values from avro file to not null ddl (Overflow case instead null to not null) | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10551 | No error when add encrypt column to already existing table | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10585 | [V1] ORC Numeric reading - Overflow error | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10586 | SQream crashed when encrypt 1 billion rows | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10593 | Seg fault when inserting AVRO non-decimal value to Numeric type | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10594 | Some of configuration flags are displaced in default config | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10613 | Samsung test fail on branch v2022.1_stable | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10629 | Different join type between SELECT (Left) vs INSERT INTO SELECT (Left cross) | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10631 | Performance degradation - copies - copy_nvarchar40.sql - case #4556 | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10632 | Performance degradation - insert_as_select - insert_as_select_parquet_int.sql - case #4971 | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10655 | Performance degradation- some queries that perform COPY FROM - case #4624 | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10656 | Performance degradation - insert_as_select - #4971 & #4984 | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10659 | [SDC] Compile Error when using comment | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10665 | AWS V2 - Files are not deleted from S3 storage after DROP database and DROP table | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10667 | Log file not created when execute copy from avro | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10677 | Different results between subquery and physical table | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10692 | Internal Runtime Error when decrypt 1 million rows of text data type | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10695 | when ingest 100 million data into table with 3 encrypted column it took time more than expected | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10716 | Error on copy from avro (Expected auto cast) | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10734 | nvarchar_backward_comp1 failed in regression on branch v2022.1_stable | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10735 | numeric_upgrade_storage has failed in regression on v2022.1_stable | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10738 | Sqream worker on GPU id 1 consume also from GPU id 0 | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10745 | compiler_tests failed in regression on v2022.1_stable | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10776 | Out Of Memory invoked during copy from with multiple files | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10813 | Copy To - The statement doesn't working when I use with 'Avro' format for location='s3....' | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10823 | window_functions_part1 failed in regression in develop | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10855 | CLONE - UF - list all files related to chunk id, Get specific chunk key values | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10869 | Enable/Disable encryption by default | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10871 | Copy To - Getting an error when missing file_name in the end of the path at the location field(This happen only at Avro format) | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10877 | Avro not implemented on stable version v2022 s3 | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10885 | Filter on Delete - should be tested | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10889 | v2022.1_stable => Internal compiler error: Bad encryption type | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10895 | [AIS] behavior is not consistent when the user using Literals with Thai varchar WIN-874 or Thai text UTF-8 | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10902 | test_copy_null_to_not_null[all_types-parquet] (from Generic Copy From) crashes sqreamd | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10916 | [AIS] varcharEncoding": "WINDOWS-874" Flag should work NOT ONLY in Developer mode | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10938 | REGEXP_REPLACE is not supported in 2022 version | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10962 | Using Thai Literals on v2022 with Text type output shows bad results ONLY ON Clientcmd | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10987 | [AIS] The system not allowing to control the update permissions - Grant update permission | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10999 | File tracker error logs on Sqream with MD - insert & select queries | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11043 | correlated_subqueries_v1 test failed | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11063 | Migration of Varchar to Text - keep the size of Varchar after the migration to the text type. | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11101 | Show locks test failed in regression for v2022.1 | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11109 | User can't change his own password using the UI | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11168 | Migration script on 1B rows table and 8 columns output with Internal run time error. | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11170 | Create a tool for migrating a Varchar table to Text | ++------------+-------------------------------------------------------------------------------------------------------------------------------------+ Operations and Configuration Changes -------- diff --git a/releases/index.rst b/releases/index.rst index 17fdbb529..d07b22632 100644 --- a/releases/index.rst +++ b/releases/index.rst @@ -5,21 +5,21 @@ Release Notes ********** SQream releases notes are specific to each version of the application. Select your version from the table below to see the related release notes. -+---------------------------------+----------------------------------+------------------------------------------------------------------+ -| **Major Release** | **Minor Releases** | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+ -| :ref:`2022.1<2022.1>` | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+ -| :ref:`2021.2<2021.2>` | :ref:`2021.2.1<2021.2.1>` | :ref:`2021.2.1.1<2021.2.1.1>` | :ref:`2021.2.1.23<2021.2.1.23>` | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+ -| :ref:`2021.1<2021.1>` | :ref:`2021.1.1<2021.1.1>` | :ref:`2021.1.2<2021.1.2>` | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+ -| :ref:`2020.3<2020.3>` | :ref:`2020.3.1<2020.3.1>` | :ref:`2020.3.2.1<2020.3.2.1>` | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+ -| :ref:`2020.2<2020.2>` | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+ -| :ref:`2020.1<2020.1>` | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+ ++---------------------------------+----------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------+ +| **Major Release** | **Minor Releases** | ++---------------------------------+----------------------------------+--------------------------------+-------------------------------------------------------------------+---------------------------------+ +| :ref:`2022.1<2022.1>` | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+---------------------------------+---------------------------------+ +| :ref:`2021.2<2021.2>` | :ref:`2021.2.0.1<2021.2.0.1>` | :ref:`2021.2.1<2021.2.1>` | :ref:`2021.2.1.1<2021.2.1.1>` | :ref:`2021.2.1.22<2021.2.1.22>` | :ref:`2021.2.1.23<2021.2.1.23>` | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+---------------------------------+---------------------------------+ +| :ref:`2021.1<2021.1>` | :ref:`2021.1.1<2021.1.1>` | :ref:`2021.1.2<2021.1.2>` | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+---------------------------------+---------------------------------+ +| :ref:`2020.3<2020.3>` | :ref:`2020.3.1<2020.3.1>` | :ref:`2020.3.2.1<2020.3.2.1>` | ++---------------------------------+----------------------------------+--------------------------------+-------------------------------------------------------------------+---------------------------------+ +| :ref:`2020.2<2020.2>` | ++---------------------------------+----------------------------------+--------------------------------+-------------------------------------------------------------------+---------------------------------+ +| :ref:`2020.1<2020.1>` | ++---------------------------------+----------------------------------+--------------------------------+-------------------------------------------------------------------+---------------------------------+ From c9207316e925b96f08bfbe0ac8cd483c97546038 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Fri, 15 Jul 2022 16:41:58 +0300 Subject: [PATCH 115/882] Started adding all patches --- releases/2021.1.1.1.rst | 32 +++++++++++++++++++++++++++++++ releases/2021.1_index.rst | 11 ++++++----- releases/2021.2.0.1.rst | 40 +++++++++++++++++++++++++++++++++++++++ releases/2021.2.1.24.rst | 26 +++++++++++++++++++++++++ releases/2021.2.1.25.rst | 26 +++++++++++++++++++++++++ releases/index.rst | 31 +++++++++++++++--------------- 6 files changed, 145 insertions(+), 21 deletions(-) create mode 100644 releases/2021.1.1.1.rst create mode 100644 releases/2021.2.0.1.rst create mode 100644 releases/2021.2.1.24.rst create mode 100644 releases/2021.2.1.25.rst diff --git a/releases/2021.1.1.1.rst b/releases/2021.1.1.1.rst new file mode 100644 index 000000000..2e562c858 --- /dev/null +++ b/releases/2021.1.1.1.rst @@ -0,0 +1,32 @@ +.. _2021.1.1.1: + +************************** +Release Notes 2021.1.1.1 +************************** +The 2021.1.1.1 release notes is a patch version released on 27/6/2022. + +The following table lists the issues that were resolved in Version 2021.1.1.1: + +.. list-table:: + :widths: 17 200 + :header-rows: 1 + + * - SQ No. + - Description + * - SQ-7045 + - Replace function doesn't support column value + * - SQ-7640 + - Some dates can't be recognized as a standard date format + * - SQ-7658 + - Can't perform "=" function between varchar(1) and text argument + * - SQ-7588 + - A thread that removes stuck open snapshots + +Version 2021.1.1.1 has no unresolved issues. + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2021.1.1.1 \ No newline at end of file diff --git a/releases/2021.1_index.rst b/releases/2021.1_index.rst index 5ba66f511..0e9960d99 100644 --- a/releases/2021.1_index.rst +++ b/releases/2021.1_index.rst @@ -5,11 +5,11 @@ Release Notes 2021.1 ************************** SQream releases notes are specific to each version of the application. Select your version from the table below to see the related release notes. -+---------------------------------+----------------------------------+------------------------------------------------------------------+ -| **Major Release** | **Minor Releases** | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+ -| :ref:`2021.1<2021.1>` | :ref:`2021.1.1<2021.1.1>` | :ref:`2021.1.2<2021.1.2>` | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+ ++---------------------------------+----------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| **Major Release** | **Minor Releases** | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+---------------------------------+---------------------------------+---------------------------------+----------------------------------+ +| :ref:`2021.2<2021.2>` | :ref:`2021.2.0.1<2021.2.0.1>` | :ref:`2021.2.1<2021.2.1>` | :ref:`2021.2.1.1<2021.2.1.1>` | :ref:`2021.2.1.22<2021.2.1.22>` | :ref:`2021.2.1.23<2021.2.1.23>` | :ref:`2021.2.1.24<2021.2.1.24>` | :ref:`2021.2.1.25<2021.2.1.25>` | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+---------------------------------+---------------------------------+---------------------------------+----------------------------------+ .. toctree:: :maxdepth: 2 @@ -18,4 +18,5 @@ SQream releases notes are specific to each version of the application. Select yo 2021.1 2021.1.1 + 2021.1.1.1 2021.1.2 \ No newline at end of file diff --git a/releases/2021.2.0.1.rst b/releases/2021.2.0.1.rst new file mode 100644 index 000000000..41cbd96d3 --- /dev/null +++ b/releases/2021.2.0.1.rst @@ -0,0 +1,40 @@ +.. _2021.2.0.1: + +************************** +Release Notes 2021.2.0.1 +************************** +The 2021.2.0.1 release notes were released on x/x/xxxx and describe the following: + +The following table lists the issues that were resolved in Version 2021.2.0.1: + +.. list-table:: + :widths: 17 200 + :header-rows: 1 + + * - SQ No. + - Description + * - SQ-8345 + - Studio-How does a publicUser connect to a specified service? + * - SQ-8343 + - Running SQream from docker does not show configuration extended info + * - SQ-8294 + - Quote qualifier is not present in exported file thus file cannot be reloaded + * - SQ-8288 + - Support parameter TEXT casts + * - SQ-8272 + - `cleanup_chunk` creates garbage metadata, potentially leading to wrong results + * - SQ-8271 + - Saved query parameters of type text are not supported + * - SQ-8266 + - [LGE] Data loading issue depending to column order. // bad syntax (datetime type) + * - SQ-8266 + - [LGE] Data loading issue depending to column order. // bad syntax (datetime type) + +Version 2021.2.0.1 has no unresolved issues. + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2021.2.0.1 \ No newline at end of file diff --git a/releases/2021.2.1.24.rst b/releases/2021.2.1.24.rst new file mode 100644 index 000000000..8f0f9d26b --- /dev/null +++ b/releases/2021.2.1.24.rst @@ -0,0 +1,26 @@ +.. _2021.2.1.24: + +****************************** +Release Notes 2021.2.1.24 +****************************** +The 2021.2.1.24 release notes is a patch version released on xxxxxxxxxxxx. + +The following table lists the issues that were resolved in Version 2021.2.1.24.rst: + +.. list-table:: + :widths: 17 200 + :header-rows: 1 + + * - SQ No. + - Description + * - SQ-xxxxx + - Description + +Version 2021.2.1.24 has no unresolved issues. + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2021.2.1.24 \ No newline at end of file diff --git a/releases/2021.2.1.25.rst b/releases/2021.2.1.25.rst new file mode 100644 index 000000000..6b6e1db03 --- /dev/null +++ b/releases/2021.2.1.25.rst @@ -0,0 +1,26 @@ +.. _2021.2.1.25: + +****************************** +Release Notes 2021.2.1.25 +****************************** +The 2021.2.1.25 release notes is a patch version released on xxxxxxxxxxxx. + +The following table lists the issues that were resolved in Version 2021.2.1.25.rst: + +.. list-table:: + :widths: 17 200 + :header-rows: 1 + + * - SQ No. + - Description + * - SQ-xxxxx + - Description + +Version 2021.2.1.25 has no unresolved issues. + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2021.2.1.25 \ No newline at end of file diff --git a/releases/index.rst b/releases/index.rst index d07b22632..8f8933ce4 100644 --- a/releases/index.rst +++ b/releases/index.rst @@ -5,22 +5,21 @@ Release Notes ********** SQream releases notes are specific to each version of the application. Select your version from the table below to see the related release notes. -+---------------------------------+----------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------+ -| **Major Release** | **Minor Releases** | -+---------------------------------+----------------------------------+--------------------------------+-------------------------------------------------------------------+---------------------------------+ -| :ref:`2022.1<2022.1>` | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+---------------------------------+---------------------------------+ -| :ref:`2021.2<2021.2>` | :ref:`2021.2.0.1<2021.2.0.1>` | :ref:`2021.2.1<2021.2.1>` | :ref:`2021.2.1.1<2021.2.1.1>` | :ref:`2021.2.1.22<2021.2.1.22>` | :ref:`2021.2.1.23<2021.2.1.23>` | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+---------------------------------+---------------------------------+ -| :ref:`2021.1<2021.1>` | :ref:`2021.1.1<2021.1.1>` | :ref:`2021.1.2<2021.1.2>` | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+---------------------------------+---------------------------------+ -| :ref:`2020.3<2020.3>` | :ref:`2020.3.1<2020.3.1>` | :ref:`2020.3.2.1<2020.3.2.1>` | -+---------------------------------+----------------------------------+--------------------------------+-------------------------------------------------------------------+---------------------------------+ -| :ref:`2020.2<2020.2>` | -+---------------------------------+----------------------------------+--------------------------------+-------------------------------------------------------------------+---------------------------------+ -| :ref:`2020.1<2020.1>` | -+---------------------------------+----------------------------------+--------------------------------+-------------------------------------------------------------------+---------------------------------+ - ++---------------------------------+----------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------+---------------------------------+----------------------------------+ +| **Major Release** | **Minor Releases** | ++---------------------------------+----------------------------------+--------------------------------+-------------------------------------------------------------------+---------------------------------+---------------------------------+----------------------------------+ +| :ref:`2022.1<2022.1>` | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+---------------------------------+---------------------------------+---------------------------------+----------------------------------+ +| :ref:`2021.2<2021.2>` | :ref:`2021.2.0.1<2021.2.0.1>` | :ref:`2021.2.1<2021.2.1>` | :ref:`2021.2.1.1<2021.2.1.1>` | :ref:`2021.2.1.22<2021.2.1.22>` | :ref:`2021.2.1.23<2021.2.1.23>` | :ref:`2021.2.1.24<2021.2.1.24>` | :ref:`2021.2.1.25<2021.2.1.25>` | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+---------------------------------+---------------------------------+---------------------------------+----------------------------------+ +| :ref:`2021.1<2021.1>` | :ref:`2021.1.1<2021.1.1>` | :ref:`2021.1.1.1<2021.1.1.1>` | :ref:`2021.1.2<2021.1.2>` | | | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+---------------------------------+------------------------------------------------------------------------------------------------------+ +| :ref:`2020.3<2020.3>` | :ref:`2020.3.1<2020.3.1>` | :ref:`2020.3.2.1<2020.3.2.1>` | ++---------------------------------+----------------------------------+--------------------------------+-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------+ +| :ref:`2020.2<2020.2>` | ++---------------------------------+----------------------------------+--------------------------------+-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------+ +| :ref:`2020.1<2020.1>` | ++---------------------------------+----------------------------------+--------------------------------+-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------+ From 1b201a083e4358af66d7a53d034424e104a74158 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Mon, 18 Jul 2022 13:08:45 +0300 Subject: [PATCH 116/882] Preparing for 2022.1 Built table for all minor patches (2022.1, 2021.1, and 2021.2) --- releases/2021.1_index.rst | 4 +- releases/2021.2.0.1.rst | 2 +- releases/2021.2.1.1.rst | 2 +- releases/2021.2.1.22.rst | 8 ++-- releases/2021.2.1.24.rst | 47 ++++++++++++++++++++---- releases/2021.2.1.25.rst | 26 ------------- releases/2021.2_index.rst | 12 +++--- releases/2022.1.1.rst | 77 +++++++++++++++++++++++++++++++++++++++ releases/2022.1_index.rst | 15 ++++---- releases/index.rst | 41 +++++++++++---------- 10 files changed, 161 insertions(+), 73 deletions(-) delete mode 100644 releases/2021.2.1.25.rst create mode 100644 releases/2022.1.1.rst diff --git a/releases/2021.1_index.rst b/releases/2021.1_index.rst index 0e9960d99..0fa9d6ccf 100644 --- a/releases/2021.1_index.rst +++ b/releases/2021.1_index.rst @@ -8,8 +8,8 @@ SQream releases notes are specific to each version of the application. Select yo +---------------------------------+----------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | **Major Release** | **Minor Releases** | +---------------------------------+----------------------------------+--------------------------------+---------------------------------+---------------------------------+---------------------------------+---------------------------------+----------------------------------+ -| :ref:`2021.2<2021.2>` | :ref:`2021.2.0.1<2021.2.0.1>` | :ref:`2021.2.1<2021.2.1>` | :ref:`2021.2.1.1<2021.2.1.1>` | :ref:`2021.2.1.22<2021.2.1.22>` | :ref:`2021.2.1.23<2021.2.1.23>` | :ref:`2021.2.1.24<2021.2.1.24>` | :ref:`2021.2.1.25<2021.2.1.25>` | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+---------------------------------+---------------------------------+---------------------------------+----------------------------------+ +| :ref:`2021.1<2021.1>` | :ref:`2021.1.1<2021.1.1>` | :ref:`2021.1.1.1<2021.1.1.1>` | :ref:`2021.1.2<2021.1.2>` | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+---------------------------------+------------------------------------------------------------------------------------------------------+ .. toctree:: :maxdepth: 2 diff --git a/releases/2021.2.0.1.rst b/releases/2021.2.0.1.rst index 41cbd96d3..03edcad4e 100644 --- a/releases/2021.2.0.1.rst +++ b/releases/2021.2.0.1.rst @@ -33,7 +33,7 @@ The following table lists the issues that were resolved in Version 2021.2.0.1: Version 2021.2.0.1 has no unresolved issues. .. toctree:: - :maxdepth: 2 + :maxdepth: 3 :glob: :hidden: diff --git a/releases/2021.2.1.1.rst b/releases/2021.2.1.1.rst index a1137e418..65cf1b8a1 100644 --- a/releases/2021.2.1.1.rst +++ b/releases/2021.2.1.1.rst @@ -21,7 +21,7 @@ The following table lists the issues that were resolved in Version 2021.2.1.1: Version 2021.2.1.1 has no unresolved issues. .. toctree:: - :maxdepth: 2 + :maxdepth: 3 :glob: :hidden: diff --git a/releases/2021.2.1.22.rst b/releases/2021.2.1.22.rst index 029ad0178..62346a3c8 100644 --- a/releases/2021.2.1.22.rst +++ b/releases/2021.2.1.22.rst @@ -3,9 +3,9 @@ ****************************** Release Notes 2021.2.1.22 ****************************** -The 2021.2.1.22 release notes is a patch version released on 27/6/2022. +The 2021.2.1.22 release notes is a patch version released on 13/6/2022. -The following table lists the issues that were resolved in Version 2021.2.1.23: +The following table lists the issues that were resolved in Version 2021.2.1.22: .. list-table:: :widths: 17 200 @@ -16,10 +16,10 @@ The following table lists the issues that were resolved in Version 2021.2.1.23: * - SQ-10776 - Out Of Memory invoked during copy from with multiple files. -Version 2021.2.1.23 has no unresolved issues. +Version 2021.2.1.22 has no unresolved issues. .. toctree:: - :maxdepth: 2 + :maxdepth: 4 :glob: :hidden: diff --git a/releases/2021.2.1.24.rst b/releases/2021.2.1.24.rst index 8f0f9d26b..cf4a2f391 100644 --- a/releases/2021.2.1.24.rst +++ b/releases/2021.2.1.24.rst @@ -7,14 +7,45 @@ The 2021.2.1.24 release notes is a patch version released on xxxxxxxxxxxx. The following table lists the issues that were resolved in Version 2021.2.1.24.rst: -.. list-table:: - :widths: 17 200 - :header-rows: 1 - - * - SQ No. - - Description - * - SQ-xxxxx - - Description ++-------------+----------------------------------------------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++=============+==================================================================================================================================+ +| SQ-9721 | pysqream - not finishing query | ++-------------+----------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10071 | error on exists subqueries with text and varchar equality condition | ++-------------+----------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10606 | [ACL] Queries getting stuck in the queue for a long time (Executing status) | ++-------------+----------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10691 | DB Schema identifier causes an error running some queries from joins suite - v2021.2.1_stable | ++-------------+----------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10843 | When getting "illegal memory access was encountered" error message worker does not crash, but fails every query afterwards. | ++-------------+----------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10879 | Performance | degradations in insert as select from ORC files | ++-------------+----------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10902 | test_copy_null_to_not_null[all_types-parquet] (from Generic Copy From) crashes sqreamd | ++-------------+----------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10918 | [SDC] WLM only assings jobs sequentially and it causes delay on user sqls when they are assigned to a worker running a huge job | ++-------------+----------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10955 | No metadata filters when filtering by nullable date using dateadd (LGU+) | ++-------------+----------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10963 | Extract File Reaper Mechanism To Separated Process | ++-------------+----------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10975 | Merging ACL's open snapshot functionality from V2021.1.1 to V2021.2.1.x | ++-------------+----------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10976 | Merging all V2021.1.X fixes/features to V2021.2&V2022.1.X | ++-------------+----------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11000 | DROP DATABASE fails to remove database path under sqreamdb and following creation commands is stuck | ++-------------+----------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11043 | correlated_subqueries_v1 test failed | ++-------------+----------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11055 | performance degradation - tpch10t - cases #1299, #1315, #1307 & #1297 | ++-------------+----------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11088 | specific worker compiling causes low performance | ++-------------+----------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11090 | SQream keeps the configuration flags where the query compiled and use it when the query is executed on a different worker | ++-------------+----------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11159 | Redesign the heartbeat timers, worker and metadata. | ++-------------+----------------------------------------------------------------------------------------------------------------------------------+ Version 2021.2.1.24 has no unresolved issues. diff --git a/releases/2021.2.1.25.rst b/releases/2021.2.1.25.rst deleted file mode 100644 index 6b6e1db03..000000000 --- a/releases/2021.2.1.25.rst +++ /dev/null @@ -1,26 +0,0 @@ -.. _2021.2.1.25: - -****************************** -Release Notes 2021.2.1.25 -****************************** -The 2021.2.1.25 release notes is a patch version released on xxxxxxxxxxxx. - -The following table lists the issues that were resolved in Version 2021.2.1.25.rst: - -.. list-table:: - :widths: 17 200 - :header-rows: 1 - - * - SQ No. - - Description - * - SQ-xxxxx - - Description - -Version 2021.2.1.25 has no unresolved issues. - -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2021.2.1.25 \ No newline at end of file diff --git a/releases/2021.2_index.rst b/releases/2021.2_index.rst index 6e207ee73..98a256bc2 100644 --- a/releases/2021.2_index.rst +++ b/releases/2021.2_index.rst @@ -5,11 +5,11 @@ Release Notes 2021.2 ************************** SQream releases notes are specific to each version of the application. Select your version from the table below to see the related release notes. -+---------------------------------+---------------------------------+------------------------------------------------------------------+ -| **Major Release** | **Minor Release** | -+---------------------------------+---------------------------------+--------------------------------+---------------------------------+ -| :ref:`2021.2<2021.2>` | :ref:`2021.2.1<2021.2.1>` | :ref:`2021.2.1.1<2021.2.1.1>` | :ref:`2021.2.1.23<2021.2.1.23>` | -+---------------------------------+---------------------------------+--------------------------------+---------------------------------+ ++---------------------------------+----------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------+---------------------------------+----------------------------------+ +| **Major Release** | **Minor Releases** | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+---------------------------------+------------------------------------------------------------------------------------------------------+ +| :ref:`2021.2<2021.2>` | :ref:`2021.2.0.1<2021.2.0.1>` | :ref:`2021.2.1<2021.2.1>` | :ref:`2021.2.1.1<2021.2.1.1>` | :ref:`2021.2.1.22<2021.2.1.22>` | :ref:`2021.2.1.23<2021.2.1.23>` | ++---------------------------------+----------------------------------+--------------------------------+---------------------------------+---------------------------------+---------------------------------+---------------------------------+----------------------------------+ .. toctree:: :maxdepth: 2 @@ -17,6 +17,8 @@ SQream releases notes are specific to each version of the application. Select yo :hidden: 2021.2 + 2021.2.0.1 2021.2.1 2021.2.1.1 + 2021.2.1.22 2021.2.1.23 \ No newline at end of file diff --git a/releases/2022.1.1.rst b/releases/2022.1.1.rst new file mode 100644 index 000000000..081d608f2 --- /dev/null +++ b/releases/2022.1.1.rst @@ -0,0 +1,77 @@ +.. _2022.1.1: + +************************** +Release Notes 2022.1.1 +************************** +The 2022.1.1 release notes were released on x/x/xxxx and describe the following: + +The following table lists the issues that were resolved in Version 2022.1.1: + ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++=============+==================================================================================================================================================+ +| SQ-6419 | Internal compiler error when casting numeric literal in aggregation function | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-9771 | The error returns different value when trying to insert date value without quotes. | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10100 | Implicit/Explicit cast from int/tinyint/bigint to bool is not working | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10741 | Got difference in execution time when ingesting data | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10772 | Internal Runtime Error when creating a text column with a limit characters size >= 1 and 30 zeros | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10790 | copy from with '*' (wildcard) from parquet is 3X slower than CSV | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10793 | Implement "Brute Force" Protection policy for the system login | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10816 | Data management on Big Table | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10838 | Repeat function throws an exception when entered a negative number | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10840 | UF - list all files related to chunk id, Get specific chunk key values | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10852 | Password Strength Check | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10863 | Performance | LGU | high SD in the duration of 'insert as select' query | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10873 | Inserting 100K bytes to a text column results in unclear error message | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10886 | Error in compilation process: : "Internal compiler error: | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10892 | Update || change error message when trying to run update on foreign table | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10899 | Cannot change the value of diskSpaceMinFreePercent - it is hard coded to 10% | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10919 | Automatic Foreign Table DDL Resolution | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10955 | No metadata filters when filtering by nullable date using dateadd (LGU+) | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10956 | Exception: "Could not read view.." - recompile and recreate doesn't help | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10963 | Extract File Reaper Mechanism To Separated Process | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10976 | Merging all V2021.1.X fixes/features to V2021.2&V2022.1.X | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10980 | sqream crashing when executing copy from avro (negative case copy file to unmatched column table) | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10988 | [SDC] stop_statement() doesn't work on jobs in queue | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11014 | Different float values between sqream and postgress | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11121 | Merging ACL's open snapshot functionality from V2021.1.1 to v2022.1.x code line | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11137 | CLONE - When getting "illegal memory access was encountered" error message worker does not crash, but fails every query afterwards. - AUTOMATIC | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11154 | After SQ-10980 fix, there is wrong error raised ("OVERFLOW exception") instead of "Tried inserting AVRO non-decimal" | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11158 | [ACL] Datediff doesn't work with specific dates - returns "Cast overflow" | ++-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ + +Version 2022.1.1 has no unresolved issues. + +.. toctree:: + :maxdepth: 3 + :glob: + :hidden: + + 2022.1.1 \ No newline at end of file diff --git a/releases/2022.1_index.rst b/releases/2022.1_index.rst index c40867102..6393d5511 100644 --- a/releases/2022.1_index.rst +++ b/releases/2022.1_index.rst @@ -3,17 +3,18 @@ ************************** Release Notes 2022.1 ************************** -The 2022.1 Release Notes describe the following releases: +The 2022.1 Release Notes describe the following releases: -+---------------------------------+----------------------------------+------------------------------------------------------------------+ -| **Major Release** | **Minor Releases** | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+ -| :ref:`2022.1<2022.1>` | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+ ++---------------------------------+----------------------------------+ +| **Major Release** | **Minor Releases** | ++---------------------------------+----------------------------------+ +| :ref:`2022.1<2022.1>` | :ref:`2022.1.1<2022.1.1>` | ++---------------------------------+----------------------------------+ .. toctree:: :maxdepth: 2 :glob: :hidden: - 2022.1 \ No newline at end of file + 2022.1 + 2022.1.1 \ No newline at end of file diff --git a/releases/index.rst b/releases/index.rst index 8f8933ce4..5e442a689 100644 --- a/releases/index.rst +++ b/releases/index.rst @@ -3,26 +3,29 @@ ********** Release Notes ********** -SQream releases notes are specific to each version of the application. Select your version from the table below to see the related release notes. - -+---------------------------------+----------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------+---------------------------------+----------------------------------+ -| **Major Release** | **Minor Releases** | -+---------------------------------+----------------------------------+--------------------------------+-------------------------------------------------------------------+---------------------------------+---------------------------------+----------------------------------+ -| :ref:`2022.1<2022.1>` | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+---------------------------------+---------------------------------+---------------------------------+----------------------------------+ -| :ref:`2021.2<2021.2>` | :ref:`2021.2.0.1<2021.2.0.1>` | :ref:`2021.2.1<2021.2.1>` | :ref:`2021.2.1.1<2021.2.1.1>` | :ref:`2021.2.1.22<2021.2.1.22>` | :ref:`2021.2.1.23<2021.2.1.23>` | :ref:`2021.2.1.24<2021.2.1.24>` | :ref:`2021.2.1.25<2021.2.1.25>` | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+---------------------------------+---------------------------------+---------------------------------+----------------------------------+ -| :ref:`2021.1<2021.1>` | :ref:`2021.1.1<2021.1.1>` | :ref:`2021.1.1.1<2021.1.1.1>` | :ref:`2021.1.2<2021.1.2>` | | | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+---------------------------------+------------------------------------------------------------------------------------------------------+ -| :ref:`2020.3<2020.3>` | :ref:`2020.3.1<2020.3.1>` | :ref:`2020.3.2.1<2020.3.2.1>` | -+---------------------------------+----------------------------------+--------------------------------+-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------+ -| :ref:`2020.2<2020.2>` | -+---------------------------------+----------------------------------+--------------------------------+-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------+ -| :ref:`2020.1<2020.1>` | -+---------------------------------+----------------------------------+--------------------------------+-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------+ - - +SQream releases notes are specific to each version of the application. Select your version from the table below to see the related release notes. ++---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| **Major Release** | **Minor Releases** | ++---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| :ref:`2022.1<2022.1>` | :ref:`2022.1.1<2022.1.1>` | ++---------------------------------+----------------------------------+---------------------------------+----------------------------------+----------------------------------+----------------------------------+----------------------------------+---------------------------------------+ +|:ref:`2021.1<2021.1>` | :ref:`2021.1.1.1<2021.1.1.1>` | :ref:`2021.1.1.11<2021.1.1.11>` | :ref:`2021.1.1.2<2021.1.1.2>` | :ref:`2021.1.1.3<2021.1.1.3>` | :ref:`2021.1.1.4<2021.1.1.4>` | :ref:`2021.1.1.6<2021.1.1.6>` | :ref:`2021.1.1_rdb_1<2021.1.1_rdb_1>` | ++---------------------------------+----------------------------------+---------------------------------+----------------------------------+----------------------------------+----------------------------------+----------------------------------+---------------------------------------+ +| | :ref:`2021.1.2<2021.1.2>` | ++---------------------------------+----------------------------------+---------------------------------+----------------------------------+----------------------------------+----------------------------------+--------------------------------------------------------------------------+ +|:ref:`2021.2<2021.2>` | :ref:`2021.2.0.1<2021.2.0.1>` |:ref:`2021.2.0.3<2021.2.0.3>` | :ref:`2021.2.1<2021.2.1>` | :ref:`2021.2.1.14<2021.2.1.14>` | :ref:`2021.2.1.16<2021.2.1.16>` | :ref:`2021.2.1.17<2021.2.1.17>` | ++---------------------------------+----------------------------------+---------------------------------+----------------------------------+----------------------------------+----------------------------------+----------------------------------+---------------------------------------+ +| |:ref:`2021.2.1.18<2021.2.1.18>` |:ref:`2021.2.1.19<2021.2.1.19>` | :ref:`2021.2.1.20<2021.2.1.20>` | :ref:`2021.2.1.21<2021.2.1.21>` | :ref:`2021.2.1.22<2021.2.1.22>` | :ref:`2021.2.1.23<2021.2.1.23>` | :ref:`2021.2.1.8<2021.2.1.8>` | ++---------------------------------+----------------------------------+---------------------------------+----------------------------------+----------------------------------+----------------------------------+----------------------------------+---------------------------------------+ +| | :ref:`2021.2.1.18<2021.2.1.18>` | :ref:`2021.1.1<2021.1.1>` | :ref:`2021.1.1.1<2021.1.1.1>` | :ref:`2021.1.2<2021.1.2>` | ++---------------------------------+----------------------------------+---------------------------------+----------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+ +| :ref:`2020.3<2020.3>` | :ref:`2020.3.1<2020.3.1>` | :ref:`2020.3.2.1<2020.3.2.1>` | ++---------------------------------+----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| :ref:`2020.2<2020.2>` | ++------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| :ref:`2020.1<2020.1>` | ++------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. toctree:: From bae359b04c2840434300804e2b38661379233f70 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Mon, 18 Jul 2022 13:56:07 +0300 Subject: [PATCH 117/882] Corrected patch order --- releases/index.rst | 23 ++++++++++++----------- 1 file changed, 12 insertions(+), 11 deletions(-) diff --git a/releases/index.rst b/releases/index.rst index 5e442a689..acb32e800 100644 --- a/releases/index.rst +++ b/releases/index.rst @@ -9,17 +9,17 @@ SQream releases notes are specific to each version of the application. Select yo | **Major Release** | **Minor Releases** | +---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`2022.1<2022.1>` | :ref:`2022.1.1<2022.1.1>` | -+---------------------------------+----------------------------------+---------------------------------+----------------------------------+----------------------------------+----------------------------------+----------------------------------+---------------------------------------+ -|:ref:`2021.1<2021.1>` | :ref:`2021.1.1.1<2021.1.1.1>` | :ref:`2021.1.1.11<2021.1.1.11>` | :ref:`2021.1.1.2<2021.1.1.2>` | :ref:`2021.1.1.3<2021.1.1.3>` | :ref:`2021.1.1.4<2021.1.1.4>` | :ref:`2021.1.1.6<2021.1.1.6>` | :ref:`2021.1.1_rdb_1<2021.1.1_rdb_1>` | -+---------------------------------+----------------------------------+---------------------------------+----------------------------------+----------------------------------+----------------------------------+----------------------------------+---------------------------------------+ -| | :ref:`2021.1.2<2021.1.2>` | -+---------------------------------+----------------------------------+---------------------------------+----------------------------------+----------------------------------+----------------------------------+--------------------------------------------------------------------------+ -|:ref:`2021.2<2021.2>` | :ref:`2021.2.0.1<2021.2.0.1>` |:ref:`2021.2.0.3<2021.2.0.3>` | :ref:`2021.2.1<2021.2.1>` | :ref:`2021.2.1.14<2021.2.1.14>` | :ref:`2021.2.1.16<2021.2.1.16>` | :ref:`2021.2.1.17<2021.2.1.17>` | -+---------------------------------+----------------------------------+---------------------------------+----------------------------------+----------------------------------+----------------------------------+----------------------------------+---------------------------------------+ -| |:ref:`2021.2.1.18<2021.2.1.18>` |:ref:`2021.2.1.19<2021.2.1.19>` | :ref:`2021.2.1.20<2021.2.1.20>` | :ref:`2021.2.1.21<2021.2.1.21>` | :ref:`2021.2.1.22<2021.2.1.22>` | :ref:`2021.2.1.23<2021.2.1.23>` | :ref:`2021.2.1.8<2021.2.1.8>` | -+---------------------------------+----------------------------------+---------------------------------+----------------------------------+----------------------------------+----------------------------------+----------------------------------+---------------------------------------+ -| | :ref:`2021.2.1.18<2021.2.1.18>` | :ref:`2021.1.1<2021.1.1>` | :ref:`2021.1.1.1<2021.1.1.1>` | :ref:`2021.1.2<2021.1.2>` | -+---------------------------------+----------------------------------+---------------------------------+----------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+ ++---------------------------------+----------------------------------+---------------------------------------+----------------------------------+----------------------------------+-------------------------------------------------------------------------------------------------------+ +| :ref:`2021.1<2021.1>` | :ref:`2021.1.1<2021.1.1>` | :ref:`2021.1.1_rdb_1<2021.1.1_rdb_1>` | :ref:`2021.1.1.11<2021.1.1.11>` | :ref:`2021.1.1.2<2021.1.1.2>` | :ref:`2021.1.1.3<2021.1.1.3>` | ++---------------------------------+----------------------------------+---------------------------------------+----------------------------------+----------------------------------+-------------------------------------------------------------------------------------------------------+ +| :ref:`2021.1.1.1<2021.1.1.1>` | :ref:`2021.1.1.4<2021.1.1.4>` | :ref:`2021.1.1.6<2021.1.1.6>` | :ref:`2021.1.1.7<2021.1.1.7>` | :ref:`2021.1.2<2021.1.2>` | ++---------------------------------+----------------------------------+---------------------------------------+----------------------------------+----------------------------------+----------------------------------+--------------------------------------------------------------------+ +| :ref:`2021.2<2021.2>` | :ref:`2021.2.0.1<2021.2.0.1>` |:ref:`2021.2.0.3<2021.2.0.3>` | :ref:`2021.2.1<2021.2.1>` | :ref:`2021.2.1.14<2021.2.1.14>` | :ref:`2021.2.1.16<2021.2.1.16>` | :ref:`2021.2.1.17<2021.2.1.17>` | ++---------------------------------+----------------------------------+---------------------------------------+----------------------------------+----------------------------------+----------------------------------+--------------------------------------------------------------------+ +| | :ref:`2021.2.1.18<2021.2.1.18>` |:ref:`2021.2.1.19<2021.2.1.19>` | :ref:`2021.2.1.20<2021.2.1.20>` | :ref:`2021.2.1.21<2021.2.1.21>` | :ref:`2021.2.1.22<2021.2.1.22>` | :ref:`2021.2.1.23<2021.2.1.23>` | ++---------------------------------+----------------------------------+---------------------------------------+----------------------------------+----------------------------------+----------------------------------+--------------------------------------------------------------------+ +| | :ref:`2021.1.1<2021.1.1>` | :ref:`2021.1.1.1<2021.1.1.1>` | :ref:`2021.2.1.8<2021.2.1.8>` | :ref:`2021.1.2<2021.1.2>` | ++---------------------------------+----------------------------------+---------------------------------------+----------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`2020.3<2020.3>` | :ref:`2020.3.1<2020.3.1>` | :ref:`2020.3.2.1<2020.3.2.1>` | +---------------------------------+----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`2020.2<2020.2>` | @@ -28,6 +28,7 @@ SQream releases notes are specific to each version of the application. Select yo +------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + .. toctree:: :maxdepth: 2 :glob: From 3d355271ccd72d072a0ff399065fe1c754eb28f3 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Mon, 18 Jul 2022 14:11:49 +0300 Subject: [PATCH 118/882] Realignment --- releases/index.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/releases/index.rst b/releases/index.rst index acb32e800..19f447988 100644 --- a/releases/index.rst +++ b/releases/index.rst @@ -9,10 +9,10 @@ SQream releases notes are specific to each version of the application. Select yo | **Major Release** | **Minor Releases** | +---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`2022.1<2022.1>` | :ref:`2022.1.1<2022.1.1>` | -+---------------------------------+----------------------------------+---------------------------------------+----------------------------------+----------------------------------+-------------------------------------------------------------------------------------------------------+ -| :ref:`2021.1<2021.1>` | :ref:`2021.1.1<2021.1.1>` | :ref:`2021.1.1_rdb_1<2021.1.1_rdb_1>` | :ref:`2021.1.1.11<2021.1.1.11>` | :ref:`2021.1.1.2<2021.1.1.2>` | :ref:`2021.1.1.3<2021.1.1.3>` | -+---------------------------------+----------------------------------+---------------------------------------+----------------------------------+----------------------------------+-------------------------------------------------------------------------------------------------------+ -| :ref:`2021.1.1.1<2021.1.1.1>` | :ref:`2021.1.1.4<2021.1.1.4>` | :ref:`2021.1.1.6<2021.1.1.6>` | :ref:`2021.1.1.7<2021.1.1.7>` | :ref:`2021.1.2<2021.1.2>` | ++---------------------------------+----------------------------------+---------------------------------------+----------------------------------+----------------------------------+----------------------------------+--------------------------------------------------------------------+ +| :ref:`2021.1<2021.1>` | :ref:`2021.1.1<2021.1.1>` | :ref:`2021.1.1_rdb_1<2021.1.1_rdb_1>` | :ref:`2021.1.1.1<2021.1.1.1>` | :ref:`2021.1.1.11<2021.1.1.11>` | :ref:`2021.1.1.2<2021.1.1.2>` | :ref:`2021.1.1.3<2021.1.1.3>` | ++---------------------------------+----------------------------------+---------------------------------------+----------------------------------+----------------------------------+----------------------------------+--------------------------------------------------------------------+ +| | :ref:`2021.1.1.4<2021.1.1.4>` | :ref:`2021.1.1.6<2021.1.1.6>` | :ref:`2021.1.1.7<2021.1.1.7>` | :ref:`2021.1.2<2021.1.2>` | +---------------------------------+----------------------------------+---------------------------------------+----------------------------------+----------------------------------+----------------------------------+--------------------------------------------------------------------+ | :ref:`2021.2<2021.2>` | :ref:`2021.2.0.1<2021.2.0.1>` |:ref:`2021.2.0.3<2021.2.0.3>` | :ref:`2021.2.1<2021.2.1>` | :ref:`2021.2.1.14<2021.2.1.14>` | :ref:`2021.2.1.16<2021.2.1.16>` | :ref:`2021.2.1.17<2021.2.1.17>` | +---------------------------------+----------------------------------+---------------------------------------+----------------------------------+----------------------------------+----------------------------------+--------------------------------------------------------------------+ From 9695e6d138e6c3f5d517307beba45ec9d9eb6b1e Mon Sep 17 00:00:00 2001 From: YanivGerowitz <82020437+YanivGerowitz@users.noreply.github.com> Date: Tue, 19 Jul 2022 12:23:36 +0300 Subject: [PATCH 119/882] Add files via upload From abfd0bd98937971597d518df78ef719d5953724e Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 19 Jul 2022 12:27:49 +0300 Subject: [PATCH 120/882] Documented External Bugs for 2022.1 Reverted to original index table structure. Will reimplement new index table structure after filtering between external/internal bugs for 2021.1 and 2021.2. Need to filter and re-implement patch for 2022.1.1. All removed files saved in local folder: C:\Users\Yaniv\Desktop\Yaniv\Release Notes\2022.1\releases_new_structure_with_patches --- .../get_extents_file_list_for_chunk.rst | 22 +- .../get_metadata_chunk_key.rst | 4 +- releases/2020.3_index.rst | 17 +- releases/2021.1.1.1.rst | 32 --- releases/2021.1.1.rst | 71 ------ releases/2021.1_index.rst | 18 +- releases/2021.2.0.1.rst | 40 ---- releases/2021.2.1.1.rst | 28 --- releases/2021.2.1.22.rst | 26 --- releases/2021.2.1.23.rst | 26 --- releases/2021.2.1.24.rst | 57 ----- releases/2021.2_index.rst | 19 +- releases/2022.1.1.rst | 77 ------ releases/2022.1.rst | 221 +++--------------- releases/2022.1_index.rst | 20 -- releases/index.rst | 44 ++-- 16 files changed, 78 insertions(+), 644 deletions(-) delete mode 100644 releases/2021.1.1.1.rst delete mode 100644 releases/2021.1.1.rst delete mode 100644 releases/2021.2.0.1.rst delete mode 100644 releases/2021.2.1.1.rst delete mode 100644 releases/2021.2.1.22.rst delete mode 100644 releases/2021.2.1.23.rst delete mode 100644 releases/2021.2.1.24.rst delete mode 100644 releases/2022.1.1.rst delete mode 100644 releases/2022.1_index.rst diff --git a/reference/sql/sql_statements/utility_commands/get_extents_file_list_for_chunk.rst b/reference/sql/sql_statements/utility_commands/get_extents_file_list_for_chunk.rst index 3c05a48fe..968c0655a 100644 --- a/reference/sql/sql_statements/utility_commands/get_extents_file_list_for_chunk.rst +++ b/reference/sql/sql_statements/utility_commands/get_extents_file_list_for_chunk.rst @@ -53,8 +53,6 @@ Output ========== The following table describes the output generated from the ``GET_EXTENTS_FILE_FOR_CHUNK`` command: -Database name. table name, table id, column id, chunk id, file path - .. list-table:: :widths: 25 25 25 25 :header-rows: 1 @@ -81,31 +79,29 @@ Database name. table name, table id, column id, chunk id, file path * - ``column_id`` - The status of the chunk. - - **Comment** - *What is the type?* + - Numeric - ``1`` * - ``chunk_id`` - Describes the state of the chunk. - - **Comment** - *What is the type?* + - Numeric - ``chunk_state::`` * - ``file_path`` - Shows the path of the file. - Text - - **Comment** - *Provide example + - /home/sqream_testing_temp/sqreamdb/databases/master/tables The following is an example of the output generated from the ``GET_EXTENTS_FILE_FOR_CHUNK`` command: .. code-block:: postgres - master,public.t_1,0,0,3,/home/eyalw/sqream_testing_temp/sqreamdb/databases/master/tables/0/0/0-2 - master,public.t_1,0,1,3,/home/eyalw/sqream_testing_temp/sqreamdb/databases/master/tables/0/1/1-2 - master,public.t_1,0,2,3,/home/eyalw/sqream_testing_temp/sqreamdb/databases/master/tables/0/2/2-2 - master,public.t_1,0,3,3,/home/eyalw/sqream_testing_temp/sqreamdb/databases/master/tables/0/3/3-2 - master,public.t_1,0,4,3,/home/eyalw/sqream_testing_temp/sqreamdb/databases/master/tables/0/4/4-2 + master,public.t_1,0,0,3,/home/sqream_testing_temp/sqreamdb/databases/master/tables + master,public.t_1,0,1,3,/home/sqream_testing_temp/sqreamdb/databases/master/tables + master,public.t_1,0,2,3,/home/sqream_testing_temp/sqreamdb/databases/master/tables + master,public.t_1,0,3,3,/home/sqream_testing_temp/sqreamdb/databases/master/tables + master,public.t_1,0,4,3,/home/sqream_testing_temp/sqreamdb/databases/master/tables Permissions ============= -The ``GET_EXTENTS_FILE_FOR_CHUNK`` requires no special permissions. - -**Comment** - *Does it require any special permissions?* \ No newline at end of file +The ``GET_EXTENTS_FILE_FOR_CHUNK`` requires no special permissions. \ No newline at end of file diff --git a/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst b/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst index c43775de7..9c69d423f 100644 --- a/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst +++ b/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst @@ -148,6 +148,4 @@ The following is an example of the output generated from the ``GET_METADATA_CHUN Permissions ============= -The ``GET_METADATA_CHUNK_KEY`` requires no special permissions. - -**Comment** - *Does it require any special permissions?* \ No newline at end of file +The ``GET_METADATA_CHUNK_KEY`` requires no special permissions. \ No newline at end of file diff --git a/releases/2020.3_index.rst b/releases/2020.3_index.rst index 19bf3bd79..b13340b52 100644 --- a/releases/2020.3_index.rst +++ b/releases/2020.3_index.rst @@ -3,19 +3,16 @@ ************************** Release Notes 2020.3 ************************** -SQream releases notes are specific to each version of the application. Select your version from the table below to see the related release notes. +The 2020.3 Release Notes describe the following releases: -+---------------------------------+----------------------------------+------------------------------------------------------------------+ -| **Major Release** | **Minor Releases** | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+ -| :ref:`2020.3<2020.3>` | :ref:`2020.3.1<2020.3.1>` | :ref:`2020.3.2.1<2020.3.2.1>` | | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+ +.. contents:: + :local: + :depth: 1 .. toctree:: - :maxdepth: 2 + :maxdepth: 1 :glob: - :hidden: - 2020.3 + 2020.3.2.1 2020.3.1 - 2020.3.2.1 \ No newline at end of file + 2020.3 \ No newline at end of file diff --git a/releases/2021.1.1.1.rst b/releases/2021.1.1.1.rst deleted file mode 100644 index 2e562c858..000000000 --- a/releases/2021.1.1.1.rst +++ /dev/null @@ -1,32 +0,0 @@ -.. _2021.1.1.1: - -************************** -Release Notes 2021.1.1.1 -************************** -The 2021.1.1.1 release notes is a patch version released on 27/6/2022. - -The following table lists the issues that were resolved in Version 2021.1.1.1: - -.. list-table:: - :widths: 17 200 - :header-rows: 1 - - * - SQ No. - - Description - * - SQ-7045 - - Replace function doesn't support column value - * - SQ-7640 - - Some dates can't be recognized as a standard date format - * - SQ-7658 - - Can't perform "=" function between varchar(1) and text argument - * - SQ-7588 - - A thread that removes stuck open snapshots - -Version 2021.1.1.1 has no unresolved issues. - -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2021.1.1.1 \ No newline at end of file diff --git a/releases/2021.1.1.rst b/releases/2021.1.1.rst deleted file mode 100644 index 992b2f850..000000000 --- a/releases/2021.1.1.rst +++ /dev/null @@ -1,71 +0,0 @@ -.. _2021.1.1: - -************************** -Release Notes 2021.1.1 -************************** -The 2021.1.1 release notes were released on 7/27/2021 and describe the following: - -.. contents:: - :local: - :depth: 1 - -New Features -------------- -The 2021.1.1 Release Notes include the following new features: - -.. contents:: - :local: - :depth: 1 - -Complete Ranking Function Support -************ -SQream now supports the following new ranking functions: - -.. list-table:: - :widths: 1 23 76 - :header-rows: 1 - - * - Function - - Return Type - - Description - * - first_value - - Same type as value - - Returns the value in the first row of a window. - * - last_value - - Same type as value - - Returns the value in the last row of a window. - * - nth_value - - Same type as value - - Returns the value in a specified (``n``) row of a window. if the specified row does not exist, this function returns ``NULL``. - * - dense_rank - - bigint - - Returns the rank of the current row with no gaps. - * - percent_rank - - double - - Returns the relative rank of the current row. - * - cume_dist - - double - - Returns the cumulative distribution of rows. - * - ntile(buckets) - - integer - - Returns an integer ranging between ``1`` and the argument value, dividing the partitions as equally as possible. - -For more information, navigate to Windows Functions and scroll to the `Ranking Functions table `_. - - -Resolved Issues -------------- -The following list describes the resolved issues: - -* SQream did not support exporting and reading **Int64** columns as **bigint** in Parquet. This was fixed. -* The Decimal column was not supported when inserting data from Parquet files. This was fixed. -* Values in Parquet Numeric columns were not being converted correctly. This was fixed. -* Converting ``string`` data type to ``datetime`` was not working correctly. This was fixed. -* Casting ``datetime`` to ``text`` truncated the time. This was fixed. - -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2021.1.1 \ No newline at end of file diff --git a/releases/2021.1_index.rst b/releases/2021.1_index.rst index 0fa9d6ccf..64b06e1d1 100644 --- a/releases/2021.1_index.rst +++ b/releases/2021.1_index.rst @@ -3,20 +3,16 @@ ************************** Release Notes 2021.1 ************************** -SQream releases notes are specific to each version of the application. Select your version from the table below to see the related release notes. +The 2021.1 Release Notes describe the following releases: -+---------------------------------+----------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| **Major Release** | **Minor Releases** | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+---------------------------------+---------------------------------+---------------------------------+----------------------------------+ -| :ref:`2021.1<2021.1>` | :ref:`2021.1.1<2021.1.1>` | :ref:`2021.1.1.1<2021.1.1.1>` | :ref:`2021.1.2<2021.1.2>` | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+---------------------------------+------------------------------------------------------------------------------------------------------+ +.. contents:: + :local: + :depth: 1 .. toctree:: - :maxdepth: 2 + :maxdepth: 1 :glob: - :hidden: - 2021.1 + 2021.1.2 2021.1.1 - 2021.1.1.1 - 2021.1.2 \ No newline at end of file + 2021.1 \ No newline at end of file diff --git a/releases/2021.2.0.1.rst b/releases/2021.2.0.1.rst deleted file mode 100644 index 03edcad4e..000000000 --- a/releases/2021.2.0.1.rst +++ /dev/null @@ -1,40 +0,0 @@ -.. _2021.2.0.1: - -************************** -Release Notes 2021.2.0.1 -************************** -The 2021.2.0.1 release notes were released on x/x/xxxx and describe the following: - -The following table lists the issues that were resolved in Version 2021.2.0.1: - -.. list-table:: - :widths: 17 200 - :header-rows: 1 - - * - SQ No. - - Description - * - SQ-8345 - - Studio-How does a publicUser connect to a specified service? - * - SQ-8343 - - Running SQream from docker does not show configuration extended info - * - SQ-8294 - - Quote qualifier is not present in exported file thus file cannot be reloaded - * - SQ-8288 - - Support parameter TEXT casts - * - SQ-8272 - - `cleanup_chunk` creates garbage metadata, potentially leading to wrong results - * - SQ-8271 - - Saved query parameters of type text are not supported - * - SQ-8266 - - [LGE] Data loading issue depending to column order. // bad syntax (datetime type) - * - SQ-8266 - - [LGE] Data loading issue depending to column order. // bad syntax (datetime type) - -Version 2021.2.0.1 has no unresolved issues. - -.. toctree:: - :maxdepth: 3 - :glob: - :hidden: - - 2021.2.0.1 \ No newline at end of file diff --git a/releases/2021.2.1.1.rst b/releases/2021.2.1.1.rst deleted file mode 100644 index 65cf1b8a1..000000000 --- a/releases/2021.2.1.1.rst +++ /dev/null @@ -1,28 +0,0 @@ -.. _2021.2.1.1: - -****************************** -Release Notes 2021.2.1.1 -****************************** -The 2021.2.1.1 release notes is a patch version released on 9/12/2021. - -The following table lists the issues that were resolved in Version 2021.2.1.1: - -.. list-table:: - :widths: 17 200 - :header-rows: 1 - - * - SQ No. - - Description - * - SQ-9114 - - `cleanup_extents` on empty texts results in a missing file - * - SQ-8849 - - `Unclear "Map:at" error for invalid column mapping of Parquet files - -Version 2021.2.1.1 has no unresolved issues. - -.. toctree:: - :maxdepth: 3 - :glob: - :hidden: - - 2021.2.1.1 \ No newline at end of file diff --git a/releases/2021.2.1.22.rst b/releases/2021.2.1.22.rst deleted file mode 100644 index 62346a3c8..000000000 --- a/releases/2021.2.1.22.rst +++ /dev/null @@ -1,26 +0,0 @@ -.. _2021.2.1.22: - -****************************** -Release Notes 2021.2.1.22 -****************************** -The 2021.2.1.22 release notes is a patch version released on 13/6/2022. - -The following table lists the issues that were resolved in Version 2021.2.1.22: - -.. list-table:: - :widths: 17 200 - :header-rows: 1 - - * - SQ No. - - Description - * - SQ-10776 - - Out Of Memory invoked during copy from with multiple files. - -Version 2021.2.1.22 has no unresolved issues. - -.. toctree:: - :maxdepth: 4 - :glob: - :hidden: - - 2021.2.1.22 \ No newline at end of file diff --git a/releases/2021.2.1.23.rst b/releases/2021.2.1.23.rst deleted file mode 100644 index ca5e2dcbe..000000000 --- a/releases/2021.2.1.23.rst +++ /dev/null @@ -1,26 +0,0 @@ -.. _2021.2.1.23: - -****************************** -Release Notes 2021.2.1.23 -****************************** -The 2021.2.1.23 release notes is a patch version released on 27/6/2022. - -The following table lists the issues that were resolved in Version 2021.2.1.23: - -.. list-table:: - :widths: 17 200 - :header-rows: 1 - - * - SQ No. - - Description - * - SQ-10703 - - When the clause is specified, all existing permissions granted on source_table_name are granted on table_name as well. - -Version 2021.2.1.23 has no unresolved issues. - -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2021.2.1.23 \ No newline at end of file diff --git a/releases/2021.2.1.24.rst b/releases/2021.2.1.24.rst deleted file mode 100644 index cf4a2f391..000000000 --- a/releases/2021.2.1.24.rst +++ /dev/null @@ -1,57 +0,0 @@ -.. _2021.2.1.24: - -****************************** -Release Notes 2021.2.1.24 -****************************** -The 2021.2.1.24 release notes is a patch version released on xxxxxxxxxxxx. - -The following table lists the issues that were resolved in Version 2021.2.1.24.rst: - -+-------------+----------------------------------------------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+=============+==================================================================================================================================+ -| SQ-9721 | pysqream - not finishing query | -+-------------+----------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10071 | error on exists subqueries with text and varchar equality condition | -+-------------+----------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10606 | [ACL] Queries getting stuck in the queue for a long time (Executing status) | -+-------------+----------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10691 | DB Schema identifier causes an error running some queries from joins suite - v2021.2.1_stable | -+-------------+----------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10843 | When getting "illegal memory access was encountered" error message worker does not crash, but fails every query afterwards. | -+-------------+----------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10879 | Performance | degradations in insert as select from ORC files | -+-------------+----------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10902 | test_copy_null_to_not_null[all_types-parquet] (from Generic Copy From) crashes sqreamd | -+-------------+----------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10918 | [SDC] WLM only assings jobs sequentially and it causes delay on user sqls when they are assigned to a worker running a huge job | -+-------------+----------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10955 | No metadata filters when filtering by nullable date using dateadd (LGU+) | -+-------------+----------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10963 | Extract File Reaper Mechanism To Separated Process | -+-------------+----------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10975 | Merging ACL's open snapshot functionality from V2021.1.1 to V2021.2.1.x | -+-------------+----------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10976 | Merging all V2021.1.X fixes/features to V2021.2&V2022.1.X | -+-------------+----------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11000 | DROP DATABASE fails to remove database path under sqreamdb and following creation commands is stuck | -+-------------+----------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11043 | correlated_subqueries_v1 test failed | -+-------------+----------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11055 | performance degradation - tpch10t - cases #1299, #1315, #1307 & #1297 | -+-------------+----------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11088 | specific worker compiling causes low performance | -+-------------+----------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11090 | SQream keeps the configuration flags where the query compiled and use it when the query is executed on a different worker | -+-------------+----------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11159 | Redesign the heartbeat timers, worker and metadata. | -+-------------+----------------------------------------------------------------------------------------------------------------------------------+ - -Version 2021.2.1.24 has no unresolved issues. - -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2021.2.1.24 \ No newline at end of file diff --git a/releases/2021.2_index.rst b/releases/2021.2_index.rst index 98a256bc2..77a22b0ae 100644 --- a/releases/2021.2_index.rst +++ b/releases/2021.2_index.rst @@ -3,22 +3,15 @@ ************************** Release Notes 2021.2 ************************** -SQream releases notes are specific to each version of the application. Select your version from the table below to see the related release notes. +The 2021.2 Release Notes describe the following releases: -+---------------------------------+----------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------+---------------------------------+----------------------------------+ -| **Major Release** | **Minor Releases** | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+---------------------------------+------------------------------------------------------------------------------------------------------+ -| :ref:`2021.2<2021.2>` | :ref:`2021.2.0.1<2021.2.0.1>` | :ref:`2021.2.1<2021.2.1>` | :ref:`2021.2.1.1<2021.2.1.1>` | :ref:`2021.2.1.22<2021.2.1.22>` | :ref:`2021.2.1.23<2021.2.1.23>` | -+---------------------------------+----------------------------------+--------------------------------+---------------------------------+---------------------------------+---------------------------------+---------------------------------+----------------------------------+ +.. contents:: + :local: + :depth: 1 .. toctree:: - :maxdepth: 2 + :maxdepth: 1 :glob: - :hidden: - 2021.2 - 2021.2.0.1 2021.2.1 - 2021.2.1.1 - 2021.2.1.22 - 2021.2.1.23 \ No newline at end of file + 2021.2 \ No newline at end of file diff --git a/releases/2022.1.1.rst b/releases/2022.1.1.rst deleted file mode 100644 index 081d608f2..000000000 --- a/releases/2022.1.1.rst +++ /dev/null @@ -1,77 +0,0 @@ -.. _2022.1.1: - -************************** -Release Notes 2022.1.1 -************************** -The 2022.1.1 release notes were released on x/x/xxxx and describe the following: - -The following table lists the issues that were resolved in Version 2022.1.1: - -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+=============+==================================================================================================================================================+ -| SQ-6419 | Internal compiler error when casting numeric literal in aggregation function | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-9771 | The error returns different value when trying to insert date value without quotes. | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10100 | Implicit/Explicit cast from int/tinyint/bigint to bool is not working | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10741 | Got difference in execution time when ingesting data | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10772 | Internal Runtime Error when creating a text column with a limit characters size >= 1 and 30 zeros | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10790 | copy from with '*' (wildcard) from parquet is 3X slower than CSV | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10793 | Implement "Brute Force" Protection policy for the system login | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10816 | Data management on Big Table | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10838 | Repeat function throws an exception when entered a negative number | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10840 | UF - list all files related to chunk id, Get specific chunk key values | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10852 | Password Strength Check | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10863 | Performance | LGU | high SD in the duration of 'insert as select' query | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10873 | Inserting 100K bytes to a text column results in unclear error message | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10886 | Error in compilation process: : "Internal compiler error: | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10892 | Update || change error message when trying to run update on foreign table | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10899 | Cannot change the value of diskSpaceMinFreePercent - it is hard coded to 10% | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10919 | Automatic Foreign Table DDL Resolution | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10955 | No metadata filters when filtering by nullable date using dateadd (LGU+) | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10956 | Exception: "Could not read view.." - recompile and recreate doesn't help | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10963 | Extract File Reaper Mechanism To Separated Process | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10976 | Merging all V2021.1.X fixes/features to V2021.2&V2022.1.X | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10980 | sqream crashing when executing copy from avro (negative case copy file to unmatched column table) | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10988 | [SDC] stop_statement() doesn't work on jobs in queue | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11014 | Different float values between sqream and postgress | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11121 | Merging ACL's open snapshot functionality from V2021.1.1 to v2022.1.x code line | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11137 | CLONE - When getting "illegal memory access was encountered" error message worker does not crash, but fails every query afterwards. - AUTOMATIC | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11154 | After SQ-10980 fix, there is wrong error raised ("OVERFLOW exception") instead of "Tried inserting AVRO non-decimal" | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11158 | [ACL] Datediff doesn't work with specific dates - returns "Cast overflow" | -+-------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ - -Version 2022.1.1 has no unresolved issues. - -.. toctree:: - :maxdepth: 3 - :glob: - :hidden: - - 2022.1.1 \ No newline at end of file diff --git a/releases/2022.1.rst b/releases/2022.1.rst index 74e568fad..b6ffdf9ef 100644 --- a/releases/2022.1.rst +++ b/releases/2022.1.rst @@ -3,7 +3,7 @@ ************************** Release Notes 2022.1 ************************** -The 2022.1 release notes were released on x/xx/2022 and describe the following: +The 2022.1 release notes were released on 7/19/2022 and describe the following: .. contents:: :local: @@ -56,191 +56,35 @@ The following two new utility commands have been created: * `GET_METADATA_CHUNK_KEY `_ - returns specific metadata key values for user-specified chunks. +Known Issues +--------- +The following table lists the known issues for Version 2022.1: + ++-------------+-------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++=============+===========================================================================================+ +| SQ-7732 | Reading numeric columns from an external Parquet file generated an error. | ++-------------+-------------------------------------------------------------------------------------------+ +| SQ-9889 | Running a query including Thai characters generated an internal runtime error. | ++-------------+-------------------------------------------------------------------------------------------+ +| SQ-10071 | error on exists subqueries with text and varchar equality condition | ++-------------+-------------------------------------------------------------------------------------------+ +| SQ-10191 | The ``ALTER DEFAULT SCHEMA`` command was not functioning correctly. | ++-------------+-------------------------------------------------------------------------------------------+ +| SQ-10629 | Inserting data into a table significantly slowed down running queries. | ++-------------+-------------------------------------------------------------------------------------------+ +| SQ-10659 | Using a comment generated a compile error. | ++-------------+-------------------------------------------------------------------------------------------+ + Resolved Issues --------- The following table lists the issues that were resolved in Version 2022.1: -**Comment** - *The items in the table below must be filtered according to external and internal bugs. We CANNOT expose internal bugs to external users.* - -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-7490 | Native Avro file access via a dedicated FDW | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-7718 | Certify LTS Ubuntu versions (18.04 & 20.04) for production usage | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-7732 | Fail to read numeric columns from an external generated parquet file | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-8163 | Performance degradation - tpch1t_external_table_parquet - cases #6079 & #6105 | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-8182 | Encryption Function | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-8984 | Update statement MVP: literal assignment | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-9221 | [Mobicom] PBI - External Tables are not shown on the tables list. | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-9611 | Create a WIN-874 to UTF-8 conversion function | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-9634 | identifier not found | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-9644 | [ACL] Incomplete logs query causing Internal Runtime Error | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-9671 | Trying to read Thai UTF-8 csv file in TEXT column and it not shows Thai | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-9764 | No error when create a foreign table with difference in the column numbers in the table and the file | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-9790 | Encryption - MVP scope | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-9808 | Allowing to set deferredValueIOThresholdFactor flag not in developer Mode=true | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-9823 | [AIS] The user can't use literals when using sqream with Thai varchar | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-9889 | [AIS] Internal runtime Error receive | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-9952 | Removing temp files takes too long - timeout issue at LGU+ | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-9988 | Find a proper solution for data lost during copy from parquet - without reverting previous optimization | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-9990 | Merge v2021.2.1_stable into develop | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10005 | Go / No Go approvals | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10011 | Delete filter optimization chicken flag | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10055 | [SamsungDisplay] Slow loading of sqream after backup compacting | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10061 | compiler side - Implement MVP scope | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10071 | error on exists subqueries with text and varchar equality condition | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10111 | Parquet numeric - Sqream can't import parquet numeric columns from other sources | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10191 | [LGE] ALTER DEFAULT SCHEMA command has a problem. | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10216 | Performance degradation - tpch1t_1mchunk - case #1326 #1345 | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10242 | socket 11 error from "Create as Select~" | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10269 | cleanup_chunk error with text(X) column | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10314 | Unable to load avro file to sqream v1 + v2 from s3 | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10319 | Error on copy from avro file with numeric data | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10425 | Lot of time in copy from, external table parquet file | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10428 | [LGU] Can not execute cleanup_extents on table because there are mixed chunks | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10470 | count distinct on 0 rows doesn't return any value | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10478 | get_ddl disregards encrypted columns | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10479 | create a table with more than three encrypted column with no error | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10492 | Wrong values when select from table have encrypted column and regular column | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10494 | No “encrypted” label when read from table with encrypted column | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10496 | Not able to insert data to encrypted column after performing delete on the column | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10514 | No error when create table with encrypted column for the unsupported data types | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10515 | Run time error when decrypt 1 million rows | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10518 | create foreign table with encrypted column with no error | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10532 | Get Read time out error when try to read avro to wrong ddl (Frozen client) | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10534 | Wrong error message when copy null values from avro file to not null ddl (Overflow case instead null to not null) | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10551 | No error when add encrypt column to already existing table | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10585 | [V1] ORC Numeric reading - Overflow error | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10586 | SQream crashed when encrypt 1 billion rows | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10593 | Seg fault when inserting AVRO non-decimal value to Numeric type | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10594 | Some of configuration flags are displaced in default config | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10613 | Samsung test fail on branch v2022.1_stable | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10629 | Different join type between SELECT (Left) vs INSERT INTO SELECT (Left cross) | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10631 | Performance degradation - copies - copy_nvarchar40.sql - case #4556 | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10632 | Performance degradation - insert_as_select - insert_as_select_parquet_int.sql - case #4971 | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10655 | Performance degradation- some queries that perform COPY FROM - case #4624 | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10656 | Performance degradation - insert_as_select - #4971 & #4984 | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10659 | [SDC] Compile Error when using comment | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10665 | AWS V2 - Files are not deleted from S3 storage after DROP database and DROP table | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10667 | Log file not created when execute copy from avro | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10677 | Different results between subquery and physical table | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10692 | Internal Runtime Error when decrypt 1 million rows of text data type | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10695 | when ingest 100 million data into table with 3 encrypted column it took time more than expected | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10716 | Error on copy from avro (Expected auto cast) | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10734 | nvarchar_backward_comp1 failed in regression on branch v2022.1_stable | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10735 | numeric_upgrade_storage has failed in regression on v2022.1_stable | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10738 | Sqream worker on GPU id 1 consume also from GPU id 0 | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10745 | compiler_tests failed in regression on v2022.1_stable | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10776 | Out Of Memory invoked during copy from with multiple files | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10813 | Copy To - The statement doesn't working when I use with 'Avro' format for location='s3....' | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10823 | window_functions_part1 failed in regression in develop | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10855 | CLONE - UF - list all files related to chunk id, Get specific chunk key values | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10869 | Enable/Disable encryption by default | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10871 | Copy To - Getting an error when missing file_name in the end of the path at the location field(This happen only at Avro format) | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10877 | Avro not implemented on stable version v2022 s3 | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10885 | Filter on Delete - should be tested | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10889 | v2022.1_stable => Internal compiler error: Bad encryption type | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10895 | [AIS] behavior is not consistent when the user using Literals with Thai varchar WIN-874 or Thai text UTF-8 | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10902 | test_copy_null_to_not_null[all_types-parquet] (from Generic Copy From) crashes sqreamd | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10916 | [AIS] varcharEncoding": "WINDOWS-874" Flag should work NOT ONLY in Developer mode | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10938 | REGEXP_REPLACE is not supported in 2022 version | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10962 | Using Thai Literals on v2022 with Text type output shows bad results ONLY ON Clientcmd | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10987 | [AIS] The system not allowing to control the update permissions - Grant update permission | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10999 | File tracker error logs on Sqream with MD - insert & select queries | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11043 | correlated_subqueries_v1 test failed | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11063 | Migration of Varchar to Text - keep the size of Varchar after the migration to the text type. | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11101 | Show locks test failed in regression for v2022.1 | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11109 | User can't change his own password using the UI | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11168 | Migration script on 1B rows table and 8 columns output with Internal run time error. | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11170 | Create a tool for migrating a Varchar table to Text | -+------------+-------------------------------------------------------------------------------------------------------------------------------------+ ++-------------+-------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++=============+===========================================================================================+ +| SQ-10111 | Reading numeric columns from an external Parquet file generated an error. | ++-------------+-------------------------------------------------------------------------------------------+ Operations and Configuration Changes -------- @@ -256,20 +100,9 @@ In SQream version 2022.1 the ``VARCHAR`` data type has been deprecated and repla If you are using an earlier version of SQream, see the `Using Legacy String Literals `_ configuration flag. -Known Issues and Limitations --------- -**Comment** - *TBD* - -The the list below describes the following known issues and limitations: - -* Text -* Text - End of Support ------- -**Comment** - *We need to know what to put here.* - -This section is not relevant to the 2022.1 release notes. +The End of Support section is not relevant to Version 2022.1. Upgrading to v2022.1 ------- diff --git a/releases/2022.1_index.rst b/releases/2022.1_index.rst deleted file mode 100644 index 6393d5511..000000000 --- a/releases/2022.1_index.rst +++ /dev/null @@ -1,20 +0,0 @@ -.. _2022.1_index: - -************************** -Release Notes 2022.1 -************************** -The 2022.1 Release Notes describe the following releases: - -+---------------------------------+----------------------------------+ -| **Major Release** | **Minor Releases** | -+---------------------------------+----------------------------------+ -| :ref:`2022.1<2022.1>` | :ref:`2022.1.1<2022.1.1>` | -+---------------------------------+----------------------------------+ - -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2022.1 - 2022.1.1 \ No newline at end of file diff --git a/releases/index.rst b/releases/index.rst index 19f447988..b1d065a9e 100644 --- a/releases/index.rst +++ b/releases/index.rst @@ -3,29 +3,27 @@ ********** Release Notes ********** -SQream releases notes are specific to each version of the application. Select your version from the table below to see the related release notes. -+---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| **Major Release** | **Minor Releases** | -+---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| :ref:`2022.1<2022.1>` | :ref:`2022.1.1<2022.1.1>` | -+---------------------------------+----------------------------------+---------------------------------------+----------------------------------+----------------------------------+----------------------------------+--------------------------------------------------------------------+ -| :ref:`2021.1<2021.1>` | :ref:`2021.1.1<2021.1.1>` | :ref:`2021.1.1_rdb_1<2021.1.1_rdb_1>` | :ref:`2021.1.1.1<2021.1.1.1>` | :ref:`2021.1.1.11<2021.1.1.11>` | :ref:`2021.1.1.2<2021.1.1.2>` | :ref:`2021.1.1.3<2021.1.1.3>` | -+---------------------------------+----------------------------------+---------------------------------------+----------------------------------+----------------------------------+----------------------------------+--------------------------------------------------------------------+ -| | :ref:`2021.1.1.4<2021.1.1.4>` | :ref:`2021.1.1.6<2021.1.1.6>` | :ref:`2021.1.1.7<2021.1.1.7>` | :ref:`2021.1.2<2021.1.2>` | -+---------------------------------+----------------------------------+---------------------------------------+----------------------------------+----------------------------------+----------------------------------+--------------------------------------------------------------------+ -| :ref:`2021.2<2021.2>` | :ref:`2021.2.0.1<2021.2.0.1>` |:ref:`2021.2.0.3<2021.2.0.3>` | :ref:`2021.2.1<2021.2.1>` | :ref:`2021.2.1.14<2021.2.1.14>` | :ref:`2021.2.1.16<2021.2.1.16>` | :ref:`2021.2.1.17<2021.2.1.17>` | -+---------------------------------+----------------------------------+---------------------------------------+----------------------------------+----------------------------------+----------------------------------+--------------------------------------------------------------------+ -| | :ref:`2021.2.1.18<2021.2.1.18>` |:ref:`2021.2.1.19<2021.2.1.19>` | :ref:`2021.2.1.20<2021.2.1.20>` | :ref:`2021.2.1.21<2021.2.1.21>` | :ref:`2021.2.1.22<2021.2.1.22>` | :ref:`2021.2.1.23<2021.2.1.23>` | -+---------------------------------+----------------------------------+---------------------------------------+----------------------------------+----------------------------------+----------------------------------+--------------------------------------------------------------------+ -| | :ref:`2021.1.1<2021.1.1>` | :ref:`2021.1.1.1<2021.1.1.1>` | :ref:`2021.2.1.8<2021.2.1.8>` | :ref:`2021.1.2<2021.1.2>` | -+---------------------------------+----------------------------------+---------------------------------------+----------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ -| :ref:`2020.3<2020.3>` | :ref:`2020.3.1<2020.3.1>` | :ref:`2020.3.2.1<2020.3.2.1>` | -+---------------------------------+----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| :ref:`2020.2<2020.2>` | -+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| :ref:`2020.1<2020.1>` | -+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. list-table:: + :widths: auto + :header-rows: 1 + + + * - Version + - Release Date + * - :ref:`2022.1` + - July 19, 2022 + * - :ref:`2021.2` + - September 13, 2021 + * - :ref:`2021.1` + - June 13, 2021 + * - :ref:`2020.3` + - October 8, 2020 + * - :ref:`2020.2` + - July 22, 2020 + * - :ref:`2020.1` + - January 15, 2020 @@ -34,7 +32,7 @@ SQream releases notes are specific to each version of the application. Select yo :glob: :hidden: - 2022.1_index + 2022.1 2021.2_index 2021.1_index 2020.3_index From ce03a5ea5bb41dab92621fb5a335db6b0a4710b5 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 19 Jul 2022 14:02:36 +0300 Subject: [PATCH 121/882] Update get_metadata_chunk_key.rst --- .../utility_commands/get_metadata_chunk_key.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst b/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst index 9c69d423f..08eba8345 100644 --- a/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst +++ b/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst @@ -78,12 +78,12 @@ The following table describes the output generated from the ``GET_METADATA_CHUNK * - ``chunk_status`` - The status of the chunk. - - **Comment** - *What is the type?* + - Numeric - ``1`` * - ``chunk_aligned`` - Describes the state of the chunk. - - **Comment** - *What is the type?* + - Text - ``chunk_state::`` * - ``offset_in_file`` From 74a04f3e7196aae9457c44457b182980602d953a Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 19 Jul 2022 17:24:35 +0300 Subject: [PATCH 122/882] Implementing SQ-10818 on live branch (testing) https://sqream.atlassian.net/browse/SQ-10818 If works correctly, will implement on all other live branches. --- reference/catalog_reference.rst | 610 +----------------- .../catalog_reference_additonal_tables.rst | 120 ++++ .../catalog_reference_catalog_tables.rst | 455 +++++++++++++ reference/catalog_reference_examples.rst | 64 ++ reference/catalog_reference_overview.rst | 11 + .../catalog_reference_schema_information.rst | 62 ++ .../alter_default_permissions.rst | 76 ++- 7 files changed, 782 insertions(+), 616 deletions(-) create mode 100644 reference/catalog_reference_additonal_tables.rst create mode 100644 reference/catalog_reference_catalog_tables.rst create mode 100644 reference/catalog_reference_examples.rst create mode 100644 reference/catalog_reference_overview.rst create mode 100644 reference/catalog_reference_schema_information.rst diff --git a/reference/catalog_reference.rst b/reference/catalog_reference.rst index 8cfa8e832..8fc0593b8 100644 --- a/reference/catalog_reference.rst +++ b/reference/catalog_reference.rst @@ -1,606 +1,16 @@ .. _catalog_reference: ************************************* -Catalog reference +Catalog Reference Guide ************************************* +The **Catalog Reference Guide** describes the following: -SQream DB contains a schema called ``sqream_catalog`` that contains information about your database's objects - tables, columns, views, permissions, and more. +.. toctree:: + :maxdepth: 1 + :glob: -Some additional catalog tables are used primarily for internal introspection, which could change across SQream DB versions. - - -.. contents:: In this topic: - :local: - -Types of data exposed by ``sqream_catalog`` -============================================== - -.. list-table:: Database objects - :widths: auto - :header-rows: 1 - - * - Object - - Table - * - Clustering keys - - ``clustering_keys`` - * - Columns - - ``columns``, ``external_table_columns`` - * - Databases - - ``databases`` - * - Permissions - - ``table_permissions``, ``database_permissions``, ``schema_permissions``, ``permission_types``, ``udf_permissions`` - * - Roles - - ``roles``, ``roles_memeberships`` - * - Schemas - - ``schemas`` - * - Sequences - - ``identity_key`` - * - Tables - - ``tables``, ``external_tables`` - * - Views - - ``views`` - * - UDFs - - ``user_defined_functions`` - -The catalog contains a few more tables which contain storage details for internal use - -.. list-table:: Storage objects - :widths: auto - :header-rows: 1 - - * - Object - - Table - * - Extents - - ``extents`` - * - Chunks - - ``chunks`` - * - Delete predicates - - ``delete_predicates`` - -Tables in the catalog -======================== - -clustering_keys ------------------------ - -Explicit clustering keys for tables. - -When more than one clustering key is defined, each key is listed in a separate row. - - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Column - - Description - * - ``database_name`` - - Name of the database containing the table - * - ``table_id`` - - ID of the table containing the column - * - ``schema_name`` - - Name of the schema containing the table - * - ``table_name`` - - Name of the table containing the column - * - ``clustering_key`` - - Name of the column that is a clustering key for this table - -columns --------- - -Column objects for standard tables - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Column - - Description - * - ``database_name`` - - Name of the database containing the table - * - ``schema_name`` - - Name of the schema containing the table - * - ``table_id`` - - ID of the table containing the column - * - ``table_name`` - - Name of the table containing the column - * - ``column_id`` - - Ordinal of the column in the table (begins at 0) - * - ``column_name`` - - Name of the column - * - ``type_name`` - - :ref:`Data type ` of the column - * - ``column_size`` - - The maximum length in bytes. - * - ``has_default`` - - ``NULL`` if the column has no default value. ``1`` if the default is a fixed value, or ``2`` if the default is an :ref:`identity` - * - ``default_value`` - - :ref:`Default value` for the column - * - ``compression_strategy`` - - User-overridden compression strategy - * - ``created`` - - Timestamp when the column was created - * - ``altered`` - - Timestamp when the column was last altered - - -.. _external_tables_table: - -external_tables ----------------- - -``external_tables`` identifies external tables in the database. - -For ``TABLES`` see :ref:`tables ` - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Column - - Description - * - ``database_name`` - - Name of the database containing the table - * - ``table_id`` - - Database-unique ID for the table - * - ``schema_name`` - - Name of the schema containing the table - * - ``table_name`` - - Name of the table - * - ``format`` - - - Identifies the foreign data wrapper used. - - ``0`` for csv_fdw, ``1`` for parquet_fdw, ``2`` for orc_fdw. - - * - ``created`` - - Identifies the clause used to create the table - -external_table_columns ------------------------- - -Column objects for external tables - -databases ------------ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Column - - Description - * - ``database_Id`` - - Unique ID of the database - * - ``database_name`` - - Name of the database - * - ``default_disk_chunk_size`` - - Internal use - * - ``default_process_chunk_size`` - - Internal use - * - ``rechunk_size`` - - Internal use - * - ``storage_subchunk_size`` - - Internal use - * - ``compression_chunk_size_threshold`` - - Internal use - -database_permissions ----------------------- - -``database_permissions`` identifies all permissions granted to databases. - -There is one row for each combination of role (grantee) and permission granted to a database. - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Column - - Description - * - ``database_name`` - - Name of the database the permission applies to - * - ``role_id`` - - ID of the role granted permissions (grantee) - * - ``permission_type`` - - Identifies the permission type - - -identity_key --------------- - - -permission_types ------------------- - -``permission_types`` Identifies the permission names that exist in the database. - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Column - - Description - * - ``permission_type_id`` - - ID of the permission type - * - ``name`` - - Name of the permission type - -roles ------- - -``roles`` identifies the roles in the database. - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Column - - Description - * - ``role_id`` - - Database-unique ID of the role - * - ``name`` - - Name of the role - * - ``superuser`` - - Identifies if this role is a superuser. ``1`` for superuser or ``0`` otherwise. - * - ``login`` - - Identifies if this role can be used to log in to SQream DB. ``1`` for yes or ``0`` otherwise. - * - ``has_password`` - - Identifies if this role has a password. ``1`` for yes or ``0`` otherwise. - * - ``can_create_function`` - - Identifies if this role can create UDFs. ``1`` for yes, ``0`` otherwise. - -roles_memberships -------------------- - -``roles_memberships`` identifies the role memberships in the database. - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Column - - Description - * - ``role_id`` - - Role ID - * - ``member_role_id`` - - ID of the parent role from which this role will inherit - * - ``inherit`` - - Identifies if permissions are inherited. ``1`` for yes or ``0`` otherwise. - -savedqueries ----------------- - -``savedqueries`` identifies the :ref:`saved_queries` in the database. - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Column - - Description - * - ``name`` - - Saved query name - * - ``num_parameters`` - - Number of parameters to be replaced at run-time - -schemas ----------- - -``schemas`` identifies all the database's schemas. - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Column - - Description - * - ``schema_id`` - - Unique ID of the schema - * - ``schema_name`` - - Name of the schema - * - ``schema_owner`` - - Name of the role who owns this schema - * - ``rechunker_ignore`` - - Internal use - - -schema_permissions --------------------- - -``schema_permissions`` identifies all permissions granted to schemas. - -There is one row for each combination of role (grantee) and permission granted to a schema. - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Column - - Description - * - ``database_name`` - - Name of the database containing the schema - * - ``schema_id`` - - ID of the schema the permission applies to - * - ``role_id`` - - ID of the role granted permissions (grantee) - * - ``permission_type`` - - Identifies the permission type - - -.. _tables_table: - -tables ----------- - -``tables`` identifies proper SQream tables in the database. - -For ``EXTERNAL TABLES`` see :ref:`external_tables ` - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Column - - Description - * - ``database_name`` - - Name of the database containing the table - * - ``table_id`` - - Database-unique ID for the table - * - ``schema_name`` - - Name of the schema containing the table - * - ``table_name`` - - Name of the table - * - ``row_count_valid`` - - Identifies if the ``row_count`` can be used - * - ``row_count`` - - Number of rows in the table - * - ``rechunker_ignore`` - - Internal use - - -table_permissions ------------------- - -``table_permissions`` identifies all permissions granted to tables. - -There is one row for each combination of role (grantee) and permission granted to a table. - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Column - - Description - * - ``database_name`` - - Name of the database containing the table - * - ``table_id`` - - ID of the table the permission applies to - * - ``role_id`` - - ID of the role granted permissions (grantee) - * - ``permission_type`` - - Identifies the permission type - - -udf_permissions ------------------- - -user_defined_functions -------------------------- - -``user_defined_functions`` identifies UDFs in the database. - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Column - - Description - * - ``database_name`` - - Name of the database containing the view - * - ``function_id`` - - Database-unique ID for the UDF - * - ``function_name`` - - Name of the UDF - -views -------- - -``views`` identifies views in the database. - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Column - - Description - * - ``view_id`` - - Database-unique ID for the view - * - ``view_schema`` - - Name of the schema containing the view - * - ``view_name`` - - Name of the view - * - ``view_data`` - - Internal use - * - ``view_query_text`` - - Identifies the ``AS`` clause used to create the view - - -Additional tables -====================== - -There are additional tables in the catalog that can be used for performance monitoring and inspection. - -The definition for these tables is provided below could change across SQream DB versions. - -extents ----------- - -``extents`` identifies storage extents. - -Each storage extents can contain several chunks. - -.. note:: This is an internal table designed for low-level performance troubleshooting. - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Column - - Description - * - ``database_name`` - - Name of the databse containing the extent - * - ``table_id`` - - ID of the table containing the extent - * - ``column_id`` - - ID of the column containing the extent - * - ``extent_id`` - - ID for the extent - * - ``size`` - - Extent size in megabytes - * - ``path`` - - Full path to the extent on the file system - -chunk_columns -------------------- - -``chunk_columns`` lists chunk information by column. - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Column - - Description - * - ``database_name`` - - Name of the databse containing the extent - * - ``table_id`` - - ID of the table containing the extent - * - ``column_id`` - - ID of the column containing the extent - * - ``chunk_id`` - - ID for the chunk - * - ``extent_id`` - - ID for the extent - * - ``compressed_size`` - - Actual chunk size in bytes - * - ``uncompressed_size`` - - Uncompressed chunk size in bytes - * - ``compression_type`` - - Actual compression scheme for this chunk - * - ``long_min`` - - Minimum numeric value in this chunk (if exists) - * - ``long_max`` - - Maximum numeric value in this chunk (if exists) - * - ``string_min`` - - Minimum text value in this chunk (if exists) - * - ``string_max`` - - Maximum text value in this chunk (if exists) - * - ``offset_in_file`` - - Internal use - -.. note:: This is an internal table designed for low-level performance troubleshooting. - -chunks -------- - -``chunks`` identifies storage chunks. - -.. note:: This is an internal table designed for low-level performance troubleshooting. - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Column - - Description - * - ``database_name`` - - Name of the databse containing the chunk - * - ``table_id`` - - ID of the table containing the chunk - * - ``column_id`` - - ID of the column containing the chunk - * - ``rows_num`` - - Amount of rows contained in the chunk - * - ``deletion_status`` - - When data is deleted from the table, it is first deleted logically. This value identifies how much data is deleted from the chunk. ``0`` for no data, ``1`` for some data, ``2`` to specify the entire chunk is deleted. - -delete_predicates -------------------- - -``delete_predicates`` identifies the existing delete predicates that have not been cleaned up. - -Each :ref:`DELETE ` command may result in several entries in this table. - -.. note:: This is an internal table designed for low-level performance troubleshooting. - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Column - - Description - * - ``database_name`` - - Name of the databse containing the predicate - * - ``table_id`` - - ID of the table containing the predicate - * - ``max_chunk_id`` - - Internal use. Placeholder marker for the highest ``chunk_id`` logged during the DELETE operation. - * - ``delete_predicate`` - - Identifies the DELETE predicate - - -Examples -=========== - -List all tables in the database ----------------------------------- - -.. code-block:: psql - - master=> SELECT * FROM sqream_catalog.tables; - database_name | table_id | schema_name | table_name | row_count_valid | row_count | rechunker_ignore - --------------+----------+-------------+----------------+-----------------+-----------+----------------- - master | 1 | public | nba | true | 457 | 0 - master | 12 | public | cool_dates | true | 5 | 0 - master | 13 | public | cool_numbers | true | 9 | 0 - master | 27 | public | jabberwocky | true | 8 | 0 - -List all schemas in the database ------------------------------------- - -.. code-block:: psql - - master=> SELECT * FROM sqream_catalog.schemas; - schema_id | schema_name | schema_owner | rechunker_ignore - ----------+---------------+--------------+----------------- - 0 | public | sqream | false - 1 | secret_schema | mjordan | false - - -List columns and their types for a specific table ---------------------------------------------------- - -.. code-block:: postgres - - SELECT column_name, type_name - FROM sqream_catalog.columns - WHERE table_name='cool_animals'; - -List delete predicates ------------------------- - -.. code-block:: postgres - - SELECT t.table_name, d.* FROM - sqream_catalog.delete_predicates AS d - INNER JOIN sqream_catalog.tables AS t - ON d.table_id=t.table_id; - - -List :ref:`saved_queries` ------------------------------ - -.. code-block:: postgres - - SELECT * FROM sqream_catalog.savedqueries; + catalog_reference_overview + catalog_reference_schema_information + catalog_reference_catalog_tables + catalog_reference_additonal_tables + catalog_reference_examples \ No newline at end of file diff --git a/reference/catalog_reference_additonal_tables.rst b/reference/catalog_reference_additonal_tables.rst new file mode 100644 index 000000000..7d34429d3 --- /dev/null +++ b/reference/catalog_reference_additonal_tables.rst @@ -0,0 +1,120 @@ +.. _catalog_reference_additonal_tables: + +************************************* +Additional Tables +************************************* +The Reference Catalog includes additional tables that can be used for performance monitoring and inspection. The definition for these tables described on this page may change across SQream versions. + +.. contents:: + :local: + :depth: 1 + +Extents +---------- +The ``extents`` storage object identifies storage extents, and each storage extents can contain several chunks. + +.. note:: This is an internal table designed for low-level performance troubleshooting. + +.. list-table:: + :widths: 20 180 + :header-rows: 1 + + * - Column + - Description + * - ``database_name`` + - Shows the name of the databse containing the extent. + * - ``table_id`` + - Shows the ID of the table containing the extent. + * - ``column_id`` + - Shows the ID of the column containing the extent. + * - ``extent_id`` + - Shows the ID for the extent. + * - ``size`` + - Shows the extent size in megabytes. + * - ``path`` + - Shows the full path to the extent on the file system. + +Chunk Columns +------------------- +The ``chunk_columns`` storage object lists chunk information by column. + +.. list-table:: + :widths: 20 180 + :header-rows: 1 + + * - Column + - Description + * - ``database_name`` + - Shows the name of the databse containing the extent. + * - ``table_id`` + - Shows the ID of the table containing the extent. + * - ``column_id`` + - Shows the ID of the column containing the extent. + * - ``chunk_id`` + - Shows the chunk ID. + * - ``extent_id`` + - Shows the extent ID. + * - ``compressed_size`` + - Shows the compressed chunk size in bytes. + * - ``uncompressed_size`` + - Shows the uncompressed chunk size in bytes. + * - ``compression_type`` + - Shows the chunk's actual compression scheme. + * - ``long_min`` + - Shows the minimum numeric value in the chunk (if one exists). + * - ``long_max`` + - Shows the maximum numeric value in the chunk (if one exists). + * - ``string_min`` + - Shows the minimum text value in the chunk (if one exists). + * - ``string_max`` + - Shows the maximum text value in the chunk (if one exists). + * - ``offset_in_file`` + - Reserved for internal use. + +.. note:: This is an internal table designed for low-level performance troubleshooting. + +Chunks +------- +The ``chunks`` storage object identifies storage chunks. + +.. list-table:: + :widths: 20 180 + :header-rows: 1 + + * - Column + - Description + * - ``database_name`` + - Shows the name of the databse containing the chunk. + * - ``table_id`` + - Shows the ID of the table containing the chunk. + * - ``column_id`` + - Shows the ID of the column containing the chunk. + * - ``rows_num`` + - Shows the amount of rows in the chunk. + * - ``deletion_status`` + - Determines what data to logically delete from the table first, and identifies how much data to delete from the chunk. The value ``0`` is ued for no data, ``1`` for some data, and ``2`` to delete the entire chunk. + +.. note:: This is an internal table designed for low-level performance troubleshooting. + +Delete Predicates +------------------- +The ``delete_predicates`` storage object identifies the existing delete predicates that have not been cleaned up. + +Each :ref:`DELETE ` command may result in several entries in this table. + +.. list-table:: + :widths: 20 180 + :header-rows: 1 + + * - Column + - Description + * - ``database_name`` + - Shows the name of the databse containing the predicate. + * - ``table_id`` + - Shows the ID of the table containing the predicate. + * - ``max_chunk_id`` + - Reserved for internal use, this is a placeholder marker for the highest ``chunk_id`` logged during the ``DELETE`` operation. + * - ``delete_predicate`` + - Identifies the DELETE predicate. + +.. note:: This is an internal table designed for low-level performance troubleshooting. \ No newline at end of file diff --git a/reference/catalog_reference_catalog_tables.rst b/reference/catalog_reference_catalog_tables.rst new file mode 100644 index 000000000..20c1bf342 --- /dev/null +++ b/reference/catalog_reference_catalog_tables.rst @@ -0,0 +1,455 @@ +.. _catalog_reference_catalog_tables: + +************************************* +Catalog Tables +************************************* +The ``sqream_catalog`` includes the following tables: + +.. contents:: + :local: + :depth: 1 + +.. _clustering_keys: + +Clustering Keys +---------------- +The ``clustering_keys`` data object is used for explicit clustering keys for tables. If you define more than one clustering key, each key is listed in a separate row, and is described in the following table: + +.. list-table:: + :widths: 20 180 + :header-rows: 1 + + * - Column + - Description + * - ``database_name`` + - Shows the name of the database containing the table. + * - ``table_id`` + - Shows the ID of the table containing the column. + * - ``schema_name`` + - Shows the name of the schema containing the table. + * - ``table_name`` + - Shows the name of the table containing the column. + * - ``clustering_key`` + - Shows the name of the column used as a clustering key for this table. + +.. _columns: + +Columns +---------------- +The **Columns** database object shows the following tables: + +.. contents:: + :local: + :depth: 1 + +Columns +*********** +The ``column`` data object is used with standard tables and is described in the following table: + +.. list-table:: + :widths: 20 150 + :header-rows: 1 + + * - Column + - Description + * - ``database_name`` + - Shows the name of the database containing the table. + * - ``schema_name`` + - Shows the name of the schema containing the table. + * - ``table_id`` + - Shows the ID of the table containing the column. + * - ``table_name`` + - Shows the name of the table containing the column. + * - ``column_id`` + - Shows the ordinal number of the column in the table (begins at **0**). + * - ``column_name`` + - Shows the column's name. + * - ``type_name`` + - Shows the column's data type. For more information see :ref:`Supported Data Types `. + * - ``column_size`` + - Shows the maximum length in bytes. + * - ``has_default`` + - Shows ``NULL`` if the column has no default value, ``1`` if the default is a fixed value, or ``2`` if the default is an identity. For more information, see :ref:`identity`. + * - ``default_value`` + - Shows the column's default value. For more information, see :ref:`Default Value Constraints`. + * - ``compression_strategy`` + - Shows the compression strategy that a user has overridden. + * - ``created`` + - Shows the timestamp displaying when the column was created. + * - ``altered`` + - Shows the timestamp displaying when the column was last altered. + +External Table Columns +*********** +The ``external_table_columns`` is used for viewing data from foreign tables. + +For more information on foreign tables, see :ref:`CREATE FOREIGN TABLE`. + +.. _databases: + +Databases +---------------- +The ``databases`` data object is used for displaying database information, and is described in the following table: + +.. list-table:: + :widths: 20 180 + :header-rows: 1 + + * - Column + - Description + * - ``database_Id`` + - Shows the database's unique ID. + * - ``database_name`` + - Shows the database's name. + * - ``default_disk_chunk_size`` + - Reserved for internal use. + * - ``default_process_chunk_size`` + - Reserved for internal use. + * - ``rechunk_size`` + - Reserved for internal use. + * - ``storage_subchunk_size`` + - Reserved for internal use. + * - ``compression_chunk_size_threshold`` + - Reserved for internal use. + +.. _permissions: + +Permissions +---------------- +The ``permissions`` data object is used for displaying permissions information, such as roles (also known as **grantees**), and is described in the following tables: + +.. contents:: + :local: + :depth: 1 + +Permission Types +*********** +The ``permission_types`` object identifies the permission names existing in the database. + +The following table describes the ``permission_types`` data object: + +.. list-table:: + :widths: 20 180 + :header-rows: 1 + + * - Column + - Description + * - ``permission_type_id`` + - Shows the permission type's ID. + * - ``name`` + - Shows the name of the permission type. + +Default Permissions +*********** +The commands included in the **Default Permissions** section describe how to check the following default permissions: + +.. contents:: + :local: + :depth: 1 + +Default Table Permissions +~~~~~~~~~~~~~~~~ +The ``sqream_catalog.table_default_permissions`` command shows the columns described below: + +.. list-table:: + :widths: 20 180 + :header-rows: 1 + + * - Column + - Description + * - ``database_name`` + - Shows the database that the default permission rule applies to. + * - ``schema_id`` + - Shows the schema that the rule applies to, or ``NULL`` if the ``ALTER`` statement does not specify a schema. + * - ``modifier_role_id`` + - Shows the role to apply the rule to. + * - ``getter_role_id`` + - Shows the role that the permission is granted to. + * - ``permission_type`` + - Shows the type of permission granted. + +Default Schema Permissions +~~~~~~~~~~~~~~~~ +The ``sqream_catalog.schema_default_permissions`` command shows the columns described below: + +.. list-table:: + :widths: 20 180 + :header-rows: 1 + + * - Column + - Description + * - ``database_name`` + - Shows the database that the default permission rule applies to. + * - ``modifier_role_id`` + - Shows the role to apply the rule to. + * - ``getter_role_id`` + - Shows the role that the permission is granted to. + * - ``permission_type`` + - Shows the type of permission granted. + +For an example of using the ``sqream_catalog.table_default_permissions`` command, see `Granting Default Table Permissions `_. + +Table Permissions +*********** +The ``table_permissions`` data object identifies all permissions granted to tables. Each role-permission combination displays one row. + +The following table describes the ``table_permissions`` data object: + +.. list-table:: + :widths: 20 180 + :header-rows: 1 + + * - Column + - Description + * - ``database_name`` + - Shows the name of the database containing the table. + * - ``table_id`` + - Shows the ID of the table the permission applies to. + * - ``role_id`` + - Shows the ID of the role granted permissions. + * - ``permission_type`` + - Identifies the permission type. + +Database Permissions +*********** +The ``database_permissions`` data object identifies all permissions granted to databases. Each role-permission combination displays one row. + +The following table describes the ``database_permissions`` data object: + +.. list-table:: + :widths: 20 180 + :header-rows: 1 + + * - Column + - Description + * - ``database_name`` + - Shows the name of the database the permission applies to + * - ``role_id`` + - Shows the ID of the role granted permissions. + * - ``permission_type`` + - Identifies the permission type. + +Schema Permissions +*********** +The ``schema_permissions`` data object identifies all permissions granted to schemas. Each role-permission combination displays one row. + +The following table describes the ``schema_permissions`` data object: + +.. list-table:: + :widths: 20 180 + :header-rows: 1 + + * - Column + - Description + * - ``database_name`` + - Shows the name of the database containing the schema. + * - ``schema_id`` + - Shows the ID of the schema the permission applies to. + * - ``role_id`` + - Shows the ID of the role granted permissions. + * - ``permission_type`` + - Identifies the permission type. + +UDF Permissions +*********** +**Comment** - *No content.* + +.. _queries: + +Queries +---------------- +The ``savedqueries`` data object identifies the saved_queries in the database, as shown in the following table: + +.. list-table:: + :widths: 20 180 + :header-rows: 1 + + * - Column + - Description + * - ``name`` + - Shows the saved query name. + * - ``num_parameters`` + - Shows the number of parameters to be replaced at run-time. + +For more information, see :ref:`saved_queries`. + +.. _roles: + +Roles +---------------- +The ``roles`` data object is used for displaying role information, and is described in the following tables: + +.. contents:: + :local: + :depth: 1 + +Roles +*********** +The ``roles`` data object identifies the roles in the database, as shown in the following table: + +.. list-table:: + :widths: 20 180 + :header-rows: 1 + + * - Column + - Description + * - ``role_id`` + - Shows the role's database-unique ID. + * - ``name`` + - Shows the role's name. + * - ``superuser`` + - Identifies whether the role is a superuser (``1`` - superuser, ``0`` - regular user). + * - ``login`` + - Identifies whether the role can be used to log in to SQream (``1`` - yes, ``0`` - no). + * - ``has_password`` + - Identifies whether the role has a password (``1`` - yes, ``0`` - no). + * - ``can_create_function`` + - Identifies whether role can create UDFs (``1`` - yes, ``0`` - no). + +Role Memberships +*********** +The ``roles_memberships`` data object identifies the role memberships in the database, as shown below: + +.. list-table:: + :widths: 20 180 + :header-rows: 1 + + * - Column + - Description + * - ``role_id`` + - Shows the role ID. + * - ``member_role_id`` + - Shows the ID of the parent role that this role inherits from. + * - ``inherit`` + - Identifies whether permissions are inherited (``1`` - yes, ``0`` - no). + +.. _schemas: + +Schemas +---------------- +The ``schemas`` data object identifies all the database's schemas, as shown below: + +.. list-table:: + :widths: 20 180 + :header-rows: 1 + + * - Column + - Description + * - ``schema_id`` + - Shows the schema's unique ID. + * - ``schema_name`` + - Shows the schema's name. + * - ``schema_owner`` + - Shows the name of the role that owns the schema. + * - ``rechunker_ignore`` + - Reserved for internal use. + +.. _sequences: + +Sequences +---------------- +The ``sequences`` data object is used for displaying identity key information, as shown below: + +Identity Key +*********** +**Comment** - *No content.* + +.. _tables: + +Tables +---------------- +The ``tables`` data object is used for displaying table information, and is described in the following tables: + +.. contents:: + :local: + :depth: 1 + +Tables +*********** +The ``tables`` data object identifies proper (**Comment** - *What does "proper" mean?*) SQream tables in the database, as shown in the following table: + +.. list-table:: + :widths: 20 180 + :header-rows: 1 + + * - Column + - Description + * - ``database_name`` + - Shows the name of the database containing the table. + * - ``table_id`` + - Shows the table's database-unique ID. + * - ``schema_name`` + - Shows the name of the schema containing the table. + * - ``table_name`` + - Shows the name of the table. + * - ``row_count_valid`` + - Identifies whether the ``row_count`` can be used. + * - ``row_count`` + - Shows the number of rows in the table. + * - ``rechunker_ignore`` + - Relevant for internal use. + +Foreign Tables +*********** +The ``external_tables`` data object identifies foreign tables in the database, as shown below: + +.. list-table:: + :widths: 20 200 + :header-rows: 1 + + * - Column + - Description + * - ``database_name`` + - Shows the name of the database containing the table. + * - ``table_id`` + - Shows the table's database-unique ID. + * - ``schema_name`` + - Shows the name of the schema containing the table. + * - ``table_name`` + - Shows the name of the table. + * - ``format`` + - Identifies the foreign data wrapper used. ``0`` for ``csv_fdw``, ``1`` for ``parquet_fdw``, ``2`` for ``orc_fdw``. + * - ``created`` + - Identifies the clause used to create the table. + +.. _views: + +Views +---------------- +The ``views`` data object is used for displaying views in the database, as shown below: + +.. list-table:: + :widths: 20 180 + :header-rows: 1 + + * - Column + - Description + * - ``view_id`` + - Shows the view's database-unique ID. + * - ``view_schema`` + - Shows the name of the schema containing the view. + * - ``view_name`` + - Shows the name of the view. + * - ``view_data`` + - Reserved for internal use. + * - ``view_query_text`` + - Identifies the ``AS`` clause used to create the view. + +.. _udfs: + +User Defined Functions +---------------- +The ``udf`` data object is used for displaying UDFs in the database, as shown below: + +.. list-table:: + :widths: 20 180 + :header-rows: 1 + + * - Column + - Description + * - ``database_name`` + - Shows the name of the database containing the view. + * - ``function_id`` + - Shows the UDF's database-unique ID. + * - ``function_name`` + - Shows the name of the UDF. \ No newline at end of file diff --git a/reference/catalog_reference_examples.rst b/reference/catalog_reference_examples.rst new file mode 100644 index 000000000..4531dfefc --- /dev/null +++ b/reference/catalog_reference_examples.rst @@ -0,0 +1,64 @@ +.. _catalog_reference_examples: + +************************************* +Examples +************************************* +The **Examples** page includes the following examples: + +.. contents:: + :local: + :depth: 1 + +Listing All Tables in a Database +---------------------------------- + +.. code-block:: psql + + master=> SELECT * FROM sqream_catalog.tables; + database_name | table_id | schema_name | table_name | row_count_valid | row_count | rechunker_ignore + --------------+----------+-------------+----------------+-----------------+-----------+----------------- + master | 1 | public | nba | true | 457 | 0 + master | 12 | public | cool_dates | true | 5 | 0 + master | 13 | public | cool_numbers | true | 9 | 0 + master | 27 | public | jabberwocky | true | 8 | 0 + +Listing All Schemas in a Database +------------------------------------ + +.. code-block:: psql + + master=> SELECT * FROM sqream_catalog.schemas; + schema_id | schema_name | schema_owner | rechunker_ignore + ----------+---------------+--------------+----------------- + 0 | public | sqream | false + 1 | secret_schema | mjordan | false + + +Listing Columns and Their Types for a Specific Table +--------------------------------------------------- + +.. code-block:: postgres + + SELECT column_name, type_name + FROM sqream_catalog.columns + WHERE table_name='cool_animals'; + +Listing Delete Predicates +------------------------ + +.. code-block:: postgres + + SELECT t.table_name, d.* FROM + sqream_catalog.delete_predicates AS d + INNER JOIN sqream_catalog.tables AS t + ON d.table_id=t.table_id; + + +Listing Saved Queries +----------------------------- + +.. code-block:: postgres + + SELECT * FROM sqream_catalog.savedqueries; + +For more information, see :ref:`saved_queries`. \ No newline at end of file diff --git a/reference/catalog_reference_overview.rst b/reference/catalog_reference_overview.rst new file mode 100644 index 000000000..b74663509 --- /dev/null +++ b/reference/catalog_reference_overview.rst @@ -0,0 +1,11 @@ +.. _catalog_reference_overview: + +************************************* +Overview +************************************* +The SQream database uses a schema called ``sqream_catalog`` that contains information about your database's objects, such tables, columns, views, and permissions. Some additional catalog tables are used primarily for internal analysis and which may be different across SQream versions. + +* :ref:`catalog_reference_schema_information` +* :ref:`catalog_reference_catalog_tables` +* :ref:`catalog_reference_additonal_tables` +* :ref:`catalog_reference_examples` \ No newline at end of file diff --git a/reference/catalog_reference_schema_information.rst b/reference/catalog_reference_schema_information.rst new file mode 100644 index 000000000..6cd43ab6a --- /dev/null +++ b/reference/catalog_reference_schema_information.rst @@ -0,0 +1,62 @@ +.. _catalog_reference_schema_information: + +************************************* +What Information Does the Schema Contain? +************************************* +The schema includes tables designated and relevant for both external and internal use: + +.. contents:: + :local: + :depth: 1 + +External Tables +----------------- +The following table shows the data objects contained in the ``sqream_catalog`` schema designated for external use: + +.. list-table:: Database Objects + :widths: 20 180 + :header-rows: 1 + + * - Database Object + - Table + * - :ref:`Clustering Keys` + - ``clustering_keys`` + * - :ref:`Columns` + - ``columns``, ``external_table_columns`` + * - :ref:`Databases` + - ``databases`` + * - :ref:`Permissions` + - ``table_permissions``, ``database_permissions``, ``schema_permissions``, ``permission_types``, ``udf_permissions``, ``sqream_catalog.table_default_permissions`` + * - :ref:`Queries` + - ``saved_queries`` + * - :ref:`Roles` + - ``roles``, ``roles_memeberships`` + * - :ref:`Schemas` + - ``schemas`` + * - :ref:`Sequences` + - ``identity_key`` + * - :ref:`Tables` + - ``tables``, ``external_tables`` + * - :ref:`Views` + - ``views`` + * - :ref:`User Defined Functions` + - ``user_defined_functions`` + +Internal Tables +----------------- +The following table shows the data objects contained in the ``sqream_catalog`` schema designated for internal use: + +.. list-table:: Storage Objects + :widths: 20 180 + :header-rows: 1 + + * - Database Object + - Table + * - Extents + - Shows ``extents``. + * - Chunk columns + - Shows ``chunks_columns``. + * - Chunks + - Shows ``chunks``. + * - Delete predicates + - Shows ``delete_predicates``. For more information, see :ref:`Deleting Data`. \ No newline at end of file diff --git a/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst b/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst index 220e05eb3..0ab200286 100644 --- a/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst +++ b/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst @@ -3,22 +3,27 @@ ***************************** ALTER DEFAULT PERMISSIONS ***************************** +The **ALTER DEFAULT PERMISSIONS** page describes the following: -``ALTER DEFAULT PERMISSIONS`` allows granting automatic permissions to future objects. +.. contents:: + :local: + :depth: 1 -By default, if one user creates a table, another user will not have ``SELECT`` permissions on it. -By modifying the target role's default permissions, a database administrator can ensure that -all objects created by that role will be accessible to others. +Overview +============= +The ``ALTER DEFAULT PERMISSIONS`` command lets you grant automatic permissions to future objects. + +By default, users do not have ``SELECT`` permissions on tables created by other users. Database administrators can grant access to other users by modifying the target role default permissions. -Learn more about the permission system in the :ref:`access control guide`. +For more information about access control, see :ref:`Access Control`. Permissions ============= - -To alter default permissions, the current role must have the ``SUPERUSER`` permission. +The ``SUPERUSER`` permission is required to alter default permissions. Syntax ========== +The following is the syntax for altering default permissions: .. code-block:: postgres @@ -55,32 +60,71 @@ Syntax :start-line: 127 :end-line: 180 - Examples ============ +This section includes the following examples: -Automatic permissions for newly created schemas +.. contents:: + :local: + :depth: 1 + +Granting Default Table Permissions ------------------------------------------------- +This example is based on the roles **r1** and **r2**, created as follows: -When role ``demo`` creates a new schema, roles u1,u2 will get USAGE and CREATE permissions in the new schema: +.. code-block:: postgres + + create role r1; + create role r2; + alter default permissions for r1 for tables grant select to r2; + +Once created, you can build and run the following query based on the above: .. code-block:: postgres - ALTER DEFAULT PERMISSIONS FOR demo FOR SCHEMAS GRANT USAGE, CREATE TO u1,u2; + select + tdp.database_name as "database_name", + ss.schema_name as "schema_name", + rs1.name as "table_creator", + rs2.name as "grant_to", + pts.name as "permission_type" + from sqream_catalog.table_default_permissions tdp + inner join sqream_catalog.roles rs1 on tdp.modifier_role_id = rs1.role_id + inner join sqream_catalog.roles rs2 on tdp.getter_role_id = rs2.role_id + left join sqream_catalog.schemas ss on tdp.schema_id = ss.schema_id + inner join sqream_catalog.permission_types pts on pts.permission_type_id=tdp.permission_type + ; + +The following is an example of the output generated from the above queries: ++-----------------------+----------------------+-------------------+--------------+------------------------------+ +| **database_name** | **schema_name** | **table_creator** | **grant_to** | **permission_type** | ++-----------------------+----------------------+-------------------+--------------+------------------------------+ +| master | NULL | public | public | select | ++-----------------------+----------------------+-------------------+--------------+------------------------------+ -Automatic permissions for newly created tables in a schema ----------------------------------------------------------------- +For more information about default permissions, see `Default Permissions `_. + +Granting Automatic Permissions for Newly Created Schemas +------------------------------------------------- +When the role ``demo`` creates a new schema, roles **u1,u2** are granted ``USAGE`` and ``CREATE`` permissions in the new schema, as shown below: -When role ``demo`` creates a new table in schema ``s1``, roles u1,u2 wil be granted with SELECT on it: +.. code-block:: postgres + + ALTER DEFAULT PERMISSIONS FOR demo FOR SCHEMAS GRANT USAGE, CREATE TO u1,u2; + +Granting Automatic Permissions for Newly Created Tables in a Schema +---------------------------------------------------------------- +When the role ``demo`` creates a new table in schema ``s1``, roles **u1,u2** are granted ``SELECT`` permissions, as shown below: .. code-block:: postgres ALTER DEFAULT PERMISSIONS FOR demo IN s1 FOR TABLES GRANT SELECT TO u1,u2; -Revoke (``DROP GRANT``) permissions for newly created tables +Revoking Permissions from Newly Created Tables --------------------------------------------------------------- +Revoking permissions refers to using the ``DROP GRANT`` command, as shown below: .. code-block:: postgres - ALTER DEFAULT PERMISSIONS FOR public FOR TABLES DROP GRANT SELECT,DDL,INSERT,DELETE TO public; + ALTER DEFAULT PERMISSIONS FOR public FOR TABLES DROP GRANT SELECT,DDL,INSERT,DELETE TO public; \ No newline at end of file From 3b13862d2959c862e65601fc522d089985a1e76d Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 19 Jul 2022 17:35:32 +0300 Subject: [PATCH 123/882] Fixed link syntax --- reference/catalog_reference_catalog_tables.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/catalog_reference_catalog_tables.rst b/reference/catalog_reference_catalog_tables.rst index 20c1bf342..7ddb9c148 100644 --- a/reference/catalog_reference_catalog_tables.rst +++ b/reference/catalog_reference_catalog_tables.rst @@ -187,7 +187,7 @@ The ``sqream_catalog.schema_default_permissions`` command shows the columns desc * - ``permission_type`` - Shows the type of permission granted. -For an example of using the ``sqream_catalog.table_default_permissions`` command, see `Granting Default Table Permissions `_. +For an example of using the ``sqream_catalog.table_default_permissions`` command, see `Granting Default Table Permissions `_. Table Permissions *********** From c331ad331ec09b684e17b5ed0f285f0b8a1e9619 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 19 Jul 2022 17:41:44 +0300 Subject: [PATCH 124/882] Update grant.rst Capitalization --- reference/sql/sql_statements/access_control_commands/grant.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/access_control_commands/grant.rst b/reference/sql/sql_statements/access_control_commands/grant.rst index dfb48c212..ceac48f7a 100644 --- a/reference/sql/sql_statements/access_control_commands/grant.rst +++ b/reference/sql/sql_statements/access_control_commands/grant.rst @@ -126,7 +126,7 @@ Parameters .. include from here -Supported permissions +Supported Permissions ======================= .. list-table:: From 280f26dd224d9ae32ed62d02da641458be00a404 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 19 Jul 2022 18:18:00 +0300 Subject: [PATCH 125/882] Update get_metadata_chunk_key.rst --- .../get_metadata_chunk_key.rst | 36 +++++++++---------- 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst b/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst index 08eba8345..784a54246 100644 --- a/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst +++ b/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst @@ -107,34 +107,34 @@ The following table describes the output generated from the ``GET_METADATA_CHUNK - ``2`` * - ``min_long`` - - **Comment** - What is it? - - **Comment** - What is it? - - ``flat`` + - Shows the minimum value of the type. + - Long + - ``25`` * - ``max_long`` - - **Comment** - What is it? - - **Comment** - What is it? - - **Comment** - What is it? + - Shows the maximum value in the chunk of a number. + - Long + - ``12345`` * - ``min_string_max_string`` - - **Comment** - What is it? - - **Comment** - What is it? - - **Comment** - What is it? + - Shows the minimum value of the string type. + - String + - ``"abc"`` * - ``min_numeric`` - - **Comment** - What is it? - - **Comment** - What is it? - - **Comment** - What is it? + - Shows the minimum value of the numeric type in the chunk. + - Numeric + - ``12.22`` * - ``max_numeric`` - - **Comment** - What is it? - - **Comment** - What is it? - - **Comment** - What is it? + - Shows the maximum value of the numeric type in the chunk. + - Numeric + - ``555.22`` * - ``column_aligned`` - - **Comment** - What is it? - - **Comment** - What is it? - - **Comment** - What is it? + - Relevant to text columns, aligment in memory. + - Boolean + - ``Yes`` / ``No`` The following is an example of the output generated from the ``GET_METADATA_CHUNK_KEY`` command: From f348959e3c5789d19ff89a01986e8c8e3d2696e5 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 19 Jul 2022 18:26:00 +0300 Subject: [PATCH 126/882] Updated --- index.rst | 6 +----- releases/2022.1.rst | 2 +- 2 files changed, 2 insertions(+), 6 deletions(-) diff --git a/index.rst b/index.rst index db8e0fa2a..5c4582c19 100644 --- a/index.rst +++ b/index.rst @@ -4,8 +4,6 @@ SQream DB Documentation ************************* -The **v2022.1** branch is a private branch designed for internal use only until the release date. - .. only:: html .. tip:: @@ -51,7 +49,6 @@ SQream DB easily plugs in to third-party tools like :ref:`Tableau` - :ref:`connect_to_tableau` * - **Releases** - **Driver and Deployment** @@ -59,7 +56,7 @@ SQream DB easily plugs in to third-party tools like :ref:`Tableau` - :ref:`2021.2<2021.2>` + :ref:`2021.2<2021.2>` :ref:`2021.1<2021.1>` @@ -74,7 +71,6 @@ SQream DB easily plugs in to third-party tools like :ref:`Tableau` - :ref:`connect_to_tableau` - :ref:`troubleshooting` guide diff --git a/releases/2022.1.rst b/releases/2022.1.rst index b6ffdf9ef..8d881c92c 100644 --- a/releases/2022.1.rst +++ b/releases/2022.1.rst @@ -67,7 +67,7 @@ The following table lists the known issues for Version 2022.1: +-------------+-------------------------------------------------------------------------------------------+ | SQ-9889 | Running a query including Thai characters generated an internal runtime error. | +-------------+-------------------------------------------------------------------------------------------+ -| SQ-10071 | error on exists subqueries with text and varchar equality condition | +| SQ-10071 | Error on existing subqueries with TEXT and VARCHAR equality condition | +-------------+-------------------------------------------------------------------------------------------+ | SQ-10191 | The ``ALTER DEFAULT SCHEMA`` command was not functioning correctly. | +-------------+-------------------------------------------------------------------------------------------+ From 50e67c53984237eed802fe6b8ea9a884443c01f9 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 19 Jul 2022 18:45:40 +0300 Subject: [PATCH 127/882] Fixed table alignment. --- index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.rst b/index.rst index 5c4582c19..bc5c25c2c 100644 --- a/index.rst +++ b/index.rst @@ -56,7 +56,7 @@ SQream DB easily plugs in to third-party tools like :ref:`Tableau` - :ref:`2021.2<2021.2>` + :ref:`2021.2<2021.2>` :ref:`2021.1<2021.1>` From dd2de29193efb911a2bd87643930b8fe7250fdce Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 19 Jul 2022 23:39:00 +0300 Subject: [PATCH 128/882] Fixed link and table alignment --- data_ingestion/avro.rst | 2 +- .../installing_prometheus_using_binary_packages.rst | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/data_ingestion/avro.rst b/data_ingestion/avro.rst index e943fe41c..753786376 100644 --- a/data_ingestion/avro.rst +++ b/data_ingestion/avro.rst @@ -161,7 +161,7 @@ The following table shows the supported **Complex** data types: +------------+-------------------------------------------------------+ | | SQream Type | -| +---------------+---------------+-----------+-----------+ +| +------------+----------------+-------------+-----------+ |Avro Type | Number | Date/Datetime | String | Boolean | +============+============+================+=============+===========+ | ``record`` | | | | | diff --git a/installation_guides/installing_prometheus_using_binary_packages.rst b/installation_guides/installing_prometheus_using_binary_packages.rst index a6104bdd0..5031ec181 100644 --- a/installation_guides/installing_prometheus_using_binary_packages.rst +++ b/installation_guides/installing_prometheus_using_binary_packages.rst @@ -102,7 +102,7 @@ You must install Prometheus before installing the Dashboard Data Collector. $ sudo chown -R prometheus:prometheus /etc/prometheus/consoles $ sudo chown -R prometheus:prometheus /etc/prometheus/console_libraries -For more information on installing the Dashboard Data Collector, see `Installing the Dashboard Data Collector `_. +For more information on installing the Dashboard Data Collector, see `Installing the Dashboard Data Collector `_. Back to :ref:`Installing Prometheus Using Binary Packages` @@ -238,4 +238,4 @@ From the **Query** tab you can query metrics, as shown below: * - .. image:: /_static/images/3c9c4e8b-49bd-44a8-9829-81d1772ed962.gif -Back to :ref:`Installing Prometheus Using Binary Packages` +Back to :ref:`Installing Prometheus Using Binary Packages` \ No newline at end of file From 77092d8367f34e4a87c37b131dd174774d4347ef Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Wed, 20 Jul 2022 14:46:07 +0300 Subject: [PATCH 129/882] Reinstituted Client Platforms (removed by accident) --- .../client_platforms/connect.sas | 27 ++ .../client_platforms/connect2.sas | 27 ++ .../client_platforms/connect3.sas | 17 + .../client_platforms/index.rst | 39 ++ .../client_platforms/informatica.rst | 173 +++++++ .../client_platforms/microstrategy.rst | 185 +++++++ .../client_platforms/odbc-sqream.tdc | 25 + .../client_platforms/pentaho.rst | 253 ++++++++++ connecting_to_sqream/client_platforms/php.rst | 76 +++ .../client_platforms/power_bi.rst | 143 ++++++ connecting_to_sqream/client_platforms/r.rst | 151 ++++++ .../client_platforms/sas_viya.rst | 185 +++++++ .../client_platforms/sql_workbench.rst | 135 ++++++ .../client_platforms/tableau.rst | 453 ++++++++++++++++++ .../client_platforms/talend.rst | 204 ++++++++ .../client_platforms/test.php | 16 + .../client_platforms/tibco_spotfire.rst | 387 +++++++++++++++ connecting_to_sqream/index.rst | 3 +- 18 files changed, 2498 insertions(+), 1 deletion(-) create mode 100644 connecting_to_sqream/client_platforms/connect.sas create mode 100644 connecting_to_sqream/client_platforms/connect2.sas create mode 100644 connecting_to_sqream/client_platforms/connect3.sas create mode 100644 connecting_to_sqream/client_platforms/index.rst create mode 100644 connecting_to_sqream/client_platforms/informatica.rst create mode 100644 connecting_to_sqream/client_platforms/microstrategy.rst create mode 100644 connecting_to_sqream/client_platforms/odbc-sqream.tdc create mode 100644 connecting_to_sqream/client_platforms/pentaho.rst create mode 100644 connecting_to_sqream/client_platforms/php.rst create mode 100644 connecting_to_sqream/client_platforms/power_bi.rst create mode 100644 connecting_to_sqream/client_platforms/r.rst create mode 100644 connecting_to_sqream/client_platforms/sas_viya.rst create mode 100644 connecting_to_sqream/client_platforms/sql_workbench.rst create mode 100644 connecting_to_sqream/client_platforms/tableau.rst create mode 100644 connecting_to_sqream/client_platforms/talend.rst create mode 100644 connecting_to_sqream/client_platforms/test.php create mode 100644 connecting_to_sqream/client_platforms/tibco_spotfire.rst diff --git a/connecting_to_sqream/client_platforms/connect.sas b/connecting_to_sqream/client_platforms/connect.sas new file mode 100644 index 000000000..10fcdb0a2 --- /dev/null +++ b/connecting_to_sqream/client_platforms/connect.sas @@ -0,0 +1,27 @@ +options sastrace='d,d,d,d' +sastraceloc=saslog +nostsuffix +msglevel=i +sql_ip_trace=(note,source) +DEBUG=DBMS_SELECT; + +options validvarname=any; + +libname sqlib jdbc driver="com.sqream.jdbc.SQDriver" + classpath="/opt/sqream/sqream-jdbc-4.0.0.jar" + URL="jdbc:Sqream://sqream-cluster.piedpiper.com:3108/raviga;cluster=true" + user="rhendricks" + password="Tr0ub4dor3" + schema="public" + PRESERVE_TAB_NAMES=YES + PRESERVE_COL_NAMES=YES; + +proc sql; + title 'Customers table'; + select * + from sqlib.customers; +quit; + +data sqlib.customers; + set sqlib.customers; +run; \ No newline at end of file diff --git a/connecting_to_sqream/client_platforms/connect2.sas b/connecting_to_sqream/client_platforms/connect2.sas new file mode 100644 index 000000000..10fcdb0a2 --- /dev/null +++ b/connecting_to_sqream/client_platforms/connect2.sas @@ -0,0 +1,27 @@ +options sastrace='d,d,d,d' +sastraceloc=saslog +nostsuffix +msglevel=i +sql_ip_trace=(note,source) +DEBUG=DBMS_SELECT; + +options validvarname=any; + +libname sqlib jdbc driver="com.sqream.jdbc.SQDriver" + classpath="/opt/sqream/sqream-jdbc-4.0.0.jar" + URL="jdbc:Sqream://sqream-cluster.piedpiper.com:3108/raviga;cluster=true" + user="rhendricks" + password="Tr0ub4dor3" + schema="public" + PRESERVE_TAB_NAMES=YES + PRESERVE_COL_NAMES=YES; + +proc sql; + title 'Customers table'; + select * + from sqlib.customers; +quit; + +data sqlib.customers; + set sqlib.customers; +run; \ No newline at end of file diff --git a/connecting_to_sqream/client_platforms/connect3.sas b/connecting_to_sqream/client_platforms/connect3.sas new file mode 100644 index 000000000..c1bf11dcf --- /dev/null +++ b/connecting_to_sqream/client_platforms/connect3.sas @@ -0,0 +1,17 @@ +options sastrace='d,d,d,d' +sastraceloc=saslog +nostsuffix +msglevel=i +sql_ip_trace=(note,source) +DEBUG=DBMS_SELECT; + +options validvarname=any; + +libname sqlib jdbc driver="com.sqream.jdbc.SQDriver" + classpath="/opt/sqream/sqream-jdbc-4.0.0.jar" + URL="jdbc:Sqream://sqream-cluster.piedpiper.com:3108/raviga;cluster=true" + user="rhendricks" + password="Tr0ub4dor3" + schema="public" + PRESERVE_TAB_NAMES=YES + PRESERVE_COL_NAMES=YES; \ No newline at end of file diff --git a/connecting_to_sqream/client_platforms/index.rst b/connecting_to_sqream/client_platforms/index.rst new file mode 100644 index 000000000..a5a3f5166 --- /dev/null +++ b/connecting_to_sqream/client_platforms/index.rst @@ -0,0 +1,39 @@ +.. _client_platforms: + +************************************ +Client Platforms +************************************ +These topics explain how to install and connect a variety of third party tools. + +Browse the articles below, in the sidebar, or use the search to find the information you need. + +Overview +========== + +SQream DB is designed to work with most common database tools and interfaces, allowing you direct access through a variety of drivers, connectors, tools, vizualisers, and utilities. + +The tools listed have been tested and approved for use with SQream DB. Most 3\ :sup:`rd` party tools that work through JDBC, ODBC, and Python should work. + +If you are looking for a tool that is not listed, SQream and our partners can help. Go to `SQream Support `_ or contact your SQream account manager for more information. + +.. toctree:: + :maxdepth: 4 + :caption: In this section: + :titlesonly: + + power_bi + tibco_spotfire + sas_viya + sql_workbench + tableau + pentaho + microstrategy + informatica + r + php + xxtalend + xxdiagnosing_common_connectivity_issues + +.. image:: /_static/images/connectivity_ecosystem.png + + diff --git a/connecting_to_sqream/client_platforms/informatica.rst b/connecting_to_sqream/client_platforms/informatica.rst new file mode 100644 index 000000000..6bc50b22a --- /dev/null +++ b/connecting_to_sqream/client_platforms/informatica.rst @@ -0,0 +1,173 @@ +.. _informatica: + +************************* +Connect to SQream Using Informatica Cloud Services +************************* + +Overview +========= +The **Connecting to SQream Using Informatica Cloud Services** page is quick start guide for connecting to SQream using Informatica cloud services. + +It describes the following: + +.. contents:: + :local: + +Establishing a Connection between SQream and Informatica +----------------- +The **Establishing a Connection between SQream and Informatica** page describes how to establish a connection between SQream and the Informatica data integration Cloud. + +**To establish a connection between SQream and the Informatica data integration Cloud:** + +1. Go to the `Informatica Cloud homepage `_. + + :: + +2. Do one of the following: + + 1. Log in using your credentials. + + :: + + 2. Log in using your SAML Identity Provider. + +3. From the **Services** window, select **Administrator** or click **Show all services** to show all services. + + + The SQream dashboard is displayed. + + + :: + + +4. In the menu on the left, click **Runtime Environments**. + + + The **Runtime Environments** panel is displayed. + + :: + +5. Click **Download Secure Agent**. + + :: + +6. When the **Download the Secure Agent** panel is displayed, do the following: + + 1. Select a platform (Windows 64 or Linux 64). + + :: + + + 2. Click **Copy** and save the token on your local hard drive. + + The token is used in combination with your user name to authorize the agent to access your account. + + +7. Click **Download**. + + The installation begins. + + :: + +8. When the **Informatica Cloud Secure Agent Setup** panel is displayed, click **Next**. + + + :: + + +9. Provide your **User Name** and **Install Token** and click **Register**. + + :: + + + +10. From the Runtime Environments panel, click **New Runtime Environment**. + + + The **New Secure Agent Group** window is displayed. + + :: + +11. On the New Secure Agent Group window, click **OK** to connect your Runtime Environment with the running agent. + + .. note:: If you do not download Secure Agent, you will not be able to connect your Runtime Environment with the running agent and continue establishing a connection between SQream and the Informatica data integration Cloud. + +Establishing a Connection In Your Environment +----------------- + +The **Establishing a Connection In Your Environment** describes the following: + +.. contents:: + :local: + +Establishing an ODBC DSN Connection In Your Environment +~~~~~~~~~~~~~ +After establishing a connection between SQream and Informatica you can establish an ODBC DSN connection in your environment. + +**To establish an ODBC connection in your environment:** + +1. Click **Add**. + + :: + +2. Click **Configure**. + + .. note:: Verify that **Use Server Picker** is selected. + +3. Click **Test**. + + :: + +4. Verify that the connection has tested successfully. + + :: + +5. Click **Save**. + + :: + +6. Click **Actions** > **Publish**. + +Establishing a JDBC Connection In Your Environment +~~~~~~~~~~~~~ +After establishing a connection between SQream and Informatica you can establish a JDBC connection in your environment. + +**To establish a JDBC connection in your environment:** + +1. Create a new DB connection by clicking **Connections** > **New Connection**. + + The **New Connection** window is displayed. + + :: + + +2. In the **JDBC_IC Connection Properties** section, in the **JDBC Connection URL** field, establish a JDBC connection by providing the correct connection string. + + For connection string examples, see `Connection Strings `_. + + :: + +3. Click **Test**. + + :: + +4. Verify that the connection has tested successfully. + + :: + +5. Click **Save**. + + :: + +6. Click **Actions** > **Publish**. + +Supported SQream Driver Versions +--------------- + +SQream supports the following SQream driver versions: + +* **JDBC** - Version 4.3.4 and above. + + :: + +* **ODBC** - Version 4.0.0 and above. diff --git a/connecting_to_sqream/client_platforms/microstrategy.rst b/connecting_to_sqream/client_platforms/microstrategy.rst new file mode 100644 index 000000000..6cad19be2 --- /dev/null +++ b/connecting_to_sqream/client_platforms/microstrategy.rst @@ -0,0 +1,185 @@ +.. _microstrategy: + + +************************* +Connect to SQream Using MicroStrategy +************************* + +.. _ms_top: + +Overview +--------------- +This document is a Quick Start Guide that describes how to install MicroStrategy and connect a datasource to the MicroStrategy dasbhoard for analysis. + + + +The **Connecting to SQream Using MicroStrategy** page describes the following: + + +.. contents:: + :local: + + + + + + +What is MicroStrategy? +================ +MicroStrategy is a Business Intelligence software offering a wide variety of data analytics capabilities. SQream uses the MicroStrategy connector for reading and loading data into SQream. + +MicroStrategy provides the following: + +* Data discovery +* Advanced analytics +* Data visualization +* Embedded BI +* Banded reports and statements + + +For more information about Microstrategy, see `MicroStrategy `_. + + + +:ref:`Back to Overview ` + + + + + +Connecting a Data Source +======================= + +1. Activate the **MicroStrategy Desktop** app. The app displays the Dossiers panel to the right. + + :: + +2. Download the most current version of the `SQream JDBC driver `_. + + :: + +3. Click **Dossiers** and **New Dossier**. The **Untitled Dossier** panel is displayed. + + :: + +4. Click **New Data**. + + :: + +5. From the **Data Sources** panel, select **Databases** to access data from tables. The **Select Import Options** panel is displayed. + + :: + +6. Select one of the following: + + * Build a Query + * Type a Query + * Select Tables + + :: + +7. Click **Next**. + + :: + +8. In the Data Source panel, do the following: + + 1. From the **Database** dropdown menu, select **Generic**. The **Host Name**, **Port Number**, and **Database Name** fields are removed from the panel. + + :: + + 2. In the **Version** dropdown menu, verify that **Generic DBMS** is selected. + + :: + + 3. Click **Show Connection String**. + + :: + + 4. Select the **Edit connection string** checkbox. + + :: + + 5. From the **Driver** dropdown menu, select a driver for one of the following connectors: + + * **JDBC** - The SQream driver is not integrated with MicroStrategy and does not appear in the dropdown menu. However, to proceed, you must select an item, and in the next step you must specify the path to the SQream driver that you installed on your machine. + * **ODBC** - SQreamDB ODBC + + :: + + 6. In the **Connection String** text box, type the relevant connection string and path to the JDBC jar file using the following syntax: + + .. code-block:: console + + $ jdbc:Sqream:///;user=;password=sqream;[; ...] + + The following example shows the correct syntax for the JDBC connector: + + .. code-block:: console + + jdbc;MSTR_JDBC_JAR_FOLDER=C:\path\to\jdbc\folder;DRIVER=;URL={jdbc:Sqream:///;user=;password=;[; ...];} + + The following example shows the correct syntax for the ODBC connector: + + .. code-block:: console + + odbc:Driver={SqreamODBCDriver};DSN={SQreamDB ODBC};Server=;Port=;Database=;User=;Password=;Cluster=; + + For more information about the available **connection parameters** and other examples, see `Connection Parameters `_. + + 7. In the **User** and **Password** fields, fill out your user name and password. + + :: + + 8. In the **Data Source Name** field, type **SQreamDB**. + + :: + + 9. Click **Save**. The SQreamDB that you picked in the Data Source panel is displayed. + + +9. In the **Namespace** menu, select a namespace. The tables files are displayed. + + :: + +10. Drag and drop the tables into the panel on the right in your required order. + + :: + +11. **Recommended** - Click **Prepare Data** to customize your data for analysis. + + :: + +12. Click **Finish**. + + :: + +13. From the **Data Access Mode** dialog box, select one of the following: + + + * Connect Live + * Import as an In-memory Dataset + +Your populated dashboard is displayed and is ready for data discovery and analytics. + + + + + + +.. _supported_sqream_drivers: + +:ref:`Back to Overview ` + +Supported SQream Drivers +================ + +The following list shows the supported SQream drivers and versions: + +* **JDBC** - Version 4.3.3 and higher. +* **ODBC** - Version 4.0.0. + + +.. _supported_tools_and_operating_systems: + +:ref:`Back to Overview ` diff --git a/connecting_to_sqream/client_platforms/odbc-sqream.tdc b/connecting_to_sqream/client_platforms/odbc-sqream.tdc new file mode 100644 index 000000000..36cd55e33 --- /dev/null +++ b/connecting_to_sqream/client_platforms/odbc-sqream.tdc @@ -0,0 +1,25 @@ + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/connecting_to_sqream/client_platforms/pentaho.rst b/connecting_to_sqream/client_platforms/pentaho.rst new file mode 100644 index 000000000..fa8146c41 --- /dev/null +++ b/connecting_to_sqream/client_platforms/pentaho.rst @@ -0,0 +1,253 @@ +.. _pentaho_data_integration: + +************************* +Connecting to SQream Using Pentaho Data Integration +************************* +.. _pentaho_top: + +Overview +========= +This document is a Quick Start Guide that describes how to install Pentaho, create a transformation, and define your output. + +The Connecting to SQream Using Pentaho page describes the following: + +* :ref:`Installing Pentaho ` +* :ref:`Installing and setting up the JDBC driver ` +* :ref:`Creating a transformation ` +* :ref:`Defining your output ` +* :ref:`Importing your data ` + +.. _install_pentaho: + +Installing Pentaho +~~~~~~~~~~~~~~~~~ +To install PDI, see the `Pentaho Community Edition (CE) Installation Guide `_. + +The **Pentaho Community Edition (CE) Installation Guide** describes how to do the following: + +* Downloading the PDI software. +* Installing the **JRE (Java Runtime Environment)** and **JDK (Java Development Kit)**. +* Setting up the JRE and JDK environment variables for PDI. + +:ref:`Back to Overview ` + +.. _install_set_up_jdbc_driver: + +Installing and Setting Up the JDBC Driver +~~~~~~~~~~~~~~~~~ +After installing Pentaho you must install and set up the JDBC driver. This section explains how to set up the JDBC driver using Pentaho. These instructions use Spoon, the graphical transformation and job designer associated with the PDI suite. + +You can install the driver by copying and pasting the SQream JDBC .jar file into your **/design-tools/data-integration/lib** directory. + +**NOTE:** Contact your SQream license account manager for the JDBC .jar file. + +:ref:`Back to Overview ` + +.. _create_transformation: + +Creating a Transformation +~~~~~~~~~~~~~~~~~~ +After installing Pentaho you can create a transformation. + +**To create a transformation:** + +1. Use the CLI to open the PDI client for your operating system (Windows): + + .. code-block:: console + + $ spoon.bat + +2. Open the spoon.bat file from its folder location. + +:: + +3. In the **View** tab, right-click **Transformations** and click **New**. + + A new transformation tab is created. + +4. In the **Design** tab, click **Input** to show its file contents. + +:: + +5. Drag and drop the **CSV file input** item to the new transformation tab that you created. + +:: + +6. Double-click **CSV file input**. The **CSV file input** panel is displayed. + +:: + +7. In the **Step name** field, type a name. + +:: + +8. To the right of the **Filename** field, click **Browse**. + +:: + +9. Select the file that you want to read from and click **OK**. + +:: + +10. In the CSV file input window, click **Get Fields**. + +:: + +11. In the **Sample data** window, enter the number of lines you want to sample and click **OK**. The default setting is **100**. + + The tool reads the file and suggests the field name and type. + +12. In the CSV file input window, click **Preview**. + +:: + +13. In the **Preview size** window, enter the number of rows you want to preview and click **OK**. The default setting is **1000**. + +:: + +14. Verify that the preview data is correct and click **Close**. + +:: + +15. Click **OK** in the **CSV file input** window. + +:ref:`Back to Overview ` + +.. _define_output: + +Defining Your Output +----------------- +After creating your transformation you must define your output. + +**To define your output:** + +1. In the **Design** tab, click **Output**. + + The Output folder is opened. + +2. Drag and drop **Table output** item to the Transformation window. + +:: + +3. Double-click **Table output** to open the **Table output** dialog box. + +:: + +4. From the **Table output** dialog box, type a **Step name** and click **New** to create a new connection. Your **steps** are the building blocks of a transformation, such as file input or a table output. + + The **Database Connection** window is displayed with the **General** tab selected by default. + +5. Enter or select the following information in the Database Connection window and click **Test**. + + The following table shows and describes the information that you need to fill out in the Database Connection window: + + .. list-table:: + :widths: 6 31 73 + :header-rows: 1 + + * - No. + - Element Name + - Description + * - 1 + - Connection name + - Enter a name that uniquely describes your connection, such as **sampledata**. + * - 2 + - Connection type + - Select **Generic database**. + * - 3 + - Access + - Select **Native (JDBC)**. + * - 4 + - Custom connection URL + - Insert **jdbc:Sqream:///;user=;password=;[; ...];**. The IP is a node in your SQream cluster and is the name or schema of the database you want to connect to. Verify that you have not used any leading or trailing spaces. + * - 5 + - Custom driver class name + - Insert **com.sqream.jdbc.SQDriver**. Verify that you have not used any leading or trailing spaces. + * - 6 + - Username + - Your SQreamdb username. If you leave this blank, you will be prompted to provide it when you connect. + * - 7 + - Password + - Your password. If you leave this blank, you will be prompted to provide it when you connect. + + The following message is displayed: + +.. image:: /_static/images/third_party_connectors/pentaho/connection_tested_successfully_2.png + +6. Click **OK** in the window above, in the Database Connection window, and Table Output window. + +:ref:`Back to Overview ` + +.. _import_data: + +Importing Data +----------------- +After defining your output you can begin importing your data. + +For more information about backing up users, permissions, or schedules, see `Backup and Restore Pentaho Repositories `_ + +**To import data:** + +1. Double-click the **Table output** connection that you just created. + +:: + +2. To the right of the **Target schema** field, click **Browse** and select a schema name. + +:: + +3. Click **OK**. The selected schema name is displayed in the **Target schema** field. + +:: + +4. Create a new hop connection between the **CSV file input** and **Table output** steps: + + 1. On the CSV file input step item, click the **new hop connection** icon. + + .. image:: /_static/images/third_party_connectors/pentaho/csv_file_input_options.png + + 2. Drag an arrow from the **CSV file input** step item to the **Table output** step item. + + .. image:: /_static/images/third_party_connectors/pentaho/csv_file_input_options_2.png + + 3. Release the mouse button. The following options are displayed. + + :: + + 4. Select **Main output of step**. + + .. image:: /_static/images/third_party_connectors/pentaho/main_output_of_step.png + +:: + +5. Double-click **Table output** to open the **Table output** dialog box. + +:: + +6. In the **Target table** field, define a target table name. + +:: + +7. Click **SQL** to open the **Simple SQL editor.** + +:: + +8. In the **Simple SQL editor**, click **Execute**. + + The system processes and displays the results of the SQL statements. + +9. Close all open dialog boxes. + +:: + +10. Click the play button to execute the transformation. + + .. image:: /_static/images/third_party_connectors/pentaho/execute_transformation.png + + The **Run Options** dialog box is displayed. + +11. Click **Run**. + + The **Execution Results** are displayed. + +:ref:`Back to Overview ` \ No newline at end of file diff --git a/connecting_to_sqream/client_platforms/php.rst b/connecting_to_sqream/client_platforms/php.rst new file mode 100644 index 000000000..2310fde6b --- /dev/null +++ b/connecting_to_sqream/client_platforms/php.rst @@ -0,0 +1,76 @@ +.. _php: + +***************************** +Connect to SQream Using PHP +***************************** + +Overview +========== +PHP is an open source scripting language that executes scripts on servers. The **Connect to PHP** page explains how to connect to a SQream cluster, and describes the following: + +.. contents:: + :local: + :depth: 1 + +Installing PHP +------------------- +**To install PHP:** + +1. Download the JDBC driver installer from the `SQream Drivers page `_. + + :: + +2. Create a DSN. + + :: + +3. Install the **uODBC** extension for your PHP installation. + + For more information, navigate to `PHP Documentation `_ and see the topic menu on the right side of the page. + +Configuring PHP +------------------- +You can configure PHP in one of the following ways: + +* When compiling, configure PHP to enable uODBC using ``./configure --with-pdo-odbc=unixODBC,/usr/local``. + + :: + +* Install ``php-odbc`` and ``php-pdo`` along with PHP using your distribution package manager. SQream recommends a minimum of version 7.1 for the best results. + +.. note:: PHP's string size limitations truncates fetched text, which you can override by doing one of the following: + + * Increasing the **php.ini** default setting, such as the *odbc.defaultlrl* to **10000**. + + :: + + * Setting the size limitation in your code before making your connection using **ini_set("odbc.defaultlrl", "10000");**. + + :: + + * Setting the size limitation in your code before fetchng your result using **odbc_longreadlen($result, "10000");**. + +Operating PHP +------------------- +After configuring PHP, you can test your connection. + +**To test your connection:** + +#. Create a test connection file using the correct parameters for your SQream installation, as shown below: + + .. literalinclude:: test.php + :language: php + :emphasize-lines: 4 + :linenos: + + For more information, download the sample :download:`PHP example connection file ` shown above. + + The following is an example of a valid DSN line: + + .. code:: php + + $dsn = "odbc:Driver={SqreamODBCDriver};Server=192.168.0.5;Port=5000;Database=master;User=rhendricks;Password=super_secret;Service=sqream"; + +#. Run the PHP file either directly with PHP (``php test.php``) or through a browser. + + For more information about supported DSN parameters, see :ref:`dsn_params`. \ No newline at end of file diff --git a/connecting_to_sqream/client_platforms/power_bi.rst b/connecting_to_sqream/client_platforms/power_bi.rst new file mode 100644 index 000000000..c088db851 --- /dev/null +++ b/connecting_to_sqream/client_platforms/power_bi.rst @@ -0,0 +1,143 @@ +.. _power_bi: + +************************* +Connect to SQream Using Power BI Desktop +************************* + +Overview +========= +**Power BI Desktop** lets you connect to SQream and use underlying data as with other data sources in Power BI Desktop. + +SQream integrates with Power BI Desktop to do the following: + +* Extract and transform your datasets into usable visual models in approximately one minute. + + :: + +* Use **DAX** functions **(Data Analysis Expressions)** to analyze your datasets. + + :: + +* Refresh datasets as needed or by using scheduled jobs. + +SQream uses Power BI for extracting data sets using the following methods: + +* **Direct query** - Direct queries lets you connect easily with no errors, and refreshes Power BI artifacts, such as graphs and reports, in a considerable amount of time in relation to the time taken for queries to run using the `SQream SQL CLI Reference guide `_. + + :: + +* **Import** - Lets you extract datasets from remote databases. + +The **Connect to SQream Using Power BI** page describes the following: + +.. contents:: + :local: + :depth: 1 + +Prerequisites +------------------- +To connect to SQream, the following must be installed: + +* **ODBC data source administrator** - 32 or 64, depending on your operating system. For Windows users, the ODBC data source administrator is embedded within the operating system. + +* **SQream driver** - The SQream application required for interacting with the ODBC according to the configuration specified in the ODBC administrator tool. + +Installing Power BI Desktop +------------------- +**To install Power BI Desktop:** + +1. Download `Power BI Desktop 64x `_. + + :: + +2. Download and configure your ODBC driver. + + For more information about configuring your ODBC driver, see `ODBC `_. + +3. Navigate to **Windows** > **Documents** and create a folder called **Power BI Desktop Custom Connectors**. + + :: + +4. In the **Power BI Desktop** folder, create a folder called **Custom Connectors**. + + +5. From the Client Drivers page, download the **PowerQuery.mez** file. + + :: + +5. Save the PowerQuery.mez file in the **Custom Connectors** folder you created in Step 3. + + :: + +6. Open the Power BI application. + + :: + +7. Navigate to **File** > **Options and Settings** > **Option** > **Security** > **Data Extensions**, and select **(Not Recommended) Allow any extension to load without validation or warning**. + + :: + +8. Restart the Power BI Desktop application. + + :: + +9. From the **Get Data** menu, select **SQream**. + + :: + +10. Click **Connect** and provide the information shown in the following table: + + .. list-table:: + :widths: 6 31 + :header-rows: 1 + + * - Element Name + - Description + * - Server + - Provide the network address to your database server. You can use a hostname or an IP address. + * - Port + - Provide the port that the database is responding to at the network address. + * - Database + - Provide the name of your database or the schema on your database server. + * - User + - Provide a SQreamdb username. + * - Passwords + - Provide a password for your user. + +11. Under **Data Connectivity mode**, select **DirectQuery mode**. + + :: + +12. Click **Connect**. + + :: + +13. Provide your user name and password and click **Connect**. + +Best Practices for Power BI +--------------- +SQream recommends using Power BI in the following ways for acquiring the best performance metrics: + +* Creating bar, pie, line, or plot charts when illustrating one or more columns. + + :: + +* Displaying trends and statuses using visual models. + + :: + +* Creating a unified view using **PowerQuery** to connect different data sources into a single dashboard. + +Supported SQream Driver Versions +--------------- +SQream supports the following SQream driver versions: + +* The **PowerQuery Connector** is an additional layer on top of the ODBC. + + :: + +* SQream Driver Installation (ODBC v4.1.1) - Contact your administrator for the link to download ODBC v4.1.1. + +Related Information +------------------- +For more information, see the `Glossary `_. \ No newline at end of file diff --git a/connecting_to_sqream/client_platforms/r.rst b/connecting_to_sqream/client_platforms/r.rst new file mode 100644 index 000000000..c84bf901b --- /dev/null +++ b/connecting_to_sqream/client_platforms/r.rst @@ -0,0 +1,151 @@ +.. _r: + +***************************** +Connect to SQream Using R +***************************** + +You can use R to interact with a SQream DB cluster. + +This tutorial is a guide that will show you how to connect R to SQream DB. + +.. contents:: In this topic: + :local: + +JDBC +========= + + +#. Get the :ref:`SQream DB JDBC driver`. + +#. + In R, install RJDBC + + .. code-block:: rconsole + + > install.packages("RJDBC") + Installing package into 'C:/Users/r/...' + (as 'lib' is unspecified) + + package 'RJDBC' successfully unpacked and MD5 sums checked + +#. + Import the RJDBC library + + .. code-block:: rconsole + + > library(RJDBC) + +#. + Set the classpath and initialize the JDBC driver which was previously installed. For example, on Windows: + + .. code-block:: rconsole + + > cp = c("C:\\Program Files\\SQream Technologies\\JDBC Driver\\2020.1-3.2.0\\sqream-jdbc-3.2.jar") + > .jinit(classpath=cp) + > drv <- JDBC("com.sqream.jdbc.SQDriver","C:\\Program Files\\SQream Technologies\\JDBC Driver\\2020.1-3.2.0\\sqream-jdbc-3.2.jar") +#. + Open a connection with a :ref:`JDBC connection string` and run your first statement + + .. code-block:: rconsole + + > con <- dbConnect(drv,"jdbc:Sqream://127.0.0.1:3108/master;user=rhendricks;password=Tr0ub4dor&3;cluster=true") + + > dbGetQuery(con,"select top 5 * from t") + xint xtinyint xsmallint xbigint + 1 1 82 5067 1 + 2 2 14 1756 2 + 3 3 91 22356 3 + 4 4 84 17232 4 + 5 5 13 14315 5 + +#. + Close the connection + + .. code-block:: rconsole + + > close(con) + +A full example +----------------- + +.. code-block:: rconsole + + > library(RJDBC) + > cp = c("C:\\Program Files\\SQream Technologies\\JDBC Driver\\2020.1-3.2.0\\sqream-jdbc-3.2.jar") + > .jinit(classpath=cp) + > drv <- JDBC("com.sqream.jdbc.SQDriver","C:\\Program Files\\SQream Technologies\\JDBC Driver\\2020.1-3.2.0\\sqream-jdbc-3.2.jar") + > con <- dbConnect(drv,"jdbc:Sqream://127.0.0.1:3108/master;user=rhendricks;password=Tr0ub4dor&3;cluster=true") + > dbGetQuery(con,"select top 5 * from t") + xint xtinyint xsmallint xbigint + 1 1 82 5067 1 + 2 2 14 1756 2 + 3 3 91 22356 3 + 4 4 84 17232 4 + 5 5 13 14315 5 + > close(con) + +ODBC +========= + +#. Install the :ref:`SQream DB ODBC driver` for your operating system, and create a DSN. + +#. + In R, install RODBC + + .. code-block:: rconsole + + > install.packages("RODBC") + Installing package into 'C:/Users/r/...' + (as 'lib' is unspecified) + + package 'RODBC' successfully unpacked and MD5 sums checked + +#. + Import the RODBC library + + .. code-block:: rconsole + + > library(RODBC) + +#. + Open a connection handle to an existing DSN (``my_cool_dsn`` in this example) + + .. code-block:: rconsole + + > ch <- odbcConnect("my_cool_dsn",believeNRows=F) + +#. + Run your first statement + + .. code-block:: rconsole + + > sqlQuery(ch,"select top 5 * from t") + xint xtinyint xsmallint xbigint + 1 1 82 5067 1 + 2 2 14 1756 2 + 3 3 91 22356 3 + 4 4 84 17232 4 + 5 5 13 14315 5 + +#. + Close the connection + + .. code-block:: rconsole + + > close(ch) + +A full example +----------------- + +.. code-block:: rconsole + + > library(RODBC) + > ch <- odbcConnect("my_cool_dsn",believeNRows=F) + > sqlQuery(ch,"select top 5 * from t") + xint xtinyint xsmallint xbigint + 1 1 82 5067 1 + 2 2 14 1756 2 + 3 3 91 22356 3 + 4 4 84 17232 4 + 5 5 13 14315 5 + > close(ch) diff --git a/connecting_to_sqream/client_platforms/sas_viya.rst b/connecting_to_sqream/client_platforms/sas_viya.rst new file mode 100644 index 000000000..83942ccfd --- /dev/null +++ b/connecting_to_sqream/client_platforms/sas_viya.rst @@ -0,0 +1,185 @@ +.. _connect_to_sas_viya: + +************************* +Connect to SQream Using SAS Viya +************************* + +Overview +========== +SAS Viya is a cloud-enabled analytics engine used for producing useful insights. The **Connect to SQream Using SAS Viya** page describes how to connect to SAS Viya, and describes the following: + +.. contents:: + :local: + :depth: 1 + +Installing SAS Viya +------------------- +The **Installing SAS Viya** section describes the following: + +.. contents:: + :local: + :depth: 1 + +Downloading SAS Viya +~~~~~~~~~~~~~~~~~~ +Integrating with SQream has been tested with SAS Viya v.03.05 and newer. + +To download SAS Viya, see `SAS Viya `_. + +Installing the JDBC Driver +~~~~~~~~~~~~~~~~~~ +The SQream JDBC driver is required for establishing a connection between SAS Viya and SQream. + +**To install the JDBC driver:** + +#. Download the `JDBC driver `_. + + :: + +#. Unzip the JDBC driver into a location on the SAS Viya server. + + SQream recommends creating the directory ``/opt/sqream`` on the SAS Viya server. + +Configuring SAS Viya +------------------- +After installing the JDBC driver, you must configure the JDBC driver from the SAS Studio so that it can be used with SQream Studio. + +**To configure the JDBC driver from the SAS Studio:** + +#. Sign in to the SAS Studio. + + :: + +#. From the **New** menu, click **SAS Program**. + + :: + +#. Configure the SQream JDBC connector by adding the following rows: + + .. literalinclude:: connect3.sas + :language: php + +For more information about writing a connection string, see **Connect to SQream DB with a JDBC Application** and navigate to `Connection String `_. + +Operating SAS Viya +-------------------- +The **Operating SAS Viya** section describes the following: + +.. contents:: + :local: + :depth: 1 + +Using SAS Viya Visual Analytics +~~~~~~~~~~~~~~~~~~ +This section describes how to use SAS Viya Visual Analytics. + +**To use SAS Viya Visual Analytics:** + +#. Log in to `SAS Viya Visual Analytics `_ using your credentials: + + :: + +2. Click **New Report**. + + :: + +3. Click **Data**. + + :: + +4. Click **Data Sources**. + + :: + +5. Click the **Connect** icon. + + :: + +6. From the **Type** menu, select **Database**. + + :: + +7. Provide the required information and select **Persist this connection beyond the current session**. + + :: + +8. Click **Advanced** and provide the required information. + + :: + +9. Add the following additional parameters by clicking **Add Parameters**: + +.. list-table:: + :widths: 10 90 + :header-rows: 1 + + * - Name + - Value + * - class + - com.sqream.jdbc.SQDriver + * - classPath + - ** + * - url + - \jdbc:Sqream://**:**/**;cluster=true + * - username + - + * - password + - + +10. Click **Test Connection**. + + :: + +11. If the connection is successful, click **Save**. + +If your connection is not successful, see :ref:`troubleshooting_sas_viya` below. + +.. _troubleshooting_sas_viya: + +Troubleshooting SAS Viya +------------------------- +The **Best Practices and Troubleshooting** section describes the following best practices and troubleshooting procedures when connecting to SQream using SAS Viya: + +.. contents:: + :local: + :depth: 1 + +Inserting Only Required Data +~~~~~~~~~~~~~~~~~~ +When using SAS Viya, SQream recommends using only data that you need, as described below: + +* Insert only the data sources you need into SAS Viya, excluding tables that don’t require analysis. + + :: + +* To increase query performance, add filters before analyzing. Every modification you make while analyzing data queries the SQream database, sometimes several times. Adding filters to the datasource before exploring limits the amount of data analyzed and increases query performance. + +Creating a Separate Service for SAS Viya +~~~~~~~~~~~~~~~~~~ +SQream recommends creating a separate service for SAS Viya with the DWLM. This reduces the impact that Tableau has on other applications and processes, such as ETL. In addition, this works in conjunction with the load balancer to ensure good performance. + +Locating the SQream JDBC Driver +~~~~~~~~~~~~~~~~~~ +In some cases, SAS Viya cannot locate the SQream JDBC driver, generating the following error message: + +.. code-block:: text + + java.lang.ClassNotFoundException: com.sqream.jdbc.SQDriver + +**To locate the SQream JDBC driver:** + +1. Verify that you have placed the JDBC driver in a directory that SAS Viya can access. + + :: + +2. Verify that the classpath in your SAS program is correct, and that SAS Viya can access the file that it references. + + :: + +3. Restart SAS Viya. + +For more troubleshooting assistance, see the `SQream Support Portal `_. + +Supporting TEXT +~~~~~~~~~~~~~~~~~~ +In SAS Viya versions lower than 4.0, casting ``TEXT`` to ``CHAR`` changes the size to 1,024, such as when creating a table including a ``TEXT`` column. This is resolved by casting ``TEXT`` into ``CHAR`` when using the JDBC driver. \ No newline at end of file diff --git a/connecting_to_sqream/client_platforms/sql_workbench.rst b/connecting_to_sqream/client_platforms/sql_workbench.rst new file mode 100644 index 000000000..16265ebd4 --- /dev/null +++ b/connecting_to_sqream/client_platforms/sql_workbench.rst @@ -0,0 +1,135 @@ +.. _connect_to_sql_workbench: + +***************************** +Connect to SQream Using SQL Workbench +***************************** + +You can use SQL Workbench to interact with a SQream DB cluster. SQL Workbench/J is a free SQL query tool, and is designed to run on any JRE-enabled environment. + +This tutorial is a guide that will show you how to connect SQL Workbench to SQream DB. + +.. contents:: In this topic: + :local: + +Installing SQL Workbench with the SQream DB installer (Windows only) +===================================================================== + +SQream DB's driver installer for Windows can install the Java prerequisites and SQL Workbench for you. + +#. Get the JDBC driver installer available for download from the `SQream Drivers page `_. The Windows installer takes care of the Java prerequisites and subsequent configuration. + +#. Install the driver by following the on-screen instructions in the easy-to-follow installer. + By default, the installer does not install SQL Workbench. Make sure to select the item! + + .. image:: /_static/images/jdbc_windows_installer_screen.png + +.. note:: The installer will install SQL Workbench in ``C:\Program Files\SQream Technologies\SQLWorkbench`` by default. You can change this path during the installation. + +#. Once finished, SQL Workbench is installed and contains the necessary configuration for connecting to SQream DB clusters. + +#. Start SQL Workbench from the Windows start menu. Be sure to select **SQL Workbench (64)** if you're on 64-bit Windows. + + .. image:: /_static/images/sql_workbench_launch.png + +You are now ready to create a profile for your cluster. Continue to :ref:`Creating a new connection profile `. + +Installing SQL Workbench manually (Linux, MacOS) +=================================================== + +Install Java Runtime +------------------------ + +Both SQL Workbench and the SQream DB JDBC driver require Java 1.8 or newer. You can install either Oracle Java or OpenJDK. + +**Oracle Java** + +Download and install Java 8 from Oracle for your platform - https://www.java.com/en/download/manual.jsp + +**OpenJDK** + +For Linux and BSD, see https://openjdk.java.net/install/ + +For Windows, SQream recommends Zulu 8 https://www.azul.com/downloads/zulu-community/?&version=java-8-lts&architecture=x86-64-bit&package=jdk + +Get the SQream DB JDBC driver +------------------------------- + +SQream DB's JDBC driver is provided as a zipped JAR file, available for download from the `SQream Drivers page `_. + +Download and extract the JAR file from the zip archive. + +Install SQL Workbench +----------------------- + +#. Download the latest stable release from https://www.sql-workbench.eu/downloads.html . The **Generic package for all systems** is recommended. + +#. Extract the downloaded ZIP archive into a directory of your choice. + +#. Start SQL workbench. If you are using 64 bit windows, run ``SQLWorkbench64.exe`` instead of ``SQLWOrkbench.exe``. + +Setting up the SQream DB JDBC driver profile +--------------------------------------------- + +#. Define a connection profile - :menuselection:`&File --> &Connect window (Alt+C)` + + .. image:: /_static/images/sql_workbench_connect_window1.png + +#. Open the drivers management window - :menuselection:`&Manage Drivers` + + .. image:: /_static/images/sql_workbench_manage_drivers.png + + + +#. Create the SQream DB driver profile + + .. image:: /_static/images/sql_workbench_create_driver.png + + #. Click on the Add new driver button ("New" icon) + + #. Name the driver as you see fit. We recommend calling it SQream DB , where is the version you have installed. + + #. + Add the JDBC drivers from the location where you extracted the SQream DB JDBC JAR. + + If you used the SQream installer, the file will be in ``C:\Program Files\SQream Technologies\JDBC Driver\`` + + #. Click the magnifying glass button to detect the classname automatically. Other details are purely optional + + #. Click OK to save and return to "new connection screen" + + +.. _new_connection_profile: + +Create a new connection profile for your cluster +===================================================== + + .. image:: /_static/images/sql_workbench_connection_profile.png + +#. Create new connection by clicking the New icon (top left) + +#. Give your connection a descriptive name + +#. Select the SQream Driver that was created in the previous screen + +#. Type in your connection string. To find out more about your connection string (URL), see the :ref:`Connection string documentation `. + +#. Text the connection details + +#. Click OK to save the connection profile and connect to SQream DB + +Suggested optional configuration +================================== + +If you installed SQL Workbench manually, you can set a customization to help SQL Workbench show information correctly in the DB Explorer panel. + +#. Locate your workbench.settings file + On Windows, typically: ``C:\Users\\.sqlworkbench\workbench.settings`` + On Linux, ``$HOME/.sqlworkbench`` + +#. Add the following line at the end of the file: + + .. code-block:: text + + workbench.db.sqreamdb.schema.retrieve.change.catalog=true + +#. Save the file and restart SQL Workbench diff --git a/connecting_to_sqream/client_platforms/tableau.rst b/connecting_to_sqream/client_platforms/tableau.rst new file mode 100644 index 000000000..ac67c8d55 --- /dev/null +++ b/connecting_to_sqream/client_platforms/tableau.rst @@ -0,0 +1,453 @@ +.. _connect_to_tableau: + +************************* +Connecting to SQream Using Tableau +************************* + +Overview +===================== +SQream's Tableau connector plugin, based on standard JDBC, enables storing and fast querying large volumes of data. + +The **Connecting to SQream Using Tableau** page is a Quick Start Guide that describes how install Tableau and the JDBC and ODBC drivers and connect to SQream using the JDBC and ODBC drivers for data analysis. It also describes using best practices and troubleshoot issues that may occur while installing Tableau. SQream supports both Tableau Desktop and Tableau Server on Windows, MacOS, and Linux distributions. + +For more information on SQream's integration with Tableau, see `Tableau's Extension Gallery `_. + +The Connecting to SQream Using Tableau page describes the following: + +.. contents:: + :local: + +Installing the JDBC Driver and Tableau Connector Plugin +------------------- +This section describes how to install the JDBC driver using the fully-integrated Tableau connector plugin (Tableau Connector, or **.taco** file). SQream has been tested with Tableau versions 9.2 and newer. + +**To connect to SQream using Tableau:** + +#. Install the Tableau Desktop application. + + For more information about installing the Tableau Desktop application, see the `Tableau products page `_ and click **Download Free Trial**. Note that Tableau offers a 14-day trial version. + + :: + +#. Do one of the following: + + * **For Windows** - See :ref:`Installing Tableau Using the Windows Installer `. + * **For MacOS or Linux** - See :ref:`Installing the JDBC Driver Manually `. + +.. note:: For Tableau **2019.4 versions and later**, SQream recommends installing the JDBC driver instead of the previously recommended ODBC driver. + +.. _tableau_windows_installer: + +Installing the JDBC Driver Using the Windows Installer +~~~~~~~~~~~~~~~~~~ +If you are using Windows, after installing the Tableau Desktop application you can install the JDBC driver using the Windows installer. The Windows installer is an installation wizard that guides you through the JDBC driver installation steps. When the driver is installed, you can connect to SQream. + +**To install Tableau using the Windows installer**: + +#. Close Tableau Desktop. + + :: + +#. Download the most current version of the `SQream JDBC driver `_. + + :: + +#. Do the following: + + #. Start the installer. + #. Verify that the **Tableau Desktop connector** item is selected. + #. Follow the installation steps. + + :: + +You can now restart Tableau Desktop or Server to begin using the SQream driver by :ref:`connecting to SQream `. + +.. _tableau_jdbc_installer: + +Installing the JDBC Driver Manually +~~~~~~~~~~~~~ +If you are using MacOS, Linux, or the Tableau server, after installing the Tableau Desktop application you can install the JDBC driver manually. When the driver is installed, you can connect to SQream. + +**To install the JDBC driver manually:** + +1. Download the JDBC installer and SQream Tableau connector (.taco) file from the :ref:`from the client drivers page`. + + :: + +#. Install the JDBC driver by unzipping the JDBC driver into a Tableau driver directory. + + Based on the installation method that you used, your Tableau driver directory is located in one of the following places: + + * **Tableau Desktop on Windows:** *C:\\Program Files\\Tableau\\Drivers* + * **Tableau Desktop on MacOS:** *~/Library/Tableau/Drivers* + * **Tableau on Linux**: */opt/tableau/tableau_driver/jdbc* + +.. note:: If the driver includes only a single .jar file, copy it to *C:\\Program Files\\Tableau/Drivers*. If the driver includes multiple files, create a subfolder *A* in *C:\\Program Files\\Tableau/Drivers* and copy all files to folder *A*. + +Note the following when installing the JDBC driver: + +* You must have read permissions on the .jar file. +* Tableau requires a JDBC 4.0 or later driver. +* Tableau requires a Type 4 JDBC driver. +* The latest 64-bit version of Java 8 is installed. + +3. Install the **SQreamDB.taco** file by moving the SQreamDB.taco file into the Tableau connectors directory. + + Based on the installation method that you used, your Tableau driver directory is located in one of the following places: + + * **Tableau Desktop on Windows:** *C:\\Users\\\\My Tableau Repository\\Connectors* + * **Tableau Desktop on Mac:** *~/My Tableau Repository/Connectors* + + :: + +4. *Optional* - If you are using the Tableau Server, do the following: + + 1. Create a directory for Tableau connectors and give it a descriptive name, such as *C:\\tableau_connectors*. + + This directory needs to exist on all Tableau servers. + + :: + + 2. Copy the SQreamDB.taco file into the new directory. + + :: + + 3. Set the **native_api.connect_plugins_path** option to ``tsm`` as shown in the following example: + + .. code-block:: console + + $ tsm configuration set -k native_api.connect_plugins_path -v C:/tableau_connectors + + If a configuration error is displayed, add ``--force-keys`` to the end of the command as shown in the following example: + + .. code-block:: console + + $ tsm configuration set -k native_api.connect_plugins_path -v C:/tableau_connectors--force-keys + + 4. To apply the pending configuration changes, run the following command: + + .. code-block:: console + + $ tsm pending-changes apply + + .. warning:: This restarts the server. + +You can now restart Tableau Desktop or Server to begin using the SQream driver by :ref:`connecting to SQream ` as described in the section below. + +.. _tableau_connect_to_sqream: + + +Installing the ODBC Driver for Tableau Versions 2019.3 and Earlier +-------------- + + +This section describes the installation method for Tableau version 2019.3 or earlier and describes the following: + +.. contents:: + :local: + +.. note:: SQream recommends installing the JDBC driver to provide improved connectivity. + +Automatically Reconfiguring the ODBC Driver After Initial Installation +~~~~~~~~~~~~~~~~~~ +If you've already installed the SQream ODBC driver and installed Tableau, SQream recommends reinstalling the ODBC driver with the **.TDC Tableau Settings for SQream DB** configuration shown in the image below: + +.. image:: /_static/images/odbc_windows_installer_tableau.png + +SQream recommends this configuration because Tableau creates temporary tables and runs several discovery queries that may impact performance. The ODBC driver installer avoids this by automatically reconfiguring Tableau. + +For more information about reinstalling the ODBC driver installer, see :ref:`Install and Configure ODBC on Windows `. + +If you want to manually reconfigure the ODBC driver, see :ref:`Manually Reconfiguring the ODBC Driver After Initial Installation ` below. + +.. _manually_reconfigure_odbc_driver: + +Manually Reconfiguring the ODBC Driver After Initial Installation +~~~~~~~~~~~~~~~~~~ +The file **Tableau Datasource Customization (TDC)** file lets you use Tableau make full use of SQream DB's features and capabilities. + +**To manually reconfigure the ODBC driver after initial installation:** + +1. Do one of the following: + + 1. Download the :download:`odbc-sqream.tdc ` file to your machine and open it in a text editor. + + :: + + 2. Copy the text below into a text editor: + + .. literalinclude:: odbc-sqream.tdc + :language: xml + :caption: SQream ODBC TDC File + :emphasize-lines: 2 + +#. Check which version of Tableau you are using. + + :: + +#. In the text of the file shown above, in the highlighted line, replace the version number with the **major** version of Tableau that you are using. + + For example, if you are using Tableau vesion **2019.2.1**, replace it with **2019.2**. + + :: + +#. Do one of the following: + + * If you are using **Tableau Desktop** - save the TDC file to *C:\\Users\\\\Documents\\My Tableau Repository\\Datasources*, where ```` is the Windows username that you have installed Tableau under. + + :: + + * If you are using the **Tableau Server** - save the TDC file to *C:\\ProgramData\\Tableau\\Tableau Server\\data\\tabsvc\\vizqlserver\\Datasources*. + +Configuring the ODBC Connection +~~~~~~~~~~~~ +The ODBC connection uses a DSN when connecting to ODBC data sources, and each DSN represents one SQream database. + +**To configure the ODBC connection:** + +1. Create an ODBC DSN. + + :: + +#. Open the Windows menu by pressing the Windows button (:kbd:`⊞ Win`) or clicking the **Windows** menu button. + + :: + +#. Type **ODBC** and select **ODBC Data Sources (64-bit)**. + + During installation, the installer created a sample user DSN named **SQreamDB**. + + :: + +#. *Optional* - Do one or both of the following: + + * Modify the DSN name. + + :: + + * Create a new DSN name by clicking **Add** and selecting **SQream ODBC Driver**. + +.. image:: /_static/images/odbc_windows_dsns.png + + +5. Click **Finish**. + + :: + +6. Enter your connection parameters. + + The following table describes the connection parameters: + + .. list-table:: + :widths: 15 38 38 + :header-rows: 1 + + * - Item + - Description + - Example + * - Data Source Name + - The Data Source Name. SQream recommends using a descriptive and easily recognizable name for referencing your DSN. Once set, the Data Source Name cannot be changed. + - + * - Description + - The description of your DSN. This field is optional. + - + * - User + - The username of a role to use for establishing the connection. + - ``rhendricks`` + * - Password + - The password of the selected role. + - ``Tr0ub4dor`` + * - Database + - The database name to connect to. For example, ``master`` + - ``master`` + * - Service + - The :ref:`service queue` to use. + - For example, ``etl``. For the default service ``sqream``, leave blank. + * - Server + - The hostname of the SQream worker. + - ``127.0.0.1`` or ``sqream.mynetwork.co`` + * - Port + - The TCP port of the SQream worker. + - ``5000`` or ``3108`` + * - User Server Picker + - Uses the load balancer when establishing a connection. Use only if exists, and check port. + - + * - SSL + - Uses SSL when establishing a connection. + - + * - Logging Options + - Lets you modify your logging options when tracking the ODBC connection for connection issues. + - + +.. tip:: Test the connection by clicking **Test** before saving your DSN. + +7. Save the DSN by clicking **OK.** + +Connecting Tableau to SQream +~~~~~~~~~~~~ +**To connect Tableau to SQream:** + +1. Start Tableau Desktop. + + :: + +#. In the **Connect** menu, in the **To a server** sub-menu, click **More Servers** and select **Other Databases (ODBC)**. + + The **Other Databases (ODBC)** window is displayed. + + :: + +#. In the Other Databases (ODBC) window, select the DSN that you created in :ref:`Setting Up SQream Tables as Data Sources `. + + Tableau may display the **Sqream ODBC Driver Connection Dialog** window and prompt you to provide your username and password. + +#. Provide your username and password and click **OK**. + +.. _tableau_connect_to_sqream_db: + + +Connecting to SQream +--------------------- +After installing the JDBC driver you can connect to SQream. + +**To connect to SQream:** + +#. Start Tableau Desktop. + + :: + +#. In the **Connect** menu, in the **To a Server** sub-menu, click **More...**. + + More connection options are displayed. + + :: + +#. Select **SQream DB by SQream Technologies**. + + The **New Connection** dialog box is displayed. + + :: + +#. In the New Connection dialog box, fill in the fields and click **Sign In**. + + The following table describes the fields: + + .. list-table:: + :widths: 15 38 38 + :header-rows: 1 + + * - Item + - Description + - Example + * - Server + - Defines the server of the SQream worker. + - ``127.0.0.1`` or ``sqream.mynetwork.co`` + * - Port + - Defines the TCP port of the SQream worker. + - ``3108`` when using a load balancer, or ``5100`` when connecting directly to a worker with SSL. + * - Database + - Defines the database to establish a connection with. + - ``master`` + * - Cluster + - Enables (``true``) or disables (``false``) the load balancer. After enabling or disabling the load balance, verify the connection. + - + * - Username + - Specifies the username of a role to use when connecting. + - ``rhendricks`` + * - Password + - Specifies the password of the selected role. + - ``Tr0ub4dor&3`` + * - Require SSL (recommended) + - Sets SSL as a requirement for establishing this connection. + - + +The connection is established and the data source page is displayed. + +.. tip:: + Tableau automatically assigns your connection a default name based on the DSN and table. SQream recommends giving the connection a more descriptive name. + +.. _set_up_sqream_tables_as_data_sources: + +Setting Up SQream Tables as Data Sources +---------------- +After connecting to SQream you must set up the SQream tables as data sources. + +**To set up SQream tables as data sources:** + +1. From the **Table** menu, select the desired database and schema. + + SQream's default schema is **public**. + + :: + +#. Drag the desired tables into the main area (labeled **Drag tables here**). + + This area is also used for specifying joins and data source filters. + + :: + +#. Open a new sheet to analyze data. + +.. tip:: + For more information about configuring data sources, joining, filtering, see Tableau's `Set Up Data Sources `_ tutorials. + +Tableau Best Practices and Troubleshooting +--------------- +This section describes the following best practices and troubleshooting procedures when connecting to SQream using Tableau: + +.. contents:: + :local: + +Inserting Only Required Data +~~~~~~~~~~~~~~~~~~ +When using Tableau, SQream recommends using only data that you need, as described below: + +* Insert only the data sources you need into Tableau, excluding tables that don't require analysis. + + :: + +* To increase query performance, add filters before analyzing. Every modification you make while analyzing data queries the SQream database, sometimes several times. Adding filters to the datasource before exploring limits the amount of data analyze and increases query performance. + +Using Tableau's Table Query Syntax +~~~~~~~~~~~~~~~~~~~ +Dragging your desired tables into the main area in Tableau builds queries based on its own syntax. This helps ensure increased performance, while using views or custom SQL may degrade performance. In addition, SQream recommends using the :ref:`create_view` to create pre-optimized views, which your datasources point to. + +Creating a Separate Service for Tableau +~~~~~~~~~~~~~~~~~~~ +SQream recommends creating a separate service for Tableau with the DWLM. This reduces the impact that Tableau has on other applications and processes, such as ETL. In addition, this works in conjunction with the load balancer to ensure good performance. + +Troubleshooting Workbook Performance Before Deploying to the Tableau Server +~~~~~~~~~~~~~~~~~~~ +Tableau has a built-in `performance recorder `_ that shows how time is being spent. If you're seeing slow performance, this could be the result of a misconfiguration such as setting concurrency too low. + +Use the Tableau Performance Recorder for viewing the performance of queries run by Tableau. You can use this information to identify queries that can be optimized by using views. + +Troubleshooting Error Codes +~~~~~~~~~~~~~~~~~~~ +Tableau may be unable to locate the SQream JDBC driver. The following message is displayed when Tableau cannot locate the driver: + +.. code-block:: console + + Error Code: 37CE01A3, No suitable driver installed or the URL is incorrect + +**To troubleshoot error codes:** + +If Tableau cannot locate the SQream JDBC driver, do the following: + + 1. Verify that the JDBC driver is located in the correct directory: + + * **Tableau Desktop on Windows:** *C:\Program Files\Tableau\Drivers* + * **Tableau Desktop on MacOS:** *~/Library/Tableau/Drivers* + * **Tableau on Linux**: */opt/tableau/tableau_driver/jdbc* + + 2. Find the file path for the JDBC driver and add it to the Java classpath: + + * **For Linux** - ``export CLASSPATH=;$CLASSPATH`` + + :: + + * **For Windows** - add an environment variable for the classpath: + + .. image:: /_static/images/Third_Party_Connectors/tableau/envrionment_variable_for_classpath.png + +If you experience issues after restarting Tableau, see the `SQream support portal `_. \ No newline at end of file diff --git a/connecting_to_sqream/client_platforms/talend.rst b/connecting_to_sqream/client_platforms/talend.rst new file mode 100644 index 000000000..2a4d2658a --- /dev/null +++ b/connecting_to_sqream/client_platforms/talend.rst @@ -0,0 +1,204 @@ +.. _talend: + +************************* +Connecting to SQream Using Talend +************************* + +.. _top: + +Overview +================= + +This page describes how to use Talend to interact with a SQream DB cluster. The Talend connector is used for reading data from a SQream DB cluster and loading data into SQream DB. + +In addition, this page provides a viability report on Talend's comptability with SQream DB for stakeholders. + +It includes the following: + +* :ref:`A Quick Start guide ` +* :ref:`Information about supported SQream drivers ` +* :ref:`Supported data sources ` and :ref:`tool and operating system versions ` +* :ref:`A description of known issues ` +* :ref:`Related links ` + + +About Talend +================= +Talend is an open-source data integration platform. It provides various software and services for Big Data integration and management, enterprise application integration, data quality and cloud storage. + +For more information about Talend, see `Talend `_. + + +.. _quickstart_guide: + +Quick Start Guide +======================= + +Creating a New Metadata JDBC DB Connection +------------- +**To create a new metadata JDBC DB connection:** + +1. In the **Repository** panel, nagivate to **Metadata** and right-click **Db connections**. + +.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_1.png + +2. Select **Create connection**. + +.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_2.png + +3. In the **Name** field, type a name. + +.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_3.png + +The name cannot contain spaces. + +4. In the **Purpose** field, type a purpose and click **Next**. You cannot go to the next step until you define both a Name and a Purpose. + +.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_4.png + +5. In the **DB Type** field, select **JDBC**. + +.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_5.png + +6. In the **JDBC URL** field, type the relevant connection string. + + For connection string examples, see `Connection Strings `_. + +.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_6.png + +7. In the **Drivers** field, click the **Add** button. + + The **"newLine** entry is added. + +.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_7.png + +8. One the **"newLine** entry, click the ellipsis. + +.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_8.png + +The **Module** window is displayed. + +9. From the Module window, select **Artifact repository(local m2/nexus)** and select **Install a new module**. + +.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_9.png + +10. Click the ellipsis. + +.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_9.5.png + +Your hard drive is displayed. + +11. Navigate to a **JDBC jar file** (such as **sqream-jdbc-4.4.0.jar**)and click **Open**. + +.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_10.png + +12. Click **Detect the module install status**. + +.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_11.5.png + +13. Click **OK**. + +The JDBC that you selected is displayed in the **Driver** field. + +.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_12.png + +14. Click **Select class name**. + +.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_13.png + +15. Click **Test connection**. + +.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_14.png + +If a driver class is not found (for example, you didn't select a JDBC jar file), the following error message is displayed: + +.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_15.png + +After creating a new metadata JDBC DB connection, you can do the following: + + * Use your new metadata connection. + * Drag it to the **job** screen. + * Build Talend components. + +For more information on loading data from JSON files to the Talend Open Studio, see `How to Load Data from JSON Files in Talend `_. + +:ref:`Back to top ` + +.. _supported_sqream_drivers: + +Supported SQream Drivers +================ + +The following list shows the supported SQream drivers and versions: + +* **JDBC** - Version 4.3.3 and higher. +* **ODBC** - Version 4.0.0. This version requires a Bridge to connect. For more information on the required Bridge, see `Connecting Talend on Windows to an ODBC Database `_. + +:ref:`Back to top ` + + +.. _supported_data_sources: + +Supported Data Sources +============================ +Talend Cloud connectors let you create reusable connections with a wide variety of systems and environments, such as those shown below. This lets you access and read records of a range of diverse data. + +* **Connections:** Connections are environments or systems for storing datasets, including databases, file systems, distributed systems and platforms. Because these systems are reusable, you only need to establish connectivity with them once. + +* **Datasets:** Datasets include database tables, file names, topics (Kafka), queues (JMS) and file paths (HDFS). For more information on the complete list of connectors and datasets that Talend supports, see `Introducing Talend Connectors `_. + +:ref:`Back to top ` + + +.. _supported_tools_os_sys_versions: + +Supported Tool and Operating System Versions +====================== +Talend was tested using the following: + +* Talend version 7.4.1M6 +* Windows 10 +* SQream version 2021.1 +* JDBC version + + + + +:ref:`Back to top ` + + +.. _known_issues: + +Known Issues +=========================== +The the list below describes the following known issues as of 6/1/2021: + +* Schemas not displayed for tables with identical names. + +:ref:`Back to top ` + + +.. _related_links: + +Related Links +=============== +The following is a list of links relevant to the Talend connector: + +* `Talend Home page `_ +* `Talend Community page `_ +* `Talend BugTracker `_ + + +Download Links +================== +The following is a list of download links relevant to the Talend connector: + +* `Talend Open Studio for Big Data `_ +* `Latest version of SQream JDBC `_ + +:ref:`Back to top ` + + + +.. contents:: In this topic: + :local: diff --git a/connecting_to_sqream/client_platforms/test.php b/connecting_to_sqream/client_platforms/test.php new file mode 100644 index 000000000..88ec88338 --- /dev/null +++ b/connecting_to_sqream/client_platforms/test.php @@ -0,0 +1,16 @@ + diff --git a/connecting_to_sqream/client_platforms/tibco_spotfire.rst b/connecting_to_sqream/client_platforms/tibco_spotfire.rst new file mode 100644 index 000000000..4c032ba84 --- /dev/null +++ b/connecting_to_sqream/client_platforms/tibco_spotfire.rst @@ -0,0 +1,387 @@ +.. _tibco_spotfire: + + +************************* +Connecting to SQream Using TIBCO Spotfire +************************* +Overview +========= +The **TIBCO Spotfire** software is an analytics solution that enables visualizing and exploring data through dashboards and advanced analytics. + +This document is a Quick Start Guide that describes the following: + +.. contents:: + :local: + :depth: 1 + +Establishing a Connection between TIBCO Spotfire and SQream +----------------- +TIBCO Spotfire supports the following versions: + +* **JDBC driver** - Version 4.5.2 +* **ODBC driver** - Version 4.1.1 + +SQream supports TIBCO Spotfire version 7.12.0. + +The **Establishing a JDBC Connection between TIBCO Spotfire and SQream** section describes the following: + +.. contents:: + :local: + :depth: 1 + +Creating a JDBC Connection +~~~~~~~~~~~ +For TIBCO Spotfire to recognize SQream, you must add the correct JDBC jar file to Spotfire's loaded binary folder. The following is an example of a path to the Spotfire loaded binaries folder: ``C:\tibco\tss\7.12.0\tomcat\bin``. + +For the complete TIBCO Spotfire documentation, see `TIBCO Spotfire® JDBC Data Access Connectivity Details `_. + +Creating an ODBC Connection +~~~~~~~~~~~ +**To create an ODBC connection** + +1. Install and configure ODBC on Windows. + + For more information, see :ref:`Install and Configure ODBC on Windows`. + +#. Launch the TIBCO Spotfire application. + + :: + +#. From the **File** menu click **Add Data Tables**. + + The **Add Database Tables** window is displayed. + +#. Click **Add** and select **Database**. + + The **Open Database** window is displayed. + +#. In the **Data source type** area, select **ODBC SQream** (Odbc Data Provider) and click **Configure**. + + The **Configure Data Source and Connection** window is displayed. + +#. Select **System or user data source** and from the drop-down menu select the DSN of your data source (SQreamDB). + + :: + +#. Provide your database username and password and click **OK**. + + :: + +#. In the **Open Database** window, click **OK**. + + The **Specify Tables and Columns** window is displayed. + +#. In the **Specify Tables and Columns** window, select the checkboxes corresponding to the tables and columns that you want to include in your SQL statement. + + :: + +#. In the **Data source name** field, set your data source name and click **OK**. + + Your data source is displayed in the **Data tables** area. + +#. In the **Add Data Tables** dialog, click **OK** to load the data from your ODBC data source into Spotfire. + +.. note:: Verify that you have checked the SQL statement. + +Creating the SQream Data Source Template +~~~~~~~~~~~ +After creating a connection, you can create your SQream data source template. + +**To create your SQream data source template:** + +1. Log in to the TIBCO Spotfire Server Configuration Tool. + + :: + +#. From the **Configuration** tab, in the **Configuration Start** menu, click **Data Source Templates**. + + The **Data Source Templates** list is displayed. + +#. From the Data Source Templates list do one of the following: + + * Override an existing template: + + 1. In the template text field, select an existing template. + + :: + + 2. Copy and paste your data source template text. + + :: + + * Create a new template: + + 1. Click **New**. + + The **Add Data Source Template** window is displayed. + + .. _creating_sqream_data_source_template: + + 2. In the **Name** field, define your template name. + + :: + + 3. In the **Data Source Template** text field, copy and paste your data source template text. + + The following is an example of a data source template: + + .. code-block:: console + + + SQream + com.sqream.jdbc.SQDriver + jdbc:Sqream://<host>:<port>/database;user=sqream;password=sqream;cluster=true + true + true + false + TABLE,EXTERNAL_TABLE + + + Bool + Integer + + + VARCHAR(2048) + String + + + INT + Integer + + + BIGINT + LongInteger + + + Real + Real + + + Decimal + Float + + + Numeric + Float + + + Date + DATE + + + DateTime + DateTime + + + + + +4. Click **Save configuration**. + + :: + +5. Close and restart your Spotfire server. + +Creating a Data Source +~~~~~~~~~~~ +After creating the SQream data source template, you can create a data source. + +**To create a data source:** + +1. Launch the TIBCO Spotfire application. + + :: + +#. From the **Tools** menu, select **Information Designer**. + + The **Information Designer** window is displayed. + + :: + +#. From the **New** menu, click **Data Source**. + + The **Data Source** tab is displayed. + + :: + +#. Provide the following information: + + * **Name** - define a unique name. + + :: + + * **Type** - use the same type template name you used while configuring your template. See **Step 3** in :ref:`Creating the SQream Data Source Template`. + + :: + + * **Connection URL** - use the standard JDBC connection string, ``:/database``. + + :: + + * **No. of connections** - define a number between **1** and **100**. SQream recommends setting your number of connections to **100**. + + :: + + * **Username and Password** - define your SQream username and password. + +Creating an Information Link +~~~~~~~~~~~ +After creating a data source, you can create an information link. + +**To create an information link**: + +1. From the **Tools** menu, select **Information Designer**. + + The **Information Designer** window is displayed. + + :: + +#. From the **New** menu, click **Information Link**. + + The **Information link** tab is displayed. + +#. From the **Elements** tab, select a column type and click **Add**. + + The column type is added to the **Elements** region as a filter. + + Note the following: + + * You can select procedures from the Elements region. + + :: + + * You can remove an element by selecting an element and clicking **Remove**. + + .. tip:: If the Elements menu is not displayed, you can display it by clicking the **Elements** tab. You can simultaneously select multiple elements by pressing **Ctrl** and making additional selections, and select a range of elements by holding **Shift** and clicking two elements. + +#. If the elements you select originate from more than one data source table, specify a **Join path**. + +5. *Optional* - In the **Description** region, type the description of the information link. + + :: + +#. *Optional* - To filter your data, expand the **Filters** section and do the following: + + 1. From the **Information Link** region, select the element you added in Step 3 above. + + :: + + 2. Click **Add**. + + The **Add Column** window is displayed. + + 3. From the drop-down list, select a column to add a hard filter to and click **OK**. + + The selected column is added to the Filters list. + + 4. Repeat steps 2 and 3 to add filters to additional columns. + + :: + + 5. For each column, from the **Filter Type** drop-down list, select **range** or **values**. + + .. note:: Filtering by range means entering the upper and lower limits of the desired range. Filtering by values means entering the exact values that you want to include in the returned data, separated by semicolon. + + 6. In the **Values** field type the desired values separated with semicolons, or set the upper and lower limits in the **Min Value** and **Max Value** fields. Alternatively, you can type ``?param_name`` in the Values field to use a parameter as the filter for the selected column, where ``param_name`` is the name used to identify the parameter. + + .. note:: Because limits are inclusive, setting the lower limit to **1000** includes the value **1000** in the data table. + + .. note:: When setting upper and lower limits on **String** type columns, ``A`` precedes ``AA``, and a lone letter precedes words beginning with that latter. For example, ``S** precedes **Smith**, indicating that the name ``Smith`` will not be present when you select names from ``D`` to ``S``. The order of characters is standard ASCII. + + For more information on adding filters, see `Adding Hard Filters `_. + +7. *Optional* - To add runtime filtering prompts, expand the **Prompts** section and do the following: + + 1. Click **Add**. + + The **Add Column** window is displayed. + + #. From the **Select column** list, select a column to add a prompt to and click **OK**. + + The selected column is added to the Prompts list. + + #. Repeat **Step 1** to add prompts to additional columns. + + :: + + #. Do the following for each column: + + * Make a selection from the **Prompt Type** drop-down list. + * Select or clear **Mandatory**. + * *Optional* - Set your **Max Selections**. + + For more information on adding prompts, see `Adding Prompts `_. + +8. *Optional* - Expand the **Conditioning** section and specify one of the following conditions: + + * None + * Distinct + * Pivot + + Note that you can edit the Pivot conditioning by selecting **Pivot** and clicking **Edit**. + +9. *Optional* - Expand the **Parameters** section and define your parameters. + + :: + +10. *Optional* - Expand the **Properties** section and define your properties. + + :: + +11. *Optional* - Expand the **Caching** section and enable or disable whether your information link can be cached. + + :: + +12. Click **Save**. + + The **Save As** window is displayed. + +13. In the tree, select where you want to save the information link. + + :: + +14. In the **Name** field, type a name and description for the information link. + + :: + + +15. Click **Save**. + + The new information link is added to the library and can be accessed by other users. + +.. tip:: You can test the information link directly by clicking **Open Data**. You can also view and edit the SQL belonging to the information link by clicking **SQL**. + +For more information on the Information Link attributes, see `Information Link Tab `_. + +Troubleshooting +------------- +The **Troubleshooting** section describes the following scenarios: + +.. contents:: + :local: + :depth: 1 + +The JDBC Driver does not Support Boolean, Decimal, or Numeric Types +~~~~~~~~~~~ +When attempting to load data, the the Boolean, Decimal, or Numeric column types are not supported and generate the following error: + +.. code-block:: console + + Failed to execute query: Unsupported JDBC data type in query result: Bool (HRESULT: 80131500) + +The error above is resolved by casting the columns as follows: + +* ``Bool`` columns to ``INT``. +* ``Decimal`` and ``Numeric`` columns to ``REAL``. + +For more information, see the following: + +* **Resolving this error** - `Details on Change Data Types `_. + +* **Supported data types** - :ref:`Data Types`. + +Information Services do not Support Live Queries +~~~~~~~~~~~ +TIBCO Spotfire data connectors support live queries, but no APIs currently exist for creating custom data connectors. This is resolved by creating a customized SQream adapter using TIBCO's **Data Virtualization (TDV)** or the **Spotfire Advanced Services (ADS)**. These can be used from the built-in TDV connector to enable live queries. + +This resolution applies to JDBC and ODBC drivers. \ No newline at end of file diff --git a/connecting_to_sqream/index.rst b/connecting_to_sqream/index.rst index a790f085d..ecb9e4715 100644 --- a/connecting_to_sqream/index.rst +++ b/connecting_to_sqream/index.rst @@ -1,4 +1,4 @@ -.. _third_party_tools: +.. _connecting_to_sqream: ************************* Connecting to SQream @@ -12,6 +12,7 @@ This section provides information about the following third party tools: :glob: :titlesonly: + client_platforms/index client_drivers/index If you need a tool that SQream does not support, contact SQream Support or your SQream account manager for more information. \ No newline at end of file From e46f40bc2d874b9de4a13f7aea69f2a197db2663 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Wed, 20 Jul 2022 15:02:18 +0300 Subject: [PATCH 130/882] Fixed links (changed to 2022.1) --- .../client_platforms/informatica.rst | 2 +- .../client_platforms/microstrategy.rst | 2 +- connecting_to_sqream/client_platforms/php.rst | 2 +- connecting_to_sqream/client_platforms/power_bi.rst | 6 +++--- connecting_to_sqream/client_platforms/sas_viya.rst | 4 ++-- .../client_platforms/sql_workbench.rst | 14 ++++++++------ connecting_to_sqream/client_platforms/tableau.rst | 2 +- connecting_to_sqream/client_platforms/talend.rst | 2 +- 8 files changed, 18 insertions(+), 16 deletions(-) diff --git a/connecting_to_sqream/client_platforms/informatica.rst b/connecting_to_sqream/client_platforms/informatica.rst index 6bc50b22a..ec39a0129 100644 --- a/connecting_to_sqream/client_platforms/informatica.rst +++ b/connecting_to_sqream/client_platforms/informatica.rst @@ -143,7 +143,7 @@ After establishing a connection between SQream and Informatica you can establish 2. In the **JDBC_IC Connection Properties** section, in the **JDBC Connection URL** field, establish a JDBC connection by providing the correct connection string. - For connection string examples, see `Connection Strings `_. + For connection string examples, see `Connection Strings `_. :: diff --git a/connecting_to_sqream/client_platforms/microstrategy.rst b/connecting_to_sqream/client_platforms/microstrategy.rst index 6cad19be2..370312a0d 100644 --- a/connecting_to_sqream/client_platforms/microstrategy.rst +++ b/connecting_to_sqream/client_platforms/microstrategy.rst @@ -54,7 +54,7 @@ Connecting a Data Source :: -2. Download the most current version of the `SQream JDBC driver `_. +2. Download the most current version of the `SQream JDBC driver `_. :: diff --git a/connecting_to_sqream/client_platforms/php.rst b/connecting_to_sqream/client_platforms/php.rst index 2310fde6b..ebb2c796f 100644 --- a/connecting_to_sqream/client_platforms/php.rst +++ b/connecting_to_sqream/client_platforms/php.rst @@ -16,7 +16,7 @@ Installing PHP ------------------- **To install PHP:** -1. Download the JDBC driver installer from the `SQream Drivers page `_. +1. Download the JDBC driver installer from the `SQream Drivers page `_. :: diff --git a/connecting_to_sqream/client_platforms/power_bi.rst b/connecting_to_sqream/client_platforms/power_bi.rst index c088db851..1cdf7c81b 100644 --- a/connecting_to_sqream/client_platforms/power_bi.rst +++ b/connecting_to_sqream/client_platforms/power_bi.rst @@ -22,7 +22,7 @@ SQream integrates with Power BI Desktop to do the following: SQream uses Power BI for extracting data sets using the following methods: -* **Direct query** - Direct queries lets you connect easily with no errors, and refreshes Power BI artifacts, such as graphs and reports, in a considerable amount of time in relation to the time taken for queries to run using the `SQream SQL CLI Reference guide `_. +* **Direct query** - Direct queries lets you connect easily with no errors, and refreshes Power BI artifacts, such as graphs and reports, in a considerable amount of time in relation to the time taken for queries to run using the `SQream SQL CLI Reference guide `_. :: @@ -52,7 +52,7 @@ Installing Power BI Desktop 2. Download and configure your ODBC driver. - For more information about configuring your ODBC driver, see `ODBC `_. + For more information about configuring your ODBC driver, see `ODBC `_. 3. Navigate to **Windows** > **Documents** and create a folder called **Power BI Desktop Custom Connectors**. @@ -140,4 +140,4 @@ SQream supports the following SQream driver versions: Related Information ------------------- -For more information, see the `Glossary `_. \ No newline at end of file +For more information, see the `Glossary `_. \ No newline at end of file diff --git a/connecting_to_sqream/client_platforms/sas_viya.rst b/connecting_to_sqream/client_platforms/sas_viya.rst index 83942ccfd..ef4a338a4 100644 --- a/connecting_to_sqream/client_platforms/sas_viya.rst +++ b/connecting_to_sqream/client_platforms/sas_viya.rst @@ -32,7 +32,7 @@ The SQream JDBC driver is required for establishing a connection between SAS Viy **To install the JDBC driver:** -#. Download the `JDBC driver `_. +#. Download the `JDBC driver `_. :: @@ -59,7 +59,7 @@ After installing the JDBC driver, you must configure the JDBC driver from the SA .. literalinclude:: connect3.sas :language: php -For more information about writing a connection string, see **Connect to SQream DB with a JDBC Application** and navigate to `Connection String `_. +For more information about writing a connection string, see **Connect to SQream DB with a JDBC Application** and navigate to `Connection String `_. Operating SAS Viya -------------------- diff --git a/connecting_to_sqream/client_platforms/sql_workbench.rst b/connecting_to_sqream/client_platforms/sql_workbench.rst index 16265ebd4..a5f7e8871 100644 --- a/connecting_to_sqream/client_platforms/sql_workbench.rst +++ b/connecting_to_sqream/client_platforms/sql_workbench.rst @@ -11,8 +11,9 @@ This tutorial is a guide that will show you how to connect SQL Workbench to SQre .. contents:: In this topic: :local: -Installing SQL Workbench with the SQream DB installer (Windows only) +Installing SQL Workbench with the SQream Installer ===================================================================== +This section applies to Windows only. SQream DB's driver installer for Windows can install the Java prerequisites and SQL Workbench for you. @@ -33,8 +34,9 @@ SQream DB's driver installer for Windows can install the Java prerequisites and You are now ready to create a profile for your cluster. Continue to :ref:`Creating a new connection profile `. -Installing SQL Workbench manually (Linux, MacOS) +Installing SQL Workbench Manually =================================================== +This section applies to Linux and MacOS only. Install Java Runtime ------------------------ @@ -51,7 +53,7 @@ For Linux and BSD, see https://openjdk.java.net/install/ For Windows, SQream recommends Zulu 8 https://www.azul.com/downloads/zulu-community/?&version=java-8-lts&architecture=x86-64-bit&package=jdk -Get the SQream DB JDBC driver +Get the SQream DB JDBC Driver ------------------------------- SQream DB's JDBC driver is provided as a zipped JAR file, available for download from the `SQream Drivers page `_. @@ -67,7 +69,7 @@ Install SQL Workbench #. Start SQL workbench. If you are using 64 bit windows, run ``SQLWorkbench64.exe`` instead of ``SQLWOrkbench.exe``. -Setting up the SQream DB JDBC driver profile +Setting up the SQream DB JDBC Driver Profile --------------------------------------------- #. Define a connection profile - :menuselection:`&File --> &Connect window (Alt+C)` @@ -100,7 +102,7 @@ Setting up the SQream DB JDBC driver profile .. _new_connection_profile: -Create a new connection profile for your cluster +Create a New Connection Profile for Your Cluster ===================================================== .. image:: /_static/images/sql_workbench_connection_profile.png @@ -117,7 +119,7 @@ Create a new connection profile for your cluster #. Click OK to save the connection profile and connect to SQream DB -Suggested optional configuration +Suggested Optional Configuration ================================== If you installed SQL Workbench manually, you can set a customization to help SQL Workbench show information correctly in the DB Explorer panel. diff --git a/connecting_to_sqream/client_platforms/tableau.rst b/connecting_to_sqream/client_platforms/tableau.rst index ac67c8d55..3c08ebe83 100644 --- a/connecting_to_sqream/client_platforms/tableau.rst +++ b/connecting_to_sqream/client_platforms/tableau.rst @@ -48,7 +48,7 @@ If you are using Windows, after installing the Tableau Desktop application you c :: -#. Download the most current version of the `SQream JDBC driver `_. +#. Download the most current version of the `SQream JDBC driver `_. :: diff --git a/connecting_to_sqream/client_platforms/talend.rst b/connecting_to_sqream/client_platforms/talend.rst index 2a4d2658a..fc16441b9 100644 --- a/connecting_to_sqream/client_platforms/talend.rst +++ b/connecting_to_sqream/client_platforms/talend.rst @@ -194,7 +194,7 @@ Download Links The following is a list of download links relevant to the Talend connector: * `Talend Open Studio for Big Data `_ -* `Latest version of SQream JDBC `_ +* `Latest version of SQream JDBC `_ :ref:`Back to top ` From c3c7b867b6b326af44b2fe48254527707473b3d9 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 21 Jul 2022 11:52:03 +0300 Subject: [PATCH 131/882] Updated Talend with Yotam --- .../client_platforms/talend.rst | 183 +++++------------- 1 file changed, 51 insertions(+), 132 deletions(-) diff --git a/connecting_to_sqream/client_platforms/talend.rst b/connecting_to_sqream/client_platforms/talend.rst index fc16441b9..1aefe8917 100644 --- a/connecting_to_sqream/client_platforms/talend.rst +++ b/connecting_to_sqream/client_platforms/talend.rst @@ -4,201 +4,120 @@ Connecting to SQream Using Talend ************************* -.. _top: - Overview -================= - -This page describes how to use Talend to interact with a SQream DB cluster. The Talend connector is used for reading data from a SQream DB cluster and loading data into SQream DB. - -In addition, this page provides a viability report on Talend's comptability with SQream DB for stakeholders. - -It includes the following: - -* :ref:`A Quick Start guide ` -* :ref:`Information about supported SQream drivers ` -* :ref:`Supported data sources ` and :ref:`tool and operating system versions ` -* :ref:`A description of known issues ` -* :ref:`Related links ` - - -About Talend -================= -Talend is an open-source data integration platform. It provides various software and services for Big Data integration and management, enterprise application integration, data quality and cloud storage. +================= +This page describes how to use Talend to interact with a SQream cluster. The Talend connector is used for reading data from a SQream cluster and loading data into SQream. In addition, this page provides a viability report on Talend's comptability with SQream for stakeholders. -For more information about Talend, see `Talend `_. +The **Connecting to SQream Using Talend** describes the following: - -.. _quickstart_guide: - -Quick Start Guide -======================= +.. contents:: + :local: + :depth: 1 Creating a New Metadata JDBC DB Connection -------------- +---------------- **To create a new metadata JDBC DB connection:** 1. In the **Repository** panel, nagivate to **Metadata** and right-click **Db connections**. -.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_1.png - + :: + 2. Select **Create connection**. -.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_2.png - + :: + 3. In the **Name** field, type a name. -.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_3.png + :: -The name cannot contain spaces. + Note that the name cannot contain spaces. -4. In the **Purpose** field, type a purpose and click **Next**. You cannot go to the next step until you define both a Name and a Purpose. +4. In the **Purpose** field, type a purpose and click **Next**. -.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_4.png + Note that you cannot continue to the next step until you define both a Name and a Purpose. + + :: 5. In the **DB Type** field, select **JDBC**. -.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_5.png + :: 6. In the **JDBC URL** field, type the relevant connection string. - For connection string examples, see `Connection Strings `_. + For connection string examples, see `Connection Strings `_. -.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_6.png - 7. In the **Drivers** field, click the **Add** button. - The **"newLine** entry is added. - -.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_7.png - -8. One the **"newLine** entry, click the ellipsis. + The **"newLine"** entry is added. -.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_8.png +8. One the **"newLine'** entry, click the ellipsis. -The **Module** window is displayed. + The **Module** window is displayed. 9. From the Module window, select **Artifact repository(local m2/nexus)** and select **Install a new module**. -.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_9.png + :: 10. Click the ellipsis. -.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_9.5.png + Your hard drive is displayed. -Your hard drive is displayed. +11. Navigate to a **JDBC jar file** (such as **sqream-jdbc-4.5.3.jar**)and click **Open**. -11. Navigate to a **JDBC jar file** (such as **sqream-jdbc-4.4.0.jar**)and click **Open**. - -.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_10.png + :: 12. Click **Detect the module install status**. -.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_11.5.png + :: 13. Click **OK**. -The JDBC that you selected is displayed in the **Driver** field. - -.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_12.png + The JDBC that you selected is displayed in the **Driver** field. 14. Click **Select class name**. -.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_13.png + :: 15. Click **Test connection**. -.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_14.png - -If a driver class is not found (for example, you didn't select a JDBC jar file), the following error message is displayed: + If a driver class is not found (for example, you didn't select a JDBC jar file), the following error message is displayed: -.. image:: /_static/images/Third_Party_Connectors/Creating_a_New_Metadata_JDBC_DB_Connection_15.png + After creating a new metadata JDBC DB connection, you can do the following: -After creating a new metadata JDBC DB connection, you can do the following: - - * Use your new metadata connection. - * Drag it to the **job** screen. - * Build Talend components. + * Use your new metadata connection. + + :: + + * Drag it to the **job** screen. + + :: + + * Build Talend components. -For more information on loading data from JSON files to the Talend Open Studio, see `How to Load Data from JSON Files in Talend `_. - -:ref:`Back to top ` + For more information on loading data from JSON files to the Talend Open Studio, see `How to Load Data from JSON Files in Talend `_. -.. _supported_sqream_drivers: - Supported SQream Drivers -================ - +---------------- The following list shows the supported SQream drivers and versions: * **JDBC** - Version 4.3.3 and higher. -* **ODBC** - Version 4.0.0. This version requires a Bridge to connect. For more information on the required Bridge, see `Connecting Talend on Windows to an ODBC Database `_. -:ref:`Back to top ` - - -.. _supported_data_sources: + :: + +* **ODBC** - Version 4.0.0. This version requires a Bridge to connect. For more information on the required Bridge, see `Connecting Talend on Windows to an ODBC Database `_. Supported Data Sources -============================ +---------------- Talend Cloud connectors let you create reusable connections with a wide variety of systems and environments, such as those shown below. This lets you access and read records of a range of diverse data. * **Connections:** Connections are environments or systems for storing datasets, including databases, file systems, distributed systems and platforms. Because these systems are reusable, you only need to establish connectivity with them once. -* **Datasets:** Datasets include database tables, file names, topics (Kafka), queues (JMS) and file paths (HDFS). For more information on the complete list of connectors and datasets that Talend supports, see `Introducing Talend Connectors `_. - -:ref:`Back to top ` - - -.. _supported_tools_os_sys_versions: - -Supported Tool and Operating System Versions -====================== -Talend was tested using the following: - -* Talend version 7.4.1M6 -* Windows 10 -* SQream version 2021.1 -* JDBC version - - - - -:ref:`Back to top ` - + :: -.. _known_issues: +* **Datasets:** Datasets include database tables, file names, topics (Kafka), queues (JMS) and file paths (HDFS). For more information on the complete list of connectors and datasets that Talend supports, see `Introducing Talend Connectors `_. Known Issues -=========================== -The the list below describes the following known issues as of 6/1/2021: - -* Schemas not displayed for tables with identical names. - -:ref:`Back to top ` - - -.. _related_links: - -Related Links -=============== -The following is a list of links relevant to the Talend connector: +---------------- +As of 6/1/2021 schemas were not displayed for tables with identical names. -* `Talend Home page `_ -* `Talend Community page `_ -* `Talend BugTracker `_ - - -Download Links -================== -The following is a list of download links relevant to the Talend connector: - -* `Talend Open Studio for Big Data `_ -* `Latest version of SQream JDBC `_ - -:ref:`Back to top ` - - - -.. contents:: In this topic: - :local: +If you experience issues using Talend, see the `SQream support portal `_. \ No newline at end of file From da777d3fdaff938683c7ed3b58d34853eda2132c Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 21 Jul 2022 11:54:47 +0300 Subject: [PATCH 132/882] Updated with Yotam --- connecting_to_sqream/client_platforms/talend.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/connecting_to_sqream/client_platforms/talend.rst b/connecting_to_sqream/client_platforms/talend.rst index 1aefe8917..7f11092fb 100644 --- a/connecting_to_sqream/client_platforms/talend.rst +++ b/connecting_to_sqream/client_platforms/talend.rst @@ -44,7 +44,7 @@ Creating a New Metadata JDBC DB Connection 6. In the **JDBC URL** field, type the relevant connection string. - For connection string examples, see `Connection Strings `_. + For connection string examples, see `Connection Strings `_. 7. In the **Drivers** field, click the **Add** button. From e61fc4053407a30e2ef361c66e48247bd98ac766 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 21 Jul 2022 11:59:29 +0300 Subject: [PATCH 133/882] Added Talend to index --- connecting_to_sqream/client_platforms/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/connecting_to_sqream/client_platforms/index.rst b/connecting_to_sqream/client_platforms/index.rst index a5a3f5166..19f929067 100644 --- a/connecting_to_sqream/client_platforms/index.rst +++ b/connecting_to_sqream/client_platforms/index.rst @@ -31,7 +31,7 @@ If you are looking for a tool that is not listed, SQream and our partners can he informatica r php - xxtalend + talend xxdiagnosing_common_connectivity_issues .. image:: /_static/images/connectivity_ecosystem.png From 0f1264ea356b718d39b318fb4a23a303917b41ab Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 21 Jul 2022 12:16:38 +0300 Subject: [PATCH 134/882] Alphabetized --- connecting_to_sqream/client_platforms/index.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/connecting_to_sqream/client_platforms/index.rst b/connecting_to_sqream/client_platforms/index.rst index 19f929067..a38f1f1f5 100644 --- a/connecting_to_sqream/client_platforms/index.rst +++ b/connecting_to_sqream/client_platforms/index.rst @@ -21,17 +21,17 @@ If you are looking for a tool that is not listed, SQream and our partners can he :caption: In this section: :titlesonly: + informatica + microstrategy + pentaho + php power_bi - tibco_spotfire + r sas_viya sql_workbench tableau - pentaho - microstrategy - informatica - r - php talend + tibco_spotfire xxdiagnosing_common_connectivity_issues .. image:: /_static/images/connectivity_ecosystem.png From 3366ab3ecd7753351d9d754e7db193ad057582aa Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 21 Jul 2022 12:48:57 +0300 Subject: [PATCH 135/882] Update tableau.rst --- .../client_platforms/tableau.rst | 310 +++--------------- 1 file changed, 40 insertions(+), 270 deletions(-) diff --git a/connecting_to_sqream/client_platforms/tableau.rst b/connecting_to_sqream/client_platforms/tableau.rst index 3c08ebe83..01f90bbb4 100644 --- a/connecting_to_sqream/client_platforms/tableau.rst +++ b/connecting_to_sqream/client_platforms/tableau.rst @@ -1,4 +1,4 @@ -.. _connect_to_tableau: +.. _tableau: ************************* Connecting to SQream Using Tableau @@ -8,7 +8,7 @@ Overview ===================== SQream's Tableau connector plugin, based on standard JDBC, enables storing and fast querying large volumes of data. -The **Connecting to SQream Using Tableau** page is a Quick Start Guide that describes how install Tableau and the JDBC and ODBC drivers and connect to SQream using the JDBC and ODBC drivers for data analysis. It also describes using best practices and troubleshoot issues that may occur while installing Tableau. SQream supports both Tableau Desktop and Tableau Server on Windows, MacOS, and Linux distributions. +The **Connecting to SQream Using Tableau** page is a Quick Start Guide that describes how install Tableau and the JDBC driver and connect to SQream for data analysis. It also describes using best practices and troubleshoot issues that may occur while installing Tableau. SQream supports both Tableau Desktop and Tableau Server on Windows, MacOS, and Linux distributions. For more information on SQream's integration with Tableau, see `Tableau's Extension Gallery `_. @@ -16,295 +16,75 @@ The Connecting to SQream Using Tableau page describes the following: .. contents:: :local: + :depth: 1 Installing the JDBC Driver and Tableau Connector Plugin ------------------- This section describes how to install the JDBC driver using the fully-integrated Tableau connector plugin (Tableau Connector, or **.taco** file). SQream has been tested with Tableau versions 9.2 and newer. -**To connect to SQream using Tableau:** - -#. Install the Tableau Desktop application. - - For more information about installing the Tableau Desktop application, see the `Tableau products page `_ and click **Download Free Trial**. Note that Tableau offers a 14-day trial version. - - :: +You can connect to SQream using Tableau by doing one of the following: -#. Do one of the following: - - * **For Windows** - See :ref:`Installing Tableau Using the Windows Installer `. * **For MacOS or Linux** - See :ref:`Installing the JDBC Driver Manually `. -.. note:: For Tableau **2019.4 versions and later**, SQream recommends installing the JDBC driver instead of the previously recommended ODBC driver. - -.. _tableau_windows_installer: - -Installing the JDBC Driver Using the Windows Installer -~~~~~~~~~~~~~~~~~~ -If you are using Windows, after installing the Tableau Desktop application you can install the JDBC driver using the Windows installer. The Windows installer is an installation wizard that guides you through the JDBC driver installation steps. When the driver is installed, you can connect to SQream. - -**To install Tableau using the Windows installer**: - -#. Close Tableau Desktop. - - :: - -#. Download the most current version of the `SQream JDBC driver `_. - - :: - -#. Do the following: - - #. Start the installer. - #. Verify that the **Tableau Desktop connector** item is selected. - #. Follow the installation steps. - - :: - -You can now restart Tableau Desktop or Server to begin using the SQream driver by :ref:`connecting to SQream `. - -.. _tableau_jdbc_installer: + :: -Installing the JDBC Driver Manually + * **For Windows** - See :ref:`Installing Tableau Using the Windows Installer `. + +Installing the JDBC Driver ~~~~~~~~~~~~~ If you are using MacOS, Linux, or the Tableau server, after installing the Tableau Desktop application you can install the JDBC driver manually. When the driver is installed, you can connect to SQream. -**To install the JDBC driver manually:** +**To install the JDBC driver:** 1. Download the JDBC installer and SQream Tableau connector (.taco) file from the :ref:`from the client drivers page`. :: -#. Install the JDBC driver by unzipping the JDBC driver into a Tableau driver directory. - - Based on the installation method that you used, your Tableau driver directory is located in one of the following places: +2. Based on your operating system, your Tableau driver directory is located in one of the following places: - * **Tableau Desktop on Windows:** *C:\\Program Files\\Tableau\\Drivers* * **Tableau Desktop on MacOS:** *~/Library/Tableau/Drivers* - * **Tableau on Linux**: */opt/tableau/tableau_driver/jdbc* - -.. note:: If the driver includes only a single .jar file, copy it to *C:\\Program Files\\Tableau/Drivers*. If the driver includes multiple files, create a subfolder *A* in *C:\\Program Files\\Tableau/Drivers* and copy all files to folder *A*. - -Note the following when installing the JDBC driver: - -* You must have read permissions on the .jar file. -* Tableau requires a JDBC 4.0 or later driver. -* Tableau requires a Type 4 JDBC driver. -* The latest 64-bit version of Java 8 is installed. - -3. Install the **SQreamDB.taco** file by moving the SQreamDB.taco file into the Tableau connectors directory. - - Based on the installation method that you used, your Tableau driver directory is located in one of the following places: - - * **Tableau Desktop on Windows:** *C:\\Users\\\\My Tableau Repository\\Connectors* - * **Tableau Desktop on Mac:** *~/My Tableau Repository/Connectors* :: -4. *Optional* - If you are using the Tableau Server, do the following: - - 1. Create a directory for Tableau connectors and give it a descriptive name, such as *C:\\tableau_connectors*. - - This directory needs to exist on all Tableau servers. - - :: - - 2. Copy the SQreamDB.taco file into the new directory. - - :: - - 3. Set the **native_api.connect_plugins_path** option to ``tsm`` as shown in the following example: - - .. code-block:: console - - $ tsm configuration set -k native_api.connect_plugins_path -v C:/tableau_connectors + * **Tableau Desktop on Windows:** *C:\\Program Files\\Tableau\\Drivers* - If a configuration error is displayed, add ``--force-keys`` to the end of the command as shown in the following example: - - .. code-block:: console + :: - $ tsm configuration set -k native_api.connect_plugins_path -v C:/tableau_connectors--force-keys - - 4. To apply the pending configuration changes, run the following command: - - .. code-block:: console - - $ tsm pending-changes apply - - .. warning:: This restarts the server. - -You can now restart Tableau Desktop or Server to begin using the SQream driver by :ref:`connecting to SQream ` as described in the section below. - -.. _tableau_connect_to_sqream: - - -Installing the ODBC Driver for Tableau Versions 2019.3 and Earlier --------------- - - -This section describes the installation method for Tableau version 2019.3 or earlier and describes the following: - -.. contents:: - :local: - -.. note:: SQream recommends installing the JDBC driver to provide improved connectivity. - -Automatically Reconfiguring the ODBC Driver After Initial Installation -~~~~~~~~~~~~~~~~~~ -If you've already installed the SQream ODBC driver and installed Tableau, SQream recommends reinstalling the ODBC driver with the **.TDC Tableau Settings for SQream DB** configuration shown in the image below: - -.. image:: /_static/images/odbc_windows_installer_tableau.png - -SQream recommends this configuration because Tableau creates temporary tables and runs several discovery queries that may impact performance. The ODBC driver installer avoids this by automatically reconfiguring Tableau. - -For more information about reinstalling the ODBC driver installer, see :ref:`Install and Configure ODBC on Windows `. - -If you want to manually reconfigure the ODBC driver, see :ref:`Manually Reconfiguring the ODBC Driver After Initial Installation ` below. - -.. _manually_reconfigure_odbc_driver: - -Manually Reconfiguring the ODBC Driver After Initial Installation -~~~~~~~~~~~~~~~~~~ -The file **Tableau Datasource Customization (TDC)** file lets you use Tableau make full use of SQream DB's features and capabilities. - -**To manually reconfigure the ODBC driver after initial installation:** - -1. Do one of the following: + * **Tableau on Linux**: */opt/tableau/tableau_driver/jdbc* + + Note the following when installing the JDBC driver: - 1. Download the :download:`odbc-sqream.tdc ` file to your machine and open it in a text editor. + * You must have read permissions on the .jar file. - :: + :: + + * Tableau requires a JDBC 4.0 or later driver. - 2. Copy the text below into a text editor: + :: + + * Tableau requires a Type 4 JDBC driver. - .. literalinclude:: odbc-sqream.tdc - :language: xml - :caption: SQream ODBC TDC File - :emphasize-lines: 2 - -#. Check which version of Tableau you are using. - - :: - -#. In the text of the file shown above, in the highlighted line, replace the version number with the **major** version of Tableau that you are using. - - For example, if you are using Tableau vesion **2019.2.1**, replace it with **2019.2**. - - :: - -#. Do one of the following: - - * If you are using **Tableau Desktop** - save the TDC file to *C:\\Users\\\\Documents\\My Tableau Repository\\Datasources*, where ```` is the Windows username that you have installed Tableau under. - - :: - - * If you are using the **Tableau Server** - save the TDC file to *C:\\ProgramData\\Tableau\\Tableau Server\\data\\tabsvc\\vizqlserver\\Datasources*. - -Configuring the ODBC Connection -~~~~~~~~~~~~ -The ODBC connection uses a DSN when connecting to ODBC data sources, and each DSN represents one SQream database. - -**To configure the ODBC connection:** - -1. Create an ODBC DSN. - - :: - -#. Open the Windows menu by pressing the Windows button (:kbd:`⊞ Win`) or clicking the **Windows** menu button. - - :: - -#. Type **ODBC** and select **ODBC Data Sources (64-bit)**. + :: + + * The latest 64-bit version of Java 8 is installed. - During installation, the installer created a sample user DSN named **SQreamDB**. - - :: +3. Install the **SQreamDB.taco** file by moving the SQreamDB.taco file into the Tableau connectors directory. -#. *Optional* - Do one or both of the following: + Based on the installation method that you used, your Tableau driver directory is located in one of the following places: - * Modify the DSN name. + * **Tableau Desktop on Windows:** *C:\\Users\\\\My Tableau Repository\\Connectors* :: - - * Create a new DSN name by clicking **Add** and selecting **SQream ODBC Driver**. - -.. image:: /_static/images/odbc_windows_dsns.png - -5. Click **Finish**. + * **Tableau Desktop on MacOS:** *~/My Tableau Repository/Connectors* - :: +You can now restart Tableau Desktop or Server to begin using the SQream driver by connecting to SQream as described in the section below. -6. Enter your connection parameters. - - The following table describes the connection parameters: - - .. list-table:: - :widths: 15 38 38 - :header-rows: 1 - - * - Item - - Description - - Example - * - Data Source Name - - The Data Source Name. SQream recommends using a descriptive and easily recognizable name for referencing your DSN. Once set, the Data Source Name cannot be changed. - - - * - Description - - The description of your DSN. This field is optional. - - - * - User - - The username of a role to use for establishing the connection. - - ``rhendricks`` - * - Password - - The password of the selected role. - - ``Tr0ub4dor`` - * - Database - - The database name to connect to. For example, ``master`` - - ``master`` - * - Service - - The :ref:`service queue` to use. - - For example, ``etl``. For the default service ``sqream``, leave blank. - * - Server - - The hostname of the SQream worker. - - ``127.0.0.1`` or ``sqream.mynetwork.co`` - * - Port - - The TCP port of the SQream worker. - - ``5000`` or ``3108`` - * - User Server Picker - - Uses the load balancer when establishing a connection. Use only if exists, and check port. - - - * - SSL - - Uses SSL when establishing a connection. - - - * - Logging Options - - Lets you modify your logging options when tracking the ODBC connection for connection issues. - - - -.. tip:: Test the connection by clicking **Test** before saving your DSN. - -7. Save the DSN by clicking **OK.** - -Connecting Tableau to SQream -~~~~~~~~~~~~ -**To connect Tableau to SQream:** - -1. Start Tableau Desktop. - - :: - -#. In the **Connect** menu, in the **To a server** sub-menu, click **More Servers** and select **Other Databases (ODBC)**. - - The **Other Databases (ODBC)** window is displayed. - - :: - -#. In the Other Databases (ODBC) window, select the DSN that you created in :ref:`Setting Up SQream Tables as Data Sources `. - - Tableau may display the **Sqream ODBC Driver Connection Dialog** window and prompt you to provide your username and password. +.. _tableau_windows_installer: -#. Provide your username and password and click **OK**. - -.. _tableau_connect_to_sqream_db: +.. _tableau_jdbc_installer: +.. _tableau_connect_to_sqream: Connecting to SQream --------------------- @@ -362,10 +142,7 @@ After installing the JDBC driver you can connect to SQream. - The connection is established and the data source page is displayed. - -.. tip:: - Tableau automatically assigns your connection a default name based on the DSN and table. SQream recommends giving the connection a more descriptive name. - + .. _set_up_sqream_tables_as_data_sources: Setting Up SQream Tables as Data Sources @@ -388,9 +165,6 @@ After connecting to SQream you must set up the SQream tables as data sources. #. Open a new sheet to analyze data. -.. tip:: - For more information about configuring data sources, joining, filtering, see Tableau's `Set Up Data Sources `_ tutorials. - Tableau Best Practices and Troubleshooting --------------- This section describes the following best practices and troubleshooting procedures when connecting to SQream using Tableau: @@ -398,16 +172,6 @@ This section describes the following best practices and troubleshooting procedur .. contents:: :local: -Inserting Only Required Data -~~~~~~~~~~~~~~~~~~ -When using Tableau, SQream recommends using only data that you need, as described below: - -* Insert only the data sources you need into Tableau, excluding tables that don't require analysis. - - :: - -* To increase query performance, add filters before analyzing. Every modification you make while analyzing data queries the SQream database, sometimes several times. Adding filters to the datasource before exploring limits the amount of data analyze and increases query performance. - Using Tableau's Table Query Syntax ~~~~~~~~~~~~~~~~~~~ Dragging your desired tables into the main area in Tableau builds queries based on its own syntax. This helps ensure increased performance, while using views or custom SQL may degrade performance. In addition, SQream recommends using the :ref:`create_view` to create pre-optimized views, which your datasources point to. @@ -437,7 +201,13 @@ If Tableau cannot locate the SQream JDBC driver, do the following: 1. Verify that the JDBC driver is located in the correct directory: * **Tableau Desktop on Windows:** *C:\Program Files\Tableau\Drivers* + + :: + * **Tableau Desktop on MacOS:** *~/Library/Tableau/Drivers* + + :: + * **Tableau on Linux**: */opt/tableau/tableau_driver/jdbc* 2. Find the file path for the JDBC driver and add it to the Java classpath: From 4e6bd961b99742efbde41793580af6fa442b1200 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 21 Jul 2022 12:55:04 +0300 Subject: [PATCH 136/882] Update tableau.rst --- connecting_to_sqream/client_platforms/tableau.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/connecting_to_sqream/client_platforms/tableau.rst b/connecting_to_sqream/client_platforms/tableau.rst index 01f90bbb4..ad29a7d15 100644 --- a/connecting_to_sqream/client_platforms/tableau.rst +++ b/connecting_to_sqream/client_platforms/tableau.rst @@ -6,7 +6,7 @@ Connecting to SQream Using Tableau Overview ===================== -SQream's Tableau connector plugin, based on standard JDBC, enables storing and fast querying large volumes of data. +SQream's Tableau connector plugin, based on standard JDBC, enables storing and fast querying large volumes of data. The **Connecting to SQream Using Tableau** page is a Quick Start Guide that describes how install Tableau and the JDBC driver and connect to SQream for data analysis. It also describes using best practices and troubleshoot issues that may occur while installing Tableau. SQream supports both Tableau Desktop and Tableau Server on Windows, MacOS, and Linux distributions. From a58d0028e203acd4eea8ad0f1517a236ed28e8bd Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 21 Jul 2022 13:02:27 +0300 Subject: [PATCH 137/882] Update tableau.rst --- connecting_to_sqream/client_platforms/tableau.rst | 14 +++----------- 1 file changed, 3 insertions(+), 11 deletions(-) diff --git a/connecting_to_sqream/client_platforms/tableau.rst b/connecting_to_sqream/client_platforms/tableau.rst index ad29a7d15..1d2ca17b6 100644 --- a/connecting_to_sqream/client_platforms/tableau.rst +++ b/connecting_to_sqream/client_platforms/tableau.rst @@ -24,14 +24,12 @@ This section describes how to install the JDBC driver using the fully-integrated You can connect to SQream using Tableau by doing one of the following: - * **For MacOS or Linux** - See :ref:`Installing the JDBC Driver Manually `. + * **For MacOS or Linux** - See :ref:`Installing the JDBC Driver `. - :: - - * **For Windows** - See :ref:`Installing Tableau Using the Windows Installer `. +.. _tableau_jdbc_installer: Installing the JDBC Driver -~~~~~~~~~~~~~ +------------------- If you are using MacOS, Linux, or the Tableau server, after installing the Tableau Desktop application you can install the JDBC driver manually. When the driver is installed, you can connect to SQream. **To install the JDBC driver:** @@ -80,12 +78,6 @@ If you are using MacOS, Linux, or the Tableau server, after installing the Table You can now restart Tableau Desktop or Server to begin using the SQream driver by connecting to SQream as described in the section below. -.. _tableau_windows_installer: - -.. _tableau_jdbc_installer: - -.. _tableau_connect_to_sqream: - Connecting to SQream --------------------- After installing the JDBC driver you can connect to SQream. From bfefafacce2957e7c8924f2ae5a84ba93626b722 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 21 Jul 2022 13:31:53 +0300 Subject: [PATCH 138/882] Reinstated missing files --- .../installing_and_launching_sqream.rst | 3 +- installation_guides/installing_monit.rst | 315 ++++++++++++++++++ .../installing_sqream_with_binary.rst | 277 +++++++++++++++ 3 files changed, 594 insertions(+), 1 deletion(-) create mode 100644 installation_guides/installing_monit.rst create mode 100644 installation_guides/installing_sqream_with_binary.rst diff --git a/installation_guides/installing_and_launching_sqream.rst b/installation_guides/installing_and_launching_sqream.rst index 6ff465758..6a41ba52b 100644 --- a/installation_guides/installing_and_launching_sqream.rst +++ b/installation_guides/installing_and_launching_sqream.rst @@ -13,4 +13,5 @@ The **Installing and Launching SQream** page includes the following installation installing_sqream_with_binary running_sqream_in_a_docker_container installing_sqream_with_kubernetes - installing_monit \ No newline at end of file + installing_monit + launching_sqream_with_monit \ No newline at end of file diff --git a/installation_guides/installing_monit.rst b/installation_guides/installing_monit.rst new file mode 100644 index 000000000..ab49164f6 --- /dev/null +++ b/installation_guides/installing_monit.rst @@ -0,0 +1,315 @@ +.. _installing_monit: + +********************************************* +Installing Monit +********************************************* + +Getting Started +============================== + +Before installing SQream with Monit, verify that you have followed the required :ref:`recommended pre-installation configurations `. + +The procedures in the **Installing Monit** guide must be performed on each SQream cluster node. + +.. _back_to_top: + +Overview +============================== + + +Monit is a free open source supervision utility for managing and monitoring Unix and Linux. Monit lets you view system status directly from the command line or from a native HTTP web server. Monit can be used to conduct automatic maintenance and repair, such as executing meaningful causal actions in error situations. + +SQream uses Monit as a watchdog utility, but you can use any other utility that provides the same or similar functionality. + +The **Installing Monit** procedures describes how to install, configure, and start Monit. + +You can install Monit in one of the following ways: + +* :ref:`Installing Monit on CentOS ` +* :ref:`Installing Monit on CentOS offline ` +* :ref:`Installing Monit on Ubuntu ` +* :ref:`Installing Monit on Ubuntu offline ` + + + + + + + +.. _installing-monit-on-centos: + +Installing Monit on CentOS: +------------------------------------ + + + +**To install Monit on CentOS:** + +1. Install Monit as a superuser on CentOS: + + .. code-block:: console + + $ sudo yum install monit + + +.. _installing-monit-on-centos-offline: + + + +Installing Monit on CentOS Offline: +------------------------------------ + + +Installing Monit on CentOS offline can be done in either of the following ways: + +* :ref:`Building Monit from Source Code ` +* :ref:`Building Monit from Pre-Built Binaries ` + + + + +.. _building_monit_from_source_code: + +Building Monit from Source Code +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + + +**To build Monit from source code:** + +1. Copy the Monit package for the current version: + + .. code-block:: console + + $ tar zxvf monit-.tar.gz + + The value ``x.y.z`` denotes the version numbers. + +2. Navigate to the directory where you want to store the package: + + .. code-block:: console + + $ cd monit-x.y.z + +3. Configure the files in the package: + + .. code-block:: console + + $ ./configure (use ./configure --help to view available options) + +4. Build and install the package: + + .. code-block:: console + + $ make && make install + +The following are the default storage directories: + +* The Monit package: **/usr/local/bin/** +* The **monit.1 man-file**: **/usr/local/man/man1/** + +5. **Optional** - To change the above default location(s), use the **--prefix** option to ./configure. + +.. + _**Comment - I took this line directly from the external online documentation. Is the "prefix option" referrin gto the "--help" in Step 3? URL: https://mmonit.com/wiki/Monit/Installation** + +6. **Optional** - Create an RPM package for CentOS directly from the source code: + + .. code-block:: console + + $ rpmbuild -tb monit-x.y.z.tar.gz + +.. + _**Comment - Is this an optional or mandatory step?** + + + + +.. _building_monit_from_pre_built_binaries: + +Building Monit from Pre-Built Binaries +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**To build Monit from pre-built binaries:** + +1. Copy the Monit package for the current version: + + .. code-block:: console + + $ tar zxvf monit-x.y.z-linux-x64.tar.gz + + The value ``x.y.z`` denotes the version numbers. + +2. Navigate to the directory where you want to store the package: + + .. code-block:: console$ cd monit-x.y.z + +3. Copy the **bin/monit** and **/usr/local/bin/** directories: + + .. code-block:: console + + $ cp bin/monit /usr/local/bin/ + +4. Copy the **conf/monitrc** and **/etc/** directories: + + .. code-block:: console + + $ cp conf/monitrc /etc/ + +.. + _**Comment - please review this procedure.** + +For examples of pre-built Monit binarties, see :ref:`Download Precompiled Binaries`. + +:ref:`Back to top ` + + + +.. _installing-monit-on-ubuntu: + + + +Installing Monit on Ubuntu: +------------------------------------ + + +**To install Monit on Ubuntu:** + +1. Install Monit as a superuser on Ubuntu: + + .. code-block:: console + + $ sudo apt-get install monit + +:ref:`Back to top ` + + + +.. _installing-monit-on-ubuntu-offline: + + +Installing Monit on Ubuntu Offline: +------------------------------------- + + +You can install Monit on Ubuntu when you do not have an internet connection. + +**To install Monit on Ubuntu offline:** + +1. Compress the required file: + + .. code-block:: console + + $ tar zxvf monit--linux-x64.tar.gz + + **NOTICE:** ** denotes the version number. + +2. Navigate to the directory where you want to save the file: + + .. code-block:: console + + $ cd monit-x.y.z + +3. Copy the **bin/monit** directory into the **/usr/local/bin/** directory: + + .. code-block:: console + + $ cp bin/monit /usr/local/bin/ + +4. Copy the **conf/monitrc** directory into the **/etc/** directory: + + .. code-block:: console + + $ cp conf/monitrc /etc/ + +:ref:`Back to top ` + + +Configuring Monit +==================================== + +When the installation is complete, you can configure Monit. You configure Monit by modifying the Monit configuration file, called **monitrc**. This file contains blocks for each service that you want to monitor. + +The following is an example of a service block: + + .. code-block:: console + + $ #SQREAM1-START + $ check process sqream1 with pidfile /var/run/sqream1.pid + $ start program = "/usr/bin/systemctl start sqream1" + $ stop program = "/usr/bin/systemctl stop sqream1" + $ #SQREAM1-END + +For example, if you have 16 services, you can configure this block by copying the entire block 15 times and modifying all service names as required, as shown below: + + .. code-block:: console + + $ #SQREAM2-START + $ check process sqream2 with pidfile /var/run/sqream2.pid + $ start program = "/usr/bin/systemctl start sqream2" + $ stop program = "/usr/bin/systemctl stop sqream2" + $ #SQREAM2-END + +For servers that don't run the **metadataserver** and **serverpicker** commands, you can use the block example above, but comment out the related commands, as shown below: + + .. code-block:: console + + $ #METADATASERVER-START + $ #check process metadataserver with pidfile /var/run/metadataserver.pid + $ #start program = "/usr/bin/systemctl start metadataserver" + $ #stop program = "/usr/bin/systemctl stop metadataserver" + $ #METADATASERVER-END + +**To configure Monit:** + +1. Copy the required block for each required service. +2. Modify all service names in the block. +3. Copy the configured **monitrc** file to the **/etc/monit.d/** directory: + + .. code-block:: console + + $ cp monitrc /etc/monit.d/ + +4. Set file permissions to **600** (full read and write access): + + .. code-block:: console + + $ sudo chmod 600 /etc/monit.d/monitrc + +5. Reload the system to activate the current configurations: + + .. code-block:: console + + $ sudo systemctl daemon-reload + +6. **Optional** - Navigate to the **/etc/sqream** directory and create a symbolic link to the **monitrc** file: + + .. code-block:: console + + $ cd /etc/sqream + $ sudo ln -s /etc/monit.d/monitrc monitrc + +Starting Monit +==================================== + +After configuring Monit, you can start it. + +**To start Monit:** + +1. Start Monit as a super user: + + .. code-block:: console + + $ sudo systemctl start monit + +2. View Monit's service status: + + .. code-block:: console + + $ sudo systemctl status monit + +3. If Monit is functioning correctly, enable the Monit service to start on boot: + + .. code-block:: console + + $ sudo systemctl enable monit diff --git a/installation_guides/installing_sqream_with_binary.rst b/installation_guides/installing_sqream_with_binary.rst new file mode 100644 index 000000000..7a3c7fff8 --- /dev/null +++ b/installation_guides/installing_sqream_with_binary.rst @@ -0,0 +1,277 @@ +.. _installing_sqream_with_binary: + +********************************************* +Installing SQream Using Binary Packages +********************************************* +This procedure describes how to install SQream using Binary packages and must be done on all servers. + +**To install SQream using Binary packages:** + +1. Copy the SQream package to the **/home/sqream** directory for the current version: + + .. code-block:: console + + $ tar -xf sqream-db-v<2020.2>.tar.gz + +2. Append the version number to the name of the SQream folder. The version number in the following example is **v2020.2**: + + .. code-block:: console + + $ mv sqream sqream-db-v<2020.2> + +3. Move the new version of the SQream folder to the **/usr/local/** directory: + + .. code-block:: console + + $ sudo mv sqream-db-v<2020.2> /usr/local/ + +4. Change the ownership of the folder to **sqream folder**: + + .. code-block:: console + + $ sudo chown -R sqream:sqream /usr/local/sqream-db-v<2020.2> + +5. Navigate to the **/usr/local/** directory and create a symbolic link to SQream: + + .. code-block:: console + + $ cd /usr/local + $ sudo ln -s sqream-db-v<2020.2> sqream + +6. Verify that the symbolic link that you created points to the folder that you created: + + .. code-block:: console + + $ ls -l + +7. Verify that the symbolic link that you created points to the folder that you created: + + .. code-block:: console + + $ sqream -> sqream-db-v<2020.2> + +8. Create the SQream configuration file destination folders and set their ownership to **sqream**: + + .. code-block:: console + + $ sudo mkdir /etc/sqream + $ sudo chown -R sqream:sqream /etc/sqream + +9. Create the SQream service log destination folders and set their ownership to **sqream**: + + .. code-block:: console + + $ sudo mkdir /var/log/sqream + $ sudo chown -R sqream:sqream /var/log/sqream + +10. Navigate to the **/usr/local/** directory and copy the SQream configuration files from them: + + .. code-block:: console + + $ cd /usr/local/sqream/etc/ + $ cp * /etc/sqream + +The configuration files are **service configuration files**, and the JSON files are **SQream configuration files**, for a total of four files. The number of SQream configuration files and JSON files must be identical. + +.. note:: Verify that the JSON files have been configured correctly and that all required flags have been set to the correct values. + +In each JSON file, the following parameters **must be updated**: + +* instanceId +* machineIP +* metadataServerIp +* spoolMemoryGB +* limitQueryMemoryGB +* gpu +* port +* ssl_port + +Note the following: + +* The value of the **metadataServerIp** parameter must point to the IP that the metadata is running on. +* The value of the **machineIP** parameter must point to the IP of your local machine. + +It would be same on server running metadataserver and different on other server nodes. + +11. **Optional** - To run additional SQream services, copy the required configuration files and create additional JSON files: + + .. code-block:: console + + $ cp sqream2_config.json sqream3_config.json + $ vim sqream3_config.json + +.. note:: A unique **instanceID** must be used in each JSON file. IN the example above, the instanceID **sqream_2** is changed to **sqream_3**. + +12. **Optional** - If you created additional services in **Step 11**, verify that you have also created their additional configuration files: + + .. code-block:: console + + $ cp sqream2-service.conf sqream3-service.conf + $ vim sqream3-service.conf + +13. For each SQream service configuration file, do the following: + + 1. Change the **SERVICE_NAME=sqream2** value to **SERVICE_NAME=sqream3**. + + 2. Change **LOGFILE=/var/log/sqream/sqream2.log** to **LOGFILE=/var/log/sqream/sqream3.log**. + +.. note:: If you are running SQream on more than one server, you must configure the ``serverpicker`` and ``metadatserver`` services to start on only one of the servers. If **metadataserver** is running on the first server, the ``metadataServerIP`` value in the second server's /etc/sqream/sqream1_config.json file must point to the IP of the server on which the ``metadataserver`` service is running. + +14. Set up **servicepicker**: + + 1. Do the following: + + .. code-block:: console + + $ vim /etc/sqream/server_picker.conf + + 2. Change the IP **127.0.0.1** to the IP of the server that the **metadataserver** service is running on. + + 3. Change the **CLUSTER** to the value of the cluster path. + +15. Set up your service files: + + .. code-block:: console + + $ cd /usr/local/sqream/service/ + $ cp sqream2.service sqream3.service + $ vim sqream3.service + +16. Increment each **EnvironmentFile=/etc/sqream/sqream2-service.conf** configuration file for each SQream service file, as shown below: + + .. code-block:: console + + $ EnvironmentFile=/etc/sqream/sqream<3>-service.conf + +17. Copy and register your service files into systemd: + + .. code-block:: console + + $ sudo cp metadataserver.service /usr/lib/systemd/system/ + $ sudo cp serverpicker.service /usr/lib/systemd/system/ + $ sudo cp sqream*.service /usr/lib/systemd/system/ + +18. Verify that your service files have been copied into systemd: + + .. code-block:: console + + $ ls -l /usr/lib/systemd/system/sqream* + $ ls -l /usr/lib/systemd/system/metadataserver.service + $ ls -l /usr/lib/systemd/system/serverpicker.service + $ sudo systemctl daemon-reload + +19. Copy the license into the **/etc/license** directory: + + .. code-block:: console + + $ cp license.enc /etc/sqream/ + + +If you have an HDFS environment, see :ref:`Configuring an HDFS Environment for the User sqream `. + + + + + + +Upgrading SQream Version +------------------------- +Upgrading your SQream version requires stopping all running services while you manually upgrade SQream. + +**To upgrade your version of SQream:** + +1. Stop all actively running SQream services. + +.. note:: All SQream services must remain stopped while the upgrade is in process. Ensuring that SQream services remain stopped depends on the tool being used. + +For an example of stopping actively running SQream services, see :ref:`Launching SQream with Monit `. + +2. Verify that SQream has stopped listening on ports **500X**, **510X**, and **310X**: + + .. code-block:: console + + $ sudo netstat -nltp #to make sure sqream stopped listening on 500X, 510X and 310X ports. + +3. Replace the old version ``sqream-db-v2020.2``, with the new version ``sqream-db-v2021.1``: + + .. code-block:: console + + $ cd /home/sqream + $ mkdir tempfolder + $ mv sqream-db-v2021.1.tar.gz tempfolder/ + $ tar -xf sqream-db-v2021.1.tar.gz + $ sudo mv sqream /usr/local/sqream-db-v2021.1 + $ cd /usr/local + $ sudo chown -R sqream:sqream sqream-db-v2021.1 + +4. Remove the symbolic link: + + .. code-block:: console + + $ sudo rm sqream + +5. Create a new symbolic link named "sqream" pointing to the new version: + + .. code-block:: console + + $ sudo ln -s sqream-db-v2021.1 sqream + +6. Verify that the symbolic SQream link points to the real folder: + + .. code-block:: console + + $ ls -l + + The following is an example of the correct output: + + .. code-block:: console + + $ sqream -> sqream-db-v2021.1 + +7. **Optional-** (for major versions) Upgrade your version of SQream storage cluster, as shown in the following example: + + .. code-block:: console + + $ cat /etc/sqream/sqream1_config.json |grep cluster + $ ./upgrade_storage + + The following is an example of the correct output: + + .. code-block:: console + + get_leveldb_version path{} + current storage version 23 + upgrade_v24 + upgrade_storage to 24 + upgrade_storage to 24 - Done + upgrade_v25 + upgrade_storage to 25 + upgrade_storage to 25 - Done + upgrade_v26 + upgrade_storage to 26 + upgrade_storage to 26 - Done + validate_leveldb + ... + upgrade_v37 + upgrade_storage to 37 + upgrade_storage to 37 - Done + validate_leveldb + storage has been upgraded successfully to version 37 + +8. Verify that the latest version has been installed: + + .. code-block:: console + + $ ./sqream sql --username sqream --password sqream --host localhost --databasename master -c "SELECT SHOW_VERSION();" + + The following is an example of the correct output: + + .. code-block:: console + + v2021.1 + 1 row + time: 0.050603s + +For more information, see the `upgrade_storage `_ command line program. + +For more information about installing Studio on a stand-alone server, see `Installing Studio on a Stand-Alone Server `_. \ No newline at end of file From 3c89d556f405dc12e25a1d9d6ab3eaa04da749ac Mon Sep 17 00:00:00 2001 From: YanivGerowitz <82020437+YanivGerowitz@users.noreply.github.com> Date: Thu, 21 Jul 2022 13:52:14 +0300 Subject: [PATCH 139/882] Added Upgrade Storage link --- releases/2022.1.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/releases/2022.1.rst b/releases/2022.1.rst index 8d881c92c..f02676c34 100644 --- a/releases/2022.1.rst +++ b/releases/2022.1.rst @@ -138,11 +138,11 @@ Upgrading to v2022.1 $ ./upgrade_storage - .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in **Step 7** of the Upgrading SQream Version procedure. + .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version `_ procedure. .. toctree:: :maxdepth: 2 :glob: :hidden: - 2022.1 \ No newline at end of file + 2022.1 From bce4e2dc23534b6dddb56308896231c449067c0c Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 21 Jul 2022 14:14:04 +0300 Subject: [PATCH 140/882] Added SAP BO --- .../client_platforms/index.rst | 1 + .../client_platforms/sap_businessobjects.rst | 60 +++++++++++++++++++ 2 files changed, 61 insertions(+) create mode 100644 connecting_to_sqream/client_platforms/sap_businessobjects.rst diff --git a/connecting_to_sqream/client_platforms/index.rst b/connecting_to_sqream/client_platforms/index.rst index a38f1f1f5..be5f4af16 100644 --- a/connecting_to_sqream/client_platforms/index.rst +++ b/connecting_to_sqream/client_platforms/index.rst @@ -27,6 +27,7 @@ If you are looking for a tool that is not listed, SQream and our partners can he php power_bi r + sap_businessobjects sas_viya sql_workbench tableau diff --git a/connecting_to_sqream/client_platforms/sap_businessobjects.rst b/connecting_to_sqream/client_platforms/sap_businessobjects.rst new file mode 100644 index 000000000..4c740b034 --- /dev/null +++ b/connecting_to_sqream/client_platforms/sap_businessobjects.rst @@ -0,0 +1,60 @@ +.. _sap_businessobjects: + +************************* +Connecting to SQream Using SAP BusinessObjects +************************* +The **Connecting to SQream Using SAP BusinessObjects** guide includes the following sections: + +.. contents:: + :local: + :depth: 1 + +Overview +========== +The **Connecting to SQream Using SAP BusinessObjects** guide describes the best practices for configuring a connection between SQream and the SAP BusinessObjects BI platform. SAP BO's multi-tier architecture includes both client and server components, and this guide describes integrating SQream with SAP BO's object client tools using a generic JDBC connector. The instructions in this guide are relevant to both the **Universe Design Tool (UDT)** and the **Information Design Tool (IDT)**. This document only covers how to establish a connection using the generic out-of-the-box JDBC connectors, and does not cover related business object products, such as the **Business Objects Data Integrator**. + +The **Define a new connection** window below shows the generic JDBC driver, which you can use to establish a new connection to a database. + +.. image:: /_static/images/SAP_BO_2.png + +SAP BO also lets you customize the interface to include a SQream data source. + +Establising a New Connection Using a Generic JDCB Connector +========== +This section shows an example of using a generic JDBC connector to establish a new connection. + +**To establish a new connection using a generic JDBC connector:** + +1. In the fields, provide a user name, password, database URL, and JDBC class. + + The following is the correct format for the database URL: + + .. code-block:: console + + 
jdbc:Sqream://:3108/
+	  
+   SQream recommends quickly testing your connection to SQream by selecting the Generic JDBC data source in the **Define a new connection** window. When you connect using a generic JDBC data source you do not need to modify your configuration files, but are limited to the out-of-the-box settings defined in the default **jdbc.prm** file.
+   
+   .. note:: Modifying the jdbc.prm file for the generic driver impacts all other databases using the same driver.
+
+For more information, see `Connection String Examples `_.
+
+2. (Optonal)If you are using the generic JDBC driver specific to SQream, modify the jdbc.sbo file to include the SQream JDBC driver location by adding the following lines under the Database section of the file:
+
+   .. code-block:: console
+
+      Database Active="Yes" Name="SQream JDBC data source">
+      
+      
+      C:\Program Files\SQream Technologies\JDBC Driver\2021.2.0-4.5.3\sqream-jdbc-4.5.3.jar
+      
+      
+      
+      com.sqream.jdbc.SQDriver
+
+      
+      
+
+3. Restart the BusinessObjects server.
+
+   When the connection is established, **SQream** is listed as a driver selection.
\ No newline at end of file

From 980753a69c3792e854316368614f1dfe370de159 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 21 Jul 2022 14:16:55 +0300
Subject: [PATCH 141/882] Added images

---
 _static/images/SAP_BO.png   | Bin 0 -> 112881 bytes
 _static/images/SAP_BO_2.png | Bin 0 -> 25160 bytes
 2 files changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 _static/images/SAP_BO.png
 create mode 100644 _static/images/SAP_BO_2.png

diff --git a/_static/images/SAP_BO.png b/_static/images/SAP_BO.png
new file mode 100644
index 0000000000000000000000000000000000000000..413ce7d0e4731668b9320ab6a6139177329c1af6
GIT binary patch
literal 112881
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
pLD2D_$vWC+{e~$c+6bxRmwn
z#FdQsrS(f2X2C4+Io+TB$W06`%&QpX;L|p<58)Lzs%>4MB-ikY=;@hysp>d2cP-&P
zqGVLf6tpmxMO5`HJit3R&!oRHQcdEUew~4~?_M5yfS-)O0Wpo^36z
zqjRBdqVex~F8qy~e*VX90w28*6UzT;H(fDm;5Mf6n^u6E#H})SpVB-h<0@~HB4wVe
zV3Q+<$v!7W+;>FdFc(HtE8wFe3R?ELs@55MkIJ%2JMCvP<5LS_mcV{^0^DS9=%OLU
ztMZBh`I`&s-!g0PDEZoxYR_CYJi~2n=-!})Z#XL#@&m7fh+0EsQBd;hretll@
zw176Vn5lPctEgtcK@Q`~if-(()~a@aKXS^mh@0s;B#LPGU6FM+b;%E(0Dp!nbFXh>=w9sJcTe
zDuT+6U!NAza|n?$A`7Vz-6PxGBD)CT?QWC~a!SuZE-emeD?MD4uo~XPDbCy}>6_zH
zXL-)3=W_a-@8BMp8t@iB-@jsd(5WsOUJS2Ctl>
zfP!;Ab;Sr9fBK?sOwM3j?vRdE@p;2BSp$d8D@CStNNTt!8W1DWnon^lOQ_>ybzDxeD~BXdE1DO0B#aexoX>E`
z7u1Yom-n;qsHz#ci6~%rBn)LV96W=vwM>a_{+W`h_OhCe8fKmbw!V^THj279j8lk|
znoUSTsjQ~0kh}@6q#h|O(>o;X5EGwoM3%EpjJ~CJaotQ!+eTz^^Jxy{il)Vy)@61c
zEge%5pSW@F*qxk`zKi^tikgnPCZ4k^FNguDQp#qc@`jqm&fy7V<_a^+aRWf
z?yHU6SMw`J#pEshBML)eichnMS~~@b%bShOJ;*Qb;}g@Q}+R!!=7E|Qp9vK;5;un&Bo?Rq9wInnuljs+NvGp{ya^)6O@FY>vvTLmDeJJq-
zoZK>#bGIkw?m$nC6qqC`qq~0lr=h8ULjKpw>NIQq_&K5@yIT3K7kOFlvb*)V|nx5E37k#;O<{s-l(9WXOHug
zlG7NUS&L21HL-FktZ1^vdP&ObJbJP9Yi@eqO~3iJ?r%5MUNWTen>TYCl?s^U$vWii
zI<594hwcSg{AqDV0liRBBg)68v_y5nzdNtbD&qLTewp*aZtPOt``HaIDR}N@wYZ`f
zct*(nlT(VvdCd-R8e_a_xMY03y`aq{<8thhji74aS0|Ov3D_IB)oZylF)N1czhW<_
z9dPur={M&LP2Fp?U8;nP629Rw;n(tI5w`p0lp3#+|KW>P(k5X?xIuQhmla&OWISYz
zVoz{ei|PbiQow!AB*`La{w=ejltCb~D3(u^%r4{1CJh1#+|RDaDrp7n-0~jBFPp1d
z$FWLU^Qt+^ng(1}bTM`-vh}NXiRe7QX(p~8=AGEXA??I0X3MMW&adJjXA*Wn$VS6D
z?mWMxoI#+t2JwqyQYz*_9OCAxm_S(re_6v&aFeE8rnOIv2c^p=p+``ID4_19Wfvu)
z?q=zheu2-_z&`GZjIE*x=@6R|zmkK2BZW=W1j)VB!I>jm)kwTK&l8eSES^Y;?RKrs{q&3}TwA~`pTh3llm)0gI8hAk0Ow-KQ)-~=B
zlenc*l(ah53>#u>7kH9QM$^mXeriAefOpi>i6jLpIq(`>y9zj3{V2dHQ8|`KPg5mbb80D;!iq7;g$8E0
z_|)RS@Z?ZR`s~u(rS(V69g|Ef0)b(vAVF7RSXF(`)!Q%JeL`J40+P}SrRBAt;_4Zg
znOl*PRRV5G&MYytA}Fex-hI5ae&adl=}+ABPws{P|H@4@myK(9&FgrK%LPnJrEDsW
ziTeF;#dZH>mmj&^FR8_gndBVh_f)YfIxFgNS4i-d=eX1E2h
zS{I*lQPGQ2&P&`d#@4^x#;?OMq+38MLenwNIkHpABudFD!Gc(NQQqT{f|s&o5iC_E4o;^XRBc%gHn3D
zDNV8lfxZbHDi%?)20=XXuG%*7l$^1kn`-f}u_Y9=ItU#0d9)+N+|5E2z%GBk0c
zu)Ny_2NMKk6}FDf+>TBzPcLYmS$RA(brT4R%E>Kl_YO=NpSv|Nf7>T8v7>(>HK)eS
zJCfiTTHP=(y?A$F?eXCFCdSSi?;c9<3@@qbTHJWFwDD+oay=k4$<-^w4(DA`+1fX}
z5S@^_uy&V{kn2f~#1ed?6Y_68*aEe!Y(j2&{`PyizuokQZmPOsT6x8!g5RuK(6mO#
zxJKBhj$f~uPp3*yzm`v@LeipM+^kaCvP|4GM@T!8LN63t8xkR
zB2nXFX-tiRO}&g|m4a=RqJ51lrdrjZS>CEr22(6=U7}!Hu7s^qu&-6cH^|$SE7%sv
zTj!}dlxaEFYT#=%UFy`GtK@77R2)iFv1K~&5?`r;Em6ajXcEeey&E*~6?(3rA{FZ2Y?nTMh7!*8YQ5e*Lxqz2-hGR=%yafo-;dEmr;w_Q5TdzV&9r8pn_h`@lA*ux^YG
z6+@!h1~lO#x^SVL*1pZwC1ZC-eb6aovGw
zLokhZT(<|M1KLB<$H?*hVVRTuNrQe#{lV!YvQb@xnp4&1HK9Eq`20|?9u4l
z$%w4+sGO
zDeW;i1Brzr@%h79RdbZAK4?rT98WKwNiCgDDw@nFUra8VOD&$ys$9vbT1_sTNy?u}
z$Q{oto6jtp%POBQq^@U`!vvElg%d^fYx%WHh16vrvwXU&Wxc3=DW`h6v}vWJVKJk0
zG^>29qGh?deXXE&ISmBzkn4ZWL{ZHp~KH|o09${J@Yn-{2EYi)x!n))_7Ms9YF
z-YTh|Y#X}XH+i>XXtTO$vY}(4fBaV0(ABP?&B4jr@Uo?6xxIf4x`#tkckA2do4S|!
z#%_+z-tQj1IyiZ!Z|nw4KfU}ErthD)F*tc+V*cLn)J>4rTdn+Q`(#
z33jjKe>>O@TIq^(=TEgJ-kD?~6g
zVpi3{7Ns%{H3G)D>}rWpb~O?Kw+u#X6|NE~MKbtj{rg0OQ+^iyU?gAG8hbAw-YZhxXWq_BvCB9YTBXQ3LqMejI2h
zdc-+=kPtCUh!}B+9Px;ma7BMZH|!caK%n$^#`O~u2J{I9gvd^E%9vODpjZ5Wcft@U
zafF;S>Yp+}P8=g8jQA#x`zDS1pg*Y_@l74|PoD_PnDS4Z@Jk-|Pn`@*n+isMr!pR%
zGZ&CL7M3*~oIW0wH5ryY5t%m`o;@CsJ4MN#56hg6%$Y|Y4bPp6Er7~6C2t}+e6wahoET>m2XH>4F
zlrCgdtz}lNrh<>ER`TlB(Xj{W)^ciA3L7@Fsupvq7YiHK3hGw@sBe!qP(WRUvao)&
ztaY=XeyOBs4JdCzM?@)WSu1QWcJa})cw(!hhuY(MrQ7f&p#ZQxjVV|Xkz}s_}o3(U;~e)79UP6p)C^&59U^%
zF04PFUU~%W(@PI#&}X0?E~A5=yxjhs3b3;I3{uk4#>4G?+%mB7Wc|j=)y-#ryXl|1
ziN~xQ{YNxSN(Id-g-j|%AV3*co|29iwyYMisuZ@V;>VN;*;ETzSBu(G0TJ6;VVgPu
z%UW^!W)T~zur*cOzD3NgMa;HY3fn4XLzQ%Bkis@eJ2pu=)I&wmp+g$mE#uItL+mrixpPEGet
z4Yzi6*ET(G^qwW|{{DK;bx>UebO6T9_@UHabLMx;J{VwWDV-8`UA&$G#d+-~OA
zDQ1?f=3HkHIB4SAXX-y_7BFb)KVV88vg$=n-#_>@@
zE^))oaeeq05ZQox+?Z$lxJUe$nRkPsdyP-Zj7QvDl?(ki~gxo!I`rmSu+73sodG%ENGk$
z%UX=gT?xsU3(sDN$Xy7_o{7qzqiJh4x?nCUcQ&?gF{WSb>Cp7!!O4e1lb|H1+#i`ie^oa;
zeIHacP8+-l{YA^{gUQ9mz|_){vAKuSOHXH)pH0Kdg@>~%Pp20jEv&zQ`tthA#kJ>i
zOW>v#^Q#XQR_{ZGnp?RK!3wmsdiBLB`VVKK4~757yNO9Ugk3G0MYV`Uqw>5)`FX99
z^IApBTE#5rKT%i4u3e6zQ-%UoqQR+G#-&%zrC)wg9~~X#l0n5~uo8_cMitz~l>iTf
zCX=emCY9Xg)x4&a=s!hgQYvO%eo-TJ*GY`1S-yx_o`hAgh()2aeYL1%g)Fu~*rHOz
zvPuTLW8WxY*C1k5D`8hJhijL1XpyjKka1{|b8M1vXb`uqk;OL3J2lDUT4k^uGT2U8
zhh_zAgQ`=5u3L+&Wzok>me8TocWY2{tm06jXc8K=+*(zfo77yIHClt~#=lj|
zrG!^I%ptt}2p?A1FcudDS*ac4*JVcTvH;$GsPHs+f$8jv>On>0#{8zLu-`zB8W
zq|JKAkNKz0cqfhdB#)ERrl3Mjo$^ng^+_5BACXfg12gCR)20H_r-CwPf-G=e7F2+vx9pyKmI@-K_1p3KUH@hb8ccMN5Ro&|tz0)&sziaGH5BjURJKf`V
z`==jtL!O$v*Ee;4Xy#G>#C_U0bN7d59u0t%W*?2tJ{q2R0B#zbygN>F6NqVY;ql}G
zI_@RprkQ1Qu#`zq(()5pbb1WwX@2#|{OV%}P)q9&m!8cnqd)gu+;}p#`e5bSv*pdF
zD_5T_Z9G9A3cpIrP1jIp&o`mJ^?hrl_uNF&6Icm#6Nu?OH{E~m>H&?14}U^=^wXn9
zKRtd7div?flb^SF`t+A=o;~~J#j{^tKL7bGuU`E8>gCTrz5E5l^b3gT)h}Bhrk}t{
zZ{76E&+tFZNx%Gpwr*{`{MAk8Bttk=GuTuM*flCIs8?LjEW4mp%&c9+qE*DET?%62
zKq=+WE#c5D=F}s|Cq`2w6KS~Rkkc9N5U+dTPvAEH9-PXA!Sn|WLkDbFYlsuj)Zls
zjD3TkX&IMR7LP%p60TL&u3o^Xh~KaPG$ilPAZ%L7YfvQb*r9;ylyhiOb!wEeE*3RN
z;#Lm+;Gl|z0FXd$zg>>3NwS80p^Ry!oK>MRwo=QrQ5jb)XI*6C(=211E@GUhY+r5a
z(WUeLXgFpXxs}=ax7zr&YdNBmnRrp5k7gOrZWY*N7dD{jQmuk3GxBb9
zj2f^F>C_>VYB=QB`PCD`+pK--t%JJMoGM{5Z1|w1Uz;Vl*^p4-9yRC{J7Pm_*29-s
zcsIJoj=9B7n0YtryH+}dG?5d!zdEC$=a_;Isc{Of@=xxz_AavU$n%VDBPaH{M6`NF
z_h39LN%6zJ$zy)06U4+}-_!{bIq;J}|e>%LJ2+Ek;CO8wK(^N?2
zWN6kD5SBe1obatesZod&k86qP>DvatDd
zapURICh%nWDi{g{eT?AO=fcqeQm);2f%1Dd-FbQA&WpF9>9=nB>HdS44<5V#9zJ{t
zJbLsB05Ls&^6JUc*F1gp(>BkZ{ruwDPjAHZ)2kP+`RV1)Xkr3h{;~yndiC>bF>Skv
z<|-Pfx3;!kym)p0wVTdJg|VyBa+7BDIrXY@S{3KC%Fb(-UeGRO(XL?CsbbTvV$-Q)
z(=BJygAN^Z>nb?(DmnG5IQ5}7R|Q-&tbPMJ=Gq~6%v-E
zoGLM2Fk3N8kv~6cET$i?XqCe(<$vIc>-U#j&q+s!n-?-k_#WiO9prJktQIa|ntEEq
z<0wDjxS)%eQKE=J!cji_aeik>lVowD#AAF;hk0H24RRD68x*nCDvlMbvc4zz9S?Du
zeRNcjTakEx-9*ZOa#onYF6YOg7-a0zC}Nm+M%YEeKJ%QY!v!%XR&gI~Y|#&#daTko
zW7leHpB7DQD)QMCX`^@zySxixgbU&Xc4;3yeCcr>EUT1#aRT(0Mwfqcm$ZytX5
zlEEnf467uLSJm6tHDA*{omJA6Q^r$BE5yRP$|j(}IjTnuo5v#7%0zv~
z3{rd_Bs+KaVmow3EFCj6#CbxDquWk*>{JOOQ>N*Xm{5l{nIh22j$3vOOj*ZCKvT
z@;2zoU8`sVu2yzjgPvV=$2Fj)^Ey!1bpxPw-+TkO=_Wb`X78=0K9uIZTP=OJf!6-p
ztpm5)2JZmvLwDPU?zExYZXZVJ7`X##S8j&J>=Me{@{_sc$MY*s7FVBcgAOdW
z_G|%-PAJP8&zI5Bc+ruYpilRvTlZpv#?@;tuU&tIa`QFUZ~X+^xc&2u+fe>=>ki88
zyFUYW?)?JXy}xzu{xA0*{PLzxheG?!3UuhU{;W^;{MpvaH@t!l9q@eXrx#m4zufwT
z#?~tu+ZKY5gcdYK{b6o8B^|-4mW$qR(yV3DsA1BoI-^~2R;T=&cEtsq8fKk37L-~R
zy=oS{DpuWUfK9K4UB8xHzlOuG7T`3hdkdFw-9;0WOQzJzrnS7LH9SV;!sb=NW+gIK
zrC(gIImSznHBJ5cya|(#i>z7NhsX6fk*kpsgVb&AW^u8#E=TUY)FKqqM
z5y@kh48Axmf11x!NW<&MMLlK_D*+WZ5p}O0nAO;&2$$3%lpHIxT&nnVBELANBV!VA
zMV|2GDfv@Zj1RDAE0{)pbX0*~BjCU#jIwSI!OgO`DBB<^T*_udpiKln{63il&T?%clpgXqx+InR{~yYAfp#4xba{
zmo`1lDlMhy$SZ3hs)n^ArYabb%?L^R&&!)Q#|x=AaY~q9k+o8{3bY}nv5AKWYA9VVlPnS9wlr|NdKD|vy#taae
zF&&nPLK}nt9V2C%$Q+cY+&O@fHxESTFT~`}$K=n&70d(ig$vsx6oHbKl8S)Eq~gWo
zlEswLrEOBnmeb0C?V$*kY2$@21DTb}Sye09RVz8w=zzSrzm6BaMjM%Tqky{khK<7d
zjiQFlZHgPO0<=Ld(E)k4DQme_-g>>F?M7wW^~$zuRqfY->W&*gP3KLZt_yhAO*iYi
zZ`JqQYUsV)*n7LF_jYqHi0KZ{+J6^l8@LCw58iJdyw^Si-0c`f=^VKSbdBEc9=+f5
z8g$&tzVZ7&|HOlV39u4+j|mu_dNe%saAf+?Hls6-fw7s#<11D=(H;UoNe_TwHsxxc*{k{l)UeOJH^L)#}EpHDL4Q
z#?@CFo3E~3{Ry~s?dR*)f4K(S`1#sRlMTpnW^=68hgC+;2K1
z6T+gNc|pD4f>tGyW(AXW*%_UZv%1CSbV@GhRIun&)2L$6t6#
z`tdO(148}}oMx=Dp5L$<>*EW)XV&|HO@~L>>kOZhpjzo89S7MAugJLuBzH55
zSY8k||MIldMOk}MO`lWT=K8pFm#{|nsJ1VeG!!l40y9SbANJk?FplI*8_t*9U2=E1
z@4o*i$>l;D+)Z{j%S_(&GJ~0!nVBuimTbu^w3wNhHIjyBG^EjJBn@>Bi&^tO)ioN+
zT4%HCtna)Ry?#`#uCA)C?ymQl_pPq3UVkio?cwBq{?&V1PoxINH9heBk{93K`lAQl
z-*!6XbVSV$ANu&Uxd(pn_^jiX@(u;2|NM_1yzt)opFZ^N+;x7he6sbERVRP_%-jWA
zfn%52cLUy^L%N(ucoN4a|lV*P=uzngr{pMBGOwTGg@wBYAK?!TBEbI
z6frriF*(}U+*XRXJY78Zgf6k5EwKQhE{QC935IH)WH%Ah>2`LL3COGjyq`13u7)>f
z&V|ubZSsE0;HKSV;noXh$jZDtgkHe8D{ZuvaUZ7xxaBUXPX~t%rjs2;6HqG#>~#{y
z#D@&*JQ;aZ=L1=Xx7i5@6fS|nDO9>d3Ief;EO#m4mI()>>MlU0cFQ%sZy6A9b`yb0
z*QW+r`!sC?oZUngaw3cHwhy$m59m7v+d2keI?>^$cH3AoCB4(tf`<
z`N1X04=ql4WO2r$i?bhHoI}E;S&uHwc#Om2%QBu=o(Vj;A`5tGWi|&yGM`?R^~~yQ
z;Mp}f&#%dPaaHP!H7PSzCBCyM^}+W}|KRcUzn!t`fme4uFk}0VA6xPGdq@8D!DX*3
zy!6zk0grs(|Hub^|NP*RnaeLeKhOX1kB|NO)$Koca^=g50w4YG$Wx!5cy9LT2jANB
z%a=DjJNx9Tivu2cZ~uQjweFc&L34NIEIp9-!t8VZ@$ll$HeP@J!~OsMyN@4uVa@NJ
zTeEn3)c1e!(aHm9uPzAumj@R;@!|1xCrj^pVaM-Y+xhOA&?i1P`}&fwf4YC}ha19H
zA1z;bxa`v{H@^GJk2jpI_|=PhAOGOwlKsi|&sh8PhdY1p;H>$Z!*}=EWU3yXI|{OS=`NKySJp0N1Up&3|
zd@O&%(fA)d`0>oS2OoZI_1eSH@2xmBf7_L3KHB-x?1S6=GiR+2UVk|LffrY-IS}>A
zCwpG{Xvc#uFI%$h(t&`?hhALz=?cG}KJ-a&bi=u@njih{!)?dY_Xd`qjcGn}LwYhy
z5D?q!e?xjITzD=9+$234B@Kv{2FA!J&d16rF2oU#nFI;VK3q&x0Nm=A%FD@s;!2A0
zDuLp9sxl-+8Jeo12uo9kr)z+Sbah0!>PCh-DpNxdou!G%R>$P1fY@9$5SOQ+h|g~U
z67yS<3cN@z)TR`98Ol4}#38lRJJ>X7yor8i1?bGI?8vI>%q9!VkrfDlyjoLUtueoj
zprGCa6xEx#=}wkn9+~u1++ZqcFqbr%$-*gQ?G#Hn-(11BRPrrV+~Q5uLKdhISqa2s
zVL3ACNn)*+T6t2oL1yJ(qiB-b_{}y!vrVY510p401H>vjAW=IgWEv+2hrETLS?g4^
zx)iN$GL4{>fP4dr!-P)lmW2ItlEqVY_qK;Ti#)?on>Mi8yq==X76Y9RltN
z-54-DG*0m+p3`v{=O~H8g#C1j-E{V`c{lzzH}R1LnGem+d}v|XLyM9hUYz{LMJbOi
z%6NQH_T!6kA6u03_>!#0mt;P^B;$!C8BZ?Fd}co
zd&~dLHAxS=b?U#K*$F)LS>KX`oeN1KyZ9jic9zkPN8!|$AU@Xa%yZqB&x#T}n+iC=!OV&&ng1$#1o^30Z1
zM=L(vl>WfXBM-fOHIyM@$qj^iK_1d2sxKyK$XIv^!R1uVWzKH8mP)^6prIh&SxMId;ps4-S|T!9A~UrV
zH?mrza5I+KeH6X;AS?My8*P^6U`
zf%FO!kWmR3Gr&+)hOAr0!pS
zK1^Z#lVjnZ=cX?jZyFdFAN-2k7Lrw*yfd2?lLvNBEy;X(X%_GdStdN|+2z?jJhvj}`IWf<
zH}Nv>xs|yut}S?eRnClcc~32je|~ZNTkA94*^vJ3ri|woM$BB5_~yE_hd#dg$Y-Ii
zuFiOWOX1ArDbIWs@zf`wAFR)vwXNj!Whqa89Qxv%sL!?(%-L4-^8DzR=S3khZ%4_D
z1u-u#h@Z8)?!C=rpKLFmv%BJhjae_u4Si{T=-aE}-d~$EYirJ|t$FXRNt?g7eEz=5
zx7MbAwzFu#-qPiVD&Afd``VJo_t$2uI$HnXhQ!7D3s)SfTXvvk(Y~V3wq~q2T!Zuv
z)}_3@EaJ0m$(zpBe6l%t`Qh@7e*Be3>erqSEI(L}HZ0szw(LOp<}McAgi`+n)9DhNQ*&^7aG^b_CYX-;wg!#+WUq%XSA;
zuiT%r@4RqNfN0hJ;w>ktHykcG93ZpCKj*|1(aCF)b%zS(
zZ%N*8yzF>r^P#KawMPqgo~zjzP<<*wzIxH6lbHAboKx@fj~_W7^eZw$G2Qa05lXq
zi7h~Ik~TP5dohLJQflj^RNq)QncPG{W;SK$xZ&_tG8Uepi^y!F;KsslexJ@a79LH;
z!U^IE^zjp8;R!_@iN&1>g`J5-#-w7?1dPe0#*{J>MQXVjNUN{_>6J`+B|=kXl_`sk
zg>%TQWq`aoz&jRRSkD4QJS#y1z!o=JOPUBu`2=MG8#jT#Rw1xg2)H=}B3qT1Jg2K6
z-++Q!=Y(@tCncztIRWoLxXjro_kEns&4*j3^y1d%bZ*I{@6%0sPS>N*^>H9moG8?7
z{eVV40JO9ZXgj>nb;6;$>C=(1aP9+8bU1v{df~%>i5W4oqh^*mbhkXGn>@eibKLa#
z^_zS?-Jjs5!STVN+i=t92*ID{CWMo@>38o1JTg1_v3Y5KoSXH~+{}j;Wc+bq+9L~7
z9$lFF*n-T*7vw&^Aph}&`Hz#2tYkk)koDA(?5CIHJWVDylB?m9@4_+1?xh^>xB0Cx;KX6TSI8=HlM0_kxYB)E{&LJ^eQ5}cw9PSsu{+yt~-;Xvj$ft%6^
zH-%&na9_}D4a?Mpb2FQOh^)5A96$%$$ZflkOTwr;g6Mn#^0bc5z%10q7jg7d)R{!g
zCF4!gsl<>{Vn{7D0%>KYv~prJadwlLnogPI^O@vP9rv`3KBu$f)msQR)!*c%LLLD}
zOkR{U5s+0eiS@*m3#=6c;3ga4CXu}gMiYHP$33K*%uQrwlhildop>av%)FkrbVT$$dVP%x~%gH0|6spgQ`so&BvGba3d51AyM-MZ1}^
zo5=j8A;8EGm{?#KAxBJuj1AmGj3zR(3B*LgAv?IqG3;=TI6+J2?2
zjvNUm=xKb+GmbJoZhHU1qjTdQUy$|CoUDiD<@|9`_Cxc*O=*uVNPmnheVO<8g2Kla
z6+X5&5A;MP5G=}hYH=>`^pd=1mgYaZEdSZ%Kpybi^8DvkkY&POSXl@>PoCD5KC`;)
z*)?U)ttowBZOKb(i(g(__{ut<2$-?HXvT)(85>GwY%F_qQ^l(r%VusWeq&P+@Froa
z;(AeR~_i;&--{yt}RBz3rt0Agmqb@9wO8XJ^HGyUN}tABHOWXiwqC96s4w
z^2wgkPxh97vajOP{gt2YulV#}#b*b~XCEk=bD(7I!Q#0GOXeLcpMR)){^6qehl>{+
zu3T`WYQd4Rg~!Sk9<5je<~mlf=y=7V6IHx)=0B=JeZ^L6
zZfh`aYfuyS0Vu)tApXu^!LEzKT^9wrF9H1Bm-%~uD}ucgSA~183ie(T?7dE~FNEMg
zsNi6j;7}+ZI2_7962?CoCO8%*JRUCMAU+W(KM~msoV-DBDhk|00AeD5a~G}fk5!zF
zQ%=UYcoh(kpbkvb0OylhI3S|AkkS&A(gJP@PHVjgq_%*bE`y%Zv{wl?>457Qy6c&`
zkStwjrY%ts4z~9IvMB`CvHT1!lwf_)srbszFAIQ|E_^4ZuEk1
z6Gu#?e5O>umI+wGO+qsLk|QR{O-BZJ}`J#h@x
z!&y&27nyk32Dh$9sqaw%?LF#_9(8+1$3C+6opv7q3Ig#}M6%6npQ?vsmh
zpW^WJ;@oElH|0G`>1kR1bHMWa=a(0}u!3;YiyU59S@gon;ulvHzqG38mDNQv))c+E
zrtr136IfR`b6wHQ^~E#Sm%P5AbmoSVnVW#(nVU;q-(2#>mQvu&EoE;c9wmztK^ei#h>ji0cPzkpG96OKO
zAwgP^A+5MG9Vj8lC^2M|5@ePcvw(7Ab_GFBr75?HAg|h-Ut<9ZYMBD^gpPd3x2TRO
zs%47nSfHeyEv{!vybtM^(gwDy(Ml#aaT6~oywB+b_8OrBs1-WuL|)X3oji#PXpj;#
z5;&V=F22kqkh=x)E@3l3ClGW|h?U)96*rB*JGrTwe*KAl2?|hX$zYRG*GDno%>jKa
z?fn2;xmNCDnUlS_$vz!7xrsP*B;>xf!kJF6n1;>d3Ee2ejxg*n3s^_2))AX+6tLSy
z9e|y{=@@f43EZx64x?Ref^N8VU1L2H>t6Ozz@eM)=>`bK$yhkS*zn*uFan2;12-=m
z?ivTM5CyTAusuXDj&PWZ^o@}S>
zq&_|;^NG1RkI&5oLp{DA=ZOV5PcF=TY5~F13v-`dl=}=Aio>%@@+h8Ln*aQ={1=wz
zgP~qrp8wLayqAIHc{5hzzq&I2wUzlZR}}!Sug>@3jWq=nGr?9HOJ-~;d6mP=%`l_N
zUf;}t1W$ZX6-1QwWDnI
zj*8hks%Gz~p1reX)~@Q=yQ^mJuAH@}lH;jbVD|pHIR|*a+=KPNyhDuyhk5f4^A;Rw
zTzHfZEIP_xdQ`Cd2!Hv}h84$nE05Q%I#ILgWEHR)I90v+WX;-B_3KVGu0JK%a7wh{
z6j_R3;qzA4@4skeqRdV=>dZCjibPvRA6?m8tq<>VEkI6o95*3A7BT0PTRPbwH)_LZchh=*YAtI6y=Vyt3%j^Yi^*S$gS(g%@5}bnfLPXJ1}&`jsVq
zGZvqFb;+G-$^13$HFe|Jw2kGgnXqA$)yh5XBp-ym)hU&|7PQ-&z~|_S%c@
ztPOs5&4u??pMP)7g%8#SeYg$?{%C#hhwFns-gt2W!Jllp=)-4QFMm1##DQ7c21){>viw7HC*y2b-nr1+fUumvi0r_Ktn-mT_Jtb+
zK~dSkQ8__3vV(7AUyRDR7?ph~8pt7t$+;4jcR4QaN?iVxc!H}51sw9PB^ChJfuw?v
zwIqT=B#>4Tl~ERzQ5v058k1QTn^hj0RS}m>fXGC=GCrp=
z0m!XN%&khws|Hf?Z$WB)b$VewYVNFI+O(sxWlT};`kVr`_kX>4v1C-U}mIL*9
z6%@SuN}vH@VO0Y~QFUWcbwhD=LrF~|P+HqWP|pX-c!F}Cu%ba!$)Tzd5F@N^64f+`
zYdO^MIS3>KLP0mop`=kHZ4}Fz0Evt*kqM-7KqzY#$`oG66(XQnDOM0j6iO+e
zRLTfcauuLPsAy?vZqWdW7L8J?QMPDQS^~AMMWfSFwCGy2ZC!GL9u01amb($FGMTzaDY?dgSqt$YY@q$HKyo
zhlZaBi=a3Oghx&SHp5Rv01>Anfk?l|h%;fK{$U~h;UQMTG@>5y~OtVsz-msL)G3M2B9E0Ya{jF#KY4bZ~U+#pu}Jn3&+0=%ASB
z;Mkbp*w~A)2^V9NyogJ@7#DvrF7|R<^tHGf*JC3?;-Y}i_#2_|QDO1X03yD4SVDAo
zB0*SUTu5T_^~BWcNy*oflCCEuh9oD3q{N4$#DyjU@uA5HVabVMDM{feDd8z;Kv-&W
zSXxq8DhDnSo|+VqnjDdy${`I1Pfw+YOizl*h>6R%L6Aui6`vUm#AT2$J~IYLxQV#<
z?BuxY6b`9Ce2y0hxoMM;$RQ~=B{4TKF*iObFCi&EAvr(Zivn*vB|jlGKRz`-F13In
zKBX`rr7$s-q9`G)*oQ=l^b#Ne$S4I8GfI;tkPKv&CTEqUWRoxn$Og)jb2#Kyq~unl
z=9J$AHuEY|^DAzmpfYU&hyy7FRjEKBP@M)80X69Wmja{|)uaN&wLn@)-DIQ#rFH3L
zb?N1G8C;lNUY}N8pI*VE$f#(@C~wFt=VewjWL5IADiIQ7QdDuMoIGkt0|=xPxfDWKu1K0A
zl4f(r5y_B}2Z-cAzPQO!Te
zP^B(HWD3-pBDJPa-2xO)Xh^(Jt-T2ihn7}~0TU)EOEp^(K
z`c`d&uC=LE+sH+DUT%_W>RSzJMVm&hYi-u+l$|Y#_GX1%qSQ;3ZOzIyrBbg}=v9h#
z1%cj&W@WqLc0hWws)GX}ZE`@Zm#YYxReA*hvZ44*$d!7TN-tBl%T#SLWafYfAoZe+
zLZX=pnYvA;(Mti9Ucv!Y$+?y*NaIO}L&%h5mss5<=1NHk^d#P*mjN1*4shu=E0?Nu
zGL;uNIyn|OoHv`a1)&a*a6o2>TJHspg~r@$zxQ;=+2I`NWkE#KCTh_OCLkn0N}EWd
z6JZzG3+O~z4v1)ULJr=&e->(;NR9Ajif}So2n3UWng!lNv
zlhH~*vsL?`qiCzqVeh22-3~PzeEDyw$6Hlfbz56?Yip%WSJg&PISEzBpw-s2w&D=H
zHeI8x6~xrg*4E(Vre3?S$EI*wTb!)UY1O$M8kfDf%OUHw%erjMT{flLrgqy@PJ1)p
zBAbAM!2YMu?6%7ZY|UI|0vBqqseN$R)eeLtj&vmlg~O&qiruEMlkgTe>>8(C?X;_0
z9GrF~2OJ9rlDZud!08Y>5!z)=yWHVucGwjY+0b$s+2xQrk?v49>`DR>Z?@Z&91x*#
zmEEo&aht+!Yj)bCE()v6Wy9$!TvnwIUF5pqG-Ym^#BCG106Pvr;IK;_HYwK_(jKl2
zXph2WS90wK)J})S;ZRKiIn4>QcwuXCPQZm5L9VULdwDsy9Dfo{htlQHIvqNvqt!_w
zT3V;m-r}-rIUs`D?E?-0XgN&TH3e$!EYxV*x6*qw*Rsz>eG?SDmYBF)?$-RyP
zDdM!^h~E6ZoE*@MiIz+{sNJft*;H1$%8JknrOk#!boI}H(*>JVW3#p(5g`L5E$wStn$Y<7tq%0d*@+Zd-q<>e+jBVddI#w4*ArDmhVViH-*Le?w*
z7?Y4Oi5QcZF^eoFp~WmP8wFMd*#xXb#F&LhM~GcqL}W7Xt&D_brYR_E;lP-YE;V$b
zpv+_xF&3G{EH&exW*kw>SR|;{WE5H~Qj!8#BxbXi!WXxoW(qWt0EZS>%zTTvX#$7~
z%mhNSFEd(brrG!w3rU{<;=WB^90#JCBt${R3!IVfq`Y9w0In6iTzrJwvFJe&M|&FS
zaT%u3Y_7*9V`;Loe3Pl($_f~U&sZ8+28leDX+VTS6Y{W(z+&R#xK>ugS`cYuNlxUc
zzZE>@7Box++sLp88!Rl3fbqhcp9ShC!B@|1_ud8;E6-vj^>d&_rr_2hlk1-VX%BKv
zJvA;fT5g?a{A7^hP5{mD0&!$+^n&3qaqgsrsEXmSYy)7n)Uz}X*;~s2Eorjg%Hx8w
zJe!T*+0kTW6c%&|lgP?6n~dm(H@hY6ITN=Vos+_s!ok9IW`fV{n%tLYoFqb7pb=9b
zCOSCL>n7)CNVUHDy}HJ!@a^weqLZfeqdhi+5Eh-1^Ed53-SZ#Nx
z%|DxS3(n=_2TUN4!}&=F$SLs4DLD04gVQ+$XL1VsCjpzd0swaTQN5p94+iXzjo5%V_v62s5-y)sZ$4vqY!*{y*b@fqOw|;!`
z#HurAR-QSt;@r9Qey7*?pILv_e}n&-b^d48p7C1^AdZx?{+rJDZS?m;xZ(6EWLtag
z+`2PoR{Nb<>vv||H2wtE`}u9~^V@hUkg~z=%tivg4W~|XdCqJ+eR}jLV@ANi5zfJxDD>rOJl*z}UU^q-kyr+RPT)RDPPNOW
zu{%_5x5nXA04_HfiFY_vPG^hVu5miGZg;E0p|U#^P8SCU89|=}Yyv6*r_$+EaA=+Y
z@*_{nUn_1Id4!BQI(gJ4!mgek4RoxlTWxp9;l^VxEGa}lUf6pZE9skL
zH-UU{%IGxQCgCRH$pSXJkk^p3YQ+Z%S%u54U@cA?Xs6S%!$oA~u4)S)rNOrxG%l<;BEv1Mhew8C>KHSpFn<$L#)UaQkz|?LeQT
zBc61u6MdLv{=In^ou3N$yDbakn*3+XV&P=rJ{o9mlHMpN)7xyj)a*VM+XSpIIawA5s1
zvNB?`QD|dj9UVMjmdxOoL|Yd}5RI0Lcw(d&A8TEIk%MPW8ck%3{6M`SjU
z6qv3mP41d?GfPY3hKEcn3YvK)Q=@NO;%)->_qL#9^m$Cl_O)Y5^ZpxfhukFY>uuk=
zXZ6x0?;k$2VgJ5WB_#?!)F4k3IE6vU4eOs&$=
z*aHVv967S)$l=vz&TMUMt;JsC0jc4~3Oxp96d8J)aN;Ka?tK&RMch@@10-z)di*%m8v$#nR&poPd
z`aHO?t!V%}3scX9oI_1-0YeyyVTDFhqt!<2db3&3*QZ6dw3zA40PMwG6CsWi^kH>N
z{>s&_mK4X13|r6}S*yTg<_xQw_xdgYUERk!|Ks>ZannG*@v~1~JLkV&$S-MZC}`2}
zB;vA&@Uvj6J-b(ghMek$e{PaW#3jx03Wr18*(ubhYYYYv%Qp9P>(;LMB+_yRs^TCDVBt+Vm9$V=eqdlewY21NrGeX#>cuorM1eb-H(ei@@hbtbMBGy)1Nw
z3OrxNA~l=Hw4I(F9exOPZ6zXUoKPAel0_mSmZo-e);QfFO>4%gwJ(*GQEnnnmPskN
z&v*TL3P6;^j$_dIDabGM#JPM~a5O3)gDMQ1S)4wMN^aMLq5UNRH3XFt1?1Ea)j})D
z_{`^Welc*Vadt){egjAiq%mmN?YW+G;5*Qt-T%_X
z;~Up6Si1OwIkR7fNt}~?<9xt@fOGqm%{4jMQQNjImdh%;yY#(1owGiBH96_(;DBj#
zgq=O>wZw!gGHJ#6zylHC=Z+lSq-d@zEWA-r5bks~gO%v$6&;iMTubg{;Ntq8)A_im
zv7s@3`LfqE>LP_AQz(k>>Jn&M3hHZP?I0jyja-s06{qT23QUHoW?7a-RnRQWZr7Dt
zjJ3L!La8`~-xyO}6>2iqXj%%J1WB^yY_o-@R24Px)46WP9h8hf$??liU{Y`qIxO{9
z0$g?S%D5|vy0n0(`%YeXBThD$lsJ*xKE;pv^pvsT{WuK
z_|@y5D=Uj08Z=QlLs@b?NzGGk_ty*DNFAr}Uxb}QuJ=k?ecGK{XW$v7}X3u)#*paRAahJQhIzIg1rBf$&f}7T_
zows+-n)=#Y7*;#BF9%ia+q>r2(JkPhHXYyPZ0+wefSclCgS)%h5uZ2r&5ZQ$;-ZAd
z9{qWEnE#c_C-&@K&f{g&)up&x3J?=zR{G%Yb1k`-fr~qpo9xb}dS3LhWv^&kigddC
zCVmuat(MEv#G+)UtwG37XyipTHAM63BD9*Ein41UBb6dsEJ$im=Lni&TD4it@`Re2
zt4ejcKpd}W%@s+L@gv{Zl-SUi$oX`zuyCh+3JFRANpVv^Ndx{$K(9ZpgRj$jcX88t
z0jbd-1lQmyb-7!tRtbFMwvK|5ioo>jqmBG1hl}s-lG_{tRZIG+wJ(>I#i7HatkEdI
z#bhkn|
z7)B%CY9%vH&D=yqIy8*%mNt9|pa^QP*<`dV9bD#iO+6x)ct_j>lV|SiHxC}zP*{-A
z*idM}*o4l)Ag&RZe3PYxP;^O`Z+wYzQT1&Z!
zQU+UrdpNDTB{lw!_}JfrluQ)&SD!|RZ(_HD2P@nl6du@+Lp}9iYp}D
zS`Dg_h~s(nAzkh&vpKJxcSR_UY!XFw_cdr*GwT{68u>9QO|I1r=aI+pAk|57cPESp
zZ2EkhzXFhJP6wXoz#j$Y<8Vq#6qWnY?&?xmS-Hiew6QH}b)`_4<8Y|(3u-nhY*wXO
zQ?P3F%(BwN(GjcFDueOPy~DuW)|)r_>j!#1{UxT|{ub|v-qxwOJvWi5Ih?UWIBt?h
zHu+dz1{@`kcQyd}loK=!CH-78{tPC3>M8ZyGS_+nb7Z?qa&pw?|kROwg9`@-cFMGyqy!xD%U;2GpTYYx*Z(d%=h(m1U)
zv$FCEhzYx@tFKEW@l8$PthKmJpI%dUNhFOHNn;OAWq#$T~&
zMll%+XR*okKrzGI{dZQtEU;Dx6_N+s)JWkPPfrAWi5h?uTsONNP>PI^amEgSlu4$_
zR{(f~GdT&l7z}*7y%`}*`AR@NC`-&wix?s0DJ0%G?a^B-a;HO+oOI>D
z{?(^WZUs)B*wQSo$jiO4X7wi{!)5`$VCm9#ii@Ljb3@!+O8j~dbCkTtBr$zsxCyo%
zr3P-(%M|2BTJ3yZL;TVuuW3{zc6%ek)bMz*?d@e&Yc0$ug)&ttOOVME6w2gQT~=dL
zq}5twG?wxO(XF~{nLJ)1jc(*$uW!88s?U-t5`>Z%z9>rDmLrtJDbyLPz1G6k5PBjE
zHTfwOjxO?zx%{=m0#%1kL59Pz>2|jeZZbDnZH)$VDPyZ*to01bHyD~+?q*GE&Z@Pq
z6c@(~4VpnooRXvXUFRm+?TL-U5el?-lEpy=<39(&8lMNc97=U|!bl{K%c-eC)4wX{
z(P=%@Xu5-XXmMH(fO_x?@%3_((C&~G7vB(x^W1I~E+0q~Y|_BXDlLt-+ms+0lTpHN
zDu|8_jE)L~an!)euC7jXI@Ppim`#$btkB5FGZ7JfVo@Q>$`y)=lHypmOVip~UtAQ!
z+2I&EPqEKFLpZc)7_|66|pP~
zc!9~>U^4U6nj*O(x4pBn(^#$3m$O!M&<1U5nVI3WwU;(4Gi8dj*0usDQcG)ztU0H(
zt;}rUA#OB*k2n&X`h3cF(Qvc>nn5lCb!T9V7>s0^5`3ke9*xZ=vDrmtrq=4HwmEBT
z4ss)GcA3j9Q){!lV0NYO7W5Brh1KPy-roG{VsXt>9d~5~y_}b~qFWsp*8ouL|%{M@J)g
z4aI4NNB|x|;l4pQ<@7n=3f~DgLEreSRbaJ=$W%9T6U&OgRxlSG4jhuq%!Dxo4uVz1
zkcb?Y0|W`6eU!Y>KBrUZa)H`7gM!;jBX+wSzZ)PX?so%LD4Bm~wMo#QKG%|a6O@nW
zxDOWxQ*b}pPN%%KHfj0Nch$-&8!NVuHBZQDDh$)y(J8UoR2H_`U=%UvJ?KUzvC%AL
zScTCfHJagZh^!8&3GBnd7Q;`s91b$epv&U-M}*$VEi7|8c<;TBv;HbUSetP7#DvTS
zs|^fQ-_cnsk!H)Ab0xAgg*ru{PL{}0#ga^=vZPs&-zbP$w&Hn?n=H^4ZtMou$4#=k
zOMrqyaYF`LisnH4(Q+6V!vutK^h~%oj%-7ajQl>UPpy^n~$qL0oIjRwBeS
z@t!ck$!)lYfp$`rpxi|LJJO-?6J1l2xN6mV+Lmg%m=u|9Os;_3Xv8JLEypjLh%Cfm
z0X4&ol~@>DH<{T&ey$l-Vl?s1sEUkm6Z4a@4nGfWKmpTSK}KHy(^%
zKG;p=<*`?<9z1(?Ye3+R;ETHgFKiAtzv*1SmJ1hl1qSZEaA9}w#U1k(yii@0Ix=kG
z#-ya&2*%9{?-I}}jOHd2D>AcUgNe`DWDch?KmW#CuRVUjfA8tz>;2DcIeu!}$x}Pd
zo!aJqY}0APPi{MXa);lkors(`xyA47j+3Xh_@CZ!_VkWphu1&$=ug&e_{`O#v#<(=
zfj!mgbZA^o4Qwk|h)$Qn;gZ9=AQ7j+?x62-a<69+D4h-zX?Ax>GctpMF6`~;)`3%C
zaJb!Cr&Hr{EA0+qdpg~6w9^KY&DqRBfl6Sz(Hb1E;~eTPx7y``+Y}rWw5O{}V{pZUf8$-ZvS=bVbLyx{Ro(v+;2k;^Twj
z#B|{FRKzlHCxtdg
zZP3L{M~|-S?$YCz64qRoTW_%_7^}!)Z7^Hw7+aGWMOeAnDk5Mc_)R6lI2H**7NHbd
zEzLGoYPa()UfOu{$f};6R?e8^RyUh^5$>3qIM=zyOb_B
zT{8f`PIN7SY1~D)TrF-_3nC6|601RFvx20iEFgOmaGAT@t#)qRWSdpl*@6BkV~8dD
zXS?NJ1cvLI`%Mr5+^O-z%~0&Wr*
zOid<|A~u>uM&GkJlfYsUSXr2F)fa*{967SKr@I~Lu(`V3?M5S7$TzbMW|n7S8d1=~
z$~w(WMpj_5hzv#nag0DrI4@EUSq|4~tqUUctnTe;BU9eVdqSUAVO-%mwVS-tCAj68
z5TUcTO%u)+Of~o~unx#usSMeq>63?$XbQEz$fi|HCt^%c8!@c@mvNKP)aY_I+iYTo
zLk6P>#ALHetybwRD>P5zFU6Ggyl(>h0=S%H?G*5i&8kA&%EH~?mahLCY&MnKrA0Qg
zNyb>{O-5^@6)-j42+pOjj)@*O^+koM~dL)#roOgPVMIliSs1HaEl6
z!V!%Y9@vc(G)p>6jV7yru}RFZKgduF=!sh?+bAXrOj~P%f;JpEyt=2SjaAiXy7}n@~$p5tO_U{F)u6v6C>o-B}c(Zt$n&Vy6D
z+$6GDVN|x8jK~Z(kQiU6#|S26ltws7&~Z{BfRn=IY5+aKXkslKHwAAza(E4~zsON;
zIsFOTDK~K=VKP{2C=ZJXhL88L8Y}APs0SHYZAfnbJrUChE#ux-L}<55+S_Z9PPEia
zmgxeJ2XX8*nHtIJf`qLma}%Yfsco3RH;J2IF-au3W#v)%`JuVFA=x?Cb81I^`~ZZ6M#du+&*CwPcbSezeRDR)*i*qXsuET`+rOXuxRi0iUjh`g9X^lcJ}q
z(`b+rUSl~hVxy@UglKiBtPX|Mu4JubA}gon4OSN1BxD)B)m9T6yy?i{bv@mkFbTP-
zf1g+IJLD#qc~ZtAbvZR|cMF~9>2j%1m)$N03mObfPFFLrfXMQ4+*^X&`#~USx)d*Y
zBH)z6uK_@3G!Z@^VR7#}y#QKF+}#OK!kXL+%1Y4rZwxot9n!|8^zA!lA3wgv&ugHu)XrwMdP29b;AI=SSTC!2g>)@8$jhoz=|mvP-+W6oi!+
zfziY#b5m@}_71U9$!lmRsjn}ot1W73D%GfA9&+=3OysLYzVW7`M<>RcY>F;-2V+sg
zJ~Eh_V1HTd%^e+brHWtQP*}&yudC1J3re)wdX^E}tOB#C9u6IRLyntZH?8aKHZT@B
z$ADiSH@RIc1qCsY5&ls(&P7D{H8$pymnGKMWt5b}fTZY?IDmUa@a7vmpdJ`mPG@sz
zX>>%y2_Q1^B%hx}9#?U1%yBLr8Biyzbj$N^A3aTOhEM0eG28?vx1k|*-u#!cvai(E
zCRJ4>)YK$ZRsiXhrIU$o8dR)0bfikgcpF-O$n8(`7W9RE${z
zSj-CUS98i;{u)8Xn^=>SjJsQ8tWj(;i+j5XH!Yd>$>?xTr%hWZt~`;NRO9Tb?7$DZ
zfoD=T7^OmkSlB5RnG`Bl`;N2w8?_B)V!TKS@~_{2|3A%{Kcj!3oi&Rbtfb40Qy_!9
z7c*OW)plm;RH8L9&b{(U2w`&qy}_y
zGDlh_lhu`$=B8)HXJsd3WW;4;MAuYjwd)&fR*}Wrz`#Z!+*BQWal>7*o5cP7o$J@l
zS+?|plP9(vJ+i5+EV-~CHaaR`$M!|JIT6kBa=T55vvP22VB^?UtK8*M(+KD`J^kvg
zor|7+>K8|kuB)s}B2&w(&2%O!;@~5eCC}7hlr=Txq@`Wy?QI2rbIeP!2ZL&_S+@KS->lCbIxBn@=Mq;+9tu|>vLFoMt
z{PUazuMG?tSc}+Um2`KhxVN2g7I3&=5-QWvVno9FcD=T&q);vs>9oyxIf-?(xmH#I
zeIyUp2sc&T!cErZE?2vuQ*L3TW=3QoZvUKfugx4G{kTDvJbax
zUg&>jcYmM3&?&C0NNH-yx7*e2dO=-XR-3NLW>c9>(zdpy;-a`GpS-VGUfHH=M0YV6
zCCGsM=mDLbLba+I^wieYkd$=sqmQ10|0opZag+DC_gA=SnH=#`o&Uyglfxmct4mtG
z{0*hDgnrr&7A2R5+=*#?P569A|Fig$*Wb)d%IofKnUr`3^?xPMSyas?@?@}?a#LTo
zIxgzm(mC&YMtckvMX{jdVqQkJN_C^8SZTA@Ds?g0C8|zF(Qb*$DX*5c?)AGMP^m07
z@}pi*5dORS|9STOnf=2?)Ni-JZc@TKVOg2MAZA&O(Wt(BIlyA>)azQ$2Lu!s7MKkB
zw3L|a%ow|^1=>fsiLnxH^7(X>o6II9!^%5NO{`63G)pgEK4UR==-b-WDs79ZwNu}b
zospcGe#7ljbDy3Svt%&3Cio&aZgp=D84Ldt*OT0lJK-j>M#`Kwj~w2dn-e1uRoHD>
zf4@CJ=MQh(Fn`sGPe1)+MthqmKJF4sDi~Ic4f%-)mzOPlzgb>|-y;0@;KxcTDSPeJ
zKhhs1n^l#Xa_#uBEys>-%FVfvpBH`l)VAIp{m~=quU(YY<*3X~&CSy@rS=dc-m$MawHS@Jc
zE#_v}hbm?5+iyL+Ztd)i8|HoX>8t6fA#2xs8Xp(Db<4ubmyf*u`XgFxZGBz3UeDvs
z#P`GXzsYX;O1ddh7R;hD7?mN{gY-I$psC@=p#$Ne*P3O*
z)Z{2|irdw8D>tn>dKA7`8`^2J$>5ZAcEX_(GdB2iVuMM1{rWjwtGcnFk>4b$t*&q4
zHKruSW~Ik;yIQS`i~$vrq4&w$#GUUgr%!RG+|<|CF?Y@z@ZFjk3uF@5O`7-Ld*1K#
zt_|zwtyuPPQ9)usUi?E3{vdP02g{CP9S$1FYFt+x^rK=he=
zJn3uLy@_dV`fmqA>FLXX6v6esJz$kvt>W%()vf81@9)g1%bqQXR{Lv1mO{{%Nl-7aXQ++-0LEsd;QVl<0mW3Onna+}R;Hg}qgom!0|J~p(h
zB(ZL6peMIW%d5|R;raVnrrB;&$z|nlzx8Bh
zMp$l6WMIJF%8HbY8|EH8vf=RI^)b#l?=t*l@YH|cQEY&MD8)k2;Ou%b>A&&-ml
zgu?Q?{FKbBxa5=@si`rkDN%X3@hWAF)6r})G(lMru`oM36y^-e
z$_)nLj_r%DUO5Ir;nnAWq~x-yz;g%S+#NZzskkWN!ukCdFCHA|Z|`VtGMmIshe{|c
zSh?~8Zb=%YUf&oVe)`Dawa1TbNJt3E%m~@DdpUgC4eRIB)n=aY+fh^$8x?g{t*+*#
zCj74)Z$h4Fe2tiV{l5%|CfpYP{bS*bMQAk(Sn>f>F|NS0fM;bS(*RLa`)w9u@~NO)~h
zX|YI{=X5HKMi2^&Ns(U9tFKR|GofrYd3$?9dis^Lw95tqU#qQc;N@CbRb6eCl~qV3
zWg=lwWo0rb?0>J_G>xwpq-TEx{K@5I$oex@wz<2j^=9Jj=i_{BU@Ux_x!z`}BQNN~
z7~$S9b@%FS#9Uf5f8OxWu)$_174fzQUx}*|W>hz&mQi7YQ`?eFCyGDXYN~r1FY2~cCq3vx13?gvV~?#qlL`p78*=K)~c|u3ad?H
zwvcsHSgRb3FV4MxoK^0PX~AXr(OXLw{X)JTyE^T1>h8iLqR{ifDE82IG<29s&8($
z8f---H@UQM*{rP0ZUb=&Sw_k*IAIv85{4B!oG9LCHaEb`BX*`s)8*FSH_F0DoG!J&
zC~~>fCbJmi?QkmX4h6%KcXPZSxg~%NdCUAJ@?H;tm;-GpZ9mDtl@*y7xbbA~UB#s1
za>PW&HOR25-65)}ja$9u?Pf)x!%61E<8lELIj8Y;fnNVFiz&Bn638y})$Se*d1sY-
za}}Gn=J}d|_A?e9!|+TNj+@ADu*luh8Wj_?bjfE!!)^nk5o?-)W3Gp$#zv(?$D~9@
zrbI=j#l)mVL?(sZNQsS3Pre>|L)ES_FwGWLTwEIUyZisYS+i#jkFfBnY>d=R-r}I+
zO#*{aV7DteI`K0pH=E^Tx|31LvI?>&n2D}SNoGV_EKRJHcRpzIvEysIx>``sZf_>s
zWG0iVjpjy!slo1$p&kn(GvX>)#hv6MNn8)Nkp9m=1;~{8Mu(&6LeSjL(EYSD5@{#5cIel_J@Mtfii{@W^SH6(+OF2zmm!u=N(E
zmSyU=8Tukvo8)JT(1*~3kVd9LV1fa8E4c4*-=rQRBO!x`T-(6+1YCdR_DT$l6hOp8
zR<5}#z=6;h?z&CBGCT`YZ?!kp)yJ(^Ia8r5wA#oU*u-ukWBFXpY5Y%s{>V+~R6ba&
zLNhDq?o%7gjfi)eU?89)k%dI=7DzvDG_#Ec3y*t&R$#OUd-`(fD(t*pGut>sp;BDw~qBfqt{
zq})rgHvx-@d~~`Iu&@nAbDiBOJbz*9;Ui0X`;=sX6v7zj|5Rms_zK*_5zQ^2`F-j)
ziJQp5aM$VakPSv@J$?sJ%4Cs)n2cann3UvI?>eNjWw$dmHHjYD
z3z)$GJtE}=IPENP+WA&<6TlL}CNFlAUIi}qa@pO&q!!-7O-`2(+_Z4fODc6S%L-wx
z!`?)QJ35Vf5M`w99W@8pvc^byKruzaJb-fH8+>JL1>_3+^p{r#C^xoVaWRMusHA=)nG<`ZrVNv33lBM
z6E=~V;~+~TYk_arNY-Jn@L7ORQlrh>Kw%}GBiVbiRd*4DB0qP12sb%gg4(*+lc!ee
z+A8f1SdrYj&|aTzN+r{{Cjh<0uSj=~3g!S^R|7gWCC}FkuETI<v;$S*>EDkv}ld
zek1bC@@4OJb!pYADy5=Aqpnga%Qc!xwWhSCwOFIgS7~z9EqRClh|suBUtCah>486d
zZ{C8Z2Zt4Arqu}2Z2U^k3NjGK%+y?}}s*P|6SeC40&obn@0UXHEcie&m5_p0(o8scdgGY~S
z;O2$@sr9hFGB-^CR6;N*kc1U3m}5cqeww`
zl)O^AXZNyS{QMth&3a{M$OtXN>8MmiyoUI?`dA(>o&fQ>*v7_0L~a9KLS0>aV`D0h
zmvZXlx?{)Ibh*_mBZW_=QdaQlGwNzndG$aFkC$9mo6y)uA`?jRq5+jB*3~Bn1nH>i
z#0fNeWmmV#YLmbdoO1dc$aVH{)0BN*0H`|58EV%MTA7NQ_6~BA{AP;;7L$>4=nRaU
zaFcgbNNO=RGbSZ~2v`H$WMmsSSDy|r-4;_uorFd*%p`?_JsD>5T4po(dOd39V1heo
zK`2LiCMfJK0OxL!GbWrD!pT=dY%zf-CB5CPE{ED_Q#q`vE~n0AYjN7JIgS4rI5=>x
zPfdl>LEiPHuLP6P8SdrViAQyxyYF8k$oPhovB*tEDa$BLMtQfpy`(7lx4-$}%vYa$
z_UYfh@Z5vXKl}TaUwRm9_55>xcG27oU3)A@KY&kNfc4(~lwL!TW!;e$DcM
zUYEma(yE15E*2oJnO&Vod3o%r`M59|Bbi9CV#(8{%5uXoZY@-+x+tZ
zySv?58`IpTZMbsjDEVB1-}ZC<+s~fadd`2#nbRBm&us8Nx7PpMYX5Vqrr>PAnloot
z0o!(b7t0
zc#sT`-+iMAz`5hRZeb)1g%~SBG3Xef^r>mCGl>LjA8^
zIS~?a`s$VAp&_TPT|E(U{ZwekX+*AGJ#qcoNo-Oe@$%(k5#eX^^I~jPHPE7|&CL!;
zO9{%(ypof36=81nwXBTG0OGerer`xc+C^l}Outf7mE7f2k^z!85z{$KHU8|
z5EZ^HH&OncasxmF)Fmd%baK=~84Bt*1spMvY)y=Jl!us3AO-T!fs8aYfqlquwMk+%
z%B{v`)+A%ekW-VHtpgC@>i<$8^u(Y-@(L1h)F(!rI8L0}es0&@9(6*i=w9>Otp-a=!o5hUMC^`tW|Dfq%Mb&L|B>KD!(0MPP@!z6}cS9AYm;c6v2-x
zV-lehYY{u`a)%ASwIY{O=CFxuR-w%%Ca{ZacHtzzN)p-aa4JFi^pli0DV!sI20qXA
ze}Kd
zq~hX8LEit$J{GKJh6#@!MKaD{wUD1ia1ABv
zsem7V-b)^K^I4STMskVyZz84%)ZYpXC4C;sg$#|1?>QKmeh4&8fZHU@OBkQD-y|mA
zue@V!!pU=2hn&B`z+vffX>*_503KMM4J^4N=u_!7Aee+wqU(kA_K)Z!7L~K^R-3~S+`b880un7TjE?`M3nM`1}%S|Q`XEDj(DgOx{
z`4(>SSt2*N32aU5Slm1t;!Q>q&tR-;(^qtKR_gU-ZThnI_HuoDxvs4gaf6|{qoV?w
z`u4K+jxvL>vZJ%SOm>OI4HAZ7?hrUeTR$}O=K%}F+yb}>FL@5eiN@r(fhoMH-UeVD}X);u`>xwNn
zqQ0!Nqe|CS*=cNO>!@w-tnFy8H0Vp2juKOQaYsj)zO&-)p}m8md=khtnZV@q&*z-R
ze>e15kNydK@ewEO>ZsIrRDEewPV~Aj4|<^xLD{PIc4#YsUSHMOS)*@<
z){~B{?!EwEh3*Im-yRyVJtTbFWLyv13WP=OxE6|VXGr*t>tWl&BX@^}?1+rm6&AMT
zdgz9*$SvVFwuOdm3lG~F8MZU@+Lnm0t>NL@FJIkqEqwpA$dlJ2jz@&=jtJcn8?`Gc
zV*8EoZBgOdBg3{uNA8LW-w_qD(~IyOH?WB?Vs~ih?i)7_hKKHsjof$R`nK5cT~Q&s
zVj~aSh&UJ?e(-w8zKDnek)gZdBX-4H+YohqLl~MGvE%LmC(dE&_4yo-;Y;S6#$7`M
zI>T4O_9?gfE&zv^a!|l`+$np%YJ0YaL~Q+PApH~S4D1RC+Z__NX9BxJ!*?V7df2wG
z$nBw#Td#(02nk1i7{+TK+NeCDjDUiZ2jN;YRli=x8-ks
zvH3ecN8)D0>E^e8vFY2t+Wf8i)_><0tN-CQYyajai~jbfi@*PyHQ)L9%5UGd_FKPP
z|9^hH{%?M>?(crJ;@dx-^P`7XDLOrj)#J4G+)Z?In38x~AY0cozESv+clIyGm+l)j
z_g8_-X>)!RAU}>m&$`!X?eoFG_ShM+3v6I#9X8h1rq#9SH2OAadz+wL5AY|@1Q?Ct
z`ns%DD?iq@@cMc?4V_Z*(Hb&w3{>M|rJF4D=efy5zAgu!uE}cWC#9U(zGI%pGcZ0j
zIzB$^@eGZ7`aPcBaZe9IU~C-W(D>M}XMB8o)C2GvMHUm=-`hVnIyN@u8OQEnkICq$
zt!|WvC8J}gVQ6T4c!*T$dHwx;|Ma7ezklEI@7}licdwrLf4|@QH$PqRyEoWUkuffP)Z+n0
zy1K00-4>Ti=XSNY-5L&R4l1C#TO*MaE?M$MOG|ZcFL`0uVj+(mZ)ZCFId0-6bRa_B
zLWbRBa|q%SPHx*i+vDj1lMIi#S-Y;?AT=^_i%ns)NIT7vc7tSi)H&|y1LKU3j|`6t
zH#Rj64E7BS_70B@jCw|g$H#gHhFGghB5Q8s*N=F5M?5|Kp56hEr)S(V^TUIG|APApqZ`}v|%;ksWuz2|TLYr*$_wc;P|TlU?bF8lkfk0=|BA%bhi52KU?;XzghM7
zKb`kaKmF{tkFBt{$yLO4ylX)9xM9=yUksv$cMVhe&leo)&UzY1<*N#g1w({l@^ME-
zMxnSvqvO!`erUbj)!}sO>G#SBlaQ|>k;x5a^6qq#%`U3vB`se3szy`RKcHo~@8*7)
zcUC5IlNWRX*u=bvCWlj;oN{*ij``!nL>lNFG}Jd{saqQK?GlBuPSaA?(ppu^OLMyP
z9?u{y0j#9{{s94BFwoa$F`I1;yWQ=w*lh}pTB%kFg@Q(20~mMQGcYvXhf{QqdtUqa
z_}~4^<+L`*D|NQu$ezox5e!uc3k8S$#BOCwacPqa4(|P~$yX8N5
zY$NdZKb!LpznK3|zg+tBCwBhVAGdt#U*0=@wSNEk(trNt?Em=vitqkx;otpi;lDn(
z;-^n-`u7J`eD^;;y6^EN9Zqs}C*7*Mfm?rErt!ZGQ*QUyjxT?#$vM9y?m$qA9uBNT
zh-n;d5my_Wqp|Uk@o~64Q2Bm`qtoGNGm!=PvMfH`r`4t5s?=Hp20$t&3m2
z{B4byCfwwaO<`OlqrYC+smq>`Ugz|{nl$&{rh^`
z`v+BgL7K_j41OJl`!?zs8XRqE6^O=7Xf8~LM^YP99_2}~N{q&>tM{>8EEZKOx==J$Q|M0U<
zfA++hWqXp>9?AUU8@vARFF&0*``nge#TyTm{^E&s+s~$)j3}P7`Rb~J>HqQIivM_U
z`I6l+i+9C-xFX`8e>wlhkId=lCgeXY(=si0BpfACx&m1t0;VEc_{AS|IgL(xo5?6<
z7{J9xbE-tI2D&C#mU8yU7<
zz>iIe&&kWk&dSJ6%`M0*N{o$FsHDA~z8;U~)sIho>z_WDz4H3WOI5#qY}xv~N!yNO
z{r!Kul~dKX`9RjE%dVciE_&?co%j85c~GSETnPVsgy{88PxxP{pR@ehs;%jtEWWn=
zSW;G%>C@#G_xhDD-IB0uTWn~G{CIFlTo&`m;>-W?^S9VuYBx>Gv`ot#$W3k=1#wz!y}{7Tu&v#_M!Tz3tFNzX
z$m#2K>f7`!+E&J9E3c`JOHL>($xly9Nl(noNXk02|3Gej){tiy+%)6EeBcO*BtiTp>bC;T@?xvAT2b~`(4R!wb9_8YG~|99W{)_1=BtzZ7)|6RIxoP0Fb
zC9kbbUb5&TwL;L}Ycd+hBHi5kH=lRw?v$H6o`I3k-tN8*v8>c=Y2`Oozy0Qm6=mt2
z9elC4*kn=-4A=(-?E^!0SC_G>y0Ev$tyZZtE!t+4Dmgv9LC8-`j*pFwx*B}Fx~%R-
zctl!8>ab_D&*ORN-Gje)XoLUNri1>4JC3FwK35bN+VK2ayV6V8=il7*@ArKWk)mF`
zBkF3b^!1OAyglngL2dVjJ+a}*(jWci!{0x(@rAdJ96eur;B4-s!<=2BFW&YP{
z_xmTk^xnozd*feuXaCQC{}J0oJmzVcmT9>oxyemrW85<~N{6CGJmUlK>0FLBmrI?J
za&g(xkCrd}Xz9{-mM?$%(4kdEW24h8tgDY-w(R{Dbz^^jhrz%n?+kvGvGA$*95>Ay
z9qS(V^!E)K%PNz5dQDwjoiQ=z-EK{Hx2Co>-OB2~pkrj{eyD$-uehkl%Ca5p?fUk1
zfmj@NZgDF(9}Kc(@o2?+_6mM
zrg87qh-a+d?KF0GwOef>mAY7^tY~SeQL2iyt))s;VTYm0;pWxWM=o9ZhFVqC-`{F7
zljS|X%=%4VjhjZt`$oqdwY*$)OH*5$P@}1CZLQI0DtWxz?k)=&I!;EM$NGCm%1UcX
zi_2g)X+|
zyzk$)_&Y!P?BSV*pLq8~TJ6ZXqlKTYkN(4}`~Lptvw!mV##tK@=4?v-Xm!l@f4S)X
zm-l|QG2x@NN&j;H+K1mf_{cklzxBgezkcq}^B-US?oSrHz2xd=>u*5e
zv8>%aJr+JK({jgh3pY*3m}eZ;#Q=P|E_a)SZL~R>oUZ2X9yM95#U*feODt@itGm9T
zDSE}qx76y&zCMlF(!hGxmg7(1oIB?x(8$<$|Cp!CYS$W!%~qRAuO~0>kr$mA)$m|9
znHexXIyUAR8}W4L92I3XLV=*9w78(CFeEHIAn?Mq>(}Dr;;&u~3GfeEFmLghvjO0X
z0gva6_ji2n-#+;6k5~WQ&$fN%zczmFzAfMS;fnA4Wc98f&A&gq>;L?C*|+|4*>``j
z4k_RI(aP`qWc{~)jQECc|JVAz{rQ$}|77$3`LA`~`T6p1|9sj1`N`V9`RUeg{cy|Q
z|9tm%e!Ss3KU(v5|F!=A{9y5qAKjpLd*B&Q%d||(9m!2@BL8vW*w`rHCeNUi)oWXL
z&B`35Ivci9v!YPllHaV%Y*u8eTXHqJjPj~0D_6bQ(o)&mr!txASX-l+eC6b8<0dlR
zG&(jo=IJB0&iKICXphaR9UZZfIho@$veLBl
ztnl!tq@*NXeSKa|L2PuwmCGS*`c86Y9?wU!_x#{zAO7gKOMddux_|%e(w{uM=7$d~
z`H%Y-K0IURkN&Xm2M^5u@k5J$^oK?NasPtWJ%
z?Xv&){n8&kyx<29&imKjE&S1gYkqM5x*r0+Tk(V6F8S$0tN!)APw#(r@w87jEz|NB
z$SvG7HZ~5BS3tP&rsBf%;Go0jFKiDA-X0vhKQM4l@WtK17k6H`uoEd4f;R?V+&X8@
zj8<)9U!UG!0I`6BZp%D(&P{`(qa$Nv!WH<^Gcq`AF?Ea%^?1exJ!3chNr@mFEQ79D(MTjh`8mz}#-9ROS{3%pix;d)8HmF%lgSzTzO_bN}zv`ouam7ClI;fM(`
zHaao@ZYs=A4G%pR9qmsL6%-wHF*+(RIvObf(a~q4V@^dzo?N)#{ni#~Uys>nkg<%y
zLKfo&6HTF=JLIMXV`Ff?;Ik3Wj!gd^9`0;!@r?F*#(OYpX?=x$TQ;U8uIiZKI-X0=21`Yn8!Wj>EX(vp1xu7Ud-Sq!7w+W
zby}unTJA`0auY{PToUCb&!EMmwOh5^B6bp%QL&7MWt+(-p;$Q*-CZ)FD0|(Sxh-m8
zPq)ErlCw;+k$i6N>*S`Pkx_VUePiP=jz-2uhfRjo(P5Xz(>*rg_Kd-3LX*k6Hlw4X
zb#?V7lW}Oce|V&y*nVTMvphDNqpq&Dv9SRsHp+3+$QYT)H3lne6eT?(kt8W8B{?}o
zBoYx?CNB!ZQbT>He2m2Dq*O8ijFcE1$6jI(4PnFM86NW(EjC_b6GucN@Ic8dbz;z=
zj%k-}TBhZW1qyWwH*uN>5TDNJFm!iy*laSJP0D>bL1VKubDJb|cS#x=lUFSNNUdz@
z>j5{(7>mqk1j&4T+(Z~)ba33`)_02Z?ahV`jat=cGRoT98{6B3LxXP6C{6;wK>rxO
zNixts(BI!PFwi|VIy^iu-t8K)Ssl&I@_Js)IJjkuP!a;r4|l2_fl%y!_RJaoGiT48
zJr{6JCYOzZl>o3a;Y65hWD^m(IWi7o$a{srN;vk=*m!Gudr@f-wnnf;tR*C)U4-T6
zHJ+AfnU=3EH@S&!!Cru^z*!f4T`rT;(Mp$lGn>WarC;tXUoLELxEpKgqL(arORcKy
z?{6pTos-E;w`HC?<)-m*5Yy1$sG*`ZLD$Cb?38tOiaI(Q^zD^(^(l6{9vnj0Y0T5p
z8l&r}z)~r;BBx2<49~|iJ?PjcuL?#{u`;3nuj=gQ|?Wn+DVdW}?z02O(p@k2J
zuvslPF-G!+AF-V1MV*#unU*^c!b{{2n#$=db!&)sGSb`aHai_!3)5&JpX?@|e&FIf
z3)?{F5Y*O3ELl2Jqp2Dg(305$49{q;1Gh}!oIBdqf5Fa0R+V50z
zbF;D2k{F*77izTTE6_9mX`Yd{x*||d~k$*
zd}Rvf{6*X}I@UWl+R-4$((9X3lH!sRV$)NiWU@k;JfC3{?k;0@58K_#n3(3ehWy?>
zC(D}J^%@&%Zmbn1M5h+z7iMRtXJjR&W+Vh(xhN2e#<^i4GKfAteEQ^(Gk(W$wm}yH
zS1w;skXty^Kl<6nb2o3;zJ1HCmCM&8C8Rw5=;Ik_Y3ZpcM-LrMip`w+$>Ob>wl0`I
z=kk@nb?cV~U-B;~%v!f@ZE(<)^MTiLvPvT(;_B-fV3ffjq}O;_re#{by4>U@j+IEv
zJBPqC=(KlsyE{ND1Y}K1#l&Y+$WlvoXHz{dVa4(fH0p-F-gc8o#Ih1%TYZjm{!(rl
z9yJLi1@h*az`)}tPwYD%c(|f6p;=jCwW_UFy~AN~I+>2n=9=2Vp6)K4woRvPH5<*9
z;j^dD;G9Jw>7s>;0s{jFhK7Ij
zo8R8JaU(S3`u1(x6B80Yc>lw$u5PQB(yJZ
ztJ$=9)0#EwN=vKY%Gqtswl+O?EvIE#rsa<1CO44{uRcL}2{+lT?Ok4OB46#EG(P|-
ze7mcmju*Xb**j_#S(Ddf1YwE3%y)gi5;u|Oh5Z92zA(S1SKnz6Yg_pponog;C6Sdd
zta^CZJv=lpG|=DMYpY{GMB_*Ze
z9Jw)ZoZ)Ejxu8RPjy22ML=yGe@4Opu{#@5U&pRK#TTxw7TVD|w85SKKy?Dto6j8Ud
zel~kf@WqRpH*c=4u1-r!D=I2lym)aXC+pX*KX~w9WMrgLsVpcc;Pd&oiX$U9#I#Jy
zwA`5xULt?qO(NrD5SQa7TSu3xom*@d)B%10D6tT3a=7d28X}f2e@mmT@9#C5j8Zc9
zl6ZfgC!fE-Zt{4B`ua`PHR+61VRy9H?X9d;ZF8uqYSPRWHAi0Kqr=0)Lp>$MIeMMW
zVr1HNMukj$BO*#7kt8IfMG};)s2%!buzIm@a*}Mr~EHn
zy|!iB#^|_+fzke$#Mm?benCOO`S~T~WwnP7oq{#g(P`YeZJXp$hL`{VxYbESK~z{Q
z4hjl7ckbMU3l~Hp(V;_!q*5uE=){Q=b#-5^8FZ($#Gm9~&U;9~&DU>aD6QDk;iS$YoNoT&-x$Ov}y9
zD#*&rjgE@Gcqu3^KWod@b&HqGCG(uP=lf(dd~94Mmu6(ASJhYO4Qh=}Is#X=%bA&#
zo0(DA?H=!Pj>#mtkzvo^;80UjBN#^}lVxUR*3{IX5^$f}?Y7x$;4Ey`*VkucWGEC0
zYB6!sF{Wi&rsdA$Ugsv5MX)}4U2eV8+2(ZW+uEc~SBJyV>UOt}kN1p?f}2S5$47@4
zb4O!CjabAlDJsg&%n7{~?(Y|H?P^GTeB70*!GY)f7A>9~5_TCC!py=+1H&UDqvOM5
zt|s}8%Me+On7ri-((;UO)4In-Q8PmF-#A&W7*S#kfqlqqFphwz&`s_!=gm06X_=O3
zxg#NpP5!)_MD87KTHqNU;$~NpuRo2Axjmk4lc{BNw2QnzHxBfX$8BgWIRnz@zFt?C
z+oo2@MM8d6c~xq1dVXHMOfIRcF3!kGNKB5h*-hZ4(Gi$Vq{JxP!IA#akzVe}-PrgD
zc!)3-F|A-Mc}B*@2gb>APhh}7(irlXfXo5&aTBE~kR3v>5_kDXIzk$`t3r63fyZ(p}Oi-5r7`-CfcpC89p({{24>uXwrVI&;m;H)hTh
ziHw4%qZtmR4&P@#%F>#;g#8}HMUgjL&}18{C1qx-ZS$OCrA@wK{)uswacTu^o3s>P
z$C|up)Hc61;uMESn+OMF*PgY6g`fuiKpT@EB_HIn$`j~Nu!X=Ww>MM-3cAFL}reNy|V(_`*bPRq|%G|9X{Tk=++vE
z1^x9mH)r&MVH3@Og$kr`1e1=R;aA+j`k<_=tb!Q65E;xj_Dy4z+Eow!J$hVuFDysq
zt8{sd+E9+o_4R`C2wy#2?tS?v`k2J5C@wC(va%9S_tNWZrFkNqm)X$G?Zx$jLJy>2
z*|E{)d#TW@C8Nsg*VFdRf`l-z6Sk9tsthO_LjB{-M?AqWXLqXZRFw^Rk^myp9Uwe)
zNj+(1-m~4)mydN1s#-aY;m(vY26X!Qlu)eawWNNG8rcmhf`$k+bI|1i!>g%<#q*9c
zUS4l#ek~i&C8&in6)O!nqy6an%P+Wp#z7e5*|xvy_B)4s!?F??LHzxxMBFBQ)N*87
zVT}1Da=T&sw5vKSh8$@GB&2GH8wU@RmDFl0}BhLsd_UrEX{5e@os*i1-bSy{ABN6|T)bCRPTJSGklP<6_KITfcOV2WJ
zG^?vGT{gO|uidpeUAJKwfZ^G&Y_?FciC)XL*+4@qw&F*A5Piggt>74;18!$uz>jaa
z=rlzKGc%f6NVz?kDp$B5O6nH7C`J>0cI4Z^|7Iz?ymp3YsK<~3W(pZTutJD+0|x|b
zM#z-3Ae`w$1dw{aj$w0oPrf2iYmIB59jaqKTZO1~!S?Aa={^r({DCS4h&ebR=X
zt+17T%^ZQKp{1(d@9O%-bDmEH5u#rk0Dw
zx_wxsTZh?PXz)qX_vTQ;3caFGxCzURJ|RLPve?{~{t%CxDT5+)6!;q+K3i_YGQ!4D
zpr4D9xO~o7{`7FQyA)Ol7u#o(gF}-3hoR*1zvO#={4W%LVy7mOCkeYttxJC>a}SjW
z&t5ZYN?lTBaqs;kibhA@8{3$|`*>6ezlIV5KR-~J{no0i-t8&59)J%I%4p83AgQMRLc^u^kC%zb#vtJ-E4;_`)#RmSQX>Xup
zH6f*(D_-Fq6uGu$^k4xuWB=LLhr)@qULabX_enXuD6j-d7>|_T?RnVQ=>E`8{rmpH
z#l=NYW?Xd)lN_pxm>{$_Y_Pys;(qli2za4Tp$9ixzNeQd>s`JcuC9Eax7k-)oMczi
zxD7FnK}o|yLj_!CpeIGOi)6C*0*nBOEm{$C4_tj
zvV{8=w%;TfSpbEtwETC>OovPNf+G0t+)S3!Ypr>Yw{(+(#p{A@u*7d-a!QPx)68k_
zfE9${M))}0et#aDagV49opP-?or0^XYRXoRy)Xtc+K$9>vWk$QJVu
zeE~lURaj1vM%WRBq#tXD10mV}7FY>N4hlu@&sb@7VaSS}4NYiqUKe*I!4ssVyTQRF
zGGW=7+k$~+rl*685xH*QIej=BA-r`c%5j=|P-@rywtcbv%kQmx2k6S&ra3$|`PMgz
zZWwz7XBB5lQ`($4z+dK#OK(@*=*(`*-TjO1fR3~lCS%3n%gB(+BpV+`PlSJQn19c(
zrmm}W;!X8v$IxtRhvCnj7Z=mXh|TNIW+cmIrE#u3o1z>-1csOk5K^)sR5FYx>61RF
z>w+{%VPRptoEiJ{yYAoTo%PUyr772?x68}Rqw#bh$4EJ;zYmsHm~RVUr$~O;;2NFh
z$8wW=Rvumgkyb%t+*0S
zxQd=0hYOkrV7e^@8964RuhBz8a;~#Lu{HZ`)a^%RpMdo2
z!ajm>P;&8^n8{XXak?@rfg*}!kH%!_UYBg?5kw3gc_Q@zuOlidszpNvGYIA(3L#FS
z%A?M5J6jQ&!@D5HE7GZI`109NQ*3P8o<&to8y_FvubX~@maF*ZkMGY#QCSO{
z$M9Bh@J9-#1ND6QiW8N7_OT2x!lQJmJ{{0lvo>MHMos>AgW2VN{x4BV4y(%M=(yMH
ztjujJOTgG7XSG5P?@3w0RQBi@rdxz7h35Ub<#>KHx8O9_s7{W*8L2!_SV)S?p|`=g
z{UAXQ(a_gXS+hN49;YTU*e8?yIBi@Av-%eDMBX^^qTB?9
zatb&qoXWsnDhi9b?}Nxhe?Uv$#FO!6HTH6^>mF^30&B(lIDl{Ia4z&jiAo?&IgqAo
zR}ywd$1Vnfg3RgL+ttyL-))5dia6QD+>X1J&8_k8lhoJaUXEhnGymz>-bicc_sV!_
zv;(QY(ux|hg7^rM)_w$#!02zgCB?)d%$EJ
z6fo?_4yE#0Z?Jv)RPjS4ERxhz-{2X{Ae#KY_T~WGA%1jTGO7-Kypbzl=mXFsFg6w(e6wrI7sKD7JA;1}yjUtf%FNh=)D8jm-iSQOOZo12@ZGp~rj
zV9#+jKC6z74oBhDK9nrQCD4vnCy;CT-wI$Y!@KJ02(5F~o@uhzO^*|e^1M;-oTZq-
z8+*Nb6Y1#zL@Eu_;a~~F$65)-doB^izr#{=-$L_n-HDy~^$kA!c5*#uGlE^%Y0eLm
z|GMTGPplz|m>n|Mp6VZi=_iM^1+AU*7w|e6mKjtv>Qzrpj?c_opPsH&f2B>-diU<`
z^70U@4~e$zQUAwbJ%ws_8J3^FIUGY#XVlI_9A%qVU0sbpAaE&oNJ&W%eu?EeRlLR>
z!2h0q9^c0)$kH6SwSMaQCslV>@{gUwlZmOR+nna%$Dp3y;>m$fib|sxdoY
ziQKvw0U$A&$%?m~a@TT_Gc4+bAtiZ>rh?x)6_vHPvGU{Nm75!tk6(7YNN~Zz1ji*@
z(nq@h5;7yFlu?(w)slD?92|UO{_lE!;{J4*go46*t1tNJ$zMyLvmwVXQ%tQyi0&BIhLVWdBy%o>iU
zK4g#13Mec*qukn92@w+nub|CFS*ym*D}B@CR9971S5iWg)YjHn)LOI`VIjPWav>qpHB&}=Yy5^AZAvNA4{sN6d?%Gpp+CbVD_`RM3q
zGb=`Z00rX{6_sn52Dm4FH@8C#P#~Pb&%T
zD6DV9BQjy&U~kVwj%#0fM^KU1nEfsH<>LDKpSx9;x8E%E@AlJ86|9D%$zFP$M#jej
zO|gg)*3NDz}n4%q06*fxVee%KAGIz*(z3cRY}Rv=H|cC<;F`|^Uube
zUfhC$P1V(o|Nj1oAfQ7gVK6}657?B{bupH?V3O3(!V=_nfh2pMEFE(0CmNBc6|NJxjr3@s(BITm1d~)b{pYe7Q{q#=5%d-rl^2*d-`|GP$;>uuJd*
zn%8WmfQ_G@UmsBlTA%3_h1}L`jcM;+AX2y3^aR;)31IqQf9cRMLU9KG2#8;YsKW06
z_$BZE_vsf02M2qz<1#;`=@y-y6JJFl(ilK-YwaFCK3sH1NC?<`lT)s&tR$e9$Vf}W
zM3bK^$4Q;Nn-XRE?`bpEey$A(;n!qRx;(<1(MG@`(@(MrA8UVus4@zjM*Wa&QeNCuiTAf)D`ZytA^}N>ogs4|56w`+$zvV;tSv
zbCM&~%6=}tE$C%cPJ{NiZV!ZqhaVr?YYB;pwwVuN(jJZ_F^ldrewU&lCr?XB2_?<2
zWC*w+;tW2)`az&W_Wse9*^P7@0d5cj3=s*~WtnS1Qtkg$OLJCU5vrbyY+I$DgU&Om
zpR=V#RmUO)8QLbK+wdzVx}_BnqM24(z)>!+3(-A(D`i8CEkz=Wnwnz2sTB_oP~#~y
z=;h?(;058^tBYCxzB}VHEN@2J@I7r9g~;R;6hPa|%s?3uSOm1vOtgaVFMWM|SwaqQ
z5Jv^D4dBI#lHlFl`s_TvV-8Xkb@f+4eF2NID{SByFuHip!Hy#(ub*sU?!LJq7cw6t~7
z)6&vYwNpsbOIgYW$~?r^>CSRBD@bFd+p#MNg12{n{J=sYm=*H-lPHkib1JH;ic4H~
zNAUS5s%iELF-}fS%%vF#aiZmzN)U2p9>LE3)*Lkm+pO$tbIpFzB40E#v_ys?&5Cb%
zk}>v;jg4^%y8!i`C{qXrVPQpthMMsbs2VD%K^DVkFaXNE{XUePr7T5cpT03$X_j52
zP?b3-kShnIl(RF-Xnif_jszK?BHq&PzB6#ItAK9}B=T0fnx{9mMm^)=;fjlj0`|G6
zs;R|AM|1Gjg&xfvw(={oUW%c(-cMD++6y$XrJ
zI}lQtNCl>y=R*GrG`}OsZ>n+yA2+Vp0wUb^zDtyaOp#=q&N8mV8$je(~VxF`bG|LhNGZAX*b3$
z_xpP$du;jY_rpK4#~2E!vw{+rRJ$*a`bfuwf6+b**u;@)G9!E!q*=<7DiP=L_lX~2hz-uciuOy|$9tD@_
z|3b8B5(;5q%E^grOR%+l+_UjlDvWC4%!<$X=>6+X4Umv5k4)!*DdEGyLcivgR
z{Wl9NZ^8LB!y6ULAKTD6iV?=TLA@UFarhN!5q62e+=x&3?XK)uUXt4P#0`OW+fv=j
zBF9HG^opW_3L}G~5d|aca&O$`A*O_tYG9-?}DStV3HtZLn-vfG6LG_6Dzf88>c{Kp)pvC0N#dNW&sFdYC1uZ&xMz^Hyeh%CB@Mg_>{)!k;_jXplq%)=WV=D{|8ly?t(~ch)mUKaT*#J;9;WI
z&hg#5ziP_m$6)$MmRt%&C(Aasb!kZ}rJ=g?fQ{&(L~a8MK@)Y+cJQ
zWaFb?)DwL5;#%#pe9(GgVnXu6-RaS6SqKuzPPA1HF6>JoRbp;StYnAfue{C08ZId*
zL2x93Wq`*5?mR&L2e5bpWHHYiHFXMK1`LbEY
z1Xy7o+nYisGBRLl{*Nfc{n5V1=ZYzpZ=XbKUigYzEYy~TX)GbJ1)nH%X}=0YWEu!S
zBWBM;+#|uTJbvzz)&FiJy39S=)Gb?!!ssYwpQ`hKs<;KPwIp~N6wNp%Ln~7H+$_3zxF8b96Awk;P#p_Or_p?=(FP|VddiQQ%z+RtC~%8`Y`>^
zUj}}VgMUb=DXNim&F)hz#=NbYzh;Xhw4{}q@vb0b;co^?dFcuhL>P_GU3lCg+IacJ1T_6K1F|7n
zF{GOZ|Is{TH_y;!YRotbCJHZPo?&&YDWo^X@e#1HDcG7ztHhBKl(p4Lx&68pnajG~
zFsYelH>0E)g#KI{SJkTP%~2N-7FRheDH8AhDlEP>dG4G#$lWM5411lX_ML_qH}0cQ
z=E(LwQB3*b?$H*-+4J_RQPi^t%Y)^Pl~F6P`%jop^&Bp(HeZ#<_dcaWb`{Ht=~n$jz`Bk#8Sfm`CnLqtTxcTigkystWqE(Av7B~L8aIB?MU@yai^@L5O
zkafVHF*Ymxw!pX85rd`{B5rG;riW3#R822);&Voq#^AD+&YRMmZ#d@cQ)*V;6~C^S
zzcN_O!hBq3mK_`n36Tx?6FNNBT7suK{QD$1|7t1Cw_|Z>7;w~{e{a8WNxpWXPZ-&~
z>b^j}!~3!Sj$8jTB?TBK=xF8>0M!mnY;6w#Ui&{e%Vo0%=nh*q1Aha@xmaf!F+2L>
z=l#Vd;Xj9yg&Me7n_a#4mSK&4Bjymu2A_k^1OPQ~LXbqWSw9-P0O$(nL3i}ZA)es^
zA>qA$A5RJ}=brxlzQDr53MrJvVSo4!QM}+H-Lq#R#~--7bQSdjM3BJ8qcR7FFN@?;
zN`hq8{Q>F{SD**5{1maC2^JweDNdNJ*e$s{6VW#!YoY=2knI*g8)?Ea*&B(YNs2Eu
zsL|PzbE@AeDlXR8>kCE)QWro`6riqEOw|I7#I-hHE!lpBI9WmwY$aTq+h6eb3i~6P
zp^PuJlsn*OGH^|{RXX!Gkh_|5fm1m1;Vn2~aPh}%z_y3@%yq+bU?EHI?2_l>Ttj0Z
zDyq%*q0z9zo7*?Mp{Wrgh}Y&*bbvT98gMmCArn*1AaBJ_
z1r%1SpkP*W?cm?8OnkW;0r$pj5w?2(yz7VG80LvWsC{Ee1TiBJWSGyf9b@iZ-7Q%H
zupUElI}7ej2%`}Oj+bno+_C`I;7<@mPg&+u0q>ho7ipkEEQJiNFRlF-;fx%
zg->u{Ju0{c?J4j{bHo)|GsqgzXf_Qc68=_}ABdA}0Z2PjKfAiR#>SLf-RSj&fDqDDj}L*ItmuTs;smGrXlO0
zm_*Kx16OS45)$aQs#lUBGt)0dmuxRC>jS>XCCRL_hryBjI|u&aVk
zQ&!-as>({~*JC(Np=jwTDSb-)wGR(Id;?-?eX1TmzG2iL@&FfsSua$rnW7YjR@x`1
zKI-YupMD~xh+fPES*Esv&!36q5a3g&R*VFYPRGy}&?yQ?KQp2!N3@_ip}%4x;tCNS
zlq!lt4e66Z2BRzEkkb-tkjr6O;@hAG;kVGYVWtr|;W6=HP74n;;QmmGIK~3fJ0%50
zgrlt!AZ*|5l+;HJ7NXj6e_HvU!uhd13Mq&EEcP}%)yf!8Jn+{};RMCK`WAw4v6hxV
zw9|4qxwR?lxIa+Rfjk=zEe2cg#&`CJcZ;p*eBu96vNOIg*ix$_#mn-&;fLIw#>$$;
zlxLC0eDld=K5Omq3GuG8{heFIwqdBh%n7TM^UkNg+ST~9Gv2l8|M)kh>9H(u%+|cE
z3E4o&eNTw5M?+(8F4G4_I?H}64CGVk<8}2tJ~`1(Q&mzzF_(E(*uayHD@^3Y7&2|^
zXlq+uQ$t5f3wnu=>eJaG(h8$4Kbqd$On4)W&u8C9bXf)`JEfx~it=Qq_996bMd$7N
zIl#EZSOm@KnVN!U;e&pBC`!nxGwqFEF|)~>e3z>hA$kpnt@QYau&}R}V~JQ%P*FN%Xk{3sm^nACTK9G=in%6!VlL@uS;`%!HLN
zA6II~Gnd)lo!>o`^5)3)1@Kw>1N#&a8F&hr29pi3=HrLLw9Bmy^K>Zhm3H@#poX87Ppk$F#xJ@Z;^LAVvJ_t~@$Y;h9}pRi
zLp97Ee0KgR<+KFyxA=_n>RDiIMex<9Sx2dW(&K2kEGaR<8dTVGKssR}jDt>71jBd1
z*;4%`e&7;jwXpM|_cO+V7@db~(JE>(piDcQ$yiT=1&XrH#2u23qnETpx}hV0qq8Tv
z;Cn$CYRNr{kuFS$q);d%&Kl-S+7DmdrT@`AIqc-TH^(AnaP
zRe4=%_EahFpKmx~2@U2=fnx$v;ADO;K1t)t-L1h};_&NSe$UvsiJDot>N4l=mw5^=R!E!M#;wlB3c(Oln0n>STWs
zj3gKpj+>nAWREe+rkol>^R%D8qFj!GKL#C1txb4lOeMuXqeQqp_g
zzBk15;|}S5M-a*P5f#`|d5nn%|Y;5@G@**fN1JMg?g;OnFlgqlb=@C=w(kzKh
zI;p(!4p33kP2gk=)ZMhXqy{DkgIM3Hvj
zW~Zz}`c3kux+9@o6eh)oLM^cXcx_!%Ql0jROqSTJuR0N4-rd(-OqTM
zvi5j#=BxjwIS?cB!ky85+Og>pOX3TIipt_*YYJ3e%Bp-X=3f0#NECb)gkZA{1W
zA!fGJLdD`a^SjKt-0a8#893QYHLrhu{Ljt;MW`-+iQsq!{+|Hje?cFD=vWsUx}u62
z7e08`{QlQQzc%v<+mJ^;|)2s}W!^n$=xtcRNhGV&Ho6G0F
z;>~|un;-r<2cN&~87p7m)NZx<;;KSM;4=ITaOJGM+^rg0r$PIR+VKpTH&1q9&GbZ^
zHI}KA>x5UC>tt{9@=RJ%I;fyn?TD3gim-Ant0i8oy~~s*JsrSZ6cj&x{16cq20+2(
zdxm&*2o{SM(FWkbf!CIoZ#kCN)ztw#MSXpuiy|^>bT{dX6<{ly>gR!D?gIj|t)78_
zJ$YTJtgK_|8&*#^n0ad3eVS|?_uRc5s>BM(0E@{H51qR`AE8^2!yaURUT^KV47MUK
z;e2gIWoRBAsjOFuxxJwuuMtb1&1b_G)+hL(FT+jiO(;yR!KKgP{cfwRWx)_!3gYuduXg
zy*@SOe&%5~BkuT>Bpm#@u(RE8x{CiW4h8vPC#eJQ7ol-EZ}#B(6Dh_KFhsDnpm6m8
zYaQ1PCbPXymrz4tN*4gc2e5=;tFxrvjjf_0mSA>P7Mp5TQ^4;#Zo?K7Z?lq?7IOPl
zka3%9zpdZ^^*8`2djF%>fw})tSaRnedGqVnuZ6Q!kHu$5AYN1fMU`#bAhm@OVn?cg
zwnSy0bP~Y|2(kp*0=H|zFr}UV_eJ#dE>S5t8({_;)r(1?JY)7DPwMNANt5(#^CiJU
znbeW9!`7_TvjySq7KN&cIlHP6w0sv{7r(uL?bFt=sKcOi&GoG-yWtv@9QG>+GvMnk
zijhjTYpAT&5yBuH=lDqtehj#&MKjpOcxfOWC;m~VxT>m3U9BfG!)O0=*#iS3>|XQy
z_V$YqHTMh^fjjLh&muVce}*^~IWaLYKtKSjfC^^-nsndlL)|m#YX(S_!`nwd@$3Ef
z=YsvUx_UmpHO@+{LGv+S!(#8Zzk2%h6W~M~U3Z3}I=wFxw)ZE}gWo0k3;_!ly~wqdeM)Rg%}i!b)4>CdyX44l`y0)8HxJ&)2=j#f6zGTe8^
zfPkJ0IXqyX6acImg5W(B*tU5k-87IYSn~a`Ry9Zi4T0jWt)qk1g(AMbzJ7aqOTwli
zP3Gk>$gqXsgZdT<{Z{y$LBC=3tUlx%4|A~AxYNMEfL}lWcuh(Dg}8^NT|Pv1q_HR~
ziJLM#0Bix=B*1_89EKhq0#i8ShXiS?Ls1&Bfs{AeOM?6lV<)QOb%rPJtJZ4+8!IN?
zoj_1XkC|8ToYL
z?HgAsvsB69m6b<87mkgsE-BeNIM7L-J-a1zW3TN%L8b;6cImGGm1(Dkw3p{$3^MRb0Uc_h(C02eXLKsEe>$
z`UpXxi93E5M1O)bV#k34qM?wHa&0txoL@uPS`MCZPTd**v9|f*tp?yuk0r+Qi}A0
zeX_Nlfct?k`C(mJyaaM&Z8lbQ8B8d7?-f0wVDDE=-kQT7QlRKUC^q~1
z`$~1d3-khHZ!?@qg#K7ay+X*>tXL=t)Qp^$W}4iWq#$ln8)Zv23qb#+fEH(FsG$*@
z%FHjsMe`qpaJtlhflF>>Wkne`0??1B8BlbUWqwnN1mFcLg@XT7n3G_JNJN^*u+GGz
zHn+^43C)_Wof8s?n-hnjWg|U15sUnX3!PZEcc{6uH8hv{lJwbwc0V5_oLj5f>fu#d
z6)DGnv=2yEA2=!ijHb)3rBJN@NmE2f=u=6_WlWkV{?WT7E^dmhaI1Zf|Ln2GBOkR>U55ik3odqTE)Mnn9e`SJP
z%@R#w(4-4~XB8l~!oGA>&y3Hkw4}vXRvuSZ)0U`tUzCjP(9)A{~KL-b+mb^l+R3E_I557_f_P#$^0A%CBk5I4}
z1&y3x$*cMnhs9bX60J$Tv<0vRBPM`Bk!c~np%uV>%nV-w5}&m
zgbd+sKCFL?3Dfi=|9d(XrjHM!2vwqc6DjI!TZ!#yyvk-to=2&5*|+F;xl_+XNl^j|
zD;VJN>C^p#sM4hJXK=({*V>e-^Np@_FW%j6XDK%~UsF=%92S#TR$sms4>57Eb-Cy(
z!V^WywgnZjy|K2i*Z~B!dMk9-0-TsO0Kyt~cw#4lRD$D8>aZLOL6b?6GB&QRkW7L%
z1=wSjLQt@d{Zy#X76DEJc}M`1pt9imy~zH-!DmA0TENjvDT9OAXgjmHNjM46zQE9O
zwa7H><0&`r**S|FbS4$0_yGng;ecW90BmQl8ZY{o(B|y2wvIub|L#HVOAc@6P1P=cR!Q#0X0qpv@!^<$guFWp
z!eVm``}J6;r1hW92U<-%7=58Q4f0Ved~O~KKf=qc%cHrl8i*hipNSmXb6j34%JN{D
zr&ooJ2QVtUcr=H+<2_)>IB>J&+$>{Q%i{42n$=ySP@@4cpejSR=I!@Qc*%Ktl28_$
zwwp~d6o&@gVVJ_d%Ae;SLZSmvBbp*o#zj=Vx4}K?MxS4tT$}^Gilo+-rgYNu`9)yM
zk1%?6V&moR10GWs#tT{m6dj{zOLi`??~zL&p3kZvw5qM9gc-Z~YbY^fuHb8PGEvWq
zT;(?S3Q{kVCRuYy)FsJE-T?jeV=|XU37b`gj%L~$76%}kg@jTe+fhr~iL-d_kFX+C
zA-2EA9JV8sVTp+Ro*_Qs%kp_ibg9*`NL_ys1tUpfZUq#HSXBfAnxyH}Md5_n6f95}
z#R|3uPu~fCnV(<(g}3M1fVY|k_mZ=>!B?Hmb@RsQ7*!OKNRg-#XbPI%}S_tmg~QDn?8NRy-Z+{AEX_=rFCc|q%`
z-hVGK;Pvz%R&gF`FRj
zf@Dh^#+2ZvCUb6;>FUB}m98q}<70Gy9SBg;x)JI*%sF)$j@z_qahG#v>F3^NmRc_s
z$g*uLoygC~^?^c*C?+uG>?hAwz29nT0!_k^o7tW%->%}?460lK(=iH&bQT$^E~h#4
z=r0x6!t*&ABN0~E#vS<{(#M~P*D2z%p;e)^1`MNJY{;8yXb>ri!lBH}y9+gjz<8RQ
zDD9GU?uYHxKW})hcpUvC=qpTlQb5?=Z7+GOV2rqH;pr6a%i)pR6@#uL%y?#I*Uc{c}`O9+}vAE?QDbDN-ZJ18utP$=15P)QWW
z<7zR(R4JKF{^44qC5>Mi^XnAX#G8(F5_C7&<~R?CL3D*F4$@NDi1>?*ZtweA$<@{i
zuIJo}>FijuF$HqfOi!Xl%ZzNNMLEo~XI|(!dIw6FuJzFLi3H%wUO+z$6v?x-_Qtk0
zO8i&YL4qyg9V8f7N_-nmZ8VqAAD|ZZKtzT9BcG9ett2gNA1pW#{2a`v@
zM(Qg9PO0nc(lLjTW*e#0t_xFT=UUuHZoTZ8OnlWp}gcWv#96g@pwH=8%jO
z>J%(ymiD=|H6g$9y?E|e9x#|BMyj#2ybK6J4Kd{k;+Cze8n~w1J7H@8=^woZC~h2Y
zO99dCGM$5h+aPoRm@DZiC_rHaumpmpZn4vPB8}|1j`Z1h>T@8G%X>(Zxw9jb9UPu(
zmW797vZzi@P6BNuFkm2zg4DqLi?aUs_?Y+Myd9WZw9=Cv%*&(K6LsA}LEzCN;TWR@
zglNey1{`QC#yFJc2gPrT6ZdvK{JY>rN?uKgF=*p*Z2$4C--b2J<26vMMv54?frjcY
z+dsbgAzjV9Q`gqt=m#+r3Bs)@1Xy^JHNKMF+Bc;s1+TUkpk~AuA93T$s~Q(5j2{2M
zFMgx`nfp8LmRr%=+x^?r{@e)<^QPY%L2){ZbP|Ph1&Ew{R4?7K6%rQKov`0?$3RpR
z7oR-5cr-zo0`L{n7;uBUPM7-gu~DiELf_Kwi2`L8qZF9gQ7E29aY)3c6LSY?$Ew=0
z2fQS45FG1EY2EO{oeC!|*Z@X&upMFUO+d2}9gVZK_@CeA_PDB!i4cjxjKDtRV>|fq
zLp@)L4vcgs)zQ^uUR?ojPF>*b^N@ZNj2nXct*?K9-E{s}@>Nh$3sGPSv`@9o?Q*L>
zIhi;XgMY<>f&dWhej*zh8j@Z)bOrwL+amQFTDm`5jW8czG^_(%umm&fDS_K%%DlJhnTdl+%mny&!yaI#_7Qw;m8mUstRD+&hT`H&(-zy
z{&NBbapYi&=h3x(V~-xNX};w3M*vCW2R_=#F%P_-uha%4%KuDJu2w)NmM!cATM%$s
z5!|E8_rLxEz%&hH;=w92l@8PlBVrD{Q?FDtSDY+KBJjya?KKK0=-=;6RLQ>h|G-U*
zC<=*=YdMl&(?C8#dd~q0T?e8wfnIVv45a|*VEbMO{`#5!4-XH`ugL0Kj@VcRf(-$q
z#G(f@JCIcI{mP1gXYe@+kFT#UT)|K@_LdF)es?6UJ|``0M5G%17HBdOPgtKl17>3A
zj%XAjl8QiS!DW}IOGD?_>Kq>|fa>m-$oC>JXX&Q=;&BEal-DtmlJ|E&vQy;WBSr6n
z=Z@lHZJuU1r{RiwjZX8R^Zd~q+sB37X0YRo_L}jmkBiZiIP;;w@lgi!`=h18Q?F2|
z3pT;YAsq*E2=h%T>88?DK5XfQldWxAOA8N=^Y60!zV5AAb;&q+a_CkJZx0G>ER9G!
zh1^BgPXe5v`_4^sT&TwVI2XIb=7L=jXdWcx6s_YZDB<XS^~J+$arOe736XLc)Xt0E
ze^O<}2#pdkKHO^5odO&_&!-2sho|h#CrtF$Dk^emx&{U~aC8G1nX*|_SD=RA1?Zup
zppKFAni#!(`!PEk7oori##JdGBNi_)gDbRzwMYm;p3Gf<;A}V?jZr1+-WX!0u1qxc
z_AyvBG%QnjWa7ALDXOc|HJRB+eJN^2Lr;6{*VTji-F1otPcMl|yVS9==VxnywcpgA
zPmKYvpuhR&tWOCmbCdmy0_2R2a3fK|y>~wXrEWdA)DwSy&40!48dV&G$tcxu+&_T-
z1!E_N`SPrFQ{hrQgRii@p6}T+tP0Q;HU#mB%7O+O)`jhZ8Y^uWuRSEZ)7#lebC;wy
z33TXQKwc9&lqSgpBmIFPO|Qh1!oB19Dg?bCXaQLA(EoxIZL2mPiLN0H*uErb
z5!E42xCH{hJWsXk_7Z?Y3C*w|nXFdRgsTm#{2dEdU(LuIu8Yk2;E8tg)y
zEAjkrmA_L}e|o3SJEBWx(!GpLFC}VXp+hX1xGUZfjUv#@`icMl)DSDH$4wTnha(jiO_ZUn64hp|;g?{ZzZe
z`*!^(t!z%%Slj;j(1dTHT%91qJK#e|U~$d9=JYQc&f32*ns-LB2mi(;uJV6=`}2C%
zpN*0aErq=RdDG^CK-jl+meEvzkZ%j&&>DnL33_Bu3Fa6FB+%O0x+n&PnP3jZ#1=`+
zA_pb?OfW#BjY1KxNnk)J!-Qw&9Kf^Y|vrH3_r@Ku_MTO`0y9s}E+~s@u7kzkcbHViiMQLfH
zj5lH8a|kUpB^BvC;Z$6j|97?`0vTL1PHYk@hz6F-iaY2t^?M4LYV;j<9fbn->Y~sp
zJq5;-dTOh9UkIo+?CaywXKEK#)s|QoyFkO&{pyhs--%8r7+U_i(~%0TCAr6n3QgBM
z#<;@Nv0ctS%y?sjUBQxwjj-Sw(cq!9qP*%UEbz9q%IKLvqW}pP%3HC!cQKNF0zeWx-Wa?T
zH)pkD;Ed$<63bwIUmpXj0HFyor)E;J>f@tTvY>|jhdq?S93xI~CNvq-mH8uSVEFDS
zQq`|)TBx%|R6@pqIld&_E+~Wjwr~mJIXgj<^thf>
zrf{X_0v$|3N`!+^^0_oi!9nQ9W(B;Ia~KhEGWlYnN*64YH(024Av;OpuZ)5D2Doyx
zG>Ec=_Whij=zEL3WRT7Qr!z+IsylajeV;wp?lqM{8((Fp;T8G*n%w8U{Y3qbQP%7p
zVx%mII|p3#Xcuoj?-5_%e3*mCwG8}4K&A0nQW5nr+!AH)21p>f!~Z+j@9Oy31?Un)
zE>R((#9HIO1Dq+iZ-yX8xLGo$WED355BT;9Hs|NxzlH;PzxUp)pT>lO3LBn8sH!U_{xt149Kk_4!1f$L$(zykQVVEA
zTbi1r4_1IKFAUbNZHpE>3eL=SWppV9vDxXa{NHo$mPM%Eq~s`8IUJr(oM^whs}lH4
zn#t+pR@b#;b>2r!5F^!Lq()JisE7~3nq2?&JNrDA=G6aLdH%xNJDA5ooxr!hEe)6nJgF{Z@cR*9+(`A08gMKinTg*NrjuLDERQm}VeNP#zmp!!bNsXu{~n
zyu5gKXI2jB!}IflS6>JJ0>l)mI(xpTTaiNX_Ly#k7H{tpKk41YX3+5*$6TIN05#5(
z;vnADEon$UpYxiiaB^azS+hYQrqzq=N#3qYv^Q{!ePCv=*z`{3;kM5&P8kZ|E|feJ
z=|qiApR1jm9NIg5%`^~Xk8=2shJ=lnjWVNju3Z1Nc!=$hnO3vxjlTT{-8`7_!d&w7
zN?O&dh?aKQ&5h2qDtZZX-uiI)pN*}8iof4R1_XMqy?f~dzb2;ttzkZ)SiF1sH-27?
zjrmpP9||ZmB2|Lvu_yQBo^ZlomyDd}FiyL)LA
zM39sa5NVL^PKgJlS-O!9>GU1HzjI#x=dgP-_ssRVYJk-+EzRSlo}ONMdb)W3wMQ7E
zP*x>yS-it=K)^|~=A$UP;U$17e)KbL?CR<&D|_#XsiTW!()H4%loQ#3Kn0Pk$mTC0|&G=4U
zfC1i-n%;D^Z+!VNM}=*;x!E+WO$OKu=c9p+;F%#qziGs*@o6Gzp2lKV_O{be=!ucc
zCWq>6T*v%h_rSk@nYV0l0Vn_!1ubA$Y=+HDfw|h}c*#Id4{i6exUY+x9FhmuHzlPY4P03ae=e8&
zheQ5aygC@9^W>pn&NPB%8j&thSmOLY{$0v`j0qtb4J3s;t>&=lcixFU2+Q?`oDMR<
z!NH;Ti>uYd@-qN_&3!kCvt9$fDg=pvfq|iKP_#`pc6Pb9sH4&~CL15vrH6NRY;G{9
zA0AIab8~a?9)VUw2W~v!Ny=@vq;0MOODJnX9Y2eujU2=8fU=gjY`?!>EA(lTcJ})d
z--`pE-1f4LI{3PVc#ci^j8$FMOQc39ez}mm$7#YI7Ptm^~d&Hpz<>&pwMeda^Khiz?t5MCMj@4tsJ*AUO+B~f&+
zi?;*1;a>#GdmPM?y5Ei8odP^0Ia!E7#0=&9m)!0bWsqWLkLy5d?V%inBn>COkn;mn
zKg1t`brBVhdW9g}O%QShkwQZfoR)=H(V5*ZpM;>TLWEglu8;*;AQ2&#5rNsF`NkQ+nR{)Y_?W;A&uwXy_Y>yR7|snjQr9OV%f$7c8)B%Ms#UtcrK|
zD?{%1iT?s{K|wG76oA1EVhz(!(t)7S2A#^t%J!N){YeMA1JXPE-`#P2F?ftsJ-yC-
z(Kry?5}*j5)#BO{Y!Z+mE(4V`5*c%MFplFQPM&nuy0WrTRaI5rGoPdyLt`M0l@9%-
z%x$y#CWK4r$G=PMI|c>*0>dU1IXOf~W_8aCR2swul~Q54J#%54Givo>&7_Nw
zB|GW7=c2>Ll-^=gOnA8c6*}k#>P)HwE*;PzB3=XlPX-4@Qrv6xF$X9r^X#&gx3AM2
z3T54=bLZrK{<7tD;eAPbH8P5Z=7jLKTWMUJ+6{MN5d|Df?F^Rk_J8Uwo*`ay=>0b8
zm=9G`zwzE)7VLqM#z{g^adCO@eCp1zihgAnu%fdfRU`3Y2(*BR9H>QmNAv<1MsLJ7
z>Cly`@}i^g()5Nt_WyCDs)po;fcgq#AE2qLso_G=!*GIn`2IO|fi(2+3Bm%AF%8&b
z;^-V_90{|~uafC@@%9!BKy!mo0w3ccT~E)#h!vm2ztYRY%8FrH?y>xsy7kA_AP<;egLa8
zxCi!C(A9JHtT=d#7WFb$l+tYPwLf6Zx`b>ha1*>x6yIzNr>-LeH27(J7yKd_`0Om+
z3rS`)j0h`}dOmnyzM=!InkyONXAp7rGxslY`w2?fM`RR9+1>p;KOdiigTqh~
z4+VBKurUiDq~%j<>*>W1($Te68&;10;KE19`3h=g7(&A&`IrS1F#;5IquNoUCOz5U
zh(t*~uiM-pKf9TR^lcb8!&N&iu`u;7=8u%vA~e?i!$O_lZmfRCl^4&<6E2Xrs)s`H
zZ!Ij+y_v|R6zbW7g%15bpFi}88l9?~)Xm_$bn$KKD@DICxmXtKWp3q#p~i=Oya`7#
zboBLcp8e7q-n`2=MLYLGwvjuZ+@R2`>eE*^CyVhmxp^=Hj@FgejLrRljPuL1wf^LU$QQejYlzoB=IYn=R6dUcc-q>6Dvy45_QeV$)ts4E&BAi>&xMQ0F}(eNt`0m
zHBw#g6r{7}h@s+o@4`Tps;;e*&y>^LbE&~_-|K;F#$VdjCyJ7Sg!MRRIeiyNsSqKd
z50}03Sb$43>J0J^2xv`N>!w7;u+W$E+Qlbi+GoKZcWC(a^87!bj{ajbfQULZrKP8L
zJwRr5D%X|G8wGuB>=dqw@exir`tO5Agw(>f*h@uLt5oMG%Gudmn|ycdF0E4q)3-+m
zThI97RW}@(U+n5l?^Li$-dFX^>V=o7W4DCr7~fwXF8{6L@b=`fd$l4!?uGOIK=0x;
zwB$ZK`GtC?=WkqTWCa){ND#ruzsbT=hpkuud{>Hvm;>p@TK}I64!^ssBfYP7x4er|OuT<2K;n8VXgI
z>15=Jy{vFN`EUP#8|P-vU=3B_pJ&DUDPGJsB#15hR?Ujjp#jT7R=
z!`a8sc5pCT0Hfy~2Rr*BVALlIRkVBc(ch#$4Kf3+i`u(@DY<)nT#TBzPTsnveCfg-Ns-5n
z<<|n6ivQ;?1{fR-mmO2-*C!M|p0YS>wRr4`y5?`gtg9)>FpL0J5ErZyuPg2=ZI78Vu=h&Vre!Bnc${d?8a_2J{k)h5^6zIACEkhg6I&1t!!
zo;&{x5MRxcZdL+M8X5sOY`p|NCxC>JBJ=6f0^?o&J^Ocn(t0%)g&5*$BG;;{<#~KK
zTpV(J@hJ+6Z_1S=MW>SHR=0d)kH^5-Fi!R859PqQ7p1|h&3t8g#140O#Hf?W$tBqX
z*X3zw)z4*eY=^zs7keKAF1~%CjYW3aICwQ=_s@pru{{EUK8MR~O#tw}`xW}|BlN!<
zalPWH4nQf})KNG<$T-fbi>3}P4bP%Xp;Lg-46^{K0DllnN&fT+YCf9AsZ<37fg~}6
z`|4RaBdFG4fL44+$VGBLbL5}c;7w#)thlnaB3LYZaA)z~Gk9)~r)0HojS8#k(YZ6vT)S*_R_$+7z14K
z-Xw@BRHIDxtbzBmth~I29E8?i=mzPQlfYvdmm(LzC@zHu@Ua#h&r4$LyZ6e;t@oJI
z3z=*N%8Is~3Pw7*Nz+q5R)4-a-o%T?{@A@1%T7MtKzjH~>`XX#8%<`6T4yG!VOV|n
zNUY{}qOP{2{Waea>4c0Q{F0VEx5?Qi(B3z5dg#)oHq^5hqB+7coj%oSxFewnhbBP}9
zYWCKz@nglgV>%cazlX^nL0=U(yNLy&qD{;74JHx%9*Px~K7kjqiwM}WLFm
zEbGK9vRyam9`2P&ZoRcZMZ2(Klg7|0@x1fc89#N~4N=J>>?1m{7-h=dfsQsvlj5^O
zg7u*^DRNK>=&ez8r@$Uj3CTV!|)#^CMdgl6b)|peP{UH
zch+>j^5v!$3F>1sK^Kw140K$Wnwk&wjoFSqdCPEsA
z!lzt~6};=lQ^$v;0j*s;f?KfusPY8qb8K6y}RAS@&Wj_mK|
z2VXzi<(!p_sq0cVtrV_@=X3}Ko~$MED&<}kw!fS8B@bQqQzU>W&b*O
zo!DR`rosN)o2Ik}LK?9_q_Oc6xkJ;JXC2~mqpV?T`x^j|W<6YOC(*_a;T5_EV1gj{
zPTd5OAIbUuojoMpAmz(IkH7;yrRARR7!&XQt$+UfgO-K{J_=gJyX6vQ{K1d3AFW2tFD2?1cW1zUgmF|uJ-}s_a`bIlxsddz8i60I+5;R
z=cQ%>H;gcP3{`!6L;6^AEd1w!=+)g(#<&zZ6)-lgbVI;iucDf7fW;ar1}8qnn__H{
zFPzg^z)UWjw{zh&$c*1<&5Rb8`17{)+5;KdlRn66=Q_S>mfXR0|8OF4F?OaNpq%T{
zd>;DZT#N6-ul9W5Qv(Il=r)LX
zR_7r(`M-RYad*G^H$eas6SN~*zLK7to}2sO10&u&0ID_^thc92wKOw;jH)4LmYD0m
zL(v@8Nl8fwad3<1VFHJNpkS&d>QBb?aDt1d#&+l{wis+&8xXD4#0?%|iNvltUTTTp
zN|gU9itf@69#Y0XxZr|^=Wjhjfh6Zp_*JFyt=)7-K(MWzy1lyVz#5EZmxTNZ4+k3u
z?WR
ztDA6VU1Z6QHtg8F~2uMcUv<_&+2({;jakdZpdJI|>-vPw(QUNJ#J;~
z6h>ngw*XevuS`L#hN1Q~a?*Fe$kg0u`|BAoA`JKp08z=;t)-(wf{%aPLjfb8!~5yF
z+)7dejdYz0=c6MW1JY!e#p(W9PsC|mX(>iYz3e#XyA2Esw1g8Exc7m{>!jG0Y~cjdJHWh
zAM=|Gx66GU2x%I0D64v@PM?D|^nsTSV;ssujz2sk2pSb&kUKDDAYsyFB(c+9hn47`TpcA#;ZlT^jpySJZ
z_;zGuB%qWSCi-e|zaY5)pefN!#Di5-t@LUI?YX>M!2~)Z56UC(@sQ^N8aNCIZN+aB
z2gXN-=NGA&l9txHVC32n#R%hC3AsNS92_JU8rU`Zn)_UcUJ~*9e(R#Ls?Oxhfgbm=
zvYIj%i_(!6af7dQ%aU@smTO&UHtzBoj8TcZUR!6ovb_C%E^m8kZSAG{efgjEzn|Uz
z{H+)9b)cGF
zkucJG6~vlruyP@o&d$!==+cDM(2*2YmKc;gq*JV3;Gc+HLp!Ep>fz!+q`;}=fl|L^
ztLTDKuprgh#kOMXAIOXKfak_98!(b4fEj#G>KU@!LwA3OfD7l)gRV!)6(rTxLb
z%MAl_{BU;{*7N|OgAg=~qy4nVkY?HnfU$X@q5m8n4#UOAH|ewerVU&Xk&D2AuaTFG
zUqBwLb;oK!^n@ftqG#-dBakreh#K?+o1vX<^eVbw!$ghYSZCf)_m&Zcl<+y4$ZX_>
zFR;p-5bBMJ|2dReTDe|j*P267{Eu-%jF09;00sioL8CO0(N~%j>6>&cVnm`Aou%yC
z2y23B4A#k`#U_HqAw~!$FmyqgGo10Fp&aqX(i+T0P{H{
zF7EyNYNg2X@t%O>uD4|1u~7Y^D<~D|0F&A>p5HuE%%y2p7MLpU;Vfe?CfZVDM;<4_
zt1FfFPT>#>RnR2$eoFl*U-)Do?3nd2s%rN6lbH4DiCA0$+M~-8R*s0W2({^%qPWyo
z0s~Y^M%@}0#BjPlN$==JVet>>$QdQ&t2%Y2Yg-BLzD
zL4lET+(9BClv}Uju|Slw0~F<1$qiMGV;yu$@^SA%D8l%%d(8J@Jf!h>(AoL6_@rMS
zV@VsBn&M{2vAbZ=SiLX
z*;ejm#vex`NJv4;XYZ&WY=h9)$@+*;#|FI;*OQS}LPEd!XQ}i9kl}eumD;nPH1%ZzE*ny<;Orv|gk4(H!awqwD4%
zh7$GjQFoIvh6C0nSOgM0D}&)cU!Yqb2fiA;xr1hqEbP_!A;MjfMY5l&HP0?3rv5_;
zjb=Bp0xFWsZ}eq9R+neeSiEk8JXhww6N^k)+h(+a6-_LleanHI_Ffa>qb+l7Y)ZJxS8*`1EQ}?BjYT8m9T2NSP|S5y@&1
zW3ym%b=^LGdVB*u`UY(4hOc8}_{&78Qr?(@Go+Dj<$rpbxxzoN=n_>l7kroWeeV_V
zt>WpZ6!P=0i(Q&hgw&K*2>B(MTuSssw{oA6t-XrxVpLx5mH|vD@H$D
z1grLMoQ@CWnFT=*cs4I@6Pf8s*AM!KC~q_gkJJB)L5O8cn_@tpw$FGjNS9te%Cz)q
zGNyZ$!B-~H;DZW7IUTwQThd5Ps?S8?J@6Gx*WkY@NR*6Jx`%s^uqfyHGFjyOleGw#
z33sUezcQ+vqyS-hlIf+Z=)O@HHHTm;?2%C<`bL`G<6u2IYo^9msW=Ol{7|Q5?_B%~
z0d1Tj6_4O~4{3uBE}larX@l+}=-!=~iE;+=o1B~+sC=JfiDZfq$WCm0L%n4@`aFu)
zR;R>*W~gLHU-W{WM?6TkDXv_y&8W`b$Pq~^^LL!H|(``5Wo11+8
zypzHglzc!`feS^LlV2z1zb&PtqH=U}q<16gRs?Z&Wmo{V#5i(@x0e?ny9?f9<^Ol5
zv>Ff?I8WKyC&Wi!8HQC@sf{ZGj0Z&b@q~@TMz6!@Gv0lGvfpC77a##U6;f}1A2QMu
z@i&7T$fHQjYvX5>xbe~yMq7$X2|?rZPQ9_+FK2ly(^vGR(+3|h^|E?r)X)$s^Y?!k
z;@N9K97R*Sn!K;CS+P+q0|V~?gaoA_!Qem#$_}VRFP<7Uf2VJ~p&yl)l7ei#)(dcq
z&wE={0H_Q^fol&G4g&sDD)`PTG*s#WAQ&JlYaoL1Vrxd+7$oN=r}^-mZka*EW0da5
z6$9Y%kc(YPT|;{GsI0gClrpSLZt;!4oin{JMWaPs1FEWP^DnPp6UiFWf?PDLcz%L#
zCj*^&v5}nm<`kb-XuQga23LfUdWTm@Gt5t>#0}%3#t!ic-8xBH9xugr@6#=8cDCGi
z1Zlh&DIB?9F0^bDTzvazLX#7a(*xxJVFiHo?maeU_-%iYkfeWGQaL(0&~g;`6Vl?^
zEgb(1=`r@eK)N4?O89W4V{!BBC8*CfFfgE?pa7+HYrpE>04dciq8At{zKHw&Jh%*b
zy8Uf$Zx0%qAJPMN=?+tsw`u?0C<-8yApHEMz6nUm=hjL;p0~sJOl0hhCy!86ZO+D-5Db(kzO651PvkUMaIifWJA
z5y0I&R7iW8QGMAg@GO1g=1`fr5D
zDQ6e#Suscnv9b?xzVgxiFTOz-44lo0x7
z_=U*GRI$3E?!V?ZqNCNW)oqWChd-m^=KIIT%-63xF76Jh_ywS^Ma+AV(Yu>L-y*b9
z&)7ISIXOayUIVE?M@OgH6ZF*pF14Yd0f7j?c9(!9x))?s4LL{!(By5TjR_0LAED@;
z9&emvF+%tV4kfFMPR{KlT()6&tb}yKBD)RPejiLfF8tOC=y;T@a&YUm;~lQFX;E0N
zn3+Aen1C_f81*r`cGWVa2uER_;RVU-_#vyy4hbP5W+^D3a_Z8o4Ik9uVlUW>Z;_LG
zv@VgZ!W`X(v~+d9P91Dv>R9VI`?$zB818)7T2vjY6p9($q;YFrVzRb&s8ryfMv{A?
zA1rcqUj(ezwoer!8;R1P_!NFWI@RLQ5L!4*YAm}5HT
zj*ic7K`)tUL#<|&b5mwuL#9mwWy?SYds|gkQ9&DZ-wJ(6kcH}t@4~OSlB+B#-MhBV
z-Z7-)(eXeV%m<1Z;a)>u;+a!tis}|F409$e1T#26_vA>3d}yw*=3B$hS$cllg69{X
zu_QVkNz0dy-S$2d{a4}CF~LKfr{};B=-_0JEIZ)*5o{T>f70hn195T?2&Nq_0S-pj
zkY1?=tTM22R2ep4vI~9_`e(Gx@5X25EZy?B1y1&1=P=cOR-Kn$#Jt(uiu3ZIKu~_j
zZ~=v7TZ4lN5Nen`7~H{pas~+b760Ef0+
zkWl%8%~8{0Kt&o?y4F#3>3@TgF{&<2-Ub|%YPK;7T7ieVr2b|frs(y`_u~fxQd=!J
zPH*qv#4Y-AbU5P;Ze8NN=J*Up2S3R1$mf%P{q_hvd{(u5R3nznOb^fD%36#N{9Mrd
zO~3FhJMsQxEgM8@q$8eP@6+9ua>2w`?Xs*aBiGdyM;^+g==HUpjfbdnXCJCruOY|8
zX-HPkZuj=Tsw{E@G8i}PTTf39ASh(fbcQ~{EHvbBqu#s^{?~G9R3bw!D(e5iFKilw
zM!>Z%VAJ;VZw5rj+QdYGqB$v+T*dPE!+5@&{&5FzSd3RyRQxl2e31wQEu+;~PO|J8
z9IhZXn!&=e_jjC2g#d1qWWr3VKCXIsUO6=huF?A+}9C#K2@X0+zX?NwckjZY(~j-b6gAJ=kx71Y;`Bd~K@
z3BXcqzxeOe=Ka-M3-~!qUyW3;6`Gs)!hvvp#!kQbMm6a5ZlWjKAK0wqBEO
z9cT=-!1#bS2P79ze1PC0`FNoP$nEduv_koKk!;-DidV={pm7?|UmOS3*eM=Nl-@V4
zp8wlr##x9%t}z0K
zm=r$yxCFJ+C{xB^rl@AZ^z6hCx@Bx9f`8j3h7)5bfN>}n22=71MkjdhrAT~AsO|>!
z%Q*h@O
zWdhs2yF)FX@!^ho`fkf>RAr{3+?nK5w@|(NZ7Cry{Y_YObpLx1uZqVSr?
zuOK^p70fX%u;-yPqV{PSSaPhpqL;7L&uVC8t1J9oe+cIMDx|FTl@LU_k*txwqHttU
z?UA1`{V$#;ZQ#47SS&$EQN_dAEinDo=Em3D6a)3#-RD#LzqR>JesW#vbbIn}agkB+
zH1hRzb#%PHJtrf1yx4(&6zgfEwi0Hb0PQneKZyqrhxiW{M~38XT9`H<*VPRQDIb;5
zU1KZ3!No1$OxN&SiCzrXUy~Im{_!^&BOs&2p<6gMtQzGt1+wbhi~oHiX6~Asm}2&-
zJ@TyTJa)GBq*QmoBU1~T!PNK*EPMMGBqM}SEd$YN`ygN6&wUe>GqV)&f^6RNa|ToP
zz{V0xQ~esvX>v}VwYJ)aJrZG(~zG@7&S7
zzytvQWln*s_A^YD4{IrNkeUmhg4lU4L{;W3T&{Z2BqvA0BuAo>^Jq-95(Q-d=Ti03
z`(obBifc%D9K{5ucm*T%Iala#hF*W7J5CYk
z8=?QC-20qs77GKFk>lTX$n$l0_&oi0dpENZdJyfbm##|g)I{K=LoXK4-&eofk9q!j
z_yg$Cbe(c$b{%U{$6$lo%Tlc$*H^j=&fP_*dGB>&1efQ!nVmoMXjI7$GW}srE(MoD
zN{ptdGCPIK#me3BVZ!HDR|)bQ*OjDEJ!h{3Xav=A8%#!3hq!az5Rv=)zC>Wo8^A!r?+XIKehxMbkS6BJDU
zE_|NmD`Tvpj0ePY&3I&bQx+T9zp-$Fz?1?J^sFrfIU`4v^XI&7?o3Q~-f-N3EVOqqP43eZuR5Bp9wxQ%me8LF
zI{*nG-Edig2TD>^aWRh60wJx)8VU~8vJAGiMu{LmhyRn$wY5`na&QtUaS-rDnl_T~
z-dEMtfKppTqq}5X>F1j3<@|_Ck@#HL>6T<6n0gNv(zNRzrCBh(NONe}lQYTGuLM><
z2Mh3)Ac~OJIdPIGE=Br5PW<_#gdF3uEFJ5n%Y%AVUB}|DT_IN$AAfY*v~7GfB2}sD
z(RXYROiMG#<=s5GYJ3Y#R$Gj>rqQ+0tY*C7o%QNw{-97aH%A`tZR3eljp5iz&~?Mc
zjX=~rM1wBUuyDL?9>_D~dOx_4@V%nj{cm+udxcV=cC#^8hzOEV)m-`90Z@p+$bzyf
zn}i;b;uB^K@GgMFfbV@v&n^wfUwSE&aKaT2QS?l;Vt!#^VF?Kde)fWj3gnoo!iHfh
zp<1ThI+Ri^CryM;R*ezMU{17EkHs3yL#xIZxL_fdV2eW`s(!s!J)Am18CSRrLYGxz
zqd!}18oYLKyv2f3C$zN;1A_1Bo5U7IC0rVGrz$k(D6nz%nx<91K?h%tQxE4d*e>T^=d>^j(FnC&9-&nH;!Z3wIIyd
zUA$1c_;?j^#SN6tZI&oc^Re#np@Z=(rz-!=Y3>$hk&@id7ssjU^BZttW;N&)mI-~%
zd{ZQpOn^S~eNK26hc738(y6qxqLtVGPkD!gj%1Z#fy<-=)y3T%3!LCV2mVcW6nikB
z)wHm1df3J>?HCL121uBVUpI`FC3J#=8$iI5CMQ**Bel?)l~kn*qKWC8J_XM6bszEF
z%IC~TbQp_YzI-1XyxXVz{6?461-JW#=cUD2%v1hNWCVyDM$0-od)wFqn3&*Ta*`(Z
znMdHh*}E`|nZhOSrRTR$FTV26?nyGQ`oSx(JK?C4I5qY5>1>v&L9mw6V5Si3xA1o}
zVcV;UK;M&Q6WlOWgtq1VbN_gS4z*&6E4&_NWoRfA;!le!)-Ak6)ySK0_A843<)(po
zhm7J~S0ufSCW;>+-a49uPuApKV%C_dk~QQts>FElmoLf_dgO0Nbd6L~vEdiWuC9fn
ztaBw)dqOPE0*B~NY)*)lf+e%sdtOR;`y6S5?0UXqxqs<(okO}7h4VOB+qS8+1B3UG
z(1iDJj*#Ta-j``d)MTXvB4#BD50|}Pe%7{m;4<#*jRKP
zQ6q$SWL-5d;;|86k6}ID2YRk?i{X8mW@b~9lO}fk&R%O%g3l#B~o>Mn}
z@scmsxxDhG6^o>HR1Yz2G%Xej5Rv5HT*<$AJaSfL^>yud+_@==UWjhpXHVyLS**41
zX&1Fs%Ml6OdCswU^F=K9Yi+I5{2!(>47B&}&&_|2%&6=-`uV{^C?a2Mr1XmnO4&Xm
z`hqW0-%JFLFi`>n+?#>9EbIoQ9Iw0mMPEXnL*thMc2v~$M$RTU
zs-GkJ*t(~_4kV|RDGZHO-iigs%sJ9LqrUKOcS$eo?Cd?}vG-<6HB4~!^nC0HZ1Ozk
zb6xIq=e|_)Q4_N&9u+&h_7CP-g#|*#gE#tG5b}~FB>XNk7(9;zu+{4uzFV3^2`DD>~3fIoF
z{YFlzcTFx8m8DA^{Kp%&{N=h_=eN6}>(-;BJu$x|v;4rc))DB7n1TCjDJv@-1>A+Z
z-X@1`N@_v9nadtn{fRDGx{a&ab^M6x;s*8QGd$VhgG*6VG#b;Yv#ZK;BcWfbq{5CT
zPyUO(|IOEUuKYAP_c_e&05+qXw&J5D2_UC@X4eb(s;w)Y(_yF@F+BYsa-#IEjB&?t
zU795#-?TExzG29s)}c&`#;0YpwBA6xy4p*uZTb7kABUAy$ltLbv>%H?IjG1Wrv1{B>maF4eP&S7=A*h0CH5gVPA
z&GY3B&z26=9j_90w%U9x%`YferXM?7N~w)GN9zplf=%UARb{%`_e_;7oK@+4MwR*R
zw#WAD=f+=dA8&_0w6RoFvF{(3RaUY}b8{6J)$*ay2nwd*-o!Hv*z+VLQ0}W}Z2Q!OH7Vc(yEChB64@NwlEvJD`~oMX@xQyrwRvW+gr`g+M4cD>$@KC
zHW*1j@Z)C1UNw=E14+fVZo&{M@(L|Wc5gW6a>&v}IFSll;jFWB^9
z;7FIKxzFaf-bn0d{P{L+aYx_gzK5t7b)ye?P38hek*-sZi|t2M_(jV$6df*4Pn>%V)*N6y?&RRz5|ESN@=-CNa(-#Y>k4}6;!CUC%|#v=IE#zswG?b)Sv~;Y
z_r9L5q>=ncEzw)FJQ-FwHH#9KO(3>~7fsiGcSUYv#2_NDUo~2(%l}ipZf5B@x$L(w
zA1wG%v?U*DQ|1_F0eO_B1K9ZBPBrxrsztg51pLJ~XWN%U%g0}0YJN;%`G|;xJ(s4<
z!)z?zL3>DrzY-QEh`Z{Cu#(RlP+qhuM0_Eajg0qj3l?z9x-hIq6vhb7FQ`%!v!PqF
z6m(!el>XhxA!21v93`2$Tc1c3AI)44mObHcKo5y7t?bk+koh|IEkd%vAu?WeNFxGf
zQdxvM!fc7;9wjf(TUB%y%Q1PwCJH5R>-RAx)6p{fEMl)WLw7&-K}}=9^b|JjQ{x$4y%MR%oy^>`wSwRvS4B%
z&6VfO9q=f`nrbXR3#YFSOiN)_2zN04o`4Vp#6E+_qNmQY>fn7@WD*QSOoG7rQ9d$d
zCe0DJGRGdjiUWtE0CB4Z3@RX0HZ#MaNMXJ`)F?$Boh$NbeH9}mHe&eK%jnN483mai
zhn?6y6%d0Bq~B+Ft;!Bj1t
zVg2exOob`lmGS6Jrj^+ZVv#WloOq&tAukg#LyEzSikI~xWFs?O){BOqoO!4ZRiJ*(
zjCB4~dMe$mF>6=$p$N4>A-a(1u?D6{8J0n)q9cV)TFeVNB
z@u&5*LRp%}tB;v#*9N_;LuN=>8k80aksAL^jo`LXpT4!#mTw^LL$pTE_^KZnJVYlz
zVOE{6nWDULPakO-DT~gnU(~DA9vg{m@&Og!GEz#L$xV@TlFa#Y={q}lv4GZtWr%7`
zhncu8+1p{fsJ<5&p;fQwt9H6;YxFrTp7l7r_`hc}5iecDL%1CgdmC#US$u^%ugb0r5boXva67(%5V?51+%y~Zf$Z;?{bUxnK^kZ_Uv`xo7mm1o5
z#{LHZ@!~R|S+RCSqkLAIBHm3ORfuvgM6>gSW4tK{O$u6NjboEUrxxft+C0+J#&%t
z{O3xMULPj(KgJ`SIY~nSVTuLAa4!%GV+ojvb%dkSCp98y`11~3`IAKNcv;$t{3xBZ
z!U7zRK6x||1D%&hdKk(iF$f`EJ$KOAXLH))iJ}-4W+NU?;QTB&
z-NS*boy1Brh^WD6+iYg{DHE>DH~r0Ul8h#5l8cv`5N6k{>TX4j-e1EYd=VYc*(;AG
z^I$iQL4?B^jOE*JB>CzZja==*Ez&>fS1~ry`q|faJPcEIyl<&#oy=vV-QYHU@%g#g
zF+4OM$ba0hi%=WC)O#nVqdCReuL&jo#9E|qu4kFtO+c5DkGqR>xb|NxA!(9h9zFm#
zg>Q8zKR_5|neHOK7WG&h*Jrd=o3g`?
z!48GN5+T7}VdHPht(o~d9#En-n(@b>WZMu*g4P)!BleMDVj4k2y24t*B7IuKOpT}E
znCQ8(NP=#I)|RkfIWv5XuNvBU^Z~XJ3Pi!@c*{wa8qm6+#$D=hBWoUp_$Zj1&H(Bj
zk8Co2u140n(U1V92VGF_^Co%?IfUy&exIJL2$2Qy^w%PCG2vAs1PYsPdMMV!i?FJE
zN=by#BtLbs_@np5X#6DKB$uLJRm^qm&M3LAd0neim;`?nW%1RqK6Q-K-eA6XYEr#;
zN&NF??EEi6Wbae
za@9&ooI!NK=X_h_ZDGv2xJCb^*-RuZ9qe-*?{P-)2Q@>r3e&u=)4Y60-pNfvs^Cod
z>T)o=AZ+{=Gg~1w~VHYd^Y~3C?42Mlwzrvon3Xh9~i^4<9{#
zt)!xD%pJoUy#Ds+v|V$>N!1rs7L2d&C$X2Q?)ap(PONJm!do1Um(+!w4ci^Y{(A^N
znEQmg-0Tm2L-2!Y3r!AFfMwhYykbUp|AQ*!8gcj(yhOq5&X8%Xd%8m5M4_xQW%+2I
zmBgb!S<6zOKnKY|H7zZqFn&b-ihhze{_8Ug!@$6v{h3@9;1?jRc#DuliH#oE&*mf8
zkT@ZZe5``@W?GmvLsgNjPGPgrvX1Y*aH17R`4TVp$^9JZwQ-*diPgi=|Y@
z-b%qUnGhek_DnOD&CAeMpo#L0bE=NLGfn;`{<=EcXmMn6ifA71_x&1|C9NvsQ)b9dhZBJe!)ZeZ+FB{eT?q6
zA-PcU?^0LRn@S~huZ=;w4@IV>(pHVqwDvg)X!`aRjEQ5jK10wJ*=W->h!qUofu3=P
zUVOR3_UF-^U2mKlhHA6#jXh68FH^lmFbpvoVvL`M>c^yoC}QY!XCwW|ShHY4Fc3{(
zv@6@^eAb?tMW5)+5K{oS4Q=5rRgee$#X1BoToQDj(`DM;zPfopW*6JJAN{azZKh`0
z5^$GjHdj?~l&qIknd6{}6!I*E%>fHbz*MzE`5hA|{u*~07arbDWhUy%LPSIR?{`k<
zSw_qALEfiMKq_E#)v%?;b6rnH%_w)|^WDy_6pk|giStDYsq&L)enIYq5+PJj+Glk<
zPJw@`3ZZGzJDZ412Tz#&9#}hqpP>b{Yvo3?XTi4=Nj+rZ8Ir1x8?l4th`(^
zH_PAOxfjJ%fQFRtY}w;tXlF3mIJriG`{b^sz-X@G%k9JY-_bl*LCQtqN5T8+O3~`j
zqZJ8u@dZ%NiRF7@U|{G&WVNVyBib@I9#Fd7V_|FsdP%b
zEs%ZvVQldQ9?iUf=WL)>aYt%SV1sg+i|>Vvl_{!OyVu(E=bQjbN9FyN%@>!*FMFF$RVKgh#v!+)X|k;lxgD7)sIv(znH2~=T~}%Fo_AkNcb;#(8JehsKNEk}WOL+1{a)(t
zr5P5ct6J6>?jf~UJMZnRW?UtXKhdXBK}TDJtZc4XA8Ub_M#-~28ljS4j=(pa1>ma6p+Rft;+kf{zuO|S(klfr@V@UEXzta
z@Uh`rj!N1a25rpo-`f3HTMsa{?&Pte>V-ReOZ_EtYXOmpOrE`gs5q%kk4vc9ig#V%
z{aDkNA6+--Hvt*2(z5)eJQTs76CU$NZc
zFFfm-@$unnE!*SNua)McAi_~v4#MSUI{yCqXtW7NH6A+)-k$ec4P7_ep$07;J7uZ-
zQjb;-`H^F}!FSPpD|(!x0eb_hi~rvI
zt#3%z*0t{bJ!X{l@_wnR(aAu}e?$s&E$~?G{FtlCRaTQcpWkXy%U*id*?6L#Ad_Ep
zE#-&N=^spqE$VXrXKwWdYut8Zy6NxJzE8D1*wdsTWNN~(qhN_X)$;HEnMOouAtW%*SD3W8OGe7z0LyH~Wj7=HgTw=B#QV~c-Ruk1FmLcF)lmhdaZ8PrD!<3F1OjIjhlh(#3XOx-qgKBa
znsj<>pU&3>>VD6z3An7tr_YJ*)L6<%^}d`eym4Mk)77&LzM7}wu
z4}RHWvzwP?KXVrECloisWgM-o@4zLP)#iQSuagIDZA>NnJ?1VQe@NY5jAacMv$OO6
z{*@(Q`}2qI$rq#gU49-^$)^UX8Esp%2WGDt&mZr7S8ucC%2B^@nMpeTNZ7u;eeJb3
zG7hqKAi6%XKU0^^ndP%TeSBDPz}
zjoi7yzOoA)am8xKOAVIt?h`b-xuOk$flD4+id4cJ@K);@-Kp^Sy{&gNFeYF1mKu7@wN80Qs}^wix&>;-LnQ*V6}9+oQlhr642M+fVQ?K8~B29FFgON?5wMIZlC$v^S{hUzuetb3CpKX?F1@a
zy14)BnO#$-zUlKRwVDR4MtUeR5~N}r<9{*(YO47T;i$}A!X^o{?lax2Y((-;HxoiO
znHz82I<#)x?2%z-V9*;J_67akkzvn>-!r4v2^)?d+on*|DwTET&hAzz>#{Nv4;)yF@}8c`^t6jFUOi;9c6WA^qSd~A
zt1~k$A+wWJrNa|&QQ=Lr%Fep7XZMQu`1Q?A1sGBCjpOKg*Usfv5)-g{{Mgnrr+3}B
zaV$6I+T}|J+FFY&md=~WCt&UP@ohcb6&Qud*j`nc3Vk?DE`Cw&5
zs@v6{eB)Sg(M`Rs*sdl=y6O$%@wPM_NG;Ri1`9KAT6u(@Z?mwWfF
zsI5t_u1-r#JYX@m(bL+|QzYuwEXFbZ=P+YaG%%q`!X~NiKI_FJW}5J`X=+VXS$R@^
z{#B1l=d|fv4!y@|a5=OthsJ4FT1?$`Td!JGXV5pPRA^4AmS_kg4fMVt{8nolu-r2l
zTU5$gy56B}grMk0M@?Y52%>A$sO#~QZZx(il{Kh^HJi0Vp{N!wfurV-b@WcS7W9Qy
zW^)@Xpb(m9g+j3#zG_5nN
zD5}YtreWW{m8(}z&(6N=aCE}~92142N-nS9JDd0xFuk}LJv<3w9OLho31PX*1?wTKmmnZ4w;){ixMbEwcIbOu?19t;bBI`xzyCtHd{NlMWMw4
zY{l{%ILJ4J(~a_BY{G1aag2W;%yTjnR*%9ae)1OZB;GwxV>H#H#B6TDZ$1_jSlXD3
zZTR&@UVsuL7yQCAOnULCny{e7st_{uib9Ph^b{C&#lsxpLc4g%j2;K0RU~?ZXY^>U
zQVC2X8T!%#YihL&4WSG>{fcrdGf@j!sj8$=@xyoGnYd6Z@u;2E+JY(-JupnYz&Jgz
zL60BPQ?jTM4%5SH=oHq(qaLKs7D#~}j>YjJ`|uf>*wS!J4GKkt$ppxt$MMA94aCE=
zVnh(wLmr4qRYk)W*YEg=Jd(xmxglwWpQ?k*ZlDBAGCyZ0o{1p^dT=*1OdJ;I(5Q7a
zc6*z}(hPxz21YsClng?qDmpLsPj`%C{C%(lNe=+ieQeU|YaYQmEX@RtU~&^Q&<`)R
z_kXt`<0o1q0^)%(ieY+2A00yog^;nHpL#_k69kBda-qpv4nM6wYygg$LWV51e9P+#gQ)`uy`u*?>yFA>#X>~dQM2y7WIm{E(8@GeC-
z38EKlVTa>fz$NK~dKd4jGh2|FA?2*1Ve+H@;spu90T`(k&ngpqh&KliC^KxqEO3?(
zP1r;sdLdajNzKLK;<3Oixvj556F#0Ofo6EH_gxJ&*I>098Wdq1bvFiU_0=(s@jr_(
z94e6_CMpxFax(P%VRnKs4$?fESohAZ#Bp
zVjH`F55@>6b7YdHI`lwUNME#NI|LcRIAqkaeK-J_%c)AVg}@4^B~)UY(seo_0%
z0EY{?r$`|&3d%s~4O5|)VbNfzU-kq8QvP7VZoMR
zE@VL@n}Bj`*=-b}IW-YOh+@iT;h4TU#xedUFl9dvLXyNGY(llf;>mS{F`xkvLX#CG
z*rnfL@%+6ACnO8>N)r)Xp*0bO2gNO>I65PyhyLl^02DB!BVq$V!ZI}x55!Y;Aao=S
zMVdemC{qMRu6jf*1u%!MKoBlu9Tuo69PlKB^B1WvhCFgcWJy%Qc^2|JUOh!LXXmL_
zto67M+tK!62ib?XpB~Nt(NIg>5t@kO0DUnWw7riw*iu7bio6o9SVCW9Uvz|8$n1s$
zOws{i|JesVTqH1ji}x{z52(@^;gces;trjrDCUzM;~4*QSS$s^#EZCwtJ5`vu!;Aj
zI=213FXS>j4BFs!fIB&wQD?rO&s52Ss4f@(ga*aV>
zJr<*UG)ql>ZX9)R9>Gx!zaxG`kKr@RP^Aa|JWpASzX#USo1Z
ztIO1y5~aFWsV-4#%2etyg|bwosz9m~!lw4tw5G;8&5d_kno=NuAz*h*Zfb+ANa<8ubc74O$
z?w)+TA&gD(-t6A)Ol(Q$$^grIvQRP>XZ3Vv_jKok8S-e(>gmb6&!Hwi6Mk^)kHg>T
z@#%p-89hDeVTSw_z4yjA#{WFd>gmnu?9S-IMD5M#>dEQu$yKUKP3G{kz9wTe*kY~)
zn@u%fmPfOhxXx^@4>RO3nKdQ-pA|=r{c$*|`M1m5MNOEcP9=`g2S=XqI*Vx(qwp(r
zzAcXK>v0&fSDL`141(|5468*cJc7seXOx<$K7ymF9?2nt--$QgBpC6~~=pG-RN8A5){eK+azKQ*B
z&g5YXn_@hgF*Bn0@oT>ej_U5w%uNtc%#wxCu^pxJ`26U$>;`xD==gsakGB8q`XA-q
zm>zyZ`%lDC&A}*)VN;C9V44{ZPT$9`{Vq7F$4B#+{zw-7`QCmjJ$}3Xe-|D`a+Li?
z^Qd)Yc-0xhrXM5Y+&>XVHGeciKYI2&p~6=(^q+{Mx_dN3e{?TV3KB~$eJjj1Bm3g+
zqSPLf+1hBEk>ycM9+RUCN;ad^zBZ4x{|Js@(@%<@?A(uP{%D4N!-HR5iLwyUJE?)c
zMi-LtZ=EG)zOt7mb^9xM%pSjXFW;U2->#pd`71q-WGFxQ{ARd$44b}B<{t_Tz2hnL
z)?IqL6RJWdX>8W(>5UQmY_>{;wuB?nbK2PQ&kpa3_cW0;?u%dWgc7ZI=bzN6c%Kwn
z)rgrPu<1TL375pT*>X0aPOBm7##h!W8SwPGV-<`NjB*Mx}Ska2Mwgjd{_-wQ@>SPi{X
z>>(UwTw-#S#{#qDwm4{H?f%&phX~ziLupQgS&1KJpN@$nu>X)@8LeRI{)80eF>Lxi
znNF~H-?`P+YA`mK%#BuC3$|uUli=nt*=lX$uPWGV?JQUaMeL#@R8b*%H`H6KFx6x>V~bX8VI~WquFXv*bCb>1*4CO|RFvefcSFHq
zfzEy3A{m{c2|9vtbb(HJmkbJqw{VqZb`@Jmz!rmIhRmau#?IR@nRRdkFvW%aW{0Dr
ztu42>_!`0nXo6Y<2E!bLCq4c!2=`!wePCD75eqDfeo00l9|s&djGYbwS!ja5<#tCK
zjt>O%$mfU~KER?JCkuzsYHe+6%P%Ut#t0>bAaG6m*r?SqVWf%A?ARP-Jj{I1;IK3h
zbb-?igLGu9G?CC8hlmG4+X((j`!FjVF&6lsm6s>i)ujRf=?#kln;5)e*z|oeV-seZ
z)7dFN0h5Db$zs9z!|9}wQH(R%%BTe9vun3^U>ac;0=B4SY(lNcgz_dd0i!v#Y?(_S
z1TGOmsCNvU$8D9x}7R$W<8kh%Ngsm2>Z`fGxL$
zW0=HJbJj;8w%q(-ER4{Sgku%4WHdD#Jh)=*+RuFhy&4UD0|E!16b!T|e!}D5pb=jT
z#K0i{r`T;tL251poMm1gg@(Y)a-=4oln2KZ{T3|@1Y3k|e8S50>!-@k0*#u)Dr&?
zK?p?!heQViyMpFgn&E^K+?B*@AvA7fP
z3OjTt7@Htt(T$}ycJCjP(M$j#IT_;cRKWoRc2Mestx}1jegCf|)P=4_p{O7jlCFi{
zHygSn|1b{KiWMlq5S<9wij|+9KC{K?!f@zIB2+6piDA?C$&5|B0_O?JvB9(XVT@X6
zVovkw9TOU%Xt#Hyrk-B2X4+^!An^T2LkFW0#vlMys;2o2O52Lm`Zygrk%l
z5Lm+wAUrUc7@MjL#%fNT4jfp%bLYZfP{;7cW=Asz8x*8ygjaj^EMwo=+VYPaS{tTM&Ar04+z=Lc2#92HmMKNTF5?c4
z2}&Sii+)>M^Y-swfrdDVLXF3ct%OY&DKQTOE9*mtR&Clm%j4Pxf~~smU0K`GF?%kEs|OKa;5l=Fgl?@e8COG{o_VVbk}?j7^bw6HnjB
zDL$HcCLx~rbLtE(SYd74IQxSSp1poOe$}d}2M(-sI=i5Z*$>!)K@J9oqZ7Msch9wJ
z2PaK>2?EqOTA;%r#Jy15(wsviV>MT))mMN`X8ht+9X$Buu3d}#eib)-7_&ianc-)1
zbIyPNzy9}~I~OD80yvHz|2rNpoCG5{C9K3Qgbf>JwYTSE2I~#A^8V5)*)5|HW^0fQ
zX|(W)pF|zS;;3@iP%sz}-m-)7$TeoTJ?(@|BJ<*(Xz&vre{n5F-?Vzw^qo7GUc9*X
z*s;xfb}#SgDL0$>5;*<+5o{J0yv-IYX6dM+97mo<2m6qr>~eKiRo#8%m0xiaVV~fV
zqdnsI)B6VS+h8=IN_Ob*D&$QrcV`G1#9!zjU>A@?*o3@k^z;3ZOua-73S5sY*lcdA
zs=D{ut2i&s4tsY^P5LXZ{2D-JGB-M$?RrB!5CoadYvX@iU31s%?m~`+0Wvajj{u+t
z&P4?C1A6??My>cC-k6ritA
zR2@FN?#h+@nB~YmhKJOvS5IHHYFaR8xOidj#~;7sam&@Jy5t+jt|T6+ugkUDdfVGd
z5--PJzjj!usJ(VIVba8L!^3K1TRlA`h$6BtlJ>BBl7JuWO0Zg8X)*&QD)t{lzOZO;
zP>l&4_Euu{lN##j&tdcf2sJDdtk%xfmcsw~U;pdV|bhs)$cmym8Y^U@>PR`1KYCpPYZv<8LrD>GX}y|LxzaWcM7-Zs1f_
z_GPWEsj)Hla^k`3*N%jn%lTTc|
zdbqJEzo8-L#TS18gE|1B9)}lQh_QsO`h^As1{?#MkiY_GH*K1Y9~B%2eoFznCk{BW
zOQ4=On{4NyEDZ`Q&YiZwHFj`HnrQV9TBk+tro#Fji82v<-&zsSiaTOri-;e{qV46%jN}d
zzx9{I%LiAlo*92|gTvmZRyD0#Gk5jMxtlgDt*E@fFF1F0-}!TUCry00
zxHx&oj>UjEbc)|Svl%g8DSqEDdwABOQ^qE&=HOnf!Bl!6e*TW_OZ-DdjasA_(bvww
zVqVfk5OD#86q=2Oj{4fX*Ixbe>eX}i?c3PVA$$3iKiO=Gd-oFOFPO4s&HQD{W|ows
zeKBWJTYDuG4#sbJ;f3FC-n_(OL4wev(>C6{duro`FUm@9)2b@eVRSzCu16F5NOUL6Me=V@d)TA>sy!7%fs;city
z7A~BMA#d2QC^PfwtFJw+)i)VTEm{M8K%24;_@-?p4h;$e!Fb^wa>mN|gr%D{ec^WX
zajk%08Zw;6j{z_XQzG2(F`1gO`
zQ&z2-^W~Sbi;Gh~{&@V+V>@4a?XPihE7q)?d+x$MoxWLTXw+a)M*feo9A@Dvr?i;)
zGLspJUipfZAD=n9(e3WUkq7S6q|(t}31iswee&1CCafKjlaDN3Jh8bc2W=6zIGxC1
zfKB6Hd+N;TUCWnEJ$@|C?NZd$<}P14{mW%DpZ>$Y9zVM4qYqzgZY-{rWoKqwIe%{7
zbI<Rzi-~Mbll5N*VN>nJhcZ=y>!{<35T}y_cz|UeZH(bWBmAM
zKL7mv6)V1Y_0>P0J-7djxBjBmHo&Y#SFh%k5q#4Ej+;cM>?+1mOJ5?P9B>KpCbz3s
zlz&^;#1@(w8*+h7JGZYqux}%N)t>$9FNcSXbLLL?$3OnIa@7~`{KUzMJTZQF{s
z-uhc_UtMbIr8nRDE7C?_E8t0`#tIY$;d7+r5CfG2HlduBbzy9paOUi$7&iT|`0HVl
z-QJavabe|(&+~GxIvqVYkxFH)e^|F>^-Q1=AnEd@_z54sG7>N?UpD>7;kcx0CtrB}
zw{crnyz%<8UXRx6(Ezh9T|DsjSAM^9=klbaBUTFljxIeSXQ(sYy3ZY>QiV
z^VaFovXo!`>i?WE^L=@L?aQzHp|LUFWNOo>>&&J$IC=c|=55>Nx3?EqEUgdr8_9H(
zM5KKu*rYcgM`(KHxqq#1%yGKNnMMvgx05I6bm%sj-&d>~OQfY8(*?%#FQ7o{DCI$u-
z#-@rDD<+*ev&HT1ieb|ah{wVv%ri-0^f{&}DAJJj^t5xEH_a_5xNb7F>UGV71L}3_
zzWDg#aW|7s#%)`+al?F%TQzUa#G^;zl5d_
znfB64zc!iLZH}IQyz}fYfBj#41M2k~=5E=#=+^C12M(^y&bhjH$){JYCM;bx<@kxX
z)oW&*JHN+j?NF(z;ojM^+qZ3-*VR=d0F>Q}>^kyrp*#|siVr5tzmHAiBs8Hj8k@f2
z_ye2NnmXXf+<6}!KDz1Z^~0C1#K#}nkbLvRjG6Bx-#m5b@Rqm#@f;R+8#gTq25slg
zANYLQJMjq{H*H#U^X8d-`_^aYBrjb${m|h!<;_vSnAzO;AWh8JG^-K|?^;}bT`UpUcdZUbJE|MYi595g<{QAdw5
zCO{Hl6aBTc%4Dvkyy*dKYQ!%YeuOZV7&d*MJPMomhebN0qt7lF3iT!m)^tf=1mJ1F8H*p^j>k%?e**CY}z<4
zH|J_z?zQ;%wLYIBCnxdrsW|*hY3Y_iY|(|l7txp4VkT9I2$8U9K?F7-{@F3O$_+(0
zkv@d*)e~KV$=KS|l(%i$BCW0wv7M89Wy7Yq24hQ8OWvM+D>iSLfB5Le&aTqUTjy)_
zjn{7+K6`#wU47QEU2cO_Z5Fh)ta)6B^$4`7xRQ*w@)vxMj;+{Qlu50p}|&Zi(64
z(b$x~|G+wo>%hT{9UYY?PVPE(e8(?;^6a2tA#%Y5x@^)ks?d^pY
zObfadu%*9W*4UU+SDV$+Twu5Lh#%hO)|SHh`mE;WJe3L^b=1{m)Y9ei7Nt_w-CfF)
z081pyY|IIo-*kTp_lsT3cx)wX!tAfRk4?jo*cA4b(j@^*#MMSqol-@&CedG%=r*7F
z&dw60s@iO6K?2ezuYhc^wsv$D%Bt^mb(feet-XC^N|g-d{fa8+w09J!HPr|
zEyrR(awjvH_{TYt*=I0hI!a?;(h7L$ATJJkUmvp0rq;H?#>TwP&T@;T%V=zGXvnLn
z%~mSw4ThHPo-z#%4zdPgg9be^tP?ghh~o)tVh50wU@YbFhZa2?n`$0{O+1RIu}Dni
zbV%{rW2i@F3Tt4Ms-~-}1V369OM7EuZc|f!dwZ$X+HEp*T)A@SlTTjj>8+B<(#)1N
zpgjDiKQhvv;lwm};OH^)GGC@Q(4e%siU@4l7RDybL#WZbiec0D$&bV)>Fn|ej%X_wP=`hxah9M(4&r4OB>D(KnKxoHn*W)
zY?Vs7hZdURZb=GV>1Y%4@gxT**P!*OsqEp{M1k#ec02@|#u!VOsTK=xI{UgBlbIgq
zrBg#^fquQfuy3<xqKI2vM7BcH4!=}<3m<;a=!c8GLyw?ED2lBC@I*4rEs<}FpFWO2
zKvk$jug8>aU~JmCbLr5a4oL^*P=u4=c`2B`a1XP>PxMQ-Yh&Q_$VlilLv#=@9kDBJ
zuoQ2}(4ZlF25KX{YJvdYFiak@9Gu_`L#)9T_t_2X&ec?8HE5L=0faKNvQ7}v8kxV}G
zp(dB;=Y*7LAOwH#kbY6XNRD`F(b?4F2cuD-36$xii=2ojz!)cp?}Nn{@q?iwoTW*!
zYW3t3CpLS%J>tw(t2Gq{V=YqS7&iU$ScKdIyO`oQ%~oqGegnl%AAVh%5XNGz)3gXP
z{ho)J{*WxrZWM>(Hi|>a__2!Q$c7RN3zBi_i=ZdeBh5~F6O+kOc`#w&o;_b8Z{kc!
zxEIykgEk-V|3UrlfN|)=J;#I{*b+9GOAj4cykWx^ZkJNTJpYDMDu-QUI!|)^AM`(Z
zyiq*n(dJ_k)mAz+%+R4cD5OI@!X*r(+H9>l7{6%Swz)1Bf|MJU4XJ=o`$~vEub0IhHVrJHvy!;E{txt
zQ`xyE1w#Oj*;cY3jFWr;F42}cMftg$oXeS+=L$>CY})eKhV`?Xn+nP2>_`v6Qoj;Q
zRg(YT5r^z&Wl^Vj`Iq24j%Rkx>D+>2o3>0|zwQfCZ8R_u$+B~IMfC8o|AhnC+|!_(V5k2CT!a_&+Y0JOD&Nh5^~k5)%1&^
zR92RiC#R*s2)jBa^FT00iKU@|9~@e=pO5yRYtcNaFU%jdPsVd{&tNRMd1vzS&ds0y
z?x|Coy`B!0s>EojwA!j`>yj%gug9?IpU0Rt*y0Bb%)3}Ym`shewP}0zF2^t7?mdg+
z;^yt%y=cdd`8#*c-!TR+5ZgIBc71W5u}eJnAq?f&J9fg!$XI&)c(S@%HWTdEw4o
zbN3ybvv}!0jvw3Ru=mroA+d~ADl3d89RH>#JpOz%B9B-ki=!8HkiQ0_iye!JsV~^1
zu6OQS5Vw8y{)6+DEr0Lm(e-v)mqtUtDpptxz$Pp+vBD}SNW`e)w$mwlB!`b!B-7|n
z6*<5s91-b9c75M6{0|lGAp1BkyLQjry?fr`MIR*JIN-21n9WsYb9q}EekYD}cW1@0
z>7U4>@+Mkw7#dnyax*i}XJwts%e#c%mYm%4_}!)-N&LJJLy#Ch?B{ZF#m~-t#_ppT
zI;RCkwqh0vk-bof(4@XDB99O*LE(H(c4B^hVrqJPLDA{l+{B#hYq`0XkT(gx9H~Po5__AMe=$272lHZPCbAFwR-Y*>K9!kuw5B@KZ0uIkdq@bIwBkjP
zI0a95{K0&b!W^v=QFWgqkNH8EfI9`tH7M;$kbqsAEJ+gGx5G)CJGTPEY7X`GvTHY@W~S7(mR
zR%^9ZHZ@-_DLvWRdP}1zj$zaH$^xyBnL8XEW_pQjz17xiu{N2_4HiqI#o9m&;XCIh
z!Te6uCX2P6_<<6*(PT7;C+V#+yR(-5{Acd8(hFy)Dy;c1X8WW2dK`{y8_5r|(`2U?
zKT<7X6(uHft;Jqtu~wT+9U3*g3Qni1R%@zow1G`(`Xs?OJpK>!gqdrjnmmHhX&v=T
zN4QPw(%&xmkF9n`i^)=r5g855dR>cnu^(L)P^mDS1^|;vU4=oRN2~R5I(?YuVV@uO
z2#n^3TegyKEdMi~a^LSQcjbi;rN+yuLA0*I}kVrH7cRDg{S&M1MQeYUw?hMsuakP==^L
zY#^|uKi@nChy2%JN&6%$HGGiSX5=UY(@{lQO7|!rp}-;4Xe)Kb5{<6ZXlPT&5e%&w
ztxTaThYtO%joxJTWXC_sJ)O2zr>z^s^N9chQ_2AHhu3*KYeu0FumwI
z6EckkKYb|SKg3oEj=Wn0fk#&v9?3LWAM7GZK`^}@K-_#B$xx;q`E3N;oc``hk*pUl
zKQojOQ*1O*v>2oMdNdPi=#eUFADct1q~Y@sh_o3sI>JhLrB;jk5@@|sX|$9Bn{?V{
zrJ~V9uWhKpnvU
zjPXB<#r&WM)K+WMRXV<-AJc;F=!s%6pR`Y$cRYk2_^pdz^j;-c>InVf#}m6e=PLC2
zO2mVfF2q8gt0c3JV0IpJ9gGNnOct$p?DvlVILde=R~z)TIGB7?wVFzUp;D`@(9;tt
z2oL;v%S_0a*z+ep{-Zp65KM^yUUhnnV3JW1)g+1|+oE^TUFdXhrx+C0{-Y^paJWi73@^YRaMcHiphyTAIobtM6lzP7zBEhqOtXV3M1<(>S(gN@CJ8f{KV>FLVK@bxB>u{y>vj&Y2?J2o1?
zw1U&?kkVE<9Ze`~YP{XrcEjZ^@9w?b+;YuoD^(~m8yb_;nxYUk#VAHGiqQ{?{?mW@
Z{{yVFQ$#+Xs)hgn002ovPDHLkV1g9&3}^rV

literal 0
HcmV?d00001

diff --git a/_static/images/SAP_BO_2.png b/_static/images/SAP_BO_2.png
new file mode 100644
index 0000000000000000000000000000000000000000..91bc53d1a98462d50718f5cada0b2149d55b04bb
GIT binary patch
literal 25160
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
}(bbAR8C%mz
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
Date: Thu, 21 Jul 2022 15:02:28 +0300
Subject: [PATCH 142/882] Moved Hardware Guide to Getting Started

---
 {operational_guides => getting_started}/hardware_guide.rst | 0
 getting_started/index.rst                                  | 3 ++-
 2 files changed, 2 insertions(+), 1 deletion(-)
 rename {operational_guides => getting_started}/hardware_guide.rst (100%)

diff --git a/operational_guides/hardware_guide.rst b/getting_started/hardware_guide.rst
similarity index 100%
rename from operational_guides/hardware_guide.rst
rename to getting_started/hardware_guide.rst
diff --git a/getting_started/index.rst b/getting_started/index.rst
index e799d047a..87b98870d 100644
--- a/getting_started/index.rst
+++ b/getting_started/index.rst
@@ -12,4 +12,5 @@ The **Getting Started** page describes the following things you need to start us
    preparing_your_machine_to_install_sqream
    installing_sqream
    executing_statements_in_sqream
-   performing_basic_sqream_operations
\ No newline at end of file
+   performing_basic_sqream_operations
+   hardware_guide
\ No newline at end of file

From f7cb29376a22d163b8ff7427e7777234795b19fe Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Sun, 24 Jul 2022 17:07:39 +0300
Subject: [PATCH 143/882] TPD-233

---
 operational_guides/access_control.rst         | 81 ++++++++-----------
 .../alter_default_permissions.rst             |  3 +-
 .../access_control_commands/grant.rst         | 43 +++++-----
 3 files changed, 61 insertions(+), 66 deletions(-)

diff --git a/operational_guides/access_control.rst b/operational_guides/access_control.rst
index 7f92f8eaf..ffe687213 100644
--- a/operational_guides/access_control.rst
+++ b/operational_guides/access_control.rst
@@ -4,61 +4,42 @@
 Access Control
 **************
 
-.. contents:: In this topic:
+.. contents:: 
    :local:
+   :depth: 1
 
 Overview
 ==========
+Access control provides authentication and authorization in SQream DB. SQream DB manages authentication and authorization using a role-based access control system (RBAC), like ANSI SQL and other SQL products.
 
-Access control provides authentication and authorization in SQream DB. 
+SQream DB has a default permissions system which is inspired by Postgres, but with more power. In most cases, this allows an administrator to set things up so that every object gets permissions set automatically. In SQream DB, users log in from any worker which verifies their roles and permissions from the metadata server. Each statement issues commands as the currently logged in role.
 
-SQream DB manages authentication and authorization using a role-based access control system (RBAC), like ANSI SQL and other SQL products.
+Roles are defined at the cluster level, meaning they are valid for all databases in the cluster. To bootstrap SQream DB, a new install will always have one ``SUPERUSER`` role, typically named ``sqream``. To create more roles, you should first connect as this role.
 
-SQream DB has a default permissions system which is inspired by Postgres, but with more power. In most cases, this allows an administrator to set things up so that every object gets permissions set automatically.
+The following:
 
-In SQream DB, users log in from any worker which verifies their roles and permissions from the metadata server. Each statement issues commands as the currently logged in role.
+* **Role** - a role can be a user, a group, or both. Roles can own database objects (e.g. tables), and can assign permissions on those objects to other roles. Roles can be members of other roles, meaning a user role can inherit permissions from its parent role.
 
-Roles are defined at the cluster level, meaning they are valid for all databases in the cluster.
+   ::
 
-To bootstrap SQream DB, a new install will always have one ``SUPERUSER`` role, typically named ``sqream``. To create more roles, you should first connect as this role.
+* **Authentication** - verifying the identity of the role. User roles have usernames (:term:`role names`) and passwords.
 
+   ::
 
-Terminology
-================
+* **Authorization** - checking the role has permissions to do a particular thing. The :ref:`grant` command is used for this.
 
-Roles
-----------
-
-:term:`Role` : a role can be a user, a group, or both.
-
-Roles can own database objects (e.g. tables), and can assign permissions on those objects to other roles.
-
-Roles can be members of other roles, meaning a user role can inherit permissions from its parent role.
-
-Authentication
---------------------
-
-:term:`Authentication` : verifying the identity of the role. User roles have usernames (:term:`role names`) and passwords.
-
-
-Authorization
-----------------
-
-:term:`Authorization` : checking the role has permissions to do a particular thing. The :ref:`grant` command is used for this.
-
-
-Roles
+Managing Roles
 =====
+Roles are used for both users and groups. Roles are global across all databases in the SQream DB cluster. To use a ``ROLE`` as a user, it should have a password, the login permission, and connect permissions to the relevant databases.
 
-Roles are used for both users and groups.
+The Roles section describes the following role-related operations:
 
-Roles are global across all databases in the SQream DB cluster.
-
-To use a ``ROLE`` as a user, it should have a password, the login permission, and connect permissions to the relevant databases.
+.. contents:: 
+   :local:
+   :depth: 1
 
-Creating new roles (users)
+Creating New Roles (Users)
 ------------------------------
-
 A user role can log in to the database, so it should have ``LOGIN`` permissions, as well as a password.
 
 For example:
@@ -81,7 +62,7 @@ Examples:
 
 A database role may have a number of permissions that define what tasks it can perform. These are assigned using the :ref:`grant` command.
 
-Dropping a user
+Dropping Users
 ---------------
 
 .. code-block:: postgres
@@ -94,7 +75,7 @@ Examples:
 
    DROP ROLE  admin_role ;
 
-Altering a user name
+Altering a User Name
 ------------------------
 
 Renaming a user's role:
@@ -111,7 +92,7 @@ Examples:
 
 .. _change_password:
 
-Changing user passwords
+Changing User Passwords
 --------------------------
 
 To change a user role's password, grant the user a new password.
@@ -122,7 +103,7 @@ To change a user role's password, grant the user a new password.
 
 .. note:: Granting a new password overrides any previous password. Changing the password while the role has an active running statement does not affect that statement, but will affect subsequent statements.
 
-Public Role
+Altering Public Role Permissions
 -----------
 
 There is a public role which always exists. Each role is granted to the ``PUBLIC`` role (i.e. is a member of the public group), and this cannot be revoked. You can alter the permissions granted to the public role.
@@ -130,7 +111,7 @@ There is a public role which always exists. Each role is granted to the ``PUBLIC
 The ``PUBLIC`` role has ``USAGE`` and ``CREATE`` permissions on ``PUBLIC`` schema by default, therefore, new users can create, :ref:`insert`, :ref:`delete`, and :ref:`select` from objects in the ``PUBLIC`` schema.
 
 
-Role membership (groups)
+Altering Role Membership (Groups)
 -------------------------
 
 Many database administrators find it useful to group user roles together. By grouping users, permissions can be granted to, or revoked from a group with one command. In SQream DB, this is done by creating a group role, granting permissions to it, and then assigning users to that group role.
@@ -174,6 +155,7 @@ Removing users and permissions can be done with the ``REVOKE`` command:
 
 Permissions
 ===========
+The following table displays the access control permissions:
 
 .. list-table:: 
    :widths: auto
@@ -226,6 +208,10 @@ Permissions
    * - table
      - ``INSERT``
      - :ref:`insert` into the table
+     
+   * - table
+     - ``UPDATE``
+     - :ref:`update` the value of certain columns in existing rows without creating a table
 
    * - table
      - ``DELETE``
@@ -254,7 +240,7 @@ Permissions
 GRANT
 -----
 
-:ref:`grant` gives permissions to a role.
+:ref:`grant` gives permissions to a role, shown in the following syntax example:
 
 .. code-block:: postgres
 
@@ -296,8 +282,8 @@ GRANT
    GRANT  [, ...] 
    TO  
    WITH ADMIN OPTION
-  
-``GRANT`` examples:
+   
+The following are some ``GRANT`` examples:
 
 .. code-block:: postgres
 
@@ -324,7 +310,7 @@ GRANT
 REVOKE
 ------
 
-:ref:`revoke` removes permissions from a role.
+:ref:`revoke` removes permissions from a role, shown in the following syntax example:
 
 .. code-block:: postgres
 
@@ -372,7 +358,7 @@ Examples:
 
    REVOKE  CREATE  FUNCTION  FROM  admin;
 
-Default permissions
+Default Permissions
 -------------------
 
 The default permissions system (See :ref:`alter_default_permissions`) 
@@ -403,6 +389,7 @@ schema statement is run.
         | USAGE
         | SELECT
         | INSERT
+        | UPDATE
         | DELETE
         | DDL
         | EXECUTE
diff --git a/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst b/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst
index 0ab200286..a49e53f88 100644
--- a/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst
+++ b/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst
@@ -43,6 +43,7 @@ The following is the syntax for altering default permissions:
          | USAGE
          | SELECT
          | INSERT
+         | UPDATE
          | DELETE
          | DDL
          | EXECUTE
@@ -103,7 +104,7 @@ The following is an example of the output generated from the above queries:
 | master                |   NULL               | public            | public       | select                       | 
 +-----------------------+----------------------+-------------------+--------------+------------------------------+
 
-For more information about default permissions, see `Default Permissions `_.  
+For more information about default permissions, see `Default Permissions `_.  
    
 Granting Automatic Permissions for Newly Created Schemas
 -------------------------------------------------
diff --git a/reference/sql/sql_statements/access_control_commands/grant.rst b/reference/sql/sql_statements/access_control_commands/grant.rst
index ceac48f7a..d86522900 100644
--- a/reference/sql/sql_statements/access_control_commands/grant.rst
+++ b/reference/sql/sql_statements/access_control_commands/grant.rst
@@ -15,13 +15,9 @@ Learn more about the permission system in the :ref:`access control guide
Date: Sun, 24 Jul 2022 17:24:04 +0300
Subject: [PATCH 144/882] Removed HW Guide from Index

---
 operational_guides/index.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/operational_guides/index.rst b/operational_guides/index.rst
index aca578e8b..9deb0835c 100644
--- a/operational_guides/index.rst
+++ b/operational_guides/index.rst
@@ -24,4 +24,3 @@ This section summarizes the following operational guides:
    seeing_system_objects_as_ddl
    configuration
    optimization_best_practices
-   hardware_guide

From 37f40386591f873b287020ec0c6864a5acd0164f Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Tue, 26 Jul 2022 10:25:02 +0300
Subject: [PATCH 145/882] Removed internal items.

---
 reference/sql/sql_statements/index.rst        |   4 -
 .../get_extents_file_list_for_chunk.rst       | 107 -------------
 .../get_metadata_chunk_key.rst                | 151 ------------------
 releases/2022.1.rst                           |  11 --
 4 files changed, 273 deletions(-)
 delete mode 100644 reference/sql/sql_statements/utility_commands/get_extents_file_list_for_chunk.rst
 delete mode 100644 reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst

diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst
index 1a075f69e..d2b92b152 100644
--- a/reference/sql/sql_statements/index.rst
+++ b/reference/sql/sql_statements/index.rst
@@ -108,10 +108,6 @@ The following table shows the Utility commands:
      - Usage
    * - :ref:`EXPLAIN`
      - Returns a static query plan, which can be used to debug query plans
-   * - :ref:`GET_EXTENTS_FILE_FOR_CHUNK`
-     - Points to all files that contain data related to a specific chunk |icon-new_2022.1|
-   * - :ref:`GET_METADATA_CHUNK_KEY`
-     - Returns a list of metadata key values for the chunks that you specify |icon-New_Dark_Gray|
    * - :ref:`SELECT GET_LICENSE_INFO`
      - View a user's license information
    * - :ref:`SELECT GET_DDL`
diff --git a/reference/sql/sql_statements/utility_commands/get_extents_file_list_for_chunk.rst b/reference/sql/sql_statements/utility_commands/get_extents_file_list_for_chunk.rst
deleted file mode 100644
index 968c0655a..000000000
--- a/reference/sql/sql_statements/utility_commands/get_extents_file_list_for_chunk.rst
+++ /dev/null
@@ -1,107 +0,0 @@
-.. _get_extents_file_list_for_chunk:
-
-********************
-GET_EXTENTS_FILE_FOR_CHUNK
-********************
-The ``GET_EXTENTS_FILE_FOR_CHUNK`` |icon-new_2022.1| command points to all files that contain data related to a specific chunk. This command is used for debugging purposes.
-
-.. |icon-new_2022.1| image:: /_static/images/new_2022.1.png
-   :align: middle
-   :width: 110
-
-This reference page includes the following information:
-
-.. contents:: 
-   :local:
-   :depth: 1
-
-Syntax
-==========
-The following is the syntax for the ``GET_EXTENTS_FILE_FOR_CHUNK`` command:
-
-.. code-block:: postgres
-
-   select get_extents_file_list_for_chunk(database_name, "
-        "table_id, chunk_id);"
-		
-Parameters
-============
-The following table shows the ``GET_EXTENTS_FILE_FOR_CHUNK`` parameters:
-
-.. list-table:: 
-   :widths: 10 100
-   :header-rows: 1
-   
-   * - Parameter
-     - Description
-   * - ``database_name``
-     - The name of the database where the chunk is located.
-   * - ``table_id``
-     - The ID of the table where the chunk is located.
-   * - ``chunk_id``
-     - The ID of the chunk.	 
-
-Example
-===========
-The following is an example of the ``GET_EXTENTS_FILE_FOR_CHUNK`` command:
-
-.. code-block:: postgres
-
-   master=> select get_extents_file_list_for_chunk('master', 0, 3);
-	 
-Output
-==========
-The following table describes the output generated from the ``GET_EXTENTS_FILE_FOR_CHUNK`` command:
-
-.. list-table:: 
-   :widths: 25 25 25 25
-   :header-rows: 1
-   
-   * - Parameter
-     - Description
-     - Type
-     - Example
-	 
-   * - ``database_name``
-     - The name of the database where the chunk is located.
-     - Text
-     - ``master``
-	 
-   * - ``table_name``
-     - The ID of the table where the chunk is located.
-     - Numeric
-     - ``0``
-	 
-   * - ``table_id``
-     - The ID of the column.
-     - Numeric
-     - ``0``
-	 
-   * - ``column_id``
-     - The status of the chunk.
-     - Numeric
-     - ``1``
-	 
-   * - ``chunk_id``
-     - Describes the state of the chunk.
-     - Numeric
-     - ``chunk_state::``
-	 
-   * - ``file_path``
-     - Shows the path of the file.
-     - Text
-     - /home/sqream_testing_temp/sqreamdb/databases/master/tables
-	 
-The following is an example of the output generated from the ``GET_EXTENTS_FILE_FOR_CHUNK`` command:
-
-.. code-block:: postgres
-
-   master,public.t_1,0,0,3,/home/sqream_testing_temp/sqreamdb/databases/master/tables
-   master,public.t_1,0,1,3,/home/sqream_testing_temp/sqreamdb/databases/master/tables
-   master,public.t_1,0,2,3,/home/sqream_testing_temp/sqreamdb/databases/master/tables 
-   master,public.t_1,0,3,3,/home/sqream_testing_temp/sqreamdb/databases/master/tables
-   master,public.t_1,0,4,3,/home/sqream_testing_temp/sqreamdb/databases/master/tables
-   
-Permissions
-=============
-The ``GET_EXTENTS_FILE_FOR_CHUNK`` requires no special permissions.
\ No newline at end of file
diff --git a/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst b/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst
deleted file mode 100644
index 784a54246..000000000
--- a/reference/sql/sql_statements/utility_commands/get_metadata_chunk_key.rst
+++ /dev/null
@@ -1,151 +0,0 @@
-.. _get_metadata_chunk_key:
-
-********************
-GET_METADATA_CHUNK_KEY
-********************
-The ``GET_METADATA_CHUNK_KEY`` |icon-new_2022.1| command returns specific metadata key values for user-specified chunks.
-
-.. |icon-new_2022.1| image:: /_static/images/new_2022.1.png
-   :align: middle
-   :width: 110
-
-This reference page includes the following information:
-
-.. contents:: 
-   :local:
-   :depth: 1
-
-Syntax
-==========
-The following is the syntax for the ``GET_METADATA_CHUNK_KEY`` command:
-
-.. code-block:: postgres
-
-   get_metadata_chunk_key(database_name, table_id, chunk_id);
-
-Parameters
-============
-The following table shows the ``GET_METADATA_CHUNK_KEY`` parameters:
-
-.. list-table:: 
-   :widths: 10 100
-   :header-rows: 1
-   
-   * - Parameter
-     - Description
-   * - ``database_name``
-     - The name of the database where the chunk is located.
-   * - ``table_id``
-     - The ID of the table where the chunk is located.
-   * - ``chunk_id``
-     - The ID of the chunk.
-
-Example
-===========
-The following is an example of the ``GET_METADATA_CHUNK_KEY`` command:
-
-.. code-block:: postgres
-
-   master=> select get_metadata_chunk_key('master', 0, 1);
-
-Output
-==========
-The following table describes the output generated from the ``GET_METADATA_CHUNK_KEY`` command:
-
-.. list-table:: 
-   :widths: 25 25 25 25
-   :header-rows: 1
-   
-   * - Parameter
-     - Description
-     - Type
-     - Example
-	 
-   * - ``database_name``
-     - The name of the database where the chunk is located.
-     - Text
-     - ``master``
-	 
-   * - ``table_id``
-     - The ID of the table where the chunk is located.
-     - Numeric
-     - ``0``
-	 
-   * - ``column_id``
-     - The ID of the column.
-     - Numeric
-     - ``0``
-	 
-   * - ``chunk_status``
-     - The status of the chunk.
-     - Numeric
-     - ``1``
-	 
-   * - ``chunk_aligned``
-     - Describes the state of the chunk.
-     - Text
-     - ``chunk_state::``
-	 
-   * - ``offset_in_file``
-     - Shows the file's offset setting.
-     - Numeric
-     - ``-1``
-	 
-   * - ``compressed_size``
-     - Shows the file's compressed size.
-     - Numeric
-     - ``0``
-	 
-   * - ``uncompressed_size``
-     - Shows the file's uncompressed size.
-     - Numeric
-     - ``2``
-	 
-   * - ``compression_type``
-     - Shows the file's compression type.
-     - Numeric
-     - ``2``
-	 
-   * - ``min_long``
-     - Shows the minimum value of the type.
-     - Long
-     - ``25``	
-	 
-   * - ``max_long``
-     - Shows the maximum value in the chunk of a number.
-     - Long
-     - ``12345``
-	 
-   * - ``min_string_max_string``
-     - Shows the minimum value of the string type.
-     - String
-     - ``"abc"``
-	 
-   * - ``min_numeric``
-     - Shows the minimum value of the numeric type in the chunk.
-     - Numeric
-     - ``12.22``
-	 
-   * - ``max_numeric``
-     - Shows the maximum value of the numeric type in the chunk.
-     - Numeric
-     - ``555.22``
-	 
-   * - ``column_aligned``
-     - Relevant to text columns, aligment in memory.
-     - Boolean
-     - ``Yes`` / ``No``
-
-The following is an example of the output generated from the ``GET_METADATA_CHUNK_KEY`` command:
-
-.. code-block:: postgres
-
-   master,0,0,1,chunk_state::clean,1,0,2,2,flat,0,0,,,0x7f722ffb7c60,0x7f722ffb7c70,1
-   master,0,1,1,chunk_state::clean,1,0,8,8,flat,1,2,,,0x7f722ffb7c60,0x7f722ffb7c70,1
-   master,0,2,1,chunk_state::clean,1,0,2,2,flat,0,0,,,0x7f722ffb7c60,0x7f722ffb7c70,1
-   master,0,3,1,chunk_state::clean,1,0,8,8,flat,3,3,,,0x7f722ffb7c60,0x7f722ffb7c70,1
-   master,0,4,1,chunk_state::clean,1,0,16,16,flat,0,0,abc,dfg,0x7f722ffb7c60,0x7f722ffb7c70,1
-   
-Permissions
-=============
-The ``GET_METADATA_CHUNK_KEY`` requires no special permissions.
\ No newline at end of file
diff --git a/releases/2022.1.rst b/releases/2022.1.rst
index f02676c34..3c5ae24e6 100644
--- a/releases/2022.1.rst
+++ b/releases/2022.1.rst
@@ -16,7 +16,6 @@ The 2022.1 Release Notes describes the following:
 * Enhanced security features.
 * New data manipulation command.
 * Additional data ingestion format.
-* New utility commands.
 
 New Features
 ----------
@@ -46,16 +45,6 @@ SQream now supports ingesting data from Avro files.
 
 For more information, see `Inserting Data from Avro `_.
 
-New Utility Commands
-************
-The following two new utility commands have been created:
-
-* `GET EXTENTS FILE FOR CHUNK `_ - points to all files that contain data related to a specific chunk. This command is used for debugging purposes.
-
-   ::
-   
-* `GET_METADATA_CHUNK_KEY `_ - returns specific metadata key values for user-specified chunks.
-
 Known Issues
 ---------
 The following table lists the known issues for Version 2022.1:

From ab2544bca967738da725b715b8fd76f937e397ca Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Tue, 26 Jul 2022 14:38:05 +0300
Subject: [PATCH 146/882] Corrected the links.

---
 configuration_guides/admin_cluster_flags.rst  |  2 +-
 configuration_guides/admin_regular_flags.rst  | 48 +++++++++----------
 configuration_guides/admin_worker_flags.rst   |  8 ++--
 .../generic_regular_flags.rst                 | 26 +++++-----
 configuration_guides/generic_worker_flags.rst |  2 +-
 5 files changed, 43 insertions(+), 43 deletions(-)

diff --git a/configuration_guides/admin_cluster_flags.rst b/configuration_guides/admin_cluster_flags.rst
index 3c74819d6..f17cee34a 100644
--- a/configuration_guides/admin_cluster_flags.rst
+++ b/configuration_guides/admin_cluster_flags.rst
@@ -6,4 +6,4 @@ Cluster Administration Flags
 
 The **Cluster Administration Flags** page describes **Cluster** modification type flags, which can be modified by administrators on a session and cluster basis using the ``ALTER SYSTEM SET`` command:
 
-* `Persisting Your Cache Directory `_
\ No newline at end of file
+* `Persisting Your Cache Directory `_
\ No newline at end of file
diff --git a/configuration_guides/admin_regular_flags.rst b/configuration_guides/admin_regular_flags.rst
index 5300310b6..064fc4b1a 100644
--- a/configuration_guides/admin_regular_flags.rst
+++ b/configuration_guides/admin_regular_flags.rst
@@ -5,27 +5,27 @@ Regular Administration Flags
 *************************
 The **Regular Administration Flags** page describes **Regular** modification type flags, which can be modified by administrators on a session and cluster basis using the ``ALTER SYSTEM SET`` command:
 
-* `Setting Bin Size `_
-* `Setting CUDA Memory `_
-* `Limiting Runtime to Utility Functions `_
-* `Enabling High Bin Control Granularity `_
-* `Reducing CPU Hashtable Sizes `_
-* `Setting Chunk Size for Copying from CPU to GPU `_
-* `Indicating GPU Synchronicity `_
-* `Enabling Modification of R&D Flags `_
-* `Checking for Post-Production CUDA Errors `_
-* `Enabling Modification of clientLogger_debug File `_
-* `Activating the NVidia Profiler Markers `_
-* `Appending String at End of Log Lines `_
-* `Monitoring and Printing Pinned Allocation Reports `_
-* `Increasing Chunk Size to Reduce Query Speed `_
-* `Adding Rechunker before Expensing Chunk Producer `_
-* `Setting the Buffer Size `_
-* `Setting Memory Used to Abort Server `_
-* `Splitting Large Reads for Concurrent Execution `_
-* `Setting Worker Amount to Handle Concurrent Reads `_
-* `Setting Implicit Casts in ORC Files `_
-* `Setting Timeout Limit for Locking Objects before Executing Statements `_
-* `Interpreting Decimal Literals as Double Instead of Numeric `_
-* `Interpreting VARCHAR as TEXT `_
-* `VARCHAR Identifiers `_
+* `Setting Bin Size `_
+* `Setting CUDA Memory `_
+* `Limiting Runtime to Utility Functions `_
+* `Enabling High Bin Control Granularity `_
+* `Reducing CPU Hashtable Sizes `_
+* `Setting Chunk Size for Copying from CPU to GPU `_
+* `Indicating GPU Synchronicity `_
+* `Enabling Modification of R&D Flags `_
+* `Checking for Post-Production CUDA Errors `_
+* `Enabling Modification of clientLogger_debug File `_
+* `Activating the NVidia Profiler Markers `_
+* `Appending String at End of Log Lines `_
+* `Monitoring and Printing Pinned Allocation Reports `_
+* `Increasing Chunk Size to Reduce Query Speed `_
+* `Adding Rechunker before Expensing Chunk Producer `_
+* `Setting the Buffer Size `_
+* `Setting Memory Used to Abort Server `_
+* `Splitting Large Reads for Concurrent Execution `_
+* `Setting Worker Amount to Handle Concurrent Reads `_
+* `Setting Implicit Casts in ORC Files `_
+* `Setting Timeout Limit for Locking Objects before Executing Statements `_
+* `Interpreting Decimal Literals as Double Instead of Numeric `_
+* `Interpreting VARCHAR as TEXT `_
+* `VARCHAR Identifiers `_
diff --git a/configuration_guides/admin_worker_flags.rst b/configuration_guides/admin_worker_flags.rst
index 2be570695..cd1a527d5 100644
--- a/configuration_guides/admin_worker_flags.rst
+++ b/configuration_guides/admin_worker_flags.rst
@@ -5,7 +5,7 @@ Worker Administration Flags
 *************************
 The **Worker Administration Flags** page describes **Worker** modification type flags, which can be modified by administrators on a session and cluster basis using the ``ALTER SYSTEM SET`` command:
 
-* `Setting Total Device Memory Usage in SQream Instance `_
-* `Enabling Manually Setting Reported IP `_
-* `Setting Port Used for Metadata Server Connection `_
-* `Assigning Local Network IP `_
\ No newline at end of file
+* `Setting Total Device Memory Usage in SQream Instance `_
+* `Enabling Manually Setting Reported IP `_
+* `Setting Port Used for Metadata Server Connection `_
+* `Assigning Local Network IP `_
\ No newline at end of file
diff --git a/configuration_guides/generic_regular_flags.rst b/configuration_guides/generic_regular_flags.rst
index f8235ae07..83afa9e8f 100644
--- a/configuration_guides/generic_regular_flags.rst
+++ b/configuration_guides/generic_regular_flags.rst
@@ -6,16 +6,16 @@ Regular Generic Flags
 
 The **Regular Generic Flags** page describes **Regular** modification type flags, which can be modified by standard users on a session basis:
 
-* `Flipping Join Order to Force Equijoins `_
-* `Determining Client Level `_
-* `Setting CPU to Compress Defined Columns `_
-* `Setting Query Memory Processing Limit `_
-* `Setting the Spool Memory `_
-* `Setting Cache Partitions `_
-* `Setting Cache Flushing `_
-* `Setting InMemory Spool Memory `_
-* `Setting Disk Spool Memory `_
-* `Setting Spool Saved File Directory Location `_
-* `Setting Data Stored Persistently on Cache `_
-* `Setting Persistent Spool Saved File Directory Location `_
-* `Setting Session Tag Name `_
\ No newline at end of file
+* `Flipping Join Order to Force Equijoins `_
+* `Determining Client Level `_
+* `Setting CPU to Compress Defined Columns `_
+* `Setting Query Memory Processing Limit `_
+* `Setting the Spool Memory `_
+* `Setting Cache Partitions `_
+* `Setting Cache Flushing `_
+* `Setting InMemory Spool Memory `_
+* `Setting Disk Spool Memory `_
+* `Setting Spool Saved File Directory Location `_
+* `Setting Data Stored Persistently on Cache `_
+* `Setting Persistent Spool Saved File Directory Location `_
+* `Setting Session Tag Name `_
\ No newline at end of file
diff --git a/configuration_guides/generic_worker_flags.rst b/configuration_guides/generic_worker_flags.rst
index 97cee4ecf..59fb9ac7a 100644
--- a/configuration_guides/generic_worker_flags.rst
+++ b/configuration_guides/generic_worker_flags.rst
@@ -5,4 +5,4 @@ Worker Generic Flags
 *************************
 The Worker Generic Flags** page describes **Worker** modification type flags, which can be modified by standard users on a session basis:
 
-   * `Persisting Your Cache Directory `_
\ No newline at end of file
+   * `Persisting Your Cache Directory `_
\ No newline at end of file

From 5956468d1b8c57b9724f109fc4aecd658ee18772 Mon Sep 17 00:00:00 2001
From: YanivGerowitz <82020437+YanivGerowitz@users.noreply.github.com>
Date: Tue, 26 Jul 2022 17:13:50 +0300
Subject: [PATCH 147/882] Update data_encryption_syntax.rst

---
 feature_guides/data_encryption_syntax.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/feature_guides/data_encryption_syntax.rst b/feature_guides/data_encryption_syntax.rst
index a7cb3e68d..3370698cf 100644
--- a/feature_guides/data_encryption_syntax.rst
+++ b/feature_guides/data_encryption_syntax.rst
@@ -22,4 +22,6 @@ The following is an example of encrypting a new table:
         last_name TEXT(128),
         salary INT(6) ENCRYPT);
 		   
-.. note::  Users without permissions cannot view the entire table as long as at least one column is encrypted. The (unique) encryption/decryption key is relevant only at the system level and is not held by users.
\ No newline at end of file
+.. note::  Users without permissions cannot view the entire table as long as at least one column is encrypted. The (unique) encryption/decryption key is relevant only at the system level and is not held by users.
+
+Note that the master key is hard-coded in the system and cannot be changed.

From 027a982ceddb086857411d6f3d51ad073f020e76 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 10:59:03 +0300
Subject: [PATCH 148/882] Released 2021.2.1.24

---
 feature_guides/index.rst        |  1 +
 feature_guides/query_healer.rst | 34 +++++++++++++++
 releases/2021.2.1.24.rst        | 77 +++++++++++++++++++++++++++++++++
 releases/2021.2_index.rst       |  1 +
 4 files changed, 113 insertions(+)
 create mode 100644 feature_guides/query_healer.rst
 create mode 100644 releases/2021.2.1.24.rst

diff --git a/feature_guides/index.rst b/feature_guides/index.rst
index 2ca100a0f..6011d5e0b 100644
--- a/feature_guides/index.rst
+++ b/feature_guides/index.rst
@@ -11,6 +11,7 @@ This section describes the following features:
    :maxdepth: 1
    :titlesonly:  
 
+   query_healer
    key_evaluation
    data_encryption
    compression
diff --git a/feature_guides/query_healer.rst b/feature_guides/query_healer.rst
new file mode 100644
index 000000000..7a2e0bc8d
--- /dev/null
+++ b/feature_guides/query_healer.rst
@@ -0,0 +1,34 @@
+.. _query_healer:
+
+***********************
+Query Healer
+***********************
+The **Query Healer** page describes the following:
+
+.. contents:: 
+   :local:
+   :depth: 1      
+   
+Overview
+----------
+The **Query Healer** periodically examines the progress of running statements, creating a log entry for all statements exceeding the ``healerMaxInactivityHours`` flag setting. The default setting of the ``healerMaxInactivityHours`` is five hours.
+
+Configuring the Healer
+------------------
+The following flags are required to configure the Query Healer:
+
+ * **isHealerOn** - Enables the Query Healer.
+
+    ::
+
+ * **healerMaxInactivityHours** - Defines the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU.
+
+The ``healerMaxInactivityHours`` log frequency is calculated as 5% of the flag setting. For example, setting ``healerMaxInactivityHours`` to five hours (the default setting) triggers an examination every 15 minutes.
+
+For more information, see the following Administration Worker flags:
+
+ * :ref:`is_healer_on`
+
+    ::
+
+ * :ref:`healerMaxInactivityHours
\ No newline at end of file
diff --git a/releases/2021.2.1.24.rst b/releases/2021.2.1.24.rst
new file mode 100644
index 000000000..7d8a1fd28
--- /dev/null
+++ b/releases/2021.2.1.24.rst
@@ -0,0 +1,77 @@
+.. _2021.2.1.24:
+
+**************************
+Release Notes 2021.2.1.24
+**************************
+The 2021.2.1.24 release notes were released on xx/xx/2022 and describe the following:
+
+.. contents:: 
+   :local:
+   :depth: 1      
+
+Version Content
+----------
+The 2021.2.1.24 Release Notes includes a query maintenance feature.
+
+New Features
+----------
+The 2021.2.1.24 Release Notes include the following new features:
+
+.. contents:: 
+   :local:
+   :depth: 1
+   
+Query Healer
+************
+The new **Query Healer** feature periodically examines the progress of running statements, and is used for query maintenance.
+
+For more information, see :ref:`query_healer`.
+
+Known Issues
+---------
+The following table lists the known issues for Version 2021.2.1.24:
+
++-------------+------------------------------------------------------------------------------------------------------------------------------------+
+| **SQ No.**  | **Description**                                                                                                                    |
++=============+====================================================================================================================================+
+| SQ-10071    | An error occurred on existing subqueries with ``TEXT`` and ``VARCHAR`` equality conditions.                                        |
++-------------+------------------------------------------------------------------------------------------------------------------------------------+
+| SQ-10606    | Queries were getting stuck in the queue for a prolonged time.                                                                      |
++-------------+------------------------------------------------------------------------------------------------------------------------------------+
+| SQ-10691    | The DB schema identifier was causing an error when running queries from joins suite.                                               |
++-------------+------------------------------------------------------------------------------------------------------------------------------------+
+| SQ-10902    | Inserting a null value into non-null column was causing SQream to crash.                                                           |
++-------------+------------------------------------------------------------------------------------------------------------------------------------+
+| SQ-10918    | The Workload Manager was only assigning jobs sequentially, delaying user SQLs assigned to workers running very large jobs.         |
++-------------+------------------------------------------------------------------------------------------------------------------------------------+
+| SQ-10955    | Metadata filters were not being applied when users filtered by nullable dates using ``dateadd``                                    |
++-------------+------------------------------------------------------------------------------------------------------------------------------------+
+| SQ-11088    | Specific workers caused low performance during compilation.                                                                        |
++-------------+------------------------------------------------------------------------------------------------------------------------------------+
+
+Resolved Issues
+---------
+The Resolved Issues section is not relevant for Version 2021.2.1.24.
+
+Operations and Configuration Changes
+--------
+No relevant operations and configuration changes were made.
+
+Naming Changes
+-------
+No relevant naming changes were made.
+
+Deprecated Features
+-------
+Version 2021.2.1.24 includes no deprecated features.
+
+End of Support
+-------
+The End of Support section is not relevant to Version 2021.2.1.24.
+ 
+.. toctree::
+   :maxdepth: 2
+   :glob:
+   :hidden:
+
+   2021.2.1.24
diff --git a/releases/2021.2_index.rst b/releases/2021.2_index.rst
index 77a22b0ae..9bee5fd66 100644
--- a/releases/2021.2_index.rst
+++ b/releases/2021.2_index.rst
@@ -13,5 +13,6 @@ The 2021.2 Release Notes describe the following releases:
    :maxdepth: 1
    :glob:
 
+   2021.2.1.24
    2021.2.1
    2021.2
\ No newline at end of file

From 30f98c94e945de893f18b2a60f8dfbe7c9a9db4c Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 11:02:26 +0300
Subject: [PATCH 149/882] Fixed release date

---
 releases/2021.2.1.24.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/releases/2021.2.1.24.rst b/releases/2021.2.1.24.rst
index 7d8a1fd28..125092f0e 100644
--- a/releases/2021.2.1.24.rst
+++ b/releases/2021.2.1.24.rst
@@ -3,7 +3,7 @@
 **************************
 Release Notes 2021.2.1.24
 **************************
-The 2021.2.1.24 release notes were released on xx/xx/2022 and describe the following:
+The 2021.2.1.24 release notes were released on 7/28/2022 and describe the following:
 
 .. contents:: 
    :local:

From 284c11bbd151ff9d63d9797bf103197a538467b1 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 11:15:54 +0300
Subject: [PATCH 150/882] Added missing flags

---
 configuration_guides/admin_worker_flags.rst        | 10 ++++++----
 .../healer_max_inactivity_hours.rst                | 14 ++++++++++++++
 configuration_guides/is_healer_on.rst              | 14 ++++++++++++++
 3 files changed, 34 insertions(+), 4 deletions(-)
 create mode 100644 configuration_guides/healer_max_inactivity_hours.rst
 create mode 100644 configuration_guides/is_healer_on.rst

diff --git a/configuration_guides/admin_worker_flags.rst b/configuration_guides/admin_worker_flags.rst
index cd1a527d5..a3ca2710a 100644
--- a/configuration_guides/admin_worker_flags.rst
+++ b/configuration_guides/admin_worker_flags.rst
@@ -5,7 +5,9 @@ Worker Administration Flags
 *************************
 The **Worker Administration Flags** page describes **Worker** modification type flags, which can be modified by administrators on a session and cluster basis using the ``ALTER SYSTEM SET`` command:
 
-* `Setting Total Device Memory Usage in SQream Instance `_
-* `Enabling Manually Setting Reported IP `_
-* `Setting Port Used for Metadata Server Connection `_
-* `Assigning Local Network IP `_
\ No newline at end of file
+* `Setting Total Device Memory Usage in SQream Instance `_
+* `Enabling Manually Setting Reported IP `_
+* `Setting Port Used for Metadata Server Connection `_
+* `Assigning Local Network IP `_
+* `Assigning Local Network IP `_
+* `Assigning Local Network IP `_
\ No newline at end of file
diff --git a/configuration_guides/healer_max_inactivity_hours.rst b/configuration_guides/healer_max_inactivity_hours.rst
new file mode 100644
index 000000000..730bd16ef
--- /dev/null
+++ b/configuration_guides/healer_max_inactivity_hours.rst
@@ -0,0 +1,14 @@
+.. _healer_max_inactivity_hours
+
+*************************
+Query Healer
+*************************
+The ``healerMaxInactivityHours`` flag is used for defining the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU.
+
+The following describes the ``healerMaxInactivityHours`` flag:
+
+* **Data type** - size_t
+* **Default value** - ``5``
+* **Allowed values** - 1-4000000000
+
+For related flags, see :ref:`is_healer_on`.
\ No newline at end of file
diff --git a/configuration_guides/is_healer_on.rst b/configuration_guides/is_healer_on.rst
new file mode 100644
index 000000000..8b90654ec
--- /dev/null
+++ b/configuration_guides/is_healer_on.rst
@@ -0,0 +1,14 @@
+.. _is_healer_on:
+
+*************************
+Enabling the Query Healer
+*************************
+The ``is_healer_on`` flag enables the Query Healer, which periodically examines the progress of running statements and logs statements exceeding the ``healerMaxInactivityHours`` flag setting.
+
+The following describes the ``is_healer_on`` flag:
+
+* **Data type** - boolean
+* **Default value** - ``true``
+* **Allowed values** - ``true``, ``false``
+
+For related flags, see :ref:`healer_max_inactivity_hours`.
\ No newline at end of file

From a7a03e2341991417303d52844440b1f0a50cee5b Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 11:18:30 +0300
Subject: [PATCH 151/882] Update healer_max_inactivity_hours.rst

---
 configuration_guides/healer_max_inactivity_hours.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration_guides/healer_max_inactivity_hours.rst b/configuration_guides/healer_max_inactivity_hours.rst
index 730bd16ef..d05d46014 100644
--- a/configuration_guides/healer_max_inactivity_hours.rst
+++ b/configuration_guides/healer_max_inactivity_hours.rst
@@ -1,4 +1,4 @@
-.. _healer_max_inactivity_hours
+.. _healer_max_inactivity_hours:
 
 *************************
 Query Healer

From 1d47c5e558e3b57126a3f7d83010026d48af290a Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 11:20:55 +0300
Subject: [PATCH 152/882] REmoved key evaluation

---
 feature_guides/index.rst                      |  1 -
 feature_guides/key_evaluation.rst             | 13 ----
 .../key_evaluation_operational_modes.rst      | 70 -------------------
 feature_guides/key_evaluation_overview.rst    | 16 -----
 4 files changed, 100 deletions(-)
 delete mode 100644 feature_guides/key_evaluation.rst
 delete mode 100644 feature_guides/key_evaluation_operational_modes.rst
 delete mode 100644 feature_guides/key_evaluation_overview.rst

diff --git a/feature_guides/index.rst b/feature_guides/index.rst
index 6011d5e0b..d70ceb705 100644
--- a/feature_guides/index.rst
+++ b/feature_guides/index.rst
@@ -12,7 +12,6 @@ This section describes the following features:
    :titlesonly:  
 
    query_healer
-   key_evaluation
    data_encryption
    compression
    python_functions
diff --git a/feature_guides/key_evaluation.rst b/feature_guides/key_evaluation.rst
deleted file mode 100644
index e016e68c7..000000000
--- a/feature_guides/key_evaluation.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-.. _key_evaluation:
-
-**************************
-Key Evaluation
-**************************
-The **Key Evaluation** section describes the following:
-
-.. toctree::
-   :maxdepth: 4
-   :titlesonly:
-   
-   key_evaluation_overview
-   key_evaluation_operational_modes
\ No newline at end of file
diff --git a/feature_guides/key_evaluation_operational_modes.rst b/feature_guides/key_evaluation_operational_modes.rst
deleted file mode 100644
index feb4fd9c1..000000000
--- a/feature_guides/key_evaluation_operational_modes.rst
+++ /dev/null
@@ -1,70 +0,0 @@
-.. _key_evaluation_operational_modes:
-
-**************************
-Operational Modes
-**************************
-Key Evaluation can be used to do one of the following:
-
-**Comment** - *Do users initiate one of these modes, or do they occur in the background on their own? The answer to this question determines whether key evaluation belongs in Feature Guides or Operational Guides.*
-
-.. contents:: 
-   :local:
-   :depth: 1
-
-View All Problematic Chunk Keys
-----------
-You can use the **View** mode to find all problematic keys in the database for all databases and/or tables.
-
-The following shows the View command options:
-
-.. code-block::
-     
-   $ select  keys_evaluate ('view');
-
-.. code-block::
-     
-   $ select  keys_evaluate ('view', 'master');
-
-.. code-block::
-     
-   $ select  keys_evaluate ('view', 'master', 'public.tbl');
-
-Find and Clean Problematic Keys from Storage
-----------
-You can use the **Clean Storage** mode to find all problematic keys located in the Storage for all databases.
-
-The following shows the Clean Storage command:
-
-.. code-block::
-     
-   $ select  keys_evaluate ('clean_storage');
-
-.. note:: This mode backs up the levelDB to the **backup** folder in the cluster before finding and cleaning problematic keys from your storage.
-   
-Find and Clean Problematic Keys from a Database
-----------
-You can use the **Clean Database** mode to find and clean all problematic keys located for a specific database and/or table.
-
-The following shows the Clean Database command options:
-
-.. code-block::
-     
-   $ select keys_evaluate ('clean_database','master');
-
-.. code-block::
-     
-   $ select keys_evaluate ('clean_database','master', 'public.tbl');
-
-.. note:: This mode backs up the levelDB to the **backup** folder in the cluster before finding and cleaning problematic keys from your database. 
-   
-Clean Specifically Defined Chunk Keys
-----------
-**Comment** - *Currently not supported. Remove until further notice?*
-
-You can use the **Clean Chunk Key** mode to clean a specific problematic chunk key. **Comment** - *Note: data_diag vs keys_evaluate.*
-
-The following shows the Clean Chunk Key command options:
-
-.. code-block::
-     
-   $ select data_diag (12, '');
\ No newline at end of file
diff --git a/feature_guides/key_evaluation_overview.rst b/feature_guides/key_evaluation_overview.rst
deleted file mode 100644
index 3d3aabf8a..000000000
--- a/feature_guides/key_evaluation_overview.rst
+++ /dev/null
@@ -1,16 +0,0 @@
-.. _key_evaluation_overview:
-
-**************************
-Overview
-**************************
-The **Key Evaluation** feature resolves conflicts caused by ingesting and deleting data at the same time. Although this rarely occurs, it causes the leveldb to restore keys pointing to deleted data. In turn, this causes SQream metadata to search for deleted files.
-
-An indication that this conflict has occurred is SQream's inability to retrieve deleted data pointers, generating the type of error shown below:
-
-.. code-block:: console
-   
-   Internal Runtime Error *** Error opening [errno 2 No such file or directory] file name /mnt/disk1/sqream_cluster/databases/******/tables/289/17/17-391270
-   
-In addition, key evaluation prevents the database from creating phantom keys, which are duplicate chunk keys generated when data is ingested. Under normal circumstances ingesting data creates incrementing chunk keys.
-
-**Comment** - *Please confirm the reason I provided based on my understanding of the source doc.*
\ No newline at end of file

From 100d27230010fef969978571cb048dd43d78c091 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 11:26:58 +0300
Subject: [PATCH 153/882] Fixed link

---
 feature_guides/query_healer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/feature_guides/query_healer.rst b/feature_guides/query_healer.rst
index 7a2e0bc8d..4d9b9e998 100644
--- a/feature_guides/query_healer.rst
+++ b/feature_guides/query_healer.rst
@@ -31,4 +31,4 @@ For more information, see the following Administration Worker flags:
 
     ::
 
- * :ref:`healerMaxInactivityHours
\ No newline at end of file
+ * :ref:`healer_max_inactivity_hours
\ No newline at end of file

From 34ec04726ada8871613cdf4090e073615232b5f0 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 11:41:16 +0300
Subject: [PATCH 154/882] Update query_healer.rst

---
 feature_guides/query_healer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/feature_guides/query_healer.rst b/feature_guides/query_healer.rst
index 4d9b9e998..4b7120db2 100644
--- a/feature_guides/query_healer.rst
+++ b/feature_guides/query_healer.rst
@@ -31,4 +31,4 @@ For more information, see the following Administration Worker flags:
 
     ::
 
- * :ref:`healer_max_inactivity_hours
\ No newline at end of file
+ * :ref:`healer_max_inactivity_hours`
\ No newline at end of file

From f4220cf1d4f71be492061949de2e17effa457d6d Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 11:48:46 +0300
Subject: [PATCH 155/882] Update admin_worker_flags.rst

---
 configuration_guides/admin_worker_flags.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/configuration_guides/admin_worker_flags.rst b/configuration_guides/admin_worker_flags.rst
index a3ca2710a..35edaf4ff 100644
--- a/configuration_guides/admin_worker_flags.rst
+++ b/configuration_guides/admin_worker_flags.rst
@@ -9,5 +9,5 @@ The **Worker Administration Flags** page describes **Worker** modification type
 * `Enabling Manually Setting Reported IP `_
 * `Setting Port Used for Metadata Server Connection `_
 * `Assigning Local Network IP `_
-* `Assigning Local Network IP `_
-* `Assigning Local Network IP `_
\ No newline at end of file
+* `Enabling the Query Healer `_
+* `Configuring the Query Healer `_
\ No newline at end of file

From b3c547958ab046c4e819f759ee4cda988bad5239 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 11:59:10 +0300
Subject: [PATCH 156/882] Update healer_max_inactivity_hours.rst

---
 configuration_guides/healer_max_inactivity_hours.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration_guides/healer_max_inactivity_hours.rst b/configuration_guides/healer_max_inactivity_hours.rst
index d05d46014..56ddb78fc 100644
--- a/configuration_guides/healer_max_inactivity_hours.rst
+++ b/configuration_guides/healer_max_inactivity_hours.rst
@@ -1,7 +1,7 @@
 .. _healer_max_inactivity_hours:
 
 *************************
-Query Healer
+Configuring the Query Healer
 *************************
 The ``healerMaxInactivityHours`` flag is used for defining the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU.
 

From e2dbe63ebe42fb20aad7e4cdb2e826f4e3856f42 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 12:02:16 +0300
Subject: [PATCH 157/882] Update admin_worker_flags.rst

---
 configuration_guides/admin_worker_flags.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration_guides/admin_worker_flags.rst b/configuration_guides/admin_worker_flags.rst
index 35edaf4ff..def1e8dac 100644
--- a/configuration_guides/admin_worker_flags.rst
+++ b/configuration_guides/admin_worker_flags.rst
@@ -9,5 +9,5 @@ The **Worker Administration Flags** page describes **Worker** modification type
 * `Enabling Manually Setting Reported IP `_
 * `Setting Port Used for Metadata Server Connection `_
 * `Assigning Local Network IP `_
-* `Enabling the Query Healer `_
+* `Enabling the Query Healer `_
 * `Configuring the Query Healer `_
\ No newline at end of file

From 55c2ae428cc8d95f40e0588bf01a55b54a1f3a36 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 12:08:47 +0300
Subject: [PATCH 158/882] Update admin_worker_flags.rst

---
 configuration_guides/admin_worker_flags.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/configuration_guides/admin_worker_flags.rst b/configuration_guides/admin_worker_flags.rst
index def1e8dac..5725fc507 100644
--- a/configuration_guides/admin_worker_flags.rst
+++ b/configuration_guides/admin_worker_flags.rst
@@ -5,9 +5,9 @@ Worker Administration Flags
 *************************
 The **Worker Administration Flags** page describes **Worker** modification type flags, which can be modified by administrators on a session and cluster basis using the ``ALTER SYSTEM SET`` command:
 
-* `Setting Total Device Memory Usage in SQream Instance `_
-* `Enabling Manually Setting Reported IP `_
-* `Setting Port Used for Metadata Server Connection `_
+* `Setting Total Device Memory Usage in SQream Instance `_
+* `Enabling Manually Setting Reported IP `_
+* `Setting Port Used for Metadata Server Connection `_
 * `Assigning Local Network IP `_
 * `Enabling the Query Healer `_
-* `Configuring the Query Healer `_
\ No newline at end of file
+* `Configuring the Query Healer `_
\ No newline at end of file

From 207472f01f0713446f202e6146dc80d551c70c67 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 12:15:37 +0300
Subject: [PATCH 159/882] Added log example

---
 feature_guides/query_healer.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/feature_guides/query_healer.rst b/feature_guides/query_healer.rst
index 4b7120db2..07e2dc0e4 100644
--- a/feature_guides/query_healer.rst
+++ b/feature_guides/query_healer.rst
@@ -13,6 +13,12 @@ Overview
 ----------
 The **Query Healer** periodically examines the progress of running statements, creating a log entry for all statements exceeding the ``healerMaxInactivityHours`` flag setting. The default setting of the ``healerMaxInactivityHours`` is five hours.
 
+The following is an example of a log record for a query stuck in the query detection phase for more than five hours:
+
+   .. code-block:: console
+
+      2022/05/19::20:01:25|ERROR|Healer|(0x7f07147fc700)|Stuck query found. Statement ID: 72, Last chunk producer updated: 1 WriteTable, Started on: Thu May 19 14:01:25 2022, Last updated: Thu May 19 15:01:25 2022, Stuck time: 5 hours, Max allowed stuck query time: 5 hours
+
 Configuring the Healer
 ------------------
 The following flags are required to configure the Query Healer:

From c5f344027a90af81ffaf7e8ecea154a7f6cb08b8 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 12:47:04 +0300
Subject: [PATCH 160/882] Update query_healer.rst

---
 feature_guides/query_healer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/feature_guides/query_healer.rst b/feature_guides/query_healer.rst
index 07e2dc0e4..cb50549b8 100644
--- a/feature_guides/query_healer.rst
+++ b/feature_guides/query_healer.rst
@@ -15,9 +15,9 @@ The **Query Healer** periodically examines the progress of running statements, c
 
 The following is an example of a log record for a query stuck in the query detection phase for more than five hours:
 
-   .. code-block:: console
+.. code-block:: console
 
-      2022/05/19::20:01:25|ERROR|Healer|(0x7f07147fc700)|Stuck query found. Statement ID: 72, Last chunk producer updated: 1 WriteTable, Started on: Thu May 19 14:01:25 2022, Last updated: Thu May 19 15:01:25 2022, Stuck time: 5 hours, Max allowed stuck query time: 5 hours
+   2022/05/19::20:01:25|ERROR|Healer|(0x7f07147fc700)|Stuck query found. Statement ID: 72, Last chunk producer updated: 1 WriteTable, Started on: Thu May 19 14:01:25 2022, Last updated: Thu May 19 15:01:25 2022, Stuck time: 5 hours, Max allowed stuck query time: 5 hours
 
 Configuring the Healer
 ------------------

From 664e4fe191aab8deafce010b68399c944655791b Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 14:06:46 +0300
Subject: [PATCH 161/882] Created and Published 2022.1.1

Including all related documentation updates.
---
 configuration_guides/admin_worker_flags.rst   |   5 +-
 configuration_guides/login_max_retries.rst    |  11 +
 operational_guides/access_control.rst         | 587 +-----------------
 .../access_control_departmental_example.rst   | 185 ++++++
 .../access_control_managing_roles.rst         | 124 ++++
 .../access_control_overview.rst               |  20 +
 .../access_control_password_policy.rst        |  42 ++
 .../access_control_permissions.rst            | 218 +++++++
 releases/2022.1.1.rst                         | 115 ++++
 releases/2022.1_index.rst                     |  17 +
 10 files changed, 744 insertions(+), 580 deletions(-)
 create mode 100644 configuration_guides/login_max_retries.rst
 create mode 100644 operational_guides/access_control_departmental_example.rst
 create mode 100644 operational_guides/access_control_managing_roles.rst
 create mode 100644 operational_guides/access_control_overview.rst
 create mode 100644 operational_guides/access_control_password_policy.rst
 create mode 100644 operational_guides/access_control_permissions.rst
 create mode 100644 releases/2022.1.1.rst
 create mode 100644 releases/2022.1_index.rst

diff --git a/configuration_guides/admin_worker_flags.rst b/configuration_guides/admin_worker_flags.rst
index 5725fc507..453c66af8 100644
--- a/configuration_guides/admin_worker_flags.rst
+++ b/configuration_guides/admin_worker_flags.rst
@@ -8,6 +8,7 @@ The **Worker Administration Flags** page describes **Worker** modification type
 * `Setting Total Device Memory Usage in SQream Instance `_
 * `Enabling Manually Setting Reported IP `_
 * `Setting Port Used for Metadata Server Connection `_
-* `Assigning Local Network IP `_
+* `Assigning Local Network IP `_
 * `Enabling the Query Healer `_
-* `Configuring the Query Healer `_
\ No newline at end of file
+* `Configuring the Query Healer `_
+* `Adjusting Permitted Log-in Attempts `_
\ No newline at end of file
diff --git a/configuration_guides/login_max_retries.rst b/configuration_guides/login_max_retries.rst
new file mode 100644
index 000000000..bf3ae6d40
--- /dev/null
+++ b/configuration_guides/login_max_retries.rst
@@ -0,0 +1,11 @@
+.. _login_max_retries:
+
+*************************
+Adjusting Permitted Log-in Attempts
+*************************
+The ``loginMaxRetries`` flag sets the permitted log-in attempts.
+
+The following describes the ``loginMaxRetries`` flag:
+
+* **Data type** - size_t
+* **Default value** - ``5``
\ No newline at end of file
diff --git a/operational_guides/access_control.rst b/operational_guides/access_control.rst
index ffe687213..bd25d0d99 100644
--- a/operational_guides/access_control.rst
+++ b/operational_guides/access_control.rst
@@ -4,581 +4,12 @@
 Access Control
 **************
 
-.. contents:: 
-   :local:
-   :depth: 1
-
-Overview
-==========
-Access control provides authentication and authorization in SQream DB. SQream DB manages authentication and authorization using a role-based access control system (RBAC), like ANSI SQL and other SQL products.
-
-SQream DB has a default permissions system which is inspired by Postgres, but with more power. In most cases, this allows an administrator to set things up so that every object gets permissions set automatically. In SQream DB, users log in from any worker which verifies their roles and permissions from the metadata server. Each statement issues commands as the currently logged in role.
-
-Roles are defined at the cluster level, meaning they are valid for all databases in the cluster. To bootstrap SQream DB, a new install will always have one ``SUPERUSER`` role, typically named ``sqream``. To create more roles, you should first connect as this role.
-
-The following:
-
-* **Role** - a role can be a user, a group, or both. Roles can own database objects (e.g. tables), and can assign permissions on those objects to other roles. Roles can be members of other roles, meaning a user role can inherit permissions from its parent role.
-
-   ::
-
-* **Authentication** - verifying the identity of the role. User roles have usernames (:term:`role names`) and passwords.
-
-   ::
-
-* **Authorization** - checking the role has permissions to do a particular thing. The :ref:`grant` command is used for this.
-
-Managing Roles
-=====
-Roles are used for both users and groups. Roles are global across all databases in the SQream DB cluster. To use a ``ROLE`` as a user, it should have a password, the login permission, and connect permissions to the relevant databases.
-
-The Roles section describes the following role-related operations:
-
-.. contents:: 
-   :local:
-   :depth: 1
-
-Creating New Roles (Users)
-------------------------------
-A user role can log in to the database, so it should have ``LOGIN`` permissions, as well as a password.
-
-For example:
-
-.. code-block:: postgres
-                
-   CREATE ROLE role_name ;
-   GRANT LOGIN to role_name ;
-   GRANT PASSWORD 'new_password' to role_name ;
-   GRANT CONNECT ON DATABASE database_name to role_name ;
-
-Examples:
-
-.. code-block:: postgres
-
-   CREATE  ROLE  new_role_name  ;  
-   GRANT  LOGIN  TO  new_role_name;  
-   GRANT  PASSWORD  'my_password'  TO  new_role_name;  
-   GRANT  CONNECT  ON  DATABASE  master  TO  new_role_name;
-
-A database role may have a number of permissions that define what tasks it can perform. These are assigned using the :ref:`grant` command.
-
-Dropping Users
----------------
-
-.. code-block:: postgres
-
-   DROP ROLE role_name ;
-
-Examples:
-
-.. code-block:: postgres
-
-   DROP ROLE  admin_role ;
-
-Altering a User Name
-------------------------
-
-Renaming a user's role:
-
-.. code-block:: postgres
-
-   ALTER ROLE role_name RENAME TO new_role_name ;
-
-Examples:
-
-.. code-block:: postgres
-
-   ALTER ROLE  admin_role  RENAME  TO  copy_role ;
-
-.. _change_password:
-
-Changing User Passwords
---------------------------
-
-To change a user role's password, grant the user a new password.
-
-.. code-block:: postgres
-
-   GRANT  PASSWORD  'new_password'  TO  rhendricks;  
-
-.. note:: Granting a new password overrides any previous password. Changing the password while the role has an active running statement does not affect that statement, but will affect subsequent statements.
-
-Altering Public Role Permissions
------------
-
-There is a public role which always exists. Each role is granted to the ``PUBLIC`` role (i.e. is a member of the public group), and this cannot be revoked. You can alter the permissions granted to the public role.
-
-The ``PUBLIC`` role has ``USAGE`` and ``CREATE`` permissions on ``PUBLIC`` schema by default, therefore, new users can create, :ref:`insert`, :ref:`delete`, and :ref:`select` from objects in the ``PUBLIC`` schema.
-
-
-Altering Role Membership (Groups)
--------------------------
-
-Many database administrators find it useful to group user roles together. By grouping users, permissions can be granted to, or revoked from a group with one command. In SQream DB, this is done by creating a group role, granting permissions to it, and then assigning users to that group role.
-
-To use a role purely as a group, omit granting it ``LOGIN`` and ``PASSWORD`` permissions.
-
-The ``CONNECT`` permission can be given directly to user roles, and/or to the groups they are part of.
-
-.. code-block:: postgres
-
-   CREATE ROLE my_group;
-
-Once the group role exists, you can add user roles (members) using the ``GRANT`` command. For example:
-
-.. code-block:: postgres
-
-   -- Add my_user to this group
-   GRANT my_group TO my_user;
-
-
-To manage object permissions like databases and tables, you would then grant permissions to the group-level role (see :ref:`the permissions table` below.
-
-All member roles then inherit the permissions from the group. For example:
-
-.. code-block:: postgres
-
-   -- Grant all group users connect permissions
-   GRANT  CONNECT  ON  DATABASE  a_database  TO  my_group;
-   
-   -- Grant all permissions on tables in public schema
-   GRANT  ALL  ON  all  tables  IN  schema  public  TO  my_group;
-
-Removing users and permissions can be done with the ``REVOKE`` command:
-
-.. code-block:: postgres
-
-   -- remove my_other_user from this group
-   REVOKE my_group FROM my_other_user;
-
-.. _permissions_table:
-
-Permissions
-===========
-The following table displays the access control permissions:
-
-.. list-table:: 
-   :widths: auto
-   :header-rows: 1
-
-   * - Object/layer
-     - Permission
-     - Description
-
-   * - all databases
-     - ``LOGIN``
-     - use role to log into the system (the role also needs connect permission on the database it is connecting to)
-
-   * - all databases
-     - ``PASSWORD``
-     - the password used for logging into the system
-
-   * - all databases
-     - ``SUPERUSER``
-     - no permission restrictions on any activity
-
-   * - database
-     - ``SUPERUSER``
-     - no permission restrictions on any activity within that database (this does not include modifying roles or permissions)
-
-   * - database
-     - ``CONNECT``
-     - connect to the database
-
-   * - database
-     - ``CREATE``
-     - create schemas in the database
-
-   * - database
-     - ``CREATE FUNCTION``
-     - create and drop functions
-     
-   * - schema
-     - ``USAGE``
-     - allows additional permissions within the schema
-
-   * - schema
-     - ``CREATE``
-     - create tables in the schema
-
-   * - table
-     - ``SELECT``
-     - :ref:`select` from the table
-
-   * - table
-     - ``INSERT``
-     - :ref:`insert` into the table
-     
-   * - table
-     - ``UPDATE``
-     - :ref:`update` the value of certain columns in existing rows without creating a table
-
-   * - table
-     - ``DELETE``
-     - :ref:`delete` and :ref:`truncate` on the table
-
-   * - table
-     - ``DDL``
-     - drop and alter on the table
-
-   * - table
-     - ``ALL``
-     - all the table permissions
-
-   * - function
-     - ``EXECUTE``
-     - use the function
-
-   * - function
-     - ``DDL``
-     - drop and alter on the function
-
-   * - function
-     - ``ALL``
-     - all function permissions
-
-GRANT
------
-
-:ref:`grant` gives permissions to a role, shown in the following syntax example:
-
-.. code-block:: postgres
-
-   -- Grant permissions at the instance/ storage cluster level:
-   GRANT 
-
-   { SUPERUSER
-   | LOGIN 
-   | PASSWORD '' 
-   } 
-   TO  [, ...] 
-
-   -- Grant permissions at the database level:
-        GRANT {{CREATE | CONNECT| DDL | SUPERUSER | CREATE FUNCTION} [, ...] | ALL [PERMISSIONS]}
-
-   ON DATABASE  [, ...]
-   TO  [, ...] 
-
-   -- Grant permissions at the schema level: 
-   GRANT {{ CREATE | DDL | USAGE | SUPERUSER } [, ...] | ALL [ 
-   PERMISSIONS ]} 
-   ON SCHEMA  [, ...] 
-   TO  [, ...] 
-       
-   -- Grant permissions at the object level: 
-   GRANT {{SELECT | INSERT | DELETE | DDL } [, ...] | ALL [PERMISSIONS]} 
-   ON { TABLE  [, ...] | ALL TABLES IN SCHEMA  [, ...]} 
-   TO  [, ...]
-       
-   -- Grant execute function permission: 
-   GRANT {ALL | EXECUTE | DDL} ON FUNCTION function_name 
-   TO role; 
-       
-   -- Allows role2 to use permissions granted to role1
-   GRANT  [, ...] 
-   TO  
-
-    -- Also allows the role2 to grant role1 to other roles:
-   GRANT  [, ...] 
-   TO  
-   WITH ADMIN OPTION
-   
-The following are some ``GRANT`` examples:
-
-.. code-block:: postgres
-
-   GRANT  LOGIN,superuser  TO  admin;
-
-   GRANT  CREATE  FUNCTION  ON  database  master  TO  admin;
-
-   GRANT  SELECT  ON  TABLE  admin.table1  TO  userA;
-
-   GRANT  EXECUTE  ON  FUNCTION  my_function  TO  userA;
-
-   GRANT  ALL  ON  FUNCTION  my_function  TO  userA;
-
-   GRANT  DDL  ON  admin.main_table  TO  userB;
-
-   GRANT  ALL  ON  all  tables  IN  schema  public  TO  userB;
-
-   GRANT  admin  TO  userC;
-
-   GRANT  superuser  ON  schema  demo  TO  userA
-
-   GRANT  admin_role  TO  userB;
-
-REVOKE
-------
-
-:ref:`revoke` removes permissions from a role, shown in the following syntax example:
-
-.. code-block:: postgres
-
-   -- Revoke permissions at the instance/ storage cluster level:
-   REVOKE
-   { SUPERUSER
-   | LOGIN
-   | PASSWORD
-   }
-   FROM  [, ...]
-            
-   -- Revoke permissions at the database level:
-   REVOKE {{CREATE | CONNECT | DDL | SUPERUSER | CREATE FUNCTION}[, ...] |ALL [PERMISSIONS]}
-   ON DATABASE  [, ...]
-   FROM  [, ...]
-
-   -- Revoke permissions at the schema level:
-   REVOKE { { CREATE | DDL | USAGE | SUPERUSER } [, ...] | ALL [PERMISSIONS]}
-   ON SCHEMA  [, ...]
-   FROM  [, ...]
-            
-   -- Revoke permissions at the object level:
-   REVOKE { { SELECT | INSERT | DELETE | DDL } [, ...] | ALL }
-   ON { [ TABLE ]  [, ...] | ALL TABLES IN SCHEMA
-
-          [, ...] }
-   FROM  [, ...]
-            
-   -- Removes access to permissions in role1 by role 2
-   REVOKE  [, ...] FROM  [, ...] WITH ADMIN OPTION
-
-   -- Removes permissions to grant role1 to additional roles from role2
-   REVOKE  [, ...] FROM  [, ...] WITH ADMIN OPTION
-
-
-Examples:
-
-.. code-block:: postgres
-
-   REVOKE  superuser  on  schema  demo  from  userA;
-
-   REVOKE  delete  on  admin.table1  from  userB;
-
-   REVOKE  login  from  role_test;
-
-   REVOKE  CREATE  FUNCTION  FROM  admin;
-
-Default Permissions
--------------------
-
-The default permissions system (See :ref:`alter_default_permissions`) 
-can be used to automatically grant permissions to newly 
-created objects (See the departmental example below for one way it can be used).
-
-A default permissions rule looks for a schema being created, or a
-table (possibly by schema), and is table to grant any permission to
-that object to any role. This happens when the create table or create
-schema statement is run.
-
-
-.. code-block:: postgres
-
-
-   ALTER DEFAULT PERMISSIONS FOR target_role_name
-        [IN schema_name, ...]
-        FOR { TABLES | SCHEMAS }
-        { grant_clause | DROP grant_clause}
-        TO ROLE { role_name | public };
-
-   grant_clause ::=
-     GRANT
-        { CREATE FUNCTION
-        | SUPERUSER
-        | CONNECT
-        | CREATE
-        | USAGE
-        | SELECT
-        | INSERT
-        | UPDATE
-        | DELETE
-        | DDL
-        | EXECUTE
-        | ALL
-        }
-
-
-Departmental Example
-=======================
-
-You work in a company with several departments.
-
-The example below shows you how to manage permissions in a database shared by multiple departments, where each department has different roles for the tables by schema. It walks you through how to set the permissions up for existing objects and how to set up default permissions rules to cover newly created objects.
-
-The concept is that you set up roles for each new schema with the correct permissions, then the existing users can use these roles. 
-
-A superuser must do new setup for each new schema which is a limitation, but superuser permissions are not needed at any other time, and neither are explicit grant statements or object ownership changes.
-
-In the example, the database is called ``my_database``, and the new or existing schema being set up to be managed in this way is called ``my_schema``.
-
-.. figure:: /_static/images/access_control_department_example.png
-   :scale: 60 %
-   
-   Our departmental example has four user group roles and seven users roles
-
-There will be a group for this schema for each of the following:
-
-.. list-table:: 
-   :widths: auto
-   :header-rows: 1
-
-   * - Group
-     - Activities
-
-   * - database designers
-     - create, alter and drop tables
-
-   * - updaters
-     - insert and delete data
-
-   * - readers
-     - read data
-
-   * - security officers
-     - add and remove users from these groups
-
-Setting up the department permissions
-------------------------------------------
-
-As a superuser, you connect to the system and run the following:
-
-.. code-block:: postgres
-
-   -- create the groups
-
-   CREATE ROLE my_schema_security_officers;
-   CREATE ROLE my_schema_database_designers;
-   CREATE ROLE my_schema_updaters;
-   CREATE ROLE my_schema_readers;
-
-   -- grant permissions for each role
-   -- we grant permissions for existing objects here too, 
-   -- so you don't have to start with an empty schema
-
-   -- security officers
-
-   GRANT connect ON DATABASE my_database TO my_schema_security_officers;
-   GRANT usage ON SCHEMA my_schema TO my_schema_security_officers;
-
-   GRANT my_schema_database_designers TO my_schema_security_officers WITH ADMIN OPTION;
-   GRANT my_schema_updaters TO my_schema_security_officers WITH ADMIN OPTION;
-   GRANT my_schema_readers TO my_schema_security_officers WITH ADMIN OPTION;
-
-   -- database designers
-
-   GRANT connect ON DATABASE my_database TO my_schema_database_designers;
-   GRANT usage ON SCHEMA my_schema TO my_schema_database_designers;
-
-   GRANT create,ddl ON SCHEMA my_schema TO my_schema_database_designers;
-
-   -- updaters
-
-   GRANT connect ON DATABASE my_database TO my_schema_updaters;
-   GRANT usage ON SCHEMA my_schema TO my_schema_updaters;
-
-   GRANT SELECT,INSERT,DELETE ON ALL TABLES IN SCHEMA my_schema TO my_schema_updaters;
-
-   -- readers
-
-   GRANT connect ON DATABASE my_database TO my_schema_readers;
-   GRANT usage ON SCHEMA my_schema TO my_schema_readers;
-
-   GRANT SELECT ON ALL TABLES IN SCHEMA my_schema TO my_schema_readers;
-   GRANT EXECUTE ON ALL FUNCTIONS TO my_schema_readers;
-
-
-   -- create the default permissions for new objects
-
-   ALTER DEFAULT PERMISSIONS FOR my_schema_database_designers IN my_schema
-    FOR TABLES GRANT SELECT,INSERT,DELETE TO my_schema_updaters;
-
-   -- For every table created by my_schema_database_designers, give access to my_schema_readers:
-   
-   ALTER DEFAULT PERMISSIONS FOR my_schema_database_designers IN my_schema
-    FOR TABLES GRANT SELECT TO my_schema_readers;
-
-.. note::
-   * This process needs to be repeated by a user with ``SUPERUSER`` permissions each time a new schema is brought into this permissions management approach.
-   
-   * 
-      By default, any new object created will not be accessible by our new ``my_schema_readers`` group.
-      Running a ``GRANT SELECT ...`` only affects objects that already exist in the schema or database.
-   
-      If you're getting a ``Missing the following permissions: SELECT on table 'database.public.tablename'`` error, make sure that
-      you've altered the default permissions with the ``ALTER DEFAULT PERMISSIONS`` statement.
-
-Creating new users in the departments
------------------------------------------
-
-After the group roles have been created, you can now create user roles for each of your users.
-
-.. code-block:: postgres
-
-   -- create the new database designer users
-   
-   CREATE  ROLE  ecodd;
-   GRANT  LOGIN  TO  ecodd;
-   GRANT  PASSWORD  'ecodds_secret_password'  TO ecodd;
-   GRANT  CONNECT  ON  DATABASE  my_database  TO  ecodd;
-   GRANT my_schema_database_designers TO ecodd;
-
-   CREATE  ROLE  ebachmann;
-   GRANT  LOGIN  TO  ebachmann;
-   GRANT  PASSWORD  'another_secret_password'  TO ebachmann;
-   GRANT  CONNECT  ON  DATABASE  my_database  TO  ebachmann;
-   GRANT my_database_designers TO ebachmann;
-
-   -- If a user already exists, we can assign that user directly to the group
-   
-   GRANT my_schema_updaters TO rhendricks;
-   
-   -- Create users in the readers group
-   
-   CREATE  ROLE  jbarker;
-   GRANT  LOGIN  TO  jbarker;
-   GRANT  PASSWORD  'action_jack'  TO jbarker;
-   GRANT  CONNECT  ON  DATABASE  my_database  TO  jbarker;
-   GRANT my_schema_readers TO jbarker;
-   
-   CREATE  ROLE  lbream;
-   GRANT  LOGIN  TO  lbream;
-   GRANT  PASSWORD  'artichoke123'  TO lbream;
-   GRANT  CONNECT  ON  DATABASE  my_database  TO  lbream;
-   GRANT my_schema_readers TO lbream;
-   
-   CREATE  ROLE  pgregory;
-   GRANT  LOGIN  TO  pgregory;
-   GRANT  PASSWORD  'c1ca6a'  TO pgregory;
-   GRANT  CONNECT  ON  DATABASE  my_database  TO  pgregory;
-   GRANT my_schema_readers TO pgregory;
-
-   -- Create users in the security officers group
-
-   CREATE  ROLE  hoover;
-   GRANT  LOGIN  TO  hoover;
-   GRANT  PASSWORD  'mintchip'  TO hoover;
-   GRANT  CONNECT  ON  DATABASE  my_database  TO  hoover;
-   GRANT my_schema_security_officers TO hoover;
-
-
-.. todo:
-   create some example users
-   show that they have the right permission
-   try out the with admin option. we can't really do a security officer because
-   only superusers can create users and logins. see what can be done
-   need 1-2 users in each group, for at least 2 schemas/departments
-   this example will be very big just to show what this setup can do ...
-   example: a security officer for a department which will only have
-     read only access to a schema can only get that with admin option
-     access granted to them
-
-After this setup:
-
-* Database designers will be able to run any ddl on objects in the schema and create new objects, including ones created by other database designers
-* Updaters will be able to insert and delete to existing and new tables
-* Readers will be able to read from existing and new tables
-
-All this will happen without having to run any more ``GRANT`` statements.
-
-Any security officer will be able to add and remove users from these
-groups. Creating and dropping login users themselves must be done by a
-superuser.
+.. toctree::
+   :maxdepth: 1
+   :titlesonly:
+
+   access_control_overview
+   access_control_managing_roles
+   access_control_permissions
+   access_control_password_policy   
+   access_control_departmental_example
\ No newline at end of file
diff --git a/operational_guides/access_control_departmental_example.rst b/operational_guides/access_control_departmental_example.rst
new file mode 100644
index 000000000..0a6b55e54
--- /dev/null
+++ b/operational_guides/access_control_departmental_example.rst
@@ -0,0 +1,185 @@
+.. _access_control_departmental_example:
+
+**************
+Departmental Example
+**************
+
+You work in a company with several departments.
+
+The example below shows you how to manage permissions in a database shared by multiple departments, where each department has different roles for the tables by schema. It walks you through how to set the permissions up for existing objects and how to set up default permissions rules to cover newly created objects.
+
+The concept is that you set up roles for each new schema with the correct permissions, then the existing users can use these roles. 
+
+A superuser must do new setup for each new schema which is a limitation, but superuser permissions are not needed at any other time, and neither are explicit grant statements or object ownership changes.
+
+In the example, the database is called ``my_database``, and the new or existing schema being set up to be managed in this way is called ``my_schema``.
+
+Our departmental example has four user group roles and seven users roles
+
+There will be a group for this schema for each of the following:
+
+.. list-table:: 
+   :widths: auto
+   :header-rows: 1
+
+   * - Group
+     - Activities
+
+   * - database designers
+     - create, alter and drop tables
+
+   * - updaters
+     - insert and delete data
+
+   * - readers
+     - read data
+
+   * - security officers
+     - add and remove users from these groups
+
+Setting up the department permissions
+------------------------------------------
+
+As a superuser, you connect to the system and run the following:
+
+.. code-block:: postgres
+
+   -- create the groups
+
+   CREATE ROLE my_schema_security_officers;
+   CREATE ROLE my_schema_database_designers;
+   CREATE ROLE my_schema_updaters;
+   CREATE ROLE my_schema_readers;
+
+   -- grant permissions for each role
+   -- we grant permissions for existing objects here too, 
+   -- so you don't have to start with an empty schema
+
+   -- security officers
+
+   GRANT connect ON DATABASE my_database TO my_schema_security_officers;
+   GRANT usage ON SCHEMA my_schema TO my_schema_security_officers;
+
+   GRANT my_schema_database_designers TO my_schema_security_officers WITH ADMIN OPTION;
+   GRANT my_schema_updaters TO my_schema_security_officers WITH ADMIN OPTION;
+   GRANT my_schema_readers TO my_schema_security_officers WITH ADMIN OPTION;
+
+   -- database designers
+
+   GRANT connect ON DATABASE my_database TO my_schema_database_designers;
+   GRANT usage ON SCHEMA my_schema TO my_schema_database_designers;
+
+   GRANT create,ddl ON SCHEMA my_schema TO my_schema_database_designers;
+
+   -- updaters
+
+   GRANT connect ON DATABASE my_database TO my_schema_updaters;
+   GRANT usage ON SCHEMA my_schema TO my_schema_updaters;
+
+   GRANT SELECT,INSERT,DELETE ON ALL TABLES IN SCHEMA my_schema TO my_schema_updaters;
+
+   -- readers
+
+   GRANT connect ON DATABASE my_database TO my_schema_readers;
+   GRANT usage ON SCHEMA my_schema TO my_schema_readers;
+
+   GRANT SELECT ON ALL TABLES IN SCHEMA my_schema TO my_schema_readers;
+   GRANT EXECUTE ON ALL FUNCTIONS TO my_schema_readers;
+
+
+   -- create the default permissions for new objects
+
+   ALTER DEFAULT PERMISSIONS FOR my_schema_database_designers IN my_schema
+    FOR TABLES GRANT SELECT,INSERT,DELETE TO my_schema_updaters;
+
+   -- For every table created by my_schema_database_designers, give access to my_schema_readers:
+   
+   ALTER DEFAULT PERMISSIONS FOR my_schema_database_designers IN my_schema
+    FOR TABLES GRANT SELECT TO my_schema_readers;
+
+.. note::
+   * This process needs to be repeated by a user with ``SUPERUSER`` permissions each time a new schema is brought into this permissions management approach.
+   
+   * 
+      By default, any new object created will not be accessible by our new ``my_schema_readers`` group.
+      Running a ``GRANT SELECT ...`` only affects objects that already exist in the schema or database.
+   
+      If you're getting a ``Missing the following permissions: SELECT on table 'database.public.tablename'`` error, make sure that
+      you've altered the default permissions with the ``ALTER DEFAULT PERMISSIONS`` statement.
+
+Creating new users in the departments
+-----------------------------------------
+
+After the group roles have been created, you can now create user roles for each of your users.
+
+.. code-block:: postgres
+
+   -- create the new database designer users
+   
+   CREATE  ROLE  ecodd;
+   GRANT  LOGIN  TO  ecodd;
+   GRANT  PASSWORD  'ecodds_secret_password'  TO ecodd;
+   GRANT  CONNECT  ON  DATABASE  my_database  TO  ecodd;
+   GRANT my_schema_database_designers TO ecodd;
+
+   CREATE  ROLE  ebachmann;
+   GRANT  LOGIN  TO  ebachmann;
+   GRANT  PASSWORD  'another_secret_password'  TO ebachmann;
+   GRANT  CONNECT  ON  DATABASE  my_database  TO  ebachmann;
+   GRANT my_database_designers TO ebachmann;
+
+   -- If a user already exists, we can assign that user directly to the group
+   
+   GRANT my_schema_updaters TO rhendricks;
+   
+   -- Create users in the readers group
+   
+   CREATE  ROLE  jbarker;
+   GRANT  LOGIN  TO  jbarker;
+   GRANT  PASSWORD  'action_jack'  TO jbarker;
+   GRANT  CONNECT  ON  DATABASE  my_database  TO  jbarker;
+   GRANT my_schema_readers TO jbarker;
+   
+   CREATE  ROLE  lbream;
+   GRANT  LOGIN  TO  lbream;
+   GRANT  PASSWORD  'artichoke123'  TO lbream;
+   GRANT  CONNECT  ON  DATABASE  my_database  TO  lbream;
+   GRANT my_schema_readers TO lbream;
+   
+   CREATE  ROLE  pgregory;
+   GRANT  LOGIN  TO  pgregory;
+   GRANT  PASSWORD  'c1ca6a'  TO pgregory;
+   GRANT  CONNECT  ON  DATABASE  my_database  TO  pgregory;
+   GRANT my_schema_readers TO pgregory;
+
+   -- Create users in the security officers group
+
+   CREATE  ROLE  hoover;
+   GRANT  LOGIN  TO  hoover;
+   GRANT  PASSWORD  'mintchip'  TO hoover;
+   GRANT  CONNECT  ON  DATABASE  my_database  TO  hoover;
+   GRANT my_schema_security_officers TO hoover;
+
+
+.. todo:
+   create some example users
+   show that they have the right permission
+   try out the with admin option. we can't really do a security officer because
+   only superusers can create users and logins. see what can be done
+   need 1-2 users in each group, for at least 2 schemas/departments
+   this example will be very big just to show what this setup can do ...
+   example: a security officer for a department which will only have
+     read only access to a schema can only get that with admin option
+     access granted to them
+
+After this setup:
+
+* Database designers will be able to run any ddl on objects in the schema and create new objects, including ones created by other database designers
+* Updaters will be able to insert and delete to existing and new tables
+* Readers will be able to read from existing and new tables
+
+All this will happen without having to run any more ``GRANT`` statements.
+
+Any security officer will be able to add and remove users from these
+groups. Creating and dropping login users themselves must be done by a
+superuser.
\ No newline at end of file
diff --git a/operational_guides/access_control_managing_roles.rst b/operational_guides/access_control_managing_roles.rst
new file mode 100644
index 000000000..373b9a212
--- /dev/null
+++ b/operational_guides/access_control_managing_roles.rst
@@ -0,0 +1,124 @@
+.. _access_control_managing_roles:
+
+**************
+Managing Roles
+**************
+Roles are used for both users and groups, and are global across all databases in the SQream cluster. For a ``ROLE`` to be used as a user, it requires a password and log-in and connect permissionss to the relevant databases.
+
+The Managing Roles section describes the following role-related operations:
+
+.. contents:: 
+   :local:
+   :depth: 1
+
+Creating New Roles (Users)
+------------------------------
+A user role logging in to the database requires ``LOGIN`` permissions and as a password.
+
+The following is the syntax for creating a new role:
+
+.. code-block:: postgres
+                
+   CREATE ROLE  ;
+   GRANT LOGIN to  ;
+   GRANT PASSWORD <'new_password'> to  ;
+   GRANT CONNECT ON DATABASE  to  ;
+
+The following is an example of creating a new role:
+
+.. code-block:: postgres
+
+   CREATE  ROLE  new_role_name  ;  
+   GRANT  LOGIN  TO  new_role_name;  
+   GRANT  PASSWORD  'my_password' to new_role_name;  
+   GRANT  CONNECT  ON  DATABASE  master to new_role_name;
+
+A database role may have a number of permissions that define what tasks it can perform, which are  assigned using the :ref:`grant` command.
+
+Dropping a User
+------------------------------
+The following is the syntax for dropping a user:
+
+.. code-block:: postgres
+
+   DROP ROLE  ;
+
+The following is an example of dropping a user:
+
+.. code-block:: postgres
+
+   DROP ROLE  admin_role ;
+
+Altering a User Name
+------------------------------
+The following is the syntax for altering a user name:
+
+.. code-block:: postgres
+
+   ALTER ROLE  RENAME TO  ;
+
+The following is an example of altering a user name:
+
+.. code-block:: postgres
+
+   ALTER ROLE admin_role RENAME TO copy_role ;
+
+Changing a User Password
+------------------------------
+You can change a user role's password by granting the user a new password.
+
+The following is an example of changing a user password:
+
+.. code-block:: postgres
+
+   GRANT  PASSWORD  <'new_password'>  TO  rhendricks;  
+
+.. note:: Granting a new password overrides any previous password. Changing the password while the role has an active running statement does not affect that statement, but will affect subsequent statements.
+
+Altering Public Role Permissions
+------------------------------
+
+There is a public role which always exists. Each role is granted to the ``PUBLIC`` role (i.e. is a member of the public group), and this cannot be revoked. You can alter the permissions granted to the public role.
+
+The ``PUBLIC`` role has ``USAGE`` and ``CREATE`` permissions on ``PUBLIC`` schema by default, therefore, new users can create, :ref:`insert`, :ref:`delete`, and :ref:`select` from objects in the ``PUBLIC`` schema.
+
+
+Altering Role Membership (Groups)
+------------------------------
+
+Many database administrators find it useful to group user roles together. By grouping users, permissions can be granted to, or revoked from a group with one command. In SQream DB, this is done by creating a group role, granting permissions to it, and then assigning users to that group role.
+
+To use a role purely as a group, omit granting it ``LOGIN`` and ``PASSWORD`` permissions.
+
+The ``CONNECT`` permission can be given directly to user roles, and/or to the groups they are part of.
+
+.. code-block:: postgres
+
+   CREATE ROLE my_group;
+
+Once the group role exists, you can add user roles (members) using the ``GRANT`` command. For example:
+
+.. code-block:: postgres
+
+   -- Add my_user to this group
+   GRANT my_group TO my_user;
+
+
+To manage object permissions like databases and tables, you would then grant permissions to the group-level role (see :ref:`the permissions table` below.
+
+All member roles then inherit the permissions from the group. For example:
+
+.. code-block:: postgres
+
+   -- Grant all group users connect permissions
+   GRANT  CONNECT  ON  DATABASE  a_database  TO  my_group;
+   
+   -- Grant all permissions on tables in public schema
+   GRANT  ALL  ON  all  tables  IN  schema  public  TO  my_group;
+
+Removing users and permissions can be done with the ``REVOKE`` command:
+
+.. code-block:: postgres
+
+   -- remove my_other_user from this group
+   REVOKE my_group FROM my_other_user;
\ No newline at end of file
diff --git a/operational_guides/access_control_overview.rst b/operational_guides/access_control_overview.rst
new file mode 100644
index 000000000..080797fec
--- /dev/null
+++ b/operational_guides/access_control_overview.rst
@@ -0,0 +1,20 @@
+.. _access_control_overview:
+
+**************
+Overview
+**************
+Access control refers to SQream's authentication and authorization operations, managed using a **Role-Based Access Control (RBAC)** system, such as ANSI SQL or other SQL products. SQream's default permissions system is similar to Postgres, but is more powerful. SQream's method lets administrators prepare the system to automatically provide objects with their required permissions.
+
+SQream users can log in from any worker, which verify their roles and permissions from the metadata server. Each statement issues commands as the role that you're currently logged into. Roles are defined at the cluster level, and are valid for all databases in the cluster. To bootstrap SQream, new installations require one ``SUPERUSER`` role, typically named ``sqream``. You can only create new roles by connecting as this role.
+
+Access control refers to the following basic concepts:
+
+ * **Role** - A role can be a user, a group, or both. Roles can own database objects (such as tables) and can assign permissions on those objects to other roles. Roles can be members of other roles, meaning a user role can inherit permissions from its parent role.
+
+    ::
+   
+ * **Authentication** - Verifies the identity of the role. User roles have usernames (or **role names**) and passwords.
+
+    ::
+ 
+ * **Authorization** - Checks that a role has permissions to perform a particular operation, such as the :ref:`grant` command.
\ No newline at end of file
diff --git a/operational_guides/access_control_password_policy.rst b/operational_guides/access_control_password_policy.rst
new file mode 100644
index 000000000..10a4f697f
--- /dev/null
+++ b/operational_guides/access_control_password_policy.rst
@@ -0,0 +1,42 @@
+.. _access_control_password_policy:
+
+**************
+Password Policy
+**************
+As part of our compliance with GDPR standards SQream relies on a strong password policy when accessing the CLI or Studio, with the following requirements:
+
+* At least eight characters long.
+
+   ::
+
+* Mandatory upper and lowercase letters.
+
+   ::
+
+* At least one numeric character.
+
+   ::
+
+* May not include a username.
+
+   ::
+
+* Must include at least one special character, such as **?**, **!**, **$**, etc.
+
+You can create a password through the Studio graphic interface or through the CLI, as in the following example command:
+
+.. code-block:: console
+
+   CREATE ROLE user_a ;
+   GRANT LOGIN to user_a ;
+   GRANT PASSWORD 'BBAu47?fqPL' to user_a ;
+
+Creating a password that does not comply with the above requirements generates an error message with a request to modify it.
+
+Unsuccessfully attempting to log in three times displays the following message:
+
+.. code-block:: console
+
+   The user is locked. please contact your system administrator to reset the password and regain access functionality.
+
+For more information, see :ref:`login_max_retries`.
diff --git a/operational_guides/access_control_permissions.rst b/operational_guides/access_control_permissions.rst
new file mode 100644
index 000000000..5afc23009
--- /dev/null
+++ b/operational_guides/access_control_permissions.rst
@@ -0,0 +1,218 @@
+.. _access_control_permissions:
+
+**************
+Permissions
+**************
+
+The following table displays the access control permissions:
+
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+| **Permission**     | **Description**                                                                                                         |
++====================+=========================================================================================================================+
+| **Object/Layer: All Databases**                                                                                                              |
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+| ``LOGIN``          | use role to log into the system (the role also needs connect permission on the database it is connecting to)            |
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+| ``PASSWORD``       | the password used for logging into the system                                                                           |
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+| ``SUPERUSER``      | no permission restrictions on any activity                                                                              |
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+| **Object/Layer: Database**                                                                                                                   |
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+| ``SUPERUSER``      | no permission restrictions on any activity within that database (this does not include modifying roles or permissions)  |
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+| ``CONNECT``        | connect to the database                                                                                                 |
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+| ``CREATE``         | create schemas in the database                                                                                          |
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+| ``CREATE FUNCTION``| create and drop functions                                                                                               |
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+| **Object/Layer: Schema**                                                                                                                     |
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+| ``USAGE``          | allows additional permissions within the schema                                                                         |
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+| ``CREATE``         | create tables in the schema                                                                                             |
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+| **Object/Layer: Table**                                                                                                                      |
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+| ``SELECT``         | :ref:`select` from the table                                                                                            |
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+| ``INSERT``         | :ref:`insert` into the table                                                                                            |
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+| ``UPDATE``         | UPDATE the value of certain columns in existing rows without creating a table                                           |
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+| ``DELETE``         | :ref:`delete` and :ref:`truncate` on the table                                                                          |
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+| ``DDL``            | drop and alter on the table                                                                                             |
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+| ``ALL``            | all the table permissions                                                                                               |
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+| **Object/Layer: Function**                                                                                                                   |
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+| ``EXECUTE``        | use the function                                                                                                        |
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+| ``DDL``            | drop and alter on the function                                                                                          |   
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+| ``ALL``            | all function permissions                                                                                                |
++--------------------+-------------------------------------------------------------------------------------------------------------------------+
+
+
+
+
+GRANT
+-----
+
+:ref:`grant` gives permissions to a role.
+
+.. code-block:: postgres
+
+   -- Grant permissions at the instance/ storage cluster level:
+   GRANT 
+
+   { SUPERUSER
+   | LOGIN 
+   | PASSWORD '' 
+   } 
+   TO  [, ...] 
+
+   -- Grant permissions at the database level:
+        GRANT {{CREATE | CONNECT| DDL | SUPERUSER | CREATE FUNCTION} [, ...] | ALL [PERMISSIONS]}
+
+   ON DATABASE  [, ...]
+   TO  [, ...] 
+
+   -- Grant permissions at the schema level: 
+   GRANT {{ CREATE | DDL | USAGE | SUPERUSER } [, ...] | ALL [ 
+   PERMISSIONS ]} 
+   ON SCHEMA  [, ...] 
+   TO  [, ...] 
+       
+   -- Grant permissions at the object level: 
+   GRANT {{SELECT | INSERT | DELETE | DDL } [, ...] | ALL [PERMISSIONS]} 
+   ON { TABLE  [, ...] | ALL TABLES IN SCHEMA  [, ...]} 
+   TO  [, ...]
+       
+   -- Grant execute function permission: 
+   GRANT {ALL | EXECUTE | DDL} ON FUNCTION function_name 
+   TO role; 
+       
+   -- Allows role2 to use permissions granted to role1
+   GRANT  [, ...] 
+   TO  
+
+    -- Also allows the role2 to grant role1 to other roles:
+   GRANT  [, ...] 
+   TO  
+   WITH ADMIN OPTION
+  
+``GRANT`` examples:
+
+.. code-block:: postgres
+
+   GRANT  LOGIN,superuser  TO  admin;
+
+   GRANT  CREATE  FUNCTION  ON  database  master  TO  admin;
+
+   GRANT  SELECT  ON  TABLE  admin.table1  TO  userA;
+
+   GRANT  EXECUTE  ON  FUNCTION  my_function  TO  userA;
+
+   GRANT  ALL  ON  FUNCTION  my_function  TO  userA;
+
+   GRANT  DDL  ON  admin.main_table  TO  userB;
+
+   GRANT  ALL  ON  all  tables  IN  schema  public  TO  userB;
+
+   GRANT  admin  TO  userC;
+
+   GRANT  superuser  ON  schema  demo  TO  userA
+
+   GRANT  admin_role  TO  userB;
+
+REVOKE
+------
+
+:ref:`revoke` removes permissions from a role.
+
+.. code-block:: postgres
+
+   -- Revoke permissions at the instance/ storage cluster level:
+   REVOKE
+   { SUPERUSER
+   | LOGIN
+   | PASSWORD
+   }
+   FROM  [, ...]
+            
+   -- Revoke permissions at the database level:
+   REVOKE {{CREATE | CONNECT | DDL | SUPERUSER | CREATE FUNCTION}[, ...] |ALL [PERMISSIONS]}
+   ON DATABASE  [, ...]
+   FROM  [, ...]
+
+   -- Revoke permissions at the schema level:
+   REVOKE { { CREATE | DDL | USAGE | SUPERUSER } [, ...] | ALL [PERMISSIONS]}
+   ON SCHEMA  [, ...]
+   FROM  [, ...]
+            
+   -- Revoke permissions at the object level:
+   REVOKE { { SELECT | INSERT | DELETE | DDL } [, ...] | ALL }
+   ON { [ TABLE ]  [, ...] | ALL TABLES IN SCHEMA
+
+          [, ...] }
+   FROM  [, ...]
+            
+   -- Removes access to permissions in role1 by role 2
+   REVOKE  [, ...] FROM  [, ...] WITH ADMIN OPTION
+
+   -- Removes permissions to grant role1 to additional roles from role2
+   REVOKE  [, ...] FROM  [, ...] WITH ADMIN OPTION
+
+
+Examples:
+
+.. code-block:: postgres
+
+   REVOKE  superuser  on  schema  demo  from  userA;
+
+   REVOKE  delete  on  admin.table1  from  userB;
+
+   REVOKE  login  from  role_test;
+
+   REVOKE  CREATE  FUNCTION  FROM  admin;
+
+Default permissions
+-------------------
+
+The default permissions system (See :ref:`alter_default_permissions`) 
+can be used to automatically grant permissions to newly 
+created objects (See the departmental example below for one way it can be used).
+
+A default permissions rule looks for a schema being created, or a
+table (possibly by schema), and is table to grant any permission to
+that object to any role. This happens when the create table or create
+schema statement is run.
+
+
+.. code-block:: postgres
+
+
+   ALTER DEFAULT PERMISSIONS FOR target_role_name
+        [IN schema_name, ...]
+        FOR { TABLES | SCHEMAS }
+        { grant_clause | DROP grant_clause}
+        TO ROLE { role_name | public };
+
+   grant_clause ::=
+     GRANT
+        { CREATE FUNCTION
+        | SUPERUSER
+        | CONNECT
+        | CREATE
+        | USAGE
+        | SELECT
+        | INSERT
+        | DELETE
+        | DDL
+        | EXECUTE
+        | ALL
+        }
\ No newline at end of file
diff --git a/releases/2022.1.1.rst b/releases/2022.1.1.rst
new file mode 100644
index 000000000..8e90524ef
--- /dev/null
+++ b/releases/2022.1.1.rst
@@ -0,0 +1,115 @@
+.. _2022.1.1:
+
+**************************
+Release Notes 2022.1.1
+**************************
+The 2022.1.1 patch release notes were released on 7/28/2022 and describe the following: 
+
+.. contents:: 
+   :local:
+   :depth: 1
+
+Version Content
+----------
+The **Version Content** section is not relevant to the 2022.1.1 patch release notes.
+
+New Features
+----------
+The 2022.1 Release Notes include the following new features:
+
+.. contents:: 
+   :local:
+   :depth: 1
+
+Automatically Identifying Schemas when Mapping Foreign Tables
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+SQream can now automatically identify the corresponding schema, avoiding complex error-prone DDL operations, saving you the time and effort required to build your schema manually. This is especially useful for particular file formats, such as Parquet, which include a built-in schema declaration. In addition, this feature improves user experience by letting you quickly load foreign tables without specifying hundred of columns. 
+
+For more information, see :ref:`automatic_schema_identification`.
+
+Password Policy
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+SQream has implemented a strong password policy required when accessing the CLI or Studio.
+
+For more information, see :ref:`access_control_password_policy`.
+   
+Resolved Issues
+---------
+The following table lists the issues that were resolved in the 2022.1.1 patch release:
+
++-------------+-----------------------------------------------------------------------------------------------------------------------+
+| **SQ No.**  | **Description**                                                                                                       |
++=============+=======================================================================================================================+
+| SQ-6419     | An internal compiler error occurred when casting a numeric literal in an aggregation function.                        |
++-------------+-----------------------------------------------------------------------------------------------------------------------+
+| SQ-10873    | Inserting 100K bytes into a ``TEXT`` column resulted in an unclear error message.                                     |
++-------------+-----------------------------------------------------------------------------------------------------------------------+
+| SQ-10886    | An internal compiler error occurred during the compilation process.                                                   |
++-------------+-----------------------------------------------------------------------------------------------------------------------+
+| SQ-10892    | The error message displayed when ``UPDATE`` is run on a foreign table was corrected.                                  |
++-------------+-----------------------------------------------------------------------------------------------------------------------+
+| SQ-10955    | Unneeded reads occured when filtering by date.                                                                        |
++-------------+-----------------------------------------------------------------------------------------------------------------------+
+
+Known Issues
+---------
+The **Known Issues** section is not relevant to Version 2022.1.1.
+
+Operations and Configuration Changes
+--------
+The **Operations and Configuration Changes** section is not relevant to the 2022.1.1 patch release notes.
+
+Naming Changes
+-------
+The **Naming Changes** section is not relevant to the 2022.1.1 patch release notes.
+
+Deprecated Features
+-------
+The **Deprecated Features** section is not relevant to the 2022.1.1 patch release.
+
+End of Support
+-------
+The **End of Support** section is not relevant to the 2022.1.1 patch release.
+
+Upgrading to v2022.1.1
+-------
+1. Generate a back-up of the metadata by running the following command:
+
+   .. code-block:: console
+
+      $ select backup_metadata('out_path');
+	  
+   .. tip:: SQream recommends storing the generated back-up locally in case needed.
+   
+   SQream runs the Garbage Collector and creates a clean backup tarball package.
+   
+2. Shut down all SQream services.
+
+    ::
+
+3. Extract the recently created back-up file.
+
+    ::
+
+4. Replace your current metadata with the metadata you stored in the back-up file.
+
+    ::
+
+5. Navigate to the new SQream package bin folder.
+
+    ::
+
+6. Run the following command:
+
+   .. code-block:: console
+
+      $ ./upgrade_storage 
+
+  .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in **Step 7** of the Upgrading SQream Version procedure.
+  
+.. toctree::
+   :maxdepth: 2
+   :glob:
+   :hidden:
+
+   2022.1.1
\ No newline at end of file
diff --git a/releases/2022.1_index.rst b/releases/2022.1_index.rst
new file mode 100644
index 000000000..628b372aa
--- /dev/null
+++ b/releases/2022.1_index.rst
@@ -0,0 +1,17 @@
+.. _2022.1_index:
+
+**************************
+Release Notes 2022.1
+**************************
+The 2022.1 Release Notes describe the following releases:
+
+.. contents:: 
+   :local:
+   :depth: 1
+
+.. toctree::
+   :maxdepth: 1
+   :glob:
+
+   2022.1.1
+   2022.1
\ No newline at end of file

From 16eab5d2b00fbdb1ffe8b66329bca9efaa64650b Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 14:18:06 +0300
Subject: [PATCH 162/882] Added 2022.1_index to main RN index

---
 releases/index.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/releases/index.rst b/releases/index.rst
index b1d065a9e..84024586e 100644
--- a/releases/index.rst
+++ b/releases/index.rst
@@ -32,7 +32,7 @@ Release Notes
    :glob:
    :hidden:
 
-   2022.1
+   2022.1_index
    2021.2_index
    2021.1_index
    2020.3_index

From 7d1d837fe0616a5dbc24cbb4c9eb12e3853a45b6 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 14:24:05 +0300
Subject: [PATCH 163/882] Added Auto Schema Identification

---
 .../automatic_schema_identification.rst       | 46 +++++++++++++++++++
 feature_guides/index.rst                      |  1 +
 2 files changed, 47 insertions(+)
 create mode 100644 feature_guides/automatic_schema_identification.rst

diff --git a/feature_guides/automatic_schema_identification.rst b/feature_guides/automatic_schema_identification.rst
new file mode 100644
index 000000000..e2089143e
--- /dev/null
+++ b/feature_guides/automatic_schema_identification.rst
@@ -0,0 +1,46 @@
+.. _automatic_schema_identification:
+
+***********************
+Automatic Schema Identification
+***********************
+The **Automatic Schema Identification** page describes the following:
+
+.. contents:: 
+   :local:
+   :depth: 1      
+   
+Overview
+----------
+SQream must be able to access a schema when reading and mapping external files to a foreign table. To facilitate this, you must specify the correct schema in the statement that creates the foreign table, which must also include the correct list of columns. To avoid human error related to this complex process SQream can now automatically identify the corresponding schema, saving you the time and effort required to build your schema manually. This is especially useful for particular file formats, such as Parquet, which include a built-in schema declaration.
+
+Usage Notes
+----------
+The automatic schema identification feature supports Parquet, ORC, and Avro files, while using it with CSV files generates an error. You can activate this feature when you create a foreign table by omitting the column list, described in the **Syntax** section below.
+
+Using this feature the path you specify in the ``LOCATION`` option must point to at least one existing file. If no files exist for the schema to read, an error will be generated. You can specify the schema manually even in the event of the error above.
+
+.. note:: When using this feature, SQream assumes that all files in the path use the same schema.
+
+Syntax
+----------
+The following is the syntax for using the automatic schema identification feature:
+
+.. code-block:: console
+   
+   CREATE FOREIGN TABLE table_name
+   [FOREIGN DATA] WRAPPER fdw_name
+   [OPTIONS (...)];
+
+Example
+----------
+The following is an example of using the automatic schema identification feature:
+
+.. code-block:: console
+
+   create foreign table parquet_table
+   wrapper parquet_fdw
+   options (location = '/tmp/file.parquet');
+   
+Permissions
+----------
+The Automatic Schema Identification feature requires **Read** permissions.
\ No newline at end of file
diff --git a/feature_guides/index.rst b/feature_guides/index.rst
index d70ceb705..d1a0c7fc3 100644
--- a/feature_guides/index.rst
+++ b/feature_guides/index.rst
@@ -12,6 +12,7 @@ This section describes the following features:
    :titlesonly:  
 
    query_healer
+   automatic_schema_identification
    data_encryption
    compression
    python_functions

From aa11873d48cbaecb9eeaa41e4a39a14d089f3bff Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 15:23:25 +0300
Subject: [PATCH 164/882] Updated

---
 .../automatic_schema_identification.rst       | 46 -------------------
 feature_guides/index.rst                      |  1 -
 releases/2022.1.1.rst                         |  6 ---
 3 files changed, 53 deletions(-)
 delete mode 100644 feature_guides/automatic_schema_identification.rst

diff --git a/feature_guides/automatic_schema_identification.rst b/feature_guides/automatic_schema_identification.rst
deleted file mode 100644
index e2089143e..000000000
--- a/feature_guides/automatic_schema_identification.rst
+++ /dev/null
@@ -1,46 +0,0 @@
-.. _automatic_schema_identification:
-
-***********************
-Automatic Schema Identification
-***********************
-The **Automatic Schema Identification** page describes the following:
-
-.. contents:: 
-   :local:
-   :depth: 1      
-   
-Overview
-----------
-SQream must be able to access a schema when reading and mapping external files to a foreign table. To facilitate this, you must specify the correct schema in the statement that creates the foreign table, which must also include the correct list of columns. To avoid human error related to this complex process SQream can now automatically identify the corresponding schema, saving you the time and effort required to build your schema manually. This is especially useful for particular file formats, such as Parquet, which include a built-in schema declaration.
-
-Usage Notes
-----------
-The automatic schema identification feature supports Parquet, ORC, and Avro files, while using it with CSV files generates an error. You can activate this feature when you create a foreign table by omitting the column list, described in the **Syntax** section below.
-
-Using this feature the path you specify in the ``LOCATION`` option must point to at least one existing file. If no files exist for the schema to read, an error will be generated. You can specify the schema manually even in the event of the error above.
-
-.. note:: When using this feature, SQream assumes that all files in the path use the same schema.
-
-Syntax
-----------
-The following is the syntax for using the automatic schema identification feature:
-
-.. code-block:: console
-   
-   CREATE FOREIGN TABLE table_name
-   [FOREIGN DATA] WRAPPER fdw_name
-   [OPTIONS (...)];
-
-Example
-----------
-The following is an example of using the automatic schema identification feature:
-
-.. code-block:: console
-
-   create foreign table parquet_table
-   wrapper parquet_fdw
-   options (location = '/tmp/file.parquet');
-   
-Permissions
-----------
-The Automatic Schema Identification feature requires **Read** permissions.
\ No newline at end of file
diff --git a/feature_guides/index.rst b/feature_guides/index.rst
index d1a0c7fc3..d70ceb705 100644
--- a/feature_guides/index.rst
+++ b/feature_guides/index.rst
@@ -12,7 +12,6 @@ This section describes the following features:
    :titlesonly:  
 
    query_healer
-   automatic_schema_identification
    data_encryption
    compression
    python_functions
diff --git a/releases/2022.1.1.rst b/releases/2022.1.1.rst
index 8e90524ef..08843f380 100644
--- a/releases/2022.1.1.rst
+++ b/releases/2022.1.1.rst
@@ -21,12 +21,6 @@ The 2022.1 Release Notes include the following new features:
    :local:
    :depth: 1
 
-Automatically Identifying Schemas when Mapping Foreign Tables
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-SQream can now automatically identify the corresponding schema, avoiding complex error-prone DDL operations, saving you the time and effort required to build your schema manually. This is especially useful for particular file formats, such as Parquet, which include a built-in schema declaration. In addition, this feature improves user experience by letting you quickly load foreign tables without specifying hundred of columns. 
-
-For more information, see :ref:`automatic_schema_identification`.
-
 Password Policy
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 SQream has implemented a strong password policy required when accessing the CLI or Studio.

From 4b0631f94889c9c1ef7c30c274ebacb372b8d131 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 15:34:57 +0300
Subject: [PATCH 165/882] REverted

---
 releases/2022.1.1.rst     | 109 --------------------------------------
 releases/2022.1_index.rst |   1 -
 releases/index.rst        |   2 +-
 3 files changed, 1 insertion(+), 111 deletions(-)
 delete mode 100644 releases/2022.1.1.rst

diff --git a/releases/2022.1.1.rst b/releases/2022.1.1.rst
deleted file mode 100644
index 08843f380..000000000
--- a/releases/2022.1.1.rst
+++ /dev/null
@@ -1,109 +0,0 @@
-.. _2022.1.1:
-
-**************************
-Release Notes 2022.1.1
-**************************
-The 2022.1.1 patch release notes were released on 7/28/2022 and describe the following: 
-
-.. contents:: 
-   :local:
-   :depth: 1
-
-Version Content
-----------
-The **Version Content** section is not relevant to the 2022.1.1 patch release notes.
-
-New Features
-----------
-The 2022.1 Release Notes include the following new features:
-
-.. contents:: 
-   :local:
-   :depth: 1
-
-Password Policy
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-SQream has implemented a strong password policy required when accessing the CLI or Studio.
-
-For more information, see :ref:`access_control_password_policy`.
-   
-Resolved Issues
----------
-The following table lists the issues that were resolved in the 2022.1.1 patch release:
-
-+-------------+-----------------------------------------------------------------------------------------------------------------------+
-| **SQ No.**  | **Description**                                                                                                       |
-+=============+=======================================================================================================================+
-| SQ-6419     | An internal compiler error occurred when casting a numeric literal in an aggregation function.                        |
-+-------------+-----------------------------------------------------------------------------------------------------------------------+
-| SQ-10873    | Inserting 100K bytes into a ``TEXT`` column resulted in an unclear error message.                                     |
-+-------------+-----------------------------------------------------------------------------------------------------------------------+
-| SQ-10886    | An internal compiler error occurred during the compilation process.                                                   |
-+-------------+-----------------------------------------------------------------------------------------------------------------------+
-| SQ-10892    | The error message displayed when ``UPDATE`` is run on a foreign table was corrected.                                  |
-+-------------+-----------------------------------------------------------------------------------------------------------------------+
-| SQ-10955    | Unneeded reads occured when filtering by date.                                                                        |
-+-------------+-----------------------------------------------------------------------------------------------------------------------+
-
-Known Issues
----------
-The **Known Issues** section is not relevant to Version 2022.1.1.
-
-Operations and Configuration Changes
---------
-The **Operations and Configuration Changes** section is not relevant to the 2022.1.1 patch release notes.
-
-Naming Changes
--------
-The **Naming Changes** section is not relevant to the 2022.1.1 patch release notes.
-
-Deprecated Features
--------
-The **Deprecated Features** section is not relevant to the 2022.1.1 patch release.
-
-End of Support
--------
-The **End of Support** section is not relevant to the 2022.1.1 patch release.
-
-Upgrading to v2022.1.1
--------
-1. Generate a back-up of the metadata by running the following command:
-
-   .. code-block:: console
-
-      $ select backup_metadata('out_path');
-	  
-   .. tip:: SQream recommends storing the generated back-up locally in case needed.
-   
-   SQream runs the Garbage Collector and creates a clean backup tarball package.
-   
-2. Shut down all SQream services.
-
-    ::
-
-3. Extract the recently created back-up file.
-
-    ::
-
-4. Replace your current metadata with the metadata you stored in the back-up file.
-
-    ::
-
-5. Navigate to the new SQream package bin folder.
-
-    ::
-
-6. Run the following command:
-
-   .. code-block:: console
-
-      $ ./upgrade_storage 
-
-  .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in **Step 7** of the Upgrading SQream Version procedure.
-  
-.. toctree::
-   :maxdepth: 2
-   :glob:
-   :hidden:
-
-   2022.1.1
\ No newline at end of file
diff --git a/releases/2022.1_index.rst b/releases/2022.1_index.rst
index 628b372aa..9c7b2b211 100644
--- a/releases/2022.1_index.rst
+++ b/releases/2022.1_index.rst
@@ -13,5 +13,4 @@ The 2022.1 Release Notes describe the following releases:
    :maxdepth: 1
    :glob:
 
-   2022.1.1
    2022.1
\ No newline at end of file
diff --git a/releases/index.rst b/releases/index.rst
index 84024586e..b1d065a9e 100644
--- a/releases/index.rst
+++ b/releases/index.rst
@@ -32,7 +32,7 @@ Release Notes
    :glob:
    :hidden:
 
-   2022.1_index
+   2022.1
    2021.2_index
    2021.1_index
    2020.3_index

From ab5f5c6a3f3bf913e9f19cce2a6c6387e403e2d1 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 15:58:22 +0300
Subject: [PATCH 166/882] Updated

---
 releases/2022.1_index.rst | 1 +
 releases/index.rst        | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/releases/2022.1_index.rst b/releases/2022.1_index.rst
index 9c7b2b211..628b372aa 100644
--- a/releases/2022.1_index.rst
+++ b/releases/2022.1_index.rst
@@ -13,4 +13,5 @@ The 2022.1 Release Notes describe the following releases:
    :maxdepth: 1
    :glob:
 
+   2022.1.1
    2022.1
\ No newline at end of file
diff --git a/releases/index.rst b/releases/index.rst
index b1d065a9e..84024586e 100644
--- a/releases/index.rst
+++ b/releases/index.rst
@@ -32,7 +32,7 @@ Release Notes
    :glob:
    :hidden:
 
-   2022.1
+   2022.1_index
    2021.2_index
    2021.1_index
    2020.3_index

From 98028f90d4a7d65a6df75d0a0bbcf3633c17df57 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 16:09:45 +0300
Subject: [PATCH 167/882] Create 2022.1.1.rst

---
 releases/2022.1.1.rst | 109 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 109 insertions(+)
 create mode 100644 releases/2022.1.1.rst

diff --git a/releases/2022.1.1.rst b/releases/2022.1.1.rst
new file mode 100644
index 000000000..08843f380
--- /dev/null
+++ b/releases/2022.1.1.rst
@@ -0,0 +1,109 @@
+.. _2022.1.1:
+
+**************************
+Release Notes 2022.1.1
+**************************
+The 2022.1.1 patch release notes were released on 7/28/2022 and describe the following: 
+
+.. contents:: 
+   :local:
+   :depth: 1
+
+Version Content
+----------
+The **Version Content** section is not relevant to the 2022.1.1 patch release notes.
+
+New Features
+----------
+The 2022.1 Release Notes include the following new features:
+
+.. contents:: 
+   :local:
+   :depth: 1
+
+Password Policy
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+SQream has implemented a strong password policy required when accessing the CLI or Studio.
+
+For more information, see :ref:`access_control_password_policy`.
+   
+Resolved Issues
+---------
+The following table lists the issues that were resolved in the 2022.1.1 patch release:
+
++-------------+-----------------------------------------------------------------------------------------------------------------------+
+| **SQ No.**  | **Description**                                                                                                       |
++=============+=======================================================================================================================+
+| SQ-6419     | An internal compiler error occurred when casting a numeric literal in an aggregation function.                        |
++-------------+-----------------------------------------------------------------------------------------------------------------------+
+| SQ-10873    | Inserting 100K bytes into a ``TEXT`` column resulted in an unclear error message.                                     |
++-------------+-----------------------------------------------------------------------------------------------------------------------+
+| SQ-10886    | An internal compiler error occurred during the compilation process.                                                   |
++-------------+-----------------------------------------------------------------------------------------------------------------------+
+| SQ-10892    | The error message displayed when ``UPDATE`` is run on a foreign table was corrected.                                  |
++-------------+-----------------------------------------------------------------------------------------------------------------------+
+| SQ-10955    | Unneeded reads occured when filtering by date.                                                                        |
++-------------+-----------------------------------------------------------------------------------------------------------------------+
+
+Known Issues
+---------
+The **Known Issues** section is not relevant to Version 2022.1.1.
+
+Operations and Configuration Changes
+--------
+The **Operations and Configuration Changes** section is not relevant to the 2022.1.1 patch release notes.
+
+Naming Changes
+-------
+The **Naming Changes** section is not relevant to the 2022.1.1 patch release notes.
+
+Deprecated Features
+-------
+The **Deprecated Features** section is not relevant to the 2022.1.1 patch release.
+
+End of Support
+-------
+The **End of Support** section is not relevant to the 2022.1.1 patch release.
+
+Upgrading to v2022.1.1
+-------
+1. Generate a back-up of the metadata by running the following command:
+
+   .. code-block:: console
+
+      $ select backup_metadata('out_path');
+	  
+   .. tip:: SQream recommends storing the generated back-up locally in case needed.
+   
+   SQream runs the Garbage Collector and creates a clean backup tarball package.
+   
+2. Shut down all SQream services.
+
+    ::
+
+3. Extract the recently created back-up file.
+
+    ::
+
+4. Replace your current metadata with the metadata you stored in the back-up file.
+
+    ::
+
+5. Navigate to the new SQream package bin folder.
+
+    ::
+
+6. Run the following command:
+
+   .. code-block:: console
+
+      $ ./upgrade_storage 
+
+  .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in **Step 7** of the Upgrading SQream Version procedure.
+  
+.. toctree::
+   :maxdepth: 2
+   :glob:
+   :hidden:
+
+   2022.1.1
\ No newline at end of file

From 41d91c9eb25c7627eae74b8c26abbbbc95e61970 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 18:18:51 +0300
Subject: [PATCH 168/882] Updated

---
 releases/2022.1.rst       | 137 --------------------------------------
 releases/2022.1_index.rst |   1 -
 releases/index.rst        |   2 +-
 3 files changed, 1 insertion(+), 139 deletions(-)
 delete mode 100644 releases/2022.1.rst

diff --git a/releases/2022.1.rst b/releases/2022.1.rst
deleted file mode 100644
index 3c5ae24e6..000000000
--- a/releases/2022.1.rst
+++ /dev/null
@@ -1,137 +0,0 @@
-.. _2022.1:
-
-**************************
-Release Notes 2022.1
-**************************
-The 2022.1 release notes were released on 7/19/2022 and describe the following:
-
-.. contents:: 
-   :local:
-   :depth: 1      
-
-Version Content
-----------
-The 2022.1 Release Notes describes the following:
-
-* Enhanced security features.
-* New data manipulation command.
-* Additional data ingestion format.
-
-New Features
-----------
-The 2022.1 Release Notes include the following new features:
-
-.. contents:: 
-   :local:
-   :depth: 1
-   
-Data Encryption
-************
-SQream now supports data encryption mechanisms in accordance with **General Data Protection Regulation (GDPR)** standards.
-
-Using the data encryption feature may lead to a maximum of a 10% increase in performance degradation.
-
-For more information, see `Data Encryption `_.
-
-Update Feature
-************
-SQream now supports the DML **Update** feature, which is used for modifying the value of certain columns in existing rows.
-
-For more information, see `UPDATE `_.
-
-Avro Ingestion
-************
-SQream now supports ingesting data from Avro files.
-
-For more information, see `Inserting Data from Avro `_.
-
-Known Issues
----------
-The following table lists the known issues for Version 2022.1:
-
-+-------------+-------------------------------------------------------------------------------------------+
-| **SQ No.**  | **Description**                                                                           |
-+=============+===========================================================================================+
-| SQ-7732     | Reading numeric columns from an external Parquet file generated an error.                 |
-+-------------+-------------------------------------------------------------------------------------------+
-| SQ-9889     | Running a query including Thai characters generated an internal runtime error.            |
-+-------------+-------------------------------------------------------------------------------------------+
-| SQ-10071    | Error on existing subqueries with TEXT and VARCHAR equality condition                     |
-+-------------+-------------------------------------------------------------------------------------------+
-| SQ-10191    | The ``ALTER DEFAULT SCHEMA`` command was not functioning correctly.                       |
-+-------------+-------------------------------------------------------------------------------------------+
-| SQ-10629    | Inserting data into a table significantly slowed down running queries.                    |
-+-------------+-------------------------------------------------------------------------------------------+
-| SQ-10659    | Using a comment generated a compile error.                                                |
-+-------------+-------------------------------------------------------------------------------------------+
-
-Resolved Issues
----------
-The following table lists the issues that were resolved in Version 2022.1:
-
-+-------------+-------------------------------------------------------------------------------------------+
-| **SQ No.**  | **Description**                                                                           |
-+=============+===========================================================================================+
-| SQ-10111    | Reading numeric columns from an external Parquet file generated an error.                 |
-+-------------+-------------------------------------------------------------------------------------------+
-
-Operations and Configuration Changes
---------
-No relevant operations and configuration changes were made.
-
-Naming Changes
--------
-No relevant naming changes were made.
-
-Deprecated Features
--------
-In SQream version 2022.1 the ``VARCHAR`` data type has been deprecated and replaced with ``TEXT``. SQream will maintain ``VARCHAR`` in all previous versions until completing the migration to ``TEXT``, at which point it will be deprecated in all earlier versions. SQream also provides an automated and secure tool to facilitate and simplify migration from ``VARCHAR`` to ``TEXT``.  
-
-If you are using an earlier version of SQream, see the `Using Legacy String Literals `_ configuration flag.
-
-End of Support
--------
-The End of Support section is not relevant to Version 2022.1.
-
-Upgrading to v2022.1
--------
-1. Generate a back-up of the metadata by running the following command:
-
-   .. code-block:: console
-
-      $ select backup_metadata('out_path');
-	  
-   .. tip:: SQream recommends storing the generated back-up locally in case needed.
-   
-   SQream runs the Garbage Collector and creates a clean backup tarball package.
-   
-2. Shut down all SQream services.
-
-    ::
-
-3. Extract the recently created back-up file.
-
-    ::
-
-4. Replace your current metadata with the metadata you stored in the back-up file.
-
-    ::
-
-5. Navigate to the new SQream package bin folder.
-
-    ::
-
-6. Run the following command:
-
-   .. code-block:: console
-
-      $ ./upgrade_storage 
-
-  .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version `_ procedure.
-  
-.. toctree::
-   :maxdepth: 2
-   :glob:
-   :hidden:
-
-   2022.1
diff --git a/releases/2022.1_index.rst b/releases/2022.1_index.rst
index 628b372aa..9c7b2b211 100644
--- a/releases/2022.1_index.rst
+++ b/releases/2022.1_index.rst
@@ -13,5 +13,4 @@ The 2022.1 Release Notes describe the following releases:
    :maxdepth: 1
    :glob:
 
-   2022.1.1
    2022.1
\ No newline at end of file
diff --git a/releases/index.rst b/releases/index.rst
index 84024586e..b1d065a9e 100644
--- a/releases/index.rst
+++ b/releases/index.rst
@@ -32,7 +32,7 @@ Release Notes
    :glob:
    :hidden:
 
-   2022.1_index
+   2022.1
    2021.2_index
    2021.1_index
    2020.3_index

From e30d16380d31cc4ae9184406691e9d43881b3143 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 18:30:29 +0300
Subject: [PATCH 169/882] Update index.rst

---
 releases/index.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/releases/index.rst b/releases/index.rst
index b1d065a9e..84024586e 100644
--- a/releases/index.rst
+++ b/releases/index.rst
@@ -32,7 +32,7 @@ Release Notes
    :glob:
    :hidden:
 
-   2022.1
+   2022.1_index
    2021.2_index
    2021.1_index
    2020.3_index

From 0ba6ce89dd90cee3feedab870658b8a89dae46d4 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 18:32:24 +0300
Subject: [PATCH 170/882] Update index.rst

---
 releases/index.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/releases/index.rst b/releases/index.rst
index 84024586e..b1d065a9e 100644
--- a/releases/index.rst
+++ b/releases/index.rst
@@ -32,7 +32,7 @@ Release Notes
    :glob:
    :hidden:
 
-   2022.1_index
+   2022.1
    2021.2_index
    2021.1_index
    2020.3_index

From 534c19e397a4ee85e1b50b6d7e3da3e4b9355a33 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 18:33:06 +0300
Subject: [PATCH 171/882] Update index.rst

---
 releases/index.rst | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/releases/index.rst b/releases/index.rst
index b1d065a9e..b3cfb3900 100644
--- a/releases/index.rst
+++ b/releases/index.rst
@@ -12,8 +12,6 @@ Release Notes
    
    * - Version
      - Release Date
-   * - :ref:`2022.1`
-     - July 19, 2022
    * - :ref:`2021.2`
      - September 13, 2021
    * - :ref:`2021.1`
@@ -32,7 +30,6 @@ Release Notes
    :glob:
    :hidden:
 
-   2022.1
    2021.2_index
    2021.1_index
    2020.3_index

From 3f84a22424552289d179fd5024d945d23f2617b3 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 18:36:17 +0300
Subject: [PATCH 172/882] Update index.rst

---
 releases/index.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/releases/index.rst b/releases/index.rst
index b3cfb3900..b1d065a9e 100644
--- a/releases/index.rst
+++ b/releases/index.rst
@@ -12,6 +12,8 @@ Release Notes
    
    * - Version
      - Release Date
+   * - :ref:`2022.1`
+     - July 19, 2022
    * - :ref:`2021.2`
      - September 13, 2021
    * - :ref:`2021.1`
@@ -30,6 +32,7 @@ Release Notes
    :glob:
    :hidden:
 
+   2022.1
    2021.2_index
    2021.1_index
    2020.3_index

From b649c40d4ea124d95ded76c3c151142c161e424a Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Thu, 28 Jul 2022 18:40:49 +0300
Subject: [PATCH 173/882] Create 2022.1.rst

---
 releases/2022.1.rst | 137 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 137 insertions(+)
 create mode 100644 releases/2022.1.rst

diff --git a/releases/2022.1.rst b/releases/2022.1.rst
new file mode 100644
index 000000000..cdd6d98c5
--- /dev/null
+++ b/releases/2022.1.rst
@@ -0,0 +1,137 @@
+.. _2022.1:
+
+**************************
+Release Notes 2022.1
+**************************
+The 2022.1 release notes were released on 7/19/2022 and describe the following:
+
+.. contents:: 
+   :local:
+   :depth: 1      
+
+Version Content
+----------
+The 2022.1 Release Notes describes the following:
+
+* Enhanced security features.
+* New data manipulation command.
+* Additional data ingestion format.
+
+New Features
+----------
+The 2022.1 Release Notes include the following new features:
+
+.. contents:: 
+   :local:
+   :depth: 1
+   
+Data Encryption
+************
+SQream now supports data encryption mechanisms in accordance with **General Data Protection Regulation (GDPR)** standards.
+
+Using the data encryption feature may lead to a maximum of a 10% increase in performance degradation.
+
+For more information, see `Data Encryption `_.
+
+Update Feature
+************
+SQream now supports the DML **Update** feature, which is used for modifying the value of certain columns in existing rows.
+
+For more information, see `UPDATE `_.
+
+Avro Ingestion
+************
+SQream now supports ingesting data from Avro files.
+
+For more information, see `Inserting Data from Avro `_.
+
+Known Issues
+---------
+The following table lists the known issues for Version 2022.1:
+
++-------------+-------------------------------------------------------------------------------------------+
+| **SQ No.**  | **Description**                                                                           |
++=============+===========================================================================================+
+| SQ-7732     | Reading numeric columns from an external Parquet file generated an error.                 |
++-------------+-------------------------------------------------------------------------------------------+
+| SQ-9889     | Running a query including Thai characters generated an internal runtime error.            |
++-------------+-------------------------------------------------------------------------------------------+
+| SQ-10071    | Error on existing subqueries with TEXT and VARCHAR equality condition                     |
++-------------+-------------------------------------------------------------------------------------------+
+| SQ-10191    | The ``ALTER DEFAULT SCHEMA`` command was not functioning correctly.                       |
++-------------+-------------------------------------------------------------------------------------------+
+| SQ-10629    | Inserting data into a table significantly slowed down running queries.                    |
++-------------+-------------------------------------------------------------------------------------------+
+| SQ-10659    | Using a comment generated a compile error.                                                |
++-------------+-------------------------------------------------------------------------------------------+
+
+Resolved Issues
+---------
+The following table lists the issues that were resolved in Version 2022.1:
+
++-------------+-------------------------------------------------------------------------------------------+
+| **SQ No.**  | **Description**                                                                           |
++=============+===========================================================================================+
+| SQ-10111    | Reading numeric columns from an external Parquet file generated an error.                 |
++-------------+-------------------------------------------------------------------------------------------+
+
+Operations and Configuration Changes
+--------
+No relevant operations and configuration changes were made.
+
+Naming Changes
+-------
+No relevant naming changes were made.
+
+Deprecated Features
+-------
+In SQream version 2022.1 the ``VARCHAR`` data type has been deprecated and replaced with ``TEXT``. SQream will maintain ``VARCHAR`` in all previous versions until completing the migration to ``TEXT``, at which point it will be deprecated in all earlier versions. SQream also provides an automated and secure tool to facilitate and simplify migration from ``VARCHAR`` to ``TEXT``.  
+
+If you are using an earlier version of SQream, see the `Using Legacy String Literals `_ configuration flag.
+
+End of Support
+-------
+The End of Support section is not relevant to Version 2022.1.
+
+Upgrading to v2022.1
+-------
+1. Generate a back-up of the metadata by running the following command:
+
+   .. code-block:: console
+
+      $ select backup_metadata('out_path');
+	  
+   .. tip:: SQream recommends storing the generated back-up locally in case needed.
+   
+   SQream runs the Garbage Collector and creates a clean backup tarball package.
+   
+2. Shut down all SQream services.
+
+    ::
+
+3. Extract the recently created back-up file.
+
+    ::
+
+4. Replace your current metadata with the metadata you stored in the back-up file.
+
+    ::
+
+5. Navigate to the new SQream package bin folder.
+
+    ::
+
+6. Run the following command:
+
+   .. code-block:: console
+
+      $ ./upgrade_storage 
+
+  .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version `_ procedure.
+  
+.. toctree::
+   :maxdepth: 2
+   :glob:
+   :hidden:
+
+   2022.1

From 174f17de04347f32e5a8e6007e67be838b4580ff Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Sun, 31 Jul 2022 10:12:57 +0300
Subject: [PATCH 174/882] Removed Healer Toggle (2022.1.1)

---
 configuration_guides/admin_worker_flags.rst   |   1 -
 .../healer_max_inactivity_hours.rst           |   4 +-
 configuration_guides/is_healer_on.rst         |  14 ---
 feature_guides/query_healer.rst               |  18 +--
 releases/2022.1.1.rst                         | 109 ------------------
 5 files changed, 3 insertions(+), 143 deletions(-)
 delete mode 100644 configuration_guides/is_healer_on.rst
 delete mode 100644 releases/2022.1.1.rst

diff --git a/configuration_guides/admin_worker_flags.rst b/configuration_guides/admin_worker_flags.rst
index 453c66af8..6b7a74b9e 100644
--- a/configuration_guides/admin_worker_flags.rst
+++ b/configuration_guides/admin_worker_flags.rst
@@ -9,6 +9,5 @@ The **Worker Administration Flags** page describes **Worker** modification type
 * `Enabling Manually Setting Reported IP `_
 * `Setting Port Used for Metadata Server Connection `_
 * `Assigning Local Network IP `_
-* `Enabling the Query Healer `_
 * `Configuring the Query Healer `_
 * `Adjusting Permitted Log-in Attempts `_
\ No newline at end of file
diff --git a/configuration_guides/healer_max_inactivity_hours.rst b/configuration_guides/healer_max_inactivity_hours.rst
index 56ddb78fc..1ff8ddaa6 100644
--- a/configuration_guides/healer_max_inactivity_hours.rst
+++ b/configuration_guides/healer_max_inactivity_hours.rst
@@ -9,6 +9,4 @@ The following describes the ``healerMaxInactivityHours`` flag:
 
 * **Data type** - size_t
 * **Default value** - ``5``
-* **Allowed values** - 1-4000000000
-
-For related flags, see :ref:`is_healer_on`.
\ No newline at end of file
+* **Allowed values** - 1-4000000000
\ No newline at end of file
diff --git a/configuration_guides/is_healer_on.rst b/configuration_guides/is_healer_on.rst
deleted file mode 100644
index 8b90654ec..000000000
--- a/configuration_guides/is_healer_on.rst
+++ /dev/null
@@ -1,14 +0,0 @@
-.. _is_healer_on:
-
-*************************
-Enabling the Query Healer
-*************************
-The ``is_healer_on`` flag enables the Query Healer, which periodically examines the progress of running statements and logs statements exceeding the ``healerMaxInactivityHours`` flag setting.
-
-The following describes the ``is_healer_on`` flag:
-
-* **Data type** - boolean
-* **Default value** - ``true``
-* **Allowed values** - ``true``, ``false``
-
-For related flags, see :ref:`healer_max_inactivity_hours`.
\ No newline at end of file
diff --git a/feature_guides/query_healer.rst b/feature_guides/query_healer.rst
index cb50549b8..380b1558f 100644
--- a/feature_guides/query_healer.rst
+++ b/feature_guides/query_healer.rst
@@ -21,20 +21,6 @@ The following is an example of a log record for a query stuck in the query detec
 
 Configuring the Healer
 ------------------
-The following flags are required to configure the Query Healer:
+The **healerMaxInactivityHours** is required define the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU. The ``healerMaxInactivityHours`` log frequency is calculated as 5% of the flag setting. For example, setting ``healerMaxInactivityHours`` to five hours (the default setting) triggers an examination every 15 minutes.
 
- * **isHealerOn** - Enables the Query Healer.
-
-    ::
-
- * **healerMaxInactivityHours** - Defines the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU.
-
-The ``healerMaxInactivityHours`` log frequency is calculated as 5% of the flag setting. For example, setting ``healerMaxInactivityHours`` to five hours (the default setting) triggers an examination every 15 minutes.
-
-For more information, see the following Administration Worker flags:
-
- * :ref:`is_healer_on`
-
-    ::
-
- * :ref:`healer_max_inactivity_hours`
\ No newline at end of file
+For more information, see :ref:`healer_max_inactivity_hours`.
\ No newline at end of file
diff --git a/releases/2022.1.1.rst b/releases/2022.1.1.rst
deleted file mode 100644
index 08843f380..000000000
--- a/releases/2022.1.1.rst
+++ /dev/null
@@ -1,109 +0,0 @@
-.. _2022.1.1:
-
-**************************
-Release Notes 2022.1.1
-**************************
-The 2022.1.1 patch release notes were released on 7/28/2022 and describe the following: 
-
-.. contents:: 
-   :local:
-   :depth: 1
-
-Version Content
-----------
-The **Version Content** section is not relevant to the 2022.1.1 patch release notes.
-
-New Features
-----------
-The 2022.1 Release Notes include the following new features:
-
-.. contents:: 
-   :local:
-   :depth: 1
-
-Password Policy
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-SQream has implemented a strong password policy required when accessing the CLI or Studio.
-
-For more information, see :ref:`access_control_password_policy`.
-   
-Resolved Issues
----------
-The following table lists the issues that were resolved in the 2022.1.1 patch release:
-
-+-------------+-----------------------------------------------------------------------------------------------------------------------+
-| **SQ No.**  | **Description**                                                                                                       |
-+=============+=======================================================================================================================+
-| SQ-6419     | An internal compiler error occurred when casting a numeric literal in an aggregation function.                        |
-+-------------+-----------------------------------------------------------------------------------------------------------------------+
-| SQ-10873    | Inserting 100K bytes into a ``TEXT`` column resulted in an unclear error message.                                     |
-+-------------+-----------------------------------------------------------------------------------------------------------------------+
-| SQ-10886    | An internal compiler error occurred during the compilation process.                                                   |
-+-------------+-----------------------------------------------------------------------------------------------------------------------+
-| SQ-10892    | The error message displayed when ``UPDATE`` is run on a foreign table was corrected.                                  |
-+-------------+-----------------------------------------------------------------------------------------------------------------------+
-| SQ-10955    | Unneeded reads occured when filtering by date.                                                                        |
-+-------------+-----------------------------------------------------------------------------------------------------------------------+
-
-Known Issues
----------
-The **Known Issues** section is not relevant to Version 2022.1.1.
-
-Operations and Configuration Changes
---------
-The **Operations and Configuration Changes** section is not relevant to the 2022.1.1 patch release notes.
-
-Naming Changes
--------
-The **Naming Changes** section is not relevant to the 2022.1.1 patch release notes.
-
-Deprecated Features
--------
-The **Deprecated Features** section is not relevant to the 2022.1.1 patch release.
-
-End of Support
--------
-The **End of Support** section is not relevant to the 2022.1.1 patch release.
-
-Upgrading to v2022.1.1
--------
-1. Generate a back-up of the metadata by running the following command:
-
-   .. code-block:: console
-
-      $ select backup_metadata('out_path');
-	  
-   .. tip:: SQream recommends storing the generated back-up locally in case needed.
-   
-   SQream runs the Garbage Collector and creates a clean backup tarball package.
-   
-2. Shut down all SQream services.
-
-    ::
-
-3. Extract the recently created back-up file.
-
-    ::
-
-4. Replace your current metadata with the metadata you stored in the back-up file.
-
-    ::
-
-5. Navigate to the new SQream package bin folder.
-
-    ::
-
-6. Run the following command:
-
-   .. code-block:: console
-
-      $ ./upgrade_storage 
-
-  .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in **Step 7** of the Upgrading SQream Version procedure.
-  
-.. toctree::
-   :maxdepth: 2
-   :glob:
-   :hidden:
-
-   2022.1.1
\ No newline at end of file

From 5b4e90d3f75caea97e4036fd38c3a93c2350ef52 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Sun, 31 Jul 2022 10:23:34 +0300
Subject: [PATCH 175/882] Removed reference to Healer configuration

---
 configuration_guides/admin_worker_flags.rst          |  1 -
 configuration_guides/healer_max_inactivity_hours.rst | 12 ------------
 feature_guides/query_healer.rst                      |  4 +---
 3 files changed, 1 insertion(+), 16 deletions(-)
 delete mode 100644 configuration_guides/healer_max_inactivity_hours.rst

diff --git a/configuration_guides/admin_worker_flags.rst b/configuration_guides/admin_worker_flags.rst
index 6b7a74b9e..6be021d70 100644
--- a/configuration_guides/admin_worker_flags.rst
+++ b/configuration_guides/admin_worker_flags.rst
@@ -9,5 +9,4 @@ The **Worker Administration Flags** page describes **Worker** modification type
 * `Enabling Manually Setting Reported IP `_
 * `Setting Port Used for Metadata Server Connection `_
 * `Assigning Local Network IP `_
-* `Configuring the Query Healer `_
 * `Adjusting Permitted Log-in Attempts `_
\ No newline at end of file
diff --git a/configuration_guides/healer_max_inactivity_hours.rst b/configuration_guides/healer_max_inactivity_hours.rst
deleted file mode 100644
index 1ff8ddaa6..000000000
--- a/configuration_guides/healer_max_inactivity_hours.rst
+++ /dev/null
@@ -1,12 +0,0 @@
-.. _healer_max_inactivity_hours:
-
-*************************
-Configuring the Query Healer
-*************************
-The ``healerMaxInactivityHours`` flag is used for defining the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU.
-
-The following describes the ``healerMaxInactivityHours`` flag:
-
-* **Data type** - size_t
-* **Default value** - ``5``
-* **Allowed values** - 1-4000000000
\ No newline at end of file
diff --git a/feature_guides/query_healer.rst b/feature_guides/query_healer.rst
index 380b1558f..667a91ed8 100644
--- a/feature_guides/query_healer.rst
+++ b/feature_guides/query_healer.rst
@@ -21,6 +21,4 @@ The following is an example of a log record for a query stuck in the query detec
 
 Configuring the Healer
 ------------------
-The **healerMaxInactivityHours** is required define the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU. The ``healerMaxInactivityHours`` log frequency is calculated as 5% of the flag setting. For example, setting ``healerMaxInactivityHours`` to five hours (the default setting) triggers an examination every 15 minutes.
-
-For more information, see :ref:`healer_max_inactivity_hours`.
\ No newline at end of file
+The **healerMaxInactivityHours** is required define the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU. The ``healerMaxInactivityHours`` log frequency is calculated as 5% of the flag setting. For example, setting ``healerMaxInactivityHours`` to five hours (the default setting) triggers an examination every 15 minutes.
\ No newline at end of file

From 9de62ba18c3006361b0c3433828fd767ff5a51e1 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Sun, 31 Jul 2022 10:35:01 +0300
Subject: [PATCH 176/882] Update 2021.2.1.24.rst

---
 releases/2021.2.1.24.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/releases/2021.2.1.24.rst b/releases/2021.2.1.24.rst
index 125092f0e..fe21d40c0 100644
--- a/releases/2021.2.1.24.rst
+++ b/releases/2021.2.1.24.rst
@@ -25,7 +25,7 @@ Query Healer
 ************
 The new **Query Healer** feature periodically examines the progress of running statements, and is used for query maintenance.
 
-For more information, see :ref:`query_healer`.
+For more information, see `Query Healer `_.
 
 Known Issues
 ---------

From 93000b924307a192a334e7cdbec8b458e8604e5e Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Sun, 31 Jul 2022 13:27:15 +0300
Subject: [PATCH 177/882] Testing links

---
 releases/2021.1.2.rst                 |   6 +-
 releases/2021.2.1.24.rst              |   2 +-
 releases/2021.2.1.rst                 |   4 +-
 releases/2021.2.rst                   |   4 +-
 releases/2022.1.rst                   |  10 +-
 sqream_studio_5.4.3/Version_5.3.3.txt | 898 ++++++++++++++++++++++++++
 6 files changed, 911 insertions(+), 13 deletions(-)
 create mode 100644 sqream_studio_5.4.3/Version_5.3.3.txt

diff --git a/releases/2021.1.2.rst b/releases/2021.1.2.rst
index 448b047df..5ccd878d8 100644
--- a/releases/2021.1.2.rst
+++ b/releases/2021.1.2.rst
@@ -40,17 +40,17 @@ String Literals Containing ASCII Characters Interepreted as TEXT
 ************
 SQream now interprets all string literals, including those containing ASCII characters, as ``text``.
 
-For more information, see `String Types `_.
+For more information, see `String Types `_.
 
 Decimal Literals Interpreted as Numeric Columns
 ************
 SQream now interprets literals containing decimal points as ``numeric`` instead of as ``double``.
 
-For more information, see `Data Types `_.
+For more information, see `Data Types `_.
 
 Roles Area Added to Studio Version 5.3.3
 ****************
-The **Roles** area has been added to `Studio version 5.3.3 `_. From the Roles area users can create and assign roles and manage user permissions.
+The **Roles** area has been added to `Studio version 5.3.3 `_. From the Roles area users can create and assign roles and manage user permissions.
 
 Resolved Issues
 -------------
diff --git a/releases/2021.2.1.24.rst b/releases/2021.2.1.24.rst
index fe21d40c0..f92cfda00 100644
--- a/releases/2021.2.1.24.rst
+++ b/releases/2021.2.1.24.rst
@@ -25,7 +25,7 @@ Query Healer
 ************
 The new **Query Healer** feature periodically examines the progress of running statements, and is used for query maintenance.
 
-For more information, see `Query Healer `_.
+For more information, see `Query Healer `_.
 
 Known Issues
 ---------
diff --git a/releases/2021.2.1.rst b/releases/2021.2.1.rst
index 3afba3093..c7e1dbada 100644
--- a/releases/2021.2.1.rst
+++ b/releases/2021.2.1.rst
@@ -21,7 +21,7 @@ CREATE TABLE
 ************
 SQream now supports duplicating the column structure of an existing table using the ``LIKE`` clause.
 
-For more information, see `Duplicating the Column Structure of an Existing Table `_.
+For more information, see `Duplicating the Column Structure of an Existing Table `_.
 
 PERCENTILE FUNCTIONS
 ************
@@ -41,7 +41,7 @@ Delete Optimization
 ************
 The ``DELETE`` statement can now delete values that contain multi-table conditions.
 
-For more information, see `Deleting Values that Contain Multi-Table Conditions `_.
+For more information, see `Deleting Values that Contain Multi-Table Conditions `_.
 
 For more information, see :ref:`regexp_replace`.
 
diff --git a/releases/2021.2.rst b/releases/2021.2.rst
index 1bd6c6223..cce1675dc 100644
--- a/releases/2021.2.rst
+++ b/releases/2021.2.rst
@@ -33,8 +33,8 @@ SQream now uses a new configuration system based on centralized configuration ac
 
 For more information, see the following:
 
-* `Configuration `_ - describes how to configure your instance of SQream from a centralized location.
-* `SQream Studio 5.4.2 `_ - configure your instance of SQream from Studio.
+* `Configuration `_ - describes how to configure your instance of SQream from a centralized location.
+* `SQream Studio 5.4.2 `_ - configure your instance of SQream from Studio.
    
 Qualifying Schemas Without Providing an Alias
 ************
diff --git a/releases/2022.1.rst b/releases/2022.1.rst
index cdd6d98c5..085108a43 100644
--- a/releases/2022.1.rst
+++ b/releases/2022.1.rst
@@ -37,13 +37,13 @@ Update Feature
 ************
 SQream now supports the DML **Update** feature, which is used for modifying the value of certain columns in existing rows.
 
-For more information, see `UPDATE `_.
+For more information, see `UPDATE `_.
 
 Avro Ingestion
 ************
 SQream now supports ingesting data from Avro files.
 
-For more information, see `Inserting Data from Avro `_.
+For more information, see `Inserting Data from Avro `_.
 
 Known Issues
 ---------
@@ -87,7 +87,7 @@ Deprecated Features
 -------
 In SQream version 2022.1 the ``VARCHAR`` data type has been deprecated and replaced with ``TEXT``. SQream will maintain ``VARCHAR`` in all previous versions until completing the migration to ``TEXT``, at which point it will be deprecated in all earlier versions. SQream also provides an automated and secure tool to facilitate and simplify migration from ``VARCHAR`` to ``TEXT``.  
 
-If you are using an earlier version of SQream, see the `Using Legacy String Literals `_ configuration flag.
+If you are using an earlier version of SQream, see the `Using Legacy String Literals `_ configuration flag.
 
 End of Support
 -------
@@ -127,11 +127,11 @@ Upgrading to v2022.1
 
       $ ./upgrade_storage 
 
-  .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version `_ procedure.
+  .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version `_ procedure.
   
 .. toctree::
    :maxdepth: 2
    :glob:
    :hidden:
 
-   2022.1
+   2022.1
\ No newline at end of file
diff --git a/sqream_studio_5.4.3/Version_5.3.3.txt b/sqream_studio_5.4.3/Version_5.3.3.txt
new file mode 100644
index 000000000..458302aad
--- /dev/null
+++ b/sqream_studio_5.4.3/Version_5.3.3.txt
@@ -0,0 +1,898 @@
+.. _acceleration_studio_version_5.3.3:
+
+****************************
+SQream Acceleration Studio 5.3.3
+****************************
+
+The SQream Studio is a web-based client for use with SQream DB. The Studio provides users with all functionality available from the command line in an intuitive and easy-to-use format. This includes running statements, managing roles and permissions, and managing SQream DB clusters.
+
+
+.. contents:: This page describes the following:
+   :depth: 3
+
+Getting Started
+==================
+
+.. _setting_up_and_starting_studio:
+
+
+Setting Up and Starting Studio
+----------------
+
+Studio is included with all `dockerized installations of SQream DB `_. When starting Studio, it listens on the local machine on port 8080.
+
+
+
+
+
+
+
+Logging In to Studio
+---------------
+**To log in to SQream Studio:**
+
+1. Open a browser to the host on **port 8080**.
+
+   For example, if your machine IP address is ``192.168.0.100``, insert the IP address into the browser as shown below:
+
+   .. code-block:: console
+
+      $ http://192.168.0.100:8080
+
+2. Fill in your SQream DB login credentials. These are the same credentials used for `SQream CLI Reference `_ or JDBC.
+
+   When you sign in, the License Warning is displayed.
+
+Navigating Studio's Main Features
+-------------
+When you log in, you are automatically taken to the **Editor** screen. The Studio's main functions are displayed in the **Navigation** pane on the left side of the screen.
+
+From here you can navigate between the main areas of the Studio:
+
+.. list-table::
+   :widths: 10 90
+   :header-rows: 1   
+   
+   * - Element
+     - Description
+   * - :ref:`Dashboard`
+     - Only users with **superuser** permissions have access to the Dashboard.
+   * - :ref:`Editor`
+     - All users have access to the Editor and to databases that they have permissions for.   
+   * - :ref:`Logs`
+     - Only users with the **superuser** permissions have access to the logs.
+   * - :ref:`Roles`
+     - Lets you create users and manage user permissions.
+
+By clicking the user icon, you can also use it for logging out and viewing the following:
+
+* User information
+* Connection type
+* SQream version
+* SQream Studio version
+* Data size limitations
+* Log out
+
+
+
+.. _back_to_dashboard:
+
+.. _studio_dashboard:
+
+Monitoring Workers and Services from the Dashboard
+==============================
+The **Dashboard** is used for the following:
+
+* Monitoring cluster storage and system health.
+* Viewing, monitoring, and adding defined service queues.
+* Viewing and managing worker status and add workers.
+
+You can only access the Dashboard if you signed in with a ``SUPERUSER`` role.
+
+The following is a brief description of the Dashboard panels:
+
+.. list-table::
+   :widths: 10 25 65
+   :header-rows: 1  
+   
+   * - No.
+     - Element
+     - Description
+   * - 1
+     - :ref:`Data Storage panel`
+     - Used to monitor cluster storage.
+   * - 2
+     - :ref:`Services panel`
+     - Used for viewing and monitoring the defined `service queues `_.
+   * - 3
+     - :ref:`Workers panel`
+     - Monitors system health and shows each Sqreamd worker running in the cluster.
+   * - 4
+     - :ref:`License information`
+     - Shows the remaining amount of days left on your license.
+   
+
+.. _data_storage_panel:
+
+Displaying System Disk Usage from the Data Storage Panel
+-----------------------
+The **Data Storage** area displays your system's total disk usage (percentage) and data storage (donut graph).
+
+Your data storage is shows as the following four components:
+
+* **Data** – Storage occupied by databases in SQream DB.
+* **Free** – Free storage space.
+* **Deleted** – Storage that is temporarily occupied, but has not been reclaimed. For more information, see `Deleting Data `_. The **deleted** value is estimated and may not be accurate.
+* **Other** – Storage used by other applications. On a dedicated SQream DB cluster this should be near zero.
+
+.. _administration_storage_database:
+
+You can show more information by clicking the expand arrow on the Data Storage panel.
+
+.. image:: /_static/images/studio_dashboard_expand_data_storage_5.3.0.png
+
+The expanded Data Storage panel can be used to drill down into each database's storage footprint, and displays a breakdown of how much storage each database in the cluster uses.
+
+The database information is displayed in a table and shows the following:
+
+* **Database name** - the name of the database.
+* **Raw Size** – the estimated size of (uncompressed) raw data in the database.
+* **Storage Size** – the physical size of the compressed data.
+* **Ratio** – the effective compression ratio
+* **Deleted Data** – Storage that is temporarily occupied, but has not been reclaimed.
+
+Below the table, an interactive line graph displays the database storage trends. By default, the line graph displays the total storage for all databases. You can show a particular database's graph by clicking it in the table. You can also change the line graph's timespan by selecting one from the timespan dropdown menu.
+
+.. image:: /_static/images/studio_dashboard_expand_data_storage_3_5.3.0.png
+
+:ref:`Back to Dashboard`
+
+.. _services_panel:
+
+Subscribing to Workers from the Services Panel
+--------------------------
+Services are used to categorize and associate (also known as **subscribing**) workers to particular services. The **Service** panel is used for viewing, monitoring, and adding defined `service queues `_.
+
+.. image:: /_static/images/studio_dashboard_services_panel_5.3.0.png
+
+The Dashboard includes the four panes shown below:
+
+.. image:: /_static/images/studio_dashboard_service_queue_5.3.0.png
+
+The following is a brief description of each pane:
+	 
+.. list-table::
+   :widths: 10 90
+   :header-rows: 1  
+   
+   * - No.
+     - Description
+   * - 1
+     - Adds a worker to the selected service.
+   * - 2
+     - Shows the service name.
+   * - 3
+     - Shows a trend graph of queued statements loaded over time.
+   * - 4
+     - Adds a service.
+   * - 5
+     - Shows the currently processed queries belonging to the service/total queries for that service in the system (including queued queries).	 
+
+Adding A Service
+^^^^^^^^^^^^^^^^^^^^^	 
+You can add a service by clicking **+ Add** and defining the service name.
+
+.. note:: If you do not associate a worker with the new service, it will not be created.
+
+You can manage workers from the **Workers** panel. For more information on managing workers, see :ref:`Workers`.
+
+:ref:`Back to Dashboard`
+
+.. _workers_panel:
+
+Managing Workers from the Workers Panel
+------------
+From the **Workers** panel you can do the following:
+
+* :ref:`View workers `
+* :ref:`Add a worker to a service`
+* :ref:`View a worker's active query information`
+* :ref:`View a worker's execution plan`
+
+.. _view_workers:
+
+Viewing Workers
+^^^^^^^^
+The **Worker** panel shows each worker (``sqreamd``) running in the cluster. Each worker has a status bar that represents the status over time. The status bar is divided into 20 equal segments, showing the most dominant activity in that segment.
+	 
+From the **Scale** dropdown menu you can set the time scale of the displayed information
+You can hover over segments in the status bar to see the date and time corresponding to each activity type:
+
+* **Idle** – the worker is idle and available for statements.
+* **Compiling** – the worker is compiling a statement and is preparing for execution.
+* **Executing** – the worker is executing a statement after compilation.
+* **Stopped** – the worker was stopped (either deliberately or due to an error).
+* **Waiting** – the worker was waiting on an object locked by another worker.
+
+.. _add_worker_to_service:
+
+Adding A Worker to A Service
+^^^^^^^^^^^^^^^^^^^^^	 
+You can add a worker to a service by clicking the **add** button. 
+
+.. image:: /_static/images/studio_dashboard_add_worker_to_service_5.3.0.png
+
+Clicking the **add** button shows the selected service's workers. You can add the selected worker to the service by clicking **Add Worker**. Adding a worker to a service does not break associations already made between that worker and other services.
+
+
+.. _view_worker_query_information:
+
+Viewing A Worker's Active Query Information
+^^^^^^^^^^^^^^^^^^^^^	 
+You can view a worker's active query information by clicking **Queries**, which displays them in the selected service.
+
+
+Each statement shows the **query ID**, **status**, **service queue**, **elapsed time**, **execution time**, and **estimated completion status**. In addition, each statement can be stopped or expanded to show its execution plan and progress. For more information on viewing a statement's execution plan and progress, see :ref:`Viewing a Worker's Execution Plan ` below.
+
+Viewing A Worker's Host Utilization
+^^^^^^^^^^^^^^^^^^^^^	 
+
+While viewing a worker's query information, clicking the **down arrow** expands to show the host resource utilization.
+
+.. image:: /_static/images/studio_dashboard_show_cpu_gpu_graph_5.3.0.png
+
+The graphs show the resource utilization trends over time, and the **CPU memory** and **utilization** and the **GPU utilization** values on the right. You can hover over the graph to see more information about the activity at any point on the graph.
+
+Error notifications related to statements are displayed as shown in the figure below, and you can hover over them for more information about the error. 
+
+.. image:: /_static/images/studio_dashboard_notification_error_5.3.0.png
+
+.. _view_worker_execution_plan:
+
+Viewing a Worker's Execution Plan
+^^^^^^^^^^^^^^^^^^^^^
+	 
+Clicking the ellipsis in a service shows the following additional options:
+
+* **Stop Query** - stops the query.
+* **Show Execution Plan** - shows the execution plan as a table. The columns in the **Show Execution Plan** table can be sorted.
+
+For more information on the current query plan, see `SHOW_NODE_INFO `_. For more information on checking active sessions across the cluster, see `SHOW_SERVER_STATUS `_.
+
+.. include:: /reference/sql/sql_statements/monitoring_commands/show_server_status.rst
+   :start-line: 67
+   :end-line: 84
+
+Managing Worker Status
+^^^^^^^^^^^^^^^^^^^^^
+
+In some cases you may want to stop or restart workers for maintenance purposes. Each Worker line has a :kbd:`⋮` menu used for stopping, starting, or restarting workers.
+
+.. image:: /_static/images/stop_restart_worker.png
+
+Starting or restarting workers terminates all queries related to that worker. When you stop a worker, its background turns gray.
+
+
+
+
+.. |icon-user| image:: /_static/images/studio_icon_user.png
+   :align: middle
+   
+.. |icon-dots| image:: /_static/images/studio_icon_dots.png
+   :align: middle   
+   
+.. |icon-editor| image:: /_static/images/studio_icon_editor.png
+   :align: middle
+
+.. |icon-copy| image:: /_static/images/studio_icon_copy.png
+   :align: middle
+
+.. |icon-select| image:: /_static/images/studio_icon_select.png
+   :align: middle
+
+.. |icon-dots| image:: /_static/images/studio_icon_dots.png
+   :align: middle
+
+.. |icon-filter| image:: /_static/images/studio_icon_filter.png
+   :align: middle
+
+.. |icon-ddl-edit| image:: /_static/images/studio_icon_ddl_edit.png
+   :align: middle
+
+.. |icon-run-optimizer| image:: /_static/images/studio_icon_run_optimizer.png
+   :align: middle
+
+.. |icon-generate-create-statement| image:: /_static/images/studio_icon_generate_create_statement.png
+   :align: middle
+
+.. |icon-plus| image:: /_static/images/studio_icon_plus.png
+   :align: middle
+
+.. |icon-close| image:: /_static/images/studio_icon_close.png
+   :align: middle
+
+.. |icon-left| image:: /_static/images/studio_icon_left.png
+   :align: middle
+
+.. |icon-right| image:: /_static/images/studio_icon_right.png
+   :align: middle
+
+.. |icon-format-sql| image:: /_static/images/studio_icon_format.png
+   :align: middle
+
+.. |icon-download-query| image:: /_static/images/studio_icon_download_query.png
+   :align: middle
+
+.. |icon-open-query| image:: /_static/images/studio_icon_open_query.png
+   :align: middle
+
+.. |icon-execute| image:: /_static/images/studio_icon_execute.png
+   :align: middle
+
+.. |icon-stop| image:: /_static/images/studio_icon_stop.png
+   :align: middle
+
+.. |icon-dashboard| image:: /_static/images/studio_icon_dashboard.png
+   :align: middle
+
+.. |icon-expand| image:: /_static/images/studio_icon_expand.png
+   :align: middle
+
+.. |icon-scale| image:: /_static/images/studio_icon_scale.png
+   :align: middle
+
+.. |icon-expand-down| image:: /_static/images/studio_icon_expand_down.png
+   :align: middle
+
+.. |icon-add| image:: /_static/images/studio_icon_add.png
+   :align: middle
+
+.. |icon-add-worker| image:: /_static/images/studio_icon_add_worker.png
+   :align: middle
+
+.. |keep-tabs| image:: /_static/images/studio_keep_tabs.png
+   :align: middle
+   
+:ref:`Back to Dashboard`
+
+
+
+.. _license_information:
+   
+License Information
+----------------------
+The license information is a counter showing the amount of time in days remaining on the license.
+
+:ref:`Back to Dashboard`
+
+
+.. _studio_editor:
+
+.. _editor_top:
+
+Executing Statements and Running Queries from the Editor
+=================
+The **Editor** is used for the following:
+
+* Selecting an active database and executing queries.
+* Performing statement-related operations and showing metadata.
+* Executing pre-defined queries.
+* Writing queries and statements and viewing query results.
+	 
+The following is a brief description of the Editor panels:
+
+
+.. list-table::
+   :widths: 10 34 56
+   :header-rows: 1  
+   
+   * - No.
+     - Element
+     - Description
+   * - 1
+     - :ref:`Toolbar`
+     - Used to select the active database you want to work on, limit the number of rows, save query, etc.
+   * - 2
+     - :ref:`Database Tree and System Queries panel`
+     - Shows a heirarchy tree of databases, views, tables, and columns
+   * - 3
+     - :ref:`Statement panel`
+     - Used for writing queries and statements
+   * - 4
+     - :ref:`Results panel`
+     - Shows query results and execution information.
+
+
+.. _studio_editor_db_tree:
+
+.. _top:
+
+.. _studio_editor_toolbar:
+
+Executing Statements from the Toolbar
+-------------
+
+The following figure shows the **Toolbar** pane:
+
+.. image:: /_static/images/studio_editor_toolbar_5.3.0.png
+
+You can access the following from the Toolbar pane:
+
+* **Database dropdown list** - select a database that you want to run statements on.
+
+* **Service dropdown list** - select a service that you want to run statements on. The options in the service dropdown menu depend on the database you select from the **Database** dropdown list.
+
+* **Execute** - lets you set which statements to execute. The **Execute** button toggles between **Execute** and **Stop**, and can be used to stop an active statement before it completes:
+
+  * **Statements** - executes the statement at the location of the cursor.
+  * **Selected** - executes only the highlighted text. This mode should be used when executing subqueries or sections of large queries (as long as they are valid SQLs).
+  * **All** - executes all statements in a selected tab.
+   
+For more information on stopping active statements, see the :ref:`STOP_STATEMENT` command.
+
+* **Format SQL** - Lets you reformat and reindent statements.
+
+* **Download query** - Lets you download query text to your computer.
+
+* **Open query** - Lets you upload query text from your computer.
+
+* **Max Rows** - By default, the Editor fetches only the first 10,000 rows. You can modify this number by selecting an option from the **Max Rows** dropdown list. Note that setting a higher number may slow down your browser if the result is very large. This number is limited to 100,000 results. To see a higher number, you can save the results in a file or a table using the :ref:`create_table_as` command.
+
+:ref:`Back to Editor`
+
+Performing Statement-Related Operations from the Database Tree
+---------------
+From the Database Tree you can perform statement-related operations and show metadata (such as a number indicating the amount of rows in the table).
+
+The following figure shows the **Database Tree** and **System Queries** panel, with the Database Tree tab selected.
+
+.. image:: /_static/images/studio_database_tree_system_queries_panel_5053.png
+
+The following figure shows the database object functions in the **calcs** table object.
+
+.. image:: /_static/images/studio_database_object_operations_5030.png
+
+The database object functions are used to perform the following:
+
+
+  * The **SELECT** statement - copies the selected table's **columns** into the Statement panel as ``SELECT`` parameters.
+  * The **copy** feature |icon-copy| - copies the selected table's **name** into the Statement panel. 
+  * The **additional operations** |icon-dots| - displays the following additional options:
+  
+
+
+
+
+.. list-table::
+   :widths: 30 70
+   :header-rows: 1   
+   
+   * - Function
+     - Description
+   * - Insert statement
+     - Generates an `INSERT `_ statement for the selected table in the editing area.
+   * - Delete statement
+     - Generates a `DELETE `_ statement for the selected table in the editing area.
+   * - Create Table As statement
+     - Generates a `CREATE TABLE AS `_ statement for the selected table in the editing area.	 
+   * - Rename statement
+     - Generates an `RENAME TABLE AS `_ statement for renaming the selected table in the editing area.
+   * - Adding column statement
+     - Generates an `ADD COLUMN `_ statement for adding columns to the selected table in the editing area.
+   * - Truncate table statement
+     - Generates a `TRUNCATE_IF_EXISTS `_ statement for the selected table in the editing area.
+   * - Drop table statement
+     - Generates a ``DROP`` statement for the selected object in the editing area.
+   * - Table DDL
+     - Generates a DDL statement for the selected object in the editing area. To get the entire database DDL, click the |icon-ddl-edit| icon next to the database name in the tree root. See also  `Seeing System Objects as DDL `_.
+   * - DDL Optimizer
+     - The `DDL Optimizer `_  lets you analyze database tables and recommends possible optimizations.
+	 
+	 
+	 
+
+
+Optimizing Database Tables Using the DDL Optimizer
+^^^^^^^^^^^^^^^^^^^^^
+The **DDL Optimizer** tab analyzes database tables and recommends possible optimizations according to SQream's best practices.
+
+As described in the previous table, you can access the DDL Optimizer by clicking the **additional options icon** and selecting **DDL Optimizer**.
+
+The following table describes the DDL Optimizer screen:
+
+.. list-table::
+   :widths: 15 75
+   :header-rows: 1   
+   
+   * - Element
+     - Description
+   * - Column area
+     - Shows the column **names** and **column types** from the selected table. You can scroll down or to the right/left for long column lists.
+   * - Optimization area
+     - Shows the number of rows to sample as the basis for running an optimization, the default setting (1,000,000) when running an optimization (this is also the overhead threshold used when analyzing ``VARCHAR`` fields),  and the default percent buffer to add to ``VARCHAR`` lengths (10%). Attempts to determine field nullability.
+   * - Run Optimizer
+     - Starts the optimization process.
+
+Clicking **Run Optimizer** adds a tab to the Statement panel showing the optimized results of the selected object. The figure below shows the **calcs Optimized** tab for the optimized **calcs** table.
+
+For more information, see `Optimization and Best Practices `_.
+
+:ref:`Back to top`
+
+Executing Pre-Defined Queries from the System Queries Panel
+---------------
+The **System Queries** panel lets you execute pre-defined queries and includes the following system query types:
+
+* **Catalog queries** - used for analyzing table compression rates, users and permissions, etc.
+* **Admin queries** - queries related to available  (describe the functionality in a general way). Queries useful for SQream database management:
+
+
+
+
+
+Clicking an item pastes the query into the Statement pane, and you can undo a previous operation by pressing **Ctrl + Z**.
+
+
+.. _studio_editor_statement_area:
+
+Writing Statements and Queries from the Statement Panel
+----------------
+The multi-tabbed statement area is used for writing queries and statements, and is used in tandem with the toolbar. When writing and executing statements, you must first select a database from the **Database** dropdown menu in the toolbar. When you execute a statement, it passes through a series of statuses until completing. Knowing the status helps you with statement maintenance, and the statuses are shown in the **Results panel**.
+
+The following table shows the statement statuses:
+	 
+.. list-table::
+   :widths: 45 160
+   :header-rows: 1  
+   
+   * - Status
+     - Description
+   * - Pending
+     - The statement is pending.
+   * - In queue
+     - The statement is waiting for execution.
+   * - Initializing
+     - The statement has entered execution checks.
+   * - Executing
+     - The statement is executing.
+   * - Statement stopped
+     - The statement has been stopped.
+	 
+You can add and name new tabs for each statement that you need to execute, and Studio preserves your created tabs when you switch between databases. You can add new tabs by clicking |icon-plus| , which creates a new tab to the right with a default name of SQL and an increasing number. This helps you keep track of your statements.
+
+.. image:: /_static/images/statement_pane_adding_statement_5.3.0.png
+
+You can also rename the default tab name by double-clicking it and typing a new name and write multiple statements in tandem in the same tab by separating them with semicolons (``;``).If too many tabs to fit into the Statement Pane are open at the same time, the tab arrows are displayed. You can scroll through the tabs by clicking |icon-left| or |icon-right|, and close tabs by clicking |icon-close|. You can also close all tabs at once by clicking **Close all** located to the right of the tabs.
+
+.. tip:: If this is your first time using SQream, see `First steps with SQream DB `_.
+
+
+.. Keyboard shortcuts
+.. ^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. :kbd:`Ctrl` +: kbd:`Enter` - Execute all queries in the statement area, or just the highlighted part of the query.
+
+.. :kbd:`Ctrl` + :kbd:`Space` - Auto-complete the current keyword
+
+.. :kbd:`Ctrl` + :kbd:`↑` - Switch to next tab.
+
+.. :kbd:`Ctrl` + :kbd:`↓` - Switch to previous tab
+
+.. _studio_editor_results:
+
+:ref:`Back to Editor`
+
+
+Viewing Statement and Query Results from the Results Panel
+------------------------------------
+The results pane shows statment and query results. By default, only the first 10,000 results are returned, although you can modify this from the :ref:`studio_editor_toolbar`, as described above.
+
+.. image:: /_static/images/studio_editor_results_5053.png
+
+By default, executing several statements together opens a separate results tab for each statement. Executing statements together executes them serially, and any failed statement cancels all subsequent executions.
+
+The following is a brief description of the elements on the Results panel views:
+
+.. list-table::
+   :widths: 45 160
+   :header-rows: 1  
+   
+   * - Element
+     - Description
+   * - :ref:`Results view`
+     - Lets you view search query results.
+   * - :ref:`Execution Details view`
+     - Lets you view execution details, such as statement ID, number of rows, and averge number of rows in chunk.
+   * - :ref:`SQL view`
+     - Lets you see the SQL view.
+   * - :ref:`Save results to clipboard`
+     - Lets you save your search results to the clipboard to paste into another text editor.
+   * - :ref:`Save results to local file`
+     - Lets you save your search query results to a local file.
+
+.. _results_view:
+
+
+	 
+Searching Query Results in the Results View
+^^^^^^^^^^^^
+The **Results view** lets you view search query results.
+
+From this view you can also do the following:
+
+* View the amount of time (in seconds) taken for a query to finish executing.
+* Switch and scroll between tabs.
+* Close all tabs at once.
+* Enable keeping tabs by selecting **Keep tabs**.
+* Sort column results.
+
+In the Results view you can also run parallel statements, as described in **Running Parallel Statements** below.
+
+.. _running_parallel_statements:
+
+Running Parallel Statements
+^^^^^^^^^^^^
+While Studio's default functionality is to open a new tab for each executed statement, Studio supports running parallel statements in one statement tab. Running parallel statements requires using macros and is useful for advanced users.
+
+The following shows the syntax for running parallel statements:
+
+.. code-block:: console
+     
+   $ @@ parallel
+   $ $$
+   $ select 1;
+   $ select 2;
+   $ select 3;
+   $ $$
+   
+The following figure shows the parallel statement syntax in the Editor:
+
+.. image:: /_static/images/running_parallel_statements.png
+
+.. _execution_details_view:
+
+Execution Details View
+^^^^^^^^^^^^
+The **Execution Details** view lets you view a query’s execution plan for monitoring purposes. Most importantly, the Execution Details view highlights rows based on how long they ran relative to the entire query.
+
+This can be seen in the **timeSum** column as follows:
+
+* **Rows highlighted red** - longest runtime
+* **Rows highlighted orange** - medium runtime
+* **Rows highlighted yellow** - shortest runtime
+
+.. image:: /_static/images/execution_details_view_3.png
+
+
+
+.. _sql_view:
+
+Viewing Wrapped Strings in the SQL View
+^^^^^^^^^^^^
+The SQL View panel allows you to more easily view certain queries, such as a long string that appears on one line. The SQL View makes it easier to see by wrapping it so that you can see the entire string at once. It also reformats and organizes query syntax entered in the Statement panel for more easily locating particular segments of your queries. The SQL View is identical to the **Format SQL** feature in the Toolbar, allowing you to retain your originally constructed query while viewing a more intuititively structured snapshot of it.
+
+The following figure shows the SQL view:
+
+.. image:: /_static/images/sql_view_5.0.3.png
+
+.. _save_results_to_clipboard:
+
+Saving Results to the Clipboard
+^^^^^^^^^^^^
+The **Save results to clipboard** function lets you save your results to the clipboard to paste into another text editor or into Excel for further analysis.
+
+
+.. _save_results_to_local_file:
+
+Saving Results to a Local File
+^^^^^^^^^^^^
+The **Save results to local file** functions lets you save your search query results to a local file. Clicking **Save results to local file** downloads the contents of the Results panel to an Excel sheet. You can then use copy and paste this content into other editors as needed.
+
+Analyzing Results
+----------------------------
+
+When results are produced, a **Generate CREATE statement** button is displayed. Clicking this button creates a new tab with an optimized :ref:`create_table` statement, and an :ref:`insert` statement to copy the data to the new table.
+
+.. _logs:
+
+.. _logs_top:
+
+:ref:`Back to Editor`
+
+Viewing Logs
+============
+The **Logs** screen is used for viewing logs and includes the following elements:
+
+.. list-table::
+   :widths: 15 75
+   :header-rows: 1   
+   
+   * - Element
+     - Description
+   * - :ref:`Filter area`
+     - Lets you filter the data shown in the table. 
+   * - :ref:`Query tab`
+     - Shows basic query information logs, such as query number and the time the query was run. 
+   * - :ref:`Session tab`
+     - Shows basic session information logs, such as session ID and user name.
+   * - :ref:`System tab`
+     - Shows all system logs.
+   * - :ref:`Log lines tab`
+     - Shows the total amount of log lines.
+
+
+.. _filter:
+
+Filtering Table Data
+-------------
+From the Logs tab, from the **FILTERS** area you can also apply the **TIMESPAN**, **ONLY ERRORS**, and additional filters (**Add**). The **Timespan** filter lets you select a timespan. The **Only Errors** toggle button lets you show all queries, or only queries that generated errors. The **Add** button lets you add additional filters to the data shown in the table. The **Filter** button applies the selected filter(s).
+	 
+
+Some filters require you to type text to define the filter.
+
+.. image:: /_static/images/logs_filters_5.3.0.png
+
+Other filters require you to select an item from a dropdown menu:
+
+* INFO
+* WARNING
+* ERROR
+* FATAL
+* SYSTEM
+
+You can also export a record of all of your currently filtered logs in Excel format by clicking **Download** located above the Filter area.
+
+.. _queries:
+
+:ref:`Back to Viewing Logs`
+
+
+Viewing Query Logs
+----------
+The **QUERIES** log area shows basic query information, such as query number and the time the query was run. The number next to the title indicates the amount of queries that have been run.
+
+From the Queries area you can see and sort by the following:
+
+* Query ID
+* Start time
+* Query
+* Compilation duration
+* Execution duration
+* Total duration
+* Details (execution details, error details, successful query details)
+
+In the Queries table, you can click on the **Statement ID** and **Query** items to set them as your filters. In the **Details** column you can also access additional details by clicking one of the **Details** options for a more detailed explanation of the query.
+
+:ref:`Back to Viewing Logs`
+
+.. _sessions:
+
+Viewing Session Logs
+----------
+The **SESSIONS** tab shows the sessions log table and is used for viewing activity that has occurred during your sessions. The number at the top indicates the amount of sessions that have occurred.
+
+From here you can see and sort by the following:
+
+* Timestamp
+* Connection ID
+* Username
+* Client IP
+* Login (Success or Failed)
+* Duration (of session)
+* Configuration Changes
+
+In the Sessions table, you can click on the **Timestamp**, **Connection ID**, and **Username** items to set them as your filters.
+
+:ref:`Back to Viewing Logs`
+
+.. _system:
+
+Viewing System Logs
+----------
+The **SYSTEM** tab shows the system log table and is used for viewing all system logs. The number at the top indicates the amount of sessions that have occurred. Because system logs occur less frequently than queries and sessions, you may need to increase the filter timespan for the table to display any system logs.
+
+From here you can see and sort by the following:
+
+* Timestamp
+* Log type
+* Message
+
+In the Systems table, you can click on the **Timestamp** and **Log type** items to set them as your filters. In the **Message** column, you can also click on an item to show more information about the message.
+
+:ref:`Back to Viewing Logs`
+
+.. _log_lines:
+
+Viewing All Log Lines
+----------
+The **LOG LINES** tab is used for viewing the total amount of log lines in a table. From here users can view a more granular breakdown of log information collected by Studio. The other tabs (QUERIES, SESSIONS, and SYSTEM) show a filtered form of the raw log lines. For example, the QUERIES tab shows an aggregation of several log lines.
+
+From here you can see and sort by the following:
+
+* Timestamp
+* Message level
+* Worker hostname
+* Worker port
+* Connection ID
+* Database name
+* User name
+* Statement ID
+
+In the **LOG LINES** table, you can click on any of the items to set them as your filters.
+
+:ref:`Back to Viewing Logs`
+
+:ref:`Back to Editor`
+
+.. _roles:
+
+Creating, Assigning, and Managing Roles and Permissions
+============
+Overview
+---------------
+In the **Roles** area you can create and assign roles and manage user permissions. 
+
+The **Type** column displays one of the following assigned role types:
+
+.. list-table::
+   :widths: 15 75
+   :header-rows: 1   
+   
+   * - Role Type
+     - Description
+   * - Groups
+     - Roles with no users.
+   * - Enabled users
+     - Users with log-in permissions and a password.
+   * - Disabled users
+     - Users with log-in permissions and with a disabled password. An admin may disable a user's password permissions to temporary disable access to the system.
+
+.. note:: If you disable a password, when you enable it you have to create a new one.
+
+
+Viewing Information About a Role
+--------------------
+Clicking a role in the roles table displays the following information:
+
+ * **Parent Roles** - displays the parent roles of the selected role. Roles inherit all roles assigned to the parent.
+ * **Members** - displays all members that the role has been assigned to. The arrow indicates the roles that the role has inherited. Hovering over a member displays the roles that the role is inherited from.
+ * **Permissions** - displays the role's permissions. The arrow indicates the permissions that the role has inherited. Hovering over a permission displays the roles that the permission is inherited from.
+
+Creating a New Role
+--------------------
+You can create a new role by clicking **New Role**.
+
+.. image:: /_static/images/role_button.png
+   
+An admin creates a **user** by granting login permissions and a password to a role. Each role is defined by a set of permissions. An admin can also group several roles together to form a **group** to manage them simultaneously. For example, permissions can be granted to or revoked on a group level.
+
+Clicking **New Role** lets you do the following:
+
+ * Add and assign a role name (required)
+ * Enable or disable log-in permissions for the role.
+ * Set a password.
+ * Assign or delete parent roles.
+ * Add or delete permissions.
+ * Grant the selected user with superuser permissions.
+ 
+From the New Role panel you view directly and indirectly (or inherited) granted permissions. Disabled permissions have no connect permissions for the referenced database and are displayed in gray text. You can add or remove permissions from the **Add permissions** field. From the New Role panel you can also search and scroll through the permissions. In the **Search** field you can use the **and** operator to search for strings that fulfill multiple criteria.
+
+When adding a new role, you must select the **Enable login for this role** and **Has password** check boxes.
+
+Editing a Role
+--------------------
+Once you've created a role, clicking the **Edit Role** button lets you do the following:
+
+ * Edit the role name.
+ * Enable or disable log-in permissions.
+ * Set a password.
+ * Assign or delete parent roles.
+ * Assign a role **administrator** permissions.
+ * Add or delete permissions.
+ * Grant the selected user with superuser permissions.
+
+From the Edit Role panel you view directly and indirectly (or inherited) granted permissions. Disabled permissions have no connect permissions for the referenced database and are displayed in gray text. You can add or remove permissions from the **Add permissions** field. From the Edit Role panel you can also search and scroll through the permissions. In the **Search** field you can use the **and** operator to search for strings that fulfill multiple criteria.
+
+Deleting a Role
+-----------------
+Clicking the **delete** icon displays a confirmation message with the amount of users and groups that will be impacted by deleting the role.

From d002f318c28dd2ace824bd21d26618768cfe4044 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Sun, 31 Jul 2022 15:54:01 +0300
Subject: [PATCH 178/882] Removed password policy

---
 operational_guides/access_control.rst         |  1 -
 .../access_control_password_policy.rst        | 42 -------------------
 2 files changed, 43 deletions(-)
 delete mode 100644 operational_guides/access_control_password_policy.rst

diff --git a/operational_guides/access_control.rst b/operational_guides/access_control.rst
index bd25d0d99..88a14d71b 100644
--- a/operational_guides/access_control.rst
+++ b/operational_guides/access_control.rst
@@ -11,5 +11,4 @@ Access Control
    access_control_overview
    access_control_managing_roles
    access_control_permissions
-   access_control_password_policy   
    access_control_departmental_example
\ No newline at end of file
diff --git a/operational_guides/access_control_password_policy.rst b/operational_guides/access_control_password_policy.rst
deleted file mode 100644
index 10a4f697f..000000000
--- a/operational_guides/access_control_password_policy.rst
+++ /dev/null
@@ -1,42 +0,0 @@
-.. _access_control_password_policy:
-
-**************
-Password Policy
-**************
-As part of our compliance with GDPR standards SQream relies on a strong password policy when accessing the CLI or Studio, with the following requirements:
-
-* At least eight characters long.
-
-   ::
-
-* Mandatory upper and lowercase letters.
-
-   ::
-
-* At least one numeric character.
-
-   ::
-
-* May not include a username.
-
-   ::
-
-* Must include at least one special character, such as **?**, **!**, **$**, etc.
-
-You can create a password through the Studio graphic interface or through the CLI, as in the following example command:
-
-.. code-block:: console
-
-   CREATE ROLE user_a ;
-   GRANT LOGIN to user_a ;
-   GRANT PASSWORD 'BBAu47?fqPL' to user_a ;
-
-Creating a password that does not comply with the above requirements generates an error message with a request to modify it.
-
-Unsuccessfully attempting to log in three times displays the following message:
-
-.. code-block:: console
-
-   The user is locked. please contact your system administrator to reset the password and regain access functionality.
-
-For more information, see :ref:`login_max_retries`.

From 0dcf869e40e8545f6e745ae29cd29298f41f2629 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Sun, 31 Jul 2022 17:40:00 +0300
Subject: [PATCH 179/882] Links

---
 releases/2020.3.rst      | 14 +++++---------
 releases/2021.1.2.rst    |  4 ++--
 releases/2021.1.rst      | 14 +++++++-------
 releases/2021.2.1.24.rst | 12 ++++++------
 releases/2021.2.1.rst    |  8 ++++----
 5 files changed, 24 insertions(+), 28 deletions(-)

diff --git a/releases/2020.3.rst b/releases/2020.3.rst
index b51a9955d..eb8ca8f62 100644
--- a/releases/2020.3.rst
+++ b/releases/2020.3.rst
@@ -26,9 +26,12 @@ The following list describes the new features:
 
 * ``TEXT`` is ramping up with new features (previously only available with VARCHARs):
 
-    * :ref:`substring`, :ref:`lower`, :ref:`ltrim`, :ref:`charindex`, :ref:`replace`, etc.
+    * `SUBSTRING `_ 
+    * `LTRIM `_ 
+    * `CHARINDEX `_
+    * `REPLACE `_ 
 
-    * Binary operators - :ref:`concat`, :ref:`like`, etc.
+    * Binary operators - `CONCAT `_ , `REPLACE `_ , etc.
 
     * Casts to and from ``TEXT``
 
@@ -100,10 +103,3 @@ Upgrading to v2020.3
 Versions are available for IBM POWER9, RedHat (CentOS) 7, Ubuntu 18.04, and other OSs via Docker.
 
 Contact your account manager to get the latest release of SQream.
-
-.. toctree::
-   :maxdepth: 2
-   :glob:
-   :hidden:
-
-   2020.3
diff --git a/releases/2021.1.2.rst b/releases/2021.1.2.rst
index 5ccd878d8..e163c987d 100644
--- a/releases/2021.1.2.rst
+++ b/releases/2021.1.2.rst
@@ -48,9 +48,9 @@ SQream now interprets literals containing decimal points as ``numeric`` instead
 
 For more information, see `Data Types `_.
 
-Roles Area Added to Studio Version 5.3.3
+Roles Area Added to Studio Version 5.4.3
 ****************
-The **Roles** area has been added to `Studio version 5.3.3 `_. From the Roles area users can create and assign roles and manage user permissions.
+The **Roles** area has been added to `Studio version 5.3.3 `_. From the Roles area users can create and assign roles and manage user permissions.
 
 Resolved Issues
 -------------
diff --git a/releases/2021.1.rst b/releases/2021.1.rst
index 15824d5d5..389655262 100644
--- a/releases/2021.1.rst
+++ b/releases/2021.1.rst
@@ -40,7 +40,7 @@ SQream now supports Numeric Data types for the following operations:
    * All aggregation types (not including Window functions).
    * Scalar functions (not including some trigonometric and logarithmic functions).
    
-For more information, see `Numeric Data Types `_.
+For more information, see `Numeric Data Types `_.
 
 Text Data Type
 ************
@@ -54,14 +54,14 @@ SQream now supports TEXT data types in all operations, which is default string d
    * Support text columns in queries with multiple distinct aggregates.
    * Text literal support for all functions.
    
-For more information, see `String Types `_.
+For more information, see `String Types `_.
 
 
 Supports Scalar Subqueries
 ************
 SQream now supports running initial scalar subqueries.
 
-For more information, see `Subqueries `_.
+For more information, see `Subqueries `_.
 
 Literal Arguments
 ************
@@ -72,7 +72,7 @@ Simple Scalar SQL UDFs
 ************
 SQream now supports simple scalar SQL UDF's.
 
-For more information, see `Simple Scalar SQL UDF’s `_.
+For more information, see `Simple Scalar SQL UDF’s `_.
 
 Logging Enhancements
 ************
@@ -91,7 +91,7 @@ Improved Presented License Information
 ************
 SQream now displays information related to data size limitations, expiration date, type of license shown by the new UF. The **Utility Function (UF)** name is ``get_license_info()``.
 
-For more information, see `GET_LICENSE_INFO `_.
+For more information, see `GET_LICENSE_INFO `_.
 
 
   
@@ -171,7 +171,7 @@ Operations and Configuration Changes
 Recommended SQream Configuration on Cloud
 ************
 
-For more information about AWS, see `Amazon S3 `_.
+For more information about AWS, see `Amazon S3 `_.
 
 
 
@@ -183,7 +183,7 @@ SQream now has a new ``runtimeGlobalFlags`` flag called ``WriteToFileThreads``.
 
 This flag configures the number of threads in the **WriteToFile** function. The default value is ``16``.
 
-For more information about the ``runtimeGlobalFlags`` flag, see the **Runtime Global Flags** table in `Configuration `_.
+For more information about the ``runtimeGlobalFlags`` flag, see the **Runtime Global Flags** table in `Configuration `_.
 
 
 
diff --git a/releases/2021.2.1.24.rst b/releases/2021.2.1.24.rst
index f92cfda00..1d5407d89 100644
--- a/releases/2021.2.1.24.rst
+++ b/releases/2021.2.1.24.rst
@@ -15,7 +15,7 @@ The 2021.2.1.24 Release Notes includes a query maintenance feature.
 
 New Features
 ----------
-The 2021.2.1.24 Release Notes include the following new features:
+The 2021.2.1.24 Release Notes include the following new features: 
 
 .. contents:: 
    :local:
@@ -25,7 +25,7 @@ Query Healer
 ************
 The new **Query Healer** feature periodically examines the progress of running statements, and is used for query maintenance.
 
-For more information, see `Query Healer `_.
+For more information, see `Query Healer `_.
 
 Known Issues
 ---------
@@ -53,9 +53,9 @@ Resolved Issues
 ---------
 The Resolved Issues section is not relevant for Version 2021.2.1.24.
 
-Operations and Configuration Changes
---------
-No relevant operations and configuration changes were made.
+Operational and Configuration Changes
+-------
+No relevant operational or configuration changes were made.
 
 Naming Changes
 -------
@@ -74,4 +74,4 @@ The End of Support section is not relevant to Version 2021.2.1.24.
    :glob:
    :hidden:
 
-   2021.2.1.24
+   2021.2.1.24
\ No newline at end of file
diff --git a/releases/2021.2.1.rst b/releases/2021.2.1.rst
index c7e1dbada..c476bd2d5 100644
--- a/releases/2021.2.1.rst
+++ b/releases/2021.2.1.rst
@@ -21,7 +21,7 @@ CREATE TABLE
 ************
 SQream now supports duplicating the column structure of an existing table using the ``LIKE`` clause.
 
-For more information, see `Duplicating the Column Structure of an Existing Table `_.
+For more information, see `Duplicating the Column Structure of an Existing Table `_.
 
 PERCENTILE FUNCTIONS
 ************
@@ -35,15 +35,15 @@ REGEX REPLACE
 ************   
 SQream now supports the ``REGEXP_REPLACE`` function for finding and replacing text column substrings.
 
-For more information, see :ref:`regexp_replace`.
+For more information, see `REGEX_REPLACE `_.
 
 Delete Optimization
 ************
 The ``DELETE`` statement can now delete values that contain multi-table conditions.
 
-For more information, see `Deleting Values that Contain Multi-Table Conditions `_.
+For more information, see `Deleting Values that Contain Multi-Table Conditions `_.
 
-For more information, see :ref:`regexp_replace`.
+For more information, see `REGEX_REPLACE `_.
 
 Performance Enhancements
 ------

From 4c79df05607c298193c873538bc82c089cb4726b Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Sun, 31 Jul 2022 18:35:05 +0300
Subject: [PATCH 180/882] Links

---
 releases/2021.2.1.rst | 10 +++++-----
 releases/2021.2.rst   |  8 ++------
 2 files changed, 7 insertions(+), 11 deletions(-)

diff --git a/releases/2021.2.1.rst b/releases/2021.2.1.rst
index c476bd2d5..2988d98f6 100644
--- a/releases/2021.2.1.rst
+++ b/releases/2021.2.1.rst
@@ -27,15 +27,15 @@ PERCENTILE FUNCTIONS
 ************
 SQream now supports the following aggregation functions:
 
-* :ref:`percentile_cont`
-* :ref:`percentile_disc`
-* :ref:`mode`
+* `PERCENTILE_CONT `_
+* `PERCENTILE_DISC `_
+* `MODE `_
 
 REGEX REPLACE
 ************   
 SQream now supports the ``REGEXP_REPLACE`` function for finding and replacing text column substrings.
 
-For more information, see `REGEX_REPLACE `_.
+For more information, see `REGEX_REPLACE `_.
 
 Delete Optimization
 ************
@@ -43,7 +43,7 @@ The ``DELETE`` statement can now delete values that contain multi-table conditio
 
 For more information, see `Deleting Values that Contain Multi-Table Conditions `_.
 
-For more information, see `REGEX_REPLACE `_.
+For more information, see `REGEX_REPLACE `_.
 
 Performance Enhancements
 ------
diff --git a/releases/2021.2.rst b/releases/2021.2.rst
index cce1675dc..a46762f01 100644
--- a/releases/2021.2.rst
+++ b/releases/2021.2.rst
@@ -34,17 +34,13 @@ SQream now uses a new configuration system based on centralized configuration ac
 For more information, see the following:
 
 * `Configuration `_ - describes how to configure your instance of SQream from a centralized location.
-* `SQream Studio 5.4.2 `_ - configure your instance of SQream from Studio.
+* `SQream Studio 5.4.3 `_ - configure your instance of SQream from Studio.
    
 Qualifying Schemas Without Providing an Alias
 ************
 When running queries, SQream now supports qualifying schemas without providing an alias.
 
-For more information, see :ref:`create_schema`.
-
-
-
-
+For more information, see `SQream Studio 5.4.3 `_.
 
 Double-Quotations Supported When Importing and Exporting CSVs
 ************

From 82abd5b5a6d0243f88e149a1f30d00483dd15990 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Sun, 31 Jul 2022 18:46:32 +0300
Subject: [PATCH 181/882] Links

---
 releases/2021.1.2.rst |  2 +-
 releases/2021.2.1.rst | 10 +++++-----
 releases/2021.2.rst   | 15 ++++++++-------
 3 files changed, 14 insertions(+), 13 deletions(-)

diff --git a/releases/2021.1.2.rst b/releases/2021.1.2.rst
index e163c987d..8945a0261 100644
--- a/releases/2021.1.2.rst
+++ b/releases/2021.1.2.rst
@@ -50,7 +50,7 @@ For more information, see `Data Types `_. From the Roles area users can create and assign roles and manage user permissions.
+The **Roles** area has been added to `Studio version 5.4.3 `_. From the Roles area users can create and assign roles and manage user permissions.
 
 Resolved Issues
 -------------
diff --git a/releases/2021.2.1.rst b/releases/2021.2.1.rst
index 2988d98f6..e1a01a147 100644
--- a/releases/2021.2.1.rst
+++ b/releases/2021.2.1.rst
@@ -27,15 +27,15 @@ PERCENTILE FUNCTIONS
 ************
 SQream now supports the following aggregation functions:
 
-* `PERCENTILE_CONT `_
-* `PERCENTILE_DISC `_
-* `MODE `_
+* `PERCENTILE_CONT `_
+* `PERCENTILE_DISC `_
+* `MODE `_
 
 REGEX REPLACE
 ************   
 SQream now supports the ``REGEXP_REPLACE`` function for finding and replacing text column substrings.
 
-For more information, see `REGEX_REPLACE `_.
+For more information, see `REGEX_REPLACE `_.
 
 Delete Optimization
 ************
@@ -43,7 +43,7 @@ The ``DELETE`` statement can now delete values that contain multi-table conditio
 
 For more information, see `Deleting Values that Contain Multi-Table Conditions `_.
 
-For more information, see `REGEX_REPLACE `_.
+For more information, see `REGEX_REPLACE `_.
 
 Performance Enhancements
 ------
diff --git a/releases/2021.2.rst b/releases/2021.2.rst
index a46762f01..800b8c863 100644
--- a/releases/2021.2.rst
+++ b/releases/2021.2.rst
@@ -34,13 +34,13 @@ SQream now uses a new configuration system based on centralized configuration ac
 For more information, see the following:
 
 * `Configuration `_ - describes how to configure your instance of SQream from a centralized location.
-* `SQream Studio 5.4.3 `_ - configure your instance of SQream from Studio.
+* `SQream Studio 5.4.3 `_ - configure your instance of SQream from Studio.
    
 Qualifying Schemas Without Providing an Alias
 ************
 When running queries, SQream now supports qualifying schemas without providing an alias.
 
-For more information, see `SQream Studio 5.4.3 `_.
+For more information, see `SQream Studio 5.4.3 `_.
 
 Double-Quotations Supported When Importing and Exporting CSVs
 ************
@@ -48,9 +48,10 @@ When importing and exporting CSVs, SQream now supports using quotation character
 
 For more information, see the following:
 
-* :ref:`copy_from`
+* `COPY_FROM `_
+
+* `COPY_TO `_
 
-* :ref:`copy_to`
 
 
 Note the following:
@@ -128,7 +129,7 @@ NVARCHAR Data Type Renamed TEXT
 The ``NVARCHAR`` data type has been renamed ``TEXT``.
 
 
-For more information on the ``TEXT`` data type, see `String (TEXT) `_
+For more information on the ``TEXT`` data type, see `String (TEXT) `_
 
 End of Support
 ------
@@ -159,13 +160,13 @@ For more information on upgrading your SQream version, see `Upgrading SQream Ver
 
 Upgrading Your Client Drivers
 ************
-For more information on the client drivers for version 2021.2, see `Client Drivers for 2021.2 `_.
+For more information on the client drivers for version 2021.2, see `Client Drivers for 2021.2 `_.
 
 Configuring Your Instance of SQream
 ************
 A new configuration method is used starting with Version 2021.2.
 
-For more information about configuring your instance of SQream, see :ref:`configuration`.
+For more information about configuring your instance of SQream, see `Client Drivers for 2021.2 `_.
 
 .. toctree::
    :maxdepth: 2

From f72cf319f80d4b3a2aa1b03000eeeac4e25c0ce7 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Sun, 31 Jul 2022 19:12:27 +0300
Subject: [PATCH 182/882] Fixed link

---
 releases/2021.1.2.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/releases/2021.1.2.rst b/releases/2021.1.2.rst
index 8945a0261..750420260 100644
--- a/releases/2021.1.2.rst
+++ b/releases/2021.1.2.rst
@@ -40,7 +40,7 @@ String Literals Containing ASCII Characters Interepreted as TEXT
 ************
 SQream now interprets all string literals, including those containing ASCII characters, as ``text``.
 
-For more information, see `String Types `_.
+For more information, see `String Types `_.
 
 Decimal Literals Interpreted as Numeric Columns
 ************

From c6cb8164225ddfd101bd43aa787965bf9e72ee54 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Mon, 1 Aug 2022 12:09:01 +0300
Subject: [PATCH 183/882] Corrected driver links

---
 connecting_to_sqream/client_drivers/index.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst
index 79d1fd176..b230faaef 100644
--- a/connecting_to_sqream/client_drivers/index.rst
+++ b/connecting_to_sqream/client_drivers/index.rst
@@ -18,14 +18,14 @@ The following are applicable to all operating systems:
 * **JDBC** - recommended installation via ``mvn``:
 
   * `JDBC .jar file `_ - sqream-jdbc-4.5.3 (.jar)
-  * `JDBC driver `_
+  * `JDBC driver `_
 
 .. _tableau_connector:   
 
 * **Tableau**:
 
   * `Tableau connector `_ - SQream (.taco)
-  * `Tableau manual installation `_
+  * `Tableau manual installation `_
 
   
 .. _powerbi_connector:   
@@ -33,7 +33,7 @@ The following are applicable to all operating systems:
 * **Power BI**:
 
   * `Power BI PowerQuery connector `_ - SQream (.mez)
-  * `Power BI manual installation `_
+  * `Power BI manual installation `_
 
 
 Windows
@@ -53,12 +53,12 @@ Linux
 The following are applicable to Linux:
 
 * `SQream SQL (x86_64) `_ - sqream-sql-v2020.1.1_stable.x86_64.tar.gz
-* `Sqream SQL CLI Reference `_ - Interactive command-line SQL client for Intel-based machines
+* `Sqream SQL CLI Reference `_ - Interactive command-line SQL client for Intel-based machines
 
    ::
 
 * `SQream SQL*(IBM POWER9) `_ - sqream-sql-v2020.1.1_stable.ppc64le.tar.gz
-* `Sqream SQL CLI Reference `_ - Interactive command-line SQL client for IBM POWER9-based machines
+* `Sqream SQL CLI Reference `_ - Interactive command-line SQL client for IBM POWER9-based machines
    
    ::
 

From edcf3ce813e7ce9b41a52782397006848cf93f3e Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Mon, 1 Aug 2022 13:35:35 +0300
Subject: [PATCH 184/882] corrected links

---
 releases/2021.2.rst | 5 ++++-
 releases/2022.1.rst | 2 +-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/releases/2021.2.rst b/releases/2021.2.rst
index 800b8c863..c4174a3aa 100644
--- a/releases/2021.2.rst
+++ b/releases/2021.2.rst
@@ -89,7 +89,10 @@ Note the following:
 For more information, see the following statements:
 
 
-* :ref:`copy_from`
+* `COPY_FROM `_
+
+* `CREATE_FOREIGN_TABLE `_
+
 
 * :ref:`create_foreign_table`
 
diff --git a/releases/2022.1.rst b/releases/2022.1.rst
index 085108a43..3d1517371 100644
--- a/releases/2022.1.rst
+++ b/releases/2022.1.rst
@@ -31,7 +31,7 @@ SQream now supports data encryption mechanisms in accordance with **General Data
 
 Using the data encryption feature may lead to a maximum of a 10% increase in performance degradation.
 
-For more information, see `Data Encryption `_.
+For more information, see `Data Encryption `_.
 
 Update Feature
 ************

From 2f95101378fdcf6f73f57e738f699a96ef8759dd Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Mon, 1 Aug 2022 19:03:59 +0300
Subject: [PATCH 185/882] Added External Storage Platforms

---
 .../hdfs.rst                                  |  0
 external_storage_platforms/index.rst          | 25 +++++++++++++++++++
 .../s3.rst                                    |  0
 index.rst                                     |  1 +
 operational_guides/external_data.rst          | 25 -------------------
 operational_guides/index.rst                  |  1 -
 6 files changed, 26 insertions(+), 26 deletions(-)
 rename {operational_guides => external_storage_platforms}/hdfs.rst (100%)
 create mode 100644 external_storage_platforms/index.rst
 rename {operational_guides => external_storage_platforms}/s3.rst (100%)
 delete mode 100644 operational_guides/external_data.rst

diff --git a/operational_guides/hdfs.rst b/external_storage_platforms/hdfs.rst
similarity index 100%
rename from operational_guides/hdfs.rst
rename to external_storage_platforms/hdfs.rst
diff --git a/external_storage_platforms/index.rst b/external_storage_platforms/index.rst
new file mode 100644
index 000000000..92c35ee63
--- /dev/null
+++ b/external_storage_platforms/index.rst
@@ -0,0 +1,25 @@
+.. _external_storage_platforms:
+
+***********************
+External Storage Platforms
+***********************
+SQream supports the following external storage platforms:
+
+.. toctree::
+   :maxdepth: 1
+   :titlesonly:
+
+   s3
+   hdfs
+   
+For more information, see the following:
+
+* :ref:`foreign_tables`
+
+   ::
+   
+* :ref:`copy_from`
+
+   ::
+   
+* :ref:`copy_to`
diff --git a/operational_guides/s3.rst b/external_storage_platforms/s3.rst
similarity index 100%
rename from operational_guides/s3.rst
rename to external_storage_platforms/s3.rst
diff --git a/index.rst b/index.rst
index bc5c25c2c..0f418c2fb 100644
--- a/index.rst
+++ b/index.rst
@@ -100,6 +100,7 @@ If you're looking for an older version of the documentation, versions 1.10 throu
    installation_guides/index
    data_ingestion/index
    connecting_to_sqream/index
+   external_storage_platforms/index
    loading_and_unloading_data/index
    feature_guides/index
    operational_guides/index
diff --git a/operational_guides/external_data.rst b/operational_guides/external_data.rst
deleted file mode 100644
index 8bf51f108..000000000
--- a/operational_guides/external_data.rst
+++ /dev/null
@@ -1,25 +0,0 @@
-.. _external_data:
-
-**********************************
-Working with External Data
-**********************************
-SQream supports the following external data sources:
-
-.. toctree::
-   :maxdepth: 1
-   :titlesonly:
-
-   s3
-   hdfs
-   
-For more information, see the following:
-
-* :ref:`external_tables`
-
-   ::
-   
-* :ref:`copy_from`
-
-   ::
-   
-* :ref:`copy_to`
\ No newline at end of file
diff --git a/operational_guides/index.rst b/operational_guides/index.rst
index 9deb0835c..25e2cdff2 100644
--- a/operational_guides/index.rst
+++ b/operational_guides/index.rst
@@ -14,7 +14,6 @@ This section summarizes the following operational guides:
 
    access_control
    creating_or_cloning_a_storage_cluster
-   external_data
    foreign_tables
    delete_guide
    exporting_data

From 637d7f74b1c40e4624bced96b28af440c7f1bff5 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Tue, 2 Aug 2022 11:10:27 +0300
Subject: [PATCH 186/882] Fixed links.

---
 releases/2021.2.rst | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/releases/2021.2.rst b/releases/2021.2.rst
index c4174a3aa..2140dc6be 100644
--- a/releases/2021.2.rst
+++ b/releases/2021.2.rst
@@ -91,10 +91,7 @@ For more information, see the following statements:
 
 * `COPY_FROM `_
 
-* `CREATE_FOREIGN_TABLE `_
-
-
-* :ref:`create_foreign_table`
+* `CREATE_FOREIGN_TABLE `_
 
 Performance Enhancements
 ------
@@ -159,7 +156,7 @@ When upgrading from a SQream version earlier than 2021.2 you must upgrade your s
       $ cat /etc/sqream/sqream1_config.json |grep cluster
       $ ./upgrade_storage 
 	  
-For more information on upgrading your SQream version, see `Upgrading SQream Version `_.
+For more information on upgrading your SQream version, see `Upgrading SQream Version `_.
 
 Upgrading Your Client Drivers
 ************

From b65ab1f10b30ddfa0ab646a9704da87ddd4cabe0 Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Tue, 2 Aug 2022 12:17:56 +0300
Subject: [PATCH 187/882] Reinstated Healer configuration flags

Removed login max retries flag (it's for 2022.1.1).
---
 configuration_guides/admin_worker_flags.rst        |  3 ++-
 .../healer_max_inactivity_hours.rst                | 14 ++++++++++++++
 configuration_guides/is_healer_on.rst              | 14 ++++++++++++++
 feature_guides/query_healer.rst                    | 12 +++++++++++-
 4 files changed, 41 insertions(+), 2 deletions(-)
 create mode 100644 configuration_guides/healer_max_inactivity_hours.rst
 create mode 100644 configuration_guides/is_healer_on.rst

diff --git a/configuration_guides/admin_worker_flags.rst b/configuration_guides/admin_worker_flags.rst
index 6be021d70..d58dad687 100644
--- a/configuration_guides/admin_worker_flags.rst
+++ b/configuration_guides/admin_worker_flags.rst
@@ -9,4 +9,5 @@ The **Worker Administration Flags** page describes **Worker** modification type
 * `Enabling Manually Setting Reported IP `_
 * `Setting Port Used for Metadata Server Connection `_
 * `Assigning Local Network IP `_
-* `Adjusting Permitted Log-in Attempts `_
\ No newline at end of file
+* `Enabling the Query Healer `_
+* `Configuring the Query Healer `_
\ No newline at end of file
diff --git a/configuration_guides/healer_max_inactivity_hours.rst b/configuration_guides/healer_max_inactivity_hours.rst
new file mode 100644
index 000000000..d05d46014
--- /dev/null
+++ b/configuration_guides/healer_max_inactivity_hours.rst
@@ -0,0 +1,14 @@
+.. _healer_max_inactivity_hours:
+
+*************************
+Query Healer
+*************************
+The ``healerMaxInactivityHours`` flag is used for defining the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU.
+
+The following describes the ``healerMaxInactivityHours`` flag:
+
+* **Data type** - size_t
+* **Default value** - ``5``
+* **Allowed values** - 1-4000000000
+
+For related flags, see :ref:`is_healer_on`.
\ No newline at end of file
diff --git a/configuration_guides/is_healer_on.rst b/configuration_guides/is_healer_on.rst
new file mode 100644
index 000000000..8b90654ec
--- /dev/null
+++ b/configuration_guides/is_healer_on.rst
@@ -0,0 +1,14 @@
+.. _is_healer_on:
+
+*************************
+Enabling the Query Healer
+*************************
+The ``is_healer_on`` flag enables the Query Healer, which periodically examines the progress of running statements and logs statements exceeding the ``healerMaxInactivityHours`` flag setting.
+
+The following describes the ``is_healer_on`` flag:
+
+* **Data type** - boolean
+* **Default value** - ``true``
+* **Allowed values** - ``true``, ``false``
+
+For related flags, see :ref:`healer_max_inactivity_hours`.
\ No newline at end of file
diff --git a/feature_guides/query_healer.rst b/feature_guides/query_healer.rst
index 667a91ed8..8f0b56d08 100644
--- a/feature_guides/query_healer.rst
+++ b/feature_guides/query_healer.rst
@@ -19,6 +19,16 @@ The following is an example of a log record for a query stuck in the query detec
 
    2022/05/19::20:01:25|ERROR|Healer|(0x7f07147fc700)|Stuck query found. Statement ID: 72, Last chunk producer updated: 1 WriteTable, Started on: Thu May 19 14:01:25 2022, Last updated: Thu May 19 15:01:25 2022, Stuck time: 5 hours, Max allowed stuck query time: 5 hours
 
+The ``healerMaxInactivityHours`` log frequency is calculated as 5% of the flag setting. When set to to five hours (the default setting), the Query Healer triggers an examination every 15 minutes.
+
 Configuring the Healer
 ------------------
-The **healerMaxInactivityHours** is required define the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU. The ``healerMaxInactivityHours`` log frequency is calculated as 5% of the flag setting. For example, setting ``healerMaxInactivityHours`` to five hours (the default setting) triggers an examination every 15 minutes.
\ No newline at end of file
+The following **Administration Worker** flags are required to configure the Query Healer:
+
+ * :ref:`is_healer_on` - Enables the Query Healer.
+
+    ::
+
+ * :ref:`healer_max_inactivity_hours` - Defines the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU.
+
+The ``healerMaxInactivityHours`` log frequency is calculated as 5% of the flag setting. For example, setting ``healerMaxInactivityHours`` to five hours (the default setting) triggers an examination every 15 minutes.
\ No newline at end of file

From 307fba9a817b840cbc901500db43da96f6fe4897 Mon Sep 17 00:00:00 2001
From: YanivGerowitz <82020437+YanivGerowitz@users.noreply.github.com>
Date: Tue, 2 Aug 2022 15:24:32 +0300
Subject: [PATCH 188/882] Update data_encryption_syntax.rst

---
 feature_guides/data_encryption_syntax.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/feature_guides/data_encryption_syntax.rst b/feature_guides/data_encryption_syntax.rst
index 3370698cf..65f03ab5e 100644
--- a/feature_guides/data_encryption_syntax.rst
+++ b/feature_guides/data_encryption_syntax.rst
@@ -23,5 +23,3 @@ The following is an example of encrypting a new table:
         salary INT(6) ENCRYPT);
 		   
 .. note::  Users without permissions cannot view the entire table as long as at least one column is encrypted. The (unique) encryption/decryption key is relevant only at the system level and is not held by users.
-
-Note that the master key is hard-coded in the system and cannot be changed.

From ed492d74ac4aa33abbe63b6b38ead278fe7e34fc Mon Sep 17 00:00:00 2001
From: Yaniv Gerowitz 
Date: Tue, 2 Aug 2022 16:34:18 +0300
Subject: [PATCH 189/882] Created and populated 2022.1.1 - NOT PUBLISHED

---
 _static/images/new_2022.1.1.png               | Bin 0 -> 3259 bytes
 _static/images/new_dark_gray_2022.1.1.png     | Bin 0 -> 2867 bytes
 _static/images/new_gray_2022.1.1.png          | Bin 0 -> 3842 bytes
 configuration_guides/admin_worker_flags.rst   |  19 ++-
 configuration_guides/login_max_retries.rst    |   7 +-
 feature_guides/compression.rst                |   8 +
 operational_guides/access_control.rst         |   1 +
 .../access_control_password_policy.rst        |  63 ++++++++
 .../sql_statements/dml_commands/update.rst    | 149 +++++++++++++++++-
 releases/2022.1.1.rst                         | 136 ++++++++++++++++
 releases/2022.1_index.rst                     |   1 +
 releases/index.rst                            |   2 +-
 12 files changed, 373 insertions(+), 13 deletions(-)
 create mode 100644 _static/images/new_2022.1.1.png
 create mode 100644 _static/images/new_dark_gray_2022.1.1.png
 create mode 100644 _static/images/new_gray_2022.1.1.png
 create mode 100644 operational_guides/access_control_password_policy.rst
 create mode 100644 releases/2022.1.1.rst

diff --git a/_static/images/new_2022.1.1.png b/_static/images/new_2022.1.1.png
new file mode 100644
index 0000000000000000000000000000000000000000..2ffb80039be7a7a4ac7605f8271045e4d0138185
GIT binary patch
literal 3259
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
Ef=gpok^lez

literal 0
HcmV?d00001

diff --git a/configuration_guides/admin_worker_flags.rst b/configuration_guides/admin_worker_flags.rst
index d58dad687..edbc71465 100644
--- a/configuration_guides/admin_worker_flags.rst
+++ b/configuration_guides/admin_worker_flags.rst
@@ -3,11 +3,18 @@
 *************************
 Worker Administration Flags
 *************************
+
+.. |icon-new_gray_2022.1.1| image:: /_static/images/new_gray_2022.1.1.png
+   :align: middle
+   :width: 110
+   
+   
 The **Worker Administration Flags** page describes **Worker** modification type flags, which can be modified by administrators on a session and cluster basis using the ``ALTER SYSTEM SET`` command:
 
-* `Setting Total Device Memory Usage in SQream Instance `_
-* `Enabling Manually Setting Reported IP `_
-* `Setting Port Used for Metadata Server Connection `_
-* `Assigning Local Network IP `_
-* `Enabling the Query Healer `_
-* `Configuring the Query Healer `_
\ No newline at end of file
+* `Setting Total Device Memory Usage in SQream Instance `_
+* `Enabling Manually Setting Reported IP `_
+* `Setting Port Used for Metadata Server Connection `_
+* `Assigning Local Network IP `_
+* `Enabling the Query Healer `_
+* `Configuring the Query Healer `_
+* `Adjusting the Permitted Log-In Attempts `_ |icon-new_gray_2022.1.1|
\ No newline at end of file
diff --git a/configuration_guides/login_max_retries.rst b/configuration_guides/login_max_retries.rst
index bf3ae6d40..af236c9c3 100644
--- a/configuration_guides/login_max_retries.rst
+++ b/configuration_guides/login_max_retries.rst
@@ -3,7 +3,12 @@
 *************************
 Adjusting Permitted Log-in Attempts
 *************************
-The ``loginMaxRetries`` flag sets the permitted log-in attempts.
+
+.. |icon-new_2022.1.1| image:: /_static/images/new_2022.1.1.png
+   :align: middle
+   :width: 110
+   
+The ``loginMaxRetries`` flag |icon-new_2022.1.1| sets the permitted log-in attempts.
 
 The following describes the ``loginMaxRetries`` flag:
 
diff --git a/feature_guides/compression.rst b/feature_guides/compression.rst
index 96c051ff4..ce5e922b6 100644
--- a/feature_guides/compression.rst
+++ b/feature_guides/compression.rst
@@ -4,6 +4,10 @@
 Compression
 ***********************
 
+.. |icon-new_dark_gray_2022.1.1.png| image:: /_static/images/new_dark_gray_2022.1.1.png
+   :align: middle
+   :width: 110
+
 SQream DB uses compression and encoding techniques to optimize query performance and save on disk space.
 
 Encoding
@@ -89,6 +93,10 @@ Compression strategies
      - Integer types
      - Optimized RLE + Delta type for built-in :ref:`identity columns`. 
      - GPU
+   * - ``zlib`` |icon-new_dark_gray_2022.1.1.png|
+     - All types
+     - The **basic_zlib_compressor** and **basic_zlib_decompressor** compress and decompress data in the **ZLIB** format, using **DualUseFilters** for input and output. In general, compression filters are for output, and decompression filters for input.
+     - CPU
 
 .. _specifying_compressions:
 
diff --git a/operational_guides/access_control.rst b/operational_guides/access_control.rst
index 88a14d71b..d5d32394e 100644
--- a/operational_guides/access_control.rst
+++ b/operational_guides/access_control.rst
@@ -11,4 +11,5 @@ Access Control
    access_control_overview
    access_control_managing_roles
    access_control_permissions
+   access_control_password_policy
    access_control_departmental_example
\ No newline at end of file
diff --git a/operational_guides/access_control_password_policy.rst b/operational_guides/access_control_password_policy.rst
new file mode 100644
index 000000000..0a17f833e
--- /dev/null
+++ b/operational_guides/access_control_password_policy.rst
@@ -0,0 +1,63 @@
+.. _access_control_password_policy:
+
+**************
+Password Policy (New!)
+**************
+
+.. |icon-new_gray_2022.1.1| image:: /_static/images/new_gray_2022.1.1.png
+   :align: middle
+   :width: 110
+      
+As part of our compliance with GDPR standards |icon-new_gray_2022.1.1| SQream relies on a strong password policy when accessing the CLI or Studio, with the following requirements:
+
+* At least eight characters long.
+
+   ::
+
+* Mandatory upper and lowercase letters.
+
+   ::
+
+* At least one numeric character.
+
+   ::
+
+* May not include a username.
+
+   ::
+
+* Must include at least one special character, such as **?**, **!**, **$**, etc.
+
+You can create a password through the Studio graphic interface or through the CLI, as in the following example command:
+
+.. code-block:: console
+
+   CREATE ROLE user_a ;
+   GRANT LOGIN to user_a ;
+   GRANT PASSWORD 'BBAu47?fqPL' to user_a ;
+
+Creating a password that does not comply with the above requirements generates the following error message:
+
+.. code-block:: console
+
+   The password you attempt to create does not comply with SQream security requirements. Please follow the requirements below:
+
+   * At least 8 characters long.
+
+   * Must include both upper and lower case letters.
+
+   * Must include at least one numeric character.
+
+   * Must not include your username.
+
+   * Must include at least one “special” character (?, !, $, etc.).
+   
+.. note:: When a new user created in Studio, a message is displayed to help you determine what the constraints are. 
+
+Unsuccessfully attempting to log in three times displays the following message:
+
+.. code-block:: console
+
+   The user is locked. please contact your system administrator to reset the password and regain access functionality.
+
+For more information, see :ref:`login_max_retries`.
\ No newline at end of file
diff --git a/reference/sql/sql_statements/dml_commands/update.rst b/reference/sql/sql_statements/dml_commands/update.rst
index d0f545017..b804d6c37 100644
--- a/reference/sql/sql_statements/dml_commands/update.rst
+++ b/reference/sql/sql_statements/dml_commands/update.rst
@@ -3,9 +3,9 @@
 **********************
 UPDATE
 **********************
-The **UPDATE** statement page  |icon-new_2022.1| describes the following:
+The **UPDATE** statement page describes the following:
 
-.. |icon-new_2022.1| image:: /_static/images/new_2022.1.png
+.. |icon-new_2022.1.1| image:: /_static/images/new_2022.1.1.png
    :align: middle
    :width: 110
 
@@ -35,6 +35,7 @@ The following is the correct syntax for the ``UPDATE`` command:
  
    UPDATE target_table_name [[AS] alias1]
    SET column_name = expression [,...]
+   [FROM additional_table_name [[AS] alias2][,...]]
    [WHERE condition]
   
 The following is the correct syntax for triggering a clean-up:
@@ -60,10 +61,14 @@ The following table describes the ``UPDATE`` parameters:
    * - ``column_name``
      - Specifies the column containing the data to be updated.
    * - ``additional_table_name``
-     - Additional tables used in the WHERE condition for performing complex joins.
+     - Specifies the column containing the data to be updated.
+   * - ``FROM`` |icon-new_2022.1.1|
+     - For making complex joins, specifies additional tables to be used in the WHERE condition. ``FROM`` is similar to the ``FROM`` clause in a ``DELETE`` statement.
    * - ``condition``
      - Specifies the condition for updating the data.
 	 
+.. note:: A single table can appear **both** as a ``DELETE`` target *and* as a ``FROM`` table. This can be useful for deleting data based on self-join conditions. A ``SET`` clause can contain columns from tables specified in a ``FROM`` clause. For example, using the join ``WHERE`` condition updates rows in the target tables with the values of one of the matching rows.
+	 
 .. note:: Similar to a ``DELETE`` statement, an ``UPDATE`` statement may leave some uncleaned data behind, which requires a clean-up operation.
 
 Examples
@@ -74,6 +79,30 @@ The **Examples** section includes the following examples:
    :local:
    :depth: 1
 
+Updating an Entire Table
+-----------------
+The Examples section shows how to modify the value of certain columns in existing rows without creating a table. The examples are based on the following tables:
+
+.. image:: /_static/images/delete_optimization.png
+
+The following methods for updating an entire table generate the same output, and result with the ``bands`` record set to ``NULL``:
+
+.. code-block:: postgres
+
+   UPDATE bands SET records_sold = 0;
+   
+.. code-block:: postgres
+
+   UPDATE bands SET records_sold = 0 WHERE true;
+   
+.. code-block:: postgres
+
+   UPDATE bands SET records_sold = 0 USING countries;
+
+.. code-block:: postgres
+
+   UPDATE bands SET records_sold = 0 USING countries WHERE 1=1;
+   
 Performing Simple Updates
 -----------------
 The following is an example of performing a simple update:
@@ -81,9 +110,102 @@ The following is an example of performing a simple update:
 .. code-block:: postgres
 
    UPDATE bands SET records_sold = records_sold + 1 WHERE name LIKE 'The %';
+   
+Updating Tables that Contain Multi-Table Conditions
+-----------------
+The following shows an example of updating tables that contain multi-table conditions:
 
-Triggering a Clean-Up
+.. code-block:: postgres
+
+   UPDATE bands
+   SET records_sold = records_sold + 1
+   WHERE EXISTS (
+     SELECT 1 FROM countries
+     WHERE countries.id=bands.country_id
+     AND country.name = 'Sweden'
+   );
+   
+Updating Tables that Contain Multi-Table Conditions using the FROM Clause
+-----------------
+The following shows an example of updating tables that contain multi-table conditions using the ``FROM`` clause:
+
+.. code-block:: postgres
+
+   UPDATE bands
+   SET records_sold = records_sold +
+     CASE
+       WHEN c.name = 'Israel' THEN 2
+       ELSE 1
+     END
+   FROM countries c
+
+You can also write the statement above using the FROM clause:
+
+.. code-block:: psql
+
+   UPDATE bands
+   SET records_sold = records_sold + 1
+   FROM countries
+   WHERE countries.id=bands.country_id AND country.name = 'Sweden';
+   
+Updating Tables that Contain Multi-Table Expressions
+-----------------
+The following shows an example of updating tables that contain multi-table expressions:
+
+.. code-block:: postgres
+
+   UPDATE bands
+   SET records_sold = records_sold +
+     CASE
+       WHEN c.name = 'Israel' THEN 2
+       ELSE 1
+     END
+   FROM countries c
+   
+Identifying and Cleaning Up Tables
 ---------------------------------------
+The following section shows examples of each phase required for cleaning up tables:
+
+* :ref:`Listing tables that require clean-up`
+* :ref:`Identifying clean-up predicates`
+* :ref:`Triggering a clean-up`
+
+.. _listing_tables_that_require_cleanup:
+
+Listing Tables that Require Clean-Up
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+The following shows an example of listing tables that require clean-up:
+
+.. code-block:: psql
+   
+   farm=> SELECT t.table_name FROM sqream_catalog.delete_predicates dp
+      JOIN sqream_catalog.tables t
+      ON dp.table_id = t.table_id
+      GROUP BY 1;
+   cool_animals
+   
+   1 row
+
+.. _identifying_cleanup_predicates:
+
+Identifying Clean-Up Predicates
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+The following shows an example of listing the clean-up predicates:
+
+.. code-block:: psql
+
+   farm=> SELECT delete_predicate FROM sqream_catalog.delete_predicates dp
+      JOIN sqream_catalog.tables t
+      ON dp.table_id = t.table_id
+      WHERE t.table_name = 'cool_animals';
+   weight > 1000
+   
+   1 row
+
+.. _triggering_a_cleanup:
+
+Triggering a Clean-Up
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 The following section shows an example of triggering a clean-up:
 
 .. code-block:: psql
@@ -98,10 +220,27 @@ The following is an example of the output generated from the above:
 * **column_id** - 1
 * **extent_ID** - 0
 
+Security and Access Control
+=============
+Executing an ``UPDATE`` statement requires the following:
+
+* Both ``UPDATE`` and ``SELECT`` permissions on the target table.
+
+   ::
+   
+* The ``SELECT`` permission for each additional table referenced in the the statement (either in the ``FROM`` clause or in a ``WHERE`` subquery expression).
+
+For more information, navigate to the **Access Control** page and see `Permissions `_.
+
+file:///C:/Users/Yaniv/sqream_docs/_build/html/operational_guides/access_control_permissions.html
+
 Locking and Concurrency
 =============
 Executing the ``UPDATE`` statement obtains an exclusive ``UPDATE`` lock on the target table.
 
 Permissions
 =============
-Executing an ``UPDATE`` statement requires both ``UPDATE`` and ``SELECT`` permissions on the target table.
\ No newline at end of file
+Executing an ``UPDATE`` statement requires the following permissions:
+
+* Both ``UPDATE`` and ``SELECT`` permissions on the target table.
+* The ``SELECT`` permission for each additional table you reference in the statement (in ither the ``FROM`` clause or ``WHERE`` subquery section).
\ No newline at end of file
diff --git a/releases/2022.1.1.rst b/releases/2022.1.1.rst
new file mode 100644
index 000000000..15fcd8c42
--- /dev/null
+++ b/releases/2022.1.1.rst
@@ -0,0 +1,136 @@
+.. _2022.1.1:
+
+**************************
+Release Notes 2022.1.1
+**************************
+The 2022.1.1 release notes were released on 7/19/2022 and describe the following:
+
+.. contents:: 
+   :local:
+   :depth: 1      
+
+Version Content
+----------
+The 2022.1.1 Release Notes describes the following: 
+
+* Enhanced security features.
+* New data manipulation command.
+* Additional data ingestion format.
+
+New Features
+----------
+The 2022.1.1 Release Notes include the following new features:
+
+.. contents:: 
+   :local:
+   :depth: 1
+   
+Update Feature
+************
+SQream now supports the DML **Update** feature, which is used for modifying the value of certain columns in existing rows.
+
+For more information, see `UPDATE `_.
+
+file:///C:/Users/Yaniv/sqream_docs/_build/html/reference/sql/sql_statements/dml_commands/update.html?highlight=update
+
+Password Policy
+************
+In compliance with GDPR standards, SQream now requires a strong password policy when accessing the CLI or Studio.
+
+For more information, see `Password Policy `_.
+
+file:///C:/Users/Yaniv/sqream_docs/_build/html/operational_guides/access_control_password_policy.html?highlight=password%20policy
+
+Compression
+************
+
+SQream now supports the **zlib** compression format.
+
+For more information, see `Compression `_. 
+
+file:///C:/Users/Yaniv/sqream_docs/_build/html/feature_guides/compression.html#compression-strategies
+
+Known Issues
+---------
+The following table lists the known issues for Version 2022.1.1:
+
++-------------+------------------------------------------------------------------------------------------------+
+| **SQ No.**  | **Description**                                                                                |
++=============+================================================================================================+
+| SQ-6419     | An internal compiler error occurred when casting Numeric literals in an aggregation function.  |
++-------------+------------------------------------------------------------------------------------------------+
+
+Resolved Issues
+---------
+The following table lists the issues that were resolved in Version 2022.1.1:
+
++-------------+----------------------------------------------------------------------------------------+
+| **SQ No.**  | **Description**                                                                        |
++=============+========================================================================================+
+| SQ-10873    | Inserting 100K bytes into a text column resulted in an unclear error message.          |
++-------------+----------------------------------------------------------------------------------------+
+| SQ-10955    | No metadata filters were applied when filtering by a nullable date using ``dateadd``.  |
++-------------+----------------------------------------------------------------------------------------+
+
+Operations and Configuration Changes
+--------
+The ``login_max_retries`` configuration flag is required for adjusting the permitted log-in attempts.
+
+For more information, see `Adjusting the Permitted Log-In Attempts `_.
+
+https://docs.sqream.com/en/latest/configuration_guides/login_max_retries.html
+
+Naming Changes
+-------
+No relevant naming changes were made.
+
+Deprecated Features
+-------
+No features were deprecated for Version 2022.1.1.
+
+End of Support
+-------
+The End of Support section is not relevant to Version 2022.1.1.
+
+Upgrading to v2022.1.1
+-------
+1. Generate a back-up of the metadata by running the following command:
+
+   .. code-block:: console
+
+      $ select backup_metadata('out_path');
+	  
+   .. tip:: SQream recommends storing the generated back-up locally in case needed.
+   
+   SQream runs the Garbage Collector and creates a clean backup tarball package.
+   
+2. Shut down all SQream services.
+
+    ::
+
+3. Extract the recently created back-up file.
+
+    ::
+
+4. Replace your current metadata with the metadata you stored in the back-up file.
+
+    ::
+
+5. Navigate to the new SQream package bin folder.
+
+    ::
+
+6. Run the following command:
+
+   .. code-block:: console
+
+      $ ./upgrade_storage 
+
+  .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version `_ procedure.
+  
+.. toctree::
+   :maxdepth: 2
+   :glob:
+   :hidden:
+
+   2022.1.1.1
\ No newline at end of file
diff --git a/releases/2022.1_index.rst b/releases/2022.1_index.rst
index 9c7b2b211..628b372aa 100644
--- a/releases/2022.1_index.rst
+++ b/releases/2022.1_index.rst
@@ -13,4 +13,5 @@ The 2022.1 Release Notes describe the following releases:
    :maxdepth: 1
    :glob:
 
+   2022.1.1
    2022.1
\ No newline at end of file
diff --git a/releases/index.rst b/releases/index.rst
index b1d065a9e..84024586e 100644
--- a/releases/index.rst
+++ b/releases/index.rst
@@ -32,7 +32,7 @@ Release Notes
    :glob:
    :hidden:
 
-   2022.1
+   2022.1_index
    2021.2_index
    2021.1_index
    2020.3_index

From 3239b338af16ae2262dc98ece1b5626d567a84fc Mon Sep 17 00:00:00 2001
From: YanivGerowitz <82020437+YanivGerowitz@users.noreply.github.com>
Date: Tue, 2 Aug 2022 17:08:37 +0300
Subject: [PATCH 190/882] Update data_encryption_syntax.rst

---
 feature_guides/data_encryption_syntax.rst | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/feature_guides/data_encryption_syntax.rst b/feature_guides/data_encryption_syntax.rst
index 65f03ab5e..0eec64bc7 100644
--- a/feature_guides/data_encryption_syntax.rst
+++ b/feature_guides/data_encryption_syntax.rst
@@ -7,19 +7,20 @@ The following is the syntax for encrypting a new table:
 
 .. code-block:: console
      
-   CREATE TABLE   (
-          <(maximum string length)>,
-         
-	last_name  <(maximum string length)>,
-        salary (<(maximum string length)>) ENCRYPT);
+   CREATE TABLE
( + NOT NULL ENCRYPT, + ENCRYPT, + , + ENCRYPT); The following is an example of encrypting a new table: .. code-block:: console CREATE TABLE client_name ( - first_name TEXT(128), - last_name TEXT(128), - salary INT(6) ENCRYPT); + id BIGINT NOT NULL ENCRYPT, + first_name TEXT ENCRYPT, + last_name TEXT, + salary INT ENCRYPT); .. note:: Users without permissions cannot view the entire table as long as at least one column is encrypted. The (unique) encryption/decryption key is relevant only at the system level and is not held by users. From 14d029d853ac26bda98622b282d649a22c17a89e Mon Sep 17 00:00:00 2001 From: YanivGerowitz <82020437+YanivGerowitz@users.noreply.github.com> Date: Tue, 2 Aug 2022 18:13:08 +0300 Subject: [PATCH 191/882] Update data_encryption_syntax.rst --- feature_guides/data_encryption_syntax.rst | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/feature_guides/data_encryption_syntax.rst b/feature_guides/data_encryption_syntax.rst index 0eec64bc7..bba431aec 100644 --- a/feature_guides/data_encryption_syntax.rst +++ b/feature_guides/data_encryption_syntax.rst @@ -23,4 +23,12 @@ The following is an example of encrypting a new table: last_name TEXT, salary INT ENCRYPT); -.. note:: Users without permissions cannot view the entire table as long as at least one column is encrypted. The (unique) encryption/decryption key is relevant only at the system level and is not held by users. +.. note:: Because encryption is not associated with any role, users with **Read** or **Insert** permissions can read tables containing encrypted data. + +.. warning:: Your performance degradation increases in correlation with the amount of added columns. + +You cannot encrypt more than three columns. Attempting to encrypt more than three columns displays the following error message: + +.. code-block:: console + + Error preparing statement: Cannot create a table with more than three encrypted columns. From c020e61055c97b51fabb9aa5f62436a31593ae95 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 2 Aug 2022 19:11:31 +0300 Subject: [PATCH 192/882] Added Avro --- data_ingestion/index.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/data_ingestion/index.rst b/data_ingestion/index.rst index fae7824c7..c11d47faa 100644 --- a/data_ingestion/index.rst +++ b/data_ingestion/index.rst @@ -14,5 +14,6 @@ The **Data Ingestion Sources** provides information about the following: csv parquet orc + oracle -For information about database tools and interfaces that SQream supports, see `Third Party Tools `_. \ No newline at end of file +For information about database tools and interfaces that SQream supports, see `Third Party Tools `_. \ No newline at end of file From 53070e875581b3fbf71c51432e28a558ae48798c Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Wed, 3 Aug 2022 16:14:36 +0300 Subject: [PATCH 193/882] Added Table (Jenny's request) --- .../access_control_password_policy.rst | 2 +- .../sql_statements/dml_commands/update.rst | 121 +----------------- releases/2022.1.1.rst | 19 +-- releases/2022.1_index.rst | 54 +++++++- 4 files changed, 57 insertions(+), 139 deletions(-) diff --git a/operational_guides/access_control_password_policy.rst b/operational_guides/access_control_password_policy.rst index 0a17f833e..6d9d989f2 100644 --- a/operational_guides/access_control_password_policy.rst +++ b/operational_guides/access_control_password_policy.rst @@ -1,7 +1,7 @@ .. _access_control_password_policy: ************** -Password Policy (New!) +Password Security Compliance (New!) ************** .. |icon-new_gray_2022.1.1| image:: /_static/images/new_gray_2022.1.1.png diff --git a/reference/sql/sql_statements/dml_commands/update.rst b/reference/sql/sql_statements/dml_commands/update.rst index b804d6c37..7c1b8c8b8 100644 --- a/reference/sql/sql_statements/dml_commands/update.rst +++ b/reference/sql/sql_statements/dml_commands/update.rst @@ -78,31 +78,7 @@ The **Examples** section includes the following examples: .. contents:: :local: :depth: 1 - -Updating an Entire Table ------------------ -The Examples section shows how to modify the value of certain columns in existing rows without creating a table. The examples are based on the following tables: - -.. image:: /_static/images/delete_optimization.png - -The following methods for updating an entire table generate the same output, and result with the ``bands`` record set to ``NULL``: - -.. code-block:: postgres - - UPDATE bands SET records_sold = 0; - -.. code-block:: postgres - - UPDATE bands SET records_sold = 0 WHERE true; - -.. code-block:: postgres - - UPDATE bands SET records_sold = 0 USING countries; - -.. code-block:: postgres - - UPDATE bands SET records_sold = 0 USING countries WHERE 1=1; - + Performing Simple Updates ----------------- The following is an example of performing a simple update: @@ -125,87 +101,8 @@ The following shows an example of updating tables that contain multi-table condi AND country.name = 'Sweden' ); -Updating Tables that Contain Multi-Table Conditions using the FROM Clause ------------------ -The following shows an example of updating tables that contain multi-table conditions using the ``FROM`` clause: - -.. code-block:: postgres - - UPDATE bands - SET records_sold = records_sold + - CASE - WHEN c.name = 'Israel' THEN 2 - ELSE 1 - END - FROM countries c - -You can also write the statement above using the FROM clause: - -.. code-block:: psql - - UPDATE bands - SET records_sold = records_sold + 1 - FROM countries - WHERE countries.id=bands.country_id AND country.name = 'Sweden'; - -Updating Tables that Contain Multi-Table Expressions ------------------ -The following shows an example of updating tables that contain multi-table expressions: - -.. code-block:: postgres - - UPDATE bands - SET records_sold = records_sold + - CASE - WHEN c.name = 'Israel' THEN 2 - ELSE 1 - END - FROM countries c - -Identifying and Cleaning Up Tables ---------------------------------------- -The following section shows examples of each phase required for cleaning up tables: - -* :ref:`Listing tables that require clean-up` -* :ref:`Identifying clean-up predicates` -* :ref:`Triggering a clean-up` - -.. _listing_tables_that_require_cleanup: - -Listing Tables that Require Clean-Up -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -The following shows an example of listing tables that require clean-up: - -.. code-block:: psql - - farm=> SELECT t.table_name FROM sqream_catalog.delete_predicates dp - JOIN sqream_catalog.tables t - ON dp.table_id = t.table_id - GROUP BY 1; - cool_animals - - 1 row - -.. _identifying_cleanup_predicates: - -Identifying Clean-Up Predicates -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -The following shows an example of listing the clean-up predicates: - -.. code-block:: psql - - farm=> SELECT delete_predicate FROM sqream_catalog.delete_predicates dp - JOIN sqream_catalog.tables t - ON dp.table_id = t.table_id - WHERE t.table_name = 'cool_animals'; - weight > 1000 - - 1 row - -.. _triggering_a_cleanup: - Triggering a Clean-Up -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +----------------- The following section shows an example of triggering a clean-up: .. code-block:: psql @@ -220,20 +117,6 @@ The following is an example of the output generated from the above: * **column_id** - 1 * **extent_ID** - 0 -Security and Access Control -============= -Executing an ``UPDATE`` statement requires the following: - -* Both ``UPDATE`` and ``SELECT`` permissions on the target table. - - :: - -* The ``SELECT`` permission for each additional table referenced in the the statement (either in the ``FROM`` clause or in a ``WHERE`` subquery expression). - -For more information, navigate to the **Access Control** page and see `Permissions `_. - -file:///C:/Users/Yaniv/sqream_docs/_build/html/operational_guides/access_control_permissions.html - Locking and Concurrency ============= Executing the ``UPDATE`` statement obtains an exclusive ``UPDATE`` lock on the target table. diff --git a/releases/2022.1.1.rst b/releases/2022.1.1.rst index 15fcd8c42..517c11042 100644 --- a/releases/2022.1.1.rst +++ b/releases/2022.1.1.rst @@ -27,29 +27,22 @@ The 2022.1.1 Release Notes include the following new features: Update Feature ************ -SQream now supports the DML **Update** feature, which is used for modifying the value of certain columns in existing rows. +The DML ``UPDATE`` statement has been enhanced to support running subqueries in the ``WHERE`` condition. For more information, see `UPDATE `_. -file:///C:/Users/Yaniv/sqream_docs/_build/html/reference/sql/sql_statements/dml_commands/update.html?highlight=update - -Password Policy +Password Security Compliance ************ In compliance with GDPR standards, SQream now requires a strong password policy when accessing the CLI or Studio. -For more information, see `Password Policy `_. - -file:///C:/Users/Yaniv/sqream_docs/_build/html/operational_guides/access_control_password_policy.html?highlight=password%20policy +For more information, see :ref:`access_control_password_policy`. Compression ************ - SQream now supports the **zlib** compression format. For more information, see `Compression `_. -file:///C:/Users/Yaniv/sqream_docs/_build/html/feature_guides/compression.html#compression-strategies - Known Issues --------- The following table lists the known issues for Version 2022.1.1: @@ -69,7 +62,7 @@ The following table lists the issues that were resolved in Version 2022.1.1: +=============+========================================================================================+ | SQ-10873 | Inserting 100K bytes into a text column resulted in an unclear error message. | +-------------+----------------------------------------------------------------------------------------+ -| SQ-10955 | No metadata filters were applied when filtering by a nullable date using ``dateadd``. | +| SQ-10892 | An unclear message was displayed when users ran ``UPDATE`` on foreign tables. | +-------------+----------------------------------------------------------------------------------------+ Operations and Configuration Changes @@ -78,8 +71,6 @@ The ``login_max_retries`` configuration flag is required for adjusting the permi For more information, see `Adjusting the Permitted Log-In Attempts `_. -https://docs.sqream.com/en/latest/configuration_guides/login_max_retries.html - Naming Changes ------- No relevant naming changes were made. @@ -133,4 +124,4 @@ Upgrading to v2022.1.1 :glob: :hidden: - 2022.1.1.1 \ No newline at end of file + 2022.1.1 \ No newline at end of file diff --git a/releases/2022.1_index.rst b/releases/2022.1_index.rst index 628b372aa..76d9e0e7c 100644 --- a/releases/2022.1_index.rst +++ b/releases/2022.1_index.rst @@ -5,13 +5,57 @@ Release Notes 2022.1 ************************** The 2022.1 Release Notes describe the following releases: -.. contents:: - :local: - :depth: 1 - .. toctree:: :maxdepth: 1 :glob: 2022.1.1 - 2022.1 \ No newline at end of file + 2022.1 + +You can also use the following tables for a summary of the new features in Version 2022.1 according to month: + +.. contents:: + :local: + :depth: 1 + +August 2022 +================== +The following enhancements were introduced in :ref:`August 2022 (2022.1.1) <2022.1.1>`: + +.. list-table:: + :widths: 20 20 60 + :header-rows: 1 + + * - Topic + - Feature + - Description + * - **Reference Guides** + - :ref:`update` + - The DML ``UPDATE`` statement has been enhanced to support running subqueries in the ``WHERE`` condition. + * - **Feature Guides** + - :ref:`compression` + - SQream supports compressing and decompressing data in and from the **ZLIB** format. + * - **Operational Guides** + - :ref:`Password Security Compliance` + - Integrated password security compliance measures when logging in to the CLI or Studio. + +July 2022 +================== +The following enhancements were introduced in :ref:`July 2022 (2022.1) <2022.1>`: + +.. list-table:: + :widths: 20 20 60 + :header-rows: 1 + + * - Topic + - Feature + - Description + * - **Feature Guides** + - :ref:`data_encryption` + - SQream has integrated data encryption mechanisms in accordance with General Data Protection Regulation (GDPR) standards. + * - **Data Ingestion** + - :ref:`avro` + - SSQream now supports ingesting data from Avro files. + * - **Reference Guides** + - :ref:`update` + - Supports modifying the value of certain columns in existing rows. \ No newline at end of file From c718d0ad427faced59301553fcf3c46a3c41692c Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Wed, 3 Aug 2022 16:37:13 +0300 Subject: [PATCH 194/882] Modified tables --- .../sql/sql_statements/dml_commands/update.rst | 2 +- releases/2022.1_index.rst | 18 +++++++++--------- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/update.rst b/reference/sql/sql_statements/dml_commands/update.rst index 7c1b8c8b8..6cc33f516 100644 --- a/reference/sql/sql_statements/dml_commands/update.rst +++ b/reference/sql/sql_statements/dml_commands/update.rst @@ -89,7 +89,7 @@ The following is an example of performing a simple update: Updating Tables that Contain Multi-Table Conditions ----------------- -The following shows an example of updating tables that contain multi-table conditions: +The following shows an example of updating tables that contain multi-table conditions |icon-new_2022.1.1|: .. code-block:: postgres diff --git a/releases/2022.1_index.rst b/releases/2022.1_index.rst index 76d9e0e7c..16a7d80ef 100644 --- a/releases/2022.1_index.rst +++ b/releases/2022.1_index.rst @@ -23,21 +23,21 @@ August 2022 The following enhancements were introduced in :ref:`August 2022 (2022.1.1) <2022.1.1>`: .. list-table:: - :widths: 20 20 60 + :widths: 24 25 60 :header-rows: 1 * - Topic - Feature - Description - * - **Reference Guides** - - :ref:`update` - - The DML ``UPDATE`` statement has been enhanced to support running subqueries in the ``WHERE`` condition. * - **Feature Guides** - :ref:`compression` - SQream supports compressing and decompressing data in and from the **ZLIB** format. * - **Operational Guides** - :ref:`Password Security Compliance` - Integrated password security compliance measures when logging in to the CLI or Studio. + * - **Reference Guides** + - :ref:`update` + - The DML ``UPDATE`` statement has been enhanced to support running subqueries in the ``WHERE`` condition. July 2022 ================== @@ -50,12 +50,12 @@ The following enhancements were introduced in :ref:`July 2022 (2022.1) <2022.1>` * - Topic - Feature - Description + * - **Data Ingestion** + - :ref:`avro` + - SQream now supports ingesting data from Avro files. * - **Feature Guides** - :ref:`data_encryption` - SQream has integrated data encryption mechanisms in accordance with General Data Protection Regulation (GDPR) standards. - * - **Data Ingestion** - - :ref:`avro` - - SSQream now supports ingesting data from Avro files. * - **Reference Guides** - - :ref:`update` - - Supports modifying the value of certain columns in existing rows. \ No newline at end of file + - `UPDATE `_ + - The DML ``UPDATE`` statement has been introduced to support modifying the value of certain columns in existing rows. \ No newline at end of file From 08682c571b81bdd8c80b90869a4d79f7770fbcb6 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 4 Aug 2022 11:27:08 +0300 Subject: [PATCH 195/882] Updated menu --- feature_guides/data_encryption.rst | 3 ++- .../data_encryption_permissions.rst | 6 +++++ feature_guides/data_encryption_syntax.rst | 2 -- .../access_control_password_policy.rst | 24 +++++++++++++------ 4 files changed, 25 insertions(+), 10 deletions(-) create mode 100644 feature_guides/data_encryption_permissions.rst diff --git a/feature_guides/data_encryption.rst b/feature_guides/data_encryption.rst index dbc6152ed..19aabb8e3 100644 --- a/feature_guides/data_encryption.rst +++ b/feature_guides/data_encryption.rst @@ -16,4 +16,5 @@ The **Data Encryption** page |icon-new_2022.1| describes the following: data_encryption_overview data_encryption_methods data_encryption_types - data_encryption_syntax \ No newline at end of file + data_encryption_syntax + data_encryption_permissions \ No newline at end of file diff --git a/feature_guides/data_encryption_permissions.rst b/feature_guides/data_encryption_permissions.rst new file mode 100644 index 000000000..ba51f2501 --- /dev/null +++ b/feature_guides/data_encryption_permissions.rst @@ -0,0 +1,6 @@ +.. _data_encryption_permissions: + +*********************** +Permissions +*********************** +Because the Data Encryption feature does not require a role, users with **Read** and **Insert** permissions can read tables containing encrypted data. \ No newline at end of file diff --git a/feature_guides/data_encryption_syntax.rst b/feature_guides/data_encryption_syntax.rst index bba431aec..56934378e 100644 --- a/feature_guides/data_encryption_syntax.rst +++ b/feature_guides/data_encryption_syntax.rst @@ -25,8 +25,6 @@ The following is an example of encrypting a new table: .. note:: Because encryption is not associated with any role, users with **Read** or **Insert** permissions can read tables containing encrypted data. -.. warning:: Your performance degradation increases in correlation with the amount of added columns. - You cannot encrypt more than three columns. Attempting to encrypt more than three columns displays the following error message: .. code-block:: console diff --git a/operational_guides/access_control_password_policy.rst b/operational_guides/access_control_password_policy.rst index 6d9d989f2..fc845ebc4 100644 --- a/operational_guides/access_control_password_policy.rst +++ b/operational_guides/access_control_password_policy.rst @@ -8,27 +8,37 @@ Password Security Compliance (New!) :align: middle :width: 110 -As part of our compliance with GDPR standards |icon-new_gray_2022.1.1| SQream relies on a strong password policy when accessing the CLI or Studio, with the following requirements: +As part of our compliance with GDPR standards |icon-new_gray_2022.1.1| SQream relies on a strong password policy when accessing the CLI or Studio. + +The following requirements apply when creating a password: * At least eight characters long. :: -* Mandatory upper and lowercase letters. +* At least one numeric character. :: -* At least one numeric character. +* Should not include a username. :: -* May not include a username. +* Must include at least one special character, such as **?**, **!**, **$**, etc. :: -* Must include at least one special character, such as **?**, **!**, **$**, etc. +* Mandatory upper and lowercase letters. + +The following is the syntax for creating a password: + +.. code-block:: console + + CREATE ROLE ; + GRANT LOGIN ; + GRANT PASSWORD <'password'> to ; -You can create a password through the Studio graphic interface or through the CLI, as in the following example command: +The following is an example of creating a password: .. code-block:: console @@ -52,7 +62,7 @@ Creating a password that does not comply with the above requirements generates t * Must include at least one “special” character (?, !, $, etc.). -.. note:: When a new user created in Studio, a message is displayed to help you determine what the constraints are. +.. note:: When a new user is created in Studio, a message is displayed to help you determine what the constraints are. Unsuccessfully attempting to log in three times displays the following message: From abc2245f25a0219ad6186d052b436001a5c798a6 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 4 Aug 2022 13:58:14 +0300 Subject: [PATCH 196/882] Changed 5.4.3 to 5.4.6 --- index.rst | 2 +- reference/sql/sql_statements/index.rst | 2 + .../utility_commands/shutdown_server.rst | 115 ++ sqream_studio_5.4.3/Version_5.3.3.txt | 898 ---------------- .../configuring_your_instance_of_sqream.rst | 44 +- ...ing_and_managing_roles_and_permissions.rst | 196 ++-- ...ts_and_running_queries_from_the_editor.rst | 984 +++++++++--------- .../getting_started.rst | 126 +-- .../index.rst | 36 +- ...orkers_and_services_from_the_dashboard.rst | 530 +++++----- .../viewing_logs.rst | 244 ++--- 11 files changed, 1200 insertions(+), 1977 deletions(-) create mode 100644 reference/sql/sql_statements/utility_commands/shutdown_server.rst delete mode 100644 sqream_studio_5.4.3/Version_5.3.3.txt rename {sqream_studio_5.4.3 => sqream_studio_5.4.6}/configuring_your_instance_of_sqream.rst (98%) rename {sqream_studio_5.4.3 => sqream_studio_5.4.6}/creating_assigning_and_managing_roles_and_permissions.rst (95%) rename {sqream_studio_5.4.3 => sqream_studio_5.4.6}/executing_statements_and_running_queries_from_the_editor.rst (92%) rename {sqream_studio_5.4.3 => sqream_studio_5.4.6}/getting_started.rst (92%) rename {sqream_studio_5.4.3 => sqream_studio_5.4.6}/index.rst (88%) rename {sqream_studio_5.4.3 => sqream_studio_5.4.6}/monitoring_workers_and_services_from_the_dashboard.rst (90%) rename {sqream_studio_5.4.3 => sqream_studio_5.4.6}/viewing_logs.rst (85%) diff --git a/index.rst b/index.rst index 0f418c2fb..23e2288c0 100644 --- a/index.rst +++ b/index.rst @@ -104,7 +104,7 @@ If you're looking for an older version of the documentation, versions 1.10 throu loading_and_unloading_data/index feature_guides/index operational_guides/index - sqream_studio_5.4.3/index + sqream_studio_5.4.6/index architecture/index configuration_guides/index reference/index diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index d2b92b152..5cac43122 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -130,6 +130,8 @@ The following table shows the Utility commands: - Returns a list of active sessions across the cluster * - :ref:`SHOW VERSION` - Returns the system version for SQream DB + * - :ref:`SHUTDOWN SERVER` + - Performs a graceful server shutdown * - :ref:`STOP STATEMENT` - Stops or aborts an active statement diff --git a/reference/sql/sql_statements/utility_commands/shutdown_server.rst b/reference/sql/sql_statements/utility_commands/shutdown_server.rst new file mode 100644 index 000000000..ac0c4dc96 --- /dev/null +++ b/reference/sql/sql_statements/utility_commands/shutdown_server.rst @@ -0,0 +1,115 @@ +.. _shutdown_server: + +******************** +SHUTDOWN SERVER +******************** +**Comment** - When finished, add command to Utility Commands > shutdown_server. + +The **SHUTDOWN_SERVER** guide describes the following: + +.. contents:: + :local: + :depth: 1 + +Overview +=============== +SQream's current method for stopping the SQream server is running the ``shutdown_server ()`` utility command. Because this command abruptly shuts down the server while executing operations, it has been modified to perform a graceful shutdown, giving you more control over the following: + +* Preventing new queries from connecting to the server. + + :: + +* The amount of time to wait before shutting down the server. + + :: + +* Configurations related to shutting down the server. + +How Does it Work? +======================== +Running the ``SHUTDOWN_SERVER`` command does the following: + +* Prevents new queries from entering the server by doing the following: + + * Setting the SQream server to unavailable in the metadata server. **Comment** - *Is "unavailable" the official server setting?* + + :: + + * Unsubscribing the server from its service. + +* Preventing new connections from being made to the server - attempting to establish a connection with the server after initiating a graceful shutdown displays the "Server is shutting down, no new connections are possible at the moment" messsge. + + :: + +* Waiting for the statement queue to be cleared - the graceful shutdown waits for queries that have been compiled on the server to be cleared from the statement queue. During this time - start executing on other available servers. + +**Comment** - *The last bullet requires clarification.* + +Syntax +========== +The following is the syntax for using the ``SHUTDOWN_SERVER`` command: + +.. code-block:: postgres + + select shutdown_server([is_graceful, [timeout]]); + +**Comment** - *Is the below syntax correct?* + +.. code-block:: postgres + + select shutdown_server([true/false, [timeout]]); + +**Comment** - *Can you set the timeout as a flag in Studio, or only in the CLI?* + +Returns +========== +Running the ``shutdown_server`` command returns no output. + +Parameters +============ +The following table shows the ``shutdown_server`` parameters: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + - Example + - Default + * - ``is_graceful`` + - Determines the method used to shut down the server. + - Selecting ``false`` shuts down the server while queries are running. Selecting ``true`` uses the graceful shutdown method. + - **Comment** - Is the default ``true`` or ``false``? + * - ``timeout`` + - Sets the maximum amount of minutes for the graceful shutdown method to run before the server is shut down using the standard method. + - ``30`` + - Five minutes. + +.. note:: Setting ``is_graceful`` to ``false`` and defining the ``timeout`` value shuts the server down mid-query after the defined time. + +It is possible to pass as the second argument the timeout in minutes after which a forceful shutdown will run, regardless of the progression of the graceful shutdown. + +**Comment** - *How can the above be true given the following, "Note that running forced shutdown with a timeout, i.e. select shutdown_server(false, 30) will return an error message; forced shutdown has no timeout timer"?* + +Note that you set the timeout value using the ``defaultGracefulShutdownTimeoutMinutes`` flag in Studio. + +For more information, see :ref:`graceful_shutdown`. + +**Comment** - *I have not yet created the ``graceful_shutdown`` configuration flag. I need to know what category it belongs in before doing so.* + +Like shutdown_server() graceful shutdown will stop any query currently running on the server. + +**Comment** - *The above makes it seem like it's a separate command, but that's not the case.* + +Relationship to Healer & Use Case +============================ +**Comment** - *Cannot document this section until I know what the Healer actually does.* + +Currently the Healer will not trigger a graceful shutdown upon detection of a stuck query. It will however log detection of such a query, prompting the user to run a graceful shutdown of the server, possibly saving existing queued queries. + +Permissions +============= +Using the ``shutdown_server`` command requires no special permissions. + +**Comment** - *Confirm.* \ No newline at end of file diff --git a/sqream_studio_5.4.3/Version_5.3.3.txt b/sqream_studio_5.4.3/Version_5.3.3.txt deleted file mode 100644 index 458302aad..000000000 --- a/sqream_studio_5.4.3/Version_5.3.3.txt +++ /dev/null @@ -1,898 +0,0 @@ -.. _acceleration_studio_version_5.3.3: - -**************************** -SQream Acceleration Studio 5.3.3 -**************************** - -The SQream Studio is a web-based client for use with SQream DB. The Studio provides users with all functionality available from the command line in an intuitive and easy-to-use format. This includes running statements, managing roles and permissions, and managing SQream DB clusters. - - -.. contents:: This page describes the following: - :depth: 3 - -Getting Started -================== - -.. _setting_up_and_starting_studio: - - -Setting Up and Starting Studio ----------------- - -Studio is included with all `dockerized installations of SQream DB `_. When starting Studio, it listens on the local machine on port 8080. - - - - - - - -Logging In to Studio ---------------- -**To log in to SQream Studio:** - -1. Open a browser to the host on **port 8080**. - - For example, if your machine IP address is ``192.168.0.100``, insert the IP address into the browser as shown below: - - .. code-block:: console - - $ http://192.168.0.100:8080 - -2. Fill in your SQream DB login credentials. These are the same credentials used for `SQream CLI Reference `_ or JDBC. - - When you sign in, the License Warning is displayed. - -Navigating Studio's Main Features -------------- -When you log in, you are automatically taken to the **Editor** screen. The Studio's main functions are displayed in the **Navigation** pane on the left side of the screen. - -From here you can navigate between the main areas of the Studio: - -.. list-table:: - :widths: 10 90 - :header-rows: 1 - - * - Element - - Description - * - :ref:`Dashboard` - - Only users with **superuser** permissions have access to the Dashboard. - * - :ref:`Editor` - - All users have access to the Editor and to databases that they have permissions for. - * - :ref:`Logs` - - Only users with the **superuser** permissions have access to the logs. - * - :ref:`Roles` - - Lets you create users and manage user permissions. - -By clicking the user icon, you can also use it for logging out and viewing the following: - -* User information -* Connection type -* SQream version -* SQream Studio version -* Data size limitations -* Log out - - - -.. _back_to_dashboard: - -.. _studio_dashboard: - -Monitoring Workers and Services from the Dashboard -============================== -The **Dashboard** is used for the following: - -* Monitoring cluster storage and system health. -* Viewing, monitoring, and adding defined service queues. -* Viewing and managing worker status and add workers. - -You can only access the Dashboard if you signed in with a ``SUPERUSER`` role. - -The following is a brief description of the Dashboard panels: - -.. list-table:: - :widths: 10 25 65 - :header-rows: 1 - - * - No. - - Element - - Description - * - 1 - - :ref:`Data Storage panel` - - Used to monitor cluster storage. - * - 2 - - :ref:`Services panel` - - Used for viewing and monitoring the defined `service queues `_. - * - 3 - - :ref:`Workers panel` - - Monitors system health and shows each Sqreamd worker running in the cluster. - * - 4 - - :ref:`License information` - - Shows the remaining amount of days left on your license. - - -.. _data_storage_panel: - -Displaying System Disk Usage from the Data Storage Panel ------------------------ -The **Data Storage** area displays your system's total disk usage (percentage) and data storage (donut graph). - -Your data storage is shows as the following four components: - -* **Data** – Storage occupied by databases in SQream DB. -* **Free** – Free storage space. -* **Deleted** – Storage that is temporarily occupied, but has not been reclaimed. For more information, see `Deleting Data `_. The **deleted** value is estimated and may not be accurate. -* **Other** – Storage used by other applications. On a dedicated SQream DB cluster this should be near zero. - -.. _administration_storage_database: - -You can show more information by clicking the expand arrow on the Data Storage panel. - -.. image:: /_static/images/studio_dashboard_expand_data_storage_5.3.0.png - -The expanded Data Storage panel can be used to drill down into each database's storage footprint, and displays a breakdown of how much storage each database in the cluster uses. - -The database information is displayed in a table and shows the following: - -* **Database name** - the name of the database. -* **Raw Size** – the estimated size of (uncompressed) raw data in the database. -* **Storage Size** – the physical size of the compressed data. -* **Ratio** – the effective compression ratio -* **Deleted Data** – Storage that is temporarily occupied, but has not been reclaimed. - -Below the table, an interactive line graph displays the database storage trends. By default, the line graph displays the total storage for all databases. You can show a particular database's graph by clicking it in the table. You can also change the line graph's timespan by selecting one from the timespan dropdown menu. - -.. image:: /_static/images/studio_dashboard_expand_data_storage_3_5.3.0.png - -:ref:`Back to Dashboard` - -.. _services_panel: - -Subscribing to Workers from the Services Panel --------------------------- -Services are used to categorize and associate (also known as **subscribing**) workers to particular services. The **Service** panel is used for viewing, monitoring, and adding defined `service queues `_. - -.. image:: /_static/images/studio_dashboard_services_panel_5.3.0.png - -The Dashboard includes the four panes shown below: - -.. image:: /_static/images/studio_dashboard_service_queue_5.3.0.png - -The following is a brief description of each pane: - -.. list-table:: - :widths: 10 90 - :header-rows: 1 - - * - No. - - Description - * - 1 - - Adds a worker to the selected service. - * - 2 - - Shows the service name. - * - 3 - - Shows a trend graph of queued statements loaded over time. - * - 4 - - Adds a service. - * - 5 - - Shows the currently processed queries belonging to the service/total queries for that service in the system (including queued queries). - -Adding A Service -^^^^^^^^^^^^^^^^^^^^^ -You can add a service by clicking **+ Add** and defining the service name. - -.. note:: If you do not associate a worker with the new service, it will not be created. - -You can manage workers from the **Workers** panel. For more information on managing workers, see :ref:`Workers`. - -:ref:`Back to Dashboard` - -.. _workers_panel: - -Managing Workers from the Workers Panel ------------- -From the **Workers** panel you can do the following: - -* :ref:`View workers ` -* :ref:`Add a worker to a service` -* :ref:`View a worker's active query information` -* :ref:`View a worker's execution plan` - -.. _view_workers: - -Viewing Workers -^^^^^^^^ -The **Worker** panel shows each worker (``sqreamd``) running in the cluster. Each worker has a status bar that represents the status over time. The status bar is divided into 20 equal segments, showing the most dominant activity in that segment. - -From the **Scale** dropdown menu you can set the time scale of the displayed information -You can hover over segments in the status bar to see the date and time corresponding to each activity type: - -* **Idle** – the worker is idle and available for statements. -* **Compiling** – the worker is compiling a statement and is preparing for execution. -* **Executing** – the worker is executing a statement after compilation. -* **Stopped** – the worker was stopped (either deliberately or due to an error). -* **Waiting** – the worker was waiting on an object locked by another worker. - -.. _add_worker_to_service: - -Adding A Worker to A Service -^^^^^^^^^^^^^^^^^^^^^ -You can add a worker to a service by clicking the **add** button. - -.. image:: /_static/images/studio_dashboard_add_worker_to_service_5.3.0.png - -Clicking the **add** button shows the selected service's workers. You can add the selected worker to the service by clicking **Add Worker**. Adding a worker to a service does not break associations already made between that worker and other services. - - -.. _view_worker_query_information: - -Viewing A Worker's Active Query Information -^^^^^^^^^^^^^^^^^^^^^ -You can view a worker's active query information by clicking **Queries**, which displays them in the selected service. - - -Each statement shows the **query ID**, **status**, **service queue**, **elapsed time**, **execution time**, and **estimated completion status**. In addition, each statement can be stopped or expanded to show its execution plan and progress. For more information on viewing a statement's execution plan and progress, see :ref:`Viewing a Worker's Execution Plan ` below. - -Viewing A Worker's Host Utilization -^^^^^^^^^^^^^^^^^^^^^ - -While viewing a worker's query information, clicking the **down arrow** expands to show the host resource utilization. - -.. image:: /_static/images/studio_dashboard_show_cpu_gpu_graph_5.3.0.png - -The graphs show the resource utilization trends over time, and the **CPU memory** and **utilization** and the **GPU utilization** values on the right. You can hover over the graph to see more information about the activity at any point on the graph. - -Error notifications related to statements are displayed as shown in the figure below, and you can hover over them for more information about the error. - -.. image:: /_static/images/studio_dashboard_notification_error_5.3.0.png - -.. _view_worker_execution_plan: - -Viewing a Worker's Execution Plan -^^^^^^^^^^^^^^^^^^^^^ - -Clicking the ellipsis in a service shows the following additional options: - -* **Stop Query** - stops the query. -* **Show Execution Plan** - shows the execution plan as a table. The columns in the **Show Execution Plan** table can be sorted. - -For more information on the current query plan, see `SHOW_NODE_INFO `_. For more information on checking active sessions across the cluster, see `SHOW_SERVER_STATUS `_. - -.. include:: /reference/sql/sql_statements/monitoring_commands/show_server_status.rst - :start-line: 67 - :end-line: 84 - -Managing Worker Status -^^^^^^^^^^^^^^^^^^^^^ - -In some cases you may want to stop or restart workers for maintenance purposes. Each Worker line has a :kbd:`⋮` menu used for stopping, starting, or restarting workers. - -.. image:: /_static/images/stop_restart_worker.png - -Starting or restarting workers terminates all queries related to that worker. When you stop a worker, its background turns gray. - - - - -.. |icon-user| image:: /_static/images/studio_icon_user.png - :align: middle - -.. |icon-dots| image:: /_static/images/studio_icon_dots.png - :align: middle - -.. |icon-editor| image:: /_static/images/studio_icon_editor.png - :align: middle - -.. |icon-copy| image:: /_static/images/studio_icon_copy.png - :align: middle - -.. |icon-select| image:: /_static/images/studio_icon_select.png - :align: middle - -.. |icon-dots| image:: /_static/images/studio_icon_dots.png - :align: middle - -.. |icon-filter| image:: /_static/images/studio_icon_filter.png - :align: middle - -.. |icon-ddl-edit| image:: /_static/images/studio_icon_ddl_edit.png - :align: middle - -.. |icon-run-optimizer| image:: /_static/images/studio_icon_run_optimizer.png - :align: middle - -.. |icon-generate-create-statement| image:: /_static/images/studio_icon_generate_create_statement.png - :align: middle - -.. |icon-plus| image:: /_static/images/studio_icon_plus.png - :align: middle - -.. |icon-close| image:: /_static/images/studio_icon_close.png - :align: middle - -.. |icon-left| image:: /_static/images/studio_icon_left.png - :align: middle - -.. |icon-right| image:: /_static/images/studio_icon_right.png - :align: middle - -.. |icon-format-sql| image:: /_static/images/studio_icon_format.png - :align: middle - -.. |icon-download-query| image:: /_static/images/studio_icon_download_query.png - :align: middle - -.. |icon-open-query| image:: /_static/images/studio_icon_open_query.png - :align: middle - -.. |icon-execute| image:: /_static/images/studio_icon_execute.png - :align: middle - -.. |icon-stop| image:: /_static/images/studio_icon_stop.png - :align: middle - -.. |icon-dashboard| image:: /_static/images/studio_icon_dashboard.png - :align: middle - -.. |icon-expand| image:: /_static/images/studio_icon_expand.png - :align: middle - -.. |icon-scale| image:: /_static/images/studio_icon_scale.png - :align: middle - -.. |icon-expand-down| image:: /_static/images/studio_icon_expand_down.png - :align: middle - -.. |icon-add| image:: /_static/images/studio_icon_add.png - :align: middle - -.. |icon-add-worker| image:: /_static/images/studio_icon_add_worker.png - :align: middle - -.. |keep-tabs| image:: /_static/images/studio_keep_tabs.png - :align: middle - -:ref:`Back to Dashboard` - - - -.. _license_information: - -License Information ----------------------- -The license information is a counter showing the amount of time in days remaining on the license. - -:ref:`Back to Dashboard` - - -.. _studio_editor: - -.. _editor_top: - -Executing Statements and Running Queries from the Editor -================= -The **Editor** is used for the following: - -* Selecting an active database and executing queries. -* Performing statement-related operations and showing metadata. -* Executing pre-defined queries. -* Writing queries and statements and viewing query results. - -The following is a brief description of the Editor panels: - - -.. list-table:: - :widths: 10 34 56 - :header-rows: 1 - - * - No. - - Element - - Description - * - 1 - - :ref:`Toolbar` - - Used to select the active database you want to work on, limit the number of rows, save query, etc. - * - 2 - - :ref:`Database Tree and System Queries panel` - - Shows a heirarchy tree of databases, views, tables, and columns - * - 3 - - :ref:`Statement panel` - - Used for writing queries and statements - * - 4 - - :ref:`Results panel` - - Shows query results and execution information. - - -.. _studio_editor_db_tree: - -.. _top: - -.. _studio_editor_toolbar: - -Executing Statements from the Toolbar -------------- - -The following figure shows the **Toolbar** pane: - -.. image:: /_static/images/studio_editor_toolbar_5.3.0.png - -You can access the following from the Toolbar pane: - -* **Database dropdown list** - select a database that you want to run statements on. - -* **Service dropdown list** - select a service that you want to run statements on. The options in the service dropdown menu depend on the database you select from the **Database** dropdown list. - -* **Execute** - lets you set which statements to execute. The **Execute** button toggles between **Execute** and **Stop**, and can be used to stop an active statement before it completes: - - * **Statements** - executes the statement at the location of the cursor. - * **Selected** - executes only the highlighted text. This mode should be used when executing subqueries or sections of large queries (as long as they are valid SQLs). - * **All** - executes all statements in a selected tab. - -For more information on stopping active statements, see the :ref:`STOP_STATEMENT` command. - -* **Format SQL** - Lets you reformat and reindent statements. - -* **Download query** - Lets you download query text to your computer. - -* **Open query** - Lets you upload query text from your computer. - -* **Max Rows** - By default, the Editor fetches only the first 10,000 rows. You can modify this number by selecting an option from the **Max Rows** dropdown list. Note that setting a higher number may slow down your browser if the result is very large. This number is limited to 100,000 results. To see a higher number, you can save the results in a file or a table using the :ref:`create_table_as` command. - -:ref:`Back to Editor` - -Performing Statement-Related Operations from the Database Tree ---------------- -From the Database Tree you can perform statement-related operations and show metadata (such as a number indicating the amount of rows in the table). - -The following figure shows the **Database Tree** and **System Queries** panel, with the Database Tree tab selected. - -.. image:: /_static/images/studio_database_tree_system_queries_panel_5053.png - -The following figure shows the database object functions in the **calcs** table object. - -.. image:: /_static/images/studio_database_object_operations_5030.png - -The database object functions are used to perform the following: - - - * The **SELECT** statement - copies the selected table's **columns** into the Statement panel as ``SELECT`` parameters. - * The **copy** feature |icon-copy| - copies the selected table's **name** into the Statement panel. - * The **additional operations** |icon-dots| - displays the following additional options: - - - - - -.. list-table:: - :widths: 30 70 - :header-rows: 1 - - * - Function - - Description - * - Insert statement - - Generates an `INSERT `_ statement for the selected table in the editing area. - * - Delete statement - - Generates a `DELETE `_ statement for the selected table in the editing area. - * - Create Table As statement - - Generates a `CREATE TABLE AS `_ statement for the selected table in the editing area. - * - Rename statement - - Generates an `RENAME TABLE AS `_ statement for renaming the selected table in the editing area. - * - Adding column statement - - Generates an `ADD COLUMN `_ statement for adding columns to the selected table in the editing area. - * - Truncate table statement - - Generates a `TRUNCATE_IF_EXISTS `_ statement for the selected table in the editing area. - * - Drop table statement - - Generates a ``DROP`` statement for the selected object in the editing area. - * - Table DDL - - Generates a DDL statement for the selected object in the editing area. To get the entire database DDL, click the |icon-ddl-edit| icon next to the database name in the tree root. See also `Seeing System Objects as DDL `_. - * - DDL Optimizer - - The `DDL Optimizer `_ lets you analyze database tables and recommends possible optimizations. - - - - - -Optimizing Database Tables Using the DDL Optimizer -^^^^^^^^^^^^^^^^^^^^^ -The **DDL Optimizer** tab analyzes database tables and recommends possible optimizations according to SQream's best practices. - -As described in the previous table, you can access the DDL Optimizer by clicking the **additional options icon** and selecting **DDL Optimizer**. - -The following table describes the DDL Optimizer screen: - -.. list-table:: - :widths: 15 75 - :header-rows: 1 - - * - Element - - Description - * - Column area - - Shows the column **names** and **column types** from the selected table. You can scroll down or to the right/left for long column lists. - * - Optimization area - - Shows the number of rows to sample as the basis for running an optimization, the default setting (1,000,000) when running an optimization (this is also the overhead threshold used when analyzing ``VARCHAR`` fields), and the default percent buffer to add to ``VARCHAR`` lengths (10%). Attempts to determine field nullability. - * - Run Optimizer - - Starts the optimization process. - -Clicking **Run Optimizer** adds a tab to the Statement panel showing the optimized results of the selected object. The figure below shows the **calcs Optimized** tab for the optimized **calcs** table. - -For more information, see `Optimization and Best Practices `_. - -:ref:`Back to top` - -Executing Pre-Defined Queries from the System Queries Panel ---------------- -The **System Queries** panel lets you execute pre-defined queries and includes the following system query types: - -* **Catalog queries** - used for analyzing table compression rates, users and permissions, etc. -* **Admin queries** - queries related to available (describe the functionality in a general way). Queries useful for SQream database management: - - - - - -Clicking an item pastes the query into the Statement pane, and you can undo a previous operation by pressing **Ctrl + Z**. - - -.. _studio_editor_statement_area: - -Writing Statements and Queries from the Statement Panel ----------------- -The multi-tabbed statement area is used for writing queries and statements, and is used in tandem with the toolbar. When writing and executing statements, you must first select a database from the **Database** dropdown menu in the toolbar. When you execute a statement, it passes through a series of statuses until completing. Knowing the status helps you with statement maintenance, and the statuses are shown in the **Results panel**. - -The following table shows the statement statuses: - -.. list-table:: - :widths: 45 160 - :header-rows: 1 - - * - Status - - Description - * - Pending - - The statement is pending. - * - In queue - - The statement is waiting for execution. - * - Initializing - - The statement has entered execution checks. - * - Executing - - The statement is executing. - * - Statement stopped - - The statement has been stopped. - -You can add and name new tabs for each statement that you need to execute, and Studio preserves your created tabs when you switch between databases. You can add new tabs by clicking |icon-plus| , which creates a new tab to the right with a default name of SQL and an increasing number. This helps you keep track of your statements. - -.. image:: /_static/images/statement_pane_adding_statement_5.3.0.png - -You can also rename the default tab name by double-clicking it and typing a new name and write multiple statements in tandem in the same tab by separating them with semicolons (``;``).If too many tabs to fit into the Statement Pane are open at the same time, the tab arrows are displayed. You can scroll through the tabs by clicking |icon-left| or |icon-right|, and close tabs by clicking |icon-close|. You can also close all tabs at once by clicking **Close all** located to the right of the tabs. - -.. tip:: If this is your first time using SQream, see `First steps with SQream DB `_. - - -.. Keyboard shortcuts -.. ^^^^^^^^^^^^^^^^^^^^^^^^^ - -.. :kbd:`Ctrl` +: kbd:`Enter` - Execute all queries in the statement area, or just the highlighted part of the query. - -.. :kbd:`Ctrl` + :kbd:`Space` - Auto-complete the current keyword - -.. :kbd:`Ctrl` + :kbd:`↑` - Switch to next tab. - -.. :kbd:`Ctrl` + :kbd:`↓` - Switch to previous tab - -.. _studio_editor_results: - -:ref:`Back to Editor` - - -Viewing Statement and Query Results from the Results Panel ------------------------------------- -The results pane shows statment and query results. By default, only the first 10,000 results are returned, although you can modify this from the :ref:`studio_editor_toolbar`, as described above. - -.. image:: /_static/images/studio_editor_results_5053.png - -By default, executing several statements together opens a separate results tab for each statement. Executing statements together executes them serially, and any failed statement cancels all subsequent executions. - -The following is a brief description of the elements on the Results panel views: - -.. list-table:: - :widths: 45 160 - :header-rows: 1 - - * - Element - - Description - * - :ref:`Results view` - - Lets you view search query results. - * - :ref:`Execution Details view` - - Lets you view execution details, such as statement ID, number of rows, and averge number of rows in chunk. - * - :ref:`SQL view` - - Lets you see the SQL view. - * - :ref:`Save results to clipboard` - - Lets you save your search results to the clipboard to paste into another text editor. - * - :ref:`Save results to local file` - - Lets you save your search query results to a local file. - -.. _results_view: - - - -Searching Query Results in the Results View -^^^^^^^^^^^^ -The **Results view** lets you view search query results. - -From this view you can also do the following: - -* View the amount of time (in seconds) taken for a query to finish executing. -* Switch and scroll between tabs. -* Close all tabs at once. -* Enable keeping tabs by selecting **Keep tabs**. -* Sort column results. - -In the Results view you can also run parallel statements, as described in **Running Parallel Statements** below. - -.. _running_parallel_statements: - -Running Parallel Statements -^^^^^^^^^^^^ -While Studio's default functionality is to open a new tab for each executed statement, Studio supports running parallel statements in one statement tab. Running parallel statements requires using macros and is useful for advanced users. - -The following shows the syntax for running parallel statements: - -.. code-block:: console - - $ @@ parallel - $ $$ - $ select 1; - $ select 2; - $ select 3; - $ $$ - -The following figure shows the parallel statement syntax in the Editor: - -.. image:: /_static/images/running_parallel_statements.png - -.. _execution_details_view: - -Execution Details View -^^^^^^^^^^^^ -The **Execution Details** view lets you view a query’s execution plan for monitoring purposes. Most importantly, the Execution Details view highlights rows based on how long they ran relative to the entire query. - -This can be seen in the **timeSum** column as follows: - -* **Rows highlighted red** - longest runtime -* **Rows highlighted orange** - medium runtime -* **Rows highlighted yellow** - shortest runtime - -.. image:: /_static/images/execution_details_view_3.png - - - -.. _sql_view: - -Viewing Wrapped Strings in the SQL View -^^^^^^^^^^^^ -The SQL View panel allows you to more easily view certain queries, such as a long string that appears on one line. The SQL View makes it easier to see by wrapping it so that you can see the entire string at once. It also reformats and organizes query syntax entered in the Statement panel for more easily locating particular segments of your queries. The SQL View is identical to the **Format SQL** feature in the Toolbar, allowing you to retain your originally constructed query while viewing a more intuititively structured snapshot of it. - -The following figure shows the SQL view: - -.. image:: /_static/images/sql_view_5.0.3.png - -.. _save_results_to_clipboard: - -Saving Results to the Clipboard -^^^^^^^^^^^^ -The **Save results to clipboard** function lets you save your results to the clipboard to paste into another text editor or into Excel for further analysis. - - -.. _save_results_to_local_file: - -Saving Results to a Local File -^^^^^^^^^^^^ -The **Save results to local file** functions lets you save your search query results to a local file. Clicking **Save results to local file** downloads the contents of the Results panel to an Excel sheet. You can then use copy and paste this content into other editors as needed. - -Analyzing Results ----------------------------- - -When results are produced, a **Generate CREATE statement** button is displayed. Clicking this button creates a new tab with an optimized :ref:`create_table` statement, and an :ref:`insert` statement to copy the data to the new table. - -.. _logs: - -.. _logs_top: - -:ref:`Back to Editor` - -Viewing Logs -============ -The **Logs** screen is used for viewing logs and includes the following elements: - -.. list-table:: - :widths: 15 75 - :header-rows: 1 - - * - Element - - Description - * - :ref:`Filter area` - - Lets you filter the data shown in the table. - * - :ref:`Query tab` - - Shows basic query information logs, such as query number and the time the query was run. - * - :ref:`Session tab` - - Shows basic session information logs, such as session ID and user name. - * - :ref:`System tab` - - Shows all system logs. - * - :ref:`Log lines tab` - - Shows the total amount of log lines. - - -.. _filter: - -Filtering Table Data -------------- -From the Logs tab, from the **FILTERS** area you can also apply the **TIMESPAN**, **ONLY ERRORS**, and additional filters (**Add**). The **Timespan** filter lets you select a timespan. The **Only Errors** toggle button lets you show all queries, or only queries that generated errors. The **Add** button lets you add additional filters to the data shown in the table. The **Filter** button applies the selected filter(s). - - -Some filters require you to type text to define the filter. - -.. image:: /_static/images/logs_filters_5.3.0.png - -Other filters require you to select an item from a dropdown menu: - -* INFO -* WARNING -* ERROR -* FATAL -* SYSTEM - -You can also export a record of all of your currently filtered logs in Excel format by clicking **Download** located above the Filter area. - -.. _queries: - -:ref:`Back to Viewing Logs` - - -Viewing Query Logs ----------- -The **QUERIES** log area shows basic query information, such as query number and the time the query was run. The number next to the title indicates the amount of queries that have been run. - -From the Queries area you can see and sort by the following: - -* Query ID -* Start time -* Query -* Compilation duration -* Execution duration -* Total duration -* Details (execution details, error details, successful query details) - -In the Queries table, you can click on the **Statement ID** and **Query** items to set them as your filters. In the **Details** column you can also access additional details by clicking one of the **Details** options for a more detailed explanation of the query. - -:ref:`Back to Viewing Logs` - -.. _sessions: - -Viewing Session Logs ----------- -The **SESSIONS** tab shows the sessions log table and is used for viewing activity that has occurred during your sessions. The number at the top indicates the amount of sessions that have occurred. - -From here you can see and sort by the following: - -* Timestamp -* Connection ID -* Username -* Client IP -* Login (Success or Failed) -* Duration (of session) -* Configuration Changes - -In the Sessions table, you can click on the **Timestamp**, **Connection ID**, and **Username** items to set them as your filters. - -:ref:`Back to Viewing Logs` - -.. _system: - -Viewing System Logs ----------- -The **SYSTEM** tab shows the system log table and is used for viewing all system logs. The number at the top indicates the amount of sessions that have occurred. Because system logs occur less frequently than queries and sessions, you may need to increase the filter timespan for the table to display any system logs. - -From here you can see and sort by the following: - -* Timestamp -* Log type -* Message - -In the Systems table, you can click on the **Timestamp** and **Log type** items to set them as your filters. In the **Message** column, you can also click on an item to show more information about the message. - -:ref:`Back to Viewing Logs` - -.. _log_lines: - -Viewing All Log Lines ----------- -The **LOG LINES** tab is used for viewing the total amount of log lines in a table. From here users can view a more granular breakdown of log information collected by Studio. The other tabs (QUERIES, SESSIONS, and SYSTEM) show a filtered form of the raw log lines. For example, the QUERIES tab shows an aggregation of several log lines. - -From here you can see and sort by the following: - -* Timestamp -* Message level -* Worker hostname -* Worker port -* Connection ID -* Database name -* User name -* Statement ID - -In the **LOG LINES** table, you can click on any of the items to set them as your filters. - -:ref:`Back to Viewing Logs` - -:ref:`Back to Editor` - -.. _roles: - -Creating, Assigning, and Managing Roles and Permissions -============ -Overview ---------------- -In the **Roles** area you can create and assign roles and manage user permissions. - -The **Type** column displays one of the following assigned role types: - -.. list-table:: - :widths: 15 75 - :header-rows: 1 - - * - Role Type - - Description - * - Groups - - Roles with no users. - * - Enabled users - - Users with log-in permissions and a password. - * - Disabled users - - Users with log-in permissions and with a disabled password. An admin may disable a user's password permissions to temporary disable access to the system. - -.. note:: If you disable a password, when you enable it you have to create a new one. - - -Viewing Information About a Role --------------------- -Clicking a role in the roles table displays the following information: - - * **Parent Roles** - displays the parent roles of the selected role. Roles inherit all roles assigned to the parent. - * **Members** - displays all members that the role has been assigned to. The arrow indicates the roles that the role has inherited. Hovering over a member displays the roles that the role is inherited from. - * **Permissions** - displays the role's permissions. The arrow indicates the permissions that the role has inherited. Hovering over a permission displays the roles that the permission is inherited from. - -Creating a New Role --------------------- -You can create a new role by clicking **New Role**. - -.. image:: /_static/images/role_button.png - -An admin creates a **user** by granting login permissions and a password to a role. Each role is defined by a set of permissions. An admin can also group several roles together to form a **group** to manage them simultaneously. For example, permissions can be granted to or revoked on a group level. - -Clicking **New Role** lets you do the following: - - * Add and assign a role name (required) - * Enable or disable log-in permissions for the role. - * Set a password. - * Assign or delete parent roles. - * Add or delete permissions. - * Grant the selected user with superuser permissions. - -From the New Role panel you view directly and indirectly (or inherited) granted permissions. Disabled permissions have no connect permissions for the referenced database and are displayed in gray text. You can add or remove permissions from the **Add permissions** field. From the New Role panel you can also search and scroll through the permissions. In the **Search** field you can use the **and** operator to search for strings that fulfill multiple criteria. - -When adding a new role, you must select the **Enable login for this role** and **Has password** check boxes. - -Editing a Role --------------------- -Once you've created a role, clicking the **Edit Role** button lets you do the following: - - * Edit the role name. - * Enable or disable log-in permissions. - * Set a password. - * Assign or delete parent roles. - * Assign a role **administrator** permissions. - * Add or delete permissions. - * Grant the selected user with superuser permissions. - -From the Edit Role panel you view directly and indirectly (or inherited) granted permissions. Disabled permissions have no connect permissions for the referenced database and are displayed in gray text. You can add or remove permissions from the **Add permissions** field. From the Edit Role panel you can also search and scroll through the permissions. In the **Search** field you can use the **and** operator to search for strings that fulfill multiple criteria. - -Deleting a Role ------------------ -Clicking the **delete** icon displays a confirmation message with the amount of users and groups that will be impacted by deleting the role. diff --git a/sqream_studio_5.4.3/configuring_your_instance_of_sqream.rst b/sqream_studio_5.4.6/configuring_your_instance_of_sqream.rst similarity index 98% rename from sqream_studio_5.4.3/configuring_your_instance_of_sqream.rst rename to sqream_studio_5.4.6/configuring_your_instance_of_sqream.rst index e5f4b11e5..2b334cbfa 100644 --- a/sqream_studio_5.4.3/configuring_your_instance_of_sqream.rst +++ b/sqream_studio_5.4.6/configuring_your_instance_of_sqream.rst @@ -1,23 +1,23 @@ -.. _configuring_your_instance_of_sqream: - -**************************** -Configuring Your Instance of SQream -**************************** -The **Configuration** section lets you edit parameters from one centralized location. While you can edit these parameters from the **worker configuration file (config.json)** or from your CLI, you can also modify them in Studio in an easy-to-use format. - -Configuring your instance of SQream in Studio is session-based, which enables you to edit parameters per session on your own device. -Because session-based configurations are not persistent and are deleted when your session ends, you can edit your required parameters while avoiding conflicts between parameters edited on different devices at different points in time. - -Editing Your Parameters -------------------------------- -When configuring your instance of SQream in Studio you can edit parameters for the **Generic** and **Admin** parameters only. - -Studio includes two types of parameters: toggle switches, such as **flipJoinOrder**, and text fields, such as **logSysLevel**. After editing a parameter, you can reset each one to its previous value or to its default value individually, or revert all parameters to their default setting simultaneously. Note that you must click **Save** to save your configurations. - -You can hover over the **information** icon located on each parameter to read a short description of its behavior. - -Exporting and Importing Configuration Files -------------------------- -You can also export and import your configuration settings into a .json file. This allows you to easily edit your parameters and to share this file with other users if required. - +.. _configuring_your_instance_of_sqream: + +**************************** +Configuring Your Instance of SQream +**************************** +The **Configuration** section lets you edit parameters from one centralized location. While you can edit these parameters from the **worker configuration file (config.json)** or from your CLI, you can also modify them in Studio in an easy-to-use format. + +Configuring your instance of SQream in Studio is session-based, which enables you to edit parameters per session on your own device. +Because session-based configurations are not persistent and are deleted when your session ends, you can edit your required parameters while avoiding conflicts between parameters edited on different devices at different points in time. + +Editing Your Parameters +------------------------------- +When configuring your instance of SQream in Studio you can edit parameters for the **Generic** and **Admin** parameters only. + +Studio includes two types of parameters: toggle switches, such as **flipJoinOrder**, and text fields, such as **logSysLevel**. After editing a parameter, you can reset each one to its previous value or to its default value individually, or revert all parameters to their default setting simultaneously. Note that you must click **Save** to save your configurations. + +You can hover over the **information** icon located on each parameter to read a short description of its behavior. + +Exporting and Importing Configuration Files +------------------------- +You can also export and import your configuration settings into a .json file. This allows you to easily edit your parameters and to share this file with other users if required. + For more information about configuring your instance of SQream, see `Configuration Guides `_. \ No newline at end of file diff --git a/sqream_studio_5.4.3/creating_assigning_and_managing_roles_and_permissions.rst b/sqream_studio_5.4.6/creating_assigning_and_managing_roles_and_permissions.rst similarity index 95% rename from sqream_studio_5.4.3/creating_assigning_and_managing_roles_and_permissions.rst rename to sqream_studio_5.4.6/creating_assigning_and_managing_roles_and_permissions.rst index 325563761..b87b6f2cf 100644 --- a/sqream_studio_5.4.3/creating_assigning_and_managing_roles_and_permissions.rst +++ b/sqream_studio_5.4.6/creating_assigning_and_managing_roles_and_permissions.rst @@ -1,98 +1,98 @@ -.. _creating_assigning_and_managing_roles_and_permissions: - -.. _roles_5.4.3: - -**************************** -Creating, Assigning, and Managing Roles and Permissions -**************************** -The **Creating, Assigning, and Managing Roles and Permissions** describes the following: - -.. contents:: - :local: - :depth: 1 - -Overview ---------------- -In the **Roles** area you can create and assign roles and manage user permissions. - -The **Type** column displays one of the following assigned role types: - -.. list-table:: - :widths: 15 75 - :header-rows: 1 - - * - Role Type - - Description - * - Groups - - Roles with no users. - * - Enabled users - - Users with log-in permissions and a password. - * - Disabled users - - Users with log-in permissions and with a disabled password. An admin may disable a user's password permissions to temporary disable access to the system. - -.. note:: If you disable a password, when you enable it you have to create a new one. - -:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` - - -Viewing Information About a Role --------------------- -Clicking a role in the roles table displays the following information: - - * **Parent Roles** - displays the parent roles of the selected role. Roles inherit all roles assigned to the parent. - - :: - - * **Members** - displays all members that the role has been assigned to. The arrow indicates the roles that the role has inherited. Hovering over a member displays the roles that the role is inherited from. - - :: - - * **Permissions** - displays the role's permissions. The arrow indicates the permissions that the role has inherited. Hovering over a permission displays the roles that the permission is inherited from. - -:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` - - -Creating a New Role --------------------- -You can create a new role by clicking **New Role**. - - - -An admin creates a **user** by granting login permissions and a password to a role. Each role is defined by a set of permissions. An admin can also group several roles together to form a **group** to manage them simultaneously. For example, permissions can be granted to or revoked on a group level. - -Clicking **New Role** lets you do the following: - - * Add and assign a role name (required) - * Enable or disable log-in permissions for the role. - * Set a password. - * Assign or delete parent roles. - * Add or delete permissions. - * Grant the selected user with superuser permissions. - -From the New Role panel you view directly and indirectly (or inherited) granted permissions. Disabled permissions have no connect permissions for the referenced database and are displayed in gray text. You can add or remove permissions from the **Add permissions** field. From the New Role panel you can also search and scroll through the permissions. In the **Search** field you can use the **and** operator to search for strings that fulfill multiple criteria. - -When adding a new role, you must select the **Enable login for this role** and **Has password** check boxes. - -:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` - -Editing a Role --------------------- -Once you've created a role, clicking the **Edit Role** button lets you do the following: - - * Edit the role name. - * Enable or disable log-in permissions. - * Set a password. - * Assign or delete parent roles. - * Assign a role **administrator** permissions. - * Add or delete permissions. - * Grant the selected user with superuser permissions. - -From the Edit Role panel you view directly and indirectly (or inherited) granted permissions. Disabled permissions have no connect permissions for the referenced database and are displayed in gray text. You can add or remove permissions from the **Add permissions** field. From the Edit Role panel you can also search and scroll through the permissions. In the **Search** field you can use the **and** operator to search for strings that fulfill multiple criteria. - -:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` - -Deleting a Role ------------------ -Clicking the **delete** icon displays a confirmation message with the amount of users and groups that will be impacted by deleting the role. - -:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` \ No newline at end of file +.. _creating_assigning_and_managing_roles_and_permissions: + +.. _roles_5.4.6: + +**************************** +Creating, Assigning, and Managing Roles and Permissions +**************************** +The **Creating, Assigning, and Managing Roles and Permissions** describes the following: + +.. contents:: + :local: + :depth: 1 + +Overview +--------------- +In the **Roles** area you can create and assign roles and manage user permissions. + +The **Type** column displays one of the following assigned role types: + +.. list-table:: + :widths: 15 75 + :header-rows: 1 + + * - Role Type + - Description + * - Groups + - Roles with no users. + * - Enabled users + - Users with log-in permissions and a password. + * - Disabled users + - Users with log-in permissions and with a disabled password. An admin may disable a user's password permissions to temporary disable access to the system. + +.. note:: If you disable a password, when you enable it you have to create a new one. + +:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` + + +Viewing Information About a Role +-------------------- +Clicking a role in the roles table displays the following information: + + * **Parent Roles** - displays the parent roles of the selected role. Roles inherit all roles assigned to the parent. + + :: + + * **Members** - displays all members that the role has been assigned to. The arrow indicates the roles that the role has inherited. Hovering over a member displays the roles that the role is inherited from. + + :: + + * **Permissions** - displays the role's permissions. The arrow indicates the permissions that the role has inherited. Hovering over a permission displays the roles that the permission is inherited from. + +:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` + + +Creating a New Role +-------------------- +You can create a new role by clicking **New Role**. + + + +An admin creates a **user** by granting login permissions and a password to a role. Each role is defined by a set of permissions. An admin can also group several roles together to form a **group** to manage them simultaneously. For example, permissions can be granted to or revoked on a group level. + +Clicking **New Role** lets you do the following: + + * Add and assign a role name (required) + * Enable or disable log-in permissions for the role. + * Set a password. + * Assign or delete parent roles. + * Add or delete permissions. + * Grant the selected user with superuser permissions. + +From the New Role panel you view directly and indirectly (or inherited) granted permissions. Disabled permissions have no connect permissions for the referenced database and are displayed in gray text. You can add or remove permissions from the **Add permissions** field. From the New Role panel you can also search and scroll through the permissions. In the **Search** field you can use the **and** operator to search for strings that fulfill multiple criteria. + +When adding a new role, you must select the **Enable login for this role** and **Has password** check boxes. + +:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` + +Editing a Role +-------------------- +Once you've created a role, clicking the **Edit Role** button lets you do the following: + + * Edit the role name. + * Enable or disable log-in permissions. + * Set a password. + * Assign or delete parent roles. + * Assign a role **administrator** permissions. + * Add or delete permissions. + * Grant the selected user with superuser permissions. + +From the Edit Role panel you view directly and indirectly (or inherited) granted permissions. Disabled permissions have no connect permissions for the referenced database and are displayed in gray text. You can add or remove permissions from the **Add permissions** field. From the Edit Role panel you can also search and scroll through the permissions. In the **Search** field you can use the **and** operator to search for strings that fulfill multiple criteria. + +:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` + +Deleting a Role +----------------- +Clicking the **delete** icon displays a confirmation message with the amount of users and groups that will be impacted by deleting the role. + +:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` \ No newline at end of file diff --git a/sqream_studio_5.4.3/executing_statements_and_running_queries_from_the_editor.rst b/sqream_studio_5.4.6/executing_statements_and_running_queries_from_the_editor.rst similarity index 92% rename from sqream_studio_5.4.3/executing_statements_and_running_queries_from_the_editor.rst rename to sqream_studio_5.4.6/executing_statements_and_running_queries_from_the_editor.rst index e1b6765eb..9640665da 100644 --- a/sqream_studio_5.4.3/executing_statements_and_running_queries_from_the_editor.rst +++ b/sqream_studio_5.4.6/executing_statements_and_running_queries_from_the_editor.rst @@ -1,492 +1,492 @@ -.. _executing_statements_and_running_queries_from_the_editor: - -.. _editor_top_5.4.3: - -**************************** -Executing Statements and Running Queries from the Editor -**************************** -The **Editor** is used for the following: - -* Selecting an active database and executing queries. -* Performing statement-related operations and showing metadata. -* Executing pre-defined queries. -* Writing queries and statements and viewing query results. - -The following is a brief description of the Editor panels: - - -.. list-table:: - :widths: 10 34 56 - :header-rows: 1 - - * - No. - - Element - - Description - * - 1 - - :ref:`Toolbar` - - Used to select the active database you want to work on, limit the number of rows, save query, etc. - * - 2 - - :ref:`Database Tree and System Queries panel` - - Shows a hierarchy tree of databases, views, tables, and columns - * - 3 - - :ref:`Statement panel` - - Used for writing queries and statements - * - 4 - - :ref:`Results panel` - - Shows query results and execution information. - - - -.. _top_5.4.3: - -.. _studio_5.4.3_editor_toolbar: - -Executing Statements from the Toolbar -================ -You can access the following from the Toolbar pane: - -* **Database dropdown list** - select a database that you want to run statements on. - - :: - -* **Service dropdown list** - select a service that you want to run statements on. The options in the service dropdown menu depend on the database you select from the **Database** dropdown list. - - :: - -* **Execute** - lets you set which statements to execute. The **Execute** button toggles between **Execute** and **Stop**, and can be used to stop an active statement before it completes: - - * **Statements** - executes the statement at the location of the cursor. - * **Selected** - executes only the highlighted text. This mode should be used when executing subqueries or sections of large queries (as long as they are valid SQLs). - * **All** - executes all statements in a selected tab. - -* **Format SQL** - Lets you reformat and reindent statements. - - :: - -* **Download query** - Lets you download query text to your computer. - - :: - -* **Open query** - Lets you upload query text from your computer. - - :: - -* **Max Rows** - By default, the Editor fetches only the first 10,000 rows. You can modify this number by selecting an option from the **Max Rows** dropdown list. Note that setting a higher number may slow down your browser if the result is very large. This number is limited to 100,000 results. To see a higher number, you can save the results in a file or a table using the :ref:`create_table_as` command. - - -For more information on stopping active statements, see the :ref:`STOP_STATEMENT` command. - -:ref:`Back to Executing Statements and Running Queries from the Editor` - - -.. _studio_5.4.3_editor_db_tree: - -Performing Statement-Related Operations from the Database Tree -================ -From the Database Tree you can perform statement-related operations and show metadata (such as a number indicating the amount of rows in the table). - - - - - -The database object functions are used to perform the following: - -* The **SELECT** statement - copies the selected table's **columns** into the Statement panel as ``SELECT`` parameters. - - :: - -* The **copy** feature |icon-copy| - copies the selected table's **name** into the Statement panel. - - :: - -* The **additional operations** |icon-dots| - displays the following additional options: - - -.. |icon-user| image:: /_static/images/studio_icon_user.png - :align: middle - -.. |icon-dots| image:: /_static/images/studio_icon_dots.png - :align: middle - -.. |icon-editor| image:: /_static/images/studio_icon_editor.png - :align: middle - -.. |icon-copy| image:: /_static/images/studio_icon_copy.png - :align: middle - -.. |icon-select| image:: /_static/images/studio_icon_select.png - :align: middle - -.. |icon-dots| image:: /_static/images/studio_icon_dots.png - :align: middle - -.. |icon-filter| image:: /_static/images/studio_icon_filter.png - :align: middle - -.. |icon-ddl-edit| image:: /_static/images/studio_icon_ddl_edit.png - :align: middle - -.. |icon-run-optimizer| image:: /_static/images/studio_icon_run_optimizer.png - :align: middle - -.. |icon-generate-create-statement| image:: /_static/images/studio_icon_generate_create_statement.png - :align: middle - -.. |icon-plus| image:: /_static/images/studio_icon_plus.png - :align: middle - -.. |icon-close| image:: /_static/images/studio_icon_close.png - :align: middle - -.. |icon-left| image:: /_static/images/studio_icon_left.png - :align: middle - -.. |icon-right| image:: /_static/images/studio_icon_right.png - :align: middle - -.. |icon-format-sql| image:: /_static/images/studio_icon_format.png - :align: middle - -.. |icon-download-query| image:: /_static/images/studio_icon_download_query.png - :align: middle - -.. |icon-open-query| image:: /_static/images/studio_icon_open_query.png - :align: middle - -.. |icon-execute| image:: /_static/images/studio_icon_execute.png - :align: middle - -.. |icon-stop| image:: /_static/images/studio_icon_stop.png - :align: middle - -.. |icon-dashboard| image:: /_static/images/studio_icon_dashboard.png - :align: middle - -.. |icon-expand| image:: /_static/images/studio_icon_expand.png - :align: middle - -.. |icon-scale| image:: /_static/images/studio_icon_scale.png - :align: middle - -.. |icon-expand-down| image:: /_static/images/studio_icon_expand_down.png - :align: middle - -.. |icon-add| image:: /_static/images/studio_icon_add.png - :align: middle - -.. |icon-add-worker| image:: /_static/images/studio_icon_add_worker.png - :align: middle - -.. |keep-tabs| image:: /_static/images/studio_keep_tabs.png - :align: middle - - -.. list-table:: - :widths: 30 70 - :header-rows: 1 - - * - Function - - Description - * - Insert statement - - Generates an `INSERT `_ statement for the selected table in the editing area. - * - Delete statement - - Generates a `DELETE `_ statement for the selected table in the editing area. - * - Create Table As statement - - Generates a `CREATE TABLE AS `_ statement for the selected table in the editing area. - * - Rename statement - - Generates an `RENAME TABLE AS `_ statement for renaming the selected table in the editing area. - * - Adding column statement - - Generates an `ADD COLUMN `_ statement for adding columns to the selected table in the editing area. - * - Truncate table statement - - Generates a `TRUNCATE_IF_EXISTS `_ statement for the selected table in the editing area. - * - Drop table statement - - Generates a ``DROP`` statement for the selected object in the editing area. - * - Table DDL - - Generates a DDL statement for the selected object in the editing area. To get the entire database DDL, click the |icon-ddl-edit| icon next to the database name in the tree root. See `Seeing System Objects as DDL `_. - * - DDL Optimizer - - The `DDL Optimizer `_ lets you analyze database tables and recommends possible optimizations. - -Optimizing Database Tables Using the DDL Optimizer ------------------------ -The **DDL Optimizer** tab analyzes database tables and recommends possible optimizations according to SQream's best practices. - -As described in the previous table, you can access the DDL Optimizer by clicking the **additional options icon** and selecting **DDL Optimizer**. - -The following table describes the DDL Optimizer screen: - -.. list-table:: - :widths: 15 75 - :header-rows: 1 - - * - Element - - Description - * - Column area - - Shows the column **names** and **column types** from the selected table. You can scroll down or to the right/left for long column lists. - * - Optimization area - - Shows the number of rows to sample as the basis for running an optimization, the default setting (1,000,000) when running an optimization (this is also the overhead threshold used when analyzing ``TEXT`` fields), and the default percent buffer to add to ``TEXT`` lengths (10%). Attempts to determine field nullability. - * - Run Optimizer - - Starts the optimization process. - -Clicking **Run Optimizer** adds a tab to the Statement panel showing the optimized results of the selected object. - -For more information, see `Optimization and Best Practices `_. - -Executing Pre-Defined Queries from the System Queries Panel ---------------- -The **System Queries** panel lets you execute predefined queries and includes the following system query types: - -* **Catalog queries** - Used for analyzing table compression rates, users and permissions, etc. - - :: - -* **Admin queries** - Queries useful for SQream database management. - -Clicking an item pastes the query into the Statement pane, and you can undo a previous operation by pressing **Ctrl + Z**. - -.. _studio_5.4.3_editor_statement_area: - -Writing Statements and Queries from the Statement Panel -============== -The multi-tabbed statement area is used for writing queries and statements, and is used in tandem with the toolbar. When writing and executing statements, you must first select a database from the **Database** dropdown menu in the toolbar. When you execute a statement, it passes through a series of statuses until completed. Knowing the status helps you with statement maintenance, and the statuses are shown in the **Results panel**. - -The auto-complete feature assists you when writing statements by suggesting statement options. - -The following table shows the statement statuses: - -.. list-table:: - :widths: 45 160 - :header-rows: 1 - - * - Status - - Description - * - Pending - - The statement is pending. - * - In queue - - The statement is waiting for execution. - * - Initializing - - The statement has entered execution checks. - * - Executing - - The statement is executing. - * - Statement stopped - - The statement has been stopped. - -You can add and name new tabs for each statement that you need to execute, and Studio preserves your created tabs when you switch between databases. You can add new tabs by clicking |icon-plus| , which creates a new tab to the right with a default name of SQL and an increasing number. This helps you keep track of your statements. - -You can also rename the default tab name by double-clicking it and typing a new name and write multiple statements in tandem in the same tab by separating them with semicolons (``;``).If too many tabs to fit into the Statement Pane are open at the same time, the tab arrows are displayed. You can scroll through the tabs by clicking |icon-left| or |icon-right|, and close tabs by clicking |icon-close|. You can also close all tabs at once by clicking **Close all** located to the right of the tabs. - -.. tip:: If this is your first time using SQream, see `Getting Started `_. - - -.. Keyboard shortcuts -.. ^^^^^^^^^^^^^^^^^^^^^^^^^ - -.. :kbd:`Ctrl` +: kbd:`Enter` - Execute all queries in the statement area, or just the highlighted part of the query. - -.. :kbd:`Ctrl` + :kbd:`Space` - Auto-complete the current keyword - -.. :kbd:`Ctrl` + :kbd:`↑` - Switch to next tab. - -.. :kbd:`Ctrl` + :kbd:`↓` - Switch to previous tab - -.. _studio_editor_results_5.4.3: - -:ref:`Back to Executing Statements and Running Queries from the Editor` - -.. _studio_5.4.3_editor_results: - -.. _results_panel_5.4.3: - -Viewing Statement and Query Results from the Results Panel -============== -The results panel shows statement and query results. By default, only the first 10,000 results are returned, although you can modify this from the :ref:`studio_editor_toolbar`, as described above. By default, executing several statements together opens a separate results tab for each statement. Executing statements together executes them serially, and any failed statement cancels all subsequent executions. - -.. image:: /_static/images/results_panel.png - -The following is a brief description of the Results panel views highlighted in the figure above: - -.. list-table:: - :widths: 45 160 - :header-rows: 1 - - * - Element - - Description - * - :ref:`Results view` - - Lets you view search query results. - * - :ref:`Execution Details view` - - Lets you analyze your query for troubleshooting and optimization purposes. - * - :ref:`SQL view` - - Lets you see the SQL view. - - -.. _results_view_5.4.3: - -:ref:`Back to Executing Statements and Running Queries from the Editor` - -Searching Query Results in the Results View ----------------- -The **Results view** lets you view search query results. - -From this view you can also do the following: - -* View the amount of time (in seconds) taken for a query to finish executing. -* Switch and scroll between tabs. -* Close all tabs at once. -* Enable keeping tabs by selecting **Keep tabs**. -* Sort column results. - -Saving Results to the Clipboard -^^^^^^^^^^^^ -The **Save results to clipboard** function lets you save your results to the clipboard to paste into another text editor or into Excel for further analysis. - -.. _save_results_to_local_file_5.4.3: - -Saving Results to a Local File -^^^^^^^^^^^^ -The **Save results to local file** functions lets you save your search query results to a local file. Clicking **Save results to local file** downloads the contents of the Results panel to an Excel sheet. You can then use copy and paste this content into other editors as needed. - -In the Results view you can also run parallel statements, as described in **Running Parallel Statements** below. - -.. _running_parallel_statements_5.4.3: - -Running Parallel Statements -^^^^^^^^^^^^ -While Studio's default functionality is to open a new tab for each executed statement, Studio supports running parallel statements in one statement tab. Running parallel statements requires using macros and is useful for advanced users. - -The following shows the syntax for running parallel statements: - -.. code-block:: console - - $ @@ parallel - $ $$ - $ select 1; - $ select 2; - $ select 3; - $ $$ - - -:ref:`Back to Viewing Statement and Query Results from the Results Panel` - -.. _execution_details_view_5.4.3: - -.. _execution_tree_5.4.3: - -Execution Details View --------------- -The **Execution Details View** section describes the following: - -.. contents:: - :local: - :depth: 1 - -Overview -^^^^^^^^^^^^ -Clicking **Execution Details View** displays the **Execution Tree**, which is a chronological tree of processes that occurred to execute your queries. The purpose of the Execution Tree is to analyze all aspects of your query for troubleshooting and optimization purposes, such as resolving queries with an exceptionally long runtime. - -.. note:: The **Execution Details View** button is enabled only when a query takes longer than five seconds. - -From this screen you can scroll in, out, and around the execution tree with the mouse to analyze all aspects of your query. You can navigate around the execution tree by dragging or by using the mini-map in the bottom right corner. - -.. image:: /_static/images/execution_tree_1.png - -You can also search for query data by pressing **Ctrl+F** or clicking the search icon |icon-search| in the search field in the top right corner and typing text. - -.. image:: /_static/images/search_field.png - -Pressing **Enter** takes you directly to the next result matching your search criteria, and pressing **Shift + Enter** takes you directly to the previous result. You can also search next and previous results using the up and down arrows. - -.. |icon-search| image:: /_static/images/studio_icon_search.png - :align: middle - -The nodes are color-coded based on the following: - -* **Slow nodes** - red -* **In progress nodes** - yellow -* **Completed nodes** - green -* **Pending nodes** - white -* **Currently selected node** - blue -* **Search result node** - purple (in the mini-map) - -The execution tree displays the same information as shown in the plain view in tree format. - -The Execution Tree tracks each phase of your query in real time as a vertical tree of nodes. Each node refers to an operation that occurred on the GPU or CPU. When a phase is completed, the next branch begins to its right until the entire query is complete. Joins are displayed as two parallel branches merged together in a node called **Join**, as shown in the figure above. The nodes are connected by a line indicating the number of rows passed from one node to the next. The width of the line indicates the amount of rows on a logarithmic scale. - -Each node displays a number displaying its **node ID**, its **type**, **table name** (if relevant), **status**, and **runtime**. The nodes are color-coded for easy identification. Green nodes indicate **completed nodes**, yellow indicates **nodes in progress**, and red indicates **slowest nodes**, typically joins, as shown below: - -.. image:: /_static/images/nodes.png - -Viewing Query Statistics -^^^^^^^^^^^^ -The following statistical information is displayed in the top left corner, as shown in the figure above: - -* **Query Statistics**: - - * **Elapsed** - the total time taken for the query to complete. - * **Result rows** - the amount of rows fetched. - * **Running nodes completion** - * **Total query completion** - the amount of the total execution tree that was executed (nodes marked green). - -* **Slowest Nodes** information is displayed in the top right corner in red text. Clicking the slowest node centers automatically on that node in the execution tree. - -You can also view the following **Node Statistics** in the top right corner for each individual node by clicking a node: - -.. list-table:: - :widths: 45 160 - :header-rows: 1 - - * - Element - - Description - * - Node type - - Shows the node type. - * - Status - - Shows the execution status. - * - Time - - The total time taken to execute. - * - Rows - - Shows the number of produced rows passed to the next node. - * - Chunks - - Shows number of produced chunks. - * - Average rows per chunk - - Shows the number of average rows per chunk. - * - Table (for **ReadTable** and joins only) - - Shows the table name. - * - Write (for joins only) - - Shows the total date size written to the disk. - * - Read (for **ReadTable** and joins only) - - Shows the total data size read from the disk. - -Note that you can scroll the Node Statistics table. You can also download the execution plan table in .csv format by clicking the download arrow |icon-download| in the upper-right corner. - -.. |icon-download| image:: /_static/images/studio_icon_download.png - :align: middle - -Using the Plain View -^^^^^^^^^^^^ -You can use the **Plain View** instead of viewing the execution tree by clicking **Plain View** |icon-plain| in the top right corner. The plain view displays the same information as shown in the execution tree in table format. - -.. |icon-plain| image:: /_static/images/studio_icon_plain.png - :align: middle - - - - -The plain view lets you view a query’s execution plan for monitoring purposes and highlights rows based on how long they ran relative to the entire query. - -This can be seen in the **timeSum** column as follows: - -* **Rows highlighted red** - longest runtime -* **Rows highlighted orange** - medium runtime -* **Rows highlighted yellow** - shortest runtime - -:ref:`Back to Viewing Statement and Query Results from the Results Panel` - -.. _sql_view_5.4.3: - -Viewing Wrapped Strings in the SQL View ------------------- -The SQL View panel allows you to more easily view certain queries, such as a long string that appears on one line. The SQL View makes it easier to see by wrapping it so that you can see the entire string at once. It also reformats and organizes query syntax entered in the Statement panel for more easily locating particular segments of your queries. The SQL View is identical to the **Format SQL** feature in the Toolbar, allowing you to retain your originally constructed query while viewing a more intuitively structured snapshot of it. - -.. _save_results_to_clipboard_5.4.3: - -:ref:`Back to Viewing Statement and Query Results from the Results Panel` - -:ref:`Back to Executing Statements and Running Queries from the Editor` +.. _executing_statements_and_running_queries_from_the_editor: + +.. _editor_top_5.4.6: + +**************************** +Executing Statements and Running Queries from the Editor +**************************** +The **Editor** is used for the following: + +* Selecting an active database and executing queries. +* Performing statement-related operations and showing metadata. +* Executing pre-defined queries. +* Writing queries and statements and viewing query results. + +The following is a brief description of the Editor panels: + + +.. list-table:: + :widths: 10 34 56 + :header-rows: 1 + + * - No. + - Element + - Description + * - 1 + - :ref:`Toolbar` + - Used to select the active database you want to work on, limit the number of rows, save query, etc. + * - 2 + - :ref:`Database Tree and System Queries panel` + - Shows a hierarchy tree of databases, views, tables, and columns + * - 3 + - :ref:`Statement panel` + - Used for writing queries and statements + * - 4 + - :ref:`Results panel` + - Shows query results and execution information. + + + +.. _top_5.4.6: + +.. _studio_5.4.6_editor_toolbar: + +Executing Statements from the Toolbar +================ +You can access the following from the Toolbar pane: + +* **Database dropdown list** - select a database that you want to run statements on. + + :: + +* **Service dropdown list** - select a service that you want to run statements on. The options in the service dropdown menu depend on the database you select from the **Database** dropdown list. + + :: + +* **Execute** - lets you set which statements to execute. The **Execute** button toggles between **Execute** and **Stop**, and can be used to stop an active statement before it completes: + + * **Statements** - executes the statement at the location of the cursor. + * **Selected** - executes only the highlighted text. This mode should be used when executing subqueries or sections of large queries (as long as they are valid SQLs). + * **All** - executes all statements in a selected tab. + +* **Format SQL** - Lets you reformat and reindent statements. + + :: + +* **Download query** - Lets you download query text to your computer. + + :: + +* **Open query** - Lets you upload query text from your computer. + + :: + +* **Max Rows** - By default, the Editor fetches only the first 10,000 rows. You can modify this number by selecting an option from the **Max Rows** dropdown list. Note that setting a higher number may slow down your browser if the result is very large. This number is limited to 100,000 results. To see a higher number, you can save the results in a file or a table using the :ref:`create_table_as` command. + + +For more information on stopping active statements, see the :ref:`STOP_STATEMENT` command. + +:ref:`Back to Executing Statements and Running Queries from the Editor` + + +.. _studio_5.4.6_editor_db_tree: + +Performing Statement-Related Operations from the Database Tree +================ +From the Database Tree you can perform statement-related operations and show metadata (such as a number indicating the amount of rows in the table). + + + + + +The database object functions are used to perform the following: + +* The **SELECT** statement - copies the selected table's **columns** into the Statement panel as ``SELECT`` parameters. + + :: + +* The **copy** feature |icon-copy| - copies the selected table's **name** into the Statement panel. + + :: + +* The **additional operations** |icon-dots| - displays the following additional options: + + +.. |icon-user| image:: /_static/images/studio_icon_user.png + :align: middle + +.. |icon-dots| image:: /_static/images/studio_icon_dots.png + :align: middle + +.. |icon-editor| image:: /_static/images/studio_icon_editor.png + :align: middle + +.. |icon-copy| image:: /_static/images/studio_icon_copy.png + :align: middle + +.. |icon-select| image:: /_static/images/studio_icon_select.png + :align: middle + +.. |icon-dots| image:: /_static/images/studio_icon_dots.png + :align: middle + +.. |icon-filter| image:: /_static/images/studio_icon_filter.png + :align: middle + +.. |icon-ddl-edit| image:: /_static/images/studio_icon_ddl_edit.png + :align: middle + +.. |icon-run-optimizer| image:: /_static/images/studio_icon_run_optimizer.png + :align: middle + +.. |icon-generate-create-statement| image:: /_static/images/studio_icon_generate_create_statement.png + :align: middle + +.. |icon-plus| image:: /_static/images/studio_icon_plus.png + :align: middle + +.. |icon-close| image:: /_static/images/studio_icon_close.png + :align: middle + +.. |icon-left| image:: /_static/images/studio_icon_left.png + :align: middle + +.. |icon-right| image:: /_static/images/studio_icon_right.png + :align: middle + +.. |icon-format-sql| image:: /_static/images/studio_icon_format.png + :align: middle + +.. |icon-download-query| image:: /_static/images/studio_icon_download_query.png + :align: middle + +.. |icon-open-query| image:: /_static/images/studio_icon_open_query.png + :align: middle + +.. |icon-execute| image:: /_static/images/studio_icon_execute.png + :align: middle + +.. |icon-stop| image:: /_static/images/studio_icon_stop.png + :align: middle + +.. |icon-dashboard| image:: /_static/images/studio_icon_dashboard.png + :align: middle + +.. |icon-expand| image:: /_static/images/studio_icon_expand.png + :align: middle + +.. |icon-scale| image:: /_static/images/studio_icon_scale.png + :align: middle + +.. |icon-expand-down| image:: /_static/images/studio_icon_expand_down.png + :align: middle + +.. |icon-add| image:: /_static/images/studio_icon_add.png + :align: middle + +.. |icon-add-worker| image:: /_static/images/studio_icon_add_worker.png + :align: middle + +.. |keep-tabs| image:: /_static/images/studio_keep_tabs.png + :align: middle + + +.. list-table:: + :widths: 30 70 + :header-rows: 1 + + * - Function + - Description + * - Insert statement + - Generates an `INSERT `_ statement for the selected table in the editing area. + * - Delete statement + - Generates a `DELETE `_ statement for the selected table in the editing area. + * - Create Table As statement + - Generates a `CREATE TABLE AS `_ statement for the selected table in the editing area. + * - Rename statement + - Generates an `RENAME TABLE AS `_ statement for renaming the selected table in the editing area. + * - Adding column statement + - Generates an `ADD COLUMN `_ statement for adding columns to the selected table in the editing area. + * - Truncate table statement + - Generates a `TRUNCATE_IF_EXISTS `_ statement for the selected table in the editing area. + * - Drop table statement + - Generates a ``DROP`` statement for the selected object in the editing area. + * - Table DDL + - Generates a DDL statement for the selected object in the editing area. To get the entire database DDL, click the |icon-ddl-edit| icon next to the database name in the tree root. See `Seeing System Objects as DDL `_. + * - DDL Optimizer + - The `DDL Optimizer `_ lets you analyze database tables and recommends possible optimizations. + +Optimizing Database Tables Using the DDL Optimizer +----------------------- +The **DDL Optimizer** tab analyzes database tables and recommends possible optimizations according to SQream's best practices. + +As described in the previous table, you can access the DDL Optimizer by clicking the **additional options icon** and selecting **DDL Optimizer**. + +The following table describes the DDL Optimizer screen: + +.. list-table:: + :widths: 15 75 + :header-rows: 1 + + * - Element + - Description + * - Column area + - Shows the column **names** and **column types** from the selected table. You can scroll down or to the right/left for long column lists. + * - Optimization area + - Shows the number of rows to sample as the basis for running an optimization, the default setting (1,000,000) when running an optimization (this is also the overhead threshold used when analyzing ``TEXT`` fields), and the default percent buffer to add to ``TEXT`` lengths (10%). Attempts to determine field nullability. + * - Run Optimizer + - Starts the optimization process. + +Clicking **Run Optimizer** adds a tab to the Statement panel showing the optimized results of the selected object. + +For more information, see `Optimization and Best Practices `_. + +Executing Pre-Defined Queries from the System Queries Panel +--------------- +The **System Queries** panel lets you execute predefined queries and includes the following system query types: + +* **Catalog queries** - Used for analyzing table compression rates, users and permissions, etc. + + :: + +* **Admin queries** - Queries useful for SQream database management. + +Clicking an item pastes the query into the Statement pane, and you can undo a previous operation by pressing **Ctrl + Z**. + +.. _studio_5.4.6_editor_statement_area: + +Writing Statements and Queries from the Statement Panel +============== +The multi-tabbed statement area is used for writing queries and statements, and is used in tandem with the toolbar. When writing and executing statements, you must first select a database from the **Database** dropdown menu in the toolbar. When you execute a statement, it passes through a series of statuses until completed. Knowing the status helps you with statement maintenance, and the statuses are shown in the **Results panel**. + +The auto-complete feature assists you when writing statements by suggesting statement options. + +The following table shows the statement statuses: + +.. list-table:: + :widths: 45 160 + :header-rows: 1 + + * - Status + - Description + * - Pending + - The statement is pending. + * - In queue + - The statement is waiting for execution. + * - Initializing + - The statement has entered execution checks. + * - Executing + - The statement is executing. + * - Statement stopped + - The statement has been stopped. + +You can add and name new tabs for each statement that you need to execute, and Studio preserves your created tabs when you switch between databases. You can add new tabs by clicking |icon-plus| , which creates a new tab to the right with a default name of SQL and an increasing number. This helps you keep track of your statements. + +You can also rename the default tab name by double-clicking it and typing a new name and write multiple statements in tandem in the same tab by separating them with semicolons (``;``).If too many tabs to fit into the Statement Pane are open at the same time, the tab arrows are displayed. You can scroll through the tabs by clicking |icon-left| or |icon-right|, and close tabs by clicking |icon-close|. You can also close all tabs at once by clicking **Close all** located to the right of the tabs. + +.. tip:: If this is your first time using SQream, see `Getting Started `_. + + +.. Keyboard shortcuts +.. ^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. :kbd:`Ctrl` +: kbd:`Enter` - Execute all queries in the statement area, or just the highlighted part of the query. + +.. :kbd:`Ctrl` + :kbd:`Space` - Auto-complete the current keyword + +.. :kbd:`Ctrl` + :kbd:`↑` - Switch to next tab. + +.. :kbd:`Ctrl` + :kbd:`↓` - Switch to previous tab + +.. _studio_editor_results_5.4.6: + +:ref:`Back to Executing Statements and Running Queries from the Editor` + +.. _studio_5.4.6_editor_results: + +.. _results_panel_5.4.6: + +Viewing Statement and Query Results from the Results Panel +============== +The results panel shows statement and query results. By default, only the first 10,000 results are returned, although you can modify this from the :ref:`studio_editor_toolbar`, as described above. By default, executing several statements together opens a separate results tab for each statement. Executing statements together executes them serially, and any failed statement cancels all subsequent executions. + +.. image:: /_static/images/results_panel.png + +The following is a brief description of the Results panel views highlighted in the figure above: + +.. list-table:: + :widths: 45 160 + :header-rows: 1 + + * - Element + - Description + * - :ref:`Results view` + - Lets you view search query results. + * - :ref:`Execution Details view` + - Lets you analyze your query for troubleshooting and optimization purposes. + * - :ref:`SQL view` + - Lets you see the SQL view. + + +.. _results_view_5.4.6: + +:ref:`Back to Executing Statements and Running Queries from the Editor` + +Searching Query Results in the Results View +---------------- +The **Results view** lets you view search query results. + +From this view you can also do the following: + +* View the amount of time (in seconds) taken for a query to finish executing. +* Switch and scroll between tabs. +* Close all tabs at once. +* Enable keeping tabs by selecting **Keep tabs**. +* Sort column results. + +Saving Results to the Clipboard +^^^^^^^^^^^^ +The **Save results to clipboard** function lets you save your results to the clipboard to paste into another text editor or into Excel for further analysis. + +.. _save_results_to_local_file_5.4.6: + +Saving Results to a Local File +^^^^^^^^^^^^ +The **Save results to local file** functions lets you save your search query results to a local file. Clicking **Save results to local file** downloads the contents of the Results panel to an Excel sheet. You can then use copy and paste this content into other editors as needed. + +In the Results view you can also run parallel statements, as described in **Running Parallel Statements** below. + +.. _running_parallel_statements_5.4.6: + +Running Parallel Statements +^^^^^^^^^^^^ +While Studio's default functionality is to open a new tab for each executed statement, Studio supports running parallel statements in one statement tab. Running parallel statements requires using macros and is useful for advanced users. + +The following shows the syntax for running parallel statements: + +.. code-block:: console + + $ @@ parallel + $ $$ + $ select 1; + $ select 2; + $ select 3; + $ $$ + + +:ref:`Back to Viewing Statement and Query Results from the Results Panel` + +.. _execution_details_view_5.4.6: + +.. _execution_tree_5.4.6: + +Execution Details View +-------------- +The **Execution Details View** section describes the following: + +.. contents:: + :local: + :depth: 1 + +Overview +^^^^^^^^^^^^ +Clicking **Execution Details View** displays the **Execution Tree**, which is a chronological tree of processes that occurred to execute your queries. The purpose of the Execution Tree is to analyze all aspects of your query for troubleshooting and optimization purposes, such as resolving queries with an exceptionally long runtime. + +.. note:: The **Execution Details View** button is enabled only when a query takes longer than five seconds. + +From this screen you can scroll in, out, and around the execution tree with the mouse to analyze all aspects of your query. You can navigate around the execution tree by dragging or by using the mini-map in the bottom right corner. + +.. image:: /_static/images/execution_tree_1.png + +You can also search for query data by pressing **Ctrl+F** or clicking the search icon |icon-search| in the search field in the top right corner and typing text. + +.. image:: /_static/images/search_field.png + +Pressing **Enter** takes you directly to the next result matching your search criteria, and pressing **Shift + Enter** takes you directly to the previous result. You can also search next and previous results using the up and down arrows. + +.. |icon-search| image:: /_static/images/studio_icon_search.png + :align: middle + +The nodes are color-coded based on the following: + +* **Slow nodes** - red +* **In progress nodes** - yellow +* **Completed nodes** - green +* **Pending nodes** - white +* **Currently selected node** - blue +* **Search result node** - purple (in the mini-map) + +The execution tree displays the same information as shown in the plain view in tree format. + +The Execution Tree tracks each phase of your query in real time as a vertical tree of nodes. Each node refers to an operation that occurred on the GPU or CPU. When a phase is completed, the next branch begins to its right until the entire query is complete. Joins are displayed as two parallel branches merged together in a node called **Join**, as shown in the figure above. The nodes are connected by a line indicating the number of rows passed from one node to the next. The width of the line indicates the amount of rows on a logarithmic scale. + +Each node displays a number displaying its **node ID**, its **type**, **table name** (if relevant), **status**, and **runtime**. The nodes are color-coded for easy identification. Green nodes indicate **completed nodes**, yellow indicates **nodes in progress**, and red indicates **slowest nodes**, typically joins, as shown below: + +.. image:: /_static/images/nodes.png + +Viewing Query Statistics +^^^^^^^^^^^^ +The following statistical information is displayed in the top left corner, as shown in the figure above: + +* **Query Statistics**: + + * **Elapsed** - the total time taken for the query to complete. + * **Result rows** - the amount of rows fetched. + * **Running nodes completion** + * **Total query completion** - the amount of the total execution tree that was executed (nodes marked green). + +* **Slowest Nodes** information is displayed in the top right corner in red text. Clicking the slowest node centers automatically on that node in the execution tree. + +You can also view the following **Node Statistics** in the top right corner for each individual node by clicking a node: + +.. list-table:: + :widths: 45 160 + :header-rows: 1 + + * - Element + - Description + * - Node type + - Shows the node type. + * - Status + - Shows the execution status. + * - Time + - The total time taken to execute. + * - Rows + - Shows the number of produced rows passed to the next node. + * - Chunks + - Shows number of produced chunks. + * - Average rows per chunk + - Shows the number of average rows per chunk. + * - Table (for **ReadTable** and joins only) + - Shows the table name. + * - Write (for joins only) + - Shows the total date size written to the disk. + * - Read (for **ReadTable** and joins only) + - Shows the total data size read from the disk. + +Note that you can scroll the Node Statistics table. You can also download the execution plan table in .csv format by clicking the download arrow |icon-download| in the upper-right corner. + +.. |icon-download| image:: /_static/images/studio_icon_download.png + :align: middle + +Using the Plain View +^^^^^^^^^^^^ +You can use the **Plain View** instead of viewing the execution tree by clicking **Plain View** |icon-plain| in the top right corner. The plain view displays the same information as shown in the execution tree in table format. + +.. |icon-plain| image:: /_static/images/studio_icon_plain.png + :align: middle + + + + +The plain view lets you view a query’s execution plan for monitoring purposes and highlights rows based on how long they ran relative to the entire query. + +This can be seen in the **timeSum** column as follows: + +* **Rows highlighted red** - longest runtime +* **Rows highlighted orange** - medium runtime +* **Rows highlighted yellow** - shortest runtime + +:ref:`Back to Viewing Statement and Query Results from the Results Panel` + +.. _sql_view_5.4.6: + +Viewing Wrapped Strings in the SQL View +------------------ +The SQL View panel allows you to more easily view certain queries, such as a long string that appears on one line. The SQL View makes it easier to see by wrapping it so that you can see the entire string at once. It also reformats and organizes query syntax entered in the Statement panel for more easily locating particular segments of your queries. The SQL View is identical to the **Format SQL** feature in the Toolbar, allowing you to retain your originally constructed query while viewing a more intuitively structured snapshot of it. + +.. _save_results_to_clipboard_5.4.6: + +:ref:`Back to Viewing Statement and Query Results from the Results Panel` + +:ref:`Back to Executing Statements and Running Queries from the Editor` diff --git a/sqream_studio_5.4.3/getting_started.rst b/sqream_studio_5.4.6/getting_started.rst similarity index 92% rename from sqream_studio_5.4.3/getting_started.rst rename to sqream_studio_5.4.6/getting_started.rst index 3b9644cdc..6b328ae67 100644 --- a/sqream_studio_5.4.3/getting_started.rst +++ b/sqream_studio_5.4.6/getting_started.rst @@ -1,61 +1,65 @@ -.. _getting_started: - -**************************** -Getting Started with SQream Acceleration Studio 5.4.3 -**************************** -Setting Up and Starting Studio ----------------- -Studio is included with all `dockerized installations of SQream DB `_. When starting Studio, it listens on the local machine on port 8080. - -Logging In to Studio ---------------- -**To log in to SQream Studio:** - -1. Open a browser to the host on **port 8080**. - - For example, if your machine IP address is ``192.168.0.100``, insert the IP address into the browser as shown below: - - .. code-block:: console - - $ http://192.168.0.100:8080 - -2. Fill in your SQream DB login credentials. These are the same credentials used for :ref:`sqream sql` or JDBC. - - When you sign in, the License Warning is displayed. - -Navigating Studio's Main Features -------------- -When you log in, you are automatically taken to the **Editor** screen. The Studio's main functions are displayed in the **Navigation** pane on the left side of the screen. - -From here you can navigate between the main areas of the Studio: - -.. list-table:: - :widths: 10 90 - :header-rows: 1 - - * - Element - - Description - * - :ref:`Dashboard` - - Lets you monitor system health and manage queues and workers. - * - :ref:`Editor` - - Lets you select databases, perform statement operations, and write and execute queries. - * - :ref:`Logs` - - Lets you view usage logs. - * - :ref:`Roles` - - Lets you create users and manage user permissions. - * - :ref:`Configuration` - - Lets you configure your instance of SQream. - -By clicking the user icon, you can also use it for logging out and viewing the following: - -* User information -* Connection type -* SQream version -* SQream Studio version -* License expiration date -* License storage capacity -* Log out - -.. _back_to_dashboard_5.4.3: - -.. _studio_dashboard_5.4.3: +.. _getting_started: + +**************************** +Getting Started with SQream Acceleration Studio 5.4.6 +**************************** +Setting Up and Starting Studio +---------------- + +:ref:`installing-sqream-db-docker` + + +Studio is included with all `dockerized installations of SQream DB `_. When starting Studio, it listens on the local machine on port 8080. + +Logging In to Studio +--------------- +**To log in to SQream Studio:** + +1. Open a browser to the host on **port 8080**. + + For example, if your machine IP address is ``192.168.0.100``, insert the IP address into the browser as shown below: + + .. code-block:: console + + $ http://192.168.0.100:8080 + +2. Fill in your SQream DB login credentials. These are the same credentials used for :ref:`sqream sql` or JDBC. + + When you sign in, the License Warning is displayed. + +Navigating Studio's Main Features +------------- +When you log in, you are automatically taken to the **Editor** screen. The Studio's main functions are displayed in the **Navigation** pane on the left side of the screen. + +From here you can navigate between the main areas of the Studio: + +.. list-table:: + :widths: 10 90 + :header-rows: 1 + + * - Element + - Description + * - :ref:`Dashboard` + - Lets you monitor system health and manage queues and workers. + * - :ref:`Editor` + - Lets you select databases, perform statement operations, and write and execute queries. + * - :ref:`Logs` + - Lets you view usage logs. + * - :ref:`Roles` + - Lets you create users and manage user permissions. + * - :ref:`Configuration` + - Lets you configure your instance of SQream. + +By clicking the user icon, you can also use it for logging out and viewing the following: + +* User information +* Connection type +* SQream version +* SQream Studio version +* License expiration date +* License storage capacity +* Log out + +.. _back_to_dashboard_5.4.6: + +.. _studio_dashboard_5.4.6: diff --git a/sqream_studio_5.4.3/index.rst b/sqream_studio_5.4.6/index.rst similarity index 88% rename from sqream_studio_5.4.3/index.rst rename to sqream_studio_5.4.6/index.rst index ac607b121..83fd6d224 100644 --- a/sqream_studio_5.4.3/index.rst +++ b/sqream_studio_5.4.6/index.rst @@ -1,19 +1,19 @@ -.. _sqream_studio_5.4.3: - -********************************** -SQream Acceleration Studio 5.4.3 -********************************** -The SQream Acceleration Studio is a web-based client for use with SQream. Studio provides users with all functionality available from the command line in an intuitive and easy-to-use format. This includes running statements, managing roles and permissions, and managing SQream clusters. - -This section describes how to use the SQream Accleration Studio version 5.4.3: - -.. toctree:: - :maxdepth: 1 - :glob: - - getting_started - monitoring_workers_and_services_from_the_dashboard - executing_statements_and_running_queries_from_the_editor - viewing_logs - creating_assigning_and_managing_roles_and_permissions +.. _sqream_studio_5.4.6: + +********************************** +SQream Acceleration Studio 5.4.6 +********************************** +The SQream Acceleration Studio is a web-based client for use with SQream. Studio provides users with all functionality available from the command line in an intuitive and easy-to-use format. This includes running statements, managing roles and permissions, and managing SQream clusters. + +This section describes how to use the SQream Accleration Studio version 5.4.6: + +.. toctree:: + :maxdepth: 1 + :glob: + + getting_started + executing_statements_and_running_queries_from_the_editor + monitoring_workers_and_services_from_the_dashboard + viewing_logs + creating_assigning_and_managing_roles_and_permissions configuring_your_instance_of_sqream \ No newline at end of file diff --git a/sqream_studio_5.4.3/monitoring_workers_and_services_from_the_dashboard.rst b/sqream_studio_5.4.6/monitoring_workers_and_services_from_the_dashboard.rst similarity index 90% rename from sqream_studio_5.4.3/monitoring_workers_and_services_from_the_dashboard.rst rename to sqream_studio_5.4.6/monitoring_workers_and_services_from_the_dashboard.rst index e30962f37..00ec30eda 100644 --- a/sqream_studio_5.4.3/monitoring_workers_and_services_from_the_dashboard.rst +++ b/sqream_studio_5.4.6/monitoring_workers_and_services_from_the_dashboard.rst @@ -1,265 +1,265 @@ -.. _monitoring_workers_and_services_from_the_dashboard: - -.. _back_to_dashboard_5.4.3: - -**************************** -Monitoring Workers and Services from the Dashboard -**************************** -The **Dashboard** is used for the following: - -* Monitoring system health. -* Viewing, monitoring, and adding defined service queues. -* Viewing and managing worker status and add workers. - -The following is an image of the Dashboard: - -.. image:: /_static/images/dashboard.png - -You can only access the Dashboard if you signed in with a ``SUPERUSER`` role. - -The following is a brief description of the Dashboard panels: - -.. list-table:: - :widths: 10 25 65 - :header-rows: 1 - - * - No. - - Element - - Description - * - 1 - - :ref:`Services panel` - - Used for viewing and monitoring the defined service queues. - * - 2 - - :ref:`Workers panel` - - Monitors system health and shows each Sqreamd worker running in the cluster. - * - 3 - - :ref:`License information` - - Shows the remaining amount of days left on your license. - - -.. _data_storage_panel_5.4.3: - - - -:ref:`Back to Monitoring Workers and Services from the Dashboard` - -.. _services_panel_5.4.3: - -Subscribing to Workers from the Services Panel --------------------------- -Services are used to categorize and associate (also known as **subscribing**) workers to particular services. The **Service** panel is used for viewing, monitoring, and adding defined `service queues `_. - - - -The following is a brief description of each pane: - -.. list-table:: - :widths: 10 90 - :header-rows: 1 - - * - No. - - Description - * - 1 - - Adds a worker to the selected service. - * - 2 - - Shows the service name. - * - 3 - - Shows a trend graph of queued statements loaded over time. - * - 4 - - Adds a service. - * - 5 - - Shows the currently processed queries belonging to the service/total queries for that service in the system (including queued queries). - -Adding A Service -^^^^^^^^^^^^^^^^^^^^^ -You can add a service by clicking **+ Add** and defining the service name. - -.. note:: If you do not associate a worker with the new service, it will not be created. - -You can manage workers from the **Workers** panel. For more information about managing workers, see the following: - -* :ref:`Managing Workers from the Workers Panel` -* `Workers `_ - -:ref:`Back to Monitoring Workers and Services from the Dashboard` - -.. _workers_panel_5.4.3: - -Managing Workers from the Workers Panel ------------- -From the **Workers** panel you can do the following: - -* :ref:`View workers ` -* :ref:`Add a worker to a service` -* :ref:`View a worker's active query information` -* :ref:`View a worker's execution plan` - -.. _view_workers_5.4.3: - -Viewing Workers -^^^^^^^^ -The **Worker** panel shows each worker (``sqreamd``) running in the cluster. Each worker has a status bar that represents the status over time. The status bar is divided into 20 equal segments, showing the most dominant activity in that segment. - -From the **Scale** dropdown menu you can set the time scale of the displayed information -You can hover over segments in the status bar to see the date and time corresponding to each activity type: - -* **Idle** – the worker is idle and available for statements. -* **Compiling** – the worker is compiling a statement and is preparing for execution. -* **Executing** – the worker is executing a statement after compilation. -* **Stopped** – the worker was stopped (either deliberately or due to an error). -* **Waiting** – the worker was waiting on an object locked by another worker. - -.. _add_worker_to_service_5.4.3: - -Adding A Worker to A Service -^^^^^^^^^^^^^^^^^^^^^ -You can add a worker to a service by clicking the **add** button. - - - -Clicking the **add** button shows the selected service's workers. You can add the selected worker to the service by clicking **Add Worker**. Adding a worker to a service does not break associations already made between that worker and other services. - - -.. _view_worker_query_information_5.4.3: - -Viewing A Worker's Active Query Information -^^^^^^^^^^^^^^^^^^^^^ -You can view a worker's active query information by clicking **Queries**, which displays them in the selected service. - - -Each statement shows the **query ID**, **status**, **service queue**, **elapsed time**, **execution time**, and **estimated completion status**. In addition, each statement can be stopped or expanded to show its execution plan and progress. For more information on viewing a statement's execution plan and progress, see :ref:`Viewing a Worker's Execution Plan ` below. - -Viewing A Worker's Host Utilization -^^^^^^^^^^^^^^^^^^^^^ - -While viewing a worker's query information, clicking the **down arrow** expands to show the host resource utilization. - - - -The graphs show the resource utilization trends over time, and the **CPU memory** and **utilization** and the **GPU utilization** values on the right. You can hover over the graph to see more information about the activity at any point on the graph. - -Error notifications related to statements are displayed, and you can hover over them for more information about the error. - - -.. _view_worker_execution_plan_5.4.3: - -Viewing a Worker's Execution Plan -^^^^^^^^^^^^^^^^^^^^^ - -Clicking the ellipsis in a service shows the following additional options: - -* **Stop Query** - stops the query. -* **Show Execution Plan** - shows the execution plan as a table. The columns in the **Show Execution Plan** table can be sorted. - -For more information on the current query plan, see `SHOW_NODE_INFO `_. For more information on checking active sessions across the cluster, see `SHOW_SERVER_STATUS `_. - -.. include:: /reference/sql/sql_statements/monitoring_commands/show_server_status.rst - :start-line: 67 - :end-line: 84 - -Managing Worker Status -^^^^^^^^^^^^^^^^^^^^^ - -In some cases you may want to stop or restart workers for maintenance purposes. Each Worker line has a :kbd:`⋮` menu used for stopping, starting, or restarting workers. - - -Starting or restarting workers terminates all queries related to that worker. When you stop a worker, its background turns gray. - - - - -.. |icon-user| image:: /_static/images/studio_icon_user.png - :align: middle - -.. |icon-dots| image:: /_static/images/studio_icon_dots.png - :align: middle - -.. |icon-editor| image:: /_static/images/studio_icon_editor.png - :align: middle - -.. |icon-copy| image:: /_static/images/studio_icon_copy.png - :align: middle - -.. |icon-select| image:: /_static/images/studio_icon_select.png - :align: middle - -.. |icon-dots| image:: /_static/images/studio_icon_dots.png - :align: middle - -.. |icon-filter| image:: /_static/images/studio_icon_filter.png - :align: middle - -.. |icon-ddl-edit| image:: /_static/images/studio_icon_ddl_edit.png - :align: middle - -.. |icon-run-optimizer| image:: /_static/images/studio_icon_run_optimizer.png - :align: middle - -.. |icon-generate-create-statement| image:: /_static/images/studio_icon_generate_create_statement.png - :align: middle - -.. |icon-plus| image:: /_static/images/studio_icon_plus.png - :align: middle - -.. |icon-close| image:: /_static/images/studio_icon_close.png - :align: middle - -.. |icon-left| image:: /_static/images/studio_icon_left.png - :align: middle - -.. |icon-right| image:: /_static/images/studio_icon_right.png - :align: middle - -.. |icon-format-sql| image:: /_static/images/studio_icon_format.png - :align: middle - -.. |icon-download-query| image:: /_static/images/studio_icon_download_query.png - :align: middle - -.. |icon-open-query| image:: /_static/images/studio_icon_open_query.png - :align: middle - -.. |icon-execute| image:: /_static/images/studio_icon_execute.png - :align: middle - -.. |icon-stop| image:: /_static/images/studio_icon_stop.png - :align: middle - -.. |icon-dashboard| image:: /_static/images/studio_icon_dashboard.png - :align: middle - -.. |icon-expand| image:: /_static/images/studio_icon_expand.png - :align: middle - -.. |icon-scale| image:: /_static/images/studio_icon_scale.png - :align: middle - -.. |icon-expand-down| image:: /_static/images/studio_icon_expand_down.png - :align: middle - -.. |icon-add| image:: /_static/images/studio_icon_add.png - :align: middle - -.. |icon-add-worker| image:: /_static/images/studio_icon_add_worker.png - :align: middle - -.. |keep-tabs| image:: /_static/images/studio_keep_tabs.png - :align: middle - -:ref:`Back to Monitoring Workers and Services from the Dashboard` - - - -.. _license_information_5.4.3: - -License Information ----------------------- -The license information section shows the following: - - * The amount of time in days remaining on the license. - * The license storage capacity. - -.. image:: /_static/images/license_storage_capacity.png - - -:ref:`Back to Monitoring Workers and Services from the Dashboard` +.. _monitoring_workers_and_services_from_the_dashboard: + +.. _back_to_dashboard_5.4.6: + +**************************** +Monitoring Workers and Services from the Dashboard +**************************** +The **Dashboard** is used for the following: + +* Monitoring system health. +* Viewing, monitoring, and adding defined service queues. +* Viewing and managing worker status and add workers. + +The following is an image of the Dashboard: + +.. image:: /_static/images/dashboard.png + +You can only access the Dashboard if you signed in with a ``SUPERUSER`` role. + +The following is a brief description of the Dashboard panels: + +.. list-table:: + :widths: 10 25 65 + :header-rows: 1 + + * - No. + - Element + - Description + * - 1 + - :ref:`Services panel` + - Used for viewing and monitoring the defined service queues. + * - 2 + - :ref:`Workers panel` + - Monitors system health and shows each Sqreamd worker running in the cluster. + * - 3 + - :ref:`License information` + - Shows the remaining amount of days left on your license. + + +.. _data_storage_panel_5.4.6: + + + +:ref:`Back to Monitoring Workers and Services from the Dashboard` + +.. _services_panel_5.4.6: + +Subscribing to Workers from the Services Panel +-------------------------- +Services are used to categorize and associate (also known as **subscribing**) workers to particular services. The **Service** panel is used for viewing, monitoring, and adding defined `service queues `_. + + + +The following is a brief description of each pane: + +.. list-table:: + :widths: 10 90 + :header-rows: 1 + + * - No. + - Description + * - 1 + - Adds a worker to the selected service. + * - 2 + - Shows the service name. + * - 3 + - Shows a trend graph of queued statements loaded over time. + * - 4 + - Adds a service. + * - 5 + - Shows the currently processed queries belonging to the service/total queries for that service in the system (including queued queries). + +Adding A Service +^^^^^^^^^^^^^^^^^^^^^ +You can add a service by clicking **+ Add** and defining the service name. + +.. note:: If you do not associate a worker with the new service, it will not be created. + +You can manage workers from the **Workers** panel. For more information about managing workers, see the following: + +* :ref:`Managing Workers from the Workers Panel` +* `Workers `_ + +:ref:`Back to Monitoring Workers and Services from the Dashboard` + +.. _workers_panel_5.4.6: + +Managing Workers from the Workers Panel +------------ +From the **Workers** panel you can do the following: + +* :ref:`View workers ` +* :ref:`Add a worker to a service` +* :ref:`View a worker's active query information` +* :ref:`View a worker's execution plan` + +.. _view_workers_5.4.6: + +Viewing Workers +^^^^^^^^ +The **Worker** panel shows each worker (``sqreamd``) running in the cluster. Each worker has a status bar that represents the status over time. The status bar is divided into 20 equal segments, showing the most dominant activity in that segment. + +From the **Scale** dropdown menu you can set the time scale of the displayed information +You can hover over segments in the status bar to see the date and time corresponding to each activity type: + +* **Idle** – the worker is idle and available for statements. +* **Compiling** – the worker is compiling a statement and is preparing for execution. +* **Executing** – the worker is executing a statement after compilation. +* **Stopped** – the worker was stopped (either deliberately or due to an error). +* **Waiting** – the worker was waiting on an object locked by another worker. + +.. _add_worker_to_service_5.4.6: + +Adding A Worker to A Service +^^^^^^^^^^^^^^^^^^^^^ +You can add a worker to a service by clicking the **add** button. + + + +Clicking the **add** button shows the selected service's workers. You can add the selected worker to the service by clicking **Add Worker**. Adding a worker to a service does not break associations already made between that worker and other services. + + +.. _view_worker_query_information_5.4.6: + +Viewing A Worker's Active Query Information +^^^^^^^^^^^^^^^^^^^^^ +You can view a worker's active query information by clicking **Queries**, which displays them in the selected service. + + +Each statement shows the **query ID**, **status**, **service queue**, **elapsed time**, **execution time**, and **estimated completion status**. In addition, each statement can be stopped or expanded to show its execution plan and progress. For more information on viewing a statement's execution plan and progress, see :ref:`Viewing a Worker's Execution Plan ` below. + +Viewing A Worker's Host Utilization +^^^^^^^^^^^^^^^^^^^^^ + +While viewing a worker's query information, clicking the **down arrow** expands to show the host resource utilization. + + + +The graphs show the resource utilization trends over time, and the **CPU memory** and **utilization** and the **GPU utilization** values on the right. You can hover over the graph to see more information about the activity at any point on the graph. + +Error notifications related to statements are displayed, and you can hover over them for more information about the error. + + +.. _view_worker_execution_plan_5.4.6: + +Viewing a Worker's Execution Plan +^^^^^^^^^^^^^^^^^^^^^ + +Clicking the ellipsis in a service shows the following additional options: + +* **Stop Query** - stops the query. +* **Show Execution Plan** - shows the execution plan as a table. The columns in the **Show Execution Plan** table can be sorted. + +For more information on the current query plan, see `SHOW_NODE_INFO `_. For more information on checking active sessions across the cluster, see `SHOW_SERVER_STATUS `_. + +.. include:: /reference/sql/sql_statements/monitoring_commands/show_server_status.rst + :start-line: 67 + :end-line: 84 + +Managing Worker Status +^^^^^^^^^^^^^^^^^^^^^ + +In some cases you may want to stop or restart workers for maintenance purposes. Each Worker line has a :kbd:`⋮` menu used for stopping, starting, or restarting workers. + + +Starting or restarting workers terminates all queries related to that worker. When you stop a worker, its background turns gray. + + + + +.. |icon-user| image:: /_static/images/studio_icon_user.png + :align: middle + +.. |icon-dots| image:: /_static/images/studio_icon_dots.png + :align: middle + +.. |icon-editor| image:: /_static/images/studio_icon_editor.png + :align: middle + +.. |icon-copy| image:: /_static/images/studio_icon_copy.png + :align: middle + +.. |icon-select| image:: /_static/images/studio_icon_select.png + :align: middle + +.. |icon-dots| image:: /_static/images/studio_icon_dots.png + :align: middle + +.. |icon-filter| image:: /_static/images/studio_icon_filter.png + :align: middle + +.. |icon-ddl-edit| image:: /_static/images/studio_icon_ddl_edit.png + :align: middle + +.. |icon-run-optimizer| image:: /_static/images/studio_icon_run_optimizer.png + :align: middle + +.. |icon-generate-create-statement| image:: /_static/images/studio_icon_generate_create_statement.png + :align: middle + +.. |icon-plus| image:: /_static/images/studio_icon_plus.png + :align: middle + +.. |icon-close| image:: /_static/images/studio_icon_close.png + :align: middle + +.. |icon-left| image:: /_static/images/studio_icon_left.png + :align: middle + +.. |icon-right| image:: /_static/images/studio_icon_right.png + :align: middle + +.. |icon-format-sql| image:: /_static/images/studio_icon_format.png + :align: middle + +.. |icon-download-query| image:: /_static/images/studio_icon_download_query.png + :align: middle + +.. |icon-open-query| image:: /_static/images/studio_icon_open_query.png + :align: middle + +.. |icon-execute| image:: /_static/images/studio_icon_execute.png + :align: middle + +.. |icon-stop| image:: /_static/images/studio_icon_stop.png + :align: middle + +.. |icon-dashboard| image:: /_static/images/studio_icon_dashboard.png + :align: middle + +.. |icon-expand| image:: /_static/images/studio_icon_expand.png + :align: middle + +.. |icon-scale| image:: /_static/images/studio_icon_scale.png + :align: middle + +.. |icon-expand-down| image:: /_static/images/studio_icon_expand_down.png + :align: middle + +.. |icon-add| image:: /_static/images/studio_icon_add.png + :align: middle + +.. |icon-add-worker| image:: /_static/images/studio_icon_add_worker.png + :align: middle + +.. |keep-tabs| image:: /_static/images/studio_keep_tabs.png + :align: middle + +:ref:`Back to Monitoring Workers and Services from the Dashboard` + + + +.. _license_information_5.4.6: + +License Information +---------------------- +The license information section shows the following: + + * The amount of time in days remaining on the license. + * The license storage capacity. + +.. image:: /_static/images/license_storage_capacity.png + + +:ref:`Back to Monitoring Workers and Services from the Dashboard` diff --git a/sqream_studio_5.4.3/viewing_logs.rst b/sqream_studio_5.4.6/viewing_logs.rst similarity index 85% rename from sqream_studio_5.4.3/viewing_logs.rst rename to sqream_studio_5.4.6/viewing_logs.rst index 0a8350a45..e431550ed 100644 --- a/sqream_studio_5.4.3/viewing_logs.rst +++ b/sqream_studio_5.4.6/viewing_logs.rst @@ -1,122 +1,122 @@ -.. _viewing_logs: - -.. _logs_top_5.4.3: - -**************************** -Viewing Logs -**************************** -The **Logs** screen is used for viewing logs and includes the following elements: - -.. list-table:: - :widths: 15 75 - :header-rows: 1 - - * - Element - - Description - * - :ref:`Filter area` - - Lets you filter the data shown in the table. - * - :ref:`Query tab` - - Shows basic query information logs, such as query number and the time the query was run. - * - :ref:`Session tab` - - Shows basic session information logs, such as session ID and user name. - * - :ref:`System tab` - - Shows all system logs. - * - :ref:`Log lines tab` - - Shows the total amount of log lines. - - -.. _filter_5.4.3: - -Filtering Table Data -------------- -From the Logs tab, from the **FILTERS** area you can also apply the **TIMESPAN**, **ONLY ERRORS**, and additional filters (**Add**). The **Timespan** filter lets you select a timespan. The **Only Errors** toggle button lets you show all queries, or only queries that generated errors. The **Add** button lets you add additional filters to the data shown in the table. The **Filter** button applies the selected filter(s). - -Other filters require you to select an item from a dropdown menu: - -* INFO -* WARNING -* ERROR -* FATAL -* SYSTEM - -You can also export a record of all of your currently filtered logs in Excel format by clicking **Download** located above the Filter area. - -.. _queries_5.4.3: - -:ref:`Back to Viewing Logs` - - -Viewing Query Logs ----------- -The **QUERIES** log area shows basic query information, such as query number and the time the query was run. The number next to the title indicates the amount of queries that have been run. - -From the Queries area you can see and sort by the following: - -* Query ID -* Start time -* Query -* Compilation duration -* Execution duration -* Total duration -* Details (execution details, error details, successful query details) - -In the Queries table, you can click on the **Statement ID** and **Query** items to set them as your filters. In the **Details** column you can also access additional details by clicking one of the **Details** options for a more detailed explanation of the query. - -:ref:`Back to Viewing Logs` - -.. _sessions_5.4.3: - -Viewing Session Logs ----------- -The **SESSIONS** tab shows the sessions log table and is used for viewing activity that has occurred during your sessions. The number at the top indicates the amount of sessions that have occurred. - -From here you can see and sort by the following: - -* Timestamp -* Connection ID -* Username -* Client IP -* Login (Success or Failed) -* Duration (of session) -* Configuration Changes - -In the Sessions table, you can click on the **Timestamp**, **Connection ID**, and **Username** items to set them as your filters. - -:ref:`Back to Viewing Logs` - -.. _system_5.4.3: - -Viewing System Logs ----------- -The **SYSTEM** tab shows the system log table and is used for viewing all system logs. The number at the top indicates the amount of sessions that have occurred. Because system logs occur less frequently than queries and sessions, you may need to increase the filter timespan for the table to display any system logs. - -From here you can see and sort by the following: - -* Timestamp -* Log type -* Message - -In the Systems table, you can click on the **Timestamp** and **Log type** items to set them as your filters. In the **Message** column, you can also click on an item to show more information about the message. - -:ref:`Back to Viewing Logs` - -.. _log_lines_5.4.3: - -Viewing All Log Lines ----------- -The **LOG LINES** tab is used for viewing the total amount of log lines in a table. From here users can view a more granular breakdown of log information collected by Studio. The other tabs (QUERIES, SESSIONS, and SYSTEM) show a filtered form of the raw log lines. For example, the QUERIES tab shows an aggregation of several log lines. - -From here you can see and sort by the following: - -* Timestamp -* Message level -* Worker hostname -* Worker port -* Connection ID -* Database name -* User name -* Statement ID - -In the **LOG LINES** table, you can click on any of the items to set them as your filters. - -:ref:`Back to Viewing Logs` \ No newline at end of file +.. _viewing_logs: + +.. _logs_top_5.4.6: + +**************************** +Viewing Logs +**************************** +The **Logs** screen is used for viewing logs and includes the following elements: + +.. list-table:: + :widths: 15 75 + :header-rows: 1 + + * - Element + - Description + * - :ref:`Filter area` + - Lets you filter the data shown in the table. + * - :ref:`Query tab` + - Shows basic query information logs, such as query number and the time the query was run. + * - :ref:`Session tab` + - Shows basic session information logs, such as session ID and user name. + * - :ref:`System tab` + - Shows all system logs. + * - :ref:`Log lines tab` + - Shows the total amount of log lines. + + +.. _filter_5.4.6: + +Filtering Table Data +------------- +From the Logs tab, from the **FILTERS** area you can also apply the **TIMESPAN**, **ONLY ERRORS**, and additional filters (**Add**). The **Timespan** filter lets you select a timespan. The **Only Errors** toggle button lets you show all queries, or only queries that generated errors. The **Add** button lets you add additional filters to the data shown in the table. The **Filter** button applies the selected filter(s). + +Other filters require you to select an item from a dropdown menu: + +* INFO +* WARNING +* ERROR +* FATAL +* SYSTEM + +You can also export a record of all of your currently filtered logs in Excel format by clicking **Download** located above the Filter area. + +.. _queries_5.4.6: + +:ref:`Back to Viewing Logs` + + +Viewing Query Logs +---------- +The **QUERIES** log area shows basic query information, such as query number and the time the query was run. The number next to the title indicates the amount of queries that have been run. + +From the Queries area you can see and sort by the following: + +* Query ID +* Start time +* Query +* Compilation duration +* Execution duration +* Total duration +* Details (execution details, error details, successful query details) + +In the Queries table, you can click on the **Statement ID** and **Query** items to set them as your filters. In the **Details** column you can also access additional details by clicking one of the **Details** options for a more detailed explanation of the query. + +:ref:`Back to Viewing Logs` + +.. _sessions_5.4.6: + +Viewing Session Logs +---------- +The **SESSIONS** tab shows the sessions log table and is used for viewing activity that has occurred during your sessions. The number at the top indicates the amount of sessions that have occurred. + +From here you can see and sort by the following: + +* Timestamp +* Connection ID +* Username +* Client IP +* Login (Success or Failed) +* Duration (of session) +* Configuration Changes + +In the Sessions table, you can click on the **Timestamp**, **Connection ID**, and **Username** items to set them as your filters. + +:ref:`Back to Viewing Logs` + +.. _system_5.4.6: + +Viewing System Logs +---------- +The **SYSTEM** tab shows the system log table and is used for viewing all system logs. The number at the top indicates the amount of sessions that have occurred. Because system logs occur less frequently than queries and sessions, you may need to increase the filter timespan for the table to display any system logs. + +From here you can see and sort by the following: + +* Timestamp +* Log type +* Message + +In the Systems table, you can click on the **Timestamp** and **Log type** items to set them as your filters. In the **Message** column, you can also click on an item to show more information about the message. + +:ref:`Back to Viewing Logs` + +.. _log_lines_5.4.6: + +Viewing All Log Lines +---------- +The **LOG LINES** tab is used for viewing the total amount of log lines in a table. From here users can view a more granular breakdown of log information collected by Studio. The other tabs (QUERIES, SESSIONS, and SYSTEM) show a filtered form of the raw log lines. For example, the QUERIES tab shows an aggregation of several log lines. + +From here you can see and sort by the following: + +* Timestamp +* Message level +* Worker hostname +* Worker port +* Connection ID +* Database name +* User name +* Statement ID + +In the **LOG LINES** table, you can click on any of the items to set them as your filters. + +:ref:`Back to Viewing Logs` \ No newline at end of file From f5d562641a0ef4482e4c9b2baf8d6daf3142bf8c Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 4 Aug 2022 15:10:18 +0300 Subject: [PATCH 197/882] Updated Studio 5.4.3 to 5.4.6 Changed links to ref syntax. --- .../utility_commands/shutdown_server.rst | 2 -- .../configuring_your_instance_of_sqream.rst | 4 ++- ...ts_and_running_queries_from_the_editor.rst | 33 +++++++------------ ...started.rst => getting_started_sqream.rst} | 8 ++--- sqream_studio_5.4.6/index.rst | 2 +- ...orkers_and_services_from_the_dashboard.rst | 31 ++++++++--------- sqream_studio_5.4.6/viewing_logs.rst | 3 ++ 7 files changed, 36 insertions(+), 47 deletions(-) rename sqream_studio_5.4.6/{getting_started.rst => getting_started_sqream.rst} (86%) diff --git a/reference/sql/sql_statements/utility_commands/shutdown_server.rst b/reference/sql/sql_statements/utility_commands/shutdown_server.rst index ac0c4dc96..1f607e753 100644 --- a/reference/sql/sql_statements/utility_commands/shutdown_server.rst +++ b/reference/sql/sql_statements/utility_commands/shutdown_server.rst @@ -3,8 +3,6 @@ ******************** SHUTDOWN SERVER ******************** -**Comment** - When finished, add command to Utility Commands > shutdown_server. - The **SHUTDOWN_SERVER** guide describes the following: .. contents:: diff --git a/sqream_studio_5.4.6/configuring_your_instance_of_sqream.rst b/sqream_studio_5.4.6/configuring_your_instance_of_sqream.rst index 2b334cbfa..a0def6827 100644 --- a/sqream_studio_5.4.6/configuring_your_instance_of_sqream.rst +++ b/sqream_studio_5.4.6/configuring_your_instance_of_sqream.rst @@ -3,6 +3,8 @@ **************************** Configuring Your Instance of SQream **************************** +**Comment** - *Has this functionality been removed from Studio 5.4.6?* + The **Configuration** section lets you edit parameters from one centralized location. While you can edit these parameters from the **worker configuration file (config.json)** or from your CLI, you can also modify them in Studio in an easy-to-use format. Configuring your instance of SQream in Studio is session-based, which enables you to edit parameters per session on your own device. @@ -20,4 +22,4 @@ Exporting and Importing Configuration Files ------------------------- You can also export and import your configuration settings into a .json file. This allows you to easily edit your parameters and to share this file with other users if required. -For more information about configuring your instance of SQream, see `Configuration Guides `_. \ No newline at end of file +For more information about configuring your instance of SQream, see :ref:`configuration_guides`. \ No newline at end of file diff --git a/sqream_studio_5.4.6/executing_statements_and_running_queries_from_the_editor.rst b/sqream_studio_5.4.6/executing_statements_and_running_queries_from_the_editor.rst index 9640665da..8015b7c4a 100644 --- a/sqream_studio_5.4.6/executing_statements_and_running_queries_from_the_editor.rst +++ b/sqream_studio_5.4.6/executing_statements_and_running_queries_from_the_editor.rst @@ -14,7 +14,6 @@ The **Editor** is used for the following: The following is a brief description of the Editor panels: - .. list-table:: :widths: 10 34 56 :header-rows: 1 @@ -35,8 +34,6 @@ The following is a brief description of the Editor panels: - :ref:`Results panel` - Shows query results and execution information. - - .. _top_5.4.6: .. _studio_5.4.6_editor_toolbar: @@ -73,22 +70,16 @@ You can access the following from the Toolbar pane: * **Max Rows** - By default, the Editor fetches only the first 10,000 rows. You can modify this number by selecting an option from the **Max Rows** dropdown list. Note that setting a higher number may slow down your browser if the result is very large. This number is limited to 100,000 results. To see a higher number, you can save the results in a file or a table using the :ref:`create_table_as` command. - -For more information on stopping active statements, see the :ref:`STOP_STATEMENT` command. +For more information on stopping active statements, see the :ref:`SHUTDOWN_SERVER` command. :ref:`Back to Executing Statements and Running Queries from the Editor` - .. _studio_5.4.6_editor_db_tree: Performing Statement-Related Operations from the Database Tree ================ From the Database Tree you can perform statement-related operations and show metadata (such as a number indicating the amount of rows in the table). - - - - The database object functions are used to perform the following: * The **SELECT** statement - copies the selected table's **columns** into the Statement panel as ``SELECT`` parameters. @@ -179,7 +170,8 @@ The database object functions are used to perform the following: .. |keep-tabs| image:: /_static/images/studio_keep_tabs.png :align: middle - + + :ref:`insert` .. list-table:: :widths: 30 70 @@ -188,23 +180,23 @@ The database object functions are used to perform the following: * - Function - Description * - Insert statement - - Generates an `INSERT `_ statement for the selected table in the editing area. + - Generates an :ref:`insert` statement for the selected table in the editing area. * - Delete statement - - Generates a `DELETE `_ statement for the selected table in the editing area. + - Generates a :ref:`delete` statement for the selected table in the editing area. * - Create Table As statement - Generates a `CREATE TABLE AS `_ statement for the selected table in the editing area. * - Rename statement - - Generates an `RENAME TABLE AS `_ statement for renaming the selected table in the editing area. + - Generates an :ref:`rename_table` statement for renaming the selected table in the editing area. * - Adding column statement - - Generates an `ADD COLUMN `_ statement for adding columns to the selected table in the editing area. + - Generates an :ref:`add_column` statement for adding columns to the selected table in the editing area. * - Truncate table statement - - Generates a `TRUNCATE_IF_EXISTS `_ statement for the selected table in the editing area. + - Generates a :ref:`truncate` statement for the selected table in the editing area. * - Drop table statement - Generates a ``DROP`` statement for the selected object in the editing area. * - Table DDL - - Generates a DDL statement for the selected object in the editing area. To get the entire database DDL, click the |icon-ddl-edit| icon next to the database name in the tree root. See `Seeing System Objects as DDL `_. + - Generates a DDL statement for the selected object in the editing area. To get the entire database DDL, click the |icon-ddl-edit| icon next to the database name in the tree root. See :ref:`seeing_system_objects_as_ddl`. * - DDL Optimizer - - The `DDL Optimizer `_ lets you analyze database tables and recommends possible optimizations. + - The `DDL Optimizer `_ lets you analyze database tables and recommends possible optimizations. Optimizing Database Tables Using the DDL Optimizer ----------------------- @@ -229,7 +221,7 @@ The following table describes the DDL Optimizer screen: Clicking **Run Optimizer** adds a tab to the Statement panel showing the optimized results of the selected object. -For more information, see `Optimization and Best Practices `_. +For more information, see :ref:`sql_best_practices`. Executing Pre-Defined Queries from the System Queries Panel --------------- @@ -274,8 +266,7 @@ You can add and name new tabs for each statement that you need to execute, and S You can also rename the default tab name by double-clicking it and typing a new name and write multiple statements in tandem in the same tab by separating them with semicolons (``;``).If too many tabs to fit into the Statement Pane are open at the same time, the tab arrows are displayed. You can scroll through the tabs by clicking |icon-left| or |icon-right|, and close tabs by clicking |icon-close|. You can also close all tabs at once by clicking **Close all** located to the right of the tabs. -.. tip:: If this is your first time using SQream, see `Getting Started `_. - +.. tip:: If this is your first time using SQream, see :ref:`getting_started`. .. Keyboard shortcuts .. ^^^^^^^^^^^^^^^^^^^^^^^^^ diff --git a/sqream_studio_5.4.6/getting_started.rst b/sqream_studio_5.4.6/getting_started_sqream.rst similarity index 86% rename from sqream_studio_5.4.6/getting_started.rst rename to sqream_studio_5.4.6/getting_started_sqream.rst index 6b328ae67..10542277e 100644 --- a/sqream_studio_5.4.6/getting_started.rst +++ b/sqream_studio_5.4.6/getting_started_sqream.rst @@ -1,15 +1,13 @@ -.. _getting_started: +.. _getting_started_sqream: **************************** Getting Started with SQream Acceleration Studio 5.4.6 **************************** Setting Up and Starting Studio ---------------- +Studio is included with all dockerized installations of SQream. When starting Studio, it listens on the local machine on port 8080. -:ref:`installing-sqream-db-docker` - - -Studio is included with all `dockerized installations of SQream DB `_. When starting Studio, it listens on the local machine on port 8080. +For more information, see :ref:`running_sqream_in_a_docker_container`. Logging In to Studio --------------- diff --git a/sqream_studio_5.4.6/index.rst b/sqream_studio_5.4.6/index.rst index 83fd6d224..451a520ad 100644 --- a/sqream_studio_5.4.6/index.rst +++ b/sqream_studio_5.4.6/index.rst @@ -11,7 +11,7 @@ This section describes how to use the SQream Accleration Studio version 5.4.6: :maxdepth: 1 :glob: - getting_started + getting_started_sqream executing_statements_and_running_queries_from_the_editor monitoring_workers_and_services_from_the_dashboard viewing_logs diff --git a/sqream_studio_5.4.6/monitoring_workers_and_services_from_the_dashboard.rst b/sqream_studio_5.4.6/monitoring_workers_and_services_from_the_dashboard.rst index 00ec30eda..51dbb3941 100644 --- a/sqream_studio_5.4.6/monitoring_workers_and_services_from_the_dashboard.rst +++ b/sqream_studio_5.4.6/monitoring_workers_and_services_from_the_dashboard.rst @@ -34,22 +34,17 @@ The following is a brief description of the Dashboard panels: - Monitors system health and shows each Sqreamd worker running in the cluster. * - 3 - :ref:`License information` - - Shows the remaining amount of days left on your license. - + - Shows the remaining amount of days left on your license. .. _data_storage_panel_5.4.6: - - :ref:`Back to Monitoring Workers and Services from the Dashboard` .. _services_panel_5.4.6: Subscribing to Workers from the Services Panel -------------------------- -Services are used to categorize and associate (also known as **subscribing**) workers to particular services. The **Service** panel is used for viewing, monitoring, and adding defined `service queues `_. - - +Services are used to categorize and associate (also known as **subscribing**) workers to particular services. The **Service** panel is used for viewing, monitoring, and adding defined in the :ref:`workload_manager`. The following is a brief description of each pane: @@ -138,20 +133,27 @@ While viewing a worker's query information, clicking the **down arrow** expands The graphs show the resource utilization trends over time, and the **CPU memory** and **utilization** and the **GPU utilization** values on the right. You can hover over the graph to see more information about the activity at any point on the graph. -Error notifications related to statements are displayed, and you can hover over them for more information about the error. - +Error notifications related to statements are displayed, and you can hover over them for more information about the error. .. _view_worker_execution_plan_5.4.6: Viewing a Worker's Execution Plan -^^^^^^^^^^^^^^^^^^^^^ - +^^^^^^^^^^^^^^^^^^^^^ Clicking the ellipsis in a service shows the following additional options: * **Stop Query** - stops the query. + + :: + * **Show Execution Plan** - shows the execution plan as a table. The columns in the **Show Execution Plan** table can be sorted. -For more information on the current query plan, see `SHOW_NODE_INFO `_. For more information on checking active sessions across the cluster, see `SHOW_SERVER_STATUS `_. +For more information on the current query plan, see the following: + +* :ref:`show_node_info` + + :: + +* :ref:`show_server_status` .. include:: /reference/sql/sql_statements/monitoring_commands/show_server_status.rst :start-line: 67 @@ -159,15 +161,10 @@ For more information on the current query plan, see `SHOW_NODE_INFO ` - Shows the total amount of log lines. +.. note:: Because the logs are stored in the **system** database, you cannot search the logs without first creating a **system** database. When you access the **Logs** tab, SQream can automatically create a **system** database for you. .. _filter_5.4.6: @@ -104,6 +105,8 @@ In the Systems table, you can click on the **Timestamp** and **Log type** items Viewing All Log Lines ---------- +**Comment** - *Has this tab been removed from the GUI?* + The **LOG LINES** tab is used for viewing the total amount of log lines in a table. From here users can view a more granular breakdown of log information collected by Studio. The other tabs (QUERIES, SESSIONS, and SYSTEM) show a filtered form of the raw log lines. For example, the QUERIES tab shows an aggregation of several log lines. From here you can see and sort by the following: From 643334085b7468c01b70db4b8ce510805233d338 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 4 Aug 2022 15:33:44 +0300 Subject: [PATCH 198/882] Removed Configuration from Studio index --- index.rst | 2 +- sqream_studio_5.4.6/index.rst | 3 +-- 2 files changed, 2 insertions(+), 3 deletions(-) diff --git a/index.rst b/index.rst index 23e2288c0..efeecb8e2 100644 --- a/index.rst +++ b/index.rst @@ -87,7 +87,7 @@ If you couldn't find what you're looking for, we're always happy to help. Visit This version of the documentation is for SQream DB Version 2022.1. -If you're looking for an older version of the documentation, versions 1.10 through 2019.2.1 are available at http://previous.sqream.com . +If you're looking for an older version of the documentation, versions 1.10 through 2019.2.1 are available at http://previous.sqream.com. .. toctree:: :caption: Contents: diff --git a/sqream_studio_5.4.6/index.rst b/sqream_studio_5.4.6/index.rst index 451a520ad..c4981ce81 100644 --- a/sqream_studio_5.4.6/index.rst +++ b/sqream_studio_5.4.6/index.rst @@ -15,5 +15,4 @@ This section describes how to use the SQream Accleration Studio version 5.4.6: executing_statements_and_running_queries_from_the_editor monitoring_workers_and_services_from_the_dashboard viewing_logs - creating_assigning_and_managing_roles_and_permissions - configuring_your_instance_of_sqream \ No newline at end of file + creating_assigning_and_managing_roles_and_permissions \ No newline at end of file From 4bdc8f6ba36a45b5ffd03ddd6316173c3fc451b7 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 4 Aug 2022 15:34:12 +0300 Subject: [PATCH 199/882] Delete configuring_your_instance_of_sqream.rst --- .../configuring_your_instance_of_sqream.rst | 25 ------------------- 1 file changed, 25 deletions(-) delete mode 100644 sqream_studio_5.4.6/configuring_your_instance_of_sqream.rst diff --git a/sqream_studio_5.4.6/configuring_your_instance_of_sqream.rst b/sqream_studio_5.4.6/configuring_your_instance_of_sqream.rst deleted file mode 100644 index a0def6827..000000000 --- a/sqream_studio_5.4.6/configuring_your_instance_of_sqream.rst +++ /dev/null @@ -1,25 +0,0 @@ -.. _configuring_your_instance_of_sqream: - -**************************** -Configuring Your Instance of SQream -**************************** -**Comment** - *Has this functionality been removed from Studio 5.4.6?* - -The **Configuration** section lets you edit parameters from one centralized location. While you can edit these parameters from the **worker configuration file (config.json)** or from your CLI, you can also modify them in Studio in an easy-to-use format. - -Configuring your instance of SQream in Studio is session-based, which enables you to edit parameters per session on your own device. -Because session-based configurations are not persistent and are deleted when your session ends, you can edit your required parameters while avoiding conflicts between parameters edited on different devices at different points in time. - -Editing Your Parameters -------------------------------- -When configuring your instance of SQream in Studio you can edit parameters for the **Generic** and **Admin** parameters only. - -Studio includes two types of parameters: toggle switches, such as **flipJoinOrder**, and text fields, such as **logSysLevel**. After editing a parameter, you can reset each one to its previous value or to its default value individually, or revert all parameters to their default setting simultaneously. Note that you must click **Save** to save your configurations. - -You can hover over the **information** icon located on each parameter to read a short description of its behavior. - -Exporting and Importing Configuration Files -------------------------- -You can also export and import your configuration settings into a .json file. This allows you to easily edit your parameters and to share this file with other users if required. - -For more information about configuring your instance of SQream, see :ref:`configuration_guides`. \ No newline at end of file From b072eabda389e4c26fea3d637195b29266f53092 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 4 Aug 2022 16:34:18 +0300 Subject: [PATCH 200/882] Updated --- feature_guides/query_healer.rst | 2 ++ .../utility_commands/shutdown_server.rst | 34 +++++-------------- 2 files changed, 11 insertions(+), 25 deletions(-) diff --git a/feature_guides/query_healer.rst b/feature_guides/query_healer.rst index 8f0b56d08..a2874e3bb 100644 --- a/feature_guides/query_healer.rst +++ b/feature_guides/query_healer.rst @@ -21,6 +21,8 @@ The following is an example of a log record for a query stuck in the query detec The ``healerMaxInactivityHours`` log frequency is calculated as 5% of the flag setting. When set to to five hours (the default setting), the Query Healer triggers an examination every 15 minutes. +.. note:: The logs are located in your cluster. + Configuring the Healer ------------------ The following **Administration Worker** flags are required to configure the Query Healer: diff --git a/reference/sql/sql_statements/utility_commands/shutdown_server.rst b/reference/sql/sql_statements/utility_commands/shutdown_server.rst index 1f607e753..334281929 100644 --- a/reference/sql/sql_statements/utility_commands/shutdown_server.rst +++ b/reference/sql/sql_statements/utility_commands/shutdown_server.rst @@ -11,7 +11,7 @@ The **SHUTDOWN_SERVER** guide describes the following: Overview =============== -SQream's current method for stopping the SQream server is running the ``shutdown_server ()`` utility command. Because this command abruptly shuts down the server while executing operations, it has been modified to perform a graceful shutdown, giving you more control over the following: +SQream's current method for stopping the SQream server is running the ``shutdown_server()`` utility command. Because this command abruptly shuts down the server while executing operations, it has been modified to perform a graceful shutdown, giving you more control over the following: * Preventing new queries from connecting to the server. @@ -29,7 +29,7 @@ Running the ``SHUTDOWN_SERVER`` command does the following: * Prevents new queries from entering the server by doing the following: - * Setting the SQream server to unavailable in the metadata server. **Comment** - *Is "unavailable" the official server setting?* + * Disabling incoming queries. :: @@ -39,9 +39,7 @@ Running the ``SHUTDOWN_SERVER`` command does the following: :: -* Waiting for the statement queue to be cleared - the graceful shutdown waits for queries that have been compiled on the server to be cleared from the statement queue. During this time - start executing on other available servers. - -**Comment** - *The last bullet requires clarification.* +* Waits for any queries that depend on server being shut down to leave the statement queue. Syntax ========== @@ -51,14 +49,12 @@ The following is the syntax for using the ``SHUTDOWN_SERVER`` command: select shutdown_server([is_graceful, [timeout]]); -**Comment** - *Is the below syntax correct?* - +The following is example of the ``SHUTDOWN_SERVER`` command: + .. code-block:: postgres select shutdown_server([true/false, [timeout]]); -**Comment** - *Can you set the timeout as a flag in Studio, or only in the CLI?* - Returns ========== Running the ``shutdown_server`` command returns no output. @@ -78,7 +74,7 @@ The following table shows the ``shutdown_server`` parameters: * - ``is_graceful`` - Determines the method used to shut down the server. - Selecting ``false`` shuts down the server while queries are running. Selecting ``true`` uses the graceful shutdown method. - - **Comment** - Is the default ``true`` or ``false``? + - ``false`` * - ``timeout`` - Sets the maximum amount of minutes for the graceful shutdown method to run before the server is shut down using the standard method. - ``30`` @@ -86,10 +82,8 @@ The following table shows the ``shutdown_server`` parameters: .. note:: Setting ``is_graceful`` to ``false`` and defining the ``timeout`` value shuts the server down mid-query after the defined time. -It is possible to pass as the second argument the timeout in minutes after which a forceful shutdown will run, regardless of the progression of the graceful shutdown. - -**Comment** - *How can the above be true given the following, "Note that running forced shutdown with a timeout, i.e. select shutdown_server(false, 30) will return an error message; forced shutdown has no timeout timer"?* - +It is possible to pass as the second argument the timeout in minutes after which a forceful shutdown will run after defining the graceful shutdown value, regardless of the progression of the graceful shutdown. + Note that you set the timeout value using the ``defaultGracefulShutdownTimeoutMinutes`` flag in Studio. For more information, see :ref:`graceful_shutdown`. @@ -98,16 +92,6 @@ For more information, see :ref:`graceful_shutdown`. Like shutdown_server() graceful shutdown will stop any query currently running on the server. -**Comment** - *The above makes it seem like it's a separate command, but that's not the case.* - -Relationship to Healer & Use Case -============================ -**Comment** - *Cannot document this section until I know what the Healer actually does.* - -Currently the Healer will not trigger a graceful shutdown upon detection of a stuck query. It will however log detection of such a query, prompting the user to run a graceful shutdown of the server, possibly saving existing queued queries. - Permissions ============= -Using the ``shutdown_server`` command requires no special permissions. - -**Comment** - *Confirm.* \ No newline at end of file +Using the ``shutdown_server`` command requires no special permissions. \ No newline at end of file From e0a7def00cccd2dcaf7d8521a19fa4b0d7bfa685 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 4 Aug 2022 22:21:22 +0300 Subject: [PATCH 201/882] Replaced 10.1 with 11.4 where necessary --- feature_guides/query_healer.rst | 2 +- .../installing_sqream_with_kubernetes.rst | 109 ++++++++++-------- .../running_sqream_in_a_docker_container.rst | 25 ++-- 3 files changed, 73 insertions(+), 63 deletions(-) diff --git a/feature_guides/query_healer.rst b/feature_guides/query_healer.rst index a2874e3bb..7068abc2d 100644 --- a/feature_guides/query_healer.rst +++ b/feature_guides/query_healer.rst @@ -17,7 +17,7 @@ The following is an example of a log record for a query stuck in the query detec .. code-block:: console - 2022/05/19::20:01:25|ERROR|Healer|(0x7f07147fc700)|Stuck query found. Statement ID: 72, Last chunk producer updated: 1 WriteTable, Started on: Thu May 19 14:01:25 2022, Last updated: Thu May 19 15:01:25 2022, Stuck time: 5 hours, Max allowed stuck query time: 5 hours + #SQ#|1659621825880088264|2022-05-19 20:01:25.880|INFO|0x00007f9a497fe700:Healer|192.168.4.65|5001|-1|master|sqream|-1|sqream|0|"[ERROR]|cpp/SqrmRT/healer.cpp:140 |"Stuck query found. Statement ID: 72, Last chunk producer updated: 1 WriteTable, Started on: Thu May 19 14:01:25 2022, Last updated: Thu May 19 15:01:25 2022, Stuck time: 5 hours, Max allowed stuck query time: 5 hours"|#EOM# The ``healerMaxInactivityHours`` log frequency is calculated as 5% of the flag setting. When set to to five hours (the default setting), the Query Healer triggers an examination every 15 minutes. diff --git a/installation_guides/installing_sqream_with_kubernetes.rst b/installation_guides/installing_sqream_with_kubernetes.rst index 093f21ba3..aa7e22422 100644 --- a/installation_guides/installing_sqream_with_kubernetes.rst +++ b/installation_guides/installing_sqream_with_kubernetes.rst @@ -197,27 +197,32 @@ After completing all of the steps above, you must check the CUDA version. .. code-block:: postgres - $ +-----------------------------------------------------------------------------+ - $ | NVIDIA-SMI 418.87.00 Driver Version: 418.87.00 CUDA Version: 10.1 | - $ |-------------------------------+----------------------+----------------------+ - $ | GPU Name Persistence-M| Bus-Id Disp.A | Volatile Uncorr. ECC | - $ | Fan Temp Perf Pwr:Usage/Cap| Memory-Usage | GPU-Util Compute M. | - $ |===============================+======================+======================| - $ | 0 GeForce GTX 105... Off | 00000000:01:00.0 Off | N/A | - $ | 32% 38C P0 N/A / 75W | 0MiB / 4039MiB | 0% Default | - $ +-------------------------------+----------------------+----------------------+ - $ - $ +-----------------------------------------------------------------------------+ - $ | Processes: GPU Memory | - $ | GPU PID Type Process name Usage | - $ |=============================================================================| - $ | No running processes found | - $ +-----------------------------------------------------------------------------+ - -In the above output, the CUDA version is **10.1**. - -If the above output is not generated, CUDA has not been installed. To install CUDA, see `Installing the CUDA driver `_. + +-----------------------------------------------------------------------------+ + | NVIDIA-SMI 470.82.01 Driver Version: 470.82.01 CUDA Version: 11.4 | + |-------------------------------+----------------------+----------------------+ + | GPU Name Persistence-M| Bus-Id Disp.A | Volatile Uncorr. ECC | + | Fan Temp Perf Pwr:Usage/Cap| Memory-Usage | GPU-Util Compute M. | + | | | MIG M. | + |===============================+======================+======================| + | 0 NVIDIA A100-PCI... On | 00000000:17:00.0 Off | 0 | + | N/A 34C P0 64W / 300W | 79927MiB / 80994MiB | 0% Default | + | | | Disabled | + +-------------------------------+----------------------+----------------------+ + | 1 NVIDIA A100-PCI... On | 00000000:CA:00.0 Off | 0 | + | N/A 35C P0 60W / 300W | 79927MiB / 80994MiB | 0% Default | + | | | Disabled | + +-------------------------------+----------------------+----------------------+ + + +-----------------------------------------------------------------------------+ + | Processes: GPU Memory | + | GPU PID Type Process name Usage | + |=============================================================================| + | No running processes found | + +-----------------------------------------------------------------------------+ + +In the above output, the CUDA version is **11.4**. +If the above output is not generated, CUDA has not been installed. To install CUDA, see :ref:`installing-the-cuda-driver`. Go back to :ref:`Setting Up Your Hosts` @@ -795,40 +800,46 @@ Installing the NVIDIA Docker2 Toolkit on an x86_64 Bit Processor on CentOS .. code-block:: postgres - $ docker run --runtime=nvidia --rm nvidia/cuda:10.1-base nvidia-smi + $ docker run --runtime=nvidia --rm nvidia/cuda:11.4.3-base-centos7 nvidia-smi The following is an example of the correct output: .. code-block:: postgres - $ docker run --runtime=nvidia --rm nvidia/cuda:10.1-base nvidia-smi - $ Unable to find image 'nvidia/cuda:10.1-base' locally - $ 10.1-base: Pulling from nvidia/cuda - $ d519e2592276: Pull complete - $ d22d2dfcfa9c: Pull complete - $ b3afe92c540b: Pull complete - $ 13a10df09dc1: Pull complete - $ 4f0bc36a7e1d: Pull complete - $ cd710321007d: Pull complete - $ Digest: sha256:635629544b2a2be3781246fdddc55cc1a7d8b352e2ef205ba6122b8404a52123 - $ Status: Downloaded newer image for nvidia/cuda:10.1-base - $ Sun Feb 14 13:27:58 2021 - $ +-----------------------------------------------------------------------------+ - $ | NVIDIA-SMI 418.87.00 Driver Version: 418.87.00 CUDA Version: 10.1 | - $ |-------------------------------+----------------------+----------------------+ - $ | GPU Name Persistence-M| Bus-Id Disp.A | Volatile Uncorr. ECC | - $ | Fan Temp Perf Pwr:Usage/Cap| Memory-Usage | GPU-Util Compute M. | - $ |===============================+======================+======================| - $ | 0 GeForce GTX 105... Off | 00000000:01:00.0 Off | N/A | - $ | 32% 37C P0 N/A / 75W | 0MiB / 4039MiB | 0% Default | - $ +-------------------------------+----------------------+----------------------+ - $ - $ +-----------------------------------------------------------------------------+ - $ | Processes: GPU Memory | - $ | GPU PID Type Process name Usage | - $ |=============================================================================| - $ | No running processes found | - $ +-----------------------------------------------------------------------------+ + docker run --runtime=nvidia --rm nvidia/cuda:11.4.3-base-centos7 nvidia-smi + Unable to find image 'nvidia/cuda:11.4.3-base-centos7' locally + 11.4.3-base-centos7: Pulling from nvidia/cuda + d519e2592276: Pull complete + d22d2dfcfa9c: Pull complete + b3afe92c540b: Pull complete + 13a10df09dc1: Pull complete + 4f0bc36a7e1d: Pull complete + cd710321007d: Pull complete + Digest: sha256:635629544b2a2be3781246fdddc55cc1a7d8b352e2ef205ba6122b8404a52123 + Status: Downloaded newer image for nvidia/cuda:11.4.3-base-centos7 + Sun Feb 14 13:27:58 2021 + +-----------------------------------------------------------------------------+ + | NVIDIA-SMI 470.82.01 Driver Version: 470.82.01 CUDA Version: 11.4 | + |-------------------------------+----------------------+----------------------+ + | GPU Name Persistence-M| Bus-Id Disp.A | Volatile Uncorr. ECC | + | Fan Temp Perf Pwr:Usage/Cap| Memory-Usage | GPU-Util Compute M. | + | | | MIG M. | + |===============================+======================+======================| + | 0 NVIDIA A100-PCI... On | 00000000:17:00.0 Off | 0 | + | N/A 34C P0 64W / 300W | 79927MiB / 80994MiB | 0% Default | + | | | Disabled | + +-------------------------------+----------------------+----------------------+ + | 1 NVIDIA A100-PCI... On | 00000000:CA:00.0 Off | 0 | + | N/A 35C P0 60W / 300W | 79927MiB / 80994MiB | 0% Default | + | | | Disabled | + +-------------------------------+----------------------+----------------------+ + + +-----------------------------------------------------------------------------+ + | Processes: GPU Memory | + | GPU PID Type Process name Usage | + |=============================================================================| + | No running processes found | + +-----------------------------------------------------------------------------+ For more information on installing the NVIDIA Docker2 Toolkit on an x86_64 Bit Processor on CentOS, see `NVIDIA Docker Installation - CentOS distributions `_ diff --git a/installation_guides/running_sqream_in_a_docker_container.rst b/installation_guides/running_sqream_in_a_docker_container.rst index e85eac925..dd8d07e50 100644 --- a/installation_guides/running_sqream_in_a_docker_container.rst +++ b/installation_guides/running_sqream_in_a_docker_container.rst @@ -248,7 +248,7 @@ Installing the Nvidia CUDA Driver nvidia-smi Wed Oct 30 14:05:42 2019 +-----------------------------------------------------------------------------+ - | NVIDIA-SMI 418.87.00 Driver Version: 418.87.00 CUDA Version: 10.1 | + | NVIDIA-SMI 470.82.01 Driver Version: 470.82.01 CUDA Version: 11.4 | |-------------------------------+----------------------+----------------------+ | GPU Name Persistence-M| Bus-Id Disp.A | Volatile Uncorr. ECC | | Fan Temp Perf Pwr:Usage/Cap| Memory-Usage | GPU-Util Compute M. | @@ -267,7 +267,7 @@ Installing the Nvidia CUDA Driver | No running processes found | +-----------------------------------------------------------------------------+ -#. Verify that the installed CUDA version shown in the output above is ``10.1``. +#. Verify that the installed CUDA version shown in the output above is ``11.4``. :: @@ -276,25 +276,25 @@ Installing the Nvidia CUDA Driver :: - 1. If CUDA version 10.1 has already been installed, skip to Docktime Runtime (Community Edition). + 1. If CUDA version 11.4 has already been installed, skip to Docktime Runtime (Community Edition). :: - 2. If CUDA version 10.1 has not been installed yet, continue with Step 7 below. + 2. If CUDA version 11.4 has not been installed yet, continue with Step 7 below. #. Do one of the following: - * Install :ref:`CUDA Driver version 10.1 for x86_64 `. + * Install :ref:`CUDA Driver version 11.4 for x86_64 `. :: * Install :ref:`CUDA driver version 10.1 for IBM Power9 `. -.. _CUDA_10.1_x8664: +.. _CUDA_11.4_x8664: -Installing the CUDA Driver Version 10.1 for x86_64 +Installing the CUDA Driver Version 11.4 for x86_64 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -**To install the CUDA driver version 10.1 for x86_64:** +**To install the CUDA driver version 11.4 for x86_64:** 1. Make the following target platform selections: @@ -314,7 +314,6 @@ For installer type, SQream recommends selecting **runfile (local)**. The availab wget http://developer.download.nvidia.com/compute/cuda/10.1/Prod/local_installers/cuda-repo-rhel7-10-1-local-10.1.243-418.87.00-1.0-1.x86_64.rpm - 3. Install the base installer for Linux CentOS 7 x86_64 by running the following commands: .. code-block:: @@ -353,7 +352,7 @@ For installer type, SQream recommends selecting **runfile (local)**. The availab nvidia-smi Wed Oct 30 14:05:42 2019 +-----------------------------------------------------------------------------+ - | NVIDIA-SMI 418.87.00 Driver Version: 418.87.00 CUDA Version: 10.1 | + | NVIDIA-SMI 470.82.01 Driver Version: 470.82.01 CUDA Version: 11.4 | |-------------------------------+----------------------+----------------------+ | GPU Name Persistence-M| Bus-Id Disp.A | Volatile Uncorr. ECC | | Fan Temp Perf Pwr:Usage/Cap| Memory-Usage | GPU-Util Compute M. | @@ -623,7 +622,7 @@ Installing the NVIDIA Docker2 Toolkit on a CentOS Operating System .. code-block:: - $ docker run --runtime=nvidia --rm nvidia/cuda:10.1-base nvidia-smi + $ docker run --runtime=nvidia --rm nvidia/cuda:11.4.3-base-centos7 nvidia-smi For more information on installing the NVIDIA Docker2 Toolkit on a CentOS operating system, see :ref:`Installing the NVIDIA Docker2 Toolkit on a CentOS operating system ` @@ -675,7 +674,7 @@ Installing the NVIDIA Docker2 Toolkit on an Ubuntu Operating System .. code-block:: - $ docker run --runtime=nvidia --rm nvidia/cuda:10.1-base nvidia-smi + $ docker run --runtime=nvidia --rm nvidia/cuda:11.4.3-base-centos7 nvidia-smi For more information on installing the NVIDIA Docker2 Toolkit on a CentOS operating system, see :ref:`Installing the NVIDIA Docker2 Toolkit on an Ubuntu operating system ` @@ -1063,7 +1062,7 @@ The following is an example of the correct output: METADATA_PORT=3105 PICKER_PORT=3108 NUM_OF_GPUS=2 - CUDA_VERSION=10.1 + CUDA_VERSION=11.4 NVIDIA_SMI_PATH=/usr/bin/nvidia-smi DOCKER_PATH=/usr/bin/docker NVIDIA_DRIVER=418 From e42dc04cb2778fb9be4caa4060a3cf4fb492e2d9 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 4 Aug 2022 22:30:17 +0300 Subject: [PATCH 202/882] Update healer_max_inactivity_hours.rst --- configuration_guides/healer_max_inactivity_hours.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/configuration_guides/healer_max_inactivity_hours.rst b/configuration_guides/healer_max_inactivity_hours.rst index d05d46014..56ddb78fc 100644 --- a/configuration_guides/healer_max_inactivity_hours.rst +++ b/configuration_guides/healer_max_inactivity_hours.rst @@ -1,7 +1,7 @@ .. _healer_max_inactivity_hours: ************************* -Query Healer +Configuring the Query Healer ************************* The ``healerMaxInactivityHours`` flag is used for defining the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU. From 888673e4502ed3fccfc117c61d308cbf05f0df0b Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 4 Aug 2022 22:49:09 +0300 Subject: [PATCH 203/882] Added Graceful Shutdown Flag --- configuration_guides/admin_regular_flags.rst | 3 ++- configuration_guides/graceful_shutdown.rst | 22 ++++++++++++++++++ .../utility_commands/shutdown_server.rst | 12 +++++----- .../getting_started_sqream.rst | 2 -- sqream_studio_5.4.6/viewing_logs.rst | 23 +------------------ 5 files changed, 31 insertions(+), 31 deletions(-) create mode 100644 configuration_guides/graceful_shutdown.rst diff --git a/configuration_guides/admin_regular_flags.rst b/configuration_guides/admin_regular_flags.rst index 064fc4b1a..133641765 100644 --- a/configuration_guides/admin_regular_flags.rst +++ b/configuration_guides/admin_regular_flags.rst @@ -3,7 +3,7 @@ ************************* Regular Administration Flags ************************* -The **Regular Administration Flags** page describes **Regular** modification type flags, which can be modified by administrators on a session and cluster basis using the ``ALTER SYSTEM SET`` command: +The **Regular Administration Flags** page describes **Regular** modification type flags, which can be modified by administrators on a session and cluster basis using the ``ALTER SYSTEM SET`` command: * `Setting Bin Size `_ * `Setting CUDA Memory `_ @@ -12,6 +12,7 @@ The **Regular Administration Flags** page describes **Regular** modification typ * `Reducing CPU Hashtable Sizes `_ * `Setting Chunk Size for Copying from CPU to GPU `_ * `Indicating GPU Synchronicity `_ +* `Setting the Graceful Server Shutdown `_ * `Enabling Modification of R&D Flags `_ * `Checking for Post-Production CUDA Errors `_ * `Enabling Modification of clientLogger_debug File `_ diff --git a/configuration_guides/graceful_shutdown.rst b/configuration_guides/graceful_shutdown.rst new file mode 100644 index 000000000..8b4f4b55c --- /dev/null +++ b/configuration_guides/graceful_shutdown.rst @@ -0,0 +1,22 @@ +.. _graceful_shutdown: + +************************* +Setting the Graceful Server Shutdown +************************* +The ``defaultGracefulShutdownTimeoutMinutes`` flag is used for setting the amount of time to pass before SQream performs a graceful server shutdown. + +The following describes the ``defaultGracefulShutdownTimeoutMinutes`` flag: + +* **Data type** - size_t +* **Default value** - ``5`` +* **Allowed values** - 1-4000000000 + +For more information, see :ref:`shutdown_server`. + +For related flags, see the folowing: + +* :ref:`is_healer_on` + + :: + +* :ref:`healer_max_inactivity_hours` \ No newline at end of file diff --git a/reference/sql/sql_statements/utility_commands/shutdown_server.rst b/reference/sql/sql_statements/utility_commands/shutdown_server.rst index 334281929..b38834d7e 100644 --- a/reference/sql/sql_statements/utility_commands/shutdown_server.rst +++ b/reference/sql/sql_statements/utility_commands/shutdown_server.rst @@ -69,16 +69,16 @@ The following table shows the ``shutdown_server`` parameters: * - Parameter - Description - - Example - - Default + - Example + - Default * - ``is_graceful`` - Determines the method used to shut down the server. - - Selecting ``false`` shuts down the server while queries are running. Selecting ``true`` uses the graceful shutdown method. - - ``false`` + - Selecting ``false`` shuts down the server while queries are running. Selecting ``true`` uses the graceful shutdown method. + - ``false`` * - ``timeout`` - Sets the maximum amount of minutes for the graceful shutdown method to run before the server is shut down using the standard method. - - ``30`` - - Five minutes. + - ``30`` + - Five minutes. .. note:: Setting ``is_graceful`` to ``false`` and defining the ``timeout`` value shuts the server down mid-query after the defined time. diff --git a/sqream_studio_5.4.6/getting_started_sqream.rst b/sqream_studio_5.4.6/getting_started_sqream.rst index 10542277e..ea95f0c41 100644 --- a/sqream_studio_5.4.6/getting_started_sqream.rst +++ b/sqream_studio_5.4.6/getting_started_sqream.rst @@ -45,8 +45,6 @@ From here you can navigate between the main areas of the Studio: - Lets you view usage logs. * - :ref:`Roles` - Lets you create users and manage user permissions. - * - :ref:`Configuration` - - Lets you configure your instance of SQream. By clicking the user icon, you can also use it for logging out and viewing the following: diff --git a/sqream_studio_5.4.6/viewing_logs.rst b/sqream_studio_5.4.6/viewing_logs.rst index 99afde3d2..4b4654c4a 100644 --- a/sqream_studio_5.4.6/viewing_logs.rst +++ b/sqream_studio_5.4.6/viewing_logs.rst @@ -101,25 +101,4 @@ In the Systems table, you can click on the **Timestamp** and **Log type** items :ref:`Back to Viewing Logs` -.. _log_lines_5.4.6: - -Viewing All Log Lines ----------- -**Comment** - *Has this tab been removed from the GUI?* - -The **LOG LINES** tab is used for viewing the total amount of log lines in a table. From here users can view a more granular breakdown of log information collected by Studio. The other tabs (QUERIES, SESSIONS, and SYSTEM) show a filtered form of the raw log lines. For example, the QUERIES tab shows an aggregation of several log lines. - -From here you can see and sort by the following: - -* Timestamp -* Message level -* Worker hostname -* Worker port -* Connection ID -* Database name -* User name -* Statement ID - -In the **LOG LINES** table, you can click on any of the items to set them as your filters. - -:ref:`Back to Viewing Logs` \ No newline at end of file +.. _log_lines_5.4.6: \ No newline at end of file From bb28843d0130eb9553d8142fff5bc95bc182629e Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 4 Aug 2022 22:57:05 +0300 Subject: [PATCH 204/882] Update shutdown_server.rst --- .../sql/sql_statements/utility_commands/shutdown_server.rst | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/reference/sql/sql_statements/utility_commands/shutdown_server.rst b/reference/sql/sql_statements/utility_commands/shutdown_server.rst index b38834d7e..7fa1571b5 100644 --- a/reference/sql/sql_statements/utility_commands/shutdown_server.rst +++ b/reference/sql/sql_statements/utility_commands/shutdown_server.rst @@ -88,9 +88,7 @@ Note that you set the timeout value using the ``defaultGracefulShutdownTimeoutMi For more information, see :ref:`graceful_shutdown`. -**Comment** - *I have not yet created the ``graceful_shutdown`` configuration flag. I need to know what category it belongs in before doing so.* - -Like shutdown_server() graceful shutdown will stop any query currently running on the server. +As with the ``shutdown_server`` command, the **graceful server shutdown** stops all queries currently running on your server. Permissions ============= From 50944519ccd025eb3662df831fab61e76a24d57c Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Thu, 4 Aug 2022 23:04:17 +0300 Subject: [PATCH 205/882] Corrected the links --- configuration_guides/admin_regular_flags.rst | 50 +++++++++---------- .../generic_regular_flags.rst | 26 +++++----- configuration_guides/generic_worker_flags.rst | 2 +- 3 files changed, 39 insertions(+), 39 deletions(-) diff --git a/configuration_guides/admin_regular_flags.rst b/configuration_guides/admin_regular_flags.rst index 133641765..902ff224b 100644 --- a/configuration_guides/admin_regular_flags.rst +++ b/configuration_guides/admin_regular_flags.rst @@ -5,28 +5,28 @@ Regular Administration Flags ************************* The **Regular Administration Flags** page describes **Regular** modification type flags, which can be modified by administrators on a session and cluster basis using the ``ALTER SYSTEM SET`` command: -* `Setting Bin Size `_ -* `Setting CUDA Memory `_ -* `Limiting Runtime to Utility Functions `_ -* `Enabling High Bin Control Granularity `_ -* `Reducing CPU Hashtable Sizes `_ -* `Setting Chunk Size for Copying from CPU to GPU `_ -* `Indicating GPU Synchronicity `_ -* `Setting the Graceful Server Shutdown `_ -* `Enabling Modification of R&D Flags `_ -* `Checking for Post-Production CUDA Errors `_ -* `Enabling Modification of clientLogger_debug File `_ -* `Activating the NVidia Profiler Markers `_ -* `Appending String at End of Log Lines `_ -* `Monitoring and Printing Pinned Allocation Reports `_ -* `Increasing Chunk Size to Reduce Query Speed `_ -* `Adding Rechunker before Expensing Chunk Producer `_ -* `Setting the Buffer Size `_ -* `Setting Memory Used to Abort Server `_ -* `Splitting Large Reads for Concurrent Execution `_ -* `Setting Worker Amount to Handle Concurrent Reads `_ -* `Setting Implicit Casts in ORC Files `_ -* `Setting Timeout Limit for Locking Objects before Executing Statements `_ -* `Interpreting Decimal Literals as Double Instead of Numeric `_ -* `Interpreting VARCHAR as TEXT `_ -* `VARCHAR Identifiers `_ +* `Setting Bin Size `_ +* `Setting CUDA Memory `_ +* `Limiting Runtime to Utility Functions `_ +* `Enabling High Bin Control Granularity `_ +* `Reducing CPU Hashtable Sizes `_ +* `Setting Chunk Size for Copying from CPU to GPU `_ +* `Indicating GPU Synchronicity `_ +* `Setting the Graceful Server Shutdown `_ +* `Enabling Modification of R&D Flags `_ +* `Checking for Post-Production CUDA Errors `_ +* `Enabling Modification of clientLogger_debug File `_ +* `Activating the NVidia Profiler Markers `_ +* `Appending String at End of Log Lines `_ +* `Monitoring and Printing Pinned Allocation Reports `_ +* `Increasing Chunk Size to Reduce Query Speed `_ +* `Adding Rechunker before Expensing Chunk Producer `_ +* `Setting the Buffer Size `_ +* `Setting Memory Used to Abort Server `_ +* `Splitting Large Reads for Concurrent Execution `_ +* `Setting Worker Amount to Handle Concurrent Reads `_ +* `Setting Implicit Casts in ORC Files `_ +* `Setting Timeout Limit for Locking Objects before Executing Statements `_ +* `Interpreting Decimal Literals as Double Instead of Numeric `_ +* `Interpreting VARCHAR as TEXT `_ +* `VARCHAR Identifiers `_ diff --git a/configuration_guides/generic_regular_flags.rst b/configuration_guides/generic_regular_flags.rst index 83afa9e8f..34ff6850c 100644 --- a/configuration_guides/generic_regular_flags.rst +++ b/configuration_guides/generic_regular_flags.rst @@ -6,16 +6,16 @@ Regular Generic Flags The **Regular Generic Flags** page describes **Regular** modification type flags, which can be modified by standard users on a session basis: -* `Flipping Join Order to Force Equijoins `_ -* `Determining Client Level `_ -* `Setting CPU to Compress Defined Columns `_ -* `Setting Query Memory Processing Limit `_ -* `Setting the Spool Memory `_ -* `Setting Cache Partitions `_ -* `Setting Cache Flushing `_ -* `Setting InMemory Spool Memory `_ -* `Setting Disk Spool Memory `_ -* `Setting Spool Saved File Directory Location `_ -* `Setting Data Stored Persistently on Cache `_ -* `Setting Persistent Spool Saved File Directory Location `_ -* `Setting Session Tag Name `_ \ No newline at end of file +* `Flipping Join Order to Force Equijoins `_ +* `Determining Client Level `_ +* `Setting CPU to Compress Defined Columns `_ +* `Setting Query Memory Processing Limit `_ +* `Setting the Spool Memory `_ +* `Setting Cache Partitions `_ +* `Setting Cache Flushing `_ +* `Setting InMemory Spool Memory `_ +* `Setting Disk Spool Memory `_ +* `Setting Spool Saved File Directory Location `_ +* `Setting Data Stored Persistently on Cache `_ +* `Setting Persistent Spool Saved File Directory Location `_ +* `Setting Session Tag Name `_ \ No newline at end of file diff --git a/configuration_guides/generic_worker_flags.rst b/configuration_guides/generic_worker_flags.rst index 59fb9ac7a..7ae2a0ee7 100644 --- a/configuration_guides/generic_worker_flags.rst +++ b/configuration_guides/generic_worker_flags.rst @@ -5,4 +5,4 @@ Worker Generic Flags ************************* The Worker Generic Flags** page describes **Worker** modification type flags, which can be modified by standard users on a session basis: - * `Persisting Your Cache Directory `_ \ No newline at end of file + * `Persisting Your Cache Directory `_ \ No newline at end of file From 98252ade3376b591bf3f37f95a988ab01113134b Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Mon, 8 Aug 2022 22:08:30 +0300 Subject: [PATCH 206/882] Removed enhancements to Update feature --- .../sql/sql_statements/dml_commands/update.rst | 16 ---------------- releases/2022.1.1.rst | 7 ------- releases/2022.1_index.rst | 3 --- 3 files changed, 26 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/update.rst b/reference/sql/sql_statements/dml_commands/update.rst index 6cc33f516..873cf6290 100644 --- a/reference/sql/sql_statements/dml_commands/update.rst +++ b/reference/sql/sql_statements/dml_commands/update.rst @@ -62,8 +62,6 @@ The following table describes the ``UPDATE`` parameters: - Specifies the column containing the data to be updated. * - ``additional_table_name`` - Specifies the column containing the data to be updated. - * - ``FROM`` |icon-new_2022.1.1| - - For making complex joins, specifies additional tables to be used in the WHERE condition. ``FROM`` is similar to the ``FROM`` clause in a ``DELETE`` statement. * - ``condition`` - Specifies the condition for updating the data. @@ -87,20 +85,6 @@ The following is an example of performing a simple update: UPDATE bands SET records_sold = records_sold + 1 WHERE name LIKE 'The %'; -Updating Tables that Contain Multi-Table Conditions ------------------ -The following shows an example of updating tables that contain multi-table conditions |icon-new_2022.1.1|: - -.. code-block:: postgres - - UPDATE bands - SET records_sold = records_sold + 1 - WHERE EXISTS ( - SELECT 1 FROM countries - WHERE countries.id=bands.country_id - AND country.name = 'Sweden' - ); - Triggering a Clean-Up ----------------- The following section shows an example of triggering a clean-up: diff --git a/releases/2022.1.1.rst b/releases/2022.1.1.rst index 517c11042..1421a82a6 100644 --- a/releases/2022.1.1.rst +++ b/releases/2022.1.1.rst @@ -14,7 +14,6 @@ Version Content The 2022.1.1 Release Notes describes the following: * Enhanced security features. -* New data manipulation command. * Additional data ingestion format. New Features @@ -25,12 +24,6 @@ The 2022.1.1 Release Notes include the following new features: :local: :depth: 1 -Update Feature -************ -The DML ``UPDATE`` statement has been enhanced to support running subqueries in the ``WHERE`` condition. - -For more information, see `UPDATE `_. - Password Security Compliance ************ In compliance with GDPR standards, SQream now requires a strong password policy when accessing the CLI or Studio. diff --git a/releases/2022.1_index.rst b/releases/2022.1_index.rst index 16a7d80ef..4018bedd1 100644 --- a/releases/2022.1_index.rst +++ b/releases/2022.1_index.rst @@ -35,9 +35,6 @@ The following enhancements were introduced in :ref:`August 2022 (2022.1.1) <2022 * - **Operational Guides** - :ref:`Password Security Compliance` - Integrated password security compliance measures when logging in to the CLI or Studio. - * - **Reference Guides** - - :ref:`update` - - The DML ``UPDATE`` statement has been enhanced to support running subqueries in the ``WHERE`` condition. July 2022 ================== From 99c9c020bdfb196ddb7fb55adbbd7d081ca6b6d9 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 9 Aug 2022 10:19:09 +0300 Subject: [PATCH 207/882] Prepared for 2022.1.1 Release Removed New for 2022.1 icons. Removed zlib compression. Removed compression from 2022.1.1 RN main page. Removed zlib and Update from 2022.1 RN main page. --- data_ingestion/avro.rst | 2 +- feature_guides/compression.rst | 4 ---- feature_guides/data_encryption.rst | 2 +- releases/2022.1.1.rst | 7 ------- releases/2022.1_index.rst | 5 +---- 5 files changed, 3 insertions(+), 17 deletions(-) diff --git a/data_ingestion/avro.rst b/data_ingestion/avro.rst index 753786376..b20e64d49 100644 --- a/data_ingestion/avro.rst +++ b/data_ingestion/avro.rst @@ -3,7 +3,7 @@ ************************** Inserting Data from Avro ************************** -The **Inserting Data from Avro** page |icon-new_2022.1| describes inserting data from Avro into SQream and includes the following: +The **Inserting Data from Avro** page describes inserting data from Avro into SQream and includes the following: .. |icon-new_2022.1| image:: /_static/images/new_2022.1.png :align: middle diff --git a/feature_guides/compression.rst b/feature_guides/compression.rst index ce5e922b6..4472c7ded 100644 --- a/feature_guides/compression.rst +++ b/feature_guides/compression.rst @@ -93,10 +93,6 @@ Compression strategies - Integer types - Optimized RLE + Delta type for built-in :ref:`identity columns`. - GPU - * - ``zlib`` |icon-new_dark_gray_2022.1.1.png| - - All types - - The **basic_zlib_compressor** and **basic_zlib_decompressor** compress and decompress data in the **ZLIB** format, using **DualUseFilters** for input and output. In general, compression filters are for output, and decompression filters for input. - - CPU .. _specifying_compressions: diff --git a/feature_guides/data_encryption.rst b/feature_guides/data_encryption.rst index 19aabb8e3..607d6c09a 100644 --- a/feature_guides/data_encryption.rst +++ b/feature_guides/data_encryption.rst @@ -3,7 +3,7 @@ *********************** Data Encryption *********************** -The **Data Encryption** page |icon-new_2022.1| describes the following: +The **Data Encryption** page describes the following: .. |icon-new_2022.1| image:: /_static/images/new_2022.1.png :align: middle diff --git a/releases/2022.1.1.rst b/releases/2022.1.1.rst index 1421a82a6..faec3add2 100644 --- a/releases/2022.1.1.rst +++ b/releases/2022.1.1.rst @@ -14,7 +14,6 @@ Version Content The 2022.1.1 Release Notes describes the following: * Enhanced security features. -* Additional data ingestion format. New Features ---------- @@ -30,12 +29,6 @@ In compliance with GDPR standards, SQream now requires a strong password policy For more information, see :ref:`access_control_password_policy`. -Compression -************ -SQream now supports the **zlib** compression format. - -For more information, see `Compression `_. - Known Issues --------- The following table lists the known issues for Version 2022.1.1: diff --git a/releases/2022.1_index.rst b/releases/2022.1_index.rst index 4018bedd1..eeb744d4e 100644 --- a/releases/2022.1_index.rst +++ b/releases/2022.1_index.rst @@ -29,9 +29,6 @@ The following enhancements were introduced in :ref:`August 2022 (2022.1.1) <2022 * - Topic - Feature - Description - * - **Feature Guides** - - :ref:`compression` - - SQream supports compressing and decompressing data in and from the **ZLIB** format. * - **Operational Guides** - :ref:`Password Security Compliance` - Integrated password security compliance measures when logging in to the CLI or Studio. @@ -54,5 +51,5 @@ The following enhancements were introduced in :ref:`July 2022 (2022.1) <2022.1>` - :ref:`data_encryption` - SQream has integrated data encryption mechanisms in accordance with General Data Protection Regulation (GDPR) standards. * - **Reference Guides** - - `UPDATE `_ + - `UPDATE `_ - The DML ``UPDATE`` statement has been introduced to support modifying the value of certain columns in existing rows. \ No newline at end of file From dfdcdea2f29f7c172ec4088ea2d0c7b57185967e Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 9 Aug 2022 11:14:00 +0300 Subject: [PATCH 208/882] Released 2022.1.1 --- operational_guides/access_control.rst | 2 +- releases/2022.1_index.rst | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/operational_guides/access_control.rst b/operational_guides/access_control.rst index d5d32394e..9d12ed712 100644 --- a/operational_guides/access_control.rst +++ b/operational_guides/access_control.rst @@ -8,8 +8,8 @@ Access Control :maxdepth: 1 :titlesonly: + access_control_password_policy access_control_overview access_control_managing_roles access_control_permissions - access_control_password_policy access_control_departmental_example \ No newline at end of file diff --git a/releases/2022.1_index.rst b/releases/2022.1_index.rst index eeb744d4e..284dc299f 100644 --- a/releases/2022.1_index.rst +++ b/releases/2022.1_index.rst @@ -45,11 +45,11 @@ The following enhancements were introduced in :ref:`July 2022 (2022.1) <2022.1>` - Feature - Description * - **Data Ingestion** - - :ref:`avro` + - `Inserting data from Avro `_ - SQream now supports ingesting data from Avro files. * - **Feature Guides** - - :ref:`data_encryption` + - `Data encryption `_ - SQream has integrated data encryption mechanisms in accordance with General Data Protection Regulation (GDPR) standards. * - **Reference Guides** - - `UPDATE `_ + - `UPDATE `_ - The DML ``UPDATE`` statement has been introduced to support modifying the value of certain columns in existing rows. \ No newline at end of file From e73416b9cd33d38f1bc71cd5eee16fa2a0e99711 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 9 Aug 2022 11:26:04 +0300 Subject: [PATCH 209/882] Corrected date in conf.py --- conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/conf.py b/conf.py index 95a622cd6..f8ee2ea90 100644 --- a/conf.py +++ b/conf.py @@ -26,7 +26,7 @@ # The full version, including alpha/beta/rc tags -release = '2021.2' +release = '2022.1.1' From c89c5bcf0ae213d56859b763352fec4b33798e68 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 9 Aug 2022 12:00:12 +0300 Subject: [PATCH 210/882] 2022.1.1 Removed New for 2022.1.1 icon (it doesn't look good). On main RN page, replaced ref syntax with absolute URL. --- configuration_guides/login_max_retries.rst | 2 +- operational_guides/access_control_password_policy.rst | 2 +- releases/2022.1.1.rst | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/configuration_guides/login_max_retries.rst b/configuration_guides/login_max_retries.rst index af236c9c3..6938d990b 100644 --- a/configuration_guides/login_max_retries.rst +++ b/configuration_guides/login_max_retries.rst @@ -8,7 +8,7 @@ Adjusting Permitted Log-in Attempts :align: middle :width: 110 -The ``loginMaxRetries`` flag |icon-new_2022.1.1| sets the permitted log-in attempts. +The ``loginMaxRetries`` flag sets the permitted log-in attempts. The following describes the ``loginMaxRetries`` flag: diff --git a/operational_guides/access_control_password_policy.rst b/operational_guides/access_control_password_policy.rst index fc845ebc4..6f678dc10 100644 --- a/operational_guides/access_control_password_policy.rst +++ b/operational_guides/access_control_password_policy.rst @@ -8,7 +8,7 @@ Password Security Compliance (New!) :align: middle :width: 110 -As part of our compliance with GDPR standards |icon-new_gray_2022.1.1| SQream relies on a strong password policy when accessing the CLI or Studio. +As part of our compliance with GDPR standards SQream relies on a strong password policy when accessing the CLI or Studio. The following requirements apply when creating a password: diff --git a/releases/2022.1.1.rst b/releases/2022.1.1.rst index faec3add2..c830b15b6 100644 --- a/releases/2022.1.1.rst +++ b/releases/2022.1.1.rst @@ -27,7 +27,7 @@ Password Security Compliance ************ In compliance with GDPR standards, SQream now requires a strong password policy when accessing the CLI or Studio. -For more information, see :ref:`access_control_password_policy`. +For more information, see `Access Control Password Policy `_. Known Issues --------- From 38d2cb5d0ab202a806f544e2cee9fefce2bf0fad Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 9 Aug 2022 16:07:50 +0300 Subject: [PATCH 211/882] Returned 2020.3.2 --- releases/2020.3.2.rst | 28 ++++++++++++++++++++++++++++ releases/2020.3_index.rst | 3 ++- 2 files changed, 30 insertions(+), 1 deletion(-) create mode 100644 releases/2020.3.2.rst diff --git a/releases/2020.3.2.rst b/releases/2020.3.2.rst new file mode 100644 index 000000000..c97e2bd47 --- /dev/null +++ b/releases/2020.3.2.rst @@ -0,0 +1,28 @@ +.. _2020.3.2: + +************************** +What's new in 2020.3.2 +************************** + +SQream DB v2020.3.2 contains major performance improvements and some bug fixes. + +Performance Enhancements +========================= +* Metadata on Demand optimization resulting in reduced latency and improved overall performance + + +Known Issues & Limitations +================================ +* Bug with STDDEV_SAMP,STDDEV_POP and STDEV functions +* Window function query returns wrong results +* rank() in window function sometimes returns garbage +* Window function on null value could have bad result +* Window function lead() on varchar can have garbage results +* Performance degradation when using "groupby" or outer_join + +Upgrading to v2020.3.2 +======================== + +Versions are available for IBM POWER9, RedHat (CentOS) 7, Ubuntu 18.04, and other OSs via Docker. + +Contact your account manager to get the latest release of SQream DB. diff --git a/releases/2020.3_index.rst b/releases/2020.3_index.rst index b13340b52..a662cb48a 100644 --- a/releases/2020.3_index.rst +++ b/releases/2020.3_index.rst @@ -3,7 +3,7 @@ ************************** Release Notes 2020.3 ************************** -The 2020.3 Release Notes describe the following releases: +The 2020.3 release notes describe the following releases: .. contents:: :local: @@ -14,5 +14,6 @@ The 2020.3 Release Notes describe the following releases: :glob: 2020.3.2.1 + 2020.3.2 2020.3.1 2020.3 \ No newline at end of file From a4f8bc94f4e9bd8c56e8cc8e1611c540a6e11a1f Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 9 Aug 2022 16:33:12 +0300 Subject: [PATCH 212/882] Divided bugs --- releases/2021.2.1.24.rst | 42 ++++++++++++++++++++++++++-------------- 1 file changed, 28 insertions(+), 14 deletions(-) diff --git a/releases/2021.2.1.24.rst b/releases/2021.2.1.24.rst index 1d5407d89..aa60c701c 100644 --- a/releases/2021.2.1.24.rst +++ b/releases/2021.2.1.24.rst @@ -15,7 +15,7 @@ The 2021.2.1.24 Release Notes includes a query maintenance feature. New Features ---------- -The 2021.2.1.24 Release Notes include the following new features: +The 2021.2.1.24 Release Notes include the following new features: .. contents:: :local: @@ -27,35 +27,49 @@ The new **Query Healer** feature periodically examines the progress of running s For more information, see `Query Healer `_. -Known Issues +Resolved Issues --------- -The following table lists the known issues for Version 2021.2.1.24: +The following table lists the resolved issues for Version 2021.2.1.24: +-------------+------------------------------------------------------------------------------------------------------------------------------------+ | **SQ No.** | **Description** | +=============+====================================================================================================================================+ -| SQ-10071 | An error occurred on existing subqueries with ``TEXT`` and ``VARCHAR`` equality conditions. | -+-------------+------------------------------------------------------------------------------------------------------------------------------------+ | SQ-10606 | Queries were getting stuck in the queue for a prolonged time. | +-------------+------------------------------------------------------------------------------------------------------------------------------------+ | SQ-10691 | The DB schema identifier was causing an error when running queries from joins suite. | +-------------+------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10902 | Inserting a null value into non-null column was causing SQream to crash. | -+-------------+------------------------------------------------------------------------------------------------------------------------------------+ | SQ-10918 | The Workload Manager was only assigning jobs sequentially, delaying user SQLs assigned to workers running very large jobs. | +-------------+------------------------------------------------------------------------------------------------------------------------------------+ | SQ-10955 | Metadata filters were not being applied when users filtered by nullable dates using ``dateadd`` | +-------------+------------------------------------------------------------------------------------------------------------------------------------+ + +Known Issues +--------- +The following table lists the known issues for Version 2021.2.1.24: + ++-------------+------------------------------------------------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++=============+====================================================================================================================================+ +| SQ-10071 | An error occurred on existing subqueries with ``TEXT`` and ``VARCHAR`` equality conditions. | ++-------------+------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-10902 | Inserting a null value into non-null column was causing SQream to crash. | ++-------------+------------------------------------------------------------------------------------------------------------------------------------+ | SQ-11088 | Specific workers caused low performance during compilation. | +-------------+------------------------------------------------------------------------------------------------------------------------------------+ -Resolved Issues ---------- -The Resolved Issues section is not relevant for Version 2021.2.1.24. +Operations and Configuration Changes +-------- +The following configuration flags were added: -Operational and Configuration Changes -------- -No relevant operational or configuration changes were made. + * :ref:`is_healer_on` + + :: + + * :ref:`healer_max_inactivity_hours` + + :: + + * :ref:`login_max_retries` Naming Changes ------- @@ -74,4 +88,4 @@ The End of Support section is not relevant to Version 2021.2.1.24. :glob: :hidden: - 2021.2.1.24 \ No newline at end of file + 2021.2.1.24 From 2629fc755633effc64451c9729b6ab55a9ebee67 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 9 Aug 2022 18:02:46 +0300 Subject: [PATCH 213/882] Reverted to 2022.1 Will restore 2022.1.1 when new release date is decided. --- operational_guides/access_control.rst | 1 - .../access_control_password_policy.rst | 73 -------- releases/2022.1.1.rst | 113 ------------ releases/2022.1_index.rst | 162 +++++++++++++----- 4 files changed, 122 insertions(+), 227 deletions(-) delete mode 100644 operational_guides/access_control_password_policy.rst delete mode 100644 releases/2022.1.1.rst diff --git a/operational_guides/access_control.rst b/operational_guides/access_control.rst index 9d12ed712..88a14d71b 100644 --- a/operational_guides/access_control.rst +++ b/operational_guides/access_control.rst @@ -8,7 +8,6 @@ Access Control :maxdepth: 1 :titlesonly: - access_control_password_policy access_control_overview access_control_managing_roles access_control_permissions diff --git a/operational_guides/access_control_password_policy.rst b/operational_guides/access_control_password_policy.rst deleted file mode 100644 index 6f678dc10..000000000 --- a/operational_guides/access_control_password_policy.rst +++ /dev/null @@ -1,73 +0,0 @@ -.. _access_control_password_policy: - -************** -Password Security Compliance (New!) -************** - -.. |icon-new_gray_2022.1.1| image:: /_static/images/new_gray_2022.1.1.png - :align: middle - :width: 110 - -As part of our compliance with GDPR standards SQream relies on a strong password policy when accessing the CLI or Studio. - -The following requirements apply when creating a password: - -* At least eight characters long. - - :: - -* At least one numeric character. - - :: - -* Should not include a username. - - :: - -* Must include at least one special character, such as **?**, **!**, **$**, etc. - - :: - -* Mandatory upper and lowercase letters. - -The following is the syntax for creating a password: - -.. code-block:: console - - CREATE ROLE ; - GRANT LOGIN ; - GRANT PASSWORD <'password'> to ; - -The following is an example of creating a password: - -.. code-block:: console - - CREATE ROLE user_a ; - GRANT LOGIN to user_a ; - GRANT PASSWORD 'BBAu47?fqPL' to user_a ; - -Creating a password that does not comply with the above requirements generates the following error message: - -.. code-block:: console - - The password you attempt to create does not comply with SQream security requirements. Please follow the requirements below: - - * At least 8 characters long. - - * Must include both upper and lower case letters. - - * Must include at least one numeric character. - - * Must not include your username. - - * Must include at least one “special” character (?, !, $, etc.). - -.. note:: When a new user is created in Studio, a message is displayed to help you determine what the constraints are. - -Unsuccessfully attempting to log in three times displays the following message: - -.. code-block:: console - - The user is locked. please contact your system administrator to reset the password and regain access functionality. - -For more information, see :ref:`login_max_retries`. \ No newline at end of file diff --git a/releases/2022.1.1.rst b/releases/2022.1.1.rst deleted file mode 100644 index c830b15b6..000000000 --- a/releases/2022.1.1.rst +++ /dev/null @@ -1,113 +0,0 @@ -.. _2022.1.1: - -************************** -Release Notes 2022.1.1 -************************** -The 2022.1.1 release notes were released on 7/19/2022 and describe the following: - -.. contents:: - :local: - :depth: 1 - -Version Content ----------- -The 2022.1.1 Release Notes describes the following: - -* Enhanced security features. - -New Features ----------- -The 2022.1.1 Release Notes include the following new features: - -.. contents:: - :local: - :depth: 1 - -Password Security Compliance -************ -In compliance with GDPR standards, SQream now requires a strong password policy when accessing the CLI or Studio. - -For more information, see `Access Control Password Policy `_. - -Known Issues ---------- -The following table lists the known issues for Version 2022.1.1: - -+-------------+------------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+=============+================================================================================================+ -| SQ-6419 | An internal compiler error occurred when casting Numeric literals in an aggregation function. | -+-------------+------------------------------------------------------------------------------------------------+ - -Resolved Issues ---------- -The following table lists the issues that were resolved in Version 2022.1.1: - -+-------------+----------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+=============+========================================================================================+ -| SQ-10873 | Inserting 100K bytes into a text column resulted in an unclear error message. | -+-------------+----------------------------------------------------------------------------------------+ -| SQ-10892 | An unclear message was displayed when users ran ``UPDATE`` on foreign tables. | -+-------------+----------------------------------------------------------------------------------------+ - -Operations and Configuration Changes --------- -The ``login_max_retries`` configuration flag is required for adjusting the permitted log-in attempts. - -For more information, see `Adjusting the Permitted Log-In Attempts `_. - -Naming Changes -------- -No relevant naming changes were made. - -Deprecated Features -------- -No features were deprecated for Version 2022.1.1. - -End of Support -------- -The End of Support section is not relevant to Version 2022.1.1. - -Upgrading to v2022.1.1 -------- -1. Generate a back-up of the metadata by running the following command: - - .. code-block:: console - - $ select backup_metadata('out_path'); - - .. tip:: SQream recommends storing the generated back-up locally in case needed. - - SQream runs the Garbage Collector and creates a clean backup tarball package. - -2. Shut down all SQream services. - - :: - -3. Extract the recently created back-up file. - - :: - -4. Replace your current metadata with the metadata you stored in the back-up file. - - :: - -5. Navigate to the new SQream package bin folder. - - :: - -6. Run the following command: - - .. code-block:: console - - $ ./upgrade_storage - - .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version `_ procedure. - -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2022.1.1 \ No newline at end of file diff --git a/releases/2022.1_index.rst b/releases/2022.1_index.rst index 284dc299f..3d1517371 100644 --- a/releases/2022.1_index.rst +++ b/releases/2022.1_index.rst @@ -1,55 +1,137 @@ -.. _2022.1_index: +.. _2022.1: ************************** Release Notes 2022.1 ************************** -The 2022.1 Release Notes describe the following releases: +The 2022.1 release notes were released on 7/19/2022 and describe the following: -.. toctree:: - :maxdepth: 1 - :glob: +.. contents:: + :local: + :depth: 1 + +Version Content +---------- +The 2022.1 Release Notes describes the following: - 2022.1.1 - 2022.1 +* Enhanced security features. +* New data manipulation command. +* Additional data ingestion format. -You can also use the following tables for a summary of the new features in Version 2022.1 according to month: +New Features +---------- +The 2022.1 Release Notes include the following new features: .. contents:: :local: :depth: 1 + +Data Encryption +************ +SQream now supports data encryption mechanisms in accordance with **General Data Protection Regulation (GDPR)** standards. + +Using the data encryption feature may lead to a maximum of a 10% increase in performance degradation. + +For more information, see `Data Encryption `_. + +Update Feature +************ +SQream now supports the DML **Update** feature, which is used for modifying the value of certain columns in existing rows. + +For more information, see `UPDATE `_. + +Avro Ingestion +************ +SQream now supports ingesting data from Avro files. + +For more information, see `Inserting Data from Avro `_. + +Known Issues +--------- +The following table lists the known issues for Version 2022.1: + ++-------------+-------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++=============+===========================================================================================+ +| SQ-7732 | Reading numeric columns from an external Parquet file generated an error. | ++-------------+-------------------------------------------------------------------------------------------+ +| SQ-9889 | Running a query including Thai characters generated an internal runtime error. | ++-------------+-------------------------------------------------------------------------------------------+ +| SQ-10071 | Error on existing subqueries with TEXT and VARCHAR equality condition | ++-------------+-------------------------------------------------------------------------------------------+ +| SQ-10191 | The ``ALTER DEFAULT SCHEMA`` command was not functioning correctly. | ++-------------+-------------------------------------------------------------------------------------------+ +| SQ-10629 | Inserting data into a table significantly slowed down running queries. | ++-------------+-------------------------------------------------------------------------------------------+ +| SQ-10659 | Using a comment generated a compile error. | ++-------------+-------------------------------------------------------------------------------------------+ + +Resolved Issues +--------- +The following table lists the issues that were resolved in Version 2022.1: + ++-------------+-------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++=============+===========================================================================================+ +| SQ-10111 | Reading numeric columns from an external Parquet file generated an error. | ++-------------+-------------------------------------------------------------------------------------------+ + +Operations and Configuration Changes +-------- +No relevant operations and configuration changes were made. + +Naming Changes +------- +No relevant naming changes were made. -August 2022 -================== -The following enhancements were introduced in :ref:`August 2022 (2022.1.1) <2022.1.1>`: +Deprecated Features +------- +In SQream version 2022.1 the ``VARCHAR`` data type has been deprecated and replaced with ``TEXT``. SQream will maintain ``VARCHAR`` in all previous versions until completing the migration to ``TEXT``, at which point it will be deprecated in all earlier versions. SQream also provides an automated and secure tool to facilitate and simplify migration from ``VARCHAR`` to ``TEXT``. -.. list-table:: - :widths: 24 25 60 - :header-rows: 1 +If you are using an earlier version of SQream, see the `Using Legacy String Literals `_ configuration flag. + +End of Support +------- +The End of Support section is not relevant to Version 2022.1. + +Upgrading to v2022.1 +------- +1. Generate a back-up of the metadata by running the following command: + + .. code-block:: console + + $ select backup_metadata('out_path'); + + .. tip:: SQream recommends storing the generated back-up locally in case needed. - * - Topic - - Feature - - Description - * - **Operational Guides** - - :ref:`Password Security Compliance` - - Integrated password security compliance measures when logging in to the CLI or Studio. - -July 2022 -================== -The following enhancements were introduced in :ref:`July 2022 (2022.1) <2022.1>`: - -.. list-table:: - :widths: 20 20 60 - :header-rows: 1 + SQream runs the Garbage Collector and creates a clean backup tarball package. - * - Topic - - Feature - - Description - * - **Data Ingestion** - - `Inserting data from Avro `_ - - SQream now supports ingesting data from Avro files. - * - **Feature Guides** - - `Data encryption `_ - - SQream has integrated data encryption mechanisms in accordance with General Data Protection Regulation (GDPR) standards. - * - **Reference Guides** - - `UPDATE `_ - - The DML ``UPDATE`` statement has been introduced to support modifying the value of certain columns in existing rows. \ No newline at end of file +2. Shut down all SQream services. + + :: + +3. Extract the recently created back-up file. + + :: + +4. Replace your current metadata with the metadata you stored in the back-up file. + + :: + +5. Navigate to the new SQream package bin folder. + + :: + +6. Run the following command: + + .. code-block:: console + + $ ./upgrade_storage + + .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version `_ procedure. + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2022.1 \ No newline at end of file From b833913c876a86b849819bebe068ea0b4e79a7a4 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Tue, 9 Aug 2022 18:06:04 +0300 Subject: [PATCH 214/882] Removed login_max_retries Will restore when new release date is announced. --- configuration_guides/admin_worker_flags.rst | 3 +-- configuration_guides/login_max_retries.rst | 16 ---------------- releases/2021.2.1.24.rst | 4 ---- 3 files changed, 1 insertion(+), 22 deletions(-) delete mode 100644 configuration_guides/login_max_retries.rst diff --git a/configuration_guides/admin_worker_flags.rst b/configuration_guides/admin_worker_flags.rst index edbc71465..b41a6a5cd 100644 --- a/configuration_guides/admin_worker_flags.rst +++ b/configuration_guides/admin_worker_flags.rst @@ -16,5 +16,4 @@ The **Worker Administration Flags** page describes **Worker** modification type * `Setting Port Used for Metadata Server Connection `_ * `Assigning Local Network IP `_ * `Enabling the Query Healer `_ -* `Configuring the Query Healer `_ -* `Adjusting the Permitted Log-In Attempts `_ |icon-new_gray_2022.1.1| \ No newline at end of file +* `Configuring the Query Healer `_ \ No newline at end of file diff --git a/configuration_guides/login_max_retries.rst b/configuration_guides/login_max_retries.rst deleted file mode 100644 index 6938d990b..000000000 --- a/configuration_guides/login_max_retries.rst +++ /dev/null @@ -1,16 +0,0 @@ -.. _login_max_retries: - -************************* -Adjusting Permitted Log-in Attempts -************************* - -.. |icon-new_2022.1.1| image:: /_static/images/new_2022.1.1.png - :align: middle - :width: 110 - -The ``loginMaxRetries`` flag sets the permitted log-in attempts. - -The following describes the ``loginMaxRetries`` flag: - -* **Data type** - size_t -* **Default value** - ``5`` \ No newline at end of file diff --git a/releases/2021.2.1.24.rst b/releases/2021.2.1.24.rst index aa60c701c..a89244934 100644 --- a/releases/2021.2.1.24.rst +++ b/releases/2021.2.1.24.rst @@ -67,10 +67,6 @@ The following configuration flags were added: * :ref:`healer_max_inactivity_hours` - :: - - * :ref:`login_max_retries` - Naming Changes ------- No relevant naming changes were made. From 220d97f436c797b23357d02da477336e0753a83a Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Wed, 10 Aug 2022 11:26:32 +0300 Subject: [PATCH 215/882] Started creating 2022.1.2 --- conf.py | 2 +- configuration_guides/admin_worker_flags.rst | 13 +- configuration_guides/login_max_retries.rst | 11 ++ operational_guides/access_control.rst | 1 + .../access_control_password_policy.rst | 42 ++++++ releases/2022.1.1.rst | 113 +++++++++++++++ releases/2022.1.2.rst | 129 ++++++++++++++++++ releases/2022.1_index.rst | 129 +----------------- 8 files changed, 309 insertions(+), 131 deletions(-) create mode 100644 configuration_guides/login_max_retries.rst create mode 100644 operational_guides/access_control_password_policy.rst create mode 100644 releases/2022.1.1.rst create mode 100644 releases/2022.1.2.rst diff --git a/conf.py b/conf.py index f8ee2ea90..4151da1c4 100644 --- a/conf.py +++ b/conf.py @@ -26,7 +26,7 @@ # The full version, including alpha/beta/rc tags -release = '2022.1.1' +release = '2022.1.2' diff --git a/configuration_guides/admin_worker_flags.rst b/configuration_guides/admin_worker_flags.rst index b41a6a5cd..130131b57 100644 --- a/configuration_guides/admin_worker_flags.rst +++ b/configuration_guides/admin_worker_flags.rst @@ -11,9 +11,10 @@ Worker Administration Flags The **Worker Administration Flags** page describes **Worker** modification type flags, which can be modified by administrators on a session and cluster basis using the ``ALTER SYSTEM SET`` command: -* `Setting Total Device Memory Usage in SQream Instance `_ -* `Enabling Manually Setting Reported IP `_ -* `Setting Port Used for Metadata Server Connection `_ -* `Assigning Local Network IP `_ -* `Enabling the Query Healer `_ -* `Configuring the Query Healer `_ \ No newline at end of file +* `Setting Total Device Memory Usage in SQream Instance `_ +* `Enabling Manually Setting Reported IP `_ +* `Setting Port Used for Metadata Server Connection `_ +* `Assigning Local Network IP `_ +* `Enabling the Query Healer `_ +* `Configuring the Query Healer `_ +* `Adjusting Permitted Log-in Attempts `_ \ No newline at end of file diff --git a/configuration_guides/login_max_retries.rst b/configuration_guides/login_max_retries.rst new file mode 100644 index 000000000..bf3ae6d40 --- /dev/null +++ b/configuration_guides/login_max_retries.rst @@ -0,0 +1,11 @@ +.. _login_max_retries: + +************************* +Adjusting Permitted Log-in Attempts +************************* +The ``loginMaxRetries`` flag sets the permitted log-in attempts. + +The following describes the ``loginMaxRetries`` flag: + +* **Data type** - size_t +* **Default value** - ``5`` \ No newline at end of file diff --git a/operational_guides/access_control.rst b/operational_guides/access_control.rst index 88a14d71b..8aba611eb 100644 --- a/operational_guides/access_control.rst +++ b/operational_guides/access_control.rst @@ -8,6 +8,7 @@ Access Control :maxdepth: 1 :titlesonly: + access_control_password_policy access_control_overview access_control_managing_roles access_control_permissions diff --git a/operational_guides/access_control_password_policy.rst b/operational_guides/access_control_password_policy.rst new file mode 100644 index 000000000..10a4f697f --- /dev/null +++ b/operational_guides/access_control_password_policy.rst @@ -0,0 +1,42 @@ +.. _access_control_password_policy: + +************** +Password Policy +************** +As part of our compliance with GDPR standards SQream relies on a strong password policy when accessing the CLI or Studio, with the following requirements: + +* At least eight characters long. + + :: + +* Mandatory upper and lowercase letters. + + :: + +* At least one numeric character. + + :: + +* May not include a username. + + :: + +* Must include at least one special character, such as **?**, **!**, **$**, etc. + +You can create a password through the Studio graphic interface or through the CLI, as in the following example command: + +.. code-block:: console + + CREATE ROLE user_a ; + GRANT LOGIN to user_a ; + GRANT PASSWORD 'BBAu47?fqPL' to user_a ; + +Creating a password that does not comply with the above requirements generates an error message with a request to modify it. + +Unsuccessfully attempting to log in three times displays the following message: + +.. code-block:: console + + The user is locked. please contact your system administrator to reset the password and regain access functionality. + +For more information, see :ref:`login_max_retries`. diff --git a/releases/2022.1.1.rst b/releases/2022.1.1.rst new file mode 100644 index 000000000..faec3add2 --- /dev/null +++ b/releases/2022.1.1.rst @@ -0,0 +1,113 @@ +.. _2022.1.1: + +************************** +Release Notes 2022.1.1 +************************** +The 2022.1.1 release notes were released on 7/19/2022 and describe the following: + +.. contents:: + :local: + :depth: 1 + +Version Content +---------- +The 2022.1.1 Release Notes describes the following: + +* Enhanced security features. + +New Features +---------- +The 2022.1.1 Release Notes include the following new features: + +.. contents:: + :local: + :depth: 1 + +Password Security Compliance +************ +In compliance with GDPR standards, SQream now requires a strong password policy when accessing the CLI or Studio. + +For more information, see :ref:`access_control_password_policy`. + +Known Issues +--------- +The following table lists the known issues for Version 2022.1.1: + ++-------------+------------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++=============+================================================================================================+ +| SQ-6419 | An internal compiler error occurred when casting Numeric literals in an aggregation function. | ++-------------+------------------------------------------------------------------------------------------------+ + +Resolved Issues +--------- +The following table lists the issues that were resolved in Version 2022.1.1: + ++-------------+----------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++=============+========================================================================================+ +| SQ-10873 | Inserting 100K bytes into a text column resulted in an unclear error message. | ++-------------+----------------------------------------------------------------------------------------+ +| SQ-10892 | An unclear message was displayed when users ran ``UPDATE`` on foreign tables. | ++-------------+----------------------------------------------------------------------------------------+ + +Operations and Configuration Changes +-------- +The ``login_max_retries`` configuration flag is required for adjusting the permitted log-in attempts. + +For more information, see `Adjusting the Permitted Log-In Attempts `_. + +Naming Changes +------- +No relevant naming changes were made. + +Deprecated Features +------- +No features were deprecated for Version 2022.1.1. + +End of Support +------- +The End of Support section is not relevant to Version 2022.1.1. + +Upgrading to v2022.1.1 +------- +1. Generate a back-up of the metadata by running the following command: + + .. code-block:: console + + $ select backup_metadata('out_path'); + + .. tip:: SQream recommends storing the generated back-up locally in case needed. + + SQream runs the Garbage Collector and creates a clean backup tarball package. + +2. Shut down all SQream services. + + :: + +3. Extract the recently created back-up file. + + :: + +4. Replace your current metadata with the metadata you stored in the back-up file. + + :: + +5. Navigate to the new SQream package bin folder. + + :: + +6. Run the following command: + + .. code-block:: console + + $ ./upgrade_storage + + .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version `_ procedure. + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2022.1.1 \ No newline at end of file diff --git a/releases/2022.1.2.rst b/releases/2022.1.2.rst new file mode 100644 index 000000000..d94916d02 --- /dev/null +++ b/releases/2022.1.2.rst @@ -0,0 +1,129 @@ +.. _2022.1.2: + +************************** +Release Notes 2022.1.2 +************************** +The 2022.1.2 release notes were released on x/xx/2022 and describe the following: + +.. contents:: + :local: + :depth: 1 + +Version Content +---------- +The 2022.1.2 Release Notes describes the following: + +* Enhanced security features. + +New Features +---------- +The 2022.1.2 Release Notes include the following new features: + +.. contents:: + :local: + :depth: 1 + +Feature 1 +************ + + +For more information, see + +Feature 2 +************ + + +For more information, see + +Known Issues +--------- +The following table lists the known issues for Version 2022.1.2: + ++-------------+------------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++=============+================================================================================================+ +| SQ-xxxx | Description | ++-------------+------------------------------------------------------------------------------------------------+ +| SQ-xxxx | Description | ++-------------+------------------------------------------------------------------------------------------------+ +| SQ-xxxx | Description | ++-------------+------------------------------------------------------------------------------------------------+ +| SQ-xxxx | Description | ++-------------+------------------------------------------------------------------------------------------------+ + +Resolved Issues +--------- +The following table lists the issues that were resolved in Version 2022.1.2: + ++-------------+------------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++=============+================================================================================================+ +| SQ-xxxx | Description | ++-------------+------------------------------------------------------------------------------------------------+ +| SQ-xxxx | Description | ++-------------+------------------------------------------------------------------------------------------------+ +| SQ-xxxx | Description | ++-------------+------------------------------------------------------------------------------------------------+ +| SQ-xxxx | Description | ++-------------+------------------------------------------------------------------------------------------------+ + +Operations and Configuration Changes +-------- +The ``xxxx`` configuration flag is required for adjusting the permitted log-in attempts. + +For more information, see + +Naming Changes +------- +No relevant naming changes were made. + +Deprecated Features +------- +No features were deprecated for Version 2022.1.2. + +End of Support +------- +The End of Support section is not relevant to Version 2022.1.2. + +Upgrading to v2022.1.2 +------- +1. Generate a back-up of the metadata by running the following command: + + .. code-block:: console + + $ select backup_metadata('out_path'); + + .. tip:: SQream recommends storing the generated back-up locally in case needed. + + SQream runs the Garbage Collector and creates a clean backup tarball package. + +2. Shut down all SQream services. + + :: + +3. Extract the recently created back-up file. + + :: + +4. Replace your current metadata with the metadata you stored in the back-up file. + + :: + +5. Navigate to the new SQream package bin folder. + + :: + +6. Run the following command: + + .. code-block:: console + + $ ./upgrade_storage + + .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version `_ procedure. + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2022.1.2 \ No newline at end of file diff --git a/releases/2022.1_index.rst b/releases/2022.1_index.rst index 3d1517371..5f53bcb38 100644 --- a/releases/2022.1_index.rst +++ b/releases/2022.1_index.rst @@ -1,137 +1,18 @@ -.. _2022.1: +.. _2022.1_index: ************************** Release Notes 2022.1 ************************** -The 2022.1 release notes were released on 7/19/2022 and describe the following: - -.. contents:: - :local: - :depth: 1 - -Version Content ----------- -The 2022.1 Release Notes describes the following: - -* Enhanced security features. -* New data manipulation command. -* Additional data ingestion format. - -New Features ----------- -The 2022.1 Release Notes include the following new features: +The 2022.1 Release Notes describe the following releases: .. contents:: :local: :depth: 1 - -Data Encryption -************ -SQream now supports data encryption mechanisms in accordance with **General Data Protection Regulation (GDPR)** standards. - -Using the data encryption feature may lead to a maximum of a 10% increase in performance degradation. - -For more information, see `Data Encryption `_. - -Update Feature -************ -SQream now supports the DML **Update** feature, which is used for modifying the value of certain columns in existing rows. - -For more information, see `UPDATE `_. - -Avro Ingestion -************ -SQream now supports ingesting data from Avro files. - -For more information, see `Inserting Data from Avro `_. - -Known Issues ---------- -The following table lists the known issues for Version 2022.1: - -+-------------+-------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+=============+===========================================================================================+ -| SQ-7732 | Reading numeric columns from an external Parquet file generated an error. | -+-------------+-------------------------------------------------------------------------------------------+ -| SQ-9889 | Running a query including Thai characters generated an internal runtime error. | -+-------------+-------------------------------------------------------------------------------------------+ -| SQ-10071 | Error on existing subqueries with TEXT and VARCHAR equality condition | -+-------------+-------------------------------------------------------------------------------------------+ -| SQ-10191 | The ``ALTER DEFAULT SCHEMA`` command was not functioning correctly. | -+-------------+-------------------------------------------------------------------------------------------+ -| SQ-10629 | Inserting data into a table significantly slowed down running queries. | -+-------------+-------------------------------------------------------------------------------------------+ -| SQ-10659 | Using a comment generated a compile error. | -+-------------+-------------------------------------------------------------------------------------------+ - -Resolved Issues ---------- -The following table lists the issues that were resolved in Version 2022.1: - -+-------------+-------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+=============+===========================================================================================+ -| SQ-10111 | Reading numeric columns from an external Parquet file generated an error. | -+-------------+-------------------------------------------------------------------------------------------+ - -Operations and Configuration Changes --------- -No relevant operations and configuration changes were made. - -Naming Changes -------- -No relevant naming changes were made. - -Deprecated Features -------- -In SQream version 2022.1 the ``VARCHAR`` data type has been deprecated and replaced with ``TEXT``. SQream will maintain ``VARCHAR`` in all previous versions until completing the migration to ``TEXT``, at which point it will be deprecated in all earlier versions. SQream also provides an automated and secure tool to facilitate and simplify migration from ``VARCHAR`` to ``TEXT``. - -If you are using an earlier version of SQream, see the `Using Legacy String Literals `_ configuration flag. - -End of Support -------- -The End of Support section is not relevant to Version 2022.1. - -Upgrading to v2022.1 -------- -1. Generate a back-up of the metadata by running the following command: - - .. code-block:: console - - $ select backup_metadata('out_path'); - - .. tip:: SQream recommends storing the generated back-up locally in case needed. - - SQream runs the Garbage Collector and creates a clean backup tarball package. - -2. Shut down all SQream services. - - :: - -3. Extract the recently created back-up file. - - :: - -4. Replace your current metadata with the metadata you stored in the back-up file. - - :: - -5. Navigate to the new SQream package bin folder. - - :: - -6. Run the following command: - - .. code-block:: console - - $ ./upgrade_storage - .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version `_ procedure. - .. toctree:: - :maxdepth: 2 + :maxdepth: 1 :glob: - :hidden: + 2022.1.2 + 2022.1.1 2022.1 \ No newline at end of file From 3b287ce61c88ec64386fcfd3d8a6c17a03fe2e6f Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 14 Aug 2022 19:05:17 +0300 Subject: [PATCH 216/882] Updated --- feature_guides/query_healer.rst | 26 +++- login_5.3.1.png | Bin 88126 -> 0 bytes .../access_control_password_policy.rst | 40 ++++++- reference/sql/sql_statements/index.rst | 4 +- .../utility_commands/shutdown_server.rst | 95 --------------- .../shutdown_server_command.rst | 113 ++++++++++++++++++ sqream_studio_5.4.6/index.rst | 18 --- .../configuring_your_instance_of_sqream.rst | 23 ++++ ...ing_and_managing_roles_and_permissions.rst | 12 +- ...ts_and_running_queries_from_the_editor.rst | 93 +++++++------- .../getting_started.rst | 14 +-- sqream_studio_5.4.7/index.rst | 19 +++ ...orkers_and_services_from_the_dashboard.rst | 77 ++++++------ .../viewing_logs.rst | 50 +++++--- studio_login_5.3.2.png | Bin 82674 -> 0 bytes 15 files changed, 353 insertions(+), 231 deletions(-) delete mode 100644 login_5.3.1.png delete mode 100644 reference/sql/sql_statements/utility_commands/shutdown_server.rst create mode 100644 reference/sql/sql_statements/utility_commands/shutdown_server_command.rst delete mode 100644 sqream_studio_5.4.6/index.rst create mode 100644 sqream_studio_5.4.7/configuring_your_instance_of_sqream.rst rename {sqream_studio_5.4.6 => sqream_studio_5.4.7}/creating_assigning_and_managing_roles_and_permissions.rst (97%) rename {sqream_studio_5.4.6 => sqream_studio_5.4.7}/executing_statements_and_running_queries_from_the_editor.rst (86%) rename sqream_studio_5.4.6/getting_started_sqream.rst => sqream_studio_5.4.7/getting_started.rst (78%) create mode 100644 sqream_studio_5.4.7/index.rst rename {sqream_studio_5.4.6 => sqream_studio_5.4.7}/monitoring_workers_and_services_from_the_dashboard.rst (84%) rename {sqream_studio_5.4.6 => sqream_studio_5.4.7}/viewing_logs.rst (73%) delete mode 100644 studio_login_5.3.2.png diff --git a/feature_guides/query_healer.rst b/feature_guides/query_healer.rst index 7068abc2d..0180150ea 100644 --- a/feature_guides/query_healer.rst +++ b/feature_guides/query_healer.rst @@ -17,11 +17,9 @@ The following is an example of a log record for a query stuck in the query detec .. code-block:: console - #SQ#|1659621825880088264|2022-05-19 20:01:25.880|INFO|0x00007f9a497fe700:Healer|192.168.4.65|5001|-1|master|sqream|-1|sqream|0|"[ERROR]|cpp/SqrmRT/healer.cpp:140 |"Stuck query found. Statement ID: 72, Last chunk producer updated: 1 WriteTable, Started on: Thu May 19 14:01:25 2022, Last updated: Thu May 19 15:01:25 2022, Stuck time: 5 hours, Max allowed stuck query time: 5 hours"|#EOM# + 2022/05/19::20:01:25|ERROR|Healer|(0x7f07147fc700)|Stuck query found. Statement ID: 72, Last chunk producer updated: 1 WriteTable, Started on: Thu May 19 14:01:25 2022, Last updated: Thu May 19 15:01:25 2022, Stuck time: 5 hours, Max allowed stuck query time: 5 hours -The ``healerMaxInactivityHours`` log frequency is calculated as 5% of the flag setting. When set to to five hours (the default setting), the Query Healer triggers an examination every 15 minutes. - -.. note:: The logs are located in your cluster. +The ``healerMaxInactivityHours`` log frequency is calculated as 5% of the flag setting. When set to to five hours (the default setting), the Query Healer triggers an examination every 15 minutes. Configuring the Healer ------------------ @@ -33,4 +31,22 @@ The following **Administration Worker** flags are required to configure the Quer * :ref:`healer_max_inactivity_hours` - Defines the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU. -The ``healerMaxInactivityHours`` log frequency is calculated as 5% of the flag setting. For example, setting ``healerMaxInactivityHours`` to five hours (the default setting) triggers an examination every 15 minutes. \ No newline at end of file +The ``healerMaxInactivityHours`` log frequency is calculated as 5% of the flag setting. For example, setting ``healerMaxInactivityHours`` to five hours (the default setting) triggers an examination every 15 minutes. + +Activating a Graceful Shutdown +------------------ +If your log entry says ``Stuck query found``, you must set the **shutdown_server** utility function to ``select shutdown_server(true);``, as in the following example: + +.. code-block:: console + + |INFO|0x00007f9a497fe700:Healer|192.168.4.65|5001|-1|master|sqream|-1|sqream|0|"[ERROR]|cpp/SqrmRT/healer.cpp:140 |"Stuck query found. Statement ID: 72, Last chunk producer updated: 1. + +Note that the log above identifies the IP (192.168.4.65) and port (5001) referring to the stuck query. + +For more information, see the following: + +* Activating the :ref:`shutdown_server_command` utility function. + + :: + +* Configuring the :ref:`shutdown_server` flag. \ No newline at end of file diff --git a/login_5.3.1.png b/login_5.3.1.png deleted file mode 100644 index 48c725a4c141b6a2bb04718c683646300bda009c..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 88126 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
2k12sUQOc} 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 diff --git a/operational_guides/access_control_password_policy.rst b/operational_guides/access_control_password_policy.rst index 10a4f697f..055d674bb 100644 --- a/operational_guides/access_control_password_policy.rst +++ b/operational_guides/access_control_password_policy.rst @@ -3,6 +3,14 @@ ************** Password Policy ************** +The **Password Policy** describes the following: + +.. contents:: + :local: + :depth: 1 + +Password Strength Requirements +============================== As part of our compliance with GDPR standards SQream relies on a strong password policy when accessing the CLI or Studio, with the following requirements: * At least eight characters long. @@ -23,7 +31,7 @@ As part of our compliance with GDPR standards SQream relies on a strong password * Must include at least one special character, such as **?**, **!**, **$**, etc. -You can create a password through the Studio graphic interface or through the CLI, as in the following example command: +You can grant a password through the Studio graphic interface or through the CLI, as in the following example command: .. code-block:: console @@ -31,12 +39,38 @@ You can create a password through the Studio graphic interface or through the CL GRANT LOGIN to user_a ; GRANT PASSWORD 'BBAu47?fqPL' to user_a ; -Creating a password that does not comply with the above requirements generates an error message with a request to modify it. +Granting a password that does not comply with the above requirements generates an error message with a request to modify it; + +.. code-block:: console + + The password you attempted to create does not comply with SQream's security requirements. + + Your password must: + + * Be at least eight characters long. + + * Contain upper and lowercase letters. + * Contain at least one numeric character. + + * Not include a username. + + * Include at least one special character, such as **?**, **!**, **$**, etc. + +Brute Force Prevention +============================== Unsuccessfully attempting to log in three times displays the following message: .. code-block:: console - The user is locked. please contact your system administrator to reset the password and regain access functionality. + The user is locked. Please contact your system administrator to reset the password and regain access functionality. + +You must have superuser permissions to release a locked user to grant a new password: + +.. code-block:: console + + GRANT PASSWORD '' to ; For more information, see :ref:`login_max_retries`. + +.. warning:: Because superusers can also be blocked, **you must have** at least two superusers per cluster. \ No newline at end of file diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index 5cac43122..960200937 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -130,8 +130,8 @@ The following table shows the Utility commands: - Returns a list of active sessions across the cluster * - :ref:`SHOW VERSION` - Returns the system version for SQream DB - * - :ref:`SHUTDOWN SERVER` - - Performs a graceful server shutdown + * - :ref:`SHUTDOWN_SERVER` + - Sets your server to finish compiling all active queries before shutting down according to a user-defined time value * - :ref:`STOP STATEMENT` - Stops or aborts an active statement diff --git a/reference/sql/sql_statements/utility_commands/shutdown_server.rst b/reference/sql/sql_statements/utility_commands/shutdown_server.rst deleted file mode 100644 index 7fa1571b5..000000000 --- a/reference/sql/sql_statements/utility_commands/shutdown_server.rst +++ /dev/null @@ -1,95 +0,0 @@ -.. _shutdown_server: - -******************** -SHUTDOWN SERVER -******************** -The **SHUTDOWN_SERVER** guide describes the following: - -.. contents:: - :local: - :depth: 1 - -Overview -=============== -SQream's current method for stopping the SQream server is running the ``shutdown_server()`` utility command. Because this command abruptly shuts down the server while executing operations, it has been modified to perform a graceful shutdown, giving you more control over the following: - -* Preventing new queries from connecting to the server. - - :: - -* The amount of time to wait before shutting down the server. - - :: - -* Configurations related to shutting down the server. - -How Does it Work? -======================== -Running the ``SHUTDOWN_SERVER`` command does the following: - -* Prevents new queries from entering the server by doing the following: - - * Disabling incoming queries. - - :: - - * Unsubscribing the server from its service. - -* Preventing new connections from being made to the server - attempting to establish a connection with the server after initiating a graceful shutdown displays the "Server is shutting down, no new connections are possible at the moment" messsge. - - :: - -* Waits for any queries that depend on server being shut down to leave the statement queue. - -Syntax -========== -The following is the syntax for using the ``SHUTDOWN_SERVER`` command: - -.. code-block:: postgres - - select shutdown_server([is_graceful, [timeout]]); - -The following is example of the ``SHUTDOWN_SERVER`` command: - -.. code-block:: postgres - - select shutdown_server([true/false, [timeout]]); - -Returns -========== -Running the ``shutdown_server`` command returns no output. - -Parameters -============ -The following table shows the ``shutdown_server`` parameters: - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - - Example - - Default - * - ``is_graceful`` - - Determines the method used to shut down the server. - - Selecting ``false`` shuts down the server while queries are running. Selecting ``true`` uses the graceful shutdown method. - - ``false`` - * - ``timeout`` - - Sets the maximum amount of minutes for the graceful shutdown method to run before the server is shut down using the standard method. - - ``30`` - - Five minutes. - -.. note:: Setting ``is_graceful`` to ``false`` and defining the ``timeout`` value shuts the server down mid-query after the defined time. - -It is possible to pass as the second argument the timeout in minutes after which a forceful shutdown will run after defining the graceful shutdown value, regardless of the progression of the graceful shutdown. - -Note that you set the timeout value using the ``defaultGracefulShutdownTimeoutMinutes`` flag in Studio. - -For more information, see :ref:`graceful_shutdown`. - -As with the ``shutdown_server`` command, the **graceful server shutdown** stops all queries currently running on your server. - -Permissions -============= -Using the ``shutdown_server`` command requires no special permissions. \ No newline at end of file diff --git a/reference/sql/sql_statements/utility_commands/shutdown_server_command.rst b/reference/sql/sql_statements/utility_commands/shutdown_server_command.rst new file mode 100644 index 000000000..ebc3d9184 --- /dev/null +++ b/reference/sql/sql_statements/utility_commands/shutdown_server_command.rst @@ -0,0 +1,113 @@ +.. _shutdown_server_command: + +******************** +SHUTDOWN SERVER +******************** +The **SHUTDOWN_SERVER** guide describes the following: + +.. contents:: + :local: + :depth: 1 + +Overview +=============== +SQream's current method for stopping the SQream server is running the ``shutdown_server ()`` utility command. Because this command abruptly shuts down the server while executing operations, it has been modified to perform a graceful shutdown by setting it to ``select shutdown_server([is_graceful, [timeout]]);``. This causes the server to wait for any queued statements to complete before shutting down. + +How Does it Work? +======================== +Running the ``SHUTDOWN_SERVER`` command gives you more control over the following: + +* Preventing new queries from connecting to the server by: + + * Setting the server as unavailable in the metadata server. + + :: + + * Unsubscribing the server from its service. + +* Stopping users from making new connections to the server. Attempting to connect to the server after activating a graceful shutdown displays the following message: + + .. code-block:: postgres + + Server is shutting down, no new connections are possible at the moment. + +* The amount of time to wait before shutting down the server. + + :: + +* Configurations related to shutting down the server. + +Syntax +========== +The following is the syntax for using the ``SHUTDOWN_SERVER`` command: + +.. code-block:: postgres + + select shutdown_server([true/false, [timeout]]); + +Returns +========== +Running the ``shutdown_server`` command returns no output. + +Parameters +============ +The following table shows the ``shutdown_server`` parameters: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + - Example + - Default + * - ``is_graceful`` + - Determines the method used to shut down the server. + - Selecting ``false`` shuts down the server while queries are running. Selecting ``true`` uses the graceful shutdown method. + - NA + * - ``timeout`` + - Sets the maximum amount of minutes for the graceful shutdown method to run before the server is shut down using the standard method. + - ``([is_graceful, [30]]);`` + - Five minutes + +.. note:: Setting ``is_graceful`` to ``false`` and defining the ``timeout`` value shuts the server down mid-query after the defined time. + +You can define the ``timeout`` argument as the amount minutes after which a forceful shutdown will run, even if a graceful shutdown is in progress. + +Note that activating a forced shutdown with a timeout, such as ``select shutdown_server(false, 30)``, outputs the following error message: + +.. code-block:: postgres + + forced shutdown has no timeout timer + +.. note:: You can set the timeout value using the ``defaultGracefulShutdownTimeoutMinutes`` flag in the Acceleration Studio. + +For more information, see :ref:`shutdown_server`. + +Examples +=================== +This section shows the following examples: + +**Example 1 - Activating a Forceful Shutdown** + +.. code-block:: postgres + + shutdown_server () + +**Example 2 - Activating a Graceful Shutdown** + +.. code-block:: postgres + + shutdown_server (true) + +**Example 3 - Overriding the timeout Default with Another Value** + +.. code-block:: postgres + + shutdown_server (500) + +The ``timeout`` unit is minutes. + +Permissions +============= +Using the ``shutdown_server`` command requires no special permissions. \ No newline at end of file diff --git a/sqream_studio_5.4.6/index.rst b/sqream_studio_5.4.6/index.rst deleted file mode 100644 index c4981ce81..000000000 --- a/sqream_studio_5.4.6/index.rst +++ /dev/null @@ -1,18 +0,0 @@ -.. _sqream_studio_5.4.6: - -********************************** -SQream Acceleration Studio 5.4.6 -********************************** -The SQream Acceleration Studio is a web-based client for use with SQream. Studio provides users with all functionality available from the command line in an intuitive and easy-to-use format. This includes running statements, managing roles and permissions, and managing SQream clusters. - -This section describes how to use the SQream Accleration Studio version 5.4.6: - -.. toctree:: - :maxdepth: 1 - :glob: - - getting_started_sqream - executing_statements_and_running_queries_from_the_editor - monitoring_workers_and_services_from_the_dashboard - viewing_logs - creating_assigning_and_managing_roles_and_permissions \ No newline at end of file diff --git a/sqream_studio_5.4.7/configuring_your_instance_of_sqream.rst b/sqream_studio_5.4.7/configuring_your_instance_of_sqream.rst new file mode 100644 index 000000000..3fcac7861 --- /dev/null +++ b/sqream_studio_5.4.7/configuring_your_instance_of_sqream.rst @@ -0,0 +1,23 @@ +.. _configuring_your_instance_of_sqream: + +**************************** +Configuring Your Instance of SQreams +**************************** +The **Configuration** section lets you edit parameters from one centralized location. While you can edit these parameters from the **worker configuration file (config.json)** or from your CLI, you can also modify them in Studio in an easy-to-use format. + +Configuring your instance of SQream in Studio is session-based, which enables you to edit parameters per session on your own device. +Because session-based configurations are not persistent and are deleted when your session ends, you can edit your required parameters while avoiding conflicts between parameters edited on different devices at different points in time. + +Editing Your Parameters +------------------------------- +When configuring your instance of SQream in Studio you can edit parameters for the **Generic** and **Admin** parameters only. + +Studio includes two types of parameters: toggle switches, such as **flipJoinOrder**, and text fields, such as **logSysLevel**. After editing a parameter, you can reset each one to its previous value or to its default value individually, or revert all parameters to their default setting simultaneously. Note that you must click **Save** to save your configurations. + +You can hover over the **information** icon located on each parameter to read a short description of its behavior. + +Exporting and Importing Configuration Files +------------------------- +You can also export and import your configuration settings into a .json file. This allows you to easily edit your parameters and to share this file with other users if required. + +For more information about configuring your instance of SQream, see :ref:`Configuration`. \ No newline at end of file diff --git a/sqream_studio_5.4.6/creating_assigning_and_managing_roles_and_permissions.rst b/sqream_studio_5.4.7/creating_assigning_and_managing_roles_and_permissions.rst similarity index 97% rename from sqream_studio_5.4.6/creating_assigning_and_managing_roles_and_permissions.rst rename to sqream_studio_5.4.7/creating_assigning_and_managing_roles_and_permissions.rst index b87b6f2cf..9f0f7f39a 100644 --- a/sqream_studio_5.4.6/creating_assigning_and_managing_roles_and_permissions.rst +++ b/sqream_studio_5.4.7/creating_assigning_and_managing_roles_and_permissions.rst @@ -1,6 +1,6 @@ .. _creating_assigning_and_managing_roles_and_permissions: -.. _roles_5.4.6: +.. _roles_5.4.3: **************************** Creating, Assigning, and Managing Roles and Permissions @@ -32,7 +32,7 @@ The **Type** column displays one of the following assigned role types: .. note:: If you disable a password, when you enable it you have to create a new one. -:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` +:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` Viewing Information About a Role @@ -49,7 +49,7 @@ Clicking a role in the roles table displays the following information: * **Permissions** - displays the role's permissions. The arrow indicates the permissions that the role has inherited. Hovering over a permission displays the roles that the permission is inherited from. -:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` +:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` Creating a New Role @@ -73,7 +73,7 @@ From the New Role panel you view directly and indirectly (or inherited) granted When adding a new role, you must select the **Enable login for this role** and **Has password** check boxes. -:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` +:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` Editing a Role -------------------- @@ -89,10 +89,10 @@ Once you've created a role, clicking the **Edit Role** button lets you do the fo From the Edit Role panel you view directly and indirectly (or inherited) granted permissions. Disabled permissions have no connect permissions for the referenced database and are displayed in gray text. You can add or remove permissions from the **Add permissions** field. From the Edit Role panel you can also search and scroll through the permissions. In the **Search** field you can use the **and** operator to search for strings that fulfill multiple criteria. -:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` +:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` Deleting a Role ----------------- Clicking the **delete** icon displays a confirmation message with the amount of users and groups that will be impacted by deleting the role. -:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` \ No newline at end of file +:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` \ No newline at end of file diff --git a/sqream_studio_5.4.6/executing_statements_and_running_queries_from_the_editor.rst b/sqream_studio_5.4.7/executing_statements_and_running_queries_from_the_editor.rst similarity index 86% rename from sqream_studio_5.4.6/executing_statements_and_running_queries_from_the_editor.rst rename to sqream_studio_5.4.7/executing_statements_and_running_queries_from_the_editor.rst index 8015b7c4a..0a298fdbf 100644 --- a/sqream_studio_5.4.6/executing_statements_and_running_queries_from_the_editor.rst +++ b/sqream_studio_5.4.7/executing_statements_and_running_queries_from_the_editor.rst @@ -1,6 +1,6 @@ .. _executing_statements_and_running_queries_from_the_editor: -.. _editor_top_5.4.6: +.. _editor_top_5.4.3: **************************** Executing Statements and Running Queries from the Editor @@ -14,6 +14,7 @@ The **Editor** is used for the following: The following is a brief description of the Editor panels: + .. list-table:: :widths: 10 34 56 :header-rows: 1 @@ -22,21 +23,23 @@ The following is a brief description of the Editor panels: - Element - Description * - 1 - - :ref:`Toolbar` + - :ref:`Toolbar` - Used to select the active database you want to work on, limit the number of rows, save query, etc. * - 2 - - :ref:`Database Tree and System Queries panel` + - :ref:`Database Tree and System Queries panel` - Shows a hierarchy tree of databases, views, tables, and columns * - 3 - - :ref:`Statement panel` + - :ref:`Statement panel` - Used for writing queries and statements * - 4 - - :ref:`Results panel` + - :ref:`Results panel` - Shows query results and execution information. -.. _top_5.4.6: -.. _studio_5.4.6_editor_toolbar: + +.. _top_5.4.3: + +.. _studio_5.4.3_editor_toolbar: Executing Statements from the Toolbar ================ @@ -70,16 +73,22 @@ You can access the following from the Toolbar pane: * **Max Rows** - By default, the Editor fetches only the first 10,000 rows. You can modify this number by selecting an option from the **Max Rows** dropdown list. Note that setting a higher number may slow down your browser if the result is very large. This number is limited to 100,000 results. To see a higher number, you can save the results in a file or a table using the :ref:`create_table_as` command. -For more information on stopping active statements, see the :ref:`SHUTDOWN_SERVER` command. -:ref:`Back to Executing Statements and Running Queries from the Editor` +For more information on stopping active statements, see the :ref:`STOP_STATEMENT` command. -.. _studio_5.4.6_editor_db_tree: +:ref:`Back to Executing Statements and Running Queries from the Editor` + + +.. _studio_5.4.3_editor_db_tree: Performing Statement-Related Operations from the Database Tree ================ From the Database Tree you can perform statement-related operations and show metadata (such as a number indicating the amount of rows in the table). + + + + The database object functions are used to perform the following: * The **SELECT** statement - copies the selected table's **columns** into the Statement panel as ``SELECT`` parameters. @@ -170,8 +179,7 @@ The database object functions are used to perform the following: .. |keep-tabs| image:: /_static/images/studio_keep_tabs.png :align: middle - - :ref:`insert` + .. list-table:: :widths: 30 70 @@ -180,23 +188,23 @@ The database object functions are used to perform the following: * - Function - Description * - Insert statement - - Generates an :ref:`insert` statement for the selected table in the editing area. + - Generates an `INSERT `_ statement for the selected table in the editing area. * - Delete statement - - Generates a :ref:`delete` statement for the selected table in the editing area. + - Generates a `DELETE `_ statement for the selected table in the editing area. * - Create Table As statement - - Generates a `CREATE TABLE AS `_ statement for the selected table in the editing area. + - Generates a `CREATE TABLE AS `_ statement for the selected table in the editing area. * - Rename statement - - Generates an :ref:`rename_table` statement for renaming the selected table in the editing area. + - Generates an `RENAME TABLE AS `_ statement for renaming the selected table in the editing area. * - Adding column statement - - Generates an :ref:`add_column` statement for adding columns to the selected table in the editing area. + - Generates an `ADD COLUMN `_ statement for adding columns to the selected table in the editing area. * - Truncate table statement - - Generates a :ref:`truncate` statement for the selected table in the editing area. + - Generates a `TRUNCATE_IF_EXISTS `_ statement for the selected table in the editing area. * - Drop table statement - Generates a ``DROP`` statement for the selected object in the editing area. * - Table DDL - - Generates a DDL statement for the selected object in the editing area. To get the entire database DDL, click the |icon-ddl-edit| icon next to the database name in the tree root. See :ref:`seeing_system_objects_as_ddl`. + - Generates a DDL statement for the selected object in the editing area. To get the entire database DDL, click the |icon-ddl-edit| icon next to the database name in the tree root. See `Seeing System Objects as DDL `_. * - DDL Optimizer - - The `DDL Optimizer `_ lets you analyze database tables and recommends possible optimizations. + - The `DDL Optimizer `_ lets you analyze database tables and recommends possible optimizations. Optimizing Database Tables Using the DDL Optimizer ----------------------- @@ -221,7 +229,7 @@ The following table describes the DDL Optimizer screen: Clicking **Run Optimizer** adds a tab to the Statement panel showing the optimized results of the selected object. -For more information, see :ref:`sql_best_practices`. +For more information, see `Optimization and Best Practices `_. Executing Pre-Defined Queries from the System Queries Panel --------------- @@ -235,7 +243,7 @@ The **System Queries** panel lets you execute predefined queries and includes th Clicking an item pastes the query into the Statement pane, and you can undo a previous operation by pressing **Ctrl + Z**. -.. _studio_5.4.6_editor_statement_area: +.. _studio_5.4.3_editor_statement_area: Writing Statements and Queries from the Statement Panel ============== @@ -266,7 +274,8 @@ You can add and name new tabs for each statement that you need to execute, and S You can also rename the default tab name by double-clicking it and typing a new name and write multiple statements in tandem in the same tab by separating them with semicolons (``;``).If too many tabs to fit into the Statement Pane are open at the same time, the tab arrows are displayed. You can scroll through the tabs by clicking |icon-left| or |icon-right|, and close tabs by clicking |icon-close|. You can also close all tabs at once by clicking **Close all** located to the right of the tabs. -.. tip:: If this is your first time using SQream, see :ref:`getting_started`. +.. tip:: If this is your first time using SQream, see `Getting Started `_. + .. Keyboard shortcuts .. ^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -279,13 +288,13 @@ You can also rename the default tab name by double-clicking it and typing a new .. :kbd:`Ctrl` + :kbd:`↓` - Switch to previous tab -.. _studio_editor_results_5.4.6: +.. _studio_editor_results_5.4.3: -:ref:`Back to Executing Statements and Running Queries from the Editor` +:ref:`Back to Executing Statements and Running Queries from the Editor` -.. _studio_5.4.6_editor_results: +.. _studio_5.4.3_editor_results: -.. _results_panel_5.4.6: +.. _results_panel_5.4.3: Viewing Statement and Query Results from the Results Panel ============== @@ -301,17 +310,17 @@ The following is a brief description of the Results panel views highlighted in t * - Element - Description - * - :ref:`Results view` + * - :ref:`Results view` - Lets you view search query results. - * - :ref:`Execution Details view` + * - :ref:`Execution Details view` - Lets you analyze your query for troubleshooting and optimization purposes. - * - :ref:`SQL view` + * - :ref:`SQL view` - Lets you see the SQL view. -.. _results_view_5.4.6: +.. _results_view_5.4.3: -:ref:`Back to Executing Statements and Running Queries from the Editor` +:ref:`Back to Executing Statements and Running Queries from the Editor` Searching Query Results in the Results View ---------------- @@ -329,7 +338,7 @@ Saving Results to the Clipboard ^^^^^^^^^^^^ The **Save results to clipboard** function lets you save your results to the clipboard to paste into another text editor or into Excel for further analysis. -.. _save_results_to_local_file_5.4.6: +.. _save_results_to_local_file_5.4.3: Saving Results to a Local File ^^^^^^^^^^^^ @@ -337,7 +346,7 @@ The **Save results to local file** functions lets you save your search query res In the Results view you can also run parallel statements, as described in **Running Parallel Statements** below. -.. _running_parallel_statements_5.4.6: +.. _running_parallel_statements_5.4.3: Running Parallel Statements ^^^^^^^^^^^^ @@ -355,11 +364,11 @@ The following shows the syntax for running parallel statements: $ $$ -:ref:`Back to Viewing Statement and Query Results from the Results Panel` +:ref:`Back to Viewing Statement and Query Results from the Results Panel` -.. _execution_details_view_5.4.6: +.. _execution_details_view_5.4.3: -.. _execution_tree_5.4.6: +.. _execution_tree_5.4.3: Execution Details View -------------- @@ -468,16 +477,16 @@ This can be seen in the **timeSum** column as follows: * **Rows highlighted orange** - medium runtime * **Rows highlighted yellow** - shortest runtime -:ref:`Back to Viewing Statement and Query Results from the Results Panel` +:ref:`Back to Viewing Statement and Query Results from the Results Panel` -.. _sql_view_5.4.6: +.. _sql_view_5.4.3: Viewing Wrapped Strings in the SQL View ------------------ The SQL View panel allows you to more easily view certain queries, such as a long string that appears on one line. The SQL View makes it easier to see by wrapping it so that you can see the entire string at once. It also reformats and organizes query syntax entered in the Statement panel for more easily locating particular segments of your queries. The SQL View is identical to the **Format SQL** feature in the Toolbar, allowing you to retain your originally constructed query while viewing a more intuitively structured snapshot of it. -.. _save_results_to_clipboard_5.4.6: +.. _save_results_to_clipboard_5.4.3: -:ref:`Back to Viewing Statement and Query Results from the Results Panel` +:ref:`Back to Viewing Statement and Query Results from the Results Panel` -:ref:`Back to Executing Statements and Running Queries from the Editor` +:ref:`Back to Executing Statements and Running Queries from the Editor` diff --git a/sqream_studio_5.4.6/getting_started_sqream.rst b/sqream_studio_5.4.7/getting_started.rst similarity index 78% rename from sqream_studio_5.4.6/getting_started_sqream.rst rename to sqream_studio_5.4.7/getting_started.rst index ea95f0c41..7f401f5fa 100644 --- a/sqream_studio_5.4.6/getting_started_sqream.rst +++ b/sqream_studio_5.4.7/getting_started.rst @@ -1,13 +1,11 @@ -.. _getting_started_sqream: +.. _getting_started: **************************** -Getting Started with SQream Acceleration Studio 5.4.6 +Getting Started with SQream Acceleration Studio 5.4.3 **************************** Setting Up and Starting Studio ---------------- -Studio is included with all dockerized installations of SQream. When starting Studio, it listens on the local machine on port 8080. - -For more information, see :ref:`running_sqream_in_a_docker_container`. +Studio is included with all `dockerized installations of SQream DB `_. When starting Studio, it listens on the local machine on port 8080. Logging In to Studio --------------- @@ -45,6 +43,8 @@ From here you can navigate between the main areas of the Studio: - Lets you view usage logs. * - :ref:`Roles` - Lets you create users and manage user permissions. + * - :ref:`Configuration` + - Lets you configure your instance of SQream. By clicking the user icon, you can also use it for logging out and viewing the following: @@ -56,6 +56,6 @@ By clicking the user icon, you can also use it for logging out and viewing the f * License storage capacity * Log out -.. _back_to_dashboard_5.4.6: +.. _back_to_dashboard_5.4.3: -.. _studio_dashboard_5.4.6: +.. _studio_dashboard_5.4.3: diff --git a/sqream_studio_5.4.7/index.rst b/sqream_studio_5.4.7/index.rst new file mode 100644 index 000000000..d98df64d5 --- /dev/null +++ b/sqream_studio_5.4.7/index.rst @@ -0,0 +1,19 @@ +.. _sqream_studio_: + +********************************** +SQream Acceleration Studio +********************************** +The SQream Acceleration Studio 5.4.3 is a web-based client for use with SQream. Studio provides users with all functionality available from the command line in an intuitive and easy-to-use format. This includes running statements, managing roles and permissions, and managing SQream clusters. + +This section describes how to use the SQream Accleration Studio version 5.4.3: + +.. toctree:: + :maxdepth: 1 + :glob: + + getting_started + monitoring_workers_and_services_from_the_dashboard + executing_statements_and_running_queries_from_the_editor + viewing_logs + creating_assigning_and_managing_roles_and_permissions + configuring_your_instance_of_sqream \ No newline at end of file diff --git a/sqream_studio_5.4.6/monitoring_workers_and_services_from_the_dashboard.rst b/sqream_studio_5.4.7/monitoring_workers_and_services_from_the_dashboard.rst similarity index 84% rename from sqream_studio_5.4.6/monitoring_workers_and_services_from_the_dashboard.rst rename to sqream_studio_5.4.7/monitoring_workers_and_services_from_the_dashboard.rst index 51dbb3941..4283f64a8 100644 --- a/sqream_studio_5.4.6/monitoring_workers_and_services_from_the_dashboard.rst +++ b/sqream_studio_5.4.7/monitoring_workers_and_services_from_the_dashboard.rst @@ -1,6 +1,6 @@ .. _monitoring_workers_and_services_from_the_dashboard: -.. _back_to_dashboard_5.4.6: +.. _back_to_dashboard_: **************************** Monitoring Workers and Services from the Dashboard @@ -27,24 +27,29 @@ The following is a brief description of the Dashboard panels: - Element - Description * - 1 - - :ref:`Services panel` + - :ref:`Services panel` - Used for viewing and monitoring the defined service queues. * - 2 - - :ref:`Workers panel` + - :ref:`Workers panel` - Monitors system health and shows each Sqreamd worker running in the cluster. * - 3 - - :ref:`License information` - - Shows the remaining amount of days left on your license. + - :ref:`License information` + - Shows the remaining amount of days left on your license. + + +.. _data_storage_panel_: + -.. _data_storage_panel_5.4.6: -:ref:`Back to Monitoring Workers and Services from the Dashboard` +:ref:`Back to Monitoring Workers and Services from the Dashboard` -.. _services_panel_5.4.6: +.. _services_panel_: Subscribing to Workers from the Services Panel -------------------------- -Services are used to categorize and associate (also known as **subscribing**) workers to particular services. The **Service** panel is used for viewing, monitoring, and adding defined in the :ref:`workload_manager`. +Services are used to categorize and associate (also known as **subscribing**) workers to particular services. The **Service** panel is used for viewing, monitoring, and adding defined `service queues `_. + + The following is a brief description of each pane: @@ -73,23 +78,23 @@ You can add a service by clicking **+ Add** and defining the service name. You can manage workers from the **Workers** panel. For more information about managing workers, see the following: -* :ref:`Managing Workers from the Workers Panel` -* `Workers `_ +* :ref:`Managing Workers from the Workers Panel` +* `Workers `_ -:ref:`Back to Monitoring Workers and Services from the Dashboard` +:ref:`Back to Monitoring Workers and Services from the Dashboard` -.. _workers_panel_5.4.6: +.. _workers_panel_: Managing Workers from the Workers Panel ------------ From the **Workers** panel you can do the following: -* :ref:`View workers ` -* :ref:`Add a worker to a service` -* :ref:`View a worker's active query information` -* :ref:`View a worker's execution plan` +* :ref:`View workers ` +* :ref:`Add a worker to a service` +* :ref:`View a worker's active query information` +* :ref:`View a worker's execution plan` -.. _view_workers_5.4.6: +.. _view_workers_: Viewing Workers ^^^^^^^^ @@ -104,7 +109,7 @@ You can hover over segments in the status bar to see the date and time correspon * **Stopped** – the worker was stopped (either deliberately or due to an error). * **Waiting** – the worker was waiting on an object locked by another worker. -.. _add_worker_to_service_5.4.6: +.. _add_worker_to_service_: Adding A Worker to A Service ^^^^^^^^^^^^^^^^^^^^^ @@ -115,14 +120,14 @@ You can add a worker to a service by clicking the **add** button. Clicking the **add** button shows the selected service's workers. You can add the selected worker to the service by clicking **Add Worker**. Adding a worker to a service does not break associations already made between that worker and other services. -.. _view_worker_query_information_5.4.6: +.. _view_worker_query_information_: Viewing A Worker's Active Query Information ^^^^^^^^^^^^^^^^^^^^^ You can view a worker's active query information by clicking **Queries**, which displays them in the selected service. -Each statement shows the **query ID**, **status**, **service queue**, **elapsed time**, **execution time**, and **estimated completion status**. In addition, each statement can be stopped or expanded to show its execution plan and progress. For more information on viewing a statement's execution plan and progress, see :ref:`Viewing a Worker's Execution Plan ` below. +Each statement shows the **query ID**, **status**, **service queue**, **elapsed time**, **execution time**, and **estimated completion status**. In addition, each statement can be stopped or expanded to show its execution plan and progress. For more information on viewing a statement's execution plan and progress, see :ref:`Viewing a Worker's Execution Plan ` below. Viewing A Worker's Host Utilization ^^^^^^^^^^^^^^^^^^^^^ @@ -133,27 +138,20 @@ While viewing a worker's query information, clicking the **down arrow** expands The graphs show the resource utilization trends over time, and the **CPU memory** and **utilization** and the **GPU utilization** values on the right. You can hover over the graph to see more information about the activity at any point on the graph. -Error notifications related to statements are displayed, and you can hover over them for more information about the error. +Error notifications related to statements are displayed, and you can hover over them for more information about the error. -.. _view_worker_execution_plan_5.4.6: + +.. _view_worker_execution_plan_: Viewing a Worker's Execution Plan -^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^ + Clicking the ellipsis in a service shows the following additional options: * **Stop Query** - stops the query. - - :: - * **Show Execution Plan** - shows the execution plan as a table. The columns in the **Show Execution Plan** table can be sorted. -For more information on the current query plan, see the following: - -* :ref:`show_node_info` - - :: - -* :ref:`show_server_status` +For more information on the current query plan, see `SHOW_NODE_INFO `_. For more information on checking active sessions across the cluster, see `SHOW_SERVER_STATUS `_. .. include:: /reference/sql/sql_statements/monitoring_commands/show_server_status.rst :start-line: 67 @@ -161,10 +159,15 @@ For more information on the current query plan, see the following: Managing Worker Status ^^^^^^^^^^^^^^^^^^^^^ + In some cases you may want to stop or restart workers for maintenance purposes. Each Worker line has a :kbd:`⋮` menu used for stopping, starting, or restarting workers. + Starting or restarting workers terminates all queries related to that worker. When you stop a worker, its background turns gray. + + + .. |icon-user| image:: /_static/images/studio_icon_user.png :align: middle @@ -243,11 +246,11 @@ Starting or restarting workers terminates all queries related to that worker. Wh .. |keep-tabs| image:: /_static/images/studio_keep_tabs.png :align: middle -:ref:`Back to Monitoring Workers and Services from the Dashboard` +:ref:`Back to Monitoring Workers and Services from the Dashboard` -.. _license_information_5.4.6: +.. _license_information_: License Information ---------------------- @@ -259,4 +262,4 @@ The license information section shows the following: .. image:: /_static/images/license_storage_capacity.png -:ref:`Back to Monitoring Workers and Services from the Dashboard` +:ref:`Back to Monitoring Workers and Services from the Dashboard` diff --git a/sqream_studio_5.4.6/viewing_logs.rst b/sqream_studio_5.4.7/viewing_logs.rst similarity index 73% rename from sqream_studio_5.4.6/viewing_logs.rst rename to sqream_studio_5.4.7/viewing_logs.rst index 4b4654c4a..7f98bea5e 100644 --- a/sqream_studio_5.4.6/viewing_logs.rst +++ b/sqream_studio_5.4.7/viewing_logs.rst @@ -1,6 +1,6 @@ .. _viewing_logs: -.. _logs_top_5.4.6: +.. _logs_top_5.4.3: **************************** Viewing Logs @@ -13,20 +13,19 @@ The **Logs** screen is used for viewing logs and includes the following elements * - Element - Description - * - :ref:`Filter area` + * - :ref:`Filter area` - Lets you filter the data shown in the table. - * - :ref:`Query tab` + * - :ref:`Query tab` - Shows basic query information logs, such as query number and the time the query was run. - * - :ref:`Session tab` + * - :ref:`Session tab` - Shows basic session information logs, such as session ID and user name. - * - :ref:`System tab` + * - :ref:`System tab` - Shows all system logs. - * - :ref:`Log lines tab` + * - :ref:`Log lines tab` - Shows the total amount of log lines. -.. note:: Because the logs are stored in the **system** database, you cannot search the logs without first creating a **system** database. When you access the **Logs** tab, SQream can automatically create a **system** database for you. -.. _filter_5.4.6: +.. _filter_5.4.3: Filtering Table Data ------------- @@ -42,9 +41,9 @@ Other filters require you to select an item from a dropdown menu: You can also export a record of all of your currently filtered logs in Excel format by clicking **Download** located above the Filter area. -.. _queries_5.4.6: +.. _queries_5.4.3: -:ref:`Back to Viewing Logs` +:ref:`Back to Viewing Logs` Viewing Query Logs @@ -63,9 +62,9 @@ From the Queries area you can see and sort by the following: In the Queries table, you can click on the **Statement ID** and **Query** items to set them as your filters. In the **Details** column you can also access additional details by clicking one of the **Details** options for a more detailed explanation of the query. -:ref:`Back to Viewing Logs` +:ref:`Back to Viewing Logs` -.. _sessions_5.4.6: +.. _sessions_5.4.3: Viewing Session Logs ---------- @@ -83,9 +82,9 @@ From here you can see and sort by the following: In the Sessions table, you can click on the **Timestamp**, **Connection ID**, and **Username** items to set them as your filters. -:ref:`Back to Viewing Logs` +:ref:`Back to Viewing Logs` -.. _system_5.4.6: +.. _system_5.4.3: Viewing System Logs ---------- @@ -99,6 +98,25 @@ From here you can see and sort by the following: In the Systems table, you can click on the **Timestamp** and **Log type** items to set them as your filters. In the **Message** column, you can also click on an item to show more information about the message. -:ref:`Back to Viewing Logs` +:ref:`Back to Viewing Logs` -.. _log_lines_5.4.6: \ No newline at end of file +.. _log_lines_5.4.3: + +Viewing All Log Lines +---------- +The **LOG LINES** tab is used for viewing the total amount of log lines in a table. From here users can view a more granular breakdown of log information collected by Studio. The other tabs (QUERIES, SESSIONS, and SYSTEM) show a filtered form of the raw log lines. For example, the QUERIES tab shows an aggregation of several log lines. + +From here you can see and sort by the following: + +* Timestamp +* Message level +* Worker hostname +* Worker port +* Connection ID +* Database name +* User name +* Statement ID + +In the **LOG LINES** table, you can click on any of the items to set them as your filters. + +:ref:`Back to Viewing Logs` \ No newline at end of file diff --git a/studio_login_5.3.2.png b/studio_login_5.3.2.png deleted file mode 100644 index e888aca13a8081b0ef7c196c969d1e4235845bd0..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 82674 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 z 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 N=x7;gma5x^{U4w+h_wI! From 0cef12c3b0f362021ba13c4602df8517cd31959a Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Mon, 15 Aug 2022 13:33:25 +0300 Subject: [PATCH 217/882] Updated with Dor. --- feature_guides/query_healer.rst | 42 +++++++++++++++++++-------------- 1 file changed, 24 insertions(+), 18 deletions(-) diff --git a/feature_guides/query_healer.rst b/feature_guides/query_healer.rst index 0180150ea..f8bb7f694 100644 --- a/feature_guides/query_healer.rst +++ b/feature_guides/query_healer.rst @@ -11,42 +11,48 @@ The **Query Healer** page describes the following: Overview ---------- -The **Query Healer** periodically examines the progress of running statements, creating a log entry for all statements exceeding the ``healerMaxInactivityHours`` flag setting. The default setting of the ``healerMaxInactivityHours`` is five hours. +The **Query Healer** periodically examines the progress of running statements, creating a log entry for all statements exceeding the ``healerMaxInactivityHours`` flag setting. The default setting of the ``healerMaxInactivityHours`` is five hours. The ``healerMaxInactivityHours`` log frequency is calculated as 5% of the flag setting. When set to to five hours (the default setting), the Query Healer triggers an examination every 15 minutes. The following is an example of a log record for a query stuck in the query detection phase for more than five hours: .. code-block:: console - 2022/05/19::20:01:25|ERROR|Healer|(0x7f07147fc700)|Stuck query found. Statement ID: 72, Last chunk producer updated: 1 WriteTable, Started on: Thu May 19 14:01:25 2022, Last updated: Thu May 19 15:01:25 2022, Stuck time: 5 hours, Max allowed stuck query time: 5 hours + |INFO|0x00007f9a497fe700:Healer|192.168.4.65|5001|-1|master|sqream|-1|sqream|0|"[ERROR]|cpp/SqrmRT/healer.cpp:140 |"Stuck query found. Statement ID: 72, Last chunk producer updated: 1. -The ``healerMaxInactivityHours`` log frequency is calculated as 5% of the flag setting. When set to to five hours (the default setting), the Query Healer triggers an examination every 15 minutes. +Once you identify the stuck worker, you can execute the ``shutdown_server`` utility function from this specific worker, as described in the next section. -Configuring the Healer +Activating a Graceful Shutdown ------------------ -The following **Administration Worker** flags are required to configure the Query Healer: - - * :ref:`is_healer_on` - Enables the Query Healer. +You can activate a graceful shutdown if your log entry says ``Stuck query found``, as shown in the example above. You can do this by setting the **shutdown_server** utility function to ``select shutdown_server();``. - :: +**To activte a graceful shutdown:** - * :ref:`healer_max_inactivity_hours` - Defines the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU. +1. Locate the IP and the Port of the stuck worker from the logs. -The ``healerMaxInactivityHours`` log frequency is calculated as 5% of the flag setting. For example, setting ``healerMaxInactivityHours`` to five hours (the default setting) triggers an examination every 15 minutes. + .. note:: The log in the previous section identifies the IP **(192.168.4.65)** and port **(5001)** referring to the stuck query. -Activating a Graceful Shutdown ------------------- -If your log entry says ``Stuck query found``, you must set the **shutdown_server** utility function to ``select shutdown_server(true);``, as in the following example: +2. From the machine of the stuck query (IP: **192.168.4.65**, port: **5001**), connect to SQream SQL client: -.. code-block:: console + .. code-block:: console - |INFO|0x00007f9a497fe700:Healer|192.168.4.65|5001|-1|master|sqream|-1|sqream|0|"[ERROR]|cpp/SqrmRT/healer.cpp:140 |"Stuck query found. Statement ID: 72, Last chunk producer updated: 1. + ./sqream sql --port=$STUCK_WORKER_IP --username=$SQREAM_USER --password=$SQREAM_PASSWORD databasename=$SQREAM_DATABASE -Note that the log above identifies the IP (192.168.4.65) and port (5001) referring to the stuck query. +3. Execute ``shutdown_server``. For more information, see the following: -* Activating the :ref:`shutdown_server_command` utility function. +* Activating the :ref:`shutdown_server_command` utility function. This page describes all of ``shutdown_server`` options. :: -* Configuring the :ref:`shutdown_server` flag. \ No newline at end of file +* Configuring the :ref:`shutdown_server` flag. + +Configuring the Healer +------------------ +The following **Administration Worker** flags are required to configure the Query Healer: + + * :ref:`is_healer_on` - Enables the Query Healer. + + :: + + * :ref:`healer_max_inactivity_hours` - Defines the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU. \ No newline at end of file From 5bdfefd47bfd95612a17b90079eb729a8a6756f3 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Mon, 15 Aug 2022 14:03:40 +0300 Subject: [PATCH 218/882] Enhanced Automatic Adaptive Compression --- releases/2022.1.2.rst | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/releases/2022.1.2.rst b/releases/2022.1.2.rst index d94916d02..389925e9d 100644 --- a/releases/2022.1.2.rst +++ b/releases/2022.1.2.rst @@ -23,15 +23,11 @@ The 2022.1.2 Release Notes include the following new features: :local: :depth: 1 -Feature 1 +Enhanced Automatic Adaptive Compression ************ - +SQream's automatic adaptive compression has been enhanced with new compression methods. This mechanism automatically uses the best compression method for each scenario, improving the compression ratio by approximately twice of that in Version 2022.1 -For more information, see - -Feature 2 -************ - +.. note:: The compression ratio is highly dependent on the nature of the compressed data and on other variables, such as ordering, cardinality and data types. For more information, see From a14f6692dcedd72e7fc1e1a02590914cdd00450e Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Mon, 15 Aug 2022 14:38:55 +0300 Subject: [PATCH 219/882] Updated - not done --- feature_guides/compression.rst | 39 +++++++++++++++++----------------- 1 file changed, 19 insertions(+), 20 deletions(-) diff --git a/feature_guides/compression.rst b/feature_guides/compression.rst index 4472c7ded..d39cf2df4 100644 --- a/feature_guides/compression.rst +++ b/feature_guides/compression.rst @@ -3,43 +3,37 @@ *********************** Compression *********************** +The **Compression** page describes the following: + +.. contents:: + :local: + :depth: 1 .. |icon-new_dark_gray_2022.1.1.png| image:: /_static/images/new_dark_gray_2022.1.1.png :align: middle :width: 110 -SQream DB uses compression and encoding techniques to optimize query performance and save on disk space. +SQream uses a variety of compression and encoding methods to optimize query performance and to save disk space. Encoding ============= +**Encoding** is an automatic operation used to convert data into common formats. For example, certain formats are often used for data stored in columnar format, in contrast with data stored in a CSV file, which stores all data in text format. -Encoding converts data into a common format. - -When data is stored in a columnar format, it is often in a common format. This is in contrast with data stored in CSVs for example, where everything is stored in a text format. - -Because encoding uses specific data formats and encodings, it increases performance and reduces data size. +Encoding enhances performance and reduces data size by using specific data formats and encoding methods. SQream encodes data in a number of ways in accordance with the data type. For example, a **date** is stored as an **integer**, starting with **March 1st 1CE**, which is significantly more efficient than encoding the date as a string. In addition, it offers a wider range than storing it relative to the Unix Epoch. -SQream DB encodes data in several ways depending on the data type. For example, a date is stored as an integer, with March 1st 1CE as the start. This is a lot more efficient than encoding the date as a string, and offers a wider range than storing it relative to the Unix Epoch. - -Compression +Lossless Compression ============== +**Compression** transforms data into a smaller format without sacrificing accuracy, known as **lossless compression**. -Compression transforms data into a smaller format without losing accuracy (lossless). - -After encoding a set of column values, SQream DB packs the data and compresses it. +After encoding a set of column values, SQream packs the data and compresses it and decompresses it to make it accessible to users. Depending on the compression scheme used, these operations can be performed on the CPU or the GPU. Some users find that GPU compressions provide better performance. -Before data can be accessed, SQream DB needs to decompress it. - -Depending on the compression scheme, the operations can be performed on the CPU or the GPU. Some users find that GPU compressions perform better for their data. - -Automatic compression +Automatic Compression ------------------------ - -By default, SQream DB automatically compresses every column (see :ref:`Specifying compressions` below for overriding default compressions). This feature is called **automatic adaptive compression** strategy. +By default, SQream automatically compresses every column (see :ref:`Specifying compressions` below for overriding default compressions). This feature is called **automatic adaptive compression** strategy. When loading data, SQream DB automatically decides on the compression schemes for specific chunks of data by trying several compression schemes and selecting the one that performs best. SQream DB tries to balance more agressive compressions with the time and CPU/GPU time required to compress and decompress the data. -Compression strategies +Compression Methods ------------------------ .. list-table:: @@ -93,6 +87,11 @@ Compression strategies - Integer types - Optimized RLE + Delta type for built-in :ref:`identity columns`. - GPU + * - ``zlib`` + - All types + - The **basic_zlib_compressor** and **basic_zlib_decompressor** compress and decompress data in the **ZLIB** format, using **DualUseFilters** for input and output. In general, compression filters are for output, and decompression filters for input. + + .. note:: Automatic compression does not select the **zlib** compression method. .. _specifying_compressions: From 7211281d357cec3d1fcac84a10a2ab54fdd394e8 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Mon, 15 Aug 2022 20:32:06 +0300 Subject: [PATCH 220/882] Restored additional Update functionality I removed this all per Ben Esh's request before publishing 2022.1.1, with the intent to restore it in the next release. as was done here. --- .../sql_statements/dml_commands/update.rst | 119 +++++++++++++++--- 1 file changed, 100 insertions(+), 19 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/update.rst b/reference/sql/sql_statements/dml_commands/update.rst index 873cf6290..9f1d321b9 100644 --- a/reference/sql/sql_statements/dml_commands/update.rst +++ b/reference/sql/sql_statements/dml_commands/update.rst @@ -5,7 +5,7 @@ UPDATE ********************** The **UPDATE** statement page describes the following: -.. |icon-new_2022.1.1| image:: /_static/images/new_2022.1.1.png +.. |icon-new_2022.1| image:: /_static/images/new_2022.1.png :align: middle :width: 110 @@ -15,7 +15,7 @@ The **UPDATE** statement page describes the following: Overview ========== -The ``UPDATE`` command is used to modify the value of certain columns in existing rows without creating a table. +The ``UPDATE`` statement is used to modify the value of certain columns in existing rows without creating a table. It can be used to do the following: @@ -27,6 +27,8 @@ It can be used to do the following: .. warning:: Using the ``UPDATE`` command on column clustered using a cluster key can undo your clustering. +The ``UPDATE`` statement cannot be used to reference other tables in the ``WHERE`` or ``SET`` clauses. + Syntax ========== The following is the correct syntax for the ``UPDATE`` command: @@ -35,8 +37,8 @@ The following is the correct syntax for the ``UPDATE`` command: UPDATE target_table_name [[AS] alias1] SET column_name = expression [,...] - [FROM additional_table_name [[AS] alias2][,...]] - [WHERE condition] + [FROM additional_table_name [[AS] alias2][,...]] + [WHERE condition] The following is the correct syntax for triggering a clean-up: @@ -44,7 +46,6 @@ The following is the correct syntax for triggering a clean-up: SELECT cleanup_chunks('schema_name','table_name'); SELECT cleanup_extents('schema_name','table_name'); - SELECT cleanup_discarded_chunks(‘public’,’t’); Parameters ============ @@ -61,13 +62,11 @@ The following table describes the ``UPDATE`` parameters: * - ``column_name`` - Specifies the column containing the data to be updated. * - ``additional_table_name`` - - Specifies the column containing the data to be updated. + - Additional tables used in the WHERE condition for performing complex joins. * - ``condition`` - Specifies the condition for updating the data. -.. note:: A single table can appear **both** as a ``DELETE`` target *and* as a ``FROM`` table. This can be useful for deleting data based on self-join conditions. A ``SET`` clause can contain columns from tables specified in a ``FROM`` clause. For example, using the join ``WHERE`` condition updates rows in the target tables with the values of one of the matching rows. - -.. note:: Similar to a ``DELETE`` statement, an ``UPDATE`` statement may leave some uncleaned data behind, which requires a clean-up operation. +.. note:: Similar to a DELETE statement, an UPDATE statement may leave some uncleaned data behind, which requires a cleanup operation. Examples =========== @@ -76,7 +75,31 @@ The **Examples** section includes the following examples: .. contents:: :local: :depth: 1 - + +Updating an Entire Table +----------------- +The Examples section shows how to modify the value of certain columns in existing rows without creating a table. The examples are based on the following tables: + +.. image:: /_static/images/delete_optimization.png + +The following methods for updating an entire table generate the same output, and result with the ``bands`` record set to ``NULL``: + +.. code-block:: postgres + + UPDATE bands SET records_sold = 0; + +.. code-block:: postgres + + UPDATE bands SET records_sold = 0 WHERE true; + +.. code-block:: postgres + + UPDATE bands SET records_sold = 0 USING countries; + +.. code-block:: postgres + + UPDATE bands SET records_sold = 0 USING countries WHERE 1=1; + Performing Simple Updates ----------------- The following is an example of performing a simple update: @@ -84,15 +107,73 @@ The following is an example of performing a simple update: .. code-block:: postgres UPDATE bands SET records_sold = records_sold + 1 WHERE name LIKE 'The %'; + +Updating Tables that Contain Multi-Table Conditions +----------------- +The following shows an example of updating tables that contain multi-table conditions: + +.. code-block:: postgres + + UPDATE bands + SET records_sold = records_sold + 1 + WHERE EXISTS ( + SELECT 1 FROM countries + WHERE countries.id=bands.country_id + AND country.name = 'Sweden' + ); + +You can also write the statement above using the FROM clause: + +.. code-block:: psql + + UPDATE bands + SET records_sold = records_sold + 1 + FROM countries + WHERE countries.id=bands.country_id AND country.name = 'Sweden'; + +Updating Tables that Contain Multi-Table Expressions +----------------- +The following shows an example of updating tables that contain multi-table expressions: + +.. code-block:: postgres + + UPDATE bands + SET records_sold = records_sold + + CASE + WHEN c.name = 'Israel' THEN 2 + ELSE 1 + END + FROM countries c -Triggering a Clean-Up +Configuring Update Behavior ----------------- -The following section shows an example of triggering a clean-up: +The ``failOnNondeterministicUpdate`` flag is used to configure ``UPDATE`` behavior when updating tables containing multi-table expressions. This flag is needed when you use the ``FROM`` clause along with a set expression containing columns from additional tables. Doing this can cause a match to occur between a row from the target table with multiple rows from the additional tables. + +For instance, the example in the previous section sets the records sold to ``2`` when the country name is Israel. If you were to insert a new entry into this table with Israel spelled in Hebrew (using the same country ID), you would have two rows with identical country ID's. + +When this happens, both rows 5 and 6 in the ``bands`` table match both Israel entries. Because no algorithm exists for determining which entry to use, updating this table may either increase ``records_sold`` by 2 (for Israel in English) or 1 (for Israel in Hebrew). + +You must set the ``failOnNondeterministicUpdate`` flag to ``FALSE`` to prevent an error from occuring. + +Note that a similar ambiguity can occur when the Hebrew spelling is used in the following example: + +.. code-block:: postgres + + UPDATE bands + SET record_count = record_count + 1 + FROM countries c + WHERE c.name = 'Israel' + +However, the ``WHERE`` clause above prevents a match with any entry other than the defined one. Because the target table row must match with the ``WHERE`` condition at least once to be included in the UPDATE statment, this scenario does not require configuring the ``failOnNondeterministicUpdate`` flag. + +Triggering a Clean-Up +--------------------------------------- +The following shows an example of triggering a clean-up: .. code-block:: psql SELECT * FROM sqream_catalog.discarded_chunks; - SELECT cleanup_discarded_chunks('public','t'); + SELECT cleanup_discarded_chunks('public','t'); The following is an example of the output generated from the above: @@ -100,14 +181,14 @@ The following is an example of the output generated from the above: * **table_id** - 24 * **column_id** - 1 * **extent_ID** - 0 - -Locking and Concurrency -============= -Executing the ``UPDATE`` statement obtains an exclusive ``UPDATE`` lock on the target table. - + Permissions ============= Executing an ``UPDATE`` statement requires the following permissions: * Both ``UPDATE`` and ``SELECT`` permissions on the target table. -* The ``SELECT`` permission for each additional table you reference in the statement (in ither the ``FROM`` clause or ``WHERE`` subquery section). \ No newline at end of file +* The ``SELECT`` permission for each additional table you reference in the statement (in ither the ``FROM`` clause or ``WHERE`` subquery section). + +Locking and Concurrency +============= +Executing the ``UPDATE`` statement obtains an exclusive UPDATE lock on the target table, but does not lock the destination tables. \ No newline at end of file From f1086363b279effae9cad39a60944b291d6e5e1c Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Mon, 15 Aug 2022 21:10:39 +0300 Subject: [PATCH 221/882] 2022.1.2 - Updated Compression Page Compression: added zlib method 2022.1.2 RN page: added link to Compression page --- feature_guides/compression.rst | 113 +++++++++++++++++---------------- releases/2022.1.2.rst | 9 ++- 2 files changed, 66 insertions(+), 56 deletions(-) diff --git a/feature_guides/compression.rst b/feature_guides/compression.rst index d39cf2df4..b44d78cf8 100644 --- a/feature_guides/compression.rst +++ b/feature_guides/compression.rst @@ -29,29 +29,30 @@ After encoding a set of column values, SQream packs the data and compresses it a Automatic Compression ------------------------ -By default, SQream automatically compresses every column (see :ref:`Specifying compressions` below for overriding default compressions). This feature is called **automatic adaptive compression** strategy. +By default, SQream automatically compresses every column (see :ref:`Specifying Compression Strategies` below for overriding default compressions). This feature is called **automatic adaptive compression** strategy. When loading data, SQream DB automatically decides on the compression schemes for specific chunks of data by trying several compression schemes and selecting the one that performs best. SQream DB tries to balance more agressive compressions with the time and CPU/GPU time required to compress and decompress the data. Compression Methods ------------------------ +The following table shows the available compression methods: .. list-table:: :widths: auto :header-rows: 1 - * - Compression name - - Supported data types + * - Compression Method + - Supported Data Types - Description - Location * - ``FLAT`` - All types - No compression (forced) - - - + - NA * - ``DEFAULT`` - All types - Automatic scheme selection - - - + - NA * - ``DICT`` - Integer types, dates and timestamps, short texts - @@ -89,23 +90,26 @@ Compression Methods - GPU * - ``zlib`` - All types - - The **basic_zlib_compressor** and **basic_zlib_decompressor** compress and decompress data in the **ZLIB** format, using **DualUseFilters** for input and output. In general, compression filters are for output, and decompression filters for input. - - .. note:: Automatic compression does not select the **zlib** compression method. + - The **basic_zlib_compressor** and **basic_zlib_decompressor** compress and decompress data in the **ZLIB** format, using **DualUseFilters** for input and output. In general, compression filters are for output, and decompression filters for input. + - **Comment - GPU, CPU?** + +.. note:: Automatic compression does not select the **zlib** compression method. .. _specifying_compressions: -Specifying compression strategies +Specifying Compression Strategies ---------------------------------- +When you create a table without defining any compression specifications, SQream defaults to automatic adaptive compression (``"default"``). However, you can prevent this by specifying a compression strategy when creating a table. -When creating a table without any compression specifications, SQream DB defaults to automatic adaptive compression (``"default"``). +This section describes the following compression strategies: -However, this can be overriden by specifying a compression strategy when creating a table. +.. contents:: + :local: + :depth: 1 -Explicitly specifying automatic compression +Explicitly Specifying Automatic Compression ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -The following two are equivalent: +When you explicitly specify automatic compression, the following two are equivalent: .. code-block:: postgres @@ -123,11 +127,11 @@ In this version, the default compression is specified explicitly: y TEXT(50) CHECK('CS "default"') ); -Forcing no compression (flat) +Forcing No Compression ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +**Forcing no compression** is also known as "flat", and can be used in the event that you want to remove compression entirely on some columns. This may be useful for reducing CPU or GPU resource utilization at the expense of increased I/O. -In some cases, you may wish to remove compression entirely on some columns, -in order to reduce CPU or GPU resource utilization at the expense of increased I/O. +The following is an example of removing compression: .. code-block:: postgres @@ -136,14 +140,9 @@ in order to reduce CPU or GPU resource utilization at the expense of increased I y TEXT(50) -- This column will still be compressed automatically ); - -Forcing compressions +Forcing Compression ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -In some cases, you may wish to force SQream DB to use a specific compression scheme based -on your knowledge of the data. - -For example: +In other cases, you may want to force SQream to use a specific compression scheme based on your knowledge of the data, as shown in the following example: .. code-block:: postgres @@ -154,13 +153,19 @@ For example: ); - -Examining compression effectiveness +Examining Compression Effectiveness -------------------------------------- +Queries made on the internal metadata catalog can expose how effective the compression is, as well as what compression schemes were selected. -Queries to the internal metadata catalog can expose how effective the compression is, as well as what compression schemes were selected. +This section describes the following: -Here is a sample query we can use to query the catalog: +.. contents:: + :local: + :depth: 1 + +Querying the Catalog +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +The following is a sample query that can be used to query the catalog: .. code-block:: postgres @@ -181,7 +186,9 @@ Here is a sample query we can use to query the catalog: GROUP BY 1, 2; -Example (subset) from the ``ontime`` table: +Example Subset from "Ontime" Table +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +The following is an example (subset) from the ``ontime`` table: .. code-block:: psql @@ -271,43 +278,43 @@ Example (subset) from the ``ontime`` table: uniquecarrier | dict | 578221 | 7230705 | 11.96 | default year | rle | 6 | 2065915 | 317216.08 | default - -Notes on reading this table: +Notes on Reading the "Ontime" Table ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +The following are some useful notes on reading the "Ontime" table shown above: -#. Higher numbers in the *effectiveness* column represent better compressions. 0 represents a column that wasn't compressed at all. +#. Higher numbers in the **Compression effectiveness** column represent better compressions. **0** represents a column that has **not been compressed**. -#. Column names are the internal representation. Names with ``@null`` and ``@val`` suffixes represent a nullable column's null (boolean) and values respectively, but are treated as one logical column. + :: +#. Column names are an internal representation. Names with ``@null`` and ``@val`` suffixes represent a nullable column's null (boolean) and values respectively, but are treated as one logical column. + + :: + #. The query lists all actual compressions for a column, so it may appear several times if the compression has changed mid-way through the loading (as with the ``carrierdelay`` column). -#. When ``default`` is the compression strategy, the system automatically selects the best compression. This can also mean no compression at all (``flat``). + :: + +#. When your compression strategy is ``default``, the system automatically selects the best compression, including no compression at all (``flat``). -Compression best practices +Best Practices ============================== +This section describes the best compression practices: -Let SQream DB decide on the compression strategy +.. contents:: + :local: + :depth: 1 + +Letting SQream Determine the Best Compression Strategy ---------------------------------------------------- +In general, SQream determines the best compression strategy for most cases. If you decide to override SQream's selected compression strategies, we recommend benchmarking your query and load performance **in addition to** your storage size. -In general, SQream DB will decide on the best compression strategy in most cases. - -When overriding compression strategies, we recommend benchmarking not just storage size but also query and load performance. - - -Maximize the advantage of each compression schemes +Maximizing the Advantage of Each Compression Scheme ------------------------------------------------------- - -Some compression schemes perform better when data is organized in a specific way. - -For example, to take advantage of RLE, sorting a column may result in better performance and reduced disk-space and I/O usage. +Some compression schemes perform better when data is organized in a specific way. For example, to take advantage of RLE, sorting a column may result in better performance and reduced disk-space and I/O usage. Sorting a column partially may also be beneficial. As a rule of thumb, aim for run-lengths of more than 10 consecutive values. -Choose data types that fit the data +Choosing Data Types that Fit Your Data --------------------------------------- +Adapting to the narrowest data type improves query performance while reducing disk space usage. However, smaller data types may compress better than larger types. -Adapting to the narrowest data type will improve query performance and also reduce disk space usage. -However, smaller data types may compress better than larger types. - -For example, use the smallest numeric data type that will accommodate your data. Using ``BIGINT`` for data that fits in ``INT`` or ``SMALLINT`` can use more disk space and memory for query execution. - -Using ``FLOAT`` to store integers will reduce compression's effectiveness significantly. \ No newline at end of file +For example, SQream recommends using the smallest numeric data type that will accommodate your data. Using ``BIGINT`` for data that fits in ``INT`` or ``SMALLINT`` can use more disk space and memory for query execution. Using ``FLOAT`` to store integers will reduce compression's effectiveness significantly. \ No newline at end of file diff --git a/releases/2022.1.2.rst b/releases/2022.1.2.rst index 389925e9d..c16b551a7 100644 --- a/releases/2022.1.2.rst +++ b/releases/2022.1.2.rst @@ -13,7 +13,7 @@ Version Content ---------- The 2022.1.2 Release Notes describes the following: -* Enhanced security features. +* Enhanced compression features. New Features ---------- @@ -27,9 +27,12 @@ Enhanced Automatic Adaptive Compression ************ SQream's automatic adaptive compression has been enhanced with new compression methods. This mechanism automatically uses the best compression method for each scenario, improving the compression ratio by approximately twice of that in Version 2022.1 -.. note:: The compression ratio is highly dependent on the nature of the compressed data and on other variables, such as ordering, cardinality and data types. +.. note:: The compression ratio depends on the nature of the compressed data and on other variables, such as ordering, cardinality and data types. -For more information, see +For more information, see :ref:`compression`. + +Parquet Read Optimization +************ Known Issues --------- From df0612b0bbcc2bfe8b6fd51e34ff0b4ac181efaa Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Mon, 15 Aug 2022 21:21:10 +0300 Subject: [PATCH 222/882] 2022.1.2 - Provided Parquet Read Optimization PRD Link --- releases/2022.1.2.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/releases/2022.1.2.rst b/releases/2022.1.2.rst index c16b551a7..7338c410f 100644 --- a/releases/2022.1.2.rst +++ b/releases/2022.1.2.rst @@ -29,10 +29,12 @@ SQream's automatic adaptive compression has been enhanced with new compression m .. note:: The compression ratio depends on the nature of the compressed data and on other variables, such as ordering, cardinality and data types. -For more information, see :ref:`compression`. +For more information, navigate to the **Compression Methods** table on the :ref:`compression` page. Parquet Read Optimization -************ +************ + +https://sqream.atlassian.net/wiki/spaces/PRODUCT/pages/2277998593/Parquet+read+optimization Known Issues --------- From c19e76e3b47d6efb3b507b1cacf60375836f0ddf Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Mon, 15 Aug 2022 23:50:36 +0300 Subject: [PATCH 223/882] 2022.1.2 - Update in progress --- ...automatic_foreign_table_ddl_resolution.rst | 46 +++++++++++++++++++ feature_guides/index.rst | 1 + releases/2022.1.2.rst | 6 +++ 3 files changed, 53 insertions(+) create mode 100644 feature_guides/automatic_foreign_table_ddl_resolution.rst diff --git a/feature_guides/automatic_foreign_table_ddl_resolution.rst b/feature_guides/automatic_foreign_table_ddl_resolution.rst new file mode 100644 index 000000000..3ce1cc49f --- /dev/null +++ b/feature_guides/automatic_foreign_table_ddl_resolution.rst @@ -0,0 +1,46 @@ +.. _automatic_foreign_table_ddl_resolution: + +*********************** +Automatic Foreign Table DDL Resolution +*********************** +The **Automatic Foreign Table DDL Resolution** page describes the following: + +.. contents:: + :local: + :depth: 1 + +Overview +---------- +SQream must be able to access a schema when reading and mapping external files to a foreign table. To facilitate this, you must specify the correct schema in the statement that creates the foreign table, which must also include the correct list of columns. To avoid human error related to this complex process SQream can now automatically identify the corresponding schema, saving you the time and effort required to build your schema manually. This is especially useful for particular file formats, such as Parquet, which include a built-in schema declaration. + +Usage Notes +---------- +The automatic foreign table DDL resolution feature supports Parquet, ORC, and Avro files, while using it with CSV files generates an error. You can activate this feature when you create a foreign table by omitting the column list, described in the **Syntax** section below. + +Using this feature the path you specify in the ``LOCATION`` option must point to at least one existing file. If no files exist for the schema to read, an error will be generated. You can specify the schema manually even in the event of the error above. + +.. note:: When using this feature, SQream assumes that all files in the path use the same schema. + +Syntax +---------- +The following is the syntax for using the automatic foreign table DDL resolution feature: + +.. code-block:: console + + CREATE FOREIGN TABLE table_name + [FOREIGN DATA] WRAPPER fdw_name + [OPTIONS (...)]; + +Example +---------- +The following is an example of using the automatic foreign table DDL resolution feature: + +.. code-block:: console + + create foreign table parquet_table + wrapper parquet_fdw + options (location = '/tmp/file.parquet'); + +Permissions +---------- +The automatic foreign table DDL resolution feature requires **Read** permissions. \ No newline at end of file diff --git a/feature_guides/index.rst b/feature_guides/index.rst index d70ceb705..abb975c5d 100644 --- a/feature_guides/index.rst +++ b/feature_guides/index.rst @@ -11,6 +11,7 @@ This section describes the following features: :maxdepth: 1 :titlesonly: + automatic_foreign_table_ddl_resolution query_healer data_encryption compression diff --git a/releases/2022.1.2.rst b/releases/2022.1.2.rst index 7338c410f..b5bbb34f0 100644 --- a/releases/2022.1.2.rst +++ b/releases/2022.1.2.rst @@ -23,6 +23,12 @@ The 2022.1.2 Release Notes include the following new features: :local: :depth: 1 +Automatic Foreign Table DDL Resolution +************ +When mapping external files to foreign tables, SQream now automatically identifies the required schema. This is especially useful for Parquet files, which include built-in schema declarations. + +For more information, see :ref:`automatic_foreign_table_ddl_resolution`. + Enhanced Automatic Adaptive Compression ************ SQream's automatic adaptive compression has been enhanced with new compression methods. This mechanism automatically uses the best compression method for each scenario, improving the compression ratio by approximately twice of that in Version 2022.1 From a6c452e77bdab2449177def5b1306f646d43e005 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 21 Aug 2022 11:31:23 +0300 Subject: [PATCH 224/882] Documented Parquet Optimization --- data_ingestion/avro.rst | 2 +- data_ingestion/parquet.rst | 153 +++++++++--------- external_storage_platforms/index.rst | 2 + .../storing_data_on_parquet.rst | 8 + feature_guides/compression.rst | 3 +- releases/2022.1.2.rst | 3 +- 6 files changed, 89 insertions(+), 82 deletions(-) create mode 100644 external_storage_platforms/storing_data_on_parquet.rst diff --git a/data_ingestion/avro.rst b/data_ingestion/avro.rst index b20e64d49..7679df816 100644 --- a/data_ingestion/avro.rst +++ b/data_ingestion/avro.rst @@ -352,7 +352,7 @@ The following is an example of loading a table from a directory of Avro files on CREATE TABLE users AS SELECT * FROM ext_users; -For more configuration option examples, see the `CREATE FOREIGN TABLE parameters `_. +For more configuration option examples, navigate to the :ref:`create_foreign_table` page and see the **Parameters** table. Loading a Table from a Directory of Avro Files on S3 -------------- diff --git a/data_ingestion/parquet.rst b/data_ingestion/parquet.rst index c5971e064..36ad8c613 100644 --- a/data_ingestion/parquet.rst +++ b/data_ingestion/parquet.rst @@ -3,16 +3,19 @@ ********************** Inserting Data from a Parquet File ********************** +This guide covers inserting data from Parquet files into SQream using :ref:`FOREIGN TABLE`, and describes the following; -This guide covers inserting data from Parquet files into SQream DB using :ref:`FOREIGN TABLE`. - -.. contents:: In this topic: +.. contents:: :local: + :depth: 1 -1. Prepare the files -===================== +Overview +=================== +As described in **Inserting Data from a Parquet File** section, you can insert data into SQream from Parquet files. However, because it is an open-source column-oriented data storage format, you may want to retain your data on external Parquet files instead of inserting it into SQream. SQream supports executing queries on external Parquet files. -Prepare the source Parquet files, with the following requirements: +Preparing Your Parquet Files +===================== +Prepare your source Parquet files according to the requirements described in the following table: .. list-table:: :widths: 40 5 20 20 20 20 5 5 5 5 10 @@ -120,7 +123,7 @@ Prepare the source Parquet files, with the following requirements: - - Supported [#f4]_ -* If a Parquet file has an unsupported type, such as ``enum``, ``uuid``, ``time``, ``json``, ``bson``, ``lists``, ``maps``, but the data is not referenced in the table (it does not appear in the :ref:`SELECT` query), the statement will succeed. If the column is referenced, an error will be thrown to the user, explaining that the type is not Supported, but the column may be ommited. This can be worked around. See more information in the examples. +* Your statements will succeed even if your Parquet file contains an unsupported type, such as ``enum``, ``uuid``, ``time``, ``json``, ``bson``, ``lists``, ``maps``, but the data is not referenced in the table (it does not appear in the :ref:`SELECT` query). If the column containing the unsupported type is referenced, an error message is displayed explaining that the type is not supported and that the column may be ommitted. For solutions to this error message, see more information in **Managing Unsupported Column Types** example in the **Example** section. .. rubric:: Footnotes @@ -132,35 +135,28 @@ Prepare the source Parquet files, with the following requirements: .. [#f4] Any microseconds will be rounded down to milliseconds. -2. Place Parquet files where SQream DB workers can access them +Making Parquet Files Accessible to Workers ================================================================ - -Any worker may try to access files (unless explicitly speficied with the :ref:`workload_manager`). -It is important that every node has the same view of the storage being used - meaning, every SQream DB worker should have access to the files. +To give workers access to files every node must have the same view of the storage being used. * For files hosted on NFS, ensure that the mount is accessible from all servers. -* For HDFS, ensure that SQream DB servers can access the HDFS name node with the correct user-id. See our :ref:`hdfs` guide for more information. +* For HDFS, ensure that SQream servers have access to the HDFS name node with the correct user-id. For more information, see :ref:`hdfs` guide for more information. -* For S3, ensure network access to the S3 endpoint. See our :ref:`s3` guide for more information. +* For S3, ensure network access to the S3 endpoint. For more information, see :ref:`s3` guide for more information. - -3. Figure out the table structure +Creating a Table =============================================== +Before loading data, you must build the CREATE TABLE to correspond with the file structure of the inserted table. -Prior to loading data, you will need to write out the table structure, so that it matches the file structure. - -For example, to import the data from ``nba.parquet``, we will first look at the source table: +The example in this section is based on the source nba.parquet table shown below: .. csv-table:: nba.parquet :file: nba-t10.csv :widths: auto :header-rows: 1 -* The file is stored on S3, at ``s3://sqream-demo-data/nba.parquet``. - - -We will make note of the file structure to create a matching ``CREATE EXTERNAL TABLE`` statement. +The following example shows the correct file structure used to create the ``CREATE EXTERNAL TABLE`` statement based on the nba.parquet table: .. code-block:: postgres @@ -182,71 +178,53 @@ We will make note of the file structure to create a matching ``CREATE EXTERNAL T LOCATION = 's3://sqream-demo-data/nba.parquet' ); -.. tip:: - - Types in SQream DB must match Parquet types exactly. - - If the column type isn't Supported, a possible workaround is to set it to any arbitrary type and then exclude it from subsequent queries. - - -4. Verify table contents -==================================== - -External tables do not verify file integrity or structure, so verify that the table definition matches up and contains the correct data. - -.. code-block:: psql - - t=> SELECT * FROM ext_nba LIMIT 10; - Name | Team | Number | Position | Age | Height | Weight | College | Salary - --------------+----------------+--------+----------+-----+--------+--------+-------------------+--------- - Avery Bradley | Boston Celtics | 0 | PG | 25 | 6-2 | 180 | Texas | 7730337 - Jae Crowder | Boston Celtics | 99 | SF | 25 | 6-6 | 235 | Marquette | 6796117 - John Holland | Boston Celtics | 30 | SG | 27 | 6-5 | 205 | Boston University | - R.J. Hunter | Boston Celtics | 28 | SG | 22 | 6-5 | 185 | Georgia State | 1148640 - Jonas Jerebko | Boston Celtics | 8 | PF | 29 | 6-10 | 231 | | 5000000 - Amir Johnson | Boston Celtics | 90 | PF | 29 | 6-9 | 240 | | 12000000 - Jordan Mickey | Boston Celtics | 55 | PF | 21 | 6-8 | 235 | LSU | 1170960 - Kelly Olynyk | Boston Celtics | 41 | C | 25 | 7-0 | 238 | Gonzaga | 2165160 - Terry Rozier | Boston Celtics | 12 | PG | 22 | 6-2 | 190 | Louisville | 1824360 - Marcus Smart | Boston Celtics | 36 | PG | 22 | 6-4 | 220 | Oklahoma State | 3431040 +.. tip:: An exact match must exist between the SQream and Parquet types. For unsupported column types, you can set the type to any type and exclude it from subsequent queries. -If any errors show up at this stage, verify the structure of the Parquet files and match them to the external table structure you created. +.. note:: The **nba.parquet** file is stored on S3 at ``s3://sqream-demo-data/nba.parquet``. -5. Copying data into SQream DB +Ingesting Data into SQream =================================== +This section describes the following: -To load the data into SQream DB, use the :ref:`create_table_as` statement: +.. contents:: + :local: + :depth: 1 + +Syntax +----------- +You can use the :ref:`create_table_as` statement to load the data into SQream, as shown below: .. code-block:: postgres CREATE TABLE nba AS SELECT * FROM ext_nba; -Working around unSupported column types ---------------------------------------------- +Examples +---------------- +This section describes the following examples: -Suppose you only want to load some of the columns - for example, if one of the columns isn't Supported. +.. contents:: + :local: + :depth: 1 -By ommitting unSupported columns from queries that access the ``EXTERNAL TABLE``, they will never be called, and will not cause a "type mismatch" error. +Omitting Unsupported Column Types +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +When loading data, you can omit columns using the NULL as argument. You can use this argument to omit unsupported columns from queries that access external tables. By omitting them, these columns will not be called and will avoid generating a “type mismatch” error. -For this example, assume that the ``Position`` column isn't Supported because of its type. +In the example below, the ``Position column`` is not supported due its type. .. code-block:: postgres CREATE TABLE nba AS SELECT Name, Team, Number, NULL as Position, Age, Height, Weight, College, Salary FROM ext_nba; - - -- We ommitted the unSupported column `Position` from this query, and replaced it with a default ``NULL`` value, to maintain the same table structure. - -Modifying data during the copy process ------------------------------------------- +Modifying Data Before Loading +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +One of the main reasons for staging data using the ``EXTERNAL TABLE`` argument is to examine and modify table contents before loading it into SQream. -One of the main reasons for staging data with ``EXTERNAL TABLE`` is to examine the contents and modify them before loading them. +For example, we can replace **pounds** with **kilograms** using the ``CREATE TABLE AS`` statement. -Assume we are unhappy with weight being in pounds, because we want to use kilograms instead. We can apply the transformation as part of the :ref:`create_table_as` statement. - -Similar to the previous example, we will also set the ``Position`` column as a default ``NULL``. +In the example below, the ``Position column`` is set to the default ``NULL``. .. code-block:: postgres @@ -255,15 +233,9 @@ Similar to the previous example, we will also set the ``Position`` column as a d FROM ext_nba ORDER BY weight; - -Further Parquet loading examples -======================================= - -:ref:`create_foreign_table` contains several configuration options. See more in :ref:`the CREATE FOREIGN TABLE parameters section`. - - -Loading a table from a directory of Parquet files on HDFS ------------------------------------------------------------- +Loading a Table from a Directory of Parquet Files on HDFS +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +The following is an example of loading a table from a directory of Parquet files on HDFS: .. code-block:: postgres @@ -277,8 +249,9 @@ Loading a table from a directory of Parquet files on HDFS CREATE TABLE users AS SELECT * FROM ext_users; -Loading a table from a bucket of files on S3 ------------------------------------------------ +Loading a Table from a Directory of Parquet Files on S3 +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +The following is an example of loading a table from a directory of Parquet files on S3: .. code-block:: postgres @@ -292,3 +265,29 @@ Loading a table from a bucket of files on S3 ); CREATE TABLE users AS SELECT * FROM ext_users; + +For more configuration option examples, navigate to the :ref:`create_foreign_table` page and see the **Parameters** table. + +Best Practices +============ +Because external tables do not automatically verify the file integrity or structure, SQream recommends manually verifying your table output when ingesting Parquet files into SQream. This lets you determine if your table output is identical to your originally inserted table. + +The following is an example of the output based on the **nba.parquet** table: + +.. code-block:: psql + + t=> SELECT * FROM ext_nba LIMIT 10; + Name | Team | Number | Position | Age | Height | Weight | College | Salary + --------------+----------------+--------+----------+-----+--------+--------+-------------------+--------- + Avery Bradley | Boston Celtics | 0 | PG | 25 | 6-2 | 180 | Texas | 7730337 + Jae Crowder | Boston Celtics | 99 | SF | 25 | 6-6 | 235 | Marquette | 6796117 + John Holland | Boston Celtics | 30 | SG | 27 | 6-5 | 205 | Boston University | + R.J. Hunter | Boston Celtics | 28 | SG | 22 | 6-5 | 185 | Georgia State | 1148640 + Jonas Jerebko | Boston Celtics | 8 | PF | 29 | 6-10 | 231 | | 5000000 + Amir Johnson | Boston Celtics | 90 | PF | 29 | 6-9 | 240 | | 12000000 + Jordan Mickey | Boston Celtics | 55 | PF | 21 | 6-8 | 235 | LSU | 1170960 + Kelly Olynyk | Boston Celtics | 41 | C | 25 | 7-0 | 238 | Gonzaga | 2165160 + Terry Rozier | Boston Celtics | 12 | PG | 22 | 6-2 | 190 | Louisville | 1824360 + Marcus Smart | Boston Celtics | 36 | PG | 22 | 6-4 | 220 | Oklahoma State | 3431040 + +.. note:: If your table output has errors, verify that the structure of the Parquet files correctly corresponds to the external table structure that you created. \ No newline at end of file diff --git a/external_storage_platforms/index.rst b/external_storage_platforms/index.rst index 92c35ee63..b7a591d65 100644 --- a/external_storage_platforms/index.rst +++ b/external_storage_platforms/index.rst @@ -23,3 +23,5 @@ For more information, see the following: :: * :ref:`copy_to` + +.. note:: While you can ingest data into SQream from Parquet files, you can also store and run queries on data located on external Parquet files. For more information, see :ref:`parquet`. \ No newline at end of file diff --git a/external_storage_platforms/storing_data_on_parquet.rst b/external_storage_platforms/storing_data_on_parquet.rst new file mode 100644 index 000000000..0aa54dbc4 --- /dev/null +++ b/external_storage_platforms/storing_data_on_parquet.rst @@ -0,0 +1,8 @@ +.. _storing_data_on_parquet: + +*********************** +Storing Data on Parquet +*********************** +As described in the **Data Ingestion Sources** section, users can insert data into SQream from Parquet files. However, because it is an open-source column-oriented data storage format, users may want to retain their data there instead of inserting it into SQream. This requires SQream users to be able to execute queries on external Parquet files. + + diff --git a/feature_guides/compression.rst b/feature_guides/compression.rst index b44d78cf8..ee36f27f9 100644 --- a/feature_guides/compression.rst +++ b/feature_guides/compression.rst @@ -90,8 +90,7 @@ The following table shows the available compression methods: - GPU * - ``zlib`` - All types - - The **basic_zlib_compressor** and **basic_zlib_decompressor** compress and decompress data in the **ZLIB** format, using **DualUseFilters** for input and output. In general, compression filters are for output, and decompression filters for input. - - **Comment - GPU, CPU?** + - The **basic_zlib_compressor** and **basic_zlib_decompressor** compress and decompress data in the **ZLIB** format, using **DualUseFilters** for input and output. In general, compression filters are for output, and decompression filters for input. .. note:: Automatic compression does not select the **zlib** compression method. diff --git a/releases/2022.1.2.rst b/releases/2022.1.2.rst index b5bbb34f0..bd8be6a61 100644 --- a/releases/2022.1.2.rst +++ b/releases/2022.1.2.rst @@ -39,8 +39,7 @@ For more information, navigate to the **Compression Methods** table on the :ref: Parquet Read Optimization ************ - -https://sqream.atlassian.net/wiki/spaces/PRODUCT/pages/2277998593/Parquet+read+optimization +SQream now supports storing and running queries on data located on external Parquet files. For more information, see :ref:`parquet`. Known Issues --------- From bc994e8ac3c5c7633678358b103b566423a52107 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 21 Aug 2022 12:09:51 +0300 Subject: [PATCH 225/882] Prepared for release - See comment about SQ-11291 --- data_ingestion/parquet.rst | 36 ++++++++++++++++++++++-- feature_guides/compression.rst | 3 +- releases/2022.1.2.rst | 50 +++++++++++++--------------------- 3 files changed, 55 insertions(+), 34 deletions(-) diff --git a/data_ingestion/parquet.rst b/data_ingestion/parquet.rst index 36ad8c613..df09891d3 100644 --- a/data_ingestion/parquet.rst +++ b/data_ingestion/parquet.rst @@ -21,19 +21,51 @@ Prepare your source Parquet files according to the requirements described in the :widths: 40 5 20 20 20 20 5 5 5 5 10 :header-rows: 1 - * - SQream DB type → + * - SQream Type → - Parquet source + :: + + Parquet Source ↓ - ``BOOL`` + + :: + - ``TINYINT`` + + :: + - ``SMALLINT`` + + :: + - ``INT`` + + :: + - ``BIGINT`` + + :: + - ``REAL`` + + :: + - ``DOUBLE`` + + :: + - ``TEXT`` [#f0]_ + + :: + - ``DATE`` + + :: + - ``DATETIME`` + + :: + * - ``BOOLEAN`` - Supported - diff --git a/feature_guides/compression.rst b/feature_guides/compression.rst index ee36f27f9..ab26e9986 100644 --- a/feature_guides/compression.rst +++ b/feature_guides/compression.rst @@ -91,8 +91,9 @@ The following table shows the available compression methods: * - ``zlib`` - All types - The **basic_zlib_compressor** and **basic_zlib_decompressor** compress and decompress data in the **ZLIB** format, using **DualUseFilters** for input and output. In general, compression filters are for output, and decompression filters for input. + - CPU -.. note:: Automatic compression does not select the **zlib** compression method. +.. note:: Automatic compression does **not** select the ``zlib`` compression method. .. _specifying_compressions: diff --git a/releases/2022.1.2.rst b/releases/2022.1.2.rst index bd8be6a61..b3ff083e9 100644 --- a/releases/2022.1.2.rst +++ b/releases/2022.1.2.rst @@ -3,7 +3,7 @@ ************************** Release Notes 2022.1.2 ************************** -The 2022.1.2 release notes were released on x/xx/2022 and describe the following: +The 2022.1.2 release notes were released on 8/24/2022 and describe the following: .. contents:: :local: @@ -13,8 +13,16 @@ Version Content ---------- The 2022.1.2 Release Notes describes the following: +* Automatic schema identification. + + :: + * Enhanced compression features. + :: + +* Support for external Parquet files. + New Features ---------- The 2022.1.2 Release Notes include the following new features: @@ -41,43 +49,23 @@ Parquet Read Optimization ************ SQream now supports storing and running queries on data located on external Parquet files. For more information, see :ref:`parquet`. -Known Issues ---------- -The following table lists the known issues for Version 2022.1.2: - -+-------------+------------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+=============+================================================================================================+ -| SQ-xxxx | Description | -+-------------+------------------------------------------------------------------------------------------------+ -| SQ-xxxx | Description | -+-------------+------------------------------------------------------------------------------------------------+ -| SQ-xxxx | Description | -+-------------+------------------------------------------------------------------------------------------------+ -| SQ-xxxx | Description | -+-------------+------------------------------------------------------------------------------------------------+ - Resolved Issues --------- The following table lists the issues that were resolved in Version 2022.1.2: -+-------------+------------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+=============+================================================================================================+ -| SQ-xxxx | Description | -+-------------+------------------------------------------------------------------------------------------------+ -| SQ-xxxx | Description | -+-------------+------------------------------------------------------------------------------------------------+ -| SQ-xxxx | Description | -+-------------+------------------------------------------------------------------------------------------------+ -| SQ-xxxx | Description | -+-------------+------------------------------------------------------------------------------------------------+ ++-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++=============+===========================================================================================================================================+ +| SQ-11273 | Clustering ``partial-partial`` optimization only occurs when copying data from CSV files. | ++-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11291 | Metadata filters were not applied when using the ``LIKE`` function, causing certain queries to run on full tables instead of sorted data. | ++-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + +**Comment** - *Was SQ-11291 just removed?* Operations and Configuration Changes -------- -The ``xxxx`` configuration flag is required for adjusting the permitted log-in attempts. - -For more information, see +No configuration changes were made. Naming Changes ------- From 30f70a8ad7394346535a1f6a54152dd426bcd96f Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 21 Aug 2022 12:19:33 +0300 Subject: [PATCH 226/882] Updated Configuration Section --- configuration_guides/configuring_sqream.rst | 22 + .../current_configuration_method.rst | 729 ------------------ .../current_method_all_configurations.rst | 431 +++++++++++ .../current_method_command_examples.rst | 36 + .../current_method_configuration_levels.rst | 33 + .../current_method_configuration_roles.rst | 17 + ...thod_configuring_your_parameter_values.rst | 40 + .../current_method_flag_types.rst | 20 + .../current_method_modification_methods.rst | 50 ++ ...showing_all_flags_in_the_catalog_table.rst | 21 + configuration_guides/index.rst | 6 +- releases/2022.1.2.rst | 2 + 12 files changed, 674 insertions(+), 733 deletions(-) create mode 100644 configuration_guides/configuring_sqream.rst delete mode 100644 configuration_guides/current_configuration_method.rst create mode 100644 configuration_guides/current_method_all_configurations.rst create mode 100644 configuration_guides/current_method_command_examples.rst create mode 100644 configuration_guides/current_method_configuration_levels.rst create mode 100644 configuration_guides/current_method_configuration_roles.rst create mode 100644 configuration_guides/current_method_configuring_your_parameter_values.rst create mode 100644 configuration_guides/current_method_flag_types.rst create mode 100644 configuration_guides/current_method_modification_methods.rst create mode 100644 configuration_guides/current_method_showing_all_flags_in_the_catalog_table.rst diff --git a/configuration_guides/configuring_sqream.rst b/configuration_guides/configuring_sqream.rst new file mode 100644 index 000000000..901af9e3d --- /dev/null +++ b/configuration_guides/configuring_sqream.rst @@ -0,0 +1,22 @@ +.. _configuring_sqream: + +************************* +Configuring SQream +************************* +The **Configuring SQream** page describes the following configuration topics: + +.. toctree:: + :maxdepth: 1 + :glob: + :titlesonly: + + current_method_configuration_levels + current_method_flag_types + current_method_configuration_roles + current_method_modification_methods + current_method_configuring_your_parameter_values + current_method_command_examples + current_method_showing_all_flags_in_the_catalog_table + current_method_all_configurations + + diff --git a/configuration_guides/current_configuration_method.rst b/configuration_guides/current_configuration_method.rst deleted file mode 100644 index 078e2dac2..000000000 --- a/configuration_guides/current_configuration_method.rst +++ /dev/null @@ -1,729 +0,0 @@ -.. _current_configuration_method: - -************************** -Configuring SQream -************************** -The **Configuring SQream** page describes SQream’s method for configuring your instance of SQream and includes the following topics: - -.. contents:: - :local: - :depth: 1 - -Overview ------ -Modifications that you make to your configurations are persistent based on whether they are made at the session or cluster level. Persistent configurations are modifications made to attributes that are retained after shutting down your system. - -Modifying Your Configuration ----- -The **Modifying Your Configuration** section describes the following: - -.. contents:: - :local: - :depth: 1 - -Modifying Your Configuration Using the Worker Configuration File -~~~~~~~~~~~ -You can modify your configuration using the **worker configuration file (config.json)**. Changes that you make to worker configuration files are persistent. Note that you can only set the attributes in your worker configuration file **before** initializing your SQream worker, and while your worker is active these attributes are read-only. - -The following is an example of a worker configuration file: - -.. code-block:: postgres - - { - “cluster”: “/home/test_user/sqream_testing_temp/sqreamdb”, - “gpu”: 0, - “licensePath”: “home/test_user/SQream/tests/license.enc”, - “machineIP”: “127.0.0.1”, - “metadataServerIp”: “127.0.0.1”, - “metadataServerPort”: “3105, - “port”: 5000, - “useConfigIP”” true, - “legacyConfigFilePath”: “home/SQream_develop/SqrmRT/utils/json/legacy_congif.json” - } - -You can access the legacy configuration file from the ``legacyConfigFilePath`` parameter shown above. If all (or most) of your workers require the same flag settings, you can set the ``legacyConfigFilePath`` attribute to the same legacy file. - -Modifying Your Configuration Using a Legacy Configuration File -~~~~~~~~~~~ -You can modify your configuration using a legacy configuration file. - -The Legacy configuration file provides access to the read/write flags used in SQream’s previous configuration method. A link to this file is provided in the **legacyConfigFilePath** parameter in the worker configuration file. - -The following is an example of the legacy configuration file: - -.. code-block:: postgres - - { - “developerMode”: true, - “reextentUse”: false, - “useClientLog”: true, - “useMetadataServer”” false - } - -Session vs Cluster Based Configuration -============================== -.. contents:: - :local: - :depth: 1 - -Cluster-Based Configuration --------------- -SQream uses cluster-based configuration, enabling you to centralize configurations for all workers on the cluster. Only flags set to the regular or cluster flag type have access to cluster-based configuration. Configurations made on the cluster level are persistent and stored at the metadata level. The parameter settings in this file are applied globally to all workers connected to it. - -For more information, see the following: - -* `Using SQream SQL `_ - modifying flag attributes from the CLI. -* `SQream Acceleration Studio `_ - modifying flag attributes from Studio. - -For more information on flag-based access to cluster-based configuration, see **Configuration Flag Types** below. - -Session-Based Configuration ----------------- -Session-based configurations are not persistent and are deleted when your session ends. This method enables you to modify all required configurations while avoiding conflicts between flag attributes modified on different devices at different points in time. - -The **SET flag_name** command is used to modify flag attributes. Any modifications you make with the **SET flag_name** command apply only to your open session, and are not saved when it ends - -For example, when the query below has completed executing, the values configured will be restored to its previous setting: - -.. code-block:: console - - set spoolMemoryGB=700; - select * from table a where date='2021-11-11' - -For more information, see the following: - -* `Using SQream SQL `_ - modifying flag attributes from the CLI. -* `SQream Acceleration Studio `_ - modifying flag attributes from Studio. - -Configuration Flag Types -========== -The flag type attribute can be set for each flag and determines its write access as follows: - -* **Administration:** session-based read/write flags that can be stored in the metadata file. -* **Cluster:** global cluster-based read/write flags that can be stored in the metadata file. -* **Worker:** single worker-based read-only flags that can be stored in the worker configuration file. - -The flag type determines which files can be accessed and which commands or commands sets users can run. - -The following table describes the file or command modification rights for each flag type: - -.. list-table:: - :widths: 20 20 20 20 - :header-rows: 1 - - * - **Flag Type** - - **Legacy Configuration File** - - **ALTER SYSTEM SET** - - **Worker Configuration File** - * - :ref:`Regular` - - Can modify - - Can modify - - Cannot modify - * - :ref:`Cluster` - - Cannot modify - - Can modify - - Cannot modify - * - :ref:`Worker` - - Cannot modify - - Cannot modify - - Can modify - -.. _regular_flag_types: - -Regular Flag Types ---------------------- -The following is an example of the correct syntax for running a **Regular** flag type command: - -.. code-block:: console - - SET spoolMemoryGB= 11; - executed - -The following table describes the Regular flag types: - -.. list-table:: - :widths: 2 5 10 - :header-rows: 1 - - * - **Command** - - **Description** - - **Example** - * - ``SET `` - - Used for modifying flag attributes. - - ``SET developerMode=true`` - * - ``SHOW / ALL`` - - Used to preset either a specific flag value or all flag values. - - ``SHOW `` - * - ``SHOW ALL LIKE`` - - Used as a wildcard character for flag names. - - ``SHOW `` - * - ``show_conf_UF`` - - Used to print all flags with the following attributes: - - * Flag name - * Default value - * Is developer mode (Boolean) - * Flag category - * Flag type - - ``rechunkThreshold,90,true,RND,regular`` - * - ``show_conf_extended UF`` - - Used to print all information output by the show_conf UF command, in addition to description, usage, data type, default value and range. - - ``compilerGetsOnlyUFs,false,generic,regular,Makes runtime pass to compiler only`` - ``utility functions names,boolean,true,false`` - * - ``show_md_flag UF`` - - Used to show a specific flag/all flags stored in the metadata file. - - - * Example 1: ``* master=> ALTER SYSTEM SET heartbeatTimeout=111;`` - * Example 2: ``* master=> select show_md_flag(‘all’); heartbeatTimeout,111`` - * Example 3: ``* master=> select show_md_flag(‘heartbeatTimeout’); heartbeatTimeout,111`` - -.. _cluster_flag_types: - -Cluster Flag Types ---------------------- -The following is an example of the correct syntax for running a **Cluster** flag type command: - -.. code-block:: console - - ALTER SYSTEM RESET useMetadataServer; - executed - -The following table describes the Cluster flag types: - -.. list-table:: - :widths: 1 5 10 - :header-rows: 1 - - * - **Command** - - **Description** - - **Example** - * - ``ALTER SYSTEM SET `` - - Used to storing or modifying flag attributes in the metadata file. - - ``ALTER SYSTEM SET `` - * - ``ALTER SYSTEM RESET `` - - Used to remove a flag or all flag attributes from the metadata file. - - ``ALTER SYSTEM RESET `` - * - ``SHOW / ALL`` - - Used to print the value of a specified value or all flag values. - - ``SHOW `` - * - ``SHOW ALL LIKE`` - - Used as a wildcard character for flag names. - - ``SHOW `` - * - ``show_conf_UF`` - - Used to print all flags with the following attributes: - - * Flag name - * Default value - * Is developer mode (Boolean) - * Flag category - * Flag type - - ``rechunkThreshold,90,true,RND,regular`` - * - ``show_conf_extended UF`` - - Used to print all information output by the show_conf UF command, in addition to description, usage, data type, default value and range. - - ``compilerGetsOnlyUFs,false,generic,regular,Makes runtime pass to compiler only`` - ``utility functions names,boolean,true,false`` - * - ``show_md_flag UF`` - - Used to show a specific flag/all flags stored in the metadata file. - - - * Example 1: ``* master=> ALTER SYSTEM SET heartbeatTimeout=111;`` - * Example 2: ``* master=> select show_md_flag(‘all’); heartbeatTimeout,111`` - * Example 3: ``* master=> select show_md_flag(‘heartbeatTimeout’); heartbeatTimeout,111`` - -.. _worker_flag_types: - -Worker Flag Types ---------------------- -The following is an example of the correct syntax for running a **Worker** flag type command: - -.. code-block:: console - - SHOW spoolMemoryGB; - -The following table describes the Worker flag types: - -.. list-table:: - :widths: 1 5 10 - :header-rows: 1 - - * - **Command** - - **Description** - - **Example** - * - ``ALTER SYSTEM SET `` - - Used to storing or modifying flag attributes in the metadata file. - - ``ALTER SYSTEM SET `` - * - ``ALTER SYSTEM RESET `` - - Used to remove a flag or all flag attributes from the metadata file. - - ``ALTER SYSTEM RESET `` - * - ``SHOW / ALL`` - - Used to print the value of a specified value or all flag values. - - ``SHOW `` - * - ``SHOW ALL LIKE`` - - Used as a wildcard character for flag names. - - ``SHOW `` - * - ``show_conf_UF`` - - Used to print all flags with the following attributes: - - * Flag name - * Default value - * Is developer mode (Boolean) - * Flag category - * Flag type - - ``rechunkThreshold,90,true,RND,regular`` - * - ``show_conf_extended UF`` - - Used to print all information output by the show_conf UF command, in addition to description, usage, data type, default value and range. - - - ``compilerGetsOnlyUFs,false,generic,regular,Makes runtime pass to compiler only`` - ``utility functions names,boolean,true,false`` - * - ``show_md_flag UF`` - - Used to show a specific flag/all flags stored in the metadata file. - - - * Example 1: ``* master=> ALTER SYSTEM SET heartbeatTimeout=111;`` - * Example 2: ``* master=> select show_md_flag(‘all’); heartbeatTimeout,111`` - * Example 3: ``* master=> select show_md_flag(‘heartbeatTimeout’); heartbeatTimeout,111`` - -All Configurations ---------------------- -The following table describes the **Generic** and **Administration** configuration flags: - -.. list-table:: - :header-rows: 1 - :widths: 1 2 1 15 1 20 - :class: my-class - :name: my-name - - * - Flag Name - - Access Control - - Modification Type - - Description - - Data Type - - Default Value - - * - ``binSizes`` - - Administration - - Regular - - Sets the custom bin size in the cache to enable high granularity bin control. - - string - - - ``16,32,64,128,256,512,1024,2048,4096,8192,16384,32768,65536,`` - ``131072,262144,524288,1048576,2097152,4194304,8388608,16777216,`` - ``33554432,67108864,134217728,268435456,536870912,786432000,107374,`` - ``1824,1342177280,1610612736,1879048192,2147483648,2415919104,`` - ``2684354560,2952790016,3221225472`` - - * - ``checkCudaMemory`` - - Administration - - Regular - - Sets the pad device memory allocations with safety buffers to catch out-of-bounds writes. - - boolean - - ``FALSE`` - - * - ``compilerGetsOnlyUFs`` - - Administration - - Regular - - Sets the runtime to pass only utility functions names to the compiler. - - boolean - - ``FALSE`` - - * - ``copyToRestrictUtf8`` - - Administration - - Regular - - Sets the custom bin size in the cache to enable high granularity bin control. - - boolean - - ``FALSE`` - - * - ``cpuReduceHashtableSize`` - - Administration - - Regular - - Sets the hash table size of the CpuReduce. - - uint - - ``10000`` - - * - ``csvLimitRowLength`` - - Administration - - Cluster - - Sets the maximum supported CSV row length. - - uint - - ``100000`` - - * - ``cudaMemcpyMaxSizeBytes`` - - Administration - - Regular - - Sets the chunk size for copying from CPU to GPU. If set to 0, do not divide. - - uint - - ``0`` - - * - ``CudaMemcpySynchronous`` - - Administration - - Regular - - Indicates if copying from/to GPU is synchronous. - - boolean - - ``FALSE`` - - * - ``cudaMemQuota`` - - Administration - - Worker - - Sets the percentage of total device memory to be used by the instance. - - uint - - ``90`` - - * - ``developerMode`` - - Administration - - Regular - - Enables modifying R&D flags. - - boolean - - ``FALSE`` - - * - ``enableDeviceDebugMessages`` - - Administration - - Regular - - Activates the Nvidia profiler (nvprof) markers. - - boolean - - ``FALSE`` - - * - ``enableLogDebug`` - - Administration - - Regular - - Enables creating and logging in the clientLogger_debug file. - - boolean - - ``TRUE`` - - * - ``enableNvprofMarkers`` - - Administration - - Regular - - Activates the Nvidia profiler (nvprof) markers. - - boolean - - ``FALSE`` - - * - ``endLogMessage`` - - Administration - - Regular - - Appends a string at the end of every log line. - - string - - ``EOM`` - - - - * - ``varcharIdentifiers`` - - Administration - - Regular - - Activates using varchar as an identifier. - - boolean - - ``true`` - - - - * - ``extentStorageFileSizeMB`` - - Administration - - Cluster - - Sets the minimum size in mebibytes of extents for table bulk data. - - uint - - ``20`` - - * - ``gatherMemStat`` - - Administration - - Regular - - Monitors all pinned allocations and all **memcopies** to/from device, and prints a report of pinned allocations that were not memcopied to/from the device using the **dump_pinned_misses** utility function. - - boolean - - ``FALSE`` - - * - ``increaseChunkSizeBeforeReduce`` - - Administration - - Regular - - Increases the chunk size to reduce query speed. - - boolean - - ``FALSE`` - - * - ``increaseMemFactors`` - - Administration - - Regular - - Adds rechunker before expensive chunk producer. - - boolean - - ``TRUE`` - - * - ``leveldbWriteBufferSize`` - - Administration - - Regular - - Sets the buffer size. - - uint - - ``524288`` - - * - ``machineIP`` - - Administration - - Worker - - Manual setting of reported IP. - - string - - ``127.0.0.1`` - - - - - * - ``memoryResetTriggerMB`` - - Administration - - Regular - - Sets the size of memory used during a query to trigger aborting the server. - - uint - - ``0`` - - * - ``metadataServerPort`` - - Administration - - Worker - - Sets the port used to connect to the metadata server. SQream recommends using port ranges above 1024† because ports below 1024 are usually reserved, although there are no strict limitations. Any positive number (1 - 65535) can be used. - - uint - - ``3105`` - - * - ``mtRead`` - - Administration - - Regular - - Splits large reads to multiple smaller ones and executes them concurrently. - - boolean - - ``FALSE`` - - * - ``mtReadWorkers`` - - Administration - - Regular - - Sets the number of workers to handle smaller concurrent reads. - - uint - - ``30`` - - * - ``orcImplicitCasts`` - - Administration - - Regular - - Sets the implicit cast in orc files, such as **int** to **tinyint** and vice versa. - - boolean - - ``TRUE`` - - * - ``statementLockTimeout`` - - Administration - - Regular - - Sets the timeout (seconds) for acquiring object locks before executing statements. - - uint - - ``3`` - - * - ``useConfigIP`` - - Administration - - Worker - - Activates the machineIP (true). Setting to false ignores the machineIP and automatically assigns a local network IP. This cannot be activated in a cloud scenario (on-premises only). - - boolean - - ``FALSE`` - - * - ``useLegacyDecimalLiterals`` - - Administration - - Regular - - Interprets decimal literals as **Double** instead of **Numeric**. Used to preserve legacy behavior in existing customers. - - boolean - - ``FALSE`` - - * - ``useLegacyStringLiterals`` - - Administration - - Regular - - Interprets ASCII-only strings as **VARCHAR** instead of **TEXT**. Used to preserve legacy behavior in existing customers. - - boolean - - ``FALSE`` - - * - ``flipJoinOrder`` - - Generic - - Regular - - Reorders join to force equijoins and/or equijoins sorted by table size. - - boolean - - ``FALSE`` - - * - ``limitQueryMemoryGB`` - - Generic - - Worker - - Prevents a query from processing more memory than the flag’s value. - - uint - - ``100000`` - - * - ``cacheEvictionMilliseconds`` - - Generic - - Regular - - Sets how long the cache stores contents before being flushed. - - size_t - - ``2000`` - - - * - ``cacheDiskDir`` - - Generic - - Regular - - Sets the ondisk directory location for the spool to save files on. - - size_t - - Any legal string - - - * - ``cacheDiskGB`` - - Generic - - Regular - - Sets the amount of memory (GB) to be used by Spool on the disk. - - size_t - - ``128`` - - * - ``cachePartitions`` - - Generic - - Regular - - Sets the number of partitions that the cache is split into. - - size_t - - ``4`` - - - * - ``cachePersistentDir`` - - Generic - - Regular - - Sets the persistent directory location for the spool to save files on. - - string - - Any legal string - - - * - ``cachePersistentGB`` - - Generic - - Regular - - Sets the amount of data (GB) for the cache to store persistently. - - size_t - - ``128`` - - - * - ``cacheRamGB`` - - Generic - - Regular - - Sets the amount of memory (GB) to be used by Spool InMemory. - - size_t - - ``16`` - - - - - - - - * - ``logSysLevel`` - - Generic - - Regular - - - Determines the client log level: - 0 - L_SYSTEM, - 1 - L_FATAL, - 2 - L_ERROR, - 3 - L_WARN, - 4 - L_INFO, - 5 - L_DEBUG, - 6 - L_TRACE - - uint - - ``100000`` - - * - ``maxAvgBlobSizeToCompressOnGpu`` - - Generic - - Regular - - Sets the CPU to compress columns with size above (flag’s value) * (row count). - - uint - - ``120`` - - - * - ``sessionTag`` - - Generic - - Regular - - Sets the name of the session tag. - - string - - Any legal string - - - - * - ``spoolMemoryGB`` - - Generic - - Regular - - Sets the amount of memory (GB) to be used by the server for spooling. - - uint - - ``8`` - -Configuration Commands -========== -The configuration commands are associated with particular flag types based on permissions. - -The following table describes the commands or command sets that can be run based on their flag type. Note that the flag names described in the following table are described in the :ref:`Configuration Roles` section below. - -.. list-table:: - :header-rows: 1 - :widths: 1 2 10 17 - :class: my-class - :name: my-name - - * - Flag Type - - Command - - Description - - Example - * - Regular - - ``SET `` - - Used for modifying flag attributes. - - ``SET developerMode=true`` - * - Cluster - - ``ALTER SYSTEM SET `` - - Used to storing or modifying flag attributes in the metadata file. - - ``ALTER SYSTEM SET `` - * - Cluster - - ``ALTER SYSTEM RESET `` - - Used to remove a flag or all flag attributes from the metadata file. - - ``ALTER SYSTEM RESET `` - * - Regular, Cluster, Worker - - ``SHOW / ALL`` - - Used to print the value of a specified value or all flag values. - - ``SHOW `` - * - Regular, Cluster, Worker - - ``SHOW ALL LIKE`` - - Used as a wildcard character for flag names. - - ``SHOW `` - * - Regular, Cluster, Worker - - ``show_conf_UF`` - - Used to print all flags with the following attributes: - - * Flag name - * Default value - * Is developer mode (Boolean) - * Flag category - * Flag type - - - - - ``rechunkThreshold,90,true,RND,regular`` - * - Regular, Cluster, Worker - - ``show_conf_extended UF`` - - Used to print all information output by the show_conf UF command, in addition to description, usage, data type, default value and range. - - ``spoolMemoryGB,15,false,generic,regular,Amount of memory (GB)`` - ``the server can use for spooling,”Statement that perform “”group by””,`` - ``“”order by”” or “”join”” operation(s) on large set of data will run`` - ``much faster if given enough spool memory, otherwise disk spooling will`` - ``be used resulting in performance hit.”,uint,,0-5000`` - * - Regular, Cluster, Worker - - ``show_md_flag UF`` - - Used to show a specific flag/all flags stored in the metadata file. - - - * Example 1: ``* master=> ALTER SYSTEM SET heartbeatTimeout=111;`` - * Example 2: ``* master=> select show_md_flag(‘all’); heartbeatTimeout,111`` - * Example 3: ``* master=> select show_md_flag(‘heartbeatTimeout’); heartbeatTimeout,111`` - -.. _configuration_roles: - -Configuration Roles -=========== -SQream divides flags into the following roles, each with their own set of permissions: - -* `Administration flags `_: can be modified by administrators on a session and cluster basis using the ``ALTER SYSTEM SET`` command. -* `Generic flags `_: can be modified by standard users on a session basis. - -Showing All Flags in the Catalog Table -======= -SQream uses the **sqream_catalog.parameters** catalog table for showing all flags, providing the scope (default, cluster and session), description, default value and actual value. - -The following is the correct syntax for a catalog table query: - -.. code-block:: console - - SELECT * FROM sqream_catalog.settings - -The following is an example of a catalog table query: - -.. code-block:: console - - externalTableBlobEstimate, 100, 100, default, - varcharEncoding, ascii, ascii, default, Changes the expected encoding for Varchar columns - useCrcForTextJoinKeys, true, true, default, - hiveStyleImplicitStringCasts, false, false, default, - -This guide covers the configuration files and the ``SET`` statement. \ No newline at end of file diff --git a/configuration_guides/current_method_all_configurations.rst b/configuration_guides/current_method_all_configurations.rst new file mode 100644 index 000000000..7385066af --- /dev/null +++ b/configuration_guides/current_method_all_configurations.rst @@ -0,0 +1,431 @@ +.. _current_method_all_configurations: + +************************** +All Configurations +************************** +The following table describes all **Generic** and **Administration** configuration flags: + +.. list-table:: + :header-rows: 1 + :widths: 1 2 1 15 1 20 + :class: my-class + :name: my-name + + * - Flag Name + - Access Control + - Modification Type + - Description + - Data Type + - Default Value + + * - ``binSizes`` + - Admin + - Regular + - Sets the custom bin size in the cache to enable high granularity bin control. + - string + - + ``16,32,64,128,256,512,1024,2048,4096,8192,16384,32768,65536,`` + ``131072,262144,524288,1048576,2097152,4194304,8388608,16777216,`` + ``33554432,67108864,134217728,268435456,536870912,786432000,107374,`` + ``1824,1342177280,1610612736,1879048192,2147483648,2415919104,`` + ``2684354560,2952790016,3221225472`` + + * - ``cacheEvictionMilliseconds`` + - Generic + - Regular + - Sets how long the cache stores contents before being flushed. + - size_t + - ``2000`` + + + * - ``cacheDiskDir`` + - Generic + - Regular + - Sets the ondisk directory location for the spool to save files on. + - size_t + - Any legal string + + + * - ``cacheDiskGB`` + - Generic + - Regular + - Sets the amount of memory (GB) to be used by Spool on the disk. + - size_t + - ``128`` + + * - ``cachePartitions`` + - Generic + - Regular + - Sets the number of partitions that the cache is split into. + - size_t + - ``4`` + + + * - ``cachePersistentDir`` + - Generic + - Regular + - Sets the persistent directory location for the spool to save files on. + - string + - Any legal string + + + * - ``cachePersistentGB`` + - Generic + - Regular + - Sets the amount of data (GB) for the cache to store persistently. + - size_t + - ``128`` + + + * - ``cacheRamGB`` + - Generic + - Regular + - Sets the amount of memory (GB) to be used by Spool InMemory. + - size_t + - ``16`` + + + + * - ``checkCudaMemory`` + - Admin + - Regular + - Sets the pad device memory allocations with safety buffers to catch out-of-bounds writes. + - boolean + - ``FALSE`` + + * - ``compilerGetsOnlyUFs`` + - Admin + - Regular + - Sets the runtime to pass only utility functions names to the compiler. + - boolean + - ``FALSE`` + + * - ``copyToRestrictUtf8`` + - Admin + - Regular + - Sets the custom bin size in the cache to enable high granularity bin control. + - boolean + - ``FALSE`` + + * - ``cpuReduceHashtableSize`` + - Admin + - Regular + - Sets the hash table size of the CpuReduce. + - uint + - ``10000`` + + * - ``csvLimitRowLength`` + - Admin + - Cluster + - Sets the maximum supported CSV row length. + - uint + - ``100000`` + + * - ``cudaMemcpyMaxSizeBytes`` + - Admin + - Regular + - Sets the chunk size for copying from CPU to GPU. If set to 0, do not divide. + - uint + - ``0`` + + * - ``CudaMemcpySynchronous`` + - Admin + - Regular + - Indicates if copying from/to GPU is synchronous. + - boolean + - ``FALSE`` + + * - ``cudaMemQuota`` + - Admin + - Worker + - Sets the percentage of total device memory to be used by the instance. + - uint + - ``90`` + + * - ``developerMode`` + - Admin + - Regular + - Enables modifying R&D flags. + - boolean + - ``FALSE`` + + * - ``enableDeviceDebugMessages`` + - Admin + - Regular + - Activates the Nvidia profiler (nvprof) markers. + - boolean + - ``FALSE`` + + * - ``enableLogDebug`` + - Admin + - Regular + - Enables creating and logging in the clientLogger_debug file. + - boolean + - ``TRUE`` + + * - ``enableNvprofMarkers`` + - Admin + - Regular + - Activates the Nvidia profiler (nvprof) markers. + - boolean + - ``FALSE`` + + * - ``endLogMessage`` + - Admin + - Regular + - Appends a string at the end of every log line. + - string + - ``EOM`` + + + + + + + + * - ``extentStorageFileSizeMB`` + - Admin + - Cluster + - Sets the minimum size in mebibytes of extents for table bulk data. + - uint + - ``20`` + + + * - ``externalTableBlobEstimate`` + - ? + - Regular + - ? + - ? + - ? + + + + + + * - ``flipJoinOrder`` + - Generic + - Regular + - Reorders join to force equijoins and/or equijoins sorted by table size. + - boolean + - ``FALSE`` + + + + * - ``gatherMemStat`` + - Admin + - Regular + - Monitors all pinned allocations and all **memcopies** to/from device, and prints a report of pinned allocations that were not memcopied to/from the device using the **dump_pinned_misses** utility function. + - boolean + - ``FALSE`` + + + * - ``healerMaxInactivityHours`` + - Admin + - Worker + - Defines the threshold for creating a log recording a slow statement. + - size_t + - ``5`` + + + + + * - ``increaseChunkSizeBeforeReduce`` + - Admin + - Regular + - Increases the chunk size to reduce query speed. + - boolean + - ``FALSE`` + + * - ``increaseMemFactors`` + - Admin + - Regular + - Adds rechunker before expensive chunk producer. + - boolean + - ``TRUE`` + + + * - ``isHealerOn`` + - Admin + - Worker + - Periodically examines the progress of running statements and logs statements exceeding the ``healerMaxInactivityHours`` flag setting. + - boolean + - ``TRUE`` + + + + + + * - ``leveldbWriteBufferSize`` + - Admin + - Regular + - Sets the buffer size. + - uint + - ``524288`` + + * - ``limitQueryMemoryGB`` + - Generic + - Worker + - Prevents a query from processing more memory than the flag’s value. + - uint + - ``100000`` + + + + + * - ``loginMaxRetries`` + - Admin + - Worker + - Sets the permitted log-in attempts. + - size_t + - ``5`` + + + + * - ``logSysLevel`` + - Generic + - Regular + - + Determines the client log level: + 0 - L_SYSTEM, + 1 - L_FATAL, + 2 - L_ERROR, + 3 - L_WARN, + 4 - L_INFO, + 5 - L_DEBUG, + 6 - L_TRACE + - uint + - ``100000`` + + + + + + * - ``machineIP`` + - Admin + - Worker + - Manual setting of reported IP. + - string + - ``127.0.0.1`` + + + * - ``maxAvgBlobSizeToCompressOnGpu`` + - Generic + - Regular + - Sets the CPU to compress columns with size above (flag’s value) * (row count). + - uint + - ``120`` + + + * - ``maxPinnedPercentageOfTotalRAM`` + - Admin + - Regular + - Sets the maximum percentage CPU RAM that pinned memory can use. + - uint + - ``70`` + + + + * - ``memMergeBlobOffsetsCount`` + - Admin + - Regular + - Sets the size of memory used during a query to trigger aborting the server. + - uint + - ``0`` + + + + * - ``memoryResetTriggerMB`` + - Admin + - Regular + - Sets the size of memory used during a query to trigger aborting the server. + - uint + - ``0`` + + * - ``metadataServerPort`` + - Admin + - Worker + - Sets the port used to connect to the metadata server. SQream recommends using port ranges above 1024† because ports below 1024 are usually reserved, although there are no strict limitations. Any positive number (1 - 65535) can be used. + - uint + - ``3105`` + + * - ``mtRead`` + - Admin + - Regular + - Splits large reads to multiple smaller ones and executes them concurrently. + - boolean + - ``FALSE`` + + * - ``mtReadWorkers`` + - Admin + - Regular + - Sets the number of workers to handle smaller concurrent reads. + - uint + - ``30`` + + * - ``orcImplicitCasts`` + - Admin + - Regular + - Sets the implicit cast in orc files, such as **int** to **tinyint** and vice versa. + - boolean + - ``TRUE`` + + + * - ``sessionTag`` + - Generic + - Regular + - Sets the name of the session tag. + - string + - Any legal string + + + + * - ``spoolMemoryGB`` + - Generic + - Regular + - Sets the amount of memory (GB) to be used by the server for spooling. + - uint + - ``8`` + + + * - ``statementLockTimeout`` + - Admin + - Regular + - Sets the timeout (seconds) for acquiring object locks before executing statements. + - uint + - ``3`` + + * - ``useConfigIP`` + - Admin + - Worker + - Activates the machineIP (true). Setting to false ignores the machineIP and automatically assigns a local network IP. This cannot be activated in a cloud scenario (on-premises only). + - boolean + - ``FALSE`` + + * - ``useLegacyDecimalLiterals`` + - Admin + - Regular + - Interprets decimal literals as **Double** instead of **Numeric**. Used to preserve legacy behavior in existing customers. + - boolean + - ``FALSE`` + + * - ``useLegacyStringLiterals`` + - Admin + - Regular + - Interprets ASCII-only strings as **VARCHAR** instead of **TEXT**. Used to preserve legacy behavior in existing customers. + - boolean + - ``FALSE`` + + + + + + + + + + * - ``varcharIdentifiers`` + - Admin + - Regular + - Activates using varchar as an identifier. + - boolean + - ``true`` \ No newline at end of file diff --git a/configuration_guides/current_method_command_examples.rst b/configuration_guides/current_method_command_examples.rst new file mode 100644 index 000000000..2f75a4711 --- /dev/null +++ b/configuration_guides/current_method_command_examples.rst @@ -0,0 +1,36 @@ +.. _current_method_command_examples: + +************************** +Command Examples +************************** +This section includes the following command examples: + +.. contents:: + :local: + :depth: 1 + +Running a Regular Flag Type Command +--------------------- +The following is an example of running a **Regular** flag type command: + +.. code-block:: console + + SET spoolMemoryGB= 11; + executed + +Running a Worker Flag Type Command +--------------------- +The following is an example of running a **Worker** flag type command: + +.. code-block:: console + + SHOW spoolMemoryGB; + +Running a Cluster Flag Type Command +--------------------- +The following is an example of running a **Cluster** flag type command: + +.. code-block:: console + + ALTER SYSTEM RESET useMetadataServer; + executed \ No newline at end of file diff --git a/configuration_guides/current_method_configuration_levels.rst b/configuration_guides/current_method_configuration_levels.rst new file mode 100644 index 000000000..47ccf32b3 --- /dev/null +++ b/configuration_guides/current_method_configuration_levels.rst @@ -0,0 +1,33 @@ +.. _current_method_configuration_levels: + +************************** +Configuration Levels +************************** +SQream's configuration parameters are based on the following hierarchy: + +.. contents:: + :local: + :depth: 1 + +Cluster-Based Configuration +-------------- +Cluster-based configuration lets you centralize configurations for all workers on the cluster. Only Regular and Cluster flag types can be modified on the cluster level. These modifications are persistent and stored at the metadata level, which are applied globally to all workers in the cluster. + +.. note:: While cluster-based configuration was designed for configuring Workers, you can only configure Worker values set to the Regular or Cluster type. + +Worker-Based Configuration +-------------- +Worker-based configuration lets you modify the configuration belong to individual workers from the worker configuration file. + +For more information on making configurations from the worker configuration file, see `Modifying Your Configuration Using a Legacy Configuration File `_. + +Session-Based Configuration +-------------- +Session-based configurations are not persistent and are deleted when your session ends. This method enables you to modify all required configurations while avoiding conflicts between flag attributes modified on different devices at different points in time. The **SET flag_name** command is used to modify flag values on the session level. Any modifications you make with the **SET flag_name** command apply only to your open session, and are not saved when it ends. + +For example, when the query below has completed executing, the values configured will be restored to its previous setting: + +.. code-block:: console + + set spoolMemoryGB=700; + select * from table a where date='2021-11-11' \ No newline at end of file diff --git a/configuration_guides/current_method_configuration_roles.rst b/configuration_guides/current_method_configuration_roles.rst new file mode 100644 index 000000000..11b7e4bfb --- /dev/null +++ b/configuration_guides/current_method_configuration_roles.rst @@ -0,0 +1,17 @@ +.. _current_method_configuration_roles: + +************************** +Configuration Roles +************************** +SQream divides flags into the following roles, each with their own set of permissions: + +* :ref:`admin_flags` - can be modified by administrators on a session and cluster basis using the ``ALTER SYSTEM SET`` command: **Comment** - *I don't think we need to mention the command here, as it's described below, and also not mentioned for Generic Flags.* + + * Regular + * Worker + * Cluster + +* :ref:`generic_flags` - can be modified by standard users on a session basis: + + * Regular + * Worker \ No newline at end of file diff --git a/configuration_guides/current_method_configuring_your_parameter_values.rst b/configuration_guides/current_method_configuring_your_parameter_values.rst new file mode 100644 index 000000000..d082db693 --- /dev/null +++ b/configuration_guides/current_method_configuring_your_parameter_values.rst @@ -0,0 +1,40 @@ +.. _current_method_configuring_your_parameter_values: + +************************** +Configuring Your Parameter Values +************************** +The method you must use to configure your parameter values depends on the configuration level. Each configuration level has its own command or set of commands used to configure values, as shown below: + ++-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| **Configuration Level** | ++=================================================================================================================================================================================================================================================================================================================+ +| **Regular, Worker, and Cluster** | ++-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ +| **Command** | **Description** | **Example** | ++-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ +| ``SET `` | Used for modifying flag attributes. | ``SET developerMode=true`` | ++-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ +| ``SHOW / ALL`` | Used to preset either a specific flag value or all flag values. | ``SHOW `` | ++-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ +| ``SHOW ALL LIKE`` | Used as a wildcard character for flag names. | ``SHOW `` | ++-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ +| ``show_conf_UF`` | Used to print all flags with the following attributes: | ``rechunkThreshold,90,true,RND,regular`` | +| | | | +| | * Flag name | | +| | * Default value | | +| | * Is Developer Mode (Boolean) | | +| | * Flag category | | +| | * Flag type | | ++-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ +| ``show_conf_extended UF`` | Used to print all information output by the show_conf UF command, in addition to description, usage, data type, default value and range. | ``rechunkThreshold,90,true,RND,regular`` | ++-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ +| ``show_md_flag UF`` | Used to show a specific flag/all flags stored in the metadata file. |* Example 1: ``* master=> ALTER SYSTEM SET heartbeatTimeout=111;`` | +| | |* Example 2: ``* master=> select show_md_flag(‘all’); heartbeatTimeout,111`` | +| | |* Example 3: ``* master=> select show_md_flag(‘heartbeatTimeout’); heartbeatTimeout,111`` | ++-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ +| **Worker and Cluster** | ++-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ +| ``ALTER SYSTEM SET `` | Used for storing or modifying flag attributes in the metadata file. | ``ALTER SYSTEM SET `` | ++-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ +| ``ALTER SYSTEM RESET `` | Used to remove a flag or all flag attributes from the metadata file. | ``ALTER SYSTEM RESET `` | ++-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ \ No newline at end of file diff --git a/configuration_guides/current_method_flag_types.rst b/configuration_guides/current_method_flag_types.rst new file mode 100644 index 000000000..b1bedecba --- /dev/null +++ b/configuration_guides/current_method_flag_types.rst @@ -0,0 +1,20 @@ +.. _current_method_flag_types: + +************************** +Flag Types +************************** +SQream uses three flag types, **Cluster**, **Worker**, and **Regular**. Each of these flag types is associated with one of three hierarchical configuration levels described earlier, making it easier to configure your system. + +The highest level in the hierarchy is Cluster, which lets you set configurations across all workers in a given cluster. Modifying cluster values is **persistent**, meaning that any configurations you set are retained after shutting down your system. Configurations set at the Cluster level take the highest priority and override settings made on the Regular and Worker level **Comment** - *Confirm*. This is known as **cluster-based configuration**. Note that Cluster-based configuration lets you modify Cluster *and* Regular flag types. An example of a Cluster flag is **persisting your cache directory.** + +The second level is Worker, which lets you configure individual workers. Modifying Worker values are also **persistent**. This is known as **worker-based configuration**. Some examples of Worker flags includes **setting total device memory usage** and **setting metadata server connection port**. + +The lowest level is Regular, which means that modifying values of Regular flags affects only your current session and are not persistent. This means that they are automatically restored to their default value when the session ends. This is known as **session-based configuration**. Some examples of Regular flags includes **setting your bin size** and **setting CUDA memory**. + +To see each flag's default value, see one of the following: + +* The **Default Value** column in the :ref:`All Configurations` section. + + :: + +* The flag's individual description page, such as :ref:`Setting CUDA Memory`. \ No newline at end of file diff --git a/configuration_guides/current_method_modification_methods.rst b/configuration_guides/current_method_modification_methods.rst new file mode 100644 index 000000000..05825b07a --- /dev/null +++ b/configuration_guides/current_method_modification_methods.rst @@ -0,0 +1,50 @@ +.. _current_method_modification_methods: + +************************** +Modification Methods +************************** +SQream provides two different ways to modify your configurations. The current method is based on hierarchical configuration as described above. This method is based on making modifications on the **worker configuration file**, while you can still make modifications using the previous method using the **legacy configuration file**, both described below: + +.. contents:: + :local: + :depth: 1 + +Modifying Your Configuration Using the Worker Configuration File +------------------- +You can modify your configuration using the **worker configuration file (config.json)**. Changes that you make to worker configuration files are persistent. Note that you can only set the attributes in your worker configuration file **before** initializing your SQream worker, and while your worker is active these attributes are read-only. + +The following is an example of a worker configuration file: + +.. code-block:: postgres + + { + “cluster”: “/home/test_user/sqream_testing_temp/sqreamdb”, + “gpu”: 0, + “licensePath”: “home/test_user/SQream/tests/license.enc”, + “machineIP”: “127.0.0.1”, + “metadataServerIp”: “127.0.0.1”, + “metadataServerPort”: “3105, + “port”: 5000, + “useConfigIP”” true, + “legacyConfigFilePath”: “home/SQream_develop/SqrmRT/utils/json/legacy_congif.json” + } + +You can access the legacy configuration file from the ``legacyConfigFilePath`` parameter shown above. If all (or most) of your workers require the same flag settings, you can set the ``legacyConfigFilePath`` attribute to the same legacy file. + +Modifying Your Configuration Using a Legacy Configuration File +--------------------- +You can modify your configuration using a legacy configuration file. + +The Legacy configuration file provides access to the read/write flags used in SQream’s previous configuration method. A link to this file is provided in the **legacyConfigFilePath** parameter in the worker configuration file. + +The following is an example of the legacy configuration file: + +.. code-block:: postgres + + { + “developerMode”: true, + “reextentUse”: false, + “useClientLog”: true, + “useMetadataServer”” false + } +For more information on using the previous configuration method, see :ref:`previous_configuration_method`. \ No newline at end of file diff --git a/configuration_guides/current_method_showing_all_flags_in_the_catalog_table.rst b/configuration_guides/current_method_showing_all_flags_in_the_catalog_table.rst new file mode 100644 index 000000000..647a401b6 --- /dev/null +++ b/configuration_guides/current_method_showing_all_flags_in_the_catalog_table.rst @@ -0,0 +1,21 @@ +.. _current_method_showing_all_flags_in_the_catalog_table: + +************************** +Showing All Flags in the Catalog Table +************************** +SQream uses the **sqream_catalog.parameters** catalog table for showing all flags, providing the scope (default, cluster and session), description, default value and actual value. + +The following is the correct syntax for a catalog table query: + +.. code-block:: console + + SELECT * FROM sqream_catalog.settings + +The following is an example of a catalog table query: + +.. code-block:: console + + externalTableBlobEstimate, 100, 100, default, + varcharEncoding, ascii, ascii, default, Changes the expected encoding for Varchar columns + useCrcForTextJoinKeys, true, true, default, + hiveStyleImplicitStringCasts, false, false, default, \ No newline at end of file diff --git a/configuration_guides/index.rst b/configuration_guides/index.rst index 6a65853f0..6805bc188 100644 --- a/configuration_guides/index.rst +++ b/configuration_guides/index.rst @@ -11,8 +11,6 @@ The **Configuration Guides** page describes the following configuration informat :glob: spooling - configuration_methods + configuring_sqream configuration_flags - - - + previous_configuration_method \ No newline at end of file diff --git a/releases/2022.1.2.rst b/releases/2022.1.2.rst index b3ff083e9..385216c21 100644 --- a/releases/2022.1.2.rst +++ b/releases/2022.1.2.rst @@ -56,6 +56,8 @@ The following table lists the issues that were resolved in Version 2022.1.2: +-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ | **SQ No.** | **Description** | +=============+===========================================================================================================================================+ +| SQ-10892 | An incorrect error message was displayed when users ran the ``UPDATE`` command on foreign tables. | ++-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ | SQ-11273 | Clustering ``partial-partial`` optimization only occurs when copying data from CSV files. | +-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ | SQ-11291 | Metadata filters were not applied when using the ``LIKE`` function, causing certain queries to run on full tables instead of sorted data. | From bf59f8c7aff5844f4092acbb7be64db20047dbbb Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 21 Aug 2022 12:24:14 +0300 Subject: [PATCH 227/882] Studio 5.4.7 --- index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.rst b/index.rst index efeecb8e2..d6a37d4f7 100644 --- a/index.rst +++ b/index.rst @@ -104,7 +104,7 @@ If you're looking for an older version of the documentation, versions 1.10 throu loading_and_unloading_data/index feature_guides/index operational_guides/index - sqream_studio_5.4.6/index + sqream_studio_5.4.7/index architecture/index configuration_guides/index reference/index From 4fbc81d46972ec6a81c966d69b5aed353174c2df Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 21 Aug 2022 12:26:01 +0300 Subject: [PATCH 228/882] Studio 5.4.7 --- ...ing_and_managing_roles_and_permissions.rst | 12 ++-- ...ts_and_running_queries_from_the_editor.rst | 60 +++++++++---------- sqream_studio_5.4.7/getting_started.rst | 6 +- sqream_studio_5.4.7/index.rst | 4 +- sqream_studio_5.4.7/viewing_logs.rst | 32 +++++----- 5 files changed, 57 insertions(+), 57 deletions(-) diff --git a/sqream_studio_5.4.7/creating_assigning_and_managing_roles_and_permissions.rst b/sqream_studio_5.4.7/creating_assigning_and_managing_roles_and_permissions.rst index 9f0f7f39a..31ff716cb 100644 --- a/sqream_studio_5.4.7/creating_assigning_and_managing_roles_and_permissions.rst +++ b/sqream_studio_5.4.7/creating_assigning_and_managing_roles_and_permissions.rst @@ -1,6 +1,6 @@ .. _creating_assigning_and_managing_roles_and_permissions: -.. _roles_5.4.3: +.. _roles_5.4.7: **************************** Creating, Assigning, and Managing Roles and Permissions @@ -32,7 +32,7 @@ The **Type** column displays one of the following assigned role types: .. note:: If you disable a password, when you enable it you have to create a new one. -:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` +:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` Viewing Information About a Role @@ -49,7 +49,7 @@ Clicking a role in the roles table displays the following information: * **Permissions** - displays the role's permissions. The arrow indicates the permissions that the role has inherited. Hovering over a permission displays the roles that the permission is inherited from. -:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` +:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` Creating a New Role @@ -73,7 +73,7 @@ From the New Role panel you view directly and indirectly (or inherited) granted When adding a new role, you must select the **Enable login for this role** and **Has password** check boxes. -:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` +:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` Editing a Role -------------------- @@ -89,10 +89,10 @@ Once you've created a role, clicking the **Edit Role** button lets you do the fo From the Edit Role panel you view directly and indirectly (or inherited) granted permissions. Disabled permissions have no connect permissions for the referenced database and are displayed in gray text. You can add or remove permissions from the **Add permissions** field. From the Edit Role panel you can also search and scroll through the permissions. In the **Search** field you can use the **and** operator to search for strings that fulfill multiple criteria. -:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` +:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` Deleting a Role ----------------- Clicking the **delete** icon displays a confirmation message with the amount of users and groups that will be impacted by deleting the role. -:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` \ No newline at end of file +:ref:`Back to Creating, Assigning, and Managing Roles and Permissions` \ No newline at end of file diff --git a/sqream_studio_5.4.7/executing_statements_and_running_queries_from_the_editor.rst b/sqream_studio_5.4.7/executing_statements_and_running_queries_from_the_editor.rst index 0a298fdbf..882b226e0 100644 --- a/sqream_studio_5.4.7/executing_statements_and_running_queries_from_the_editor.rst +++ b/sqream_studio_5.4.7/executing_statements_and_running_queries_from_the_editor.rst @@ -1,6 +1,6 @@ .. _executing_statements_and_running_queries_from_the_editor: -.. _editor_top_5.4.3: +.. _editor_top_5.4.7: **************************** Executing Statements and Running Queries from the Editor @@ -23,23 +23,23 @@ The following is a brief description of the Editor panels: - Element - Description * - 1 - - :ref:`Toolbar` + - :ref:`Toolbar` - Used to select the active database you want to work on, limit the number of rows, save query, etc. * - 2 - - :ref:`Database Tree and System Queries panel` + - :ref:`Database Tree and System Queries panel` - Shows a hierarchy tree of databases, views, tables, and columns * - 3 - - :ref:`Statement panel` + - :ref:`Statement panel` - Used for writing queries and statements * - 4 - - :ref:`Results panel` + - :ref:`Results panel` - Shows query results and execution information. -.. _top_5.4.3: +.. _top_5.4.7: -.. _studio_5.4.3_editor_toolbar: +.. _studio_5.4.7_editor_toolbar: Executing Statements from the Toolbar ================ @@ -76,10 +76,10 @@ You can access the following from the Toolbar pane: For more information on stopping active statements, see the :ref:`STOP_STATEMENT` command. -:ref:`Back to Executing Statements and Running Queries from the Editor` +:ref:`Back to Executing Statements and Running Queries from the Editor` -.. _studio_5.4.3_editor_db_tree: +.. _studio_5.4.7_editor_db_tree: Performing Statement-Related Operations from the Database Tree ================ @@ -204,7 +204,7 @@ The database object functions are used to perform the following: * - Table DDL - Generates a DDL statement for the selected object in the editing area. To get the entire database DDL, click the |icon-ddl-edit| icon next to the database name in the tree root. See `Seeing System Objects as DDL `_. * - DDL Optimizer - - The `DDL Optimizer `_ lets you analyze database tables and recommends possible optimizations. + - The `DDL Optimizer `_ lets you analyze database tables and recommends possible optimizations. Optimizing Database Tables Using the DDL Optimizer ----------------------- @@ -243,7 +243,7 @@ The **System Queries** panel lets you execute predefined queries and includes th Clicking an item pastes the query into the Statement pane, and you can undo a previous operation by pressing **Ctrl + Z**. -.. _studio_5.4.3_editor_statement_area: +.. _studio_5.4.7_editor_statement_area: Writing Statements and Queries from the Statement Panel ============== @@ -288,13 +288,13 @@ You can also rename the default tab name by double-clicking it and typing a new .. :kbd:`Ctrl` + :kbd:`↓` - Switch to previous tab -.. _studio_editor_results_5.4.3: +.. _studio_editor_results_5.4.7: -:ref:`Back to Executing Statements and Running Queries from the Editor` +:ref:`Back to Executing Statements and Running Queries from the Editor` -.. _studio_5.4.3_editor_results: +.. _studio_5.4.7_editor_results: -.. _results_panel_5.4.3: +.. _results_panel_5.4.7: Viewing Statement and Query Results from the Results Panel ============== @@ -310,17 +310,17 @@ The following is a brief description of the Results panel views highlighted in t * - Element - Description - * - :ref:`Results view` + * - :ref:`Results view` - Lets you view search query results. - * - :ref:`Execution Details view` + * - :ref:`Execution Details view` - Lets you analyze your query for troubleshooting and optimization purposes. - * - :ref:`SQL view` + * - :ref:`SQL view` - Lets you see the SQL view. -.. _results_view_5.4.3: +.. _results_view_5.4.7: -:ref:`Back to Executing Statements and Running Queries from the Editor` +:ref:`Back to Executing Statements and Running Queries from the Editor` Searching Query Results in the Results View ---------------- @@ -338,7 +338,7 @@ Saving Results to the Clipboard ^^^^^^^^^^^^ The **Save results to clipboard** function lets you save your results to the clipboard to paste into another text editor or into Excel for further analysis. -.. _save_results_to_local_file_5.4.3: +.. _save_results_to_local_file_5.4.7: Saving Results to a Local File ^^^^^^^^^^^^ @@ -346,7 +346,7 @@ The **Save results to local file** functions lets you save your search query res In the Results view you can also run parallel statements, as described in **Running Parallel Statements** below. -.. _running_parallel_statements_5.4.3: +.. _running_parallel_statements_5.4.7: Running Parallel Statements ^^^^^^^^^^^^ @@ -364,11 +364,11 @@ The following shows the syntax for running parallel statements: $ $$ -:ref:`Back to Viewing Statement and Query Results from the Results Panel` +:ref:`Back to Viewing Statement and Query Results from the Results Panel` -.. _execution_details_view_5.4.3: +.. _execution_details_view_5.4.7: -.. _execution_tree_5.4.3: +.. _execution_tree_5.4.7: Execution Details View -------------- @@ -477,16 +477,16 @@ This can be seen in the **timeSum** column as follows: * **Rows highlighted orange** - medium runtime * **Rows highlighted yellow** - shortest runtime -:ref:`Back to Viewing Statement and Query Results from the Results Panel` +:ref:`Back to Viewing Statement and Query Results from the Results Panel` -.. _sql_view_5.4.3: +.. _sql_view_5.4.7: Viewing Wrapped Strings in the SQL View ------------------ The SQL View panel allows you to more easily view certain queries, such as a long string that appears on one line. The SQL View makes it easier to see by wrapping it so that you can see the entire string at once. It also reformats and organizes query syntax entered in the Statement panel for more easily locating particular segments of your queries. The SQL View is identical to the **Format SQL** feature in the Toolbar, allowing you to retain your originally constructed query while viewing a more intuitively structured snapshot of it. -.. _save_results_to_clipboard_5.4.3: +.. _save_results_to_clipboard_5.4.7: -:ref:`Back to Viewing Statement and Query Results from the Results Panel` +:ref:`Back to Viewing Statement and Query Results from the Results Panel` -:ref:`Back to Executing Statements and Running Queries from the Editor` +:ref:`Back to Executing Statements and Running Queries from the Editor` diff --git a/sqream_studio_5.4.7/getting_started.rst b/sqream_studio_5.4.7/getting_started.rst index 7f401f5fa..21d9348c0 100644 --- a/sqream_studio_5.4.7/getting_started.rst +++ b/sqream_studio_5.4.7/getting_started.rst @@ -1,7 +1,7 @@ .. _getting_started: **************************** -Getting Started with SQream Acceleration Studio 5.4.3 +Getting Started with SQream Acceleration Studio 5.4.7 **************************** Setting Up and Starting Studio ---------------- @@ -56,6 +56,6 @@ By clicking the user icon, you can also use it for logging out and viewing the f * License storage capacity * Log out -.. _back_to_dashboard_5.4.3: +.. _back_to_dashboard_5.4.7: -.. _studio_dashboard_5.4.3: +.. _studio_dashboard_5.4.7: diff --git a/sqream_studio_5.4.7/index.rst b/sqream_studio_5.4.7/index.rst index d98df64d5..d57789b49 100644 --- a/sqream_studio_5.4.7/index.rst +++ b/sqream_studio_5.4.7/index.rst @@ -3,9 +3,9 @@ ********************************** SQream Acceleration Studio ********************************** -The SQream Acceleration Studio 5.4.3 is a web-based client for use with SQream. Studio provides users with all functionality available from the command line in an intuitive and easy-to-use format. This includes running statements, managing roles and permissions, and managing SQream clusters. +The SQream Acceleration Studio 5.4.7 is a web-based client for use with SQream. Studio provides users with all functionality available from the command line in an intuitive and easy-to-use format. This includes running statements, managing roles and permissions, and managing SQream clusters. -This section describes how to use the SQream Accleration Studio version 5.4.3: +This section describes how to use the SQream Accleration Studio version 5.4.7: .. toctree:: :maxdepth: 1 diff --git a/sqream_studio_5.4.7/viewing_logs.rst b/sqream_studio_5.4.7/viewing_logs.rst index 7f98bea5e..c4e4b73a3 100644 --- a/sqream_studio_5.4.7/viewing_logs.rst +++ b/sqream_studio_5.4.7/viewing_logs.rst @@ -1,6 +1,6 @@ .. _viewing_logs: -.. _logs_top_5.4.3: +.. _logs_top_5.4.7: **************************** Viewing Logs @@ -13,19 +13,19 @@ The **Logs** screen is used for viewing logs and includes the following elements * - Element - Description - * - :ref:`Filter area` + * - :ref:`Filter area` - Lets you filter the data shown in the table. - * - :ref:`Query tab` + * - :ref:`Query tab` - Shows basic query information logs, such as query number and the time the query was run. - * - :ref:`Session tab` + * - :ref:`Session tab` - Shows basic session information logs, such as session ID and user name. - * - :ref:`System tab` + * - :ref:`System tab` - Shows all system logs. - * - :ref:`Log lines tab` + * - :ref:`Log lines tab` - Shows the total amount of log lines. -.. _filter_5.4.3: +.. _filter_5.4.7: Filtering Table Data ------------- @@ -41,9 +41,9 @@ Other filters require you to select an item from a dropdown menu: You can also export a record of all of your currently filtered logs in Excel format by clicking **Download** located above the Filter area. -.. _queries_5.4.3: +.. _queries_5.4.7: -:ref:`Back to Viewing Logs` +:ref:`Back to Viewing Logs` Viewing Query Logs @@ -62,9 +62,9 @@ From the Queries area you can see and sort by the following: In the Queries table, you can click on the **Statement ID** and **Query** items to set them as your filters. In the **Details** column you can also access additional details by clicking one of the **Details** options for a more detailed explanation of the query. -:ref:`Back to Viewing Logs` +:ref:`Back to Viewing Logs` -.. _sessions_5.4.3: +.. _sessions_5.4.7: Viewing Session Logs ---------- @@ -82,9 +82,9 @@ From here you can see and sort by the following: In the Sessions table, you can click on the **Timestamp**, **Connection ID**, and **Username** items to set them as your filters. -:ref:`Back to Viewing Logs` +:ref:`Back to Viewing Logs` -.. _system_5.4.3: +.. _system_5.4.7: Viewing System Logs ---------- @@ -98,9 +98,9 @@ From here you can see and sort by the following: In the Systems table, you can click on the **Timestamp** and **Log type** items to set them as your filters. In the **Message** column, you can also click on an item to show more information about the message. -:ref:`Back to Viewing Logs` +:ref:`Back to Viewing Logs` -.. _log_lines_5.4.3: +.. _log_lines_5.4.7: Viewing All Log Lines ---------- @@ -119,4 +119,4 @@ From here you can see and sort by the following: In the **LOG LINES** table, you can click on any of the items to set them as your filters. -:ref:`Back to Viewing Logs` \ No newline at end of file +:ref:`Back to Viewing Logs` \ No newline at end of file From 13261d752364c298c848b73f9f2397f4164ad217 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Sun, 21 Aug 2022 17:04:11 +0300 Subject: [PATCH 229/882] Changed title to 5.4.7 --- sqream_studio_5.4.7/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sqream_studio_5.4.7/index.rst b/sqream_studio_5.4.7/index.rst index d57789b49..17c7ae05c 100644 --- a/sqream_studio_5.4.7/index.rst +++ b/sqream_studio_5.4.7/index.rst @@ -1,7 +1,7 @@ .. _sqream_studio_: ********************************** -SQream Acceleration Studio +SQream Acceleration Studio 5.4.7 ********************************** The SQream Acceleration Studio 5.4.7 is a web-based client for use with SQream. Studio provides users with all functionality available from the command line in an intuitive and easy-to-use format. This includes running statements, managing roles and permissions, and managing SQream clusters. From 5bb47aaef6c231fbcacb9572eb1d65014e6123ae Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Mon, 22 Aug 2022 17:43:10 +0300 Subject: [PATCH 230/882] Absolute links --- releases/2022.1.2.rst | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/releases/2022.1.2.rst b/releases/2022.1.2.rst index 385216c21..8f7fcc8f6 100644 --- a/releases/2022.1.2.rst +++ b/releases/2022.1.2.rst @@ -35,7 +35,7 @@ Automatic Foreign Table DDL Resolution ************ When mapping external files to foreign tables, SQream now automatically identifies the required schema. This is especially useful for Parquet files, which include built-in schema declarations. -For more information, see :ref:`automatic_foreign_table_ddl_resolution`. +For more information, see `Automatic Foreign Table DDL Resolution `_. Enhanced Automatic Adaptive Compression ************ @@ -43,11 +43,11 @@ SQream's automatic adaptive compression has been enhanced with new compression m .. note:: The compression ratio depends on the nature of the compressed data and on other variables, such as ordering, cardinality and data types. -For more information, navigate to the **Compression Methods** table on the :ref:`compression` page. +For more information, navigate to the **Compression Methods** table on the `Compression `_ page. Parquet Read Optimization ************ -SQream now supports storing and running queries on data located on external Parquet files. For more information, see :ref:`parquet`. +SQream now supports storing and running queries on data located on external Parquet files. For more information, see `Inserting Data from a Parquet File `_. Resolved Issues --------- @@ -60,10 +60,6 @@ The following table lists the issues that were resolved in Version 2022.1.2: +-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ | SQ-11273 | Clustering ``partial-partial`` optimization only occurs when copying data from CSV files. | +-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11291 | Metadata filters were not applied when using the ``LIKE`` function, causing certain queries to run on full tables instead of sorted data. | -+-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ - -**Comment** - *Was SQ-11291 just removed?* Operations and Configuration Changes -------- From db8995e55df536c9c1fdeb62e0a4774d7bffa687 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Mon, 22 Aug 2022 17:59:29 +0300 Subject: [PATCH 231/882] Update parquet.rst --- data_ingestion/parquet.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data_ingestion/parquet.rst b/data_ingestion/parquet.rst index df09891d3..9a8e4c24b 100644 --- a/data_ingestion/parquet.rst +++ b/data_ingestion/parquet.rst @@ -11,7 +11,7 @@ This guide covers inserting data from Parquet files into SQream using :ref:`FORE Overview =================== -As described in **Inserting Data from a Parquet File** section, you can insert data into SQream from Parquet files. However, because it is an open-source column-oriented data storage format, you may want to retain your data on external Parquet files instead of inserting it into SQream. SQream supports executing queries on external Parquet files. +SQream supports inserting data into SQream from Parquet files. However, because it is an open-source column-oriented data storage format, you may want to retain your data on external Parquet files instead of inserting it into SQream. SQream supports executing queries on external Parquet files. Preparing Your Parquet Files ===================== From 242709e9e707ed47e80ce15a2fcf0bfa7d9cfd48 Mon Sep 17 00:00:00 2001 From: Ben Date: Tue, 23 Aug 2022 17:49:23 +0300 Subject: [PATCH 232/882] Corrected the 2022.1.2 release notes --- releases/2022.1.2.rst | 18 +++++++----------- 1 file changed, 7 insertions(+), 11 deletions(-) diff --git a/releases/2022.1.2.rst b/releases/2022.1.2.rst index 8f7fcc8f6..076da49d9 100644 --- a/releases/2022.1.2.rst +++ b/releases/2022.1.2.rst @@ -17,11 +17,11 @@ The 2022.1.2 Release Notes describes the following: :: -* Enhanced compression features. +* Added `zlib` compression. :: -* Support for external Parquet files. +* Optimized queries on external Parquet tables. New Features ---------- @@ -37,17 +37,13 @@ When mapping external files to foreign tables, SQream now automatically identifi For more information, see `Automatic Foreign Table DDL Resolution `_. -Enhanced Automatic Adaptive Compression +Added `zlib` compression ************ -SQream's automatic adaptive compression has been enhanced with new compression methods. This mechanism automatically uses the best compression method for each scenario, improving the compression ratio by approximately twice of that in Version 2022.1 - -.. note:: The compression ratio depends on the nature of the compressed data and on other variables, such as ordering, cardinality and data types. - -For more information, navigate to the **Compression Methods** table on the `Compression `_ page. +Added support for the `zlib` compression algorithm. For more information, navigate to the **Compression Methods** table on the `Compression `_ page. Parquet Read Optimization ************ -SQream now supports storing and running queries on data located on external Parquet files. For more information, see `Inserting Data from a Parquet File `_. +Querying Parquet foreign tables has been optimized and is now up to 20x faster than in previous versions. Resolved Issues --------- @@ -58,7 +54,7 @@ The following table lists the issues that were resolved in Version 2022.1.2: +=============+===========================================================================================================================================+ | SQ-10892 | An incorrect error message was displayed when users ran the ``UPDATE`` command on foreign tables. | +-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11273 | Clustering ``partial-partial`` optimization only occurs when copying data from CSV files. | +| SQ-11273 | Clustering optimization only occurs when copying data from CSV files. | +-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ Operations and Configuration Changes @@ -118,4 +114,4 @@ Upgrading to v2022.1.2 :glob: :hidden: - 2022.1.2 \ No newline at end of file + 2022.1.2 From 775cd692cd19fb5d1910250420b3646aec679c5c Mon Sep 17 00:00:00 2001 From: Ben Date: Tue, 23 Aug 2022 18:08:59 +0300 Subject: [PATCH 233/882] Removed mentions of zlib in 2022.1.2 Since it was already released in 2022.1.1 --- releases/2022.1.2.rst | 12 +++--------- 1 file changed, 3 insertions(+), 9 deletions(-) diff --git a/releases/2022.1.2.rst b/releases/2022.1.2.rst index 076da49d9..3a01464f0 100644 --- a/releases/2022.1.2.rst +++ b/releases/2022.1.2.rst @@ -17,10 +17,6 @@ The 2022.1.2 Release Notes describes the following: :: -* Added `zlib` compression. - - :: - * Optimized queries on external Parquet tables. New Features @@ -36,10 +32,6 @@ Automatic Foreign Table DDL Resolution When mapping external files to foreign tables, SQream now automatically identifies the required schema. This is especially useful for Parquet files, which include built-in schema declarations. For more information, see `Automatic Foreign Table DDL Resolution `_. - -Added `zlib` compression -************ -Added support for the `zlib` compression algorithm. For more information, navigate to the **Compression Methods** table on the `Compression `_ page. Parquet Read Optimization ************ @@ -54,7 +46,9 @@ The following table lists the issues that were resolved in Version 2022.1.2: +=============+===========================================================================================================================================+ | SQ-10892 | An incorrect error message was displayed when users ran the ``UPDATE`` command on foreign tables. | +-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11273 | Clustering optimization only occurs when copying data from CSV files. | +| SQ-11273 | Clustering optimization only occurs when copying data from CSV files. | ++-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11273 | Clustering optimization only occurs when copying data from CSV files. | +-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ Operations and Configuration Changes From 788b6edfe601c0e4147c890fe1e1ad97375e49b1 Mon Sep 17 00:00:00 2001 From: Ben Date: Tue, 23 Aug 2022 18:10:50 +0300 Subject: [PATCH 234/882] Fixed resolved issues table --- releases/2022.1.2.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/releases/2022.1.2.rst b/releases/2022.1.2.rst index 3a01464f0..aad45464c 100644 --- a/releases/2022.1.2.rst +++ b/releases/2022.1.2.rst @@ -48,8 +48,6 @@ The following table lists the issues that were resolved in Version 2022.1.2: +-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ | SQ-11273 | Clustering optimization only occurs when copying data from CSV files. | +-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11273 | Clustering optimization only occurs when copying data from CSV files. | -+-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ Operations and Configuration Changes -------- From 476eb971fa6fcf9134632f42fb77852db88849c6 Mon Sep 17 00:00:00 2001 From: Ben Date: Wed, 24 Aug 2022 16:36:27 +0300 Subject: [PATCH 235/882] Update JDBC version --- connecting_to_sqream/client_drivers/index.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index b230faaef..fb772853c 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -17,7 +17,7 @@ The following are applicable to all operating systems: * **JDBC** - recommended installation via ``mvn``: - * `JDBC .jar file `_ - sqream-jdbc-4.5.3 (.jar) + * `JDBC .jar file `_ - sqream-jdbc-4.5.4 (.jar) * `JDBC driver `_ .. _tableau_connector: @@ -81,4 +81,4 @@ If you couldn't find what you're looking for, we're always happy to help. Visit .. rubric:: Looking for older drivers? -If you're looking for an older version of SQream DB drivers, versions 1.10 through 2019.2.1 are available at https://sqream.com/product/client-drivers/. \ No newline at end of file +If you're looking for an older version of SQream DB drivers, versions 1.10 through 2019.2.1 are available at https://sqream.com/product/client-drivers/. From 0f01559929702ff0c6bbfd2b69ecc4fbbc1f0da3 Mon Sep 17 00:00:00 2001 From: Ben Date: Wed, 24 Aug 2022 16:38:59 +0300 Subject: [PATCH 236/882] Removed explicit mention of the auto schema feature --- releases/2022.1.2.rst | 6 ------ 1 file changed, 6 deletions(-) diff --git a/releases/2022.1.2.rst b/releases/2022.1.2.rst index aad45464c..a44d83d83 100644 --- a/releases/2022.1.2.rst +++ b/releases/2022.1.2.rst @@ -27,12 +27,6 @@ The 2022.1.2 Release Notes include the following new features: :local: :depth: 1 -Automatic Foreign Table DDL Resolution -************ -When mapping external files to foreign tables, SQream now automatically identifies the required schema. This is especially useful for Parquet files, which include built-in schema declarations. - -For more information, see `Automatic Foreign Table DDL Resolution `_. - Parquet Read Optimization ************ Querying Parquet foreign tables has been optimized and is now up to 20x faster than in previous versions. From 1165daf511033824c002c27750392bcb1b446709 Mon Sep 17 00:00:00 2001 From: Yaniv Gerowitz Date: Fri, 26 Aug 2022 13:27:54 -0700 Subject: [PATCH 237/882] Update 2022.1.2.rst --- releases/2022.1.2.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/2022.1.2.rst b/releases/2022.1.2.rst index a44d83d83..769bf60bc 100644 --- a/releases/2022.1.2.rst +++ b/releases/2022.1.2.rst @@ -100,4 +100,4 @@ Upgrading to v2022.1.2 :glob: :hidden: - 2022.1.2 + 2022.1.2 \ No newline at end of file From 0fc7ddda88024a4b91c6b7387b483c501e4aee4d Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Thu, 8 Sep 2022 08:24:11 +0300 Subject: [PATCH 238/882] Add 2022.1.3 RN page --- releases/2022.1.3.rst | 103 ++++++++++++++++++++++++++++++++++++++ releases/2022.1_index.rst | 1 + 2 files changed, 104 insertions(+) create mode 100644 releases/2022.1.3.rst diff --git a/releases/2022.1.3.rst b/releases/2022.1.3.rst new file mode 100644 index 000000000..769bf60bc --- /dev/null +++ b/releases/2022.1.3.rst @@ -0,0 +1,103 @@ +.. _2022.1.2: + +************************** +Release Notes 2022.1.2 +************************** +The 2022.1.2 release notes were released on 8/24/2022 and describe the following: + +.. contents:: + :local: + :depth: 1 + +Version Content +---------- +The 2022.1.2 Release Notes describes the following: + +* Automatic schema identification. + + :: + +* Optimized queries on external Parquet tables. + +New Features +---------- +The 2022.1.2 Release Notes include the following new features: + +.. contents:: + :local: + :depth: 1 + +Parquet Read Optimization +************ +Querying Parquet foreign tables has been optimized and is now up to 20x faster than in previous versions. + +Resolved Issues +--------- +The following table lists the issues that were resolved in Version 2022.1.2: + ++-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++=============+===========================================================================================================================================+ +| SQ-10892 | An incorrect error message was displayed when users ran the ``UPDATE`` command on foreign tables. | ++-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11273 | Clustering optimization only occurs when copying data from CSV files. | ++-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + +Operations and Configuration Changes +-------- +No configuration changes were made. + +Naming Changes +------- +No relevant naming changes were made. + +Deprecated Features +------- +No features were deprecated for Version 2022.1.2. + +End of Support +------- +The End of Support section is not relevant to Version 2022.1.2. + +Upgrading to v2022.1.2 +------- +1. Generate a back-up of the metadata by running the following command: + + .. code-block:: console + + $ select backup_metadata('out_path'); + + .. tip:: SQream recommends storing the generated back-up locally in case needed. + + SQream runs the Garbage Collector and creates a clean backup tarball package. + +2. Shut down all SQream services. + + :: + +3. Extract the recently created back-up file. + + :: + +4. Replace your current metadata with the metadata you stored in the back-up file. + + :: + +5. Navigate to the new SQream package bin folder. + + :: + +6. Run the following command: + + .. code-block:: console + + $ ./upgrade_storage + + .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version `_ procedure. + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2022.1.2 \ No newline at end of file diff --git a/releases/2022.1_index.rst b/releases/2022.1_index.rst index 5f53bcb38..beceab0b6 100644 --- a/releases/2022.1_index.rst +++ b/releases/2022.1_index.rst @@ -13,6 +13,7 @@ The 2022.1 Release Notes describe the following releases: :maxdepth: 1 :glob: + 2022.1.3 2022.1.2 2022.1.1 2022.1 \ No newline at end of file From cc7ff075f5b7c66cc672e704dfce80e669c5a040 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Thu, 8 Sep 2022 08:37:32 +0300 Subject: [PATCH 239/882] Update 2022.1.3.rst --- releases/2022.1.3.rst | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/releases/2022.1.3.rst b/releases/2022.1.3.rst index 769bf60bc..beeb68679 100644 --- a/releases/2022.1.3.rst +++ b/releases/2022.1.3.rst @@ -1,9 +1,9 @@ -.. _2022.1.2: +.. _2022.1.3: ************************** -Release Notes 2022.1.2 +Release Notes 2022.1.3 ************************** -The 2022.1.2 release notes were released on 8/24/2022 and describe the following: +The 2022.1.3 release notes were released on 9/8/2022 and describe the following: .. contents:: :local: @@ -11,7 +11,7 @@ The 2022.1.2 release notes were released on 8/24/2022 and describe the following Version Content ---------- -The 2022.1.2 Release Notes describes the following: +The 2022.1.3 Release Notes describes the following: * Automatic schema identification. @@ -21,7 +21,7 @@ The 2022.1.2 Release Notes describes the following: New Features ---------- -The 2022.1.2 Release Notes include the following new features: +The 2022.1.3 Release Notes include the following new features: .. contents:: :local: @@ -33,7 +33,7 @@ Querying Parquet foreign tables has been optimized and is now up to 20x faster t Resolved Issues --------- -The following table lists the issues that were resolved in Version 2022.1.2: +The following table lists the issues that were resolved in Version 2022.1.3: +-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ | **SQ No.** | **Description** | @@ -53,13 +53,13 @@ No relevant naming changes were made. Deprecated Features ------- -No features were deprecated for Version 2022.1.2. +No features were deprecated for Version 2022.1.3. End of Support ------- -The End of Support section is not relevant to Version 2022.1.2. +The End of Support section is not relevant to Version 2022.1.3. -Upgrading to v2022.1.2 +Upgrading to v2022.1.3 ------- 1. Generate a back-up of the metadata by running the following command: @@ -93,11 +93,11 @@ Upgrading to v2022.1.2 $ ./upgrade_storage - .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version `_ procedure. + .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version `_ procedure. .. toctree:: :maxdepth: 2 :glob: :hidden: - 2022.1.2 \ No newline at end of file + 2022.1.3 \ No newline at end of file From 3297854d25a65da7150bbbbb43d6aa60667cba75 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Thu, 8 Sep 2022 09:31:40 +0300 Subject: [PATCH 240/882] Update 2022.1.3.rst --- releases/2022.1.3.rst | 36 +++++++++++++++++++++++++++++------- 1 file changed, 29 insertions(+), 7 deletions(-) diff --git a/releases/2022.1.3.rst b/releases/2022.1.3.rst index beeb68679..37b9e90c6 100644 --- a/releases/2022.1.3.rst +++ b/releases/2022.1.3.rst @@ -13,11 +13,20 @@ Version Content ---------- The 2022.1.3 Release Notes describes the following: -* Automatic schema identification. +* Optimize the delete operation by removing redundant calls. :: -* Optimized queries on external Parquet tables. +* Support LIKE condition for filtering metadata. + + :: + +* Migration tool for converting VARCHAR columns into TEXT columns. + + :: + +* Support sub-queries in the UPDATE condition. + New Features ---------- @@ -27,9 +36,9 @@ The 2022.1.3 Release Notes include the following new features: :local: :depth: 1 -Parquet Read Optimization +Support sub-queries in the UPDATE condition ************ -Querying Parquet foreign tables has been optimized and is now up to 20x faster than in previous versions. +Update functionality has been enhanced to support sub-queries allowing to update table and / or columns based on other table and / or columns. Resolved Issues --------- @@ -38,9 +47,19 @@ The following table lists the issues that were resolved in Version 2022.1.3: +-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ | **SQ No.** | **Description** | +=============+===========================================================================================================================================+ -| SQ-10892 | An incorrect error message was displayed when users ran the ``UPDATE`` command on foreign tables. | +| SQ-11487 | COPY FROM with offset = 0 (which is an unsupported option) is stuck up to the query timeout. | ++-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11378 | Python connector fails to run multi threaded per one connection. | ++-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11373 | SQL statement fails after changing the foreign table the statement tries to query. | ++-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11320 | Locked users are not being released on system reset. | ++-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11310 | Using "create table like" on foreign tables results in flat compression of the created table. | ++-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ +| SQ-11287 | SQL User Defined Function declaration fails when UDF contains parenthesis. | +-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11273 | Clustering optimization only occurs when copying data from CSV files. | +| SQ-10892 | Update || enhanced error message when trying to run update on foreign table. | +-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ Operations and Configuration Changes @@ -57,7 +76,10 @@ No features were deprecated for Version 2022.1.3. End of Support ------- -The End of Support section is not relevant to Version 2022.1.3. +SQream is declaring end of support of VARCHAR data type, the decision resulted by SQream's effort to enhance its core functionalities and with respect to ever changing echo system requirements. +VARCHAR is no longer supported for new customers - effective immanently. +TEXT data type is replacing VARCHAR - SQream will maintain VARCHAR data type support until 09/30/2023. +As part of this release 2022.1.3, SQream provides an automated and secured migration tool to help customers with the conversion phase from VARCHAR to TEXT data type, please address delivery for further information. Upgrading to v2022.1.3 ------- From dbfeb529b16b61c4f0cf925126990ba228e2ee8e Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Thu, 8 Sep 2022 09:51:52 +0300 Subject: [PATCH 241/882] Update VARCHAR deprecation msg --- releases/2022.1.1.rst | 4 +++- releases/2022.1.2.rst | 4 +++- releases/2022.1.3.rst | 3 --- 3 files changed, 6 insertions(+), 5 deletions(-) diff --git a/releases/2022.1.1.rst b/releases/2022.1.1.rst index faec3add2..d5c76b361 100644 --- a/releases/2022.1.1.rst +++ b/releases/2022.1.1.rst @@ -63,7 +63,9 @@ No relevant naming changes were made. Deprecated Features ------- -No features were deprecated for Version 2022.1.1. +In SQream version 2022.1 the ``VARCHAR`` data type has been deprecated and replaced with ``TEXT``. SQream will maintain ``VARCHAR`` in all previous versions until completing the migration to ``TEXT``, at which point it will be deprecated in all earlier versions. SQream also provides an automated and secure tool to facilitate and simplify migration from ``VARCHAR`` to ``TEXT``. + +If you are using an earlier version of SQream, see the `Using Legacy String Literals `_ configuration flag. End of Support ------- diff --git a/releases/2022.1.2.rst b/releases/2022.1.2.rst index 769bf60bc..0c9a4f3b3 100644 --- a/releases/2022.1.2.rst +++ b/releases/2022.1.2.rst @@ -53,7 +53,9 @@ No relevant naming changes were made. Deprecated Features ------- -No features were deprecated for Version 2022.1.2. +In SQream version 2022.1 the ``VARCHAR`` data type has been deprecated and replaced with ``TEXT``. SQream will maintain ``VARCHAR`` in all previous versions until completing the migration to ``TEXT``, at which point it will be deprecated in all earlier versions. SQream also provides an automated and secure tool to facilitate and simplify migration from ``VARCHAR`` to ``TEXT``. + +If you are using an earlier version of SQream, see the `Using Legacy String Literals `_ configuration flag. End of Support ------- diff --git a/releases/2022.1.3.rst b/releases/2022.1.3.rst index 37b9e90c6..46199e037 100644 --- a/releases/2022.1.3.rst +++ b/releases/2022.1.3.rst @@ -32,9 +32,6 @@ New Features ---------- The 2022.1.3 Release Notes include the following new features: -.. contents:: - :local: - :depth: 1 Support sub-queries in the UPDATE condition ************ From aae33c7a9553fabd6cffe577e046353993c21fb0 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Thu, 8 Sep 2022 10:06:35 +0300 Subject: [PATCH 242/882] Update 2022.1.3.rst --- releases/2022.1.3.rst | 47 ++++++++++++++++++++++++------------------- 1 file changed, 26 insertions(+), 21 deletions(-) diff --git a/releases/2022.1.3.rst b/releases/2022.1.3.rst index 46199e037..fea508cb6 100644 --- a/releases/2022.1.3.rst +++ b/releases/2022.1.3.rst @@ -41,23 +41,25 @@ Resolved Issues --------- The following table lists the issues that were resolved in Version 2022.1.3: -+-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+=============+===========================================================================================================================================+ -| SQ-11487 | COPY FROM with offset = 0 (which is an unsupported option) is stuck up to the query timeout. | -+-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11378 | Python connector fails to run multi threaded per one connection. | -+-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11373 | SQL statement fails after changing the foreign table the statement tries to query. | -+-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11320 | Locked users are not being released on system reset. | -+-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11310 | Using "create table like" on foreign tables results in flat compression of the created table. | -+-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11287 | SQL User Defined Function declaration fails when UDF contains parenthesis. | -+-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10892 | Update || enhanced error message when trying to run update on foreign table. | -+-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ ++-------------+-------------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++=============+=================================================================================================+ +| SQ-11487 | COPY FROM with offset = 0 (which is an unsupported option) is stuck up to the query timeout. | ++-------------+-------------------------------------------------------------------------------------------------+ +| SQ-11378 | Python connector fails to run multi threaded per one connection. | ++-------------+-------------------------------------------------------------------------------------------------+ +| SQ-11373 | SQL statement fails after changing the foreign table the statement tries to query. | ++-------------+-------------------------------------------------------------------------------------------------+ +| SQ-11320 | Locked users are not being released on system reset. | ++-------------+-------------------------------------------------------------------------------------------------+ +| SQ-11310 | Using "create table like" on foreign tables results in flat compression of the created table. | ++-------------+-------------------------------------------------------------------------------------------------+ +| SQ-11287 | SQL User Defined Function declaration fails when UDF contains parenthesis. | ++-------------+-------------------------------------------------------------------------------------------------+ +| SQ-10892 | Update - enhanced error message when trying to run update on foreign table. | ++-------------+-------------------------------------------------------------------------------------------------+ + + Operations and Configuration Changes -------- @@ -69,15 +71,18 @@ No relevant naming changes were made. Deprecated Features ------- -No features were deprecated for Version 2022.1.3. - -End of Support -------- SQream is declaring end of support of VARCHAR data type, the decision resulted by SQream's effort to enhance its core functionalities and with respect to ever changing echo system requirements. + VARCHAR is no longer supported for new customers - effective immanently. + TEXT data type is replacing VARCHAR - SQream will maintain VARCHAR data type support until 09/30/2023. + As part of this release 2022.1.3, SQream provides an automated and secured migration tool to help customers with the conversion phase from VARCHAR to TEXT data type, please address delivery for further information. +End of Support +------- +No End of Support changes were made. + Upgrading to v2022.1.3 ------- 1. Generate a back-up of the metadata by running the following command: From 2d678574f10a5bf4fc8e94cf10c4dff95ed77936 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Thu, 8 Sep 2022 14:45:45 +0300 Subject: [PATCH 243/882] Update 2022.1.3.rst --- releases/2022.1.3.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/releases/2022.1.3.rst b/releases/2022.1.3.rst index fea508cb6..37b731a0a 100644 --- a/releases/2022.1.3.rst +++ b/releases/2022.1.3.rst @@ -46,8 +46,6 @@ The following table lists the issues that were resolved in Version 2022.1.3: +=============+=================================================================================================+ | SQ-11487 | COPY FROM with offset = 0 (which is an unsupported option) is stuck up to the query timeout. | +-------------+-------------------------------------------------------------------------------------------------+ -| SQ-11378 | Python connector fails to run multi threaded per one connection. | -+-------------+-------------------------------------------------------------------------------------------------+ | SQ-11373 | SQL statement fails after changing the foreign table the statement tries to query. | +-------------+-------------------------------------------------------------------------------------------------+ | SQ-11320 | Locked users are not being released on system reset. | From e973e38343a45febcb324b4644f4f89742c7c6eb Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Mon, 12 Sep 2022 08:35:25 +0300 Subject: [PATCH 244/882] Update 2022.1.3.rst --- releases/2022.1.3.rst | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/releases/2022.1.3.rst b/releases/2022.1.3.rst index 37b731a0a..486ed2244 100644 --- a/releases/2022.1.3.rst +++ b/releases/2022.1.3.rst @@ -27,15 +27,16 @@ The 2022.1.3 Release Notes describes the following: * Support sub-queries in the UPDATE condition. +Known Issues +--------- +The following table lists the issues that are known limitations in Version 2022.1.3: -New Features ----------- -The 2022.1.3 Release Notes include the following new features: ++-------------+--------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++=============+============================================================================================+ +| SQ-11677 | UPADTE or DELETE using a sub-query that includes '%' (modulo) is crashing SQreamDB worker | ++-------------+--------------------------------------------------------------------------------------------+ - -Support sub-queries in the UPDATE condition -************ -Update functionality has been enhanced to support sub-queries allowing to update table and / or columns based on other table and / or columns. Resolved Issues --------- From 8bbf57ec1862f4373b40309fe92e134100c99b5a Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Mon, 12 Sep 2022 14:28:02 +0300 Subject: [PATCH 245/882] Update 2022.1.3.rst --- releases/2022.1.3.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/releases/2022.1.3.rst b/releases/2022.1.3.rst index 486ed2244..7d49b64c3 100644 --- a/releases/2022.1.3.rst +++ b/releases/2022.1.3.rst @@ -53,8 +53,6 @@ The following table lists the issues that were resolved in Version 2022.1.3: +-------------+-------------------------------------------------------------------------------------------------+ | SQ-11310 | Using "create table like" on foreign tables results in flat compression of the created table. | +-------------+-------------------------------------------------------------------------------------------------+ -| SQ-11287 | SQL User Defined Function declaration fails when UDF contains parenthesis. | -+-------------+-------------------------------------------------------------------------------------------------+ | SQ-10892 | Update - enhanced error message when trying to run update on foreign table. | +-------------+-------------------------------------------------------------------------------------------------+ From e357e7ab04b4a72e98ca2bd56b1dc08eb8bcf7b3 Mon Sep 17 00:00:00 2001 From: Ben Date: Wed, 14 Sep 2022 10:50:44 +0300 Subject: [PATCH 246/882] GETDATE is not supported as a default value --- reference/sql/sql_statements/ddl_commands/create_table.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/sql/sql_statements/ddl_commands/create_table.rst b/reference/sql/sql_statements/ddl_commands/create_table.rst index eb25baa8a..9fd4bacf5 100644 --- a/reference/sql/sql_statements/ddl_commands/create_table.rst +++ b/reference/sql/sql_statements/ddl_commands/create_table.rst @@ -74,7 +74,7 @@ Default Value Constraints The ``DEFAULT`` value constraint specifies a value to use if one is not defined in an :ref:`insert` or :ref:`copy_from` statement. -The value may either be a literal, **GETDATE()**, or Null, which is evaluated at the time the row is created. +The value may either be NULL or a literal. .. note:: The ``DEFAULT`` constraint only applies if the column does not have a value specified in the :ref:`insert` or :ref:`copy_from` statement. You can still insert a ``NULL`` into an nullable column by explicitly inserting ``NULL``. For example, ``INSERT INTO cool_animals VALUES (1, 'Gnu', NULL)``. @@ -293,4 +293,4 @@ The following table describes the properties that must be copied from the target Permissions ============= -The role must have the ``CREATE`` permission at the schema level. \ No newline at end of file +The role must have the ``CREATE`` permission at the schema level. From cf5277a47ef364040426cd4532110c5123c7ea05 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Sun, 18 Sep 2022 10:48:21 +0300 Subject: [PATCH 247/882] Update 2022.1.3.rst --- releases/2022.1.3.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/releases/2022.1.3.rst b/releases/2022.1.3.rst index 7d49b64c3..b1412f577 100644 --- a/releases/2022.1.3.rst +++ b/releases/2022.1.3.rst @@ -55,7 +55,8 @@ The following table lists the issues that were resolved in Version 2022.1.3: +-------------+-------------------------------------------------------------------------------------------------+ | SQ-10892 | Update - enhanced error message when trying to run update on foreign table. | +-------------+-------------------------------------------------------------------------------------------------+ - +https://sqream.atlassian.net/browse/SQ-11287 +https://sqream.atlassian.net/browse/SQ-11187 Operations and Configuration Changes From f4ea9959802cc0ec6fef957c31953496a1b549b8 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Tue, 20 Sep 2022 11:25:00 +0300 Subject: [PATCH 248/882] Update 2022.1.3.rst --- releases/2022.1.3.rst | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/releases/2022.1.3.rst b/releases/2022.1.3.rst index b1412f577..a237f1ee6 100644 --- a/releases/2022.1.3.rst +++ b/releases/2022.1.3.rst @@ -53,10 +53,13 @@ The following table lists the issues that were resolved in Version 2022.1.3: +-------------+-------------------------------------------------------------------------------------------------+ | SQ-11310 | Using "create table like" on foreign tables results in flat compression of the created table. | +-------------+-------------------------------------------------------------------------------------------------+ +| SQ-11287 | SQL User Defined Function fails when function definition contain parenthesis | ++-------------+-------------------------------------------------------------------------------------------------+ +| SQ-11187 | FLAT compression is wrongly chosen when dealing with data sets starting with all-nulls | ++-------------+-------------------------------------------------------------------------------------------------+ | SQ-10892 | Update - enhanced error message when trying to run update on foreign table. | +-------------+-------------------------------------------------------------------------------------------------+ -https://sqream.atlassian.net/browse/SQ-11287 -https://sqream.atlassian.net/browse/SQ-11187 + Operations and Configuration Changes @@ -115,7 +118,7 @@ Upgrading to v2022.1.3 $ ./upgrade_storage - .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version `_ procedure. + .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. .. toctree:: :maxdepth: 2 From 74b740074bcf3f9b9ffe5cf0407832430400f826 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Tue, 20 Sep 2022 11:33:07 +0300 Subject: [PATCH 249/882] Update 2022.1.3.rst --- releases/2022.1.3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/2022.1.3.rst b/releases/2022.1.3.rst index a237f1ee6..548c8673c 100644 --- a/releases/2022.1.3.rst +++ b/releases/2022.1.3.rst @@ -3,7 +3,7 @@ ************************** Release Notes 2022.1.3 ************************** -The 2022.1.3 release notes were released on 9/8/2022 and describe the following: +The 2022.1.3 release notes were released on 9/20/2022 and describe the following: .. contents:: :local: From e43dbdb42b90cc51237e27a91cbac6b3c4cfa25a Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Tue, 20 Sep 2022 16:34:29 +0300 Subject: [PATCH 250/882] Update index.rst Fix misspells --- connecting_to_sqream/client_drivers/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index fb772853c..5365380b9 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -40,7 +40,7 @@ Windows -------------- The following are applicable to Windows: -* **ODBC installer** - SQream Drivers v2020.2.0, with Tableau customizations. Please contact your `SSream represenative `_ for this installer. +* **ODBC installer** - SQream Drivers v2020.2.0, with Tableau customization. Please contact your `SQream representative `_ for this installer. For more information on installing and configuring ODBC on Windows, see :ref:`Install and configure ODBC on Windows `. From 6c7cf5116b0297a92853fa8337b24c21a707450e Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Wed, 21 Sep 2022 10:03:23 +0300 Subject: [PATCH 251/882] Add non production HW specs and fix some broken links --- getting_started/hardware_guide.rst | 4 +- .../non_production_hardware_guide.rst | 49 +++++++++++++++++++ index.rst | 6 +-- 3 files changed, 55 insertions(+), 4 deletions(-) create mode 100644 getting_started/non_production_hardware_guide.rst diff --git a/getting_started/hardware_guide.rst b/getting_started/hardware_guide.rst index 5337db9cd..c502f60bf 100644 --- a/getting_started/hardware_guide.rst +++ b/getting_started/hardware_guide.rst @@ -225,4 +225,6 @@ For clustered scale-out installations, SQream relies on NAS/SAN storage. For sta SQream recommends using enterprise-grade SAS SSD or NVMe drives. For a 32-user configuration, the number of GPUs should roughly match the number of users. SQream recommends 1 Tesla V100 or A100 GPU per 2 users, for full, uninterrupted dedicated access. -Download the full `SQream Reference Architecture `_ document. \ No newline at end of file +Download the full `SQream Reference Architecture `_ document. + +.. note:: Non production HW requirements may be found at `Non Production HW Requirements `_ \ No newline at end of file diff --git a/getting_started/non_production_hardware_guide.rst b/getting_started/non_production_hardware_guide.rst new file mode 100644 index 000000000..03c738887 --- /dev/null +++ b/getting_started/non_production_hardware_guide.rst @@ -0,0 +1,49 @@ +.. non_production_hardware_guide: + +*************************************** +Staging and Development Hardware Guide +*************************************** +The **Staging and Development Hardware Guide** describes the SQream recommended HW for development, staging and or QA desktop and servers. + +.. warning:: The HW specification in this page are not intended for production use! + +Development Desktop +----------------------------------- + ++------------------+-----------------------------------------------+ +| **Component** | **Type** | ++==================+===============================================+ +| Server | PC | ++------------------+-----------------------------------------------+ +| Processor | Intel i7 | ++------------------+-----------------------------------------------+ +| RAM | 64GB RAM | ++------------------+-----------------------------------------------+ +| Onboard storage | 2TB SSD | ++------------------+-----------------------------------------------+ +| GPU | 1x NVIDIA RTX A4000 16GB | ++------------------+-----------------------------------------------+ +| Operating System | Red Hat Enterprise Linux v7.9 or CentOS v7.9 | ++------------------+-----------------------------------------------+ + + +Lab Server +----------------------------------- + ++------------------+------------------------------------------------------------+ +| **Component** | **Type** | ++==================+============================================================+ +| Server | Dell R640 or similar | ++------------------+------------------------------------------------------------+ +| Processor | x2 Intel(R) Xeon(R) Silver 4112 CPU @ 2.60GHz | ++------------------+------------------------------------------------------------+ +| RAM | 128 or 256 GB | ++------------------+------------------------------------------------------------+ +| Onboard storage | "2x 960GB SSD 2.5in hot plug for OS, RAID1 | ++------------------+------------------------------------------------------------+ +| | 1(or more)x 3.84TB SSD 2.5in Hot plug for storage, RAID5" | ++------------------+------------------------------------------------------------+ +| GPU | 1xNVIDIA T4 or A40 or A10 | ++------------------+------------------------------------------------------------+ +| Operating System | Red Hat Enterprise Linux v7.9 or CentOS v7.9 | ++------------------+------------------------------------------------------------+ diff --git a/index.rst b/index.rst index d6a37d4f7..c4bee46da 100644 --- a/index.rst +++ b/index.rst @@ -8,7 +8,7 @@ SQream DB Documentation .. tip:: Want to read this offline? - `Download the documentation as a single PDF `_ . + `Download the documentation as a single PDF `_ . .. only:: pdf or latex @@ -33,7 +33,7 @@ SQream DB easily plugs in to third-party tools like :ref:`Tableau`_ + `Getting Started `_ :ref:`sql_feature_support` @@ -45,7 +45,7 @@ SQream DB easily plugs in to third-party tools like :ref:`Tableau`_ + `Setting up SQream `_ :ref:`Best practices` From 072320e0bb312af20cf3bcaa8e632f6efd7d55bc Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Wed, 21 Sep 2022 10:27:33 +0300 Subject: [PATCH 252/882] Update conf.py Update latest version to 2022.1.3 --- conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/conf.py b/conf.py index 4151da1c4..305be5597 100644 --- a/conf.py +++ b/conf.py @@ -26,7 +26,7 @@ # The full version, including alpha/beta/rc tags -release = '2022.1.2' +release = '2022.1.3' From 853c8a1440defc7be09afbadb38f0c3f520a930c Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Thu, 29 Sep 2022 15:25:52 +0300 Subject: [PATCH 253/882] Update query_healer.rst --- feature_guides/query_healer.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/feature_guides/query_healer.rst b/feature_guides/query_healer.rst index f8bb7f694..305875447 100644 --- a/feature_guides/query_healer.rst +++ b/feature_guides/query_healer.rst @@ -11,7 +11,7 @@ The **Query Healer** page describes the following: Overview ---------- -The **Query Healer** periodically examines the progress of running statements, creating a log entry for all statements exceeding the ``healerMaxInactivityHours`` flag setting. The default setting of the ``healerMaxInactivityHours`` is five hours. The ``healerMaxInactivityHours`` log frequency is calculated as 5% of the flag setting. When set to to five hours (the default setting), the Query Healer triggers an examination every 15 minutes. +The **Query Healer** periodically examines the progress of running statements, creating a log entry for all statements exceeding the ``healerMaxInactivityHours`` flag setting. The default setting of the ``healerMaxInactivityHours`` is five hours. The ``healerMaxInactivityHours`` log frequency is calculated as 5% of the flag setting. When set to five hours (the default setting), the Query Healer triggers an examination every 15 minutes. The following is an example of a log record for a query stuck in the query detection phase for more than five hours: From 06bc8165ae5e323c631b9c8d0bb1e491149f400d Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Thu, 6 Oct 2022 12:28:41 +0300 Subject: [PATCH 254/882] Create 2022.1.4.rst --- releases/2022.1.4.rst | 127 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 127 insertions(+) create mode 100644 releases/2022.1.4.rst diff --git a/releases/2022.1.4.rst b/releases/2022.1.4.rst new file mode 100644 index 000000000..43b1b1330 --- /dev/null +++ b/releases/2022.1.4.rst @@ -0,0 +1,127 @@ +.. _2022.1.4: + +************************** +Release Notes 2022.1.4 +************************** +The 2022.1.4 release notes were released on 10/XX/2022 and describe the following: + +.. contents:: + :local: + :depth: 1 + +Version Content +---------- +The 2022.1.4 Release Notes describes the following: + +* Optimize the delete operation by removing redundant calls. + + :: + +* Support LIKE condition for filtering metadata. + + :: + +* Migration tool for converting VARCHAR columns into TEXT columns. + + :: + +* Support sub-queries in the UPDATE condition. + +Known Issues +--------- +The following table lists the issues that are known limitations in Version 2022.1.4: + ++-------------+--------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++=============+============================================================================================+ +| SQ-11677 | UPADTE or DELETE using a sub-query that includes '%' (modulo) is crashing SQreamDB worker | ++-------------+--------------------------------------------------------------------------------------------+ + + +Resolved Issues +--------- +The following table lists the issues that were resolved in Version 2022.1.4: + ++-------------+-------------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++=============+=================================================================================================+ +| SQ-11487 | COPY FROM with offset = 0 (which is an unsupported option) is stuck up to the query timeout. | ++-------------+-------------------------------------------------------------------------------------------------+ +| SQ-11373 | SQL statement fails after changing the foreign table the statement tries to query. | ++-------------+-------------------------------------------------------------------------------------------------+ +| SQ-11320 | Locked users are not being released on system reset. | ++-------------+-------------------------------------------------------------------------------------------------+ +| SQ-11310 | Using "create table like" on foreign tables results in flat compression of the created table. | ++-------------+-------------------------------------------------------------------------------------------------+ +| SQ-11287 | SQL User Defined Function fails when function definition contain parenthesis | ++-------------+-------------------------------------------------------------------------------------------------+ +| SQ-11187 | FLAT compression is wrongly chosen when dealing with data sets starting with all-nulls | ++-------------+-------------------------------------------------------------------------------------------------+ +| SQ-10892 | Update - enhanced error message when trying to run update on foreign table. | ++-------------+-------------------------------------------------------------------------------------------------+ + + + +Operations and Configuration Changes +-------- +No configuration changes were made. + +Naming Changes +------- +No relevant naming changes were made. + +Deprecated Features +------- +SQream is declaring end of support of VARCHAR data type, the decision resulted by SQream's effort to enhance its core functionalities and with respect to ever changing echo system requirements. + +VARCHAR is no longer supported for new customers - effective from Version 2022.1.3 (September 2022). + +TEXT data type is replacing VARCHAR - SQream will maintain VARCHAR data type support until 09/30/2023. + + +End of Support +------- +No End of Support changes were made. + +Upgrading to v2022.1.4 +------- +1. Generate a back-up of the metadata by running the following command: + + .. code-block:: console + + $ select backup_metadata('out_path'); + + .. tip:: SQream recommends storing the generated back-up locally in case needed. + + SQream runs the Garbage Collector and creates a clean backup tarball package. + +2. Shut down all SQream services. + + :: + +3. Extract the recently created back-up file. + + :: + +4. Replace your current metadata with the metadata you stored in the back-up file. + + :: + +5. Navigate to the new SQream package bin folder. + + :: + +6. Run the following command: + + .. code-block:: console + + $ ./upgrade_storage + + .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. + +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2022.1.4 \ No newline at end of file From 4175f1d2ec633a215e6a520085eab544a7e6bde1 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Thu, 6 Oct 2022 12:32:12 +0300 Subject: [PATCH 255/882] Update 2022.1.3.rst fix misspell --- releases/2022.1.3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/2022.1.3.rst b/releases/2022.1.3.rst index 548c8673c..9887f7a04 100644 --- a/releases/2022.1.3.rst +++ b/releases/2022.1.3.rst @@ -74,7 +74,7 @@ Deprecated Features ------- SQream is declaring end of support of VARCHAR data type, the decision resulted by SQream's effort to enhance its core functionalities and with respect to ever changing echo system requirements. -VARCHAR is no longer supported for new customers - effective immanently. +VARCHAR is no longer supported for new customers - effective immediately. TEXT data type is replacing VARCHAR - SQream will maintain VARCHAR data type support until 09/30/2023. From 620a3167cb811b95ea88105f88806cbafa91ee6f Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Tue, 11 Oct 2022 15:33:07 +0300 Subject: [PATCH 256/882] Remove irrelevant toctree --- releases/2022.1.1.rst | 6 ---- releases/2022.1.2.rst | 6 ---- releases/2022.1.4.rst | 59 ++++++++++++--------------------------- releases/2022.1_index.rst | 1 + 4 files changed, 19 insertions(+), 53 deletions(-) diff --git a/releases/2022.1.1.rst b/releases/2022.1.1.rst index d5c76b361..436287c6c 100644 --- a/releases/2022.1.1.rst +++ b/releases/2022.1.1.rst @@ -107,9 +107,3 @@ Upgrading to v2022.1.1 .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version `_ procedure. -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2022.1.1 \ No newline at end of file diff --git a/releases/2022.1.2.rst b/releases/2022.1.2.rst index 0c9a4f3b3..5c007f0ec 100644 --- a/releases/2022.1.2.rst +++ b/releases/2022.1.2.rst @@ -97,9 +97,3 @@ Upgrading to v2022.1.2 .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version `_ procedure. -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2022.1.2 \ No newline at end of file diff --git a/releases/2022.1.4.rst b/releases/2022.1.4.rst index 43b1b1330..6b9cbb5a0 100644 --- a/releases/2022.1.4.rst +++ b/releases/2022.1.4.rst @@ -3,7 +3,7 @@ ************************** Release Notes 2022.1.4 ************************** -The 2022.1.4 release notes were released on 10/XX/2022 and describe the following: +The 2022.1.4 release notes were released on 10/11/2022 and describe the following: .. contents:: :local: @@ -13,52 +13,35 @@ Version Content ---------- The 2022.1.4 Release Notes describes the following: -* Optimize the delete operation by removing redundant calls. +* Security enhancement - Disable Python UDFs by default. :: -* Support LIKE condition for filtering metadata. - - :: - -* Migration tool for converting VARCHAR columns into TEXT columns. - - :: - -* Support sub-queries in the UPDATE condition. Known Issues --------- -The following table lists the issues that are known limitations in Version 2022.1.4: - -+-------------+--------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+=============+============================================================================================+ -| SQ-11677 | UPADTE or DELETE using a sub-query that includes '%' (modulo) is crashing SQreamDB worker | -+-------------+--------------------------------------------------------------------------------------------+ +No relevant Known Issues. Resolved Issues --------- The following table lists the issues that were resolved in Version 2022.1.4: -+-------------+-------------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+=============+=================================================================================================+ -| SQ-11487 | COPY FROM with offset = 0 (which is an unsupported option) is stuck up to the query timeout. | -+-------------+-------------------------------------------------------------------------------------------------+ -| SQ-11373 | SQL statement fails after changing the foreign table the statement tries to query. | -+-------------+-------------------------------------------------------------------------------------------------+ -| SQ-11320 | Locked users are not being released on system reset. | -+-------------+-------------------------------------------------------------------------------------------------+ -| SQ-11310 | Using "create table like" on foreign tables results in flat compression of the created table. | -+-------------+-------------------------------------------------------------------------------------------------+ -| SQ-11287 | SQL User Defined Function fails when function definition contain parenthesis | -+-------------+-------------------------------------------------------------------------------------------------+ -| SQ-11187 | FLAT compression is wrongly chosen when dealing with data sets starting with all-nulls | -+-------------+-------------------------------------------------------------------------------------------------+ -| SQ-10892 | Update - enhanced error message when trying to run update on foreign table. | -+-------------+-------------------------------------------------------------------------------------------------+ ++--------------+------------------------------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++==============+==================================================================================================================+ +| SQ-11487 | Alter default permissions to grant update results in error | ++--------------+------------------------------------------------------------------------------------------------------------------+ +| SQ-11771 | Wrong results returned when execute select subquery | ++--------------+------------------------------------------------------------------------------------------------------------------+ +| SQ-11740 | A correlated subquery is blocked when having 'not exist' where clause in update query | ++--------------+------------------------------------------------------------------------------------------------------------------+ +| SQ-11584 | CUDA malloc error | ++--------------+------------------------------------------------------------------------------------------------------------------+ +| SQ-10602 | Group by clause error | ++--------------+------------------------------------------------------------------------------------------------------------------+ +| SQ-9813 | When executing copy from a parquet file that contain date values earlier than 1970, values are changed to 1970. | ++--------------+------------------------------------------------------------------------------------------------------------------+ @@ -119,9 +102,3 @@ Upgrading to v2022.1.4 .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2022.1.4 \ No newline at end of file diff --git a/releases/2022.1_index.rst b/releases/2022.1_index.rst index beceab0b6..e5c24021d 100644 --- a/releases/2022.1_index.rst +++ b/releases/2022.1_index.rst @@ -13,6 +13,7 @@ The 2022.1 Release Notes describe the following releases: :maxdepth: 1 :glob: + 2022.1.4 2022.1.3 2022.1.2 2022.1.1 From c022974310478f16887810e2984fe81067acce08 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Tue, 11 Oct 2022 16:06:25 +0300 Subject: [PATCH 257/882] Update python_functions.rst --- feature_guides/python_functions.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/feature_guides/python_functions.rst b/feature_guides/python_functions.rst index 3717cdcd8..7aaea5051 100644 --- a/feature_guides/python_functions.rst +++ b/feature_guides/python_functions.rst @@ -6,6 +6,8 @@ Python UDF (User-Defined Functions) User-defined functions (UDFs) are a feature that extends SQream DB's built in SQL functionality. SQream DB's Python UDFs allow developers to create new functionality in SQL by writing the lower-level language implementation in Python. +.. note:: Starting v2022.1.4, Python UDF are disabled by default in order to enhance product security. Use the ``enablePythonUdfs`` configuration flag in order to enable Python UDF. + .. contents:: In this topic: :local: From 5fe9d223e9bb82f8470390bb94107b7e2fdebe67 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Wed, 12 Oct 2022 14:13:44 +0300 Subject: [PATCH 258/882] Update 2022.1.4.rst --- releases/2022.1.4.rst | 31 ++++++++++++++++--------------- 1 file changed, 16 insertions(+), 15 deletions(-) diff --git a/releases/2022.1.4.rst b/releases/2022.1.4.rst index 6b9cbb5a0..0f3a6add0 100644 --- a/releases/2022.1.4.rst +++ b/releases/2022.1.4.rst @@ -27,21 +27,22 @@ Resolved Issues --------- The following table lists the issues that were resolved in Version 2022.1.4: -+--------------+------------------------------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+==============+==================================================================================================================+ -| SQ-11487 | Alter default permissions to grant update results in error | -+--------------+------------------------------------------------------------------------------------------------------------------+ -| SQ-11771 | Wrong results returned when execute select subquery | -+--------------+------------------------------------------------------------------------------------------------------------------+ -| SQ-11740 | A correlated subquery is blocked when having 'not exist' where clause in update query | -+--------------+------------------------------------------------------------------------------------------------------------------+ -| SQ-11584 | CUDA malloc error | -+--------------+------------------------------------------------------------------------------------------------------------------+ -| SQ-10602 | Group by clause error | -+--------------+------------------------------------------------------------------------------------------------------------------+ -| SQ-9813 | When executing copy from a parquet file that contain date values earlier than 1970, values are changed to 1970. | -+--------------+------------------------------------------------------------------------------------------------------------------+ ++---------------------+------------------------------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++=====================+==================================================================================================================+ +| SQ-11782 | Alter default permissions to grant update results in error | ++---------------------+------------------------------------------------------------------------------------------------------------------+ +| SQ-11771 | Wrong results returned when execute select subquery | ++---------------------+------------------------------------------------------------------------------------------------------------------+ +| SQ-11740 | A correlated subquery is blocked when having 'not exist' where clause in update query | ++---------------------+------------------------------------------------------------------------------------------------------------------+ +| SQ-11686, SQ-11584 | CUDA malloc error | ++---------------------+------------------------------------------------------------------------------------------------------------------+ +| SQ-10602 | Group by clause error | ++---------------------+------------------------------------------------------------------------------------------------------------------+ +| SQ-9813 | When executing copy from a parquet file that contain date values earlier than 1970, values are changed to 1970. | ++---------------------+------------------------------------------------------------------------------------------------------------------+ + From 7aafdb3e9871e088e43cfbd53ae911441c4d16c9 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Wed, 19 Oct 2022 11:44:32 +0300 Subject: [PATCH 259/882] New file for 2022.1.5 release New file for 2022.1.5 release --- releases/2022.1.5.rst | 91 +++++++++++++++++++++++++++++++++++++++ releases/2022.1_index.rst | 1 + 2 files changed, 92 insertions(+) create mode 100644 releases/2022.1.5.rst diff --git a/releases/2022.1.5.rst b/releases/2022.1.5.rst new file mode 100644 index 000000000..828ac3d5f --- /dev/null +++ b/releases/2022.1.5.rst @@ -0,0 +1,91 @@ +.. _2022.1.5: + +************************** +Release Notes 2022.1.5 +************************** +The 2022.1.5 release notes were released on 10/XX/2022 and describe the following: + +.. contents:: + :local: + :depth: 1 + +Version Content +---------- +The 2022.1.5 Release Notes describes the following: + +XXXXXX TBD XXXXXXXXXXXXXXXXXXXX + + :: + + +Known Issues +--------- +No relevant Known Issues. + + +Resolved Issues +--------- +The following table lists the issues that were resolved in Version 2022.1.5: + +XXXXXX TBD XXXXXXXXXXXXXXXXXXXX + + + + +Operations and Configuration Changes +-------- +No configuration changes were made. + +Naming Changes +------- +No relevant naming changes were made. + +Deprecated Features +------- +SQream is declaring end of support of VARCHAR data type, the decision resulted by SQream's effort to enhance its core functionalities and with respect to ever changing echo system requirements. + +VARCHAR is no longer supported for new customers - effective from Version 2022.1.3 (September 2022). + +TEXT data type is replacing VARCHAR - SQream will maintain VARCHAR data type support until 09/30/2023. + + +End of Support +------- +No End of Support changes were made. + +Upgrading to v2022.1.5 +------- +1. Generate a back-up of the metadata by running the following command: + + .. code-block:: console + + $ select backup_metadata('out_path'); + + .. tip:: SQream recommends storing the generated back-up locally in case needed. + + SQream runs the Garbage Collector and creates a clean backup tarball package. + +2. Shut down all SQream services. + + :: + +3. Extract the recently created back-up file. + + :: + +4. Replace your current metadata with the metadata you stored in the back-up file. + + :: + +5. Navigate to the new SQream package bin folder. + + :: + +6. Run the following command: + + .. code-block:: console + + $ ./upgrade_storage + + .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. + diff --git a/releases/2022.1_index.rst b/releases/2022.1_index.rst index e5c24021d..d6522a59b 100644 --- a/releases/2022.1_index.rst +++ b/releases/2022.1_index.rst @@ -13,6 +13,7 @@ The 2022.1 Release Notes describe the following releases: :maxdepth: 1 :glob: + 2022.1.5 2022.1.4 2022.1.3 2022.1.2 From 84d8101cf9443126a3f9831911cbd77b166e7de8 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Wed, 19 Oct 2022 11:49:15 +0300 Subject: [PATCH 260/882] Remove redundent toc tree that causes error --- releases/2022.1.3.rst | 6 ------ releases/2022.1.rst | 6 ------ 2 files changed, 12 deletions(-) diff --git a/releases/2022.1.3.rst b/releases/2022.1.3.rst index 9887f7a04..b88eb78d9 100644 --- a/releases/2022.1.3.rst +++ b/releases/2022.1.3.rst @@ -120,9 +120,3 @@ Upgrading to v2022.1.3 .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2022.1.3 \ No newline at end of file diff --git a/releases/2022.1.rst b/releases/2022.1.rst index 3d1517371..6614d6458 100644 --- a/releases/2022.1.rst +++ b/releases/2022.1.rst @@ -129,9 +129,3 @@ Upgrading to v2022.1 .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version `_ procedure. -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2022.1 \ No newline at end of file From 90f0d9772ef43bdb62e8a196503c17071da57b08 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Wed, 19 Oct 2022 11:54:44 +0300 Subject: [PATCH 261/882] Remove redundent toc tree that causes error --- releases/2019.2.1.rst | 94 ---------------------------------------- releases/2020.1.rst | 6 --- releases/2020.2.rst | 6 --- releases/2020.3.1.rst | 6 --- releases/2020.3.2.1.rst | 6 --- releases/2021.1.2.rst | 6 --- releases/2021.1.rst | 6 --- releases/2021.2.1.24.rst | 6 --- releases/2021.2.1.rst | 6 --- releases/2021.2.rst | 6 --- 10 files changed, 148 deletions(-) delete mode 100644 releases/2019.2.1.rst diff --git a/releases/2019.2.1.rst b/releases/2019.2.1.rst deleted file mode 100644 index c9c96b59b..000000000 --- a/releases/2019.2.1.rst +++ /dev/null @@ -1,94 +0,0 @@ -.. _2019.2.1: - -****************************** -Release Notes 2019.2.1 -****************************** - -* 250 bugs fixed. Thanks to all of our customers and an unprecedented number of deployments for helping us find and fix these! -* Improved Unicode text handling on the GPU -* Improved logging and monitoring of statements -* Alibaba DataX connector - - -Improvements -===================== - -* We’ve updated the ``show_server_status()`` function to more accurately reflect the status of statements across the cluster: - - * Preparing – Initial validation - * In queue – Waiting for execution - * Initializing – Pre-execution processing - * Executing – statement is running - -* We’ve improved our log files and have unified them into a single file per worker, per date. Each message type has a unique code which can help identify potential issues. See the documentation for full details on the changes to the log structures. - -* ``WITH ADMIN OPTION`` added in ``GRANT``/``REVOKE`` operations, allowing roles to grant their own permissions to others. - -* HA cluster fully supports qualified hostnames, and no longer requires explicit IP addresses. - -* SQream DB CLI’s history can be disabled, by passing ``./ClientCmd --no-history`` - - -Behaviour Changes -===================== - -* SQream DB no longer applies an implicit cast from a long text column to a shorter text column (``VARCHAR``/``TEXT``). This means some ``INSERT``/``COPY`` operations will now error instead of truncating the text. This is intended to prevent accidental truncation of text columns. If you want the old truncation behaviour, you can use the ``SUBSTRING`` function to truncate the text. - - -Operations -===================== - -* The client-server protocol has been updated to support a wider range of encodings. End users are required to use only the latest ClientCmd, JDBC, and ODBC drivers delivered with this version. - -* Clients such as SecureCRT and other shells must have locale set as ``cp874`` or equivalent - -* When upgrading from SQream DB v3.2 or lower, the storage version must be upgraded using the :ref:`upgrade_storage_cli_reference` utility: ``./bin/upgrade_storage /path/to/storage/sqreamdb/`` - - -Known Issues and Limitations -=================================== - -* TEXT columns cannot be used as a ``GROUP BY`` key when there are multiple ``COUNT (DISTINCT …)`` operations in a query - -* TEXT columns cannot be used in a statement containing window functions - -* TEXT is not supported as a join key - -* The following functions are not supported on ``TEXT`` column types: ``chr``, ``min``, ``max``, ``patindex``, ``to_binary``, ``to_hex``, ``rlike``, ``regexp_count``, ``regexp_instr``, ``regexp_substr`` - -* SQream Dashboard: Only works with a HA clustered installation - -* SQream Editor: External tables and UDFs don’t appear in the DB Tree but do appear in the relevant sqream_catalog entries. - - -Fixes -===================== - -250 bugs and issues fixed, including: - -* Variety of performance improvements: - -* Improved performance of ``TEXT`` by up to 315% for a variety of scenarios, including ``COPY FROM``, ``INNER JOIN``, ``LEFT JOIN``. - -* Improved load performance from previous versions - -* Faster compilation times for very complex queries - -* DWLM: - - * Fixed situation where queries were not distributed correctly among all available workers - * Fixed ``cannot execute - reconnectDb error`` error - * Fixed occasional hanging statement - * Fixed occasional ``Connection refused`` - -* Window functions: - - * Fixed window function edge-case ``error WindowA with no functions`` - * Fixed situations where the SUM window function is applied on a column, partitioned by a second, and sorted by a third would return wrong results when scanning very large datasets - -* Other bugs: - - * Fixed situation where many concurrent statements running would result in ``map::at`` appearing - * Fixed situation where SQream DB would restart when force-stopping an ``INSERT`` over the network - * Fixed situation where RAM wasn’t released immediately after statement has been executed - * Fixed Type doesn’t have a fixed size error that appeared when using an external table joined with a standard SQream DB table diff --git a/releases/2020.1.rst b/releases/2020.1.rst index 86b619d54..769fa0ebb 100644 --- a/releases/2020.1.rst +++ b/releases/2020.1.rst @@ -187,9 +187,3 @@ Versions are available for IBM POWER9, RedHat (CentOS) 7, Ubuntu 18.04, and othe Contact your account manager to get the latest release of SQream. -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2020.1 \ No newline at end of file diff --git a/releases/2020.2.rst b/releases/2020.2.rst index 917d80800..5a66e99bd 100644 --- a/releases/2020.2.rst +++ b/releases/2020.2.rst @@ -114,9 +114,3 @@ Versions are available for IBM POWER9, RedHat (CentOS) 7, Ubuntu 18.04, and othe Contact your account manager to get the latest release of SQream. -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2020.2 \ No newline at end of file diff --git a/releases/2020.3.1.rst b/releases/2020.3.1.rst index b66454c75..9fa40cbb0 100644 --- a/releases/2020.3.1.rst +++ b/releases/2020.3.1.rst @@ -71,9 +71,3 @@ Versions are available for IBM POWER9, RedHat (CentOS) 7, Ubuntu 18.04, and othe Contact your account manager to get the latest release of SQream. -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2020.3.1 \ No newline at end of file diff --git a/releases/2020.3.2.1.rst b/releases/2020.3.2.1.rst index 8fef047f6..29f3b3e88 100644 --- a/releases/2020.3.2.1.rst +++ b/releases/2020.3.2.1.rst @@ -30,9 +30,3 @@ Versions are available for IBM POWER9, RedHat (CentOS) 7, Ubuntu 18.04, and othe Contact your account manager to get the latest release of SQream. -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2020.3.2.1 \ No newline at end of file diff --git a/releases/2021.1.2.rst b/releases/2021.1.2.rst index 750420260..ee33cfbd8 100644 --- a/releases/2021.1.2.rst +++ b/releases/2021.1.2.rst @@ -60,9 +60,3 @@ The following list describes the resolved issues: * The ``REPLACE`` function only supported constant values as arguments. This was fixed. * The ``LIKE`` function did not check for incorrect patterns or handle escape characters. This was fixed. -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2021.1.2 \ No newline at end of file diff --git a/releases/2021.1.rst b/releases/2021.1.rst index 389655262..02d5377d5 100644 --- a/releases/2021.1.rst +++ b/releases/2021.1.rst @@ -212,9 +212,3 @@ Upgrading to v2021.1 ------- Due to the known issue of a limitation on the amount of access requests that can be simultaneously sent to AWS, deploying S3 requires setting the ``ObjectStoreClients`` parameter to ``40``. -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2021.1 \ No newline at end of file diff --git a/releases/2021.2.1.24.rst b/releases/2021.2.1.24.rst index a89244934..d277ea51a 100644 --- a/releases/2021.2.1.24.rst +++ b/releases/2021.2.1.24.rst @@ -79,9 +79,3 @@ End of Support ------- The End of Support section is not relevant to Version 2021.2.1.24. -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2021.2.1.24 diff --git a/releases/2021.2.1.rst b/releases/2021.2.1.rst index e1a01a147..d50f1084e 100644 --- a/releases/2021.2.1.rst +++ b/releases/2021.2.1.rst @@ -78,9 +78,3 @@ Deprecated Features ------ The **Deprecated Components** section is not relevant to Version 2021.2.1. -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2021.2.1 \ No newline at end of file diff --git a/releases/2021.2.rst b/releases/2021.2.rst index 2140dc6be..f95de16a5 100644 --- a/releases/2021.2.rst +++ b/releases/2021.2.rst @@ -168,9 +168,3 @@ A new configuration method is used starting with Version 2021.2. For more information about configuring your instance of SQream, see `Client Drivers for 2021.2 `_. -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2021.2 \ No newline at end of file From ff8d1d8d4f56daf27e803d8b6e3618dfc250164a Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Wed, 19 Oct 2022 14:18:13 +0300 Subject: [PATCH 262/882] Update remedying_slow_queries.rst Fix broken links --- troubleshooting/remedying_slow_queries.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/troubleshooting/remedying_slow_queries.rst b/troubleshooting/remedying_slow_queries.rst index 8a109f0c0..9bd05b324 100644 --- a/troubleshooting/remedying_slow_queries.rst +++ b/troubleshooting/remedying_slow_queries.rst @@ -33,7 +33,7 @@ The following table is a checklist you can use to identify the cause of your slo - Use ``SELECT show_cluster_nodes();`` to list the active cluster workers. - If the worker list is incomplete, follow the :ref:`cluster troubleshooting` section below. + If the worker list is incomplete, locate and start the missing worker(s). If all workers are up, continue to step 4. * - 4 @@ -73,7 +73,7 @@ The following table is a checklist you can use to identify the cause of your slo - Check free memory across hosts - #. Check free memory across the hosts by running ``$ free -th`` from the terminal. - #. If the machine has less than 5% free memory, consider **lowering** the ``limitQueryMemoryGB`` and ``spoolMemoryGB`` settings. Refer to the :ref:`configuration` guide. + #. If the machine has less than 5% free memory, consider **lowering** the ``limitQueryMemoryGB`` and ``spoolMemoryGB`` settings. Refer to the :ref:`spooling` guide. #. If the machine has a lot of free memory, consider **increasing** the ``limitQueryMemoryGB`` and ``spoolMemoryGB`` settings. If performance does not improve, contact SQream support for more help. \ No newline at end of file From 2596e3da9e04a54d10d183141590f84ce8e08e0b Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Thu, 20 Oct 2022 10:38:15 +0300 Subject: [PATCH 263/882] Update 2022.1.4.rst Remove customer sensitive bug --- releases/2022.1.4.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/releases/2022.1.4.rst b/releases/2022.1.4.rst index 0f3a6add0..338fdf164 100644 --- a/releases/2022.1.4.rst +++ b/releases/2022.1.4.rst @@ -32,8 +32,6 @@ The following table lists the issues that were resolved in Version 2022.1.4: +=====================+==================================================================================================================+ | SQ-11782 | Alter default permissions to grant update results in error | +---------------------+------------------------------------------------------------------------------------------------------------------+ -| SQ-11771 | Wrong results returned when execute select subquery | -+---------------------+------------------------------------------------------------------------------------------------------------------+ | SQ-11740 | A correlated subquery is blocked when having 'not exist' where clause in update query | +---------------------+------------------------------------------------------------------------------------------------------------------+ | SQ-11686, SQ-11584 | CUDA malloc error | From 89b87fcd68993fb8084b6bd66ba561932f1ae59e Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Sun, 30 Oct 2022 13:40:30 +0200 Subject: [PATCH 264/882] Cuda 11.4 rollback Rollback Cude descriptions from 11.4 to 10.1 as 11.4 is yet to be released --- .../installing_sqream_with_kubernetes.rst | 16 ++++++------- .../running_sqream_in_a_docker_container.rst | 24 +++++++++---------- 2 files changed, 20 insertions(+), 20 deletions(-) diff --git a/installation_guides/installing_sqream_with_kubernetes.rst b/installation_guides/installing_sqream_with_kubernetes.rst index aa7e22422..fbf2566ed 100644 --- a/installation_guides/installing_sqream_with_kubernetes.rst +++ b/installation_guides/installing_sqream_with_kubernetes.rst @@ -198,7 +198,7 @@ After completing all of the steps above, you must check the CUDA version. .. code-block:: postgres +-----------------------------------------------------------------------------+ - | NVIDIA-SMI 470.82.01 Driver Version: 470.82.01 CUDA Version: 11.4 | + | NVIDIA-SMI 470.82.01 Driver Version: 470.82.01 CUDA Version: 10.1 | |-------------------------------+----------------------+----------------------+ | GPU Name Persistence-M| Bus-Id Disp.A | Volatile Uncorr. ECC | | Fan Temp Perf Pwr:Usage/Cap| Memory-Usage | GPU-Util Compute M. | @@ -220,7 +220,7 @@ After completing all of the steps above, you must check the CUDA version. | No running processes found | +-----------------------------------------------------------------------------+ -In the above output, the CUDA version is **11.4**. +In the above output, the CUDA version is **10.1**. If the above output is not generated, CUDA has not been installed. To install CUDA, see :ref:`installing-the-cuda-driver`. @@ -800,15 +800,15 @@ Installing the NVIDIA Docker2 Toolkit on an x86_64 Bit Processor on CentOS .. code-block:: postgres - $ docker run --runtime=nvidia --rm nvidia/cuda:11.4.3-base-centos7 nvidia-smi + $ docker run --runtime=nvidia --rm nvidia/cuda:10.1.3-base-centos7 nvidia-smi The following is an example of the correct output: .. code-block:: postgres - docker run --runtime=nvidia --rm nvidia/cuda:11.4.3-base-centos7 nvidia-smi - Unable to find image 'nvidia/cuda:11.4.3-base-centos7' locally - 11.4.3-base-centos7: Pulling from nvidia/cuda + docker run --runtime=nvidia --rm nvidia/cuda:10.1.3-base-centos7 nvidia-smi + Unable to find image 'nvidia/cuda:10.1.3-base-centos7' locally + 10.1.3-base-centos7: Pulling from nvidia/cuda d519e2592276: Pull complete d22d2dfcfa9c: Pull complete b3afe92c540b: Pull complete @@ -816,10 +816,10 @@ Installing the NVIDIA Docker2 Toolkit on an x86_64 Bit Processor on CentOS 4f0bc36a7e1d: Pull complete cd710321007d: Pull complete Digest: sha256:635629544b2a2be3781246fdddc55cc1a7d8b352e2ef205ba6122b8404a52123 - Status: Downloaded newer image for nvidia/cuda:11.4.3-base-centos7 + Status: Downloaded newer image for nvidia/cuda:10.1.3-base-centos7 Sun Feb 14 13:27:58 2021 +-----------------------------------------------------------------------------+ - | NVIDIA-SMI 470.82.01 Driver Version: 470.82.01 CUDA Version: 11.4 | + | NVIDIA-SMI 470.82.01 Driver Version: 470.82.01 CUDA Version: 10.1 | |-------------------------------+----------------------+----------------------+ | GPU Name Persistence-M| Bus-Id Disp.A | Volatile Uncorr. ECC | | Fan Temp Perf Pwr:Usage/Cap| Memory-Usage | GPU-Util Compute M. | diff --git a/installation_guides/running_sqream_in_a_docker_container.rst b/installation_guides/running_sqream_in_a_docker_container.rst index dd8d07e50..2a2454164 100644 --- a/installation_guides/running_sqream_in_a_docker_container.rst +++ b/installation_guides/running_sqream_in_a_docker_container.rst @@ -248,7 +248,7 @@ Installing the Nvidia CUDA Driver nvidia-smi Wed Oct 30 14:05:42 2019 +-----------------------------------------------------------------------------+ - | NVIDIA-SMI 470.82.01 Driver Version: 470.82.01 CUDA Version: 11.4 | + | NVIDIA-SMI 470.82.01 Driver Version: 470.82.01 CUDA Version: 10.1 | |-------------------------------+----------------------+----------------------+ | GPU Name Persistence-M| Bus-Id Disp.A | Volatile Uncorr. ECC | | Fan Temp Perf Pwr:Usage/Cap| Memory-Usage | GPU-Util Compute M. | @@ -267,7 +267,7 @@ Installing the Nvidia CUDA Driver | No running processes found | +-----------------------------------------------------------------------------+ -#. Verify that the installed CUDA version shown in the output above is ``11.4``. +#. Verify that the installed CUDA version shown in the output above is ``10.1``. :: @@ -276,25 +276,25 @@ Installing the Nvidia CUDA Driver :: - 1. If CUDA version 11.4 has already been installed, skip to Docktime Runtime (Community Edition). + 1. If CUDA version 10.1 has already been installed, skip to Docktime Runtime (Community Edition). :: - 2. If CUDA version 11.4 has not been installed yet, continue with Step 7 below. + 2. If CUDA version 10.1 has not been installed yet, continue with Step 7 below. #. Do one of the following: - * Install :ref:`CUDA Driver version 11.4 for x86_64 `. + * Install :ref:`CUDA Driver version 10.1 for x86_64 `. :: * Install :ref:`CUDA driver version 10.1 for IBM Power9 `. -.. _CUDA_11.4_x8664: +.. _CUDA_10.1_x8664: -Installing the CUDA Driver Version 11.4 for x86_64 +Installing the CUDA Driver Version 10.1 for x86_64 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -**To install the CUDA driver version 11.4 for x86_64:** +**To install the CUDA driver version 10.1 for x86_64:** 1. Make the following target platform selections: @@ -352,7 +352,7 @@ For installer type, SQream recommends selecting **runfile (local)**. The availab nvidia-smi Wed Oct 30 14:05:42 2019 +-----------------------------------------------------------------------------+ - | NVIDIA-SMI 470.82.01 Driver Version: 470.82.01 CUDA Version: 11.4 | + | NVIDIA-SMI 470.82.01 Driver Version: 470.82.01 CUDA Version: 10.1 | |-------------------------------+----------------------+----------------------+ | GPU Name Persistence-M| Bus-Id Disp.A | Volatile Uncorr. ECC | | Fan Temp Perf Pwr:Usage/Cap| Memory-Usage | GPU-Util Compute M. | @@ -622,7 +622,7 @@ Installing the NVIDIA Docker2 Toolkit on a CentOS Operating System .. code-block:: - $ docker run --runtime=nvidia --rm nvidia/cuda:11.4.3-base-centos7 nvidia-smi + $ docker run --runtime=nvidia --rm nvidia/cuda:10.1.3-base-centos7 nvidia-smi For more information on installing the NVIDIA Docker2 Toolkit on a CentOS operating system, see :ref:`Installing the NVIDIA Docker2 Toolkit on a CentOS operating system ` @@ -674,7 +674,7 @@ Installing the NVIDIA Docker2 Toolkit on an Ubuntu Operating System .. code-block:: - $ docker run --runtime=nvidia --rm nvidia/cuda:11.4.3-base-centos7 nvidia-smi + $ docker run --runtime=nvidia --rm nvidia/cuda:10.1.3-base-centos7 nvidia-smi For more information on installing the NVIDIA Docker2 Toolkit on a CentOS operating system, see :ref:`Installing the NVIDIA Docker2 Toolkit on an Ubuntu operating system ` @@ -1062,7 +1062,7 @@ The following is an example of the correct output: METADATA_PORT=3105 PICKER_PORT=3108 NUM_OF_GPUS=2 - CUDA_VERSION=11.4 + CUDA_VERSION=10.1 NVIDIA_SMI_PATH=/usr/bin/nvidia-smi DOCKER_PATH=/usr/bin/docker NVIDIA_DRIVER=418 From 7d2e27c0d70e16f5709c0b3f52a04c1f229ca1db Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Sun, 30 Oct 2022 13:58:42 +0200 Subject: [PATCH 265/882] Update 2022.1.5.rst Add bug list --- releases/2022.1.5.rst | 19 +++++++++++++++++-- 1 file changed, 17 insertions(+), 2 deletions(-) diff --git a/releases/2022.1.5.rst b/releases/2022.1.5.rst index 828ac3d5f..318934b41 100644 --- a/releases/2022.1.5.rst +++ b/releases/2022.1.5.rst @@ -3,7 +3,7 @@ ************************** Release Notes 2022.1.5 ************************** -The 2022.1.5 release notes were released on 10/XX/2022 and describe the following: +The 2022.1.5 release notes were released on 11/02/2022 and describe the following: .. contents:: :local: @@ -27,7 +27,22 @@ Resolved Issues --------- The following table lists the issues that were resolved in Version 2022.1.5: -XXXXXX TBD XXXXXXXXXXXXXXXXXXXX ++--------------+------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++==============+==========================================================================================+ +| SQ-11473 | SQream Command Line Interface connectivity issues | ++--------------+------------------------------------------------------------------------------------------+ +| SQ-11551 | SQream Studio Logs pages filtering issues | ++--------------+------------------------------------------------------------------------------------------+ +| SQ-11631 | Log related configuration flags are not working as expected | ++--------------+------------------------------------------------------------------------------------------+ +| SQ-11745 | Missing validation of sufficient GPU memory | ++--------------+------------------------------------------------------------------------------------------+ +| SQ-11792 | CUME_DIST function causes query execution errors | ++--------------+------------------------------------------------------------------------------------------+ +| SQ-11905 | GetDate casting to as text returns DATE with 0s in the time part or no time part at all | ++--------------+------------------------------------------------------------------------------------------+ + From 1572206fde5df85eeadb39331fad00131dc28a95 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Mon, 31 Oct 2022 08:56:43 +0200 Subject: [PATCH 266/882] add features details --- releases/2022.1.5.rst | 16 ++++++++++++---- troubleshooting/lock_related_issues.rst | 2 ++ 2 files changed, 14 insertions(+), 4 deletions(-) diff --git a/releases/2022.1.5.rst b/releases/2022.1.5.rst index 318934b41..2ff841d42 100644 --- a/releases/2022.1.5.rst +++ b/releases/2022.1.5.rst @@ -9,13 +9,21 @@ The 2022.1.5 release notes were released on 11/02/2022 and describe the followin :local: :depth: 1 -Version Content +New Features ---------- -The 2022.1.5 Release Notes describes the following: +The 2022.1.5 Release Notes include the following new features: + +* keys_evaluate utility function enhancement - add problematic chunk ID to the function's output report. -XXXXXX TBD XXXXXXXXXXXXXXXXXXXX + :: - :: +* Automatically close database connections that have been open for 24 hours without any active statements. + + :: + +* release_defunct_locks utility function enhancement to receive new optional input parameter to specify timeout - for more details see `Lock Related Issues <../troubleshooting/lock_related_issues.html>`_. + + Known Issues diff --git a/troubleshooting/lock_related_issues.rst b/troubleshooting/lock_related_issues.rst index 1a15858ec..ed1e21579 100644 --- a/troubleshooting/lock_related_issues.rst +++ b/troubleshooting/lock_related_issues.rst @@ -26,4 +26,6 @@ If the locks still appear in the :ref:`show_locks` utility, we can force remove t=> SELECT RELEASE_DEFUNCT_LOCKS(); executed +.. tip:: ``RELEASE_DEFUNCT_LOCKS`` has an optional input parameter to specify the number of seconds, after which ``RELEASE_DEFUNCT_LOCKS`` will execute. + .. warning:: This operation can cause some statements to fail on the specific worker on which they are queued. This is intended as a "last resort" to solve stale locks. \ No newline at end of file From 0d17c656203004634229eb5e1f14f0b07ecdfe74 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Mon, 31 Oct 2022 12:53:59 +0200 Subject: [PATCH 267/882] Update 2022.1.5.rst --- releases/2022.1.5.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/releases/2022.1.5.rst b/releases/2022.1.5.rst index 2ff841d42..1466882cc 100644 --- a/releases/2022.1.5.rst +++ b/releases/2022.1.5.rst @@ -17,7 +17,7 @@ The 2022.1.5 Release Notes include the following new features: :: -* Automatically close database connections that have been open for 24 hours without any active statements. +* Automatically close database client connections that have been open for 24 hours without any active statements. :: @@ -28,7 +28,7 @@ The 2022.1.5 Release Notes include the following new features: Known Issues --------- -No relevant Known Issues. +Recently discovered issue with the encryption feature, at this time SQream recommends to avoid using this feature - a fix will be introduced in the near future. Resolved Issues From 1e139a42cf6bc62f5ac9d9889772d7fc92e7f5a6 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Tue, 1 Nov 2022 06:20:22 +0200 Subject: [PATCH 268/882] Update 2022.1.5.rst --- releases/2022.1.5.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/releases/2022.1.5.rst b/releases/2022.1.5.rst index 1466882cc..d63bf3b7a 100644 --- a/releases/2022.1.5.rst +++ b/releases/2022.1.5.rst @@ -38,6 +38,8 @@ The following table lists the issues that were resolved in Version 2022.1.5: +--------------+------------------------------------------------------------------------------------------+ | **SQ No.** | **Description** | +==============+==========================================================================================+ +| SQ-11081 | Tableau connection are not getting closed | ++--------------+------------------------------------------------------------------------------------------+ | SQ-11473 | SQream Command Line Interface connectivity issues | +--------------+------------------------------------------------------------------------------------------+ | SQ-11551 | SQream Studio Logs pages filtering issues | From 2a5ea06da042851b5bbe51827ebaf29b731313e4 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Sun, 6 Nov 2022 11:58:52 +0200 Subject: [PATCH 269/882] Update catalog_reference_catalog_tables.rst --- reference/catalog_reference_catalog_tables.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/reference/catalog_reference_catalog_tables.rst b/reference/catalog_reference_catalog_tables.rst index 7ddb9c148..4f4d60b76 100644 --- a/reference/catalog_reference_catalog_tables.rst +++ b/reference/catalog_reference_catalog_tables.rst @@ -303,8 +303,6 @@ The ``roles`` data object identifies the roles in the database, as shown in the - Identifies whether the role can be used to log in to SQream (``1`` - yes, ``0`` - no). * - ``has_password`` - Identifies whether the role has a password (``1`` - yes, ``0`` - no). - * - ``can_create_function`` - - Identifies whether role can create UDFs (``1`` - yes, ``0`` - no). Role Memberships *********** From f6a1a094e274396619bf3f81d105045b1179364a Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Tue, 8 Nov 2022 10:54:20 +0200 Subject: [PATCH 270/882] Create external_data.rst --- operational_guides/external_data.rst | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 operational_guides/external_data.rst diff --git a/operational_guides/external_data.rst b/operational_guides/external_data.rst new file mode 100644 index 000000000..c9a6cfb33 --- /dev/null +++ b/operational_guides/external_data.rst @@ -0,0 +1,26 @@ +.. _external_data: + +********************************** +Working with External Data +********************************** +SQream supports the following external data sources: + +.. toctree:: + :maxdepth: 1 + :titlesonly: + + s3 + hdfs + mounting_an_nfs_shared_drive + +For more information, see the following: + +* :ref:`external_tables` + + :: + +* :ref:`copy_from` + + :: + +* :ref:`copy_to` \ No newline at end of file From ae7a7c79f6e3f8a24800ae1ce2ab4a9fa9fe52fd Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Tue, 8 Nov 2022 11:38:39 +0200 Subject: [PATCH 271/882] Removed NFS + Relocate Exteranl storage data Removed NFS + Relocate Exteranl storage data --- index.rst | 221 ++++++++++++++++++++--------- operational_guides/hdfs.rst | 265 +++++++++++++++++++++++++++++++++++ operational_guides/index.rst | 3 + operational_guides/s3.rst | 129 +++++++++++++++++ 4 files changed, 552 insertions(+), 66 deletions(-) create mode 100644 operational_guides/hdfs.rst create mode 100644 operational_guides/s3.rst diff --git a/index.rst b/index.rst index c4bee46da..00c01f392 100644 --- a/index.rst +++ b/index.rst @@ -4,6 +4,8 @@ SQream DB Documentation ************************* +For SQream version 2021.2. + .. only:: html .. tip:: @@ -14,67 +16,155 @@ SQream DB Documentation .. tip:: This documentation is available online at https://docs.sqream.com/ -SQream DB is a columnar analytic SQL database management system. - -SQream DB supports regular SQL including :ref:`a substantial amount of ANSI SQL`, uses :ref:`serializable transactions`, and :ref:`scales horizontally` for concurrent statements. - -Even a :ref:`basic SQream DB machine` can support tens to hundreds of terabytes of data. - -SQream DB easily plugs in to third-party tools like :ref:`Tableau` comes with standard SQL client drivers, including :ref:`JDBC`, :ref:`ODBC`, and :ref:`Python DB-API`. - -.. - .. ref`features_tour` - -.. list-table:: - :widths: 33 33 33 - :header-rows: 0 - - * - **Get Started** - - **Reference** - - **Guides** - * - - `Getting Started `_ - - :ref:`sql_feature_support` - - :ref:`Bulk load CSVs` - - - :ref:`SQL Reference` - - :ref:`sql_statements` - - :ref:`sql_functions` - - - `Setting up SQream `_ - - :ref:`Best practices` - - - * - **Releases** - - **Driver and Deployment** - - **Help and Support** - * - - :ref:`2022.1<2022.1>` - - :ref:`2021.2<2021.2>` - - :ref:`2021.1<2021.1>` - - :ref:`2020.3<2020.3>` - - :ref:`2020.2<2020.2>` - - :ref:`2020.1<2020.1>` - - :ref:`All recent releases` - - - - :ref:`Client drivers` - - - - :ref:`troubleshooting` guide - - :ref:`information_for_support` +SQream DB is a columnar analytic SQL database management system. SQream DB supports regular SQL including :ref:`a substantial amount of ANSI SQL`, uses :ref:`serializable transactions`, and :ref:`scales horizontally` for concurrent statements. Even a :ref:`basic SQream DB machine` can support tens to hundreds of terabytes of data. SQream DB easily plugs in to third-party tools like :ref:`Tableau` comes with standard SQL client drivers, including :ref:`JDBC`, :ref:`ODBC`, and :ref:`Python DB-API`. + +:ref:`client_platforms` + ++---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ +| Topic | Description | ++===================================================+========================================================================================================================================+ +| **Getting Started** | ++---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ +| :ref:`preparing_your_machine_to_install_sqream` | Set up your local machine according to SQream’s recommended pre-installation configurations. | ++---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ +| :ref:`executing_statements_in_sqream` | Provides more information about the available methods for executing statements in SQream. | ++---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ +| :ref:`performing_basic_sqream_operations` | Provides more information on performing basic operations. | ++---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ +| :ref:`hardware_guide` | Describes SQream’s mandatory and recommended hardware settings, designed for a technical audience. | ++---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ +| **Installation Guides** | ++---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ +| :ref:`installing_and_launching_sqream` | Refers to SQream’s installation guides. | ++---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ +| :ref:`sqream_studio_installation` | Refers to all installation guides required for installations related to Studio. | ++---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ +| **Ingesting Data** | ++--------------------------+------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ +| :ref:`csv` | :ref:`avro` | | ++--------------------------+------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ +| :ref:`parquet` | :ref:`orc` | | ++--------------------------+------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ +| :ref:`oracle` | ++--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| **Connecting to SQream** | ++--------------------------+------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ +| :ref:`client_platforms` | Describes how to install and connect a variety of third party connection platforms and tools. | ++---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ +| :ref:`client_drivers` | Describes how to use the SQream client drivers and client applications with SQream. | ++---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ +| **External Storage Platforms** | ++---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ +| :ref:`s3` | Describes how to insert data over a native S3 connector. | ++---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ +| :ref:`hdfs` | Describes how to configure an HDFS environment for the user sqream and is only relevant for users with an HDFS environment. | ++---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + + + Loading and unloading data: + + * Loading data: + + * Overview of loading data + * Alternatives to loading data (foreign tables) + * Supported data types + * Ingesting data from external sources + * Inserting data from external tables + * Ingesting data from third party client platforms + * Using the **COPY FROM** statement + * Importing data using Studio + * Loading data using Amazon S3 + + * Unloading data: + + * Overview of unloading data + * Using the **COPY TO** statement + + Feature guides: + + * Query Healer + * Automatic schema Identification + * Compression + * Python UDF (User-Defined Functions) + * Workload Manager + * Transactions + * Concurrency and locks + * Concurrency and scaling in SQream DB + + Operational guides: + + * Access control + * Creating or cloning storage clusters + * Foreign tables + * Deleting data + * Exporting data + * Logging + * Monitoring query performance + * Security + * Saved queries + * Seeing system objects as DDL + * Optimization and best practices + + SQream Accelerated Studio 5.4.3: + + * Getting started with SQream Acceleration Studio 5.4.3 + * Monitoring workers and services from the dashboard + * Executing statements and running queries from the Editor + * Viewing logs + * Creating, assigning, and managing roles and permissions + * Configuring Your instance of SQream + + System architecture: + + * Internals and architecture + * Filesystem and usage + + Configuring SQream: + + * Configuration methods + * Configuration flags + + Reference guides: + + * SQL syntax, statements, and functions + * Catalog reference guide + * Command Line programs + * SQL feature checklist + * Python API reference guide + + Data type guides: + + * Converting and casting + * Supported data types + * Supported casts + + Release notes: + + * 2022.1 + * 2021.2 + * 2021.1 + * 2020.3 + * 2020.2 + * 2020.1 + + Troubleshooting: + + * Remedying slow queries + * Resolving common issues + * Examining logs + * Identifying configuration issues + * Lock related issues + * SAS Viya related issues + * Tableau related issues + * Solving “Code 126” ODBC errors + * Log related issues + * Node.js related issues + * Core dumping related issues + * SQream SQL installation related issues + * Gathering information for SQream support + + Glossary + @@ -85,9 +175,9 @@ If you couldn't find what you're looking for, we're always happy to help. Visit .. rubric:: Looking for older versions? -This version of the documentation is for SQream DB Version 2022.1. +This version of the documentation is for SQream DB Version 2021.2. -If you're looking for an older version of the documentation, versions 1.10 through 2019.2.1 are available at http://previous.sqream.com. +If you're looking for an older version of the documentation, versions 1.10 through 2019.2.1 are available at http://previous.sqream.com . .. toctree:: :caption: Contents: @@ -100,7 +190,6 @@ If you're looking for an older version of the documentation, versions 1.10 throu installation_guides/index data_ingestion/index connecting_to_sqream/index - external_storage_platforms/index loading_and_unloading_data/index feature_guides/index operational_guides/index @@ -114,9 +203,9 @@ If you're looking for an older version of the documentation, versions 1.10 throu glossary .. - Indices and Tables + Indices and tables ================== * :ref:`genindex` * :ref:`modindex` - * :ref:`search` \ No newline at end of file + * :ref:`search` diff --git a/operational_guides/hdfs.rst b/operational_guides/hdfs.rst new file mode 100644 index 000000000..e59c49cc7 --- /dev/null +++ b/operational_guides/hdfs.rst @@ -0,0 +1,265 @@ +.. _hdfs: + +.. _back_to_top_hdfs: + +Using SQream in an HDFS Environment +======================================= + +.. _configuring_an_hdfs_environment_for_the_user_sqream: + +Configuring an HDFS Environment for the User **sqream** +---------------------------------------------------------- + +This section describes how to configure an HDFS environment for the user **sqream** and is only relevant for users with an HDFS environment. + +**To configure an HDFS environment for the user sqream:** + +1. Open your **bash_profile** configuration file for editing: + + .. code-block:: console + + $ vim /home/sqream/.bash_profile + +.. + Comment: - see below; do we want to be a bit more specific on what changes we're talking about? + + .. code-block:: console + + $ #PATH=$PATH:$HOME/.local/bin:$HOME/bin + + $ #export PATH + + $ # PS1 + $ #MYIP=$(curl -s -XGET "http://ip-api.com/json" | python -c 'import json,sys; jstr=json.load(sys.stdin); print jstr["query"]') + $ #PS1="\[\e[01;32m\]\D{%F %T} \[\e[01;33m\]\u@\[\e[01;36m\]$MYIP \[\e[01;31m\]\w\[\e[37;36m\]\$ \[\e[1;37m\]" + + $ SQREAM_HOME=/usr/local/sqream + $ export SQREAM_HOME + + $ export JAVA_HOME=${SQREAM_HOME}/hdfs/jdk + $ export HADOOP_INSTALL=${SQREAM_HOME}/hdfs/hadoop + $ export CLASSPATH=`${HADOOP_INSTALL}/bin/hadoop classpath --glob` + $ export HADOOP_COMMON_LIB_NATIVE_DIR=${HADOOP_INSTALL}/lib/native + $ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${SQREAM_HOME}/lib:$HADOOP_COMMON_LIB_NATIVE_DIR + + + $ PATH=$PATH:$HOME/.local/bin:$HOME/bin:${SQREAM_HOME}/bin/:${JAVA_HOME}/bin:$HADOOP_INSTALL/bin + $ export PATH + +2. Verify that the edits have been made: + + .. code-block:: console + + source /home/sqream/.bash_profile + +3. Check if you can access Hadoop from your machine: + + .. code-block:: console + + $ hadoop fs -ls hdfs://:8020/ + +.. + Comment: - + **NOTICE:** If you cannot access Hadoop from your machine because it uses Kerberos, see `Connecting a SQream Server to Cloudera Hadoop with Kerberos `_ + + +4. Verify that an HDFS environment exists for SQream services: + + .. code-block:: console + + $ ls -l /etc/sqream/sqream_env.sh + +.. _step_6: + + +5. If an HDFS environment does not exist for SQream services, create one (sqream_env.sh): + + .. code-block:: console + + $ #!/bin/bash + + $ SQREAM_HOME=/usr/local/sqream + $ export SQREAM_HOME + + $ export JAVA_HOME=${SQREAM_HOME}/hdfs/jdk + $ export HADOOP_INSTALL=${SQREAM_HOME}/hdfs/hadoop + $ export CLASSPATH=`${HADOOP_INSTALL}/bin/hadoop classpath --glob` + $ export HADOOP_COMMON_LIB_NATIVE_DIR=${HADOOP_INSTALL}/lib/native + $ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${SQREAM_HOME}/lib:$HADOOP_COMMON_LIB_NATIVE_DIR + + + $ PATH=$PATH:$HOME/.local/bin:$HOME/bin:${SQREAM_HOME}/bin/:${JAVA_HOME}/bin:$HADOOP_INSTALL/bin + $ export PATH + +:ref:`Back to top ` + +.. _authenticate_hadoop_servers_that_require_kerberos: + +Authenticating Hadoop Servers that Require Kerberos +--------------------------------------------------- +If your Hadoop server requires Kerberos authentication, do the following: + +1. Create a principal for the user **sqream**. + + .. code-block:: console + + $ kadmin -p root/admin@SQ.COM + $ addprinc sqream@SQ.COM + +2. If you do not know yor Kerberos root credentials, connect to the Kerberos server as a root user with ssh and run **kadmin.local**: + + .. code-block:: console + + $ kadmin.local + + Running **kadmin.local** does not require a password. + +3. If a password is not required, change your password to **sqream@SQ.COM**. + + .. code-block:: console + + $ change_password sqream@SQ.COM + +4. Connect to the hadoop name node using ssh: + + .. code-block:: console + + $ cd /var/run/cloudera-scm-agent/process + +5. Check the most recently modified content of the directory above: + + .. code-block:: console + + $ ls -lrt + +6. Look for a recently updated folder containing the text **hdfs**. + + The following is an example of the correct folder name: + + .. code-block:: console + + cd -hdfs- + + This folder should contain a file named **hdfs.keytab** or another similar .keytab file. + + + +.. + Comment: - Does "something" need to be replaced with "file name" + + +7. Copy the .keytab file to user **sqream's** Home directory on the remote machines that you are planning to use Hadoop on. + + :: + +8. Copy the following files to the **sqream sqream@server:/hdfs/hadoop/etc/hadoop:** directory: + + * core-site.xml + * hdfs-site.xml + +9. Connect to the sqream server and verify that the .keytab file's owner is a user sqream and is granted the correct permissions: + + .. code-block:: console + + $ sudo chown sqream:sqream /home/sqream/hdfs.keytab + $ sudo chmod 600 /home/sqream/hdfs.keytab + +10. Log into the sqream server. + + :: + +11. Log in as the user **sqream**. + + :: + +12. Navigate to the Home directory and check the name of a Kerberos principal represented by the following .keytab file: + + .. code-block:: console + + $ klist -kt hdfs.keytab + + The following is an example of the correct output: + + .. code-block:: console + + $ sqream@Host-121 ~ $ klist -kt hdfs.keytab + $ Keytab name: FILE:hdfs.keytab + $ KVNO Timestamp Principal + $ ---- ------------------- ------------------------------------------------------ + $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + +13. Verify that the hdfs service named **hdfs/nn1@SQ.COM** is shown in the generated output above. + + :: + +14. Run the following: + + .. code-block:: console + + $ kinit -kt hdfs.keytab hdfs/nn1@SQ.COM + +15. Verify that the output is correct: + + .. code-block:: console + + $ klist + + The following is an example of the correct output: + + .. code-block:: console + + $ Ticket cache: FILE:/tmp/krb5cc_1000 + $ Default principal: sqream@SQ.COM + $ + $ Valid starting Expires Service principal + $ 09/16/2020 13:44:18 09/17/2020 13:44:18 krbtgt/SQ.COM@SQ.COM + +16. List the files located at the defined server name or IP address: + + .. code-block:: console + + $ hadoop fs -ls hdfs://:8020/ + +17. Do one of the following: + + :: + + * If the list below is output, continue with Step 18. + + :: + + * If the list is not output, verify that your environment has been set up correctly. + +If any of the following are empty, verify that you followed :ref:`Step 6 ` in the **Configuring an HDFS Environment for the User sqream** section above correctly: + + .. code-block:: console + + $ echo $JAVA_HOME + $ echo $SQREAM_HOME + $ echo $CLASSPATH + $ echo $HADOOP_COMMON_LIB_NATIVE_DIR + $ echo $LD_LIBRARY_PATH + $ echo $PATH + +18. Verify that you copied the correct keytab file. + + :: + +19. Review this procedure to verify that you have followed each step. + +:ref:`Back to top ` \ No newline at end of file diff --git a/operational_guides/index.rst b/operational_guides/index.rst index 25e2cdff2..048efb06f 100644 --- a/operational_guides/index.rst +++ b/operational_guides/index.rst @@ -14,12 +14,15 @@ This section summarizes the following operational guides: access_control creating_or_cloning_a_storage_cluster + external_data foreign_tables delete_guide exporting_data logging monitoring_query_performance security + saved_queries seeing_system_objects_as_ddl configuration optimization_best_practices + hardware_guide diff --git a/operational_guides/s3.rst b/operational_guides/s3.rst new file mode 100644 index 000000000..5e4f8b264 --- /dev/null +++ b/operational_guides/s3.rst @@ -0,0 +1,129 @@ +.. _s3: + +*********************** +Inserting Data Using Amazon S3 +*********************** +SQream uses a native S3 connector for directly inserting data from a number of external sources directly into SQream. This is done using the ``s3://`` URI to specify an external file path on an S3 bucket. Your files can be saved in CSV or columnar format, such as Parquet and ORC, and your file names can include wildcard characters. + +The **Amazon S3** page describes the following topics: + +.. contents:: + :local: + :depth: 1 + +Configuring Amazon S3 +============================== +Any database host with access to S3 endpoints can access S3 without any configuration. To read files from an S3 bucket, the database must have listable files. + +Setting the S3 URI Format +=============== +With S3, specify a location for a file (or files) when using :ref:`copy_from` or :ref:`external_tables`. + +The following is an example of the general S3 syntax: + +.. code-block:: console + + s3://bucket_name/path + +Authenticating Users +================= + +SQream supports ``AWS ID`` and ``AWS SECRET`` authentication. These should be specified when executing a statement. + +Examples +========== +You can use a foreign table to stage data from S3 before loading from CSV, Parquet, or ORC files. + +This section includes the following examples: + +.. contents:: + :local: + :depth: 1 + +Planning for Data Staging +-------------------------------- +The examples in this section are based on the CSV file shown in the following table: + +.. csv-table:: nba-t10 + :file: ../_static/samples/nba-t10.csv + :widths: auto + :header-rows: 1 + +This CSV file is stored on Amazon S3, and this bucket is public and listable. To create a matching ``CREATE FOREIGN TABLE`` statement you can make a record of your source file's structure and use it to reproduce a corresponding foreign table, as shown in the following section. + +Creating a Foreign Table +----------------------------- +Based on the source file's structure above, you can create a foreign table with the structure you want and point it to your file, as shown in the following example: + +.. code-block:: postgres + + CREATE FOREIGN TABLE nba + ( + Name text(40), + Team text(40), + Number tinyint, + Position text(2), + Age tinyint, + Height text(4), + Weight real, + College text(40), + Salary float + ) + WRAPPER csv_fdw + OPTIONS + ( + LOCATION = 's3://sqream-demo-data/nba_players.csv', + RECORD_DELIMITER = '\r\n' -- DOS delimited file + ) + ; + +.. note:: In the example above the file format is CSV and is stored as an S3 object. If your file has an HDFS path, you must change the URI accordingly. Note that the record delimiter is a DOS newline (``\r\n``). + +For more information, see the following: + +* **Creating a foreign table** - see :ref:`creating a foreign table`. +* **Using SQream in an HDFS environment** - see :ref:`hdfs`. + +Querying Foreign Tables +------------------------------ +The following shows the data located in the foreign table: + +.. code-block:: psql + + t=> SELECT * FROM nba LIMIT 10; + name | team | number | position | age | height | weight | college | salary + --------------+----------------+--------+----------+-----+--------+--------+-------------------+--------- + Avery Bradley | Boston Celtics | 0 | PG | 25 | 6-2 | 180 | Texas | 7730337 + Jae Crowder | Boston Celtics | 99 | SF | 25 | 6-6 | 235 | Marquette | 6796117 + John Holland | Boston Celtics | 30 | SG | 27 | 6-5 | 205 | Boston University | + R.J. Hunter | Boston Celtics | 28 | SG | 22 | 6-5 | 185 | Georgia State | 1148640 + Jonas Jerebko | Boston Celtics | 8 | PF | 29 | 6-10 | 231 | | 5000000 + Amir Johnson | Boston Celtics | 90 | PF | 29 | 6-9 | 240 | | 12000000 + Jordan Mickey | Boston Celtics | 55 | PF | 21 | 6-8 | 235 | LSU | 1170960 + Kelly Olynyk | Boston Celtics | 41 | C | 25 | 7-0 | 238 | Gonzaga | 2165160 + Terry Rozier | Boston Celtics | 12 | PG | 22 | 6-2 | 190 | Louisville | 1824360 + Marcus Smart | Boston Celtics | 36 | PG | 22 | 6-4 | 220 | Oklahoma State | 3431040 + +Bulk Loading a File from a Public S3 Bucket +---------------------------------------------- +Youc an use the ``COPY FROM`` command to load data without staging it first. + +.. note:: The bucket must be publicly available and objects can be listed. + +The following is an example of bulk loading a file from a public S3 bucket: + +.. code-block:: postgres + + COPY nba FROM 's3://sqream-demo-data/nba.csv' WITH OFFSET 2 RECORD DELIMITER '\r\n'; + +For more information on the ``COPY FROM`` command, see :ref:`copy_from`. + +Loading Files from an Authenticated S3 Bucket +--------------------------------------------------- +The following is an example of loading fles from an authenticated S3 bucket: + +.. code-block:: postgres + + COPY nba FROM 's3://secret-bucket/*.csv' WITH OFFSET 2 RECORD DELIMITER '\r\n' + AWS_ID '12345678' + AWS_SECRET 'super_secretive_secret'; \ No newline at end of file From 491cbfbe35c659fd7e84b7efcd7369300f90f14a Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Tue, 8 Nov 2022 15:24:32 +0200 Subject: [PATCH 272/882] Update copy_to.rst --- reference/sql/sql_statements/dml_commands/copy_to.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/copy_to.rst b/reference/sql/sql_statements/dml_commands/copy_to.rst index bd32a325f..0edb0a4d6 100644 --- a/reference/sql/sql_statements/dml_commands/copy_to.rst +++ b/reference/sql/sql_statements/dml_commands/copy_to.rst @@ -32,7 +32,7 @@ The following is the correct syntax for using the **COPY TO** statement: ) ; - fdw_name ::= csw_fdw | parquet_fdw | orc_fdw + fdw_name ::= csv_fdw | parquet_fdw | orc_fdw schema_name ::= identifer @@ -84,7 +84,7 @@ The following table shows the ``COPY_TO`` elements: * - ``query`` - An SQL query that returns a table result, or a table name * - ``fdw_name`` - - The name of the Foreign Data Wrapper to use. Supported FDWs are ``csv_fdw``, ``orc_fdw``, or ``parquet_fdw``. + - The name of the Foreign Data Wrapper to use. Supported FDWs are ``csv_fdw``, ``orc_fdw``, ``avro_fdw`` or ``parquet_fdw``. * - ``LOCATION`` - A path on the local filesystem, S3, or HDFS URI. For example, ``/tmp/foo.csv``, ``s3://my-bucket/foo.csv``, or ``hdfs://my-namenode:8020/foo.csv``. The local path must be an absolute path that SQream DB can access. * - ``HEADER`` @@ -545,4 +545,4 @@ The following is an example of exporting a table to an ORC file: Permissions ============= -The role must have the ``SELECT`` permission on every table or schema that is referenced by the statement. +The role must have the ``SELECT`` permission on every table or schema that is referenced by the statement. \ No newline at end of file From 950a058487677ae4b53a86ab6d1114de6fc62d72 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Wed, 16 Nov 2022 13:12:45 +0200 Subject: [PATCH 273/882] Added 2022.1.6 release notes --- releases/2022.1.6.rst | 116 ++++++++++++++++++++++++++++++++++++++ releases/2022.1_index.rst | 1 + 2 files changed, 117 insertions(+) create mode 100644 releases/2022.1.6.rst diff --git a/releases/2022.1.6.rst b/releases/2022.1.6.rst new file mode 100644 index 000000000..be3e40b76 --- /dev/null +++ b/releases/2022.1.6.rst @@ -0,0 +1,116 @@ +.. _2022.1.5: + +************************** +Release Notes 2022.1.6 +************************** +The 2022.1.5 release notes were released on 11/02/2022 and describe the following: + +.. contents:: + :local: + :depth: 1 + +New Features +---------- +The 2022.1.5 Release Notes include the following new features: + +* keys_evaluate utility function enhancement - add problematic chunk ID to the function's output report. + + :: + +* Automatically close database client connections that have been open for 24 hours without any active statements. + + :: + +* release_defunct_locks utility function enhancement to receive new optional input parameter to specify timeout - for more details see `Lock Related Issues <../troubleshooting/lock_related_issues.html>`_. + + + + +Known Issues +--------- +Recently discovered issue with the encryption feature, at this time SQream recommends to avoid using this feature - a fix will be introduced in the near future. + + +Resolved Issues +--------- +The following table lists the issues that were resolved in Version 2022.1.5: + ++--------------+------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++==============+==========================================================================================+ +| SQ-11081 | Tableau connection are not getting closed | ++--------------+------------------------------------------------------------------------------------------+ +| SQ-11473 | SQream Command Line Interface connectivity issues | ++--------------+------------------------------------------------------------------------------------------+ +| SQ-11551 | SQream Studio Logs pages filtering issues | ++--------------+------------------------------------------------------------------------------------------+ +| SQ-11631 | Log related configuration flags are not working as expected | ++--------------+------------------------------------------------------------------------------------------+ +| SQ-11745 | Missing validation of sufficient GPU memory | ++--------------+------------------------------------------------------------------------------------------+ +| SQ-11792 | CUME_DIST function causes query execution errors | ++--------------+------------------------------------------------------------------------------------------+ +| SQ-11905 | GetDate casting to as text returns DATE with 0s in the time part or no time part at all | ++--------------+------------------------------------------------------------------------------------------+ + + + + + +Operations and Configuration Changes +-------- +No configuration changes were made. + +Naming Changes +------- +No relevant naming changes were made. + +Deprecated Features +------- +SQream is declaring end of support of VARCHAR data type, the decision resulted by SQream's effort to enhance its core functionalities and with respect to ever changing echo system requirements. + +VARCHAR is no longer supported for new customers - effective from Version 2022.1.3 (September 2022). + +TEXT data type is replacing VARCHAR - SQream will maintain VARCHAR data type support until 09/30/2023. + + +End of Support +------- +No End of Support changes were made. + +Upgrading to v2022.1.5 +------- +1. Generate a back-up of the metadata by running the following command: + + .. code-block:: console + + $ select backup_metadata('out_path'); + + .. tip:: SQream recommends storing the generated back-up locally in case needed. + + SQream runs the Garbage Collector and creates a clean backup tarball package. + +2. Shut down all SQream services. + + :: + +3. Extract the recently created back-up file. + + :: + +4. Replace your current metadata with the metadata you stored in the back-up file. + + :: + +5. Navigate to the new SQream package bin folder. + + :: + +6. Run the following command: + + .. code-block:: console + + $ ./upgrade_storage + + .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. + diff --git a/releases/2022.1_index.rst b/releases/2022.1_index.rst index d6522a59b..1e2c0d256 100644 --- a/releases/2022.1_index.rst +++ b/releases/2022.1_index.rst @@ -13,6 +13,7 @@ The 2022.1 Release Notes describe the following releases: :maxdepth: 1 :glob: + 2022.1.6 2022.1.5 2022.1.4 2022.1.3 From 068ca0ebb206712b47d866a52fe31d2f5df1bbd5 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Wed, 16 Nov 2022 13:21:16 +0200 Subject: [PATCH 274/882] Update create_table.rst --- reference/sql/sql_statements/ddl_commands/create_table.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/ddl_commands/create_table.rst b/reference/sql/sql_statements/ddl_commands/create_table.rst index 9fd4bacf5..f32afe2dd 100644 --- a/reference/sql/sql_statements/ddl_commands/create_table.rst +++ b/reference/sql/sql_statements/ddl_commands/create_table.rst @@ -74,7 +74,7 @@ Default Value Constraints The ``DEFAULT`` value constraint specifies a value to use if one is not defined in an :ref:`insert` or :ref:`copy_from` statement. -The value may either be NULL or a literal. +The default value may be a literal, GETDATE(), or NULL. .. note:: The ``DEFAULT`` constraint only applies if the column does not have a value specified in the :ref:`insert` or :ref:`copy_from` statement. You can still insert a ``NULL`` into an nullable column by explicitly inserting ``NULL``. For example, ``INSERT INTO cool_animals VALUES (1, 'Gnu', NULL)``. From 633adb18de6fa580a41d60ed2fbabe69335646d2 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Wed, 16 Nov 2022 13:56:02 +0200 Subject: [PATCH 275/882] Updates whole Client Drivers section --- .../client_drivers/cpp/connect_test.cpp | 34 ++ .../client_drivers/cpp/index.rst | 86 +++ .../client_drivers/cpp/insert_test.cpp | 39 ++ connecting_to_sqream/client_drivers/index.rst | 44 +- .../client_drivers/nodejs/index.rst | 382 ++++++++++++ .../client_drivers/nodejs/sample.js | 21 + .../client_drivers/python/index.rst | 568 ++++++++++++++++++ .../client_drivers/python/nba-t10.csv | 10 + .../client_drivers/python/test.py | 37 ++ 9 files changed, 1212 insertions(+), 9 deletions(-) create mode 100644 connecting_to_sqream/client_drivers/cpp/connect_test.cpp create mode 100644 connecting_to_sqream/client_drivers/cpp/index.rst create mode 100644 connecting_to_sqream/client_drivers/cpp/insert_test.cpp create mode 100644 connecting_to_sqream/client_drivers/nodejs/index.rst create mode 100644 connecting_to_sqream/client_drivers/nodejs/sample.js create mode 100644 connecting_to_sqream/client_drivers/python/index.rst create mode 100644 connecting_to_sqream/client_drivers/python/nba-t10.csv create mode 100644 connecting_to_sqream/client_drivers/python/test.py diff --git a/connecting_to_sqream/client_drivers/cpp/connect_test.cpp b/connecting_to_sqream/client_drivers/cpp/connect_test.cpp new file mode 100644 index 000000000..82365af4e --- /dev/null +++ b/connecting_to_sqream/client_drivers/cpp/connect_test.cpp @@ -0,0 +1,34 @@ +// Trivial example + +#include + +#include "sqream.h" + +int main () { + + sqream::driver sqc; + + // Connection parameters: Hostname, Port, Use SSL, Username, Password, + // Database name, Service name + sqc.connect("127.0.0.1", 5000, false, "rhendricks", "Tr0ub4dor&3", + "raviga", "sqream"); + + // create table with data + run_direct_query(&sqc, "CREATE TABLE test_table (x int)"); + run_direct_query(&sqc, "INSERT INTO test_table VALUES (5), (6), (7), (8)"); + + // query it + sqc.new_query("SELECT * FROM test_table"); + sqc.execute_query(); + + // See the results + while (sqc.next_query_row()) { + std::cout << "Received: " << sqc.get_int(0) << std::endl; + } + + sqc.finish_query(); + + // Close the connection completely + sqc.disconnect(); + +} diff --git a/connecting_to_sqream/client_drivers/cpp/index.rst b/connecting_to_sqream/client_drivers/cpp/index.rst new file mode 100644 index 000000000..7cbabd1ef --- /dev/null +++ b/connecting_to_sqream/client_drivers/cpp/index.rst @@ -0,0 +1,86 @@ +.. _cpp_native: + +************************* +C++ Driver +************************* + +The SQream DB C++ driver allows C++ programs and tools to connect to SQream DB. + +This tutorial shows how to write a C++ program that uses this driver. + +.. contents:: In this topic: + :depth: 2 + :local: + + +Installing the C++ Driver +================================== + +Prerequisites +---------------- + +The SQream DB C++ driver was built on 64-bit Linux, and is designed to work with RHEL 7 and Ubuntu 16.04 and newer. + +Getting the Library +--------------------- + +The C++ driver is provided as a tarball containing the compiled ``libsqream.so`` file and a header ``sqream.h``. Get the driver from the `SQream Drivers page `_. The library can be integrated into your C++-based applications or projects. + + +Extract the Tarball Archive +----------------------------- + +Extract the library files from the tarball + +.. code-block:: console + + $ tar xf libsqream-3.0.tar.gz + +Examples +============================================== + +Assuming there is a SQream DB worker to connect to, we'll connect to it using the application and run some statements. + +Testing the Connection to SQream +-------------------------------------------- + +Download this file by right clicking and saving to your computer :download:`connect_test.cpp `. + +.. literalinclude:: connect_test.cpp + :language: cpp + :caption: Connect to SQream DB + :linenos: + + +Compiling and Running the Application +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +To build this code, place the library and header file in ./libsqream-3.0/ and run + +.. code-block:: console + + $ g++ -Wall -Ilibsqream-3.0 -Llibsqream-3.0 -lsqream connect_test.cpp -o connect_test + $ ./connect_test + +Modify the ``-I`` and ``-L`` arguments to match the ``.so`` library and ``.h`` file if they are in another directory. + +Creating a Table and Inserting Values +-------------------------------------------- + +Download this file by right clicking and saving to your computer :download:`insert_test.cpp `. + +.. literalinclude:: insert_test.cpp + :language: cpp + :caption: Inserting data to a SQream DB table + :linenos: + + +Compiling and Running the Application +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +To build this code, use + +.. code-block:: console + + $ g++ -Wall -Ilibsqream-3.0 -Llibsqream-3.0 -lsqream insert_test.cpp -o insert_test + $ ./insert_test \ No newline at end of file diff --git a/connecting_to_sqream/client_drivers/cpp/insert_test.cpp b/connecting_to_sqream/client_drivers/cpp/insert_test.cpp new file mode 100644 index 000000000..d395be31a --- /dev/null +++ b/connecting_to_sqream/client_drivers/cpp/insert_test.cpp @@ -0,0 +1,39 @@ +// Insert with parameterized statement example + +#include + +#include "sqream.h" + +int main () { + + sqream::driver sqc; + + // Connection parameters: Hostname, Port, Use SSL, Username, Password, + // Database name, Service name + sqc.connect("127.0.0.1", 5000, false, "rhendricks", "Tr0ub4dor&3", + "raviga", "sqream"); + + run_direct_query(&sqc, + "CREATE TABLE animals (id INT NOT NULL, name VARCHAR(10) NOT NULL)"); + + // prepare the statement + sqc.new_query("INSERT INTO animals VALUES (?, ?)"); + sqc.execute_query(); + + // Data to insert + int row0[] = {1,2,3}; + std::string row1[] = {"Dog","Cat","Possum"}; + int len = sizeof(row0)/sizeof(row0[0]); + + for (int i = 0; i < len; ++i) { + sqc.set_int(0, row0[i]); + sqc.set_varchar(1, row1[i]); + sqc.next_query_row(); + } + + // This commits the insert + sqc.finish_query(); + + sqc.disconnect(); + +} diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index 5365380b9..f7ae2710d 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -1,7 +1,7 @@ .. _client_drivers: ************************************ -Client Drivers for 2022.1 +Client Drivers for 2022.1.6 ************************************ The guides on this page describe how to use the Sqream DB client drivers and client applications with SQream. @@ -17,15 +17,32 @@ The following are applicable to all operating systems: * **JDBC** - recommended installation via ``mvn``: - * `JDBC .jar file `_ - sqream-jdbc-4.5.4 (.jar) - * `JDBC driver `_ + * `JDBC .jar file `_ - sqream-jdbc-4.5.3 (.jar) + * `JDBC driver `_ + + +.. _python: + +* **Python** - Recommended installation via ``pip``: + + * `Python .tar file `_ - pysqream v3.1.3 (.tar.gz) + * `Python driver `_ + + +.. _nodejs: + +* **Node.JS** - Recommended installation via ``npm``: + + * `Node.JS `_ - sqream-v4.2.4 (.tar.gz) + * `Node.JS driver `_ + .. _tableau_connector: * **Tableau**: * `Tableau connector `_ - SQream (.taco) - * `Tableau manual installation `_ + * `Tableau manual installation `_ .. _powerbi_connector: @@ -33,17 +50,18 @@ The following are applicable to all operating systems: * **Power BI**: * `Power BI PowerQuery connector `_ - SQream (.mez) - * `Power BI manual installation `_ + * `Power BI manual installation `_ Windows -------------- The following are applicable to Windows: -* **ODBC installer** - SQream Drivers v2020.2.0, with Tableau customization. Please contact your `SQream representative `_ for this installer. +* **ODBC installer** - SQream Drivers v2020.2.0, with Tableau customizations. Please contact your `Sqream represenative `_ for this installer. For more information on installing and configuring ODBC on Windows, see :ref:`Install and configure ODBC on Windows `. + * **Net driver** - `SQream .Net driver v3.0.2 `_ @@ -53,17 +71,22 @@ Linux The following are applicable to Linux: * `SQream SQL (x86_64) `_ - sqream-sql-v2020.1.1_stable.x86_64.tar.gz -* `Sqream SQL CLI Reference `_ - Interactive command-line SQL client for Intel-based machines +* `Sqream SQL CLI Reference `_ - Interactive command-line SQL client for Intel-based machines :: * `SQream SQL*(IBM POWER9) `_ - sqream-sql-v2020.1.1_stable.ppc64le.tar.gz -* `Sqream SQL CLI Reference `_ - Interactive command-line SQL client for IBM POWER9-based machines +* `Sqream SQL CLI Reference `_ - Interactive command-line SQL client for IBM POWER9-based machines :: * ODBC Installer - Please contact your SQream representative for this installer. + :: + +* C++ connector - `libsqream-4.0 `_ +* `C++ shared object library `_ + .. toctree:: :maxdepth: 4 @@ -71,7 +94,10 @@ The following are applicable to Linux: :titlesonly: jdbc/index + python/index + nodejs/index odbc/index + cpp/index @@ -81,4 +107,4 @@ If you couldn't find what you're looking for, we're always happy to help. Visit .. rubric:: Looking for older drivers? -If you're looking for an older version of SQream DB drivers, versions 1.10 through 2019.2.1 are available at https://sqream.com/product/client-drivers/. +If you're looking for an older version of SQream DB drivers, versions 1.10 through 2019.2.1 are available at https://sqream.com/product/client-drivers/. \ No newline at end of file diff --git a/connecting_to_sqream/client_drivers/nodejs/index.rst b/connecting_to_sqream/client_drivers/nodejs/index.rst new file mode 100644 index 000000000..8ddd0d0bc --- /dev/null +++ b/connecting_to_sqream/client_drivers/nodejs/index.rst @@ -0,0 +1,382 @@ +.. _nodejs: + +************************* +Node.JS +************************* + +The SQream DB Node.JS driver allows Javascript applications and tools connect to SQream DB. +This tutorial shows you how to write a Node application using the Node.JS interface. + +The driver requires Node 10 or newer. + +.. contents:: In this topic: + :local: + +Installing the Node.JS driver +================================== + +Prerequisites +---------------- + +* Node.JS 10 or newer. Follow instructions at `nodejs.org `_ . + +Install with NPM +------------------- + +Installing with npm is the easiest and most reliable method. +If you need to install the driver in an offline system, see the offline method below. + +.. code-block:: console + + $ npm install @sqream/sqreamdb + +Install from an offline package +------------------------------------- + +The Node driver is provided as a tarball for download from the `SQream Drivers page `_ . + +After downloading the tarball, use ``npm`` to install the offline package. + +.. code-block:: console + + $ sudo npm install sqreamdb-4.0.0.tgz + + +Connect to SQream DB with a Node.JS application +==================================================== + +Create a simple test +------------------------------------------ + +Replace the connection parameters with real parameters for a SQream DB installation. + +.. code-block:: javascript + :caption: sqreamdb-test.js + + const Connection = require('@sqream/sqreamdb'); + + const config = { + host: 'localhost', + port: 3109, + username: 'rhendricks', + password: 'super_secret_password', + connectDatabase: 'raviga', + cluster: true, + is_ssl: true, + service: 'sqream' + }; + + const query1 = 'SELECT 1 AS test, 2*6 AS "dozen"'; + + const sqream = new Connection(config); + sqream.execute(query1).then((data) => { + console.log(data); + }, (err) => { + console.error(err); + }); + + +Run the test +---------------- + +A successful run should look like this: + +.. code-block:: console + + $ node sqreamdb-test.js + [ { test: 1, dozen: 12 } ] + + +API reference +==================== + +Connection parameters +--------------------------- + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Item + - Optional + - Default + - Description + * - ``host`` + - ✗ + - None + - Hostname for SQream DB worker. For example, ``127.0.0.1``, ``sqream.mynetwork.co`` + * - ``port`` + - ✗ + - None + - Port for SQream DB end-point. For example, ``3108`` for the load balancer, ``5000`` for a worker. + * - ``username`` + - ✗ + - None + - Username of a role to use for connection. For example, ``rhendricks`` + * - ``password`` + - ✗ + - None + - Specifies the password of the selected role. For example, ``Tr0ub4dor&3`` + * - ``connectDatabase`` + - ✗ + - None + - Database name to connect to. For example, ``master`` + * - ``service`` + - ✓ + - ``sqream`` + - Specifices service queue to use. For example, ``etl`` + * - ``is_ssl`` + - ✓ + - ``false`` + - Specifies SSL for this connection. For example, ``true`` + * - ``cluster`` + - ✓ + - ``false`` + - Connect via load balancer (use only if exists, and check port). For example, ``true`` + +Events +------------- + +The connector handles event returns with an event emitter + +getConnectionId + The ``getConnectionId`` event returns the executing connection ID. + +getStatementId + The ``getStatementId`` event returns the executing statement ID. + +getTypes + The ``getTypes`` event returns the results columns types. + +Example +^^^^^^^^^^^^^^^^^ + +.. code-block:: javascript + + const myConnection = new Connection(config); + + myConnection.runQuery(query1, function (err, data){ + myConnection.events.on('getConnectionId', function(data){ + console.log('getConnectionId', data); + }); + + myConnection.events.on('getStatementId', function(data){ + console.log('getStatementId', data); + }); + + myConnection.events.on('getTypes', function(data){ + console.log('getTypes', data); + }); + }); + +Input placeholders +------------------------- + +The Node.JS driver can replace parameters in a statement. + +Input placeholders allow values like user input to be passed as parameters into queries, with proper escaping. + +The valid placeholder formats are provided in the table below. + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Placeholder + - Type + * - ``%i`` + - Identifier (e.g. table name, column name) + * - ``%s`` + - A text string + * - ``%d`` + - A number value + * - ``%b`` + - A boolean value + +See the :ref:`input placeholders example` below. + +Examples +=============== + +Setting configuration flags +----------------------------------- + +SQream DB configuration flags can be set per statement, as a parameter to ``runQuery``. + +For example: + +.. code-block:: javascript + + const setFlag = 'SET showfullexceptioninfo = true;'; + + const query_string = 'SELECT 1'; + + const myConnection = new Connection(config); + myConnection.runQuery(query_string, function (err, data){ + console.log(err, data); + }, setFlag); + + +Lazyloading +----------------------------------- + +To process rows without keeping them in memory, you can lazyload the rows with an async: + +.. code-block:: javascript + + + const Connection = require('@sqream/sqreamdb'); + + const config = { + host: 'localhost', + port: 3109, + username: 'rhendricks', + password: 'super_secret_password', + connectDatabase: 'raviga', + cluster: true, + is_ssl: true, + service: 'sqream' + }; + + const sqream = new Connection(config); + + const query = "SELECT * FROM public.a_very_large_table"; + + (async () => { + const cursor = await sqream.executeCursor(query); + let count = 0; + for await (let rows of cursor.fetchIterator(100)) { + // fetch rows in chunks of 100 + count += rows.length; + } + await cursor.close(); + return count; + })().then((total) => { + console.log('Total rows', total); + }, (err) => { + console.error(err); + }); + + +Reusing a connection +----------------------------------- + +It is possible to execeute multiple queries with the same connection (although only one query can be executed at a time). + +.. code-block:: javascript + + const Connection = require('@sqream/sqreamdb'); + + const config = { + host: 'localhost', + port: 3109, + username: 'rhendricks', + password: 'super_secret_password', + connectDatabase: 'raviga', + cluster: true, + is_ssl: true, + service: 'sqream' + }; + + const sqream = new Connection(config); + + (async () => { + + const conn = await sqream.connect(); + try { + const res1 = await conn.execute("SELECT 1"); + const res2 = await conn.execute("SELECT 2"); + const res3 = await conn.execute("SELECT 3"); + conn.disconnect(); + return {res1, res2, res3}; + } catch (err) { + conn.disconnect(); + throw err; + } + + })().then((res) => { + console.log('Results', res) + }, (err) => { + console.error(err); + }); + + +.. _input_placeholders_example: + +Using placeholders in queries +----------------------------------- + +Input placeholders allow values like user input to be passed as parameters into queries, with proper escaping. + +.. code-block:: javascript + + const Connection = require('@sqream/sqreamdb'); + + const config = { + host: 'localhost', + port: 3109, + username: 'rhendricks', + password: 'super_secret_password', + connectDatabase: 'raviga', + cluster: true, + is_ssl: true, + service: 'sqream' + }; + + const sqream = new Connection(config); + + const sql = "SELECT %i FROM public.%i WHERE name = %s AND num > %d AND active = %b"; + + sqream.execute(sql, "col1", "table2", "john's", 50, true); + + +The query that will run is ``SELECT col1 FROM public.table2 WHERE name = 'john''s' AND num > 50 AND active = true`` + + +Troubleshooting and recommended configuration +================================================ + + +Preventing ``heap out of memory`` errors +-------------------------------------------- + +Some workloads may cause Node.JS to fail with the error: + +.. code-block:: none + + FATAL ERROR: CALL_AND_RETRY_LAST Allocation failed - JavaScript heap out of memory + +To prevent this error, modify the heap size configuration by setting the ``--max-old-space-size`` run flag. + +For example, set the space size to 2GB: + +.. code-block:: console + + $ node --max-old-space-size=2048 my-application.js + +BIGINT support +------------------------ + +The Node.JS connector supports fetching ``BIGINT`` values from SQream DB. However, some applications may encounter an error when trying to serialize those values. + +The error that appears is: +.. code-block:: none + + TypeError: Do not know how to serialize a BigInt + +This is because JSON specification do not support BIGINT values, even when supported by Javascript engines. + +To resolve this issue, objects with BIGINT values should be converted to string before serializing, and converted back after deserializing. + +For example: + +.. code-block:: javascript + + const rows = [{test: 1n}] + const json = JSON.stringify(rows, , (key, value) => + typeof value === 'bigint' + ? value.toString() + : value // return everything else unchanged + )); + console.log(json); // [{"test": "1"}] + diff --git a/connecting_to_sqream/client_drivers/nodejs/sample.js b/connecting_to_sqream/client_drivers/nodejs/sample.js new file mode 100644 index 000000000..cf3e19099 --- /dev/null +++ b/connecting_to_sqream/client_drivers/nodejs/sample.js @@ -0,0 +1,21 @@ +const Connection = require('@sqream/sqreamdb'); + +const config = { + host: 'localhost', + port: 3109, + username: 'rhendricks', + password: 'super_secret_password', + connectDatabase: 'raviga', + cluster: true, + is_ssl: true, + service: 'sqream' + }; + +const query1 = 'SELECT 1 AS test, 2*6 AS "dozen"'; + +const sqream = new Connection(config); +sqream.execute(query1).then((data) => { + console.log(data); +}, (err) => { + console.error(err); +}); \ No newline at end of file diff --git a/connecting_to_sqream/client_drivers/python/index.rst b/connecting_to_sqream/client_drivers/python/index.rst new file mode 100644 index 000000000..e03df343d --- /dev/null +++ b/connecting_to_sqream/client_drivers/python/index.rst @@ -0,0 +1,568 @@ +.. _pysqream: + +************************* +Python (pysqream) +************************* +The **Python** connector page describes the following: + +.. contents:: + :local: + :depth: 1 + +Overview +============= +The SQream Python connector is a set of packages that allows Python programs to connect to SQream DB. + +* ``pysqream`` is a pure Python connector. It can be installed with ``pip`` on any operating system, including Linux, Windows, and macOS. + +* ``pysqream-sqlalchemy`` is a SQLAlchemy dialect for ``pysqream`` + +The connector supports Python 3.6.5 and newer. The base ``pysqream`` package conforms to Python DB-API specifications `PEP-249 `_. + +Installing the Python Connector +================================== + +Prerequisites +---------------- +Installing the Python connector includes the following prerequisites: + +.. contents:: + :local: + :depth: 1 + +Python +^^^^^^^^^^^^ + +The connector requires Python 3.6.5 or newer. To verify your version of Python: + +.. code-block:: console + + $ python --version + Python 3.7.3 + + +.. note:: If both Python 2.x and 3.x are installed, you can run ``python3`` and ``pip3`` instead of ``python`` and ``pip`` respectively for the rest of this guide + +.. warning:: If you're running on an older version, ``pip`` will fetch an older version of ``pysqream``, with version <3.0.0. This version is currently not supported. + +PIP +^^^^^^^^^^^^ +The Python connector is installed via ``pip``, the Python package manager and installer. + +We recommend upgrading to the latest version of ``pip`` before installing. To verify that you are on the latest version, run the following command: + +.. code-block:: console + + $ python -m pip install --upgrade pip + Collecting pip + Downloading https://files.pythonhosted.org/packages/00/b6/9cfa56b4081ad13874b0c6f96af8ce16cfbc1cb06bedf8e9164ce5551ec1/pip-19.3.1-py2.py3-none-any.whl (1.4MB) + |████████████████████████████████| 1.4MB 1.6MB/s + Installing collected packages: pip + Found existing installation: pip 19.1.1 + Uninstalling pip-19.1.1: + Successfully uninstalled pip-19.1.1 + Successfully installed pip-19.3.1 + +.. note:: + * On macOS, you may want to use virtualenv to install Python and the connector, to ensure compatibility with the built-in Python environment + * If you encounter an error including ``SSLError`` or ``WARNING: pip is configured with locations that require TLS/SSL, however the ssl module in Python is not available.`` - please be sure to reinstall Python with SSL enabled, or use virtualenv or Anaconda. + +OpenSSL for Linux +^^^^^^^^^^^^^^^^^^^^^^^^^^ +Some distributions of Python do not include OpenSSL. The Python connector relies on OpenSSL for secure connections to SQream DB. + +* To install OpenSSL on RHEL/CentOS + + .. code-block:: console + + $ sudo yum install -y libffi-devel openssl-devel + +* To install OpenSSL on Ubuntu + + .. code-block:: console + + $ sudo apt-get install libssl-dev libffi-dev -y + +Installing via PIP +----------------- +The Python connector is available via `PyPi `_. + +Install the connector with ``pip``: + +.. code-block:: console + + $ pip install pysqream pysqream-sqlalchemy + +``pip`` will automatically install all necessary libraries and modules. + +Upgrading an Existing Installation +-------------------------------------- +The Python drivers are updated periodically. To upgrade an existing pysqream installation, use pip's ``-U`` flag: + +.. code-block:: console + + $ pip install pysqream pysqream-sqlalchemy -U + +Validating Your Installation +----------------------------- +This section describes how to validate your installation. + +**To validate your installation**: + +1. Create a file called ``test.py``, containing the following: + +.. literalinclude:: test.py + :language: python + :caption: pysqream Validation Script + :linenos: + +2. Verify that the parameters in the connection have been replaced with your respective SQream installation parameters. + + :: + +3. Run the test file to verify that you can connect to SQream: + + .. code-block:: console + + $ python test.py + Version: v2020.1 + + If the validation was successful, you can build an application using the SQream Python connector. If you receive a connection error, verify the following: + + * You have access to a running SQream database. + + :: + + * The connection parameters are correct. + +SQLAlchemy Examples +======================== +SQLAlchemy is an **Object-Relational Mapper (ORM) for Python. When you install the SQream dialect (``pysqream-sqlalchemy``) you can use frameworks such as Pandas, TensorFlow, and Alembic to query SQream directly. + +This section includes the following examples: + +.. contents:: + :local: + :depth: 1 + +Standard Connection Example +--------------------------------- +The following is a standard connection example: + +.. code-block:: python + + import sqlalchemy as sa + from sqlalchemy.engine.url import URL + + engine_url = URL('sqream' + , username='rhendricks' + , password='secret_passwor" + , host='localhost' + , port=5000 + , database='raviga' + , query={'use_ssl': False}) + + engine = sa.create_engine(engine_url) + + res = engine.execute('create table test (ints int)') + res = engine.execute('insert into test values (5), (6)') + res = engine.execute('select * from test') + +Pulling a Table into Pandas +--------------------------------- +The following example shows how to pull a table in Pandas. This examples uses the URL method to create the connection string: + +.. code-block:: python + + import sqlalchemy as sa + import pandas as pd + from sqlalchemy.engine.url import URL + + + engine_url = URL('sqream' + , username='rhendricks' + , password='secret_passwor" + , host='localhost' + , port=5000 + , database='raviga' + , query={'use_ssl': False}) + + engine = sa.create_engine(engine_url) + + table_df = pd.read_sql("select * from nba", con=engine) + +API Examples +=============== +This section includes the following examples: + +.. contents:: + :local: + :depth: 1 + +Describing Your Connection +--------------------------------------- +This example shows how to describe the connection. + +**Describing your connection**: + +1. Import the package and create a connection: + + .. code-block:: python + + # Import pysqream package + + import pysqream + + """ + Connection parameters include: + * IP/Hostname + * Port + * database name + * username + * password + * Connect through load balancer, or direct to worker (Default: false - direct to worker) + * use SSL connection (default: false) + * Optional service queue (default: 'sqream') + """ + + # Create a connection object + + con = pysqream.connect(host='127.0.0.1', port=3108, database='raviga' + , username='rhendricks', password='Tr0ub4dor&3' + , clustered=True) + +2. Run a query and fetch the results: + + .. code-block:: python + + cur = con.cursor() # Create a new cursor + # Prepare and execute a query + cur.execute('select show_version()') + + result = cur.fetchall() # `fetchall` gets the entire data set + + print (f"Version: {result[0][0]}") + + The SQream version should be output, such as ``v2020.1``. + +3. Close the connection: + + .. code-block:: python + + con.close() + +Using the Cursor +-------------------------------------------- +The DB-API specification includes several methods for fetching results from the cursor. This sections shows an example using the ``nba`` table, which looks as follows: + +.. csv-table:: nba + :file: nba-t10.csv + :widths: auto + :header-rows: 1 + +As before, you must import the library and create a :py:meth:`~Connection`, followed by :py:meth:`~Connection.execute` on a simple ``SELECT *`` query: + +.. code-block:: python + + import pysqream + con = pysqream.connect(host='127.0.0.1', port=3108, database='master' + , username='rhendricks', password='Tr0ub4dor&3' + , clustered=True) + + cur = con.cursor() # Create a new cursor + # The select statement: + statement = 'SELECT * FROM nba' + cur.execute(statement) + +When the statement has finished executing, you have a :py:meth:`Connection` cursor object waiting. A cursor is iterable, meaning that it advances the cursor to the next row when fetched. + +You can use :py:meth:`~Connection.fetchone` to fetch one record at a time: + +.. code-block:: python + + first_row = cur.fetchone() # Fetch one row at a time (first row) + + second_row = cur.fetchone() # Fetch one row at a time (second row) + +To fetch several rows at a time, use :py:meth:`~Connection.fetchmany`: + +.. code-block:: python + + # executing `fetchone` twice is equivalent to this form: + third_and_fourth_rows = cur.fetchmany(2) + +To fetch all rows at once, use :py:meth:`~Connection.fetchall`: + +.. code-block:: python + + # To get all rows at once, use `fetchall` + remaining_rows = cur.fetchall() + + # Close the connection when done + con.close() + +The following is an example of the contents of the row variables used in our examples: + +.. code-block:: pycon + + >>> print(first_row) + ('Avery Bradley', 'Boston Celtics', 0, 'PG', 25, '6-2', 180, 'Texas', 7730337) + >>> print(second_row) + ('Jae Crowder', 'Boston Celtics', 99, 'SF', 25, '6-6', 235, 'Marquette', 6796117) + >>> print(third_and_fourth_rows) + [('John Holland', 'Boston Celtics', 30, 'SG', 27, '6-5', 205, 'Boston University', None), ('R.J. Hunter', 'Boston Celtics', 28, 'SG', 22, '6-5', 185, 'Georgia State', 1148640)] + >>> print(remaining_rows) + [('Jonas Jerebko', 'Boston Celtics', 8, 'PF', 29, '6-10', 231, None, 5000000), ('Amir Johnson', 'Boston Celtics', 90, 'PF', 29, '6-9', 240, None, 12000000), ('Jordan Mickey', 'Boston Celtics', 55, 'PF', 21, '6-8', 235, 'LSU', 1170960), ('Kelly Olynyk', 'Boston Celtics', 41, 'C', 25, '7-0', 238, 'Gonzaga', 2165160), + [...] + +.. note:: Calling a fetch command after all rows have been fetched will return an empty array (``[]``). + +Reading Result Metadata +---------------------------- +When you execute a statement, the connection object also contains metadata about the result set, such as **column names**, **types**, etc). + +The metadata is stored in the :py:attr:`Connection.description` object of the cursor: + +.. code-block:: pycon + + >>> import pysqream + >>> con = pysqream.connect(host='127.0.0.1', port=3108, database='master' + ... , username='rhendricks', password='Tr0ub4dor&3' + ... , clustered=True) + >>> cur = con.cursor() + >>> statement = 'SELECT * FROM nba' + >>> cur.execute(statement) + + >>> print(cur.description) + [('Name', 'STRING', 24, 24, None, None, True), ('Team', 'STRING', 22, 22, None, None, True), ('Number', 'NUMBER', 1, 1, None, None, True), ('Position', 'STRING', 2, 2, None, None, True), ('Age (as of 2018)', 'NUMBER', 1, 1, None, None, True), ('Height', 'STRING', 4, 4, None, None, True), ('Weight', 'NUMBER', 2, 2, None, None, True), ('College', 'STRING', 21, 21, None, None, True), ('Salary', 'NUMBER', 4, 4, None, None, True)] + +You can fetch a list of column names by iterating over the ``description`` list: + +.. code-block:: pycon + + >>> [ i[0] for i in cur.description ] + ['Name', 'Team', 'Number', 'Position', 'Age (as of 2018)', 'Height', 'Weight', 'College', 'Salary'] + +Loading Data into a Table +--------------------------- +This example shows how to load 10,000 rows of dummy data to an instance of SQream. + +**To load data 10,000 rows of dummy data to an instance of SQream:** + +1. Run the following: + + .. code-block:: python + + import pysqream + from datetime import date, datetime + from time import time + + con = pysqream.connect(host='127.0.0.1', port=3108, database='master' + , username='rhendricks', password='Tr0ub4dor&3' + , clustered=True) + +2. Create a table for loading: + + .. code-block:: python + + create = 'create or replace table perf (b bool, t tinyint, sm smallint, i int, bi bigint, f real, d double, s varchar(12), ss text, dt date, dtt datetime)' + con.execute(create) + +3. Load your data into table using the ``INSERT`` command. + + :: + +4. Create dummy data matching the table you created: + + .. code-block:: python + + data = (False, 2, 12, 145, 84124234, 3.141, -4.3, "Marty McFly" , u"キウイは楽しい鳥です" , date(2019, 12, 17), datetime(1955, 11, 4, 1, 23, 0, 0)) + + row_count = 10**4 + +5. Get a new cursor: + + .. code-block:: python + + cur = con.cursor() + insert = 'insert into perf values (?,?,?,?,?,?,?,?,?,?,?)' + start = time() + cur.executemany(insert, [data] * row_count) + print (f"Total insert time for {row_count} rows: {time() - start} seconds") + +6. Close this cursor: + + .. code-block:: python + + cur.close() + +7. Verify that the data was inserted correctly. + + :: + +8. Get a new cursor: + + .. code-block:: python + + cur = con.cursor() + cur.execute('select count(*) from perf') + result = cur.fetchall() # `fetchall` collects the entire data set + print (f"Count of inserted rows: {result[0][0]}") + +9. Close the cursor: + + .. code-block:: python + + cur.close() + +10. Close the connection: + + .. code-block:: python + + con.close() + +Reading Data from a CSV File for Loading into a Table +---------------------------------------------------------- +This example shows how to write a helper function to create an :ref:`insert` statement, by reading an existing table's metadata. + +**To read data from a CSV file for loading into a table:** + +1. Run the following: + + .. code-block:: python + + import pysqream + import datetime + + def insert_from_csv(cur, table_name, csv_filename, field_delimiter = ',', null_markers = []): + """ +2. Ask SQream for some table information. + + This is important for determining the number of columns, and helps create a matching ``INSERT`` statement: + + .. code-block:: python + + """ + + column_info = cur.execute(f"SELECT * FROM {table_name} LIMIT 0").description + + + def parse_datetime(v): + try: + return datetime.datetime.strptime(row[i], '%Y-%m-%d %H:%M:%S.%f') + except ValueError: + try: + return datetime.datetime.strptime(row[i], '%Y-%m-%d %H:%M:%S') + except ValueError: + return datetime.datetime.strptime(row[i], '%Y-%m-%d') + +3. Create enough placeholders (`?`) for the ``INSERT`` query string: + + + .. code-block:: python + + qstring = ','.join(['?'] * len(column_info)) + insert_statement = f"insert into {table_name} values ({qstring})" + +4. Open the CSV file: + + .. code-block:: python + + with open(csv_filename, mode='r') as csv_file: + csv_reader = csv.reader(csv_file, delimiter=field_delimiter) + +5. Execute the ``INSERT`` statement with the CSV data: + + .. code-block:: python + + cur.executemany(insert_statement, [row for row in csv_reader]) + + + con = pysqream.connect(host='127.0.0.1', port=3108, database='master' + , username='rhendricks', password='Tr0ub4dor&3' + , clustered=True) + + cur = con.cursor() + insert_from_csv(cur, 'nba', 'nba.csv', field_delimiter = ',', null_markers = []) + + con.close() + +Using SQLAlchemy ORM to Create and Populate Tables +----------------------------------------------------------------------- +This section shows how to use the ORM to create and populate tables from Python objects. + +**To use SQLAlchemy ORM to create and populate tables:** + +1. Run the following: + + .. code-block:: python + + import sqlalchemy as sa + import pandas as pd + from sqlalchemy.engine.url import URL + + + engine_url = URL('sqream' + , username='rhendricks' + , password='secret_passwor" + , host='localhost' + , port=5000 + , database='raviga' + , query={'use_ssl': False}) + + engine = sa.create_engine(engine_url) + +2. Build a metadata object and bind it: + + .. code-block:: python + + metadata = sa.MetaData() + metadata.bind = engine + +3. Create a table in the local metadata: + + .. code-block:: python + + employees = sa.Table( + 'employees' + , metadata + , sa.Column('id', sa.Integer) + , sa.Column('name', sa.VARCHAR(32)) + , sa.Column('lastname', sa.VARCHAR(32)) + , sa.Column('salary', sa.Float) + ) + + The ``create_all()`` function uses the SQream engine object. + +4. Create all the defined table objects: + + .. code-block:: python + + metadata.create_all(engine) + +5. Populate your table. + + :: + +6. Build the data rows: + + .. code-block:: python + + insert_data = [ {'id': 1, 'name': 'Richard','lastname': 'Hendricks', 'salary': 12000.75} + ,{'id': 3, 'name': 'Bertram', 'lastname': 'Gilfoyle', 'salary': 8400.0} + ,{'id': 8, 'name': 'Donald', 'lastname': 'Dunn', 'salary': 6500.40} + ] + +7. Build the ``INSERT`` command: + + .. code-block:: python + + ins = employees.insert(insert_data) + +8. Execute the command: + + .. code-block:: python + + result = engine.execute(ins) + +For more information, see the :ref:`python_api_reference_guide`. \ No newline at end of file diff --git a/connecting_to_sqream/client_drivers/python/nba-t10.csv b/connecting_to_sqream/client_drivers/python/nba-t10.csv new file mode 100644 index 000000000..024530355 --- /dev/null +++ b/connecting_to_sqream/client_drivers/python/nba-t10.csv @@ -0,0 +1,10 @@ +Name,Team,Number,Position,Age,Height,Weight,College,Salary +Avery Bradley,Boston Celtics,0.0,PG,25.0,6-2,180.0,Texas,7730337.0 +Jae Crowder,Boston Celtics,99.0,SF,25.0,6-6,235.0,Marquette,6796117.0 +John Holland,Boston Celtics,30.0,SG,27.0,6-5,205.0,Boston University, +R.J. Hunter,Boston Celtics,28.0,SG,22.0,6-5,185.0,Georgia State,1148640.0 +Jonas Jerebko,Boston Celtics,8.0,PF,29.0,6-10,231.0,,5000000.0 +Amir Johnson,Boston Celtics,90.0,PF,29.0,6-9,240.0,,12000000.0 +Jordan Mickey,Boston Celtics,55.0,PF,21.0,6-8,235.0,LSU,1170960.0 +Kelly Olynyk,Boston Celtics,41.0,C,25.0,7-0,238.0,Gonzaga,2165160.0 +Terry Rozier,Boston Celtics,12.0,PG,22.0,6-2,190.0,Louisville,1824360.0 diff --git a/connecting_to_sqream/client_drivers/python/test.py b/connecting_to_sqream/client_drivers/python/test.py new file mode 100644 index 000000000..d7de6305a --- /dev/null +++ b/connecting_to_sqream/client_drivers/python/test.py @@ -0,0 +1,37 @@ +#!/usr/bin/env python + +import pysqream + +""" +Connection parameters include: +* IP/Hostname +* Port +* database name +* username +* password +* Connect through load balancer, or direct to worker (Default: false - direct to worker) +* use SSL connection (default: false) +* Optional service queue (default: 'sqream') +""" + +# Create a connection object + +con = pysqream.connect(host='127.0.0.1', port=5000, database='master' + , username='sqream', password='sqream' + , clustered=False) + +# Create a new cursor +cur = con.cursor() + +# Prepare and execute a query +cur.execute('select show_version()') + +result = cur.fetchall() # `fetchall` gets the entire data set + +print (f"Version: {result[0][0]}") + +# This should print the SQream DB version. For example ``Version: v2020.1``. + +# Finally, close the connection + +con.close() \ No newline at end of file From d17ce9fd22c666672b481ee2d716e44ae23cecb8 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Wed, 16 Nov 2022 14:44:48 +0200 Subject: [PATCH 276/882] Removed C++ from Client Driver documentation --- .../client_drivers/cpp/connect_test.cpp | 34 -------- .../client_drivers/cpp/index.rst | 86 ------------------- .../client_drivers/cpp/insert_test.cpp | 39 --------- connecting_to_sqream/client_drivers/index.rst | 5 -- 4 files changed, 164 deletions(-) delete mode 100644 connecting_to_sqream/client_drivers/cpp/connect_test.cpp delete mode 100644 connecting_to_sqream/client_drivers/cpp/index.rst delete mode 100644 connecting_to_sqream/client_drivers/cpp/insert_test.cpp diff --git a/connecting_to_sqream/client_drivers/cpp/connect_test.cpp b/connecting_to_sqream/client_drivers/cpp/connect_test.cpp deleted file mode 100644 index 82365af4e..000000000 --- a/connecting_to_sqream/client_drivers/cpp/connect_test.cpp +++ /dev/null @@ -1,34 +0,0 @@ -// Trivial example - -#include - -#include "sqream.h" - -int main () { - - sqream::driver sqc; - - // Connection parameters: Hostname, Port, Use SSL, Username, Password, - // Database name, Service name - sqc.connect("127.0.0.1", 5000, false, "rhendricks", "Tr0ub4dor&3", - "raviga", "sqream"); - - // create table with data - run_direct_query(&sqc, "CREATE TABLE test_table (x int)"); - run_direct_query(&sqc, "INSERT INTO test_table VALUES (5), (6), (7), (8)"); - - // query it - sqc.new_query("SELECT * FROM test_table"); - sqc.execute_query(); - - // See the results - while (sqc.next_query_row()) { - std::cout << "Received: " << sqc.get_int(0) << std::endl; - } - - sqc.finish_query(); - - // Close the connection completely - sqc.disconnect(); - -} diff --git a/connecting_to_sqream/client_drivers/cpp/index.rst b/connecting_to_sqream/client_drivers/cpp/index.rst deleted file mode 100644 index 7cbabd1ef..000000000 --- a/connecting_to_sqream/client_drivers/cpp/index.rst +++ /dev/null @@ -1,86 +0,0 @@ -.. _cpp_native: - -************************* -C++ Driver -************************* - -The SQream DB C++ driver allows C++ programs and tools to connect to SQream DB. - -This tutorial shows how to write a C++ program that uses this driver. - -.. contents:: In this topic: - :depth: 2 - :local: - - -Installing the C++ Driver -================================== - -Prerequisites ----------------- - -The SQream DB C++ driver was built on 64-bit Linux, and is designed to work with RHEL 7 and Ubuntu 16.04 and newer. - -Getting the Library ---------------------- - -The C++ driver is provided as a tarball containing the compiled ``libsqream.so`` file and a header ``sqream.h``. Get the driver from the `SQream Drivers page `_. The library can be integrated into your C++-based applications or projects. - - -Extract the Tarball Archive ------------------------------ - -Extract the library files from the tarball - -.. code-block:: console - - $ tar xf libsqream-3.0.tar.gz - -Examples -============================================== - -Assuming there is a SQream DB worker to connect to, we'll connect to it using the application and run some statements. - -Testing the Connection to SQream --------------------------------------------- - -Download this file by right clicking and saving to your computer :download:`connect_test.cpp `. - -.. literalinclude:: connect_test.cpp - :language: cpp - :caption: Connect to SQream DB - :linenos: - - -Compiling and Running the Application -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -To build this code, place the library and header file in ./libsqream-3.0/ and run - -.. code-block:: console - - $ g++ -Wall -Ilibsqream-3.0 -Llibsqream-3.0 -lsqream connect_test.cpp -o connect_test - $ ./connect_test - -Modify the ``-I`` and ``-L`` arguments to match the ``.so`` library and ``.h`` file if they are in another directory. - -Creating a Table and Inserting Values --------------------------------------------- - -Download this file by right clicking and saving to your computer :download:`insert_test.cpp `. - -.. literalinclude:: insert_test.cpp - :language: cpp - :caption: Inserting data to a SQream DB table - :linenos: - - -Compiling and Running the Application -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -To build this code, use - -.. code-block:: console - - $ g++ -Wall -Ilibsqream-3.0 -Llibsqream-3.0 -lsqream insert_test.cpp -o insert_test - $ ./insert_test \ No newline at end of file diff --git a/connecting_to_sqream/client_drivers/cpp/insert_test.cpp b/connecting_to_sqream/client_drivers/cpp/insert_test.cpp deleted file mode 100644 index d395be31a..000000000 --- a/connecting_to_sqream/client_drivers/cpp/insert_test.cpp +++ /dev/null @@ -1,39 +0,0 @@ -// Insert with parameterized statement example - -#include - -#include "sqream.h" - -int main () { - - sqream::driver sqc; - - // Connection parameters: Hostname, Port, Use SSL, Username, Password, - // Database name, Service name - sqc.connect("127.0.0.1", 5000, false, "rhendricks", "Tr0ub4dor&3", - "raviga", "sqream"); - - run_direct_query(&sqc, - "CREATE TABLE animals (id INT NOT NULL, name VARCHAR(10) NOT NULL)"); - - // prepare the statement - sqc.new_query("INSERT INTO animals VALUES (?, ?)"); - sqc.execute_query(); - - // Data to insert - int row0[] = {1,2,3}; - std::string row1[] = {"Dog","Cat","Possum"}; - int len = sizeof(row0)/sizeof(row0[0]); - - for (int i = 0; i < len; ++i) { - sqc.set_int(0, row0[i]); - sqc.set_varchar(1, row1[i]); - sqc.next_query_row(); - } - - // This commits the insert - sqc.finish_query(); - - sqc.disconnect(); - -} diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index f7ae2710d..43141714d 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -82,10 +82,6 @@ The following are applicable to Linux: * ODBC Installer - Please contact your SQream representative for this installer. - :: - -* C++ connector - `libsqream-4.0 `_ -* `C++ shared object library `_ .. toctree:: @@ -97,7 +93,6 @@ The following are applicable to Linux: python/index nodejs/index odbc/index - cpp/index From 3546cb57a7b3c10b26abf89dc9eccdedd23c4590 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Wed, 16 Nov 2022 15:02:03 +0200 Subject: [PATCH 277/882] Added .NET to Client Driver --- connecting_to_sqream/client_drivers/index.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index 43141714d..780f5a324 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -20,6 +20,12 @@ The following are applicable to all operating systems: * `JDBC .jar file `_ - sqream-jdbc-4.5.3 (.jar) * `JDBC driver `_ +.. _.net: + +* **.NET**: + + * `.NET integration + .. _python: From 03d3ab18e0f8938d5e93d3b38da2dcc436f3ba12 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Sun, 20 Nov 2022 15:08:34 +0200 Subject: [PATCH 278/882] Brand update --- .../SQream_logo_without background-15.png | Bin 0 -> 128962 bytes conf.py | 6 +++--- 2 files changed, 3 insertions(+), 3 deletions(-) create mode 100644 _static/images/SQream_logo_without background-15.png diff --git a/_static/images/SQream_logo_without background-15.png b/_static/images/SQream_logo_without background-15.png new file mode 100644 index 0000000000000000000000000000000000000000..1a4460581981aa00ed03e21f2691a33389cc4c39 GIT binary patch literal 128962 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

HW& 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 lN(g=(&k+CDXNc#hZ%glfyYYjE_|dNxE7yH_ Date: Sun, 20 Nov 2022 16:23:40 +0200 Subject: [PATCH 279/882] Password policy --- .../client_drivers/dotnet/index.rst | 129 ++++++++++++++++++ connecting_to_sqream/client_drivers/index.rst | 1 + .../access_control_password_policy.rst | 6 +- releases/2022.1.6.rst | 48 +++---- 4 files changed, 155 insertions(+), 29 deletions(-) create mode 100644 connecting_to_sqream/client_drivers/dotnet/index.rst diff --git a/connecting_to_sqream/client_drivers/dotnet/index.rst b/connecting_to_sqream/client_drivers/dotnet/index.rst new file mode 100644 index 000000000..64e9ddeb4 --- /dev/null +++ b/connecting_to_sqream/client_drivers/dotnet/index.rst @@ -0,0 +1,129 @@ +.. _net: + +************************* +.NET +************************* +The SqreamNet ADO.NET Data Provider allows you to connect to a SQream database server through .NET environments. This page describes how to establish such connection. + +The .NET page includes the following sections: + +.. contents:: + :local: + :depth: 1 + +Integrating SQreamNet +================================== +The **Integrating SQreamNet** section describes the following: + +.. contents:: + :local: + :depth: 1 + +Prerequisites +---------------- +The SqreamNet provider requires a .NET Framework 6 or newer. + +Verifying the Correct .NET Framework Version is Installed +--------------------- +To verify the correct version of .NET Framework is installed, go to your Framework directory, under Microsoft.NET and look for a v6.x.x directory. In case an older version of .NET Framework exists, you may follow Microsoft guidelines: ____ + +Integrating SQreamNet +------------------------- +To integrate SQreamNet, unzip the archive file and save to a known location. Next, in your Visual Studio, add a reference to the Sqreamnet.dll file to your project. +If you wish to upgrade SQreamNet within an existing project, you may replace the .dll file with an updated one or add a reference to the updated .dll file within its new location. + +Using SQreamNet in your Visual Studio project +---------------------------- + + +Connecting to SQream For the First Time +============================================== +An initial connection to SQream must be established by creating a **SqreamConnection** object by using a connection string. + +.. contents:: + :local: + :depth: 1 + +Connection string +-------------- +Use ``com.sqream.jdbc.SQDriver`` as the driver class in the JDBC application. + +Connection String +-------------------- +JSQreamNet Data Provider relies on a connection string. + +The following is the syntax for SQream: + +.. code-block:: text + + "Data Source=,;User=;Password=;Initial \ Catalog=master;Integrated Security=true"; + +Connection Parameters +^^^^^^^^^^^^^^^^^^^^^^^^ +The following table shows the connection string parameters: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Item + - State + - Default + - Description + * - ```` + - Mandatory + - None + - Hostname/IP/FQDN and port of the SQream DB worker. For example, ``127.0.0.1:5000``, ``sqream.mynetwork.co:3108`` + * - ```` + - Mandatory + - None + - Database name to connect to. For example, ``master`` + * - ``username=`` + - Mandatory + - None + - Username of a role to use for connection. For example, ``username=rhendricks`` + * - ``password=`` + - Mandatory + - None + - Specifies the password of the selected role. For example, ``password=Tr0ub4dor&3`` + * - ``service=`` + - Optional + - ``sqream`` + - Specifices service queue to use. For example, ``service=etl`` + * - ```` + - Optional + - ``false`` + - Specifies SSL for this connection. For example, ``ssl=true`` + * - ```` + - Optional + - ``true`` + - Connect via load balancer (use only if exists, and check port). + +Connection String Examples +^^^^^^^^^^^^^^^^^^^^^^^^^^^ +The following is an example of a SQream cluster with load balancer and no service queues (with SSL): + +.. code-block:: text + + jdbc:Sqream://sqream.mynetwork.co:3108/master;user=rhendricks;password=Tr0ub4dor&3;ssl=true;cluster=true + +The following is a minimal example for a local standalone SQream database: + +.. code-block:: text + + jdbc:Sqream://127.0.0.1:5000/master;user=rhendricks;password=Tr0ub4dor&3 + +The following is an example of a SQream cluster with load balancer and a specific service queue named ``etl``, to the database named ``raviga`` + +.. code-block:: text + + jdbc:Sqream://sqream.mynetwork.co:3108/raviga;user=rhendricks;password=Tr0ub4dor&3;cluster=true;service=etl + +Sample Java Program +-------------------- +You can download the :download:`JDBC Application Sample File ` below by right-clicking and saving it to your computer. + +.. literalinclude:: sample.java + :language: java + :caption: JDBC Application Sample + :linenos: diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index 780f5a324..8339a0a28 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -99,6 +99,7 @@ The following are applicable to Linux: python/index nodejs/index odbc/index + .net/index diff --git a/operational_guides/access_control_password_policy.rst b/operational_guides/access_control_password_policy.rst index 055d674bb..6c69257ed 100644 --- a/operational_guides/access_control_password_policy.rst +++ b/operational_guides/access_control_password_policy.rst @@ -31,7 +31,7 @@ As part of our compliance with GDPR standards SQream relies on a strong password * Must include at least one special character, such as **?**, **!**, **$**, etc. -You can grant a password through the Studio graphic interface or through the CLI, as in the following example command: +You can create a password by using the Studio graphic interface or using the CLI, as in the following example command: .. code-block:: console @@ -39,7 +39,7 @@ You can grant a password through the Studio graphic interface or through the CLI GRANT LOGIN to user_a ; GRANT PASSWORD 'BBAu47?fqPL' to user_a ; -Granting a password that does not comply with the above requirements generates an error message with a request to modify it; +Creating a password which does not comply with the password policy generates an error message with a request to include any of the missing above requirements: .. code-block:: console @@ -59,7 +59,7 @@ Granting a password that does not comply with the above requirements generates a Brute Force Prevention ============================== -Unsuccessfully attempting to log in three times displays the following message: +Unsuccessfully attempting to log in five times displays the following message: .. code-block:: console diff --git a/releases/2022.1.6.rst b/releases/2022.1.6.rst index be3e40b76..158bc46a2 100644 --- a/releases/2022.1.6.rst +++ b/releases/2022.1.6.rst @@ -1,9 +1,9 @@ -.. _2022.1.5: +.. _2022.1.6: ************************** Release Notes 2022.1.6 ************************** -The 2022.1.5 release notes were released on 11/02/2022 and describe the following: +The 2022.1.6 release notes were released on 11/xx/2022 and describe the following: .. contents:: :local: @@ -11,7 +11,7 @@ The 2022.1.5 release notes were released on 11/02/2022 and describe the followin New Features ---------- -The 2022.1.5 Release Notes include the following new features: +The 2022.1.6 Release Notes include the following new features: * keys_evaluate utility function enhancement - add problematic chunk ID to the function's output report. @@ -28,36 +28,32 @@ The 2022.1.5 Release Notes include the following new features: Known Issues --------- -Recently discovered issue with the encryption feature, at this time SQream recommends to avoid using this feature - a fix will be introduced in the near future. +No known issues. -Resolved Issues +Version 2022.1.6 resolved Issues --------- -The following table lists the issues that were resolved in Version 2022.1.5: -+--------------+------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+==============+==========================================================================================+ -| SQ-11081 | Tableau connection are not getting closed | -+--------------+------------------------------------------------------------------------------------------+ -| SQ-11473 | SQream Command Line Interface connectivity issues | -+--------------+------------------------------------------------------------------------------------------+ -| SQ-11551 | SQream Studio Logs pages filtering issues | -+--------------+------------------------------------------------------------------------------------------+ -| SQ-11631 | Log related configuration flags are not working as expected | -+--------------+------------------------------------------------------------------------------------------+ -| SQ-11745 | Missing validation of sufficient GPU memory | -+--------------+------------------------------------------------------------------------------------------+ -| SQ-11792 | CUME_DIST function causes query execution errors | -+--------------+------------------------------------------------------------------------------------------+ -| SQ-11905 | GetDate casting to as text returns DATE with 0s in the time part or no time part at all | -+--------------+------------------------------------------------------------------------------------------+ ++-------------------------------+---------------------------------------------------------+ +| **SQ No.** | **Description** | ++===============================+=========================================================+ +| SQ-10160 | Spotfire casting issues when reading SQream data | ++-------------------------------+---------------------------------------------------------+ +| SQ-11811, SQ-11772 | Queries containing JOIN TEXT columns slow runtime | ++-------------------------------+---------------------------------------------------------+ +| SQ-11940, SQ-11926, SQ-11874 | Version 2022.1.5 encryption issues | ++-------------------------------+---------------------------------------------------------+ +| SQ-12089 | ``COUNT (*)`` execution fails when using foreign table | ++-------------------------------+---------------------------------------------------------+ +| | | ++-------------------------------+---------------------------------------------------------+ +| | | ++-------------------------------+---------------------------------------------------------+ - -Operations and Configuration Changes +Configuration Changes -------- No configuration changes were made. @@ -78,7 +74,7 @@ End of Support ------- No End of Support changes were made. -Upgrading to v2022.1.5 +Upgrading to v2022.1.6 ------- 1. Generate a back-up of the metadata by running the following command: From 75bd5b065022fa00c53eb9df764a494673c51e77 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Sun, 20 Nov 2022 17:20:47 +0200 Subject: [PATCH 280/882] Documentation landing page --- .../client_drivers/dotnet/index.rst | 12 +- connecting_to_sqream/client_drivers/index.rst | 2 +- index.rst | 125 ++---------------- 3 files changed, 16 insertions(+), 123 deletions(-) diff --git a/connecting_to_sqream/client_drivers/dotnet/index.rst b/connecting_to_sqream/client_drivers/dotnet/index.rst index 64e9ddeb4..caa1952e5 100644 --- a/connecting_to_sqream/client_drivers/dotnet/index.rst +++ b/connecting_to_sqream/client_drivers/dotnet/index.rst @@ -50,7 +50,7 @@ Use ``com.sqream.jdbc.SQDriver`` as the driver class in the JDBC application. Connection String -------------------- -JSQreamNet Data Provider relies on a connection string. +SQreamNet Data Provider relies on a connection string. The following is the syntax for SQream: @@ -105,21 +105,23 @@ The following is an example of a SQream cluster with load balancer and no servic .. code-block:: text - jdbc:Sqream://sqream.mynetwork.co:3108/master;user=rhendricks;password=Tr0ub4dor&3;ssl=true;cluster=true + Data Source=sqream.mynetwork.co,3108;User=rhendricks;Password=Tr0ub4dor&3;Initial \ Catalog=master;Integrated Security=true;ssl=true;cluster=true; + The following is a minimal example for a local standalone SQream database: .. code-block:: text - jdbc:Sqream://127.0.0.1:5000/master;user=rhendricks;password=Tr0ub4dor&3 + + Data Source=127.0.0.1,5000;User=rhendricks;Password=Tr0ub4dor&3;Initial \ Catalog=master; The following is an example of a SQream cluster with load balancer and a specific service queue named ``etl``, to the database named ``raviga`` .. code-block:: text - jdbc:Sqream://sqream.mynetwork.co:3108/raviga;user=rhendricks;password=Tr0ub4dor&3;cluster=true;service=etl + Data Source=sqream.mynetwork.co,3108;User=rhendricks;Password=Tr0ub4dor&3;Initial \ Catalog=raviga;Integrated Security=true;service=etl;cluster=true; -Sample Java Program +Sample C# Program -------------------- You can download the :download:`JDBC Application Sample File ` below by right-clicking and saving it to your computer. diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index 8339a0a28..fa1155c01 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -99,7 +99,7 @@ The following are applicable to Linux: python/index nodejs/index odbc/index - .net/index + dotnet/index diff --git a/index.rst b/index.rst index 00c01f392..c3d41c39c 100644 --- a/index.rst +++ b/index.rst @@ -4,21 +4,9 @@ SQream DB Documentation ************************* -For SQream version 2021.2. - -.. only:: html - - .. tip:: - Want to read this offline? - `Download the documentation as a single PDF `_ . - -.. only:: pdf or latex - - .. tip:: This documentation is available online at https://docs.sqream.com/ SQream DB is a columnar analytic SQL database management system. SQream DB supports regular SQL including :ref:`a substantial amount of ANSI SQL`, uses :ref:`serializable transactions`, and :ref:`scales horizontally` for concurrent statements. Even a :ref:`basic SQream DB machine` can support tens to hundreds of terabytes of data. SQream DB easily plugs in to third-party tools like :ref:`Tableau` comes with standard SQL client drivers, including :ref:`JDBC`, :ref:`ODBC`, and :ref:`Python DB-API`. -:ref:`client_platforms` +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ | Topic | Description | @@ -61,111 +49,15 @@ SQream DB is a columnar analytic SQL database management system. SQream DB suppo +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ - Loading and unloading data: - - * Loading data: - - * Overview of loading data - * Alternatives to loading data (foreign tables) - * Supported data types - * Ingesting data from external sources - * Inserting data from external tables - * Ingesting data from third party client platforms - * Using the **COPY FROM** statement - * Importing data using Studio - * Loading data using Amazon S3 - - * Unloading data: - - * Overview of unloading data - * Using the **COPY TO** statement - - Feature guides: - - * Query Healer - * Automatic schema Identification - * Compression - * Python UDF (User-Defined Functions) - * Workload Manager - * Transactions - * Concurrency and locks - * Concurrency and scaling in SQream DB - - Operational guides: - - * Access control - * Creating or cloning storage clusters - * Foreign tables - * Deleting data - * Exporting data - * Logging - * Monitoring query performance - * Security - * Saved queries - * Seeing system objects as DDL - * Optimization and best practices - - SQream Accelerated Studio 5.4.3: - - * Getting started with SQream Acceleration Studio 5.4.3 - * Monitoring workers and services from the dashboard - * Executing statements and running queries from the Editor - * Viewing logs - * Creating, assigning, and managing roles and permissions - * Configuring Your instance of SQream - - System architecture: - - * Internals and architecture - * Filesystem and usage - - Configuring SQream: - - * Configuration methods - * Configuration flags - - Reference guides: - - * SQL syntax, statements, and functions - * Catalog reference guide - * Command Line programs - * SQL feature checklist - * Python API reference guide - - Data type guides: - - * Converting and casting - * Supported data types - * Supported casts - - Release notes: - - * 2022.1 - * 2021.2 - * 2021.1 - * 2020.3 - * 2020.2 - * 2020.1 - - Troubleshooting: - - * Remedying slow queries - * Resolving common issues - * Examining logs - * Identifying configuration issues - * Lock related issues - * SAS Viya related issues - * Tableau related issues - * Solving “Code 126” ODBC errors - * Log related issues - * Node.js related issues - * Core dumping related issues - * SQream SQL installation related issues - * Gathering information for SQream support - - Glossary +.. only:: html + .. tip:: + Want to read this offline? + `Download the documentation as a single PDF `_ . +.. only:: pdf or latex + + .. tip:: This documentation is available online at https://docs.sqream.com/ .. rubric:: Need help? @@ -175,9 +67,8 @@ If you couldn't find what you're looking for, we're always happy to help. Visit .. rubric:: Looking for older versions? -This version of the documentation is for SQream DB Version 2021.2. -If you're looking for an older version of the documentation, versions 1.10 through 2019.2.1 are available at http://previous.sqream.com . +If you're looking for an older version of the documentation, go to http://previous.sqream.com . .. toctree:: :caption: Contents: From bb84ce82c7f49ed9649f4a6e51cf91010a9a33a7 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Tue, 22 Nov 2022 11:13:05 +0200 Subject: [PATCH 281/882] .NET --- .../client_drivers/dotnet/index.rst | 29 +++--- .../client_drivers/dotnet/sample.cs | 93 +++++++++++++++++++ 2 files changed, 107 insertions(+), 15 deletions(-) create mode 100644 connecting_to_sqream/client_drivers/dotnet/sample.cs diff --git a/connecting_to_sqream/client_drivers/dotnet/index.rst b/connecting_to_sqream/client_drivers/dotnet/index.rst index caa1952e5..5de839eae 100644 --- a/connecting_to_sqream/client_drivers/dotnet/index.rst +++ b/connecting_to_sqream/client_drivers/dotnet/index.rst @@ -3,7 +3,7 @@ ************************* .NET ************************* -The SqreamNet ADO.NET Data Provider allows you to connect to a SQream database server through .NET environments. This page describes how to establish such connection. +The SqreamNet ADO.NET Data Provider lets you connect to SQream through your .NET environment. The .NET page includes the following sections: @@ -25,32 +25,32 @@ The SqreamNet provider requires a .NET Framework 6 or newer. Verifying the Correct .NET Framework Version is Installed --------------------- -To verify the correct version of .NET Framework is installed, go to your Framework directory, under Microsoft.NET and look for a v6.x.x directory. In case an older version of .NET Framework exists, you may follow Microsoft guidelines: ____ +To verify the correct version of .NET Framework is installed, go to the Microsoft.NET directory, open the Framework directory, and verify that a v6.x.x directory exists. +In case an older version of .NET Framework exists, you may follow Microsoft guidelines for upgrading .NET Framework: ________________ Integrating SQreamNet ------------------------- -To integrate SQreamNet, unzip the archive file and save to a known location. Next, in your Visual Studio, add a reference to the Sqreamnet.dll file to your project. -If you wish to upgrade SQreamNet within an existing project, you may replace the .dll file with an updated one or add a reference to the updated .dll file within its new location. +To integrate SQreamNet, unzip the archive file and save to a known location. Next, in your Visual Studio, add a Sqreamnet.dll reference to your project. +If you wish to upgrade SQreamNet within an existing project, you may replace the existing .dll file with an updated one or change the project's reference location to a new one. -Using SQreamNet in your Visual Studio project +Known Driver Limitations ---------------------------- +Unicode characters are not supported when using ``INSERT INTO AS SELECT``. +To avoid possible casting issues, use ``getDouble`` when using ``FLOAT``. Connecting to SQream For the First Time ============================================== -An initial connection to SQream must be established by creating a **SqreamConnection** object by using a connection string. +An initial connection to SQream must be established by creating a **SqreamConnection** object using a connection string. .. contents:: :local: :depth: 1 -Connection string --------------- -Use ``com.sqream.jdbc.SQDriver`` as the driver class in the JDBC application. Connection String -------------------- -SQreamNet Data Provider relies on a connection string. +The SQreamNet Data Provider relies on a connection string. The following is the syntax for SQream: @@ -60,7 +60,6 @@ The following is the syntax for SQream: Connection Parameters ^^^^^^^^^^^^^^^^^^^^^^^^ -The following table shows the connection string parameters: .. list-table:: :widths: auto @@ -123,9 +122,9 @@ The following is an example of a SQream cluster with load balancer and a specifi Sample C# Program -------------------- -You can download the :download:`JDBC Application Sample File ` below by right-clicking and saving it to your computer. +You can download the :download:`.NET Application Sample File ` below by right-clicking and saving it to your computer. -.. literalinclude:: sample.java - :language: java - :caption: JDBC Application Sample +.. literalinclude:: sample.cs + :language: C# + :caption: .NET Application Sample :linenos: diff --git a/connecting_to_sqream/client_drivers/dotnet/sample.cs b/connecting_to_sqream/client_drivers/dotnet/sample.cs new file mode 100644 index 000000000..54a19e0da --- /dev/null +++ b/connecting_to_sqream/client_drivers/dotnet/sample.cs @@ -0,0 +1,93 @@ + public void Test() + { + var connection = OpenConnection("192.168.4.62", 5000, "sqream", "sqream", "master"); + + ExecuteSQLCommand(connection, "create or replace table tbl_example as select 1 as x , 'a' as y;"); + + var tableData = ReadExampleData(connection, "select * from tbl_example;"); + } + + ///

+ /// Builds a connection string to sqream server and opens a connection + /// + /// host to connect + /// port sqreamd is running on + /// role username + /// role password + /// database name + /// optional - set to true when the ip,port endpoint is a server picker process + /// + /// SQream connection object + /// Throws SqreamException if fails to open a connction + /// + public SqreamConnection OpenConnection(string ipAddress, int port, string username, string password, string databaseName, bool isCluster = false) + { + // create the connection string according to the format + var connectionString = string.Format( + "Data Source={0},{1};User={2};Password={3};Initial Catalog={4};Cluster={5}", + ipAddress, + port, + username, + password, + databaseName, + isCluster + ); + + // create a sqeram connection object + var connection = new SqreamConnection(connectionString); + + // open a connection + connection.Open(); + + // returns the connection object + return connection; + } + + /// + /// Executes a SQL command to sqream server + /// + /// connection to sqream server + /// sql command + /// thrown when the connection is not open + public void ExecuteSQLCommand(SqreamConnection connection, string sql) + { + // validates the connection is open and throws exception if not + if (connection.State != System.Data.ConnectionState.Open) + throw new InvalidOperationException(string.Format("connection to sqream is not open. connection.State: {0}", connection.State)); + + // creates a new command object utilizing the sql and the connection + var command = new SqreamCommand(sql, connection); + + // executes the command + command.ExecuteNonQuery(); + } + + /// + /// Executes a SQL command to sqream server, and reads the result set usiing DataReader + /// + /// connection to sqream server + /// sql command + /// thrown when the connection is not open + public List> ReadExampleData(SqreamConnection connection, string sql) + { + // validates the connection is open and throws exception if not + if (connection.State != System.Data.ConnectionState.Open) + throw new InvalidOperationException(string.Format("connection to sqream is not open. connection.State: {0}", connection.State)); + + // creates a new command object utilizing the sql and the connection + var command = new SqreamCommand(sql, connection); + + // creates a reader object to iterate over the result set + var reader = (SqreamDataReader)command.ExecuteReader(); + + // list of results + var result = new List>(); + + //iterate the reader and read the table int,string values into a result tuple object + while (reader.Read()) + result.Add(new Tuple(reader.GetInt32(0), reader.GetString(1))); + + // return the result set + return result; + } + From f5fc472e31d4cee4ed9ab5d42e458e49fc213a4b Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Tue, 22 Nov 2022 12:01:48 +0200 Subject: [PATCH 282/882] Update filesystem_and_filesystem_usage.rst --- architecture/filesystem_and_filesystem_usage.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/architecture/filesystem_and_filesystem_usage.rst b/architecture/filesystem_and_filesystem_usage.rst index d1838d4e8..c4e2e1d80 100644 --- a/architecture/filesystem_and_filesystem_usage.rst +++ b/architecture/filesystem_and_filesystem_usage.rst @@ -27,7 +27,7 @@ The **cluster root** is the directory in which all data for SQream DB is stored. The databases directory houses all of the actual data in tables and columns. -Each database is stored as it's own directory. Each table is stored under it's respective database, and columns are stored in their respective table. +Each database is stored as its own directory. Each table is stored under it's respective database, and columns are stored in their respective table. .. figure:: /_static/images/table_columns_storage.png From 751fa2c8b2516f3dd78dd4483afb7b0c73e65314 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Tue, 22 Nov 2022 13:24:50 +0200 Subject: [PATCH 283/882] Update index.rst --- .../client_drivers/dotnet/index.rst | 32 ++++++++----------- 1 file changed, 14 insertions(+), 18 deletions(-) diff --git a/connecting_to_sqream/client_drivers/dotnet/index.rst b/connecting_to_sqream/client_drivers/dotnet/index.rst index 5de839eae..0800f3738 100644 --- a/connecting_to_sqream/client_drivers/dotnet/index.rst +++ b/connecting_to_sqream/client_drivers/dotnet/index.rst @@ -21,23 +21,19 @@ The **Integrating SQreamNet** section describes the following: Prerequisites ---------------- -The SqreamNet provider requires a .NET Framework 6 or newer. - -Verifying the Correct .NET Framework Version is Installed ---------------------- -To verify the correct version of .NET Framework is installed, go to the Microsoft.NET directory, open the Framework directory, and verify that a v6.x.x directory exists. -In case an older version of .NET Framework exists, you may follow Microsoft guidelines for upgrading .NET Framework: ________________ +The SqreamNet provider requires a .NET version 6 or newer. Integrating SQreamNet ------------------------- -To integrate SQreamNet, unzip the archive file and save to a known location. Next, in your Visual Studio, add a Sqreamnet.dll reference to your project. +To integrate SQreamNet, unzip the archive file and save to a known location. Next, in your IDE, add a Sqreamnet.dll reference to your project. If you wish to upgrade SQreamNet within an existing project, you may replace the existing .dll file with an updated one or change the project's reference location to a new one. + Known Driver Limitations ---------------------------- -Unicode characters are not supported when using ``INSERT INTO AS SELECT``. + * Unicode characters are not supported when using ``INSERT INTO AS SELECT``. -To avoid possible casting issues, use ``getDouble`` when using ``FLOAT``. + * To avoid possible casting issues, use ``getDouble`` when using ``FLOAT``. Connecting to SQream For the First Time ============================================== @@ -50,13 +46,13 @@ An initial connection to SQream must be established by creating a **SqreamConnec Connection String -------------------- -The SQreamNet Data Provider relies on a connection string. +To connect to SQream, instantiate a **SqreamConnection** object using this connection string. The following is the syntax for SQream: .. code-block:: text - "Data Source=,;User=;Password=;Initial \ Catalog=master;Integrated Security=true"; + "Data Source=,;User=;Password=;Initial Catalog=;Integrated Security=true"; Connection Parameters ^^^^^^^^^^^^^^^^^^^^^^^^ @@ -77,15 +73,15 @@ Connection Parameters - Mandatory - None - Database name to connect to. For example, ``master`` - * - ``username=`` + * - ```` - Mandatory - None - Username of a role to use for connection. For example, ``username=rhendricks`` - * - ``password=`` + * - ```` - Mandatory - None - Specifies the password of the selected role. For example, ``password=Tr0ub4dor&3`` - * - ``service=`` + * - ```` - Optional - ``sqream`` - Specifices service queue to use. For example, ``service=etl`` @@ -104,21 +100,21 @@ The following is an example of a SQream cluster with load balancer and no servic .. code-block:: text - Data Source=sqream.mynetwork.co,3108;User=rhendricks;Password=Tr0ub4dor&3;Initial \ Catalog=master;Integrated Security=true;ssl=true;cluster=true; - + Data Source=sqream.mynetwork.co,3108;User=rhendricks;Password=Tr0ub4dor&3;Initial Catalog=master;Integrated Security=true;ssl=true;cluster=true; + The following is a minimal example for a local standalone SQream database: .. code-block:: text - Data Source=127.0.0.1,5000;User=rhendricks;Password=Tr0ub4dor&3;Initial \ Catalog=master; + Data Source=127.0.0.1,5000;User=rhendricks;Password=Tr0ub4dor&3;Initial Catalog=master; The following is an example of a SQream cluster with load balancer and a specific service queue named ``etl``, to the database named ``raviga`` .. code-block:: text - Data Source=sqream.mynetwork.co,3108;User=rhendricks;Password=Tr0ub4dor&3;Initial \ Catalog=raviga;Integrated Security=true;service=etl;cluster=true; + Data Source=sqream.mynetwork.co,3108;User=rhendricks;Password=Tr0ub4dor&3;Initial Catalog=raviga;Integrated Security=true;service=etl;cluster=true; Sample C# Program -------------------- From 51bcd4d98baa47be95349b0d0e10e19a23448c1c Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Tue, 22 Nov 2022 13:33:47 +0200 Subject: [PATCH 284/882] .NET --- connecting_to_sqream/client_drivers/dotnet/index.rst | 2 +- connecting_to_sqream/client_drivers/index.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/connecting_to_sqream/client_drivers/dotnet/index.rst b/connecting_to_sqream/client_drivers/dotnet/index.rst index 0800f3738..1236f1932 100644 --- a/connecting_to_sqream/client_drivers/dotnet/index.rst +++ b/connecting_to_sqream/client_drivers/dotnet/index.rst @@ -25,7 +25,7 @@ The SqreamNet provider requires a .NET version 6 or newer. Integrating SQreamNet ------------------------- -To integrate SQreamNet, unzip the archive file and save to a known location. Next, in your IDE, add a Sqreamnet.dll reference to your project. +To integrate SQreamNet,save the archive file to a known location. Next, in your IDE, add a Sqreamnet.dll reference to your project. If you wish to upgrade SQreamNet within an existing project, you may replace the existing .dll file with an updated one or change the project's reference location to a new one. diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index fa1155c01..76a6560c7 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -24,7 +24,7 @@ The following are applicable to all operating systems: * **.NET**: - * `.NET integration + * `.NET driver `_ .. _python: From 0d9aa3c89b2ffddcb560030aa79da4e41de4a895 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Tue, 22 Nov 2022 13:49:10 +0200 Subject: [PATCH 285/882] Update index.rst --- connecting_to_sqream/client_drivers/dotnet/index.rst | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/connecting_to_sqream/client_drivers/dotnet/index.rst b/connecting_to_sqream/client_drivers/dotnet/index.rst index 1236f1932..1d28069a7 100644 --- a/connecting_to_sqream/client_drivers/dotnet/index.rst +++ b/connecting_to_sqream/client_drivers/dotnet/index.rst @@ -23,9 +23,14 @@ Prerequisites ---------------- The SqreamNet provider requires a .NET version 6 or newer. +Getting the DLL file +---------------- +The .NET driver is available for download from the :ref:`client drivers download page`. + Integrating SQreamNet ------------------------- -To integrate SQreamNet,save the archive file to a known location. Next, in your IDE, add a Sqreamnet.dll reference to your project. +After downloading the .NET driver, save the archive file to a known location. Next, in your IDE, add a Sqreamnet.dll reference to your project. + If you wish to upgrade SQreamNet within an existing project, you may replace the existing .dll file with an updated one or change the project's reference location to a new one. From 97815cf03be488f0b6372b723bcebdcbfe3c9628 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Tue, 22 Nov 2022 14:07:14 +0200 Subject: [PATCH 286/882] Update index.rst --- connecting_to_sqream/client_drivers/index.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index 76a6560c7..957fa3505 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -24,7 +24,8 @@ The following are applicable to all operating systems: * **.NET**: - * `.NET driver `_ + * `.NET .dll file `_ + * `.NET driver `_ .. _python: From 940b55ae76791a2dfd003dd49ee6efc35fe42d24 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Thu, 24 Nov 2022 11:18:44 +0200 Subject: [PATCH 287/882] Saved queries --- operational_guides/saved_queries.rst | 130 ++++++++++++++++++ reference/sql/sql_statements/index.rst | 10 ++ .../utility_commands/drop_saved_query.rst | 2 +- .../recompile_saved_query.rst | 2 + 4 files changed, 143 insertions(+), 1 deletion(-) create mode 100644 operational_guides/saved_queries.rst diff --git a/operational_guides/saved_queries.rst b/operational_guides/saved_queries.rst new file mode 100644 index 000000000..2ec42f247 --- /dev/null +++ b/operational_guides/saved_queries.rst @@ -0,0 +1,130 @@ +.. _saved_queries: + +*********************** +Saved Queries +*********************** + + + +Using the ``save_query`` command will both generate and save an execution plan. This allows you to save time when running frequently used complex queries. + +Note that the saved execution plan is tightly coupled with the structure of its underlying tables, which means that if one or more of the objects mentioned in the query is modified, the saved query must be re-created. + + +How saved queries work +========================== + +Saved queries are compiled when they are created. When a saved query is run, this query plan is used instead of compiling a query plan at query time. + +Parameters support +=========================== + +Query parameters can be used as substitutes for constants expressions in queries. + +* Parameters cannot be used to substitute identifiers like column names and table names. + +* Query parameters of a string datatype (like ``TEXT``) must be of a fixed length, and can be used in equality checks, but not patterns (e.g. :ref:`like`, :ref:`rlike`, etc.) + +Creating a saved query +====================== + +A saved query is created using the :ref:`save_query` utility command. + +Saving a simple query +--------------------------- + +.. code-block:: psql + + t=> SELECT SAVE_QUERY('select_all','SELECT * FROM nba'); + executed + +Saving a parametrized query +------------------------------------------ + +Use parameters to replace them later at execution time. + + + +.. code-block:: psql + + t=> SELECT SAVE_QUERY('select_by_weight_and_team','SELECT * FROM nba WHERE Weight > ? AND Team = ?'); + executed + +.. TODO tip Use dollar quoting (`$$`) to avoid escaping strings. +.. this makes no sense unless you have a query which would otherwise need escaping +.. t=> SELECT SAVE_QUERY('select_by_weight_and_team',$$SELECT * FROM nba WHERE Weight > ? AND Team = ?$$); +.. executed + + +Executing saved queries +======================= + +Executing a saved query requires calling it by it's name in a :ref:`execute_saved_query` statement. A saved query with no parameter is called without parameters. + +.. code-block:: psql + + t=> SELECT EXECUTE_SAVED_QUERY('select_all'); + Name | Team | Number | Position | Age | Height | Weight | College | Salary + -------------------------+------------------------+--------+----------+-----+--------+--------+-----------------------+--------- + Avery Bradley | Boston Celtics | 0 | PG | 25 | 6-2 | 180 | Texas | 7730337 + Jae Crowder | Boston Celtics | 99 | SF | 25 | 6-6 | 235 | Marquette | 6796117 + John Holland | Boston Celtics | 30 | SG | 27 | 6-5 | 205 | Boston University | + R.J. Hunter | Boston Celtics | 28 | SG | 22 | 6-5 | 185 | Georgia State | 1148640 + [...] + +Executing a saved query with parameters requires specifying the parameters in the order they appear in the query: + +.. code-block:: psql + + t=> SELECT EXECUTE_SAVED_QUERY('select_by_weight_and_team', 240, 'Toronto Raptors'); + Name | Team | Number | Position | Age | Height | Weight | College | Salary + ------------------+-----------------+--------+----------+-----+--------+--------+-------------+-------- + Bismack Biyombo | Toronto Raptors | 8 | C | 23 | 6-9 | 245 | | 2814000 + James Johnson | Toronto Raptors | 3 | PF | 29 | 6-9 | 250 | Wake Forest | 2500000 + Jason Thompson | Toronto Raptors | 1 | PF | 29 | 6-11 | 250 | Rider | 245177 + Jonas Valanciunas | Toronto Raptors | 17 | C | 24 | 7-0 | 255 | | 4660482 + +Listing saved queries +======================= + +Saved queries are saved as a database objects. They can be listed in one of two ways: + +Using the :ref:`catalog`: + +.. code-block:: psql + + t=> SELECT * FROM sqream_catalog.savedqueries; + name | num_parameters + --------------------------+--------------- + select_all | 0 + select_by_weight | 1 + select_by_weight_and_team | 2 + +Using the :ref:`list_saved_queries` utility function: + +.. code-block:: psql + + t=> SELECT LIST_SAVED_QUERIES(); + saved_query + ------------------------- + select_all + select_by_weight + select_by_weight_and_team + + +Dropping a saved query +============================= + +When you're done with a saved query, or would like to replace it with another, you can drop it with :ref:`drop_saved_query`: + +.. code-block:: psql + + t=> SELECT DROP_SAVED_QUERY('select_all'); + executed + t=> SELECT DROP_SAVED_QUERY('select_by_weight_and_team'); + executed + + t=> SELECT LIST_SAVED_QUERIES(); + saved_query + ------------------------- + select_by_weight \ No newline at end of file diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index 960200937..af6e9f06a 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -106,8 +106,16 @@ The following table shows the Utility commands: * - Command - Usage + * - :ref:`DROP SAVED QUERY` + - Drops a saved query + * - :ref:`EXECUTE SAVED QUERY` + - Executes a previously saved query * - :ref:`EXPLAIN` - Returns a static query plan, which can be used to debug query plans + * - :ref:`LIST SAVED QUERIES` + - Lists previously saved query names, one per row. + * - :ref:`RECOMPILE SAVED QUERY` + - Recompiles a saved query that has been invalidated due to a schema change * - :ref:`SELECT GET_LICENSE_INFO` - View a user's license information * - :ref:`SELECT GET_DDL` @@ -126,6 +134,8 @@ The following table shows the Utility commands: - Returns a list of locks from across the cluster * - :ref:`SHOW NODE INFO` - Returns a snapshot of the current query plan, similar to ``EXPLAIN ANALYZE`` from other databases + * - :ref:`SHOW SAVED QUERY` + - Returns a single row result containing the saved query string * - :ref:`SHOW SERVER STATUS` - Returns a list of active sessions across the cluster * - :ref:`SHOW VERSION` diff --git a/reference/sql/sql_statements/utility_commands/drop_saved_query.rst b/reference/sql/sql_statements/utility_commands/drop_saved_query.rst index f7faef6c5..9e7d8d725 100644 --- a/reference/sql/sql_statements/utility_commands/drop_saved_query.rst +++ b/reference/sql/sql_statements/utility_commands/drop_saved_query.rst @@ -6,7 +6,7 @@ DROP_SAVED_QUERY ``DROP_SAVED_QUERY`` drops a :ref:`previously saved query`. -Read more in the :ref:`saved_queries` guide. +Read more in the :ref:`saved_queries` guide. See also: ref:`save_query`, :ref:`execute_saved_query`, ref:`show_saved_query`, ref:`list_saved_queries`. diff --git a/reference/sql/sql_statements/utility_commands/recompile_saved_query.rst b/reference/sql/sql_statements/utility_commands/recompile_saved_query.rst index d6b63e30e..97b1139e9 100644 --- a/reference/sql/sql_statements/utility_commands/recompile_saved_query.rst +++ b/reference/sql/sql_statements/utility_commands/recompile_saved_query.rst @@ -6,6 +6,8 @@ RECOMPILE_SAVED_QUERY ``RECOMPILE_SAVED_QUERY`` recompiles a saved query that has been invalidated due to a schema change. +Read more in the :ref:`saved_queries` guide. + Permissions ============= From ee576fde06e1711088bf7017afa26f6ffa620520 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Thu, 24 Nov 2022 11:58:49 +0200 Subject: [PATCH 288/882] Update index.rst --- connecting_to_sqream/client_drivers/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index 957fa3505..3cdcc54b7 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -17,7 +17,7 @@ The following are applicable to all operating systems: * **JDBC** - recommended installation via ``mvn``: - * `JDBC .jar file `_ - sqream-jdbc-4.5.3 (.jar) + * `JDBC .jar file `_ - sqream-jdbc-4.5.3 (.jar) * `JDBC driver `_ .. _.net: From 1aee577821bf4294cbcffafd74ace41ee212fec1 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Thu, 24 Nov 2022 14:35:02 +0200 Subject: [PATCH 289/882] Update drop_role.rst --- .../sql/sql_statements/access_control_commands/drop_role.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/access_control_commands/drop_role.rst b/reference/sql/sql_statements/access_control_commands/drop_role.rst index f519870cd..61c4d5bb9 100644 --- a/reference/sql/sql_statements/access_control_commands/drop_role.rst +++ b/reference/sql/sql_statements/access_control_commands/drop_role.rst @@ -13,7 +13,7 @@ See also :ref:`create_role`. Permissions ============= -To drop a role, the current role must have the ``SUPERUSER`` permission. +To drop a role, the current role must have a ``SUPERUSER`` cluster-level permission. Syntax ========== From 19fcd24b65fbace1c0939092adc4b313b7f29e66 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Thu, 24 Nov 2022 17:23:21 +0200 Subject: [PATCH 290/882] Update 2022.1.6.rst --- releases/2022.1.6.rst | 49 +++++++++++++++++-------------------------- 1 file changed, 19 insertions(+), 30 deletions(-) diff --git a/releases/2022.1.6.rst b/releases/2022.1.6.rst index 158bc46a2..7f9eb19ea 100644 --- a/releases/2022.1.6.rst +++ b/releases/2022.1.6.rst @@ -11,46 +11,35 @@ The 2022.1.6 release notes were released on 11/xx/2022 and describe the followin New Features ---------- -The 2022.1.6 Release Notes include the following new features: -* keys_evaluate utility function enhancement - add problematic chunk ID to the function's output report. +* Improved ZLIB compression performance. :: -* Automatically close database client connections that have been open for 24 hours without any active statements. - - :: - -* release_defunct_locks utility function enhancement to receive new optional input parameter to specify timeout - for more details see `Lock Related Issues <../troubleshooting/lock_related_issues.html>`_. - - - - Known Issues --------- -No known issues. - +:ref:`Percentile` is not supported for Window functions. Version 2022.1.6 resolved Issues --------- -+-------------------------------+---------------------------------------------------------+ -| **SQ No.** | **Description** | -+===============================+=========================================================+ -| SQ-10160 | Spotfire casting issues when reading SQream data | -+-------------------------------+---------------------------------------------------------+ -| SQ-11811, SQ-11772 | Queries containing JOIN TEXT columns slow runtime | -+-------------------------------+---------------------------------------------------------+ -| SQ-11940, SQ-11926, SQ-11874 | Version 2022.1.5 encryption issues | -+-------------------------------+---------------------------------------------------------+ -| SQ-12089 | ``COUNT (*)`` execution fails when using foreign table | -+-------------------------------+---------------------------------------------------------+ -| | | -+-------------------------------+---------------------------------------------------------+ -| | | -+-------------------------------+---------------------------------------------------------+ - - ++-------------------------------+-------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++===============================+===========================================================================================+ +| SQ-10160 | Spotfire casting issues when reading SQream data | ++-------------------------------+-------------------------------------------------------------------------------------------+ +| SQ-11772 | Queries containing JOIN TEXT columns slow runtime | ++-------------------------------+-------------------------------------------------------------------------------------------+ +| SQ-12117 | Running TCPH-21 results in out of memory | ++-------------------------------+-------------------------------------------------------------------------------------------+ +| SQ-12089 | ``COUNT (*)`` execution fails when using foreign table | ++-------------------------------+-------------------------------------------------------------------------------------------+ +| SQ-12019 | Using ``PERCENTILE_DISC`` function with ``PARTITION BY`` function causes internal error | ++-------------------------------+-------------------------------------------------------------------------------------------+ +| SQ-11940, SQ-11926, SQ-11874 | Known encryption issues | ++-------------------------------+-------------------------------------------------------------------------------------------+ +| SQ-11295??????? | | ++-------------------------------+-------------------------------------------------------------------------------------------+ Configuration Changes From 7b1a44b54b4507093b7182a717670c3403a5fc57 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Mon, 28 Nov 2022 13:55:42 +0200 Subject: [PATCH 291/882] Update 2022.1.6.rst --- releases/2022.1.6.rst | 33 ++++++++++++++++----------------- 1 file changed, 16 insertions(+), 17 deletions(-) diff --git a/releases/2022.1.6.rst b/releases/2022.1.6.rst index 7f9eb19ea..c11fbb099 100644 --- a/releases/2022.1.6.rst +++ b/releases/2022.1.6.rst @@ -23,23 +23,22 @@ Known Issues Version 2022.1.6 resolved Issues --------- -+-------------------------------+-------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+===============================+===========================================================================================+ -| SQ-10160 | Spotfire casting issues when reading SQream data | -+-------------------------------+-------------------------------------------------------------------------------------------+ -| SQ-11772 | Queries containing JOIN TEXT columns slow runtime | -+-------------------------------+-------------------------------------------------------------------------------------------+ -| SQ-12117 | Running TCPH-21 results in out of memory | -+-------------------------------+-------------------------------------------------------------------------------------------+ -| SQ-12089 | ``COUNT (*)`` execution fails when using foreign table | -+-------------------------------+-------------------------------------------------------------------------------------------+ -| SQ-12019 | Using ``PERCENTILE_DISC`` function with ``PARTITION BY`` function causes internal error | -+-------------------------------+-------------------------------------------------------------------------------------------+ -| SQ-11940, SQ-11926, SQ-11874 | Known encryption issues | -+-------------------------------+-------------------------------------------------------------------------------------------+ -| SQ-11295??????? | | -+-------------------------------+-------------------------------------------------------------------------------------------+ ++--------------------------------+--------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++================================+============================================================================================+ +| SQ-10160 | Spotfire casting issues when reading SQream data | ++--------------------------------+--------------------------------------------------------------------------------------------+ +| SQ-12089 | ``COUNT (*)`` execution fails when using foreign table | ++--------------------------------+--------------------------------------------------------------------------------------------+ +| SQ-12019 | Using ``PERCENTILE_DISC`` function with ``PARTITION BY`` function causes internal error | ++--------------------------------+--------------------------------------------------------------------------------------------+ +| SQ-12117 | Running TCPH-21 results in out of memory | ++--------------------------------+--------------------------------------------------------------------------------------------+ +| SQ-11940, SQ-11926, SQ-11874 | Known encryption issues | ++--------------------------------+--------------------------------------------------------------------------------------------+ +| SQ-11295 | ``max_file_size`` when executing ``COPY_TO`` is imprecise | ++--------------------------------+--------------------------------------------------------------------------------------------+ + Configuration Changes From bde0616602cc2237cae57c1d5936a05051a1ca52 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Mon, 28 Nov 2022 13:58:05 +0200 Subject: [PATCH 292/882] Update 2022.1.6.rst --- releases/2022.1.6.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/2022.1.6.rst b/releases/2022.1.6.rst index c11fbb099..56580f26e 100644 --- a/releases/2022.1.6.rst +++ b/releases/2022.1.6.rst @@ -38,7 +38,7 @@ Version 2022.1.6 resolved Issues +--------------------------------+--------------------------------------------------------------------------------------------+ | SQ-11295 | ``max_file_size`` when executing ``COPY_TO`` is imprecise | +--------------------------------+--------------------------------------------------------------------------------------------+ - + Configuration Changes From 8bf7f16cefb34b57e611b4f818a7debe62464ea5 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Tue, 29 Nov 2022 09:39:38 +0200 Subject: [PATCH 293/882] Update data_encryption_methods.rst --- feature_guides/data_encryption_methods.rst | 3 --- 1 file changed, 3 deletions(-) diff --git a/feature_guides/data_encryption_methods.rst b/feature_guides/data_encryption_methods.rst index 0e5638058..db789d02f 100644 --- a/feature_guides/data_encryption_methods.rst +++ b/feature_guides/data_encryption_methods.rst @@ -5,9 +5,6 @@ Encryption Methods *********************** Data exists in one of following states and determines the encryption method: -.. contents:: - :local: - :depth: 1 Encrypting Data in Transit ---------------- From 0db6d80ac0ea70374a4316a0c86dbc20aacd26df Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Tue, 29 Nov 2022 10:35:21 +0200 Subject: [PATCH 294/882] Update data_encryption_overview.rst --- feature_guides/data_encryption_overview.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/feature_guides/data_encryption_overview.rst b/feature_guides/data_encryption_overview.rst index a37325e52..925abdbbe 100644 --- a/feature_guides/data_encryption_overview.rst +++ b/feature_guides/data_encryption_overview.rst @@ -21,6 +21,9 @@ Encryption can be used for the following: * Selecting data from an encrypted column. +.. note:: Executing ``CREATE TABLE AS`` ``SELECT`` when one or more columns contain encrypted data will result in newly created table containing unencrypted data. + + For more information on the encryption syntax, see :ref:`data_encryption_syntax`. For more information on GDPR compliance requirements, see the `GDPR checklist `_. \ No newline at end of file From 02cc00ec67fe78ced3380afebe7828dd5ee0d7a8 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Tue, 29 Nov 2022 12:08:58 +0200 Subject: [PATCH 295/882] Update 2022.1.6.rst --- releases/2022.1.6.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/releases/2022.1.6.rst b/releases/2022.1.6.rst index 56580f26e..b848d9296 100644 --- a/releases/2022.1.6.rst +++ b/releases/2022.1.6.rst @@ -13,6 +13,7 @@ New Features ---------- * Improved ZLIB compression performance. +* :ref:`.Net Driver` now supports .NET version 6 or newer. :: From e29f67ebaa8e090b7fd9316247ae5857e70e008e Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Tue, 29 Nov 2022 14:16:33 +0200 Subject: [PATCH 296/882] RN updates --- releases/2022.1.6.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/releases/2022.1.6.rst b/releases/2022.1.6.rst index b848d9296..56cdaa568 100644 --- a/releases/2022.1.6.rst +++ b/releases/2022.1.6.rst @@ -3,7 +3,7 @@ ************************** Release Notes 2022.1.6 ************************** -The 2022.1.6 release notes were released on 11/xx/2022 and describe the following: +The 2022.1.6 release notes were released on 11/29/2022 and describe the following: .. contents:: :local: @@ -56,7 +56,7 @@ SQream is declaring end of support of VARCHAR data type, the decision resulted b VARCHAR is no longer supported for new customers - effective from Version 2022.1.3 (September 2022). -TEXT data type is replacing VARCHAR - SQream will maintain VARCHAR data type support until 09/30/2023. +TEXT data type is replacing VARCHAR and NVARCHAR - SQream will maintain VARCHAR data type support until 09/30/2023. End of Support From 1c0016a009c09feecdef5477f8fd1fb808b64ce9 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Tue, 29 Nov 2022 14:49:10 +0200 Subject: [PATCH 297/882] Update data_encryption_overview.rst --- feature_guides/data_encryption_overview.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/feature_guides/data_encryption_overview.rst b/feature_guides/data_encryption_overview.rst index 925abdbbe..919700131 100644 --- a/feature_guides/data_encryption_overview.rst +++ b/feature_guides/data_encryption_overview.rst @@ -11,7 +11,7 @@ The demand for confidentiality has steadily increased to protect the growing vol Encryption can be used for the following: -* Creating tables up to three encrypted columns. +* Creating tables with up to three encrypted columns. :: @@ -21,7 +21,7 @@ Encryption can be used for the following: * Selecting data from an encrypted column. -.. note:: Executing ``CREATE TABLE AS`` ``SELECT`` when one or more columns contain encrypted data will result in newly created table containing unencrypted data. +.. note:: The ``SELECT`` statement decrypts information by default. When executing ``CREATE TABLE AS`` ``SELECT``, re-encryption of confidential information is required. For more information on the encryption syntax, see :ref:`data_encryption_syntax`. From 6475feaaf6ef81251765727e44624aff28c36a9c Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Tue, 29 Nov 2022 14:54:01 +0200 Subject: [PATCH 298/882] Update data_encryption_overview.rst --- feature_guides/data_encryption_overview.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/feature_guides/data_encryption_overview.rst b/feature_guides/data_encryption_overview.rst index 919700131..f2fb60b57 100644 --- a/feature_guides/data_encryption_overview.rst +++ b/feature_guides/data_encryption_overview.rst @@ -21,7 +21,7 @@ Encryption can be used for the following: * Selecting data from an encrypted column. -.. note:: The ``SELECT`` statement decrypts information by default. When executing ``CREATE TABLE AS`` ``SELECT``, re-encryption of confidential information is required. +.. note:: The ``SELECT`` statement decrypts information by default. When executing ``CREATE TABLE AS SELECT``, re-encryption of confidential information is required. For more information on the encryption syntax, see :ref:`data_encryption_syntax`. From f8b17a13d25132dd86a7013b7492b0610ee3a6fb Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Tue, 29 Nov 2022 16:07:47 +0200 Subject: [PATCH 299/882] Update window_functions.rst --- reference/sql/sql_syntax/window_functions.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_syntax/window_functions.rst b/reference/sql/sql_syntax/window_functions.rst index 39d072d33..7718e8b3a 100644 --- a/reference/sql/sql_syntax/window_functions.rst +++ b/reference/sql/sql_syntax/window_functions.rst @@ -161,7 +161,7 @@ Without ``PARTITION BY``, all rows produced by the query are treated as a single ``ORDER BY`` ---------------------- -The ``ORDER BY`` clause determines the order in which the rows of a partition are processed by the window function. It works similarly to a query-level ``ORDER BY`` clause, but cannot use output-column names or numbers. +The ``ORDER BY`` clause determines the order in which the rows of a partition are processed by the window function. It works similarly to a query-level ``ORDER BY`` clause, but cannot use output-column names or indexes. Without ``ORDER BY``, rows are processed in an unspecified order. From 40e6bbfdaaff5ac400fd20069d8ce9dfc2f02988 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Tue, 29 Nov 2022 17:34:33 +0200 Subject: [PATCH 300/882] Update data_encryption_overview.rst --- feature_guides/data_encryption_overview.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/feature_guides/data_encryption_overview.rst b/feature_guides/data_encryption_overview.rst index f2fb60b57..ca953ce2a 100644 --- a/feature_guides/data_encryption_overview.rst +++ b/feature_guides/data_encryption_overview.rst @@ -21,8 +21,7 @@ Encryption can be used for the following: * Selecting data from an encrypted column. -.. note:: The ``SELECT`` statement decrypts information by default. When executing ``CREATE TABLE AS SELECT``, re-encryption of confidential information is required. - +.. warning:: The ``SELECT`` statement decrypts information by default. When executing ``CREATE TABLE AS SELECT``, encrypted information will appear as clear text in the newly created table. For more information on the encryption syntax, see :ref:`data_encryption_syntax`. From e6a9eb800bfd51958a75b2bcb6a43a3ad090b389 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Wed, 30 Nov 2022 11:59:33 +0200 Subject: [PATCH 301/882] Update 2022.1.6.rst --- releases/2022.1.6.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/releases/2022.1.6.rst b/releases/2022.1.6.rst index 56cdaa568..05caecddf 100644 --- a/releases/2022.1.6.rst +++ b/releases/2022.1.6.rst @@ -39,6 +39,8 @@ Version 2022.1.6 resolved Issues +--------------------------------+--------------------------------------------------------------------------------------------+ | SQ-11295 | ``max_file_size`` when executing ``COPY_TO`` is imprecise | +--------------------------------+--------------------------------------------------------------------------------------------+ +| SQ-12204 | Possible issue when trying to INSERT Unicode data using .Net client | ++--------------------------------+--------------------------------------------------------------------------------------------+ From 682cb1ed2ae7af9b79cfe1d2e823e059b26e6eac Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Thu, 1 Dec 2022 08:33:12 +0200 Subject: [PATCH 302/882] Update 2022.1.6.rst --- releases/2022.1.6.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/releases/2022.1.6.rst b/releases/2022.1.6.rst index 05caecddf..67eb46222 100644 --- a/releases/2022.1.6.rst +++ b/releases/2022.1.6.rst @@ -12,7 +12,6 @@ The 2022.1.6 release notes were released on 11/29/2022 and describe the followin New Features ---------- -* Improved ZLIB compression performance. * :ref:`.Net Driver` now supports .NET version 6 or newer. :: From 726485821d8fc436d757a3839ab8b7b4503c810d Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Thu, 1 Dec 2022 13:11:21 +0200 Subject: [PATCH 303/882] 2022.1.7 --- conf.py | 2 +- releases/2022.1.7.rst | 102 ++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 103 insertions(+), 1 deletion(-) create mode 100644 releases/2022.1.7.rst diff --git a/conf.py b/conf.py index a821348da..104b75e03 100644 --- a/conf.py +++ b/conf.py @@ -26,7 +26,7 @@ # The full version, including alpha/beta/rc tags -release = '2022.1.6' +release = '2022.1.7' diff --git a/releases/2022.1.7.rst b/releases/2022.1.7.rst new file mode 100644 index 000000000..f879b41a1 --- /dev/null +++ b/releases/2022.1.7.rst @@ -0,0 +1,102 @@ +.. _2022.1.7: + +************************** +Release Notes 2022.1.7 +************************** +The 2022.1.7 release notes were released on 11/xx/2022 and describe the following: + +.. contents:: + :local: + :depth: 1 + +New Features +---------- + + * Inserting data from a JSON file. + + :: + + * ZLIB compression type performance enhancements. + + :: + + +Known Issues +--------- +:ref:`Percentile` is not supported for Window functions. + +Version 2022.1.7 resolved Issues +--------- + ++--------------------------------+--------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++================================+============================================================================================+ +| SQ-12228 | Executing ``CREATE AS SELECT`` with ``UNION`` and ``GROUP BY`` fails. | ++--------------------------------+--------------------------------------------------------------------------------------------+ +| SQ-12178 | SQreamNet does not support the ``ExecuteNonQuery`` ADO.NET command. | ++--------------------------------+--------------------------------------------------------------------------------------------+ +| SQ-11811 | Missing metadata optimization when joining ``TEXT`` columns. | ++--------------------------------+--------------------------------------------------------------------------------------------+ +| SQ-11772 | ``JOIN`` query performance issue. | ++--------------------------------+--------------------------------------------------------------------------------------------+ +| SQ-11523 | ``SAVED QUERY`` execution internal error. | ++--------------------------------+--------------------------------------------------------------------------------------------+ + + +Configuration Changes +-------- +No configuration changes were made. + +Naming Changes +------- +No relevant naming changes were made. + +Deprecated Features +------- +SQream is declaring end of support of VARCHAR data type, the decision resulted by SQream's effort to enhance its core functionalities and with respect to ever changing echo system requirements. + +VARCHAR is no longer supported for new customers - effective from Version 2022.1.3 (September 2022). + +TEXT data type is replacing VARCHAR and NVARCHAR - SQream will maintain VARCHAR data type support until 09/30/2023. + + +End of Support +------- +No End of Support changes were made. + +Upgrading to v2022.1.7 +------- +1. Generate a back-up of the metadata by running the following command: + + .. code-block:: console + + $ select backup_metadata('out_path'); + + .. tip:: SQream recommends storing the generated back-up locally in case needed. + + SQream runs the Garbage Collector and creates a clean backup tarball package. + +2. Shut down all SQream services. + + :: + +3. Extract the recently created back-up file. + + :: + +4. Replace your current metadata with the metadata you stored in the back-up file. + + :: + +5. Navigate to the new SQream package bin folder. + + :: + +6. Run the following command: + + .. code-block:: console + + $ ./upgrade_storage + + .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. + From fcb4608588ecc6b948daff6afef73fb168ae8a93 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Sun, 4 Dec 2022 17:32:45 +0200 Subject: [PATCH 304/882] JSON --- data_ingestion/avro.rst | 4 +- data_ingestion/index.rst | 1 + data_ingestion/json.rst | 234 +++++++++++++++++++++++++++++++++++++++ 3 files changed, 236 insertions(+), 3 deletions(-) create mode 100644 data_ingestion/json.rst diff --git a/data_ingestion/avro.rst b/data_ingestion/avro.rst index 7679df816..cfa048645 100644 --- a/data_ingestion/avro.rst +++ b/data_ingestion/avro.rst @@ -5,9 +5,7 @@ Inserting Data from Avro ************************** The **Inserting Data from Avro** page describes inserting data from Avro into SQream and includes the following: -.. |icon-new_2022.1| image:: /_static/images/new_2022.1.png - :align: middle - :width: 110 + .. contents:: :local: diff --git a/data_ingestion/index.rst b/data_ingestion/index.rst index c11d47faa..f75df595f 100644 --- a/data_ingestion/index.rst +++ b/data_ingestion/index.rst @@ -15,5 +15,6 @@ The **Data Ingestion Sources** provides information about the following: parquet orc oracle + json For information about database tools and interfaces that SQream supports, see `Third Party Tools `_. \ No newline at end of file diff --git a/data_ingestion/json.rst b/data_ingestion/json.rst new file mode 100644 index 000000000..5cdd8d3f2 --- /dev/null +++ b/data_ingestion/json.rst @@ -0,0 +1,234 @@ +.. _json: + +************************** +Inserting Data from JSON +************************** + + +.. contents:: In this topic: + :local: + + +Overview +======== +JSON (Java Script Object Notation) is a popular textual format. It’s flexibility makes it a common choice for representing dynamic, nested and semi-structured data. It’s used both as a file format and as a way for serializing messages. + +SQream DB's JSON parser handles `RFC 8259 `_. SQream supports JSON files consisting of either as a continuous batch of JSON objects, or as an array of JSON objects. + +SQream supports the `JSON Lines `_ standard, in which each lines in the input file contains exactly one JSON value (either an array or an object). When exporting data, SQream will always use objects. +Note that in JSONLines files every newlines (ASCII 10) character always marked the end of a JSON object. Therefore, value strings containing newline must escape it as \n. + + +Making JSON Files Accessible to Workers +================ +To give workers access to files every node must have the same view of the storage being used. + +The following apply for JSON files to be accessible to workers: + +* For files hosted on NFS, ensure that the mount is accessible from all servers. + +* For HDFS, ensure that SQream servers have access to the HDFS name node with the correct **user-id**. For more information, see :ref:`hdfs`. + +* For S3, ensure network access to the S3 endpoint. For more information, see :ref:`s3`. + +For more information about restricted worker access, see :ref:`workload_manager`. + +Preparing Your Table +=============== +You can build your table structure on both local and foreign tables: + + +Creating a Table +--------------------- +Before loading data, you must build the ``CREATE TABLE`` to correspond with the file structure of the inserted table. + +The example in this section is based on the source ``nba.json`` table shown below: + +.. csv-table:: nba.json + :file: nba-t10.json + :widths: auto + :header-rows: 1 + +The following example shows the correct file structure used to create the ``CREATE TABLE`` statement based on the **nba.json** table: + +.. code-block:: postgres + + CREATE TABLE ext_nba + ( + + Name TEXT(40), + Team TEXT(40), + Number BIGINT, + Position TEXT(2), + Age BIGINT, + Height TEXT(4), + Weight BIGINT, + College TEXT(40), + Salary FLOAT + ) + WRAPPER json_fdw + OPTIONS + ( + LOCATION = 's3://sqream-demo-data/nba.json' + ); + +.. tip:: + + An exact match must exist between the SQream and JSON types. For unsupported column types, you can set the type to any type and exclude it from subsequent queries. + +.. note:: The **nba.json** file is stored on S3 at ``s3://sqream-demo-data/nba.json``. + +Creating a Foreign Table +--------------------- +Before loading data, you must build the ``CREATE FOREIGN TABLE`` to correspond with the file structure of the inserted table. + +The example in this section is based on the source ``nba.json`` table shown below: + +.. csv-table:: nba.json + :file: nba-t10.csv + :widths: auto + :header-rows: 1 + +The following example shows the correct file structure used to create the ``CREATE FOREIGN TABLE`` statement based on the **nba.json** table: + +.. code-block:: postgres + + CREATE FOREIGN TABLE ext_nba + ( + + Name TEXT(40), + Team TEXT(40), + Number BIGINT, + Position TEXT(2), + Age BIGINT, + Height TEXT(4), + Weight BIGINT, + College TEXT(40), + Salary FLOAT + ) + WRAPPER json_fdw + OPTIONS + ( + LOCATION = 's3://sqream-demo-data/nba.json' + ); + +.. tip:: + + An exact match must exist between the SQream and JSON types. For unsupported column types, you can set the type to any type and exclude it from subsequent queries. + +.. note:: The **nba.json** file is stored on S3 at ``s3://sqream-demo-data/nba.json``. + +.. note:: The examples in the sections above are identical except for the syntax used to create the tables. + + +Mapping JSON to SQream +======================= +A JSON field consists of a key name and a value. JSON values may be the lower-case ``false``, ``true``, and ``null``, or any of the following data types: + + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - JSON Data Type + - Representation in SQream + - Notes + * - Number + - + - + * - String + - ``TEXT``, ``VARCHAR``, NVARCHAR + - Support in ``VARCHAR`` and ``NVARCHAR`` data types is about to end. + * - JSON Literal + - ``null``, ``true``, ``false`` + - + * - JSON Array + - ``TEXT`` + - + * - JSON Object + - ``TEXT`` + - + +JSON key names are mapped to SQream columns. Key names are case sensitive. +Note that using the jsonpath_location option overrides this mapping. - Verify meaning with Ben or Eyal. +A JSON row containing more than one field is registered as an error unless the fdw is configured to ignore. +An JSON row which is missing a field, automatically receives ``null`` as the value. + + +Ingesting Data into SQream +========================== + + +Syntax +------- +Before ingesting data into SQream from a JSON file, you must create a table using the following syntax: + +.. code-block:: + + COPY [schema name.]table_name + FROM WRAPPER fdw_name + ; + +After creating a table you can ingest data from an Avro file into SQream using the following syntax: + +.. code-block:: + + json_fdw + +To access JSON files, use the ``json_fdw`` with a ``copy_from``, ``copy_to``, or ``create_foreign_table`` statement. +The FDW syntax is: + +.. code-block:: + + json_fdw [OPTIONS(option=value[,...])] + +.. note:: Accessing JSON files is possible only by using the FDW syntax. + +Parameters +---------- +The following parameters are supported by json_fdw: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``datetime_format`` + - Default value is ``DEFAULT``. Supported date formats can be found in :ref:```COPY_TO```. + * - ``ignore_extra_fields`` + - Default is ``false``. + * - ``location`` + - A path on the local filesystem, S3, or HDFS URI. The local path must be an absolute path that SQream DB can access. + * - ``offset`` + - The row number to start with. + * - ``limit`` + - When specified, tells SQream DB to stop loading after the specified number of rows. Unlimited if unset. + * - ``error_log`` + - + * - ``continue_on_error + - Specifies if errors should be ignored or skipped. When set to true, the transaction will continue despite rejected data. This parameter should be set together with ``ERROR_COUNT`` When reading multiple files, if an entire file can’t be opened it will be skipped. + * - ``error_count`` + - Specifies the threshold for the maximum number of faulty records that will be ignored. This setting must be used in conjunction with ``CONTINUE_ON_ERROR``. + * - ``enforce_single_file`` + - Enforces the maximum file size (bytes). Permitted values: ``true`` - creates one file of unlimited size, ``false`` - permits creating several files together limited by the ``MAX_FILE_SIZE``. When set to ``true``, the single file size is not limited by the ``MAX_FILE_SIZE`` setting. When set to ``false``, the combined file sizes cannot exceed the ``MAX_FILE_SIZE``. Default value: ``FALSE``. + * - ``max_file_size`` + - Sets the maximum file size (bytes). + * - ``aws_id``, ``aws_secret`` + - Specifies the authentication details for secured S3 buckets + + +Automatic Schema Inference +--------------------------- +You may let SQream DB automatically infer the schema of a foreign table when using ``json_fdw``. For more information, follow the :ref:`Automatic Foreign Table DDL Resolution` page. + + + +Examples +-------- + + + +Limitations +=========== +Currently SQream does not support compressed JSON files. \ No newline at end of file From a64e1126a7cc2b21cc553f7209045633a80319fe Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Mon, 5 Dec 2022 09:37:04 +0200 Subject: [PATCH 305/882] Update ceiling.rst --- .../sql/sql_functions/scalar_functions/numeric/ceiling.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/numeric/ceiling.rst b/reference/sql/sql_functions/scalar_functions/numeric/ceiling.rst index 2f4e2d988..fad39aae6 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/ceiling.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/ceiling.rst @@ -15,7 +15,7 @@ Syntax CEILING( expr ) - CEIL ( expr ) --> DOUBLE + CEIL ( expr ) Arguments ============ @@ -34,7 +34,6 @@ Returns * ``CEIL`` Always returns a floating point result. -* ``CEILING`` returns the same type as the argument supplied. Notes ======= From 934ac91c5b64b0ddbbf939e4be89108f209750aa Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Mon, 5 Dec 2022 16:29:09 +0200 Subject: [PATCH 306/882] JSON documentation --- data_ingestion/avro.rst | 4 +- data_ingestion/csv.rst | 7 +- data_ingestion/index.rst | 4 +- ...{inserting_data.rst => ingesting_data.rst} | 14 +- data_ingestion/json.rst | 120 ++++++++++-------- data_ingestion/nba-t10.csv | 18 +-- data_ingestion/nba.json | 9 ++ data_ingestion/orc.rst | 8 +- data_ingestion/parquet.rst | 6 +- ...automatic_foreign_table_ddl_resolution.rst | 2 +- 10 files changed, 109 insertions(+), 83 deletions(-) rename data_ingestion/{inserting_data.rst => ingesting_data.rst} (97%) create mode 100644 data_ingestion/nba.json diff --git a/data_ingestion/avro.rst b/data_ingestion/avro.rst index cfa048645..a548ec265 100644 --- a/data_ingestion/avro.rst +++ b/data_ingestion/avro.rst @@ -1,9 +1,9 @@ .. _avro: ************************** -Inserting Data from Avro +Ingesting Data from Avro ************************** -The **Inserting Data from Avro** page describes inserting data from Avro into SQream and includes the following: +The **Ingesting Data from Avro** page describes ingesting data from Avro into SQream and includes the following: diff --git a/data_ingestion/csv.rst b/data_ingestion/csv.rst index 47c6d94a1..f902a5ed2 100644 --- a/data_ingestion/csv.rst +++ b/data_ingestion/csv.rst @@ -1,14 +1,15 @@ .. _csv: ********************** -Inserting Data from a CSV File +Ingesting Data from a CSV File ********************** -This guide covers inserting data from CSV files into SQream DB using the :ref:`copy_from` method. +This guide covers ingesting data from CSV files into SQream DB using the :ref:`copy_from` method. -.. contents:: In this topic: +.. contents:: :local: + :depth: 1 1. Prepare CSVs ===================== diff --git a/data_ingestion/index.rst b/data_ingestion/index.rst index f75df595f..6e8530710 100644 --- a/data_ingestion/index.rst +++ b/data_ingestion/index.rst @@ -3,13 +3,13 @@ ************************* Data Ingestion Sources ************************* -The **Data Ingestion Sources** provides information about the following: +The **Data Ingestion Sources** page provides information about the following: .. toctree:: :maxdepth: 1 :glob: - inserting_data + ingesting_data avro csv parquet diff --git a/data_ingestion/inserting_data.rst b/data_ingestion/ingesting_data.rst similarity index 97% rename from data_ingestion/inserting_data.rst rename to data_ingestion/ingesting_data.rst index e20e37920..97d57ef4c 100644 --- a/data_ingestion/inserting_data.rst +++ b/data_ingestion/ingesting_data.rst @@ -1,9 +1,9 @@ -.. _inserting_data: +.. _ingesting_data: *************************** -Inserting Data Overview +Ingesting Data Overview *************************** -The **Inserting Data Overview** page provides basic information useful when ingesting data into SQream from a variety of sources and locations, and describes the following: +The **Ingesting Data Overview** page provides basic information useful when ingesting data into SQream from a variety of sources and locations, and describes the following: .. contents:: :local: @@ -20,8 +20,8 @@ SQream supports ingesting data using the following methods: * Executing the ``COPY FROM`` statement or ingesting data from foreign tables: * Local filesystem and locally mounted network filesystems - * Inserting Data using the Amazon S3 object storage service - * Inserting Data using an HDFS data storage system + * Ingesting Data using the Amazon S3 object storage service + * Ingesting Data using an HDFS data storage system SQream supports loading files from the following formats: @@ -149,7 +149,7 @@ Text files, such as CSV, rarely conform to `RFC 4180 `_. SQream supports JSON files consisting of either as a continuous batch of JSON objects, or as an array of JSON objects. +JSON (Java Script Object Notation) is both a file format and a serializer. It is a flexible file format commonly used for dynamic, nested, and semi-structured data representations. -SQream supports the `JSON Lines `_ standard, in which each lines in the input file contains exactly one JSON value (either an array or an object). When exporting data, SQream will always use objects. -Note that in JSONLines files every newlines (ASCII 10) character always marked the end of a JSON object. Therefore, value strings containing newline must escape it as \n. +SQream DB's JSON parser handles `RFC 8259 `_. SQream supports JSON files either as a continuous batch of JSON objects, or as an array of JSON objects. + +SQream supports the `JSON Lines `_ standard, in which each line in the input file contains exactly one JSON row. When exporting data, SQream will always use objects. +Note that in JSON Line files, every newline (ASCII 10) character always marks the end of a JSON object; therefore, if a value string contains a newline character, it must be escaped as \\n. Making JSON Files Accessible to Workers -================ -To give workers access to files every node must have the same view of the storage being used. +======================================= +To give workers access to files, every node in your system must have access to the storage being used. -The following apply for JSON files to be accessible to workers: +The following are required for JSON files to be accessible to workers: * For files hosted on NFS, ensure that the mount is accessible from all servers. -* For HDFS, ensure that SQream servers have access to the HDFS name node with the correct **user-id**. For more information, see :ref:`hdfs`. +* For HDFS, ensure that SQream servers have access to the HDFS NameNode with the correct **user-id**. For more information, see :ref:`hdfs`. * For S3, ensure network access to the S3 endpoint. For more information, see :ref:`s3`. For more information about restricted worker access, see :ref:`workload_manager`. + Preparing Your Table -=============== +==================== You can build your table structure on both local and foreign tables: +.. contents:: + :local: + :depth: 1 Creating a Table --------------------- @@ -44,8 +48,8 @@ Before loading data, you must build the ``CREATE TABLE`` to correspond with the The example in this section is based on the source ``nba.json`` table shown below: -.. csv-table:: nba.json - :file: nba-t10.json +.. csv-table:: nba.avro + :file: nba-t10.csv :widths: auto :header-rows: 1 @@ -84,7 +88,7 @@ Before loading data, you must build the ``CREATE FOREIGN TABLE`` to correspond w The example in this section is based on the source ``nba.json`` table shown below: -.. csv-table:: nba.json +.. csv-table:: nba.avro :file: nba-t10.csv :widths: auto :header-rows: 1 @@ -123,7 +127,7 @@ The following example shows the correct file structure used to create the ``CREA Mapping JSON to SQream ======================= -A JSON field consists of a key name and a value. JSON values may be the lower-case ``false``, ``true``, and ``null``, or any of the following data types: +A JSON field consists of a key name and a value. JSON values may be one of the following reserved words (lower-case) ``false``, ``true``, and ``null``, or any of the following data types: .. list-table:: @@ -134,10 +138,10 @@ A JSON field consists of a key name and a value. JSON values may be the lower-ca - Representation in SQream - Notes * - Number - - + - ``tinyint``, ``smallint``, ``int``, ``bigint``, ``float``, ``double``, ``numeric`` - * - String - - ``TEXT``, ``VARCHAR``, NVARCHAR + - ``TEXT``, ``VARCHAR``, ``NVARCHAR`` - Support in ``VARCHAR`` and ``NVARCHAR`` data types is about to end. * - JSON Literal - ``null``, ``true``, ``false`` @@ -150,42 +154,32 @@ A JSON field consists of a key name and a value. JSON values may be the lower-ca - JSON key names are mapped to SQream columns. Key names are case sensitive. -Note that using the jsonpath_location option overrides this mapping. - Verify meaning with Ben or Eyal. -A JSON row containing more than one field is registered as an error unless the fdw is configured to ignore. -An JSON row which is missing a field, automatically receives ``null`` as the value. + +By default, rows containing extra fields will be treated as errors. This behavior can be changed so they will be ignored instead. + +An empty JSON field is automatically mapped with ``null`` as the value. Ingesting Data into SQream -========================== +=========================== +.. contents:: In this topic: + :local: Syntax ------- -Before ingesting data into SQream from a JSON file, you must create a table using the following syntax: - -.. code-block:: - - COPY [schema name.]table_name - FROM WRAPPER fdw_name - ; - -After creating a table you can ingest data from an Avro file into SQream using the following syntax: - -.. code-block:: - - json_fdw - -To access JSON files, use the ``json_fdw`` with a ``copy_from``, ``copy_to``, or ``create_foreign_table`` statement. +To access JSON files, use the ``json_fdw`` with a ``COPY FROM``, ``COPY TO``, or ``CREATE FOREIG TABLE`` statement. The FDW syntax is: .. code-block:: - json_fdw [OPTIONS(option=value[,...])] + json_fdw [OPTIONS(option=value[,...])] -.. note:: Accessing JSON files is possible only by using the FDW syntax. +.. note:: Reading and writing JSON files can be done only by using the ``json-fdw`` file format specifier. Parameters ----------- +------------ + The following parameters are supported by json_fdw: .. list-table:: @@ -195,9 +189,11 @@ The following parameters are supported by json_fdw: * - Parameter - Description * - ``datetime_format`` - - Default value is ``DEFAULT``. Supported date formats can be found in :ref:```COPY_TO```. + - Default value is ``default``. Supported date formats can be found in the :ref:`COPY FROM ` page. * - ``ignore_extra_fields`` - - Default is ``false``. + - Default value is ``false``. When value is ``true``, key names which do not have corresponding SQream table columns will be ignored. Parameter may be used with the ``COPY TO`` and ``IGNORE FOREIGN TABLE`` statements. + * - ``compression`` + - Supported values are ``auto``, ``gzip``, and ``none``. ``auto`` means that the compression type is automatically detected upon import. Parameter is not supported for exporting. ``gzip`` means that a ``gzip`` compression is applied. ``none`` means that no compression or an attempt to decompress will take place. * - ``location`` - A path on the local filesystem, S3, or HDFS URI. The local path must be an absolute path that SQream DB can access. * - ``offset`` @@ -206,12 +202,12 @@ The following parameters are supported by json_fdw: - When specified, tells SQream DB to stop loading after the specified number of rows. Unlimited if unset. * - ``error_log`` - - * - ``continue_on_error - - Specifies if errors should be ignored or skipped. When set to true, the transaction will continue despite rejected data. This parameter should be set together with ``ERROR_COUNT`` When reading multiple files, if an entire file can’t be opened it will be skipped. + * - ``continue_on_error`` + - Specifies if errors should be ignored or skipped. When set to true, the transaction will continue despite rejected data. This parameter should be set together with ``error_count``. When reading multiple files, if an entire file can’t be opened it will be skipped. * - ``error_count`` - - Specifies the threshold for the maximum number of faulty records that will be ignored. This setting must be used in conjunction with ``CONTINUE_ON_ERROR``. + - Specifies the threshold for the maximum number of faulty records that will be ignored. This setting must be used in conjunction with ``continue_on_error``. * - ``enforce_single_file`` - - Enforces the maximum file size (bytes). Permitted values: ``true`` - creates one file of unlimited size, ``false`` - permits creating several files together limited by the ``MAX_FILE_SIZE``. When set to ``true``, the single file size is not limited by the ``MAX_FILE_SIZE`` setting. When set to ``false``, the combined file sizes cannot exceed the ``MAX_FILE_SIZE``. Default value: ``FALSE``. + - Enforces the maximum file size (bytes). Permitted values: ``true`` - creates one file of unlimited size, ``false`` - permits creating several files together limited by the ``MAX_FILE_SIZE``. When set to ``true``, the single file size is not limited by the ``MAX_FILE_SIZE`` setting. When set to ``false``, the combined file sizes cannot exceed the ``MAX_FILE_SIZE``. Default value: ``false``. * - ``max_file_size`` - Sets the maximum file size (bytes). * - ``aws_id``, ``aws_secret`` @@ -220,15 +216,31 @@ The following parameters are supported by json_fdw: Automatic Schema Inference --------------------------- -You may let SQream DB automatically infer the schema of a foreign table when using ``json_fdw``. For more information, follow the :ref:`Automatic Foreign Table DDL Resolution` page. - +You may let SQream DB to automatically infer the schema of a foreign table when using ``json_fdw``. For more information, follow the :ref:`Automatic Foreign Table DDL Resolution` page. Examples --------- +------------ +The following is an example of creating a table: +.. code-block:: postgres + + COPY t + FROM WRAPPER fdw_name + OPTIONS + ( + [ copy_from_option [, ...] ] + ) + ; -Limitations -=========== -Currently SQream does not support compressed JSON files. \ No newline at end of file +The following is an example of loading data from a JSON file into SQream: + +.. code-block:: postgres + + WRAPPER json_fdw + OPTIONS + ( + LOCATION = 's3://sqream-demo-data/nba.json' + ); + diff --git a/data_ingestion/nba-t10.csv b/data_ingestion/nba-t10.csv index 024530355..e57ad3131 100644 --- a/data_ingestion/nba-t10.csv +++ b/data_ingestion/nba-t10.csv @@ -1,10 +1,10 @@ Name,Team,Number,Position,Age,Height,Weight,College,Salary -Avery Bradley,Boston Celtics,0.0,PG,25.0,6-2,180.0,Texas,7730337.0 -Jae Crowder,Boston Celtics,99.0,SF,25.0,6-6,235.0,Marquette,6796117.0 -John Holland,Boston Celtics,30.0,SG,27.0,6-5,205.0,Boston University, -R.J. Hunter,Boston Celtics,28.0,SG,22.0,6-5,185.0,Georgia State,1148640.0 -Jonas Jerebko,Boston Celtics,8.0,PF,29.0,6-10,231.0,,5000000.0 -Amir Johnson,Boston Celtics,90.0,PF,29.0,6-9,240.0,,12000000.0 -Jordan Mickey,Boston Celtics,55.0,PF,21.0,6-8,235.0,LSU,1170960.0 -Kelly Olynyk,Boston Celtics,41.0,C,25.0,7-0,238.0,Gonzaga,2165160.0 -Terry Rozier,Boston Celtics,12.0,PG,22.0,6-2,190.0,Louisville,1824360.0 +Avery Bradley,Boston Celtics,0,PG,25,44714,180,Texas,7730337 +Jae Crowder,Boston Celtics,99,SF,25,44718,235,Marquette,6796117 +John Holland,Boston Celtics,30,SG,27,44717,205,Boston University, +R.J. Hunter,Boston Celtics,28,SG,22,44717,185,Georgia State,1148640 +Jonas Jerebko,Boston Celtics,8,PF,29,44722,231,,5000000 +Amir Johnson,Boston Celtics,90,PF,29,44721,240,,12000000 +Jordan Mickey,Boston Celtics,55,PF,21,44720,235,LSU,1170960 +Kelly Olynyk,Boston Celtics,41,C,25,36708,238,Gonzaga,2165160 +Terry Rozier,Boston Celtics,12,PG,22,44714,190,Louisville,1824360 diff --git a/data_ingestion/nba.json b/data_ingestion/nba.json new file mode 100644 index 000000000..e4df53204 --- /dev/null +++ b/data_ingestion/nba.json @@ -0,0 +1,9 @@ +{"name":"Avery Bradley","team":"Boston Celtics","number":0,"position":"PG","age":25,"height":"6-2","weight":180.0,"college":"Texas","salary":7730337.0} +{"name":"Jae Crowder","team":"Boston Celtics","number":99,"position":"SF","age":25,"height":"6-6","weight":235.0,"college":"Marquette","salary":6796117.0} +{"name":"John Holland","team":"Boston Celtics","number":30,"position":"SG","age":27,"height":"6-5","weight":205.0,"college":"Boston University","salary":null} +{"name":"R.J. Hunter","team":"Boston Celtics","number":28,"position":"SG","age":22,"height":"6-5","weight":185.0,"college":"Georgia State","salary":1148640.0} +{"name":"Jonas Jerebko","team":"Boston Celtics","number":8,"position":"PF","age":29,"height":"6-10","weight":231.0,"college":null,"salary":5000000.0} +{"name":"Amir Johnson","team":"Boston Celtics","number":90,"position":"PF","age":29,"height":"6-9","weight":240.0,"college":null,"salary":12000000.0} +{"name":"Jordan Mickey","team":"Boston Celtics","number":55,"position":"PF","age":21,"height":"6-8","weight":235.0,"college":"LSU","salary":1170960.0} +{"name":"Kelly Olynyk","team":"Boston Celtics","number":41,"position":"C","age":25,"height":"7-0","weight":238.0,"college":"Gonzaga","salary":2165160.0} +{"name":"Terry Rozier","team":"Boston Celtics","number":12,"position":"PG","age":22,"height":"6-2","weight":190.0,"college":"Louisville","salary":1824360.0} \ No newline at end of file diff --git a/data_ingestion/orc.rst b/data_ingestion/orc.rst index cfcf6c38b..f7ea1fdea 100644 --- a/data_ingestion/orc.rst +++ b/data_ingestion/orc.rst @@ -1,10 +1,14 @@ .. _orc: ********************** -Inserting Data from an ORC File +Ingesting Data from an ORC File ********************** -This guide covers inserting data from ORC files into SQream DB using :ref:`FOREIGN TABLE`. +.. contents:: + :local: + :depth: 1 + +This guide covers ingesting data from ORC files into SQream DB using :ref:`FOREIGN TABLE`. 1. Prepare the files diff --git a/data_ingestion/parquet.rst b/data_ingestion/parquet.rst index 9a8e4c24b..2128cf17c 100644 --- a/data_ingestion/parquet.rst +++ b/data_ingestion/parquet.rst @@ -1,9 +1,9 @@ .. _parquet: ********************** -Inserting Data from a Parquet File +Ingesting Data from a Parquet File ********************** -This guide covers inserting data from Parquet files into SQream using :ref:`FOREIGN TABLE`, and describes the following; +This guide covers ingesting data from Parquet files into SQream using :ref:`FOREIGN TABLE`, and describes the following; .. contents:: :local: @@ -11,7 +11,7 @@ This guide covers inserting data from Parquet files into SQream using :ref:`FORE Overview =================== -SQream supports inserting data into SQream from Parquet files. However, because it is an open-source column-oriented data storage format, you may want to retain your data on external Parquet files instead of inserting it into SQream. SQream supports executing queries on external Parquet files. +SQream supports ingesting data into SQream from Parquet files. However, because it is an open-source column-oriented data storage format, you may want to retain your data on external Parquet files instead of ingesting it into SQream. SQream supports executing queries on external Parquet files. Preparing Your Parquet Files ===================== diff --git a/feature_guides/automatic_foreign_table_ddl_resolution.rst b/feature_guides/automatic_foreign_table_ddl_resolution.rst index 3ce1cc49f..6c0d1605c 100644 --- a/feature_guides/automatic_foreign_table_ddl_resolution.rst +++ b/feature_guides/automatic_foreign_table_ddl_resolution.rst @@ -15,7 +15,7 @@ SQream must be able to access a schema when reading and mapping external files t Usage Notes ---------- -The automatic foreign table DDL resolution feature supports Parquet, ORC, and Avro files, while using it with CSV files generates an error. You can activate this feature when you create a foreign table by omitting the column list, described in the **Syntax** section below. +The automatic foreign table DDL resolution feature supports Parquet, ORC, JSON, and Avro files, while using it with CSV files generates an error. You can activate this feature when you create a foreign table by omitting the column list, described in the **Syntax** section below. Using this feature the path you specify in the ``LOCATION`` option must point to at least one existing file. If no files exist for the schema to read, an error will be generated. You can specify the schema manually even in the event of the error above. From bed2cdd8df602a71ad57119e3d4200f6ebc8c27e Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Mon, 5 Dec 2022 17:21:07 +0200 Subject: [PATCH 307/882] Update json.rst --- data_ingestion/json.rst | 30 +++++++++++++++--------------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/data_ingestion/json.rst b/data_ingestion/json.rst index 489ffc9e5..121b1d62a 100644 --- a/data_ingestion/json.rst +++ b/data_ingestion/json.rst @@ -11,12 +11,14 @@ Ingesting Data from JSON Overview ======== -JSON (Java Script Object Notation) is both a file format and a serializer. It is a flexible file format commonly used for dynamic, nested, and semi-structured data representations. +JSON (Java Script Object Notation) is used both as a file format and as a serialization method. The JSON file format is flexible and is commonly used for dynamic, nested, and semi-structured data representations. -SQream DB's JSON parser handles `RFC 8259 `_. SQream supports JSON files either as a continuous batch of JSON objects, or as an array of JSON objects. +The SQream DB JSON parser handles `RFC 8259 `_. +SQream DB supports: -SQream supports the `JSON Lines `_ standard, in which each line in the input file contains exactly one JSON row. When exporting data, SQream will always use objects. -Note that in JSON Line files, every newline (ASCII 10) character always marks the end of a JSON object; therefore, if a value string contains a newline character, it must be escaped as \\n. +* JSON files either as a continuous batch of JSON objects, or as an array of JSON objects +* The `JSON Lines `_ standard, in which every newline (ASCII 10) character always marks the end of a JSON object; therefore, if a value string contains a newline character, it must be escaped as \\n +When exporting data, SQream will always use objects. Making JSON Files Accessible to Workers @@ -44,7 +46,7 @@ You can build your table structure on both local and foreign tables: Creating a Table --------------------- -Before loading data, you must build the ``CREATE TABLE`` to correspond with the file structure of the inserted table. +Before loading data, you must build the ``CREATE TABLE`` statement to correspond with the file structure of the inserted table. The example in this section is based on the source ``nba.json`` table shown below: @@ -53,7 +55,7 @@ The example in this section is based on the source ``nba.json`` table shown belo :widths: auto :header-rows: 1 -The following example shows the correct file structure used to create the ``CREATE TABLE`` statement based on the **nba.json** table: +The following example shows the correct file structure used to build the ``CREATE TABLE`` statement based on the **nba.json** table: .. code-block:: postgres @@ -84,7 +86,7 @@ The following example shows the correct file structure used to create the ``CREA Creating a Foreign Table --------------------- -Before loading data, you must build the ``CREATE FOREIGN TABLE`` to correspond with the file structure of the inserted table. +Before loading data, you must build the ``CREATE FOREIGN TABLE`` statement to correspond with the file structure of the inserted table. The example in this section is based on the source ``nba.json`` table shown below: @@ -93,7 +95,7 @@ The example in this section is based on the source ``nba.json`` table shown belo :widths: auto :header-rows: 1 -The following example shows the correct file structure used to create the ``CREATE FOREIGN TABLE`` statement based on the **nba.json** table: +The following example shows the correct file structure used to build the ``CREATE FOREIGN TABLE`` statement based on the **nba.json** table: .. code-block:: postgres @@ -153,11 +155,9 @@ A JSON field consists of a key name and a value. JSON values may be one of the f - ``TEXT`` - -JSON key names are mapped to SQream columns. Key names are case sensitive. - -By default, rows containing extra fields will be treated as errors. This behavior can be changed so they will be ignored instead. +JSON key names, which are case sensitive, are mapped to SQream columns. By default, key names which do not have corresponding SQream table columns are treated as errors, though this behavior can be changed so that they are ignored instead. -An empty JSON field is automatically mapped with ``null`` as the value. +An empty JSON field is automatically mapped to SQream with ``null`` as a value. Ingesting Data into SQream @@ -175,12 +175,12 @@ The FDW syntax is: json_fdw [OPTIONS(option=value[,...])] -.. note:: Reading and writing JSON files can be done only by using the ``json-fdw`` file format specifier. +.. note:: Reading and writing JSON files is enabled only by using the ``json-fdw`` file format specifier. Parameters ------------ -The following parameters are supported by json_fdw: +The following parameters are supported by ``json_fdw``: .. list-table:: :widths: auto @@ -217,7 +217,7 @@ The following parameters are supported by json_fdw: Automatic Schema Inference --------------------------- -You may let SQream DB to automatically infer the schema of a foreign table when using ``json_fdw``. For more information, follow the :ref:`Automatic Foreign Table DDL Resolution` page. +You may let SQream DB automatically infer the schema of a foreign table when using ``json_fdw``. For more information, follow the :ref:`Automatic Foreign Table DDL Resolution` page. Examples ------------ From da569cdbafc704617de1c8d70df18e7ef5f24585 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Mon, 5 Dec 2022 17:24:41 +0200 Subject: [PATCH 308/882] JSON JSON --- data_ingestion/json.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/data_ingestion/json.rst b/data_ingestion/json.rst index 121b1d62a..12370279d 100644 --- a/data_ingestion/json.rst +++ b/data_ingestion/json.rst @@ -50,7 +50,7 @@ Before loading data, you must build the ``CREATE TABLE`` statement to correspond The example in this section is based on the source ``nba.json`` table shown below: -.. csv-table:: nba.avro +.. csv-table:: nba.json :file: nba-t10.csv :widths: auto :header-rows: 1 @@ -90,7 +90,7 @@ Before loading data, you must build the ``CREATE FOREIGN TABLE`` statement to co The example in this section is based on the source ``nba.json`` table shown below: -.. csv-table:: nba.avro +.. csv-table:: nba.json :file: nba-t10.csv :widths: auto :header-rows: 1 From 90eb9599c40d921e3cf81108f1944d1795930686 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Mon, 5 Dec 2022 18:14:35 +0200 Subject: [PATCH 309/882] Update json.rst --- data_ingestion/json.rst | 63 ++++++----------------------------------- 1 file changed, 8 insertions(+), 55 deletions(-) diff --git a/data_ingestion/json.rst b/data_ingestion/json.rst index 12370279d..b5ccf661d 100644 --- a/data_ingestion/json.rst +++ b/data_ingestion/json.rst @@ -36,57 +36,10 @@ The following are required for JSON files to be accessible to workers: For more information about restricted worker access, see :ref:`workload_manager`. -Preparing Your Table -==================== -You can build your table structure on both local and foreign tables: - -.. contents:: - :local: - :depth: 1 - -Creating a Table ---------------------- -Before loading data, you must build the ``CREATE TABLE`` statement to correspond with the file structure of the inserted table. - -The example in this section is based on the source ``nba.json`` table shown below: - -.. csv-table:: nba.json - :file: nba-t10.csv - :widths: auto - :header-rows: 1 - -The following example shows the correct file structure used to build the ``CREATE TABLE`` statement based on the **nba.json** table: - -.. code-block:: postgres - - CREATE TABLE ext_nba - ( - - Name TEXT(40), - Team TEXT(40), - Number BIGINT, - Position TEXT(2), - Age BIGINT, - Height TEXT(4), - Weight BIGINT, - College TEXT(40), - Salary FLOAT - ) - WRAPPER json_fdw - OPTIONS - ( - LOCATION = 's3://sqream-demo-data/nba.json' - ); - -.. tip:: - - An exact match must exist between the SQream and JSON types. For unsupported column types, you can set the type to any type and exclude it from subsequent queries. - -.. note:: The **nba.json** file is stored on S3 at ``s3://sqream-demo-data/nba.json``. Creating a Foreign Table ---------------------- -Before loading data, you must build the ``CREATE FOREIGN TABLE`` statement to correspond with the file structure of the inserted table. +========================= +When creating a foreign table statement, make sure that the table schema corresponds with the JSON file structure. The example in this section is based on the source ``nba.json`` table shown below: @@ -102,14 +55,14 @@ The following example shows the correct file structure used to build the ``CREAT CREATE FOREIGN TABLE ext_nba ( - Name TEXT(40), - Team TEXT(40), + Name TEXT, + Team TEXT, Number BIGINT, - Position TEXT(2), + Position TEXT, Age BIGINT, - Height TEXT(4), + Height TEXT, Weight BIGINT, - College TEXT(40), + College TEXT, Salary FLOAT ) WRAPPER json_fdw @@ -222,7 +175,7 @@ You may let SQream DB automatically infer the schema of a foreign table when usi Examples ------------ -The following is an example of creating a table: +The following is an example of creating a table using the COPY FROM statement: .. code-block:: postgres From 982c35427d48487e939a36ef94da96e13fc93893 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Mon, 5 Dec 2022 18:34:43 +0200 Subject: [PATCH 310/882] Update json.rst --- data_ingestion/json.rst | 29 ++++++++++++++++++++++++++--- 1 file changed, 26 insertions(+), 3 deletions(-) diff --git a/data_ingestion/json.rst b/data_ingestion/json.rst index b5ccf661d..c744c6cd7 100644 --- a/data_ingestion/json.rst +++ b/data_ingestion/json.rst @@ -175,15 +175,38 @@ You may let SQream DB automatically infer the schema of a foreign table when usi Examples ------------ -The following is an example of creating a table using the COPY FROM statement: +The following is an example of creating a table using the ``COPY FROM``, ``COPY TO``, and ``CREATE FOREIGN TABLE`` statements: .. code-block:: postgres COPY t - FROM WRAPPER fdw_name + FROM WRAPPER json_fdw OPTIONS ( - [ copy_from_option [, ...] ] + location = 'somefile.json' + ) + ; + +.. code-block:: postgres + + COPY t + TO WRAPPER json_fdw + OPTIONS + ( + location = 'somefile.json' + ) + ; + +.. code-block:: postgres + + CREATE FOREIGN TABLE t + ( + id int not null + ) + WRAPPER json_fdw + OPTIONS + ( + location = 'somefile.json' ) ; From a96817cd5ef5074efca3fbc293b74527a3c2a3a5 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Thu, 8 Dec 2022 14:26:44 +0200 Subject: [PATCH 311/882] Update json.rst --- data_ingestion/json.rst | 204 ++++++++++++++++++++++++---------------- 1 file changed, 122 insertions(+), 82 deletions(-) diff --git a/data_ingestion/json.rst b/data_ingestion/json.rst index c744c6cd7..b9eb6c5b9 100644 --- a/data_ingestion/json.rst +++ b/data_ingestion/json.rst @@ -13,12 +13,7 @@ Overview JSON (Java Script Object Notation) is used both as a file format and as a serialization method. The JSON file format is flexible and is commonly used for dynamic, nested, and semi-structured data representations. -The SQream DB JSON parser handles `RFC 8259 `_. -SQream DB supports: - -* JSON files either as a continuous batch of JSON objects, or as an array of JSON objects -* The `JSON Lines `_ standard, in which every newline (ASCII 10) character always marks the end of a JSON object; therefore, if a value string contains a newline character, it must be escaped as \\n -When exporting data, SQream will always use objects. +The SQream DB JSON parser handles `RFC 8259 `_ and supports both JSON objects and object arrays. Making JSON Files Accessible to Workers @@ -36,53 +31,16 @@ The following are required for JSON files to be accessible to workers: For more information about restricted worker access, see :ref:`workload_manager`. +Mapping between JSON and SQream +=============================== -Creating a Foreign Table -========================= -When creating a foreign table statement, make sure that the table schema corresponds with the JSON file structure. - -The example in this section is based on the source ``nba.json`` table shown below: - -.. csv-table:: nba.json - :file: nba-t10.csv - :widths: auto - :header-rows: 1 - -The following example shows the correct file structure used to build the ``CREATE FOREIGN TABLE`` statement based on the **nba.json** table: - -.. code-block:: postgres - - CREATE FOREIGN TABLE ext_nba - ( - - Name TEXT, - Team TEXT, - Number BIGINT, - Position TEXT, - Age BIGINT, - Height TEXT, - Weight BIGINT, - College TEXT, - Salary FLOAT - ) - WRAPPER json_fdw - OPTIONS - ( - LOCATION = 's3://sqream-demo-data/nba.json' - ); - -.. tip:: - - An exact match must exist between the SQream and JSON types. For unsupported column types, you can set the type to any type and exclude it from subsequent queries. - -.. note:: The **nba.json** file is stored on S3 at ``s3://sqream-demo-data/nba.json``. +The only JSON standard supported by SQream is the `JSON Lines `_ standard. -.. note:: The examples in the sections above are identical except for the syntax used to create the tables. +A JSON field consists of a key name and a value. +Key names, which are case sensitive, are mapped to SQream columns. Key names which do not have corresponding SQream table columns are treated as errors by default, unless the ``IGNORE_EXTRA_FIELDS`` parameter is set to ``true``, in which case these key names will be ignored during the mapping process. -Mapping JSON to SQream -======================= -A JSON field consists of a key name and a value. JSON values may be one of the following reserved words (lower-case) ``false``, ``true``, and ``null``, or any of the following data types: +Values may be one of the following reserved words (lower-case): ``false``, ``true``, and ``null``, or any of the following data types: .. list-table:: @@ -91,27 +49,26 @@ A JSON field consists of a key name and a value. JSON values may be one of the f * - JSON Data Type - Representation in SQream - - Notes * - Number - - ``tinyint``, ``smallint``, ``int``, ``bigint``, ``float``, ``double``, ``numeric`` - - + - ``TINYINT``, ``SMALLINT``, ``INT``, ``BIGINT``, ``FLOAT``, ``DOUBLE``, ``NUMERIC`` * - String - - ``TEXT``, ``VARCHAR``, ``NVARCHAR`` - - Support in ``VARCHAR`` and ``NVARCHAR`` data types is about to end. + - ``TEXT`` * - JSON Literal - - ``null``, ``true``, ``false`` - - + - ``NULL``, ``TRUE``, ``FALSE`` * - JSON Array - ``TEXT`` - - * - JSON Object - ``TEXT`` - - -JSON key names, which are case sensitive, are mapped to SQream columns. By default, key names which do not have corresponding SQream table columns are treated as errors, though this behavior can be changed so that they are ignored instead. - An empty JSON field is automatically mapped to SQream with ``null`` as a value. +Character Escaping +------------------ + +The ASCII 10 character (LF) marks the end of JSON objects. Use ``\\n`` to avoid a new line within a value string. + +When exporting data, SQream will always use objects. + Ingesting Data into SQream =========================== @@ -121,14 +78,16 @@ Ingesting Data into SQream Syntax ------- -To access JSON files, use the ``json_fdw`` with a ``COPY FROM``, ``COPY TO``, or ``CREATE FOREIG TABLE`` statement. -The FDW syntax is: +To access JSON files, use the ``json_fdw`` with a ``COPY FROM``, ``COPY TO``, or ``CREATE FOREIGN TABLE`` statement. + +The Foreign Data Wrapper (FDW) syntax is: .. code-block:: json_fdw [OPTIONS(option=value[,...])] -.. note:: Reading and writing JSON files is enabled only by using the ``json-fdw`` file format specifier. +.. note:: The ``json_fdw`` is the only file format specifier which may be used for reading and writing JSON files. + Parameters ------------ @@ -141,41 +100,49 @@ The following parameters are supported by ``json_fdw``: * - Parameter - Description - * - ``datetime_format`` - - Default value is ``default``. Supported date formats can be found in the :ref:`COPY FROM ` page. - * - ``ignore_extra_fields`` + * - ``DATETIME_FORMAT`` + - Default format is ``yyyy-mm-dd``. Other supported date formats are:``iso8601``, ``iso8601c``, ``dmy``, ``ymd``, ``mdy``, ``yyyymmdd``, ``yyyy-m-d``, ``yyyy-mm-dd``, ``yyyy/m/d``, ``yyyy/mm/dd``, ``d/m/yyyy``, ``dd/mm/yyyy``, ``mm/dd/yyyy``, ``dd-mon-yyyy``, ``yyyy-mon-dd``. + * - ``IGNORE_EXTRA_FIELDS`` - Default value is ``false``. When value is ``true``, key names which do not have corresponding SQream table columns will be ignored. Parameter may be used with the ``COPY TO`` and ``IGNORE FOREIGN TABLE`` statements. - * - ``compression`` + * - ``COMPRESSION`` - Supported values are ``auto``, ``gzip``, and ``none``. ``auto`` means that the compression type is automatically detected upon import. Parameter is not supported for exporting. ``gzip`` means that a ``gzip`` compression is applied. ``none`` means that no compression or an attempt to decompress will take place. - * - ``location`` + * - ``LOCATION`` - A path on the local filesystem, S3, or HDFS URI. The local path must be an absolute path that SQream DB can access. - * - ``offset`` + * - ``OFFSET`` - The row number to start with. - * - ``limit`` + * - ``LIMIT`` - When specified, tells SQream DB to stop loading after the specified number of rows. Unlimited if unset. - * - ``error_log`` - - - * - ``continue_on_error`` - - Specifies if errors should be ignored or skipped. When set to true, the transaction will continue despite rejected data. This parameter should be set together with ``error_count``. When reading multiple files, if an entire file can’t be opened it will be skipped. - * - ``error_count`` + * - ``ERROR_LOG`` + - When used, the ``COPY`` process will write error information from unparsable rows to the file specified by this parameter. + + * If an existing file path is specified, it will be overwritten. + + * Specifying the same file for ``ERROR_LOG`` and ``REJECTED_DATA`` is not allowed and will result in error. + + * Specifing an error log when creating a foreign table will write a new error log for every query on the foreign table. + * - ``CONTINUE_ON_ERROR`` + - Specifies if errors should be ignored or skipped. When set to true, the transaction will continue despite rejected data. This parameter should be set together with ``ERROR_COUNT``. When reading multiple files, if an entire file can’t be opened it will be skipped. + * - ``ERROR_COUNT`` - Specifies the threshold for the maximum number of faulty records that will be ignored. This setting must be used in conjunction with ``continue_on_error``. - * - ``enforce_single_file`` - - Enforces the maximum file size (bytes). Permitted values: ``true`` - creates one file of unlimited size, ``false`` - permits creating several files together limited by the ``MAX_FILE_SIZE``. When set to ``true``, the single file size is not limited by the ``MAX_FILE_SIZE`` setting. When set to ``false``, the combined file sizes cannot exceed the ``MAX_FILE_SIZE``. Default value: ``false``. - * - ``max_file_size`` + * - ``ENFORCE_SINGLE_FILE`` + - Enforces the maximum file size (bytes). Permitted values: ``true`` - creates one file of unlimited size, ``false`` - permits creating several files together limited by the ``max_file_size``. When set to ``true``, the single file size is not limited by the ``max_file_size`` setting. When set to ``false``, the combined file sizes cannot exceed the ``max_file_size``. Default value: ``false``. + * - ``MAX_FILE_SIZE`` - Sets the maximum file size (bytes). - * - ``aws_id``, ``aws_secret`` + * - ``AWS_ID``, ``AWS_SECRET`` - Specifies the authentication details for secured S3 buckets Automatic Schema Inference --------------------------- -You may let SQream DB automatically infer the schema of a foreign table when using ``json_fdw``. For more information, follow the :ref:`Automatic Foreign Table DDL Resolution` page. +You may let SQream DB automatically infer the schema of a foreign table when using ``json_fdw``. + +For more information, follow the :ref:`Automatic Foreign Table DDL Resolution` page. Examples ------------ -The following is an example of creating a table using the ``COPY FROM``, ``COPY TO``, and ``CREATE FOREIGN TABLE`` statements: +Using the ``COPY FROM`` statement: .. code-block:: postgres @@ -187,6 +154,8 @@ The following is an example of creating a table using the ``COPY FROM``, ``COPY ) ; +Using the ``COPY TO`` statement: + .. code-block:: postgres COPY t @@ -197,6 +166,8 @@ The following is an example of creating a table using the ``COPY FROM``, ``COPY ) ; +When using the ``CREATE FOREIGN TABLE`` statement, make sure that the table schema corresponds with the JSON file structure. + .. code-block:: postgres CREATE FOREIGN TABLE t @@ -217,6 +188,75 @@ The following is an example of loading data from a JSON file into SQream: WRAPPER json_fdw OPTIONS ( - LOCATION = 's3://sqream-demo-data/nba.json' + LOCATION = 'somefile.json' ); + + +JSON object array: + +.. code-block:: postgres + + { + "name":"Avery Bradley", + "age":25, + "position":"PG" + } + { + "name":"Jae Crowder", + "age":25, + "position":"PG" + } + { + "name":"John Holland", + "age":27, + "position":"SG" + } + +JSON objects: + +.. code-block:: postgres + + [ + { "name":"Avery Bradley", "age":25, "position":"PG" }, + { "name":"Jae Crowder", "age":25, "position":"SF" }, + { "name":"John Holland", "age":27, "position":"SG" } + ] + + +The example in this section is based on the source ``nba.json`` table shown below: + +.. csv-table:: nba.json + :file: nba-t10.csv + :widths: auto + :header-rows: 1 + +The following example shows the correct file structure used to build the ``CREATE FOREIGN TABLE`` statement based on the **nba.json** table: + +.. code-block:: postgres + + CREATE FOREIGN TABLE ext_nba + ( + + Name TEXT, + Team TEXT, + Number BIGINT, + Position TEXT, + Age BIGINT, + Height TEXT, + Weight BIGINT, + College TEXT, + Salary FLOAT + ) + WRAPPER json_fdw + OPTIONS + ( + LOCATION = 's3://sqream-demo-data/nba.json' + ); + +.. tip:: + + An exact match must exist between the SQream and JSON types. For unsupported column types, you can set the type to any type and exclude it from subsequent queries. + + + From f9112474ad464ee2fa95f883ec9a38dc78d414a7 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Thu, 8 Dec 2022 17:01:46 +0200 Subject: [PATCH 312/882] JSON --- data_ingestion/csv.rst | 8 +-- data_ingestion/json.rst | 110 ++++++++++++++-------------------------- data_ingestion/orc.rst | 10 ++-- 3 files changed, 47 insertions(+), 81 deletions(-) diff --git a/data_ingestion/csv.rst b/data_ingestion/csv.rst index f902a5ed2..afe819fb5 100644 --- a/data_ingestion/csv.rst +++ b/data_ingestion/csv.rst @@ -11,7 +11,7 @@ This guide covers ingesting data from CSV files into SQream DB using the :ref:`c :local: :depth: 1 -1. Prepare CSVs +Prepare CSVs ===================== Prepare the source CSVs, with the following requirements: @@ -45,7 +45,7 @@ Prepare the source CSVs, with the following requirements: .. note:: If a text field is quoted but contains no content (``""``) it is considered an empty text field. It is not considered ``NULL``. -2. Place CSVs where SQream DB workers can access +Place CSVs where SQream DB workers can access ======================================================= During data load, the :ref:`copy_from` command can run on any worker (unless explicitly speficied with the :ref:`workload_manager`). @@ -57,7 +57,7 @@ It is important that every node has the same view of the storage being used - me * For S3, ensure network access to the S3 endpoint. See our :ref:`s3` guide for more information. -3. Figure out the table structure +Figure out the table structure =============================================== Prior to loading data, you will need to write out the table structure, so that it matches the file structure. @@ -96,7 +96,7 @@ We will make note of the file structure to create a matching ``CREATE TABLE`` st ); -4. Bulk load the data with COPY FROM +Bulk load the data with COPY FROM ==================================== The CSV is a standard CSV, but with two differences from SQream DB defaults: diff --git a/data_ingestion/json.rst b/data_ingestion/json.rst index b9eb6c5b9..16f0b20f1 100644 --- a/data_ingestion/json.rst +++ b/data_ingestion/json.rst @@ -15,9 +15,12 @@ JSON (Java Script Object Notation) is used both as a file format and as a serial The SQream DB JSON parser handles `RFC 8259 `_ and supports both JSON objects and object arrays. +The only JSON standard supported by SQream is `JSON Lines `_. + Making JSON Files Accessible to Workers ======================================= + To give workers access to files, every node in your system must have access to the storage being used. The following are required for JSON files to be accessible to workers: @@ -34,15 +37,12 @@ For more information about restricted worker access, see :ref:`workload_manager` Mapping between JSON and SQream =============================== -The only JSON standard supported by SQream is the `JSON Lines `_ standard. - A JSON field consists of a key name and a value. Key names, which are case sensitive, are mapped to SQream columns. Key names which do not have corresponding SQream table columns are treated as errors by default, unless the ``IGNORE_EXTRA_FIELDS`` parameter is set to ``true``, in which case these key names will be ignored during the mapping process. Values may be one of the following reserved words (lower-case): ``false``, ``true``, and ``null``, or any of the following data types: - .. list-table:: :widths: auto :header-rows: 1 @@ -60,18 +60,16 @@ Values may be one of the following reserved words (lower-case): ``false``, ``tru * - JSON Object - ``TEXT`` -An empty JSON field is automatically mapped to SQream with ``null`` as a value. +Missing JSON fields are automatically mapped to SQream with ``null`` as a value. Character Escaping ------------------ The ASCII 10 character (LF) marks the end of JSON objects. Use ``\\n`` to avoid a new line within a value string. -When exporting data, SQream will always use objects. - -Ingesting Data into SQream -=========================== +Ingesting JSON Data into SQream +=============================== .. contents:: In this topic: :local: @@ -86,8 +84,6 @@ The Foreign Data Wrapper (FDW) syntax is: json_fdw [OPTIONS(option=value[,...])] -.. note:: The ``json_fdw`` is the only file format specifier which may be used for reading and writing JSON files. - Parameters ------------ @@ -139,9 +135,40 @@ You may let SQream DB automatically infer the schema of a foreign table when usi For more information, follow the :ref:`Automatic Foreign Table DDL Resolution` page. +Automatic Schema Inference example: + +.. code-block:: postgres + + CREATE FOREIGN TABLE t + WRAPPER json_fdw + OPTIONS + ( + location = 'somefile.json' + ) + ; + + Examples ------------ +JSON object array: + +.. code-block:: postgres + + { "name":"Avery Bradley", "age":25, "position":"PG" } + { "name":"Jae Crowder", "age":25, "position":"PG" } + { "name":"John Holland", "age":27, "position":"SG" } + +JSON objects: + +.. code-block:: postgres + + [ + { "name":"Avery Bradley", "age":25, "position":"PG" }, + { "name":"Jae Crowder", "age":25, "position":"SF" }, + { "name":"John Holland", "age":27, "position":"SG" } + ] + Using the ``COPY FROM`` statement: .. code-block:: postgres @@ -154,7 +181,7 @@ Using the ``COPY FROM`` statement: ) ; -Using the ``COPY TO`` statement: +Note that JSON files generated using the ``COPY TO`` statement will store objects, and not object arrays. .. code-block:: postgres @@ -193,67 +220,6 @@ The following is an example of loading data from a JSON file into SQream: -JSON object array: - -.. code-block:: postgres - - { - "name":"Avery Bradley", - "age":25, - "position":"PG" - } - { - "name":"Jae Crowder", - "age":25, - "position":"PG" - } - { - "name":"John Holland", - "age":27, - "position":"SG" - } - -JSON objects: - -.. code-block:: postgres - - [ - { "name":"Avery Bradley", "age":25, "position":"PG" }, - { "name":"Jae Crowder", "age":25, "position":"SF" }, - { "name":"John Holland", "age":27, "position":"SG" } - ] - - -The example in this section is based on the source ``nba.json`` table shown below: - -.. csv-table:: nba.json - :file: nba-t10.csv - :widths: auto - :header-rows: 1 - -The following example shows the correct file structure used to build the ``CREATE FOREIGN TABLE`` statement based on the **nba.json** table: - -.. code-block:: postgres - - CREATE FOREIGN TABLE ext_nba - ( - - Name TEXT, - Team TEXT, - Number BIGINT, - Position TEXT, - Age BIGINT, - Height TEXT, - Weight BIGINT, - College TEXT, - Salary FLOAT - ) - WRAPPER json_fdw - OPTIONS - ( - LOCATION = 's3://sqream-demo-data/nba.json' - ); - .. tip:: An exact match must exist between the SQream and JSON types. For unsupported column types, you can set the type to any type and exclude it from subsequent queries. diff --git a/data_ingestion/orc.rst b/data_ingestion/orc.rst index f7ea1fdea..4906a80de 100644 --- a/data_ingestion/orc.rst +++ b/data_ingestion/orc.rst @@ -11,7 +11,7 @@ Ingesting Data from an ORC File This guide covers ingesting data from ORC files into SQream DB using :ref:`FOREIGN TABLE`. -1. Prepare the files +Prepare the files ===================== Prepare the source ORC files, with the following requirements: @@ -157,7 +157,7 @@ Prepare the source ORC files, with the following requirements: .. [#f7] Will succeed if all values fit the destination type -2. Place ORC files where SQream DB workers can access them +Place ORC files where SQream DB workers can access them ================================================================ Any worker may try to access files (unless explicitly speficied with the :ref:`workload_manager`). @@ -169,7 +169,7 @@ It is important that every node has the same view of the storage being used - me * For S3, ensure network access to the S3 endpoint. See our :ref:`s3` guide for more information. -3. Figure out the table structure +Figure out the table structure =============================================== Prior to loading data, you will need to write out the table structure, so that it matches the file structure. @@ -213,7 +213,7 @@ We will make note of the file structure to create a matching ``CREATE FOREIGN TA If the column type isn't supported, a possible workaround is to set it to any arbitrary type and then exclude it from subsequent queries. -4. Verify table contents +Verify table contents ==================================== External tables do not verify file integrity or structure, so verify that the table definition matches up and contains the correct data. @@ -236,7 +236,7 @@ External tables do not verify file integrity or structure, so verify that the ta If any errors show up at this stage, verify the structure of the ORC files and match them to the external table structure you created. -5. Copying data into SQream DB +Copying data into SQream DB =================================== To load the data into SQream DB, use the :ref:`create_table_as` statement: From 2aacceeff2202e104ed06ff58a87293596bf0ab0 Mon Sep 17 00:00:00 2001 From: RosinTalia Date: Sun, 11 Dec 2022 09:08:03 +0200 Subject: [PATCH 313/882] System architecture --- _static/images/chunks_and_extents.png | Bin 75743 -> 70037 bytes _static/images/storage_organization.png | Bin 84955 -> 79471 bytes _static/images/table_columns_storage.png | Bin 46261 -> 54784 bytes 3 files changed, 0 insertions(+), 0 deletions(-) diff --git a/_static/images/chunks_and_extents.png b/_static/images/chunks_and_extents.png index bb092fab7dc403e87f92cc405d41f2ddf8150f67..8b3cc8d0523a62b8c4b841ecb92d8bce58c8f8d9 100644 GIT binary patch literal 70037 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

RSYQTD~ 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 literal 75743 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 F{{YiA!f^lq diff --git a/_static/images/storage_organization.png b/_static/images/storage_organization.png index 8cde6d70e90f6784b7e2c12b784edda47d4acf6e..d6a06d7635e20e31f31f136389bf242b7b47494a 100644 GIT binary patch literal 79471 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 O!<-%54l?b7&;JWR(f17i literal 84955 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 diff --git a/_static/images/table_columns_storage.png b/_static/images/table_columns_storage.png index 322538dac74c289c8fff79fae17a2ff9f0170899..071e140ea75048555667656b476d5a72daa6a721 100644 GIT binary patch literal 54784 zcmeFYXH-+`+BVA4rS1(Xi$zrg6xI^yA|f4Bnu^jx2#}y4y_e97E;mI&5fws5Kw2P) zbP@<rA)tib2~9w12oPFm31@=)JMZ`B{5fNsasGUB42I8$$(&EQuj{_<GG7}T>R({L z%+AKfcH!Xz9aA>8v&(F3zu)=SS>Thwx70_#KmYcA0P$mE<M{LV@3+2*h(k8Et85Q- z?wJQ=txRxKLj%J_cBdu}vJQsGO<zxONV}i=bhSqEe33kQ0ur!dP~3kz`j17P`@`&S z-oDX%2?>5oDN;~YaN&T+{O~{fK)mPFbqSY0FfJUwi{Baf>S=l@*8MN7=c8}YQWFdf zEaZs5z%}tz%6zX(`YTeiyi=1gUez6OC<h}`$!iR92muDn@%ZY-j&B}Mn~m+oLhgr) zCnL7Aca6{e8lApca{6TS;<rBremfa`X8RYg+T-gf+wbsSqnm91sQwxWu-y~-H9G&| z|J?5X?A?hi{2xR4KdAVB&nPdVV*p<ITzVT9zKq(Z4(Yel@@Fem6!Jqlu0Y09ogfAB z18IwnkiD0q+J5|5E2W$HmagU5BO-*@#U0AT+>raE`>I^D{!XAZja1m2w3ZZ$9Tdsc ztoLh!@?B<QQ_g-)fOY=^SgQB<@>Nf!r9x<Pi*W^-x5A-xV(d0?0D^3?-&85+Pnd4q z&zshBhbi$*e6w>YiS3lr6c3q@4w+D&*N;=KQ{l6ByPnS-?4KVSklNOvBNpvcxld5X z6Vx4tpZ6xH>v1~uE`ioS)_gHLYf?n)JN=LA*g>nr(KgQaqtLC&w27m;I%N&@)!xb! zgrC?FZMyeD=vX#sX?_vkz{j~ZWfl`0dU18UqRked;`OjUj~Utf@w>6&_PF}jdNxX? z&%JDxTiqP32ynsZP10r?A{m^kcBMc&A!rGo{B8KQJ$ccxdPCGISS)o@bi+`Xqf^hn zQj{VQM2=ewxLh&*;EOd^Hq7L#|DdKELt=o6VPCTNitkkqfh!{;RtFC}l@NKj<%PY9 z^8N7V^0(jV*Jh;<*Wi_wR}kN<ApU%*cJzwVz01<AhvNkm)j`U9NMY+NXi&*{dPZl> z6j_w$hf@qU&>1ge=VW6GlKuCwBe6_I&0WtV1p13M>>EqLLZ&UHy`b+dKpTr<Ifi*E zJebB?c-@Y~+XdN5?Z%iC-rnzmy@oHxQE1$oQ+QEF@i=E)uI5dU<uLYx!B}#IzdP|h zCe~0%j;ICt4kr%>Z>a`%B+Vz+RK*5R7C;WrI`-xE9!vx@I>=!V#y8Q$eGj_-SiB6i z+SkMld2RrCj=pi4z%x^bYAD?Ce=N6_fa_wVc^-Y3KzKUcxV{RDU+UItSu4W>+-~^y zv9tTkVZ*-A<rZ-C#b51+ejx$oGZF1M3wINh6-g3!bkE8}#|sCEb~k9&g^pU3yI0M2 zI?Mj_337M-`;(h&>mz|-G=t{+{tFcJ3=Hnq73R>^mA=R;uWsFvOwVVZ7EMYXEoWZ~ z0o|;-nSrkEdi<MBQ%`K+^bK2vwOzpewFy)>s@@<E3V|qH?xpIT7y3>P-|y%%)@gdL zYp;oz^ySN*hFw}IjD&i2Ur9VopGfOswB*?ZN+mgFgfc2D?i@k#fJLmkpBx74Lv0g_ zLR6dTWVz_L2T@hXd)7m>_HOJ=$0l&U7A9;^kg)ji4H~R7DQowvntil#Zkc)OvtVb= zzosiitsqtGGwtp80eoewUEU=Q`@x0F9GxhVgHU^C!q9I}Y^+^HEXh&0SEAh&fBOX{ z+ewNyK)=;A7K!~mhz5g5@|T)p%<7s~&V{&0POLu;!Lo0mWI(-hy`DSE78zU#&ALM4 zy5a6RSZ)*KRLTKNZRYd0K>Ml1E@fq3qxf2-@x~tIE!az7LEe=o;zaHy0FT;iGk@ak zx1>E0<v`7&(&T_GJycxvtt_&cA_OD@rfphY@zASCvjX2iE!Q`ifZ81->fPQyvvM`S zDVyq448-pBwmu@+>^~N(`Ld!RkHrWkfHs%ne4A|SF<fZTq&ZPJMsw9*Jf3G}+qM`j z1kovrjY^ibg1~CY@c|%tBqoni{1nYjGtDHwuc@hW&7DLHtoo{i8*QtGfYdrXvF&r0 z{UFuR{rBLO!-?O_s9pK|!BPlPS|UNvGeJY}NI80pJ2z~R7|B}Oo#Fykmw&Rl)9)#U zLr%6LTw_DoYE2R%uJQg>*{=)t<`8Bt2AuC)$0sy$xnQj7_Pwzksg?UNTegsDeq>R< z_2_yJ%g*_E<o?RnFZyOR;7Eg3y~@co=3&d%9xW>^5iXDvd9qzIY1LbpFsJ8_;PL0} zz0^fE#<;^rr-~od=I5AzZ?|(S{{*E#>%bt2%*Ab|KD29KI<PMpn+bRsM-8lOxGhXa zs$0xf)-Eqyi)(B9G#<9?SC{h;Y%!Md8&sGOpqPt!hbce~4hBF**{j|;nRI}2T^RZ2 zH&XTU%ip+l{4|Mt0#yWqx*QOok~&k9Va!e`1rs(|I)mY_xaogmwQ+q4Zj}%<f#_`3 zf@1A`2X`~3x5Z|gsr@#MdrMIsE*^2BBHt0M5Aa34gUj2Gb0LJ(i2$dHF;6*1UHMF` z&{Q^DRMl^@AB`KWP7EAeNCUir{*fZE!Dmm{RXyf<osq}u*lK7^@RM1^D)eMoY6GEj zlRN=mD$i7kH(V&_+~(HhqTWHHt(12vE!FPu&APSP<8IiMLRw74<eVB4y7aE(IKST< zbG*JGpz?N5VHWj4veUxawPxnq)|ZVkd@^ZcCD}4V<IjqLbdM{ON_48d0)6Op;i3a% zE1!!{&c2v9iI)&`=XGF1ey!u_OW_TK@UF-t+_sn>1mzl_B{JulL>3D_dwN#y>0IU4 zJ>RKh7g54aqrhJb+q8>O2L}CvYvkrLD{lYEg-F<#G*zyvTyw0rX)_V%hl$1cT0pg0 z$QCfpP6v6dKF%K~R0E6Z+3-kxEL$3%9lPVrJ2}U}+za5MiMGFxHCWSCtdos$A%svH zXuP?xbM({M3GX0fYUc4aw{ds)Vi2*O!p$V(EWcGeC~uZ~bFa^ekIdCM7ox$*@9=rV zwx5S06t<Oj>l^hsq#B8|pQh`Jr8Xc8IARJ2X&Iq<=M%g}#$03!`8zAdQWu09WX@Eb z3tZjJIPy5n_Ic^av5fF$FRXpbov^!9ldxNM4msO5=Xsv!2yNPZOK<)5(^(9rsA6G} z2dxiQr_k~&WiMA`Ddku6#EQ)(I6EXbOY`|WFXzfOPfz`d@r<;Mv6aGZS~~M2%Pq(g zFzla91;5eT;uifk(nkM~-*-0Ya-{}TDzA@(SA1GP(8aZr^xi+SwpcT}oT6U`scBsC zlKNspaRP0RacdQSE`^-&bqE5}thG&|LzZ^SQzU=(1rCA&Ah2k#L?acB@HH5oY)9R7 ztAM=6jzNS;rZC}#EPi?Q+_ppK0balD@STlYAE-kwEy~Q^%gFOb=bx7%@1z>+wcFqu zv;QH47(&Gnt#+!{&-_D>d{5Q+NrqJ00ldR%#2W(N4<)$&{Xwb@6nQ7fXq=xxTsEM; zq;_kq*0?Li-Fj1AD;kHp-G&Y7vocg?>D&ws3g??Wx3O5exmdlK1{INyxQZZ6nqGkg z-L~@6w{u~6cgU&#sXz-Sqjx%t3k0T+ftzZ`PzBrgSZsPRa1O=D=xxA(2L+fOv~Oli zMBbeE9(kzS2@4=mCVSk57ks8EqOc~+B~qAtr7|Vfv-r}4r`ScbP~zNZ`IQ8|U_Lje zP=~v>Z@*)2RPBwEZY>J!ZAUT2ws%JGD3sLN^NRTgSoc}wAw-(j^9uR{zCBZ6M8d$1 ze13m|r55-cNWyu!=uQ%PWO%i8S~>~tFxDaYfxP@l7J<)pv;g^TtGT7FF_xLA+)aFS zc_Ru2O{%jw69NkD(0gvuvSG{z*$<OLypEDijYD~Vdbi!)^>&Fl(B$hck(3<3hbZ9E z-Yk9MFxXUie%ADv^`)M|+Vo(JKum^q-T0zzMOGo*U%vYNY8`%U&r!$zn%tOe(M>rc znskFnli^e*rnDkUzd;DDYxjO_+cxlEt+;rg>??lJYum3x4cz**$6p#ADlb3vI&U<V zo_=H4Qzdl6s%WEekeZ&;gNx}SSd4u&mg~x->elrm!X$XPck=tGDGcu}8{S(1st|~Y z%8n)I+DN)U0#Y~_5ID%POTnYd3W8RyvaOF9$;d0|Q=4zK>90zgNt3OJI@_bWax?a{ zw4?GKKue!B(mmEK4>QI!x4F54*QWGZqU&<1vWR<G0XA>JgU;x%8>wxT&iV=zg5FPZ zLRz{&oW*T1H>LKRIQ^m9WK@~OP<)|#i7V$Qxj<ftNB?@9K#mM*wty?94dDwL?+N3o zDlN2Yh=oy12d%JN{ccqP8a6so8_wGsu@*Ho4WKhaE0ow#ec||Xlq30Qr{Y;HzA6Vm z!WBu`*YU(E3Oc~8UA->R^g#EN-Ve&iAy9uivTvtm^a>kZvzUFD5=b(ILWZT6Q8+yu z`agjtEnmHfs#sSCi1hiknFsGdjt+(6_r>_44`?ErH~2E;wX$?oiqTr#7!1Zu*5Uw{ zCt1Bbw7J}lgA>G0eR4&JTiNfRmhqAU<q@*BjGTX|n*BbCE?Y3YiagaliSouAdG((Y zUqxi|A4U3nDWdO+V<|S>Gi5__&xd>+p>Uyu=1y_6gKPLGkyz~&SavCl=Bc9zZs~L8 zUA*vQ0i<kQw`G%FHT-?1w^gIUYfH_?`)7`ThgW@Yp3frTlo}hGz?Bmv`7o%HiedJ- z%N@88HC2#Acs(@QkJgKqd7jamY9$mPSfM^1Yk4Kk5bMf~v$;)0bD{Ip?Mg3k6m&Xw zEI2#`p9xH`?7EyRb0Nh;)U5v9*Ak12Ba7&}CS3t;x{6b1UeI0Sd`sb{;<~K1<O=m@ zPVhAgcB*N~=F>Hn^7>n~8T~tnZM3>baaM4sd{L$6DC^dSe^|l!ZaW7H=-@`B`(D~9 zz#;vlBuIWjSXAvlW*0y-dZv$-oWhl}m*w}DPa6GZCngn%tjU;LsjDP761FLwuD0Di z2KOx37ozzP_&J9fTX&sHmhko$Sd%E9Wbi#3b5M}Wl;oJXqZC?>A0Z70N`=xwhy6o4 zSd2GZ8NAv6dWw9+GCgC1(pd?}z44KXkwjU`0@NjkS6q#xqv=FeOAQ^+KSIQf{Dd|e z^1Nw{g^LC<M7zSgPWs7O;ZBZGU8+PqwI(7+1G(wyR{XT`{3a?iey&97qF9_*@Rrpe zvpOauS)_~HEq$Al#86@)M~EyVYi$}mP-ERGmkB+(@_#4De*DgiB1atBqRAmzM}^<D zNf~-VhAA&Wyr#OvH>5gMb$N&2ebSZFs^;x6?SB-fd6{3cv54|f;0D!z$}Y~gI&P$S z-66jb_t54@uzXb2aXDC85!HiH8M|>BZOC|??x?SaaIPzRR9y*r4uOMc3>l3-IEja2 zKK))tR$<#^Q}MP(-;M;S^ZYX!*#U?C>_N+MI9E?7EGA&P1J5%scz_DQRBWhvWIL*t zR?6DCs=IVSkKigq&q77Vie)&c6nxfqiC|cD{x7m?V`ZOg*}~=={8MV%eN`u=NIR<e z^!R-RM0rYz$6d1r!-<wImqruZ3w<#SsDC^q%B*aPTx%?#_rMXDNqwQdLJ!YH<8em5 zwfz(#pjAq?{%QpED9Bd5`snT<V(Kt*Mrl@eE~Lxoxsg?OSl%Vtt@^V0^}_8eFFtuK za~-uap9t#F3mYiZ&CW3@kGxqlIw4Jnn&LKs8Lo$dId-f-cZaPpu;LG%O%M=!(ZLNz z)Pa{GDmZlS@s76NPM<qLO?E#!K-`wal>($9*AEp60DAlJd%~T#+&!(TX3~DT>VMj+ zzM0*$=&~#O`i6D0t~}!uKgr$V3<#oVi?#+Q79LgiXW>b(iNp$5lCl<8#VQ?7eYXGB zLdWa2)Kr?~H?oQsM=<IlS(G~8OP!b3G;3M+H#rL-C%1KYThxU-)*h%#b6KE!3#mfG zw*|>G1o0?$b~cx3dbnX9GxNk?BF)vw2b%g1Mi1mN?3Ivys&>n7h*;pCv@P8L<I^pR zZ4~K4|Hp5xr5b-<uI#8^D))(n*Ahh03S^0N94&0e&ik4~KR|Rgo=?j^j7)cwug*eu zAgOC)^u;Mr)DLu)*>I;_H3;0Vh+-TNBoCeqwuib{K;_zp(rAm=(RVRDLYGu|4u;m^ z&fQs!U&@P_&F}!XV2QILZF6I_sYIiDP<(Fho~M84gg}l*i!UrDmQe2gY_xsz)<-Ey z@D*W+{6#*WRsWh)16{b0i$;H{<4iWgoBer}fQspvlqy{di@%F%I{3`~h5=3$qzFD+ zNsx}VCVZRUNLl{;G5!8X0Iw>hB=uTXI^ia4f5hQ9p4lB1opCy>0@Oo}?Q!b(1@}Pv zW$mMg;J+|8`1a*(YK;6^<3#hnf#;iawW{0WB*&MBUV^Zc42i!a#}wur?)E3D#y%P} zgXkn%$?a_T&Qn_Q8qe48ZHi_PL|gF?>3E%LJQvBXeIrD^F^x3-Ku#~UN<h<8M=iS& z3bGS&Hy`bH)!O6Mf_XAlCIxL9m!y1}yR;C2!pZ_#cdpRw4T29X)ezvo4a>~@TF+Wj z(6Gz%<hq=aM(Q229!utX);o$+s)w{7Xb7b154nxJTx#$56F!nEIfaKiD~+Qhe+%7S zYfUZ7?O!lkG_OW|l2`+I2(^t3R$0lS9@X=N6|Gl}VwxLD9QzXjP{y9}Wv4#f(p*U~ z;0h)P6UxC6URD(Y7yMPv_;G8+GTl}YZFdf@I#z1??2#hnS#`OGf<B#sw)}45tr3e! z*M){HAMw6OxPecQtY4XvS2JxHx!>X*`~Vv!3}~!gk3oewd~iG*VJYzNiw&?Xuv%gV zKVmU{OVrDu*HSXyvL=<bQ6I7cW4uONYSdxQ`%rOV@T;Rsn)23iF1!f(w`eE}2s_zM ziyqell<yJzx>R;)QN75f*`B=Jh2FT%U<<ySxlK^i_@mHo<*}YQDLAO&RC%mpgR3A; z{m;4a%3E&?QY^FyH~1=@w@gFHu<~3l9kryC+7yWrsWFJ2aPwSNW&XI{MId-72S?v7 zt;EP9Yh5j@FF&#P7>-4?klS+iHRW)-|LhiWHWi04f3Qyb96%dptfzJZ!uAeA?S^NQ zNb_MgU{!D0+$h@g<sEN#!vjP6!YI2*$^40OfVnRD_m-i~RryZ@TTDc<i}e#@Wx-lb zWY7UQpg?%vLNA!`&5Dbrhb{Lu_zmVKA(iX)sJ{K??Gz%~{F{S(Z5r5b*|gA3cu*5% zzX>D$gRzS7#EJl7gBKd2$C)_69}`_PyS|<m6g0s(Q&AC~%nPxpUUHxpNx_7`HmqR_ z$%P!lOO0J3gw)Y?tHh$v-0p&YVM*<;tSij{bs6`RBR;y)f}el1A}8;~CgbvLh;uxs z!Zm|ucI-b*rMmZVDTA+<M*T%ImYDvCvel~c9BTPt^`AqlYEDioA)}FTNaD}KT~>2H z1$K(<zhxRj<D7*FPUbA5Rph9*&h7x*B&;>DOd7D`GlLJ9*Tg*j?U8UWmJ3pMiQt@? z66lf$r6`5K(|EX={UEoU`m-wMA5p*Y+)!M;TKrCOBtL^}QQQ9bz|#UeqZ{9)*v`1f zIXBn6#N1$P+ti9_Z*Ny`h$GE3qB=A0w9Zp8@l<Ss@7!sL`Z4(0<VYR$9R2m$+Uq0w zqL_TYRbnT}*&X(6c97O<Iqcawzw^LdRu9MvDM@?YX#QAP>4r10n9#k{H|Vz(0vU9y zgzAWQlBj%A)~Fn*{0xa<no`eWh4~P|jnoZS3uxU9?auOS?Cqh)M-K;`C0-c3oM7cG zjcECnNar3*W@yYQL^^LxTVA$~i;3AG-S?80wX9Nsg|J$KXl1o6wY12p#v>k^oOqU1 zYSmu*GC{KAG4GpZg+Y8kzBSqfwQQh3kMs0b8;mD-7RS!J*R=XI4{8*{JC?&04Ez>D z<`gc$P?OfBC@Lt$zj;Zn+<guLx>&mm357uK)p<=|c3FEzf9nlBr$-*mbdw02QzBDG zTLhN;F{n<8Y|8((FA$>}hy-~xZVC;zt%X0+KkSQS73@ag_R_54>hrTnw##>B3QI#U z-wKdm55drF;>#4j(Ro2o+Pj$&)t1XvtE4_-#ZI*C!FyKdbNS_`DAWTfr;!WbLG#Wi z6uVUCH#KokDtyyYx-T^)#j>>Bt@*LAK{DxqP<(d0xrv2E3iRmbE3+5i)wN09>~l#i zi7^aP^3rH*q2V}d<j8Vw{O^Pd6?e|0Zi1fsfA8D39J?gBFjAP?;35mFW1rh!D-4I) zgFz&8BdnAlr9}+gN=}nV72S^RXx$9@7<faNCM4OdHYt#R7;;YxQ%?dnZ8=m-H@>c) z=f&P=uHQ7figTGQJ=k2+<uMqva&$P|BW@Lefpt$up;T{qNIa&V2W=jj@{WJ=9mum5 zCVl008$}QM21z7YcG#7IYaYrZd8x~9%4y&Npt>Vy?a^j2&bDTNI>Q&nxswtn`H_vg zymaCbtq${hg$Q$t`M)t*5T9w!CWqEhqOXD9q~{(s@(S@leCjo0E&S>orRZ4)4#IB5 zTyhZn&Xr7LjGddCatJ}MI%czSM%LOjb<hb?cH=bC5vA+~=Cvm@@{isZOT7$=HLFRN z7Tpe%wiYeI1=3>k&7xEY_<ZS_e;#x9@x|R}#v7_|$RVaZuYh$YUN6@DC#-1b&C=+V z^la-rm73wO#pKf<@7+by=LQoS%*H8H#o^LxOZsAN6<qfxHEv_O+csqIT^GFlbp7o6 ze=6;8#8k+omOGTe_$Ho=Ie1xjp<a2plPg3;)wcVum5<LtgH@a`nR-Hwgkl@Ad0~AP zN_sOkF950nmL@e#$IK>I#E>tACOuh63NK)ga0Lr3ZnnV>8)<EkjW)&i)CB=uHFA=4 zEPmjMw5)v`#u#gtdptdWnFzI;I;xk`WED>#&T(q;adv9)xNYb)7O4rl@mB`H<zZ*x z3w3QXf6H5dhIP5Hw#wM^aMYgH;CRI<3IcZ__a8O{@NMe0tosUU1F5}Cil$?QlYitD z*;I0BdOykZ@Tq&Gy6SBqbfe;%IZb@Z&$-jMxP_tVa&8f!2CX6gm>JMS&74(HP59sj zK5g-Qid*WR^?8Ohh9+H79b{J=&(Fd~c%Gi3t6t9~<i?&B)u`XREp(8fkJ>3tCgmp4 zlG0o4q<<plpBGu*+NyRpSDH2^VFWsF#q>CRmyB#ukJuWFEDc-zM+I<w;U{_W95Jac z6L4^=T)C<)<Vo$(UEtJ`LIWlQM_=ykzSEAG`Eoi*x1)~Sy`s92o#rBwy%ohIUEl|! z`So|sUjz#7zj^^SEbBbgVe}cK?xbtmWSf%=!|yL^g)0-eVGin_KK-Gj)hK6&$qq?v zeYH825W{ydck7`X%rD~cZ9Or!=MEg*)v0pUb+XajYT^+)eP!fs8((^=rJ8&Ikii9x zE9Tc!oif2Sj*asPNDVJ>qs^b18%uJQs|(*UURUf!*@g^5g1vxTfS(w{=2w0H$Da8A zQ_bJ7XT#UcIpP^TKGZ!_gd)Pw__TJr{%w^}NG(Ha>)WMZTYblceoy8P?C)%Bu%Hub z5nrS?>)%<S5E#IZ__K%-7lm?OkF8PQmu)&n=ZZ3kT)IAvEU6u(CU_vl<I-WuaX}^N zxOL#i@91=a+`Sg3Bm41<PPMLj{lIAh+dtQsDO2iVSf>AbRIjFYbKA`4+5QTbSrw<B zH6rPm23iq;>tNvVa_YZy<!w#XTSqx{%!FG%ALI?cI^fKbPx5ZYE7IwaJDlC$+_Waf zw^Fcewnw9!som?~Nk-z0xS9CI9V(V^ivXYB_C3S)qUvt5=qWa~ta@_9RtmlDXugJC zn%Q(ElIf(ygR}{|cPYqbvvrt6d0o-J{~Ffh;TFcMBJu(h!#{(nBWgu#P>80m(2(3> zB&x@AZ@!M~gls&@_DTf2<3_x*cu4mu!Kc5|Rt~FW0S!F@S~LFJi}B;H!n?9jLRx;z z%=YzJGbLIqC#$t>b{h%%(`%$wQI_aWbrFmxbUT`35X2(p_e*zYfV-4Y`$8q0ALl{Y zg@f<A@`jMnQ?iUqB@df_;|!fjtz^%{)=d%0#*5$3Gn8O_MEaLp?sh;gxZFR^t*%QK zzL1K#<3a`76ng(m^<o*0`>jpZ|IFuT{~>ioU7}GfvcGj>d+CFSY9U%gkHB0z>fgwb zwdK8&BRhN$_VCLPCX|tSfSnA{$3-ux9DebN+^r7dV_sd&31zf+1kxnS798j2!S`pW zQ9yr;x7A6SJ?nm%c0-Bv-;-6LMwfu<VDZ@M{?|vbZ@=a$a@#ws_j5+d;+)CvtekS3 z>)$pVd|MfB@0M`SNY9qSik(qTC{8a(MWOrnM9Q1QqXJ4ncBntqj~c(%|D2Jj*q-4q zZ1_YUeZ;`KF>-F1KRNK42sa8QE{)pyksKW6rs?C<FKwL2l-Jf&*Otxh&<%x0-D^6O z{GFqK{l2Mg?Id%BGl7HD@gwU;!<j=L&(C29w`!Zb5U2+L8=OArg~`#DN^xoX*Z96) z=l(ORxBpZO-W$^(nx2twlL8r|ccS+jmsBUiXekx5f^{OpN`*l1zZU5fF4Vwi^$1*x zi`fy0O$yuRa7e3h40A6uz3IVxL)ST7x}dG~c}0uL<6jv1aC&_C4HY^}EOoySeCyit zOMS3V2gqRRNAI1YOwRH{R^BaVwV?5-VIrn!@TI4!k?PbaPa1Hl9LdK}dU|(%dSY|% z?aec<j`oJUatA7yKRjzHzq%d0Oj)PCQwql&da%=HN<O$yQR|+aEkW*t#h5a}kYT)* z2k%HPucJ}O(WLm~R1FHXzUa0T11&Yhxa)?n=Q4YYH(#T40E?YH5ivhLZfRp9Mh3A> zRO-24AM?Sdlwwq){ZgH;dTK;jPeI`eFDmK<*4Behyw?-xjry_o*D=}rP^rL!W_wfI z^kYH*K_sVx1N~}1`d>i!y|bg!=t@u+#eTNjdyRR}=iy$NaUAe-AJ@RMK17iUd%eOA zJd+X>U>X13jX9zj^?68JJpr=QtP>VA>`|c(3GcTLdnIv>uU9DFQd^_@=;4>7Y?JDa zn30!<ZG0g3u)p)!*nagg0RgEq4=w4i{b2SB^W02(9rJ$JR=@2ZBR;JUBI_hR9BfB2 z)lN8M_ANs0QxNdGs~0$hfu*!0BqX*tvF5O?v_M+i@ww8!%dNz^O$I@1{7BSx=92T8 z_Q7n^xg7{?;jU}c{z9m*IvPt)^_t{TnmF9v@Y;cT<-{c&RYmdu;oZzmLtyq<Ft8nR zk53rQX?nxMdRAd9qNdz*f8dGQ%<$26F*!ADiCImU?n4(pA@!YE@QO<x-MdxtaJaQJ zdA^a^Fx8*}3t$!Xuf8twUQM+oLRZah1Tp~!<`uTS&^`=s?vG#F^zvA_%MsUv=2HL3 z99x|PowXBT4)C|j89kd2to2ARkfoSL1Q<_GkZt$h2CZQa9fPwas;5UEx@A)yuxP|! zk1(g<T+S_*qEE`uZVkrj>#<b|?-c$Z=a@rKH}`B=C_W?r{L8<9Zzu7`!?6ZTt|T!C z{$k@hz^a@ytv@(5d~bGXdEM%os+O;XH5Qh8s~$BbIK=YL1-h#^fQ**L0Y@_<IE7c! zi_Vy{spJ`&@TCelJRQ~&7r)+l{cy3^D^5^zeRAVc5vpd(rVbW%uRL8K3C$1sVreyN zwjJL;Wx9XxP=Tv|%8ar`0Tj_}I&LqBS%`ceX|#rCJ#m=JssV_<Kl8*9snp^wy7sN$ z8N|)ke%q(3p^Vjp^iiO4Hu6MC#BvYH4%;_n^Aj~y1lgicRtoZb*@kst;vma#zzu+E zml~I8Ye~6{JJ^<ksXfQME}vtwlhel6aL>}uDMi$ucQD(2&TfIl%~S?0CQCkUn9H1! zC4Lg=*x4SQ4MMZ57h@V8qIw=L9FhW?_TERo1deM{|Cp_BUS(SRr%gdl_RPIDsWT7S zT>a9TX2o(bRz5{9#6dQNFJz+(kG+(+uphGq+^XmmmVL=l|6z)oM9_gV^RUlP4G&)g zAY4y*y;C-mI9yte0bHk{+=-zne5U^=SX>PBtnl;dw*%Bw$(rWFA6{XN<v)PfN>FxU z|DPO>R0?F$ms&TAP>L)FyWYmWXgJ_F2<VBsCxyDZkcyO3CDq$yZKlqQULz3ibBP;| ztuq>SY@(uzUkx~J)HVdB493_Jwi7F#%o)J~9m1Zt86VTZFEV*(5fe}$*@$;y<m?Xc zH`#Pq8~kR0sy3J&oI`qQh&g>MynAcHEaO7G8)GtMC!cA&ft+GooCb2W>scq}wO(y{ zwGPj8(E33E0#M(`F{tg0=0@PCD>a^PMB|rbqk`mrsJJoNWY736Q37d`n;)qYA@tPx z`8e_n|J2?*zkjCDF-x6DBISG8h6~AKYm@LVqvNMGmOg$)+rn$Dv_4BQ7#0UfVR+Z< zQO?%45o!EJ3Rv1(M2_Z2sQ1xJ;7m_zZNVsS(>E^f3{An0O;PGJZYx{jjT*NUTP}x7 z0;^esRTrQWMq6nBiUG>Z|56s9RvNckBahBaA!73Y<LeZ*MT`9Sd$^HaS$t?i{3^3Q zJxK_SSX4OX4S>=Z@24uZ1$aYBL)P})%GNz-E%nRwPH*maG7dM62A8%&)PU}xYXIT? zx0^HT!z;DGmGp5<_?}bK)}U77UQ!c$63aU5=8+p%#=rB~stUmyCz;7b73AWV$n>$J zX|0-WC~?QH!E>);Y9sA8wx>6Lsl4eQT|$AnEqiiD<l)HOwXntJ$TfZ2;AiyIQX-|E zg_qJWG&CsvXB99M4Hj*I^{Fbr&YkgfrZ04De`BrW<MEt+RopqWb_+5!kDI-kLq$S< z(nMG-YY~gNheO3M-wE5`aGy?IteHgX=fYzmTZ_#k`h*@NYB6E<n+RL~&BL!VF>Aza z#_#^e9COmMs%`)jkkb-lBj442r<sj4(a{Z4M+txmpmj5sy_$ahS5DPr<rZmN@2(jb zy4A_n$XtceJJneJ!HmgsF?YNuyXbQakzGrjLl!i0cgY0-c&TE}lbVf$d0oq)+LE9+ z&?vAsG{LZ`S?g_!*nej`Lf;20?E=5;r{F!g#^tYh2C|cXTFc?D9<$o<EgPl3jDI!t zSA~+9S6pgTyQzDtqlCKhw1$OAjS9e|>ko1!5a)z*g-5IDS!=p2;2n{mL$~8<ICEhe z@Ki6jPqJ}AiC4yP_C`8ks7X`rx(HyxbsE0wbZXP~6tO`jgn-~w*CYhH;1nAjHj762 zvm2h-ZK8gx9&Q?{w;1q(B<h!llQp46(lRpLlgx=w@xD+jD_KUOl#Jdh4P5W>XUrTe zdF-|N4apV3)dHLG$!LCC;~XbIC0y#rDfurKZj>DJJlZ0Z-oTicvb3~uZCo6`khB#- zcm+7IreMHldm>^RmOlsp_N{%~aAyTL?(>$e>6f^uVs_-Bga!A^@lT%2t&Z^`++Ng^ z*#a?cT@&@$quvcb?)g{sriJ(7sDX0QvNDsQM@?%*>qRU$1uG&X%wnN)kCZxVxb0I9 zc}_ffQusWB=+}nS#A$#`i{RzMeq(Mh`i2a`0R6hHh|_lbMqKO2;<pxs?BIxJKD84| z)!kZNl{Q4J0~Y7bfE&;Vv|6hD6u|xY6Wj;=Ho8+3c(__7i~m78*2^5vCQ6g7jGMOk zBhd=PPeI#Xfa+7gopJ7CMbfhhQ0R{{KLOb=$#9w?u7!FXgc64yZgv8N^1q?%ORf6) zlX8H;vl+gRJ5GJ`e=vtIMz)f3_ebkk-3hrk))N%f(3o9C>o~eu4GoZ!k*ULQ_W}DQ zu6?4>PbnU^LOv1f-V4I=^AonQOwh{-p9jB9=xZ^ffEZvZ_WK2@X7GB?bfmZULgG?C z>+5fTGkbgD%+6p$Muc+G8=RNh$%4ne&gVOczp+Pz94A(_=|ff`3gu4Grznv-Oc8(m z=xEl{5XT)6A;7}AU3^~yp6Ak|<2l@Q@jVzw1s)Rtcl2b@sKXcuQ|G`=UL*-9Dm48N zHrC2&m>W`?DXW|05*$JYe=y+@(Olo%ax(7$)=?aHJe3zBw}5qsA44IvS;5bYX6OW9 zo7t<!zB1{(G*nefS>0&}AkhGcoO!fpoxL`}xSRYH2g5Qdmc*)ZK^nk3)cH^NM;(0( z?ICP-T84li^Y!T@BioFHV0r<z@e@57kV_i|b*+2HIZ0sCN@9Y5fC~UvPW{3p;eSwm zU8#Ib>6ZFd%`wu$bi$s@9Xk@66NTx0-_)C*YYdob(36J#U>fUm64BTHc|CJkWb{vL zFexelFh7SE$n%vRj;^-B-K!dOAU{p-5j$r$3<P&m%mcpF(5F+2c*WV6;rOI*?8MUH zci<*R5jx|4rvbK*<8|zF*>Y-bPsxhbmR}NSSZ)07C#$KhaDb8~Ul$2q=?PwHuw{zL z<qC@kLWp}M%MB490&ngAW-|puRdJqmW0MCxVl-goN#{8gk#{`Q1CIcDedX4wf3z}r zz?k6UI_@2%D@p-7pLOxqt}OuFO;Av7!TBxNW*o9OTz!9Ji-ZmcwF~oqo)3V8Zqo)3 zs(VAfOHxw8sx8q`{frNSF-i1_bOl2qpYI=&J_H1qyZ`^>48Caq)O&pWS9t@Y|G)ab zKTPKVTkEZw2J|^lVn_bqiUD@Or&t%Tz^;H3jnhBybElM3zr`(get8uU%i|o*0@f6h zLvA?!%_`^`C84|5rH=^{;<8PMb;~ILVpg`SJ14tWj2#~OGN`cEa(oK_AhXd6>xPq+ zk~*Q7lY8^?C>-~<c3l+70q*s0w|@gunKw28jMn?CGSFrgumv*o%*EdnH8p7G9P%QB z`W~3OKH0nG#twXA|5sp>2TVBGaUk3o_&*AxY)MlYKuqg?V4L~5F#aK8!zM1nD-hMC zfD1=Wu{N8E8?a8wcg~~*=Ct^<g--&Qz@is+3v2e4{ou#3$x8Behz9w1BA0>Q54b_3 z-b97uvPIb#tf?V_8f_06eBzn=$ZuY=QBs|1ps>)lpf#MU9SCrU+p>M)g6(B2MCfsL zNAS#dhINw`FqK#Enjg`iDU;}T$8PDcUmbB_dv7Xy0J~b&oqMX;I%kH0#b|dIU^T+$ zixV#jg0rbI`cS8%2rp%e-GKas<C8FSJc;3iJT2k;UMl;E%U9R@+Wr-tf3ezAMX$&I ztKncUV5So$=bq|E-U(k@$Z-|6g$@R+$=}DP*e7j=&Aev+JUATTB($t6bTwjCU;$sC zIb5+SL5S36;@)X;0;}Em6>OYYMxi6-hTh$;#NYCOd#BtdxGmE(;Ko~&5H+hKzwkgz z2$nbz%-&T+8QgYSElZ+Cw#8VSv0B4)*X?U64O|0j-EP<{nLT(mUva-t86~+|2?(f< zw5<I`rfcKif)$i2&_4VzDy-3Y5O-(b%S`k;mE*?;{3=VY_}FSGKl)<qnrnGZr|dME zoG4#LYXuIet^78%E-GtWb1;(HQ!$U#7~8zkoDH{bAC$RDR0X!VtPHiWzqxDiwE^^H zbb%9qv6+6jhbn6m&O2UF{(Dv#mI;`x(iKp}h!$AO`_Pz~&RRIAI?ai8{cS&0wFAMe zemoC8vlHtJSdO^|#-b+i(*o0wsZa}0S$4cxc#eISOBpc`UPD>#@!F;`u22oAv$-fc z4~JA6b{;BUicw)CM!QTKU(f|_Hj$ArnpX$B0p#&XE77QZAz=pf!5#juE$tNVGR?>m zjD=c`Yn{DH$^xzm^C(m@7b`WG*hGwo8UrWsZV0t)PgvRxyHT0e%j}JUNhZ1@TElq- z*51N%#st|i?50i^fZQyS`H5+qSsr>PHQigWx~P2rLow<fwQI#c)Qzlt0?lIs%Yy@r zLRrPAow8<vTcWF0`ajjy$L8WYkcDgFp!Ten)^dQuS4Xn|+$nREo|G@u8bb%6R}@N) zF|e)hALll9g5ijSa(Dk(kbX^^y2aeYppg>Q1MqNWImC;-ePKAkWhY8*XdqleaILc7 zBF<}Y1y}612+29Q>4{qJ@`kTh<C!zdKNc64tBTp_cdjVv)0|^+uH97wEl4C8Jsa<@ zCfZEg@dGTYygNH_YW+4%E_dmWc~vILS?QySFViBW?EW_vU^p^TMy^d$J||N~xP%|$ z^{l~5L+Hyv&fX@x>JJs*)rAEx$S-`|1@&F?@cg~;3dc#ba@4}o!FYw$T}|y9dwU_o zXM^V(oK#s4iJ8DM%V!fo@{ITe6w$A_w|nOI?*DCjf9qSRw6~dy(m&%Q@%W(BK5R7_ z^xLQmyn&=fb*&yA^5D-cZ7;XQ1w0eFHBpZO%_hLN$4ZrrrrfA&^*)2RgKO4WpAULW zQrwj=uGjWf@w)Q~+ln?p@w4D^cJ%|aVt?Qim<SU>r7WlcyoY)bYH-xFY)o&BcwiMd zHOO2h0vJFRx@q)o0(|LIS3XRI*a7mO-&m+i$m>(esr=j!6kj~h$gSx!aHXL@2vx^H zMK!u5s%oAw4OAypNPGzCuF~j69nipQ8WYkDDSpDUs$MFI%b!_+wpEfgp+yVKkAA`n zxP8O@W1}54pc(-8R~XKQlPuX^VuJB1F7WluoB~Jub|KqRW$`ZbXjhFoo21#6H`oTC zv3$SFEhnG%XE>afBLAv<UsWzN&c2@!Q8JkbUs2p%OWeK^xtO($lSOsI%k3`?5*rpv z0zQiSpKxwr{&6z<OcCaHD){9DxDKuE2|sA<TV`8!?%q*1=?=06F#}32wi(Wk6cdK* zuQcFiXkEn|_i|^_X7NM67-Z*v-oA4_wuj^E|C4v~o<0S@;{k+(+t_m88SD2?@^eq$ z)ata{kpezw{Nu#hfzkh8PW^x0P3&1e){-x{<#FMz);i@_PMmAAihbtgPP^wWc?1{S z;N<Pw<2F-Ij;4N;^K&S0WUA6u*S~B2$h$z@(ZhyJKs`Ghlb<NHwg&3UA)?xZN4dFx z5Y~U6c_Qc4r&Ms^lF$Pqot9K5+<LAm0J<EfJ)m*2@x{p=ybuSrsiyE^1%}dCyO$w` zUM-8x+-rF$hUVy77)rduH;ff@c^*7j?>w8asK;lZt?RDt<Z)gx^SF&j%e1A(v?W+B z!o*)R$&jbFYa=b)xn=#a1re!VhiqHPkT(6K6rzkU#D-ugm1)6;6&zLw^x{vh32CWr z_-^t!?1Rw>%BEa=l=iv&s%im3;gG-3XWd=_l`N&q12L%`|5X0f<ys^VbZG#txt{vA zY-%SkCMM%(rq4iDIHI{0ElyYmvS_nfhtrYFLJzNywuMz76hD-SyazCEJOILAZ{V2E zAIqCE(V5|6>6F4N5RX?~MIqxIhigJA=04l4rHJVcH9325Wwr_?eDBq3bf0(-e_nBh zBzWD<x#SY9@kX6Rs=k_=j+&H3?cTKBb8@hMLCLFnyT9KUJcCl|3SupC^c%jB!=<|O z>r_8bflRZ;ZKOUHNjkK&hz^t}H+W_%4PIm5T@aR6zKdFS+0lFT3kD%^>0%81Vgirf z=7GJ>9-U+n8t~lR|F4LH+@sn0L&$&p!zIc?$EFTyy7HQ<Y$xGlCl*p+CkZf@mnO$f zkWKDtsg);C={%|mWcUOix3kxY3mt!@Ki{~0>kr{m|9<&Mn`==(1U3W31%6ST0J-o& zd1O{)TU<euP(g1O83L7{=+X$EXrP{@#5Jf_i}K~ctM8pbj>r9HG&b#D_h0;e|Ih35 z&xCJvJJ}Aa5MMW^#i)oY_+3|63xu^P_;ukTh}1x);h~sF(-ak@QsYC)nH<+mP$=;J z(r7b*+uZPZrtNXKypoZoXz%C&hVp%$i{$#cy&$%KmLu7K4EjcD#N0ps^K5|@2-k^z zjmN}};_jbs=@HAfH@wE~5_5QeM<6~;Ucf|6KwepZ^a6eJ4FWTY`?jsG6RCsI0u9YQ zdI@EpW;Y4TsloF6NcjiXXMdApsjs`{oG%I0kPb)KUG=T--g#^1jigFwE(h?lu4Tw+ zc|E?5f6f|L@flw5!r+$oGb5>o<f*{iPZ!x<_@1ERX`I3IxQoJB?3zGFxVNFEl9w*? zDQ%8}gO1<hD()zK-9*Xw#+XM;58aKF4RJkN(ByaXY-M|G;=av*Nc<w1KflcLrsMp% z0xhLK_Et0O1duGBXRTj&MhbyK?j-MK?M$eGn%Kpz_{E%b1U~Wpc|K9f0-xOn<Jfc| zlf&?vqK-~lft`|3fqP%>5A5*7-LqkIY{Bx(pMY<)+~r%pz^BD;G6pj{zwGGv63STV zJ5bmGbfAr`PGERTH!MVy1tfTG7AaX<o@4t=KVjX^JSh~QX-nwvNOS|)h-=b{@Vgh; z2sg|dNUXdbWvwVbl7slVVygCiCilM16I8mv!I!y><mH9=RXLsWJo%9UIul=FSvJ=k ze?IzRa}6Aueojo)QNKeo4Yhc-Aly*X*CciySedVUS=AreRU9NqoH>Yrg5nl)k`eD0 z3tjPBS*YzekRJ`VSRxk{prB@u0#~S9SS0f{w^W~-{Bd^)=N7Q!_v)2T$ti4+MjTD) zz=`MLnV0Z`IQR?FQ;+h0Q`y)`-XBNYY(;6UMe|WkT>`shDtm{anm36JJCx|vG$mv1 zC<spAO3CYQ`acg0o>^+1aUn!4mKg*?uDOP|=3n3FRZz3D=ze;hhmj|xV+7S<HdS-l zw5;R|pl*dr+MeGw9jaYlC}hW1^GC3r(qm?X0~ASwr416p^jqrvhE?ginS&;-$)hT2 z`K-GV|1n6SV0hXGTfX2;rN}Bmh0LY6lz?#D4Ib;~^Z7kUMEbc$XnC`PPL_@AejoZu z2X8;Fx(>?Dh?@&1;9@Jf7cX)R{l;ee@8b*{+v95zA45SA>vRRbS5B<v(sOn`w5L2F zn<h8jf5qCwO`ASNvP?cG%|Z8KA$uiDUHTYfvoH-1VNfVm;M;=T&8U#Q0ZOIiE}tJG z<y0NzRg|5gwdW81XRvFJ+Q|H(j{b9qqs5zPG_X=xmAT?DvYT|6Xw#8qqH3rkyF6xa z&6dKDW#)Wsw&S&Nl3m_62p#EMldhS5Op`+#4D%um*+>0k9e0qzQ7oG+e$f!e_ooP7 z?`9adE~q$cJt+HMy#OqRC17)RaVN3m&8Vy_k;6#vz*hF&Tr`t3^rqKDP`)ZH(!rEu z-L!Q-Qr5MP8eTf*;0jKcV?6}9N0|pGDez0Ql|4KlY|q(W6(QMQ{K--H0Xwo>c_+ki zPBho3z(7B348%=PU{5CV#(_dgH5~WD!u4fC+<beHa!*_w!IVwR2uQ&-<WXqXh37KT z{j4D7p3T;rX`xL^`77LF7ASW7X{m;jOC;V#zMg#HC*n6KUH%Q?5))VA(M@_9DRD^6 zhQyB2_G0(x#O|*^LZkgS+syVt;-j4J8Z&afS|1}Ol3XUSst87XB)9#D=dqcqLe-c% zAnj^ytUgiNMI<JZKFdVG_j0yEG(&ahHRjils6pQ-n*ji&b><1+afU1su?i_%uD_(A zXrgAxy*C-QHRl=!@;&D!>bRr-(~ql0;_6CgTNcZd+-}Z`JXLR=iWHRA==L;v2`!Do z5Z@$S5-RK#dOQt%BI`>i)L1e#=-|0ibQfEE$Ikm|eyw=iGuz8*Be_ydcTDu6;SG!x z=2L4ovSwsA(5C<JIQPY7_HE_<v#umHCsMi#H@-xI<XI{$%b&c4e*GnVY2h&M&xZS+ zBQ^YwuzYrlksG9^SW7AJ4bWKO6g8xZO<J+9gJK@geS;RL#CTfT`JA13HjWq0r5M#W zy&O_Wm^1aZD0z(;jVf7_jPlBc?`flD`o(Bw;PE)w&;cGL99h>(b>VK4K#x!s1l5$; zo1Mh^V)OIdCTW?Nx06=b-e7Zn;3I+I%N_DA<}04+Y1Kd8KXx#VL&9(&Q!f+Oa_>%6 zhkKx9GOvFD#BkB=|6=HX1GhW!<50Qmla}naodl`x{ARc?Tg|gh^N&*CxUhk(L7i)^ zqDl&7<p#V#$w`!)jKxgQez14R-;O`+9W5M&mBd7FU&44y2gjd2>7dDi`U*8>O{Zau z@~?6cYhAj-<r%iW`$$w%WovpLuNA+*KJ(gt?4pH#DeY_^Kilz2`=D=b_D6Z_C5SIl z6C8Te);%+Q2XDX|;o{X;tp%m0y()~u4?Oa-Fj`XQ223Q9k?Vzl9<8^Yp(?5G=jH^n zNQtbMcG_JJy{J1ve%-<31~ot2_;RsG<AK~^<nL^scmGT0eY`l!%?h`fqr-07I4#L7 zQv27t9Y(>{vLd)JS@!U~Z%)%T^kgZ}_ql`qgVKFWHSii;jcbEnG8JKWQ|V@vG37MC zASe{|;X!B0PL%;Ev^2rd_0y=?yCg~zrDUy(*Op2~{!_c3Q;oD?A9qEh1W8m&S$r*= z;*jtzdmVgkvll8z;>$P<0bZ$XV%=co0QEX!j1~bI$6}ANvrJ3OEaD}&OycYwApdFb zA9b-MTzbXDZDY(}M-qc|>0DfXMjyQ>Vwrd3>Q|G7Blf{ZbHu%r+=zoU7VWRJKiNLN ze-~%~NaLrjd)a|aimSvq1-e!@?D7-Es#!UXnhK5Wf)!N4B37ahTq-_y7tjOzIG(=k zAsyCJj{*PA*bEG1rl7X0NMLzzOSfaO{51gk?B^9-7$uP^Jm9Ak_-i!wW(tamuP>{* z**SVq3NYp=;J}-?8ou%cN+Jq<p@hO*w~$TwDkc7^5MTL*;(^P45&D|*A|<cSoZBF| z;_Y~!qH?I+DVmvIn_q@?EO+tenms@cY!!9u4qSYXTIv(4A!nr!a=xmzZ$=}!lZXe0 zx$|Q?t4GH6W}Bwub8I(ve(~fP8LhyF<E%QjSwt>#c4U9QD2P^`vHKM2G5#ml7$U`) zYcGeVXHIMwDF^zn&8w7(2(vBSNAt`$+=JQ5I{GtblD}dz%(In@Z?Liw!C@cm`Ntr9 zkCMJ@2}no#DTMY#zzc^Rd0*jd=n5{6-~L1BE8yAaq_($}^ZdDk{EDxpL-);w1xY|Z zbQ)q*f^CJYOS_Ay=Z9&!6+*%cXY;G4U=bhU{)UTx+S1t1o;plO18Xfb_lL`{v9-P$ z0xIEbH=_zsC0q5S1yVy=ht6RKRL+)M^*#SXE6nxD_kyt;XMO2KtPIQXcS!=}uQTpz zvYWWtt5}xEu&$VJpH_H;mM$0(P;f(zf@AM{(DF1^`lvv62DWx<)FyAh(eG1GhfT$q z`SNOg*uDl01dg=>L5)0~oIgL0NC^erv(a?(fSl(HHA8gT$d?PohE>oUO1B+WdnWy> z&gG9>R+x(?F%UF)1DdSaqNU&xLDJn+Nmp8P`=_OEYra|W0YLKc=YCPh>CJ_%*MS6@ z3`zg}jtD|T^U!j9Z-krvdZCVV8204Q%IJwrpPCdOXGc8gmBQ@XoW2NO3G=efof^Tk z<eg}Q9WRU`APXA5F!0f}?*2!uS0=HS!b!G>YY>SyQc)hsXWVKCioLeh`zk_GHSJff zbda7_I5^0<p6iDN;_UvmxvU^gb3oq5^X$wSm`p#F|0V_M;bkw}{JBv$bZ@Dq+5zgp zz9wqNSV86!0<c)1o9|uXFIAM6_oyMs0ogRSv@jc$E!SprG@M#b)wj+M?|wPbcvP5% z#3tAZW^r?bh(@4`HRn0IVmCvn1;+1^NX)9)t*=?8i0@4lfs#($rn*{zMc|?O6%>py zx5C*+pn#|^rpn+kq@2aK!nPmA@bSA60|tXWRr{Or%9h-OnkZ9h=d;NDxIE~4$pz7w zw#{6bTGF_NpY2L|joePhIRAm;S_0E=ht$mxTHphe>9^h)CI)>`5@LJtUH8Nt@i0UU zlE_nyGsZ#4kL#<XY&m33<j#F{qML1X<GP)WldZevx_>oen@1~9?@73HS9gMPk4ThF z%i+sQ6^(V*@^22@Qs7wb^Rp-ntRIe(xut(N4(sPO>YfBie<BYq6jT+d<p_l>^<0s2 z-%a^8IA=%Ce`h~hD&8j81-Y`2TlLp`H(CzX|Hki#1oFHMZ0kvRhfO)ZS_=}=crE;g zhdyiE_=D28m=?w6P^OM3$9~R~IrhfXn%sx+AqH*p61&^=JM;UrtQ(iI3Vr6rRbn)i zZoL4C!rUn*C#3AD{c_T~wB|aH3VR;x255@oi`(dA{lExx(l7uFUPzvhyz!H6-4@a+ z@WD-?ldz;Dqjo5jXF$dq@ZT?%9vuJfZjHv&$Ur&D^E~0x=A48dfXJIEzrI}igkqbB zmJ8b}Gh6Znc(nZ_e{Af*sn^20`gLS<V{5a*b(_DqeGbSbz5n}I<9wj3Cd3BbxuYoO zFW%ZJlzU)a!JM<k>|3f=x@?-)|Ha0Z_V$Fb%t3&f@Z+Ly$JS3~3kV)#Moo)Ry1Tp9 z)L;o=?6`Twhc@l?nAZavnP%!6b^nXd|HayS$2GNe?V?NBHc;3qP3l&+pmbDv-8NJN z6r^_%L3(eYSr7#QD<B;ekQNA?00~7vrPt5`0s=xp0t6Cz?o5Jy`#bkN=XcLNXZ-_8 zRvYCR&nR<d54d~|Phx^(n+Ptpth5a8DJOy%=r!|OSMsg76UaR4Qk9iqWb3<@X!v<5 zt{T3oj7{2*gh#w|JjbcqH!*FO5<`w|KU4WW`|Vt@WOWH?cE-|7?%VNM;)3(G1QWzZ zA9D%4mX63)nAb1Q&M&nc((kwZXR00u4c7eK2+iJm=-Pu8m9c=+G>odQ$Q75Ux_h~L ze1bF?#g#1B(qZmVot3iOboP@{XBS5~mK3$xZD<<7@%%nNS8Bl08?*B52X*!vYbg1Z zABItLr1DMdRt;9AMjY@Ea>^f&{9ZbQyuJY7y_>!F@@Ee42R7}js_uc_K=(_V1y5I3 zz_VyI`{$k9>)ntshrE5DEV!X*U}@R2@jGFKOFTx-A~0A?&F;RmSAxj6IkKP27sW@U zHmC`{PLt3-9lTz!4MT`5UL>yP-#_dTdork?+oZg-?1y%eF%xuKBi|cXgw@%rus#`C znJfn+OwaA@yt$nCM>jYkd+p-kMJr}8;rF&y%oCjGdGSSfc}>PDjJa615gTil5-AB@ zc%oxI*&MN%bjrO6c*fd{#Itjp$!2_U!KqGtHre&!d!id>>{3K6bOJUPG)yCiS$}$n z9SrlL&Ua7??r`vjqqz>TOgonYtv6@VDu$ugGQge7o?hj+7pGmW0&kia(lEUx$8&Mq z5OKm8(}Gw7V5P2MhfoyP|K66H>iH?bY4PcTg#J`U?2D7)YLtZnw!v4)HXp}fwHf}- z!N@n00xlBSB5tE2>+)(W$HJ$*tMetpFCc;SozeHwpc%ByWK8NNsXwH8UhlQfE8xhF z>3!O3c1Bj-jb1r<k=>=P-^g=Sne~e{oW1-lH(zjFoImAT6KMZ=`s5!j7wd+`53&tk z379OLD^34X;!GBj==Tum737L0UwP~G!EGG9-l>kMBXBeiH*r8#ik<6V1~BxRaM<lA zt+rI12l_z$GC=bb?GII6_b;&zhXQL43_j92^HkS%<fi?~lWPhM2vV42Na=vk?W?|C z*(W@%IBSK!V1=x_mij?qH1zAI{L)kNhH*LHTpXPov^V<2lUe0N9R1(bBRha<Efo)B zo}bV7R#y;&gSod=C1h>r^7YURTmQ;-&)=y+Q0+&0&SKU5O=MPAJ+402PEWHHWX+LT z>-;S_FICwO_XwpWwbJ~+%;#&wt@44Sc7f5=$x$vJR3OF6avv1hMTZNi><s2&Cv;hH zvA^oTKyQ-C#b6ZBXhgP&cYpuTEAniW91D(9`{5ZaQ=FVr?~(_5w`#B?euTd#PhT9W zbw_B>l3U@&!0u;?4B}sgdCtBZvXO9dazNQfj5fvqEIRx$XTM<5AEbA&0t1E8+p8Z0 zlL#$tH_miAIT=~GDng-W>GP@b<0YkK%JTdVb9?8`oshM~XmaF*_}Kt&c~%zpVc|<= zTXqg1@^vtnDS7>r!ATC#WR<Fa$l?|Ough|wsR=-L-u%>QzMnru3<U1YgXs-!`tCQ- zjkCs%9f^Rwk$;N%`dF?m8DhJoi?+u#Ce6`nv1i=HC(r2j$cV+4*SsQ%LbYB(^o;P@ zM<9xcJdxRT@OlyCjUhUuma;x>7R|TGVK)sXygIsZL8x~9P)t+xx<a|u8p|Gt+lJmG zkN+EBA=i~l%t|hfj?UTg%N3KJsUl_Qz!rT$Q3J(W?*upPJ<YbKISgFcQEN4VtWLuS zoFn7)p3}pLPz-zfJUF*<+wb1_5JFM~$ul*=adgXcaa?W9shY^PO*En|Tq&=-kv%`f zD^a9|MST3$aI92@|E)pjZs>*`<2n8S&(V|O1wO-JBa_HhldB+r#GyY=xdxjDt{0%p z@(MSWEw?Cl3hTQvV&l{{yJ9DX+`TA)xb$A~QmWWdNPW#A{}@p6Z9^M9Pv#k24r~Un z{*5M&v)M?AJwCH9bLP4&?qt_X)TCVa)FNqo*tNo_Z{TWn0uAvb;YT$n3r&I)6bN5c z;<T&L1I*2!Gf7o<s!jK0ZuLjN;MhMKI|(lZoul=0(cF>*2hk_GuGOoXM#1gfciiN# zOgS168$H>XO0gwe6D&%;8X!8=yoO~0Q+Q36RZd=h=~Ugbl)9VtlxD##D`}@|^HO^9 zD;Y4<VKgPXqv=>AkIh=8=H#Yl9D74mV^#_uEgaMb>4Ui?1z9yxpp*Z4Wl>YcUnCm% zx+h|8BLH&S?^q}^qiUF-dE6|3J$L>rSSz-<?727rkBc0~Mk-lK7>s5>#OHcC(WDM@ zlRTv6af<-elS)@)K2{3+{3*8AW1c^G@sU;{Tbu8if@aZLwCdd(&7u~=2e@x&m#{yk z$wpGUAa^gstwdMa_qdNQ98P~)UnOo&VAF4k>5rYFDP)3pvCimKJ;L7@*ShA3W8;05 zjQIJpZuCJkd|;_n(y%V$PnR!jAtk4j3?|dlq*QcInK2JtA=FU9B*)I>@Fv5r4Y$~6 zQhq)-#M?7dQu7D&=>=VS+@<LYE_e6KnmJ^=dsub+Vmg>?DTSd{mJY`tR`+uRq^@Fp z1=rW?J>><muj3~h+8f3*yd8|BTsJyU8*hVR_d{uC>CbI-BkJH_lju!ew#Kb>knD0e zt1DEm@CrovuXwr?gGBx<ePRH*+wVHS9cO;xBX5*zFfp9Td|wq>cFm3%lJcLzf<-(~ z=&RoLMUQ{5(it_(cD?;x02-VUe(3Fi;(O`l1HIcP>!h4+;%z{W_oX$PS+o9NpAQ@Q z#3}S*$U?PRIySZV2ge4^-H*+6)1AnoWQiJHf*?LYdK6c84?${7F3CB<{KX{kfeID_ zl}bY<riA2?bKowUjKnQ0DPSo#rFtfjtulk-^t=uQdDLa}sPop7sIGy++EFk=V#Db4 z=w02yBdH5^)Ty!u;yP-?ve@JK7@!s-8bsV{?|Zeo4IuAkBjX`8>5NeC%Sp<1n_7Pd zd}9@+=1x){@{H<QtBa9!gefqeX$`cxxCqObKLyot@00|Jryf*oJ2q@qqG4NE=uQ$1 z2HbU|qX~{<fmerHZe8v3qD5y{N9RGgSz#8)ZTHTJ%O7H??ixC-W7)id)LE4{6mgOk zNcZ??yvX@nrc4T?aU|iXO`+Gnbd^W|<ya{Lh7>Mm<YZ+DA~&#y-O0Y&)c!kG6jxPu zPpZmT;1_Yhds_`LO*lyt0YDPpo%c-0`!6)>2?D{PiNUioE9fDj7CsJm-Da;{KNhhi z(}r2j5UFAx%7`eM#lM``_8PJfXo<~AjiI3!0GUJ~%8gx+HeV@$0~o~(wn5aLke31= z3~QoETm8AHjYrfKm|WhPs~z00&40_)0hvZV#FeZzZ=wzdu_JKPcTDBLy|a~AQhvDZ za7#!6{k38luXPCA+BzLu9|hLFL^vz?P}}2BLrc@-cK8$a5%YyP+tQW}<0CVvRp(<< ztA0E-`B)-onF9?kwR+NAd9qo@WnOIr{RmKJPsG&Jgq{w({gTdK;%qA2=-l}kUmc1! zsKseAKzO?7dev}|#@#w>1~9g@?vQl?MG`lUGp$C~c-B>Fa#AGB1Ls-+dK>{aH91%T zZdsB8tI9|dFCxD^lQdjrV@TBrCYv2(Wo11t7EdvA)@ri>m+}v~q|AM|BbpB#+;GKN zQe&LOa@%2<yi(KKKjcCDm?{R<9{AhvH2a7o5a9Pux_(@Tximg^d$ucXMa?JglZ-c) zb6g}z62xMM#LWX8G;A6kA_G+|H=3;T&xP-<xt;;Je3=FcVd78j8tkhf3ai0n+k~|h zvaJo%Z`zwmxe|0zgSW%NPo9`hC7T&YuQJ<JFY;qUHs0~t9deyti_KN#4B6}&ivp=% zJ=gdBC@&q&Kym>UUS5?&IYiE4g1Ai?kXJ$Dw12u<`y^?0DBza$>@aOP!<bQj2Rlri zo?TngEjh>OR%BO_ot0G@nq=kM{CsFAT2I?#)hl5BSyoDr1k1SYie=93z`_xQ)UA+e z+_|s|)_s<vt1m}1C5g|7!Dtzakv`6l?S0gCuJ2O1VG~&KvH1`W9GMJM9&#KEJ95Jq zC^lpiJg6`DPR6rI@XF^`gp|?ILGNPn57OE{W1*I^Qc{JvS>?nQQ-KN`TDz=r7j%Pz zejbqUr-#*-X~kE7V9$O}n=!II@PFzYzjmcfV`jh@1l`>8``q1hU;>}J{eTY3;J2LL zjpY9^dHkPVu9TC;$mEj%8^m0>bnz12+0og*^~5fyc7V?KYEJ_}hX|dpfW6UijRMnT zSZx1Lk#BW>DI(k7_>$SXt%UYc?<DQFa7xirzrVl+fmxnOFQOOC2NHwWTogtqf3c{m zog2cr0A^A>BHhp|FuggOGWueA09f24B3gRWL_>gRPuvB$IniH@y9RTwt`Ct1m@Wzd zvbGiZ{P`m5^fnt~^)H_l`+bk^$(Fl2_Q>=~HAd<iv1>6};T5jP#=IXSRV}9<j(#x5 z*;BPaO3h8Cld{Fdci`2$`+ZCtzg!sppl_}H>2P1X^n@J*3B}W9RiRJnrjD8}KR${5 zQ7Pdl8gB-&&}!fF^LrHBqc$bZ%gV^z<%q%9N(N1z&cCRk?>`85?of;XLCNq-aG=$j zd|{2fp7*0C_16wSwbFEjSv|ii{)a2zwAvjP`@H1%a%-&0?2KMrsA+D(1>gN=q6m*^ z7Qt$`4g{9R7OPog%m_-moG#&MtH9jTcm5!7j<X17@-Dxp=vqII$7$t}#Qe6R^BvF3 z!1Bl7f9RpWMr{6CY}loX=~n}SFY9BibKp-b#u9>L_ng5M$4Tn^a~-4{hZ@M4yhVVV z`>ztww~hONcx+`|2A^VFzqYTu6}zG6pl{%_&HJRjV4MV0Ub%64QbaMN?26pM+?#v> zL9RaSFJb6ImKafu)^jQu9R(7?X3E;8;c)-6kF5uTxRLvE!?7*PNMLzs%y@eDdD6yD zsm`#3xAj7`-IXU^?`)0TWQ1Vhwi`c!Z0}x;t(0J4;$>A@ecL=3zsKsNnrRa8C3#Y* zoy5jAt1B;e+gZMZGAt_6SLBV2=cl+e-zae9tF$v?E(C-WWB1PwBOcXo_uMyP4V}IY zuAC;UVYwLFUBaMXLZ8-xo<F)>`c^-&=Do8G=hHx2qo*Vz&V+;d{^qe^df_aKgm%@C zsX~e?-{IZ-4#MyD=rqI>2N+HDb_NF&?9Y$>elxcP&wbG|XudEfkDctqj~W}|P6|0K zUsVN|qRL{VY&@>0EHON%w#eID&MChqAv5+vOw@o<;c*sD!-I}Bl@hS6B4B9EP4AcT zX+ke`R=J+oVSAFP`LKw~EyX*kEl>7%-&di4YRZ_(`?($q0QX04(A7C<=Z9-}BIZ`< zVifOnI+SPnftdQByoZ5tOH=+yk$P5Mu|tl$3U?c=$!JY+MGey$ic$YVPe1!N)9bZ` zITh(!t7HM<TCvsr)ynXKy73`TR<<S=J^^mlVI?<WA!m}|J!^}D!v*3`_9cJtj=x?l zs`1AQIWUxl;XnR{-(!utG=mS-)Oa14mps>Rot_O;YW0vlp#>eaIqk<I5TB<!@~&7N zXFuL<Zzd}iXc83v!fBQ7%2Dl_8Mn9QgYMzGQ=V93e9dM$>Pyoxu3toYqo;40Hjf|2 zKDB`h__U7eI}yM3Z>VUzo9PO?_u0npYWceT21P3^ePvkj!~j3DXpH_K=uOMhCrP2n znNE~t!|t^7KW84;l$=){70DUrxUZpXV6a85mCl(HXn9zCvQmj9=SixsSbNB1Vc8p8 z(YMm{*w~X87khJxfK5SV`dsBjQVXHYh<Kc$&e_e6Q)L|!CAdYyEbg<R4vYU2&KpdG z^L?08fuJjl2H50Zj$3}Gl@(i$Me{tp3(JlA`uWOXP8FZ$X@pN4zJtMm7t!0@DV}dr z(7+;M^JFHG*08N0q1-~vd2x*=+S2%Q%|%Y^smI;|;$pV>e$RAgB_-OUpz0-u%cQkm z#)uuT<Cqdv!+W@Z5!l2oNJ`PfayKZot#Xg%EV}*EdTaP#^guYF;`#fGaYTEcTZx<o zUYMf!*0<SnoBd8{X<5?i`94|p)<gOO{1Rp(3HlRJ(_lZV{)CGhZiWKZ!AC_{p2zgb zdR=WeO%eSAvU>iBj(^gzVNMOhlB@-r0b(qf7Ks<$e7G&iPYkwhU@FE4WIvQ-@rXY5 zF++-QdR{U-T**{JIi_(fJZDM39^jW_r8H~}Y3+P6yuWmOf4;Qvw{O-YP3sASNm6t< zP_K<fb~GPyABG>SGJ&AUOSHL3=y`fxfYVl?NXfn{C9-_Xu{_be?-!;18N1p*5m$0z zX$JDC3J*Ig$Cq(|c&<4oz9sM!OJB4M#<Xc}GyC%77x%$nk8qZ)=t}sYG;dRpiTg*V z;N0*wTdZHQ<C`b@yyHNLi;pbrq-Cj;f&&{UiqZ!lLzw|o7pS#<vOW2*n0=_)?z5fC z*ZSAXmB4RbmfuY^kJS&ux;<ZT@+&oAt|Q-@)Vn(HqSWfSm=q6leZQQn3|r~Fk%Z(K z<XI7lMI!%Xto4kb0_NpLqJH4EQ;=j!|If}~uR&F}i#DvuqUN6c4ojtj@#)`?`zE+{ z&Dmb;3js7!^vU!Pz*%$Ij)^UvN6Zy{gQYTe#ib;bzNvb}@jFV^TT_a~24&cS1c|Cm z-dL6QIWD$)W|T(8p1pKwt-k?<-j}4u`I`uvJ!Wit63f@n;K9&#MtxXY4f%c>jiD;> z(llDJM2RI?_fOK>abgyw+pcKAVX(0Cr`y|mu;ONGQPPvPQ$=fh*%$D!FCTQfr-ZEB zT!=4y!RJ3((;$L*lE+sDH@tUz@Fo1dpHh3ejipbCZ1RV<*vYpIgcjs@-S_<(Na{(< z`y&meuSSDP7SHV0;&|Rr-}o{eXa8JinO|!K)RRimS5DDXo!neBSCLMB7=B2xDB?Yb z#sG_06tEe-wr?l@xXyO46yJ00*DL_rMUXEU+)Gs%+4f+&OOo#%^=z2&T01;lC6oI~ z(P@uC#!QDurvcwMk6=sxD&nwBH*w}JNqJ<5*fy$UcPVUmVUo{L{K_fEEd{S=+h%)P z#p$Am`t-6m)8aM0mIZRUVKh~27xaaLIqW`qKX|yC;>KwnpF9Ys#gDLw<{I(lT+w{c zdiYVM6A|&GE0BD;nOk+NW~xLwZ+Y`1+`V_E)kKX|VWI+`&}}D}dlxLTP1F4^u9Ytd zdXM1v-(+IXt3XT$o3+l^1$}3%>ZrX`p$Y>RI`*5r{gY4Ufbl#4AS9#ri(hFT%>+IY zq&NQ_3Y}wQz)9bA)#b{A$xK-(f!)=%cFC$eTYO57m>zAZ4J^MN$_xo=OCI*YuYam# z{gp(79yMZ~ox9f-_@ilT<9jO`n#f%4f$wt}Mu@^u+tZZxRMQZPOL_4QT>GKhF)H-$ zKhU<yl62UtQrjK~f9y5+Gp~oMaVw;_EHhXedl}d_=EfkXSP3P82m!K#KLDqw_5$5^ zPw-jSy6W}SpZmtlVRK)Fw>Gka^P$?$hiQ|}V2gp+l&ZV#;Tv+&7Nj{_=_;50iCH(= z-|6`#_=Gw~uL($wq0sEvXTs%8`l+iuKb8Fo-{WwE*{G4cZ`*73Y2|8j@BdsggX0l3 zTaRuXJtxAWbd&oz=uTOu6;V~U@L_h%6jW*1djtec(TOW`<JQKo(w%lZa&?QXI`=(G z^=vWjJ<i58&mR9!$z(G59Hr6Nb8m|PY@=VHYk6Xi`xTvwgEoT6)Ehr6<kW`H=E33L z;7ApO4VA?<hUwR|krlIP@4%m;V<DF>bHzVIJ|dzk-Xo&K6DRXMHzrmJcuvFcYOaaA zXav!4@_qCv+nD)J^U(<zSxxY`#BTysc7%R=uuCdg9tyoaNZZ(rcKm;)?GEBJ!dlx~ z3hNj(DkhL43S8Ha&5<2jFvUBCSs}fXtc0Ht=oAdM<(Q=&Ss|5Ip4(S4<UH#2#{EH? zR31NRkHqrk=NMN}n3Kl1`a#x`<|k1xg5)jXlo6hNRj@gl1&VKc*C?a4OUAeb*dX}_ zj2uM%{n(J6Aa!;A&@DO7D`Mt>LqECZl00qxI^knbSTbXNGhmcg#WqGofk#s<sau~s zu;&)9-RJv=_0x6JMa9~dCHTA^v?;lc&Bo2Dkh(81Sa*22prF!oINDs0V_;Y9@=02> zg5v8zu6W!azZ&_T#jKbRy*eZ(7@;qSQdHeUi3VylS<IL5S53^}KpAMWa%JZ7=ZI{d z2T*MnLzJNnB2NM@Al<$DXCo)J(Z;5FYFUK$zylpK7czE3;q)Rn1gd4%3!>qVE+7vS zT3G}IE<Yl|RaSny-rjnHHiEu$FjB3}SMy3fjYa2l%B7C}kSVa>EXLgvPvPWZf%xbv z6v4xWihL^l34TIvaR1G0OMjW|eTV<G*^>Wlwza+Vv1A|u#VVvtLsN4Ls+RpTf7>=W zI{sXhL@<?!m}9@_vW`doTp!>S<*E7}-S0Qk8sy%eR9DnIit^SzU*q>rQdiGS@_@#S z+R;i(TMXGXZY;eh*F^_EK)o<H2^@^Rh8eWy=SPd>3<|1h@GK)^qsN+a6n<NEWZeIW zRa-eQ0PBXeU8=vyh%YXoNK#6F99!a(T(B1~yqvsrS(?Z|f@b!=%xQN}G3^K#R*I6r zxfJ-##}>e<S4YrUC-=hEHB<=Sqv5MK|ER^4Eg9QXQssk3?vy2sNu|ovSQT>i1Fn<h z{;*cRt+JwKA9mKy-_>DG1FNgnV<8h?^W6)pvS=-^?jp9}yNMtyk)y^Jp-^dh86Qd$ z33k*8+MFzxyM%2$hVWXv{~@(rVWvs_5<btW`~Te3fBe#Oil2icAT5So54frW25*h2 zO?`Y~RJt@55nXc+%fDFas>+_L8t5Ik8f185T<NAvDM0v$+yeAk4QZx7mFuu*=By%U z?J%A?zFv30XDr|G8>$x2t;|wfle4w%7s?`AjmA~E=yt`RTO(9CN5|2?sc(_M%?s{> zoX`22g&5dqV#$S%rjVm&^aH%T_}RO)Lidp7CO-%U`p#zyr!Et-HXC=>9-#M^q1wko zC>ujDC6ZU9>Oa5X{JuK^a(l>tdm5Y%(2*_l+SGsZi~HV`<tr`*wp6@K=dhsnt*3z! zhU9_K?Yd9Tj&VfspFVh{cly25&A|}E5ORI-By7yYw95!e3!vLc?ImOTjI7vpIANf0 zaj~f2%pP}*Vsy>P=~j5;7`3)a#H1imwMqi1N^Xj1lBoC~GpgWenIvOZh)0yWCLh(3 zwD{9*`TQFda@ShNC4x8U!`ASW?<aiD@KGf)`X<2RwDq0)_(`2`DeKm2A*jG?R*=Ij zsLZYTWcR#;;>%#Cu%#`-+a(rfJ}IqkM~d<c4-_ekDwa!HP;(v>HE)y3Di?V-f@LJ; zjC9EZ(L;n!#sLoafXZw<0ygauMMfsm0!a>|!++y((BWIg9`)|mtcMbq>q|gMk)L$# zx7WlZgI!BZs@kLWK$$h)5-e!w_$D2|vfjFvjb1SrPKM5k(1Ld8GY{8GW;}-z^Hx7A z>{w7yhhbg-Ot+60s`b;QC+9cbu=kp~mhOVmF41$&8&3hnVDHT!#~B*ALlC`b3B?=9 zX?&h3o>P>6kA;z&61>X|tJPaDDi&Q8<g%32_1gD-PKBExvasyVV`B=`EW{~vE*_z? zjOMPK2^KgvHgJnPK(0&GXj6Bkfz1wgIhqL)rZRxSxSkK-H&T!D6mMdJ;Pa=$-HJCJ z&fd6>`8*LJL4+rWOOyJzu3%>)zX_O<Cf4K2?^svQE$e*~P=ZaiPmsVK0XcZYu+MU1 zOlp$;zcr@0(HkTeW<aX|XAaI~MbyK<4dk@K9786u^Unl=fWN1}!l##_^DDO46d3zz zG};J`uKJm+kXt5Sad2t>9FVz{BanA@lvh?&VA$ujMG%b_(Wy@SO>k*8khxR;;WRQI z0rf9e<j4d3kZZ~pM<RYsVz0tf0DzTdzL)i78!qO0WJFIO&>j3$%PuhPz%Z-Fn$D7X zH#rWUsX%%qgn3`Yq=06rS9M3ZC#3@{%2_M7jls>~BEquTx#JYT7%(Hq<h%zGO8~Mf zF&xeWKSVQ)d0TPCFP2E)i7+uU&$LY|PHR)=_I(p52h`%{rs0?X{q$GmG;X0@`ms>r zgiFhXT=zqHLa*~4E<`-NYCR=`3WcB^Ml0-74lsno;?B8saQQo;t+Q?#01#7J;IK~| zAgAkjPVb$n_kjddIX+AuG*w5z2iflgsctF1r4+QlH>U9kk}2A-6@E=SLtg;0evOlA zqzyKM^DY}5<i?{qF8TKO2jupMW<Wi2SIxf4WO<U8$p&5)P#TgUn~yKTZp&o_4HsQ6 zUS8D&#jBWZRiDF)X0jd2q}$9T-76n&&yGHg=j?m@0YPIvHGugvQ|Hw}GTyuIyNBlU z9Yw2hDjQjn2WBisj)knK5uSkx>^Ff8($>B^grvdn-BlhRLkmrT<qQ8!=iO4-cOPJ# z2Ty_?bOTdfc3B)2CH6^a9L!l|=4bzPgI9~&oBS@TF{m7#ZEpdX?_yJ`xnb9U;N~~+ z#nkPFZxweN!)#-=;)qluFE4K{rg9H}oX>Md-Tm`S{JjTl^f*QrA16TSD|Gf0dQH4E zy!Bz;nKLXW^m{-7_#!>A2o<^S<Y18y=7j+ntrJg-u`;QfgqX#s8Fvk^+}Q~T5u&v& z0UqX;J$FO#*XiPd^g99Z1`8W#o#IO8>U#?bQ!OG6$Bhs6^fUK>4vOCB94IV6w=Xl# zkb&B6l&VlbYvB|Js5k+X&jW#P`e}tcNJ6Bv=#5H9h&F-9abE}dw4wwcOls*qC?3VQ z*HK1KdunQh=3RLkFI5(M`%5f1VyI08Aw?4iVm0AOM6*DQ432PGRm6Sze%5W<cCgBT z5esf4^)4-y0RtP(tWWUu@utzuI28hj3Ie2aAm|y>2tvg4+ubPenTV$CrqU2@HKR)9 zb%P`TC2N>qaTH={(*0`$ON+opc<T0rKpZUQGYCqz0ldN=AwD6}@$Nv%JFn5+rkDN7 zWrmR2EEu%p+9H7I!*H<ZBuh&G;mN;b5LuzCG8d3`<!E+dg^&K=B)Q!83V}OS!Fl|> z{8p~u>5TyzQn!b!%ojBSMaeJ}bq4?DHP6J8w}x>+53*IJ%qazwJ|I$!oxkP<Ynxw& zWpZGNiJ-2NvSh$TlQbwWr_kX8{Fb9mTb&2~C;1n!D(7EsMs3y;<ktundIO1JfTp0` z(kcqZo-_+c!kmVV7JdXo?lk+I5SZN>0Mi@>uTmFMyZKZ>El~Pi`+zz5)iP1dXz^@2 zJn`6!gu;jSTYr?#4{)fdvM=v~gpV*XOb-9)j2W9Apsn`^uFpjuP$A#09YQ!v^>OgS z+K@^j0vq{6l_UJ-SZUvOJa`HpnjHuGU$!1jIIRyEoFyLO6^wCK5-Cvq1Il6aOQpiR zeZ09IC3&bwM=<AO#4I@}SY#&NCTnek#`E|gsd<J*G7C#E!*k4JM@?ADR3O+Fw23kL zX2q<u(b{vn21r=fUv4i=GXGgxAl%>CXuGbjScbFG0gWuK0uw1TEePNvK+a;)<=-># z$!&BtNu{QSBbf{OB*A#+*X`|CwHUSaA7ci}`F(&q+K<3h)MDP9v%A#%9A4B+KE(QY zhCpqOU-=GRSzut1WW-$xP@<@*%=bz;P@48tM(QuJgeS*M@MGX2u%FxH_AmUC=d#4j z*t0@bm^j*S*_PD1bPI0E#8p~P_3aocFJ{|%(`stzr>XmuL7SO8*x$jD!KY|R4IYur zT+nTG<oAPe&?5GoPx|oQoJIHs#?%Y48u~?`b(BkG08<l1*0NaC;6D*D9oe~`mhygX zXID)_&<Fa29>^AS2Mn(9e(BYwalSwqAmUr26Eyb+dE#frrT%*-iBYVt{YYxn>}bve zZ_wD|;N$@J!z&e3rB5J81;e_F12T&ZAis=`XiD)PI>V6)BrC9EO|$s9XkZbNu%7_g zRi^DMiUWUn@dYH^i&2w9`tA+ia(_itoQtGt0UZ^4RE(0N_CeZWJHjmjU>>piJ)l=F zi+@0j?^_Jb#t+U*a){P^lSz=8$Dh;5{WK@8A4*Fgi2pV$J#B~6Wj11l4m$prEnE=o z#p&C^K~~JUsd|Q8Dfcf^HtvBERaSK$m^B2)zguh!z7u+F2HdMr32v^xSR%r|v8rb} zIhMb5p*2CS3XgEsso|!&&m)bb3Q)l0eDP0Ddo?!11Qz2F8%pc%vqFOZMRKHOlRR`U zjuZm+p1IPFbNS?l7w+HIcM9Hk^;3=bqo}#R0Lw*$ZA`h>`L}!%fMGDih`Q16$r@K@ zNf=%y<=rvMv4u<;=JYWdfoUgx>7NHymm4E+udgFJQq#c9XfZ0=3!mh_()a@I+IY-1 zhCfLzm%CfvgAg7vaO4qoYcZ3hszo3%kks{#BMPuh#`FLq<Ll3(XMANg7-_ZFzqpE= zQ=l@9X<}HRc=A$D5TnoqrSZ@gszW!d?-!KobKo%s{{y82BK=pF@s~uiigT+5f{S&j zVBR3t{x0PKzx(KGyUXT$pfI92zqR=JwW+8gksPP^p%Z-?MSTq_BwJsLx4L?UO}qSe zh0ZZ*H&V0sodk8_e*PM6pC}Ke%;sK_Kegjd-6JJXN14fpt{`o%AimeF7d5+#Aw*Ab zekPY)1{H|T(PP+}e-mx>%PH7x-D+T!wrp6C>{i+YP6NA&q%pOwYT#j$jv;Hhmu*63 zVzeW9LqcrLiYDrdnlno)fJ<{knZFKum1|&OP9C`J@28wD1l?5m1^eBcuRh!#_XBv^ zXqEHIX3U!!V5#&k4}M$rf={c@bSnuNk<%PONd1<}3d;WfIy;-0_`mD5pY=>XAhIhb z?kAHI?F^O4$r$X-w}`I^-oCfb6Iy$;72u@ZP#>exk#=Gyc?RAJ>L$@^?*NjB5vshk zE|aeBvIK3<%Qj=~^EtE^rD2z_7rs*wPIpzBQ5YDy2?7@1LmOzM9Xaas`hG2Y+2Ueq zQ&D+!6`lnz$o<sTE+x3PgJ%DY99D8Fl?+Q_@CUu#Ju}Hi9bGoBdii*R=-J^ib~v$Y zv(=CZvf|qb5}#=4=G<7Y>1D3CoKY}cl|(NU6wzk|Yo9rewZ~C<D?`BCpb#B|Y7gW9 zmeK?8*eoZQ3G7bzfnJQRJ&+gdgG~+kq0=9{zKvdM*)-0QOgLM<^xMZ*BjH;{mnVl( z0;IPmhrAoh(gAPJ&gX~;@@a1W`Sd}B&E!c?u)D9u%>wiMSE}Z=8#Y%JLgi|a3>hn^ zUi-!t@|_92RW_t)0kgjRPuEo)<w}{od-q1KzXS2=)5io!{tY8q9m~bY-}|y>$c(q# z=h(Mg2ItFy=TUxR!;&#9?WP9gfy91zWUdI`M&$-o8pYwfI58X-r&31#8fWuWjVJ-* zgKh>fY~|=k?27O9FyP&iBh>lug0(q0l;^CGnU<?1btJ<srR@9(hv?;ZG-@&DT^<*N zrzfoI1?vjlK&{{E%RU06;E3X-Aw>y5iZ#-lr~s_lCg!u%@@-|JF&iP*9^B1*$1?w# zH{?2uiRpU_iW8Ozkt1rCKG&ZN`t37hgdT@Qjw%xrPxv=lF!cRDnNZlN=2#UC*4Vk` z8T-N-i%n33#fYYPY}YYgELv4o*<gDWRNOu%Qx_~JLV`nl25mx+_g&9V<36Z<Q*$Lo z2O-ck#s6Y^@gDGJjU49P=7=fz*gJnQZ>dFHunZYIiQ6|fF|mo8c*Q(jBYy95%!itP zo%HETQ*#JU%jgoJD4fi8@H43Ism<B_t~vVW|G)CWST%Cjp~ca1muGV3fN>3!Qa>Db zn3K%2{||X$Xpy<wr~+cTDdv)$;aYlc@v!gbOmVg1pP*r~gX&H!(|yf-z<44!CG<m` zgQpcDS)m)SwOJJ1#rXPB$&$qEVlXj1$>3VGlAuyESc0xO7nd^zIHw?8Nf2x9FI#5? zX;sVaUC?tT7`@!?W~38DAyV(GO%XTV%2}?Bvju)HA2Wb`b(9n%X!%yB_<1-UJa~|A z<#e(+)?K+T@NG1}OyeZWQ-BLMgGdCjkNGNxla}SV@BOpZ{(Gth@pb)2Q_Q>lA5GCP zF#3A43+%q(h(C4RXu)dj!4GmAxp}O>lAVN36%E0+Klm~w7;`;`ORr);{1a2?QTl#f zQ0Ry28-15Quh^7c2gz65^a%>vVZ_4KR0Y5qCs3xC+X0&q&Hp3MFfObBtkyP0OW&{g zr~?2&n;2TP92}qi_eW(I4GBmnF)D_7KDK5G%h8sTnVC6(00aJuD76X&hovbhWxn}b zSwR7Mb#shRU5-aEZ85nIy>I$g6t~i?{9f&Or!7kGSv%ZC?%tbrV~?f-(jC;cQLM%_ zlRnD(G3>eOFH-6@hxdPaaV5IW@lVGl`-it~1iX4<EE2%y^4xy;M|Zw7MeL|bPmqhn z^4|eT@4mlGgdOd<c%%!uBE<7hGQ(G>xl4-g0pXjJ(22t)PvRb=vjoJ;#Xp!u;qLoH zv0e7|)%W%`^zNG}HpnN;29rs6J7SaCCVb453F=_b$h3?kq{roo31_r}9u!(O^PDa@ z&f!swCPAgH9LZ>5vf#meY%2a~M@KoJSRMu$jLb3mLiD>st%J{>R1)7jvD(7BeO#H; z+Jzh5zP!uo03((c{xqom{+UW14)N>zu~kJe+T61oCpW@=1?@{2Z%!ScyekX31{u{O zfqd~`$OVET3H37QMLBT4HG(f148B_y&Ap#3p0$4tw%jvXo$EJES*sg>KY~&CE6!)% zDJg+E8AU?qyp~X6)hhnnIigD7>X!_kba!nF_wJKAs@|*98iI)x>EMB#<0!jBeHi@) zzzT)juF$&H;5h$#jw<2z9F^AZML0sgyH!USnIvci9{2@%oqsUg5`yf1+uHd$58&H? zhU><Coi+&jGvLDhqm37WOZqYIh<;FL0OKn5@!Wp-1uMbeFKx;*FO-WV9~a6zzS&VT ztt0@Y-D6yqCtG;01q8L$9i!*)pkDU}z4iy$$KN@gS`v*HL0bwXCPs|8IIAaW0tGUj zI&JE1QRV2L7hIDt_J|j$pX{RFIl+6Mc;*>>iD{##oEtRj9`e)|r-;GgbmI>|J12RA zlS+?2UYWHLRo)<J9e<quXMNP-!D?es(%HcgtNqqeDenx|jgRCU;$T^8D@C~_VXQ<x zYL0ncM7$WgZGA(B@0<~t^h`cxCTbU?7)jqS46;A)&dEi7uX_#0bdTVLfmf`f_g;OS zzH(>4Fxc5+jCayAC-&=ff3tsnj+9X4%)&v+jc~7P@^U<A;xn6dk>}t-PwBaIXl5jb z+g7%})BfXm&r%<7d*mk^7t_Q=VxBj;XTT0N7K(KVrpjgAkj11j4_~J!*BE^fo>?## z2$Ahk(WH)=iT!vjoqKWrjBsD*@yA*wR=Xkk6b96JJDc<6soco0P5Z$lS=*w@k2%iH z9G+TD@H0vn7e}GQ;e?!Tyf=pK8@Q9P>#N=;+HnIb*I3&8I$)D38#c8@ig6Muson7i zZob_ReewcIn_bs+7LmKXfA;!bU48fB%4%JRi&%AhyVwriDVd@fmtvR!)BZ>pOr)8I z;69HG+&&vy0kCiV&iRAgeRk){9^JTrFshR^t(E1uSoF?GTmP%RB8#N>*2bvukS#ej z$dZ}owNGM0_PN<ti-~uJTO4+4Kxu6ZYGr>+KWSK2QRAkZBNY4C4`_e6qq4n9Gq>yn z!N}ea2*W4YMmi4{mAZnccR9Tlbf{w=G{l(l4vl^Jb$WezKW>^C6L4?Cc5u+WSby~G z@a?IU#2)HXqDSzOg|ro3M}I);@0pQ4seRzCJ0@M`1(i8ulH<Vrgj4L~67{cf%W3*N z>;_wvFuo&Tqs2>R)U3{Qoniy*zCjGrF0$9h6xidD)u_*o8!eAiptNGIVON@0CY&*N z`_{xj$oaTkPJ*eLVWXLs&B2wFlcRD$?IU^l!jAEVPdPlN)J!c^Gl5;V`>+Z^oyLsZ zrIT6q<HHJZV0ssoV_d`x23HJkX&DxYjGn~8i@>*z?ymmvyu!GnICAf+?~*bF>3`ct z+F@6k6tv1qpU<>w8DfDUh%e4;&60l7On*)#$6podY+`u*dGjM~jo)*<o(!)udnP<h z9W|a-;z0}5jVv6*IOUW@+3M<ZF`;ejTEgs@%CE;!8f&FL7X)RKetw%d`x40s{k+L= zZj%d$7lL2zdVWAG<tslQ=E)s?GP8f~6@*{nUS5gYa><K*0sp(*(J{#oRO>%1q7rp& zUXgwpH2c3X+%1G*`z#x;sS8j~{;}JTZgL3Akg3=YU$6BOkk@;7cJ>)wHXuWF&1ZI1 zZ-;J2pUM|<Otw_cg0tsooj<`HsUI?%=H><GOt7`#IU92iJVjRWVton~;YzI=llPvA z$S!X88`slZR59r~IT@3@`g!}2c~+j8d&8>DQ8X|hiqCoi<i*U02U1yaTNBh^>YkaJ zRblGHB-M6Jvt704q09h){l{b5kJN&u!zn5Y3s@>CQu2Oo9Fx@*h77C>xTZ#fR_=@H zY$p>(R^QngI9S(gFR}4qtEjcqs&mwGL5CU2AK#6!V2ccJ#J4?oq=T~i$wWNdE&lLs z^6M3s4X!;_35<GMd>@KwA8d5FDYf`&<X^@!cWY?zD4x+Mqd~rrOBd}jp=*Bg!vzOp zRAp~r_@lM8pL~V?i9{kD1e9bHIAXQ5pAZzAw6(Rur25P;1KHWxQk7zl;a`WEg|sdG zO-=_+7T|bT)L}bqFOo+`5Ze=-K)*D&>1H37E34Y-+PV5Ju2d7!z@!V7V|2AaFwF9c zvL0z5L_&fsyjfy@!KiO=n~k8N^$C1n-^KCIM0k$B6ZjtBpi;OyRKi$z07<zr5s`Ut z(?I9p{PA{F+><QBRB#PAQ+R`DGw}dXfq1pehN9BLK^9aLt`6F?a}<Ehe66ZqeHY$v ze=@FDSr&NZRrmjCkW(K9TAu-io;!aUDrDbrVd0suKPAdOfZ+9C0r0ofhE$7+;Y#@7 z5GgS<Y;yn|r?PPAr=r)#97GGcTzI6iTq$rHHR%}aa+Z+I!4@W&>JDSPrgC)_w@~|l z1!>?_Wxwd_Hggk7TdJcgh#OsLuw9*2=6ZU1{p>W&l>ONd6$9eSl`uZ#D!3j%iKYzj zoZ~ZwTQ|%#R|=@Aob9Tl=L^d(vl<8*k>hV(8$K=$o(R*AN=`^h+8*jNhfNmxgMTpV zz1B;I83!F|iB|PIpH$@0_#CZM-$Eb|YP_-4t^d)ec|9y4o{RKk7l>cZvKRq3t)BYk zZM}(j<~DsSE4(da@!7(w;*OGI9g6w4<d7khl!f7tg)Cx<azKgX<AqmOuw0>Qo(!3H zo{u47xuVqw6|-qNSIebdd2h{)nU!v~w$9pFzJXEt=2xR3O-5l9vQJQ%j0vx!pojO0 zJxph-wi~1wde*!pyVZdmL(@8ka1HV6;SFgAAGw=M;g=uiAxknBK4z$nMoVHrArTyD z`ZeTv!zY0Fd~)>B5EgE@Yq;Os+*~FG$cVW`Ncf^Jzm0HK=7sn<xFf!|_jbG)=LO8& zd7GnI1<K;=s6~u-)E=uvMkoo5_5N+&vs?cc?E8H9j<c5EkS({0lwW|i%<)i4oy(sn zZCLQ6SOjUe*;KLeu@>;5g{x<(Ps+q#DK`uUz@Bsq<i*r{e|)kqk$KWifHf=1QkOIU z%+$z(0nD}4z;KW*h!?vAp%SEv64<+#c0~SOS^XbLome@2mP1{1m}cFB^Z&Q4+l$e8 zf;zip4_X>xmI)z#I$yRY@A|EOF&fyimrn9nig4@KsV>Yx=)G=fK()5iW2ziougkuD zckuYpdNN_dK~PDCLpw$Jj2CqYD-)wtJ@IbT7=z=WrptNx`cf~N%Sn>Htl9{tkcP^A zl7XcknvBufv;f{U{B&ct*G@k`%GI^f1N%^Xq7CDe=V*2|Yq43V{+(TtfGo99xE|nj z@wlhydu_+w65?2m@FrPsbGAx2Mqr-hc=g8~&LdVkjiK7=L#$@EFyf;_Y86(I)YZ|T z@zu%bT&15jF4tDq`p}gQYdA@2?I0c3+c(F8zZC7dy`zEF;ZwPi4waWj&TadxqSe-` z#HC)7<(3~%#5R&+g6C9@|M3sM`XL9`!h<xu75;GpKP*T`bA1|`2km1emuyAuJ|E98 zAV3jzx+`fXf7?5*FXsOzp4&1aQrbzZ=h&n1qk;mTaDCLdNV#yq&CO%uKO=R3>A9B^ zm|Zu=W9lXEreyo$)wtrq8*I298xob!(+IX?slz^~xpcP)U&B6SS$9k%$^;`1-P;L2 zCMH6OriHVIs&Pfgrl9{5Q0JttWCp>oJgNaBK5&8)SbdZD-P(OnRHrisql{~{NS}^{ zplN4pEr&Pu&g8-hr(kF_eFI0DbpMs=q|wW0P$!}+2A_xPqs*&u$BwC3U<L@-jfRUl zK4HUxmIkDOyCdn7sr!9Xs&l6i6qHrRa&=6KvH{5m;(WqT2-s8ONkJ~Ij|eQ>Z^iI} zy!Y^ELbGb&211Ib{XmR>N--Jn8g^lIOyI!2_LLld{Lu}zC;J3Ok6J9^#(;E7y4IiU zk~+uW6rJ6p9#hCYiKD;FweEpvJun||S`#-boVVi6t!AOVN7tl`iAr`wmB^-low*mc zKjVn&ykH3eDq(C11mK*-*jZnvj|URlSxI9xI=U>Gnup`G4CxCgU4^{zTuf=42^>3! zp{`UZ`PdBswk(L<&6oqV=WV>Ojk+Q0o5OD_jUQUPE5B9yAR+a9@YqYYCjaK)lMn-m zN|MdrIT0rA97i|wpN+dAYe?b2Dz4Y~=M$U8afxSrREY=GZFZ=-oYI{Q&40`j2jl~> z4{NR>UKBWvn8MAtqPMY*4J>TS{mSHUHL&6R{0F-*Zze+!*Nr1Pg3buGD^7;V#HhIa z{OWcuQ+On>ttp{-?=HdGhdX)g{5{kC<7cawp%O(#2e>3L@xuPpc0lz2OxF1Lx(8Ao zYO#=$0z^9Ml}$Bw*WO`dx}63QVVgnV`2{cT7i2yj*h-Ly?igLzMy8PZx9c(}MNsEo z3||@Q>bquZ4mhZZK6aww?#kulg#@VcW;=bPFKwQkW$i~2l0Vtx7D$98+U|O`&oYH_ z?i9q#Yvk7cPS@W@aMQiK%0`nGXFLle#k3=6&BZ(<TO(&YmoSy^CRu`WNeK|~jSKsS z!4LnTkaoPdAw1V{1iigs6d!O)n$LInGcYy(%}cBJww4A%4Q81b{xKDS6u&!`@_s+R zCNvAEC>|p}SK|zxHK*FO+3Ygn-gyTD#0#{nLGLMRY(_G>QO0PHX;uwPeD6N^C&v+@ zr3~NbAX=z;!nQ^xW~<(?>~Tj}czum4s&E=19C+&S*g>vvUz9&sWJg^gAQl$Y(6W5; z%eVi1eG|kBogqsLUZ&g@#k?X3f69+MRIZI^=czNV+r$S-B#nb^nNMmPSKd+lm}|F5 z?n<^ki)Ya(P|cb~G)Jj&TO4W6gN?Qzs~Wxv*QCJ_(0N94Ikb$6DfjQZ>n0aa<wjq| zdjF|Px!tE#zDt~Q$xyQQqAaUr`OR`x*Y!A^ei;I;V7=f_DhqU8x4e%Q71NFa-LN(0 z6n#8(x0{(%&FW9Ak<Q!jatb>DmF#Dji`VmyuO#+*U9%mG0WzO?MFcr=w2#H3A6qm{ zOc)1oNnYCM@b*qwDRW<4zoG-Y<lxSkZ$8$G-48o<VKsYo^y{GaHODWxug~F!O6NcU zLU?8w%ie(OF|oQ1buR9tYcKEU8y^`6<8D8d`cY;2KCp(j&PXA_gU10esgOT#+SCf9 zUtJ8}@~Q@Im4EbM?hV<v+kNv-i7j5ZHr$-alYKtK1D31bVhe-3fP%|o@CTd2nj5Z- zmjUI=E!`XtNIA%Rah`+%q|NQeY*quHfPKoGp<#@kNhs@!uhU@gZm(q7Sex&hc})0g zUln7LGAm!e*~dU1ux-10+HAzYmIP#zqRyXbi;Sn~oWA4O5p(JvbB`-yy0BrQMdAHA zLXFG!2xJrXY|*)DQkx?KwVZSh`F6m=>y7QIf$dzAF<WX4m`=XEbV}cQ1y!8J`ul=S zX9vx6|MAuH*rr8r#7)<P$LcIo#d6hXxDvWF#I0`n4=9R3&O>G2ex254IsW%dw>ilE z3e3NhkKCLwcJ2F=<!}gq76VC33jR(S27gv7>2&oY$?)QMfIIT2azRESJMZuW+|ok` z+qlRCmHf4H(mQ~1#vVfE`^US1yfNFm)g9-`Bx&f_>GR5sP(;VJ-Rd~Tm>J{@a&Xt; ztiE?0$NT~ECSi&x?1BKv0N!P(t$0ZMrH<RFqlr6DE_k!Z*2rzO2;+DtSQgnZ8oIcB zor`o3FbznhVVn$Ek1}#NcFZTlZ)#1A!veP0;)v4tied_{k3%iaFW_7WEU9Lc2MPsT z3%hn40<wBmK~rr#6{%)MTBIJaI2ZE*{zHvAtyEtXOo?gONBx<zFcY$QIAkvr$yk8} zwGLk}FzwUx=e!g7#fS6=<{L(}nJ<v}`=chHW!J{nb*L{3S<|jD<g~*t)06Kw`vg+M z$6fo`WR}6UUZK;oWn`LUAWe-Uc`_zv@`n8}Dm~WxP$d03E<joXF7m5pc;jgQE-?u^ zdd(i<$5nAT<$#!5^L>0F#9W3?+r08Upc44eb6YF1FO$V9@fn4LWWjYKzZFxe-s;!X zFD12k&=6yW3$njI%q7*ijz2^MqNan@+O*6#ha?U}Q!Z4I?YiSxlmSpjo+GOCdOcFo zYzwi#i{2QkkKjt;244?o$x<F2?0PHZQ0LAos%s8QfiR>+eAUO*CqsDiRy6Y>GN8#- z5UWsNCmH*9Ue$Py;32`)2Awc(9922VuYS?<Nha{uZq9(P8j!7Nu(bYHaz837VHNN5 zUnUo)O>*LGRXb?va_oR<+1TOj4a-26CXR}QP0x$Iz7+7~*hivN3O9a`#ulO<frN#Z zFj%(sT3qT>=*&(IB$X>uV5+i}U4K8n<W>3n>UQ>4h+AKC$a-Ax)<eO~p0TYg&iEs> zo{W?z)ZbLj?Xr0}2(2}Zc6HU$6LI0_s`U?8SAt*wD4cFg-Z>tU+PBx_S~-@kzch36 z)o#y*;gG2n>#2y>qpq(X80-{`)ADP6=AEmroJsPJHQ#FzMIVoY)SHLo1I^6~wrdG0 zU`_Slk+K*<o<E-aGTGYIPiTZIWjTCb=QzWBph$dsq2%+&`y7LRvN*A;o9?`mxHv5k zEcYJ*w7SCdiq8{TK%qrbkoj=KSxg()8qyzNdX>q08p<)sdqevfrF&>v{QgYE&4{o- zb6<-up==NjW05GZ=_iUE0ZgIVJH&H(e%evC-<w6>74j-_srv662fVh{f8c*8Urd>l z_wqiOm>Ozb2n!Y)-r#<cZLNXnr`rxqwsGc0!QqBz>Nt3D>gpr6Z(m=_!~|J&EG={s ziW?$*sQ~86`;~Wx8vG)_LrsbeB@Q&Ef^4b*Y4vymdYc-SivF3M&}^|%u3|kHA!7~L zs!R;v3NkUf(!3RZt&~V$w4muUZdPAs$~YeWxe7JzxhwPvquBtF48(rmkYNVVkk{GY zi*^n$;tS+eG3*nl7Dyd6x28UL<XriuFSb}z*?aX%0jPP$=qucH-9J7A5Y6{N)?P1p z1_G+@8}j{rvx2N?$(Fjc5hy?P<8{5GM6kbKm$6;R)CIEzJxNxTEVwdGD-K2e&}W98 zC89ijWH)F?96D}RwouHZ`0f`iCMldG_IITwH5Zu+g1|ghVoU9oL-DI_&!n<BT9hk} zEX=AgbD@?;GTSmZYNp>xs%@L2DZ;Mv%ia*@&MX;lbqybhfn}P$Cu!7JO5W}Aj+FrB zxQwB5Lm$<;JJ-&9+-Ol-TkzuG?})q2OHM*A?b2it+abar4gG8txh5LsmGkpnx$Oo& z&Cub_QwqE1f7y>Ik#`hf70HMdn5T2aK1<(EPBx3oKK3f!X!3PY3;6jp3pMi1^N*oN zJGp$EqpAYCfVg(AHyFz9Eo`*>JA_<`W}_||j-_Fz_y|ZlLwT3AA|@I_XzH-rvoNg4 z%3_o(>iP**k>=w5w;eoaEphC?u*+((wjb7ity>PATvD?+bR>9>)q&YEW15H7nxzbc zbn=K>o4Qn<TsALKtOic07<6XZtK|zNT6y)$>NIDnP^ZuiVCS`~p7W$&(B8S1P3p^> z1iO}sn7=9nv#BoGpXOYWE8V>NplrwbrE;;bh>I6_)kqXIQV}Vx22eidQX}5*0zfmF zKp9gfWGZ)jy=&M(V8ivKZ&*+LQlWG&1s~vqRXwu({Snc)WJX;7TH3o=g}y<r+V?xo zU3@(!GQg4=of|w~uDbM+4Ye`fB4O<Pau3V#z;n;Tzq(aSyElggjUO6c-t$iH6b%`< zQbOQmarza`&6L+U$c~cDOApEz90i&_PfkV)e!J^AwmM-*y>Cy#pjUbhnISx9kbluY zWN$ui#e2AW`E&e1DtVfvz9+W>q^W=cxm~MBgWI|Cp-|J(<=C|#XUW_`Vr}~Dw}w9- zmc{*kTKzMeOT&O<^HiFE+PMSV5m;Ld1@358HR#d8KQ2lAaWWZo(DQoEY=E};S}hye zdvcUBRiyI@(izMQgL*RziAyo>d3%Qo<<(x_82#J6=$0HuUv>|L%C2CQ(1QKdE~WGN z^<bi5qwAuM>dI7X>gi5{9fvK+{y0D7XfYdzto-|Jc(b^rPa5dp+0Vb*J%5Eh#}0Kq zc@-O1KIU&|L_!)4k17PtCXQ(jSp?^22p=dp#Xx}2=+dCOcIE{rP}MHnBrGDEe2Alh z1UA@QuuthL2V`o{R2Zlr>X>xSlz@!|P`*FvG@9gm*A;(dfFLP6)PU(*nWLyx3s<j; z9#29#yMmJDz?RW~fB*}HI9i<65<I-T=9M!$O>>g*It_tCAV<vXPdU>W&9FjsO<Yie z5~ouDy`bn0sxao<d=)3miq_vJG`l<>|Bieh>L37`K{+U&7V(qgLDWSp8MO~RPJ^mP z&Z=Z7CbHV^)Y&_W;A=l_`jyDv!Yl_<^&0rA5CF&=kyBG)k}BnU?)4103@>hd%psgh zMzN~@3WBjKWtRRIv3j^4X#~x&%`#wH0|40ukU@V}-W=9UJA)KgqA9QQh7MlMev4Nu z`v|N})N<5-Sn}s9?>PnUDd4s!a>L$TJUi{t^KFB6_XykT<u0YW4lUDO8xEKgh|E}7 zV#&=iC-h0sDd;YpU-S80Mozd#Ntx*EZ0g|K!c;XoU3f%$yLE}f-TITfW0hM!L8BnB za>b6hM0AH4Y3YgmaGeX<Qi89Sj;(*uP+cXIOIF?OyDV#y^2#UL@eglLnyrmjOtr9r zWQJc{RX;7tTT4r8(318tY1tr4$(Tv;?7s<^g^rwqfLeeRrIJ=p9s}iqQ<bxn%?`=d z^^Lgg38jWI-fb}&l5jd}Yj!nLH%Znw@=IQyz%3GSZn+dn&|uVrJH5d9ru(f;PtJfI z*>s+6y!e;IHd?X{(#8F8dGMOuZh+kOSYkjdCk<5AH;R`(f6UUMW_Z;w?6-ZD(;Rx5 z(P<BrMbIF)4Odc=)bc3idHBBnr@ikEYN~zPj2#sf3y9Jb3(`fTH${=66oEh>bfgnn zDAG}i0#aU)-b4u{p$Z8QARq|5lmLRX&_RgQ2%(3v2NT}kezUvZ_uHAB*?+#wI0NR8 zob!~sT-SBq4~M5KcGcFd<C3)p)kX%0F3oSc7GhH2{a<`<zVK3W6J_gkJ$TQlPo}bN zKQ0DVK%aa2^^^BGd|qq|^UElIyg|c-3AG-iZ5%M`N_B1dgNpA@qpOc5snK@Paol!< zqn)>2aAr~g@ki`AU?{8k<@7$%guI}*@=TTa{n_m^*mi+Ryx|`t(edi0xWb;QU--q` z3Ip_)z{<(>0wOl-$o5!9cAb>m%J(9lfiFPTCF}EIYtDG2v%Ecg-(GLe^9s^ur}${r zFAfyomQn|!*u9o>1^4$`KF#;IX3`u9U#{-nj`|th?M+xWvD?O5BEE8QfH4w^n}4v+ z8W4n!Ne0v0tCAz2cj2q(OXJQNbZJ%E=%~>%b~E8R@E`iwg-1FiQ~p%LfJ*ZLL4!R7 zUkw=7Y^V_qm~(v-(R}{Bg~2q>-+wLP_czW#rUIJ*1O*=cJJ2%B&a}gT?570_#@%_i zKS!kW&PqM7C!F6LIox&-ia)Jfzw{<V)NlG%&4^5|Xkpp%&zLOUUtO3X7sZ$R`)NKG zUE1Nt%^|uotQ+}Ex_FO2702|zZYC)y>C1jmHRu6!f4%o|q^4~DePVQH%_2SzYu#Kk zak&O7;xm<wc@q)HL3b`njtRF~b80+8rr|eN4F$@7x3ZTE>_JobF0^AvX03L2=ft@k zv;9$;u{&JKM2%)Td;i0JD698o_uQI^1%mACpxoRkbvD_1tFJGrixY;2^QLXI)YVmk zeStUCMQje2NP4aON~>2)+Z{55*8IMlFD?h7e(1h*f=cu6lMl2g7tknB7w3P_MEpON zSp4T7M<c9E{D8bxoz4_o)%-^WF%?2)I|t%ZrQRMv1;As|PgNt)6+r5m)FgScWAH+a z@kRN5?BA2g0x|g25Qg4Hb+4VK_rHY-mZnw6Z7<*m4|VyLjKq;!)n$MwPz@gCdS&Im zz0$~`{%v(go9}0t4p#RJ&u%IZR^k9?JeL@<G1OIJMQ;pn-1nkZm#|@W_mh8Y5ZeS- z$;iyU(y-#@GzZl}o8Wb%mmElvN(KeEm+&0Fjb>nOdvrUQh5q`@^t4kRGZE?NM0<gg z9>)Q6&U!$kXR+^{H%nk0zr{nnw{U%y^qT98N82f+o3ikiag>#Y4ilfXkShgqp?&#4 zya1ic$zhEoY3+IpX*EgdNMTltnuP@g)8TBCL!E!oHpdSj5joS;f^t<V6IoS$<D#5! zAJA%ST{dZO<U<iucv?eR>QG;w$Vlm=M0^O=yC_`c@kMlQQXiki72<$yGcSs4seLk= zY}y`<<p78+s<$V!(DR=^p#|ISwXW#njjvBT&;l?Ey;M2D|0tFqt&=0o5*cf59+99# zk5@4TyL9yAO4z@xsS(21rZ}9DNUw>}Mnkw$Si@sq$MP(0nWIfV$;IF!@S1v;%@6}) ztbLiIm4x27M?FI&gyQ01Vg%w;#m`a1dZE=nV+!JV`|z>ZCwWvO^4mvCEHVdZs!T88 zWm{o2Yk0vtg6{7LneOYuwa+r1`ivxL7nS8czi#-!uZDOmxOo@gNPFB$KcqA}@c^CZ zGDgUYY@^P1P7*c2R>~H`zgWHFwUc0Ju!xCGM-lL-h~~Y$XQE;sk{)4Kr_D$wYTr}y zwSYSz9CNLQa~J~SGWzQrpKdSNGwLE#vT;8;<a2k7^A9Q58rgO8-v*Em4elSIrUa)= z2~*)zUY*Zhe@s2<(S8D;wy&5Uh+sbn?XWjX$rZZfJ<rfE=<dQr;sHs6jJKBUxkuZS zB-k01>qBJZu4dBk^1W~Cg35)IPYWk%HEG(e4d-%qM^B~8tBpFob|?r6cgiY0_U1ZH zOcuqHThh7J+WrcV^ki<Q6(<S$s`Xp*Jm5z2^BE4tXjcN`z=BGIR(W72ie}@&PXBPf z@7savuXD-B+&eC+%_80)!edw|dfcNVaY@DuQXWl$<gZ9&qSP+K<v?+?{DVy}<hEEG zTA1}MqpF=I<HK0_Di?%?nU?MLRPJxHEj{p2k(sp+L=j9&nuOvFa`Lk^id{@Bz&&le znci(~VUjCflqu)etK&JXhn07PGxiDQKvWaXo{m|2uY8SQjF;@Y!}g+gYjI}I>eS=z zS0g6DAWYTNltzx4<AvY&<y@Q8iPag<BE)T&bAN8KsN9D%i)L(HcBaVWl!e{<lqR%< z4hH<W%M+HYWmUS`SO^DyTFpM3n&CR7Kf7HL%3QG8_%VNFXyga_b1q3t`{m*{`q7S? zZ0sV-c@<b-o-&vZ$JYHAVYa??{d<Ut6{2URzp~G{W<@_gDPw2qF@31xGjy#%>eh~l zt>c>(o&n2lImON@%Q*KG-(tM2vZEe@wEpfo?k(j|Q6`ng2_RyGS#wI+h31i2UN+r) zMD!Vie6cN(tU^vIu708Sw86C!Z=RuHZ!<vI{@%1$%-s&N&RRD<^<MZl&rvl*$#_~H zdnp*WH+=4FB^c5Bmj%C|qMeO|q`I&3nZE3HC%#};^O9|`ZYJPMqp4wdZ4@dK)Bb!) z3%_YAY!ovjr8B+Sq!T0qmoB_t7%I`ene_IMlH|L=OMy7>(i~x9UNyEo6eYA`GoX^Q z;Q%$y=}A8&6@wlCtcXsN?KiK8*nBvD7mS0LRR4hfZ!a@Og0)_2tNxK5Re0%a9_C)* z3r-!&cKs`5bo&oZ<wwSvEYD25M`FJ)1;n;7nt{7_iwqp|t(qD%oK*8_d4hcqwE~{g zQ)FwIgtKnFI^XNy-w}sDy@)9LR*P~iAow7UD?Xh|0W@Zfvt_mjUNNgP*%P~l>_m1= z<45*^`gTR4I@}-gyIco*`deIX;{4Sazq)VvGTH90SZWqA*0f~_4d;QbuC^^vTt#%y zv5(Djdq2Q^BbDVp{LCw2sGD(qHsk4Q@l{>bOi3HthlKEhW0}|ZlEnL58MIdotfJ3W zB5jN%`A@EDddumkb~4rHFEhB#abl|Y(mNjOQToR91kz{NBSy{z+@cohgX9VrpdyOV z+NwEsCq<S<X5hr>Q?n}M*--xDVr@&gFGY>$=iiT}8@sO!_{hIsDG5QH95d_mbiAF+ zd#*h4*jwRYuHC8$pBTz*BCzUzx%Tw=1lHkagbxv|mA&l!EHZTX9}b56*m`!qa?3u8 zOzvXx{MR1c1}Kxn+=dtQ&}n*$_dKXm54D@OwC_F_(&iN=R!t0fwV-y)AeuJML^@Kn z@@9FCg(@TZ|F-{XOz*0~f9_3dfvRpUUK<hX7jM3B8}NLNRgPU<@T}Uq)uO8y{}d)v zOPA@umR=gmgtvq80;M<ca1T#fS%yM8oJA!VHrMU%9bOH1kW^}HF*fiUDR*3LN65ba zgJe|Rr7kdZN0^oL{M2=?iJhn8KOT#K!Ak~3=%vjap_P7ZNjtuf2fhfNYCv8fnFe#u zLtCUMx-|Afwq@B~ss?fBqK28%g|#0=yLw8O<Z%^r#{t$l>1@{osW%S2J*4e!L<o7Q zs!soMk^l51N^4Vmb^T+n2;qUD>2eR5nblBR39W)pnMl4EJWT0W*^cu_aw{RRfd4e& z$z)Q`R@IAq?6kxJuA*Hx4}-AWh7zK;pene6&{4rHKM)^{WR^6dFB4D)%dX-(EuBmG zUgl<A+B(y&@hU!u+0G21Epl9wtj}^JBQYdDj1dax<A!>*?`YbzW&Mz_nPG5-p}`(P zMG|r$K8PihrQYXI2;*AHgF7QucfhK;?02%xWIn?E7#U`6T5Z?dEa%2Jq?G-fuK}Ji zE(zYjYSjyigcrJxvcR%xW=fGzm$=}+yZIlOd-r6`18xFwU=XEmX7tQnkw=F1FFNLg zp$V+0EFScoXMSapjL~>*BX2)Imlkcsxx2Xi1!SkH7hYGIX)7>{bG8p5p%O<Q`}96Q zGFny?i^r3#kc2R>56a3WxLo9TO2=UOj}iO|u9++-=uPwthbO`u<%h^GM&iYUGNE^7 z_Slb`H&}MB9Wmja-4Bg{Ds>Pj`U3PJJL(j#T{i^%(p@*#aN7FD>!dFw!?%$qcUl^? zQxsF|9B=TXw4{mY%vIP<%^A-TV)MQ69fi6B@VVVe8!<fLTma%<@?IM1^M5V=4afqb zDLY_IM;ThH13E{sfk`#v69Fo5P{#fH{CLGoyi7Kz6Og)Il4n+uPi3e>GSoc=f^q$h zQq6T{fSogc>I?^FRB0Iv`MWS}DhbCRuf8RtMKV&x&jDHG`|6p9y%eRjT*%+*KVBMs zX;NlR-nRc3M?6w0MUA?Pewiti-3n1L7s@#;RLb&99>Gxe?s^Za%6dP8JhQ%SB@56` zaE7At6;di|6z|v3RoUT6y1C8D!?gSv-gf=up*LFN&}I`L`qjG1aRmESqF|6!UTLu} zy?Od|(b=)4QrsWmOp>WDPbO4G*Xc3-wpoATZV+<<toa387(5*Nx{k$s10!<$70ZOL zN)4}`NUIyvtTW-Lo83gp`yz*a_rucE>N5}@@}-fUzt40nAEUXj?T<uv^oSK^&aR@5 zGo@K9t`z^w-z<2dxCoXd@ok4WEY?FAY_RNhCj_Qk<Tc+`0b%p-44%6^0pFT%YlaI( zMg8)yWUDQq-5?W`J9AJ2FX0M=#Wwlnq8N>ox0AX+kaF`rfwewEv$Anj=-R0zgHqha zjx~15Y&NagSEa`)*=$u8L0tPriix&Wt$N|hS|)+<pATOr=yM0WBR0kIoQ$EoYm7@r zcyp0}{*!B*CtD|mND*MCo#Mj<UFc+<ZF^3fu~HfKS)tx6ws^T@`F%A&swYoYt~I$G z`DINNXa^`<gbKvfmDmO*btS@fmWE0-K|feJ<XHqN3&d6_;M|VVm%iM0St7t@zQrx} zMRo8Kt?j0B$~y&uY3RQAtzp7ONwk-x%YqX3e7Kwu<ERyE+b;t(uhQd!a3dv8E~}`( zQ;NYhdBDO$ZMCeIUjnT)j9vKnnWoxm&_31nWKKN3Kn(LjTE;JAq9aBp3}tr5)eEU& z|7eELzg4V#tB<3;LIlwpUCeKO!7RVf$q%YN056NfbDvCakE-EC`x=0mwuYHWF}Stu z4bqj4aOgFJTOoRZxV3@%JQW+QypafKx!<e%^yTO3#5a9&HeVVI-x&e%D^jbTO@#2- zVYYU9c7LDAoz2$__)uyn?fx*BOj5D>ER(%pd11LhG;wDs$@Q(c{>b}#tM5Wz#zAK! z5NnY;h--j>U2WQoKnyxI79T18l9x7%@#=x!HpxZa%{<&y3byzPRku;+F@SpQ@+=6x zQls@zO)_mSnE@K~941NZXMa4;W}^=2-<pawD#5$u$umQCNt)skT6fTHe+6Qb>bjV_ z@}u@xlg16cW@rZ+<r-RRTEqvXm@^if`1O*8N!(X18Dz(34mLEL{i2dFmeLVnYAFe< zycz75-wyD+3kEE_r+L9+hg_@1sGyF?U$IEMtt3bOd9x`fcZz<DBz#dK9iSJozDB8) zdF8$Mj+`+=b#{?0VNzE*W&tQZ+49tkrG~0EJ_+h{xRixTqt}}8pbHIROF!jxihlWv zC-_yeIkfR+fPRdh-)vsF>Y22rtc^BYX2c80-(g<|p7DzlZ(+9hW<nVq5b){u<Xubp z*?mJ1`LuvVWwfx=p?IPodp=bMQCA!Kg|e1)xYZMV@0j%oYBp^0{U-kfz$`(ex%f|d z+U9m4dwZFcR-2r1xk8jtljJQk$o=;z8BD18$l#|-2I!DrCFLA|eHQ)Z<m5|F#AHnu zGrXtB%GUeFcvSjCTAj^)-Hu*@Kl4fNl3M)+2i9%a%(VjP6~19B`;d}FkYpH@K&v(5 z1-q=qgMCFF(+8*!KgH_H+&0y8%sUFbNbF2T-kS@5*sXEn5%xXASv308u@jSh_|qC+ z#bUm1_@P*yH#3ujE<I{W+mJ;>JHUg(8q%~^$IPmQ0myaVbv)WP$+e$CU*VPLTL9VS z@ve@79~a;l(L~`LfgVfePnxSbDT+YvK?owCAdRTAREcA@zZL6k9$O%IECGJZRyZGw zu(LZuv^@QsS6X<u%Vmz9BE%Yq{SFzX>!c|FYCrKx9a-=+Wm~w#*robSMT*#ch)s}2 zKw6&fbqfIkky|<fr)EGc;#5A%I*hqLFVZSSrcmS-%v?*lWYOn3TP>WX*aCFQ)P9)2 z&Hrx|i~rJl{yUJ1wG=?lmi{!iI%Ityabxqn;|Ka^K{XZs|DYR_3ThK%6VZJFnV}BB zbTa2_4}hx_9!pN8f_niKA6{c&3#FPdGJ+dp-8HU$mdn9h=vw=$#1A#N$=`w&X}b=U zRqAFFN`1|8KK2dj)wm5|3e-gM44K3w<I_^jHD66!IU?tlqiSSB*x=sV4YR_YbF?el z!$at3I2E!uAM&?<UaAg~m|wFyQeU&pac^IM0|4scg3P#`Aa&#IpDcta-wS1OIKJ)m zi5YKy;#XtYvSV4@chmQpNkO66>+D`VQGTEE*MKU9-Slepl+wy$mR;1=LZAmyTQ-%a z9-wGt`3t}J_J5nh{8^t5SO~m%M?Ut@47dA-qi)#)dLVroduXk=9?Z}VKu^R0Ly-P~ zT3FZP4TAu>5>(1VgZB#j800sihmU;(AAAn_hD0`iV&x)_e7tq=e{01Ib?8)VJuu$Y zz&}88bqYjlHXVQg17#u64nPJ$fxKCCxzJ?@P!ei(uPQ(qG|Hv4a{abd58z;1C1Kg& z!9IZG#W&ReOxM{$BRZhGfKJN{;sJYudG%~$r|N70&rxeV>L`C)0CLY{AdzFJ!~7h= zs1cR`gIE@WI(6vaNq^BTRbg)yVX@uFR&B<^rPQKdP^XZYh2aHlL!eG*vGoN!-o3xl zn2jbNVxtL5T|WRszA+%Qs>1^8M;1^8B(!iBxWnc4^;@Qfr=OkpILS|1p|%5%)Upru zgwfBuCl9{2ErBh?l!gtlK%Zce*BeW=WSIh`KuOeANg&r!Z4(b8KmfB*!DsUq;Of+1 z^=MDdleZtyrAL5+LH9$ci}V`i+dKa2gIN9-(&+-8ee392SCC{94H%Vt+C?B|L6qqp zT%_$c$;Uv+)>$F|<9RPgJRnm$?t(fG0RXM{<bXGEz%ihgCcd|Z@6QrLoz)|{LLhwe zUJ!d=M=iJqeT)DmqI;skm9#(T^CJJC)}>`PGb@4U(bz8ikbXGz4nL{_7o%dtfJ;f} zCQv@L#1zztd#@88PcRPXEgiz`+e%O=*Mh(y{bVY1_g@0IMMIzV+f#uwg7+)L5DTRm zhQySv>iJh(`X;v{+-8@?69MUHug>1y-p(6r{fmTIEcvG)|J~$9PqTrT@fi#Cw3Ys5 z^Mz%V?le93$Gh6MfHsrBtJYu<5H(#NZX(zs(h{Xz>!wq^p(eM_pw~AhNjvz#`d6Y} z2rD<zX%5^NRwqIEQR>D@uGP+1N+G&u)U;2#@9RblOB>C7*X98u4b-*S<zIMU{yzx{ zs07IW6B7%lX%B1}h@f{ndG6%(ys$!XeZHSu_Tu>mNe5pN;0Q#6qJ6gH>11+=4iV{i zz}Dq`B`eEg`IjgnOA>5cG5CDJV{!Y?^41QJWGs_c;d#v~?7-Ifu4YgZd{C3YWWYl= zn>?=PyHp|zV79>9XWS9vI`}WUG9}vuFSgeAk>c6oN8QOZ)DL9xup!#vsUE}qIOM0N zvNP@<lp$glpgLV%S?j`!yyTDjr!)aC$lcuNf=k$2V2E<V5SgHE`K973L!C(#M*EeR zi3gKmLs(-!=Kes;NV%diq|ED(eylq^jSDD>?u`$21sLP)#|YxBagF`bIZ1Vg?q}q% z9(P1oL8y*(eM0lJm-$;po@0M4C24|9@$j^c{wDwvpR7eG;aQyfco*$Qv&kk8znRQH z%I`y!bl)G<0LW<7uB#<o=%uv4DPk_Ln12#7PuX`HbSOn!dH2xlEgYpi<&kG$RUA!1 z{wBX@o4Ovv(hUzIEAw=VHfR)U^C#feAyt;}U=P0FSUa;jq6w#@tyn8N-=hJkNi$`H zg`<a~<5He2-t$121v+g3o5isp&%l9<CM3F`rcTe}mW+_=;FrIx23OneX8$DC=SrN@ zVNTW_9cC^}RQA^coAH}per)fSSm16@`8LXt_uyGFR<ahQ3R?<a$`YJr6_qts_R2g? z6#w<Y#;Df#oQQBf<7;Pi>v%?jh12zKhl=x^LXTX2@;5uT1O97pX*^5-^UcO#ip96| z*3D^KW9Fdp4}T>b(PXy|9XTD(pRND)h*^)NiO#i*qhj{w-rX0rTS3<3_%X&NstqPy znOPxmS;VtlS(<1#oxW8_@|Ic}h{7asBRkq})0faem$->=jUi&W^><H=6s_ZiZ?x(f zhI5__2^PqtE)f)XppI+Kd+38?x#*4~vhC9;pr>}Y-8%efvkP$GoLcx=474KOVub9V z?6~$3UPwkdXj-+$v=4-TwDYJ-^MSQ?hPR_(jH6GsD}OL0REXFtm3&-`q!IlfUVh{Z zVYVv9K`GvhRNBv5086ZBbALB^7_;0z71UWo-*-FMkSjIXVQ3@S9A}(`Bkh^c3~7Ku zg(IV(T^3W)`QFr~LTF5Ta!D~|#w{|!@XdE8C)vf9P36%7jIUl8x0pD0u~r<AMvxC; zht#wih6m}#d%ryTtZ>58_k>FfA1|Gu-NB4KZ_$8}MAvg>E$w;#Mmk`c*aWTX%T1OX zTGl0=T3j=yg<t^+68t=M7!=l1sMQyVl~ChOWi&M$kaRKAxJ)dI^(Na^4zxe?ZYpGB znsbpgJtt%N&kp8Xvl$d@l+Bx+c2YqPS%Sr^p6ACxd2!E-BeahD2_mtHKirqf>7vyv zUuNAi@yZsl8p^Kjt9o5?g14rO?s=;%_Hz?XV14Q5xEi&L8R91K0yTU4jRZ`@aMz;{ zncS_mf$llk>T=gZV;eVm+ygiv6+Fy(=^=D5tT-Q2nQ$wol`;%=gI`&=M^4eyK9nWy z4oUHo^!tD=70YO_Uhm(f_db4)#<GGSIlz!Iyn+ngE3RzP>+=kH;P|?VZu@N5?|G*> zbiDIIPY|gxjVPMjkkW{syNTRl5682tZF#eOiVO+VLoy}GQ*%O)$vEc^Po`Lh82M7x zkcD?4fvNX0?IJ<~4HC<QEo#d9*30o}HqMJ`L4k&_YiK#&4~pYFy?5Rq)Pr5gOCzhR ztCG@xj?SoM0T27U$8B-^PKPi;R6XUeUu@?v{Fg}k4f%s?s3A!$0np+6X0Y}Jj#Jxz z$^28yeeR#w`N#p8x$=*tHUNtOpFXcY^9F@Xz8vLyW_qF7ONMG9i)=YRN~sy|_y}D+ zD-hnf=yRXdVA!H%f%)_J*vfU>3LS1)I0bm-&nJoYnIAA(M2YO6G+p4$?X&Ra^?|3{ zux}Zyz*u%A&Y6P6JOw&PTkS9Z99jt6A0$C^EObeoGqcsSvsHXe`UJSF+F#-cSd2ru zbL@^>z0O(Q?39vW-}d&c>d(kz6l5+?@AmT^)wFuO^IhmBxKr6hJMXI*W@#OIU@@sW zEajky3*;?b0Kq-<#OHC7QI(Ei1tR>)tHE%jL!=`XxH4HmDgH?P=M94=Zxd=-dwe$6 zQ_K63Cx@tQ5P{qJP)`?d8{=N3tQ|Ex2y3jE8PaP?>Kk%&x_|X-8e@94#HEO*YnJ`G z1wM)uDvQ^6meSCshEh+oI~OiBopWSPW;vLFHpBUhxWSv#PF7heSfqndLsZ9&2Q7V$ z+HP=mM$gO6BhK1xXcykbHDaK96efpB>K$B+y!#T?0~x>+my;f9gB*z7(__f;zK3mA zWz2J#LrwY2g~Q$gZ}j4y2fKG-P;D6m&b<kjJ6ErdhxdCp=qq8__He7L-_6K3dmYQz zKEr(q>5f$#q2}12TF&{#1Y*g&1=H6qo$or%W&OhW!<S*gextKT-JlItH++ZP$zY)< z);QRcmjJ&|>9$DuLRTOvY0lAvo??wO=O|m2hzxhS+pt+Fw5Ai}(VA0g7g)y1;}9iv zz3zu}JW6zE-a4vUgqRaq6~^G^IMm-p3#UPR@+{U7rvn^Z81pa7DRIk0M8j?zF2Zmw z1e(1&N9eE?7mqL(oJ;~bRo*Y~yn0B7rOM5aY29~Z)8R%Wdfhg#NG$)>=l2eR)5d9( zDo7OKt<01_ScN)VV!U$srN=JuVkG=DwaOg?f`hel5p?+ub2%`0Vqug{cvH80h8k~c zwfMT(eb)JSA}|4$ObLq#Etr^PoH@?!QLXm77~WpdiCx(0$a7DJkv)EWIL@cm-zHh% zcYGLwqdl6vgeGzWg}cUwVHZWp&QJ&s96$H_7f2bg+>RUXo=Jd1FQ<-<CTVe{_*ji% zS%(_@+*<P<BonK#9UZLySWyDj93plO)f=}Y&=c%&fzpL$3=~6ShIo*NpE@ErKgZsN zThf|(m=tjSwt1AEyru{ZS{orw?Ya#EBb5LRVD8wyy)o-&+=HJkpFI6zG1bGUlsw<Q z`6+?Cn4m>4pX{B<Vu-%-&v#naXIKPjk>*7%n;I7I47Og^-wd4$r(+oGO?)%8>#;;0 zKfJhZxjj*0*n`(A_85|aiF37WDuBftN5EjQN(BwEf?L+!1#t=M|F}mw;(4a2BBII2 zB(XLhnY_kswFEyKrKVW_^*LBf@q8rPlV7gv<3sMH-`d8z$r9>wcN#m$8`9GsCe{_u z<318om4Q`aBc<WMA3Q8=ZiD-PdsM|tWM(4IzcQlu8pBlkUeh9Tlk)^51`q5XzF+K= z=ig%=6;;zk8R>qRDiXleyqgr9ND<A1D!ok5B!n)Bac0`1y4HxkH75locRS3^SQcw( z<I&d*{Ng@;ce?8^vOtke{h<>xQ03w43(MU%lL2VW9z53!YR_gjRP6LlXu#rK`SjF# zKWw0no|KC$K{kiWCzlKdTb6;fQ&nQ6uN{D9gb|0GvxYqg)s6{{m0ZK%%F82}R%x!I zHtXC_yEuodb|Dn|rs_tW3Ad4%66ZO5sNgXR5Qx!M`SC;T`F~mKud_L`)8ae>BPZux zLc*d26rgxL-n9f;r60(|^po3!vUXLff*Z@ZchL?)G&5c+uK@92$ma(Cka;FyFB64S zx;~sjGdg)}0Fn2S?jYiL@SmCff73(!+n2pG`%`faN|-)Tv$wwHw>6r+{n-tgxksK7 z^V>uj*Q}En6I!aO(>1pmykxrU<~9sqYGhOzv6zk{DkLzyVALERPfg+=ipH5AWLGSS zlY)EGg?@X5JMDu0B#!Md^}ccEk&QtAZD_jxrvE4<o*U7j^FoEZ?6^1GvAZj09HqF~ zvbP%{xA|0#vdH1fg>Wr8MNa%2CFZxQE4w|nw{W7SOjP}Y=GM6yN@30RW|`vXQ|^<q z4zysU_xV{P*=0*2(Zg>}cZRf`zsh5|)hkw5)8@|$__c1vg!UnAw-`T<m9jk(RdynJ zZ<B~xDIx8C=O`Gj+}fqoY@Z&bEXF7E-c8>0T%L2xHxC|@r}l~lK@=r&D3v38AQY`6 zBQN#4Q#90gHy-Jr-E*ku3vFp&w?fzAL3#IR97us*N+94raFb__6ot_)(Z71;M0$gf zo7_ssA&3Gslru^7eIJNz(g*AI;NS4xJp(#u=VE7fpVcQxbL&3AMD|I#wi_9e&So-2 z14`W1omFNi;9==TrUZ^ASznIAS_9B8TI^s41O5^~k3V$D`P#n%FU{{gV|f<PL#q?$ z9kCYQ;6tpOyHVt2Z)!-HPuFoHS2F@9+0*h-=~KX%HJyj-{3=F&eP^|&ybFAJDsVyV z=XlzKm|u7Wb~v_Kk91%M2M<__Tl1du|3TIU(EzKl=b<{$o;8?ll7GSMbW_xwqSotE zic$HW7)%b(A4MzR9)SSG1+uC;IRH0_AC&j2YR@qATcn$l&7Ga5@B&2@iVMx=f5eiY zu_a*W<W#wRSs5)k8n{TN>zB1u{L8aW$JArh%{nA0J%?7PeZWD|Ue9gTCO0yHvA?(= z)CWF0E9*N?V*BVw9q)ihy2ajme<Nq76`w1we?Rr?#MpBh>?M7{^BityR#^A+6Xuf- zqHv~5e@az*jlp6Su~r3HlsjwFM?O-IBLxMBT=rhvxk*wLyLxtB^+XXTZJ*BxzHv<l zqAL#1J`jplT~pME#5Ru`6y#7c*6EA%(_a2*CIp(xMJ7jSsce$Rff=c@I}YKeQZu05 zzBk;6s3-Mb)vL_|dOlNAUlY}ckRt&2p+h|!3^0Pf4)O(%*Fn@C!2S>RO2f_n50^<7 z|0ya54gDP5p{#eyZC+-XL#y=_?oj|wFiP?jfUo@Q8{OTG@~3Ri5TrF!X5#%9FBk6R z&rZjTa0wgxPwx57A-5(+WsS3~RBAS+({VM2yI(TUM&a2iaMHxCGO)LI`Wy>-<b5g7 zzI4O~9OPAQTThIf_ui<_=I-8xQv`eN>Wu9(^Mc*U%QZ_}o8-dYUy1tZ`HlB=27y+T zeL!TpZ|;H9qGzb>L4hCty%71oxNIzxcD|hh;7D{-Y;GW2MSyUbk9jDaYRo|F(MShT zEtSfp0Uk@gM9r2%gc%^<F|57FmIVaODnxEXYSV_;MN<o-H!*s><;djfm+Awr0%8Pc z#T{d>06(FiG6N1$fTrq|9U5r`yrDwQHy_wzh^O@A7KZ59)bX39egsK_fYe9vf$nix zVncRbZ_D*ARL(E6-DN3p)a;Xu#%kKMnlvaV>4rF*;6|JSmWSGsXPl<j)vtzg;`$c% z{Ocqa@$A$-Oht7_?7(7>D+SofFNWSJ);}D{cF3k%Q=90Ae8&}^NfH4596ZW<z9ZQ% zGTHlR6l~)qN@A2qIJvwvh4%C7aBd;uuyaQ4r;RGb{ut5iY2Ji`R7+<t+|2z%j6Al> zTD-q-cG}h8;{`?&Z=uB}#7dvt@37YiNQZ*SCbGe>*ffQeJ(ZCxcNOl#bvUz3-@DN# zjrf4OT~6S2)>=vo^Ewi~&9@fPYChkD9xO5Nep)HPjJNX}JUwa1>i)XlXZs%Vc43Q% z?P%+#K8Ln#cPVqCzuJVOg&9K|o<_3<FfuY~SRi`7=Lx4?=t_+km@7cDEwIK{mkm1{ zRUVdzB}>d5S2ZPtFnw4Mc8uCw%(Bath`6?}Dqdz-lA}SXV(ALrP7yRWbodgD4&ST} zgE!`P7|jQkyCoB+VYGxBVrWtBBKbxyO`)=J{vHqBeL^cFz|*l(PyUnVz+4+w*?apz zIn2T>Emm)K;(U|Hf<(;gFZqzB?g_p1@MstT-EHu=XAo#f{JJ>aV(|M(l3AQ5-gm*w z&*GR-L7KPd)w3hvz6^t#)qZCwE5oT&?g><cZLvjoqnY2eAl<9Ntq~B6v@|f@oQE?n zJ;Y1bebqBiU|6w~{f=ECbGBjU+bhJm6#DPyPW;XsOu9#Sidnefk!>LL+~JXa>6>Tg zdkx!*nud(dzn)@349hGoSBgi3VUqdG7Fudz1HZf%);DAaf^5c)>ML^|=1+m6fN7W; z`<pMevzz6<&A^(md43C1{0)hXS@fA$zqc)M72a+!|1kb`sk=R!>$%5vonMyc)i}S| z5-WtvdGRiWO^dM0rlV41cJuRgeeI5Bl|AAkkrD;@cZ3fpB-C8$-34~S-C1e*B;}Us zg{)v>^8MVy`98bKaM_yccd*QtRU)tKwY#8==6f*UAU7$kM&8keQi-aPj<IrL^7w#5 zrTfBm0TRGCrbcv^s#>?C^rZeZZFKPLwRh&v&iK3B(glmP8bx~^f8WYlS*kUEsGJdY z-O*N8GRmX)Z{i>y!E3~o-GgRIfmQVoZ*lZG6g+IN*xJZ4wHAI6iN<6f^8*jl87^Kc zbOVb~&iBF|qrNB0mnM%iq(WWVo2TA+ckuJl8~*eCFfIjfw=-C*!@)Yf|G0F;&cs*1 zT?WR5=d2LYE=(ZWcWp|J-i1->m0L&-$h+R1oDg4jQ^TY$0t=P>*m1)Z^!lK}_eOH6 z%<qJBN64RE-5`h|u&r~fUnQc3jiy?#$`>PL8VJaO$%&!viPFiFeGZHnV_;&EGNA&d zp3}%1Sc5)0+oen5)s<cxbpqP|v&85>ZLCbd$PIB0i`OJfHlEVnk)i1VKqjkGJo&ok zQ|zChhZMM!2H$Gr(YLA*bP^?gqh>9|co6OYn#2gZJZPKiaM$&&`K=zC=bN!aH|?V? z-U=EXfAO}n*N^HKn7sqpIo5G=EgAahdY^Ynd;F_HuPWRoHtclwCbXG6cxNw;b9>lf zbb$|?_Krr42QUK8Q~>z+Buy{9AT#LF6|Oh86`x1wda;|A_Tf^TcAkH~2S=*iK}%%l zlWaqHO3?SNo?W{!Mp%&5owr)A%JCUW>zrOTYmqW4b*ZTyrt{z$zSrTLRejMjnYN{V zgMK;zvB&)5fP1<3_;tUqWqwGDJUL@@!VfU$YPSs6w}`;tj*0TVf0SEJDi?wWl#n6F z8Ohr?6eP;(xpJQy<D4gI{jR!DO}0>tGij9v=S|QdID3-}jg6tAf1K6J07>s2!zT=4 zB@`pMcFslvkLRB2SuPHYfrahf)n1uj=Z0tqA?V|Yg9P~BjQXnq$gd2Ud<M057YNHH ziVMG1$><dV?V0yqI)*`TAatny(50+mQ-e&#f9TRtnX$dknld_dK1^ue=ubV`egrrs z@UF*wR_SDyc6Sw<&pz!F15Fj(UO%s)eL2o|u{Bnw1ED>tQtlT20SeLeSjmIw`mn`O zH*P=wD~Co5(dP3q-^8xk#nfZ+S$NKzYm&C2%umXu>$<^pdhnUoNU5Gb$x@`r`}+gS z`Xe<rDCOJ%5dZAW`6pA+i$LI5UbF>wV|=B*sjN^dDv}pY>X_IT`^4$U)o9-_o<<8M zYBeA8HegQK?+GkiB!ZjW2A#7~{gaF1G(z1I2QA~$S>HaXjU(;2bg=?XFC65+>&y1L z`aH>wOTO1&)gyhjNm20NL@UTA(M+i%3l41mWtbR2z^GwW;#$kY@B5xz$(S_Y&iqgt z!_uTV-+_^{Yy*xJ^>qgpm>SoR#|^)cyje@&z~Fat%j=s%3(Rvq2B0gHCUk6&XG*yB z=0Id>`jqwa!t1*HjYD!B>rrm39yO?h?uS9nf=%z-z&&{7;-;~$pQd-1sZI1iASMBQ z9?bZ_%)52Fb^F#=ozB}Soc3PNd+^T0D*OZ`e}b%^;t$b&XV{ox^hCU`niRfa&(t(X z!btIR4t6f&$3-s<6%vXB&pI}c=NmgtkCOQ7>fMLSxKiL(7nHI?LY8*sGz5{q%WoWv zJ3Y+A-T960jOb^VxxkH5uz|M(U3kDu;3t*&92qfvISkmv`+WOCY5sLBm5v*(lB^~E zgHMP!VyeVc%a`n>VYPQ9JtudJ8pWq7)F;<-DGmG&Di<#XeuY*gyYq`WibrwNTrwzb zT=rGFXLifnowZ6k)GvWgw<eP>HqQH(4H`i)!)@1%OPhzn;VmC$KS2$3hHgap0~mi5 zfCw`KcvdxW&~l!o%$Po=a3Cr!!5lTn^t0Fdu$uD~V}AIq9gP|U@pVUdcSkr6o~kO- zb}M<VUAUlX)7PKxlq}lUDr9Q1zAl=Q@?)0l)BG@gwv6$ht7e?dzyf>a7S4ahWlf9t z>CCZsU*p?Fe;PUi4Sncg=z(uL-<fXlj1rt|v-{zT`2cp)pGdw$uu8jhRv<q~KtC9> zo~%9Y!Ls0eX=^y}0PeU#Sc`>LFis_4{vzKOpl=)h5&oge^z2*<<+67}YMUoJmvhGg z5CDFl3@bQ^<^qlA9-}&XpUhXUbNY2qcJMcH?CP7m(YJhQNCT+04uG5iszSg#y_8jh zjejhScwT8i0kXO!3?P~fJD3|LUcjnS&<=#5V=XuP_aUa=AL?rX#FUd&`km8aRYDWz zPv^b9AZK!kObtl}g&p9T_K%l2aq__8w07yZEVv<Y)0}T!aU%kmQLxqWzj&uVy>{T5 zF4EIZgejVM-0g@iU<A8T6z*(r?#dWGI5v9o@{&)-w03j94lz~049_03UQk%bLAm<J z0D+z|j1QscTGRkb<LBAu%rBIUZcbS-EdA1E+7Ax$AQ|Y+_qj_5*kfCLtu`E_klQX( zBU9z%K@d6X0jx_uLTbHWd??7fbm0+s$!Y=aBt~=OCN`g76M9E=NI`CS1)P~rpJ$Z4 zT|-3CL^`0_uE(ncHSHHuObJao{;MZvm}sdNh!2PuIy6;?OQx%--zo{`yYNvoPXOvX zz*vEw{uhY-zsMgBkof<;j5_cCP!s<>Apboepno%#`PXGd_S}fQa~#NW)^_2Eh5Zp! NR#1CfAaC;ee*kz~kShQH literal 46261 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 Iz$Nm30F(WRBme*a From a3a8ca58fb86cc736b03c850658dfe47d8755904 Mon Sep 17 00:00:00 2001 From: RosinTalia <talia@sqreamtech.com> Date: Sun, 11 Dec 2022 10:14:18 +0200 Subject: [PATCH 314/882] RN --- connecting_to_sqream/client_drivers/index.rst | 6 ++-- releases/2022.1.7.rst | 29 +++++++++---------- releases/2022.1_index.rst | 1 + 3 files changed, 17 insertions(+), 19 deletions(-) diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index 3cdcc54b7..58791e766 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -1,8 +1,8 @@ .. _client_drivers: -************************************ -Client Drivers for 2022.1.6 -************************************ +************** +Client Drivers +************** The guides on this page describe how to use the Sqream DB client drivers and client applications with SQream. diff --git a/releases/2022.1.7.rst b/releases/2022.1.7.rst index f879b41a1..96fcff0b4 100644 --- a/releases/2022.1.7.rst +++ b/releases/2022.1.7.rst @@ -12,11 +12,11 @@ The 2022.1.7 release notes were released on 11/xx/2022 and describe the followin New Features ---------- - * Inserting data from a JSON file. + * Ingesting data from JSON files. :: - * ZLIB compression type performance enhancements. + * ZLIB compression performance enhancements. :: @@ -28,20 +28,17 @@ Known Issues Version 2022.1.7 resolved Issues --------- -+--------------------------------+--------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+================================+============================================================================================+ -| SQ-12228 | Executing ``CREATE AS SELECT`` with ``UNION`` and ``GROUP BY`` fails. | -+--------------------------------+--------------------------------------------------------------------------------------------+ -| SQ-12178 | SQreamNet does not support the ``ExecuteNonQuery`` ADO.NET command. | -+--------------------------------+--------------------------------------------------------------------------------------------+ -| SQ-11811 | Missing metadata optimization when joining ``TEXT`` columns. | -+--------------------------------+--------------------------------------------------------------------------------------------+ -| SQ-11772 | ``JOIN`` query performance issue. | -+--------------------------------+--------------------------------------------------------------------------------------------+ -| SQ-11523 | ``SAVED QUERY`` execution internal error. | -+--------------------------------+--------------------------------------------------------------------------------------------+ - ++------------------+-----------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++==================+=======================================================================+ +| SQ-11523 | ``SAVED QUERY`` execution internal error | ++------------------+-----------------------------------------------------------------------+ +| SQ-11772 | ``JOIN`` query performance issue | ++------------------+-----------------------------------------------------------------------+ +| SQ-11811 | Missing metadata optimization when joining ``TEXT`` columns | ++------------------+-----------------------------------------------------------------------+ +| SQ-12178 | SQreamNet does not support the ``ExecuteNonQuery`` ADO.NET command | ++------------------+-----------------------------------------------------------------------+ Configuration Changes -------- diff --git a/releases/2022.1_index.rst b/releases/2022.1_index.rst index 1e2c0d256..e63294405 100644 --- a/releases/2022.1_index.rst +++ b/releases/2022.1_index.rst @@ -13,6 +13,7 @@ The 2022.1 Release Notes describe the following releases: :maxdepth: 1 :glob: + 2022.1.7 2022.1.6 2022.1.5 2022.1.4 From 2808cdd25dc86ec8ac483553799d6ccc0ef8e6f6 Mon Sep 17 00:00:00 2001 From: RosinTalia <talia@sqreamtech.com> Date: Sun, 11 Dec 2022 11:43:44 +0200 Subject: [PATCH 315/882] Update index.rst --- .../client_drivers/python/index.rst | 153 ++---------------- 1 file changed, 16 insertions(+), 137 deletions(-) diff --git a/connecting_to_sqream/client_drivers/python/index.rst b/connecting_to_sqream/client_drivers/python/index.rst index e03df343d..7f8baac93 100644 --- a/connecting_to_sqream/client_drivers/python/index.rst +++ b/connecting_to_sqream/client_drivers/python/index.rst @@ -41,10 +41,6 @@ The connector requires Python 3.6.5 or newer. To verify your version of Python: Python 3.7.3 -.. note:: If both Python 2.x and 3.x are installed, you can run ``python3`` and ``pip3`` instead of ``python`` and ``pip`` respectively for the rest of this guide - -.. warning:: If you're running on an older version, ``pip`` will fetch an older version of ``pysqream``, with version <3.0.0. This version is currently not supported. - PIP ^^^^^^^^^^^^ The Python connector is installed via ``pip``, the Python package manager and installer. @@ -53,7 +49,7 @@ We recommend upgrading to the latest version of ``pip`` before installing. To ve .. code-block:: console - $ python -m pip install --upgrade pip + $ python3 -m pip install --upgrade pip Collecting pip Downloading https://files.pythonhosted.org/packages/00/b6/9cfa56b4081ad13874b0c6f96af8ce16cfbc1cb06bedf8e9164ce5551ec1/pip-19.3.1-py2.py3-none-any.whl (1.4MB) |████████████████████████████████| 1.4MB 1.6MB/s @@ -91,9 +87,9 @@ Install the connector with ``pip``: .. code-block:: console - $ pip install pysqream pysqream-sqlalchemy + $ pip3 install pysqream pysqream-sqlalchemy -``pip`` will automatically install all necessary libraries and modules. +``pip3`` will automatically install all necessary libraries and modules. Upgrading an Existing Installation -------------------------------------- @@ -101,7 +97,7 @@ The Python drivers are updated periodically. To upgrade an existing pysqream ins .. code-block:: console - $ pip install pysqream pysqream-sqlalchemy -U + $ pip3 install pysqream pysqream-sqlalchemy -U Validating Your Installation ----------------------------- @@ -109,9 +105,9 @@ This section describes how to validate your installation. **To validate your installation**: -1. Create a file called ``test.py``, containing the following: +1. Create a file called ``sample.py``, containing the following: -.. literalinclude:: test.py +.. literalinclude:: sample.py :language: python :caption: pysqream Validation Script :linenos: @@ -120,11 +116,11 @@ This section describes how to validate your installation. :: -3. Run the test file to verify that you can connect to SQream: +3. Run the sample file to verify that you can connect to SQream: .. code-block:: console - $ python test.py + $ python sample.py Version: v2020.1 If the validation was successful, you can build an application using the SQream Python connector. If you receive a connection error, verify the following: @@ -199,57 +195,6 @@ This section includes the following examples: :local: :depth: 1 -Describing Your Connection ---------------------------------------- -This example shows how to describe the connection. - -**Describing your connection**: - -1. Import the package and create a connection: - - .. code-block:: python - - # Import pysqream package - - import pysqream - - """ - Connection parameters include: - * IP/Hostname - * Port - * database name - * username - * password - * Connect through load balancer, or direct to worker (Default: false - direct to worker) - * use SSL connection (default: false) - * Optional service queue (default: 'sqream') - """ - - # Create a connection object - - con = pysqream.connect(host='127.0.0.1', port=3108, database='raviga' - , username='rhendricks', password='Tr0ub4dor&3' - , clustered=True) - -2. Run a query and fetch the results: - - .. code-block:: python - - cur = con.cursor() # Create a new cursor - # Prepare and execute a query - cur.execute('select show_version()') - - result = cur.fetchall() # `fetchall` gets the entire data set - - print (f"Version: {result[0][0]}") - - The SQream version should be output, such as ``v2020.1``. - -3. Close the connection: - - .. code-block:: python - - con.close() Using the Cursor -------------------------------------------- @@ -298,6 +243,9 @@ To fetch all rows at once, use :py:meth:`~Connection.fetchall`: # To get all rows at once, use `fetchall` remaining_rows = cur.fetchall() + cur.close() + + # Close the connection when done con.close() @@ -360,13 +308,13 @@ This example shows how to load 10,000 rows of dummy data to an instance of SQrea con = pysqream.connect(host='127.0.0.1', port=3108, database='master' , username='rhendricks', password='Tr0ub4dor&3' , clustered=True) - + , cur = con.cursor() 2. Create a table for loading: .. code-block:: python create = 'create or replace table perf (b bool, t tinyint, sm smallint, i int, bi bigint, f real, d double, s varchar(12), ss text, dt date, dtt datetime)' - con.execute(create) + cur.execute(create) 3. Load your data into table using the ``INSERT`` command. @@ -384,7 +332,6 @@ This example shows how to load 10,000 rows of dummy data to an instance of SQrea .. code-block:: python - cur = con.cursor() insert = 'insert into perf values (?,?,?,?,?,?,?,?,?,?,?)' start = time() cur.executemany(insert, [data] * row_count) @@ -396,11 +343,7 @@ This example shows how to load 10,000 rows of dummy data to an instance of SQrea cur.close() -7. Verify that the data was inserted correctly. - - :: - -8. Get a new cursor: +7. Verify that the data was inserted correctly: .. code-block:: python @@ -409,83 +352,19 @@ This example shows how to load 10,000 rows of dummy data to an instance of SQrea result = cur.fetchall() # `fetchall` collects the entire data set print (f"Count of inserted rows: {result[0][0]}") -9. Close the cursor: +8. Close the cursor: .. code-block:: python cur.close() -10. Close the connection: +9. Close the connection: .. code-block:: python con.close() -Reading Data from a CSV File for Loading into a Table ----------------------------------------------------------- -This example shows how to write a helper function to create an :ref:`insert` statement, by reading an existing table's metadata. - -**To read data from a CSV file for loading into a table:** - -1. Run the following: - .. code-block:: python - - import pysqream - import datetime - - def insert_from_csv(cur, table_name, csv_filename, field_delimiter = ',', null_markers = []): - """ -2. Ask SQream for some table information. - - This is important for determining the number of columns, and helps create a matching ``INSERT`` statement: - - .. code-block:: python - - """ - - column_info = cur.execute(f"SELECT * FROM {table_name} LIMIT 0").description - - - def parse_datetime(v): - try: - return datetime.datetime.strptime(row[i], '%Y-%m-%d %H:%M:%S.%f') - except ValueError: - try: - return datetime.datetime.strptime(row[i], '%Y-%m-%d %H:%M:%S') - except ValueError: - return datetime.datetime.strptime(row[i], '%Y-%m-%d') - -3. Create enough placeholders (`?`) for the ``INSERT`` query string: - - - .. code-block:: python - - qstring = ','.join(['?'] * len(column_info)) - insert_statement = f"insert into {table_name} values ({qstring})" - -4. Open the CSV file: - - .. code-block:: python - - with open(csv_filename, mode='r') as csv_file: - csv_reader = csv.reader(csv_file, delimiter=field_delimiter) - -5. Execute the ``INSERT`` statement with the CSV data: - - .. code-block:: python - - cur.executemany(insert_statement, [row for row in csv_reader]) - - - con = pysqream.connect(host='127.0.0.1', port=3108, database='master' - , username='rhendricks', password='Tr0ub4dor&3' - , clustered=True) - - cur = con.cursor() - insert_from_csv(cur, 'nba', 'nba.csv', field_delimiter = ',', null_markers = []) - - con.close() Using SQLAlchemy ORM to Create and Populate Tables ----------------------------------------------------------------------- From 425857f22622386806126a086a9176a532fdd57b Mon Sep 17 00:00:00 2001 From: RosinTalia <talia@sqreamtech.com> Date: Sun, 11 Dec 2022 12:11:15 +0200 Subject: [PATCH 316/882] SELECT encryption disclaimer --- reference/sql/sql_statements/ddl_commands/create_table_as.rst | 2 ++ reference/sql/sql_statements/dml_commands/insert.rst | 3 +++ 2 files changed, 5 insertions(+) diff --git a/reference/sql/sql_statements/ddl_commands/create_table_as.rst b/reference/sql/sql_statements/ddl_commands/create_table_as.rst index c0d941f21..7ffd565df 100644 --- a/reference/sql/sql_statements/ddl_commands/create_table_as.rst +++ b/reference/sql/sql_statements/ddl_commands/create_table_as.rst @@ -64,6 +64,8 @@ This section includes the following examples: :local: :depth: 1 +.. warning:: The ``SELECT`` statement decrypts information by default. When executing ``CREATE TABLE AS SELECT``, encrypted information will appear as clear text in the newly created table. + Creating a Copy of a Foreign Table or View --------------------------------------------------------------------------- diff --git a/reference/sql/sql_statements/dml_commands/insert.rst b/reference/sql/sql_statements/dml_commands/insert.rst index 2607669bd..4005b471e 100644 --- a/reference/sql/sql_statements/dml_commands/insert.rst +++ b/reference/sql/sql_statements/dml_commands/insert.rst @@ -113,6 +113,9 @@ For example, SELECT name, weight FROM all_animals WHERE region = 'Australia'; + +.. warning:: The ``SELECT`` statement decrypts information by default. When executing ``INSERT INTO TABLE AS SELECT``, encrypted information will appear as clear text in the newly created table. + Inserting data with positional placeholders --------------------------------------------- From 2a973fb02512c359565686fb0a1e0102b0b59509 Mon Sep 17 00:00:00 2001 From: RosinTalia <talia@sqreamtech.com> Date: Sun, 11 Dec 2022 14:11:01 +0200 Subject: [PATCH 317/882] rocksdb --- architecture/filesystem_and_filesystem_usage.rst | 4 ++-- architecture/internals_architecture.rst | 2 +- operational_guides/logging.rst | 4 ++-- reference/cli/upgrade_storage.rst | 6 +++--- troubleshooting/log_related_issues.rst | 4 ++-- 5 files changed, 10 insertions(+), 10 deletions(-) diff --git a/architecture/filesystem_and_filesystem_usage.rst b/architecture/filesystem_and_filesystem_usage.rst index c4e2e1d80..4830271e4 100644 --- a/architecture/filesystem_and_filesystem_usage.rst +++ b/architecture/filesystem_and_filesystem_usage.rst @@ -63,10 +63,10 @@ Each column directory will contain extents, which are collections of chunks. .. figure:: /_static/images/chunks_and_extents.png -``metadata`` or ``leveldb`` +``metadata`` or ``rocksdb`` ---------------------------- -SQream DB's metadata is an embedded key-value store, based on LevelDB. LevelDB helps SQream DB ensure efficient storage for keys, handle atomic writes, snapshots, durability, and automatic recovery. +SQream DB's metadata is an embedded key-value store, based on RocksDB. RocksDB helps SQream DB ensure efficient storage for keys, handle atomic writes, snapshots, durability, and automatic recovery. The metadata is where all database objects are stored, including roles, permissions, database and table structures, chunk mappings, and more. diff --git a/architecture/internals_architecture.rst b/architecture/internals_architecture.rst index f25dfeb22..571b5f9a0 100644 --- a/architecture/internals_architecture.rst +++ b/architecture/internals_architecture.rst @@ -45,7 +45,7 @@ The storage is split into the :ref:`metadata layer<metadata_system>` and an appe Metadata layer ^^^^^^^^^^^^^^^^^^^^^^ -The metadata layer uses LevelDB, and uses LevelDB's snapshot and write atomic features as part of the transaction system. +The metadata layer uses RocksDB, and uses RocksDB's snapshot and write atomic features as part of the transaction system. The metadata layer, together with the append-only bulk data layer help ensure consistency. diff --git a/operational_guides/logging.rst b/operational_guides/logging.rst index 8d76b4a1a..03950784d 100644 --- a/operational_guides/logging.rst +++ b/operational_guides/logging.rst @@ -416,8 +416,8 @@ Finding Fatal Errors .. code-block:: psql t=> SELECT message FROM logs WHERE message_type_id=1010; - Internal Runtime Error,open cluster metadata database:IO error: lock /home/rhendricks/sqream_storage/leveldb/LOCK: Resource temporarily unavailable - Internal Runtime Error,open cluster metadata database:IO error: lock /home/rhendricks/sqream_storage/leveldb/LOCK: Resource temporarily unavailable + Internal Runtime Error,open cluster metadata database:IO error: lock /home/rhendricks/sqream_storage/rocksdb/LOCK: Resource temporarily unavailable + Internal Runtime Error,open cluster metadata database:IO error: lock /home/rhendricks/sqream_storage/rocksdb/LOCK: Resource temporarily unavailable Mismatch in storage version, upgrade is needed,Storage version: 25, Server version is: 26 Mismatch in storage version, upgrade is needed,Storage version: 25, Server version is: 26 Internal Runtime Error,open cluster metadata database:IO error: lock /home/rhendricks/sqream_storage/LOCK: Resource temporarily unavailable diff --git a/reference/cli/upgrade_storage.rst b/reference/cli/upgrade_storage.rst index c95ef25f3..867df3e03 100644 --- a/reference/cli/upgrade_storage.rst +++ b/reference/cli/upgrade_storage.rst @@ -51,7 +51,7 @@ Results and error codes - ``no need to upgrade`` - Storage doesn't need an upgrade * - Failure: can't read storage - - ``levelDB is in use by another application`` + - ``RocksDB is in use by another application`` - Check permissions, and ensure no SQream DB workers or :ref:`metadata_server <metadata_server_cli_reference>` are running when performing this operation. @@ -64,7 +64,7 @@ Upgrade SQream DB's storage cluster .. code-block:: console $ ./upgrade_storage /home/rhendricks/raviga_database - get_leveldb_version path{/home/rhendricks/raviga_database} + get_rocksdb_version path{/home/rhendricks/raviga_database} current storage version 23 upgrade_v24 upgrade_storage to 24 @@ -75,7 +75,7 @@ Upgrade SQream DB's storage cluster upgrade_v26 upgrade_storage to 26 upgrade_storage to 26 - Done - validate_leveldb + validate_rocksdb storage has been upgraded successfully to version 26 This message confirms that the cluster has already been upgraded correctly. diff --git a/troubleshooting/log_related_issues.rst b/troubleshooting/log_related_issues.rst index 12623c943..a259bff35 100644 --- a/troubleshooting/log_related_issues.rst +++ b/troubleshooting/log_related_issues.rst @@ -81,8 +81,8 @@ Finding Fatal Errors .. code-block:: psql t=> SELECT message FROM logs WHERE message_type_id=1010; - Internal Runtime Error,open cluster metadata database:IO error: lock /home/rhendricks/sqream_storage/leveldb/LOCK: Resource temporarily unavailable - Internal Runtime Error,open cluster metadata database:IO error: lock /home/rhendricks/sqream_storage/leveldb/LOCK: Resource temporarily unavailable + Internal Runtime Error,open cluster metadata database:IO error: lock /home/rhendricks/sqream_storage/rocksdb/LOCK: Resource temporarily unavailable + Internal Runtime Error,open cluster metadata database:IO error: lock /home/rhendricks/sqream_storage/rocksdb/LOCK: Resource temporarily unavailable Mismatch in storage version, upgrade is needed,Storage version: 25, Server version is: 26 Mismatch in storage version, upgrade is needed,Storage version: 25, Server version is: 26 Internal Runtime Error,open cluster metadata database:IO error: lock /home/rhendricks/sqream_storage/LOCK: Resource temporarily unavailable From 269cc1949ca9cdf35b9dcf90924fbf6913e4b79d Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 11 Dec 2022 16:25:42 +0200 Subject: [PATCH 318/882] Update 2022.1.7.rst --- releases/2022.1.7.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/2022.1.7.rst b/releases/2022.1.7.rst index 96fcff0b4..fa81f914f 100644 --- a/releases/2022.1.7.rst +++ b/releases/2022.1.7.rst @@ -33,7 +33,7 @@ Version 2022.1.7 resolved Issues +==================+=======================================================================+ | SQ-11523 | ``SAVED QUERY`` execution internal error | +------------------+-----------------------------------------------------------------------+ -| SQ-11772 | ``JOIN`` query performance issue | +| | ``JOIN`` query performance issue | +------------------+-----------------------------------------------------------------------+ | SQ-11811 | Missing metadata optimization when joining ``TEXT`` columns | +------------------+-----------------------------------------------------------------------+ From f44b95091daf1b1de65a39822b3a8e0cb3cf5ea0 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Mon, 12 Dec 2022 10:34:31 +0200 Subject: [PATCH 319/882] c & e updates --- _static/images/chunks_and_extents.png | Bin 70037 -> 75831 bytes .../filesystem_and_filesystem_usage.rst | 2 +- 2 files changed, 1 insertion(+), 1 deletion(-) diff --git a/_static/images/chunks_and_extents.png b/_static/images/chunks_and_extents.png index 8b3cc8d0523a62b8c4b841ecb92d8bce58c8f8d9..972b624e3ecd1e3455df5deca1854a10ada4cadf 100644 GIT binary patch delta 60180 zcmce;cTg1F*Dl(a5hE&5f|8Sf5{Ib5kR&5WMsgYuVL)PICL=ixX~<EsfPfN2KnI4L zkt7);XE=NCeZTvw`+arKKj)sVqROf1>E3(w3eS4h(?(!VmA9YzC?N(H<F@uY7t010 z%Nx?aFMMk@j(=9KVE$eg=Wl29`sC)jN)Dg1`6pxONhOQy8!q@c%M@~7dvld&+|ubr zA-Nff_&a@_!rjStN$%99mw9uIA{v&6h^{?(#d0CqEL3S=d3dp0=Rhd|o|>I-%vO4g znR62!4c3@j%3fO)ZJRYYg7=O@r(MSxF!c?c;fcFVwxx{Gj&^XCUOz3Pg)KW$!T6?S z3U(>Ps8*~dS2LgMe$1uoGtGruY{bdi?z;DKcTPZ(hBH&q(nq6_EfKH1Dj!8OpYEj3 z-@quQU+HAXb}ZG%x7|=TOh=b2UO<d<;zWKGOjq`m&YaoPFI+`!=@#F(c_D$K%cfX- zB1;5<{9XnjAm~F?v+v5Hc!jBN=r)ywgS#h-3K!e&FpI(0QeD+-d$j9&<~r+!^YPnP zf9QIo*l5+6uc&UmwnM!}JEpuzHDovgdB4QBhDD1rot!dU3;QB|Q}oSpS4B%Om9l~? zTVX1{fxtUr?g^Qz_PO_dsyYRkCwg=uSiBfL)G9W2@80mFDPtQYv(9LpNj(W&$TkS0 zkf4Qo(@8d_as&gXiAIyF91{G`Kv1P=rcPeRCIlr-?9coj_&#Nxp<?TDglM{$A%Tbv z_o&}zi{R)6TS>ley{cAGbogW5@W3$GWAT7|Q_|si@p=v2;pS1_(Ynpy>S{kx7QR({ zyNh(|kj35+cHZZ&R*4_7-7ZgbI69=0fCcGGUHko8FI6TUC<h;I8hWjCgEMF^1Q`Tq zBW|3%h>-Aqr5M)l=wPs4xtrBnEbb7~e^Id3#JZ`6ocr?<oX}iLs=qEVvaKWN<1i6R zp6~uAuomu>JbhcDa{Nft!?c<1(BrwWhvDVxEP}g(Z@14&(njx+LeLMAL<%cmSh!>9 z5FMnDLIOcu>&8DivV<(#H+Gw;id-Ow9+H!~uW^A`PYZ&69sdaWd(2!y%>DCE2=cy@ zguV1%pJq<{_ph8D0mpkZzgYl`m8OxO%jpJOqFs3%7UYGW9I-}l*i;xm(DgxCJT<t^ zq%!f@>7jaD1v>4y+5BX~_7Xi&p$phTc0||!FEh(Gy4j{yO?Is^;c1QcGT^gIx-B-S z@ZufKHnobBtq#P`SUYt%f$J;p<vGOZ!~#d$;&U8|BZ5OvSt)?d^7l3b86ECCv5GpX z-TwlE>)$v2SZ4CEM5!bTJkx5faA}9t%3p3nIYkjI5yN5ECUoP(Xd!3@cIqO6y!Cc2 zC5Y9Wlx_Bx@fe?Y3Ma&E7!*%m2v%j+(kzX&oGXfmjLuRIxX8Bgxpz6PN8GwIPkVsL zIk0Z4+o2p!H<9FMSHApXP@P>%phNpC1WPWjVpO+wPb_U>oEnU{ZP?EEmyWv1Pql>G z&o649A1lBM7}8eJ25&psFrSpMpn;&q`mQMOYy`z)3R_v|_>5gm5}6&{Vi4_@8Vqp3 zq@$gd+42&8A`7y^vxa9qPbeg^$?;8Hldd`_bKkE4PTjP9Uue)HtE{uX^Xdw`J)aaD z!ngM&AIZWQ!LhX))FoUP3%l846WZ4>=!?OpA?OSV4I11~dC<cmn3SB0$!AsP8dqCs zcM+{kLXV^R*_p><t-;?DR#Bs@6^{0~4CpGl(_Rtio*n$i)x;V1hUJIj=OFKq>xV}P zLZv1Q!#-c{Uf`Kaqp-E$JOfuf!lWD)b3NU^&aIoJ=i1lQEMW8XrdQ9axYs6y=3u+0 z>yEce{x#MD7d(l(dwSx|Xhq4e@(woj4Oy4OuZ*h$G=sRA**kk)Re6`k6Ss@lZZ8VC zdm5Xuk9`(75JriGKGtr%p7TD>Jw@q``#7pfF=A4r6M<wX^mG@67kY)XwJc&=E*{Ru zyKT>6oCgtXHK<2<m=a9`j`>31-nc&)1hof?O8QGR;E=UPo90I_Tta3Ce0ts_=Vbmp z-e`<V)$%7b+vL&#flaFmWt~l520d<i7_eCJyiG@cV^T`XDqB~NvEOW(Yu$i|Aj!2C zDIj7d&HU-$W=|eH@7kB>uj)qf&-%Lj@a|qe`N(ajjU@_-XJ7A!EAM$euir8Kt^*Hk zhkqDz72Gq)T^}^%3Ue%A{8+a!(X(qJZrc<atU6NjGtbfPVTXWtNJi14G^etDcgL26 zF!UxR!)GFBhHDdE8wog>R`<d}`3i|J-NQGX`qN~u;YQrvvnvI;0W?(w#vhITgduKR zGvOJ%pAmBb=N@}!>Irr9^P7<O_;H9&Hii=CiK5I%<_cE171X5E&+Xvbb6zc?svh6Z z_*H)>MCITaGdg`2&UI6NFyPAV&s07a*<5|s&)uKyE3KWoV>|8Itfb1OTSutW*xt%& zFJc9*RN)4NAs<6w+oB9tw=^l9^|+aQ>7&v&qqDEqMsDuq78vu4?q~|0S+hA3SdiK{ znZ-%V@cRUmM1P!+2ur#cc7@paz490cSB&^hN=P$D7%6q3Re0HU>JOsYbRAUOuP1TW zf;MEIjcf}Sg*PLEmIK73DU_sz6Lny#JwBV)sbM5xNUPpcAS)L9V&m^MzWMQ9^qs-< zuOp8OigUUtIGv-1$6T+8&zDnhD)-RNM<0?x-o}4z!i7SWxQ*}e#aR}acC;8RhHbBK zhTI4eC=guzY!_qfTe#NqXl4EzP5iX#uxrp~yD7v8$a~3Z%C~Y`91{S4t?NrMIIAJ? z&FGOjF$C!#Wq{9r*A={WqdJl?W;p{#6_{ziuAzrIx?qzDym5q-?gL-qdFt0Y=-CC| z`{OJilk)Xso`fLR!Z+VNI0xt~rbnprF{JPgTH^VbNQGMO6;Q5hrX5isY8B55?Dw)# z@l#7vcj?Zxd=`ERUvuZq!dMftrdOYWk_5Mp!hFA;SfhD;+Gcw3V*1*TlPhE(1ixM* zBmi#tFSdUQlyoT-3>G%!NHOlMAbH~c?1QK%PDHXTziDDP{JaJ5LSWC!sSMM~a&^=d z-D$Ht!*VnKBUhK#L3|u*Wnc|oNabq+1<npOXxHVy6AX<CQ!Tqni6#m9;!gR9l4nQB zFSEPaLt@^lXT-bDrJWX2iQSLSLu|#798PVqko~9;Vnv5CS;!b}jTgOEa7$vX5U!j& zqW%yIp+tU}B<(!u44_!JG5@Nvs^q1bBCW)N=?^s3s^Px5YQp>Z8xk}PpH{lQH^1e+ zL!JBn9!#E~{~U>4vyr_NnppE`;aB2CwYNS6-b?>DJW}39rx7h2%o>DLj%v9ve_?2% zHkedR{`|4C@j4bLpI_W)PQ6%jPk|T{=U6i!^17kV-XkXds6t&`5=DZvYsw0<bFap1 zR3xUznGF@-DwBTT=or|VE#xwll(XOs)bvo$r9_jFi!?Di6CKJ&^<yuyJF|-K8SeE; zOKcC+UN9K9A5Wn}xTs#f&S<E7^n3%R&XfubNYLIq+LYw=wkzJ2T~QtuO1jZt#DBSW z$JSkbzl)Qa56#n-afO^4v9%sWXSia&iZHk=ED9h3zVKnUVZN7F()hRH`V80t<48C2 zGG%h{k3`L;jRZ|DyRhKoJ7%{e3d!Vl)w2-vJUOU>-nTgKBr#?GTo~j0E0*smjPI1M zEABWJ_$#`u%bvZaMU8Q+@-R+|)LStdj@S~u_Gss7uN950T;1LG^Pu>x17o4YXVE<3 zYU1{wpvEBvbRg&gt$Q{K&O2;dYCr03Fq#&bG5Lsby`ZwDJl}0D`@J}6!q9UZ{<-!7 zxSrv|ZtDnUP>U-5C|fVCG!4))``KnEZI=YNNmylnD_I;KlHTJ-Pq?nt&G^<B@okKh zOk^lt?Kh6G%}!yXCc>0>R<8*llx-`SqBJ9O_g4hACm5Yqcgo<Qi9vS&GG65SGJr@D zm&p8WAo0iCq|YIoEVyBmL?Y)JL+Opz-6HnYjxP7kDEQURb>H$&Eedam(67NNq1+$m zGy%wX@ctOz=FqE7j$_a>+~Sm5AC<q)T2<xgJ%AuL^>)0Yfd!2lb?+sRH?Rb_G<l~- zyGi{C?8&<6#E5Z%pmidI$F4FcDian$zha3X6_t8Du=NjuN7sjcdJPAOlJzu+uBpo` zZqVd8br3=AXZMf#2M^YLownEC4~rYr1lXK`Bzae)K>qmWXg@7Vc!K{NPDF$<{?8#v ze*ADD`0wZc@w@*UU%~$_<p0La{)c=0vwsNsAHMs?RR6zzMY#X}5#tB6&j4&^2>fzG zj}xM}3BqjeQ@o@-$o=Gq>5(61MBXnq!vMgo*E3EMyzn^Z@f{FOGq7CRb7{GhL5$;E z(%!x4A$yEtn?osNM4#(`tNtdur9K^xSfGuMr#K>xB8xVxF|iAStNWXDoKjAHG3p%c zBj1JB=sNv_M3UTR2t`ONLnA-aaY-q$!ShG$=E{4}Xe9vD-^}8_ZeM$d8RZq`J*1DK zn&BM1?~<{cgoTT5LgzC<Pq4xpeaPK@MC7vSBFJ;}_geMJDA!uLewh?9==`_KU43IV zo+9cdCop3o-)}e$O9=CNN&LJ3og3#lw1<9E61+Q!1sH(FOQZadweRa=BJXkb2o9HB zsgQ&}6=8;_=_S&hPu-WW`O2IS3qf!8J9{p}yV{ptR9=c^IR^LntMEC|--#(z7&ZX0 zmm;#FY1bt3SyWGzw7GOt0OJi>DM6A{5|(q$#ymz|$01bt&81^;4ZA_neGw80UVif8 zp6~4>F+zmKj%Cz!jn2kd3MCc4voZwfMS3oEuX(aTs96h=ygizgl#vH-?GVvIv6G1b zNnw|u4>5-K4uxwUo%X(zLP!!$Zv*Ex=fR~uw7A^4xoMLQS-wg{ZaN#^fh3Ffb-u=d zJ|WIZG|BPUUTgUp`Id75ijQ1~!Fh+HFN(z|Pth0eb<4^8I1O3iF^5N_5X}Puz=+oJ z8n`QV)nSj&|2US2L-Zu0%}E)roOw<&e+YzQm+HV~J^3i1q#K7vR}^1XB%C>gcumN0 zJflnN^BrQy){|g=*QA4av#GxaWY7cn@uK~5^oe$&V?(-5BzmjV`7~w{L3tfVx5`&E zXg)N%osl7e2Byv`fE?9+>-fAKxTIM^v1wfa@{ZiL3akB@X_r)^R<UZX_!xPQ2ztIs z(P?-BbN_hB%5nSQln_+%dN#`YTbJtAwE<%2Ls;S;4VrdJh7u02smoq|MRApwCmRe< z?>0G4=K85dN6~7(`)OJGz)-INP6>qTE`8a#KJPSjL^RHI{nQFf=J#9pQ2*>dn=|Cg z-pc@?^M1OxF`^;Q;Ny1W+<3^~yQ7Wm8y3B}@#0(AOePljIzQhweWB`yzhA6<@w`$a zKj1O<%{@$xCLIOh?iw1w$75uxA*gJ9QXl#G?d{tm4~P!lZ2W$SJH`}0qBhoqvvnCN z+N#}V#o&5e^;FkJ0Xm}x{1xadX1B^TeHy2Dp^H5qbde?wO|nH->4dL&ok(+lyO*es zo`ARUe@IxC%qIoUG>9Y7Cx@j!zkR?k^5CmwJ1R?Wtmq_-<X>~qz_Ci|wh6k`<J1pL zNJe@05(EPu9W};9aE{-`eps)9=iZg#;rRx`BW}9|8wuCe@q+z{gvZNnqY@YB5W9yv zUUfIV_dDjQpLIIBLiXqUI2R;Y_0H-(@B!tXy{x;4bie^+-_iNgbgzJ8SZHJTa$x+B z8<!lzm(J=W_Xk_=maYzSR9aZlt@EanovieJK_V;j8TjF8LZBLnqiy+SbL`;lwIdDv zqCd;Z9{ca`CPzCk!_!l#?bXTdQd@pYl*1w=H-K-BbJ0^1Zh!CC&pnqPA1&z{I%c$a z?aq*oRvB#$+y8oXf^x<HFNSqzseBJXnXg}vSkeOQN>4(dBP0#|kr{U=Dz#xKv0}Vi z?@<zQrA5jl{#7y@M>%^Dl70C3bV<+)5~%&$aTc+co)_B=8D<Rh?&%7Z0r!dJ*MK00 z23^TLpK=J=I1c<>wJg1gkCm2R1(k+21VWLLaZZ<K4LZcq-2FFCK|)~7S`E68H{Y?N z*Erd2_}RzTEb(J=LrzRS+zMS{8`kAxgP|{1?TIQFMovJC$%K$!$AEO{HIp{$a`UL` z%pKYf48!V`<xau)d`QI>EWqN5JrOki*ACM|IZ-3`*1p0bYWm_WjVGU{y321xF7XcB zfcyeqkjz{l*zD%<jtW3t<ge$Bf6=;b_&J8;tdsW=*RV-tFKlTDu`-WyB^47kmV8wQ z<nZ;dxzqmk!sr7VeFJQjOoHnOm&dA0X<}P`%@@qTiyhZN&Yk^W?D9tc5BK~99e*yb z^=UhNg2mvS)^>b<ror>2&>O1N<TnxH?_ikEZF#*kih0Qbh5mh!ykhP=vhVWkVcp_o zx7WJs^)Ou1D7;mXQhpY?eszUxg$&^jp2C&m<hLG`oGhZ0XE^8_5&>zuwOvy!V$9!- zQ5E#utDKqg2yG-~wjz$$3DwdL_bxK+!=Dw9_GKu2PqWwPTN_(kjjI|DYO-!-UIa9( z<n#=!?snI*9fQLu=(O}_5HdjolT#qzWAC6uh<eV>=4h5bHf2%_XOzP-`i8PoEqaVE zQJ+~QZy=S#1@~MUElvy!m1`{zlv#Xb+%6`tU(i(W>-kAZ-mCUgz}+?o59Y#O_aRha zLb}MmLq}s%`a_^-&=PS=(IOS!LbaG@6=WM;Ov<(q$~0iW0Aodx)tkx?T-zDsDT(My z?rn3~0;<%kFRurkl5wy^Fb~^QP6Li>%VCx%Nyw*sK<4vXPQs&lM@Yu)%02P!-Jy|T z$h(`rUJh)@2UyDA(%qXVsp6Br&8B^KH_!0L4yV_JYEFDgYG)xPVxVlSl9@%qc{u)R zXDseJE)Q-SpD&z=-Uz}Vo6gBt&iBbV9r947pNfcRX0=L<nxivRX11DRzW~-jk`Sj; zKXux>?$(I>{m*Yd1HXm-I#*k+aOXF^NAhlOe6J`LhlhVqU6n0hlxJ-WV?m^ca?8-V z8Lm5i%9rza^Ww$fc3JFh7QQgdvY|5cF%D))w9Si3-4(ot2@TbpzN0-BdDLVt<IB3( zX1P4xUS0O*%PmqFNJX?km)NJgoft$EM7i|xE`UuxNSMq6koTK<&otMi%c|XGdUVIi zsWfoT?s2t=t}$yW<A+fB&6v$BK`Ol_FNg7h-vNg`tajBIj3M|ow|?>WwQFBlZ^3WJ zv+n4YM7LgoEYA=eFczc&=$9`ru8M46x_~_PfNx-6vsWu_Bx~5pZ;nR9%G6mXFFX`U zRhS?x)G|bh6bMw$=<&V}Qz5*p-zl7hEN`szwEC2*Tn6dKn}y(Cx87o_<C0a!o_4U^ zq#Vw74ieiN5#%32GJK7IZHpK~n9}R`b>fv}`vt(Z@@|jZ2CfMO;tAOOJVU&j9JVkl zUGVNosiNC(QB}?0GqLbS!vvom(Za>`#}e=7llm%If9B?a-x&Fn6MRGRFCKWCeD&v; z4x{{shHFyt(VW%OzQQ&kB@FQiY<lWx-C0QwI?D@Se*;{i#ZK8u7wU0=dAgsqnHZ?C z&^Q-J9Z>ttV`Aa$-L>Q*>fyb4){vAaQmL`)vazqeBLz8LcC~0Ij8!rS=;$=j9rSQp zFHeU=<9Q>5)K(RydbBXhlTG;wLz^HR{lv>lHG{-IvSlX@d?B^uUK|WnPy>wfb#j<s zb3k|m9UCf{H4FPjF8XF+s=q-bU&l1dQcZGN<DoL@^XEv4qS>JEH|KlViDhET=eIqV zbGv2alAkfU>U|>fV`^Lw>yAjh3PG0S|6Y+0ASy!gbC1Nlbi+UUvdD90IZh^Tl|~Gy zK4-UrnQX>=bDUweF~@!T5d)EyqBaj$=@qLfLj_l1+H4G`wlhd$Ll;2vN#3AKa69_A zWb0CSb-)1!0Wx_n-cf`Qm!)p`AYq%h&GRRUR%{ID`R7bF|5*-3`i5yDoqDmU0Za}E z2ahE6$OX5Kz(uz?b$~8JEKS!_z^_J*YT=>;l2h@@4q=XVhQ)<o?L07WbNh7{u|o0> z5`WE~VXBltilAy9Zm9$)2YUSmq)3RKQr!?d@qZ5e<C_1^hxXHilJoEJ|MeBm0~mV} z@=l>fAgD_v(T$e)xD;+qknHUyW2Uk5{8eLUnkqZQdxPg7cT000<Q4#kE!?1M`7K4P zt!F%6otisi5rR$z9@|=$<Pwd8g80!yW@i(rOys#}*S3fXmXOGiHK}l0q1E=iGbt6_ zcGeQ5z3YqfDO=xYMXxZykH>NPMYrcvS{a&)K*COOd_N^rR@|}aFhM4<yEYRWQ=G&7 z>>eGv%rd5CQ_W@lr6P*v=#_3Q<v|VR)84xw5V(>B^dr{61BxpV#+cNyqP}_HcmCsH z_mf6rrjAwy@mh|n?dZ}M*C6lvQUqwkdXtHNU9C=5?y~y>xFsQp3i$5O%HBxKe3-hk zt%yafx|l{H51Z*SW*S(5vExUWR#`W1noatf2wc|W$e+TPAhF@H?bd5}w3?bM#tFv~ zwEAH{2{0O0#`89_X#G6-RM@iC@W$uoPtly3>wEko?TIpPqUUAk3;l8Lf89@vn0f9E z{+uZmmhwheuJc8dS#4!yrF3L2e>`dLv|NDQ)Tm;&A}e#fM<}5KI?b_4N-tAKPgaKu z1q6?jvGD*B88M#ck#$c=nS^Xi&clCeU8J5b3p~qXka^t?=`3>81b@DUR90dmGFDcr zK&YQ@%+Nfa;fyHva45;!#0v=A?c0H~s1=3oBE(UqLTRaZCto+isZLg>>5K@`LqYrC z8pF+)<=#+gMD1oUix3s2NnA@LbBHP#qY;U$Tgx_4MCDX+uvtvW+Z3m!2F%%^EE(48 zvl!49Xa?sBobiPVRzg+gJpyCP_h0DOZ{l~H3<hyKsv}R``}iHaxNb}r*uXl&8sAbU z?p<Vtj6PhkpQ5wpzxPY7sb_ODRi7f~3AHZex(2qz2p#LW9GB9kxTkx79!Y(v<}5bX zXsA6QHa}FVeRhHB-J-EWcsEDZL2-jSz%NwCnD6P#WtfR5Tr@N49Pu@JtK;qKIQP0> z6C)aYkbZlneh8yF*y>XK@?x~S)Ql&ppy;jK<@wLV844wDH#QPNZ?p#Ekb?v2M!SgB zU#;kiVe0aFnR<x#xU_>#oQW^5h;mi<O}v6xhk{&GiGV*#(zv?xw~Rmy(r?Jc!A?7C za*PZXn4`>zQ*4Yyo~&`6EP-S9aE4=ake3sGt(MtZOR)*g+UlGmi<A%*2Z8<S1;^0~ z1&6RaEpq2)%yNGI>%|d`I1@9Kxa>RZ_FW@epY>R}`{#^S27OHgyV8@p%B<CCG7R>+ z?LJ#LM3v@rD+~^n%peRYEcpGlKy%N33_a`4$?W}ZCM6kDSC!Z3%bbYHA68SiR9#}P zu=qnBW_|Js+3e5bTI@0S!ua;XL2GL{k+QPRiV{rdb$Ro?!$?znnY`)Di!oQd59=y% z4PnQHQ<x!TFl|#cCbu}pAnvV(U};=wvSOZ<@|1Q5d;D{CwAye<Th~N+cc@?)PHv#n z#@Z%AZZV@kfF^45vdp*l8tH$0Um|NS57@!oyTj8obRaY(KS#iy)7mVY4Jf;nr`vbJ z(#OkKNG2RqyYQb-qAPvuVQ8m*w-@+<y8ASo`5o7sdsH(n2^DTWJIoTo$RuVN1m<hY zF3(c2BmMF-YTvO(;R>RHuq;qsb*?@d_w0N(as^EBs?DQ0K-%<UURDa({%-3DU%Yl@ zWo_2NT^Z|%I-mJxjVI=++N;~5n+xxHr41K-`3Fa9%JJWw<6|yI*kH3ZI@Xam7R?84 z5^YMApOC1?63>n{frF4xgRyX=JZ>hf&2}BVSbRAmj@<$~8nvzC{IiRzbp^~{WEymL zzUc~>r3Pi-_~L%wGo21@lFs&r(H|SL?0S@*o=uAAKiwHU*lCRj#ua!j&I-5}DK)iQ zWZM+480b+f`{rx)8SDz*JV$2DJaQ6B8ay5$U4M5_XwOi+W;*ZQw`(Q;z>+J>O^#i` zTH_iipZtS9J|*q+d0!USj!<#(nt6^aGh(aQq|e$X8c8MdO0;z<!sg%{Db-Kn{<BiU z<Exoq`g-8=BFAwh67kEnMMkVNa$Q4Tr-JiN3%gf9X5i(Y!~F?PIa<9tK3h%)DWl~{ zV!s){TIjj|`dK^OssNP`YJf(|LO#LGmg?bRj_TlU<&O%>fn?2oH_ozjS=x@4&e=<h zx&=sF%}O`ER}>z6WK-YRFS};v6oek%0>#x!@^g3pi`Il}^|RXhY(;LN314iY@)N~S z6c)<sQ#8w%z|yCJ6JijwdOR3RQn96qH%r{{8jm%hn$1Dq;Y<5KayS#r@?hNe=Hj$R z-2>mVx}BUg`hCf!>de}=IlM%fXzQ%}2c9++vc0c^wS)rISu(wJ9yXj-XW{QO-{_NF zeX%!7p(E3H8l9-@+I0~uN&0w6JzastTV1!v&QGL>cJ-V;1c-e(Y|gruFF5-90GGj8 zT{@LQGr{rWr4a@uNh)2csaX!3_nm%!^-oECN6PMIXc!@>a-v~p5tU6#?T{xG3^N(6 z7mIg>i@O=houH8!d?$Ba;fj?AwOPLD+jO3yw_D1K)t}3P-iKa#Dm;+3W;t0J(TQkX zkQ0nZ>sMX0%B_ARG?muPq7Y|xmFdl<0c~kidQ1_bZ-A}R%c}DMTE1uWY-tsO2P@T^ z%pi(73sF!s=wbrPHO$4*%2tPAK{%tHV~){%y(80rBS>7pLQ*|JxodXc`RAQa8*!zG zEY9rd3I$E6saB2=^{VVkh=d@s`El*{jPrORXqV==+j(Yty$E<Ajhs9MD?X`>tI*i@ zO5RD*{I5^vZG;j<Rf1oBtp<4ISW7T|KXFhN#YA5hM6Ph9e;Sbwd-XUtd7%5=U_Y0_ zPlB9hJwUfG>N;JBm=-=SEKX&B%5%)TShs1}Wv*?NnAV!;6J$p7COZljqBWjJsXdqe ze3tFR9;O3b*1!ldsP~JU;+4qK7_kV;F4|2-tfGjW@*00JQlG(Ea9;A_SxfDq>E{7k zx%%DsY(#gux*_cOGH$02t(tKQ_`WUBeLN=urL_qREIe@)Gz1b=M@$Ql^1Rg>vC0WU zZYaCP(vVsKE;X?Mr9qp(($qIWNOqg^^ntgP-2GaELil0_$m)~_CGr?D`nU4pt<boE zr{N{~9el`*pop}eMUg-A)7E^e&9~Z$^!E?kn&4J7LF(pF|4x3c{*6@X!HupAf}&wv z(!qO;&_x~|MQoH@dM4heh^z4Y`OTm~x0=r0ETl_Gdm`F=v~42x?X)v`ya~CeQ?Os{ z^Md363HM%eC)$}f?qDnh>V*A~zD!KaRDs{~T>@AgR9Rd@BA;1q9w4WF#P-P!!1?{D zvXKI<Zu^|QMVLyaYQyCh+H;Y;PFPS!?~dm!?3GsPN3K}}n#6ia1l#n?4E?<6Pk9~~ z3nWr7`1t4eA@Sc;AOC#y{}O~yBm>VO93RR<EE0m@|Ady%3rb~z#-ffAftc4ET8Xau z)nkv#s`M%|RTDG0Oe<tRYFAi9z^D7S0c=eu+{P!$@V0cgC-@k&F74VaiZwo6?BI>_ zZQ?ZV(88L$k;qW>=;K(4Y`IbZdZ`)v<8jD&>E^(x!Eaa`Vp?Po&gMX33*_rqpAve5 zG=b(<4`osse9Fo_tD0L-8(^t3r~PY1uQtkoX35b)%TUE1yK1aFZ|2){eKadfMaj_J zYSDAC)@Zq4I4dx!w<Wp^E@;pt+k3kK_IU6Y7*os{>8|e3^(y{mT}ehMc`Z~nv_)jj zYKEqh!-zBB9#pFD;|*fR)o9SS;!Ze<_i>*0TedaQj2}_=ARt~}CN;fivu|&e=r=*; zr#L2m-tzA6Veyu;*IY(bTw0jWGi)zY@!cz1aWSj1gWLmawu=@tZK015L8KC6?qlL} ztR*2Gn+bWdDT}3v>0(81!paKSKGb=_Xxcz}t>LL5CXST0desSerRD|q(d!Y-p$`U> zraRp=ms1a<r#fA8MG>_vl*~~Y1~%$8<YLvCQVE!eq18rw4dSdX8wBktQyk44y@*Tb zICH;oBGG)}B(;W_^7LC?eGko3^E~mO6;Ra+5ztR<G+TM8<5nBP#(aY$>yj0`@?kE! zPrlG{f9Pr46TP%HPUdclP18h_$%^);0vwI=ow=cGn4))pAK^7Bf<<vDX>ewu&`Wsx zgWG7>X7Jgl8*lo+tpN4MEFAR!nd`)Lxo2MmaN>B5&KgjXG5J9L%9HW?a;Ft?`@*BF zu!Rp-@PlK#5h{3}#S$yne_UOgT{Yz({EJGc)E@WVkFDXZ(kL9|FpU?T^N5w<v`j%2 zeHQj^pSyDnzPdJu^eKCBnJP_5Ad_!N;9`MPG?RKA%Z>W21<|pt6lZZ%Mnk|zZ!Eu? z@`k!d7OqG29I%bTHte;2fY+)i7y2@us5ySJk#WN~=~+^6St%UdWSqi?C@?0E;0X9> zo5;ChC{&%^sMte^UO1{`^D7KZ_~GC5COgMiOm#XAJ((3CFr0y!zEtgTVNffP&8w5Q zw7SvB4I}C_9FG%4<p}gRSU1&7?^x<a2-h3|m?+hI+bbcLH$C%WE`uuShNAGC2*<ow z_c`cG5}_A?q3iFM?B<wsQc5)h@^jGQ{XQ0Pt7;O1Gr#!c^Pd<uZ<eRNA-yrC?i|?1 zYUb{z)TH`AddkCUG;$!!smWQ>T8_$-%$f6DA{$%EDo4fLjct@8;x_uy{LSKB8DC6r zb!cB9V>nX#J$8WWs(DlKK{pwq7QZ>R!l`;a=#JJN+#rJjp?qkh{K!ht$p12@xSapX z*ucvMmCgz%mGJRoo*@6$yFY*bc;BKLfbDBcXerL<$SwYXxEaQ}r0S9CILlVLZNwZg zjHsZ}{-ew-wQ+gkZcdfKt^q2i4M4vUvVwOgD~wT3Kl!&OZs&31g4C&IW~I*MeX50t z-S=taJW@RCwQp+N@pRr6q07b8Cs<xcyj_wpA9VC{5bLPR0%#Cv{vQz_eMGmCJ`(T@ zK|f(@<^hc{TDLU;QOqU~7<y$_8)Nb_tioLW!m~Fka<S$Uuibc6IKnPl+`Q)2<!atk zaw)H*k2Tk&D`xx0+H{z>g*+S^<HyU@-)>9#z?W=Zqmy;2II)&q-kFao0;PPBIZ#QH zlu1uHKjDRICsM>F6+IC4E)ZujkL~MxDbLe?&IT|WkJf1DSaHStvz#MV&QwdOLRtMR zjSFmbfEvo|Hgqt=7Ipa_bY-Or{WQ0>WCZx_C%|uVg{B_uTAw*tkm?5SoM@tUaI)35 z2VXgrB~Cy*KF5hg)`<9|Zk*Jpg?3`<wXi#uWSkE&o{F)X=-kd$t?Dm%BHz{5l_Wp% zM%^6fSd3$qx4)Q6v`ccuk&4ztK4S=bW_g43T45qWsna~xvdd0@fA9NZn@m`gC7;-i z&hu}id@CkRB9nD*4<6#dh-z1QU8%S^gVC8b&YI0*c3XRZE51igj#{@qof?w@Ae5kK z;N{RWOr`Q+=YUu-5OE4+e%9TsJ^hERIgJI7rV$eg2Go@tGW1hTO}bNKj(=@3f}7=@ z$Ljr2n>l&irh2lG@`k`XdkY#pD*fD3;Xzi!?Bt9(bqycV?-lVsOfhX9X~iybd-Q5q zHx;9$yLO_R)*q-o_>EV<PUH*iK3R+|6PLqg#fA%YsKfs9rddkauSo^9Lq!4G#$)Dt zdA&N1&B7*A`@MlkEM}==$Fu8x`t!l?S^Td|kS%K1nGt&lQ4=C4EKVe1w9Mfv!bzu` z%dgi%=E?rr$A>s`u6Brrx;<_46DV~(J&Ed7Gy5xONcTo#(V>+Drm4kjLqmJ6v5h_W zOg<azT<VEZp_;#b67usSP%hr_(hRlwO!DDxY+U-BVg;mAL*?dDNn|b$3Lxi;GmCNQ zzcff6ChE#yaA`P6Oj81`7<ZQjo?T_JRyQ9w9Gh7Xoe|a4VzR8O<dgrD$thoBHTv;d zs1-L6#G22!^0G{I=xHLyH+<Xh%mTh57#3Zx$vnv(Fn@jRr^iC&z(Ac}?Sikc|DY|k z|7eNV;PcwR#*l$gL_cR_@y5K~AI2mUcB`JEt7og#Uy;~;{w!5@vg+Por(X}H4Js*` z9IzEs*_t_e9)N0e0MofdN4q94kF3#bd(5uo{K&rgcNj~#!JxAPsxs+WSLq1cdiT7D z)hHh**LbJRzyc-x`k!U^bCV?*L*XwvTsuSQHgF~k@%lVeB3Vi+yQ!rz)mw|Aa>@<e zHim)Xz28^dP~JPGroCZyw!P|!vGEk6_dBuV0P7vYEIs;P9)5B0j(f3z)vJExMc=M2 zemfgzoQgEFW<G2!(vQ3g4+<a*2AskJjlUzO3!UW#Ya@iXXAd;nCiWj)-WW(a_aD?< z0%02dHawi?JL0k0J#}_z->@?@%GzaC;a@Uc0yx!)`8#PhMhaXK+!oUtlyqd60n(7r zp73#=cx{ew{mpRLs`i_6kk9WjH4Rp^s)TfU%9R$@vVZ_PD}C?B4UmuiIeya-Q20N` z|6av#-ev_W;R2=@ESm7ljP2rEobLAI@(|$jkkgc|zg^1#2{!~lkfkdqTsK!Vm+1i+ zog^6eOdkSb)vH{9MP_x-(C4LMV#Vdx&|9Bo;$E*IrTh(sJjjCC!QPdsj#~r{koD<$ zN2zW~f%OrI-9fs@?iXekz#(2V#SlRhP5{Ne1tg~T$X`A#zVPg2speZujN#ELtKUyI zGpgQh9?>GLHy{+4W$Zok5l1t=B7<g_F>syP^%Nv|bZcY|Mc`!DkA=vR$(HLMNlE1o z-^ej2Fwahh(N*1%H=tO=riPNr44AjexN%r@E>1?57UoA7RBD2>B5}o@9|?&5e+D)x z;q=eNd7n04Ws+a;4E)toqHv3vI3HD)8WQ+G(^$?)lqp^baL{mBV5s5%vYC~dX=#65 zX)__n#-`YE^v})RN1YEFw<KJe{bt1C9<=OSopZL$2`<C8#oEbFQ5+uNyAJBDGBu_@ za`qqx%(wd<t?&3&*~<=%&KY-VHHN7;-?S+%k%}KFN7(Fr)CUd7@;^g>{=Y+jhr}0| z=*OGk^9s(ayjPW}D5-Z)wnScw7M%jxp%atI^S>GOY&9xs*vC>Bao=CJ$r$E|BHoGj zDm2qDnbjRc*;5DC^d4$n#&E=^%MQ*K6M&4DIN$+MFh>rGdeqQN8xVamiQ08YGtG*w zJG%ypsmpD<Z=y*b3#{ri(^CuEH#1gSz|*p^OY+l?^&gj&T%AHB1|=gxgn)N!U9~3+ zgS>wq&qdGIBW2!WLov!Yp~Uas<%zE>W|)RD`EtgPGV9ej-gKSuENuuTThdx()+=u$ z6_wAO`SkRzv|Q4}{m}2E`~b)2i|k`A_mruhkj4JsT45wG7kDj96RC+2drqio+0iT5 z?G}5~oH23HGmX+fV+p`i7DRLp;7LtZ_${r?_J3?)L)ON0_?wp9El@DZgrQ?1_cJ>k z2r$pTOn#DZeF-_>fn!TlhqT#dQ%vPN1{i5vem@Kgv}c9Q1wZFUmK24I2uO$F(z0UW zM@K@1o{qPQYmt6OX6sfg?iVk6s;_tBl21j3KGY;1yd(ZLjP$XUoCwp8cx4~$SC@fb zivOLUe7N|xp(#G)lgHBG!^AVr&?rqz6}XCX%iZP;4VqO8)i28nWxu6R_J*%$AYIZ= z9rkqcU~(dZT~h?cb$scl7xO}fTRm1~xOLZ<9&Klil-VhC2+wt^HWjN*f*SPa%3s@? z{^ekNS#&tru&VtlY#$!1oZbvW-W)9K48pTBrF4YKYva<Mb7Vy{%oRw57|2ug%i8N2 zA`SU59iT*45fHWfgT@T_rP^Sr4l)!8f`e>4ui|*1M3r6x#IbLmb`m$r7}|svkuuAl zviceNg7o3C&16vz1%AeYNhkcAY6@Gzn<A@#0n8HH9dU%NSy5Kt9HzA;n_p(VnpAeI zRlIj);pPfjJzk<#aV$0Dmq1`x-rl&!D$DG4q;2u@Z}TZxaO}9cGG!InSeG&gRF{8U z>kmQK#(IH?j_-ta^EutEdR9u~`S*Iy<^^qR{AMh43mz`_TUvNNCY2kso-E<oE&!@z zQMUWV<1;3ucL#M?5y}IZ*3&YYgPEv^?ogrZ;Jk?EptZv5u;O_=Up4o5;5W0QNG*V< z1GP6_{cJI+GuXh*fHF@ECC?J^SdO7IZd0q`anSbe-CGK*X?a<IM06whJ8H7Lbj*V! ziV7ATeQ?y(<t`-qRnC8(uT({r_<D80DPN|jc*BW_F8BOgroec*(~J8)OV1jLNZE7@ z8SUjiXX=@VhZr|=Q2Xi!D{`m7MFZ!Yro(t6w^d`J_EbkS6DbWXrh}6`yPbQO2`;_( z#9F~K-LoD)Fm}#9;yx;O(RT6^hQ-$YS`eZaUBB<Q#6Ruzp!lTZ7{N83CJ^S*gg07% zSQG-N|37C}I^AFjb+`~4adhwpOGjaoQNh;%Ys;OdM#oEG!}tfZ8Iq_2?`Wn-$psbL zd!WZHZ9F6S0#zcn>KUU*d7Sf~Ek<%S{m{`YRVWcxXqlGZp4qnQl<5ENK>p}t1mmpe zN|B8YCk=<qs|!1of5Z$i27iXSYVD^JP9x-wShkO}dOF*`>;P%brRkv>^CKD-F!`*5 z_iv3nsKt+NG#E%89+RBw7Y~SZ*|omC3;J0(x7yR&)?T6@FW+Z5l{y&`O1Y6Pbe>;_ zj)}{)V_`2p(9vvILO!%xE<BAXw{A^vfO%0=)0yc5A3qq`vUAH}cQV{<zdEX$Fa|<N zF9_pO9tnbnn@2~25_&K>ln8U~b=O5@_*lh+lEsqB`rgv5Jz4#*liP~1BHhwYIqL0B zviqYgs-G93Myb#I+dk!$!Jw2G{atB9a?Cxr+;a45TSDbily0Nu>dg0t%l^o#TdQ?D z>~Y8>o0gQ6kEK@OLJwRx2V8h6do8^P`is1;GM~Fac7mXK_?S8@xB%q9yE85czUh8e zT0K^;E9Is-HKepN-cns>46Kyd(sT+2XSk^j0x~=3MGgg6$NT?BIuQZnThlloFbe)w zvw7{#&2}P!hGf<N>q(Rp?NjcJBaE2e{8f=yY`?wc!hP5xk<e@sF6a$w%_MYGr@051 z6L}j0kpu#08=xyPgu&U22!RmG&iQuuw4Y_``HJ_=*}tbcpZ;&BD%8IZs)5IXVG)tt z?R$EX^k*xhoRnurQpAWLptSi;LlEZ>9|sP%B6u%{7J=S8P*~pk3ipQ?R)3K`HIU>k z`&T7X!t_@pLs)a_Uy)26*k997-RZ<9D<SqFq9=4x-DS2uETzpPoPg*hftZKzOjIr( zU%sGvy8%9k7t!^Mp1j)rS*K&hc4KVD0Gvp)Le`ETXk-|UlV{D=_|X~$uKgG?lAC<O z6zkrIbe7q=0zqgHLO%(55z}KO8pSy(48m!39e%Rg&te{Rw0!gvD7B{QP7piU&(Pwl zQ{3N$3`5?zz|OV=-}-qxlDlvrZ;QuiZsCY$b-sBy&tp2OjkAA)k(lv6<x)T!1Vff! zB>v%8jpTP#=OReMp<uV*eJB?ot>3@~AC4y!>MK{9ZR*=U`w!Jv#R$lb{$xuMlVpn` zGsxPt0FkY^GzqF$anCLPQCAPT+S8D?CaBY3T6zL1@h9{TJRbnrxbc2P7fA49r6u;K zb;%Ck(Y9e;rx&{&#WtEsi9lUacuy<ucb$n*;DW^DJ3~?7>R%OEg^qC1g4V-(7Kb?D zt&OOft*thPZX(DPgl-4{3amaL_zQ(4@R!|(JC27_e5>vt>TJkpg-YIW1QVr??oE4~ zxB*7#Kpl6V@Qdfire(c;2!8;y;tVH2f8f3F&WbSc{(Bf59)qEOKK&mN&HmLu|GnbB z7yPRT{@(-Xf7kK#Tp*Bb`K1C4s|zk~h1*C)ETb26G2;0=P*R*vwaS$S1E6j^Ui%rH zEIn<<vAQ`ffAUX*heG$98f~Hy;_d`$Hsx!hBT0f^Zgjy4Btw%6?M_*Gl)4p}yH(cR zV$ZhM+k079z9mj%pM(&;eI(LS3qVMBmf+q-^j7Pe(%5eIcxt!SU4PuCi{uyw`72z8 zPiQ9mu=L-8FtlppGac1!!5*814@o5UzQJ2KIxz_mCqZmAcw!8jCw!`b>f|`CE`+O9 zz|Y5+Or~pi%Zz4d;<&}co)6k6vE6TwM&6orIii7|GrM{2Zxk;rdsWSF8SYNMbsyP} zq&^zk>a1T*jHi(JVSffnqG>Sr!f||Aiu7(m(E;!H#UbAh(-l1NTKYzpE5W-O71b8X zdO~!Vq>|;oqGpo_D)EE+fKCu>@B49w%X8&U?Iz~Ps`=I2D7>n84||j*su+4sHrf5* zme10S;d_-XmK;C~>r)M44eTTEuQYFjNlUB7c`kl${b6r{-k<3lWykw3FE|y<B;c#D z?mhx1Ayesv(|o~wB+!SyN~&JI+vvW>_C0iPb%CKnkUufs{jGo{n&F25OJ_jbF93ZY z;p8`juxT$Z`Sv>SH#5)$e<MX!Mm-Tc4U$bEdAqnV_rHQWZqQbe$h;pGT=JUW1d3qA z%J)v(gmfwGegYZ?%iX`?P6R#pn|Pd>`zq`|mpYk;qg7#VkD0$JLgv#@!&SiL-`*rB z)d)hOQK06YHx%Vx4{AG@y+D5Xdk8^ASlMK$1$p1v1gRP<@z-%yKbT3u&xz4_EzX8a zk>uz}(92Y2IN8tAVnKKDt`A59!AiXY)+GsIpSu7O*bv+YRUjOp0AmAlYwEZv_p=Au zEDU#F#~t)vn?@C{e-lYrwtx>k1=qSJ^s9{g3tY>ot5+9MQD&C56}q2x{bt;|wF^$? z+zB#xKG%ORy?AdoL$FI+LeP`bI%96VP{8`NL8|*aN!uMa|D{qweflIzkTe=J7|d{j z)j)rfwI2NG<6lR1mT}^^Ut-&-Upgt1SveamvQuAB87A?9)y?IFtt(fu)2^VhOKHU_ zdut#6az4|SAdgubt9I(<N0Zt=E9E_9k3(e#zYSXV2fBQ!H>~W$2(RZvw!R#}y4!Tl zb=r-tF_c>(neSYMu2UD17m_3Vf$hG4R}En(so=uJ3K0Q4r}VtrHm2*R>1rf+RVVj- zESO{>?JI4JU}5APFVDrjPVs&d?C1K)-~sDKu0$nUj?&Jz=z*&T3R`{Sr<Vlo+=9IO zIOrM-GT(zs`vo2=oD5?S{7$p{Ik+-C(?Fd|VUn@pmb+O^*sC4&z;fvVMIrFdSZ6un z5I*@(OFkzSr@6lDFyy=7Q|jDY>l-DN*49j=FGFQxjjftD=zLnRSqVx9zh^B)0%yuR z`Q`?ZUrcyrX!j<5wBOJJf|Noncc1DHrwhr!CXdZ)Pnanc=)2ju?bOXZ$uXm?Iy_mr z%<rb%dG@W1C+n@0kRPy#)~M5ng?aO!T_7oIq#i!@woL7zFHjEZFtgNbeTi4?pi;D( z?y*?me-i#Z%VmKN@lBS8UAIXoMYZqgiAQqu9AT;{vfPTTrqjL7W4pZdUXvnc!qSa8 zs?*)=z-zp8QIwFMZyyIuA^9pHk2M}s^)oCs^4L5Uzi{}^$E$<S7Yg@C!+7K=W+O~j zx&<+U!ykgO7=Lt;i<2JQ%s0DxP(L+|qCQ{V?LbW<;)~4UxX&a%V;LA#vfE3YMw=lO zveuljt;0&9nUC|hxy~|dbL3H%H?~S7nS9lqiGK3|3kW_*he9L))UenL#JI6NYG7oN zETVm=4wG4RIYp~<_*g4G><V&gDl=8Fv|RDClqv(DdoB>_Ei~NT)}0R6?)i?Yw(z|L z#Dr<8V)d(Uu+_Xm`_;&zbKqI`aY!z_RRV$QJwE<dOE^vS$RZr+OA+|7>`g!rb~aj% zlQLqf@clKU$)E*}#g9*3%>QkazWyNG5-LUV8m&I3I?k?Vf%MH#%DeG;NmpD=|A!fP zZRlm+yxG4l<@;A%SQ^`hzkM{8Ionz5iYWhWGu_vz3|EZ_Q2FMa3S)YgEl!!HCBzlx zRmQLNz>QnaLYg?65JrxacsK|{89P=4>b2y8^upV3AcH2s(SPSl4v1(wx#pBqw!lXo zVqpg5<B`gOdMC|*+dWgT|BNle)XZ5_*E!?cR#Ycfq(aj3TM&LXfu!#mA)0^=FW^`c zMnTnhGhd=;;hP9f;XE5<%Iw>^4VeMnn*p?!dsXFhTT>~iR8iRMh)LBt*1);$AF`V; zPhn&@D`G!Qq{0EDJbglf0F5B;UoG78)%S*hp#t(AGij+GLg~uv{L-0=Qhh>^8L!_S z7N76EsQp_;c77Z9u!j554?3@Y=VC33AY}7xrqAK+c&)(iJp)YBC=t&e)gVV869;$M zWon!(N|gKtzJ!{GCFaLR!QanclV*PODC-~;2VTe|7zXe}bN>jpNQJ3FZZb=T_MB3! zoBU*$Tieh7*c{$`BjR{akTNlFU1r5Z`7E||5WPO1_>4nhw{b?alcne1@wcA*DYmO= zcNvN2-C9`cY=^IR^IMg;imHZp89?-a0L3`krNNGN*3XUip}-T~eIO@EP6Jnc{W6Oi zutH;&*H`^vcSpV(>Y~EN>U@fxV+@Yz*4B}vYI1uV_pxoO(O%80&DZj^Q}8oZ#5B~^ zp5K%UQo)Ssbsc^NiUlv7JA<+$Ca&GV3+|=>=Gy56Vs5@mXx!q8Arbup!d~IYz`h(% zA}FB0(^9!+DyAnuE+@s!q!0@F{y&y;DU4Q${VV);MQ`%cNO%=DUFt;=TV3BGkx&p< zV)YV@U|HNx$4^V*cTR;c*{`E*&c>M*JKDW=v@3A5bHNYNN*>W~J}<osYTF{HT0EA2 z9WE-8vE_9r63)<hVsl#3kXYu4{n9fKO}n&(<lX|{WD3?tp5Tc<5Epo>hr{#L_uPfC ztPt>dmkOM5zk$#=f#O{G(~Ag>Ssk^vGq+9!{cVqMdC$=cBf@_mpp`Gf9R(2ebyDzy zmk$XT6}(V_Lq4NhC%(-!S$khDvKjVWd2J=Lf&E&(-8;}{p>xt~8lbt6U)9zNSExxx z1~WZD!zy4HG~iA=Jvz~=>i{tBL*hj6a<@;EB6?^k-o3BKCI)cJ-<JUq6wN~L-!EUD z&M6S?WqBU}!0CA1=`9V?sgPf+S?WAHQuu^a(|`=dAK*o)=l0_;5h7P3e_^#bDYXc- zVrD2@@D^|lZviASQu)gU+FRPXu0MdEIPE;P16djkO0i(?#bGk$H?%9*PpDJq>Qc4M zQ*z9U#gDNC2R2oS-{i`6t`6MU9=dsMq`3E`^I&}<H|HMi*S79~a2+Eh#245{@{{7A zlX|FwdKvbqN%;d3!3D;@oKJ~ScO#x|A5?HDe9Xhz=fx67HE~{Z4q6!TNSk8LQKu+s zZO^xHyLB@ECGTve6TM!Yfh)#yjCzff0TA)9WO$)1!E*02xySb5%uwlbJ?B!9-3{du z&mlW`YlU@jiM#H_+%qFa*=aKHe&#|1@J_<Z#qk?z>jobzRgGtV_YE+(AFM05@3-L{ zQ0LRsDvSpenG|!nE*WN^zTV0QWPUJ9l5<o`#QWEkCncF13>H<Z0`-qxvM$M4bNJUQ zc`OsT09bPHxZ?UQMs*>h;CDmzS)Zu$euN;S_=i1Hy=~GAgSr|jCGW&4$0+}MrgVEQ zE``yjI`OPX8K!tNi#A(1`W%(c=i6@FO3PNK)_<4<SD6G4_dfrL9u80K5VlA-bk=w$ zTA*6aSjx0p_uJ@v%Cmtqnf(&^$VUS-Igf;l5eck*toK1E^7-u=bxhNg+{*04y^#v( zry3-K=5BAo)`@e;LNj%jM-%&YEFJpj#j-Mk^wAwZMK?Z)Y{X??m%Fq4>uzs?;&O)U zxTvcv%rfCE^#TzByAy_TjEY&AD1e2Oyo7a<q;&gcQ<W;s1V^rx&R5KuI1YTK1Vu5Z zOp`^QR(YBTRg~JM5zVRg9K5zCIxaD)!mb7PoMEWZ7fPuzxSgq#k{(uvR#lS;*h4It znF@My`c$u`;e^Dv`f$H8yq+p|&>W4NJc;l3E4%6rBJ|{OSE<4pdsjA`(N8%J%SIKk zu42*AOy|Y##*Ly%-gc57b5a^OS})$irq<PUYjq({`XlehJ>zro82FxQbw$eyUiZiE zArAYx1%I*?M>ONGMcJ2DQjyrTzG*~yi<oHH=QK9T`Zeq8>lIOlR}}U6oPSo?94k<z zfC3e*{y>>Ku(G^zo`NdSelSzt>F0WPre{jo&d*N#A?}E_A<?vWF+K6nIq%}abW9(s zUCzS+*F3N6V)Pw$%B=Z}HTcqA#%%m@dx@1;%$eeHHlpi{o_s|+X+}D!pMHAfg?!S> zP-@YAmxa0Xf%62wR$7OJTK8TjUN>Y#7QH|=1&v%D=xa&(s`+$Kd%>j8f9A8?>vXC{ zseBy2e|ZdgNhiRxm&cYoLe8wrjj0sw>APGV+{f`?;q(Qbzp7PuCfM^}tl-W4>PeaC zb=f#1t2m~^Pgk7gAlLNUpKN~{;_!R$_Eh{V{jqRWe8!VT#w>>kp_!l0^y=NKOEjL3 zSt3T%SEUV00fQ+)g;~n*y>LxUUh^O6Do!N0pn$19WsTDSzggfzdfP4QksDh@SdaNi zs``_y7cey<@mEpEu7Fu2+KuM01LK(9TO{Bpjt}P()A)obQ`MD5741%$2BUjs#q_J5 zoyTpvMyM36X5j`jeQz^GgijU;Jo}pIV8gv$!liiKPC>rN@?p!KSTcB9%<=<|PVd9U z)9qN`N5R$Cm1jf|hUnjx!_JC+Aq27OKz$3GB=A^Y!@%FOg!bc{E&Ah=rM^B-#YU+P zy9JAt5Fm2p@GJ1xoA>C^j^f{ZXh?q?2vo;`z*Bd%#<j@w!S<Ud(h~w5FIM~Ixo+|8 z%xWRM*nN%UD496H*q4-2u9*atgU31BqB0z3pTypgC%!Of*nFPj{r}?Yy`$mkzPRxr zk9a~tiV$QXiRd*^5~C+kM~QB95#1nRh<ZhWh!(w$-a9jho-PQZj2T9Yh&Bunz5gzG zzH7a|wchpKKe==7x#yg{_h)~0IdLp7i|4>K7Vfu&4Cv%}p9MF!-nt6B9RJ|AFI6#J zh^n6ZrRk&|QePnfTl5FNTCnno@2&yQkmg>?cEerbMM*H(HE$vJ=O`i<p4TbFS0Ksk z>^-Lvv>4Ee4+KjehBi4i!)4j6E1zVND=2knS<UzBTCyS;zI@2E{JKrhs-^Sr0AG=B z3Qx)P*MilY<r?Y1eAXmxvBbgMTV9dX`>T$*7vq)q8??Qsj*-z$hsCbhOuq)rn-`vk z`E>`%`|%;GS2}-2V{J@TlF7Lq4;RnUqN=ZyjieO!OVESs^=W|Tt7Ti}AzP^#tla_@ zO}3@jQcBlC^os4G4*J$!x4s5igI-8}p8+wCQoJ|MH=n#3BXb#^h4b>3L-GYP{=qjh z?sv+`U%MrGzhBSfLk)8Grr+b9P5FZp&BQmmzpk7ceVtvgBDqjJ4g|Eab27g2EBPiZ z=g4)4flW2}(PFP50e?EpGpw!aBPkqDk>z6Lv0&^+D_or2+?5jpRD3TwP<3rxZ|%y# zxv;^x_B_YG`akANOXIU$_uFoMF`*Ck{`n_7>9{oyd%Q(pKX6G)?}-{G)W%4c3qJGa zqQo9ZXI+b`j1F+=MAw~Z{@U<VP4Cvu^l0&tN$@uwte{U_k6ZGuiHwVe5W3)DfyrU` zoPmGNbjgD|{``}`t2suSTSHuOiQdL{or|hZ^>r=zM-HiL;9ZtjjG6=6ESdtX{TAj( z+10~K^avaIb?(Pi|JJaG{`i}btGummFyW%f7?nwYhtqPMC36)D#_DLQcJZ!eKY1{K z*H-%(j>bO3m9_`oTRoT>mV)&oo~T{YRGTqz!Q4w{1NckYOky5FZB`fZdh3iE@}G?q zFMqD3L6&|_)|8ddtSz48;tK4|D~SMch+-Cg<Z9%=1SO`Xx4nH*`_mIOw$}C@9vjK+ z*rBO;C-|}hcDwcPx${B2x&<^6?H6JB=}T7=fyZxvTrH-0nh#Mo$dkpeTZ^=Qco$?W zTVX7KpJQLl<EumF+Ob@+2FZrP5wW#zIP!*4cw>ffB%vCMz^|v%<M3Fvy&U`VCrUr& zFVf$g9#@7GY1U1XH9qOZ#8IW$sq8uBS4Dj_yq{}Oe;O{)u_1n({#*3UC5nxuJT}fg zovSW}i>59RUNpb;S((rgl1D_Y0}TN<HqQgKGg;Slo`I-M21(|^NUMJ5RmAEI3MF=3 zj@k|!=5ZzLti(I)ZJY2nzg)<w-$_QWMsl|!I<Fl~Bqh|Dd(jTwSMrpz)MjrDbo&^n zcWB`DL<(}=4|Q*IKo3QJr~5az7}ozZjf=Z$Ev;n2-UewLaWJ344qW+cApt_RAe&>z z_J~(<BZ^S-S{wOm-{c8fV!4ErSzo8k;FZ+pf0Xy6vhp9*DxRTEPrA(%ok@_C{BzfW z8LHhG+5+=jx+mH5Xq&FcmHf|;HiZ(r5SQkN@m*SIspkB?vxot4#VlS{yIwhyT(}ZX z!pA*ild7bM|1k%$_)?SBn^`yzF_}!<W?uHZRw=JbD2wqLMqiXY!o=U04&Fn?06(_I z)2b)+UHG|>4YzG8E+Lx(K!of3(H`6f5};c&ve=!u&I-v08!p4t5TD9_@iI%g!pGS2 z`JvC}z`BjsHmK?is>}9wt~+I)tYXOf|5BC#9jw(1*{JYL)1i^hGn?l_UvzFNiEy3M z+TQ3a%<`2nDYhIH==bR5xhc4ii`+oqSv^)4^GaTUQOm0zKfmG%!J?xCje_qFUMD@? z!x+iwm^MEM53RmR(T&q^&PPa9V7_O1>LJpgotfNDRg3bE_OOyOGdY$+gn;e=JH$gk zEn6V#H3_Z<M?hU#nao$PCE28$JId|sZp}j#`|~W$b3-fNK6Y2VAsKOg9jYfO%P+Fc zd$blcnVM6|y2>Z39A0hXbMUC8K3O>*4-0CZs4Q1U-UXYe<xQ|}h$;O{&{6rs)5KyD zbh(Hx`C@&<MdiSRO_J{@L8_z4N)t$U*{0RYlN+}Q_vcV}dchARxv87V2rOuAfg<~S z89Pe8)$9xCSJ8i6uKMzTnRABAStG${smRL!>M2uayWaeZ*yT~Ka@QSHrmg?0$BDiu z%4S=B>+RwDhUi;dXA;c%=8`mOeuc$JO*OIC7ly7mzv3M^FUMDq4?MURg;UF7s>Pwq z4$7x_eQE?HyUg~&W*m}x?{0*|WO!dI^T_0knbs5Gdy!l6_G5IBATlX&6CoF1<SEEr zQsKLB)rV^|Zhn|;!>#l4^8hrE);j|Bq{`(>TW`+ZN*;f%f;4CL!$n^*XM~aIIN^V| z)d&av!9@i+!>olV0Ci9(s0Y~n5b5UgS?c0Ck-u<mdT$q7in7Kh@ocE5C*k3L-W-&h zZ|vp35Ush2I+K3a$yZLZfv#Mib7<)hKMQC(Jk3DoaxP;O?Dx=CHRJ($oluU}eLT+* z*b#5+jr6Z9_gbEGa=#bJLM<%+R<tsYz-m5jAoFLfO}t|aJwR!5o6#uqAO#}o;b~39 z6E(G11fh1M&QmUxxO52q(NCV@{fWd`g8sQ8G0KeIw9JH}ET4PzpJY#awu&kQ|E;g9 z&D^BwEqd1})etl6Ty0Y&7)Rm@EN>yFbx6?TrpTY;qDXZXQhpa|Sax3=R`P68|LFkb z0OSDsT=YGd!Fpfyd*W;%<||j!4e@Z}d@k0sfOZ`z47XTZy|d(nI54C8ntXSiOOflw zgm!af&()%ldXTK(xZr0ySv5qd&5-}^WzJwX!ssCpu+dA<V|HO*FgNIb*ZBXXbnkBr z0s{Ge)$X1Aj5i~vW@b5<adO2la6Q7Kv@%P@(6YZ;DyfA+Slgs93v}mpSN&uGS>E>@ zp51rH6C3%kNSVx=!eBIiE#yRR^QxP*kgGVrRJEO4E$KPwm35CiAip=*fTfv>2w3&D zjf-QSE8!AozC8e!^t?RS%MVeswUMZN8iKdEZJwkhi7bn*_(E(+e|J9Qm@65-`%wb? zIHeq&uOLzM$)G5vfMDEt4(ajJkMUMu8%XGy!vp7AHo6$r>9X*RcWs_BXlO;cd5f$x zOiC4f?o*r_0}Mdht{2D-g{$Sa_BKY1SK5`B>G;%gS6(~ztjE7L5@2(Zv>mWvat$np z*i8#@WLh)dp4xL>HPH1}F?$`TxFkUf`uJ@pK0a?Gjet=zM&#fF6j*9=Aa{$C`=r;x zESpBMWN+Kkw@!Z7zfTHW?`j|hW*+Qpjduc|0~=5^&AWQ3jb%CSRbPqy7S2bzGgmAu za7OF!cbU$JIQ3ZE1Gb)u<X3xSnTV=3KDJe%(sntbkxky0BG9|gFPs7wW^BF2K^m>S zf@qE3OzxL&y#d2ji-6@l&qB}KN;KMts^6mA0Y&<uEyiR1SiV-GffcGa?E?T=puPNL zR>i}V+OFa#&@HC^V-q)-=n5sA4sSTs+h_s*y6(FJ@kHomSj*#NHnuZ9@>S}{*gOsU z8Jt?wZXVGoXi;sfx-LEjx=~6sDj>ub`ufP<T2GfhQ)=@F<1H`x%+Nk_C1!NowZTyu z+5DK@hA{w1i)jqS(!Dg60@7E}??np?F1jxN2>E_?s#o=SDl5gL%;5UPk*B8<6vRz@ zlrJe=M=}pLp1PA)9`9iA;JWn0Ey5iuC+X0rY8$__VJr78FPppA(ee7Kz$)C})%L*2 z-9dw)af6Km)q>?x-=mDJmcWHiKD|D@m2T!<!qQ<R2|};>{pPn`*6~0#W#a<L0+Pn? z;yBzQxh}u695P^37JYj0`fHfKe^F3@q&oXk=)e|RP6Y!KlH(f2nbNa-u;QAoQSt=J z!<|{Hiq<A+LpjOc$tDfA$qM~})?vEadrv@Ppg8YOo45w$A#YzfT(0lLE&1<iL2rUt z-3v{2VeEh(0Jg@cuS2d|K=}xKmwNTj%461y(FoQJz0s02<t&k=x!8FzbIXpn#C{3W zu=AuhFgC57=t4bD7(~HY)ye*$BUe=;)A?E}^Wnf+Np+&c;&=-x<{e{_KM$Q1U$qT| zfu=~Xx=1pF+Lw+2;m7IXcPl)4YghguGEOvzIoDjZxf=M=4^qd7U<Ht%a$qMk>XtrG z8ZDkyhSIfq%ZN(tl62V@0vb2e*IQAd!-piJ4!y8Yi^Kszg_`~WSTxLAzxO9+Bb>7k zSlb#~uy2<fY0O*s$dLbA8s$~&PZou(vX}}lx(}dCd0wMxi}jSUM&?~9Wj4i}8d;|5 zyr^Nocn<!qy`H!eRnHh>50#iw^&Zmp$HUS{55C+#Tz$rptq)IiajoFE9q<k@u+2oj zBZbMn0ue1ML0_nkC`V_fx-%DJHuYN2*^&`7UAe4J+R%2GR!^7oq05xL`1Yr%RWm%J z+`<m0zJ9R}{?ad;Z$6yw08;YtHy(kRjpu<phL^k&eL`8@V5U16W@N$9YD60Wqf<wH z8=ilR+JD8DgxAU0N@^+^&|)oczlaKY-Rs7gIgQqu@`GC1o*9Hn$vd?=&uk<QJRJYC z(>)+iGT0H>_UC2s10~`G*F14m(w44Dk4nj#^+x*OY?7sIbkVC?hWhI7Q{VoGwq6EE zF_tX0T?=pSjEw!f9-=qsc~9bg1!`*0y0hf*jU!TdyA=d8p(@I$j-*OIutU<;nd7w{ zvERI^Ux4sL_kVAKi#3*`3%w%iBL?_SBO@Nk4sZ<|e`J?~-w-2G1X6eX_&eV!Kv_A~ zINuE+&Q~Cfl)BK^=o}~MNW2e_gH@5$;rYh7yboP@2<2IoF#m~-fwS^eYH_1Vhb4#1 zR7l@EP`U*u{Y3bgg4m%_`>1*X9D0Y`@>nPiZ1Xg0vA!77qA&Q%tqMzhXC#9e4~WiR zt-%c`{&`;W7I;=DAQs;vJC)Hq+1~m%-_M;=%T<5)+UItBPsmDDaS`CO_|coLb$)VU zdCRY_=mXuBL24GGoS!@Y%qd9xy0-<DR8J`UV!bI-3r0LTPf?*n$AN`AIoZp4Esvr! zO8<UIAsY;eUw@&@UZ(dI_CoGAXJ$88nipK~RJSN{fVpJ)0q0wgsN_?dF`$j7SGFa- zEXYvTt(@?Lnq+aQ9|72@25yzau#(sy@l==P+mns4523=^Pih;}--PTFe*1wn2d@)W z(>R`5M1*B{c<*?~rF70_Vr_OAt}XKVTA=T=i52qeRYbf$Xp2<aTmJsU!_@vk2YV3V za!<ATnU)Yrrn{!p!8Oa#iU|i6LrY~+NJT_FQ3c$B#Vpjv_8-D0?u3Zgx4gHb^~KQ} zzmv^yI_lq;s*)U?4<@EhZq2v+%d+RKXdhm)@(Hg%zNOotG<@UI%I}otb3OA#_4FzT zXK8q{evFoobj*OlmqD!sv&6_i!&V2&p+t*R)DE04&C8%(-mX<bkw5EQn(iL>X?rhw zV;%6dD=tzqfV9=MH7In;`N=bvTN^ftw3<>4MFk=JPm#hca+chvfu(h*GVI7Oi+kbB zs72P!q(tzp#H5dy6x$du8%$Z$VVM;MzK8AKHY-21P@^Ha)w1%dwA3H+=*{6onRzb$ z^`;-Mi(WA_e>0ZE;B*(E-lbfmns07=jq(xkvYrJAh(I($kCl(Y8Mb~?p{QpTo;c3_ z#U&EQJNm#20P0ThOU21Du`jTEEV`n@dNIXVCAw{K9s#D@P7nY4XZ1mqvV6sZ{JB|? zhiF+?=zyXUnw|ad25ce@X!rQ@+_wseSJUhKw)o6*%;WA#RP<g=CN#bSFXf3eiU0NT zVhNCgXT5}aSJ5IzeljRA>?`K^6&nf8&#QOI{wm+~5xX2Hb(ga$7JIS%u)`aZQXcIq z3MCCJ@T)7ei)*&N6ENfbl?Ix;?go;?HcFFWuYXQCuX~UXTcTp_kTq%peJ(;%lEb{0 zh11RfCnb)+iSddhv9S0{D`b_JKm92J)W55ACa56894fF``<i&=fh{Mv@#u}SyN>m# zb)U$$IU~HR9kKNG=SUXG$>H@ZL5P@>=|Y#p|HL+9+d`Fn*x~6<@(PEn^BGv+3)8{K zNTf|k5?(E51&PP>7HDyx?Vlyot>pK&(W|sy3@D0b9JS0#fTQB{;d2YX2C-Bt<+ll5 zN?%=^EpSz$zs-=56tk|(+YzH*ua(phKft+jp(keawOy9)H)RA4zYArgfr?1Kbbc;p z7M9OeM^O6FnV_?&eVX$J5nsg*`N8Q(;i*e!`k}+lo$33hh0$}tqfQB%lo~LJ>WS{0 zp1+dVJ70R26vAOnPx%PUDvvI5Vp}12_7el_h3C`p|22?1O0c%cN?d%eM!Fkbu&Bcm zu6)7y;Zy$#21-@zNPSdWOpG02FCM7jBF{gf)zdBILa9f!?H+tyo0l%ouZ@n&KhO@? zi>aJ%Q7?<h$8GrS%dE!Y3dlx#rSX~@Z}n*%d_@WhgiCJ&vf9IrHHDv>ZaP11*OnUB zd!viiQbS9Iz0^wo^1;i|Iaxo~0u^g`H(!TZ)K-mhHu;ZF%K?)c%h^3v<dhuUvhj7C z14o^-3&Erj8@*cFcdUDVIr!0l0`747pW{>tQ+4u{V$TGWL|%;mVyrz5*@Y5KgoSpQ zx(X#a0pvXVTtTm1=>-15rIqUY-Ou@KHKTpi;VVpcM-V?*j@nB;9$Zs5#o4}D2+ce@ zz$GQ0)?@*_V?b02(z*dTr-MwtSz)e6d0L8S5a#<=BJn^y$J{tjUZuJEnuDMD$%ctK z-Y}3LyR9eH5P;9xH!nRn;r@(ZrN@EH1;DRLLN9aOIR@{<j{@sk9)bIeBZoqhZFf9& z2t+)u`oXW?Ov=&nmN$j;&17LuZw6|{H}8)o2ZO)kjqfTM_@h}M4Bp8$K9NnKf$;r% z(h<Y~X0k6I--G@G6=JljZA>1}y=7b5IQr8u4pgi0g8@CDQGY6$YYNy-{v71uyF7?A znFQNX@w61?C#Xpfm7=<mz?hb}{C}gF`0uHPrf3i80G`eWP*>k*7w(?YkZkxGlR{V& z4j{hn?<N1>!*n_;&V9e6$Y0cPK;n(D2en;*N(9U|Gp4|r4gmT<V`G>1;iYq0NmDV_ z|JeW9>EFx+KbQ(u40hh?tDK$u<I^yosdBL@Pz(35lZDM~qA99!FZ4(NracEDtd2wX zu=M69ToN&H;%OsQ^gn}{l*2&lt#q)yA~d8^;GC<!SaV0DqT`toslb@0i!dyq@dv6> zU)aeudE*IjGiBx9w3?H5|8Vf@0r;`4qL;C)$J^yBXb&LSLP9NT0{w6_lXcN6m>^y! zcE=>}Pr(*_;M&%9*noo3_^JZ_X;H5fig}?;@G$;}>3|_YSMXQEuDEjeLMWJ67ZI|r zPrP1&xKApmn7VyX?6&CMC}f?#O-PV1x1duF$2~FE*O!A(qUwoD_kmG*J*CkIP_OKA zZg7DZP@25m|9UyRVXJv+#nppF1^3V(yO%RScuu=bY^M<>yiPXp!$==25xM16Y%&67 zXe;yVt?@7LTVc|<e))bOvs2RYv-+k#uv(GN(CmQ^*VY36d3x{7wnWy?;>yC|k=p$4 z5-xnJ=*p?h;SFdsP~e!RYp(ySstc*7xdXxSkSs9l$f{YDQGp8}deMA&0!#(ixXQKu zMQy)=DiL1fZ*hwF^N_1WNgc{TTVsEGwx*7@k4&1n#A|&Er9YQPqpH?@kD5pAurdw| zZ63L{(!8aOZK=f(hE)JW@4;x949UX55ZhW<k8JG&HmOZ$Pc)Aqv;XW?UiZOo9zbm5 zMsDwgJ+r)e9CXYNkvKf>hP>p(<k&tTeJw@ff~WO*r1TznYkYX|NVG8umVzHy{Xjn% zt{k%1I)8OnkQ}u8eMKcN#day`C~!myA3oGN)lfNXnb*6K8pwunQ0kCdC;!@TU`NCG zfI@u+xI`khU01uOeTTkZ%CpBBQ67zr>Vh3^2Hve*G!5Syt($MLmhGtOB)hEh0P)+} zkLK!~2{oU5LH48P1!zRUl%_{)fBhHyRE`!c%HkFD4qHjZ3ZC`C3hy0~3R*xJ`cVB` z{(+!De1YSxRj0S`;**-#U%MrM))mxn@u!FK$7LLCMCaw7Q8zE;{4a~Zc`Vg@vI%>% zuhef}ANqQ;VX?3ABmN<&x6PxC^J}l0Z5?uYuS}3Il3#1eliXF{t5cMs+-e#Y)wa^Q zCJ>)jfs&OpnSi}rPepU`eMv+cE%xO{-82d_z#~B1H7`gF0kS*$j>QiG>Eb*FswCxm zH(~h<tf?Tpc~f>DeU0p|LmP)Wi=b5>?tF};l(-%BKe3NtUNj2Rd}kPeA{UD(@nwHx zU_$L@Fu+2~J(SU^JV!tCW-jA*a`8HZkz4S?gWmZfm{+-&hV4*WeLG5g!NgOOqveM% zyBd-cAfn6!%7*e#p<jsTnmeVH;wExtS;{M5HAmh`T;$##(hisov6g*|H6f4$q9PQm zKJki|eAcW>cF>s%f$4tipGtC76>NRmUr*@I>t$Me)n9D8Xx6`FZLg);agJq!=z}`T z&U$T<Fb~$|Av*$8hOTDGbq?HFFe5z811J^K+)GQfD?_U`d4m;WUKM#&f%3bKb5}so z>JRi1svl1^CUK**LWs;wKX5tEdRHCMpi%M2`8%R~o8!zP2R{~EW^}27V+_AFnt8Q< zs@J=^_`w$fCm&B>WWG(4m8Zu*{i=t#s;X^%KR#)bS6IE<)7=dpo(I%D%GDuc?Hm+i zI&`&0c%P!U7i<?>UZG{0T;Wp*p3%C*;_2JZ*dali3dd>!0@?oeuc7{l79bbDBS*ub zH&(GKIor9r&@*|FlwmcfWL@9WL0BBWRB~6vg<onew;Bf|7YcO7*<Ms+kyQu(eKr)X z%Z)mG(z@8V1JLVq432Rn7X|9h>6ow%lJR{yVA<7TE(Ik8y5*4T50AO=KFI-PMdv5A zFg5W%#)}D`rG?iUl?9wNFGM{zoO=V47p&7!&C9Xf?<+%95O(eYQ*Z7dNCo*9Cck!- zIuESq6zTk~T|vpPZy=ou-d(qiYl~0@+FRw>rjS5MdTyP?{_Y*LK$W&k8>$*nq_6Gb z**GBfWl%F!7!djBsSPS+ssC-#zthc5c7GHW3)6C`V9aB9%g}E3?Wg>XcD!@ad}~F2 z4i0-d9454`2UQ^%qHnPHheg)M)YB8ROK4GD{^j-^Pf{!L)aTUL)hPQ809i*~ceIPV z|9V}xU9M|ya-10zx{zWnP<8B(!ba4<(v>FRfU5p6$vbA~dsDt5bFLG9O039p%<$=a zn4U^3SrZC}d8_m-B<6$6M1PUv;&Jo#5pb<e^uo2j%B>d!N1Z5z1TEfttxKp<hkxo& zyi)RP{=iZqhlUrEl>DEO9i6eMT~4x0jf4_e4K2i<92FQ1D-Z4`7C5jM=;$I)0m@KO z!cN|u(QmHJ*P=Wd7V)=T&Rs5xuRdJ&TY)k@+zaKz=IM+dUgcl=?cJc%@vro2&&=w! zs4g4M_bQeLa*X^Ci0146#zo4AU=h((0{x%tDbRYl&W&w8zR~ViI@k5YWAy0Bc%%H@ zAj(GKvQb|8(CrIR;##Z$6&E^5%IKRj%1mV*pOpi6qN)krY9%lEcVx)JyFHT;FdO^@ z+c`R-bIGri#3Tb^xwH131zHAn*qD%@4XZ~nBb<tEsm+BaAJ_ozIAMkb=*PuCRlD3U zr7ggHf(Y78uTo}=4tM(K(ov<$>}e_^-DZ%^O|LgXWetK#N<z=UFNbyhXwlJ+YNI3a zm@m=@wUCl(nEmPW4~Fod=0cYmRGIvqH<7@bKzRCi0H#rTFgD~~slH`2r&-clgViei zy+2d0CLNPFPAJe(iS2>|D*fMo<49KQ7BCPwAL9V)v_6oL*&O=N3aUfRC&l+9?XiTP zrSbP2gYc|O6(bkmdoNQ965wpIl~|2cCPa$dA%eZIiz>UKf79s{w$+Xnl$*Y`l;fU$ zX`#AzLD-ckHtjL?v63|4UG`}n-*CjsCMA>3(wznBSik}ABP}#vwb&}^%S{&i_`OeT zQ=7wc9Umur4$`;p;8zDePAmo#eC%Dj<Bl1HwT}<K9Bin5_*JTUSv+1}u7IOd{IY&o zcAkUX0_z}#&<lc?cdzP={IV$$m}92J??kbub&aeoFC<6DGeI0~$=di5il0CrND&}= z_5Zx*_jZQ8ckB4&f-tH_fN%YJ<N_kk7tGae4f=X)Bu==DH1(Rd943T-r?^44p6Rbt z=d$hLxRgu@G7Cgul-@z`SZ$mjsfDW?>EKR0Dsc{u9ajigNFBfw*hiMqK(3H16l}m* zhTNkDjv*K8W%`|Q_?-Fvs*z<D?%)(z6_=1HBx{2gfV>B9V*?#kurB1d%(jO-@6a(W zFW?n@Kx}A!7p4H6M+}G+*hlRC1NjUxY2;%S`TqRzt(qmq-xy=e-M!^^BbL|PG7HsC z;qT+#W^&2u`PLU}fZ5wfk?cSK{CdcJY&odX2l<)*G|!^mRUJ&o3uk}&H|3_Rv~TFT z;6iHdH7bZBcw=22I0vuu3_xp{M*0Bk@3~pHdw304|D%tCy;(oIfXJnzg3N#;E{q0; zas7-CC~$r2(QRo*aZ$^5<4oCid<|X18!~T{o`XE%11Dj_0RUe=a57#YMNVCL8TmQy z_QUqMm;=Y04m4}lrzo0>^CNv?x%Nu9vw4kF5Ix0F`r@;oW>Jtjac;W%*cfeC#@-y* z!z{LY#*H-hH$J$+q9EG1;LJ0!?7qtD<<-J;kZfjf2|YnK50XgEF9bhUfRFhPSZFc{ zbUyJ&&ypY5m~UY09rc`(m|m{8y|kRfH8=jTGGfdPdk%HJ_1UvZzlG;TqZ?kyrpN0( zzaz!SxV*DBzApe)<ex%{97|4L*PRhFj=NX>gV9`<>3t4xzl+31%#N0)(Odg5mfmvi z<gtvQqYeWWWwCJ<Km5~wumC^m{N)a?Vdo$%R90ZtatzpP@gqrXEr}e?O)@?mq=H0& zn~D-y&qDef<l*`@{T!a-M57M8328Z;+fF|$&<RRES~x{KB6l_(jQL<i51KjtpbJ5R zDZV6aP_*Gjg%rVplkGqoaOg%K1p5nf=#JLFhL5CIfSv5v-N9sa5M7v@79$6pUdVn7 zx?$jD62bWPoVzI%1odpr6E|?0M05OJ@CqV`gA~-i1S*JA?uJT$uaT}L^|=!k4E$%d zgzQYl=+{;n2woL{d+CHL*qp2`_%8=VxdYqwtTP~<8QPzG+XM2ed`<x4-}yRza0Qsa z2ObpkUVrH~0EdX5*m>~JLCiDuLyi?NT`OuxX<X;*vPbe^(%a384%d&R?D(qC6uYsE zVK4$g9JrjP0+FyoFUUFNV`2`xvO_@evaS%xXD|vzL4uz7ztzIbFRuX)AmZm=0RMdx zGYdVThHxHoJytuhyiW5j3;m9w(-{Yu|GfgK@S*APjVi>&0MK!4$hr+`B5Kcr-O(Qz z?7tP8ZaC4TTtnl<PTr@m$IJXD&7f!mB@ObCb|hH?!C&61pcN;@9QkEqza5wiVvWD8 z%w|!Ew*Cv8c&lJ)ChO#d<`G<}-VfI>4_DFWHQW~<*vcL`(W0#8gP?QNp6}0|5XPi8 z974k@mI`IMX=yhO?b#uZqAdYcF}_@^y<&$DBpbERe$WiMxB+7}R<kE6Lr4><6~XPh zywEnhF=OeCwrKZtS(yL1TIPFNxpD^hnrC}%vu#ET6(E|{IqNGYS@YwYlJ}}~k+e#d zE&2>Zf$wnT^V=-2m;w^yc(TgaTRj=3u(sbi#2LwP-`z{DgTGPBdYr_jiM2Jqche52 zEsLhM%-BZzah%_zNo&!{`@4bICzE#xlhwAk@Jca8vB8st2^x8!00r%@17E63rQ4Ur zwz*kvuK+N<d1Ze8=c*}F#x!@H(8A<l;TBP)N?y*ld2gcDNRnc<`6q&1a%^qdd+yw% zx!^AZ05+Zh2giz61S#7f!&q>KWO(PSjZ5TpFF#+70tS6nYH;WCPszyA`*N?l%(M1m za_vKRPj<N#F#A{eSocI(?mOW^e1I*tm|smt`@hZqnGa&}m0XXUNA!#3*@rcOxv5|g zlHFhBx{~$+cR+dGv7_R3^_}-Jl*jE?DD~w&@X5-!=*$~rP`JP`EvOvtL2-$m(`0w3 zDU-XgbW=w98GS`uWF}Ph!T0i0$NVeAYWHNJG~tWRBO0(^&-ZxaYAxJFXHdex3*00p zb}ylGc6Zi%-hWv;W=!!dLvd{84OzHv;kt`X*70o+4aO6r!&h;SxHa}w%()2>&rr<x z-z^3I=Pe5$1>5rp&EdZ(;06Rlr_<tNGx=mqeZLli5(HjsCk&qh4Bo*a*EF+Tfo`3f z^H>Xl9UB@r?#c$;@l6WTe+SJK-?Nc555p`(bhu6Z|BNAcQ_xp(ejq6CVhHhm4_rl& z{1jOt-SvZJYvopbTj$msLl%Jggkz~1o+Wn(e-T_C59gUg*RYxT9?=oKjS6RLznhP- znkPp><=D-)S|rxYx6<GnzOw~W-StFodbh=hO%J|}SA=Z)#Rlz(c?*m6ZodqV$zS!< z3Vxs>aJq8NeUvJ@;2bFbH(YOvO8;Ft+vxPQ_k~l7PQtapT0mKrF$+!h&)%#w_Z8Vd zJQUb>SdR+UqYn@jx%NKIb%Q^GI#3|s_i7)-?cs~NLt#)q_g)-#mHDXS-aAH1_V7)E zfSkH{);&x5ur>{FwN0`Zzk|n-IbAJ&QIl@U2oXZQx9@vY?V4=y<$j>ukv)rp&57aC z^J!oEG?WFfHP#p26qwJ?)@P&Fa`YOBt)Mmi!|}SO&_nJAbD-S{1(Sar9YAbf+vPP5 zBjnmI5zUK;9;Q^;s2#|-BuBO$4@J@rJY>Od^#kkxdIjYFn-3<bslDEd+e95BL~#(@ z&JNkYRh-rQ9K{wQ?Or<0W&~@}b%kK?zOG~dt+A1E%TdyzRh&FbS6RX!$Xk@^xof^4 zPBAgyNt)H&$l2}pD&-g&lx7UThc$?*vcDnZ*lXa@GNoJvAlOU|NfuPsF5dnW_<7Qb zFo=Wvt{YJEc2Y<1*WQ5(c^p)i>_<#N3t#@?)m@et%OO3uPqOSgr$1Zycp%DTO;haK zx;lKZ*hUa=A9`X1|4^PI<fi4yUdidbl#|nKS6mVB^ufBvdR;8<kIR-vS{;I@CGj+> z;pvxdUQ4%Nz!iUeg}$yQO#Xv#V%3_!Ifv&m0d|gJ{Y~rT&;_{<QKy5L!8lRovtFge zzT3{!5GznW>ZQ79iIsbA1MQc;SDq?7b7E69c4?hd{YtX+@10tjC%g=&5~W#OSC4B1 zzFfwPduq@$Gq_xhoCsU|294?Y7J*ZsZ!jqBc?OmPu?8n)>V9b3+9&y{5iOlUtulIq zBZ)d!mNd$E#N}n3_k01R<Gt~E<vCQC`Onr<ODf1yIZ^MdEa2Eqq@N*BMXCICG@D*t zPqAwZ5gX?(uu2|Ka0*3S$**0Ht>Z;4<)ePWSiF@LW%ji864C;SY#4iYMr<+D;?7!G zA$;;17FF+FL}W!<NTx48cPWIL;0)%P*^?(PLqsb;o5$Cy>UbK$tF|C2f$6QXrpx|t z4AB7yNw-ly&JjC#81*uKZ?ULHv<zk5sN12Hc7`Quq)_4)|Ak&M24eos&b)vr1%I}! z<R6*-t8yvQhCA|LYprtI#dD5Au;q)8?2B@jXB9x_rFW7syXFM`lXSP3UOLgKhbXqW zbDLB+NqKSc@k*>|eUPQ^LR@!8RC8wnYg7uO-1#FOX-f7lq)aC((>&8ajp%DzE2SAS zIco`l=zqt3Y}4ZtEs@B6dZG#IFZAx~zUAXX=Z9Bu-5uRnX=!tL@3Ql<EEk(tj}9ca z7Sv*W&orDtl)@{L?G+y)jY>iM`aV*xt9#Gb=3j`Yk_j<^6{T?MSb+f$<O8v9A5-n= zRKZgP=wvDaACKEQw-4Ra2xG0ZzB`0Zzd_Tx{_IeOj!@8#GKfzTJL@EA+6SI0X_lK{ zyF3v2dR+eu#EKu>QrU!iwuaEYd%yTVOM#qe?TAsP5~HbH*HsYKkSa-tkxbX1YA(sI zKTGt%j5xvquWXlfGy$%cinwzX%vX>BI*pef4ep393Te%8WUOK4{Y*!fkF^f52v%)1 zwg|Uq6MXHkAheN6$YYoGmn2D^oiM;ug6vC*p*o`eB|j|$?+|vB{_#CyHr3yW%FT|W z)}JCdsV&y<i53JU*H?MTO4DGOUSqN?Q%nZ9zAu#lLw!ki$9G##^*1uT8f-KOy(Rmh z&gA?+r6rLqYoTF`c4I)-jC{p$4*VuD*KFf&lO0G9^WMjh!4(!~I4RZ{)w#aN;=HB& zq4v2|SFpq0T?PV^hMuUXBS2HXZZ4~9$wo6A?IL?`$3l!MJ~&2L)y7e5SKOwTI?3h? zAT}+2>UKpY(>Ht_XfH-OidtKqrO84ddYA|+Xy29Z$F2-g?FBbY!@6#@I%bxsSY3U( z_($4+GPl}ZZ*-Ma5=~EBv?ZnH6Kdgp+E9{L#v_0B#3Fnk^FL=7)rf{Mcr*wBb55)3 zoQ4#0Rv0v-whJj7oY*epikUhPRC$dFpVkHQ#^`V^f;BgI^COpejSY;*?g71nL0T&e z3@x9r%1%7DI{7U7_TMl7_&{M0>>uTZXZkgXcm?bn>*T6yrm&{x`=yyLVx3E@u;m{n z8pcX08I?f?0N26Ie6?|2IB?E$ZXWaHe&#yHfh$d?0WD1j{Dt$!78U<cY%VEU#2=4p z)NIH+d^IZWkKV(7tE=4F-@oR>T(LX>ClbZ(Y?bf%teBQ<twXoJ#w0E6ecffRUy|xa z&05=$axQ}j3Sdm4qxB!Qpp&Qz_}s!<pou;~1^c~~xWn#Cr_h!%ff2zT`rM>A;E>|x z3k0n1PUkf=uL$|s4))rLw7;|dBr6~2J@I>-&hxj(Dad)EV$|^v!4Ee9BOkp!EU-y) zv8JWyxryz&=&fseXBA=Z2Qk_9_i>?_7i0x|?TR@-2lGU!Zq5oXM_M>Afacnx`<mHI z(nNdk-f77Dvj~rAmUe*TVLdT<Fv{7uEHCfRLIt}Xl6g*+)7NnQ`}{~wB?NNAR}usp zrfCg!ZKgZM0MmMn6)vnQ>fO{_#Pa9(m8P{KZnB9GXvOD1YlfngWT=0LDx0VbESE2> znvUU!lGFQLzEb)9@@VF<%xG1a92*nQ<?5>sOeZqh=mEE&{HA{(R+7zjKRkfZ{{9-< zju(D&l~D8ER%(9tj!yRRrv4d^2J@}&oW!&K%b^Xlz&0289C%9XF~LEKrB+|uV$e99 z$do<k3<4XS-&&IkTfVw)wK`l9S*@BF%(d;^WzmP2ZTQC6i4jN8kKd)K>unLgN;4Pj z0>}<ud{J>Sg!%!OYzCFL3@LQ7V!mGMXK!N|AXfhgvO-MoQ@Uv0Z)>}8$$1D@--E}L z2?t5E-Kb;er9x#z@u9L-rbmNkl?qDD5D!|tsu~k?;alJA<oMr%V68BWKxA9Fcl56! z%!({%Tx1_Eu?T@gA0IZF4U9V&Cbg{f^<Bo)B;@u7tFL?+kh<pQz?;@-`?EywlYSb> za+G{Ejjtd(izYRpssELu=(Hne{J?dK2Jh>;W5E{Isc4Zw86Yz@IW*7tb<uA@?`wO9 zp!EdRSzm^_`q$qrbj2kZO<swkU5SSFYK|%>ieVUko<&|&l!iq!5S?Q)y0PdFO9~9# z((t^t=Y77tYRZehVdzCGQQ!&jt(Qdr(a+RUA4uBOo591kR6CYeF?S7CTIDLhLr19~ z7)|c<#dHwwH_FRCqg8}uD<5+f2Q%b-4-k4NfmBVQ7FBk@Ux9z1C`RMS^pNlJKRVf8 zjA0$myMQjy!~$x#I;D6^l2iM|l>k>h3C-<hs2-JIKqaMvAuEbnS0KP0N3D}|t$)X6 z{+-Uqa@WI2M^m&>*5VcoW96G*Icw2JRJ@6BqWn{*n<V+bYt0h|+U3nlGIhG58X`mO z7IY5_h7iU_tIpmvFi$ymd$A3dP;{^b43{%H38d_ocN8UK6$*M26W)lAX^j?F=6Yr- zLU3I<enmF<Xd|NI%-{;i>)5_!J<x8GM$q=s9?b6CiEMdjc@ARbg?L)I(g^xGO?AD@ zL8Ju)X|SPv&mFfqm*LU=Ady;O@8(HdBechtjouD1^pYk{?yTK&J}Vos;)KI~Ao%I- zIPbq$676TE{WCA0(fznZQ;Dt6g_COP&@>55S7Fokjtd?%k>ywEm=}(Fqn~eKhyQEA ze|f$UMo6@KU!u`;IuWCf4)H`<L&>{!?LA$3Kj7`7bG<l|!8%6{^RS+Q!Oc~e>cz?4 zV5DJ~;nw4g<^At+0hP(UWs7=1E9tQ5F08(%N$>g);rF1IWW1Q8;SJE(fQ|(+b8=*3 zq^e~@YMJVhif`fa#BZalAu&VHpVn)D^ko_!A0vcC`_d|Uws?HdxJUE&W02myzpq;s zpX#N;D(uRq9|qs-99j3q?aD_EH}`_CSLE`Z&$o(g6`aTR6`6@ARRXm-T|)?6C{OFk zniw6*+?oy!*DF~O)GYR?`j`-B9i*=)o=CLQA-5RXjbAF$KB#;)FI@&w>sh8<@PI7I zJhA--5L~#_c=}J}nMO~NM*IThw*D#RJZ9O}BXz1kD)fJ-rL^>J&#bPfvRILvkAsc) z1Ae}W$H2E>=}Tu`u+oHh$|Tl}J$2dBU5V=Q`qXL4V`;M2L*sZ)lQUSUo;kfBJVPD* z1!2;gzgYL)Tn06#UnR64$M>6=P-MZ(bgt^lfCY?W9c-G50KL1zOXl{H0jt|WV`AA< z>n_K<sPX~m6x}=tv9i;R4VM>V#Um;o(g9y}ncQ{h9#Wh|=3eUP4J{Dc;ihmTKUlsn zk1(s3%ciGBZIom3cWZ)Nbb~4^)>m#(Ce`nO=PR+6Oya6fLm}B}f@$-ObA-Vx_l-2o zB1uIz(RfQFW_wZ>=}~717)~Ni2c>2!N^N?#B-OrhUgn>9S80k&be*&aZ#d@ycpZ*e zJ<_eC=!w(Hnzjf0QQrEKYdJBUvB%wT4nkr)F(HNtn~$867iNO-v0n)n_3XogRhfV3 zbf~{W`X?oA4r=hxj}3n>ZIm0f`?!^qd&dkeEMw8=`F7~as`JN%lvP&q)jNdr-sUc% zcZx1%04DGyIFKZ=bZ_wX9XViTM)g$iW3V`(Qqxg=dgfe};!!3RU1_l4wjeUSRd4aZ z7%Yi){GZDxmrIg%0=R4?`zAH&`pcto+ruT_+ZWO{;L8Me_u2<&IflOK`>AeNcU%J@ zT<6+I)4QjV-@?U5DpYX8M<(~yZ9yl!FLVAJXiAYvAFf6LW`=K7OPGhIZj<#i$Q}p! za~-$a<x=Y{4}X+8_|dnmZwDn)3;DWzkfpJ~zZj$p8kmT7(7d>VEQ)4@J`n4`-zZ>U zOH}H>^bgU=I8M5wu_nc9-LTjC4D?AG+o`Vn@YdkqZvTK(8pSSnbEZ1E{37!&y#T&| zLi3juH;VQE`wuO?x~wP{^9~RM#?RID%0wj?siXxGB}?7FHt$&o(c$2_UB@l6Q3pWx z2{pv-<(9O(*+EIHvon7<>AIvUe>hDM{@TAp3X+R(?b!!~JenHpk4=Q`+uk<4bRFbb zEVHal`!cLGbCeE32|o#^OVcrrkQ~UrtF<lyG-^!l{aei62JFdab&6Dn9djw=oN82w zuJU?ax}1F57Yp6>-xd;a8JKB)tGwy?ZE_3UAg9xjjiQuO!5U@q-t#X$OKFQzCbCPf zpS7*2&HZ~yI}wj4z{XU<J8B_0mGHS@qinJ8=nB^4Zkrcs%@#FSa}r@7g*+Jy<J<sh zN1kt{LRC<TpnoPh_&;aa4~JVxb<%O+M%R20-Ziy<8Si44dis1~nsp^*aY!<)(njPr z@d<?!{>jz(a&xwMvE-{dDt!?rj$w#Mdenbj@_Mo_Vg36tw?AeAaS-tkwrKe#1cHWh z$(^(7@)@JfI~+IwOdvU!@ILyIHSV`0h7zdkaj#9)EEtB}AU{+if779j=`n<-f3fXQ zO>4C);Tzo4hMz%D<_vqW&XwXDPX@fy(9Q+X25M*nlX_7J1JcralgbMGoa2$?M}~LL zI!fw=*(j-Hz|Ty?>R=T}YEr~3u3Ucs6FZnp?7=g-a{+Z=AJArJ7r$}u>2GfPb4T0V z@+r^GRRui#WV?vxE^x(Lv9~TsBdZQFIF@d92Y8)gIlEjl{pu7Dy+ehV+OfssmSU=a zBAX;wy)9LB?XUt{00DH&^Arg|_X;*E#arttE$6hIc+Q&bum4&};=WWdGa2x+{arw7 z`z{a>0_^LJnS3|gJ@N&^0SC8F6uLyZj$!z-7cw-)T~VKfQD;&7iFAGWG%2MAEoM>z znzE@_^E&53eO>#+YwdA<i0-<?T^UN7p+|<(BG{<cu}}Wd0}}k){WJDKvJ5b$|K$=u zHI0cwJNna8CYT!)QtXz*UTPm&Nq|9l<<kdPhmB&*_F1gEDcsM3Jgnxz4IY`*wxw(L z0k>AtDqu?qe+~^11J5rx)1!?ewM|%VcnDBsA9%XsPAEFaBe!wI^W|ef`Qk}P1u??M z>xp(>Ll#<!a`83sgz!bPF;<$@C27i~-nNLr8i_rj3}g|)V^{F%uRLH&4f9JpLQ5pQ zpE!@5Nbvy=lgh*)LH7RBF=29iiR;&4mZK^#&L`e^1TM5}t|s2@;}`q-5#KK}uQ0oU z3M`cfBR(2#iI;AY`QMan{6)PZ*XbaAp(hv>d_+(vIrH%&O~n$?Z$`qGcRZoZaZCwm zK1Dw=0h$@X^X~+WFX46|*~m+^603ruMep<N)(zsdE`cYH1^!LL0uwyEr@o8Oq{a=X zrEQx$!<ZlSE_R>(o+ST{U)|JkbfIX%lpkJ}?4JI%pb78m!~78MRY1M~4xZzG40^G2 z&vknHOup-v8Nc!U#_oork}D1jfe2Bk-Mi3neLc5Orh9|kJ8Qhg$;w0nO{ZSb;t>}` zF!=t6{e;-06i+`yD-tQtcS{2sa(t9W83UKTY@zuKnPK3W!tY(yC#F?+UOusA*O1@X z{go3HPX(h{Dy&^Ld)J#D{KAO?K~mF;L5*{3X+9JiTQYV6LNL?!n}FF5Qu66%mpVZ# z_F9f!&!w&H*UY?F87JJ$2Q<QYyL}S#0mFncJ9BA}irtIFvw?`?GV0kYFriux%DG!| zeY}*1ptKM&P`vh}(bDMiCRz>MHdbx``pb5lG@x5RM>K@9T|rIIe!vFQEsmU%w~P$7 zCvd-^#r+i9a{?r=Gnx&7D+->%Gy|Tli8s`=-7A>0F^j~yucL9@0q(bjz7#~qdI^J6 zUdCUSBQ#1?SP9DG$eD-cSdi6Iyd4a756Ncbd%F=)=a*-NkP)?2#2&EII@1;MT}i>V zQ=9HqX1*+AvXZXd`0>lHj&ZQ|&alS4^pGM&O9D{H4o_h%Vtwtnk*`o#2}bs?%)Wl0 z$2HnF@3LsjcextQ&RT&hQ@dS4`BbOlDFX-cr_BzGk8HC-_OALlI6TAG1r#z|PlS&; z%NInE*P*hcuLIH{V66yS6w)!@^FY#Myx2nx&zFB^MB{^vTwOeMa_eDJ{HAx{xhv=n z0G6q2!PX`?l(<%+RH0R2A?~MRi;-}~wsuu|d|!7_0@q)Dx4BX>#bS4~$}5%HK+W;$ z5c4D0w_A>rBdbH9)!B%F)iPPHcf#hX$TaNqtDmFAG6kEMdM9J;rh4D}Ww8DSbLj*| zNaCOBMZ;7C-Sd0X+*{8V+^iK(1qz0D!DB%NHf_MxrZjot7fHIv=zp9O-o4UKq6>7C zNA>c)Ej+kvtT*y8c64gR<K+)@4+FLrO7pG!>}IO&orRWNt(l=+0g~N^2=-j$dUK$% z?b@C*z8U2|;<IEz!B_y9qIJcI274yEj|y%M**D1zVJb(IqrgxF!9$n}P%vVYoG-d8 zUYiMS;w8nuBp^6Y*QBIieKrZ?2bc|?h`^a^h+R&aObg3D&%~X-56CX8xhI)R)hkDI z<;M=uy+!<nchp~)FcDB%*%<hDMYOt@VsN_E^DO<XP%0H<)t{0Kk`}RK<#NK{%9O<X zTBN1e7u^sObph!ZAj+;`#8)|MK^j?BOS+A1?<%Y%oBRtN#CxnZy#6M)&qA~Q=!i8l z>0?se>2woKTY$=}RA$TO&jYvl6bzQH<ecF!#@4<niHRc!*Wj=fUAgP=Q^n8BU($>w z?OLV#h^Q_;ac-H1Mf3Q(mWT??gPF;KQmw?cRs9?wsYy(5t<mah4t3}d9!$9eF9ora z80Fg^DOvpmKVk>&kw`9yX{xD>MwBM!df_*AXg;N1JdDVeo9~l86Dr}RTVH5K6E3z# z*CedN)1<sXxfSu_o40$>tSkOfi%JHZaBU*OmE+{$L52#9V8BR$ng+v^f>{TWcU$8& z7T6T$2rhSN<`a5#6>Iv5%G~yZ#5ny4A33z0iRe>){jXRF{jQ<($_IQR64E$}UfSO$ z4}+Mn9`CFmrnJsNd=#C6L0WXbt{%z6b1E?Hb|F)Y^`o-6!inz9hU;mFAMK2K%KXoZ zZNgqOJ-`0FZO|(zX`mj!Y|JPJC#2}v&gn>fN=WjmRJS`{YJsgHtBdq}#o*CHy$Z)W zIIGTdTRKL)*xbRHE&e7H()Z?sib}{%wHVUvQ(Iu)(0!|cenj_vgv}!jS`>Y{hopD? z(I}t0{phO~ittk<0obY@Nz8g8Gw+~_Gz}Fp>aL%oUqL*8onC0I*J<QWjWvpnE~}k? z=WIE4zGoebJ~%AyCaSZRUPn{Mkp26gHU%_k9B9pfd}D=8re%yF<rF<0@#6~#zL9_S zAGY%-t7$7ZK8LJH;kLc1S}G7ww3#x{kX7=@s(eJ@$d1tZZmRZ$i<8k;+A#1$_ob83 z<5OWk20lEux7b})3YB)1-fqy5o#v<DHnXdZ3p@NnNpz}rFvFF_u>qftBi>&ADBT5V z)Wq;1d92v3we{IYX9FJH=Rz~evSosFy^fQj|EiHddtnkrx}iRa#LRqR-SKs-Z?8a@ zipU-gSKN7ENzCy|I<3q_!%??cZSGd~Xm0>Gol+9u(0&Ti=k(W2%j-=eCbwKQuSbmy z+t0wB#cgUn79-)UbG2wtGGB=9gNJD~_M`KA&uJ4UjzAWsvwu$QMHQzhqcWOVZLZ&& zt_uMXas*JDpQURC$earv2iN4a{gus1c8A*1ZWsHif{hI!eJyy&YATi05BCA5X5OG8 zDrqBmf_#C-X^Jw1>)dDEy^<j?5@;&G2F5dw0|yXnLH^N574}qiS~N8cx{D^0f27ci zE>E}PkxzGzOIe|udVmF4rhu$T1@0}-Zi~yO4`n6PJ_7bGyVv4>fR0|rbN+78#KKKt zJuHkGLAQ(AyB=egoeH>fr=dHF&s`FkMETL?;!ytGaaOkVcMzg#&POJte;zfi4R5J5 zT#M{Np2DaXc<UnsyYEZE>gyX)y{uuLWi|pYZPlus2NXoR$E?8U3mNk~9k(1tDf6Wx z+6tp^KT(A%RhuRKpZu;6B5ZA{7u8FFagMps{>_!@MBSHQ5758qugBtqM^g*YHSrqj z@&9HzoiU($?<;s<iNw1JQ$s3x3&$UEG|w|cUe?&~|IWkJ9Sl!lbRM}CFfJp`yH<*X zK_7HPb<MtfP%l|6M_i!?c}8Ei#b&`P4t(EG2gelq!Sr0sqWQ+>rtaQ&<q!O(Rjwb4 z#I<bzXR7Aw5=|3}O{jB*9EPWdO1cVR;ovD^HNvpuik$Mbg;tBC{tsjoRO$4H4>qQL zP*818kdpc3RJ8SY*p~Ze+Tn5wN|XMfZQCJAj-IeE8QF$WC^5ea%IrA+q@ItjN8Xan zPUXFrS)sRi*Q01!m?CQs7U~Vi5BJ~zV%b02u8#3FpE1+v8K#HobXOfsd&Ds|qq`rI zKAK@LE&#og<EX7%f&KGqEdQi_y%?OV?rkCbDX7iJ$1^~kz4V8Ht|3k0Xz(-Agk5Zj zKfg1nMyStramsP;H=Dj!^J#i8JGfjfBkOVzZeswI*ld3zpm6VmU|1;{mj}|vi>BwB z%G=5{V3sNOhX{4fVfr~>gL5$d3*4ySrI3gB3%CtkF%!L{^&v&{M?CgxWq=*#)5rHw z6%EdlVNB=gVvy|u*KHN~;M4QLBbHuQ3v93>&b|ouZo-DdZp(o9kEA=g9eScY)VVpo z_pM7+5+}RP+dIlpt};V_vkeW;NK4A-4zlIwD2nV2eK3hA?bh8Y&-i^9t{d`|XiJbn zRk}-N4uK{K!zxBT85B6B%w}qIw}#X)CD`axyUK-v?3fDg<gdZ1YGV5!NsLWR%vXt| z9U2IB$&$g|UR~RkDm`cCB$-*@j~A@%PpEqn-&FufD*&R)AGWk5P<vRow7Wx_?==%j z#xPhLuJH#w!uSJBLVn@Ii^m`Xa8kqIU`p2LD>g;3eGWnM?BfEa7vze2hph7$m{C8k zhDRlU?Oc15sBWYOBqq)FC91wKenWj*{b_LkWyW9Bp%iwo>%C#tEm$G5;b2KBht)Yw zW4;0Ejt_t6Z;4Q@ks{lCC&Wz4M4u3qMnMJdqI%o{j1)(xF{ZG5W0V%aTW2%fH@Wo5 z!naDN-Qg<DtT>w)TG(XUa?AE$;zcP8+-&ccY#eEamfsX5GNoTA+)P@-)S11#Kj8V5 z+MXb(=dSwV8jZc@{{P3-TgNrscYnY$&`U6`3lT*{3|bJCZVbRtL%Kmg28^N7HNJ>R zD_vtMj1GYT(x3>^l7mr74HzLcU?ZN-xbFLYe$Vs$OJ5uNe)7coyw5pa0m2HKbD=o* zGa?~Sc!tEIc-|uRYr9gh<G1`?If$b0R_5L3-KoagGWuKzf_6PIsTA$%Y^`<Q?h=z< zx!t}7!F{Oh^G+Bgrq>kxGQd1IyU)xkwF#jQWm-_=J}b{)5vOfAm1$g%uW`n~^QtIZ z<~J2eTxO5f27lHe07<v`1DnphS?Ds9Q9G;FlL?DeAR<cg!sW%-%tJ~o0iA@Dn{^4- z@v~pM$J3F|=;?!|uF^-^Ke{hF%9c>vj+abC-_}9P0N|s?Q>HXfj<msP8Ezt=l;wes z=_xuq5WpRSCmFwl>)DmWL|cm<_cDIhcI0E&k>`~@9hp5_?wxK3u^%n@@W)V>yPz_@ z#jsgE=jEI}@xw&c4b`0ruiuG&K#2b9c;p$q33GRRdCjjc!J1R-_opoqG6sjqK!=xk z9aYj1{5Wgpp6iPr^r$cdX1MfVu1HB)Z+_9Bi{lgi&#6no?;fMYn7Y4;cRI<7l825l zug&<f{N(?2I$c|@E}aN<78Olo3xhkjxy<2D+B4D)H<|SVAvB9;mnx@yI%q{Q#l}G@ z>yOC9k|B44N)>bI3h4YVy8{NPzRu4p)fSEM#B86w+EW)Ekhd>adR@2#5^We*2JliS za@yoDrc}0glSM^C<ejRC2D?#*q?-?r#Wg;G9lY)*U#6x)ecm6GqGbHnd<&K|e)2DQ zZX+eEhqtscL8}KXEXVRrp6Jzi4Nw+q6?@48OF}G(yO=yK`KK37r^uB$<J@zNK(>I8 z{QH`Sf-6Wyroj1cKH-*8ea0rgdQ_@R1yg-OWdP(M`c3BwN#nZuy@dM<p_aKLvgNPy zMw<@VJ3?<Vv5$)T#*3HSw+~%7Dq?z+I8!CFdr(nV1ic3ov7fT6N>kR_s;j?5LdQo} z9`j<74SWIrg|K=)#&WEw;11eU7V^T%6mVY8JDy#ecEAjd%Nemlmt~C>dkrr5jFZdi zY_oiX_5FcA_V0e8jZBigp8g0_$E!#-LAqD6bd^$LOK|vR!iUIGmP2MFDyU1Q%E@|O zv#PG(h4s`!lgprx(Gt4BD`RY||4Gko7t-I>EuLNHz_*Ue>k;87a#_)9O3X`;h`>H0 zyQuoXG@HLK#NSZfm@kgnN0sPl@8%dR89-L=UWCso=iSgNC7fi#?sIJNzCm`;`k#h# zMN4#B+5@h;A1_gEVG5aB_AYlZIR7Bgu})xi8(v@F*pWc>mR~e3chz$h3IvrE?EYn9 zolp-GWv6q|v=k5JCc6KOX4ZXPaFZWdpL4VBOv=4fAH_9_z5R((Ot`P^D?%UAl?<d> z2AQtC$qQvarwc<|`x<r-a!%|+K3C{U<oUFdx7yHeSGeQu3}PA92byn6*%cr8H#-4; zI;>y|`B)EYFXs70;=`zEQ*i0A9`0AURk2rD_672X7`LaAfaz1ok@ZaTZ>DlKso;z( zxd~l)8LmlY2UC`!SJ#@?dw?sda6Ijm+wjeInX8VLNik=k{j>xdvf<4RyMALe4Qy+m zU8z)UO#8qFbH!kr()BXzSpVTd*O_W+F{*GOyiv!FR3Q$ZzbKf2?*)c2c<j%tc>o){ zRPy(WJ0t!(r7l8N(b0~o^}<ZW)B0YZ`9yd31~>knBJ>1VO>H?f!70||wiYpU0#!Qf zq6o2QDW0(}9(0$uhp3mRChQa%1!xk{v!YQQkH$sMV^5{rMuE!&9>RZMh=xO^65q5A zWO}tUYx`jdX&e^p^En$n=VY8s{w|1g%^G%~)EoV+{am_QEEUX2b8~&$?Ib=&?`C_T z|41PrDZ4T&w(!kmU`K<;9=eyt=r@7BhCY&L_ewwsUzgPXHl%aDo17?+zCJ8Ar14ys zDMcvH_D8o$tm%VVljXsuf>HQLA@>{CbMoP}rga?_)aq~~S=(w6u*R^f<g)05M02Er zC>kqICcamfsbTs{`11K$c6?)K22IRE<f~rN{;OemfgJnwKhXRGsaDuP#nO(%hku&; zQI*b1N^97I>eXfI%Eg0157tv~=IJ<QQr?*C&GL?9yH^en`fR?r;VI^~0&k_}TAl9P z#qy!qlU79sonn(?`nHsCE!kqxZ=9iP%=hQw*?$(pu%$#K&EkN>kR|RFYGF{}5l5ba z@T>GWjV4ID+5w7@Jubyt2phF;IS+Oc_RO(0j8?B4qb;ktAaz2o=zzA&>;67XQ&pl7 zZy*p7$ZZ89<F6ou2`m1W3u_RJsJXxt-248cUicNJ+%@m%-7``3a%AMVz<})?88Q+Z z)bGNAd@Jx&-yuU=oNY#@T<EF$Xhs@A9GX<?l2Ch;RYVF^Bp-@nx7STT8(_^N@(1&E zn?A2oa<#tFdX{L;4%#Z@LtY*yV~pMX)@^p;n8<D^DIaPyrCJf7F99q%m3j|P8Eq^U zFfwtKZ3K`|%<(!0?MRX;$)X@3WoK-*6&sxb_Potvdx~Ku*xG;I5cYg>0%9`w1;2CE z^o6j(s^-$VPE$xbO${Ul4GG?SEV?*eJj9mfgK2IxbQ>NxUaY1_d{%NP8GGHKTH2i( z@6H-?J%_2wt-XS}xlvj>r#aN9>Oc`?qU-qs*UY5-U3ij5iq~L_qaJRyYD%Rzb$2ay z_NYD!%wE|sg#Q6@AtLP;6kFP*lty^|Ffm9{_fFy9-{-(-T;Eq9Vo@J;&ACEl$Ucq& z#ogz!Y#Qy}@Zhub{$%Q@HEWmm-gUt8_xUe6N*Utm*Do6g^2f4W4#m|DOE{1Vi-r;d zm^ZVkV%pB%-`PTjRT;wq5@()NtQJp*=ZqdS_2I(ZDp(S`mj_AyxcmW~i~d-eRHHl8 zu2Ad*Q!`fhP5hf3f5VWbM%J}&61_Aa-P`ebZ455<`Fh)3t2J-Z`AUbTW1`G6Uj0Y< zp6N;cM&96w!2{0MaNZ5KJZz0~9FsBISB(3mzL>ni+|vAfMW<EX5s{IjoT}tv-*=_8 zs{$l6#)eE32!~GHue|Y~*?Ilb9i(7V$HyYlubbExAGl#3V%(p40)bWx$h?&iZnzna z1XJMIg|*M=WCZ5Ly&k;BDLeQ1;n9b3@&f5^Qf|qke5Ny9U`oPHCoE4y&QTA1db(q3 z<G}w-Y=opGI=>)lDoZ?KYHWpQ()U^IxV(VJ7xd=veT4EdU_?N@;vt?Xh4r>vuA2#r zj*B@QLBIv-$h<a(%1)`w`g|+$XtX1L*EJ@Y)OH;0mf88mI|Ny1*HRNN9A0v(xoMO+ zR`UAU0J~O&B~_tH5$lhAwD5#nvO1IUs)^v*q#NQ0nMZ^_M%_hOV)A|SN}}D{TVFuH zO(a}}_OaD0KR>^&U7V#_v*BqbO0RUP(oZL?9Q$kdA%XSOe8beyb?db?keZQ>%;PNJ zglR*}ll*@^iH#<TKL&2L684}L^C%;`EUvW7*zEW5+ez;DIDev(aMB1qdZMH3<65PK z1EnpdHRa}S;^ETOSC93zvm%Z6Jj|J)Tw`N5a}eLkRx|$9MpAQZb^Mb+QkN-Z;_Ry_ zK^a!Rd9I9pvW`Nry}2VsUW#iuJ1T-H2*8eTRUW~lEN^rLW@h^i5vgUroPI2pm6p)$ zHjE$Z8oLYI0&9#Q^Y83J+c_W~#Mtu+w(@SVFj4rFx|%@m+<4aKo7K>MiU;WcY@PLp zX*j(uv3)a<f<y`^+0=8fTr@Tn*3i#d5Sqg4TuW~c)-^5YzoYnj%jrn`L4!wX9bz8l z75z8Y)AJT`VEW?du49m}0Xt{Y5!depqE#LMP~-o=k$$IaEtPiTcw&q19jr;E2JxBP zZ`Vpmb~i%jg2G%iL=DSeE~!Hq*`bl5Cxz=+U`jdv5;yg<Ji`^}sXX+W<tEi9p8w(C z>XKTyga<QTD5#Gdgq>Huli^)xbNwj;@;cplF8!6>pY&dnZ|mvngH9M5rU)mh1)ewk z^NnY$=BSKQ*}}u#7`>BBy)7r67FDR9-^ABpq42Ya$^>qIP8)$k&0?-M6ns0{gk3MS zf9N53m3E{oiW{>7z$bh^Y$pgPp7uK@OsRfP2CpYA%2PR<FKHvkOsT<u4*s-rm*^RZ zWCmozanannkIw(ultKL#DpdKod?vp5*9U*YUzuh<v;J{&W+FQ+NH8_1SYF8D*Mxj@ zywR9)g4MWQbjy*4`J+z44kL!X(p+^Ql&$|S#h84bnDEB)hVRyQkxRAsC}Ve}9earp zz*9mbFPwwo9hra!!t{jgxUS=Ux_nw)czb5i`kd1OaIObu*n(tmEg3L9Jh`Yhx|H4g z3(hV?;JeMa-nsIujiMc4=&c?5=F+!-^to@{uM_{p<$ljsKE;&3mpLrEAm;(y{Vgw~ zy#5KJZ|LLj8joMJH2^X1|BNgH@c2hR|4!k8C?u}YW%8S)@goP_SMpHM42?IRwtV4< zTxF6B7#|<gJGQ?lW8N6H4}~8>`xSMS)G6fxurwto9Pg+1M}^LBgtx-xwc6cLY?tWq zWvT*&7t}?ov+*CI^5G)psWDCc@jdSRb&nq}ZU_jYlWyM3Tyn~jUO*MM3w?HYew#@| zA6eR%1nd`pizdsZjG`{Y<V13KPtAN03<=NC`<S{LFY_jkVkr1Hb1{#}+Wn&Wi+tju zFyKGt1@CXJ+ET}b8oDj{N2Q3+AQ1zIPvt>MVHQS3oeSn(Uh`&64I{lgFsllIAE{P} z2gTKQgha?h{bCrgudp|YeWqK%$3a+>OpG@DGya-UWI<H?+VzDBHa{8mw)7qe=7v`e z^5_dTLq^P6<`HvW54y|5&8d-(At3<bpZU`3$^3S3mzmq3c+^7rcZs0XSqt^@gtvm~ zWjG#=BUj+Q$6)sE`|(pvpgbAzQ?Yx<O1p1;6f*`LErn%u*ZIG+EzQH}GuoZL&O`2< z$y^Ik8<pVHo?U-y_pW(bf?j()sr*r03<&djkcSsdNEVPxWA)N*h$0}p{vup9CXtzM zJFv$F8o>oPC+KOMO?G+uMX$}b&&3>}cDF<~<f{{-OJAFkO5U)+dc1oMTH-rwivPx* zn#Y^#;@!>WTxAj6p<i^?bBZYE)%xyS_nDr<eL)&*uTj7#e22`$62o_EQ%cWjL;J)= zO?BwND{)ExWz<l<@AN-`?tuFLE}!ysxPX&``@vCIW-TE=1B|JIo5?;~UQ3+P|2^X2 z?0lu8-7MbRuw*EjMJ|?6$syk&GCzw{A>x^$vz`t!Hvte}fI)A)ISA*p&;O}e!mI{X ze%5_{gy|wouOrZn!H|0RZ|)4FA+j$cXRGBmzlk_VygPW(1j(Z04HC6@u^>_F|K>3e z4!0larkOzHGKy5Lez_%;>Bt*LAACaI>wKGXMqacnZ67eQ`ZuGZ=kZTz;!ov_61$P| z@Srnqe8X#>ZoIBd{24fZcs@XVO=u?JXYofQbiXq=g(Lf@W^P0h@DpJl2Hjnb0z!=# zM@qO>AIP{_-PQt};_b26lM1x9V4O2;Axg4B^Bb`o5oSj5>Fgx?r=t0#HdX=KGNtCw zqN+Nz96!Ob!H^7_VUj5$?X?F90SCwz_hO&(7Om}`asG|QINP@-8M65-jz?5LnSlBK zt5hO>@x`3q=GG_Er@94|v_gMRTgn~J#hWjN0ln6l5d*Dr>k6$v_qZ2<F?9?fKwXF3 zxU)MeDUg}lpXUrpMD_notNA}!H9l$d`<+cqXBW7VM0W|Ui-S7_OBcuUQ(y6GH|1(W zAK<zE*5+)Px_>*5CT>L?_*heUJL-U(D@byfao=7}9UeXM&`Rq-1@MLE0mCtD4%!(# z;5kE;90n{%!ld{i*iF-YG1;U1ym$|!@X)q%%Nzjv{!IL4IwajrknP5Nf-IK`XyvQ+ zk7%BXlZX02_K?if!mzm&)fA%s%H}_p0eg4wj)YA|py#K$k(YaBcdq$5P&q~C&r<-! zQl*$;pwPe6U-RX;6|i7?LK*TRo}IY^WOm|Y$%}3s^5VKBTE7m$5-oX?dd4DuTVGN9 zv2fT<vYn&@dr)5r5Qlo%YKZ*tBfpU?p_36WeJ+FUnG>b3aYIS7R%v~Oi!pXXvlbw! zYIfiB)X2!NlL53f`(vJwAkph2^N(iV2rle#6@i;2!%#kltC}lEQGzFl_jotJTkwu< z{=%|Mn*`v%JViWDw>fn}xpspVop?>;gzAAinDpC&iC!d0xi>YsG98<{iOU%~-^7Q- zuKnE7!$SL@2B;$axUZA2^NoP3nEoteph{AyrO-FeyOe?obNRP&$(!QFSckx}U;iZ& z;F%QG%iC>xsgJ4w<)Cr)gEQmI>I5vZm`H}J9ffJU+Pkpwm^^$^@bCB$HYJ@pzDpO2 zenlR<vwRs_nBbvOJkOwj5uRi~r!)jU^a5gN^W}t9a&IYf{~&n;HLY5UGR1qC{W^q^ z80tLe+&#N-Dq?81;2!GBV2w4Z(gDKW8yegy$zy6tK9&87emx*#XH6lw-Hx8SHf0!~ z<({_i)rGYFa;gi&8(D^>xirjXiK)dEKP5&K0?r}p%RkS9tHvPdgZ!iPFa)$kSTd`Q zN(2Lc-jDYs72ILAVmF;ZriL*U*Cn6wlU8)i*HL?w1&a>!WFIKHoN(}Aq62#etVf!W z5z+B+N9ZYgepJS<m_P&O-Ptd{HN@2W93JcatwDbHbRJN{wVX2olI+$UN|PQcJtWjJ zT@}u>r&ERn<MN^J2P1zANhFD9PM8?yT@tQ4XSv$hk}1=r@%<@Usk&^?>-vk!cF8f4 z$6<_xwq{fth<6@Jc1;o;9JX`31k(=FkdXX^>_KOY2Tb3Jyp77&VRjLC%7)POZp`p; zJ0@C3$YUC0`%wgo_cyU>waY2LoN51G0D@^68YlaR@JH43NO<g)`^RFj>SMEJ>|#As zb}^PiVbtpOik@8qXW8033X=TOcL7PX9^wqcx9M5k6n@}H)|UR30J_KiCo#bRZ|q+4 zVm(Vkf~dN12$ubUt;G^4!TEET*Y763@Q!sdQ)tI`yXo@FU&IT(+I)|A@1}7UY7<f? zN%-e)CO+-R*r@tFnHN{hSWId1_Hju}0ZwIXmPF_Tp_v=%gAQyBA-Hb`ogTdtR!HsY zyW$0a)VVhwZ-IOX5?~o|`m2oSrqvyW>0OO#pMCOr_w~)BllHfl>tdOL*j@%_Bp-j3 zb=myy&n(8DMHbHK;wRFXmIWbDB!M$l-u8}Cdq9u6=$w<?$V<yk1X;U6jfu>*){`R} z>!Ir|*>{`zj>HNJFn$3r1DI9%Fgcl077k48ZooEN@V7eZ5cQllQsR(iaWmToonOKZ z>G29gr(1dCbYnYaCxJh<4m|f_C2l($F%xDx7ZTTO*AOEU7o$&1gT{odkRo)8reatA zo1TE2+_AO#Ms!ICot{@r-j;EJH<iIYGTombe(H^1*26U}D#trA;#=&DKtNrnHnWCe zj<Yr+HxuIWJP7+6m<Ar3^_)o<nk`K8Zv7=D3fp#}dw*ykqSPWuM|Mt@DHa5VLhOo- z-_6M@R%$?sX9%XXo>nec>2~IxUD6G+N{|rnx9;E1dgBHIUxHqmLK0+T(V&p@^_<n` z3NiW){HI2CRoLG4-V*+RJRpNE=v=El=u}#(z(OPyW4_)t!OU$ZqBCTAZs|QCSx%ii z6b=^(kW4Ik4GwOmB16|&HEvpsfLvZrpx5%CK~}e~2Vui_m^lvdUhdZmw-<WHfBO9k zXs~_J5o~&Q(10fAx)<DRm9i?j%;r>d8M|8CVGH=cH<GTT*Tv+m8z7iL4>k5LGE2HT zHLKcNJhw~2bd0idB_=wz>hMe?J-Z}*Brz3L3JN9=YV%ApWR6h~wUkQy9S$sX>eryO zo?YK^U&Oj4dvcGrPasX=w~!)eRS!#V+OLt&2ZpS|ge^>b<Y@^KyS{TC2%w(HwUKGK zeA3F%uVr8am^Pj#n!YSGz8~A{+*^)=w0q2dhDtNNV)Ii=+Dad^lAut&-7YR?i!b8v zgclF3nd^`m)f7&>2xj(z2FttqlhkGH@Q?e%DWskn!vM`DgnF5S=(^cE4^eox_xNMt zyc}mvcL4Vs<$uhv+AZixo85UUQ=v(?^2y%)uuxs-D(7cUyCUg4#Wg*kh;oA#O5B7F zz!D=){X}mR&#ZY`9WDDO{^7lh3Wam-9qYY1Z&OX7Qz~~ZCvnEI<?8+i*I1wF4%Gi2 zuJP1B@MZ%0<>Q@}&Pjw-qd~N$64R`nMWCDLH$~KOjROG^z4e;Fa4CMpC7*riBGZhA zfE74{r9e0OJF~(FygQPkdu0|c#5}fY59}PC4M@niqpMnhSPN~-6AFk`feu{7Tj^cy z=vV(X|IsZju{^^qZh0*&{*q7QTJA0Fe_*83`zJkj97%ML`0jx>?beXps|=Q&u?!Vs z3Yab%Jk>F?S})Bs?eTt^HQro7p~ilXk#}1=yR$AHqh4PDm_Vt<rc*km9o#XRqPupk z9F&DGmMrhwXYD#VeW9`7loF3>f0(`JzLk>;l9h2QC^m=2?*U6~JX{Je!V#wF*C4&= z^2X`->c;6%#r=$4#}mEfg56@^H=mTo75?*AcYCfp=IAG69v0woq<vPzPqx5tv+jCe z)M-TZU{gDH?VD?!Y%g~WnJ;Z^>B(v%)qJ;7AyD-GCo;<vW{=2aBvgPW;6B68oZb8? z4_r&;Gl#_j7_|^U!3In4rT@~=-p&2TDfGT83c-3K{*%CJ0JFFJ-&eAMcea@HWv*$g zg8D{}mBAoqaG_Hz{+kZ~UIr<_8IF(d(${Y`B4#G)EJ|UFiU-}r%I1JCz0X5o42e-S z><_SGEBAcXS;(i>t5hE!5dSHfhJ-UJHO#TXNc-jE7{iZdq<g!Y$J0yDMEQH4PyT<) zDExPD+V8*7Yc|?hpvA9Rf$mD{LJu;K4?0=(|AIaJ-&ex+b4`+rn-blX9<SvNXvoOl z)4TAW@($olO8R0K><JUYOS>T30aP+wt-6rl8_Rt7|E-uHIt$R$|NWkLUV(eQjrI56 zDH9^Y)xQgPQ_5)&-{JZHPq74EPS|BQUkRYEfhQmfpkItK35+TUdqdszpmFwck0yhr zUFNVUvjJGZjLq!5PI?{as<?z{U6_^q1(LmS`+&e;`0|@EuZh9^G6`w>>FbQ&Ok`v6 zX1c0?1*WQ{1q4!dcb|3DA01uVe!4zah))e^DwyLqS02l((t3U#(~6y=S*<<T2ug{F z5Fsf_Ah#XJ!^L#VG3f^Lqp;|Ej7V48`MH5-9Va%=!aiV5$dLCB>)w%oX;77H-w4ja zlx=}u*aei+IkLg0S0}b=P1}+W!Sp~-7uY}X4?+HUr?e-|)j7#Eztgj0Mez&l=jfW` zqsvk40{Btgj&e?g>PrE<_kf8D`ylqO3<r8o7IQQ=&~?bjj1%_v3dF}o7>WhNUe9p> zK}JTp()Ilr+ua9Z{x`CFL^a?f>|MhiW&q#oO)UnAbl?bq^9RBgoWpRyEgWGK3%H-z z<1Ts!l-HG3aJQ&MylKweCxHs@mm!NcU?i<xiEf$i02cNGU}6aVCT4~l@n+~?JwQwZ zPTzi9NFxcDAfP1q?-y?OdgWjr&MO#Y)L(+Y=xAAT;A^n<eLyE(i@6(GSP^Ignkf+% zwnK0YH{SOO6Zebu+{7-f)q~eNe!M&qx1#~l{y@CKgmIec2tRCHnY&LE-T+XDfdXb_ zV+RJB$NukQH;$(r?^jr1+9EGN$qB{>V#52YR&jh&OCK05k0cqiDaJUUeP`l^iK_iu z5^(Jq&yD|{6vltr_DiWS{so@8<1=Z1nWiMmIF4A?on0n^AU=VUQMaW08!RB<{tyc~ z5L6zqYT4)V#4;vK))e}ZF=0)N>-4Cu-OVnHi13KmpbBvse+yG>mFa?f2g2OLLP3eZ z6z|i9oX-}=Jv-d}H=PRKA+Zl&O82^`cV!usUo!WrU;K;|^YPu?{G@6gH$<3UTX)|2 zvo{+Xn)}S0Ox}3f)HSE@Y?kKJNKSF*^F0NsK`%kj#7yK@NrRC;1=QpPnVp-APNeH9 z|5o$>RY?v*U^$i4!F(_*9m4+3&g81je1&JO$h~Dm&WpE6p`~dMy>)EQc8!KqRV2TT z-Er#q{a6vREGgkP+r-r&>+T6MoTe>7CsIa*lL$sp84cy5C15E{lzEdX0mYSE$)Z|N zGf_6W=}6`aA5l^L=hv+9PtlM6y6up>C}7=Lfn0+Fvy4(Og8$NuUdBl7Dq3QFL2e#e z$_2Th`DQOb>+1hMH?I$@jNWUo;2$pj3nB<}ZElaHEX8|G;<z@6u7=pEpbN};N(>jD zQA;LM6sCj+Z|P&yk$JFxcOkJ7^=mq0r>?!V8|QcShANZJwRYS_{Ap_Zg|O#4d?Zc@ z%Y7o0*-<Q*FrXJP$?D*6_X7vJO^<lUTsnKgUF)upZrd9^bvH`%5>ib*D`h{s5zsGG z0Y|0HvGa?$+<xqkF3vh}{NoX|6PNe~4}E>b`EK#6#3oC`u4LzF|5e&3^!CC(k}LNc zc6QQoLceVIRgvYr7x-{w`6b_iq+>(xmNaT)w@z}5oTw9Ou=wl>x_9zE1SzQ}b90xq zQ_FdRt&oC`qL(7wbzuXc11uhhd8Rt4SD=)Vl8K2$IemI;WaWv%ZqJ^<r@uS|#y<MR ztzcU`)uDqowdR>tK||UP5FWU>7aw?5xlE2#Z4kMt`zrWva&6t1l8sr4y}@LaJis!o zKF_4I|I%dqR1Dp+X6id)CvI={j^wFn{;@2-vK7vr0vKE2+4&Qo9U=BEC+z9pBh<Od z-Kj$49>sKYmxf;CYI|6tyX8D3n{Ii4-&$ng0+`5nEavAC2wWRs;ev|`qoX^&yTGwC zlUbNqmaRY}e?d)bAVq4sF&l;Cv7&ZzhlObf4{oP@%krehx80dZ-wK3+*GB%33;BIn zSpM~t%I%eziX~}k_+oXFGiUY2w~*Qt@4f4B7IPL=G+H>Rem82VUw3J*gKN67w5HVO zyYN9HCu>Ng@T@PGU;ty-AF3uwWOp}HYWGAcM#5)yH-kJqaM0R|)WgkRxD{$Ji)Tm5 zI^<<(+(GZ1#@gTAA4IJ>sz+*_!tPXeb&@Z6`9uq;LA`~0lj%$7ioLTU7e@vp=%+?R z+7LCST$_C^8}pUB6I`C=8)qxntqOyx8!YA_VX$V5_HQTSlWP9dkQHlkc=;Z>(3Vdj zG}zoRcX@-Nxe+IG&c7d7Pc5pPuBKrU*ED&8rIJ@TE4RYR_H@h6!U~CgZ>t&GZ&m31 z=_E`_+oF8x`>7iGD;rs7m$2y@9Q9a%(A$F2&8Zq_y`XoeIBPM{Qi;4nNU=2wXduUi z?@F&0Hrln<*FA4GYOOxaAtutE-Ztw?olG25T;ZfI4DGEp4YR@;EGn;2t=X+b0=}m+ zPR%*>*6SN%TPwcMDwX)85>Qf{PjkXw+s=JZd%OLaq7szKeSgJK@q%Jw2BP-KweraO zJ%(HrMTO|f*k;L2IoA>X*-(f#0%u0k1mynCv7#gD;pKyc8O;wU++`#iMC5AOvCrK2 zY)zh^PgRW>`f8@9Rv&ndMhnERn74X5W6<lz%nyBzZ?NbIs*dL?JX>e2%eWemsbw`j z#PHL~@K8d}5zInwCok`#$eS&wNIK$1^<z@{MbTq%A|o3UT}ull5U=MYZ>sQ6DG5F1 zJKrxHArEJjf@`~Dz6zkKG%9!7Rk9*br<Kt<S)-CnJ-=g@NFikko^D<A16K7x)x3ZE z7M=x7GecU>yTj`4xU9)n#`_2~$49>JH_bbG8?G4={jdjpSKwL-ihDx~?J=)*q-0Ub zrIr7=F77d|T_u1F4L~kE8~GQOvG0ex3p9^UZB(hTYFJi1bz4J*zjuAQxjrV|d^O-Z zFVzw3u{vYzr$C!it1D=6Y?s*JQtQT!z0KaXv93&5#E%qmAzxUdb4H}vrx{9yzf6xe zscRsH+mWcr5toHs@g|A3>S<rRR959bgm&hGtzM>9Kq~X!?HDs?2F*C??mDV^J!#s! zy0>6IGeT-F%+NgB*D|xj9WQuGuQ{`dWUE)H>7V~_qSM^JoZb*rsj^hE6W2ALZY`5+ z;XCvMs+_^V>cC-auyE3xXZjq^=xZqy>QR9Yt<z$)HHqYDj_~FUq?)9wI;y@ztjzW- zL6y#v-mLdI3P)PV-b;L^<m7$IusVXr($ub&bVtCsIn#Cz!l)?&;EKYW+8JZ~`rs;F z^CXYJZH4pF$D%tGY4wzTuE8(~=^kE->07V57&p|%eaAcUW+E@K1Uvgtu#oy9L}b1K z3#+qc^$n_q1>`ZVi4p&p!bS-6u$#9zsw$GrF+;v3b1E^IAD)U0)pI7Ehu;-!YF!?h z)Rq0}mtj#sBk>zY3%u`M<gRh4VL|%u#$KD=X6&5`jz|+^Tz)sq><hI-%<qx0+8gg< zY&2yoDiNGVVL*iL4_@md<DKwH?(+AxsywfFH3gzy!XqK>LH|lrwjU63s?8tN<iZfo z#1tz0%4%poV;0}@DN4u~vfh#QB;9O&6Fye6?9AgeM{~_vJ%>Iiln<owggKFOwqkLP zMw;V+&cF)e23Q7Utwp3RGWvH4C3EZU&VPes)doWOR0ZEhiK}`<{e<6j?B0d{oGkX{ zeH=LnZPBuD&f6(nGf}Ko=C!-(#8AP`XpI=LRujIu4k6(Jxe7wniWg33P!!yDzPMOJ zEpjKuC#S>1e8X#xukI~la;v;l(q(Gky<h2)qh8-Ihhfy=?v<9)=0y3bno?SWR%Z$L zjX$cpi@KJ(KScSaNyFS4w_RkLBR%GzH17vj(^(~bpZN`3M~wIu`p)f)dE0`!{RmrC zu5f3~wzg|)y`)dq*DIgfdWEY#go4UBHQ(p$F{e`c#KC)NcX#jl#?q{E{ehS-S(FOU z1k_sO<dH(+e1pZ4imrv$TFQ5en-D|7vRkl9`NlLf&!ACn>pl|0Kl^{CR6z3T><2C$ zu@<q41D&WoS~Kz=0yu&4l<wwx+wvYGC(a71d(KNec=8&8Q7UVG_{Gk_-Df3x(o0y} z`dhFjO%?gF{d+zRV90a+<y`b~G`L5sz6aif1C;`+>*)Jyu@w`@&$5Mk5cwE<X@!tV zO|3^z3v6s~=JQa+;xO2}@6*-G-@hX?yq2EN7Za*nDxNeo`kwBvq$Ie3`ATYTZrAUg zn?SdUr-0r5>TglN1d}2#rYhyO->LQUA;w55^JPbu61ZDz+8?HC)%WrRU&2L)&hi{v z-2~e)7<6>N27D`m+WY~ImK`kH`Edfx2Eji60TX}3Faw0DWFxB3YvWd%`-)E*gV<2z z8!OJ(U}$6&@{j9^MBktGr|(9rr+z^lUbjQx<wm&^iaN7GYZfh$G>7DIH^sY^C<T$Y z#Em(3hcd|wMav<oYx^={oopXv3mf94TFWYI{Tdm$hlHN2@v#7F1-huVzc=0TO{2GH zN1<Sa82$>ES^Q#Ug!~vo*?WjsU@-Y3D_g3H1DKi3g^{>L`trw_#Wj%OJt{j_@C57Y zv1SpBjAG^QwD5mSFt@052ih~DW2AH<=ahK@eH||q=i6`bt*mp$dTsQS$Zmz~MqN*( z%q~uGt7{SBi}UZn?DQhYKTTf$jA--!thoN&E*sxOdpM{X3r>4}L7qjKh1w{JRTwTL zFIGzZ@!g+>Z=#Q>HsuLKgKs!i=0v6IlfrfrwIttsd4fT^%N=m{2PgBc>jF&lAKwM7 z6MAaHqFDukC+X7(NR`5tNAGGy_a-Lx?AMUx(9>!1g+jg%<#`@z;5QA1jF5uc`q9?t zD)3L-GLhVKv<&=8#olB$|1q7V&U>uN(jM5=53TN#KK@UaUxi&SpZFns8Yk823%|&7 ztSsrP-lA!w9$aC{$l+eFx$hN7(FLcIto}Zq5~aMVjcIzmVI|7+P<El)W{02_qagz+ zdVE}XJG*?p>jA46I2|0y81HVf@63HyO)@Wca7$Jp`hWxvl~iq}I{x9fNur)#uGIWZ z`K<V_&f^6Qn4rBmBzr7F2E2&{$NjT*<gXu!v}>u)L<P$xx%S{!ryR27giD7q(%JP{ z(F+e26Z83Z67L%ik%yK?ZOXz+A+10=&>mGYs`jWikFk`3wd|{UZ{B~Te+q)C`I_uJ z<={4~80~EZ0bys;{&p#!v#Z+ps(sY`b_++Ma)OL?Rc&L4ipQbizkS;cgP(buJpCu7 zrQnXvmaOZ!;Jo?7|1-4PpDL4XqqS0!)w)wt(&i)*RP6m^AiRf6#yk$~8qTd7>6Lv| zSLIHehuGRC;r&8%Bu@{|^v*@aV|k_Red%iUlkhULZ(ce!Ijg;7OWF0}hn1p&zB;C* z-6@i<N(iFF6c58nz<fx%uaRF(yNPbg!OGlj`cX)sxz=3FNqL>K8<d=}dnt5`SPHq+ zB$t(jEYB)HloU72og&H-g@97Oz{fcz7JpQoRY|j(?^+Vnrx7BySPwd(K6Ay&IE>oG zlV&4r|GCLhNZht5SUB$AQaI#}8Tx{!eIdQ8H&|ygB{n_v?n|sT=bF$wFQ&g?Q*7ka zKTwcvRKW4q+@;bTom=|m#I#);4|T%oZ{M)D)xZ9R7$y_D%5EVJ+T?rm*?1*Y(?=tT zu`+lO3n>|zd{7AY6~X6`83iPVlS4R4JX~RN$7yePDo!;B&wXnJ$rDJLWnD#vCzWDW z>QU$)rR!`){=03n`zAc4;-y~X83)7sJ$z0<7?n#AVZMY@pgpH_6q~}|PR8tZLf3<0 z9WW9pZs&1=E}$_jw}oSxzx+aMgJwt6`>l10#laGV%2=V+^2Q~UEC#7iS-e%=VcvrY zABzIqQrxvCNj_*aeQ3h<SMspR3xpP&9UH&0Tk{#nQ0tJFUCWqWGb<dcZ@VH@?YKUr zZz?`%osxD=pw{rX-p)hx100l&o{d5w7R@W6Ane?E!B}-V>U@h+l0y5kM96oK3v~VC z20JFi7%JJMXHVMlyIFCA|HX6Gz-zeZ$jq=tGXJT8E41nIoQ~wrOjBn)DBiuvvb4La za+hB*j+-UYKJ%q=(mA!OHaaU;K}B{~PT8R;v%wodL2Ta~_tbK2p&@P&m#Ss=alx+l z3LJ>F?ZG#D)QX2cD`PSmyVK3?k;;v6B`#<*SATEfx}HTIA5p730o79S7-y!+<K&2r zazGT|3wqMmEO&DSz7#>S=WAjlN)X4K);F%CR`1OjLVsc>Tt5(WMKqImXN{_Xz`A5+ zX__aHcw;>%c0wI$y{?+BSugg8l<wlLMTzRYMWRL^PK)0%j`rASz7e1qR6Wh*JGENt zJ<~EnV?BiT5_d3JBvb~wphKgn_`IHQ^H=#Mr=Iv>e+L)Nk+Kn=XsHxja4X$=s-m<4 znO7A@kM+u0M2^(@RERV+yX!;xNiH=W%zb&*iYJd3#z6xtCrgq>EMQh$ZI%3y6FhM3 z)WWF0?W0akkXx75EyA>&qmFLnYFZH@qwOQi6^W-&CD4x9wRaRL0oK01=BfniBW=}k z(sPEdn}VySkh12h=^agR%(#`EmAGOY_T`3nNxu-uSG;}G#AB$u)Hu9zw+I}LA~+%0 z($W+IS#{@FuGJEH*z~*ko4nk*zXNZS`{C*&(3le(=JM2MJf7j21MYrF&fRSAon@3B zRV6SJVXwb3=T<wyjU-2ZKFI!Z098|HsL7EqfsZ#}>N4=%l~7Tm=bV^uOzf0VJp&tB z$ic3=*>vdc;1(z{tFGbiI~}uI7aII0ND%#Of*@g`V7NB9_{gi0($n<9y|>jW4Hi#- z>>H`)7IgJjWB;i(R!{9msE>c_H%mxo<%m*A;9J(#m2AJQ-05YFH2Fjp!R_t@Ek)pL zM1oZl{4-JM79=<>EGO$DulbY6djj2I2rl<)%r>iEB&d1tAY9pxUS%Nd<LIFO+>3Vp zh1H!~;TubegNSc>@Wd*p0@0W}qiRr=nsdE8s%socpWvjFX|Bwz43s0Ns4se^5$nw< z4#cPV@FP6N?)eA>^Ti>L?zhfX2G#}DA=S4ZWTyMI>DnfgTg7^KXoiaAEbq3k#hZKX z$fJpcNgjEtZzJZ6q81;efZjPfIRfyIO-kKqV4DB>`L8&NWEDT?MbeWU;qCe3l%9U8 zt!90W_Od~XXG`Z=9l0c>kwBeyKbYE|Ih%NQM2_yHv!|!?$K>{GBPpcz)NzqxINpaY zz#wxc^{P+#Ma9DdXUx(~fl=4|c8LWuKJB%)3e0Xl;h5ESXbq7;H<a!U<%Rg0Q+BJP zbo)J|$23^PBUjgn#;L?kt$`)SJ(82Hbie>A!lu9{`vz0da>fsd;<K-MhHD)*KBvqi zdCp6YzHv8ac75|^0QCZ#XlY%`gD@6+dQGzodsP3$oQKT`Dw(KYxrye8<qSfRC6P}c z(kWBCy)g=sTUZj;)Zr;;jEJ+nC#&D(+&fMeZ`Y<fW;l~r%4-xcYll*=mG#K9laNVS zpT@lQrp|5P%+Bwa5&f^VPml)UNH1HrIL;67T1!wDqBJ(b!ls=cvw5aJlM&s$Q@fOP zjBd`Eq$V&VfAeu(l#{O=ut0lXb~a!7GqTSmfbQSXtJvMqwV|X(hhT>IFh~BdgFOtZ zcEpT4D{gqOs!cgUJl_zNU&4$8yOwR)RPeF?s77*m+%sXxeb0uae&2J1f8<Bm=;`po zLp9DsbE}PZ;^61~R@+2Votvq~nTkWiA0rySjo@+HDV;_ADm?ry$xcJOypE7yic{R- zyW#H-E2j%*f2X=u`Ni7sb-lwx`6ayJZoW;bAQ^uzB3vUQOiN`WF^P#CnR=guG3G>3 zbzJ+WNTt~V4PkwvHU&SqtEpzOfH%$;R?HZSBDDEB<YX*RYZbg#V-I(T?YOB+YSN@q zE9o{^4$zoXXK&E1N%Pa3A5>|XZkG6Yg#S@*M7KieU};kFgjX?d%hYaSg~C7L4z)o` zheFinOUeojNy!<#tVc_j3IrpkDs&F#W!<{2k{Fk)xFNJL2|TsZXPOS``J%dd>6q2v zo$iA2*B3=F36$)T6&Xqwrwl`72r&a_&gysXkBRL=ip_z7+&pmT-Q-<`0$Vj6#mF`X z;z*{rc!hu1JMIfB-aN-5-RxOJz$%V6m|wt=zrZafrKEQ^`B&$0FZ&4VTBX;?^c9Sv zPpkJ_B3XLH%kQusO@{nHF~*qYWH87_jIq&wev=sE+ID@gl(X2(ba7#}X=z|nHij<e zz|6<~O{h5uZU>DNApXqTvr&)hY8-Ha?@x5ySU$!`P^D!H#k}H^_(T@fi{{x7LEJTX zUZQt=p#2s#$G?3n!c5oPaM6_X{?ipF(2H_jQnGrv@q#lm>@ykYn3S1{#oxef<MZ%g zxT$XxS3GgF71fl4F%yzFsVx02Nu#ut3YXD<)W&VyT*Bg0sBDIuHr;>CnQZ%$c6*qm zhcLAy>4ik3@HtJAb9b+D5+^EFA*lrIE>fwGP&TrI9CY5^X%CldE$N%t*^yH2(cQ3^ zPx0CFykrc-x)+z&(NXLFx`z}_ubc)=;ErCQ$_y70g?QI{a&NVJjNzK(AynrGnpNGo zuOO)eQe^dg_V?u2y0u8WBE#Eb$x{*Uw9c{BVLfRY_H}gr9NfSu_H%r!?Z6`4w8XXF zwlQs?H0iGde5alKuF!^yBvE4a-!ZkLDjve5_!}&Wm&$q;?4<Yp`@W&M;UVeRL1viL zU(OzJjQ9(9el;@09^(l(z|Zh9!BYog1JFF<v4WM&fC>{Z7`3}=!qbgQ#-BcOT(NvD zX|V+#r?NDKfCVT|Gccjw!`_qVk=Z82;hn80uIk0^RbN&W(=CAHjTS9wXA5&FE^9&W z4+LOlBeZIeYz2P1U8kUM3kKLUQQcr$8DrzjCy}!$0L5NR-N7U_1k-t_Y8M&{4#A|n z_K}=uZn4OVYK8ffkbSRg4aq73(PoZTFu=4dbC=FSPdA*xPE8lJWa%9P=E@v#mw);b zDAZ&lOVjEBi$<VSm-8v%ZswluKn_JF9e)aa=Jrr)TU&6gok^+QZpmB-%9`du%<0P! z^qpb@&4OPp1MJ4B3TNZDQeRoQq(I$Pxxfd{{bFfd5NtU_30MH0_HhKmZ92z+-u^i_ zHYD~u%2u_s9QakI6%j7T%!W39{^MVTXp<d-9FnyJfc&OcmX1XM;KUL@<j}DD2nM*= zhIF(`E<h}Jg4XJON<MP%=2?(dn3#^pE67V3`(7UIZoXmVn%gQX-)}Lnv~cKkT%egn z!uX0QIi)&ZUYuz<Oj}ftyFcfS$;66<b+s$Nu?m%g{y`>S9*Mj?G#ENS0RrGx9Ro#Y zZ}g2AkvV^5XI)ou#0^Tsv#mvnwY;5M-Y64oe^}c2V?J_1KTxn~Yk1JNz_(z8oP<o7 z_4isP5~~d<Uu@~~aarLj_s!9|J(o)8({dc*7ODNNI|6r0uYHet7hEg7*ZMF?@So_3 zNk6z628a&bjR=AWIV;Uj#RJ*vm!z%cn}f))Tv@Xw#k!^e{)Ym(Q<^*VB;gvy1!>38 zKEiDkzOHCFoPmAncY#<ogp%s#9=-huQ_EvR^`!?KC@It)|D2d|`<6;*)7_!4GprY; z&PjU^mPa;^9~<N?Xpog|B+OoQ4TrxdUD@?WkJm7ZM#ZyVm@?7L)G#BZ*i<0|8(WZP zaMQ&NPfDgOq0%g)yb(!qM@g@Tv}b;8*fYu{%=*Xcsp#u=Z64lJ!|R8~({?Ir&J8VA z8doLw5*u^N)8(ESV`9d7_>$!Ne%!Y%kPNC0IHbCN26|E=Q9J_L&9Avx1rv01EwnB? zA34uexU=uCd{n#nIGRex3U16O(y->H^EkY3h`O-K3@H+8)(=1GwO{AHlYL^{B2rTN ziGsSXCBXdblX@a7uOBzCo*_wihWhUTc}sfmfq)R4Hlb8=hq|PAICeRrsCl#ZM9(;k zwyxuGuI+=!So-&mk@vs#CECHe5B&O-^Cg`!5ha_1t5o34G_vO_ygMG%KK{|;C!#cO zGh;jzg1d}1+zKjj{H04gd#19+s6=0AK&!y`mfo3$UGmZ0v94RZ@(GfcxTZ~V>SD%C zt#b(S=-gR_$}orf1!tNa$NXZw#G2ZuXU3*t&gBGqyGL|41sR@ho!aPB^bwv`Piopg zToK-|-j*wFOhPM8`*a)XZ|4|!l61q`VnEaY!fEe2fjlS)^?dGQ%XzMyPuOsd(XN`_ z31inE-PQyON@u|`=q)!NDPz7==UM|rpyDFm(v(TfpT(t!;5QB^l{<#F1#l&=zEg|2 z?{?R4>oIUgU-K)s$(iFu=6hbZGguM8Y$2U%ws_Sb*iu4A(vxd#=~S<nciCM~k2!9b zgDb23xd+2M88$fkE-Mx&5ryH1_!>X$^kpE?s~xz+4p~{Y?5(cuZL&QVG?<|oJvNae zj2K;6);{sBrSoxj)K;-ZaYDu@Yi-)i4Lm*nJ3@Tw@tM}eVOv^jgHlk8OMZjW#G#~a zs-O!Rf8>dNsK>{0YSoG>4U)iRjF`KQ7^{oWOEJdEp9QHU%Le`hMvJ6?yi-pICA8}C zAKS*ncdM#YG}7${-J54rC`fW>LcjL@XwE^q6Wi8J075?+3J{RGcpxKR!dXA1n5lpL zm`)qa)sB1lAWY6V>TkH*<VIrmvwmxH<~QcJbF;MBP>cB}jfrDWCUqlGfuD?0eL+6& zA}<~W@EJQEFULx?al%k9+k;sgOFKa?CO7M<y+7jC6Tj@A%j*u^)5)nRQhwvx6<0?N zQi#ff%We#dUNuo5`J~2I2a)+w5!&qMaRxGs$3XRU&u_L8`oVpb2zldiwJF~y>&Ue} z!c6M9LR<~xniw2b<1vRMYK|Gb$e)AP8~5%?PnXo&c4~!1ktkZ*F{pDmYx!G`&RlIe zsuE`1wtH?cKgGZ)BzQ~uP<?hl{Horv@DR~`ihMCOB^PDWB{4crLsd}^j~!J-S3g9t zyMzs(`~l49%+PKc@5DuKM}Fxa$}Ewv(`PDu1`TOm;(7GmAuv*iHvY;pob>*1lfkt@ z)ItTE;>&FuIngJP#8DgWa4k8?EWw~|Sdb&8Ynr3Pf-=wZP%kyxScrjYZcrl3fMbiX z>JI^Oy*ZGUku>?B8h5z49GD@i_dFR6U8*?|I}c%6A8bsMCO#IftF}ylKV5*9p3DMU zQ5nbPQ?<AL+`qPGN6cuU#$nZ_-8aLtTOk1ZrK|9+b&W|>zIB#~;S+->>-2^EN(00{ z=~A)rVi50<VL{%!0aW*v<4@x}zOtBQ$`|$v7PU_*!$%0E(aXO53Oosh<Gm)8;njRp zps?sK7$@a0oR#~S4l2GEih5cc9*~leEc?BjTPgAb++_-&lA^i?ZFGFE-xAG>|8m-4 zf-u=*uw$V6NIx)L<x`oi-B$)$honz7a>KtcFnSk1aCP+P-lM3~S53e4Mo5i?i2{pf z0JpjZX1*n3hx?Uvzsm;Rveq1r9(1r2)1so22}`elbq49uuPh%CO1Z#!y;tKe4uXEq zi!#Kkc5A<|Dy-V08wDm4H=zC=chdwmsE;tWD&*3ymmKBP_e5ONS9aptS&?C%k?4eZ zk$(lTH$%t8Up@9NH2sq0Hycs7M6ceR30-EM!pO-7roAm+X?e?C?W%NfZIZ(WM@&?y zwj`AD*5T~x6I@NJM?&On2CQj5Mw3D04Rt4q--+?h%1U0L<yh|2H}+yvvSr!A#dWtr zhx&RIzyk0kP5!X&b-_86llZJUs6pXT90_s~ku;~M4}&d-deUE!CP@`k8cl)+?)njN zZfZM&<`8))Z(-G9&s9a+axO~pLTWuk->9&od#@>be^#7M*gZF5bZ~YaESe1_5@ot@ zXdukk=9PEjNr9VviEcv)`d40Lv7YVoso`0g%Bo|7oj%&{mV!=dny5?EkuNkOMcNQa z&(Oo-myV_{i1+y%@hy3g<*4~(f&CI+*6JjQSN^wD>&}BmH#XKtJugJUXqT6vGVu^k z1^|5U<T>CV1Zdi>Q9XE`>9EZ36-FLbjywsMnj~{;I4*>nI4K^BCZ!7>pDyN>E<#k6 zn)4WDYsYe{M#@X8@D#4JP@%20r6(6fYRgbT^9JFjsCV4Yq7Um3`4Sz?Yuh7D;q3T7 z@rM!Ny2o<Vwx9ARJ4GG?n@bIf$7at$k<niYIK4+ALOYgmi&3I{^usMx@-@xN`IR*_ zni2Ye_`R+Bq7~bE=J#szo2UHOyqjlM94J59Qbme757`{63Tf}vR;4L&4c(!`JZxi) zuDpm?@y;tqdamuQhAJz(ZynDfJCKp$mowXw^UHuzAwN{$n~Y{vgz!5hn#3kUbHx&` z(Hs=lUX}2VzT-y{vTqmKTQ{vWT|@Xg+3b|Bsdp&WocyIV6~9if#AZ-f+@uktB4Z(Q zRF8gP{%Gs7GqWDb^X`}=AZThbKs@6n5-!9o9X<J=(n2+_{9$Thu_p7g7&nJ9ff7y4 z`h*5$Rwez+*78W`a<exnV`*+PW;?U1XHYRHVIlPRn3``MyoEq4(vRdp!@mmCOO+q= zSQN$hr@8PLcW5SF%Hrzs%U2QG&^^`1Px;utB-O)haYKyw$EfmTvj>pA=gAqNMT%pg z0g4i}`LF?!P~qKR9q*Mq1w>U;yzN_SM90n)-JkH#_BvED`mEjU9ZvVBqs<pmx^=l6 z-e5>i!x%yAE6=`6R1k>kL?vk?jW(v1)QnZ7RVM_ClCvb-Fme_8d&s1DOVl5IuD6Fa z_zH=PsaFXwJQqHAm`D|!p4yuKzJGnx;93FSf-GFVE4D#hMVIfNTQ#push#{2Bwk#E z;uI7+R;;2LsR{4ZQ1jv*j7)1!Tb(TCR>}^LaM)wm_GKEHVtI<Z)s~bm1TqJ7)wy`L zy#{_8&&9ib;OOXg2i>y^E<Py|4$qvT+?B(_cB&?3Q_=^7X2k>?T+894i-31u>d`DT z-FLQ!)+nY{7tTYCXFC*HTbpEbh0dJ<4GLK}_R(q=%6Y%vi)t$}C&ix=DIBz0*7P-( z9^G_{o+uno^D0U|jCD&99MG@TAVE5oPW@a_qqr%#o^V5YzwYzZ_{h_Rh9C}c@h}6H zy_*<qmf-G_wxE$3egC_`s|@4PK|zPY!CQ6-3ih%)g@g1YEHdY1zt`P2_a>n6XmROj z2hy6>ghV9I&iGyva(JnYux{odHS%-It|Bd;OH;n!Wm_rz(-nck^FhWo!6S{#Ljo(q zZ;hVDN^};r8x)QkG!0~1da$mxugZ-?*W1p=4^Z+L2a&;)fL(MWCoyeG_GmqEt4h$Z zzpgqxtQZl#lOnF$v4M(!=KHm1pe=+f2w4K{Q2Fnl+(+M?Tsa9E&z3e5v?r$DH*m}n z#k@c7ty>q{wWOMAOo^fB9^GeQFkj9mZ>wSH3>yx1GFfQ17AS)f1R>c1xHnSh;4~oN zPfzr4Gd!8vE@Bn<G>xMRTdLTLh>OmO*RsVxQOAN(sENFq2?R>b0A6?qa6A0|BhB|6 z)05e{=0x+EDDDUm;LFVtAD1(JC70_KmiS`JNkm1KufF&@Z(QPJTWY(W7MWJ^u!G_B z&7T&AugOVBoY1AOf>Ob5St>6iiDG(|Z6pQQuU`zjFF^iju@(~qWAEd_`XM&Hv#9b} z>|j+#OP8&eFxw5Xl?;l{jGSu3SQplR``ZWz5`H8P>ZyosPy*fB*;Ei<JXP-%>0_wu zRAb`(!Te&=s-jD+rs?MA)juVluY7$1GoINmCf(2Xa*hPl!-smBbwBlhn{@$3dH%Z= zgQ!q9stqx$-)=J3&aasmZsnxt2VbuS1=rI0xSXn1=t!-x36YjdG~kV?232yC72LL| zT^R4l=7=y>)z1lx(DaU&%IS;?b7P7nHKi3j;txE~UkU0NBpYgK&Hq!}na4GCZF~G6 za=BFtiW4dVG6)D3l}Qvy6+{ymi#R|-5GWKdAXAVV!@;SFGDyOpAfy_IB831l2!R9@ ztD+K-Az=v73lt%Q$QU4oynSNdyRV=2^X~2Y-1hFj_=IGiwfA0opS9QTd(Jj}7v=xx z;JBw}XG|?GSwpA7JSbGBjMwBVy~?|qhtLR#b4++R#is9d3DlVH<Lw)NTUd9A%RNHn z4c8*c`h{l#(#Q*)_@Fpt4a#i%`%!W1(Jva>^N4SU$DR~3()!#cjP)D(yIwG2%&{c= zRJ5TPvRULSNSi&AlS6I^G3^}OX^G^3%tvC38qyy0jSScmD}FLoB!P$0K?C4R>KLv> z|8kE<Q}(<`s@lbJA=A#<rR^=LJa6XJ@EM6jj;n>uIm)VDf2WrU^OqC1C-K7MK-xt4 zGm?hR>;nWqFgWbR@0P))*3Fx?j8g_2HTKWR9^IhE!O;uZ8~9|>!c?nzveWwDT%gy^ zxW^rLI-;Jpyx6{_q4}~H?lt9Ms5g0&i=VhxN0S_;o}3WFe!)$?J}Zfl?nw=VYEeDV zsy--oDHs<Tk}cpJylh~L03;h^H$8gRHSq7X3cBbntG;0ySnR;M51dBtK)^AZYV<ji z=cy6-@j+9QMy|b9f0L`O#c3KAPWX0%V~PU>Gg@<Iu;;!MG1X(J3k7E-W5n~VL$P^X z=Ir1rMU_?boSaIyg%WtIg%TFt^A#xrKM`#&2h4<PFT2!`%bS^;weq669AXX1DhoT^ zL!_&rotlU+5BWuRDt1+5P4up0BjYU((*v7M-@e=at(ctNhuo&qW*YjRRh7G;;n2X6 zG=fW}mQBy*6NklY39p1ky^rtoD;mxVZHhM}={;?ciXta{O9ReqO!vkaNQbn#N?WLS z)4greNqGdhL3#x)A>zPcuKk?tkQ>>Ulp*RSbWT@_o)c?X7;S)&nLfQIded@}f-)*v z?9oGj-U9vae@Gbkm?pZQDLNa+8Y7!_-OsDqxnrXzSr@JA6;-HV1%R%~=-o?fhi2c9 zP}+I=Qm+X*w%G8q3<FnkVsm6q>+62u#r9o#=+}sLMF?OTkakqq>6acNd#B4x*BwbJ z=|&B?GNZQIN-o;(_2jzibEA7h!=?iaYk%bC6<O2Wtao^`=nt9+a}7=xj_QSyLnCr8 zEP?>U0caM8mt!;nC0?Y2oF(WdWf_?Ncn5>=*Khkgc4fBGA|+iop)}N?O24Olj<WpT zFeTKRezRD^ri-OvgRdyIXQT_d*xlG6M%6bXT624(9U#kqD7Qj79upPneY><Jols4C ztdw}(0SUh#`lKTeu|FWR&)ubT7bVM5@*4ajn!!Wz1x(3-ip=o<=UqYE<na7T(JZju zaCjazp-<!x_ShykoebWZkzCP2MbETncv@lXKBLxGkUITBD0a1D1PpyVI%C{p8cS`o z0Efx0Ij>-X>d^|lzyEor!4~b2m7DrOO6SM59aPKa2O6$zspX!wW0j6?%!V+`p6Z${ zD>4V%eb;qhX-vw&7k{0&sqeYj@D}WubjRHH!E{{_^-bJve1MC1F{EYh&k!P`n+1+X zNxZlnzbeLQvk{s+;MQrfP6vBaV&QEYb|tVWnrw<rXm58a$*KGHjqxa7Qzt#ox+BIZ zH?O!mC#;#1X?gD`DZjtNmaNr$SyXxh?C?7(UDmzBdfIe&n`7Bo&kOqDqvU(^hV|?$ zXO5*k|8Nnp)l~v4Scas#p)xB)7FGYVO9sj0#Jg4Y7!BR3pl1kp(He{nM-tn#6&;zz z&(|BEy$3i3soL=q0UN^d0t2IFI0VtW$>g;HXN}`XuCujui$~_9^9D5FAdA8Z2vt== zic3fs9p1MK&>XbDW2wi{g&2)*r1jYx%0Q89(wEtHNYqwcK7XGciJ=Z^4%duQ2{mX2 zdP~ybrvSH9``Nn`)I$DFwms&EK|Fc*f;T#6Kn6fTyg^1?g5_xq?M&m5`E*YDv}3nN zGdjOLM{hDC@KCqcb4sN?{%$OIe>MfbBju}ZZ(0k}KK{t_{K{G<0(W{KN4P6G+1sIT zzCgtOc#~5Rv3nnLV@IC#oitS3OrKE0(bi1^PjPCi!7D*(+MkT+b&04S|LzL_y#1g2 z6rrOxx!ctr?6E><FvCKx)=9gD#x_Dn6*!UH)}P4ZY<Agb`9g~KH$`Xf;#OL@(Kp^d z+0prRbSbHO2t6?{+eSZgul4U(i|IB4N{dC`O!9J0d63JM?YLh8SlAZ{mEb-P%jKC; zzAlnNFQOzhR7+UEd948NtGagq3!BfJn?q*JscT=)4PvvIX`>Yn6>x;!Z6{+ljHcn) z@~%p!l9Eox8(G`B#-#i&TC9W%=)RL#TDe&Tp&WLHbz6%ko)H^DHpUPQuY8v-_U6V4 zd>Rj_zI8#o$mTLgQAP4c`;;NoXPMc8g-4}pUmhguwLymK4u`>nGB~igFj<?Eaj4%j zFtUG2P*nn+$k7V&XQ=4Tbn7VSOhlnNn_iR)Zm8k#G@dO&pk!t!LBk2h0w<NHKlX89 zSQb=nrL{<+Hw<m%=C0`LbXw=i3NY`R?-em`eDQhWdAHFju&_T~NmMekRuI;;q7L{2 zOvCYG=K{o14x23u;_UKzeeDfP*7swBu7~9h;9v1mSf2q9?yN88`Y$Jb4g%CN9ztws z8MB$g9q{y3Cj6fMP`f$KOkhP?mdINQSVzF|A~C#bvuREJ6a$_at7@Iv*7$LdnJGTT z3abOa@7hrW8%6?M_-qBpXb)B&6-<j6y_0ZlWSQy&Us0WGDN<b)SVIwW8|MJVyMX(e zH6%at>RI@8#+f_F_nf(l+yPi_1G*^&sc$bxkk2=jF!*zM@(=1d(Q?031Q|CKY?m$h zas}~W-*TeTYlU?khr|!&-QaxUP#SKbi)mhaX`AZL-1x%cUvlFGAjlYk<0ix81DA9@ z#xdkF5$8ct+0r?+L1u>dFw19NBQX+)E;^u5TNTE7<9uYo8rfKud|1BlUaogy@$L+< zE6V}7K%tJ(b*E7krqRqIznd_azo)*JeMEhX0I$-E`1;zmbE0BL50(R$bqFf61w91_ z_Cz$$QWBNLYX#CcxkJiWb@-B(n+2KcU*(Cfg)0Nm+MH((F5QM?r!MVtDqtl{n#yJB z_Oo1b+^!imfx!~hgqt~E6Faf==Sl~52UyxbyEo08>$=<kL%b`93Eu{$ToUj<c1vNB z)Iu(mk0-HDi;9TmnDu+j1sBg4P4J(^83<MjZ$o8(eZTHH`s4({`PJkuA@;A4ErGN) z0}+A)&~O1@E_>x|l8-3)1QMXBqdpW5j*&QUJyEjsX<ZFFAy@k9(ZO@?kH%rg5+Y%V zI+NN!EMbZ|;$%{8M8Y8MBaE7@ahvsl8tp*T1m=)ht^A&_PF(wZ8;lI`EilA6@G^Nn z*ci|_EFo%P{5}YJ)+(s+J_P5E78b|x7xLGp){bj=v+IRXl8GMN>??$Pmf{%;=XGRb z^rLbwZmfJB4i?CNS{=91?}VMe$SdOD*)K<*=&dA{>yC}d1&dzZK>Fq`*n0e=^Av7n z@4!BlAycXq$DgLq#_TQ~Tj;|LQ|OQx-ER5=CwwaNYQr&ifAckGjYj;^kl|SR1eLFp zxc}PqU?Aq1I^gc{mcD&Gdy*S_UJk3M(Q;uvc%BDJbQmVa-+oo1;%Bp?BvRgfx5)g2 zI`VUy=F9}}4vFiRnA3VEhc`Gl!=E+Ynmomgg+<km`jCJ!JY&_!4=#%u>yH_!RKIrH z9Ul`C|HRJ(A{4+mV++7>Bi`@jZ9w`hWx^44XAku9aj;Zg1LYEVIs2edc;AA~1SeK^ zbR*)o-@QK&6W57W@~fFo=O0)-;ul6*mQ^*P-HC-xJ_Q-2Z|4W5tGwELA8CJuT)H4) zidLrtY_5<pkdU8ybsMD#M=iNv3Y{#ZTF+5^gsW!qkuKCH72=Hcf3Mz{3fv<Q93<!R zaPfWN)ovOrPT9FEv1H2P-GE6QXT7EhQH(&i4mQe=jq}P6!P`f~!|_m1N7`tMWrF<W zD(5m1NSnn;1h?$cL$j12L?kWDzs<y@tA#I9G(mVE3f^C?mU!H1e_g~6jFP`SHI8Y6 zAXO3?paMB+1fY!#noeK9mgp~Q^cTWhs3mIkoXz~>D>0|~kuE>~{%R~vTsO8tzfOtg zjH-~nvk#eCou|U&t_ANjm|E>tw8)H};5}ZSI#Zsdq;={%vYMO^(QrH<MOl2_wmNQc zV!~lbu(axZzGOgsG{s)~g~SZ@9i|pMc*BNvo&k=Pi(}-Je|b|y+2by(4E=@6@X21> z3Ug!mFj;favC}4RWRFXQ3wYG!{tZ|AHl5O+QkkI1Dz8IYz9!As?e1%4R6$GqaKi^; z1)@^O%o+>=&``fecIrq`esKKGCpoq;1<50Q`cSdI27mriqE+a(h(-%ML{YXOtF5AF zBF~g4%Cav(oTn&%`Nu_myS`6f``4?3|A~FSx4z$79sK7u_gCh@zZ{M~y1Bn<Eg1hl zaCCpw++Vd8@xOoFTmE@{zqh(i{;&M+apwPrc|Xs;KV`1{mU;hue)j*yHU7+{0RH2a zmfvbFSgMiokJiHfN#_HWfbsv&Ip3%2Lw~CC*?`@V9QD&HW*X<jyLAxqbTfLtt7GXt HzjOZuy#N<S delta 54395 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%0AR=~>cYpB4^J}tI!;Y)*eNE>C=!6p` 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 diff --git a/architecture/filesystem_and_filesystem_usage.rst b/architecture/filesystem_and_filesystem_usage.rst index 4830271e4..634097e23 100644 --- a/architecture/filesystem_and_filesystem_usage.rst +++ b/architecture/filesystem_and_filesystem_usage.rst @@ -27,7 +27,7 @@ The **cluster root** is the directory in which all data for SQream DB is stored. The databases directory houses all of the actual data in tables and columns. -Each database is stored as its own directory. Each table is stored under it's respective database, and columns are stored in their respective table. +Each database is stored as its own directory. Each table is stored under its respective database, and columns are stored in their respective table. .. figure:: /_static/images/table_columns_storage.png From 6f3d4f84b9e1583fe505f3ec27047b0c66c1df20 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 13 Dec 2022 10:59:17 +0200 Subject: [PATCH 320/882] Update json.rst --- data_ingestion/json.rst | 229 +--------------------------------------- 1 file changed, 1 insertion(+), 228 deletions(-) diff --git a/data_ingestion/json.rst b/data_ingestion/json.rst index 16f0b20f1..50fe2258c 100644 --- a/data_ingestion/json.rst +++ b/data_ingestion/json.rst @@ -1,228 +1 @@ -.. _json: - -************************** -Ingesting Data from JSON -************************** - -.. contents:: - :local: - :depth: 1 - -Overview -======== - -JSON (Java Script Object Notation) is used both as a file format and as a serialization method. The JSON file format is flexible and is commonly used for dynamic, nested, and semi-structured data representations. - -The SQream DB JSON parser handles `RFC 8259 <https://datatracker.ietf.org/doc/html/rfc8259>`_ and supports both JSON objects and object arrays. - -The only JSON standard supported by SQream is `JSON Lines <https://jsonlines.org/>`_. - - -Making JSON Files Accessible to Workers -======================================= - -To give workers access to files, every node in your system must have access to the storage being used. - -The following are required for JSON files to be accessible to workers: - -* For files hosted on NFS, ensure that the mount is accessible from all servers. - -* For HDFS, ensure that SQream servers have access to the HDFS NameNode with the correct **user-id**. For more information, see :ref:`hdfs`. - -* For S3, ensure network access to the S3 endpoint. For more information, see :ref:`s3`. - -For more information about restricted worker access, see :ref:`workload_manager`. - - -Mapping between JSON and SQream -=============================== - -A JSON field consists of a key name and a value. - -Key names, which are case sensitive, are mapped to SQream columns. Key names which do not have corresponding SQream table columns are treated as errors by default, unless the ``IGNORE_EXTRA_FIELDS`` parameter is set to ``true``, in which case these key names will be ignored during the mapping process. - -Values may be one of the following reserved words (lower-case): ``false``, ``true``, and ``null``, or any of the following data types: - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - JSON Data Type - - Representation in SQream - * - Number - - ``TINYINT``, ``SMALLINT``, ``INT``, ``BIGINT``, ``FLOAT``, ``DOUBLE``, ``NUMERIC`` - * - String - - ``TEXT`` - * - JSON Literal - - ``NULL``, ``TRUE``, ``FALSE`` - * - JSON Array - - ``TEXT`` - * - JSON Object - - ``TEXT`` - -Missing JSON fields are automatically mapped to SQream with ``null`` as a value. - -Character Escaping ------------------- - -The ASCII 10 character (LF) marks the end of JSON objects. Use ``\\n`` to avoid a new line within a value string. - - -Ingesting JSON Data into SQream -=============================== - -.. contents:: In this topic: - :local: - -Syntax -------- -To access JSON files, use the ``json_fdw`` with a ``COPY FROM``, ``COPY TO``, or ``CREATE FOREIGN TABLE`` statement. - -The Foreign Data Wrapper (FDW) syntax is: - -.. code-block:: - - json_fdw [OPTIONS(option=value[,...])] - - -Parameters ------------- - -The following parameters are supported by ``json_fdw``: - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - ``DATETIME_FORMAT`` - - Default format is ``yyyy-mm-dd``. Other supported date formats are:``iso8601``, ``iso8601c``, ``dmy``, ``ymd``, ``mdy``, ``yyyymmdd``, ``yyyy-m-d``, ``yyyy-mm-dd``, ``yyyy/m/d``, ``yyyy/mm/dd``, ``d/m/yyyy``, ``dd/mm/yyyy``, ``mm/dd/yyyy``, ``dd-mon-yyyy``, ``yyyy-mon-dd``. - * - ``IGNORE_EXTRA_FIELDS`` - - Default value is ``false``. When value is ``true``, key names which do not have corresponding SQream table columns will be ignored. Parameter may be used with the ``COPY TO`` and ``IGNORE FOREIGN TABLE`` statements. - * - ``COMPRESSION`` - - Supported values are ``auto``, ``gzip``, and ``none``. ``auto`` means that the compression type is automatically detected upon import. Parameter is not supported for exporting. ``gzip`` means that a ``gzip`` compression is applied. ``none`` means that no compression or an attempt to decompress will take place. - * - ``LOCATION`` - - A path on the local filesystem, S3, or HDFS URI. The local path must be an absolute path that SQream DB can access. - * - ``OFFSET`` - - The row number to start with. - * - ``LIMIT`` - - When specified, tells SQream DB to stop loading after the specified number of rows. Unlimited if unset. - * - ``ERROR_LOG`` - - When used, the ``COPY`` process will write error information from unparsable rows to the file specified by this parameter. - - * If an existing file path is specified, it will be overwritten. - - * Specifying the same file for ``ERROR_LOG`` and ``REJECTED_DATA`` is not allowed and will result in error. - - * Specifing an error log when creating a foreign table will write a new error log for every query on the foreign table. - * - ``CONTINUE_ON_ERROR`` - - Specifies if errors should be ignored or skipped. When set to true, the transaction will continue despite rejected data. This parameter should be set together with ``ERROR_COUNT``. When reading multiple files, if an entire file can’t be opened it will be skipped. - * - ``ERROR_COUNT`` - - Specifies the threshold for the maximum number of faulty records that will be ignored. This setting must be used in conjunction with ``continue_on_error``. - * - ``ENFORCE_SINGLE_FILE`` - - Enforces the maximum file size (bytes). Permitted values: ``true`` - creates one file of unlimited size, ``false`` - permits creating several files together limited by the ``max_file_size``. When set to ``true``, the single file size is not limited by the ``max_file_size`` setting. When set to ``false``, the combined file sizes cannot exceed the ``max_file_size``. Default value: ``false``. - * - ``MAX_FILE_SIZE`` - - Sets the maximum file size (bytes). - * - ``AWS_ID``, ``AWS_SECRET`` - - Specifies the authentication details for secured S3 buckets - - -Automatic Schema Inference ---------------------------- - -You may let SQream DB automatically infer the schema of a foreign table when using ``json_fdw``. - -For more information, follow the :ref:`Automatic Foreign Table DDL Resolution<automatic_foreign_table_ddl_resolution>` page. - -Automatic Schema Inference example: - -.. code-block:: postgres - - CREATE FOREIGN TABLE t - WRAPPER json_fdw - OPTIONS - ( - location = 'somefile.json' - ) - ; - - -Examples ------------- - -JSON object array: - -.. code-block:: postgres - - { "name":"Avery Bradley", "age":25, "position":"PG" } - { "name":"Jae Crowder", "age":25, "position":"PG" } - { "name":"John Holland", "age":27, "position":"SG" } - -JSON objects: - -.. code-block:: postgres - - [ - { "name":"Avery Bradley", "age":25, "position":"PG" }, - { "name":"Jae Crowder", "age":25, "position":"SF" }, - { "name":"John Holland", "age":27, "position":"SG" } - ] - -Using the ``COPY FROM`` statement: - -.. code-block:: postgres - - COPY t - FROM WRAPPER json_fdw - OPTIONS - ( - location = 'somefile.json' - ) - ; - -Note that JSON files generated using the ``COPY TO`` statement will store objects, and not object arrays. - -.. code-block:: postgres - - COPY t - TO WRAPPER json_fdw - OPTIONS - ( - location = 'somefile.json' - ) - ; - -When using the ``CREATE FOREIGN TABLE`` statement, make sure that the table schema corresponds with the JSON file structure. - -.. code-block:: postgres - - CREATE FOREIGN TABLE t - ( - id int not null - ) - WRAPPER json_fdw - OPTIONS - ( - location = 'somefile.json' - ) - ; - -The following is an example of loading data from a JSON file into SQream: - -.. code-block:: postgres - - WRAPPER json_fdw - OPTIONS - ( - LOCATION = 'somefile.json' - ); - - - -.. tip:: - - An exact match must exist between the SQream and JSON types. For unsupported column types, you can set the type to any type and exclude it from subsequent queries. - - - +.. _json: ************************** Ingesting Data from JSON ************************** .. contents:: :local: :depth: 1 Overview ======== JSON (Java Script Object Notation) is used both as a file format and as a serialization method. The JSON file format is flexible and is commonly used for dynamic, nested, and semi-structured data representations. The SQream DB JSON parser supports the `RFC 8259 <https://datatracker.ietf.org/doc/html/rfc8259>`_ data interchange format and supports both JSON objects and JSON object arrays. Only the `JSON Lines <https://jsonlines.org/>`_ data format is supported by SQream. Making JSON Files Accessible to Workers ======================================= To give workers access to files, every node in your system must have access to the storage being used. The following are required for JSON files to be accessible to workers: * For files hosted on NFS, ensure that the mount is accessible from all servers. * For HDFS, ensure that SQream servers have access to the HDFS NameNode with the correct **user-id**. For more information, see :ref:`hdfs`. * For S3, ensure network access to the S3 endpoint. For more information, see :ref:`s3`. For more information about configuring worker access, see :ref:`workload_manager`. Mapping between JSON and SQream =============================== A JSON field consists of a key name and a value. Key names, which are case sensitive, are mapped to SQream columns. Key names which do not have corresponding SQream table columns are treated as errors by default, unless the ``IGNORE_EXTRA_FIELDS`` parameter is set to ``true``, in which case these key names will be ignored during the mapping process. SQream table columns which do not have corresponding JSON fields are automatically set to ``null`` as a value. Values may be one of the following reserved words (lower-case): ``false``, ``true``, or ``null``, or any of the following data types: .. list-table:: :widths: auto :header-rows: 1 * - JSON Data Type - Representation in SQream * - Number - ``TINYINT``, ``SMALLINT``, ``INT``, ``BIGINT``, ``FLOAT``, ``DOUBLE``, ``NUMERIC`` * - String - ``TEXT`` * - JSON Literal - ``NULL``, ``TRUE``, ``FALSE`` * - JSON Array - ``TEXT`` * - JSON Object - ``TEXT`` Character Escaping ------------------ The ASCII 10 character (LF) marks the end of JSON objects. Use ``\\n`` to escape the ``\n`` character when you do not mean it be a new line. Ingesting JSON Data into SQream =============================== .. contents:: In this topic: :local: Syntax ------- To access JSON files, use the ``json_fdw`` with a ``COPY FROM``, ``COPY TO``, or ``CREATE FOREIGN TABLE`` statement. The Foreign Data Wrapper (FDW) syntax is: .. code-block:: json_fdw [OPTIONS(option=value[,...])] Parameters ------------ The following parameters are supported by ``json_fdw``: .. list-table:: :widths: auto :header-rows: 1 * - Parameter - Description * - ``DATETIME_FORMAT`` - Default format is ``yyyy-mm-dd``. Other supported date formats are:``iso8601``, ``iso8601c``, ``dmy``, ``ymd``, ``mdy``, ``yyyymmdd``, ``yyyy-m-d``, ``yyyy-mm-dd``, ``yyyy/m/d``, ``yyyy/mm/dd``, ``d/m/yyyy``, ``dd/mm/yyyy``, ``mm/dd/yyyy``, ``dd-mon-yyyy``, ``yyyy-mon-dd``. * - ``IGNORE_EXTRA_FIELDS`` - Default value is ``false``. When value is ``true``, key names which do not have corresponding SQream table columns will be ignored. Parameter may be used with the ``COPY TO`` and ``IGNORE FOREIGN TABLE`` statements. * - ``COMPRESSION`` - Supported values are ``auto``, ``gzip``, and ``none``. ``auto`` means that the compression type is automatically detected upon import. Parameter is not supported for exporting. ``gzip`` means that a ``gzip`` compression is applied. ``none`` means that no compression or an attempt to decompress will take place. * - ``LOCATION`` - A path on the local filesystem, on S3, or on HDFS URI. The local path must be an absolute path that SQream DB can access. * - ``LIMIT`` - When specified, tells SQream DB to stop ingesting after the specified number of rows. Unlimited if unset. * - ``OFFSET`` - The row number from which to start ingesting. * - ``ERROR_LOG`` - If when using the ``COPY`` command, copying a row fails, the ``ERROR LOG`` command writes error information to the error log specified in the ``ERROR LOG`` command. * If an existing file path is specified, the file will be overwritten. * Specifying the same file for ``ERROR_LOG`` and ``REJECTED_DATA`` is not allowed and will result in error. * Specifying an error log when creating a foreign table will write a new error log for every query on the foreign table. * - ``CONTINUE_ON_ERROR`` - Specifies if errors should be ignored or skipped. When set to true, the transaction will continue despite rejected data. This parameter should be set together with ``ERROR_COUNT``. When reading multiple files, if an entire file cannot be opened, it will be skipped. * - ``ERROR_COUNT`` - Specifies the maximum number of faulty records that will be ignored. This setting must be used in conjunction with ``continue_on_error``. * - ``MAX_FILE_SIZE`` - Sets the maximum file size (bytes). * - ``ENFORCE_SINGLE_FILE`` - Permitted values are ``true`` or ``false``. When set to ``true``, a single file of unlimited size is created. This single file is not limited by the ``MAX_FILE_SIZE`` parameter. ``false`` permits creating several files together limited by the ``MAX_FILE_SIZE`` parameter. Default value: ``false``. * - ``AWS_ID``, ``AWS_SECRET`` - Specifies the authentication details for secured S3 buckets. Automatic Schema Inference --------------------------- You may let SQream DB automatically infer the schema of a foreign table when using ``json_fdw``. For more information, follow the :ref:`Automatic Foreign Table DDL Resolution<automatic_foreign_table_ddl_resolution>` page. Automatic Schema Inference example: .. code-block:: postgres CREATE FOREIGN TABLE t WRAPPER json_fdw OPTIONS ( location = 'somefile.json' ) ; Examples ------------ JSON object array: .. code-block:: postgres { "name":"Avery Bradley", "age":25, "position":"PG" } { "name":"Jae Crowder", "age":25, "position":"PG" } { "name":"John Holland", "age":27, "position":"SG" } JSON objects: .. code-block:: postgres [ { "name":"Avery Bradley", "age":25, "position":"PG" }, { "name":"Jae Crowder", "age":25, "position":"SF" }, { "name":"John Holland", "age":27, "position":"SG" } ] Using the ``COPY FROM`` statement: .. code-block:: postgres COPY t FROM WRAPPER json_fdw OPTIONS ( location = 'somefile.json' ) ; Note that JSON files generated using the ``COPY TO`` statement will store objects, and not object arrays. .. code-block:: postgres COPY t TO WRAPPER json_fdw OPTIONS ( location = 'somefile.json' ) ; When using the ``CREATE FOREIGN TABLE`` statement, make sure that the table schema corresponds with the JSON file structure. .. code-block:: postgres CREATE FOREIGN TABLE t ( id int not null ) WRAPPER json_fdw OPTIONS ( location = 'somefile.json' ) ; The following is an example of loading data from a JSON file into SQream: .. code-block:: postgres WRAPPER json_fdw OPTIONS ( LOCATION = 'somefile.json' ); .. tip:: An exact match must exist between the SQream and JSON types. For unsupported column types, you can set the type to any type and exclude it from subsequent queries. \ No newline at end of file From 15b10fe3e0ee2a4ced414d5406909ca2dbf909d4 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 13 Dec 2022 12:42:30 +0200 Subject: [PATCH 321/882] Update data_encryption_overview.rst --- feature_guides/data_encryption_overview.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/feature_guides/data_encryption_overview.rst b/feature_guides/data_encryption_overview.rst index ca953ce2a..256e3d718 100644 --- a/feature_guides/data_encryption_overview.rst +++ b/feature_guides/data_encryption_overview.rst @@ -21,7 +21,7 @@ Encryption can be used for the following: * Selecting data from an encrypted column. -.. warning:: The ``SELECT`` statement decrypts information by default. When executing ``CREATE TABLE AS SELECT``, encrypted information will appear as clear text in the newly created table. +.. warning:: The ``SELECT`` statement decrypts information by default. When executing ``CREATE TABLE AS SELECT`` or ``INSERT INTO TABLE AS SELECT``, encrypted information will appear as clear text in the newly created table. For more information on the encryption syntax, see :ref:`data_encryption_syntax`. From 484f1469137f2d571a7813cb5435c278cfebdc69 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 13 Dec 2022 13:17:55 +0200 Subject: [PATCH 322/882] Update index.rst --- external_storage_platforms/index.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/external_storage_platforms/index.rst b/external_storage_platforms/index.rst index b7a591d65..92c35ee63 100644 --- a/external_storage_platforms/index.rst +++ b/external_storage_platforms/index.rst @@ -23,5 +23,3 @@ For more information, see the following: :: * :ref:`copy_to` - -.. note:: While you can ingest data into SQream from Parquet files, you can also store and run queries on data located on external Parquet files. For more information, see :ref:`parquet`. \ No newline at end of file From 1ff394a7cc8e2a780b73a00f3111de825e223b4d Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 13 Dec 2022 15:15:18 +0200 Subject: [PATCH 323/882] Update shutdown_server_command.rst --- .../utility_commands/shutdown_server_command.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/sql/sql_statements/utility_commands/shutdown_server_command.rst b/reference/sql/sql_statements/utility_commands/shutdown_server_command.rst index ebc3d9184..bc42fcd5d 100644 --- a/reference/sql/sql_statements/utility_commands/shutdown_server_command.rst +++ b/reference/sql/sql_statements/utility_commands/shutdown_server_command.rst @@ -11,7 +11,7 @@ The **SHUTDOWN_SERVER** guide describes the following: Overview =============== -SQream's current method for stopping the SQream server is running the ``shutdown_server ()`` utility command. Because this command abruptly shuts down the server while executing operations, it has been modified to perform a graceful shutdown by setting it to ``select shutdown_server([is_graceful, [timeout]]);``. This causes the server to wait for any queued statements to complete before shutting down. +SQream's current method for stopping the SQream server is running the ``shutdown_server()`` utility command. Because this command abruptly shuts down the server while executing operations, it has been modified to perform a graceful shutdown by setting it to ``select shutdown_server([is_graceful, [timeout]]);``. This causes the server to wait for any queued statements to complete before shutting down. How Does it Work? ======================== @@ -92,7 +92,7 @@ This section shows the following examples: .. code-block:: postgres - shutdown_server () + shutdown_server() **Example 2 - Activating a Graceful Shutdown** From 9498d047c401fbaf731cb230ed5dd6d431897e1e Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 15 Dec 2022 10:32:37 +0200 Subject: [PATCH 324/882] Update 2022.1.7.rst --- releases/2022.1.7.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/releases/2022.1.7.rst b/releases/2022.1.7.rst index fa81f914f..af5561432 100644 --- a/releases/2022.1.7.rst +++ b/releases/2022.1.7.rst @@ -33,8 +33,6 @@ Version 2022.1.7 resolved Issues +==================+=======================================================================+ | SQ-11523 | ``SAVED QUERY`` execution internal error | +------------------+-----------------------------------------------------------------------+ -| | ``JOIN`` query performance issue | -+------------------+-----------------------------------------------------------------------+ | SQ-11811 | Missing metadata optimization when joining ``TEXT`` columns | +------------------+-----------------------------------------------------------------------+ | SQ-12178 | SQreamNet does not support the ``ExecuteNonQuery`` ADO.NET command | From 9644cbf5fc78395eed2fd7e71bda8aad2ff4d82f Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 15 Dec 2022 10:33:46 +0200 Subject: [PATCH 325/882] Update 2022.1.7.rst --- releases/2022.1.7.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/2022.1.7.rst b/releases/2022.1.7.rst index af5561432..c9563f9b0 100644 --- a/releases/2022.1.7.rst +++ b/releases/2022.1.7.rst @@ -3,7 +3,7 @@ ************************** Release Notes 2022.1.7 ************************** -The 2022.1.7 release notes were released on 11/xx/2022 and describe the following: +The 2022.1.7 release notes were released on 11/15/2022 and describe the following: .. contents:: :local: From b5e922fc7d7bef1ecdb8d092097e3e659d49a5e4 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 15 Dec 2022 10:42:52 +0200 Subject: [PATCH 326/882] Update 2022.1_index.rst --- releases/2022.1_index.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/releases/2022.1_index.rst b/releases/2022.1_index.rst index e63294405..5355f1cc4 100644 --- a/releases/2022.1_index.rst +++ b/releases/2022.1_index.rst @@ -13,6 +13,7 @@ The 2022.1 Release Notes describe the following releases: :maxdepth: 1 :glob: + 2022.1.7 2022.1.6 2022.1.5 From d39f19854958ed3913c32dc5d5695a2c718afe54 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 15 Dec 2022 13:36:34 +0200 Subject: [PATCH 327/882] release --- releases/2022.1.7.rst | 2 +- releases/2022.1.8.rst | 97 +++++++++++++++++++++++++++++++++++++++ releases/2022.1_index.rst | 2 +- 3 files changed, 99 insertions(+), 2 deletions(-) create mode 100644 releases/2022.1.8.rst diff --git a/releases/2022.1.7.rst b/releases/2022.1.7.rst index c9563f9b0..22b147e29 100644 --- a/releases/2022.1.7.rst +++ b/releases/2022.1.7.rst @@ -3,7 +3,7 @@ ************************** Release Notes 2022.1.7 ************************** -The 2022.1.7 release notes were released on 11/15/2022 and describe the following: +The 2022.1.7 release notes were released on 15/12/2022 and describe the following: .. contents:: :local: diff --git a/releases/2022.1.8.rst b/releases/2022.1.8.rst new file mode 100644 index 000000000..f15b5d71d --- /dev/null +++ b/releases/2022.1.8.rst @@ -0,0 +1,97 @@ +.. _2022.1.8: + +************************** +Release Notes 2022.1.8 +************************** +The 2022.1.8 release notes were released on xx/xx/2022 and describe the following: + +.. contents:: + :local: + :depth: 1 + +New Features +---------- + + * Ingesting data from JSON files. + + :: + + * ZLIB compression performance enhancements. + + :: + + +Known Issues +--------- +:ref:`Percentile<percentile_disc>` is not supported for Window functions. + +Version 2022.1.8 resolved Issues +--------- + ++------------------+-----------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++==================+=======================================================================+ +| SQ-11523 | ``SAVED QUERY`` execution internal error | ++------------------+-----------------------------------------------------------------------+ +| SQ-11811 | Missing metadata optimization when joining ``TEXT`` columns | ++------------------+-----------------------------------------------------------------------+ +| SQ-12178 | SQreamNet does not support the ``ExecuteNonQuery`` ADO.NET command | ++------------------+-----------------------------------------------------------------------+ + +Configuration Changes +-------- +No configuration changes were made. + +Naming Changes +------- +No relevant naming changes were made. + +Deprecated Features +------- +SQream is declaring end of support of VARCHAR data type, the decision resulted by SQream's effort to enhance its core functionalities and with respect to ever changing echo system requirements. + +VARCHAR is no longer supported for new customers - effective from Version 2022.1.3 (September 2022). + +TEXT data type is replacing VARCHAR and NVARCHAR - SQream will maintain VARCHAR data type support until 09/30/2023. + + +End of Support +------- +No End of Support changes were made. + +Upgrading to v2022.1.8 +------- +1. Generate a back-up of the metadata by running the following command: + + .. code-block:: console + + $ select backup_metadata('out_path'); + + .. tip:: SQream recommends storing the generated back-up locally in case needed. + + SQream runs the Garbage Collector and creates a clean backup tarball package. + +2. Shut down all SQream services. + + :: + +3. Extract the recently created back-up file. + + :: + +4. Replace your current metadata with the metadata you stored in the back-up file. + + :: + +5. Navigate to the new SQream package bin folder. + + :: + +6. Run the following command: + + .. code-block:: console + + $ ./upgrade_storage <levelDB path> + + .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. + diff --git a/releases/2022.1_index.rst b/releases/2022.1_index.rst index 5355f1cc4..a41453b32 100644 --- a/releases/2022.1_index.rst +++ b/releases/2022.1_index.rst @@ -13,7 +13,7 @@ The 2022.1 Release Notes describe the following releases: :maxdepth: 1 :glob: - + 2022.1.8 2022.1.7 2022.1.6 2022.1.5 From 0b0e4da0a910257f5f009690aa0936a33707a4de Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 15 Dec 2022 14:06:01 +0200 Subject: [PATCH 328/882] Update 2022.1.8.rst --- releases/2022.1.8.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/releases/2022.1.8.rst b/releases/2022.1.8.rst index f15b5d71d..5364a5fde 100644 --- a/releases/2022.1.8.rst +++ b/releases/2022.1.8.rst @@ -31,11 +31,11 @@ Version 2022.1.8 resolved Issues +------------------+-----------------------------------------------------------------------+ | **SQ No.** | **Description** | +==================+=======================================================================+ -| SQ-11523 | ``SAVED QUERY`` execution internal error | +| SQ-11199 | AWS S3 internal runtime error when executing ``COPY TO`` statement | +------------------+-----------------------------------------------------------------------+ -| SQ-11811 | Missing metadata optimization when joining ``TEXT`` columns | +| SQ-11772 | Slow ``JOIN`` query | +------------------+-----------------------------------------------------------------------+ -| SQ-12178 | SQreamNet does not support the ``ExecuteNonQuery`` ADO.NET command | +| SQ-12228 | | +------------------+-----------------------------------------------------------------------+ Configuration Changes From 1ee8be95313e4706899613efbd1c427b615bfb11 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Thu, 15 Dec 2022 14:56:46 +0200 Subject: [PATCH 329/882] Update 2022.1.7.rst --- releases/2022.1.7.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/releases/2022.1.7.rst b/releases/2022.1.7.rst index 22b147e29..b3fda33ff 100644 --- a/releases/2022.1.7.rst +++ b/releases/2022.1.7.rst @@ -3,7 +3,7 @@ ************************** Release Notes 2022.1.7 ************************** -The 2022.1.7 release notes were released on 15/12/2022 and describe the following: +The 2022.1.7 release notes were released on 12/15/2022 and describe the following: .. contents:: :local: @@ -12,7 +12,7 @@ The 2022.1.7 release notes were released on 15/12/2022 and describe the followin New Features ---------- - * Ingesting data from JSON files. + * Ingesting data from :ref:`JSON<json>` files. :: From 1a492e6e89e4431a3788b40bd3992ea778d9f68c Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 15 Dec 2022 16:09:22 +0200 Subject: [PATCH 330/882] release --- external_storage_platforms/index.rst | 1 + external_storage_platforms/s3.rst | 3 ++- index.rst | 1 + releases/2022.1.8.rst | 33 ++++++++++++++++++---------- 4 files changed, 26 insertions(+), 12 deletions(-) diff --git a/external_storage_platforms/index.rst b/external_storage_platforms/index.rst index 92c35ee63..827fdf190 100644 --- a/external_storage_platforms/index.rst +++ b/external_storage_platforms/index.rst @@ -10,6 +10,7 @@ SQream supports the following external storage platforms: :titlesonly: s3 + hdfs For more information, see the following: diff --git a/external_storage_platforms/s3.rst b/external_storage_platforms/s3.rst index f8bb2dab6..a3111f3b9 100644 --- a/external_storage_platforms/s3.rst +++ b/external_storage_platforms/s3.rst @@ -12,7 +12,8 @@ The **Amazon S3** describes the following topics: S3 Configuration ============================== -Any database host with access to S3 endpoints can access S3 without any configuration. To read files from an S3 bucket, the database must have listable files. + +A best practice for granting access to AWS S3 is by creating an `Identity and Access Management (IAM) <https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started.html>`_ user account. If creating an IAM user account is not possible, you may follow AWS guidelines for `using the global configuration object <https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/global-config-object.html>`_ and setting an `AWS region <https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/setting-region.html>`_ S3 URI Format =============== diff --git a/index.rst b/index.rst index c3d41c39c..61e31b593 100644 --- a/index.rst +++ b/index.rst @@ -81,6 +81,7 @@ If you're looking for an older version of the documentation, go to http://previo installation_guides/index data_ingestion/index connecting_to_sqream/index + external_storage_platforms/index loading_and_unloading_data/index feature_guides/index operational_guides/index diff --git a/releases/2022.1.8.rst b/releases/2022.1.8.rst index 5364a5fde..0fc5cafe6 100644 --- a/releases/2022.1.8.rst +++ b/releases/2022.1.8.rst @@ -12,11 +12,11 @@ The 2022.1.8 release notes were released on xx/xx/2022 and describe the followin New Features ---------- - * Ingesting data from JSON files. + * xxxxxxxxx GCP :: - * ZLIB compression performance enhancements. + * xxxxxxxxx :: @@ -28,15 +28,26 @@ Known Issues Version 2022.1.8 resolved Issues --------- -+------------------+-----------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+==================+=======================================================================+ -| SQ-11199 | AWS S3 internal runtime error when executing ``COPY TO`` statement | -+------------------+-----------------------------------------------------------------------+ -| SQ-11772 | Slow ``JOIN`` query | -+------------------+-----------------------------------------------------------------------+ -| SQ-12228 | | -+------------------+-----------------------------------------------------------------------+ ++---------------+------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++===============+==========================================================================================+ +| SQ-11199 | AWS S3 internal runtime error when executing ``COPY TO`` statement | ++---------------+------------------------------------------------------------------------------------------+ +| SQ-11772 | Slow ``JOIN`` query | ++---------------+------------------------------------------------------------------------------------------+ +| SQ-12228 | ``CREATE AS SELECT`` statement fails when executed with ``UNION ALL`` and ``GROUP BY`` | ++---------------+------------------------------------------------------------------------------------------+ +| | | ++---------------+------------------------------------------------------------------------------------------+ +| | | ++---------------+------------------------------------------------------------------------------------------+ +| | | ++---------------+------------------------------------------------------------------------------------------+ +| | | ++---------------+------------------------------------------------------------------------------------------+ +| | | ++---------------+------------------------------------------------------------------------------------------+ + Configuration Changes -------- From 9fe508b97dca09e4e37fa26da469115638fa7ba5 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 18 Dec 2022 12:34:46 +0200 Subject: [PATCH 331/882] Access control - UPDATE --- operational_guides/access_control.rst | 2 +- operational_guides/access_control_permissions.rst | 5 +++-- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/operational_guides/access_control.rst b/operational_guides/access_control.rst index 8aba611eb..9a1ce9f17 100644 --- a/operational_guides/access_control.rst +++ b/operational_guides/access_control.rst @@ -8,8 +8,8 @@ Access Control :maxdepth: 1 :titlesonly: - access_control_password_policy access_control_overview + access_control_password_policy access_control_managing_roles access_control_permissions access_control_departmental_example \ No newline at end of file diff --git a/operational_guides/access_control_permissions.rst b/operational_guides/access_control_permissions.rst index 5afc23009..25ff6ba14 100644 --- a/operational_guides/access_control_permissions.rst +++ b/operational_guides/access_control_permissions.rst @@ -88,7 +88,7 @@ GRANT TO <role> [, ...] -- Grant permissions at the object level: - GRANT {{SELECT | INSERT | DELETE | DDL } [, ...] | ALL [PERMISSIONS]} + GRANT {{SELECT | INSERT | DELETE | DDL | UPDATE } [, ...] | ALL [PERMISSIONS]} ON { TABLE <table_name> [, ...] | ALL TABLES IN SCHEMA <schema_name> [, ...]} TO <role> [, ...] @@ -155,7 +155,7 @@ REVOKE FROM <role> [, ...] -- Revoke permissions at the object level: - REVOKE { { SELECT | INSERT | DELETE | DDL } [, ...] | ALL } + REVOKE { { SELECT | INSERT | DELETE | DDL | UPDATE } [, ...] | ALL } ON { [ TABLE ] <table_name> [, ...] | ALL TABLES IN SCHEMA <schema_name> [, ...] } @@ -213,6 +213,7 @@ schema statement is run. | INSERT | DELETE | DDL + | UPDATE | EXECUTE | ALL } \ No newline at end of file From 1cf91841c43a04b4f31da817630cfaae072daf2d Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 20 Dec 2022 12:34:26 +0200 Subject: [PATCH 332/882] Update 2022.1.8.rst --- releases/2022.1.8.rst | 18 +++++++++++++----- 1 file changed, 13 insertions(+), 5 deletions(-) diff --git a/releases/2022.1.8.rst b/releases/2022.1.8.rst index 0fc5cafe6..50ae0a675 100644 --- a/releases/2022.1.8.rst +++ b/releases/2022.1.8.rst @@ -37,16 +37,24 @@ Version 2022.1.8 resolved Issues +---------------+------------------------------------------------------------------------------------------+ | SQ-12228 | ``CREATE AS SELECT`` statement fails when executed with ``UNION ALL`` and ``GROUP BY`` | +---------------+------------------------------------------------------------------------------------------+ -| | | +| SQ-11296 | Slow catalog queries | +---------------+------------------------------------------------------------------------------------------+ -| | | +| SQ-11948 | ``SAVED QUERY`` execution using ``SELECT`` or ``INSERT INTO`` returns error | +---------------+------------------------------------------------------------------------------------------+ -| | | +| SQ-12255 | ``COPY TO`` string export error | +---------------+------------------------------------------------------------------------------------------+ -| | | +| SQ-12310 | ``DICT`` compression buffer size issue | +---------------+------------------------------------------------------------------------------------------+ -| | | +| SQ-12318 | JDBC ``insertBuffer`` parameter issue | +---------------+------------------------------------------------------------------------------------------+ +| SQ-12364 | ``GET DDL`` foreign table output issue | ++---------------+------------------------------------------------------------------------------------------+ +| SQ-12468 | Internal compiler error | ++---------------+------------------------------------------------------------------------------------------+ + + + + Configuration Changes From 31e595ee44f71425f8382d2b8bf5f6d43648a5db Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 20 Dec 2022 17:29:48 +0200 Subject: [PATCH 333/882] Trino --- .../client_platforms/index.rst | 1 + .../client_platforms/trino.rst | 95 +++++++++++++++++++ 2 files changed, 96 insertions(+) create mode 100644 connecting_to_sqream/client_platforms/trino.rst diff --git a/connecting_to_sqream/client_platforms/index.rst b/connecting_to_sqream/client_platforms/index.rst index be5f4af16..d8c122480 100644 --- a/connecting_to_sqream/client_platforms/index.rst +++ b/connecting_to_sqream/client_platforms/index.rst @@ -21,6 +21,7 @@ If you are looking for a tool that is not listed, SQream and our partners can he :caption: In this section: :titlesonly: + trino informatica microstrategy pentaho diff --git a/connecting_to_sqream/client_platforms/trino.rst b/connecting_to_sqream/client_platforms/trino.rst new file mode 100644 index 000000000..63ef65bc0 --- /dev/null +++ b/connecting_to_sqream/client_platforms/trino.rst @@ -0,0 +1,95 @@ +.. _trino: + +************************* +Connecting to SQream Using Trino +************************* + +Overview +===================== +SQream's Trino connector plugin, based on standard JDBC, enables storing and fast querying large volumes of data. + +The **Connecting to SQream Using Trino** page is a Quick Start Guide that describes how to install Trino and the JDBC driver and connect to SQream for data analysis. It also describes using best practices and troubleshoot issues that may occur while installing Trino. + + + +.. contents:: + :local: + :depth: 1 + +Prerequisites +------------- + +SQream version xxxxx +JDBC version 4.5.6 or later +Trino version 403 or later + + +Installing the Trino Connector Plugin +------------------------------------- + +Install the Trino plugin on all nodes dedicated to Trino within your cluster. + +1. Create a dedicated directory for the Trino plugin. + +2. Download the latest version of Trino plugin. + +3. Extract the Trino plugin ZIP file and copy the extracted directory into the Trino plugin directory. + +.. code-block:: postgres + + trino-server/ + └── plugin + └── sqream + ├── sqream-jdbc.jar + ├── trino-sqream-services.jar + ├── trino-sqream-SNAPSHOT.jar + └── all dependencies + + + +Connecting to SQream +-------------------- + +Under ``trino-server/etc/catalog``, create a ``sqream.properties`` file. + +.. code-block:: postgres + + connector.name=sqream + connection-url=jdbc:Sqream://<host>:<port>/<database>... + +Supported Data Types and Mapping +-------------------------------- + +When executing queries in Trino, use Trino data types. The plugin converts them into SQream data types. + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Trino type + - SQream type + * - ``BOOLEAN`` + - ``BOOL`` + * - ``TINYINT`` + - ``TINYINT`` + * - ``SMALLINT`` + - ``SMALLINT`` + * - ``INT`` + - ``INT`` + * - ``BIGINT`` + - ``BIGINT`` + * - ``REAL`` + - ``REAL`` + * - ``DOUBLE`` + - ``DOUBLE`` + * - ``DATE`` + - ``DATE`` + * - ``TIMESTAMP`` + - ``DATETIME`` + * - ``VARCHAR(N)`` + - ``VARCHAR(N)`` + * - ``VARCHAR`` + - ``TEXT`` + * - ``DECIMAL(P,S)`` + - ``NUMERIC(P,S)`` + From 493486f11ca31472adb1f709f6bdd0e6c9681d91 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 22 Dec 2022 09:46:57 +0200 Subject: [PATCH 334/882] Update create_table.rst --- .../ddl_commands/create_table.rst | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/reference/sql/sql_statements/ddl_commands/create_table.rst b/reference/sql/sql_statements/ddl_commands/create_table.rst index f32afe2dd..3d0299185 100644 --- a/reference/sql/sql_statements/ddl_commands/create_table.rst +++ b/reference/sql/sql_statements/ddl_commands/create_table.rst @@ -51,7 +51,7 @@ The following parameters can be used when creating a table: * - Parameter - Description * - ``OR REPLACE`` - - Creates a new tables and overwrites any existing table by the same name. Does not return an error if the table already exists. ``CREATE OR REPLACE`` does not check the table contents or structure, only the table name. + - Creates a new table and overwrites any existing table by the same name. Does not return an error if the table already exists. ``CREATE OR REPLACE`` does not check table contents or structure, only the table name. * - ``schema_name`` - The name of the schema in which to create the table. * - ``table_name`` @@ -263,7 +263,7 @@ The generated output of both of the statements above is identical. Creating a Table based on Foreign Tables and Views ~~~~~~~~~~~~ -The following is example of creating a table based on foreign tables and views: +The following is an example of creating a table based on foreign tables and views: .. code-block:: postgres @@ -271,24 +271,24 @@ The following is example of creating a table based on foreign tables and views: CREATE VIEW v as SELECT x+1,y,y || 'abc' from t1; CREATE TABLE t3 LIKE v; -When duplicating the column structure of an existing table, the target table of the ``LIKE`` clause can be a regular or an external table, or a view. +When duplicating the column structure of an existing table, the target table of the ``LIKE`` clause can be either a regular or an external table, or a view. -The following table describes the properties that must be copied from the target table: +The following table describes which properties are copied from the target table to the newly created table: +-----------------------------+------------------+---------------------------------+---------------------------------+ | **Property** | **Native Table** | **External Table** | **View** | +-----------------------------+------------------+---------------------------------+---------------------------------+ -| Column names | Must be copied | Must be copied | Must be copied | +| Column names | Copied | Copied | Copied | +-----------------------------+------------------+---------------------------------+---------------------------------+ -| Column types | Must be copied | Must be copied | Must be copied | +| Column types | Copied | Copied | Copied | +-----------------------------+------------------+---------------------------------+---------------------------------+ -| ``NULL``/``NOT NULL`` | Must be copied | Must be copied | Must be copied | +| ``NULL``/``NOT NULL`` | Copied | Copied | Copied | +-----------------------------+------------------+---------------------------------+---------------------------------+ -| ``text`` length constraints | Must be copied | Must be copied | Does not exist in source object | +| ``text`` length constraints | Copied | Copied | Does not exist in source object | +-----------------------------+------------------+---------------------------------+---------------------------------+ -| Compression specification | Must be copied | Does not exist in source object | Does not exist in source object | +| Compression specification | Copied | Does not exist in source object | Does not exist in source object | +-----------------------------+------------------+---------------------------------+---------------------------------+ -| Default/identity | Must be copied | Does not exist in source object | Does not exist in source object | +| Default/identity | Copied | Does not exist in source object | Does not exist in source object | +-----------------------------+------------------+---------------------------------+---------------------------------+ Permissions From 378082f190601edb9787711398189aa149c5641c Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 22 Dec 2022 10:05:24 +0200 Subject: [PATCH 335/882] Update create_table.rst --- reference/sql/sql_statements/ddl_commands/create_table.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/ddl_commands/create_table.rst b/reference/sql/sql_statements/ddl_commands/create_table.rst index 3d0299185..47d684653 100644 --- a/reference/sql/sql_statements/ddl_commands/create_table.rst +++ b/reference/sql/sql_statements/ddl_commands/create_table.rst @@ -271,7 +271,7 @@ The following is an example of creating a table based on foreign tables and view CREATE VIEW v as SELECT x+1,y,y || 'abc' from t1; CREATE TABLE t3 LIKE v; -When duplicating the column structure of an existing table, the target table of the ``LIKE`` clause can be either a regular or an external table, or a view. +When duplicating the column structure of an existing table, the target table of the ``LIKE`` clause can be either a native, a regular, or an external table, or a view. The following table describes which properties are copied from the target table to the newly created table: From 984b224c50e1e362aa1370a3d04534b4dc2657af Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 22 Dec 2022 17:42:21 +0200 Subject: [PATCH 336/882] Trino --- .../client_drivers/jdbc/index.rst | 2 +- .../client_platforms/trino.rst | 86 +++++++++++++++---- releases/2022.1.8.rst | 2 +- 3 files changed, 69 insertions(+), 21 deletions(-) diff --git a/connecting_to_sqream/client_drivers/jdbc/index.rst b/connecting_to_sqream/client_drivers/jdbc/index.rst index 832987efa..83bdc3801 100644 --- a/connecting_to_sqream/client_drivers/jdbc/index.rst +++ b/connecting_to_sqream/client_drivers/jdbc/index.rst @@ -82,7 +82,7 @@ The following is the syntax for SQream: .. code-block:: text - jdbc:Sqream://<host and port>/<database name>;user=<username>;password=<password>sqream;[<optional parameters>; ...] + jdbc:Sqream://<host and port>/<database name>;user=<username>;password=<password>;[<optional parameters>; ...] Connection Parameters ^^^^^^^^^^^^^^^^^^^^^^^^ diff --git a/connecting_to_sqream/client_platforms/trino.rst b/connecting_to_sqream/client_platforms/trino.rst index 63ef65bc0..930d9b95c 100644 --- a/connecting_to_sqream/client_platforms/trino.rst +++ b/connecting_to_sqream/client_platforms/trino.rst @@ -6,10 +6,7 @@ Connecting to SQream Using Trino Overview ===================== -SQream's Trino connector plugin, based on standard JDBC, enables storing and fast querying large volumes of data. - -The **Connecting to SQream Using Trino** page is a Quick Start Guide that describes how to install Trino and the JDBC driver and connect to SQream for data analysis. It also describes using best practices and troubleshoot issues that may occur while installing Trino. - +The JDBC based SQream Trino plugin supports large volumes of data storage and fast querying. .. contents:: @@ -18,22 +15,32 @@ The **Connecting to SQream Using Trino** page is a Quick Start Guide that descri Prerequisites ------------- +To use Trino with SQream, you must have the following installed: + +* SQream version 2022.1.8 or later +* Trino version 403 or later +* SQream Trino plugin xxxx +* JDBC version 4.5.6 or later -SQream version xxxxx -JDBC version 4.5.6 or later -Trino version 403 or later - -Installing the Trino Connector Plugin -------------------------------------- -Install the Trino plugin on all nodes dedicated to Trino within your cluster. +Installation +------------ + +.. contents:: + :local: + :depth: 1 -1. Create a dedicated directory for the Trino plugin. -2. Download the latest version of Trino plugin. +SQream Trino Plugin +~~~~~~~~~~~~~~~~~~~ + +The SQream Trino plugin must be installed on each cluster node dedicated to Trino. + +1. Create a dedicated directory for the SQream Trino plugin. + +2. Download the `SQream Trino Plugin<...>` and extract the content of the ZIP file to the dedicated directory, as shown in the example: -3. Extract the Trino plugin ZIP file and copy the extracted directory into the Trino plugin directory. .. code-block:: postgres @@ -45,22 +52,52 @@ Install the Trino plugin on all nodes dedicated to Trino within your cluster. ├── trino-sqream-SNAPSHOT.jar └── all dependencies +JDBC +~~~~ +In case JDBC is not yet installed on your system, follow the `JDBC Client Drivers page <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/jdbc/index.html>`_ for installation and configuration guidance. Connecting to SQream -------------------- -Under ``trino-server/etc/catalog``, create a ``sqream.properties`` file. +Trino uses catalogs for referencing stored objects such as tables, databases, and functions. Each Trino catalog may be configured with access to a single SQream database. If you wish for Trino to have access to more than one SQream database or server, you must create additional catalogs. + +Catalogs may be created using ``properties`` files. Start by creating a ``sqream.properties`` file and placing it under ``trino-server/etc/catalog``. + +The following is an example of a properties file: + +.. code-block:: postgres + + connector.name=<name> + connection-url=jdbc:Sqream://<host and port>/<database name>;[<optional parameters>; ...] + connection-user=<user> + connection-password=<password> + +Syntax examples +--------------- + +The following is an example of the ``SHOW SCHEMAS FROM`` statement: .. code-block:: postgres - connector.name=sqream - connection-url=jdbc:Sqream://<host>:<port>/<database>... + SHOW SCHEMAS FROM sqream; + +The following is an example of the ``SHOW TABLES FROM`` statement: + +.. code-block:: postgres + + SHOW TABLES FROM sqream.public; + +The following is an example of the ``DESCRIBE sqream.public.t`` statement: + +.. code-block:: postgres + + DESCIBE sqream.public.t; + Supported Data Types and Mapping -------------------------------- - -When executing queries in Trino, use Trino data types. The plugin converts them into SQream data types. +Use the appropriate Trino data type for executing queries. Upon execution, incompatible data types will be converted by Trino to SQream data types. .. list-table:: :widths: auto @@ -93,3 +130,14 @@ When executing queries in Trino, use Trino data types. The plugin converts them * - ``DECIMAL(P,S)`` - ``NUMERIC(P,S)`` + + +Limitations +----------- + +SQream does not support the following SQL statements: + +``GRANT`` +``REVOKE`` +``SHOW GRANTSHOW ROLES`` +``SHOW ROLE GRANTS`` \ No newline at end of file diff --git a/releases/2022.1.8.rst b/releases/2022.1.8.rst index 50ae0a675..46ca54d1d 100644 --- a/releases/2022.1.8.rst +++ b/releases/2022.1.8.rst @@ -16,7 +16,7 @@ New Features :: - * xxxxxxxxx + * xxxxxxxxx Trino :: From 0190b95d720dff4ec3d778b001d51675bd662986 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 25 Dec 2022 10:03:59 +0200 Subject: [PATCH 337/882] Update trino.rst --- connecting_to_sqream/client_platforms/trino.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/connecting_to_sqream/client_platforms/trino.rst b/connecting_to_sqream/client_platforms/trino.rst index 930d9b95c..cdbbc981a 100644 --- a/connecting_to_sqream/client_platforms/trino.rst +++ b/connecting_to_sqream/client_platforms/trino.rst @@ -55,7 +55,7 @@ The SQream Trino plugin must be installed on each cluster node dedicated to Trin JDBC ~~~~ -In case JDBC is not yet installed on your system, follow the `JDBC Client Drivers page <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/jdbc/index.html>`_ for installation and configuration guidance. +In case JDBC is not yet deployed, follow the `JDBC Client Drivers page <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/jdbc/index.html>`_ for registration and configuration guidance. Connecting to SQream -------------------- @@ -92,7 +92,7 @@ The following is an example of the ``DESCRIBE sqream.public.t`` statement: .. code-block:: postgres - DESCIBE sqream.public.t; + DESCRIBE sqream.public.t; Supported Data Types and Mapping @@ -124,7 +124,7 @@ Use the appropriate Trino data type for executing queries. Upon execution, incom * - ``TIMESTAMP`` - ``DATETIME`` * - ``VARCHAR(N)`` - - ``VARCHAR(N)`` + - ``VARCHAR(N)``. Note that VARCHAR is soon to be deprecated and may not be used in SQream DB. * - ``VARCHAR`` - ``TEXT`` * - ``DECIMAL(P,S)`` From 61c748e181d33adcf1cfc940d09fd473d13a6c17 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 25 Dec 2022 10:14:06 +0200 Subject: [PATCH 338/882] Delete trino.rst --- .../client_platforms/trino.rst | 143 ------------------ 1 file changed, 143 deletions(-) delete mode 100644 connecting_to_sqream/client_platforms/trino.rst diff --git a/connecting_to_sqream/client_platforms/trino.rst b/connecting_to_sqream/client_platforms/trino.rst deleted file mode 100644 index cdbbc981a..000000000 --- a/connecting_to_sqream/client_platforms/trino.rst +++ /dev/null @@ -1,143 +0,0 @@ -.. _trino: - -************************* -Connecting to SQream Using Trino -************************* - -Overview -===================== -The JDBC based SQream Trino plugin supports large volumes of data storage and fast querying. - - -.. contents:: - :local: - :depth: 1 - -Prerequisites -------------- -To use Trino with SQream, you must have the following installed: - -* SQream version 2022.1.8 or later -* Trino version 403 or later -* SQream Trino plugin xxxx -* JDBC version 4.5.6 or later - - - -Installation ------------- - -.. contents:: - :local: - :depth: 1 - - -SQream Trino Plugin -~~~~~~~~~~~~~~~~~~~ - -The SQream Trino plugin must be installed on each cluster node dedicated to Trino. - -1. Create a dedicated directory for the SQream Trino plugin. - -2. Download the `SQream Trino Plugin<...>` and extract the content of the ZIP file to the dedicated directory, as shown in the example: - - -.. code-block:: postgres - - trino-server/ - └── plugin - └── sqream - ├── sqream-jdbc.jar - ├── trino-sqream-services.jar - ├── trino-sqream-SNAPSHOT.jar - └── all dependencies - -JDBC -~~~~ - -In case JDBC is not yet deployed, follow the `JDBC Client Drivers page <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/jdbc/index.html>`_ for registration and configuration guidance. - -Connecting to SQream --------------------- - -Trino uses catalogs for referencing stored objects such as tables, databases, and functions. Each Trino catalog may be configured with access to a single SQream database. If you wish for Trino to have access to more than one SQream database or server, you must create additional catalogs. - -Catalogs may be created using ``properties`` files. Start by creating a ``sqream.properties`` file and placing it under ``trino-server/etc/catalog``. - -The following is an example of a properties file: - -.. code-block:: postgres - - connector.name=<name> - connection-url=jdbc:Sqream://<host and port>/<database name>;[<optional parameters>; ...] - connection-user=<user> - connection-password=<password> - -Syntax examples ---------------- - -The following is an example of the ``SHOW SCHEMAS FROM`` statement: - -.. code-block:: postgres - - SHOW SCHEMAS FROM sqream; - -The following is an example of the ``SHOW TABLES FROM`` statement: - -.. code-block:: postgres - - SHOW TABLES FROM sqream.public; - -The following is an example of the ``DESCRIBE sqream.public.t`` statement: - -.. code-block:: postgres - - DESCRIBE sqream.public.t; - - -Supported Data Types and Mapping --------------------------------- -Use the appropriate Trino data type for executing queries. Upon execution, incompatible data types will be converted by Trino to SQream data types. - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Trino type - - SQream type - * - ``BOOLEAN`` - - ``BOOL`` - * - ``TINYINT`` - - ``TINYINT`` - * - ``SMALLINT`` - - ``SMALLINT`` - * - ``INT`` - - ``INT`` - * - ``BIGINT`` - - ``BIGINT`` - * - ``REAL`` - - ``REAL`` - * - ``DOUBLE`` - - ``DOUBLE`` - * - ``DATE`` - - ``DATE`` - * - ``TIMESTAMP`` - - ``DATETIME`` - * - ``VARCHAR(N)`` - - ``VARCHAR(N)``. Note that VARCHAR is soon to be deprecated and may not be used in SQream DB. - * - ``VARCHAR`` - - ``TEXT`` - * - ``DECIMAL(P,S)`` - - ``NUMERIC(P,S)`` - - - -Limitations ------------ - -SQream does not support the following SQL statements: - -``GRANT`` -``REVOKE`` -``SHOW GRANTSHOW ROLES`` -``SHOW ROLE GRANTS`` \ No newline at end of file From 00c8c43f31165a9cb2daa36e74ed032448b6901e Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 25 Dec 2022 11:25:21 +0200 Subject: [PATCH 339/882] Update index.rst --- connecting_to_sqream/client_platforms/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/connecting_to_sqream/client_platforms/index.rst b/connecting_to_sqream/client_platforms/index.rst index d8c122480..8d468e5f5 100644 --- a/connecting_to_sqream/client_platforms/index.rst +++ b/connecting_to_sqream/client_platforms/index.rst @@ -21,7 +21,7 @@ If you are looking for a tool that is not listed, SQream and our partners can he :caption: In this section: :titlesonly: - trino + informatica microstrategy pentaho From 4ad945717e3a5d5ee1548ea8117af4daf772c12c Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 25 Dec 2022 16:47:38 +0200 Subject: [PATCH 340/882] Trino --- .../client_platforms/index.rst | 1 + .../client_platforms/trino.rst | 143 ++++++++++++++++++ operational_guides/index.rst | 1 + operational_guides/ldap.rst | 110 ++++++++++++++ .../sql_statements/dml_commands/delete.rst | 7 + releases/2022.1.8.rst | 4 +- releases/4.0.0_index.rst | 116 ++++++++++++++ releases/index.rst | 3 + 8 files changed, 383 insertions(+), 2 deletions(-) create mode 100644 connecting_to_sqream/client_platforms/trino.rst create mode 100644 operational_guides/ldap.rst create mode 100644 releases/4.0.0_index.rst diff --git a/connecting_to_sqream/client_platforms/index.rst b/connecting_to_sqream/client_platforms/index.rst index 8d468e5f5..5d6092e14 100644 --- a/connecting_to_sqream/client_platforms/index.rst +++ b/connecting_to_sqream/client_platforms/index.rst @@ -22,6 +22,7 @@ If you are looking for a tool that is not listed, SQream and our partners can he :titlesonly: + trino informatica microstrategy pentaho diff --git a/connecting_to_sqream/client_platforms/trino.rst b/connecting_to_sqream/client_platforms/trino.rst new file mode 100644 index 000000000..b0e21f954 --- /dev/null +++ b/connecting_to_sqream/client_platforms/trino.rst @@ -0,0 +1,143 @@ +.. _trino: + +************************* +Connecting to SQream Using Trino +************************* + +Overview +===================== +The JDBC based SQream Trino plugin supports large volumes of data storage and fast querying. + + +.. contents:: + :local: + :depth: 1 + +Prerequisites +------------- +To use Trino with SQream, you must have the following installed: + +* SQream version 2022.1.8 or later +* Trino version 403 or later +* SQream Trino plugin xxxx +* JDBC version 4.5.6 or later + + + +Installation +------------ + +.. contents:: + :local: + :depth: 1 + + +SQream Trino Plugin +~~~~~~~~~~~~~~~~~~~ + +The SQream Trino plugin must be installed on each cluster node dedicated to Trino. + +1. Create a dedicated directory for the SQream Trino plugin. + +2. Download the `SQream Trino Plugin<...>` and extract the content of the ZIP file to the dedicated directory, as shown in the example: + + +.. code-block:: postgres + + trino-server/ + └── plugin + └── sqream + ├── sqream-jdbc.jar + ├── trino-sqream-services.jar + ├── trino-sqream-SNAPSHOT.jar + └── all dependencies + +JDBC +~~~~ + +In case JDBC is not yet deployed, follow the `JDBC Client Drivers page <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/jdbc/index.html>`_ for registration and configuration guidance. + +Connecting to SQream +-------------------- + +Trino uses catalogs for referencing stored objects such as tables, databases, and functions. Each Trino catalog may be configured with access to a single SQream database. If you wish for Trino to have access to more than one SQream database or server, you must create additional catalogs. + +Catalogs may be created using ``properties`` files. Start by creating a ``sqream.properties`` file and placing it under ``trino-server/etc/catalog``. + +The following is an example of a properties file: + +.. code-block:: postgres + + connector.name=<name> + connection-url=jdbc:Sqream://<host and port>/<database name>;[<optional parameters>; ...] + connection-user=<user> + connection-password=<password> + +Syntax examples +--------------- + +The following is an example of the ``SHOW SCHEMAS FROM`` statement: + +.. code-block:: postgres + + SHOW SCHEMAS FROM sqream; + +The following is an example of the ``SHOW TABLES FROM`` statement: + +.. code-block:: postgres + + SHOW TABLES FROM sqream.public; + +The following is an example of the ``DESCRIBE sqream.public.t`` statement: + +.. code-block:: postgres + + DESCRIBE sqream.public.t; + + +Supported Data Types and Mapping +-------------------------------- +Use the appropriate Trino data type for executing queries. Upon execution, incompatible data types will be converted by Trino to SQream data types. + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Trino type + - SQream type + * - ``BOOLEAN`` + - ``BOOL`` + * - ``TINYINT`` + - ``TINYINT`` + * - ``SMALLINT`` + - ``SMALLINT`` + * - ``INT`` + - ``INT`` + * - ``BIGINT`` + - ``BIGINT`` + * - ``REAL`` + - ``REAL`` + * - ``DOUBLE`` + - ``DOUBLE`` + * - ``DATE`` + - ``DATE`` + * - ``TIMESTAMP`` + - ``DATETIME`` + * - ``VARCHAR(N)`` + - ``VARCHAR(N)``. + * - ``VARCHAR`` + - ``TEXT`` + * - ``DECIMAL(P,S)`` + - ``NUMERIC(P,S)`` + +.. note:: ``VARCHAR`` is soon to be deprecated and may not be used in SQream DB. + +Limitations +----------- + +SQream does not support the following SQL statements: + +``GRANT`` +``REVOKE`` +``SHOW GRANTSHOW ROLES`` +``SHOW ROLE GRANTS`` \ No newline at end of file diff --git a/operational_guides/index.rst b/operational_guides/index.rst index 048efb06f..ee45ec254 100644 --- a/operational_guides/index.rst +++ b/operational_guides/index.rst @@ -21,6 +21,7 @@ This section summarizes the following operational guides: logging monitoring_query_performance security + ldap saved_queries seeing_system_objects_as_ddl configuration diff --git a/operational_guides/ldap.rst b/operational_guides/ldap.rst new file mode 100644 index 000000000..1cfe78bd2 --- /dev/null +++ b/operational_guides/ldap.rst @@ -0,0 +1,110 @@ +.. _ldap: + +************************* +LDAP Authentication +************************* + +.. contents:: In this topic: + :local: + + +Overview +============ + +Lightweight Directory Access Protocol (LDAP) is an external authentication source. Once LDAP is configured to authenticate SQream users, all existing roles, with the exception of a ``SUPERUSER``, are required to be authenticated by an external LDAP server. + + +New Flag Attributes +------------------- +To enable LDAP Authentication, configure the following **cluster** flag attributes using the ``ALERT SYSTEM SET`` command: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Attribute + - Description + * - ``authenticationMethod`` + - Configure an authentication method. Attribute may be set to either ``sqream`` or ``ldap``. To configure LDAP, choose ``ldap``. + * - ``ldapDomain`` + - Configure users` location domain. + * - ``ldapIpAddress`` + - Configure the IP address of your LDAP server and select a protocol. Out of the ``ldap`` and ``ldaps``, we recommend to use the encrypted ``ldaps`` protocol. + * - ``ldapConnTimeoutSec`` + - Configure the LDAP connection timeout threshold (seconds). The default is 30 seconds. + + +LDAP Configuration +================== + +Configuring system roles +------------------------ +It is recommend to set up the roles of externally authenticated users in advance. + +To set up roles, follow these steps: + +1. Create a new role. + +.. code-block:: postgres + + CREATE ROLE my_new_role; + +2. Grant new role login permissions. + +.. code-block:: postgres + + GRANT LOGIN TO my_new_role; + +Grant a specific database role ``CONNECT`` permissions. + +.. code-block:: postgres + + GRANT CONNECT ON DATABASE my_database TO my_new_role; + +Note - in the case that no role exists but LDAP authentication is successful, a role with no login or connection permissions will be added. + + +Enabling LDAP Authentication +---------------------------- + +Only roles with admin privileges or higher may enable LDAP Authentication. + +To enable LDAP Authentication, follow these steps. The provided syntax for each of the steps is an example. + +1. Set the ``ldapIpAddress`` attribute. + +.. code-block:: postgres + + ALTER SYSTEM SET ldapIpAddress = 'ldaps://192.168.10.20'; + +2. Set the ``ldapDomain`` attribute. + +.. code-block:: postgres + + ALTER SYSTEM SET ldapDomain = '@sqream.loc'; + +3. Set the ``ldapConnTimeoutSec`` attribute (Optional). + +.. code-block:: postgres + + ALTER SYSTEM SET ldapConnTimeoutSec = 15; + +4. Set the ``authenticationMethod`` attribute. + +.. code-block:: postgres + + ALTER SYSTEM SET authenticationMethod = 'ldap'; + +5. **Reset all ``sqreamd`` servers.** + + +Disabling LDAP Authentication +----------------------------- + +To disable LDAB authentication and configure sqream authentication, execute the following syntax: + +.. code-block:: postgres + + ALTER SYSTEM SET authenticationMethod = 'sqream'; + + diff --git a/reference/sql/sql_statements/dml_commands/delete.rst b/reference/sql/sql_statements/dml_commands/delete.rst index 2aa9c6729..9240172e7 100644 --- a/reference/sql/sql_statements/dml_commands/delete.rst +++ b/reference/sql/sql_statements/dml_commands/delete.rst @@ -72,6 +72,13 @@ The following is the correct syntax for triggering a clean-up: schema_name ::= identifier +For high-concurrency storage systems, use the following syntax to enhance deletion performance and shorten runtime: + +.. code-block:: postgres + + SELECT set_parallel_delete_threads(x); + +.. note:: You may configure up to 10 threads. Parameters ============ diff --git a/releases/2022.1.8.rst b/releases/2022.1.8.rst index 46ca54d1d..d081d3998 100644 --- a/releases/2022.1.8.rst +++ b/releases/2022.1.8.rst @@ -12,11 +12,11 @@ The 2022.1.8 release notes were released on xx/xx/2022 and describe the followin New Features ---------- - * xxxxxxxxx GCP + * Re-enabling an enhanced version of the :ref:`License Storage Capacity<monitoring_workers_and_services_from_the_dashboard>` feature :: - * xxxxxxxxx Trino + * :ref:`Physical deletion performance enhancement<delete>` by supporting file systems with parallelism capabilities :: diff --git a/releases/4.0.0_index.rst b/releases/4.0.0_index.rst new file mode 100644 index 000000000..829177e8e --- /dev/null +++ b/releases/4.0.0_index.rst @@ -0,0 +1,116 @@ +.. _4.0.0: + +************************** +Release Notes 4.0.0 +************************** +The 4.0.0 release notes were released on xx/xx/20xx and describe the following: + +.. contents:: + :local: + :depth: 1 + +New Features +---------- + + * Re-enabling an enhanced version of the :ref:`License Storage Capacity<monitoring_workers_and_services_from_the_dashboard>` feature + + :: + + * :ref:`Physical deletion performance enhancement<delete>` by supporting file systems with parallelism capabilities + + :: + + +Known Issues +--------- +:ref:`Percentile<percentile_disc>` is not supported for Window functions. + +Version 4.0.0 resolved Issues +--------- + ++---------------+------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++===============+==========================================================================================+ +| SQ-11199 | AWS S3 internal runtime error when executing ``COPY TO`` statement | ++---------------+------------------------------------------------------------------------------------------+ +| SQ-11772 | Slow ``JOIN`` query | ++---------------+------------------------------------------------------------------------------------------+ +| SQ-12228 | ``CREATE AS SELECT`` statement fails when executed with ``UNION ALL`` and ``GROUP BY`` | ++---------------+------------------------------------------------------------------------------------------+ +| SQ-11296 | Slow catalog queries | ++---------------+------------------------------------------------------------------------------------------+ +| SQ-11948 | ``SAVED QUERY`` execution using ``SELECT`` or ``INSERT INTO`` returns error | ++---------------+------------------------------------------------------------------------------------------+ +| SQ-12255 | ``COPY TO`` string export error | ++---------------+------------------------------------------------------------------------------------------+ +| SQ-12310 | ``DICT`` compression buffer size issue | ++---------------+------------------------------------------------------------------------------------------+ +| SQ-12318 | JDBC ``insertBuffer`` parameter issue | ++---------------+------------------------------------------------------------------------------------------+ +| SQ-12364 | ``GET DDL`` foreign table output issue | ++---------------+------------------------------------------------------------------------------------------+ +| SQ-12468 | Internal compiler error | ++---------------+------------------------------------------------------------------------------------------+ + + + + + + +Configuration Changes +-------- +No configuration changes were made. + +Naming Changes +------- +No relevant naming changes were made. + +Deprecated Features +------- +SQream is declaring end of support of VARCHAR data type, the decision resulted by SQream's effort to enhance its core functionalities and with respect to ever changing echo system requirements. + +VARCHAR is no longer supported for new customers - effective from Version 2022.1.3 (September 2022). + +TEXT data type is replacing VARCHAR and NVARCHAR - SQream will maintain VARCHAR data type support until 09/30/2023. + + +End of Support +------- +No End of Support changes were made. + +Upgrading to v4.0.0 +------- +1. Generate a back-up of the metadata by running the following command: + + .. code-block:: console + + $ select backup_metadata('out_path'); + + .. tip:: SQream recommends storing the generated back-up locally in case needed. + + SQream runs the Garbage Collector and creates a clean backup tarball package. + +2. Shut down all SQream services. + + :: + +3. Extract the recently created back-up file. + + :: + +4. Replace your current metadata with the metadata you stored in the back-up file. + + :: + +5. Navigate to the new SQream package bin folder. + + :: + +6. Run the following command: + + .. code-block:: console + + $ ./upgrade_storage <levelDB path> + + .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. + diff --git a/releases/index.rst b/releases/index.rst index 84024586e..107f323c8 100644 --- a/releases/index.rst +++ b/releases/index.rst @@ -12,6 +12,8 @@ Release Notes * - Version - Release Date + * - :ref:`4.0.0` + - XXXX xx, xxxx * - :ref:`2022.1` - July 19, 2022 * - :ref:`2021.2` @@ -32,6 +34,7 @@ Release Notes :glob: :hidden: + 4.0.0_index 2022.1_index 2021.2_index 2021.1_index From 7564a0d97c276c8b535fca0b4c2ba8355a997468 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 25 Dec 2022 17:15:49 +0200 Subject: [PATCH 341/882] Deletion --- reference/sql/sql_statements/dml_commands/delete.rst | 2 +- releases/2022.1.8.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/delete.rst b/reference/sql/sql_statements/dml_commands/delete.rst index 9240172e7..b561eaf78 100644 --- a/reference/sql/sql_statements/dml_commands/delete.rst +++ b/reference/sql/sql_statements/dml_commands/delete.rst @@ -72,7 +72,7 @@ The following is the correct syntax for triggering a clean-up: schema_name ::= identifier -For high-concurrency storage systems, use the following syntax to enhance deletion performance and shorten runtime: +For systems with delete parallelism capabilities, use the following syntax to enhance deletion performance and shorten runtime: .. code-block:: postgres diff --git a/releases/2022.1.8.rst b/releases/2022.1.8.rst index d081d3998..c7ea25263 100644 --- a/releases/2022.1.8.rst +++ b/releases/2022.1.8.rst @@ -16,7 +16,7 @@ New Features :: - * :ref:`Physical deletion performance enhancement<delete>` by supporting file systems with parallelism capabilities + * :ref:`Physical deletion performance enhancement<delete>` for file systems with delete parallelism capabilities :: From 63ef1a112cbf39698e1c59cd0e94a81ec4afc8a6 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 25 Dec 2022 17:42:02 +0200 Subject: [PATCH 342/882] Update ldap.rst --- operational_guides/ldap.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/operational_guides/ldap.rst b/operational_guides/ldap.rst index 1cfe78bd2..596dd382e 100644 --- a/operational_guides/ldap.rst +++ b/operational_guides/ldap.rst @@ -25,9 +25,9 @@ To enable LDAP Authentication, configure the following **cluster** flag attribut * - Attribute - Description * - ``authenticationMethod`` - - Configure an authentication method. Attribute may be set to either ``sqream`` or ``ldap``. To configure LDAP, choose ``ldap``. + - Configure an authentication method. Attribute may be set to either ``sqream`` or ``ldap``. To configure LDAP authentication, choose ``ldap``. * - ``ldapDomain`` - - Configure users` location domain. + - Configure users` domain. * - ``ldapIpAddress`` - Configure the IP address of your LDAP server and select a protocol. Out of the ``ldap`` and ``ldaps``, we recommend to use the encrypted ``ldaps`` protocol. * - ``ldapConnTimeoutSec`` @@ -39,9 +39,9 @@ LDAP Configuration Configuring system roles ------------------------ -It is recommend to set up the roles of externally authenticated users in advance. +When using external authentication such as LDAP, it is recommend that roles be configured in advance. -To set up roles, follow these steps: +To configure roles, follow these steps: 1. Create a new role. @@ -55,7 +55,7 @@ To set up roles, follow these steps: GRANT LOGIN TO my_new_role; -Grant a specific database role ``CONNECT`` permissions. +Grant the new role ``CONNECT`` permissions. .. code-block:: postgres From daa2205903dba5f46487e67813176996e6dad7fc Mon Sep 17 00:00:00 2001 From: TaliaSQream <taliar@sqreamtech.com> Date: Mon, 26 Dec 2022 12:19:01 +0200 Subject: [PATCH 343/882] Update ldap.rst --- operational_guides/ldap.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/operational_guides/ldap.rst b/operational_guides/ldap.rst index 596dd382e..cf8036739 100644 --- a/operational_guides/ldap.rst +++ b/operational_guides/ldap.rst @@ -11,7 +11,7 @@ LDAP Authentication Overview ============ -Lightweight Directory Access Protocol (LDAP) is an external authentication source. Once LDAP is configured to authenticate SQream users, all existing roles, with the exception of a ``SUPERUSER``, are required to be authenticated by an external LDAP server. +Lightweight Directory Access Protocol (LDAP) is an authentication management service. Once LDAP is configured to authenticate SQream users, all existing roles, with the exception of a ``SUPERUSER``, are required to be authenticated by an external LDAP server. New Flag Attributes From 7b8b68e317ab2deffd0113dcf0a48c9651d8e08b Mon Sep 17 00:00:00 2001 From: TaliaSQream <taliar@sqreamtech.com> Date: Mon, 26 Dec 2022 12:21:56 +0200 Subject: [PATCH 344/882] Update ldap.rst --- operational_guides/ldap.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/operational_guides/ldap.rst b/operational_guides/ldap.rst index cf8036739..16b2e1115 100644 --- a/operational_guides/ldap.rst +++ b/operational_guides/ldap.rst @@ -9,13 +9,13 @@ LDAP Authentication Overview -============ +======== -Lightweight Directory Access Protocol (LDAP) is an authentication management service. Once LDAP is configured to authenticate SQream users, all existing roles, with the exception of a ``SUPERUSER``, are required to be authenticated by an external LDAP server. +Lightweight Directory Access Protocol (LDAP) is an authentication management service. Once LDAP is configured to authenticate SQream users, all existing roles, with the exception of a ``SUPERUSER``, are required to be authenticated by an LDAP server. -New Flag Attributes -------------------- +Flag Attributes +--------------- To enable LDAP Authentication, configure the following **cluster** flag attributes using the ``ALERT SYSTEM SET`` command: .. list-table:: From 7e68e0d14cc9623b91ee96dcb8a8b127b160cedd Mon Sep 17 00:00:00 2001 From: TaliaSQream <taliar@sqreamtech.com> Date: Mon, 26 Dec 2022 12:24:54 +0200 Subject: [PATCH 345/882] Update ldap.rst --- operational_guides/ldap.rst | 38 ++++++++++++++++++------------------- 1 file changed, 18 insertions(+), 20 deletions(-) diff --git a/operational_guides/ldap.rst b/operational_guides/ldap.rst index 16b2e1115..2133927d9 100644 --- a/operational_guides/ldap.rst +++ b/operational_guides/ldap.rst @@ -13,26 +13,6 @@ Overview Lightweight Directory Access Protocol (LDAP) is an authentication management service. Once LDAP is configured to authenticate SQream users, all existing roles, with the exception of a ``SUPERUSER``, are required to be authenticated by an LDAP server. - -Flag Attributes ---------------- -To enable LDAP Authentication, configure the following **cluster** flag attributes using the ``ALERT SYSTEM SET`` command: - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Attribute - - Description - * - ``authenticationMethod`` - - Configure an authentication method. Attribute may be set to either ``sqream`` or ``ldap``. To configure LDAP authentication, choose ``ldap``. - * - ``ldapDomain`` - - Configure users` domain. - * - ``ldapIpAddress`` - - Configure the IP address of your LDAP server and select a protocol. Out of the ``ldap`` and ``ldaps``, we recommend to use the encrypted ``ldaps`` protocol. - * - ``ldapConnTimeoutSec`` - - Configure the LDAP connection timeout threshold (seconds). The default is 30 seconds. - LDAP Configuration ================== @@ -63,6 +43,24 @@ Grant the new role ``CONNECT`` permissions. Note - in the case that no role exists but LDAP authentication is successful, a role with no login or connection permissions will be added. +Flag Attributes +--------------- +To enable LDAP Authentication, configure the following **cluster** flag attributes using the ``ALERT SYSTEM SET`` command: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Attribute + - Description + * - ``authenticationMethod`` + - Configure an authentication method. Attribute may be set to either ``sqream`` or ``ldap``. To configure LDAP authentication, choose ``ldap``. + * - ``ldapDomain`` + - Configure users` domain. + * - ``ldapIpAddress`` + - Configure the IP address of your LDAP server and select a protocol. Out of the ``ldap`` and ``ldaps``, we recommend to use the encrypted ``ldaps`` protocol. + * - ``ldapConnTimeoutSec`` + - Configure the LDAP connection timeout threshold (seconds). The default is 30 seconds. Enabling LDAP Authentication ---------------------------- From 2e76150951c4669e3858ef4e17ee7a501762ec4f Mon Sep 17 00:00:00 2001 From: TaliaSQream <taliar@sqreamtech.com> Date: Mon, 26 Dec 2022 12:49:23 +0200 Subject: [PATCH 346/882] Update ldap.rst --- operational_guides/ldap.rst | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/operational_guides/ldap.rst b/operational_guides/ldap.rst index 2133927d9..44e707559 100644 --- a/operational_guides/ldap.rst +++ b/operational_guides/ldap.rst @@ -1,25 +1,26 @@ .. _ldap: -************************* -LDAP Authentication -************************* - -.. contents:: In this topic: - :local: +************************************* +Configuring authentication using LDAP +************************************* -Overview -======== - Lightweight Directory Access Protocol (LDAP) is an authentication management service. Once LDAP is configured to authenticate SQream users, all existing roles, with the exception of a ``SUPERUSER``, are required to be authenticated by an LDAP server. + +.. contents:: In this topic: + :local: + + LDAP Configuration ================== Configuring system roles ------------------------ -When using external authentication such as LDAP, it is recommend that roles be configured in advance. + +It is recommended that SQream roles be configured before implementing LDAP authentication. + To configure roles, follow these steps: From bfa8442273777d4745cac40542af0d5f067fbc1c Mon Sep 17 00:00:00 2001 From: TaliaSQream <taliar@sqreamtech.com> Date: Mon, 26 Dec 2022 12:52:35 +0200 Subject: [PATCH 347/882] Update ldap.rst --- operational_guides/ldap.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/operational_guides/ldap.rst b/operational_guides/ldap.rst index 44e707559..63f64d2c4 100644 --- a/operational_guides/ldap.rst +++ b/operational_guides/ldap.rst @@ -16,13 +16,13 @@ Lightweight Directory Access Protocol (LDAP) is an authentication management ser LDAP Configuration ================== -Configuring system roles +Configuring SQream roles ------------------------ It is recommended that SQream roles be configured before implementing LDAP authentication. -To configure roles, follow these steps: +**Procedure** 1. Create a new role. From d20105ad15807ee3578bc27046836cc418041b3a Mon Sep 17 00:00:00 2001 From: TaliaSQream <taliar@sqreamtech.com> Date: Mon, 26 Dec 2022 13:02:01 +0200 Subject: [PATCH 348/882] Update ldap.rst --- operational_guides/ldap.rst | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/operational_guides/ldap.rst b/operational_guides/ldap.rst index 63f64d2c4..6ab04dbdb 100644 --- a/operational_guides/ldap.rst +++ b/operational_guides/ldap.rst @@ -24,25 +24,26 @@ It is recommended that SQream roles be configured before implementing LDAP authe **Procedure** -1. Create a new role. +1. To create a new role, run: .. code-block:: postgres - CREATE ROLE my_new_role; + CREATE ROLE <new_role>; -2. Grant new role login permissions. +2. To grant new role login permissions: .. code-block:: postgres - GRANT LOGIN TO my_new_role; + GRANT LOGIN TO <new_role>; -Grant the new role ``CONNECT`` permissions. +3. To grant the new role ``CONNECT`` permissions: .. code-block:: postgres - GRANT CONNECT ON DATABASE my_database TO my_new_role; + GRANT CONNECT ON DATABASE <my_database> TO <new_role>; -Note - in the case that no role exists but LDAP authentication is successful, a role with no login or connection permissions will be added. + +If no role exists but LDAP authentication is successful, a role with no login or connection permissions will be added. Flag Attributes --------------- From b732256201e825c87d45b21e4f1c53de0cf10869 Mon Sep 17 00:00:00 2001 From: TaliaSQream <taliar@sqreamtech.com> Date: Mon, 26 Dec 2022 13:38:30 +0200 Subject: [PATCH 349/882] Update ldap.rst --- operational_guides/ldap.rst | 37 ++++++++++++++++++++----------------- 1 file changed, 20 insertions(+), 17 deletions(-) diff --git a/operational_guides/ldap.rst b/operational_guides/ldap.rst index 6ab04dbdb..c500dd8d1 100644 --- a/operational_guides/ldap.rst +++ b/operational_guides/ldap.rst @@ -13,37 +13,39 @@ Lightweight Directory Access Protocol (LDAP) is an authentication management ser :local: -LDAP Configuration -================== Configuring SQream roles ------------------------- +======================== It is recommended that SQream roles be configured before implementing LDAP authentication. **Procedure** -1. To create a new role, run: +1. Create a new role: .. code-block:: postgres CREATE ROLE <new_role>; -2. To grant new role login permissions: +2. Grant new role login permission: .. code-block:: postgres GRANT LOGIN TO <new_role>; -3. To grant the new role ``CONNECT`` permissions: +3. Grant the new role ``CONNECT`` permission: .. code-block:: postgres GRANT CONNECT ON DATABASE <my_database> TO <new_role>; -If no role exists but LDAP authentication is successful, a role with no login or connection permissions will be added. +.. note:: If no role exists but LDAP authentication is successful, a role with no login or connection permissions will be added. + + +Configuring LDAP Authentication +============================ Flag Attributes --------------- @@ -63,33 +65,34 @@ To enable LDAP Authentication, configure the following **cluster** flag attribut - Configure the IP address of your LDAP server and select a protocol. Out of the ``ldap`` and ``ldaps``, we recommend to use the encrypted ``ldaps`` protocol. * - ``ldapConnTimeoutSec`` - Configure the LDAP connection timeout threshold (seconds). The default is 30 seconds. +.. comment:: Enabling LDAP Authentication ----------------------------- +------------------------------- Only roles with admin privileges or higher may enable LDAP Authentication. -To enable LDAP Authentication, follow these steps. The provided syntax for each of the steps is an example. +**Procedure** -1. Set the ``ldapIpAddress`` attribute. +1. Set the ``ldapIpAddress`` attribute: .. code-block:: postgres - ALTER SYSTEM SET ldapIpAddress = 'ldaps://192.168.10.20'; + ALTER SYSTEM SET ldapIpAddress = 'ldaps://<192.168.10.20>'; -2. Set the ``ldapDomain`` attribute. +2. Set the ``ldapDomain`` attribute: .. code-block:: postgres - ALTER SYSTEM SET ldapDomain = '@sqream.loc'; + ALTER SYSTEM SET ldapDomain = <'@sqream.loc'>; -3. Set the ``ldapConnTimeoutSec`` attribute (Optional). +3. To set the ``ldapConnTimeoutSec`` attribute (Optional), run: .. code-block:: postgres - ALTER SYSTEM SET ldapConnTimeoutSec = 15; + ALTER SYSTEM SET ldapConnTimeoutSec = <15>; -4. Set the ``authenticationMethod`` attribute. +4. Set the ``authenticationMethod`` attribute: .. code-block:: postgres @@ -101,7 +104,7 @@ To enable LDAP Authentication, follow these steps. The provided syntax for each Disabling LDAP Authentication ----------------------------- -To disable LDAB authentication and configure sqream authentication, execute the following syntax: +To disable LDAP authentication and configure sqream authentication, execute the following syntax: .. code-block:: postgres From 6175f17fb59bdd7acb441526bd23fe145288fb58 Mon Sep 17 00:00:00 2001 From: TaliaSQream <taliar@sqreamtech.com> Date: Mon, 26 Dec 2022 14:13:51 +0200 Subject: [PATCH 350/882] Update ldap.rst --- operational_guides/ldap.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/operational_guides/ldap.rst b/operational_guides/ldap.rst index c500dd8d1..299ed02c7 100644 --- a/operational_guides/ldap.rst +++ b/operational_guides/ldap.rst @@ -1,7 +1,7 @@ .. _ldap: ************************************* -Configuring authentication using LDAP +Configuring LDAP authentication ************************************* From 058f3ca96b9e0148c49bf91e293fdea9a56e0b5c Mon Sep 17 00:00:00 2001 From: TaliaSQream <taliar@sqreamtech.com> Date: Mon, 26 Dec 2022 14:16:00 +0200 Subject: [PATCH 351/882] Update ldap.rst --- operational_guides/ldap.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/operational_guides/ldap.rst b/operational_guides/ldap.rst index 299ed02c7..a91e3387c 100644 --- a/operational_guides/ldap.rst +++ b/operational_guides/ldap.rst @@ -104,7 +104,7 @@ Only roles with admin privileges or higher may enable LDAP Authentication. Disabling LDAP Authentication ----------------------------- -To disable LDAP authentication and configure sqream authentication, execute the following syntax: +To disable LDAP authentication and configure sqream authentication, use the following syntax: .. code-block:: postgres From 55e1a472e6006b0ebee30ad1ed16422b3cb127e4 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 27 Dec 2022 10:36:06 +0200 Subject: [PATCH 352/882] LDAP --- configuration_guides/index.rst | 1 + .../ldap.rst | 18 ++++++++++-------- operational_guides/index.rst | 1 - 3 files changed, 11 insertions(+), 9 deletions(-) rename {operational_guides => configuration_guides}/ldap.rst (79%) diff --git a/configuration_guides/index.rst b/configuration_guides/index.rst index 6805bc188..9c0b206e7 100644 --- a/configuration_guides/index.rst +++ b/configuration_guides/index.rst @@ -12,5 +12,6 @@ The **Configuration Guides** page describes the following configuration informat spooling configuring_sqream + ldap configuration_flags previous_configuration_method \ No newline at end of file diff --git a/operational_guides/ldap.rst b/configuration_guides/ldap.rst similarity index 79% rename from operational_guides/ldap.rst rename to configuration_guides/ldap.rst index a91e3387c..e9c13ad7f 100644 --- a/operational_guides/ldap.rst +++ b/configuration_guides/ldap.rst @@ -5,7 +5,7 @@ Configuring LDAP authentication ************************************* -Lightweight Directory Access Protocol (LDAP) is an authentication management service. Once LDAP is configured to authenticate SQream users, all existing roles, with the exception of a ``SUPERUSER``, are required to be authenticated by an LDAP server. +Lightweight Directory Access Protocol (LDAP) is an authentication management service. Once LDAP is configured to authenticate SQream users, all existing SQream roles, with the exception of a ``SUPERUSER``, will be required to be authenticated by an LDAP server. @@ -17,7 +17,7 @@ Lightweight Directory Access Protocol (LDAP) is an authentication management ser Configuring SQream roles ======================== -It is recommended that SQream roles be configured before implementing LDAP authentication. +It is recommended that SQream roles be configured before implementing LDAP authentication. **Procedure** @@ -45,7 +45,7 @@ It is recommended that SQream roles be configured before implementing LDAP authe Configuring LDAP Authentication -============================ +=============================== Flag Attributes --------------- @@ -62,7 +62,7 @@ To enable LDAP Authentication, configure the following **cluster** flag attribut * - ``ldapDomain`` - Configure users` domain. * - ``ldapIpAddress`` - - Configure the IP address of your LDAP server and select a protocol. Out of the ``ldap`` and ``ldaps``, we recommend to use the encrypted ``ldaps`` protocol. + - Configure the IP address or the Fully Qualified Domain Name (FQDN) of your LDAP server and select a protocol. Out of the ``ldap`` and ``ldaps``, we recommend to use the encrypted ``ldaps`` protocol. * - ``ldapConnTimeoutSec`` - Configure the LDAP connection timeout threshold (seconds). The default is 30 seconds. .. comment:: @@ -70,7 +70,7 @@ To enable LDAP Authentication, configure the following **cluster** flag attribut Enabling LDAP Authentication ------------------------------- -Only roles with admin privileges or higher may enable LDAP Authentication. +Only roles with SQream ``SUPERUSER`` privileges or higher may enable LDAP Authentication. **Procedure** @@ -98,16 +98,18 @@ Only roles with admin privileges or higher may enable LDAP Authentication. ALTER SYSTEM SET authenticationMethod = 'ldap'; -5. **Reset all ``sqreamd`` servers.** +5. Restart all sqreamd servers. Disabling LDAP Authentication ----------------------------- -To disable LDAP authentication and configure sqream authentication, use the following syntax: +To disable LDAP authentication and configure sqream authentication: + +1. Execute the following syntax: .. code-block:: postgres ALTER SYSTEM SET authenticationMethod = 'sqream'; - +2. Restart all sqreamd servers. diff --git a/operational_guides/index.rst b/operational_guides/index.rst index ee45ec254..048efb06f 100644 --- a/operational_guides/index.rst +++ b/operational_guides/index.rst @@ -21,7 +21,6 @@ This section summarizes the following operational guides: logging monitoring_query_performance security - ldap saved_queries seeing_system_objects_as_ddl configuration From 0a4e26fc7a829d8ac1e7fb6ea822cfaf3c135d7e Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 27 Dec 2022 13:13:31 +0200 Subject: [PATCH 353/882] Update ldap.rst --- configuration_guides/ldap.rst | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/configuration_guides/ldap.rst b/configuration_guides/ldap.rst index e9c13ad7f..c4a03fa87 100644 --- a/configuration_guides/ldap.rst +++ b/configuration_guides/ldap.rst @@ -5,9 +5,9 @@ Configuring LDAP authentication ************************************* -Lightweight Directory Access Protocol (LDAP) is an authentication management service. Once LDAP is configured to authenticate SQream users, all existing SQream roles, with the exception of a ``SUPERUSER``, will be required to be authenticated by an LDAP server. +Lightweight Directory Access Protocol (LDAP) is a Microsoft Active Directory authentication management service. Once LDAP is configured to authenticate SQream users, all existing SQream roles, with the exception of a ``SUPERUSER``, will be required to be authenticated by an LDAP server. - +It is recommended that SQream roles be configured before integrating LDAP authentication. This is ideal for when SQream DB is installed within an environment which had already been integrated with LDAP or for when creating a new SQream role when SQream DB had already been integrated with LDAP. .. contents:: In this topic: :local: @@ -17,7 +17,6 @@ Lightweight Directory Access Protocol (LDAP) is an authentication management ser Configuring SQream roles ======================== -It is recommended that SQream roles be configured before implementing LDAP authentication. **Procedure** From d08c4126b396f1eef515cd8e450e0b317f987485 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 27 Dec 2022 13:25:42 +0200 Subject: [PATCH 354/882] Update ldap.rst --- configuration_guides/ldap.rst | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/configuration_guides/ldap.rst b/configuration_guides/ldap.rst index c4a03fa87..41f726644 100644 --- a/configuration_guides/ldap.rst +++ b/configuration_guides/ldap.rst @@ -7,7 +7,11 @@ Configuring LDAP authentication Lightweight Directory Access Protocol (LDAP) is a Microsoft Active Directory authentication management service. Once LDAP is configured to authenticate SQream users, all existing SQream roles, with the exception of a ``SUPERUSER``, will be required to be authenticated by an LDAP server. -It is recommended that SQream roles be configured before integrating LDAP authentication. This is ideal for when SQream DB is installed within an environment which had already been integrated with LDAP or for when creating a new SQream role when SQream DB had already been integrated with LDAP. +It is recommended that SQream roles be configured before integrating LDAP authentication. + +This is ideal for when: + * SQream DB is being installed within an environment which had already been integrated with LDAP + * Creating a new SQream role when SQream DB had already been integrated with LDAP .. contents:: In this topic: :local: From b36dfdba5722428eda7e2a036f5cb0406c8e97c9 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 27 Dec 2022 16:33:27 +0200 Subject: [PATCH 355/882] Update copy_to.rst --- reference/sql/sql_statements/dml_commands/copy_to.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/dml_commands/copy_to.rst b/reference/sql/sql_statements/dml_commands/copy_to.rst index 0edb0a4d6..783f9a4f9 100644 --- a/reference/sql/sql_statements/dml_commands/copy_to.rst +++ b/reference/sql/sql_statements/dml_commands/copy_to.rst @@ -96,7 +96,7 @@ The following table shows the ``COPY_TO`` elements: * - ``MAX_FILE_SIZE`` - Sets the maximum file size (bytes). Default value: 16*2^20 (16MB). * - ``ENFORCE_SINGLE_FILE`` - - Enforces the maximum file size (bytes). Permitted values: ``true`` - creates one file of unlimited size, ``false`` - permits creating several files together limited by the ``MAX_FILE_SIZE``. When set to ``true``, the single file size is not limited by the ``MAX_FILE_SIZE`` setting. When set to ``false``, the combined file sizes cannot exceed the ``MAX_FILE_SIZE``. Default value: ``FALSE``. + - Enforces the maximum file size (bytes). Permitted values: ``true`` - creates one file of unlimited size, ``false`` - permits creating several files together limited by the ``MAX_FILE_SIZE``. When set to ``true``, the single file size is not limited by the ``MAX_FILE_SIZE`` setting. When set to ``false``, the combined file sizes cannot exceed the ``MAX_FILE_SIZE``. Default value: ``TRUE``. Usage Notes =============== From 1343f354a55be33bfd8196db02cf289e862f7665 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 29 Dec 2022 11:47:35 +0200 Subject: [PATCH 356/882] Update ldap.rst --- configuration_guides/ldap.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/configuration_guides/ldap.rst b/configuration_guides/ldap.rst index 41f726644..9080699cd 100644 --- a/configuration_guides/ldap.rst +++ b/configuration_guides/ldap.rst @@ -5,7 +5,7 @@ Configuring LDAP authentication ************************************* -Lightweight Directory Access Protocol (LDAP) is a Microsoft Active Directory authentication management service. Once LDAP is configured to authenticate SQream users, all existing SQream roles, with the exception of a ``SUPERUSER``, will be required to be authenticated by an LDAP server. +Lightweight Directory Access Protocol (LDAP) is an authentication management service. Once LDAP is configured to authenticate SQream users, all existing SQream roles, with the exception of a ``SUPERUSER``, will be required to be authenticated by an LDAP server. It is recommended that SQream roles be configured before integrating LDAP authentication. From b8c9274d694b79fc3df63620661fde1319857ad3 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 29 Dec 2022 12:53:04 +0200 Subject: [PATCH 357/882] Update 4.0.0_index.rst --- releases/4.0.0_index.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/releases/4.0.0_index.rst b/releases/4.0.0_index.rst index 829177e8e..6a81d2338 100644 --- a/releases/4.0.0_index.rst +++ b/releases/4.0.0_index.rst @@ -9,6 +9,8 @@ The 4.0.0 release notes were released on xx/xx/20xx and describe the following: :local: :depth: 1 +SQream is introducing a more commonly used versioning system, beginning with 4.0.0 as a minor version. + New Features ---------- From 9c7c9e9ccb4628c48c8145684440f542e72500ba Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 29 Dec 2022 13:07:54 +0200 Subject: [PATCH 358/882] double --- .../sql/sql_functions/scalar_functions/numeric/ceiling.rst | 2 +- reference/sql/sql_functions/scalar_functions/numeric/round.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/numeric/ceiling.rst b/reference/sql/sql_functions/scalar_functions/numeric/ceiling.rst index fad39aae6..39a63ddab 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/ceiling.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/ceiling.rst @@ -32,7 +32,7 @@ Arguments Returns ============ -* ``CEIL`` Always returns a floating point result. +``CEIL`` always returns a ``double`` floating point number. Notes diff --git a/reference/sql/sql_functions/scalar_functions/numeric/round.rst b/reference/sql/sql_functions/scalar_functions/numeric/round.rst index 842224edd..553344246 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/round.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/round.rst @@ -32,7 +32,7 @@ Arguments Returns ============ -Always returns a floating point result. +``ROUND``always returns a ``double`` floating point number. Notes ======= From fa55f8770e23b22377667fba4cf87ade9a773be9 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 29 Dec 2022 15:15:44 +0200 Subject: [PATCH 359/882] Update ldap.rst --- configuration_guides/ldap.rst | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/configuration_guides/ldap.rst b/configuration_guides/ldap.rst index 9080699cd..d3fa0ddcb 100644 --- a/configuration_guides/ldap.rst +++ b/configuration_guides/ldap.rst @@ -5,13 +5,12 @@ Configuring LDAP authentication ************************************* -Lightweight Directory Access Protocol (LDAP) is an authentication management service. Once LDAP is configured to authenticate SQream users, all existing SQream roles, with the exception of a ``SUPERUSER``, will be required to be authenticated by an LDAP server. +Lightweight Directory Access Protocol (LDAP) is an authentication management service. Once it has been configured to authenticate SQream roles, all existing and newly added roles will be required to be authenticated by an LDAP server, with the exception of the initial system deployment ``sqream`` role, which is granted full control permissions upon deployment. -It is recommended that SQream roles be configured before integrating LDAP authentication. +Prior to integrating SQream with LDAP, two preconditions must be considered: -This is ideal for when: - * SQream DB is being installed within an environment which had already been integrated with LDAP - * Creating a new SQream role when SQream DB had already been integrated with LDAP + * If SQream DB is being installed within an LDAP-integrated environment, it is best practice to ensure that the newly created SQream role names are consistent with existing LDAP user names. + * If LDAP is being integrated with a SQream environment, it is best practice to ensure that the newly created LDAP user names are consistent with existing SQream role names. Note that after LDAP has been successfully integrated, SQream roles that were mistakenly not configured or have conflicting names with LDAP will be recreated in SQream as roles without the ability to log in, without permissions, and without a default schema. .. contents:: In this topic: :local: @@ -44,7 +43,6 @@ Configuring SQream roles GRANT CONNECT ON DATABASE <my_database> TO <new_role>; -.. note:: If no role exists but LDAP authentication is successful, a role with no login or connection permissions will be added. Configuring LDAP Authentication @@ -81,13 +79,13 @@ Only roles with SQream ``SUPERUSER`` privileges or higher may enable LDAP Authen .. code-block:: postgres - ALTER SYSTEM SET ldapIpAddress = 'ldaps://<192.168.10.20>'; + ALTER SYSTEM SET ldapIpAddress = '<ldaps://192.168.10.20>'; 2. Set the ``ldapDomain`` attribute: .. code-block:: postgres - ALTER SYSTEM SET ldapDomain = <'@sqream.loc'>; + ALTER SYSTEM SET ldapDomain = '<@sqream.loc>'; 3. To set the ``ldapConnTimeoutSec`` attribute (Optional), run: From 72a733349e28a0f0f6b0117c555b0d306b4e760e Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 29 Dec 2022 15:56:22 +0200 Subject: [PATCH 360/882] Update 4.0.0_index.rst --- releases/4.0.0_index.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/releases/4.0.0_index.rst b/releases/4.0.0_index.rst index 6a81d2338..f846edb4f 100644 --- a/releases/4.0.0_index.rst +++ b/releases/4.0.0_index.rst @@ -3,13 +3,16 @@ ************************** Release Notes 4.0.0 ************************** + +**SQream is introducing a more commonly used versioning system, beginning with 4.0.0 as a minor version.** + The 4.0.0 release notes were released on xx/xx/20xx and describe the following: .. contents:: :local: :depth: 1 -SQream is introducing a more commonly used versioning system, beginning with 4.0.0 as a minor version. + New Features ---------- From eec82e0b16b21fedd7e961a30ada0209c8ad58db Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 29 Dec 2022 15:59:52 +0200 Subject: [PATCH 361/882] Update converting_and_casting_types.rst --- .../converting_and_casting_types.rst | 24 +++++++++++++++++-- 1 file changed, 22 insertions(+), 2 deletions(-) diff --git a/data_type_guides/converting_and_casting_types.rst b/data_type_guides/converting_and_casting_types.rst index 44579a068..940e21822 100644 --- a/data_type_guides/converting_and_casting_types.rst +++ b/data_type_guides/converting_and_casting_types.rst @@ -3,7 +3,7 @@ ************************* Converting and Casting Types ************************* -SQream supports explicit and implicit casting and type conversion. The system may automatically add implicit casts when combining different data types in the same expression. In many cases, while the details related to this are not important, they can affect the query results of a query. When necessary, an explicit cast can be used to override the automatic cast added by SQream DB. +SQream supports explicit and implicit casting and type conversion. The system may automatically add implicit casts when combining different data types in the same expression. In many cases, while the details related to this are not important, they can affect the results of a query. When necessary, an explicit cast can be used to override the automatic cast added by SQream DB. For example, the ANSI standard defines a ``SUM()`` aggregation over an ``INT`` column as an ``INT``. However, when dealing with large amounts of data this could cause an overflow. @@ -25,4 +25,24 @@ SQream supports the following three data conversion types: * See the :ref:`SQL functions reference <sql_functions>` for additional functions that convert from a specific value which is not an SQL type, such as :ref:`from_unixts`, etc. -.. note:: SQream interprets integer constants exceeding the maximum bigint value as float constants, which may cause precision loss. \ No newline at end of file + +Supported Casts +--------------- + ++----------------------------------------------+-----------+----------------------------------------------+-----------------+--------------+------------------------+-----------------------+ +| | **BOOL** | **TINYINT**/**SMALLINT**/**INT**/**BIGINT** | **REAL/FLOAT** | **NUMERIC** | **DATE**/**DATETIME** | **VARCHAR**/**TEXT** | ++==============================================+===========+==============================================+=================+==============+========================+=======================+ +| **BOOL** | N/A | ✓ | ✗ | ✗ | ✗ | ✓ | ++----------------------------------------------+-----------+----------------------------------------------+-----------------+--------------+------------------------+-----------------------+ +| **TINYINT**/**SMALLINT**/**INT**/**BIGINT** | ✓ | N/A | ✓ | ✓ | ✗ | ✓ | ++----------------------------------------------+-----------+----------------------------------------------+-----------------+--------------+------------------------+-----------------------+ +| **REAL/FLOAT** | ✗ | ✓ | N/A | ✓ | ✗ | ✓ | ++----------------------------------------------+-----------+----------------------------------------------+-----------------+--------------+------------------------+-----------------------+ +| **NUMERIC** | ✗ | ✓ | ✓ | N/A | ✗ | ✓ | ++----------------------------------------------+-----------+----------------------------------------------+-----------------+--------------+------------------------+-----------------------+ +| **DATE**/**DATETIME** | ✗ | ✗ | ✗ | ✗ | N/A | ✓ | ++----------------------------------------------+-----------+----------------------------------------------+-----------------+--------------+------------------------+-----------------------+ +| **VARCHAR**/**TEXT** | ✓ | ✓ | ✓ | ✓ | ✓ | N/A | ++----------------------------------------------+-----------+----------------------------------------------+-----------------+--------------+------------------------+-----------------------+ + + :check_mark: \ No newline at end of file From 710f6ee3e0b538628392bc8bf675995f12cbf94f Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 29 Dec 2022 16:25:30 +0200 Subject: [PATCH 362/882] Update ldap.rst --- configuration_guides/ldap.rst | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/configuration_guides/ldap.rst b/configuration_guides/ldap.rst index d3fa0ddcb..56332eea1 100644 --- a/configuration_guides/ldap.rst +++ b/configuration_guides/ldap.rst @@ -5,7 +5,7 @@ Configuring LDAP authentication ************************************* -Lightweight Directory Access Protocol (LDAP) is an authentication management service. Once it has been configured to authenticate SQream roles, all existing and newly added roles will be required to be authenticated by an LDAP server, with the exception of the initial system deployment ``sqream`` role, which is granted full control permissions upon deployment. +Lightweight Directory Access Protocol (LDAP) is an authentication management service widely use with Microsoft Active Directory. Once it has been configured to authenticate SQream roles, all existing and newly added roles will be required to be authenticated by an LDAP server, with the exception of the initial system deployment ``sqream`` role, which is granted full control permissions upon deployment. Prior to integrating SQream with LDAP, two preconditions must be considered: @@ -20,8 +20,6 @@ Prior to integrating SQream with LDAP, two preconditions must be considered: Configuring SQream roles ======================== - - **Procedure** 1. Create a new role: @@ -43,6 +41,7 @@ Configuring SQream roles GRANT CONNECT ON DATABASE <my_database> TO <new_role>; +You may also wish to :ref:`rename SQream roles<rename_role>`. Configuring LDAP Authentication @@ -71,7 +70,7 @@ To enable LDAP Authentication, configure the following **cluster** flag attribut Enabling LDAP Authentication ------------------------------- -Only roles with SQream ``SUPERUSER`` privileges or higher may enable LDAP Authentication. +Roles with admin privileges or higher may enable LDAP Authentication. **Procedure** From f79cc31425499c8e1e461d206438239c972cdbfc Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 29 Dec 2022 17:36:24 +0200 Subject: [PATCH 363/882] Update server_picker.rst --- reference/cli/server_picker.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/cli/server_picker.rst b/reference/cli/server_picker.rst index b4869c181..e64d792a0 100644 --- a/reference/cli/server_picker.rst +++ b/reference/cli/server_picker.rst @@ -1,7 +1,7 @@ .. _server_picker_cli_reference: ************************* -server_picker +Server Picker ************************* SQream DB's load balancer is called ``server_picker``. From 8d221468130d4c25b6f4b7b188a28b7bff888015 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 29 Dec 2022 17:46:09 +0200 Subject: [PATCH 364/882] cnt --- .../sql/sql_functions/scalar_functions/string/left.rst | 6 ++++-- .../sql/sql_functions/scalar_functions/string/right.rst | 3 ++- 2 files changed, 6 insertions(+), 3 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/string/left.rst b/reference/sql/sql_functions/scalar_functions/string/left.rst index 77c99b0f1..143c6eeb7 100644 --- a/reference/sql/sql_functions/scalar_functions/string/left.rst +++ b/reference/sql/sql_functions/scalar_functions/string/left.rst @@ -27,13 +27,15 @@ Arguments * - ``expr`` - String expression * - ``character_count`` - - A positive integer that specifies how many characters to return. - + - A positive integer that specifies how many characters to return + * - ``cnt`` + - The number of characters to be returned. If ``cnt <= 0``, an empty string is returned. Returns ============ Returns the same type as the argument supplied. + Notes ======= diff --git a/reference/sql/sql_functions/scalar_functions/string/right.rst b/reference/sql/sql_functions/scalar_functions/string/right.rst index 158de7da0..8cf750510 100644 --- a/reference/sql/sql_functions/scalar_functions/string/right.rst +++ b/reference/sql/sql_functions/scalar_functions/string/right.rst @@ -28,7 +28,8 @@ Arguments - String expression * - ``character_count`` - A positive integer that specifies how many characters to return. - + * - ``cnt`` + - The number of characters to be returned. If ``cnt <= 0``, an empty string is returned. Returns ============ From 727a8dca1ec272d0cdd142bd359199c638bf2e0b Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 1 Jan 2023 08:58:00 +0200 Subject: [PATCH 365/882] Update round.rst --- reference/sql/sql_functions/scalar_functions/numeric/round.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_functions/scalar_functions/numeric/round.rst b/reference/sql/sql_functions/scalar_functions/numeric/round.rst index 553344246..d362c9abd 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/round.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/round.rst @@ -32,7 +32,7 @@ Arguments Returns ============ -``ROUND``always returns a ``double`` floating point number. +``ROUND`` always returns a ``double`` floating point number. Notes ======= From db06670f9e12200ccbdd34978349152441c93b3a Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 1 Jan 2023 13:19:50 +0200 Subject: [PATCH 366/882] kafka --- .../client_drivers/dotnet/index.rst | 2 +- connecting_to_sqream/client_drivers/index.rst | 16 +- .../client_drivers/jdbc/index.rst | 2 +- .../client_drivers/kafka/index.rst | 192 ++++++++++++++++++ .../client_drivers/nodejs/index.rst | 2 +- .../client_drivers/odbc/index.rst | 2 +- .../client_drivers/python/index.rst | 2 +- .../client_platforms/power_bi.rst | 2 +- 8 files changed, 208 insertions(+), 12 deletions(-) create mode 100644 connecting_to_sqream/client_drivers/kafka/index.rst diff --git a/connecting_to_sqream/client_drivers/dotnet/index.rst b/connecting_to_sqream/client_drivers/dotnet/index.rst index 1d28069a7..ed0c61557 100644 --- a/connecting_to_sqream/client_drivers/dotnet/index.rst +++ b/connecting_to_sqream/client_drivers/dotnet/index.rst @@ -1,7 +1,7 @@ .. _net: ************************* -.NET +Connecting to SQream Using .NET ************************* The SqreamNet ADO.NET Data Provider lets you connect to SQream through your .NET environment. diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index 58791e766..ce6b1ef8d 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -18,22 +18,26 @@ The following are applicable to all operating systems: * **JDBC** - recommended installation via ``mvn``: * `JDBC .jar file <https://sq-ftp-public.s3.amazonaws.com/sqream-jdbc-4.5.6.jar>`_ - sqream-jdbc-4.5.3 (.jar) - * `JDBC driver <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/jdbc/index.html#>`_ + * :ref:`java_jdbc` .. _.net: * **.NET**: * `.NET .dll file <https://get.sqream-share.com/share/sIsu8fxv>`_ - * `.NET driver <https://docs.sqream.com/en/v2022.1.6/connecting_to_sqream/client_drivers/dotnet/index.html>`_ + * :ref:`net` +* **Kafka**: + + * `Kafka file <>`_ + * :ref:`kafka` .. _python: * **Python** - Recommended installation via ``pip``: * `Python .tar file <https://github.com/SQream/pysqream/releases/tag/v3.1.3>`_ - pysqream v3.1.3 (.tar.gz) - * `Python driver <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/python/index.html>`_ + * :ref:`pysqream` .. _nodejs: @@ -41,7 +45,7 @@ The following are applicable to all operating systems: * **Node.JS** - Recommended installation via ``npm``: * `Node.JS <https://sq-ftp-public.s3.amazonaws.com/sqream-sqreamdb-4.2.4.tgz>`_ - sqream-v4.2.4 (.tar.gz) - * `Node.JS driver <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/nodejs/index.html>`_ + * :ref:`nodejs` .. _tableau_connector: @@ -49,7 +53,7 @@ The following are applicable to all operating systems: * **Tableau**: * `Tableau connector <https://sq-ftp-public.s3.amazonaws.com/SQreamDB.taco>`_ - SQream (.taco) - * `Tableau manual installation <https://docs.sqream.com/en/v2021.1/third_party_tools/client_platforms/tableau.html#>`_ + * :ref:`tableau` .. _powerbi_connector: @@ -57,7 +61,7 @@ The following are applicable to all operating systems: * **Power BI**: * `Power BI PowerQuery connector <https://sq-ftp-public.s3.amazonaws.com/SqlODBC__v1.0.mez>`_ - SQream (.mez) - * `Power BI manual installation <https://docs.sqream.com/en/v2021.1/third_party_tools/client_platforms/power_bi.html>`_ + * :ref:`power_bi` Windows diff --git a/connecting_to_sqream/client_drivers/jdbc/index.rst b/connecting_to_sqream/client_drivers/jdbc/index.rst index 83bdc3801..438df0ad7 100644 --- a/connecting_to_sqream/client_drivers/jdbc/index.rst +++ b/connecting_to_sqream/client_drivers/jdbc/index.rst @@ -1,7 +1,7 @@ .. _java_jdbc: ************************* -JDBC +Connecting to SQream Using JDBC ************************* The SQream JDBC driver lets you connect to SQream using many Java applications and tools. This page describes how to write a Java application using the JDBC interface. The JDBC driver requires Java 1.8 or newer. diff --git a/connecting_to_sqream/client_drivers/kafka/index.rst b/connecting_to_sqream/client_drivers/kafka/index.rst new file mode 100644 index 000000000..5b762576d --- /dev/null +++ b/connecting_to_sqream/client_drivers/kafka/index.rst @@ -0,0 +1,192 @@ +.. _kafka: + +************************* +Connecting to SQream Using Kafka +************************* + +Intro to Kafka producer, consumer, and loader. +Data formats +Confluent GUI + + +The Kafka page includes the following sections: + +.. contents:: + :local: + :depth: 1 + +Getting Started +================================== +System requirements +------------------- +No system requirements + + +Download Kafka connector files +------------------------------ + + +Installation and configuration +============= + +Prerequisites +---------------- +Both Kafka consumer and SQream loader require JAVA 11. + + + +Kafka producer +============== + +Installing Kafka producer +--------------------------- +The Kafka producer is installed on the 192.168.0.125 server. + +Operating Kafka producer +-------------------------- + +For the producer to properly function, two processes must continuously be running: Kafka producer and Zookeeper. Note that Kafka producer will not run unless Zookeeper is already running. + +Running Zookeeper: + +.. code-block:: postgres + + cd /home/sqream/kafka_2.12-3.2.1/ + bin/zookeeper-server-start.sh -daemon config/zookeeper.properties + +Running Kafka producer: + +.. code-block:: postgres + + cd /home/sqream/kafka_2.12-3.2.1/ + bin/kafka-server-start.sh -daemon config/server.properties + +Creating a new topic: + +.. code-block:: postgres + + cd /home/sqream/kafka_2.12-3.2.1/ + bin/kafka-topics.sh --create --bootstrap-server localhost:2181 --replication-factor 1 --partitions 1 --topic <topic name> + +Reading data from a topic: + +.. code-block:: postgres + + cd /home/sqream/kafka_2.12-3.2.1/ + ./kafka-console-consumer.sh --topic <topic name> --from-beginning --bootstrap-server localhost:9092 + +Loading data from a file: + +.. code-block:: postgres + + cd /home/sqream/kafka_2.12-3.2.1/ + ./kafka-console-producer.sh --bootstrap-server localhost:9092 --topic <topic name> < <full path to file> + +To close Kafka producer, you must first stop the producer and only then stop Zookeeper. + +Closing Kafka producer: + +.. code-block:: postgres + + cd /home/sqream/kafka_2.12-3.2.1/ + bin/kafka-server-stop.sh + +Verifying that the producer is running +-------------------------------------- + + +Known Driver Limitations +---------------------------- + * Unicode characters are not supported when using ``INSERT INTO AS SELECT``. + + * To avoid possible casting issues, use ``getDouble`` when using ``FLOAT``. + +Connecting to SQream For the First Time +============================================== +An initial connection to SQream must be established by creating a **SqreamConnection** object using a connection string. + +.. contents:: + :local: + :depth: 1 + + +Connection String +-------------------- +To connect to SQream, instantiate a **SqreamConnection** object using this connection string. + +The following is the syntax for SQream: + +.. code-block:: text + + "Data Source=<hostname or ip>,<port>;User=<username>;Password=<password>;Initial Catalog=<database name>;Integrated Security=true"; + +Connection Parameters +^^^^^^^^^^^^^^^^^^^^^^^^ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Item + - State + - Default + - Description + * - ``<data source>`` + - Mandatory + - None + - Hostname/IP/FQDN and port of the SQream DB worker. For example, ``127.0.0.1:5000``, ``sqream.mynetwork.co:3108`` + * - ``<initial catalog>`` + - Mandatory + - None + - Database name to connect to. For example, ``master`` + * - ``<username>`` + - Mandatory + - None + - Username of a role to use for connection. For example, ``username=rhendricks`` + * - ``<password>`` + - Mandatory + - None + - Specifies the password of the selected role. For example, ``password=Tr0ub4dor&3`` + * - ``<service>`` + - Optional + - ``sqream`` + - Specifices service queue to use. For example, ``service=etl`` + * - ``<ssl>`` + - Optional + - ``false`` + - Specifies SSL for this connection. For example, ``ssl=true`` + * - ``<cluster>`` + - Optional + - ``true`` + - Connect via load balancer (use only if exists, and check port). + +Connection String Examples +^^^^^^^^^^^^^^^^^^^^^^^^^^^ +The following is an example of a SQream cluster with load balancer and no service queues (with SSL): + +.. code-block:: text + + Data Source=sqream.mynetwork.co,3108;User=rhendricks;Password=Tr0ub4dor&3;Initial Catalog=master;Integrated Security=true;ssl=true;cluster=true; + + +The following is a minimal example for a local standalone SQream database: + +.. code-block:: text + + + Data Source=127.0.0.1,5000;User=rhendricks;Password=Tr0ub4dor&3;Initial Catalog=master; + +The following is an example of a SQream cluster with load balancer and a specific service queue named ``etl``, to the database named ``raviga`` + +.. code-block:: text + + Data Source=sqream.mynetwork.co,3108;User=rhendricks;Password=Tr0ub4dor&3;Initial Catalog=raviga;Integrated Security=true;service=etl;cluster=true; + +Sample C# Program +-------------------- +You can download the :download:`.NET Application Sample File <sample.cs>` below by right-clicking and saving it to your computer. + +.. literalinclude:: sample.cs + :language: C# + :caption: .NET Application Sample + :linenos: diff --git a/connecting_to_sqream/client_drivers/nodejs/index.rst b/connecting_to_sqream/client_drivers/nodejs/index.rst index 8ddd0d0bc..94b84a072 100644 --- a/connecting_to_sqream/client_drivers/nodejs/index.rst +++ b/connecting_to_sqream/client_drivers/nodejs/index.rst @@ -1,7 +1,7 @@ .. _nodejs: ************************* -Node.JS +Connecting to SQream Using Node.JS ************************* The SQream DB Node.JS driver allows Javascript applications and tools connect to SQream DB. diff --git a/connecting_to_sqream/client_drivers/odbc/index.rst b/connecting_to_sqream/client_drivers/odbc/index.rst index 3ee093692..691e7e999 100644 --- a/connecting_to_sqream/client_drivers/odbc/index.rst +++ b/connecting_to_sqream/client_drivers/odbc/index.rst @@ -1,7 +1,7 @@ .. _odbc: ************************* -ODBC +Connecting to SQream Using ODBC ************************* .. toctree:: diff --git a/connecting_to_sqream/client_drivers/python/index.rst b/connecting_to_sqream/client_drivers/python/index.rst index 7f8baac93..3ad7b1594 100644 --- a/connecting_to_sqream/client_drivers/python/index.rst +++ b/connecting_to_sqream/client_drivers/python/index.rst @@ -1,7 +1,7 @@ .. _pysqream: ************************* -Python (pysqream) +Connecting to SQream Using Python (pysqream) ************************* The **Python** connector page describes the following: diff --git a/connecting_to_sqream/client_platforms/power_bi.rst b/connecting_to_sqream/client_platforms/power_bi.rst index 1cdf7c81b..b43adf578 100644 --- a/connecting_to_sqream/client_platforms/power_bi.rst +++ b/connecting_to_sqream/client_platforms/power_bi.rst @@ -1,7 +1,7 @@ .. _power_bi: ************************* -Connect to SQream Using Power BI Desktop +Connecting to SQream Using Power BI Desktop ************************* Overview From f9e65f1e4e0e6b4dea6a1c94cdc1afbb1747f183 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 1 Jan 2023 14:39:05 +0200 Subject: [PATCH 367/882] Update index.rst --- .../client_drivers/kafka/index.rst | 287 ++++++++++++------ 1 file changed, 194 insertions(+), 93 deletions(-) diff --git a/connecting_to_sqream/client_drivers/kafka/index.rst b/connecting_to_sqream/client_drivers/kafka/index.rst index 5b762576d..20d339746 100644 --- a/connecting_to_sqream/client_drivers/kafka/index.rst +++ b/connecting_to_sqream/client_drivers/kafka/index.rst @@ -16,17 +16,22 @@ The Kafka page includes the following sections: :depth: 1 Getting Started -================================== -System requirements +=============== + +.. contents:: + :local: + :depth: 1 + +System Requirements ------------------- No system requirements -Download Kafka connector files +Download Kafka Connector Files ------------------------------ -Installation and configuration +Installation and Configuration ============= Prerequisites @@ -35,14 +40,18 @@ Both Kafka consumer and SQream loader require JAVA 11. -Kafka producer +Kafka Producer ============== -Installing Kafka producer +.. contents:: + :local: + :depth: 1 + +Installing Kafka Producer --------------------------- The Kafka producer is installed on the 192.168.0.125 server. -Operating Kafka producer +Operating Kafka Producer -------------------------- For the producer to properly function, two processes must continuously be running: Kafka producer and Zookeeper. Note that Kafka producer will not run unless Zookeeper is already running. @@ -91,102 +100,194 @@ Closing Kafka producer: cd /home/sqream/kafka_2.12-3.2.1/ bin/kafka-server-stop.sh -Verifying that the producer is running +Verifying that the Producer is Running -------------------------------------- +To verify that both Kafka and Zookeeper are running, log in to your machine using SQream credentials: + + * User: sqream + * Password: sqream11 + + And run the following string: + + .. code-block:: postgres + + [sqream@metadata-0-125 ~]$ ps -ef |grep java + +Example of an output indicating that both processes are running: + .. code-block:: postgres + + sqream 63082 1 0 Sep11 ? 00:03:50 /usr/lib/jvm/jre-1.8.0-openjdk/bin/java -Xmx512M -Xms512M -server -XX:+UseG1GC -XX:MaxGCPauseMillis=20 -XX:InitiatingHeapOccupancyPercent=35 -XX:+ExplicitGCInvokesConcurrent -XX:MaxInlineLevel=15 -Djava.awt.headless=true -Xloggc:/home/sqream/kafka_2.12-3.2.1/bin/../logs/zookeeper-gc.log -verbose:gc -XX:+PrintGCDetails -XX:+PrintGCDateStamps -XX:+PrintGCTimeStamps -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=10 -XX:GCLogFileSize=100M -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -Dkafka.logs.dir=/home/sqream/kafka_2.12-3.2.1/bin/../logs -Dlog4j.configuration=file:bin/../config/log4j.properties -cp /home/sqream/kafka_2.12-3.2.1/bin/../libs/activation-1.1.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/aopalliance-repackaged-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/argparse4j-0.7.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/audience-annotations-0.5.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/commons-cli-1.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/commons-lang3-3.8.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-api-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-basic-auth-extension-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-json-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-mirror-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-mirror-client-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-runtime-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-transforms-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-api-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-locator-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-utils-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-annotations-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-core-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-databind-2.12.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-dataformat-csv-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-datatype-jdk8-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-jaxrs-base-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-jaxrs-json-provider-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-module-jaxb-annotations-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-module-scala_2.12-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.activation-api-1.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.annotation-api-1.3.5.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.inject-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.validation-api-2.0.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.ws.rs-api-2.1.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.xml.bind-api-2.3.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javassist-3.27.0-GA.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javax.servlet-api-3.1.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javax.ws.rs-api-2.1.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jaxb-api-2.3.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-client-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-common-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-container-servlet-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-container-servlet-core-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-hk2-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-server-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-client-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-continuation-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-http-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-io-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-security-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-server-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-servlet-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-servlets-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-util-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-util-ajax-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jline-3.21.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jopt-simple-5.0.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jose4j-0.7.9.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka_2.12-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-clients-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-log4j-appender-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-metadata-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-raft-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-server-common-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-shell-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-storage-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-storage-api-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-examples-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-scala_2.12-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-test-utils-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-tools-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/lz4-java-1.8.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/maven-artifact-3.8.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/metrics-core-2.2.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/metrics-core-4.1.12.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-buffer-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-codec-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-common-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-handler-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-resolver-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-tcnative-classes-2.0.46.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-classes-epoll-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-native-epoll-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-native-unix-common-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/osgi-resource-locator-1.0.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/paranamer-2.8.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/plexus-utils-3.3.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/reflections-0.9.12.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/reload4j-1.2.19.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/rocksdbjni-6.29.4.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-collection-compat_2.12-2.6.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-java8-compat_2.12-1.0.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-library-2.12.15.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-logging_2.12-3.9.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-reflect-2.12.15.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/slf4j-api-1.7.36.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/slf4j-reload4j-1.7.36.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/snappy-java-1.1.8.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/trogdor-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zookeeper-3.6.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zookeeper-jute-3.6.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zstd-jni-1.5.2-1.jar org.apache.zookeeper.server.quorum.QuorumPeerMain config/zookeeper.properties + sqream 63614 1 0 Sep11 ? 00:19:22 /usr/lib/jvm/jre-1.8.0-openjdk/bin/java -Xmx1G -Xms1G -server -XX:+UseG1GC -XX:MaxGCPauseMillis=20 -XX:InitiatingHeapOccupancyPercent=35 -XX:+ExplicitGCInvokesConcurrent -XX:MaxInlineLevel=15 -Djava.awt.headless=true -Xloggc:/home/sqream/kafka_2.12-3.2.1/bin/../logs/kafkaServer-gc.log -verbose:gc -XX:+PrintGCDetails -XX:+PrintGCDateStamps -XX:+PrintGCTimeStamps -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=10 -XX:GCLogFileSize=100M -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -Dkafka.logs.dir=/home/sqream/kafka_2.12-3.2.1/bin/../logs -Dlog4j.configuration=file:bin/../config/log4j.properties -cp /home/sqream/kafka_2.12-3.2.1/bin/../libs/activation-1.1.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/aopalliance-repackaged-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/argparse4j-0.7.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/audience-annotations-0.5.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/commons-cli-1.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/commons-lang3-3.8.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-api-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-basic-auth-extension-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-json-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-mirror-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-mirror-client-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-runtime-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-transforms-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-api-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-locator-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-utils-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-annotations-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-core-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-databind-2.12.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-dataformat-csv-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-datatype-jdk8-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-jaxrs-base-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-jaxrs-json-provider-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-module-jaxb-annotations-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-module-scala_2.12-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.activation-api-1.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.annotation-api-1.3.5.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.inject-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.validation-api-2.0.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.ws.rs-api-2.1.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.xml.bind-api-2.3.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javassist-3.27.0-GA.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javax.servlet-api-3.1.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javax.ws.rs-api-2.1.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jaxb-api-2.3.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-client-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-common-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-container-servlet-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-container-servlet-core-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-hk2-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-server-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-client-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-continuation-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-http-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-io-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-security-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-server-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-servlet-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-servlets-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-util-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-util-ajax-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jline-3.21.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jopt-simple-5.0.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jose4j-0.7.9.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka_2.12-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-clients-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-log4j-appender-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-metadata-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-raft-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-server-common-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-shell-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-storage-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-storage-api-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-examples-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-scala_2.12-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-test-utils-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-tools-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/lz4-java-1.8.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/maven-artifact-3.8.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/metrics-core-2.2.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/metrics-core-4.1.12.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-buffer-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-codec-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-common-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-handler-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-resolver-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-tcnative-classes-2.0.46.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-classes-epoll-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-native-epoll-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-native-unix-common-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/osgi-resource-locator-1.0.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/paranamer-2.8.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/plexus-utils-3.3.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/reflections-0.9.12.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/reload4j-1.2.19.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/rocksdbjni-6.29.4.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-collection-compat_2.12-2.6.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-java8-compat_2.12-1.0.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-library-2.12.15.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-logging_2.12-3.9.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-reflect-2.12.15.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/slf4j-api-1.7.36.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/slf4j-reload4j-1.7.36.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/snappy-java-1.1.8.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/trogdor-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zookeeper-3.6.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zookeeper-jute-3.6.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zstd-jni-1.5.2-1.jar kafka.Kafka config/server.properties -Known Driver Limitations ----------------------------- - * Unicode characters are not supported when using ``INSERT INTO AS SELECT``. - - * To avoid possible casting issues, use ``getDouble`` when using ``FLOAT``. - -Connecting to SQream For the First Time -============================================== -An initial connection to SQream must be established by creating a **SqreamConnection** object using a connection string. +Kafka Consumer +=============== .. contents:: :local: :depth: 1 - -Connection String --------------------- -To connect to SQream, instantiate a **SqreamConnection** object using this connection string. +The Kafka consumer converts data formatted as CSV and JSON into .tmp files and saves it in the predefined directory. +You must define the number of files to be converted before they are saved as a sqream.batchRecordCount file. Once reaching the defined number of files, the consumer saves the converted files and begins the process all over again. + +Installing Kafka Consumer +-------------------------- -The following is the syntax for SQream: +The Kafka consumer version is located under /home/sqream/kafkaconnect1, machine IP 192.168.0.102 +Credentials: +user = sqream +pass = sqprj2021$ -.. code-block:: text +Configuring Kafka Consumer +--------------------------- - "Data Source=<hostname or ip>,<port>;User=<username>;Password=<password>;Initial Catalog=<database name>;Integrated Security=true"; +Connection string: -Connection Parameters -^^^^^^^^^^^^^^^^^^^^^^^^ + .. code-block:: postgres + + vi /home/sqream/kafkaconnect1/sqream-kafka-connector/sqream-kafkaconnect/config/sqream-filesink.properties + +Configuration file structure: -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Item - - State - - Default - - Description - * - ``<data source>`` - - Mandatory - - None - - Hostname/IP/FQDN and port of the SQream DB worker. For example, ``127.0.0.1:5000``, ``sqream.mynetwork.co:3108`` - * - ``<initial catalog>`` - - Mandatory - - None - - Database name to connect to. For example, ``master`` - * - ``<username>`` - - Mandatory - - None - - Username of a role to use for connection. For example, ``username=rhendricks`` - * - ``<password>`` - - Mandatory - - None - - Specifies the password of the selected role. For example, ``password=Tr0ub4dor&3`` - * - ``<service>`` - - Optional - - ``sqream`` - - Specifices service queue to use. For example, ``service=etl`` - * - ``<ssl>`` - - Optional - - ``false`` - - Specifies SSL for this connection. For example, ``ssl=true`` - * - ``<cluster>`` - - Optional - - ``true`` - - Connect via load balancer (use only if exists, and check port). - -Connection String Examples -^^^^^^^^^^^^^^^^^^^^^^^^^^^ -The following is an example of a SQream cluster with load balancer and no service queues (with SSL): - -.. code-block:: text - - Data Source=sqream.mynetwork.co,3108;User=rhendricks;Password=Tr0ub4dor&3;Initial Catalog=master;Integrated Security=true;ssl=true;cluster=true; - - -The following is a minimal example for a local standalone SQream database: - -.. code-block:: text - - - Data Source=127.0.0.1,5000;User=rhendricks;Password=Tr0ub4dor&3;Initial Catalog=master; - -The following is an example of a SQream cluster with load balancer and a specific service queue named ``etl``, to the database named ``raviga`` - -.. code-block:: text - - Data Source=sqream.mynetwork.co,3108;User=rhendricks;Password=Tr0ub4dor&3;Initial Catalog=raviga;Integrated Security=true;service=etl;cluster=true; - -Sample C# Program --------------------- -You can download the :download:`.NET Application Sample File <sample.cs>` below by right-clicking and saving it to your computer. - -.. literalinclude:: sample.cs - :language: C# - :caption: .NET Application Sample - :linenos: + .. code-block:: postgres + + name=SQReamFileSink + topics=topsqreamtest1 + tasks.max=4 + connector.class=tr.com.entegral.FileSinkConnector + errors.tolerance=all + errors.log.enable=true + errors.log.include.messages=true + value.converter=org.apache.kafka.connect.json.JsonConverter + value.converter.schemas.enable=false + transforms=flatten + transforms.flatten.type=org.apache.kafka.connect.transforms.Flatten$Value + transforms.flatten.delimiter=. + sqream.outputdir=/home/sqream/kafkaconnect/outputs + sqream.batchRecordCount =10 + sqream.fileExtension=csv + sqream.removeNewline =false + sqream.outputType=csv + sqream.csvOrder=receivedTime,equipmentId,asdf,timestamp,intv + + +What needs to be configured: + +topics + +sqream.batchrecordcount – best to configure according to an estimated number of messages. + +outputdir – address requirement to copy and save for later. + +csvorder – Create table columns. + +Running commands: + + .. code-block:: postgres + + export JAVA_HOME=/home/sqream/copy-from-util/jdk-11;export CLASSPATH=.:$JAVA_HOME/jre/lib:$JAVA_HOME/lib:$JAVA_HOME/lib/tools.jar;cd /home/sqream/kafkaconnect1/kafka/bin/ && ./connect-standalone.sh /home/sqream/kafkaconnect1/sqream-kafka-connector/sqream-kafkaconnect/config/connect-standalone.properties /home/sqream/kafkaconnect1/sqream-kafka-connector/sqream-kafkaconnect/config/sqream-filesink.properties & + +In SQream, create a table according to the columns defined using csvorder. + + .. code-block:: postgres + + Note – Copy the sqream.outputdir path, from its beginning and until ``outputs``, included, and save it to a known location. It is required to configure SQream loader to use this section of the path. + +SQream Loader +============== + + + +Installing SQream loader +Sqream loader credentials: +ip machine: 192.168.0.102 +user = sqream +pass = sqprj2021$ + +Configuring SQream Loader +---------------------------- + +Building SQream loader: + + .. code-block:: postgres + + git clone -b develop http://gitlab.sq.l/java/copy-from-util.git + mvn clean package + + +Running SQream loader: + + .. code-block:: postgres + + git clone -b develop http://gitlab.sq.l/java/copy-from-util.git + mvn clean package + + + + +Configuration file structure: + + + .. code-block:: postgres + + + #config.yaml + + com: + sqream: + kafka: + common: + root: "/home/sqream/copy_from_root" + readyFileSuffix: ".csv" + connection: + ip: "127.0.0.1" + port: 3108 + database: "master" + cluster: true + user: sqream + pass: sqream + delimiter: "," + tables: + - schema: "public" + name: "t1" + parallel: 5 + - schema: "public" + name: "t2" + parallel: 3 + - schema: "public" + name: "t3" + parallel: 1 + + +What needs to be configured: +root – paste copied path to root +schema +name +Running commands: + + .. code-block:: postgres + + /home/sqream/copy-from-util/jdk-11/bin/java -jar /home/sqream/copy-from-util/copy-from-util/target/copy-from-util-0.0.1-SNAPSHOT.jar --spring.config.additional-location=/home/sqream/copy-from-util/config.yaml & + +Logging and Monitoring +======================== + +The following log files are created: + * JAVA application fails (consumer or loader?) + * Files cannot be saved to folder due to +Either + * Folder permission issue +Or + * SQream loader folder is not the same as Kenan folder +Purging +======= +Ingested files are automatically zipped and archived for 60 days. + +Limitations +=========== + +Latency +Retention + +Example +========= From d1546388788281fce06c1fa0cb85073586c55556 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 1 Jan 2023 15:29:10 +0200 Subject: [PATCH 368/882] update --- operational_guides/access_control_managing_roles.rst | 2 +- operational_guides/access_control_permissions.rst | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/operational_guides/access_control_managing_roles.rst b/operational_guides/access_control_managing_roles.rst index 373b9a212..15729fa53 100644 --- a/operational_guides/access_control_managing_roles.rst +++ b/operational_guides/access_control_managing_roles.rst @@ -80,7 +80,7 @@ Altering Public Role Permissions There is a public role which always exists. Each role is granted to the ``PUBLIC`` role (i.e. is a member of the public group), and this cannot be revoked. You can alter the permissions granted to the public role. -The ``PUBLIC`` role has ``USAGE`` and ``CREATE`` permissions on ``PUBLIC`` schema by default, therefore, new users can create, :ref:`insert`, :ref:`delete`, and :ref:`select` from objects in the ``PUBLIC`` schema. +The ``PUBLIC`` role has ``USAGE`` and ``CREATE`` permissions on ``PUBLIC`` schema by default, therefore, new users can ``CREATE``, :ref:`insert`, :ref:`delete`, :ref:`select` and :ref:`UPDATE` from objects in the ``PUBLIC`` schema. Altering Role Membership (Groups) diff --git a/operational_guides/access_control_permissions.rst b/operational_guides/access_control_permissions.rst index 25ff6ba14..2d8b9bf0e 100644 --- a/operational_guides/access_control_permissions.rst +++ b/operational_guides/access_control_permissions.rst @@ -39,7 +39,7 @@ The following table displays the access control permissions: +--------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``INSERT`` | :ref:`insert` into the table | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``UPDATE`` | UPDATE the value of certain columns in existing rows without creating a table | +| ``UPDATE`` | :ref:`update` the value of certain columns in existing rows | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``DELETE`` | :ref:`delete` and :ref:`truncate` on the table | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ @@ -213,7 +213,7 @@ schema statement is run. | INSERT | DELETE | DDL - | UPDATE + | UPDATE | EXECUTE | ALL } \ No newline at end of file From 78d5f40d5c01e124ee25cb62e8f0825a6c426cf4 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 1 Jan 2023 16:32:11 +0200 Subject: [PATCH 369/882] copy to / --- connecting_to_sqream/client_drivers/python/index.rst | 2 +- reference/sql/sql_statements/dml_commands/copy_to.rst | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/connecting_to_sqream/client_drivers/python/index.rst b/connecting_to_sqream/client_drivers/python/index.rst index 3ad7b1594..e3e53c8b3 100644 --- a/connecting_to_sqream/client_drivers/python/index.rst +++ b/connecting_to_sqream/client_drivers/python/index.rst @@ -165,7 +165,7 @@ The following is a standard connection example: res = engine.execute('select * from test') Pulling a Table into Pandas ---------------------------------- +--------------------------- The following example shows how to pull a table in Pandas. This examples uses the URL method to create the connection string: .. code-block:: python diff --git a/reference/sql/sql_statements/dml_commands/copy_to.rst b/reference/sql/sql_statements/dml_commands/copy_to.rst index 783f9a4f9..fcdb96a9f 100644 --- a/reference/sql/sql_statements/dml_commands/copy_to.rst +++ b/reference/sql/sql_statements/dml_commands/copy_to.rst @@ -90,7 +90,7 @@ The following table shows the ``COPY_TO`` elements: * - ``HEADER`` - The CSV file will contain a header line with the names of each column in the file. This option is allowed only when using CSV format. * - ``DELIMITER`` - - Specifies the character that separates fields (columns) within each row of the file. The default is a comma character (``,``). + - Specifies the character or string that separates fields (columns) within each row of the file. The default is a comma character (``,``). * - ``AWS_ID``, ``AWS_SECRET`` - Specifies the authentication details for secured S3 buckets * - ``MAX_FILE_SIZE`` @@ -269,8 +269,6 @@ The following table shows the unsupported ASCII field delimiters: +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ | 34 | " | Double Quote | 42 | 22 | 100010 | &#34; | &quot; | +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 39 | ' | Single Quote | 47 | 27 | 100111 | &#39; | &apos; | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ | 45 | - | Minus Sign | 55 | 2D | 101101 | &#45; | &minus; | +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ | 46 | . | Period | 56 | 2E | 101110 | &#46; | &period; | @@ -349,6 +347,8 @@ The following table shows the unsupported ASCII field delimiters: +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ | 90 | Z | Upper Case Letter Z | 132 | 5A | 1011010 | &#90; | | +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 92 | \\ | Backslash | 134 | 5C | 01011100 | | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ | 97 | a | Lower Case Letter a | 141 | 61 | 1100001 | &#97; | | +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ | 98 | b | Lower Case Letter b | 142 | 62 | 1100010 | &#98; | | From eb2c1add971f80e6b7bb9ed1e39fcd20f7c85d25 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 1 Jan 2023 17:07:16 +0200 Subject: [PATCH 370/882] Update copy_to.rst --- reference/sql/sql_statements/dml_commands/copy_to.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/copy_to.rst b/reference/sql/sql_statements/dml_commands/copy_to.rst index fcdb96a9f..01c0006a5 100644 --- a/reference/sql/sql_statements/dml_commands/copy_to.rst +++ b/reference/sql/sql_statements/dml_commands/copy_to.rst @@ -347,7 +347,7 @@ The following table shows the unsupported ASCII field delimiters: +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ | 90 | Z | Upper Case Letter Z | 132 | 5A | 1011010 | &#90; | | +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 92 | \\ | Backslash | 134 | 5C | 01011100 | | | +| 92 | \\ | Backslash | 134 | 5C | 01011100 | \&\#92\; | | +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ | 97 | a | Lower Case Letter a | 141 | 61 | 1100001 | &#97; | | +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ @@ -379,7 +379,7 @@ The following table shows the unsupported ASCII field delimiters: +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ | 111 | o | Lower Case Letter o | 157 | 6F | 1101111 | &#111; | | +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 112 | p | Lower Case Letter p | 160 | 70 | 1110000 | p | | +| 112 | p | Lower Case Letter p | 160 | 70 | 1110000 | &#112; | | +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ | 113 | q | Lower Case Letter q | 161 | 71 | 1110001 | &#113; | | +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ From 9d69eacb32acafe984e48b15b5548cbd84fba293 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 1 Jan 2023 17:17:35 +0200 Subject: [PATCH 371/882] SQLAlchemy --- .../client_drivers/python/index.rst | 56 ++++++++++++++----- .../sql_statements/dml_commands/copy_to.rst | 2 +- 2 files changed, 43 insertions(+), 15 deletions(-) diff --git a/connecting_to_sqream/client_drivers/python/index.rst b/connecting_to_sqream/client_drivers/python/index.rst index e3e53c8b3..5d09c785c 100644 --- a/connecting_to_sqream/client_drivers/python/index.rst +++ b/connecting_to_sqream/client_drivers/python/index.rst @@ -143,26 +143,54 @@ This section includes the following examples: Standard Connection Example --------------------------------- -The following is a standard connection example: + .. code-block:: python - import sqlalchemy as sa - from sqlalchemy.engine.url import URL + import sqlalchemy as sa + from sqlalchemy.engine.url import URL - engine_url = URL('sqream' - , username='rhendricks' - , password='secret_passwor" - , host='localhost' - , port=5000 - , database='raviga' - , query={'use_ssl': False}) + engine_url = URL('sqream' + , username='rhendricks' + , password='secret_passwor" + , host='localhost' + , port=5000 + , database='raviga' + , query={'use_ssl': False}) - engine = sa.create_engine(engine_url) + engine = sa.create_engine(engine_url) + + res = engine.execute('create or replace table test (ints int, ints2 int)') + res = engine.execute('insert into test (ints,ints2) values (5,1), (6,2)') + res = engine.execute('select * from test') + for item in res: + print(item) + +Multi Cluster Connection Example +------------------------ + +The following example is for using a ServerPicker: + +.. code-block:: python + + import sqlalchemy as sa + from sqlalchemy.engine.url import URL + + engine_url = URL('sqream' + , username='rhendricks' + , password='secret_passwor" + , host='localhost' + , port=3108 + , database='raviga' + , query={'use_ssl': False}) + + engine = sa.create_engine(engine_url , connect_args={"clustered": True}) - res = engine.execute('create table test (ints int)') - res = engine.execute('insert into test values (5), (6)') - res = engine.execute('select * from test') + res = engine.execute('create or replace table test (ints int, ints2 int)') + res = engine.execute('insert into test (ints,ints2) values (5,1), (6,2)') + res = engine.execute('select * from test') + for item in res: + print(item) Pulling a Table into Pandas --------------------------- diff --git a/reference/sql/sql_statements/dml_commands/copy_to.rst b/reference/sql/sql_statements/dml_commands/copy_to.rst index 01c0006a5..3708d85ae 100644 --- a/reference/sql/sql_statements/dml_commands/copy_to.rst +++ b/reference/sql/sql_statements/dml_commands/copy_to.rst @@ -161,7 +161,7 @@ The following table shows the supported printable ASCII characters: +---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ | [ | Left Square Bracket | 91 | 133 | 5B | 1011011 | &#91; | &lsqb; | +---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ -| \ | Backslash | 92 | 134 | 5C | 1011100 | &#92; | &bsol; | +| \ | Backslash | 92 | 134 | 5C | 1011100 | \&\#92\; | &bsol; | +---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ | ] | Right Square Bracket | 93 | 135 | 5D | 1011101 | &#93; | &rsqb; | +---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ From 662a82cc5cc61a215e92cd33df3368ecb9326a37 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 1 Jan 2023 17:24:08 +0200 Subject: [PATCH 372/882] python --- connecting_to_sqream/client_drivers/index.rst | 16 ++++++---------- 1 file changed, 6 insertions(+), 10 deletions(-) diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index ce6b1ef8d..58791e766 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -18,26 +18,22 @@ The following are applicable to all operating systems: * **JDBC** - recommended installation via ``mvn``: * `JDBC .jar file <https://sq-ftp-public.s3.amazonaws.com/sqream-jdbc-4.5.6.jar>`_ - sqream-jdbc-4.5.3 (.jar) - * :ref:`java_jdbc` + * `JDBC driver <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/jdbc/index.html#>`_ .. _.net: * **.NET**: * `.NET .dll file <https://get.sqream-share.com/share/sIsu8fxv>`_ - * :ref:`net` + * `.NET driver <https://docs.sqream.com/en/v2022.1.6/connecting_to_sqream/client_drivers/dotnet/index.html>`_ -* **Kafka**: - - * `Kafka file <>`_ - * :ref:`kafka` .. _python: * **Python** - Recommended installation via ``pip``: * `Python .tar file <https://github.com/SQream/pysqream/releases/tag/v3.1.3>`_ - pysqream v3.1.3 (.tar.gz) - * :ref:`pysqream` + * `Python driver <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/python/index.html>`_ .. _nodejs: @@ -45,7 +41,7 @@ The following are applicable to all operating systems: * **Node.JS** - Recommended installation via ``npm``: * `Node.JS <https://sq-ftp-public.s3.amazonaws.com/sqream-sqreamdb-4.2.4.tgz>`_ - sqream-v4.2.4 (.tar.gz) - * :ref:`nodejs` + * `Node.JS driver <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/nodejs/index.html>`_ .. _tableau_connector: @@ -53,7 +49,7 @@ The following are applicable to all operating systems: * **Tableau**: * `Tableau connector <https://sq-ftp-public.s3.amazonaws.com/SQreamDB.taco>`_ - SQream (.taco) - * :ref:`tableau` + * `Tableau manual installation <https://docs.sqream.com/en/v2021.1/third_party_tools/client_platforms/tableau.html#>`_ .. _powerbi_connector: @@ -61,7 +57,7 @@ The following are applicable to all operating systems: * **Power BI**: * `Power BI PowerQuery connector <https://sq-ftp-public.s3.amazonaws.com/SqlODBC__v1.0.mez>`_ - SQream (.mez) - * :ref:`power_bi` + * `Power BI manual installation <https://docs.sqream.com/en/v2021.1/third_party_tools/client_platforms/power_bi.html>`_ Windows From afb27d69a3e0467c2ec347ca258f7b72c16f7d1b Mon Sep 17 00:00:00 2001 From: TaliaSQream <taliar@sqreamtech.com> Date: Mon, 2 Jan 2023 13:20:19 +0200 Subject: [PATCH 373/882] Update trino.rst --- .../client_platforms/trino.rst | 23 ++++++++++--------- 1 file changed, 12 insertions(+), 11 deletions(-) diff --git a/connecting_to_sqream/client_platforms/trino.rst b/connecting_to_sqream/client_platforms/trino.rst index b0e21f954..7e63bc68b 100644 --- a/connecting_to_sqream/client_platforms/trino.rst +++ b/connecting_to_sqream/client_platforms/trino.rst @@ -4,9 +4,8 @@ Connecting to SQream Using Trino ************************* -Overview -===================== -The JDBC based SQream Trino plugin supports large volumes of data storage and fast querying. + +If you are using Trino for distributed SQL query processing and wish to use it to connect to a SQream, follow these instructions. .. contents:: @@ -31,6 +30,11 @@ Installation :local: :depth: 1 +JDBC +~~~~ + +In case JDBC is not yet configured, follow the `JDBC Client Drivers page <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/jdbc/index.html>`_ for registration and configuration guidance. + SQream Trino Plugin ~~~~~~~~~~~~~~~~~~~ @@ -52,15 +56,12 @@ The SQream Trino plugin must be installed on each cluster node dedicated to Trin ├── trino-sqream-SNAPSHOT.jar └── all dependencies -JDBC -~~~~ -In case JDBC is not yet deployed, follow the `JDBC Client Drivers page <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/jdbc/index.html>`_ for registration and configuration guidance. Connecting to SQream -------------------- -Trino uses catalogs for referencing stored objects such as tables, databases, and functions. Each Trino catalog may be configured with access to a single SQream database. If you wish for Trino to have access to more than one SQream database or server, you must create additional catalogs. +Trino uses catalogs for referencing stored objects such as tables, databases, and functions. Each Trino catalog may be configured with access to a single SQream database. If you wish Trino to have access to more than one SQream database or server, you must create additional catalogs. Catalogs may be created using ``properties`` files. Start by creating a ``sqream.properties`` file and placing it under ``trino-server/etc/catalog``. @@ -137,7 +138,7 @@ Limitations SQream does not support the following SQL statements: -``GRANT`` -``REVOKE`` -``SHOW GRANTSHOW ROLES`` -``SHOW ROLE GRANTS`` \ No newline at end of file +* ``GRANT`` +* ``REVOKE`` +* ``SHOW GRANTSHOW ROLES`` +* ``SHOW ROLE GRANTS`` \ No newline at end of file From 1ff73b9f48d8e8deee9d69c4e877720c9b4320bf Mon Sep 17 00:00:00 2001 From: TaliaSQream <taliar@sqreamtech.com> Date: Mon, 2 Jan 2023 13:24:58 +0200 Subject: [PATCH 374/882] Update trino.rst --- connecting_to_sqream/client_platforms/trino.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/connecting_to_sqream/client_platforms/trino.rst b/connecting_to_sqream/client_platforms/trino.rst index 7e63bc68b..be1e7e9b7 100644 --- a/connecting_to_sqream/client_platforms/trino.rst +++ b/connecting_to_sqream/client_platforms/trino.rst @@ -136,7 +136,7 @@ Use the appropriate Trino data type for executing queries. Upon execution, incom Limitations ----------- -SQream does not support the following SQL statements: +The SQream Trino plugin does not support the following SQL statements: * ``GRANT`` * ``REVOKE`` From 50583d64980f8c396c80cec156c8d297de839527 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 3 Jan 2023 10:42:09 +0200 Subject: [PATCH 375/882] Update 4.0.0_index.rst --- releases/4.0.0_index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/4.0.0_index.rst b/releases/4.0.0_index.rst index f846edb4f..f2b96c4d5 100644 --- a/releases/4.0.0_index.rst +++ b/releases/4.0.0_index.rst @@ -4,7 +4,7 @@ Release Notes 4.0.0 ************************** -**SQream is introducing a more commonly used versioning system, beginning with 4.0.0 as a minor version.** +**SQream is introducing a new version release system that follows the more commonly used Major.Minor.Patch versioning schema. No considerable preparations are required upon the 4.0.0 version release, as it is a minor version upgrade.** The 4.0.0 release notes were released on xx/xx/20xx and describe the following: From bf57e3389c9adcf0255c6cc270c3027096c46c8a Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 3 Jan 2023 11:05:10 +0200 Subject: [PATCH 376/882] sqlalchemy --- .../client_drivers/python/index.rst | 23 +++++++++++-------- releases/4.0.0_index.rst | 2 +- 2 files changed, 14 insertions(+), 11 deletions(-) diff --git a/connecting_to_sqream/client_drivers/python/index.rst b/connecting_to_sqream/client_drivers/python/index.rst index 5d09c785c..1b5a7ccd4 100644 --- a/connecting_to_sqream/client_drivers/python/index.rst +++ b/connecting_to_sqream/client_drivers/python/index.rst @@ -173,24 +173,26 @@ The following example is for using a ServerPicker: .. code-block:: python - import sqlalchemy as sa + import sqlalchemy as sa + import pandas as pd from sqlalchemy.engine.url import URL + engine_url = URL('sqream' - , username='rhendricks' - , password='secret_passwor" + , username='dor' + , password='DorBerg123$' , host='localhost' , port=3108 - , database='raviga' - , query={'use_ssl': False}) + , database='pushlive') - engine = sa.create_engine(engine_url , connect_args={"clustered": True}) + engine = sa.create_engine(engine_url,connect_args={"clustered": True}) - res = engine.execute('create or replace table test (ints int, ints2 int)') - res = engine.execute('insert into test (ints,ints2) values (5,1), (6,2)') - res = engine.execute('select * from test') + res = engine.execute("create or replace table test100 (dor int);") + res = engine.execute('insert into test100 values (5), (6);') + res = engine.execute('select * from test100') for item in res: - print(item) + print(item) + Pulling a Table into Pandas --------------------------- @@ -337,6 +339,7 @@ This example shows how to load 10,000 rows of dummy data to an instance of SQrea , username='rhendricks', password='Tr0ub4dor&3' , clustered=True) , cur = con.cursor() + 2. Create a table for loading: .. code-block:: python diff --git a/releases/4.0.0_index.rst b/releases/4.0.0_index.rst index f2b96c4d5..8458ba8b7 100644 --- a/releases/4.0.0_index.rst +++ b/releases/4.0.0_index.rst @@ -4,7 +4,7 @@ Release Notes 4.0.0 ************************** -**SQream is introducing a new version release system that follows the more commonly used Major.Minor.Patch versioning schema. No considerable preparations are required upon the 4.0.0 version release, as it is a minor version upgrade.** +**SQream is introducing a new version release system that follows the more commonly used Major.Minor.Patch versioning schema. The newly released 4.0.0 version is a minor version upgrade and does not require considerable preparation.** The 4.0.0 release notes were released on xx/xx/20xx and describe the following: From 0972b4e6e9aad7734e6f4f23d2dddeeb82bfba58 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 3 Jan 2023 14:49:35 +0200 Subject: [PATCH 377/882] Kafka --- connecting_to_sqream/client_drivers/index.rst | 24 ++- .../client_drivers/kafka/index.rst | 190 ++++++++++-------- 2 files changed, 121 insertions(+), 93 deletions(-) diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index 58791e766..d35b1662f 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -18,22 +18,26 @@ The following are applicable to all operating systems: * **JDBC** - recommended installation via ``mvn``: * `JDBC .jar file <https://sq-ftp-public.s3.amazonaws.com/sqream-jdbc-4.5.6.jar>`_ - sqream-jdbc-4.5.3 (.jar) - * `JDBC driver <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/jdbc/index.html#>`_ + * :ref:`java_jdbc` .. _.net: * **.NET**: * `.NET .dll file <https://get.sqream-share.com/share/sIsu8fxv>`_ - * `.NET driver <https://docs.sqream.com/en/v2022.1.6/connecting_to_sqream/client_drivers/dotnet/index.html>`_ + * :ref:`net` +* **Kafka**: + + * `Kafka download file <>`_ + * :ref:`kafka` .. _python: * **Python** - Recommended installation via ``pip``: * `Python .tar file <https://github.com/SQream/pysqream/releases/tag/v3.1.3>`_ - pysqream v3.1.3 (.tar.gz) - * `Python driver <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/python/index.html>`_ + * :ref:`pysqream` .. _nodejs: @@ -41,7 +45,7 @@ The following are applicable to all operating systems: * **Node.JS** - Recommended installation via ``npm``: * `Node.JS <https://sq-ftp-public.s3.amazonaws.com/sqream-sqreamdb-4.2.4.tgz>`_ - sqream-v4.2.4 (.tar.gz) - * `Node.JS driver <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/nodejs/index.html>`_ + * :ref:`nodejs` .. _tableau_connector: @@ -49,7 +53,7 @@ The following are applicable to all operating systems: * **Tableau**: * `Tableau connector <https://sq-ftp-public.s3.amazonaws.com/SQreamDB.taco>`_ - SQream (.taco) - * `Tableau manual installation <https://docs.sqream.com/en/v2021.1/third_party_tools/client_platforms/tableau.html#>`_ + * :ref:`tableau` .. _powerbi_connector: @@ -57,7 +61,7 @@ The following are applicable to all operating systems: * **Power BI**: * `Power BI PowerQuery connector <https://sq-ftp-public.s3.amazonaws.com/SqlODBC__v1.0.mez>`_ - SQream (.mez) - * `Power BI manual installation <https://docs.sqream.com/en/v2021.1/third_party_tools/client_platforms/power_bi.html>`_ + * :ref:`power_bi` Windows @@ -78,12 +82,12 @@ Linux The following are applicable to Linux: * `SQream SQL (x86_64) <https://sq-ftp-public.s3.amazonaws.com/sqream-sql-v2020.1.1_stable.x86_64.tar.gz>`_ - sqream-sql-v2020.1.1_stable.x86_64.tar.gz -* `Sqream SQL CLI Reference <https://docs.sqream.com/en/v2021.1/reference/cli/sqream_sql.html#sqream-sql-cli-reference>`_ - Interactive command-line SQL client for Intel-based machines +* :ref:`sqream_sql_cli_reference` - Interactive command-line SQL client for Intel-based machines :: * `SQream SQL*(IBM POWER9) <https://sq-ftp-public.s3.amazonaws.com/sqream-sql-v2020.1.1_stable.ppc64le.tar.gz>`_ - sqream-sql-v2020.1.1_stable.ppc64le.tar.gz -* `Sqream SQL CLI Reference <https://docs.sqream.com/en/v2021.1/reference/cli/sqream_sql.html#sqream-sql-cli-reference>`_ - Interactive command-line SQL client for IBM POWER9-based machines +* :ref:`sqream_sql_cli_reference` - Interactive command-line SQL client for IBM POWER9-based machines :: @@ -98,6 +102,8 @@ The following are applicable to Linux: jdbc/index python/index + dotnet/index + kafka/index nodejs/index odbc/index dotnet/index @@ -106,7 +112,7 @@ The following are applicable to Linux: .. rubric:: Need help? -If you couldn't find what you're looking for, we're always happy to help. Visit `SQream's support portal <https://support.sqream.com>`_ for additional support. +If you couldn't find what you're looking for, we're always happy to help. Visit :ref:`information_for_support` for additional support. .. rubric:: Looking for older drivers? diff --git a/connecting_to_sqream/client_drivers/kafka/index.rst b/connecting_to_sqream/client_drivers/kafka/index.rst index 20d339746..895ccf475 100644 --- a/connecting_to_sqream/client_drivers/kafka/index.rst +++ b/connecting_to_sqream/client_drivers/kafka/index.rst @@ -4,57 +4,59 @@ Connecting to SQream Using Kafka ************************* -Intro to Kafka producer, consumer, and loader. -Data formats -Confluent GUI - - -The Kafka page includes the following sections: +This page describes how to connect SQream with the Kafka Apache stream-processing software platform. .. contents:: :local: :depth: 1 -Getting Started -=============== + +Installation and Configuration +============= .. contents:: :local: :depth: 1 - -System Requirements -------------------- -No system requirements - - -Download Kafka Connector Files ------------------------------- - - -Installation and Configuration -============= Prerequisites ---------------- -Both Kafka consumer and SQream loader require JAVA 11. - + * JAVA 11 + * Network bandwidth should be not less than X Giga/Sec + +Supported Data Formats +---------------------- +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Data Format + - Specification + * - JSON + - + * - CSV + - + * - Avro + - Kafka Producer -============== +-------------- + +The Kafka Producer can be used for creating new topics, reading data from existing topics, and loading data from files. + +In order for the Kafka producer to operate correctly, both the Kafka producer and Zookeeper processes must be running simultaneously. If Zookeeper is not running, the Kafka producer will not start. .. contents:: :local: :depth: 1 -Installing Kafka Producer ---------------------------- -The Kafka producer is installed on the 192.168.0.125 server. +Kafka Producer Installation +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Operating Kafka Producer --------------------------- +The Kafka producer is installed on the 192.168.0.125 server. -For the producer to properly function, two processes must continuously be running: Kafka producer and Zookeeper. Note that Kafka producer will not run unless Zookeeper is already running. +Kafka Producer Configuration +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Running Zookeeper: @@ -70,6 +72,26 @@ Running Kafka producer: cd /home/sqream/kafka_2.12-3.2.1/ bin/kafka-server-start.sh -daemon config/server.properties +Verifying that both Zookeeper and Kafka producer are running: + +1. Log in to your machine using the following SQream credentials: + + * User: sqream + * Password: sqream11 + +2. Run the following string: + + .. code-block:: postgres + + [sqream@metadata-0-125 ~]$ ps -ef |grep java + +The following is an example of an output indicating that both processes are running: + + .. code-block:: postgres + + sqream 63082 1 0 Sep11 ? 00:03:50 /usr/lib/jvm/jre-1.8.0-openjdk/bin/java -Xmx512M -Xms512M -server -XX:+UseG1GC -XX:MaxGCPauseMillis=20 -XX:InitiatingHeapOccupancyPercent=35 -XX:+ExplicitGCInvokesConcurrent -XX:MaxInlineLevel=15 -Djava.awt.headless=true -Xloggc:/home/sqream/kafka_2.12-3.2.1/bin/../logs/zookeeper-gc.log -verbose:gc -XX:+PrintGCDetails -XX:+PrintGCDateStamps -XX:+PrintGCTimeStamps -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=10 -XX:GCLogFileSize=100M -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -Dkafka.logs.dir=/home/sqream/kafka_2.12-3.2.1/bin/../logs -Dlog4j.configuration=file:bin/../config/log4j.properties -cp /home/sqream/kafka_2.12-3.2.1/bin/../libs/activation-1.1.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/aopalliance-repackaged-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/argparse4j-0.7.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/audience-annotations-0.5.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/commons-cli-1.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/commons-lang3-3.8.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-api-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-basic-auth-extension-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-json-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-mirror-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-mirror-client-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-runtime-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-transforms-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-api-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-locator-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-utils-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-annotations-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-core-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-databind-2.12.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-dataformat-csv-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-datatype-jdk8-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-jaxrs-base-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-jaxrs-json-provider-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-module-jaxb-annotations-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-module-scala_2.12-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.activation-api-1.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.annotation-api-1.3.5.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.inject-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.validation-api-2.0.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.ws.rs-api-2.1.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.xml.bind-api-2.3.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javassist-3.27.0-GA.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javax.servlet-api-3.1.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javax.ws.rs-api-2.1.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jaxb-api-2.3.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-client-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-common-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-container-servlet-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-container-servlet-core-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-hk2-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-server-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-client-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-continuation-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-http-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-io-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-security-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-server-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-servlet-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-servlets-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-util-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-util-ajax-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jline-3.21.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jopt-simple-5.0.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jose4j-0.7.9.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka_2.12-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-clients-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-log4j-appender-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-metadata-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-raft-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-server-common-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-shell-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-storage-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-storage-api-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-examples-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-scala_2.12-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-test-utils-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-tools-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/lz4-java-1.8.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/maven-artifact-3.8.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/metrics-core-2.2.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/metrics-core-4.1.12.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-buffer-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-codec-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-common-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-handler-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-resolver-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-tcnative-classes-2.0.46.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-classes-epoll-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-native-epoll-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-native-unix-common-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/osgi-resource-locator-1.0.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/paranamer-2.8.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/plexus-utils-3.3.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/reflections-0.9.12.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/reload4j-1.2.19.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/rocksdbjni-6.29.4.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-collection-compat_2.12-2.6.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-java8-compat_2.12-1.0.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-library-2.12.15.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-logging_2.12-3.9.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-reflect-2.12.15.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/slf4j-api-1.7.36.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/slf4j-reload4j-1.7.36.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/snappy-java-1.1.8.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/trogdor-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zookeeper-3.6.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zookeeper-jute-3.6.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zstd-jni-1.5.2-1.jar org.apache.zookeeper.server.quorum.QuorumPeerMain config/zookeeper.properties + sqream 63614 1 0 Sep11 ? 00:19:22 /usr/lib/jvm/jre-1.8.0-openjdk/bin/java -Xmx1G -Xms1G -server -XX:+UseG1GC -XX:MaxGCPauseMillis=20 -XX:InitiatingHeapOccupancyPercent=35 -XX:+ExplicitGCInvokesConcurrent -XX:MaxInlineLevel=15 -Djava.awt.headless=true -Xloggc:/home/sqream/kafka_2.12-3.2.1/bin/../logs/kafkaServer-gc.log -verbose:gc -XX:+PrintGCDetails -XX:+PrintGCDateStamps -XX:+PrintGCTimeStamps -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=10 -XX:GCLogFileSize=100M -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -Dkafka.logs.dir=/home/sqream/kafka_2.12-3.2.1/bin/../logs -Dlog4j.configuration=file:bin/../config/log4j.properties -cp /home/sqream/kafka_2.12-3.2.1/bin/../libs/activation-1.1.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/aopalliance-repackaged-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/argparse4j-0.7.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/audience-annotations-0.5.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/commons-cli-1.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/commons-lang3-3.8.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-api-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-basic-auth-extension-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-json-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-mirror-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-mirror-client-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-runtime-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-transforms-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-api-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-locator-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-utils-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-annotations-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-core-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-databind-2.12.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-dataformat-csv-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-datatype-jdk8-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-jaxrs-base-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-jaxrs-json-provider-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-module-jaxb-annotations-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-module-scala_2.12-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.activation-api-1.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.annotation-api-1.3.5.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.inject-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.validation-api-2.0.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.ws.rs-api-2.1.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.xml.bind-api-2.3.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javassist-3.27.0-GA.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javax.servlet-api-3.1.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javax.ws.rs-api-2.1.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jaxb-api-2.3.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-client-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-common-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-container-servlet-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-container-servlet-core-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-hk2-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-server-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-client-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-continuation-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-http-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-io-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-security-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-server-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-servlet-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-servlets-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-util-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-util-ajax-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jline-3.21.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jopt-simple-5.0.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jose4j-0.7.9.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka_2.12-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-clients-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-log4j-appender-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-metadata-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-raft-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-server-common-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-shell-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-storage-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-storage-api-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-examples-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-scala_2.12-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-test-utils-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-tools-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/lz4-java-1.8.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/maven-artifact-3.8.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/metrics-core-2.2.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/metrics-core-4.1.12.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-buffer-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-codec-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-common-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-handler-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-resolver-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-tcnative-classes-2.0.46.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-classes-epoll-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-native-epoll-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-native-unix-common-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/osgi-resource-locator-1.0.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/paranamer-2.8.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/plexus-utils-3.3.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/reflections-0.9.12.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/reload4j-1.2.19.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/rocksdbjni-6.29.4.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-collection-compat_2.12-2.6.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-java8-compat_2.12-1.0.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-library-2.12.15.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-logging_2.12-3.9.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-reflect-2.12.15.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/slf4j-api-1.7.36.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/slf4j-reload4j-1.7.36.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/snappy-java-1.1.8.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/trogdor-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zookeeper-3.6.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zookeeper-jute-3.6.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zstd-jni-1.5.2-1.jar kafka.Kafka config/server.properties + Creating a new topic: .. code-block:: postgres @@ -91,55 +113,53 @@ Loading data from a file: cd /home/sqream/kafka_2.12-3.2.1/ ./kafka-console-producer.sh --bootstrap-server localhost:9092 --topic <topic name> < <full path to file> -To close Kafka producer, you must first stop the producer and only then stop Zookeeper. - Closing Kafka producer: +To close the Kafka producer, you must first stop the producer and then stop Zookeeper. + .. code-block:: postgres cd /home/sqream/kafka_2.12-3.2.1/ bin/kafka-server-stop.sh - -Verifying that the Producer is Running --------------------------------------- -To verify that both Kafka and Zookeeper are running, log in to your machine using SQream credentials: - - * User: sqream - * Password: sqream11 - - And run the following string: - - .. code-block:: postgres - - [sqream@metadata-0-125 ~]$ ps -ef |grep java - -Example of an output indicating that both processes are running: - - .. code-block:: postgres - - sqream 63082 1 0 Sep11 ? 00:03:50 /usr/lib/jvm/jre-1.8.0-openjdk/bin/java -Xmx512M -Xms512M -server -XX:+UseG1GC -XX:MaxGCPauseMillis=20 -XX:InitiatingHeapOccupancyPercent=35 -XX:+ExplicitGCInvokesConcurrent -XX:MaxInlineLevel=15 -Djava.awt.headless=true -Xloggc:/home/sqream/kafka_2.12-3.2.1/bin/../logs/zookeeper-gc.log -verbose:gc -XX:+PrintGCDetails -XX:+PrintGCDateStamps -XX:+PrintGCTimeStamps -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=10 -XX:GCLogFileSize=100M -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -Dkafka.logs.dir=/home/sqream/kafka_2.12-3.2.1/bin/../logs -Dlog4j.configuration=file:bin/../config/log4j.properties -cp /home/sqream/kafka_2.12-3.2.1/bin/../libs/activation-1.1.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/aopalliance-repackaged-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/argparse4j-0.7.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/audience-annotations-0.5.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/commons-cli-1.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/commons-lang3-3.8.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-api-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-basic-auth-extension-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-json-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-mirror-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-mirror-client-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-runtime-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-transforms-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-api-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-locator-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-utils-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-annotations-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-core-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-databind-2.12.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-dataformat-csv-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-datatype-jdk8-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-jaxrs-base-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-jaxrs-json-provider-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-module-jaxb-annotations-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-module-scala_2.12-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.activation-api-1.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.annotation-api-1.3.5.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.inject-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.validation-api-2.0.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.ws.rs-api-2.1.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.xml.bind-api-2.3.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javassist-3.27.0-GA.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javax.servlet-api-3.1.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javax.ws.rs-api-2.1.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jaxb-api-2.3.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-client-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-common-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-container-servlet-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-container-servlet-core-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-hk2-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-server-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-client-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-continuation-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-http-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-io-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-security-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-server-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-servlet-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-servlets-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-util-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-util-ajax-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jline-3.21.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jopt-simple-5.0.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jose4j-0.7.9.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka_2.12-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-clients-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-log4j-appender-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-metadata-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-raft-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-server-common-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-shell-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-storage-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-storage-api-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-examples-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-scala_2.12-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-test-utils-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-tools-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/lz4-java-1.8.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/maven-artifact-3.8.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/metrics-core-2.2.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/metrics-core-4.1.12.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-buffer-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-codec-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-common-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-handler-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-resolver-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-tcnative-classes-2.0.46.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-classes-epoll-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-native-epoll-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-native-unix-common-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/osgi-resource-locator-1.0.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/paranamer-2.8.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/plexus-utils-3.3.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/reflections-0.9.12.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/reload4j-1.2.19.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/rocksdbjni-6.29.4.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-collection-compat_2.12-2.6.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-java8-compat_2.12-1.0.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-library-2.12.15.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-logging_2.12-3.9.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-reflect-2.12.15.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/slf4j-api-1.7.36.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/slf4j-reload4j-1.7.36.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/snappy-java-1.1.8.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/trogdor-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zookeeper-3.6.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zookeeper-jute-3.6.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zstd-jni-1.5.2-1.jar org.apache.zookeeper.server.quorum.QuorumPeerMain config/zookeeper.properties - sqream 63614 1 0 Sep11 ? 00:19:22 /usr/lib/jvm/jre-1.8.0-openjdk/bin/java -Xmx1G -Xms1G -server -XX:+UseG1GC -XX:MaxGCPauseMillis=20 -XX:InitiatingHeapOccupancyPercent=35 -XX:+ExplicitGCInvokesConcurrent -XX:MaxInlineLevel=15 -Djava.awt.headless=true -Xloggc:/home/sqream/kafka_2.12-3.2.1/bin/../logs/kafkaServer-gc.log -verbose:gc -XX:+PrintGCDetails -XX:+PrintGCDateStamps -XX:+PrintGCTimeStamps -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=10 -XX:GCLogFileSize=100M -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -Dkafka.logs.dir=/home/sqream/kafka_2.12-3.2.1/bin/../logs -Dlog4j.configuration=file:bin/../config/log4j.properties -cp /home/sqream/kafka_2.12-3.2.1/bin/../libs/activation-1.1.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/aopalliance-repackaged-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/argparse4j-0.7.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/audience-annotations-0.5.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/commons-cli-1.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/commons-lang3-3.8.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-api-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-basic-auth-extension-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-json-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-mirror-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-mirror-client-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-runtime-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-transforms-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-api-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-locator-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-utils-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-annotations-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-core-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-databind-2.12.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-dataformat-csv-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-datatype-jdk8-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-jaxrs-base-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-jaxrs-json-provider-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-module-jaxb-annotations-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-module-scala_2.12-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.activation-api-1.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.annotation-api-1.3.5.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.inject-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.validation-api-2.0.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.ws.rs-api-2.1.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.xml.bind-api-2.3.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javassist-3.27.0-GA.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javax.servlet-api-3.1.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javax.ws.rs-api-2.1.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jaxb-api-2.3.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-client-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-common-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-container-servlet-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-container-servlet-core-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-hk2-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-server-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-client-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-continuation-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-http-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-io-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-security-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-server-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-servlet-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-servlets-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-util-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-util-ajax-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jline-3.21.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jopt-simple-5.0.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jose4j-0.7.9.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka_2.12-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-clients-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-log4j-appender-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-metadata-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-raft-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-server-common-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-shell-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-storage-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-storage-api-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-examples-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-scala_2.12-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-test-utils-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-tools-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/lz4-java-1.8.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/maven-artifact-3.8.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/metrics-core-2.2.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/metrics-core-4.1.12.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-buffer-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-codec-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-common-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-handler-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-resolver-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-tcnative-classes-2.0.46.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-classes-epoll-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-native-epoll-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-native-unix-common-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/osgi-resource-locator-1.0.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/paranamer-2.8.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/plexus-utils-3.3.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/reflections-0.9.12.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/reload4j-1.2.19.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/rocksdbjni-6.29.4.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-collection-compat_2.12-2.6.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-java8-compat_2.12-1.0.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-library-2.12.15.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-logging_2.12-3.9.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-reflect-2.12.15.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/slf4j-api-1.7.36.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/slf4j-reload4j-1.7.36.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/snappy-java-1.1.8.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/trogdor-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zookeeper-3.6.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zookeeper-jute-3.6.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zstd-jni-1.5.2-1.jar kafka.Kafka config/server.properties Kafka Consumer -=============== +--------------- .. contents:: :local: :depth: 1 -The Kafka consumer converts data formatted as CSV and JSON into .tmp files and saves it in the predefined directory. -You must define the number of files to be converted before they are saved as a sqream.batchRecordCount file. Once reaching the defined number of files, the consumer saves the converted files and begins the process all over again. +The Kafka consumer converts data formatted as CSV and JSON into ``.tmp`` files and saves it in a predefined directory. +You must define the number of files to be converted before they are saved as a ``sqream.batchRecordCount`` file. Once reaching the defined number of files, the consumer saves the converted files and begins the process all over again. -Installing Kafka Consumer --------------------------- +Kafka Consumer Installation +~~~~~~~~~~~~~~~~~~~~~~~~~~~ The Kafka consumer version is located under /home/sqream/kafkaconnect1, machine IP 192.168.0.102 Credentials: user = sqream pass = sqprj2021$ -Configuring Kafka Consumer ---------------------------- +Kafka Consumer Configuration +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +What needs to be configured: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - Topic + - A category or feed name to which messages are published and subscribed to + * - ``sqream.batchrecordcount`` + - Preferably configured according to an estimated number of messages + * - ``outputdir`` + - Copy the ``sqream.outputdir`` path, from its beginning and until ``outputs``, included, and save it to a known location. It is required to configure SQream loader to use this section of the path + * - ``csvorder`` + - Create table columns + Connection string: @@ -169,17 +189,8 @@ Configuration file structure: sqream.removeNewline =false sqream.outputType=csv sqream.csvOrder=receivedTime,equipmentId,asdf,timestamp,intv - - -What needs to be configured: - -topics - -sqream.batchrecordcount – best to configure according to an estimated number of messages. - -outputdir – address requirement to copy and save for later. - -csvorder – Create table columns. + +SQream tables must be created according to the columns configured in ``csvorder``. Running commands: @@ -187,25 +198,26 @@ Running commands: export JAVA_HOME=/home/sqream/copy-from-util/jdk-11;export CLASSPATH=.:$JAVA_HOME/jre/lib:$JAVA_HOME/lib:$JAVA_HOME/lib/tools.jar;cd /home/sqream/kafkaconnect1/kafka/bin/ && ./connect-standalone.sh /home/sqream/kafkaconnect1/sqream-kafka-connector/sqream-kafkaconnect/config/connect-standalone.properties /home/sqream/kafkaconnect1/sqream-kafka-connector/sqream-kafkaconnect/config/sqream-filesink.properties & -In SQream, create a table according to the columns defined using csvorder. - .. code-block:: postgres - - Note – Copy the sqream.outputdir path, from its beginning and until ``outputs``, included, and save it to a known location. It is required to configure SQream loader to use this section of the path. + SQream Loader -============== +------------- +.. contents:: + :local: + :depth: 1 +SQream Loader Installation +~~~~~~~~~~~~~~~~~~~~~~~~~~ -Installing SQream loader Sqream loader credentials: ip machine: 192.168.0.102 user = sqream pass = sqprj2021$ -Configuring SQream Loader ----------------------------- +SQream Loader Configuration +~~~~~~~~~~~~~~~~~~~~~~~~~~~ Building SQream loader: @@ -222,15 +234,26 @@ Running SQream loader: git clone -b develop http://gitlab.sq.l/java/copy-from-util.git mvn clean package +What needs to be configured: +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``root`` + – paste copied path to root + * - ``schema`` + - + * - ``name`` + - Configuration file structure: - .. code-block:: postgres - #config.yaml com: @@ -259,10 +282,8 @@ Configuration file structure: parallel: 1 -What needs to be configured: -root – paste copied path to root -schema -name + + Running commands: .. code-block:: postgres @@ -279,6 +300,7 @@ Either * Folder permission issue Or * SQream loader folder is not the same as Kenan folder + Purging ======= Ingested files are automatically zipped and archived for 60 days. @@ -289,5 +311,5 @@ Limitations Latency Retention -Example +Examples ========= From 88ad92d8f589fc6cf9c73c8ca400988c7a44e8b8 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 3 Jan 2023 15:34:29 +0200 Subject: [PATCH 378/882] Update index.rst --- connecting_to_sqream/client_drivers/kafka/index.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/connecting_to_sqream/client_drivers/kafka/index.rst b/connecting_to_sqream/client_drivers/kafka/index.rst index 895ccf475..9c64a03e1 100644 --- a/connecting_to_sqream/client_drivers/kafka/index.rst +++ b/connecting_to_sqream/client_drivers/kafka/index.rst @@ -249,7 +249,6 @@ What needs to be configured: * - ``name`` - - Configuration file structure: .. code-block:: postgres From 5140c109460bd3293daa655764e57c912fd3f7ee Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 3 Jan 2023 16:48:22 +0200 Subject: [PATCH 379/882] Update compression.rst --- feature_guides/compression.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/feature_guides/compression.rst b/feature_guides/compression.rst index ab26e9986..74874b980 100644 --- a/feature_guides/compression.rst +++ b/feature_guides/compression.rst @@ -35,7 +35,9 @@ When loading data, SQream DB automatically decides on the compression schemes fo Compression Methods ------------------------ -The following table shows the available compression methods: +In some cases, if SQream finds that the given compression method cannot effectively compress the data, it will return to the default compression type. + +The following table shows the supported compression methods: .. list-table:: :widths: auto From 74ebf6f18977db29a7526a91c0b0a933fbde95e4 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 5 Jan 2023 13:16:34 +0200 Subject: [PATCH 380/882] Kafka --- connecting_to_sqream/client_drivers/kafka/index.rst | 11 ++++------- connecting_to_sqream/client_drivers/python/index.rst | 3 +-- 2 files changed, 5 insertions(+), 9 deletions(-) diff --git a/connecting_to_sqream/client_drivers/kafka/index.rst b/connecting_to_sqream/client_drivers/kafka/index.rst index 9c64a03e1..22c06709c 100644 --- a/connecting_to_sqream/client_drivers/kafka/index.rst +++ b/connecting_to_sqream/client_drivers/kafka/index.rst @@ -4,7 +4,7 @@ Connecting to SQream Using Kafka ************************* -This page describes how to connect SQream with the Kafka Apache stream-processing software platform. +This page describes how to connect SQream with Kafka Apache. .. contents:: :local: @@ -74,10 +74,7 @@ Running Kafka producer: Verifying that both Zookeeper and Kafka producer are running: -1. Log in to your machine using the following SQream credentials: - - * User: sqream - * Password: sqream11 +1. Log in to your machine. 2. Run the following string: @@ -89,8 +86,8 @@ The following is an example of an output indicating that both processes are runn .. code-block:: postgres - sqream 63082 1 0 Sep11 ? 00:03:50 /usr/lib/jvm/jre-1.8.0-openjdk/bin/java -Xmx512M -Xms512M -server -XX:+UseG1GC -XX:MaxGCPauseMillis=20 -XX:InitiatingHeapOccupancyPercent=35 -XX:+ExplicitGCInvokesConcurrent -XX:MaxInlineLevel=15 -Djava.awt.headless=true -Xloggc:/home/sqream/kafka_2.12-3.2.1/bin/../logs/zookeeper-gc.log -verbose:gc -XX:+PrintGCDetails -XX:+PrintGCDateStamps -XX:+PrintGCTimeStamps -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=10 -XX:GCLogFileSize=100M -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -Dkafka.logs.dir=/home/sqream/kafka_2.12-3.2.1/bin/../logs -Dlog4j.configuration=file:bin/../config/log4j.properties -cp /home/sqream/kafka_2.12-3.2.1/bin/../libs/activation-1.1.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/aopalliance-repackaged-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/argparse4j-0.7.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/audience-annotations-0.5.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/commons-cli-1.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/commons-lang3-3.8.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-api-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-basic-auth-extension-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-json-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-mirror-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-mirror-client-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-runtime-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-transforms-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-api-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-locator-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-utils-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-annotations-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-core-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-databind-2.12.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-dataformat-csv-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-datatype-jdk8-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-jaxrs-base-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-jaxrs-json-provider-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-module-jaxb-annotations-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-module-scala_2.12-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.activation-api-1.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.annotation-api-1.3.5.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.inject-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.validation-api-2.0.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.ws.rs-api-2.1.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.xml.bind-api-2.3.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javassist-3.27.0-GA.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javax.servlet-api-3.1.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javax.ws.rs-api-2.1.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jaxb-api-2.3.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-client-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-common-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-container-servlet-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-container-servlet-core-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-hk2-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-server-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-client-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-continuation-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-http-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-io-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-security-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-server-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-servlet-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-servlets-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-util-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-util-ajax-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jline-3.21.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jopt-simple-5.0.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jose4j-0.7.9.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka_2.12-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-clients-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-log4j-appender-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-metadata-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-raft-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-server-common-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-shell-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-storage-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-storage-api-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-examples-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-scala_2.12-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-test-utils-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-tools-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/lz4-java-1.8.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/maven-artifact-3.8.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/metrics-core-2.2.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/metrics-core-4.1.12.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-buffer-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-codec-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-common-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-handler-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-resolver-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-tcnative-classes-2.0.46.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-classes-epoll-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-native-epoll-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-native-unix-common-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/osgi-resource-locator-1.0.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/paranamer-2.8.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/plexus-utils-3.3.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/reflections-0.9.12.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/reload4j-1.2.19.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/rocksdbjni-6.29.4.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-collection-compat_2.12-2.6.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-java8-compat_2.12-1.0.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-library-2.12.15.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-logging_2.12-3.9.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-reflect-2.12.15.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/slf4j-api-1.7.36.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/slf4j-reload4j-1.7.36.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/snappy-java-1.1.8.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/trogdor-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zookeeper-3.6.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zookeeper-jute-3.6.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zstd-jni-1.5.2-1.jar org.apache.zookeeper.server.quorum.QuorumPeerMain config/zookeeper.properties - sqream 63614 1 0 Sep11 ? 00:19:22 /usr/lib/jvm/jre-1.8.0-openjdk/bin/java -Xmx1G -Xms1G -server -XX:+UseG1GC -XX:MaxGCPauseMillis=20 -XX:InitiatingHeapOccupancyPercent=35 -XX:+ExplicitGCInvokesConcurrent -XX:MaxInlineLevel=15 -Djava.awt.headless=true -Xloggc:/home/sqream/kafka_2.12-3.2.1/bin/../logs/kafkaServer-gc.log -verbose:gc -XX:+PrintGCDetails -XX:+PrintGCDateStamps -XX:+PrintGCTimeStamps -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=10 -XX:GCLogFileSize=100M -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -Dkafka.logs.dir=/home/sqream/kafka_2.12-3.2.1/bin/../logs -Dlog4j.configuration=file:bin/../config/log4j.properties -cp /home/sqream/kafka_2.12-3.2.1/bin/../libs/activation-1.1.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/aopalliance-repackaged-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/argparse4j-0.7.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/audience-annotations-0.5.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/commons-cli-1.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/commons-lang3-3.8.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-api-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-basic-auth-extension-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-json-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-mirror-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-mirror-client-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-runtime-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/connect-transforms-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-api-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-locator-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/hk2-utils-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-annotations-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-core-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-databind-2.12.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-dataformat-csv-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-datatype-jdk8-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-jaxrs-base-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-jaxrs-json-provider-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-module-jaxb-annotations-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jackson-module-scala_2.12-2.12.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.activation-api-1.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.annotation-api-1.3.5.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.inject-2.6.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.validation-api-2.0.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.ws.rs-api-2.1.6.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jakarta.xml.bind-api-2.3.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javassist-3.27.0-GA.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javax.servlet-api-3.1.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/javax.ws.rs-api-2.1.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jaxb-api-2.3.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-client-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-common-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-container-servlet-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-container-servlet-core-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-hk2-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jersey-server-2.34.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-client-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-continuation-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-http-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-io-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-security-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-server-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-servlet-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-servlets-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-util-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jetty-util-ajax-9.4.44.v20210927.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jline-3.21.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jopt-simple-5.0.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/jose4j-0.7.9.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka_2.12-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-clients-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-log4j-appender-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-metadata-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-raft-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-server-common-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-shell-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-storage-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-storage-api-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-examples-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-scala_2.12-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-streams-test-utils-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/kafka-tools-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/lz4-java-1.8.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/maven-artifact-3.8.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/metrics-core-2.2.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/metrics-core-4.1.12.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-buffer-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-codec-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-common-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-handler-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-resolver-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-tcnative-classes-2.0.46.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-classes-epoll-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-native-epoll-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/netty-transport-native-unix-common-4.1.73.Final.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/osgi-resource-locator-1.0.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/paranamer-2.8.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/plexus-utils-3.3.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/reflections-0.9.12.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/reload4j-1.2.19.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/rocksdbjni-6.29.4.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-collection-compat_2.12-2.6.0.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-java8-compat_2.12-1.0.2.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-library-2.12.15.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-logging_2.12-3.9.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/scala-reflect-2.12.15.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/slf4j-api-1.7.36.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/slf4j-reload4j-1.7.36.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/snappy-java-1.1.8.4.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/trogdor-3.2.1.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zookeeper-3.6.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zookeeper-jute-3.6.3.jar:/home/sqream/kafka_2.12-3.2.1/bin/../libs/zstd-jni-1.5.2-1.jar kafka.Kafka config/server.properties + <JAVA_HOME>/bin/java... org.apache.zookeeper.server.quorum.QuorumPeerMain config/zookeeper.properties + <JAVA_HOME>/bin/java... kafka.Kafka config/server.properties Creating a new topic: diff --git a/connecting_to_sqream/client_drivers/python/index.rst b/connecting_to_sqream/client_drivers/python/index.rst index 1b5a7ccd4..f29679bc0 100644 --- a/connecting_to_sqream/client_drivers/python/index.rst +++ b/connecting_to_sqream/client_drivers/python/index.rst @@ -173,8 +173,7 @@ The following example is for using a ServerPicker: .. code-block:: python - import sqlalchemy as sa - import pandas as pd + import sqlalchemy as sa from sqlalchemy.engine.url import URL From 2327b820780b07cb049e4c4a8b4fb9e7e42444b3 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 5 Jan 2023 15:15:27 +0200 Subject: [PATCH 381/882] Update create_table.rst --- reference/sql/sql_statements/ddl_commands/create_table.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/ddl_commands/create_table.rst b/reference/sql/sql_statements/ddl_commands/create_table.rst index 47d684653..3f9e9d578 100644 --- a/reference/sql/sql_statements/ddl_commands/create_table.rst +++ b/reference/sql/sql_statements/ddl_commands/create_table.rst @@ -74,7 +74,7 @@ Default Value Constraints The ``DEFAULT`` value constraint specifies a value to use if one is not defined in an :ref:`insert` or :ref:`copy_from` statement. -The default value may be a literal, GETDATE(), or NULL. +The default value may be a literal or NULL. .. note:: The ``DEFAULT`` constraint only applies if the column does not have a value specified in the :ref:`insert` or :ref:`copy_from` statement. You can still insert a ``NULL`` into an nullable column by explicitly inserting ``NULL``. For example, ``INSERT INTO cool_animals VALUES (1, 'Gnu', NULL)``. From 86a66f59d934d32e72232e6902bc505cda9a96e9 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 5 Jan 2023 17:02:17 +0200 Subject: [PATCH 382/882] Update round.rst --- .../scalar_functions/numeric/round.rst | 21 ++++++++++++------- 1 file changed, 13 insertions(+), 8 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/numeric/round.rst b/reference/sql/sql_functions/scalar_functions/numeric/round.rst index d362c9abd..420bd3c0f 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/round.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/round.rst @@ -13,8 +13,10 @@ Syntax .. code-block:: postgres - ROUND( expr [, scale ] ) - + ROUND( numeric ) -> numeric + ROUND( numeric [, int ] ) -> numeric + ROUND( double ) -> double + Arguments ============ @@ -24,20 +26,23 @@ Arguments * - Parameter - Description - * - ``expr`` - - Numeric expression to round - * - ``scale`` - - Number of digits after the decimal point to round to. Defaults to 0 if not specified. + * - ``numeric`` + - Stores numeric values such as integers, decimal numbers, and currency values + * - ``int`` + - Stores integer values Returns ============ -``ROUND`` always returns a ``double`` floating point number. +The ``ROUND()`` function returns a ``numeric`` value when used with numeric input types, such as ``integer`` or ``decimal``. When the input is ``double``, the return type is also ``double``. + + +.. note:: ``integer`` data types are automatically cast to ``numeric`` data types. Notes ======= -* If the input value is NULL, the result is NULL. +If the input value is NULL, the result is NULL. Examples =========== From 02671cf6a2de00de5fbecfe5e02920c50467c953 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 8 Jan 2023 11:38:40 +0200 Subject: [PATCH 383/882] Spark --- .../client_platforms/index.rst | 1 + .../client_platforms/spark.rst | 382 ++++++++++++++++++ 2 files changed, 383 insertions(+) create mode 100644 connecting_to_sqream/client_platforms/spark.rst diff --git a/connecting_to_sqream/client_platforms/index.rst b/connecting_to_sqream/client_platforms/index.rst index 5d6092e14..903800b35 100644 --- a/connecting_to_sqream/client_platforms/index.rst +++ b/connecting_to_sqream/client_platforms/index.rst @@ -22,6 +22,7 @@ If you are looking for a tool that is not listed, SQream and our partners can he :titlesonly: + spark trino informatica microstrategy diff --git a/connecting_to_sqream/client_platforms/spark.rst b/connecting_to_sqream/client_platforms/spark.rst new file mode 100644 index 000000000..d610f5d42 --- /dev/null +++ b/connecting_to_sqream/client_platforms/spark.rst @@ -0,0 +1,382 @@ +.. _spark: + +************************* +Connecting to SQream Using Spark +************************* + + +If you are using Spark for distributed processing and analysis and wish to use it to connect to SQream, follow these instructions. + + +.. contents:: + :local: + :depth: 1 + +Prerequisites +------------- +To use Spark with SQream, you must have the following installed: + +* SQream version 2022.1.8 or later +* Spark version 3.3.1 or later +* SQream Spark plugin xxxx +* JDBC version 4.5.6 or later + + + +Installation +------------ + +.. contents:: + :local: + :depth: 1 + +JDBC +~~~~ + +In case JDBC is not yet configured, follow the `JDBC Client Drivers page <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/jdbc/index.html>`_ for registration and configuration guidance. + + +SQream Spark Plugin +~~~~~~~~~~~~~~~~~~~ + +The SQream Spark plugin supports bi-directional data transfer between the different clusters. The Spark cluster may be self-hosted or third-party hosted, using services such as Qubole, AWS EMR, or Databricks. + +Connection Parameters +~~~~~~~~~~~~~~~~~~~~~ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Item + - Default + - Description + * - ``url`` + - + - The JDBC URL of the form ``jdbc:subprotocol:subname`` to connect to. The source-specific connection properties may be specified in the URL. e.g., ``jdbc:Sqream://localhost/test?user=fred&password=secret`` + * - ``dbtable`` + - + - The JDBC table that should be read from or written into. Note that when using it in the read path anything that is valid in a ``FROM`` clause of a SQL query can be used. For example, instead of a full table you could also use a subquery in parentheses. It is not allowed to specify ``dbtable`` and ``query`` options at the same time. + * - ``query`` + - + - A query that will be used to read data into Spark. The specified query will be parenthesized and used as a subquery in the ``FROM`` clause. Spark will also assign an alias to the subquery clause. As an example, spark will issue a query of the following form to the JDBC Source. ``SELECT <columns> FROM (<user_specified_query>) spark_gen_alias``. Restrictions while using this option: 1. It is not allowed to specify ``dbtable`` and ``query`` options at the same time. 2. It is not allowed to specify ``query`` and ``partitionColumn`` options at the same time. When specifying ``partitionColumn`` option is required, the subquery can be specified using ``dbtable`` option instead and partition columns can be qualified using the subquery alias provided as part of ``dbtable``. + Example: ``spark.read.format("jdbc").option("url", jdbcUrl).option("query", "select c1, c2 from t1").load()`` + * - ``driver`` + - + - The class name of the JDBC driver to use to connect to this URL. + * - ``numPartitions`` + - + - The maximum number of partitions that can be used for parallelism in table reading and writing. This also determines the maximum number of concurrent JDBC connections. If the number of partitions to write exceeds this limit, we decrease it to this limit by calling ``coalesce(numPartitions)`` before writing. + * - ``queryTimeout`` + - 0 + - The number of seconds the driver will wait for a Statement object to execute to the given number of seconds. Zero means there is no limit. In the write path, this option depends on how JDBC drivers implement the API ``setQueryTimeout``, e.g., the h2 JDBC driver checks the timeout of each query instead of an entire JDBC batch. + * - ``fetchsize`` + - 1 + - The JDBC fetch size, which determines how many rows to fetch per round trip. This can help performance on JDBC drivers which default to low fetch size (e.g. Oracle with 10 rows). + * - ``batchsize`` + - 1000000 + - The JDBC batch size, which determines how many rows to insert per round trip. This can help performance on JDBC drivers. This option applies only to writing. + * - ``sessionInitStatement`` + - + - After each database session is opened to the remote DB and before starting to read data, this option executes a custom SQL statement (or a PL/SQL block). Use this to implement session initialization code. Example: ``option("sessionInitStatement", """BEGIN execute immediate 'alter session set "_serial_direct_read"=true'; END;""")`` + * - ``truncate`` + - ``false`` + - This is a JDBC writer related option. When ``SaveMode.Overwrite`` is enabled, this option causes Spark to truncate an existing table instead of dropping and recreating it. This can be more efficient, and prevents the table metadata (e.g., indices) from being removed. However, it will not work in some cases, such as when the new data has a different schema. In case of failures, users should turn off ``truncate`` option to use ``DROP TABLE`` again. Also, due to the different behavior of ``TRUNCATE TABLE`` among DBMS, it's not always safe to use this. MySQLDialect, DB2Dialect, MsSqlServerDialect, DerbyDialect, and OracleDialect supports this while PostgresDialect and default JDBCDirect doesn't. For unknown and unsupported JDBCDirect, the user option ``truncate`` is ignored. + * - ``cascadeTruncate`` + - the default cascading truncate behaviour of the JDBC database in question, specified in the ``isCascadeTruncate`` in each JDBCDialect + - This is a JDBC writer related option. If enabled and supported by the JDBC database (PostgreSQL and Oracle at the moment), this options allows execution of a ``TRUNCATE TABLE t CASCADE`` (in the case of PostgreSQL a TRUNCATE TABLE ONLY t CASCADE is executed to prevent inadvertently truncating descendant tables). This will affect other tables, and thus should be used with care. + * - ``createTableOptions`` + - + - This is a JDBC writer related option. If specified, this option allows setting of database-specific table and partition options when creating a table (e.g., ``CREATE TABLE t (name string) ENGINE=InnoDB.``). + * - ``createTableColumnTypes`` + - + - The database column data types to use instead of the defaults, when creating the table. Data type information should be specified in the same format as CREATE TABLE columns syntax (e.g: ``"name CHAR(64), comments VARCHAR(1024)"``). The specified types should be valid spark sql data types. + * - ``customSchema`` + - + - The custom schema to use for reading data from JDBC connectors. For example, ``"id DECIMAL(38, 0), name STRING"``. You can also specify partial fields, and the others use the default type mapping. For example, ``"id DECIMAL(38, 0)"``. The column names should be identical to the corresponding column names of JDBC table. Users can specify the corresponding data types of Spark SQL instead of using the defaults. + * - ``pushDownPredicate`` + - ``true`` + - The option to enable or disable predicate push-down into the JDBC data source. The default value is true, in which case Spark will push down filters to the JDBC data source as much as possible. Otherwise, if set to false, no filter will be pushed down to the JDBC data source and thus all filters will be handled by Spark. Predicate push-down is usually turned off when the predicate filtering is performed faster by Spark than by the JDBC data source. + * - ``pushDownAggregate`` + - ``false`` + - The option to enable or disable aggregate push-down in V2 JDBC data source. The default value is false, in which case Spark will not push down aggregates to the JDBC data source. Otherwise, if sets to true, aggregates will be pushed down to the JDBC data source. Aggregate push-down is usually turned off when the aggregate is performed faster by Spark than by the JDBC data source. Please note that aggregates can be pushed down if and only if all the aggregate functions and the related filters can be pushed down. If ``numPartitions`` equals to 1 or the group by key is the same as ``partitionColumn``, Spark will push down aggregate to data source completely and not apply a final aggregate over the data source output. Otherwise, Spark will apply a final aggregate over the data source output. + * - ``pushDownLimit`` + - ``false`` + - The option to enable or disable LIMIT push-down into V2 JDBC data source. The LIMIT push-down also includes LIMIT + SORT , a.k.a. the Top N operator. The default value is false, in which case Spark does not push down LIMIT or LIMIT with SORT to the JDBC data source. Otherwise, if sets to true, LIMIT or LIMIT with SORT is pushed down to the JDBC data source. If ``numPartitions`` is greater than 1, SPARK still applies LIMIT or LIMIT with SORT on the result from data source even if LIMIT or LIMIT with SORT is pushed down. Otherwise, if LIMIT or LIMIT with SORT is pushed down and ``numPartitions`` equals to 1, SPARK will not apply LIMIT or LIMIT with SORT on the result from data source. + * - ``pushDownTableSample`` + - ``false`` + - The option to enable or disable TABLESAMPLE push-down into V2 JDBC data source. The default value is false, in which case Spark does not push down TABLESAMPLE to the JDBC data source. Otherwise, if value sets to true, TABLESAMPLE is pushed down to the JDBC data source. + * - ``connectionProvider`` + - + - The name of the JDBC connection provider to use to connect to this URL, e.g. ``db2``, ``mssql``. Must be one of the providers loaded with the JDBC data source. Used to disambiguate when more than one provider can handle the specified driver and options. The selected provider must not be disabled by ``spark.sql.sources.disabledJdbcConnProviderList``. + + +Data transfer from SQream to Spark +-------------------- + +1. Use the read() method of the SqlContext object to construct a DataFrameReader. + +2. Specify SQREAM_SOURCE_NAME using the format() method. For the definition + +3. Specify the connector options using either the option() or options() method. + +4. Specify one of the following options for the table data to be read: + + * dbtable: The name of the table to be read. All columns and records are retrieved (i.e. it is equivalent to SELECT * FROM db_table). + + * query: The exact query (SELECT statement) to run. + +Examples +--------------- + +To read an entire table: + +.. code-block:: postgres + + val df: DataFrame = sqlContext.read .format(SQREAM_SOURCE_NAME) .options(sfOptions) .option("<sqream_table_name>", "<table_name>") .load() + +To read query results: + +.. code-block:: postgres + + val df: DataFrame = sqlContext.read .format(SQREAM_SOURCE_NAME) .options(sfOptions) .option("query", "<EXECUTED_QUERY> <table_name>") .load() + + +Data transfer from Spark to SQream +-------------------------------- + +1. Use the write() method of the DataFrame to construct a DataFrameWriter. + +2. Specify SQREAM_SOURCE_NAME using the format() method. + +3. Specify the connector options using either the option() or options() method. + +4. Use the dbtable option to specify the table to which data is written. + +5. Use the mode() method to specify the save mode for the content. + +Examples +--------------- +To read an entire table: + +.. code-block:: postgres + + df.write .format(SQREAM_SOURCE_NAME) .options(sfOptions) .option("<sqream_table_name>", "<table_name>") .mode(SaveMode.Overwrite) .save() + +Supported Data Types and Mapping +-------------------------------- + +SQream data types mapped to Spark + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - SQream + - Spark + * - ``BIGINT`` + - ``LONGINT`` + * - ``BOOL`` + - ``BooleanType`` + * - ``DATE`` + - ``DateType`` + * - ``DOUBLE`` + - ``DoubleType`` + * - ``REAL`` + - ``FloateType`` + * - ``DECIMAL`` + - ``DeciamlType`` + * - ``INT`` + - ``Integer`` + * - ``SMALLINT`` + - ``ShortType`` + * - ``TINYINT`` + - ``ShortType`` + * - ``DATETIME`` + - ``TimestampType`` + +Spark data types mapped to SQream + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Spark + - SQream + * - ``BooleanType`` + - ``BOOL`` + * - ``ByteType`` + - ``SMALLINT`` + * - ``DateType`` + - ``DATE`` + * - ``DecimalType`` + - ``DECIMAL`` + * - ``DoubleType`` + - ``DOUBLE`` + * - ``FloatType`` + - ``REAL`` + * - ``IntegerType`` + - ``INT`` + * - ``LongType`` + - ``BIGINT`` + * - ``ShortType`` + - ``SMALLINT`` + * - ``StringType`` + - ``TEXT`` + * - ``TimestampType`` + - ``DATETIME`` + + +Examples +--------- + +Scala + +.. code-block:: postgres + + // Note: JDBC loading and saving can be achieved via either the load/save or jdbc methods + // Loading data from a JDBC source + val jdbcDF = spark.read + .format("jdbc") + .option("url", "jdbc:Sqream:dbserver") + .option("dbtable", "schema.tablename") + .option("user", "username") + .option("password", "password") + .load() + + val connectionProperties = new Properties() + connectionProperties.put("user", "username") + connectionProperties.put("password", "password") + val jdbcDF2 = spark.read + .jdbc("jdbc:Sqream:dbserver", "schema.tablename", connectionProperties) + // Specifying the custom data types of the read schema + connectionProperties.put("customSchema", "id DECIMAL(38, 0), name TEXT") + val jdbcDF3 = spark.read + .jdbc("jdbc:postgresql:dbserver", "schema.tablename", connectionProperties) + + // Saving data to a JDBC source + jdbcDF.write + .format("jdbc") + .option("url", "jdbc:Sqream:dbserver") + .option("dbtable", "schema.tablename") + .option("user", "username") + .option("password", "password") + .save() + + jdbcDF2.write + .jdbc("jdbc:Sqream:dbserver", "schema.tablename", connectionProperties) + + // Specifying create table column data types on write + jdbcDF.write + .option("createTableColumnTypes", "name TEXT, comments TEXT") + .jdbc("jdbc:Sqream:dbserver", "schema.tablename", connectionProperties) + +JAVA + +.. code-block:: postgres + + // Note: JDBC loading and saving can be achieved via either the load/save or jdbc methods + // Loading data from a JDBC source + Dataset<Row> jdbcDF = spark.read() + .format("jdbc") + .option("url", "jdbc:Sqream:dbserver") + .option("dbtable", "schema.tablename") + .option("user", "username") + .option("password", "password") + .load(); + + Properties connectionProperties = new Properties(); + connectionProperties.put("user", "username"); + connectionProperties.put("password", "password"); + Dataset<Row> jdbcDF2 = spark.read() + .jdbc("jdbc:Sqream:dbserver", "schema.tablename", connectionProperties); + + // Saving data to a JDBC source + jdbcDF.write() + .format("jdbc") + .option("url", "jdbc:Sqream:dbserver") + .option("dbtable", "schema.tablename") + .option("user", "username") + .option("password", "password") + .save(); + + jdbcDF2.write() + .jdbc("jdbc:Sqream:dbserver", "schema.tablename", connectionProperties); + + // Specifying create table column data types on write + jdbcDF.write() + .option("createTableColumnTypes", "name TEXT, comments TEXT") + .jdbc("jdbc:Sqream:dbserver", "schema.tablename", connectionProperties); + +Python + +.. code-block:: postgres + + # Note: JDBC loading and saving can be achieved via either the load/save or jdbc methods + # Loading data from a JDBC source + jdbcDF = spark.read \ + .format("jdbc") \ + .option("url", "jdbc:Sqream:dbserver") \ + .option("dbtable", "schema.tablename") \ + .option("user", "username") \ + .option("password", "password") \ + .load() + + jdbcDF2 = spark.read \ + .jdbc("jdbc:Sqream:dbserver", "schema.tablename", + properties={"user": "username", "password": "password"}) + + # Specifying dataframe column data types on read + jdbcDF3 = spark.read \ + .format("jdbc") \ + .option("url", "jdbc:Sqream:dbserver") \ + .option("dbtable", "schema.tablename") \ + .option("user", "username") \ + .option("password", "password") \ + .option("customSchema", "id DECIMAL(38, 0), name TEXT") \ + .load() + + # Saving data to a JDBC source + jdbcDF.write \ + .format("jdbc") \ + .option("url", "jdbc:Sqream:dbserver") \ + .option("dbtable", "schema.tablename") \ + .option("user", "username") \ + .option("password", "password") \ + .save() + + jdbcDF2.write \ + .jdbc("jdbc:Sqream:dbserver", "schema.tablename", + properties={"user": "username", "password": "password"}) + + # Specifying create table column data types on write + jdbcDF.write \ + .option("createTableColumnTypes", "name TEXT, comments TEXT") \ + .jdbc("jdbc:Sqream:dbserver", "schema.tablename", + properties={"user": "username", "password": "password"}) + +R + +.. code-block:: postgres + + # Loading data from a JDBC source + df <- read.jdbc("jdbc:Sqream:dbserver", "schema.tablename", user = "username", password = "password") + + # Saving data to a JDBC source + write.jdbc(df, "jdbc:Sqream:dbserver", "schema.tablename", user = "username", password = "password") + +SQL + +.. code-block:: postgres + + CREATE TEMPORARY VIEW jdbcTable + USING org.apache.spark.sql.jdbc + OPTIONS ( + url "jdbc:Sqream:dbserver", + dbtable "schema.tablename", + user 'username', + password 'password' + ) + + INSERT INTO TABLE jdbcTable + SELECT * FROM resultTable \ No newline at end of file From 4e8739a95dc9b63b8797fb1669c3c4a2b1942bd5 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 8 Jan 2023 14:18:24 +0200 Subject: [PATCH 384/882] Spark --- .../client_platforms/spark.rst | 125 +++++++++--------- reference/cli/server_picker.rst | 2 +- 2 files changed, 65 insertions(+), 62 deletions(-) diff --git a/connecting_to_sqream/client_platforms/spark.rst b/connecting_to_sqream/client_platforms/spark.rst index d610f5d42..7a5adc225 100644 --- a/connecting_to_sqream/client_platforms/spark.rst +++ b/connecting_to_sqream/client_platforms/spark.rst @@ -48,67 +48,70 @@ Connection Parameters :widths: auto :header-rows: 1 - * - Item - - Default - - Description - * - ``url`` - - - - The JDBC URL of the form ``jdbc:subprotocol:subname`` to connect to. The source-specific connection properties may be specified in the URL. e.g., ``jdbc:Sqream://localhost/test?user=fred&password=secret`` - * - ``dbtable`` - - - - The JDBC table that should be read from or written into. Note that when using it in the read path anything that is valid in a ``FROM`` clause of a SQL query can be used. For example, instead of a full table you could also use a subquery in parentheses. It is not allowed to specify ``dbtable`` and ``query`` options at the same time. - * - ``query`` - - - - A query that will be used to read data into Spark. The specified query will be parenthesized and used as a subquery in the ``FROM`` clause. Spark will also assign an alias to the subquery clause. As an example, spark will issue a query of the following form to the JDBC Source. ``SELECT <columns> FROM (<user_specified_query>) spark_gen_alias``. Restrictions while using this option: 1. It is not allowed to specify ``dbtable`` and ``query`` options at the same time. 2. It is not allowed to specify ``query`` and ``partitionColumn`` options at the same time. When specifying ``partitionColumn`` option is required, the subquery can be specified using ``dbtable`` option instead and partition columns can be qualified using the subquery alias provided as part of ``dbtable``. - Example: ``spark.read.format("jdbc").option("url", jdbcUrl).option("query", "select c1, c2 from t1").load()`` - * - ``driver`` - - - - The class name of the JDBC driver to use to connect to this URL. - * - ``numPartitions`` - - - - The maximum number of partitions that can be used for parallelism in table reading and writing. This also determines the maximum number of concurrent JDBC connections. If the number of partitions to write exceeds this limit, we decrease it to this limit by calling ``coalesce(numPartitions)`` before writing. - * - ``queryTimeout`` - - 0 - - The number of seconds the driver will wait for a Statement object to execute to the given number of seconds. Zero means there is no limit. In the write path, this option depends on how JDBC drivers implement the API ``setQueryTimeout``, e.g., the h2 JDBC driver checks the timeout of each query instead of an entire JDBC batch. - * - ``fetchsize`` - - 1 - - The JDBC fetch size, which determines how many rows to fetch per round trip. This can help performance on JDBC drivers which default to low fetch size (e.g. Oracle with 10 rows). - * - ``batchsize`` - - 1000000 - - The JDBC batch size, which determines how many rows to insert per round trip. This can help performance on JDBC drivers. This option applies only to writing. - * - ``sessionInitStatement`` - - - - After each database session is opened to the remote DB and before starting to read data, this option executes a custom SQL statement (or a PL/SQL block). Use this to implement session initialization code. Example: ``option("sessionInitStatement", """BEGIN execute immediate 'alter session set "_serial_direct_read"=true'; END;""")`` - * - ``truncate`` - - ``false`` - - This is a JDBC writer related option. When ``SaveMode.Overwrite`` is enabled, this option causes Spark to truncate an existing table instead of dropping and recreating it. This can be more efficient, and prevents the table metadata (e.g., indices) from being removed. However, it will not work in some cases, such as when the new data has a different schema. In case of failures, users should turn off ``truncate`` option to use ``DROP TABLE`` again. Also, due to the different behavior of ``TRUNCATE TABLE`` among DBMS, it's not always safe to use this. MySQLDialect, DB2Dialect, MsSqlServerDialect, DerbyDialect, and OracleDialect supports this while PostgresDialect and default JDBCDirect doesn't. For unknown and unsupported JDBCDirect, the user option ``truncate`` is ignored. - * - ``cascadeTruncate`` - - the default cascading truncate behaviour of the JDBC database in question, specified in the ``isCascadeTruncate`` in each JDBCDialect - - This is a JDBC writer related option. If enabled and supported by the JDBC database (PostgreSQL and Oracle at the moment), this options allows execution of a ``TRUNCATE TABLE t CASCADE`` (in the case of PostgreSQL a TRUNCATE TABLE ONLY t CASCADE is executed to prevent inadvertently truncating descendant tables). This will affect other tables, and thus should be used with care. - * - ``createTableOptions`` - - - - This is a JDBC writer related option. If specified, this option allows setting of database-specific table and partition options when creating a table (e.g., ``CREATE TABLE t (name string) ENGINE=InnoDB.``). - * - ``createTableColumnTypes`` - - - - The database column data types to use instead of the defaults, when creating the table. Data type information should be specified in the same format as CREATE TABLE columns syntax (e.g: ``"name CHAR(64), comments VARCHAR(1024)"``). The specified types should be valid spark sql data types. - * - ``customSchema`` - - - - The custom schema to use for reading data from JDBC connectors. For example, ``"id DECIMAL(38, 0), name STRING"``. You can also specify partial fields, and the others use the default type mapping. For example, ``"id DECIMAL(38, 0)"``. The column names should be identical to the corresponding column names of JDBC table. Users can specify the corresponding data types of Spark SQL instead of using the defaults. - * - ``pushDownPredicate`` - - ``true`` - - The option to enable or disable predicate push-down into the JDBC data source. The default value is true, in which case Spark will push down filters to the JDBC data source as much as possible. Otherwise, if set to false, no filter will be pushed down to the JDBC data source and thus all filters will be handled by Spark. Predicate push-down is usually turned off when the predicate filtering is performed faster by Spark than by the JDBC data source. - * - ``pushDownAggregate`` - - ``false`` - - The option to enable or disable aggregate push-down in V2 JDBC data source. The default value is false, in which case Spark will not push down aggregates to the JDBC data source. Otherwise, if sets to true, aggregates will be pushed down to the JDBC data source. Aggregate push-down is usually turned off when the aggregate is performed faster by Spark than by the JDBC data source. Please note that aggregates can be pushed down if and only if all the aggregate functions and the related filters can be pushed down. If ``numPartitions`` equals to 1 or the group by key is the same as ``partitionColumn``, Spark will push down aggregate to data source completely and not apply a final aggregate over the data source output. Otherwise, Spark will apply a final aggregate over the data source output. - * - ``pushDownLimit`` - - ``false`` - - The option to enable or disable LIMIT push-down into V2 JDBC data source. The LIMIT push-down also includes LIMIT + SORT , a.k.a. the Top N operator. The default value is false, in which case Spark does not push down LIMIT or LIMIT with SORT to the JDBC data source. Otherwise, if sets to true, LIMIT or LIMIT with SORT is pushed down to the JDBC data source. If ``numPartitions`` is greater than 1, SPARK still applies LIMIT or LIMIT with SORT on the result from data source even if LIMIT or LIMIT with SORT is pushed down. Otherwise, if LIMIT or LIMIT with SORT is pushed down and ``numPartitions`` equals to 1, SPARK will not apply LIMIT or LIMIT with SORT on the result from data source. - * - ``pushDownTableSample`` - - ``false`` - - The option to enable or disable TABLESAMPLE push-down into V2 JDBC data source. The default value is false, in which case Spark does not push down TABLESAMPLE to the JDBC data source. Otherwise, if value sets to true, TABLESAMPLE is pushed down to the JDBC data source. - * - ``connectionProvider`` - - - - The name of the JDBC connection provider to use to connect to this URL, e.g. ``db2``, ``mssql``. Must be one of the providers loaded with the JDBC data source. Used to disambiguate when more than one provider can handle the specified driver and options. The selected provider must not be disabled by ``spark.sql.sources.disabledJdbcConnProviderList``. + + * - Item + - Default + - Description + * - ``url`` + - + - The JDBC URL of the form ``jdbc:subprotocol:subname`` to connect to. The source-specific connection properties may be specified in the URL. e.g., ``jdbc:Sqream://localhost/test?user=fred&password=secret``. + * - ``dbtable`` + - + - The JDBC table that should be read from or written into. Note that when using it in the read path anything that is valid in a ``FROM`` clause of a SQL query can be used. For example, instead of a full table you could also use a subquery in parentheses. It is not allowed to specify ``dbtable`` and ``query`` options at the same time. + * - ``dbtable`` + - + - The JDBC table that should be read from or written into. Note that when using it in the read path anything that is valid in a ``FROM`` clause of a SQL query can be used. For example, instead of a full table you could also use a subquery in parentheses. It is not allowed to specify ``dbtable`` and ``query`` options at the same time. + * - ``query`` + - + - A query that will be used to read data into Spark. The specified query will be parenthesized and used as a subquery in the ``FROM`` clause. Spark will also assign an alias to the subquery clause. As an example, spark will issue a query of the following form to the JDBC Source. ``SELECT <columns> FROM (<user_specified_query>) spark_gen_alias``. Restrictions while using this option: 1. It is not allowed to specify ``dbtable`` and ``query`` options at the same time. 2. It is not allowed to specify ``query`` and ``partitionColumn`` options at the same time. When specifying ``partitionColumn`` option is required, the subquery can be specified using ``dbtable`` option instead and partition columns can be qualified using the subquery alias provided as part of ``dbtable``. Example: ``spark.read.format("jdbc").option("url", jdbcUrl).option("query", "select c1, c2 from t1").load()`` + * - ``driver`` + - + - The class name of the JDBC driver to use to connect to this URL. + * - ``numPartitions`` + - + - The maximum number of partitions that can be used for parallelism in table reading and writing. This also determines the maximum number of concurrent JDBC connections. If the number of partitions to write exceeds this limit, we decrease it to this limit by calling ``coalesce(numPartitions)`` before writing. + * - ``queryTimeout`` + - 0 + - The number of seconds the driver will wait for a Statement object to execute to the given number of seconds. Zero means there is no limit. In the write path, this option depends on how JDBC drivers implement the API ``setQueryTimeout``, e.g., the h2 JDBC driver checks the timeout of each query instead of an entire JDBC batch. + * - ``fetchsize`` + - 1 + - The JDBC fetch size, which determines how many rows to fetch per round trip. This can help performance on JDBC drivers which default to low fetch size (e.g. Oracle with 10 rows). + * - ``batchsize`` + - 1000000 + - The JDBC batch size, which determines how many rows to insert per round trip. This can help performance on JDBC drivers. This option applies only to writing. + * - ``sessionInitStatement`` + - + - After each database session is opened to the remote DB and before starting to read data, this option executes a custom SQL statement (or a PL/SQL block). Use this to implement session initialization code. Example: ``option("sessionInitStatement", """BEGIN execute immediate 'alter session set "_serial_direct_read"=true'; END;""")`` + * - ``truncate`` + - ``false`` + - This is a JDBC writer related option. When ``SaveMode.Overwrite`` is enabled, this option causes Spark to truncate an existing table instead of dropping and recreating it. This can be more efficient, and prevents the table metadata (e.g., indices) from being removed. However, it will not work in some cases, such as when the new data has a different schema. In case of failures, users should turn off ``truncate`` option to use ``DROP TABLE`` again. Also, due to the different behavior of ``TRUNCATE TABLE`` among DBMS, it's not always safe to use this. MySQLDialect, DB2Dialect, MsSqlServerDialect, DerbyDialect, and OracleDialect supports this while PostgresDialect and default JDBCDirect doesn't. For unknown and unsupported JDBCDirect, the user option ``truncate`` is ignored. + * - ``cascadeTruncate`` + - the default cascading truncate behaviour of the JDBC database in question, specified in the ``isCascadeTruncate`` in each JDBCDialect + - This is a JDBC writer related option. If enabled and supported by the JDBC database (PostgreSQL and Oracle at the moment), this options allows execution of a ``TRUNCATE TABLE t CASCADE`` (in the case of PostgreSQL a TRUNCATE TABLE ONLY t CASCADE is executed to prevent inadvertently truncating descendant tables). This will affect other tables, and thus should be used with care. + * - ``createTableOptions`` + - + - This is a JDBC writer related option. If specified, this option allows setting of database-specific table and partition options when creating a table (e.g., ``CREATE TABLE t (name string) ENGINE=InnoDB.``). + * - ``createTableColumnTypes`` + - + - The database column data types to use instead of the defaults, when creating the table. Data type information should be specified in the same format as CREATE TABLE columns syntax (e.g: ``"name CHAR(64), comments VARCHAR(1024)"``). The specified types should be valid spark sql data types. + * - ``customSchema`` + - + - The custom schema to use for reading data from JDBC connectors. For example, ``"id DECIMAL(38, 0), name STRING"``. You can also specify partial fields, and the others use the default type mapping. For example, ``"id DECIMAL(38, 0)"``. The column names should be identical to the corresponding column names of JDBC table. Users can specify the corresponding data types of Spark SQL instead of using the defaults. + * - ``pushDownPredicate`` + - ``true`` + - The option to enable or disable predicate push-down into the JDBC data source. The default value is true, in which case Spark will push down filters to the JDBC data source as much as possible. Otherwise, if set to false, no filter will be pushed down to the JDBC data source and thus all filters will be handled by Spark. Predicate push-down is usually turned off when the predicate filtering is performed faster by Spark than by the JDBC data source. + * - ``pushDownAggregate`` + - ``false`` + - The option to enable or disable aggregate push-down in V2 JDBC data source. The default value is false, in which case Spark will not push down aggregates to the JDBC data source. Otherwise, if sets to true, aggregates will be pushed down to the JDBC data source. Aggregate push-down is usually turned off when the aggregate is performed faster by Spark than by the JDBC data source. Please note that aggregates can be pushed down if and only if all the aggregate functions and the related filters can be pushed down. If ``numPartitions`` equals to 1 or the group by key is the same as ``partitionColumn``, Spark will push down aggregate to data source completely and not apply a final aggregate over the data source output. Otherwise, Spark will apply a final aggregate over the data source output. + * - ``pushDownLimit`` + - ``false`` + - The option to enable or disable LIMIT push-down into V2 JDBC data source. The LIMIT push-down also includes LIMIT + SORT , a.k.a. the Top N operator. The default value is false, in which case Spark does not push down LIMIT or LIMIT with SORT to the JDBC data source. Otherwise, if sets to true, LIMIT or LIMIT with SORT is pushed down to the JDBC data source. If ``numPartitions`` is greater than 1, SPARK still applies LIMIT or LIMIT with SORT on the result from data source even if LIMIT or LIMIT with SORT is pushed down. Otherwise, if LIMIT or LIMIT with SORT is pushed down and ``numPartitions`` equals to 1, SPARK will not apply LIMIT or LIMIT with SORT on the result from data source. + * - ``pushDownTableSample`` + - ``false`` + - The option to enable or disable TABLESAMPLE push-down into V2 JDBC data source. The default value is false, in which case Spark does not push down TABLESAMPLE to the JDBC data source. Otherwise, if value sets to true, TABLESAMPLE is pushed down to the JDBC data source. + * - ``connectionProvider`` + - + - The name of the JDBC connection provider to use to connect to this URL, e.g. ``db2``, ``mssql``. Must be one of the providers loaded with the JDBC data source. Used to disambiguate when more than one provider can handle the specified driver and options. The selected provider must not be disabled by ``spark.sql.sources.disabledJdbcConnProviderList``. Data transfer from SQream to Spark diff --git a/reference/cli/server_picker.rst b/reference/cli/server_picker.rst index e64d792a0..3bfd4a004 100644 --- a/reference/cli/server_picker.rst +++ b/reference/cli/server_picker.rst @@ -31,7 +31,7 @@ Positional command line arguments * - ``TCP listen port`` - ``3108`` - TCP port for server picker to listen on - * - ``Metadata server port`` + * - ``SSL listen port`` - ``3109`` - SSL port for server picker to listen on From 6faec673ce3b64e2e3c27e1ba6d0b905167230c5 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 8 Jan 2023 16:37:50 +0200 Subject: [PATCH 385/882] RN --- .../client_platforms/spark.rst | 4 +- releases/4.0.0_index.rst | 51 ++++++++----------- 2 files changed, 22 insertions(+), 33 deletions(-) diff --git a/connecting_to_sqream/client_platforms/spark.rst b/connecting_to_sqream/client_platforms/spark.rst index 7a5adc225..d7c9e13ad 100644 --- a/connecting_to_sqream/client_platforms/spark.rst +++ b/connecting_to_sqream/client_platforms/spark.rst @@ -23,8 +23,8 @@ To use Spark with SQream, you must have the following installed: -Installation ------------- +Installation and Configuration +------------------------------ .. contents:: :local: diff --git a/releases/4.0.0_index.rst b/releases/4.0.0_index.rst index 8458ba8b7..4a490c16a 100644 --- a/releases/4.0.0_index.rst +++ b/releases/4.0.0_index.rst @@ -12,66 +12,55 @@ The 4.0.0 release notes were released on xx/xx/20xx and describe the following: :local: :depth: 1 - - New Features ----------- +------------ * Re-enabling an enhanced version of the :ref:`License Storage Capacity<monitoring_workers_and_services_from_the_dashboard>` feature :: - * :ref:`Physical deletion performance enhancement<delete>` by supporting file systems with parallelism capabilities + * :ref:`Lightweight Directory Access Protocol(LDAP)<ldap>` may be used to authenticate SQream roles :: + * :ref:`Physical deletion performance enhancement<delete>` by supporting file systems with parallelism capabilities + +SQream Studio Updates and Improvements +-------------------------------------- + + * When creating a **New Role**, you may now create a group role by selecting **Set as a group role**. + + :: Known Issues ---------- +------------ :ref:`Percentile<percentile_disc>` is not supported for Window functions. Version 4.0.0 resolved Issues ---------- +----------------------------- +---------------+------------------------------------------------------------------------------------------+ | **SQ No.** | **Description** | +===============+==========================================================================================+ -| SQ-11199 | AWS S3 internal runtime error when executing ``COPY TO`` statement | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-11772 | Slow ``JOIN`` query | +| SQ-10544 | | +---------------+------------------------------------------------------------------------------------------+ | SQ-12228 | ``CREATE AS SELECT`` statement fails when executed with ``UNION ALL`` and ``GROUP BY`` | +---------------+------------------------------------------------------------------------------------------+ -| SQ-11296 | Slow catalog queries | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-11948 | ``SAVED QUERY`` execution using ``SELECT`` or ``INSERT INTO`` returns error | +| SQ-12580 | Server Picker GPU dependency | +---------------+------------------------------------------------------------------------------------------+ -| SQ-12255 | ``COPY TO`` string export error | +| SQ-12652 | Result panel adjustment | +---------------+------------------------------------------------------------------------------------------+ -| SQ-12310 | ``DICT`` compression buffer size issue | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-12318 | JDBC ``insertBuffer`` parameter issue | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-12364 | ``GET DDL`` foreign table output issue | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-12468 | Internal compiler error | -+---------------+------------------------------------------------------------------------------------------+ - - - - - Configuration Changes --------- +--------------------- No configuration changes were made. Naming Changes -------- +-------------- No relevant naming changes were made. Deprecated Features -------- +------------------- SQream is declaring end of support of VARCHAR data type, the decision resulted by SQream's effort to enhance its core functionalities and with respect to ever changing echo system requirements. VARCHAR is no longer supported for new customers - effective from Version 2022.1.3 (September 2022). @@ -80,11 +69,11 @@ TEXT data type is replacing VARCHAR and NVARCHAR - SQream will maintain VARCHAR End of Support -------- +--------------- No End of Support changes were made. Upgrading to v4.0.0 -------- +------------------- 1. Generate a back-up of the metadata by running the following command: .. code-block:: console From 3115b10b5ca0d207c1b49a30305a112b068bf796 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 8 Jan 2023 17:32:50 +0200 Subject: [PATCH 386/882] Update copy_to.rst --- reference/sql/sql_statements/dml_commands/copy_to.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/dml_commands/copy_to.rst b/reference/sql/sql_statements/dml_commands/copy_to.rst index 3708d85ae..b0610efcd 100644 --- a/reference/sql/sql_statements/dml_commands/copy_to.rst +++ b/reference/sql/sql_statements/dml_commands/copy_to.rst @@ -91,6 +91,8 @@ The following table shows the ``COPY_TO`` elements: - The CSV file will contain a header line with the names of each column in the file. This option is allowed only when using CSV format. * - ``DELIMITER`` - Specifies the character or string that separates fields (columns) within each row of the file. The default is a comma character (``,``). + * - ``RECORD_DELIMITER`` + - Specifies the character or string that separates records in a data set. This option is allowed only when using CSV format. * - ``AWS_ID``, ``AWS_SECRET`` - Specifies the authentication details for secured S3 buckets * - ``MAX_FILE_SIZE`` @@ -458,7 +460,7 @@ The following is an example of exporting a table to a TSV file with a HEADER row .. code-block:: psql - COPY nba TO WRAPPER csv_fdw OPTIONS (LOCATION = '/tmp/nba_export.csv', DELIMITER = '|', HEADER = true); + COPY nba TO WRAPPER csv_fdw OPTIONS (LOCATION = '/tmp/nba_export.csv', DELIMITER = '\t', HEADER = true); .. code-block:: console From 1afef227e31e2b17e5d0b661a6d9881de96c2e37 Mon Sep 17 00:00:00 2001 From: TaliaSQream <taliar@sqreamtech.com> Date: Mon, 9 Jan 2023 13:23:23 +0200 Subject: [PATCH 387/882] Update spark.rst --- .../client_platforms/spark.rst | 34 +++++++++++-------- 1 file changed, 20 insertions(+), 14 deletions(-) diff --git a/connecting_to_sqream/client_platforms/spark.rst b/connecting_to_sqream/client_platforms/spark.rst index d7c9e13ad..20472ceef 100644 --- a/connecting_to_sqream/client_platforms/spark.rst +++ b/connecting_to_sqream/client_platforms/spark.rst @@ -1,11 +1,11 @@ .. _spark: ************************* -Connecting to SQream Using Spark +Using Spark With SQream ************************* -If you are using Spark for distributed processing and analysis and wish to use it to connect to SQream, follow these instructions. +If you are using Spark for distributed processing and analysis and wish to use it with SQream, follow these instructions. .. contents:: @@ -33,17 +33,19 @@ Installation and Configuration JDBC ~~~~ -In case JDBC is not yet configured, follow the `JDBC Client Drivers page <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/jdbc/index.html>`_ for registration and configuration guidance. +If JDBC is not yet configured, follow the `JDBC Client Drivers page <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/jdbc/index.html>`_ for registration and configuration guidance. SQream Spark Plugin ~~~~~~~~~~~~~~~~~~~ -The SQream Spark plugin supports bi-directional data transfer between the different clusters. The Spark cluster may be self-hosted or third-party hosted, using services such as Qubole, AWS EMR, or Databricks. +The SQream Spark plugin supports bi-directional data transfer between the Spark and the SQream cluster. -Connection Parameters +Connection Command and Parameters ~~~~~~~~~~~~~~~~~~~~~ +**Missing connection command** + .. list-table:: :widths: auto :header-rows: 1 @@ -114,18 +116,20 @@ Connection Parameters - The name of the JDBC connection provider to use to connect to this URL, e.g. ``db2``, ``mssql``. Must be one of the providers loaded with the JDBC data source. Used to disambiguate when more than one provider can handle the specified driver and options. The selected provider must not be disabled by ``spark.sql.sources.disabledJdbcConnProviderList``. -Data transfer from SQream to Spark --------------------- +Transferring Data From SQream to Spark +------------------------------------- -1. Use the read() method of the SqlContext object to construct a DataFrameReader. +In the Spark UI, configure Spark to write to the SQream database. -2. Specify SQREAM_SOURCE_NAME using the format() method. For the definition +1. From the SqlContext object, use the read() method to construct a DataFrameReader. -3. Specify the connector options using either the option() or options() method. +2. Use the format() method to specify SQREAM_SOURCE_NAME. + +3. Use either the option() or options() method to specify the connector options. -4. Specify one of the following options for the table data to be read: +4. Specify one of the following options for reading tables: - * dbtable: The name of the table to be read. All columns and records are retrieved (i.e. it is equivalent to SELECT * FROM db_table). + * dbtable: The name of the table to be read. All columns and records are retrieved (i.e. it is equivalent to ``SELECT * FROM db_table``). * query: The exact query (SELECT statement) to run. @@ -145,8 +149,10 @@ To read query results: val df: DataFrame = sqlContext.read .format(SQREAM_SOURCE_NAME) .options(sfOptions) .option("query", "<EXECUTED_QUERY> <table_name>") .load() -Data transfer from Spark to SQream --------------------------------- +Transferring data From Spark to SQream +-------------------------------------- + +In the Spark UI, configure Spark to read from the SQream database. 1. Use the write() method of the DataFrame to construct a DataFrameWriter. From 3641996e77fa05ad6f5444cacfd9f8cb6dff2b53 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 10 Jan 2023 09:30:47 +0200 Subject: [PATCH 388/882] comment --- configuration_guides/current_method_configuration_levels.rst | 2 +- configuration_guides/current_method_configuration_roles.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/configuration_guides/current_method_configuration_levels.rst b/configuration_guides/current_method_configuration_levels.rst index 47ccf32b3..216919991 100644 --- a/configuration_guides/current_method_configuration_levels.rst +++ b/configuration_guides/current_method_configuration_levels.rst @@ -11,7 +11,7 @@ SQream's configuration parameters are based on the following hierarchy: Cluster-Based Configuration -------------- -Cluster-based configuration lets you centralize configurations for all workers on the cluster. Only Regular and Cluster flag types can be modified on the cluster level. These modifications are persistent and stored at the metadata level, which are applied globally to all workers in the cluster. +Cluster-based configuration lets you centralize configurations for all workers on the cluster. Only :ref:`Regular and Cluster flag types<current_method_flag_types>` can be modified on the cluster level. These modifications are persistent and stored at the metadata level, which are applied globally to all workers in the cluster. .. note:: While cluster-based configuration was designed for configuring Workers, you can only configure Worker values set to the Regular or Cluster type. diff --git a/configuration_guides/current_method_configuration_roles.rst b/configuration_guides/current_method_configuration_roles.rst index 11b7e4bfb..b3afc2b46 100644 --- a/configuration_guides/current_method_configuration_roles.rst +++ b/configuration_guides/current_method_configuration_roles.rst @@ -5,7 +5,7 @@ Configuration Roles ************************** SQream divides flags into the following roles, each with their own set of permissions: -* :ref:`admin_flags` - can be modified by administrators on a session and cluster basis using the ``ALTER SYSTEM SET`` command: **Comment** - *I don't think we need to mention the command here, as it's described below, and also not mentioned for Generic Flags.* +* :ref:`admin_flags` - can be modified by administrators on a session and cluster basis using the ``ALTER SYSTEM SET`` command: * Regular * Worker From eb38bde73cd833d276f78b9e30f9b6d7cf022f84 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 10 Jan 2023 11:04:12 +0200 Subject: [PATCH 389/882] Kafka --- .../current_method_configuration_levels.rst | 2 +- .../client_drivers/kafka/index.rst | 23 +++++++++---------- 2 files changed, 12 insertions(+), 13 deletions(-) diff --git a/configuration_guides/current_method_configuration_levels.rst b/configuration_guides/current_method_configuration_levels.rst index 216919991..a6d9b91aa 100644 --- a/configuration_guides/current_method_configuration_levels.rst +++ b/configuration_guides/current_method_configuration_levels.rst @@ -17,7 +17,7 @@ Cluster-based configuration lets you centralize configurations for all workers o Worker-Based Configuration -------------- -Worker-based configuration lets you modify the configuration belong to individual workers from the worker configuration file. +Worker-based configuration lets you modify individual workers using a worker configuration file. Worker-based configuration modifications are persistent. For more information on making configurations from the worker configuration file, see `Modifying Your Configuration Using a Legacy Configuration File <https://docs.sqream.com/en/latest/configuration_guides/current_configuration_method.html#modifying-your-configuration-using-a-legacy-configuration-file>`_. diff --git a/connecting_to_sqream/client_drivers/kafka/index.rst b/connecting_to_sqream/client_drivers/kafka/index.rst index 22c06709c..524dc5243 100644 --- a/connecting_to_sqream/client_drivers/kafka/index.rst +++ b/connecting_to_sqream/client_drivers/kafka/index.rst @@ -4,7 +4,8 @@ Connecting to SQream Using Kafka ************************* -This page describes how to connect SQream with Kafka Apache. +If you are using Kafka Apache for distributed streaming and wish to use it with SQream, follow these instructions. + .. contents:: :local: @@ -42,9 +43,7 @@ Supported Data Formats Kafka Producer -------------- -The Kafka Producer can be used for creating new topics, reading data from existing topics, and loading data from files. - -In order for the Kafka producer to operate correctly, both the Kafka producer and Zookeeper processes must be running simultaneously. If Zookeeper is not running, the Kafka producer will not start. +The Kafka Producer requires both the Kafka producer and Zookeeper processes to be running in order to create new topics, read data from existing topics, and load data from files. If Zookeeper is not running, the Kafka producer will not start. .. contents:: :local: @@ -53,7 +52,7 @@ In order for the Kafka producer to operate correctly, both the Kafka producer an Kafka Producer Installation ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -The Kafka producer is installed on the 192.168.0.125 server. +The Kafka Producer is installed on the 192.168.0.125 server. Kafka Producer Configuration ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -110,34 +109,34 @@ Loading data from a file: cd /home/sqream/kafka_2.12-3.2.1/ ./kafka-console-producer.sh --bootstrap-server localhost:9092 --topic <topic name> < <full path to file> -Closing Kafka producer: +Terminating the Kafka Producer requires that both the Kafka Producer and Zookeeper be terminated. To avoid data inconsistency and potential data loss, terminate the Kafka Producer before terminating the Zookeeper. -To close the Kafka producer, you must first stop the producer and then stop Zookeeper. +Terminating the Kafka Producer: .. code-block:: postgres cd /home/sqream/kafka_2.12-3.2.1/ bin/kafka-server-stop.sh -Kafka Consumer +SQream Consumer --------------- .. contents:: :local: :depth: 1 -The Kafka consumer converts data formatted as CSV and JSON into ``.tmp`` files and saves it in a predefined directory. +The SQream Consumer converts data formatted as CSV and JSON into ``.tmp`` files and saves it in a predefined directory. You must define the number of files to be converted before they are saved as a ``sqream.batchRecordCount`` file. Once reaching the defined number of files, the consumer saves the converted files and begins the process all over again. -Kafka Consumer Installation +SQream Consumer Installation ~~~~~~~~~~~~~~~~~~~~~~~~~~~ -The Kafka consumer version is located under /home/sqream/kafkaconnect1, machine IP 192.168.0.102 +The SQream Consumer version is located under /home/sqream/kafkaconnect1, machine IP 192.168.0.102 Credentials: user = sqream pass = sqprj2021$ -Kafka Consumer Configuration +SQream Consumer Configuration ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ What needs to be configured: From 3a95bb2e7182320eea461a2ea955e85b19a0a920 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 10 Jan 2023 11:04:46 +0200 Subject: [PATCH 390/882] Update current_method_flag_types.rst --- configuration_guides/current_method_flag_types.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/configuration_guides/current_method_flag_types.rst b/configuration_guides/current_method_flag_types.rst index b1bedecba..7908e65d0 100644 --- a/configuration_guides/current_method_flag_types.rst +++ b/configuration_guides/current_method_flag_types.rst @@ -5,7 +5,7 @@ Flag Types ************************** SQream uses three flag types, **Cluster**, **Worker**, and **Regular**. Each of these flag types is associated with one of three hierarchical configuration levels described earlier, making it easier to configure your system. -The highest level in the hierarchy is Cluster, which lets you set configurations across all workers in a given cluster. Modifying cluster values is **persistent**, meaning that any configurations you set are retained after shutting down your system. Configurations set at the Cluster level take the highest priority and override settings made on the Regular and Worker level **Comment** - *Confirm*. This is known as **cluster-based configuration**. Note that Cluster-based configuration lets you modify Cluster *and* Regular flag types. An example of a Cluster flag is **persisting your cache directory.** +The highest level in the hierarchy is Cluster, which lets you set configurations across all workers in a given cluster. Modifying cluster values is **persistent**, meaning that any configurations you set are retained after shutting down your system. Configurations set at the Cluster level take the highest priority and override settings made on the Regular and Worker level. This is known as **cluster-based configuration**. Note that Cluster-based configuration lets you modify Cluster *and* Regular flag types. An example of a Cluster flag is **persisting your cache directory.** The second level is Worker, which lets you configure individual workers. Modifying Worker values are also **persistent**. This is known as **worker-based configuration**. Some examples of Worker flags includes **setting total device memory usage** and **setting metadata server connection port**. From 691125ddacb881883d7e8c7c41366b36ba278b45 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 10 Jan 2023 13:35:27 +0200 Subject: [PATCH 391/882] Update 4.0.0_index.rst --- releases/4.0.0_index.rst | 22 +++++++++++++++++++--- 1 file changed, 19 insertions(+), 3 deletions(-) diff --git a/releases/4.0.0_index.rst b/releases/4.0.0_index.rst index 4a490c16a..1b962fbdc 100644 --- a/releases/4.0.0_index.rst +++ b/releases/4.0.0_index.rst @@ -4,7 +4,7 @@ Release Notes 4.0.0 ************************** -**SQream is introducing a new version release system that follows the more commonly used Major.Minor.Patch versioning schema. The newly released 4.0.0 version is a minor version upgrade and does not require considerable preparation.** +SQream is introducing a new version release system that follows the more commonly used Major.Minor.Patch versioning schema. The newly released **4.0.0 version** is a minor version upgrade and does not require considerable preparation. The 4.0.0 release notes were released on xx/xx/20xx and describe the following: @@ -42,13 +42,29 @@ Version 4.0.0 resolved Issues +---------------+------------------------------------------------------------------------------------------+ | **SQ No.** | **Description** | +===============+==========================================================================================+ -| SQ-10544 | | +| SQ-10544 | SQream Studio Worker Panel issue | ++---------------+------------------------------------------------------------------------------------------+ +| SQ-11199 | AWS S3 internal runtime error when executing ``COPY TO`` statement | ++---------------+------------------------------------------------------------------------------------------+ +| SQ-11296 | Slow catalog queries | ++---------------+------------------------------------------------------------------------------------------+ +| SQ-11772 | Slow ``JOIN`` query | ++---------------+------------------------------------------------------------------------------------------+ +| SQ-11948 | ``SAVED QUERY`` execution using ``SELECT`` or ``INSERT INTO`` returns error | +---------------+------------------------------------------------------------------------------------------+ | SQ-12228 | ``CREATE AS SELECT`` statement fails when executed with ``UNION ALL`` and ``GROUP BY`` | +---------------+------------------------------------------------------------------------------------------+ +| SQ-12310 | ``DICT`` compression buffer size issue | ++---------------+------------------------------------------------------------------------------------------+ +| SQ-12318 | JDBC ``insertBuffer`` parameter issue | ++---------------+------------------------------------------------------------------------------------------+ +| SQ-12364 | ``GET DDL`` foreign table output issue | ++---------------+------------------------------------------------------------------------------------------+ +| SQ-12468 | Internal compiler error | ++---------------+------------------------------------------------------------------------------------------+ | SQ-12580 | Server Picker GPU dependency | +---------------+------------------------------------------------------------------------------------------+ -| SQ-12652 | Result panel adjustment | +| SQ-12652 | SQream Studio result panel adjustment | +---------------+------------------------------------------------------------------------------------------+ Configuration Changes From 23333c568fbc7bf796b1eb1a2cb135d16efec81c Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 10 Jan 2023 13:36:13 +0200 Subject: [PATCH 392/882] Update index.rst --- .../client_drivers/kafka/index.rst | 43 ++++++++----------- 1 file changed, 17 insertions(+), 26 deletions(-) diff --git a/connecting_to_sqream/client_drivers/kafka/index.rst b/connecting_to_sqream/client_drivers/kafka/index.rst index 524dc5243..ee8e3e98c 100644 --- a/connecting_to_sqream/client_drivers/kafka/index.rst +++ b/connecting_to_sqream/client_drivers/kafka/index.rst @@ -19,26 +19,15 @@ Installation and Configuration :local: :depth: 1 -Prerequisites +Before You Begin ---------------- - * JAVA 11 - * Network bandwidth should be not less than X Giga/Sec - -Supported Data Formats ----------------------- -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Data Format - - Specification - * - JSON - - - * - CSV - - - * - Avro - - +* You must have JAVA 11 installed +* Your network bandwidth must be at least X gigabits per second +* Supported data formats for streaming data are: + * JSON + * CSV + * Avro Kafka Producer -------------- @@ -125,8 +114,9 @@ SQream Consumer :local: :depth: 1 -The SQream Consumer converts data formatted as CSV and JSON into ``.tmp`` files and saves it in a predefined directory. -You must define the number of files to be converted before they are saved as a ``sqream.batchRecordCount`` file. Once reaching the defined number of files, the consumer saves the converted files and begins the process all over again. +The SQream Consumer reads Kafka topics and writes messages into text files in either CSV, JSON, or Avro format. The files are created with the extension ``.tmp`` and stored in the specified directory. The ``sqream.batchRecordCount`` parameter defines the number of records to be written to each file. When the specified number of records is reached, the SQream Consumer closes the file, renames it to the ``sqream.fileExtension``, and then creates a new file. + +SQream tables must be created according to the columns configured in ``csvorder``. SQream Consumer Installation ~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -139,7 +129,7 @@ pass = sqprj2021$ SQream Consumer Configuration ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -What needs to be configured: +The following parameters require configuration. .. list-table:: :widths: auto @@ -150,11 +140,11 @@ What needs to be configured: * - Topic - A category or feed name to which messages are published and subscribed to * - ``sqream.batchrecordcount`` - - Preferably configured according to an estimated number of messages + - The record count to be written to each file * - ``outputdir`` - Copy the ``sqream.outputdir`` path, from its beginning and until ``outputs``, included, and save it to a known location. It is required to configure SQream loader to use this section of the path * - ``csvorder`` - - Create table columns + - Defines table columns. SQream table columns must align with the ``csvorder`` table columns Connection string: @@ -186,7 +176,7 @@ Configuration file structure: sqream.outputType=csv sqream.csvOrder=receivedTime,equipmentId,asdf,timestamp,intv -SQream tables must be created according to the columns configured in ``csvorder``. + Running commands: @@ -215,7 +205,7 @@ pass = sqprj2021$ SQream Loader Configuration ~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Building SQream loader: +Building the SQream Loader: .. code-block:: postgres @@ -223,7 +213,7 @@ Building SQream loader: mvn clean package -Running SQream loader: +Running the SQream Loader: .. code-block:: postgres @@ -236,6 +226,7 @@ What needs to be configured: :widths: auto :header-rows: 1 + * - Parameter - Description * - ``root`` From 708d8da1c57a95c968c9397ff8122770a75225c7 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 10 Jan 2023 15:52:44 +0200 Subject: [PATCH 393/882] healer_max_statement_inactivity_seconds --- .../healer_max_inactivity_hours.rst | 14 -------------- .../healer_max_statement_inactivity_seconds.rst | 14 ++++++++++++++ feature_guides/query_healer.rst | 4 ++-- releases/2021.2.1.24.rst | 2 +- 4 files changed, 17 insertions(+), 17 deletions(-) delete mode 100644 configuration_guides/healer_max_inactivity_hours.rst create mode 100644 configuration_guides/healer_max_statement_inactivity_seconds.rst diff --git a/configuration_guides/healer_max_inactivity_hours.rst b/configuration_guides/healer_max_inactivity_hours.rst deleted file mode 100644 index 56ddb78fc..000000000 --- a/configuration_guides/healer_max_inactivity_hours.rst +++ /dev/null @@ -1,14 +0,0 @@ -.. _healer_max_inactivity_hours: - -************************* -Configuring the Query Healer -************************* -The ``healerMaxInactivityHours`` flag is used for defining the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU. - -The following describes the ``healerMaxInactivityHours`` flag: - -* **Data type** - size_t -* **Default value** - ``5`` -* **Allowed values** - 1-4000000000 - -For related flags, see :ref:`is_healer_on`. \ No newline at end of file diff --git a/configuration_guides/healer_max_statement_inactivity_seconds.rst b/configuration_guides/healer_max_statement_inactivity_seconds.rst new file mode 100644 index 000000000..0de4e68e6 --- /dev/null +++ b/configuration_guides/healer_max_statement_inactivity_seconds.rst @@ -0,0 +1,14 @@ +.. _healer_max_statement_inactivity_seconds: + +************************* +Configuring the Query Healer +************************* +The ``maxStatementInactivitySeconds`` flag is used for defining the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU. + +The following describes the ``maxStatementInactivitySeconds`` worker level flag: + +* **Data type** - size_t +* **Default value** - ``5`` +* **Allowed values** - 1-4000000000 + +For related flags, see :ref:`is_healer_on`. \ No newline at end of file diff --git a/feature_guides/query_healer.rst b/feature_guides/query_healer.rst index 305875447..4c87ec0a9 100644 --- a/feature_guides/query_healer.rst +++ b/feature_guides/query_healer.rst @@ -11,7 +11,7 @@ The **Query Healer** page describes the following: Overview ---------- -The **Query Healer** periodically examines the progress of running statements, creating a log entry for all statements exceeding the ``healerMaxInactivityHours`` flag setting. The default setting of the ``healerMaxInactivityHours`` is five hours. The ``healerMaxInactivityHours`` log frequency is calculated as 5% of the flag setting. When set to five hours (the default setting), the Query Healer triggers an examination every 15 minutes. +The **Query Healer** periodically examines the progress of running statements, creating a log entry for all statements exceeding the ``maxStatementInactivitySeconds`` worker level flag setting. The default setting of the ``maxStatementInactivitySeconds`` is five hours. The ``maxStatementInactivitySeconds`` log frequency is calculated as 5% of the flag setting. When set to five hours (the default setting), the Query Healer triggers an examination every 15 minutes. The following is an example of a log record for a query stuck in the query detection phase for more than five hours: @@ -55,4 +55,4 @@ The following **Administration Worker** flags are required to configure the Quer :: - * :ref:`healer_max_inactivity_hours` - Defines the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU. \ No newline at end of file + * :ref:`healer_max_statement_inactivity_seconds` - Defines the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU. \ No newline at end of file diff --git a/releases/2021.2.1.24.rst b/releases/2021.2.1.24.rst index d277ea51a..8b1992283 100644 --- a/releases/2021.2.1.24.rst +++ b/releases/2021.2.1.24.rst @@ -59,7 +59,7 @@ The following table lists the known issues for Version 2021.2.1.24: Operations and Configuration Changes -------- -The following configuration flags were added: +The following worker level configuration flags were added: * :ref:`is_healer_on` From 7dcd4f5e754089a105c848ba2028e193a44d0e32 Mon Sep 17 00:00:00 2001 From: TaliaSQream <taliar@sqreamtech.com> Date: Wed, 11 Jan 2023 09:31:08 +0200 Subject: [PATCH 394/882] Update 2021.2.1.24.rst --- releases/2021.2.1.24.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/2021.2.1.24.rst b/releases/2021.2.1.24.rst index 8b1992283..f1ab492dc 100644 --- a/releases/2021.2.1.24.rst +++ b/releases/2021.2.1.24.rst @@ -65,7 +65,7 @@ The following worker level configuration flags were added: :: - * :ref:`healer_max_inactivity_hours` + * :ref:`healer_max_statement_inactivity_seconds:` Naming Changes ------- From 51ecc5835ffe6a4f5a3c503fbb5b2b8531b73524 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 12 Jan 2023 11:06:11 +0200 Subject: [PATCH 395/882] Update spark.rst --- .../client_platforms/spark.rst | 135 +++--------------- 1 file changed, 19 insertions(+), 116 deletions(-) diff --git a/connecting_to_sqream/client_platforms/spark.rst b/connecting_to_sqream/client_platforms/spark.rst index 20472ceef..9b57063d6 100644 --- a/connecting_to_sqream/client_platforms/spark.rst +++ b/connecting_to_sqream/client_platforms/spark.rst @@ -18,7 +18,7 @@ To use Spark with SQream, you must have the following installed: * SQream version 2022.1.8 or later * Spark version 3.3.1 or later -* SQream Spark plugin xxxx +* SQream Spark plugin 1.0.0 * JDBC version 4.5.6 or later @@ -41,10 +41,25 @@ SQream Spark Plugin The SQream Spark plugin supports bi-directional data transfer between the Spark and the SQream cluster. -Connection Command and Parameters +How to use with Spark Shell ~~~~~~~~~~~~~~~~~~~~~ -**Missing connection command** +Plugin command: + +.. code-block:: postgres + + ./spark-shell --driver-class-path {driver path} --jars {Spark-Sqream-Connector.jar path} + + +Plugin command example: + +.. code-block:: postgres + + ./spark-shell --driver-class-path /home/sqream/sqream-jdbc-4.5.6.jar --jars Spark-Sqream-Connector-1.0.jar + + + +Spark options supported by SQream: .. list-table:: :widths: auto @@ -172,6 +187,7 @@ To read an entire table: df.write .format(SQREAM_SOURCE_NAME) .options(sfOptions) .option("<sqream_table_name>", "<table_name>") .mode(SaveMode.Overwrite) .save() + Supported Data Types and Mapping -------------------------------- @@ -238,47 +254,6 @@ Spark data types mapped to SQream Examples --------- - -Scala - -.. code-block:: postgres - - // Note: JDBC loading and saving can be achieved via either the load/save or jdbc methods - // Loading data from a JDBC source - val jdbcDF = spark.read - .format("jdbc") - .option("url", "jdbc:Sqream:dbserver") - .option("dbtable", "schema.tablename") - .option("user", "username") - .option("password", "password") - .load() - - val connectionProperties = new Properties() - connectionProperties.put("user", "username") - connectionProperties.put("password", "password") - val jdbcDF2 = spark.read - .jdbc("jdbc:Sqream:dbserver", "schema.tablename", connectionProperties) - // Specifying the custom data types of the read schema - connectionProperties.put("customSchema", "id DECIMAL(38, 0), name TEXT") - val jdbcDF3 = spark.read - .jdbc("jdbc:postgresql:dbserver", "schema.tablename", connectionProperties) - - // Saving data to a JDBC source - jdbcDF.write - .format("jdbc") - .option("url", "jdbc:Sqream:dbserver") - .option("dbtable", "schema.tablename") - .option("user", "username") - .option("password", "password") - .save() - - jdbcDF2.write - .jdbc("jdbc:Sqream:dbserver", "schema.tablename", connectionProperties) - - // Specifying create table column data types on write - jdbcDF.write - .option("createTableColumnTypes", "name TEXT, comments TEXT") - .jdbc("jdbc:Sqream:dbserver", "schema.tablename", connectionProperties) JAVA @@ -317,75 +292,3 @@ JAVA .option("createTableColumnTypes", "name TEXT, comments TEXT") .jdbc("jdbc:Sqream:dbserver", "schema.tablename", connectionProperties); -Python - -.. code-block:: postgres - - # Note: JDBC loading and saving can be achieved via either the load/save or jdbc methods - # Loading data from a JDBC source - jdbcDF = spark.read \ - .format("jdbc") \ - .option("url", "jdbc:Sqream:dbserver") \ - .option("dbtable", "schema.tablename") \ - .option("user", "username") \ - .option("password", "password") \ - .load() - - jdbcDF2 = spark.read \ - .jdbc("jdbc:Sqream:dbserver", "schema.tablename", - properties={"user": "username", "password": "password"}) - - # Specifying dataframe column data types on read - jdbcDF3 = spark.read \ - .format("jdbc") \ - .option("url", "jdbc:Sqream:dbserver") \ - .option("dbtable", "schema.tablename") \ - .option("user", "username") \ - .option("password", "password") \ - .option("customSchema", "id DECIMAL(38, 0), name TEXT") \ - .load() - - # Saving data to a JDBC source - jdbcDF.write \ - .format("jdbc") \ - .option("url", "jdbc:Sqream:dbserver") \ - .option("dbtable", "schema.tablename") \ - .option("user", "username") \ - .option("password", "password") \ - .save() - - jdbcDF2.write \ - .jdbc("jdbc:Sqream:dbserver", "schema.tablename", - properties={"user": "username", "password": "password"}) - - # Specifying create table column data types on write - jdbcDF.write \ - .option("createTableColumnTypes", "name TEXT, comments TEXT") \ - .jdbc("jdbc:Sqream:dbserver", "schema.tablename", - properties={"user": "username", "password": "password"}) - -R - -.. code-block:: postgres - - # Loading data from a JDBC source - df <- read.jdbc("jdbc:Sqream:dbserver", "schema.tablename", user = "username", password = "password") - - # Saving data to a JDBC source - write.jdbc(df, "jdbc:Sqream:dbserver", "schema.tablename", user = "username", password = "password") - -SQL - -.. code-block:: postgres - - CREATE TEMPORARY VIEW jdbcTable - USING org.apache.spark.sql.jdbc - OPTIONS ( - url "jdbc:Sqream:dbserver", - dbtable "schema.tablename", - user 'username', - password 'password' - ) - - INSERT INTO TABLE jdbcTable - SELECT * FROM resultTable \ No newline at end of file From 5136a9a09c51341f9cdc5e1d858ff570fcdf6dae Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 12 Jan 2023 11:34:06 +0200 Subject: [PATCH 396/882] Update current_method_configuration_levels.rst --- configuration_guides/current_method_configuration_levels.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/configuration_guides/current_method_configuration_levels.rst b/configuration_guides/current_method_configuration_levels.rst index a6d9b91aa..cb55893b3 100644 --- a/configuration_guides/current_method_configuration_levels.rst +++ b/configuration_guides/current_method_configuration_levels.rst @@ -19,7 +19,7 @@ Worker-Based Configuration -------------- Worker-based configuration lets you modify individual workers using a worker configuration file. Worker-based configuration modifications are persistent. -For more information on making configurations from the worker configuration file, see `Modifying Your Configuration Using a Legacy Configuration File <https://docs.sqream.com/en/latest/configuration_guides/current_configuration_method.html#modifying-your-configuration-using-a-legacy-configuration-file>`_. +For more information on making configurations from the worker configuration file, see :ref:`current_method_modification_methods`. Session-Based Configuration -------------- From 197b770eeba0f6f841d85b4428b93e4ea8b5f253 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 12 Jan 2023 16:08:35 +0200 Subject: [PATCH 397/882] Update spark.rst --- .../client_platforms/spark.rst | 37 ++++++++++--------- 1 file changed, 19 insertions(+), 18 deletions(-) diff --git a/connecting_to_sqream/client_platforms/spark.rst b/connecting_to_sqream/client_platforms/spark.rst index 9b57063d6..823fa5728 100644 --- a/connecting_to_sqream/client_platforms/spark.rst +++ b/connecting_to_sqream/client_platforms/spark.rst @@ -12,17 +12,6 @@ If you are using Spark for distributed processing and analysis and wish to use i :local: :depth: 1 -Prerequisites -------------- -To use Spark with SQream, you must have the following installed: - -* SQream version 2022.1.8 or later -* Spark version 3.3.1 or later -* SQream Spark plugin 1.0.0 -* JDBC version 4.5.6 or later - - - Installation and Configuration ------------------------------ @@ -30,36 +19,48 @@ Installation and Configuration :local: :depth: 1 +Before You Begin +~~~~~~~~~~~~~~~~ + +To use Spark with SQream, you must have the following installed: + +* SQream version 2022.1.8 or later +* Spark version 3.3.1 or later +* SQream Spark Connector 1.0.0 +* JDBC version 4.5.6 or later + JDBC ~~~~ If JDBC is not yet configured, follow the `JDBC Client Drivers page <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/jdbc/index.html>`_ for registration and configuration guidance. -SQream Spark Plugin +SQream-Spark Connector ~~~~~~~~~~~~~~~~~~~ -The SQream Spark plugin supports bi-directional data transfer between the Spark and the SQream cluster. +The SQream-Spark Connector enables inserting DataFrames into SQream tables and export tables or queries as DataFrames for use with Spark. DataFrames are Spark objects used for transferring data from one data source to another. -How to use with Spark Shell -~~~~~~~~~~~~~~~~~~~~~ -Plugin command: +The SQream-Spark Connector command for Spark Shell: .. code-block:: postgres ./spark-shell --driver-class-path {driver path} --jars {Spark-Sqream-Connector.jar path} -Plugin command example: +An example for the SQream-Spark Connector command: .. code-block:: postgres ./spark-shell --driver-class-path /home/sqream/sqream-jdbc-4.5.6.jar --jars Spark-Sqream-Connector-1.0.jar +Connector Configuration +~~~~~~~~~~~~~~~~~~~~~~~ + +The Spark JDBC connection properties allow users to configure connections between Spark and databases. These properties enable database access, query execution, and result retrieval, as well as authentication, encryption, and connection pooling. -Spark options supported by SQream: +The following Spark connection properties are supported by SQream: .. list-table:: :widths: auto From 54e49546b3ab7ef7c020d0a19ab48c575843d0f0 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 12 Jan 2023 16:20:53 +0200 Subject: [PATCH 398/882] Update copy_to.rst --- reference/sql/sql_statements/dml_commands/copy_to.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/copy_to.rst b/reference/sql/sql_statements/dml_commands/copy_to.rst index b0610efcd..167f70c23 100644 --- a/reference/sql/sql_statements/dml_commands/copy_to.rst +++ b/reference/sql/sql_statements/dml_commands/copy_to.rst @@ -65,7 +65,6 @@ The following is the correct syntax for using the **COPY TO** statement: AWS Secret ::= string -.. note:: The DELIMITER is applicable to the CSV format only. .. note:: In Studio, you must write the parameters using lower case letters. Using upper case letters generates an error. @@ -90,7 +89,7 @@ The following table shows the ``COPY_TO`` elements: * - ``HEADER`` - The CSV file will contain a header line with the names of each column in the file. This option is allowed only when using CSV format. * - ``DELIMITER`` - - Specifies the character or string that separates fields (columns) within each row of the file. The default is a comma character (``,``). + - Specifies the character or string that separates fields (columns) within each row of the file. The default is a comma character (``,``). This option is allowed only when using CSV format. * - ``RECORD_DELIMITER`` - Specifies the character or string that separates records in a data set. This option is allowed only when using CSV format. * - ``AWS_ID``, ``AWS_SECRET`` From 0f8c16f272ba024a0eb71150e0a3df35028b2b89 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 15 Jan 2023 12:09:46 +0200 Subject: [PATCH 399/882] Update creating_assigning_and_managing_roles_and_permissions.rst --- ...ing_and_managing_roles_and_permissions.rst | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/sqream_studio_5.4.7/creating_assigning_and_managing_roles_and_permissions.rst b/sqream_studio_5.4.7/creating_assigning_and_managing_roles_and_permissions.rst index 31ff716cb..648117ca7 100644 --- a/sqream_studio_5.4.7/creating_assigning_and_managing_roles_and_permissions.rst +++ b/sqream_studio_5.4.7/creating_assigning_and_managing_roles_and_permissions.rst @@ -63,11 +63,11 @@ An admin creates a **user** by granting login permissions and a password to a ro Clicking **New Role** lets you do the following: * Add and assign a role name (required) - * Enable or disable log-in permissions for the role. - * Set a password. - * Assign or delete parent roles. - * Add or delete permissions. - * Grant the selected user with superuser permissions. + * Enable or disable log-in permissions for the role + * Set a password + * Assign or delete parent roles + * Add or delete permissions + * Grant the selected user with superuser permissions From the New Role panel you view directly and indirectly (or inherited) granted permissions. Disabled permissions have no connect permissions for the referenced database and are displayed in gray text. You can add or remove permissions from the **Add permissions** field. From the New Role panel you can also search and scroll through the permissions. In the **Search** field you can use the **and** operator to search for strings that fulfill multiple criteria. @@ -79,13 +79,13 @@ Editing a Role -------------------- Once you've created a role, clicking the **Edit Role** button lets you do the following: - * Edit the role name. - * Enable or disable log-in permissions. - * Set a password. - * Assign or delete parent roles. - * Assign a role **administrator** permissions. - * Add or delete permissions. - * Grant the selected user with superuser permissions. + * Edit role name + * Enable or disable log-in permissions + * Set a password + * Assign or delete parent roles + * Assign a role **administrator** permissions + * Add or delete permissions + * Grant the selected user with superuser permissions From the Edit Role panel you view directly and indirectly (or inherited) granted permissions. Disabled permissions have no connect permissions for the referenced database and are displayed in gray text. You can add or remove permissions from the **Add permissions** field. From the Edit Role panel you can also search and scroll through the permissions. In the **Search** field you can use the **and** operator to search for strings that fulfill multiple criteria. From 2f66a5f3b4d7a0c5f5a2b7a1072a3709e6009c03 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 15 Jan 2023 12:42:08 +0200 Subject: [PATCH 400/882] block_new_varchar_objects --- configuration_guides/admin_regular_flags.rst | 2 +- configuration_guides/block_new_varchar_objects.rst | 12 ++++++++++++ .../current_method_all_configurations.rst | 6 +++--- configuration_guides/varchar_identifiers.rst | 12 ------------ 4 files changed, 16 insertions(+), 16 deletions(-) create mode 100644 configuration_guides/block_new_varchar_objects.rst delete mode 100644 configuration_guides/varchar_identifiers.rst diff --git a/configuration_guides/admin_regular_flags.rst b/configuration_guides/admin_regular_flags.rst index 902ff224b..a9b0681bd 100644 --- a/configuration_guides/admin_regular_flags.rst +++ b/configuration_guides/admin_regular_flags.rst @@ -28,5 +28,5 @@ The **Regular Administration Flags** page describes **Regular** modification typ * `Setting Implicit Casts in ORC Files <https://docs.sqream.com/en/v2022.1.1/configuration_guides/orc_implicit_casts.html>`_ * `Setting Timeout Limit for Locking Objects before Executing Statements <https://docs.sqream.com/en/v2022.1.1/configuration_guides/statement_lock_timeout.html>`_ * `Interpreting Decimal Literals as Double Instead of Numeric <https://docs.sqream.com/en/v2022.1.1/configuration_guides/use_legacy_decimal_literals.html>`_ -* `Interpreting VARCHAR as TEXT <https://docs.sqream.com/en/v2022.1.1/configuration_guides/use_legacy_string_literals.html>`_ +* :ref:`Blocking New VARCHAR Objects<block_new_varchar_objects>` * `VARCHAR Identifiers <https://docs.sqream.com/en/v2022.1.1/configuration_guides/varchar_identifiers.html>`_ diff --git a/configuration_guides/block_new_varchar_objects.rst b/configuration_guides/block_new_varchar_objects.rst new file mode 100644 index 000000000..a64ff7995 --- /dev/null +++ b/configuration_guides/block_new_varchar_objects.rst @@ -0,0 +1,12 @@ +.. _block_new_varchar_objects: + +************************* +Blocking New VARCHAR Objects +************************* +The ``blockNewVarcharObjects`` flag disables the creation of new tables, views, external tables containing Varchar columns, and the creation of user-defined functions with Varchar arguments or a Varchar return value. + +The following describes the ``blockNewVarcharObjects`` flag: + +* **Data type** - boolean +* **Default value** - ``false`` +* **Allowed values** - ``true``, ``false`` \ No newline at end of file diff --git a/configuration_guides/current_method_all_configurations.rst b/configuration_guides/current_method_all_configurations.rst index 7385066af..9a2352faf 100644 --- a/configuration_guides/current_method_all_configurations.rst +++ b/configuration_guides/current_method_all_configurations.rst @@ -423,9 +423,9 @@ The following table describes all **Generic** and **Administration** configurati - * - ``varcharIdentifiers`` + * - ``blockNewVarcharObjects`` - Admin - Regular - - Activates using varchar as an identifier. + - Disables the creation of new tables, views, external tables containing Varchar columns, and the creation of user-defined functions with Varchar arguments or a Varchar return value. - boolean - - ``true`` \ No newline at end of file + - ``FALSE`` \ No newline at end of file diff --git a/configuration_guides/varchar_identifiers.rst b/configuration_guides/varchar_identifiers.rst deleted file mode 100644 index 889e5c16e..000000000 --- a/configuration_guides/varchar_identifiers.rst +++ /dev/null @@ -1,12 +0,0 @@ -.. _varchar_identifiers: - -************************* -Interpreting VARCHAR as TEXT -************************* -The ``varcharIdentifiers`` flag activates using **varchar** as an identifier. - -The following describes the ``varcharIdentifiers`` flag: - -* **Data type** - boolean -* **Default value** - ``true`` -* **Allowed values** - ``true``, ``false`` \ No newline at end of file From 217e7d8c788b092200bd6601673112c1fe1e3aee Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 15 Jan 2023 13:20:22 +0200 Subject: [PATCH 401/882] Update admin_regular_flags.rst --- configuration_guides/admin_regular_flags.rst | 48 ++++++++++---------- 1 file changed, 24 insertions(+), 24 deletions(-) diff --git a/configuration_guides/admin_regular_flags.rst b/configuration_guides/admin_regular_flags.rst index a9b0681bd..fd7131692 100644 --- a/configuration_guides/admin_regular_flags.rst +++ b/configuration_guides/admin_regular_flags.rst @@ -5,28 +5,28 @@ Regular Administration Flags ************************* The **Regular Administration Flags** page describes **Regular** modification type flags, which can be modified by administrators on a session and cluster basis using the ``ALTER SYSTEM SET`` command: -* `Setting Bin Size <https://docs.sqream.com/en/v2022.1.1/configuration_guides/bin_sizes.html>`_ -* `Setting CUDA Memory <https://docs.sqream.com/en/v2022.1.1/configuration_guides/check_cuda_memory.html>`_ -* `Limiting Runtime to Utility Functions <https://docs.sqream.com/en/v2022.1.1/configuration_guides/compiler_gets_only_ufs.html>`_ -* `Enabling High Bin Control Granularity <https://docs.sqream.com/en/v2022.1.1/configuration_guides/copy_to_restrict_utf8.html>`_ -* `Reducing CPU Hashtable Sizes <https://docs.sqream.com/en/v2022.1.1/configuration_guides/cpu_reduce_hashtable_size.html>`_ -* `Setting Chunk Size for Copying from CPU to GPU <https://docs.sqream.com/en/v2022.1.1/configuration_guides/cuda_mem_cpy_max_size_bytes.html>`_ -* `Indicating GPU Synchronicity <https://docs.sqream.com/en/v2022.1.1/configuration_guides/cuda_mem_cpy_synchronous.html>`_ -* `Setting the Graceful Server Shutdown <https://docs.sqream.com/en/v2022.1.1/configuration_guides/graceful_shutdown.html>`_ -* `Enabling Modification of R&D Flags <https://docs.sqream.com/en/v2022.1.1/configuration_guides/developer_mode.html>`_ -* `Checking for Post-Production CUDA Errors <https://docs.sqream.com/en/v2022.1.1/configuration_guides/enable_device_debug_messages.html>`_ -* `Enabling Modification of clientLogger_debug File <https://docs.sqream.com/en/v2022.1.1/configuration_guides/enable_log_debug.html>`_ -* `Activating the NVidia Profiler Markers <https://docs.sqream.com/en/v2022.1.1/configuration_guides/enable_nv_prof_markers.html>`_ -* `Appending String at End of Log Lines <https://docs.sqream.com/en/v2022.1.1/configuration_guides/end_log_message.html>`_ -* `Monitoring and Printing Pinned Allocation Reports <https://docs.sqream.com/en/v2022.1.1/configuration_guides/gather_mem_stat.html>`_ -* `Increasing Chunk Size to Reduce Query Speed <https://docs.sqream.com/en/v2022.1.1/configuration_guides/increase_chunk_size_before_reduce.html>`_ -* `Adding Rechunker before Expensing Chunk Producer <https://docs.sqream.com/en/v2022.1.1/configuration_guides/increase_mem_factors.html>`_ -* `Setting the Buffer Size <https://docs.sqream.com/en/v2022.1.1/configuration_guides/level_db_write_buffer_size.html>`_ -* `Setting Memory Used to Abort Server <https://docs.sqream.com/en/v2022.1.1/configuration_guides/memory_reset_trigger_mb.html>`_ -* `Splitting Large Reads for Concurrent Execution <https://docs.sqream.com/en/v2022.1.1/configuration_guides/mt_read.html>`_ -* `Setting Worker Amount to Handle Concurrent Reads <https://docs.sqream.com/en/v2022.1.1/configuration_guides/mt_read_workers.html>`_ -* `Setting Implicit Casts in ORC Files <https://docs.sqream.com/en/v2022.1.1/configuration_guides/orc_implicit_casts.html>`_ -* `Setting Timeout Limit for Locking Objects before Executing Statements <https://docs.sqream.com/en/v2022.1.1/configuration_guides/statement_lock_timeout.html>`_ -* `Interpreting Decimal Literals as Double Instead of Numeric <https://docs.sqream.com/en/v2022.1.1/configuration_guides/use_legacy_decimal_literals.html>`_ +* :ref:`Setting Bin Size<bin_sizes>` +* :ref:`Setting CUDA Memory<check_cuda_memory>` +* :ref:`Limiting Runtime to Utility Functions<compiler_gets_only_ufs>` +* :ref:`Enabling High Bin Control Granularity<copy_to_restrict_utf8>` +* :ref:`Reducing CPU Hashtable Sizes<cpu_reduce_hashtable_size>` +* :ref:`Setting Chunk Size for Copying from CPU to GPU<cuda_mem_cpy_max_size_bytes>` +* :ref:`Indicating GPU Synchronicity<cuda_mem_cpy_synchronous>` +* :ref:`Setting the Graceful Server Shutdown<graceful_shutdown>` +* :ref:`Enabling Modification of R&D Flags<developer_mode>` +* :ref:`Checking for Post-Production CUDA Errors<enable_device_debug_messages>` +* :ref:`Enabling Modification of clientLogger_debug File<enable_log_debug>` +* :ref:`Activating the NVidia Profiler Markers<enable_nv_prof_markers>` +* :ref:`Appending String at End of Log Lines<end_log_message>` +* :ref:`Monitoring and Printing Pinned Allocation Reports<gather_mem_stat>` +* :ref:`Increasing Chunk Size to Reduce Query Speed<increase_chunk_size_before_reduce>` +* :ref:`Adding Rechunker before Expensing Chunk Producer<increase_mem_factors>` +* :ref:`Setting the Buffer Size<level_db_write_buffer_size>` +* :ref:`Setting Memory Used to Abort Server<memory_reset_trigger_mb>` +* :ref:`Splitting Large Reads for Concurrent Execution<mt_read>` +* :ref:`Setting Worker Amount to Handle Concurrent Reads<mt_read_workers>` +* :ref:`Setting Implicit Casts in ORC Files<orc_implicit_casts>` +* :ref:`Setting Timeout Limit for Locking Objects before Executing Statements<statement_lock_timeout>` +* :ref:`Interpreting Decimal Literals as Double Instead of Numeric<use_legacy_decimal_literals>` +* :ref:`Using Legacy String Literals<use_legacy_string_literals>` * :ref:`Blocking New VARCHAR Objects<block_new_varchar_objects>` -* `VARCHAR Identifiers <https://docs.sqream.com/en/v2022.1.1/configuration_guides/varchar_identifiers.html>`_ From 38c40f0d43e3c21fb65449b0998bbb258cff017b Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 15 Jan 2023 13:32:46 +0200 Subject: [PATCH 402/882] Update create_table.rst --- reference/sql/sql_statements/ddl_commands/create_table.rst | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/reference/sql/sql_statements/ddl_commands/create_table.rst b/reference/sql/sql_statements/ddl_commands/create_table.rst index 3f9e9d578..5ca988f19 100644 --- a/reference/sql/sql_statements/ddl_commands/create_table.rst +++ b/reference/sql/sql_statements/ddl_commands/create_table.rst @@ -175,10 +175,7 @@ The following is an example of the syntax used to create a table with an identit country TEXT(30) DEFAULT 'Unknown' NOT NULL ); -.. note:: - * Identity columns are supported on ``BIGINT`` columns. - - * Identity does not enforce the uniqueness of values. The identity value can be bypassed by specifying it in an :ref:`insert` command. +.. note:: Identity does not enforce the uniqueness of values. The identity value can be bypassed by specifying it in an :ref:`insert` command. Creating a Table from a SELECT Query ----------------------------------------- From b7e2874df711b871058ed78ef6bd273bcda376dd Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 15 Jan 2023 14:21:46 +0200 Subject: [PATCH 403/882] CEIL --- configuration_guides/current_method_flag_types.rst | 2 +- .../sql/sql_functions/scalar_functions/numeric/ceiling.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/configuration_guides/current_method_flag_types.rst b/configuration_guides/current_method_flag_types.rst index 7908e65d0..93e82e79b 100644 --- a/configuration_guides/current_method_flag_types.rst +++ b/configuration_guides/current_method_flag_types.rst @@ -13,7 +13,7 @@ The lowest level is Regular, which means that modifying values of Regular flags To see each flag's default value, see one of the following: -* The **Default Value** column in the :ref:`All Configurations<all_configurations>` section. +* The **Default Value** column in the :ref:`All Configurations<current_method_all_configurations>` section. :: diff --git a/reference/sql/sql_functions/scalar_functions/numeric/ceiling.rst b/reference/sql/sql_functions/scalar_functions/numeric/ceiling.rst index 39a63ddab..314c33c02 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/ceiling.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/ceiling.rst @@ -32,7 +32,7 @@ Arguments Returns ============ -``CEIL`` always returns a ``double`` floating point number. +``CEILING`` and ``CEIL`` always return a ``double`` floating point number. Notes From 5e0e968d9b6f9193468410fd41ab75201f7e8956 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 15 Jan 2023 15:34:18 +0200 Subject: [PATCH 404/882] Update char_length.rst --- .../sql_functions/scalar_functions/string/char_length.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/string/char_length.rst b/reference/sql/sql_functions/scalar_functions/string/char_length.rst index 47d517975..79bbdcdbc 100644 --- a/reference/sql/sql_functions/scalar_functions/string/char_length.rst +++ b/reference/sql/sql_functions/scalar_functions/string/char_length.rst @@ -1,7 +1,7 @@ .. _char_length: ************************** -CHAR_LENGTH +CHARACTER_LENGTH / CHAR_LENGTH ************************** Calculates the number of characters in a string. @@ -16,6 +16,7 @@ Syntax .. code-block:: postgres CHAR_LEN( text_expr ) --> INT + CHARACTER_LEN( text_expr ) --> INT Arguments ============ @@ -32,7 +33,7 @@ Arguments Returns ============ -Returns an integer containing the number of characters in the string. +Return an integer containing the number of characters in the string. Notes ======= @@ -59,7 +60,7 @@ Length in characters and bytes of strings ASCII characters take up 1 byte per character, while Thai takes up 3 bytes and Hebrew takes up 2 bytes. -Unlike :ref:`len`, ``CHAR_LENGTH`` preserves the trailing whitespaces. +Unlike :ref:`len`, ``CHARACTER_LENGTH`` and ``CHAR_LENGTH`` preserve the trailing white spaces. .. code-block:: psql From f6a981f95573c5205d9100aae56ee82d7b275b28 Mon Sep 17 00:00:00 2001 From: TaliaSQream <taliar@sqreamtech.com> Date: Mon, 16 Jan 2023 13:31:56 +0200 Subject: [PATCH 405/882] Update spark.rst --- .../client_platforms/spark.rst | 19 ++++++++----------- 1 file changed, 8 insertions(+), 11 deletions(-) diff --git a/connecting_to_sqream/client_platforms/spark.rst b/connecting_to_sqream/client_platforms/spark.rst index 823fa5728..6e972a830 100644 --- a/connecting_to_sqream/client_platforms/spark.rst +++ b/connecting_to_sqream/client_platforms/spark.rst @@ -32,23 +32,22 @@ To use Spark with SQream, you must have the following installed: JDBC ~~~~ -If JDBC is not yet configured, follow the `JDBC Client Drivers page <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/jdbc/index.html>`_ for registration and configuration guidance. +If JDBC is not yet configured, follow the `JDBC Client Drivers page <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/jdbc/index.html>`_ for guidance in registring and configuring. -SQream-Spark Connector +Connecting Spark to SQream ~~~~~~~~~~~~~~~~~~~ -The SQream-Spark Connector enables inserting DataFrames into SQream tables and export tables or queries as DataFrames for use with Spark. DataFrames are Spark objects used for transferring data from one data source to another. +The SQream-Spark Connector enables inserting DataFrames into SQream tables and exporting tables or queries as DataFrames for use with Spark. DataFrames are Spark objects used for transferring data from one data source to another. - -The SQream-Spark Connector command for Spark Shell: +1. In the Spark Shell, run: .. code-block:: postgres ./spark-shell --driver-class-path {driver path} --jars {Spark-Sqream-Connector.jar path} -An example for the SQream-Spark Connector command: +Example: .. code-block:: postgres @@ -72,16 +71,14 @@ The following Spark connection properties are supported by SQream: - Description * - ``url`` - - - The JDBC URL of the form ``jdbc:subprotocol:subname`` to connect to. The source-specific connection properties may be specified in the URL. e.g., ``jdbc:Sqream://localhost/test?user=fred&password=secret``. - * - ``dbtable`` - - - The JDBC table that should be read from or written into. Note that when using it in the read path anything that is valid in a ``FROM`` clause of a SQL query can be used. For example, instead of a full table you could also use a subquery in parentheses. It is not allowed to specify ``dbtable`` and ``query`` options at the same time. + The JDBC URL ``jdbc:subprotocol:subname`` establishes the connection between SQream and Spark. Source-specific connection properties may be specified in the URL, such as ``user`` and ``password``, e.g. ``jdbc:Sqream://localhost/test?user=fred&password=secret``. * - ``dbtable`` - - - The JDBC table that should be read from or written into. Note that when using it in the read path anything that is valid in a ``FROM`` clause of a SQL query can be used. For example, instead of a full table you could also use a subquery in parentheses. It is not allowed to specify ``dbtable`` and ``query`` options at the same time. + - A JDBC table to read from or write to. When reading from a ``dbtable``, anything that is valid in an SQL ``FROM`` clause may be used. For example, you may use a subquery in parentheses instead of querying a full table. It is not allowed to specify ``dbtable`` and ``query`` options at the same time. * - ``query`` - - - A query that will be used to read data into Spark. The specified query will be parenthesized and used as a subquery in the ``FROM`` clause. Spark will also assign an alias to the subquery clause. As an example, spark will issue a query of the following form to the JDBC Source. ``SELECT <columns> FROM (<user_specified_query>) spark_gen_alias``. Restrictions while using this option: 1. It is not allowed to specify ``dbtable`` and ``query`` options at the same time. 2. It is not allowed to specify ``query`` and ``partitionColumn`` options at the same time. When specifying ``partitionColumn`` option is required, the subquery can be specified using ``dbtable`` option instead and partition columns can be qualified using the subquery alias provided as part of ``dbtable``. Example: ``spark.read.format("jdbc").option("url", jdbcUrl).option("query", "select c1, c2 from t1").load()`` + - The ``query`` property in Spark is used to read data into the program by specifying a query. This query is used as a subquery in the ``FROM`` clause and Spark will assign an alias to the subquery. For example, when using a JDBC Source, Spark will issue a query in the format of ``SELECT <columns> FROM (<user_specified_query>) spark_gen_alias``. It's important to note that it is not allowed to use both the ``dbtable`` and ``query`` options at the same time, and the ``query`` option cannot be used with the ``partitionColumn`` option. If the ``partitionColumn`` option is needed, it must be specified using the ``dbtable`` option and qualified using the subquery alias provided in ``dbtable``. An example of how to use this option would be: spark.read.format("jdbc").option("url", jdbcUrl).option("query", "select c1, c2 from t1").load() * - ``driver`` - - The class name of the JDBC driver to use to connect to this URL. From c10da56b17451a8f1d6312caf6b2e760ee7ef08b Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 17 Jan 2023 14:57:14 +0200 Subject: [PATCH 406/882] flags --- configuration_guides/current_method_configuration_levels.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/configuration_guides/current_method_configuration_levels.rst b/configuration_guides/current_method_configuration_levels.rst index cb55893b3..ad5143def 100644 --- a/configuration_guides/current_method_configuration_levels.rst +++ b/configuration_guides/current_method_configuration_levels.rst @@ -19,7 +19,7 @@ Worker-Based Configuration -------------- Worker-based configuration lets you modify individual workers using a worker configuration file. Worker-based configuration modifications are persistent. -For more information on making configurations from the worker configuration file, see :ref:`current_method_modification_methods`. +For more information on making configurations from the worker configuration file, see :ref:`previous_configuration_method`. Session-Based Configuration -------------- From 68761dca9011cc2e37cfc9ac6de4bf851bb2a35f Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 17 Jan 2023 15:42:36 +0200 Subject: [PATCH 407/882] Update spark.rst --- .../client_platforms/spark.rst | 64 +++++++++---------- 1 file changed, 30 insertions(+), 34 deletions(-) diff --git a/connecting_to_sqream/client_platforms/spark.rst b/connecting_to_sqream/client_platforms/spark.rst index 6e972a830..f10191b70 100644 --- a/connecting_to_sqream/client_platforms/spark.rst +++ b/connecting_to_sqream/client_platforms/spark.rst @@ -71,8 +71,7 @@ The following Spark connection properties are supported by SQream: - Description * - ``url`` - - - - The JDBC URL ``jdbc:subprotocol:subname`` establishes the connection between SQream and Spark. Source-specific connection properties may be specified in the URL, such as ``user`` and ``password``, e.g. ``jdbc:Sqream://localhost/test?user=fred&password=secret``. + - The JDBC URL ``jdbc:subprotocol:subname`` establishes the connection between SQream and Spark. Source-specific connection properties may be specified in the URL, such as ``user`` and ``password``, e.g. ``jdbc:Sqream://localhost/test?user=fred&password=secret``. * - ``dbtable`` - - A JDBC table to read from or write to. When reading from a ``dbtable``, anything that is valid in an SQL ``FROM`` clause may be used. For example, you may use a subquery in parentheses instead of querying a full table. It is not allowed to specify ``dbtable`` and ``query`` options at the same time. @@ -257,36 +256,33 @@ JAVA .. code-block:: postgres - // Note: JDBC loading and saving can be achieved via either the load/save or jdbc methods - // Loading data from a JDBC source - Dataset<Row> jdbcDF = spark.read() - .format("jdbc") - .option("url", "jdbc:Sqream:dbserver") - .option("dbtable", "schema.tablename") - .option("user", "username") - .option("password", "password") - .load(); - - Properties connectionProperties = new Properties(); - connectionProperties.put("user", "username"); - connectionProperties.put("password", "password"); - Dataset<Row> jdbcDF2 = spark.read() - .jdbc("jdbc:Sqream:dbserver", "schema.tablename", connectionProperties); - - // Saving data to a JDBC source - jdbcDF.write() - .format("jdbc") - .option("url", "jdbc:Sqream:dbserver") - .option("dbtable", "schema.tablename") - .option("user", "username") - .option("password", "password") - .save(); - - jdbcDF2.write() - .jdbc("jdbc:Sqream:dbserver", "schema.tablename", connectionProperties); - - // Specifying create table column data types on write - jdbcDF.write() - .option("createTableColumnTypes", "name TEXT, comments TEXT") - .jdbc("jdbc:Sqream:dbserver", "schema.tablename", connectionProperties); + import com.sqream.driver.SqreamSession; + import org.apache.spark.sql.Dataset; + import org.apache.spark.sql.Row; + + import java.util.HashMap; + + public class main { + public static void main(String[] args) { + HashMap<String, String> config = new HashMap<>(); + //spark configuration + //optional configuration here: https://spark.apache.org/docs/latest/configuration.html + config.put("spark.master", "local"); + SqreamSession sqreamSession = SqreamSession.getSession(config); + + //spark properties + //optional properties here: https://spark.apache.org/docs/latest/sql-data-sources-jdbc.html + HashMap<String, String> props = new HashMap<>(); + + props.put("url", "jdbc:Sqream://192.168.4.51:5000/master;user=sqream;password=sqream;cluster=false;logfile=logsFiles.txt;loggerlevel=DEBUG"); + props.put("dbtable", "test"); + + /*Read from sqream table*/ + Dataset<Row> dataFrame = sqreamSession.read(props); + + /*Added to sqream table*/ + sqreamSession.write(dataFrame, props); + + } + } From fe5e9c2281fb33f9497e0194fe7a1b6459b9ebfe Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 19 Jan 2023 16:21:28 +0200 Subject: [PATCH 408/882] Update ldap.rst --- configuration_guides/ldap.rst | 248 +++++++++++++++++++++++++++++++--- 1 file changed, 230 insertions(+), 18 deletions(-) diff --git a/configuration_guides/ldap.rst b/configuration_guides/ldap.rst index 56332eea1..657a5c6cd 100644 --- a/configuration_guides/ldap.rst +++ b/configuration_guides/ldap.rst @@ -5,7 +5,7 @@ Configuring LDAP authentication ************************************* -Lightweight Directory Access Protocol (LDAP) is an authentication management service widely use with Microsoft Active Directory. Once it has been configured to authenticate SQream roles, all existing and newly added roles will be required to be authenticated by an LDAP server, with the exception of the initial system deployment ``sqream`` role, which is granted full control permissions upon deployment. +Lightweight Directory Access Protocol (LDAP) is an authentication management service widely used with Microsoft Active Directory. Once it has been configured to authenticate SQream roles, all existing and newly added roles will be required to be authenticated by an LDAP server, with the exception of the initial system deployment ``sqream`` role, which is granted full control permissions upon deployment. Prior to integrating SQream with LDAP, two preconditions must be considered: @@ -15,11 +15,22 @@ Prior to integrating SQream with LDAP, two preconditions must be considered: .. contents:: In this topic: :local: +Before You Begin +================ + +Enable self-signed certificates for OpenLDAP by adding the following line to the ``ldap.conf`` configuration file: + +.. code-block:: postgres + + ``TLS_REQCERT allow`` + Configuring SQream roles ======================== +Follow this procedure if you already have LDAP configured for your environment. + **Procedure** 1. Create a new role: @@ -40,16 +51,39 @@ Configuring SQream roles GRANT CONNECT ON DATABASE <my_database> TO <new_role>; - -You may also wish to :ref:`rename SQream roles<rename_role>`. +You may also wish to :ref:`rename SQream roles<rename_role>` so that they are consistent with existing LDAP user names. Configuring LDAP Authentication =============================== +.. contents:: In this topic: + :local: + +Configuration Methods +--------------------- + +To configure LDAP authentication for SQream, you may choose one of the following configuration methods: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Method + - Description + * - Basic method + - Use a given username in attempt to bind it to a distinguished name. To simplify usage, the ``ldapPrefix`` and ``ldapSuffix`` flags are used to construct a distinguished name built by ``ldapPrefix``, ``username``, or ``ldapSuffix``. + * - Advanced method + - Bind to the LDAP directory using a fixed username and password, which are set in the flags ``ldapBindDn`` and ``ldapBindDnPassword``. In the case that ``ldapBindDn`` and ``ldapBindDnPassword`` are not set, an anonymous bind will be attempted to the directory. A search will be preformed over the subtree set by ``ldapBaseDn``, by searching for an exact match of the given username in the attribute set in the ``ldapSearchAttribute`` flag. Only a single match is allowed in the search result. Once the user has been found in the search, the server disconnects and re-binds to the directory as this user, using the password specified by the client. Follow this procedure if you are configuring LDAP authentication for SQream. + + + +Basic Method +------------ + Flag Attributes ---------------- -To enable LDAP Authentication, configure the following **cluster** flag attributes using the ``ALERT SYSTEM SET`` command: +~~~~~~~~~~~~~~~ +To enable LDAP Authentication, configure the following **Cluster** flag attributes using the ``ALTER SYSTEM SET`` command: .. list-table:: :widths: auto @@ -59,47 +93,225 @@ To enable LDAP Authentication, configure the following **cluster** flag attribut - Description * - ``authenticationMethod`` - Configure an authentication method. Attribute may be set to either ``sqream`` or ``ldap``. To configure LDAP authentication, choose ``ldap``. - * - ``ldapDomain`` - - Configure users` domain. * - ``ldapIpAddress`` - Configure the IP address or the Fully Qualified Domain Name (FQDN) of your LDAP server and select a protocol. Out of the ``ldap`` and ``ldaps``, we recommend to use the encrypted ``ldaps`` protocol. * - ``ldapConnTimeoutSec`` - Configure the LDAP connection timeout threshold (seconds). The default is 30 seconds. -.. comment:: + * - ``ldapPort`` + - LDAP server port number. + * - ``ldapAdvancedMode`` + - Configure either basic or advanced authentication method. Default is ``false``. + * - ``ldapPrefix`` + - String to prepend to the user name when forming the DN to bind as, when doing simple bind authentication. + * - ``ldapSuffix`` + - String to append to the user name when forming the DN to bind as, when doing simple bind authentication. + -Enabling LDAP Authentication -------------------------------- +Basic Method Configuration +~~~~~~~~~~~~~~~~~~~~~~~~~~ -Roles with admin privileges or higher may enable LDAP Authentication. +Only roles with admin privileges and higher may enable LDAP Authentication. **Procedure** -1. Set the ``ldapIpAddress`` attribute: +1. Set the ``authenticationMethod`` attribute: + +.. code-block:: postgres + + ALTER SYSTEM SET authenticationMethod = 'ldap'; + +2. Set the ``ldapIpAddress`` attribute: .. code-block:: postgres - ALTER SYSTEM SET ldapIpAddress = '<ldaps://192.168.10.20>'; + ALTER SYSTEM SET ldapIpAddress = '<ldaps://...>'; + +3. Set the ``ldapPrefix`` attribute: + +.. code-block:: postgres -2. Set the ``ldapDomain`` attribute: + ALTER SYSTEM SET ldapPrefix = '<DN_binding_string_prefix>='; + +4. Set the ``ldapSuffix`` attribute: .. code-block:: postgres - ALTER SYSTEM SET ldapDomain = '<@sqream.loc>'; + ALTER SYSTEM SET ldapSuffix = '<DN_binding_string_suffix>'; -3. To set the ``ldapConnTimeoutSec`` attribute (Optional), run: +5. To set the ``ldapPort`` attribute (Optional), run: + +.. code-block:: postgres + + ALTER SYSTEM SET ldapPort = <port_number> + +6. To set the ``ldapConnTimeoutSec`` attribute (Optional), run: .. code-block:: postgres ALTER SYSTEM SET ldapConnTimeoutSec = <15>; -4. Set the ``authenticationMethod`` attribute: +7. Restart all sqreamd servers. + +Example +~~~~~~~ + +After completing the setup above we can try to bind to a user by a distinguished name. For example if the DN of the user is: + +.. code-block:: postgres + + CN=ElonMusk,OU=Sqream Users,DC=sqream,DC=loc + +We could set the ldapPrefix and ldapSuffix to + +.. code-block:: postgres + + ALTER SYSTEM SET ldapPrefix = 'CN='; + + ALTER SYSTEM SET ldapSuffix = ',OU=Sqream Users,DC=sqream,DC=loc'; + +Logging in will be possible using the username ElonMusk using sqream client + +.. code-block:: postgres + + ./sqream sql --username=ElonMusk --password=sqream123 --databasename=master --port=636 + +Advanced Method +--------------- + +Flag Attributes +~~~~~~~~~~~~~~~ + +To enable LDAP Authentication, configure the following **Cluster** flag attributes using the ``ALTER SYSTEM SET`` command: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Attribute + - Description + * - ``authenticationMethod`` + - Configure an authentication method. Attribute may be set to either ``sqream`` or ``ldap``. To configure LDAP authentication, choose ``ldap``. + * - ``ldapIpAddress`` + - Configure the IP address or the Fully Qualified Domain Name (FQDN) of your LDAP server and select a protocol. Out of the ``ldap`` and ``ldaps``, we recommend to use the encrypted ``ldaps`` protocol. + * - ``ldapConnTimeoutSec`` + - Configure the LDAP connection timeout threshold (seconds). The default is 30 seconds. + * - ``ldapPort`` + - LDAP server port number. + * - ``ldapAdvancedMode`` + - Configure either basic or advanced authentication method. Default is ``false``. + * - ``ldapBaseDn`` + - Root DN to begin the search for the user in, when doing advanced authentication. + * - ``ldapBindDn`` + - DN of user to bind to the directory with to perform the search when doing advanced authentication. + * - ``ldapBindDnPassword`` + - Password for user to bind to the directory with to perform the search when doing advanced authentication. + * - ``ldapSearchAttribute`` + - Attribute to match against the user name in the search when doing advanced authentication. If no attribute is specified, the ``uid`` attribute will be used. + +Advanced Method Configuration +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Only roles with admin privileges and higher may enable LDAP Authentication. + +**Procedure** + +1. Set the ``authenticationMethod`` attribute: + +.. code-block:: postgres + + ALTER SYSTEM SET authenticationMethod = 'ldap'; + +2. Set the ``ldapAdvancedMode`` attribute: + +.. code-block:: postgres + + ALTER SYSTEM SET ldapAdvancedMode = true; + +3. Set the ``ldapIpAddress`` attribute: + +.. code-block:: postgres + + ALTER SYSTEM SET ldapIpAddress = '<ldaps://<IpAddress>'; + +4. Set the ``ldapBindDn`` attribute: + +.. code-block:: postgres + + ALTER SYSTEM SET ldapBindDn = <binding_user_DN>; + +5. Set the ``ldapBindDnPassword`` attribute: + +.. code-block:: postgres + + ALTER SYSTEM SET ldapBindDnPassword = '<binding_user_password>'; + +6. Set the ``ldapBaseDn`` attribute: + +.. code-block:: postgres + + ALTER SYSTEM SET ldapBaseDn = '<search_root_DN>'; + +7. Set the ``ldapSearchAttribute`` attribute: + +.. code-block:: postgres + + ALTER SYSTEM SET ldapSearchAttribute = '<search_attribute>'; + +8. To set the ``ldapPort`` attribute (Optional), run: + +.. code-block:: postgres + + ALTER SYSTEM SET ldapPort = <port_number> + +9. To set the ``ldapConnTimeoutSec`` attribute (Optional), run: + +.. code-block:: postgres + + ALTER SYSTEM SET ldapConnTimeoutSec = <15>; + +10. Restart all sqreamd servers. + +Example +~~~~~~~ + +After completing the setup above we can try to bind to a user by locating it by one of its unique attributes. + +User DN = + +.. code-block:: postgres + + CN=ElonMusk,OU=Sqream Users,DC=sqream,DC=loc + +User has value of elonm for attribute ``sAMAccountName``. + .. code-block:: postgres ALTER SYSTEM SET authenticationMethod = 'ldap'; + + ALTER SYSTEM SET ldapAdvancedMode = true; + + ALTER SYSTEM SET ldapIpAddress = 'ldaps://192.168.10.20'; + + ALTER SYSTEM SET ldapPort = 636 + + ALTER SYSTEM SET ldapBindDn = 'CN=LDAP admin,OU=network admin,DC=sqream,DC=loc'; -5. Restart all sqreamd servers. + ALTER SYSTEM SET ldapBindDnPassword = 'sqream123'; + ALTER SYSTEM SET ldapBaseDn = 'OU=Sqream Users,DC=sqream,DC=loc'; + + ALTER SYSTEM SET ldapSearchAttribute = 'sAMAccountName'; + + ALTER SYSTEM SET ldapConnTimeoutSec = 30; + + +Logging in will be possible using the username elonm using sqream client + +.. code-block:: postgres + + ./sqream sql --username=elonm --password=<elonm_password> --databasename=master --port=636 + Disabling LDAP Authentication ----------------------------- From 27c5c35bb2469cc5c155e9b272c0337e39c9c581 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 22 Jan 2023 12:05:19 +0200 Subject: [PATCH 409/882] Kafka --- _static/images/kafka_flow.png | Bin 0 -> 167138 bytes .../client_drivers/kafka/index.rst | 107 +++--------------- 2 files changed, 13 insertions(+), 94 deletions(-) create mode 100644 _static/images/kafka_flow.png diff --git a/_static/images/kafka_flow.png b/_static/images/kafka_flow.png new file mode 100644 index 0000000000000000000000000000000000000000..c5bfc0ff2554e72db941134d9635480663ff610f GIT binary patch literal 167138 zcma&O1yodP-v??Sp%MdvpyVJRQqm0yLr8~8i_#&Tl7a|Bh!O&lil8Debax0yN_Te+ zAl>)b1Lu9u_kC;Kd)MN4$k}^8@&EtonLrgK8T_lau3ors0soOKLhZr@9K8z{E^Fgr zgYVRSe_{;&chNyjM&bghopKR;fo1wo@!^FFIq$C>y|@Ct#<P{xa=37Ti~;)Z;v=;? z>lZGZranSEeC+ycB>|`W-8N05H#{5`h>U!4mp-yJQdAOQf{>RtH(#4cdMt<c$oM0L z1Vvy|Q&V3y$zb}I19xwCYNevGHNo9P2lV{0o9J#yhd_te{Qhxe(puApD$Ud?Zh`p| zG0r_R?e18yx8Ha(7uEm&e){!g>4Th>Q!zme!*{%Wn*Z<rOy7B@oLANQ=l|o^pcfJN zJ$?O3kiPZlRXRT+3EY4GBP(>8a+B<Teh>Ug7%P{@Y2CLfZlk7&las?W5_O7^KyRfG zo=kH^OYmTQ`QLb{n7h5H#nC$}gVSC|8!|=4Eo4Q8jRZvw^GZeTyVgZE<6=eLr(Q05 z>n~hZ1~_*cX}pW4nfh*GE`}GusV*JO;6N75Yxy*qUWOogGb5h8WAN38;C%e_-<x+Q zu9C7YT)oM@5_E%Y%6`6iRY`a?|8xG@|F{F6ZgJ}&djmPlBOxx~eiJ|5iqI*se|xwy z{KR^7r~n;6<8A9recG+(I{6lTwAtZu<r<mee4;yw;&O-B;mc@lQ>AE88RzKjkPP%z zx3bG8E@P3LRFZcR7K&JpkNUx5{`16JRo~6sC-a@R7E~P!gl#8Y3l>a{>}+<3m#q#L zm01lJmeP3bbtc$JlWF9eak~6wh#pX>^mrA`Z!<<>m8HN`$bcF9<b>;SMK8aSGGo4~ zy%FMejm*QzKy%?~hUR1_rQk|)B(r5hxmv1Rsll(HxQB#mLdh()sFn|tJcldh-(T<; zJs%S{#7tor53BFw%%08dO^)fRlY^E9WcIjcQD>%3QG2F#L35_=ex~r@$_P5Q<z6vM zR>sQDr<qIkv&~k+Fw7Km%J{SC6rFlDdw1MU+G`y8K&_3M{qIMjTg&OevU1U@O)`GV zIR*atV2+Vcs$spwuIS<xjw~bTGH`#TAr#z+d#&bt(q>Y+_|eliZ2k8CeEi)iJX)(d z<+`}jAx?3Uf68w?G7;sO*UF|{K9H%E*Fegq-J|EZ-HUQw9YU9HUX34U5D&Hg@Mot$ zx8=VdBCXLj<0mAq)Ro${_xrUk8q)mp`j`t5F4<e;v?q!VE5`A)t&SB8>)HJxMQImU zpcDqV&>4C5S{6e7Ax~LW>T$x0J=w%L%}Syy|M~bnWnZtMc7uCmxM-YBzp}M0iGLj2 zU6Y<|&0ExqI&AdMbc+&?SDTEMhuU5SfBy4i_H2X^vlPxp`J44dFXjKWQwg^BipISh zSTs<MBn`^8mi?JdH=k+N_g2o`(m2U&(M9Q&=+3qFJa3yh3G|gca{l+9W^t;*8c+A? zj=^@bUaR!9UhGP>o@?zGEwmce-M63B+azn#TU1LOUHrt|c<}091)|P9{>6Mp*-5*t z!4#r<tzN(31nw;~r}?i@)NN5O^*B8_wjL{gh5pJ(Qz98aP$J~CTzreyqWBtnadm=S z0|k2?#qgf)-@>eatpe2Si*hiFqc&BiXs_e#n8S?#n$dWUx#CYr9gh2(^Dg~GC1X!e zx`PQHH#1JX&@%$99m*}rN4@_UtiO&$9{s3Mrf*6aCXbL>qqh^{#W?$*AKMJwHZM7S ze>NZdtMBqhPMO+g-FH@;@=QDIr<oM8ar+wH-7afk(L?{8Yq2!2{1);_le4|U{q$@W z-MhzRTaLZ+G3%wm+~&r`miMRo--VsGVulOcqjj>M`@{(u|7;0o2)2BsC$CZA<`gZg zVf{2@b8}4mY^9Io^LN>wp06ozLvL+g`Rnhj7&k}lCvifxCP@NRyDetSr*OP(L|%I$ zZ;R*FMxzPB(#y)hMeA+L$e?MGRrhz*@4U!E?*H>QA>Y6@;@DlzF^qECTh6L-CSg+I zVX6SLT59nmz2xO!-W4Zr|Nq@5?z|AHORP9Nne+BeY`A5ak#qJ>4OK^+_&7eb$iVS& zzdm}%GRx`Xy(jkbGsjH1+xgdh79a8aw{Iw|874D?QVY*HuZ>xSWkoP5+M6agMJ+pb zE25?XosA5NzMj7<xPaZg_q%K2)tZ=6iuI{rxv!-2t8_``aA64xi-vP=+MsrEc1tX8 zddq_Y*jWdedVTObfRM&6j^8RbHfx;qxZ&en)!Kr}6E}@=O->s&%x}TijRb5bXi1-u zd@%Xfa#vc}TL}AV{Wp>s-K{Ln8&>e*t3S%<cR0Iy;R?Iqw~)ZG(0@Jlt<!z*v=cs; zt+$tYt(SVztamx8ioYqw7MD6L$8zic&nGc!q#&RYYrVUZ`rm=O#bkc8+H5oW=ZoZM zR@L!RET8$(y{8#wPCCjR@q&HZ|GKq40nX`h@59m6!MsK`-Qqur$BsXR=i|#!>fb|A zkJGwxP+9*Pwxv*RN<sTb=Cg_{!Kf5(##_W*zAh1L&GsZWvL%WwuIMplP?3=i3+r^d zt3~6b%HO?~oL9$YQI@X~(lxRY&wnF@lp>VsaQm^_3mT})e*Xj7kLOj)r?@d=m7ZmX z6Lo|mb8T^Yqe4!4v&|p%#ynnudZ2V_dIfjt<of^qBjnWL`03v0G3a~NW6_%<(VLZy z3>@r>sHzjUXmRfo@29V6(H;M~3g*-B>!6v$S(IA*v*>OyIUKd|%j<#qp@$kN(Mw-O z<vG?4<{B$+&Hs;aD>1aF07U}M?>wRz=Q+GuRF-Sp!g#RxuW7)siJyEge)9b9jL83a z#uzcr(%XXeDXAotJ42RwX=<q>6sGZ$Z1^W9|7TZ;D$xkL^>pDY#|!*E&Yi#6kM_T< z3%Z^XJK@d=&-tL8KiT*3#p{jlX-u^-({RV9^Q%l*hxqA;-Ya8LjWTB|jqK+ST@DsM zm8YKJpcLw=)048{T;pKDE1;D$^S&JT!)w{ss&fz1v(?^Q_dee4AE)3lvh_Ya-VIE< zj;<GHlE#3dbF>g@b+DJ@UFs4*;3OZ-?)2^!uYGU2hD(Y4tUU#{i9*l(e_#cKFcwu5 zHc!!`Wuq&Dd7~pG4tl*mpXkN$S?PZ3RwiuT`S<T8RBr_alBi>D6iydPExLq_e`|*C z<-kNNpVg8@&yUGm(+)Hn>De!=4pw<r;bj>aGi#vYmj`mbLL2yevH4vML}7j_aAJM3 z4&BB-?ij~!<IJX=pWWoc-67I_{<w%e+x3Zu!Oq739_jrKXVB|M>FE`|96TQ__>K6v zcW)t7iJ&B!44No4?`Cuvb?Ps%=>7S~_Ut}h$hXG}jy}=Qo4v(vz0#MdGw)A8wG>Jv zJa>MhUmhf<V_rgpQrv4q?ds{?^m~-kavw_W<2|_!#xtmt2=-ZVEU#tkda3iOHowQ7 zt>rKV&?5iPc0PgT7EbMte|xSkLu(oUfLT=eUpc(9M}!+RC5o1%tA6#j?D-L<Q|VE1 zo7W<;2ys^IZl4c?-F=f*^4(qyeJ!~c7R7SsHy?%#%SyS0(yyvK{M*7YS|3PK!EiRZ zF-CibSYxM{FKP`NLMYJ3yW>T;{h%iO^oO1&49gikvWQJc{c`&couvPDb`6y7Ts@*^ z6kuG#&2C{~=M`J`U9{7Df=ePmYIzkUr^cXQSpS{*jn3~@;x^4Lf3@i*AK$x(kOgy- zXxW$XDgAL;co72W?J!Y&k>6^FXBRY|5-^mpL@bzL@(qCNVWz`i9ZYHQ7s&u^{0vJ} ziL@`~ju1pHjEb={-;|Tkh1R1>Ui-5*`Q3M3_7~ac@9xhhmDL3hx?7%HKAGr5lTZ)u zx5W!~zoQl%LiFwp<e9#Y<F$;!$04NNnmefj&<<UByrTnPok03S4uo#JQ=b+}DM1L} zO?HR1irqv2#8dwn<2ND7iPeYtm{}Ul^E`Ck9WZ=fGW9E12kU|=6Jj3ogAH2ZP#W<u zQg+>eQRiVRlzI0z^oT=80kRc>w{yy$xPF1<*~Ip&d|>H230^R{Jc3DLCSK5Cq|)<H zH&NtO2K(&E@u3y<r@P3W;R^R6DUaNjV7cy;!04rmIV$&Rk9US`(6!e%9Kj2wA08}c zjh3xdE{pBYkQ5pGy2^4><@1A!!9-Fwq&=oIpJqK<{X5^WW<TG)n(#}U=$+i~g`9}( z#!#x|%0slUMusM*O9O@JfSu=7r_5892v5`Y_`%R?ldq~@Uo2$z<yNiQ|2vyEeFf3Q zKkm`ZrkP#cJ_{;w(e!L-4x1dMZDz5xt}=?Mp9w6TDC($#`1os$!FA-_1s1*b404g# z%YtBu>)0G0Y&(l^cF3nFyPCWr08e8H_X4F~SuEmg6&lMrVs;tsXYbP!6Oq-<uK^T( zkEWTxYCxt;2BVO1{rcV&Eb8Avqz2m(g!|##U?2=g?!km%#CG-)H{ykyetL#F5vk30 zB-yMPU@3_m_UYJ^Bzd0<ib)FT-Bn9LdRh-;zaUc#8Yr=ylmP5Tl|(<u9W5AKXnczB zvmPn#e3JgO&1xXK<^}P?fmYD*@V-&<Yq4LN%mYuJ_YP+7y*G(N!u<#@B%<#Fo#Y4( zjmPu(*VREtT|kg_=Ru(~O?=f*ua5Q1kG(zaAoewRkgLbSA3BXvM{}J99s}0K`VG3o zXSOw0Adbf0`O#3u?0E5el0uWH{S1=j$<IiumYaGoPkqnrCq+iTiG@u=0~|Y2oTRf! z7jMVo!L(jI+fQ5<rC%+Aij1GEU@ja}I9!P?N=9CT2_gcU?n8Vm<$Aq3LIo}u&8A~w zSpNi}R8QmgsB6E-tg{wN8KJpUF?HlP{f>XAEM`H?PhM@~?>?W^(11ObbiFJ>MNB4g zA;D$Le0xCa{i~M|9cuSJdmSI39Om0mZre+Y?bgGEZESj_J;@K^c+3rIEkG|Qrx$-a zPW_<OXuQI0JJ&(Nb+r6d9@GI7l%v`8R$^ezFd>+>VB>V-`{AA2{MIj3%fu*glG&7= zfri4>`Ee02r;<cbcWo?qGK&=n&5nAi9H~pUBL62M#Yk4)bV4{cvmxvQN7a$N%OU8- zS4r;`D~liZc!I7qrVX#C+nwu@=P1Zv7vb<|#8eMNbJzl=%h_GJp7I8Vu+S_Xl;BUC z7>3RKW_Ot-t9*+3)eLMGK+jJDflYE)th54u$E04~nF_^KN*2p1p1K<Mp5(@+Y?Az_ zx|l|effUJ|GM6=L3C6Hw+#rv{yIS!-kp5EH2o+=R6t&c6!fE~vbFJo646t0>2*jVt z&355Ju{4iq--Rd1I%xrcwjl$-3(b{8uf&hmCFT3&<Yqu$(7JKYmLUF`YOYqUQO>Ie z`E=dL5=4r<Zi?o&lT|-F64q_5DO45J-N!#ZSOptS3gyIaHHzU@M9NLL5?Ma_Rc_IH zuVo5$xBcqF`mK)|&lZ<@(@i_@#?NqV7}uRrXnDX#-`H)=M(gvv;qd?d;LQ(c?SvDm zCL;ZjK8P^lz~(ZtFc^{e@h(bVlIletO@vAG{z<inx7e_hf)Py$t%+Dz9&U2~GxyBZ z0HL(qG50K~Vt6(2w%n2)Lc9J?0FBoGB}#TbSo3fym_vJMYT&tewb+38;dNHYb)c1K zBG@|LAWM4Mu?iE&P1zBu^&DNe4(uNOo*Ui@N0!yRfm&B<szO;!D}vceo8Y#vmv3?X zO!Ghie%i7JK&G?Id+O~dOov0xoHxkDTgl=?x`9_0hYHdu<e@eJqeM2`u{!<wUd%%B zyHdgl!^ytEy$|d~&ue_isN~r+u+-qvf&L7+A34`7)s}Jr4jj+FQH3ibpaf%(8&yNx z=`-HjXr!_7R9kUg_*0W?1mpiy1xji9o1xDSFY7e$4X`u28NRudhIro|!&%ow7C{hW zriI0l{CJSyaGnxru`ShK?Qq>M{}=8zL<8}!mYn+^o_#9K?MaamV2JI#S*Q8lOfU59 zGD1(u&zNS2Qz4=uMmrmjeJ9W<3vi!>$|GaeuNPR44s}_vv}HqcglKNso53qT#dN_g ze1w+*kOnHi_?u*VP6aZt{?h)Y@Tr^^TJK@HL=2C%g9rL^jpa%1!eowjSvynIzbh5& zZUD4mZ0@e5gs<6k1Q!cei`mX9Lkp46!I(kAGvmFhr8M-Si%5O?#s)Fx$BQp+*hMvI z&k@pyjaU?U?T)%cT_t}Qc`G+%f{MrN!*KSCH=d#9@W)zY1Jo0`V{XfA!qO+-N2{G- z5io~9Y2zfFB5PjG$W>b6h)SoCVml^vN_y)nzC<l0D$7x_&()YnO3DDPA~7i8(`CZa zP=k>qv=o*QY|gdiIb`S*p#ob^c+>UD3Ij8YHYQ?-q6cw0>w7-T#`xj-%?FxB@brTg zle0C*ne^n0rU;y`a6O-kB=oCbv8|YNBw7{p%Zj@;Qn}pCgvJqe$8{V&MJxBr{x?IE zv;ZSgG*#}Sy>WA7j;yM<9JhX@2N^?<fLsb=GOKC^ZZRSYPD!jcl>I_7n4RG#Nlo}{ z%FOI0G9QrucO{+-lx^mdk78W}xXhSWRqOo^wa|}N_8BSICc{2^$t=vlj~=yp#e%wc zI9Dz^-olwp=r?$<y&Pxzi%(GI#I%Yt&z!c@evDGM5vd|?bbnKzBR#8fC^W+GPI8ow z8%kHX{R&-lY~jg%4i&--?oT1W*H^aHCBLc}=s^nS+Z$US;Q*k4l4$SbY(u0(Od{r| zs(wAhRJ~*(wXLuq8_?v?6E$y4su_a5LA`YS*K>?Y2g8Nmm@>_JR-wB#Rzb>kFPYea zm;>ODrCZ`Bd(&jwY?v1b_h${pbeEeL47*VQutt=97Fen#2!^+`FnVI$Gnnl5)=Wdq zzW?WwmhI*K4mF)?(3~Js=$4bA)tgMcRM!S}$~$t-TD2`zy~(C9`lmNDLD7pkP{yDn zJ_wLlR~<X|dfikdWX^t+pvW8wft$E91V|j*bq#t=_)kH%tsilKRK<Z7pRSpcY&l+8 zak$;DuUF>0s#|0|s^It}5`(+_h}wsKgEe9|-SEy~t@02hNOd+&^>o+1V(yCgsF{FL zV1iL0W&*;GsLBHim*vc&Se#SSBu|r0=rKP|obe++nJ88*UC_~3E7mi#^2$q~Q6YkJ zHZ|Xc9`wiM8YeK0b6=DrE%Qv;SaUz_1IdRo>)0J#(rDZk+k1!^PVg51F_VqDfp(@9 zw-4rJj2Idy+%O_y48Vmwq0K-K7j-Dc3v`xmW&ujupDcAvX9t24pyPE>2|Ks)TJ$u9 z$YHK8fmAmF_^dZmr$4u$72u$MMoZ$1dL&;h-}tWZ$-tMTGxObT{+%cR`3OL(?z^<G z6=^Q<U@lEpUsc1&31A+&;kJ$ATKQ(^$607}{D|=A&lremT^PO02)G5bNo&mHP@&cG zExwlvY<B3qjcIGZ>d;`XIV#5TY|NcY@dow>i{Hz@QZEA+)xLdBQ9}?K&;=1!Kn*YG zsR7DOu466d+um`n!#2?Rn+t5l$Ce)Bo!yi{fLXuC{@)USMKrB2e}@}(|9p%#jsV8B z?o5_Kg9>l&wA5qArc<~TbyTPCeLM@16EcoxM@h!#BXk<htj^e9{>lMp)*?lg{p>a< z%;O=ioiQY&*$>VF`&qeQgNm7Od0l{nD;T~%r|KfO$?<GN&tv1)nC{sv0W#n`WDdj< zHI!LrvNe#j(SR=OoOh#v4;YMrM9u;h?l|s!T5-5uM>q;`{Zf}TG}}IZ3Uz}@&(9|; zHlb(33#a2UX<g7RvR;*bPi-}5h*=?sku&6rs0Wmnn*Y^bqauiV0y0$!n4+t^lFxl0 z%kzO^JYE6_P{a9z`^n-a>oJe#01QwBc!*RPW+v+2oDcaO@Kg?<RM`O{<^cXSiREcV zOwr7^%9_($>nFzIM8I<X^OzDwO&@Az+Y^SNWd#<ZYUdf>-1snQQ}P3vA9(F&>E*6e zc?{10^c-eMr9qSY0&GBwv;Y7Er`paavcw&1zdk$?#$uo!56d|lHAnu|fkTf8)BV7T z_nCIUcM|+057JI-ftFF^Q;2tYd5X5-fipof{Ew0#VCPm%K<E5OZ`cHhbn$|DMbUrg z&Q>Mt%DbOnd6fbVs<|`)xRQ3=JwDCo*sQi#UWaRBthNA){ym!<Tsq>Gu?lyf@~5)3 z*#b({T8ycIVQSf{RAL?jR3ff_8gK|GZNU@Ri=Q6lK{Tu2VT=oa>n<}*FcKr!3(t*@ ze0T;d@N^CoXe*;~AHp)<ILia&S?}a%AL72#Ko&A-0kCheU1YQMbCLOZJ2I$Fw}SXD z=z!=Jjw(lvimh-Kt=yENttv`Uw;s=<jYjK(twnSlq4?H68z}tJoFpZMu;ao6)LR-9 zp#_MXdHpBoLn$zyc7eE90t#CDC05+{fl{Y*yi}=RGN-rKZaQN~_wI;;6?M%G+;6z) z$c%g$v#+$(@CE}MMEPiuP0}F%e<SS)!kLW6Kyw=fitWp)o6lUoSd}3HiJ$&lS;^}t zT!nWvkoJV#IDY~-ZE6#kr)7Ua8tVdG_w6NP?4-Tw+vq^1MBC_RZfRw+Q99=Z5tRI{ zDsS&1;4|F*F6|};-8kYV;wKzQtg-=M*1+qDpbOe*Y79U$5X_sTdyOr8>Ei=}WYgb6 zIUf7=d2GawbP8W;X?&5ma+`h~UJYMjym_`waV^&+>f~1;tr@COI(a7VEJuoS4#!VV z<}+dZu6YGk!+jO|b8#qzPh9_5%W5?b22<s4LR(+H4PuYDVdS#66`o^B%tH)2St?k; z2v|#~^e5?2!pj+X<-F>I$%eq$d(p`4FsBfloB6Dw6p~m1s}R-UUIJ<7yK}(z<`7u5 z3qToNnCnRL?&@Co5<s1ct>Qu3XF$F*Qj+&7=e&}sVZ&&VD5;<us(P3@R)4KPV|QiH zuy(E|O`YvW^20aSC@_6dTms~a9&dbXyyNe`@cqa=JphWV8Ju;BB`t&`_-r5hG4Qk! z$p>7gFff-fiwv`$0T|o4Xw*5b=;_FZT%(nNoVm=MG557s4w$CwNA&v&{USd9$n)tG za$4wHVU?esE&E=%HWI^Wm{ECeHNY~ff^Q|ym?%sb2p-oid^xdP?#moCj@C0_eorFl z+SG(8q8C+;ye4bkMv;*lwgVAun#;J^=<OPqsKrcDab)3gf0oN^OZ4s>roH0Qsa;CD z@SAZHF!War(2&z9J&b39FIW3q*6T<VRm=v<KHm~>encb_ZEgWTiDX#z?Sk{gK(!c# z5CUSR{v6uBxZ=AE$%l}@%@D0?;G0gf9i&0YEJln`YCtRdtbJCTB(U(Ve+L#-z8W>= zmVIc8PXMh(X=FV^58G4~I97<dZOJ~h>d9vWAP-%GL*saSxa-1g(rW8@u=OZ%{oYws zd2tb+TkVo^EYEMxy~zO7vkEsf7|?>+9YlrN?w3aqjAKK1Z(QX?{ehQx{&aps%ohV1 zAOd$=4+9E_u=?X{DhEmLs#N<j%K?B0)p@peBJBdx*Ijy_Xq51exz=IzLtKeU$gxT1 zmhf3)3!9@YhW`w=_KU>>qOU!0V2k#_I2CB4`t@A&l0~Q2%g4bEmMSA-)%^3H!jA_U zb0rYnVtR$YX0k)$eGzJ~Kc40qh-~+$Gipj-gDfpTk@JDs+&yCWUettQf9f0|bWvjU zgYI7XiQBZ4fJ&$s)P&)q%QytZ4DwOMKsPG`O6)*+{cBKWmY+iE(0{rYxvpcU6#8(j zN+ak6w9Uzls$Ea^=M~MMilztJN(DowB&d&ywyF3$K=iRed!Ny8B+r$HPCY+VA=?hv z4@$t4^dBRh@5|C(1KoZGQd4t{eowV2#sDN*w>pqh2dv90W0cTE01>)>S3Cd5Fwhjv z_JrnKFzEip(fVG4qCjnASO2Ck7QR65f*v7jgS4<XQEtBTI@U%D--Zyw=6nYbGyyzu zmp@7S4IJsKP|wu(u0&;HJ@vrx7)XYCUnJg^3u0E11oHW7!)Z__M<9672HDIAw<}B; zgkpQu0P~HKGON`agN~^~>`6pq|BF<k7>Em64VC`@0-lTXZN+xeBcR^sg3WarA?6AI z>D<Hj6G2Q`YP6ZZA&vaie8N2DrNJ{|U8cPK``$VB%Eu8qT;XORC2R9dR|X=m-e{@Q zYP_N38NTcCQx@B=S4<Kc<u&iB=d~K@iE|HvIzxyc5ZwOG-JwSGSGez%0wndH#act_ zeR4E6arbP!=i@-iGJDxdt|MKkT2>(_o)DxPi}yaifwXpL1ExHR&;@-}Fa2p|dC7O$ z)ODaq>w=OnDs@wDrcF^Kg-;NK2U;SS-t)_xRRP%bzjJNNAV*=yI|5BySmhT{pt;xF zF-;483^s&WDw%cphO|w4)%mJ;Yz&k|>v|*%rI}-ZE?q_i_g;gRmkZRCpZt8hF?R>Q zd<Cr08DRIH%>!nzLVh0Zu0@}LuLx(+A?(GAFGG#y+-E;(lnb6ppAD26{w)TZs^h{} zZ%1wG@Yw;{9Sc_{N|h7UP>X_$-ncj(vkO#$_Vu$(VRdozn3d*-i=97dXB&B@9eq~J zemR)y*vSV}d~w!-`#UZFOz>mFT0cBK#w$2!0tSYFy;{$=Cjd{}{&(nODM#R`=#PFf zO<erX?7jgnQ}R{jz1*3?`7rMJRDIxLvXw1}lR(<H%~I8Qlll1ozaJPZ&=!Q&R7tl| za0Nv!fP)}~Qh9@P;(J)YJjJio^IBg+4*(u|cij7IEO6gU1k}92iBsf=9mWCR$_1=F z2N34?!ax7d>o;lT7`%-Wd6ioR0bd}=>OmR;14gcYijxc$%~*Vj<mLA~G#jhuvl`}T zW@zYm1KJoDF0r7CrwMlJNtEk9IrHD5m7U2f8nfpgb&UA$C1k(wEkj~-u1VVxa5$%- z5@_?=dl0hyplt>~ydHX_q~eTDo$ohWtj+?LwJ|j0-~c0_V8x-c0fKM9s$11vD_v&) zZz=fzp@!XwH-x1$-bbAfGpg^|8z{7j1K8;U&`=-es$*#5*(-zA^d4-(QVo62UP!eR z1@#dP+SGOwLJTXid~Yh)8q6OWOqbnYp6PDX(LdM&4~UgT`S5Eu*&Xq3^EqnhIX&@R z^a^zR#RA#8|CA=oszDSxfGSu9mG~8RNGaB-^72G{zx~bs7#IVip1Y%_aQh@N&k<<L zv%RA_M>qEn>0$uxT7#v828}XGt=Ob3cH<i<_AM@+<{ypP<*s(;yag(P0D_OuSyI(5 zU*jmBU<b-KAl@wLK5ih!WAm<Q5)?x_Fr5yd<=K+ndu;n&bSDN6g=ah$akfo9=Kwu< z^JEA>M~Danen+B!HoxA7ylqiJJgfafg$_7}-`)Q~5ts{xT}U>9kgiqH=v<=r$t!t& z;7_>ogG(Zb^wUO#92ZoAdq#o12#n5+hTD3exRX4&s(7~jd~5T~yIU`Z^i(GZyEp?A z&>jM-;5J_+BOW9AAqEJQ(SJ4`<`I!R?I6pfQDm*RI}@Q?O2(#L{5yiF3~Evkomd?y z>4rAfSgbiA^M@QmwTMFCI-!ArVsAB+Z}(p0FA@TEEgxB;i%e?IcT^AsaLDirEc=~7 z8FheiRiq!Yo@U0jL~|q+Jv~|(Dri}vr|mhXv6%UU-;{gzVqVhGb1Ch+?r@>iC@|}w zIz9@-H;l)^q8LS{GWK#8J!%aA7&=rKZ40D`f^c)d)g9l99sGb`DvM_JXDG3;8(1GU zS?_<kbAm~X$r3|56G#F%kLdt`&Kb%C%K*qPXh^~KmouoS0pLTl2&{1zpl&m1MvBov zt|&ymD^E|{|I>>#A)5-K;rVyTpf;JJkNX)&ECGk0R+S6dNosLgq!K?V1uXZrnX*b^ z1_(K!Kp8?gE_M}G)TjJayej+UaA(y4*!G3T1}zAqRFPYUY`|S9oAA8`c~B!z3G=+? zjLQd^u2(+PBhDr^{E8E~ES_)mAmG=*77V5T^jH3@f}c;)8GnXtfeK#ca~VfF(@)Iv zpcu55SMuQjXRRBTPU8Ht2Wkin8eajT2Wd&AAZ@n`xR7R<0aQ!DT`_v7d97elZdY$) zv%2LA;;u9SI|dWm0E`fT8t?G^aBA}5sT{*bg#iXPXMi#pgL01nupbiBl-{~GWdZ7p z70t`>ac5v?TDjw$Q^<#JrJG-0yqwY51*B39U^8r9s?*7YN)P1rfutR`p@IQz0*=&@ z`JIjZNcdUHltBJNK|fG-@)BVUfY{L|6*u4~L&?BA5-!?icstiA7=N-0wI>5NlQx%Y z;g!VIK1A|zhA$(r{AXG}b=N;ei~t{W=)rCO{SZNP{nbpL^ELYCv(F~*A+)ZBE~CoY zL37$S8hRH<!i0fnfc}iZ^-1EcVueNGYKipU)l5=5LpOj_3!Qy-N$p-~1J>_w<P*fx zhL=fdCWzbv1D1!kaZ#1!fyb~((u<@U+mPjSG0H6i@r#RyE|~UqNdB*Lb>)WH0Dz$; z;bP=9AN{ZW!7V*Rmq8YJX4Epq;U%eq>KNcInf{l4ZL0_UpSjGI>X)Sz>)cNAYs6HJ zz~@aL=&S+eiBj7OVnGQo7hkGn)^%G<Wd|T_$J>DJ9j>pnnmC4?onbsbqRH21FMB6Q z736hN<)cdhFipysywwE6w~@CupDnPLE+pUSm;5Zvn)Yx#<}81CR^^eh=je#oXei&D zj|U(li-Lw5x{zO21W>Fzn=UX!0o41V#9BZuD}zxa{<(0N|JjA>!ETiw0UbyWNK+W- z1E35LhW3`yv!D&33szL7il^F_lgr60QvdYev(nskE(Hk;f=0AFT$IJ4n(PN9Vp=|N ze=nN3k#gk(nC@%^wg5m?lsuXS<&3+NH(NU6thAp!1>)-Yd@zCK#rtI&0HVD7n(qla z<KOB4bXDYG1KG-q<d+6}z@JxiYy-vRALw=VEbxHq-bv@~^wb^Dz+6Ze6>Oopr=e>n z74N$MnU)ZT9V)U}1Mp(DP4QM%`QIQYA|lmm0<@aAIFJ8bZIJm>U|m~-M!<IjmJp-> zjuFFttBfB*70Yc+z{I#UrW1%fvV>4c>cbI$5&#$=E&E=Di&Z9+5)H1oK8FzBvIMnx z9+-WzZGvyl2K^`i(8w~tXT~5h&ujLl`g*#Z9ndN<@aJi!b_vLlxI08N03GFJTFBw{ z@;n#F^0q08L1P6Md0=}CpumcYpv_o06iXnUPsYmCT}PXE0HaVx&t+7Hu8Z(&ST7Rm zoxVH2>b2`LE+Avtk|bVL22!+`urAv^2NWCu;MqAr$O#e|9~I_od!HUA4Fl{VRgQfb zYTPht$c9l&5bA|Mq@F_?FJn12{Z}7ZcMx7MSsMo2UMtWCs4Zn8ul~9MZ>lr&?3%9; z{oY?=G1PVMW(uj8$6mG+ia6{B4J6P(N#3rjpa~&Af;ew0oYt;&Qje~N*9{WEC~gfE zSk41*FuQ{uU1mE=y-Far0?%GJ-Uz^Ss1czI8$%&*f_JO&k)#KJB#pQ6fs_tEmXP)X zcBC@wgK8_p^9S#(+n(<p<kq=F8xIsfx+r)y5TDQ?-0kag4FtR+fS=hUr*{PbSp)eF z=$oSnUI&Xow(ksn94g(*fwBz$Y2S+^XQ<|W<<Vbxj8q8)0|Ae4cbGN-J=EkmLxrux zrOf}a-nq{vW|DwfWZ`7D>a+wH%q2i%WV#182c<ZQi|b2i*4f^`Fbrf9<RVxD^oRys z&N+ffx$p(hWT7A(p9g?1=)4ZG%|0^B(vZNNgrsXIoCA7i%)*ae0ON{}_BYG&+J(;U z8|yt}NSDpMArylY0Xxsb9VdX&oq<F9rbycC#VOc^1;=O*pF0K{ZY+G_&1U!3V)rPx z!wNy>H~H-V#AF^We0~29ZNv?8UHJOv)NN<bbQFjtn@N)Z@D_0yPmP}y`Yu88aF9A# z0mORlDjDm7k}#WH+hsM_d`oo4Ea(u>Xu?H(vIBnbo3>LzfpZ&c+XoW}9!fEfV#r+` z0hoBz^Vcc8bjW>9zMhq_is9|G@o|yz%UAkUkXZo)RQBE96tBfD$c;LoXr3(wGDIfl zo}<THfz4KKJ>Y%m<{11M0Z#EKRPF#2UL|AKHJgTXRnWiPEU(dEW)dM3;7AKHUXB1c z7eF#BKfl-g{8LZ?*rBZklpu`awupx)<uq*2ykSx0b&N3#fW1O=V}l@!6b9W38t`!! zLh++)_k}M3x}YOi?Sm;%x*7}xYutf$IRfg5mDt)35KJouOlEw{E@b16$spK3R-<4t zhMYBB09|FA!>%o~lN|yZ5kwdrMnF1d6o@GpF-|&^(j3kWE5faQ`QGyga5XZjGV4(x z`MmAlOi2SCeKHEhV-O*Mtij=6!uGgL3gBg~8iMdip;f5+#?-Gl)po8f_hV3@cRqnd zpq0O(V^d+AG&|r)6e_43>I4imNV#|#ov=xM|M}})CmI3U&lsSEak9V)?cz2ngj}iR z-t=fdtXob<Q^LT303B!GEx9@PUOuM98Y}h(@e(b4&iLQ9$&#!tPeILwC;0l189KkG z7H$3D3E^+~DI7^ONM9_v?W`<9DL7E*dLoSDpeoJJWK48X>gNn_AjU8&<pynG<-t-q z8L4)Oy|G66Q?^ZKK%|pf5`>G&px`0MUg!psv6U;|At?U=BZGWPh`u=xTtdj~NUhrW z$=5&bnl>bQu%6oI3QY5i1|rp;fW>^p`+=MMEBI!SizI-!s}*${e?P@pm;Q#hmecA` z@6N@So4_kCk{yQRyD=xw%*s4Ze6O+F0$IipI9R24(JQxQQZ8M&I&cD{Qk%vn&;bHb zcV`l<LH;^W7*<AGICH&e#(XH%K{|3p`yG{VpT&2O#VIj)47Crdq<HbpU&vojEMgiM zmZfDt9Z-;!>H)E-A0MwiID%+^Vx;sBsh4aZ*AqCUE7=|wLh70ov3jX79pF##P6ACI z2yigUMYCwM$I<)ZbqIB=N3rRwjL}8W*9I@V9T)Htx3v{HJ=$D#Phintw=s9EwxQ`@ zs8R;X#k0>;+u%q<T$_(G)hA7}UE+P2vil=n6cxANRu6{qC-=NylNZ}#ws>tHFt8AY zeun6lpvT|qy=m%=2R<S)TY~n$M7V*Ybikd@u_p$KS<3<A%eX?0<GUwof4;o&T<an} z@ZRziXoxv44V)=dci`BU*&8<MC2qlzjjhX83qSKXLii3&Rr<uMzxh<0vpc6v-b{#h z?pJ)M6*cW8h|H1&exj4a-t>}IC|~-SuF&ef@$05yll;#Gxk#3<WXCzfL)K*awQL|` zYO&FEP1EPY!$C|e!WzV0$x0sGVV7orKRAxfM&=;HA-yoQ-eR=008$88bc?f#w!MKe z^R{f#|F%Ll0Izuvq@lPdz#k>LUVRx2e1*bxzIku3m$iF1`muaAA(0hOa66Ekj6MVd zI4Zh3Vu&3iL*v;~zW}=VEBAw<1vhYuIw?yauwuTP?cM(7`2NJ`yFYT@@chinYtqvE z==^Z?+X)S6eFda1gwU1eajKQC*Is)X7wBZ0UkZ$e74i}?z_jw+V<?IA0;MY#l7m+$ za4C=G;e~XC#=o`1wQD{E%ZPW}RvjWw+Cy)Ma3UA3d=+?e+B*HZW;ba~8-Tg;f-W*p z=a5@iYx?njZBbwI{W-F^XueBwRU&*BnuUM46wXuC3BS!S1^Eo#02;alQ>)R^UeC=o zen!?Q)@I=(V#BQ#^6rkWHd5l3e3?tb(~!qgP1P<a;HmT_84hoaF3e9L<i$DJ&c&|N z2Q$i`AnF0Bh;4{BM-}y&Go~F|m5UsS0n~^)ZzhcagYSFzHbyTaQXya}FN8Dqj)`8< z-nUmwwAc6Nm9ZFyztbxm=z9&nVJihI5{t=zsg{0%2=P-F@z_tQ>mc0grpLvPN+OLQ zGQgq5!)(B682?`Ow51FeFjx~RbA3lCS%zEAHNIEafgs3;&J|1M^5sbE2kM`LvdD(t zYMiMrt{xU~7u@iVML#Mb5Y@_5hSe?Rlg!d-MJ^~ni1jjrI)zyJZo^<8uBP}qF7vPr z5gA8@kDSZ2Uhr&tko0VK>=50J$EzThAhJBpZ+-b@`7Kfe7!AUGGqt85_i5gbU3_}| z<n%-Ub$V<kv1!0A<JvIbGs!gcpmmBuQg*&%a&SUOADnU`3!Bov3`<zQE$@h@MCzd* zsLQ123hX>c4rQ|t&4h+kmV@?NxcMa<aXINfPrr@^s04ODOR0$X9q*gzx5H><4#zX6 z?_!)8K^*vt5w*u}DZ5raqEnc|Kak9SNF-s$lbSR`qR`okgYz^Ozmq2A{bdirMIHE# zK}QJTkeX2doh6Z#`GH~UCimUc$UTHcFGj!XVs<23Cjv1Q=Wx+m`;^$?Rg<7^FMfjb zA1IjUr-3bE%W0&tN%DqAHQZ4R)*&nDKOn{Qu8G%6c~K<%Ti_2qp|`j}<ioJ;g}Vl3 zjRF#;WMAI3vtACfuG|aE!Rc`F>aa_$ajmuCDR5pef-7~x+5wF?_Tqkimr3tNf?0V0 ztW`ElK4?th?Nu!~d7+_{klJeH1JKulv|@GPw*s4t^sr<?RJ~^Cmg%*-9xBO^y?r3S zSNNOvn!?wh=S|!7b+Hbn-ah>oj_zLe7P1xWp9_~~&sof>JZM%s<+B+Z5vvoWmv9E^ ztaICO$G$DqAdRiU$?1f?w^&`Z*U|Cep|RlU;d1@kDv|Zg>I$Y+F4ZhtJ0z!<s7BvB zr3d|`qz&;#uEd*tvx75Q2-eAC!i>g})EjCK4LuO#Gv4K0uS{I2T@zgkUHk64W_yRY ztwfvl+61gCI3$ugxbEyzuP00h*Sh$x5jJ+X1Uo!@Oanw5PrlfR5nGdqT|cC0a%v#r zTNK$i^XXX7!dv&&H6HWklHJJd>gpzLp9riDBrs3^ND5yK5E{}K=!Nyl%@JYI3<-qo zDSbPB@=bxlp_+*vpTN)Pea#?C_9$Byj@N0>4)3}`_cNKt4C;idF4Z|ZfVkR%WJ^)? zI~7Us*M;JqCMS()H+&*axIN$QeWvlrV^u0OI;v6q=*3V&zx7M<9VW1hbi~c_R=a9& zy#k2x;WuWl0z98Vv1V@e0-?wp1Qrm23kgs8^lMtQg41pa(Vwotv7EB0^w3fA<t#sW zXVl%^nI6Yf$>X^=n^-fb+zdN&ULeYm!@0#t4vTGi(zRefUaf*S(1*(hmNR&YF(b94 zoB5L;az<?kjtNt8V`Hlk&|mF(B@=HXj_gU<zz=a`=;eU3UE+lcuSx7E&QPpTg_301 zgj{B=+V0a)oM8AH+4C9bXPmJ3p=?Cy6fc^Dd@-n6@y?Y_Y-B%f4Py0g<?J4jj^<6e zMA;|pZ_N8%2qQKO;y=%^He3na00})lSYl)oGS36M4sY{5HL+HFc$1)CU;dB9AiB4Q zC!i&`I>2e_9g`#NDnCE9d3%+#oIyh1P;|lt|6!DwD?F+DsubvQU6=E3o3_Thu)=?N zx3XKC$LGy3NI+)1YZH_<#D;C?yB3<e5U(nXUkDi5J9sG|-8KI(<(-yEh}9M0u8;O? z`R-;mfB5S{14)>bVz)YpUQhe>)C=6VZ{2!ti#^LNGM}ID120bP#v&B%K}P&h`O=wV z)(KB%j*joS#nT+9LMJ2zY@P!wLIbr;Ahp8BfNslpqG}k>{!&hje^OQP;GWPLc?pp^ zY+&K;^lV5>;J_nC_QfnBI^-o|u|sJAsYpaQq8e1%C`%yd1SUET!EOP)IFH6IW_#n{ zySg%utwf^|PFzP=VvHw=Rp3IX>uvIjag;>Q0%;lbxP}}4H0Fd^klS6ByevU~iEGUe zeOXBwLDRi2b2P(UzWi#QgyNAOWoM1<H8}48`&2eAM{yD&mS{V)iKFI8y`PzBB7P!i z{4;WpnZm`-FR}ge6~EcWhUY5k!C@|F|50gJUxJ&S!H#J^bOpqK6#lj+vHeW#Nx)ZQ zg&N++v={UNmz}#G6miq@X5te{t-zj8LOJd~-fk;7jTwYZ`*in65<(5Few?+l6z==g zN{J$aA*Crug;2Yg9%?VS2LRD7lE5Vw<4GpLfer8Al{?y8Y0S%pmtm2(2IZ?83f~gx z3KRmrF_6Y`l!BudUDqXD%_8o7`k{?@&Lu!J+3dXFNRj}^uEsFm8heObd84gZ(6xFw zxS}9Uy=GTaj@9#9VHC<X_0M)>uBsrOC)+}i;9$gM1o2o2Zskf`tQO~2IYF}Is{$H+ z&zBmB2b&8o8eZ&w(_uf>YC0Y-?t5?11!fHUSwe<%rW9VzTLp|~h^xx^W-?!A9VJQs zgYB}~%al{HG%cRfB``RjE1#=0l5g@8pxm%q$T50@P`;akSCT1)n)6A2hfBDtB4`9s zx{{J<d=v@ipB@lGPDtt}f}%nu3FcHQS<{d|a@gbtqFWE`YTpqaydDs<i(j8~xc;bZ zE1EL$8FWTX*7U=(%hPNHU+(8K$~dOhbOUr8p(@Gzw&^b1KJuBs-!HJ>3lcM=3F=ja z$+F|L+H_C%d8O39evODtncu2)bS=rU!^_0={{4s}o_OyVAUov@G+kH%=a;9X4Jm*w zmQB_L=sZr7rI6!@x4-YzNdPA<0}gCdxHhu*b0S5Reoqo$xZeeRQ}|ZY7vBQC;<~wH zlE>di@`i38Bktz#^=7mBy7d?3Q{eizI!N(U=P4YR#TVErq&_C6aPyVA+jR{(&=5*- zsHRY+2AsRrG#+-7_IPuOKwD%g&ozQH#7~kErHZ5HJt^-vDzY)61)QqJG6`D-gzGZ+ zE~$$A_A#S@#||jnuLm+h82-EG=yAXjGrs!czJU?>=qIOND1Qvo3;afZE3BO`K?L#k zxqx*F@1mBYBGQ&bZ)2U2je}R?6*Z0Lma0vlEFQ6*I>939(V@aEUbQ2<Fd`#V%@5h; zmVDP!2y7#Sd$ySBnnA!o{qdog+5>^FcW~zA;}8hGtw7|~jAsSV-dW_UPX{)d;z<-F z=t{@z8mZ<egS#aa;x1|(PC2NE0H-NV)V&a|2>EqDLhJNrI*QBvTT<9vhBGkl_s|i_ zby_6P0AD9U&m}aUJB20<jCzn|zYn6n$q3k5;6%4q_T!JbmS{S2T{Cj}pPirI7b2y@ z92cyKwiQMNm$HulAB{psy2YgErq(r{wgx}GQ`(@YjYK&ffSlUP#R*r9E47=A!U0Vq zfF8A|r3FUPck<3&r{Jm&;ZISTE>cDM(Mr)e6+DtsvZ(HXY*BdZ7s5AsUtVp_Sp&_e zuS1dWgIg3ISNn4~*Ta{;Uc4Sk#nPVmBeTWjX`ies`S32H|E9i2XR_KO=8#O<bzvkG zmzd6-MxWJ-0Xke(oNc_-6qGnYtXjFQmW*erf!}>IBUPqQ9wQ(pC^<Jy0_n7Hf%cY7 z&4P!l<2#Y!LVb^ox2X#$7v+x$v6w^%zS7yN`Vqjtq~+`bG7*~-H5BfcLc~u0<U+*4 zEq-&l(x4uhWXoncPdb0juA6X^z~V2W^1}5t^Di8~u0F)7yK+<ax$271$R4_Et#tu6 zUxPCrHuyRRe?Gh3cQ9oBx*@!v<Nnl(rW6A1!Q0`>uVudxg+!8HK6dMT<P+KBfg}5A zw?|$1m4iAVL<Y?K$4`L!s`Hq#%4zWm<xQKCS+ZWIch7A_7^VqVvDB8-p0bj|4L$rM z9I3cXLPP_=A$*>=i>m@jL8L6DAX((5ergQhsrAv`1{o1>o%uC~!yM~?;dWo<s#ucR z6p5ZXbu1)4BayF_>Ocyh?ZOkV2W|wWri9FH))47R8Tq)-rloQIrHiHGs{pJg%DNO7 zD8#x_zO?sxGPJry|2EO1eQ>DnUlvGvzIfxs117ctBsKCbL*_@dcQPCvrkuV%6hC<E zdC|rjgP16m08HFy$Q1~3nbiG|j|UXCS#-%fb-MU2ICv5p^QhzvNcOiCn0Ggfy029{ zt=k9vny0Z2l41~p^|dzSPR@1$Tb2^yfR@kAM2C+Tf@nz@L?>VQ&s68ta=+n@0M9ca zQN}1pz$uZ!m+ww=A<*_pgFs9t`b*{w3(#9ss;C=r)UdjpZv%1pw-2AD$DfAUM+B;o zCuX1vu&TTkyH*&Wa+W@jWqN)m`CAQG4b+hbSK!AFEyxn-LSj<z8Gj}NZ6?T;==WT5 zFgur_V8hF<JK@hF9D7}pgBD(!aZ!2^JwiD8G6||Kg<1T;!y!WNjY^J0xF)#Drps^D z0)y!#g%Y3j$O4Go87jRHL&!jeY*aD|WM`Z`)1EYza!wwQwAIg>uc@4}7Vg5BH*WKo zJ?{`5mfX6-g%ol{MBi@{mD)4bi8OfdBQ=o+mYe@w_6c;lDVWGqEUhEr>fv0>Y{nhP zjT0x*F;}LQ1E&~zA>KHrj(z=m{vP}xy$^ttI@sjN&Vr5AKF(kyyy%6Z6kdAWGdM`i zr;3<zjn+N$bQZBfxX8U^@mLXRbc)xpn;>W3_Wfioun@Qif^WPjGKXvmAkef4`tf`r zPu*`L4kKJ#*g%{B$xYGqNxkLP>pzl9eIV+ijg6l?AoaKUviN=DSXoK|Sa>3JV*>CF zM@B(uV{{}IZ9c?8Vl&|1U))~m%e1s2ALAgucX_fXaGs)b2OJXPri;eaf-@NSk_RK@ zcgVS3hk&zmT>K(C1BPUFEhm9oU#?4nylJL~G^lKC7vy^In0G*u$52OUhe#|*rQRQ` zkfwkYLxI>S4|;?gU3kQea=;by&6`;eB#31Ln`A4Qr$ouGj_JOv5f$F+`=SU)h)CYs zzv7<?pfpt`snFwY=xC%YlS;=VRBj)>8M0*dS^ZGUrg;fvQR*)a9Zv-@-12mAz%liQ zYJNWM71z9Qc4Rv#oRun5_5rWn^c*PpXmBjDpxqvT(2Oy7*kAbH$uZ*5#@(o%OyD>v zIZfV=wJ3!*>4CEXjFdrpbfc73G9e);M^=NmsclKZE+}JV+DqGD=Q!JxZ}{WIMLwV% zdV@<85|RHxR+&;$hB9mm0OCSc>g&+44yzAgFD9yeP%2*}oV{iB6@rA5O<_ubDOO!6 zfr5l#r7@nw$89^00wJe&xUwV*ocsDHn(m=*CQpx6yNq8G#mAer7Jl_mvfdNuh~<K5 z0Tuu#CsV~++7947Rn(yLfa3H0058cq-3qlb=yk-`&t9Yx`+Jg#FUiA1U<mdg^&@!+ z)$Wh1n)%y5TI5Dgs=cts<(qYWU1_g`^mAhA%CA(5wfnlDac3}k%LQhAOF!?>52mT< z!f#Ll>;CT?RNfb_-3lYe<>Ui#Ypn)em>MvnUW7TMoB&QPkLcl#T(~8UbVw;T7y!nw zitsdiwK`i32$R8Fkb2X7M@>E1^5718rxTDL$R5e1;H>rluLL^LIB<w1c^igGsR1Hu ziJr~e;Royl7Xl>{@<FYnojd-eptv?Lm;Q~De#{C(A$I7G)ck#p!?|L1x<S13Whesq zHKRY@T%Eg^zRTc#su*i$@$ZL_SM3-2JQ($W>@DyQO93n&S~Gn<_k);0ZotM;8{Ww) zQu9pu_8T?qfk`uYKXoI^y9kXcXUo<VixeDdP{e&bZ9?&M$l9w05Suf<4GXVSde>xg z{v+h4TsQ*4KWhRubE{eqqJQf$wj7$U|1VISc{n8LB-$XKfGNqtVA~9mUU)TYDL{is z!6(-1X37af<!cZj0&g+MeRQllVkgm)%QpuyC~NFTH9Yc-yAkV6^zU7Djv8yOU#9kV z!X6XGMIn>Pe@zqXrKRq)a(8If2PPTBIqyPA5GZZM93aS;d{377k)JwfCJKJP*4ZK3 zx;9z`i4quL1t&blNWsCxZy(9m>GEz6SeXYR`qzD$p2k<(lGESDY5yI$_1WlBSkfc{ z41tmSkaY^)jyxe<BD+>DWTQscyyqjIrOn1yy9!silqwpnqBu}bl(g^@V`d?QUSl^m ze`IM>*GHy2xF=SB01|yMrk{z@F7ocmh9R_Ng%p55j!^h99Q2U*>&=2{*yBL2&lSNw z#N^;?=02II--}k4(1#cBvA*)dhRNq-Ked$wJg!eEtgF6x)2n$4q(5TT9|<|d<AO7J zK@p8ax4n9>lUcB(s<45Zgj|?Im7#NQYyq#v2@1g2RPKMP5GU%Ll8?UEMVM~|6?|~o z<2eQI1yiGD>WO+%YhTMBv=UB`aRkC?eT8m7Ox7E(^lY2F&dDn#c6#K{BI5f%UKkc2 z>OFDbf9u>1xzI_<vG;ej#ofVAmJ-Ayi-e5H?@e=4Uxg_kV<$`MKD=9psAWA?9R>Dp z;ODg`YXypAK1uKU?O69<>*C-u?Ca#u{e`YOBMc@+NN_u)Q<lD>mV!Ad%~nA+=paUw zqw?i7WHA6-ITh)$Hb?EkYns}I7J<JM0&e2MIl__!irT<CrdZ@dZk!i5&}*aW0y$Ms z;*m{?wKF87E~g<~R?n5M=>Wk;09*#_H$V`&l1gBH$H(E4RT(fgwXt>pzsOhx!H17n zR5xsE>EYxxQ9I-E92JiCw4Z5v&X@Pa6cimVfjN(#ENhBgjpPR&*Dw_gb;M0jBMU<r z(lU`)#9{cVx+zO34Ri%0yoi$rcWBe<ALq!X@Zm-wUag0I_LP6eovivOKz9Gy^$2nl zbKryKaR40R*5&S5SP(|k?thE3{#&?1NL~(3u+LDtEzprXNMj4dl{dOFwFnZ1Myi=d zNkEm?$TfPz{b9Z>u3wERBEiS8A6bt0qQVhXNCGRQynLAIuL)dvHqx9b@h)m$6lg>H zK83`UDa@JrVW7+PcK*mGbX`usVg=_!MIX*E!0D_ghI+T6AqV_mcg?1KZIP66+$@VO zc4|iYDNIggg0^v&QOqoTl1GMu8=(_Fd2~@&<A<su6y%0Cf0>jPRr1Sw-V0Y%?BBZR z%MwPHVp9`y7h%B-M9y7+T1wgVN;ThA+Dd_jGY=Y06e^-r$d!rZor&Y?*M8jnkO6y% zJXy^Gc){=rj3EpYf-3Y~;d=Vybs^`K1!|A=hYr<W=3Kzhrq;gjs2|@fmwY6bz<CGO zT+&8%xBz|cpy&-=y?rH>Ix;2!_~RTLUGV-xQDJ^VjXhKEuW^0&qx|5Y{*y2`nJ^aa z9bdNp?E8&#?UFNvjL``{aYy3Lm980})c;mP<Assk04LRj67hOp!X~dV=OFJdkCqi3 zfBQ4Zup}=zLrAWX_-c+~7vyntD$@3ro}Fc-Op|Z4Tll29H%+|W)b=o6lyW2@KNWCV zdh7y3t1=Mw8mf4o75~sJ1sK<mJMHWlbc1;cB8H*uh!V!f2SH{}bAyOT<;CCLD!C4% z;YS~l_K*<dN2E$1-3bBEt4$HPjO2H_cs*^w9*tvS?^ml$m%X;20!7BJ!vLyH;^#k7 zNwFMJ08#{WzF#ElckzRH4Fq9|_%dL%QfAM2<W{xSf$p|Q1-&+60aq$z8RWPu)06|p z>X^gK#Nu!K=5hk<wG^BxcD4M5ALNLSFKY|l52o-hWu$mDjI@k&rxfI0WXdZTZiJz9 z^GI2qYM%P$!a(der}Ys6YqLV($9PSSt!|~^-QnSU^N3L#xS4v;xf*yq422t;!UBUc z|Dk1j{NqoRS`Kbl?DG%R!5<I8;9Q?L4gFKSlO0%Vcn_)v>_F;UOHpx&0dtT5SzM!q z->9Z`JxjNwYt*4b6!Yd5fVkzkO~QqsqzS;M9|V)(Q}h?qI1(dE>}}suz5ImRV}!2z z9X|0M^q(#$QL%!x@i2vj01Jf9IOollYIhd98zJk+8l+Iiw7;B1XJE4vy>D^I-jULU zUwRgU;7E~55TkodaQ9he4;E<{-eSD#X^JyeimWK~ZZqwAuHk3L{ffUhHUp9iz2irl zpdD~($!cWW<rd$5#X<B!iGhX(j3n^yIH2^U**j&C_}|q)4MT@?85Cor?}J6FF$(0K ziUNaxH8MC$S|B*FJ_lkyrc-QMLR0BiZnK_YVO4@;7F7dKKfr;5FoA_Tw61BAv|U%L z3OhHZ8!H6iUDbc8MSIp{w<M04(RntHi7}yp9LW^w)FdKrxoCE)Z9UjqS?*R3*x(;( z#^&&h7r=@U{$yRGU*&}^=zo@X{Xz4cD1p255^3px+mr}7EyY+}sM!L?_3(mF2r_-} z1`|(xQvd-$fgh8pDrp<k51%s@q`lb|2<~^xf+F>wJOsD_HIk(X`f}pQQt(D{!5$tH zJ~&XQ=;JeitF$@;pzbd~{w{a}3okWC5bTK&%nz>L1m_k?z+nw-$6`$K8w%&96~CZ* z`Q_zh+bPCivRbSAmOPDT*%^2<sB8dl<MoL^7Jn_i#r}svviEk_LhY^cY)77(?D!1i zSDM&~GJaSWHWqqFzQH5`WQEP*I2}QX9h@ig{C{{l??9^i_y1=fS?8F?<{UGd;+Po+ z$6hTfE7>7CBjd!e9eYKNBk3-skRn;3l3iJGkWgm!%I|gV`}6(%RsAE5b6)T3bzRTL z<5~klxInU~fn0k2o_Y7~H_$HdEg+%qm<Hg$;^umiL^jO41$PSa$Y0q>guj)ANOS$w zt^3K}wtar~-}k9X0;A5^ryS~|pU75<&oyx&WU|;RB`_3|&S?5?!~-Xh)I9?lQKt+1 zWC;p26}9C|FVvSD&JeRGTd}M6oK4}B`DL6d;j&yI?~1jfrrEVPC#ALu-a^rsz1QS` zAUW|1EFgD+tZCOzK;)na+^znXa7Wweys<&7z;Sn403Q7>nN|DxClA}tYZ;a0I6kO7 zY)jzoaiGs9a=(Cd{m!yzs@+5CB#agrq{%ZTw`+M7T(M-RX$lPAy}S}Y==~S?kx=I~ zz_s^Ze+Rjf@%IOaH97!JzyS>L-Ztnat+jxc6t>{ZSiLFBq7F{3_MadrLVhfFei*fF zr;KA8%94l$S&L>cPHzU?f~HTh&3$jd&|a*Yavk+m|JZ$nq3!Q+TU-RA0@D3tL7^S@ zB4X?2R<`W*mZr~cn*Cp9I7gDdhmnGHyBhp({<aQV!U5a~nHMb@a{dj0>*|4T)l~Wq z9Upx%DUytZH^^^+nfv-vnGSx09UxMdKjzE$_^lPL-ooDo#I4^@$4t~#x_whXg?+sz zo?JbUO*l`*ZaW0X0fb|o>;y4cG&7zfE6c*BBYF<=(9Qo>1?B1`P_bxm{08wMnD2D> zJQG=M@$Z2T61K&$T#QhSWd|FUW#E1bBSR|WA##MqMQ~5ty;!pa4%M|<AXXqt1)IpZ zMzuL&DUa%HV#wo7TrCLY`iwoVkf|K$fAjA6PwHwC&a&|o)WT!+ER#1Q!>?`~kkN;X zDlmC#l<^KAoAL;3V**FT;0)F80q(}0HP8lXl(6~9CS&6L54kCJ`H^Ki!Y;Wqond+s zTsY6q^L^u7Ujg)q?c*2V%h;X;0ojj5unKT{BzMGiRcpCxmT`UH%HH63vAjIy@WZcr zfluH&Wp{o_vSn_5?3pi_a78;xbo_h3Aod5DtEN4o^uTrDZG%24K4FfWFu42cB}h)q zAPSB^qhZwxrm@8GJ$yd>>pKME_+L+jAw5kFN#5jQRx6nr^4jYbEQ>kx`fd31T3v^| zdhq`hVeob~8{g~XTkly&GMw8WooC_P<;Op6y;&A}1^PJbsm}mN)o@20hmAAW1Nd@d z^Pi7WX2BvnvAAz!IELDQQII^1RS(~I@a0(e9(#|H`$u*%7i*%Bckyn_7G@9WZkrkW zo>+PotF}a}Lp)WOG|1}ejX$Fna~!Tjy}kB*G7(&4i>lS{M-pO;L>obfoXvAwIbOld z+Lla9iItMYQj;ThUB&?~BK<4Q&t{K7?>m{L4oQ<|XXHZ-lB04QfL>w(eM#(3GT+^G zIb#pR>Sl~82SH6U1x!SrCrjKxc<n-5{?<GX7y=Dta0~B)n@;_}f4MIb*|bCEwBLZV zpnYV~E>Hg*@XM)DT~FSiGSuf&0iZ`{&=U2bII&j7@<FUwDoIzc3Vi2ZXDZkAPqSMY zPdI1~BkS-WgOVD*u(eHNG`Y%xQg#UWaye8`?|-R4^8fXL(gkJ(8}KKHz?^`h$klZb z+--91zsP@Nj%_33xIyMR;>Eew!xhVcX%M(%Fe%z5h9%~zx^tkJ<YD!k_|Vmqj(?uB zLlXZF-0~V1`Efa~J(hU!=QT{biTAnPP0)cTdeu<=;xTxVh=sFKeA2>M>ZciWX#j|m zEJHKfcrQQi^iLB=9VKwzMu}-<dZ-9Y6CaSRN%~w!ji4BZBeK;75jK8txxki7p%El1 z8#M``M)*F3+xM@T*RO%wr=M!i%p)tLs>i>j1Q!15?i{*T`zX6n*!D6xVeX@zx)Hy7 z(bm0JJ3&co??aMSGK3%ZG=Y}sg{dJrZa&NSr!ei|?Yj28lo)3GQzF~LOX(NEbM6~o z;<Ej{|1L$~D2Kod$h{zf0*tRSTDuDbD5s4A^LniavZ{25^Eo~mx{$73SOJ$3L3-#6 z<UuPc#j;4$gp-XM2DMF8U`T*$6(tE78}irXc@6*oqohF1Yo83k$~KWGuM#n^RC&?j z3t52Rusf&FXgJ~WFuEdpUjNL`a99w`gi7B&|D|kCXQ<mPb!e^Nr;}~lsQl>cvqcaR zP}aN#5KW=wAqZBFhs^E27Mo)Gx_~;dGvs55myx^&OMpEn2W9OfOMq#_pC5InHo71N zak>?Sy(47(uTTqNEi}hW!P2Ap?lTy}`CXj2gIKM|j2kp|iVIa-_282Qv6t&Wi+bH( z2IdWI0wB+gjF(fXZ57~PnzlPlT+f|3MUFtn)4`}jgQ+O>QB^6=@;#-}ecgXPJ|n+! z@15bT06_T;rZgZ=n3T&$&R~3b!9YvY5&6tK?a>}9A>1<QS(^Mq&v1jx5tE@^6+_%; zlAUyL+H}m3pTGIO&Zw~DtxandTDg{u_><6idO><<^lRsKO1A6KF8Bzz*dvY<c}}Hh zf87oBj3!L(xo;G+FbtdiW5-$+uOKcNyBqws)xPpkAw+iW;{HZ~PSjIoXclXlx$<%d zERjt9t{bS$w<O@sRkhX##(i9$0a4`dfG{Ni<leVtMm|e;_$SCOq8EU4VLV!#z|o#_ zbV|;j{5lt-uIf+l2LzH!YUq1ZTSV4y3eGm8Cn-#*N9Tw1VxMX@YmvltZ+*Nje3KJj z5;V)7wsZvg&tseTD@9xG_sOv#gp-k=sj+OCc%zx7?XS_p=dy@EfJ#2ml5q{X-R^b_ z03>6Mflcj4<6Ww^`4Rjr`w`d4DK~%fUkR}TVc<h!E4J~;fnEK0dV^O-9X>DhF2aij zzm9&fbz%YtEYe=`BOqkJ8DKn&vHb5s+9|~^zNmEo0j96D^Nyb)3uXd8UM6+r=MUD3 z+>>4XyiI#@=8%otZ2+8R2*7QguV}VK&z;D*_JsZI8dthDs8adNFcev8^(j}<jS_Wa z1X&Z_)jkAiA@Fo{I}zfuTK;FKz*rLZI=7`F*wpmDi8K&qFn6(9-vuA#FC}a|k7_Uz zmTDi+-{@hCP%Yd<7nE&{iXciUPN3>ZtNz<pq$G2H1l%@nZDms}H$z{-1Yyd{zHHp` z;Tz7pxIU3{92UXYO9W+w3}<Pbra7KrEAg`h>tfT(pbk;N$3m{9IpT7oS^@8M6D{m0 zCosr}e%eh(t1vTCEMXJFu&*)qSa7!3VSm-N1jQ>ac8+WQ3_)TsNg|b$V3|t7jeS<d zD;FL*<A&fAO)B8WFSgwJlG#_)Ewv|E=zJ#m0DOupnI=d&!Av2UMpo$%i?jZWo;-im z1N@o{P>RqCwY?(XuuWb7lZ@wKkZ25AWFi_xWlc+|V?^YKB(^LD-XZ!4E(uAtU)Xsd zs1iWZ4zhk9!9JAR%0P*t%AnA~{Qz~(pNHmgIWo+TxA9AQb0SHVk|$N8p06Z_$(>@{ zZScZon}`^`$!5l}6ChH67OPWH**7heZ&&L_*M_W3jdwv|4!GdAr+<&0j<DBSUfcpD z@r6z!c_D8Y3}n=twtr&fg0I62p1s|*OC9XI#$Fg&fcpk6_#&#q98I+4(Yr;-l~L8> zH$gk4?@UJ|PQr{}maL{<ihi{E^=V160Wo{-zV10kjh%yATHAwqyUp5Mg}wK{<>J~U zX|FIhsv)IX%+)js@aSuhut%Fy8}^sa@G*LY+lZ?S=l#~l$}WD6ffd4DCgZd<#EJ`W zPPH^vjio+hCyALN<ps(6Fyg^#cQ4uZH_2SC_n_PJ66lwt>i#UIl^Wgw6OZ%$>!aA; z14;zUx7;|l4v@(6A7FU*N`v8V*tIU^erB|mm0(&}8!}VFHRDXpzX=vZFcvYKXU$db z;&tTmPkUV29%NOs^zX3Ul!*ntc8ac))yRb$+_e*o)1p~D4rt=SQ@e&dM>sCKfrNG6 zp%$nFm1o%lbVZLiW`s+B*98q{R(}6wC~{=UkiRZ>5=3whEUa=ezDuJne8I`aI0|3; zzdM2<;UA3bkn|f@=_-Xxe6}a5AI9QV=0zCYXLJ?(wEtJge9*aieg{;nB{&^w!L5xq zBI(|yLwWrNfasBSWQW~FKN_-XdtiR26y$>^qlP(!aq^#|GN|149$8gRfz#y1{j=2n zkU?$h#1{gt>@!^b2^mR(Oud?&Qd|R;yZUcztX~e}GcPr<ptoo$-Pq5Cb2jab-Z)E( z7kP90E>v}M*f0PmIZ8waSN)Sxpg7$N*WUkYRg#yX@{KP6!XE{mM&HWapB#~c$9qZj zExw%=pMTFFTPGn!$F$I89$q+8co^cvAI%@?9EHZY(Lv?cx_4nEs<J;{TC@(Vu*Bsq z#Q0sImSt3pvnuvY@T=1*-x?@!BfadK-zw$(z4?97?zz^`o0Wo)Yu$fev-G)XriJ^K zuhz*v?|XJ&tWNQ4Js0N-rr+jv$+aydWWfzt;6U}xT_XtLvVVOxc&NrkoOl1N$?DQ? zPpIPo^SovJJY=XdZbRTlF)M{ZvjoTme&~1A#VW4aO_;&Q4n9}LsI5LPJYrJmooI`$ zwXRBO(2RJs8ACcTZq8hcJ<^G+2mPI0^Dc^{PzgWu^xc*uqo=qWrqv1Uv+NSiTaP%_ zI=9Rsi*t8wWVby^529V(chgn-10H!L*E-d6CL;Lg)@!uG#b+(Mwm!ZkzGbtwyEE~= z6xnl@FA|I-$iVUH_e_j#Wa*yD>dn*0o(pq-K{ou`L@VkF*_JhZ7o~*1mAyzJ&jjft zCggyD<>J_GIA?DP>|FTQ*D)0Vmq>Oppp)HdXcW!0)iT&UdpHz!R%|;bAf@u6{v>i3 z@^HzR{w&{q09?d`aYmucV<NF7j2p=}3opngat(1T8WSYE3bvSgRIOM4%?maF>TvfK zsf^V0F^p=z)p@>itvzbjC|An-mBLYR%c~{v4UKQ$0x(^0JmAl|PE+b{lk%U+2tWyO z?MV{#<f};+gi#N|2j7IQ7;zb+`R171c>bVYIHw8mi(k))V(#SdN-Gj%OXC6~H>{}s zx%-rj3HZ$DAsy|d2RS`&Ad<dxaddICLtHS5SvXQQ5s{YO3hDA#eiS6@n~<SyAku<T zD0azx15#*Dl#*@qh@EeR2yzZ|jA^Zf1=DSqxGimC{pPU;3F)X0jYi*7t>Ai9{`Gpt zU4tKY7S%bM80AZagj~k-rFYh0GkMD+)g?Ndcq!RyGwVx1w~hs`HRIjfn*Z)9$i9@F z^L)_uyZZdk@O_OQZks|E?s6RzP2>CZw0C}AJtq4W@5q-2xiw3B2=XDfn#})dG*bAM zdujEwDadEWEj!Ps!&HSvkrP6m8@`*SxUTkwx#GaprbGu5d~kTuK1@oX!VE3Kx+?hB zP{TwPf`i;fO$}=4#p+>1cy+AT_*b8e(#|WGE48f4|G6y_E*`*4Y<hTNJejpCDul>R z5yW#R$R`F&RKZJN!QnT#afrD$Tej1Vaf7Wy{xqmzdLY&kYdle=5V6rtX9m%)U$8@9 zZ<p2wQdN9TCmEY*?sAs|mJI}~lp_7EVQsA!k>_r&s?zcOgVOrCx!3-;aNzv7p=b5T zt)4)Ckg48P<%4_mARFiVdUjl+OU0WK>&x|Mj@l(z4d=V!+eqb3x&g8dEQjny_dI;S z<ZM?xpPltkc0+n23US;M>X5AY$}=t$?x)vX-|6|!P~(qCv&i&_<%WxRyTQy|n&64A zD9MdToo<1KyB%~f;(;lPk?qa>Nipo^e8-_A?E!xk*vC5hM=0v8TOAK|cZD1ECp>*c z)BgVz2VeVO#6r!Qkqu5M-zsc5SAnaep!x;eAbs=va+qK0h(gysq2V)eZ0jazmx++7 z1U@!|wSqN%j;)gAeq7g``!>z279m*ZZYBjoJADF;tChpxa$8d(1rd})`L}YJX+roF zOzB}~p(hBV=baKJm(((t;1ljstjqk<eyAnt&iRXPI~tIW2Qx*uj1rVth9q#;8Hr6| zFBoStJVxj`rB>w;?YQpF0OJz+YwKl^YjwUFXq7n!!xDNoDXSl?&lB5EihXM9cDa`~ zyaqG@KrMzkL<mkkIMElQ1D$*o1f{ikyq98zP@?ekkO4A2(bKYVAO^~=YEYI+z7e#2 zsw0IbbqfA|;Y0{aJ`@=~yP4C77=S^oKwIXS-6Xq9b{Lnr3Qh^~c%^(r3|<A(9ls(3 zsjT-<Wk$q@uWvdo!ZBu<g&(!;^H-Hv#B~H42efMPdg=n@nriElVA@o(#fV$C2XOW8 zo6MByzjhAELnj*1N5Xe#d4}WWD+Dwa`|5&M#)i7leYdCU-zE1gzI1rkHcvw+Z%QH( zh@aEv5r}h(Z3@GjVpNQY;noN9E0{=r;qu=dQCR0PWLW|zK*ml)?Fv2OeBPh*%(6Dk z;F?x4&!1=@OXa@hc%(!QL=ilasUO}{hJDw_)aXI6K`TrzVnbfb62m<lPq|%=aN~Ry zWL^iHq^nxPiL>19Grr$W1<ovDn?41d<rDW(v(225Ao!i+-UkaI8XlRfNzHWuP)Fvn z+JMy7@?roJ;8VON7mknDDG?m*40G{Ey-Mv$X6)zZRLv>3&7dvgvL_0=pTcN*telUg z)Sb@!JWh7)R80sHOR%&<X;D)dUm?K_w*>|$+{O0SZeO4B|9Q`P-(q0ny8vj!o%EAw zF6GP_3qIo}@z#+_2ury5d_An>CGETMmic{0Qds(o?O~<D>|TbaUyRN3gTclJ-(!_D z*BAcRlLbQ{spI<d@Mjpg#DagyyFX;2Mc*S5A;V2pRCt4n<y$sAP~oHkMOrz+ch`6q zx&#_pIa-Y(ZgH`voCfeTJ$SNwfJ-o9n4{9j*Q!B_Po*24b^*SFsWV&5cJpY3F4MG* zz|SgN>%p!g5={_(*~KvyI8W;N3%WFfM2vugdaVobEQJ?SqSb_EnvspU2*ZU5d7^8; zPNnb(?kY6{mIsZpc4Lb(Viy@Ih1`JP>hD7TVlJjyCbk*oGWaQ{J;S~5&5Shkc9{r= zyn>kFa&vD!;O|zBJ^KA^)3EKw7UUtHcn7yDw<I`=s70+u|J3T-5Kc*1&=7?5p?(XS z|6!hs@=8Fo+-Ab{qA%&~SN-KnywRUIZwPPuKtIG0STNcI>BY4w{GMiOH+g&;tv=CQ zPo-)&@ys-bg91tc8-W^AAst`$Ln8Q;@Xz^_bVawKhlY|Gm0TqVRqq5~ZuJdrJbkZ2 z>z}&aj673H^E#}QVNW11&x2w!|92)8qFhhj!$|=d<b@21!d-C?UsLf5nRtIA+qoH+ z3ST*isQ(<n4E;E+viM2S`r{u)p_bu%(zq_BY9=;o;0~m&RB)A^@f7~&KpG*ei`<gm z9a$4fWu9Xm;2n_NV~)$&flfd#tJ0Q9_2-=~D+zT8D<du;;9D9b=Va~VYpGcuPUgqA zkXhVxyWFTNhoVn<-p=hq9aL|jFJ{E~=ug=1#^Ee(Tv$xU#KHSQZuAB9H11DtI+B3r zadco2MMYOD9FN#zjLXOAt}zU7xJsF`pc-$tYRpH4#jXaGZaW1y>yIroXDogGyIdJ4 zh=i5t)KV-aHCfo_%_vcOmIlMRPJRo;(+$7}R(^cQ`3#HI(jtXR)?Lt;-Glc8POG#u zN9{*<E@Q)($5Zyr7TyYsB-43vZTxk2{Mxykv?oFJ&a2{o9uq9)>YzlA1lEOCkHH!D z0GT;N;r0<=ke{<+b(kt+%WvT_xS8&%b)_jVKEGe+3?bO0Z=~oXGE;(p{tHGu)=zNx zGcFEi)R^HCOBiUJ$?BC1`T<il#wbpzvj(czD~wWYQEFT8F!_3y<Mv9v^-#vkx<s!1 zTbqu!)z^!W@j9GI^!l&QZnCtT?oZ=>v^UK2q~z+@r`2adym88CRJMWqAjx<VLXqMQ z!QpI)Og~>nB`&~6VX2tYOiW@dUHzh`iHmR56={T^D^gctRgGEzErhj0+nfezt3&Hp z0_iK5=QVqDKC5aaG@<LoCxstpLTobb;T)*1PQ=z<gbhRORb{n$l%ruV;oL@{$u?5j z5+*Wx$w{l{PCa+vnI9+jW(#*+O*diJ%9Uk~(9&X06?;<lX*8bUoN{YPQLsr$7uBAQ z#go+|-I|%uU6<k=+qGu{g^hlsw^Z2vCO#;v==IGQb@&h`1$4GB^1}&9YeT>TNB=Ex zSAn1ykiLJ*HDGZXS&Ib1oWcH{8hi-shWtv9f84x>BZ1VUTv{%8A@xjpVQ*+)8oF@7 zw#MQ03qOXTypunCTNhVD5su@^15%6Tli0u1lu|npFz1tbJxfDp;!NB5PuB_*dOA*V z#Fd2K`q9@2mTdN^*+(5OdsUxn5i|*Meqv=@UG7*%?5$eWBW<*yyr`zqUd}+E-+t@C zViMH2Trz;9y2#fgTPoO3^Y`uSQR;&}rL}=nrY?8tE2U8A$^jpx%*+9Xb`e@DHDf|8 zf)4r^k|oR0ZcpUnyScymV=vc(r<yKi57y-N$y&67;YH}CedjvwF0@qcx!*?fs$pl( z6(<d7%<uhlcixs9D!LdG-E_Mz|MkDmwQt1hB<F_wjm6W<(;J9WTLN_F0O{-6Cajjb zt@ot!{QWx@MY+4#(rDrF@?s##_}<&lWhs^30FovZCGgC>MOwjmzgt`_5`Kb-=v2N& zm%w5m)g_dswvywfb4m35S1@?}EY#DefEv^(2Z>w#Im*e(t@a3)dJ4o1qY8HW^R*yo zLaSBgLkm!$=I&@tU0g0ny<AvY_?+;Wp~g)b<u3UNoz_8|F#n<w`W&@NzHp+jfUxHa zW(1ep=~gR7pIs0iiFyos`s>wR)S`0QTb#Mpako|E5ErAD6RYYM;Nn!8WBX#f&Esd` zJp|)OmN2xt{_|*EI|Kaok9<?N-1>G^Jz^}lp#*qgW<c91E~fr;jIO6!c`jiWxq6-P z3+@dBTdxooD(fzV^60{iO(gSi^{g6N9%dvc=qsKUQ`hz^9&Z^-^XZX1phd8O*ZEU! zXg};!)5bHp0m=Xk#=gA~gpCbndn!Z^VP;g(7vkECrlZ;`4^``FS2!48mtXY<f43UK zQH_ci{FseE^Xd1Bc=ITfg+N2ybhi~kLQigsZgWK8af@Adm4!AUNa5Vb+&_H*7Rx~* zKkbnD*&p*Ge=tm-!-F!kr00u7X%tUH`{Nc1eU{hNH=1K{X%BdUNRcbgIs+B=dwRDp zqeXYk19dLqW@rd02W7%7LTX!628vT|*5{DjBd^d=Vhc*&Ak}vGsDRtTJL<akoh}y7 zoN4VmPW<DLvXL}%e%cm7Jl4X~#LpP|inP28Jl~!yuC<^3<5g*7KPmu|zWBd23Rs-6 zJkOKsZzp~s4ybBcanJ|z<|33{KJsbK4%*@Gd9#BZ;S7)Nb=@Wic^10CD}vHCDb|A- zL*a~`8!zRYENRjh;Vv6vJx7tiUT{-;Gu<v2j(gsgrG0V^Yfli6C%W9|!X;f*S$-vd z)|IbPF9XlS5>1eX;*Au#6<nq|Flb`D(`oXyd+_-pL-Fgl`dAOnPFEstFM0~f-|g?> zYY+*BGt%|<J?Ust!XVJTt?CnZfF*Vpnm5x|K9Rd36t&qe+%c3Cffi)t{<O{kYTL`O zyfL{9e~9*9k1;JjIYF$j(=iRT0#<RDa>N|zn%;+~r%`~|_~&l_LpBsNj7N=`Kj`fW z>=9QB)F3ABq<5pf)V0b%yJ^ai4TuKKWEAn_(-@Z+>?Kq|HFFFRgSy(K(cfcXmbT^M zdt|`3pmA-0>;7wt51%D;f>|>XOI56h^#$B7?{<A_A~}o+F49h2Y<%B<^v-vyKFQoL z&lMY>KAJ5aUSrYtstseMtd3AdSzs}>G|M5}&<zSJewQsEfs|h~$2t<y-OfHkF$wWy ztrdGfhB)H5b+S+1YtRZ#H}FyQuxyJ$^-k957rFOM1LdMB3I|xDKfW~bb}h3xWJAIB zH_|rxvT2LwUA0$4hVy*-8c)_Kd)hbIhRj56lVW>U1#L|CYk|X{5yf@avCH>#sww}; zr?7OjW0XqP`y`$wJmX&By2*pKkN#{kqOFUFgN?U~;|NEkh0rCZ)ZT<h945mI8+;6T zetgTNy1njw*ozdF=~Yy1*z)lE6$I-0K9#vbh1lOpw*QVY%63S+ys?OcSIIF21$!qG zzn%4lD@oh5ipoMw4Qs{oXLJlvCC48%Z0q8wO{|(v3^!3zM%(4*xH89a=%Iz+iqKo* z%;h?<JLy93*bQHCS5Cd}dMuhZrkmi}s8H*+I=_rmcD3O1^4ZSP?Wpc3txr*mUdIEw zMi&;#xyn0HI=`N4&!<9b=m!LAcolpP4bH<fg?ybypV>7$=GF$`qt^ibc!0=2)Cx~z z(SD(ug#_j<pgz?xuL@8zru}n+Mc9>`zxeuB_)iuEod#AM;SOzpBRT6d5rzl+ZoEXr zo8`D@TnOA}o)VwD>dOA`bD|LLc@i6ce>CbNUMqLr@Qk}tTz>?8dn2^tSVD$C&#feg zx<bucO9x9Xr6UMfrIrfXT6*3^IKyV&tHTYoCc0xWhFwA#R;|~173M@RKcuW4pm~PY zs!sYEJ@tb4>J3$yyDTRL>uZeee%c}A%lcjFQk)oZU>MdJzWMXbumI_Az-O2tN;V_m z$bg;A%A1d_$Jo9kGVKvAi(yk=d?@B2|G*AOiv-0!_;{4OtF+h`RYp_GKxGiQYofMD zY}@L586W;B`sd%EQnWk(P(MTW0@Fn96i07zmr<<oy450kx=w^AhAfO$)H$g;6lo`{ zrXm{`tG_&aJJ9f_T&`A=Qt?}1wD93=nb^?=ROFv1WXDUVTFu`>S4p-DTN)!#%$poK z#cp$NXw?MHlvnUET<~&Zj;UAuEe%{^X#F)m(<XBV-WPuZzK4r7<+lZH@Ec+lkHe=U z3{LJe;LpBe*ggrM6bezA5yc9>U>iEEY?Z}7yWy6?(0Wm0MuRTx#3z566sfbV_KkU; zpQMuJV|*hl>K!*CYW5XVHOKVtW9H2a@px{J2=A(`l7c~{f#&2H)tJubBOB8DRQ-Gv zVx7r?$_o+XybA%YCK(<yvU!#hO`3h1s-OuURH#%kOVWT3Mu?d`@h^mapkfI@NG?Ce z<tBuQ(bBX?Z4R?1C*-=qVX*2E2HbkE$g;128ayu0l{DUCxy0L}|D*G*sC7yhO}{|> z1y`OMdQ31i4SNVBo;gvZ)T1fChQ8a5n%IUB2aY(Y&1h{;j2Sr-z;-EM%Ggid)pf(% z>jtMgXFxVmEo+8@T7|I|^+8yI<ZIAOuaMcO=_)kGZsme{E8HjaV^g(D0&8y_hPY{Y zlVUc0MTAdkITZE@TCo4Nqwv#iatdJpoqJAKa1lG!8MqlyE7$Eru#Jnk45E{!$NG%A zKM2<)x*dnPUY5>3c!mvxyD(YND8Q3c`L_1IBUWVyA~VriNzSpjd-91cg{!yCpdQx@ zx`ZX!4&IVbUcAD=FD_DF>`z)(>WPCVEv4x(t~>S@{O)*77Hro_&Sjjg2(<*h1>TOE z@z7-tn04TqULjI3r%`&S2vRkwAWE66_8Q_+THxfLuU0<Adl-gh3o?~n<ntO4uD$&o zV`D<gWgUn3HEix2-DQh)T2m6bHP2_1d+y!QXzLFZ28BT`+oskjWUW;B{Na~c$H|NY zpZ8H{U+fk1wXSQ7e_|ecU5r-h8GmA{)U4%8H_MJs+nVE^Z<5&536?t2yX4NlCi)xC z%DtK80c*$qHt$kGoFDguDyce^IW-!-%X{Rv#^#kWF3=OZ^mC6Z{1){4Yg#lmgIlS4 zO?YwO!u-JkU&NKy)hi{xyP^#x7LU4AkxPNA;kByD`9Wr{LxEcP`BA@8YNaG|X{q3b zEtYu=Il#9k*sdwOZyxA7CAAyZX2Hv)PB{RZfwj(;%9%6X;F~M#9n<42T+xm4fW1(q zLpva5nwU$kdbepVa4+m3uR-tihrPe6)l~g=9WqcY_a*BoPC1_ip_#!JRW?7n71ho4 zGU9Z@Ugzy6to5^Qx{f`WS5vqD{7ph0CvG|Zu-kCh)YvQ$8D^dqj;cP;G?6@(-I~<C z<HC0d>JTB2Ojz7YZ#?5i8`I+!Z$m#L+>OrN(oCj*_bP7Y>5q<e)pc0wfWm($BU+W! zQU5l6i3fleVt@m}v#blJO~KWdC60#Rh!^eh#<}cxE%>4Qag{RYt!JRWk%WdW901+_ zT$<noV|K1N1cCKP#}s|3V=#l8Ee=*G`A!F-`y?}~rx2rwwMEluC0MqHG3d#6q&r2j z1yTv){r0O6(C^_Mb&PK3YHY|u*i)p&aP^;A)VNkWy(^H+yS3VEH;>W!dF>`kbeyj6 z)};r{zl7g|3BVxBuL5LaR%6i0w4~#M^s0AV@OFACm7X?bs#%BQRl1vnZ5wI(pBhMx zX}#}TRd12L_XV<<^(x$EQq@ARtA=IZd#~1VkHFhh#lJ2bUt@_Y1hrjT^gJAfR26GQ zuH;0rLk3tng!e%E;RkZktvHg7Pi3*M@!;v4+Wt@9eug-{&Ai3<fk1&LpHu@fd^3Ny zw?!O&3eOCD8eJ`1%cZM!G+(UrIRf$c_C<v!K^K#u3q_=tQ5n%2e9udL!1*7@hy0fQ zyIl*mfgApDEg}X+Jti<9;7ZdWH#r}9FRM%8Oo!%T@_tXljf+!ZT0M1#dnrDj7RThi z#r+=md$Nd&Z2Nnydy{qb{m#$**J1S|O>`Q_Cp}y5cU(2sV3R4U%}}l=&ROidtDpl_ z;|HbAp#H!>X3!bC7rn(lcd-3!_WJF2<JB{3q&ETgtrI{-{y0PQp-kV-pMjhi;CU@` zj}d=e5Y-bdJI?tnZAPHgKkD>AQ~!xE^Q<(05Ze5O2I%KBW|V5_1{4N7o|DwO!cvab zPW%77omXA3+cMpX?DVHzm;AaI@pG)npO0ZLZe4Xis;9>vJ`;EvDd0zK6a4-FNVQNF zn{UDXfM$1*HlySj+0y8!q?$s~gZI(1JoCBiyhI7{g#hE(Jxg+;8G<(l@73&7@Yd6< zzP~P<$ayiZ1Ord59iq7Jl*SI17^O*PmX~!g?RbtIl9R!S4CU=fu3x5|IU|6%0~{F{ zx_rd@2KB5kTl81qH!f{IR69^cPt6!z;bID6<Yga>9u6wB(-rXc<RzWhGgww*3h2{& z6}i9rl;QGY<g~|!q{vi!`3nYAAeIWAp3EbHz&|n(9%e1m@4D4B?aA)bQ3PJe4{=N0 z6NAJ*1}*b@DjT*W6^2>9lC#UDu=!*j3+7pgH;8F6E835j2&kos7M-BR?MTwhvR5;f zqG7dx+S;D_`-^tN(+kDObBFyD^)gV~6J_}mUTU2+8cLD9Php9qraCI23E=6VRAhyI zH)GeJ^z(%k;nDK?SNTSPB-}jJ_dN`P|H9?^+FZJm`ypU1r^U_N!}1!Dzh~iWyf~7> z>HnmDm>!U``k+tv2SP^<na&}y(O0cQT+fSq7cDzL7to|UTh<8{)uox|mb6yAJKP<} z0yFipM>M&%={mPPGDTBKeo$zH2`2@nLs)B(4fHkRi2)|fnf1@m{w@#na0@Nah-9pg zqc;Gii#0I#Lol|qC$iRD_KHlT0tXH%&NHEnlQGcfn74~{T8=20{<Pn%30K>~3p?mN zt9?VICdrMeh|Yy&GjnO~2lN&}YCUM!lug*wo??*?J(%0Eu3`0LOdTiEEwEsCFhZ*n zu%MX~B#e-v8o<dl{<)71U}ATK9X0LZntTPTZD_GqG6Z4yjZjLtz1&cSBT?N}Ab<;X zI+57GAPWgTz!lV2mel+4Z4W+H897uN<>AHkM>^|@noP1quo-XIB`~i4w@}u_1yjbK zOT6HH!L^U<7&Ak4$roI2!x+n$3}2!(D0d}w4Pq{xL!6`1m9C+Rp63T<h{uqpjBp*8 zy-~wH@b=hWI*ZSa%2$gW6%;Avq>`kygp~<Bwpq-1Q}TfWqD#>ojL3Q<C62b!V=txt zHW*uITx>O5kR3u1C!H(w5jZnHV26l6jGw@ev5l+1h19(tf_+b-vO%4cfeFAZdVw=9 z?Ds=TYOa=8x99b#-xz-&tF&;}GZm(4vMthov0f0zYT#RKE^V%Zx+L7ix|8yJsXB(a zZ@Z(xP`WC*bC08)lY+wofxe8eJ85Lbm)6^cuRYo^6_e(R4j4o>wOiaTy*|rh_2~et z7YhM0rdCJwi45Y6>g%clF->%||E2f-d$l0K#7^>BFMSp0Wu5I9;CY$?(2lc}^0HA> zIzw6>x`y>_Y+O;Ar~=an<Pn-Z;4RcgLEG(o&vT<oQghU_7HO4mQ<x`JIswr_(qeN- z)KRy@S@_78Ap^QN%*3!bW@vY~lMogWI?Mk4w1U;?!0!MUx}MVBwnkDONbB-7IKqAh zT+zX8CxLWMgpYwNSvE&DQt$$gmHrMZM@nz<e6f>?`fJPTLLYSQ4*&)FO5TLoejvm_ zjKx?9oG_zt@o(zvLSGSlNCZH>hKxnCC>Frpkb1WYemz^7GQ%?cca0%;;&*wMv4Nv{ z;X9v<pfY_8dhFug@1QET$w^6cF8C7xP0J$=v`3atXm3`4fAR^vm6yD?6s70OPwEOz zNjOl&EWMN*cdD=ABD?WQlsq!XYx+*UnmD8|<IamHp3%DuqPN2$96X6V<UMN>s`xXK zNBhkC4G-ba`@g<D^S{uAspkE>d@ou6fZ(aDvr$HJX|u1v=CYfXJ79vDnfwnrHVUK` zuM9A|Nr*`kF3C66F;?6H=DXeFO=%*Bv79s(il_5(N)8YWk&I_v7xUHxfzGc4sR%i| zrf}i%z2r4<>pVZUypKnp){#PD@4xMpUA)^`)n6_1d69DRIxz1-j2&0%P36)gJ~oIc z=I&|qU!Kaz)xLA9-wR-;AOh;0ee@}W`PHS?`Xt;>qFHzJ!*1yTh*zjrP*PA=r2Gg2 zRR#;u&A@Y!8yHZ|?*zggvb}JxqJ8|Yw}R*<@+L*w^U-ior(RZu2vy=1*+|_%fxeoy z8s5Un#L4wx`78F9(vx{!izwD+xv!mUyi@~ZZSCiD2dD!KE&m`(EtTCRJUq3RPET~* z9syeiFt7<*@kF9jR}*MBeCv9JiM4x3?AS@KIyQGcM!txfs7JdS2cOU(9Oa)_{m#Gh z6fRKn{r#fnh&3-~T+Y&0GQp=z4ppy@)Uf!8A_A=^A(*#1XwP4zRm#Ayr=k~t(tiZl z3+sySX64_wQhPJBz3-r93E!8Kz{8LqxYWLg8EVhp=PXQ*%Y9j2JxA#R4`jg81!kP@ zfFx;`YgJK-5+5$5D4~X)Zbw3|)zleJ;{NLTUI@)O>&M5p-82mu27=4?Ms?~_?HPvX z^Il1>xrk~Hv6SB=`RE&$c<BF^s8s;xt`PhK?6%fEiOR%F?{VitvywL;zhH}0g(lY` z__TvX?<|os#Py|h_)=LjYxLlctn2}o^P3}{`f6wv@_~0Hfj$sxhnf9hC7aFC&5@Qx z{2*$VBY_`Pb`>5IzVgSMAq+RR4m@z=waxDLg%J1l<Z3Q|(29e8K=J5bO|ynK$boQU zs(Cmt;z=84kK%AY74)xu75C1AczZwD0TD}r4TipVG2ka@nvG`oslAFy*qVdV)b8(Z z>qLcYPuKoryJzGTIMwAbZ$7hd)aM0gZKTiC&<tEO@U|9tsO%8wUDmzO0_>{zGaa1c z982QJ{UP%zr?g7NhOUS`@S3~Zk0Pr-uN!_lWKM4BoI5hBl0!c=!5R<uTfd3bQlCWU zG8i=88-+U7on+}2>~SHKLM|EY@k)DA1*8Ws&$S}TuGUz;pZEt)Yc+I(k#N#`0l^W7 zx*3jNI`sb^u>q`?FbF?XL(|9|Q=R^hR8?@@o2o$(cdhM#QIZY$sS9-k%LQCIGH@DD zVfiy;{b$Qp{q49h{gN}A_ksgzj6{-a$%qfXIBcfH2RuFelaQ2FvgqJBUsyUpDshsG z2sMD6hA}K_?@nWsVp)f_z(cm2-7%1Mvd%4uynxVMnG}{FO=kgc7o#DLp?qbT<zTPH z9gu78cNu)3BW8#EfrvshnuFa-Y2R2hHne;1YkEpaz6FcJ(3~w6o+hMyEcD|#Pbe0Q zj<1QGo#r>Cvk6{^Hh5}|fPc{40cn$FAicZx+1UD5xA>dGb;AjJNFXWzFY4A;sPMJ* z0rO2``l_XmM*?w0x$n?WwwhFa$~x6+wrl~udJnobbCfyvSX@-#R&8E11N6$JKoU`` zSq&CTgnsX!Pp<u+%O19X31+f@DlJ2@@)d+#A4;0x_P=^?docm#+K0(atsqz|dXppb zI>HhYCNgvx3+f9buf_(<{LxVj<l7Q9>;u`gM&Kb_^=369NY(g9oMulj>&fa~b~bMJ z<aAUpAX_8}7xwwvNE2XpN;4;!r2Y~qc1W$m;f9c;Nlp{j<v^ZymBMQR`ssY7v>#_< zLck|~M!c>D0DXee$F)9<iw$)}$^J_a;(8OL*>C(3x-2&*nxO?L8nXy5$m+Ns(a!ET z6S2r2xyRaoxf50TH9T{Zxt%+?QQIMlhO#1i`*_Se+|b&Uf=+BYy<NhL)psawzT;t= zI*%21k5ZQ^xP$K{+)t+T(4Jtt;Z$)7GizitmJ)hSRg?I^j#CyBe4<iqxBqXIg80(* zlB1&Nyf!@(Tr@|~@|j3&T(Q$=b^8cgr<hRJFgKxJ>iWYt182~`rEfKCrvA2cZ;xKL z;M5#er+106;~cXOoN{EOIltHD*H`P04?rw4Kc6$MY=-t%lR|o%aY@o|z4~+A{#_aq z5>ab_Kqaq5eiZ_}5%^PxRT6|wIX`rq!uvn`Xuoq~y)E3Vge=p?F_lJzKg+tl4<fGh z=U?H<TFQ0b18_=alBVA<W`?(-;8HWa>W%sEF10x39Z2`6_F^<VLuih*;=_gaHIrPn z5n*)p0s106^bDIU)lWQw1bVn*w>yZYWneejcuogRncGD0GX0@;y}Fwoo@|;04_?f- z4J^AsuwqljCVuLnokKbDdq1$Ce!gau#H0sSM##srD(G%A3A}`>ax8;KiT)b{Wt=EH z4<mJsz@;ckeq8=sy<d#BCi>{2gNQzNw8>u?7Ga453&O3py2a`f!I)eDYKZVoL;OMP zX8+v<2dJ{R2w&=)E0AX9%P`<WK(bow(D}Dco5)Kl^RJSkRruO5E|7g@P-j`;AMM-m zc~u5T6XBpPk>PB$O$V;h=g=3G922}mkM7yD)+;E~AG}Wbd=an`x|^kjJ_oyoRsg4z z_Y#-f0spts>VS6*{9rua;>L?p1G{O;Lq-8y<q|SX#(sY93%9baeq8+D(gdLS5CvF_ z7;U2Biwk1guMN|A+$G~+K}PqEz(U<?Z(I`hwJ}6K=r|&v5b=^~XBIYX-Q1;T3jH2{ zjRY<v)9}usRA~tZr_!CkC1&@ZytSf7K!HN6QpmUo{r0*H#DbYhJg=fL!z--&Spu#a zfwFCZn}EmI{CWI;8=99P)R%{OtY76Z!$O>vo?BVyy8<~&jk7cT<(}gH6@ZLSJ<v&z zRzJgx=uBjK=}TKfaU=*Tw$*|su!{3SBuGNRHo(MMR3*tK>6egufUN>tGPyzrW%GS2 z>zR>VJwBq0S@)TrT<0$J+DnCcre@o5Ztei8xE^Ot2reqP;x2%br{QZ^1gYeqr)WBl zPx+sJR&zqK_^6f%$!9WdKL2icCB;Lc;ZUExy+Qm=iNw_QnSm1^jP)C^_x)d$i!rpM z`w57lmlSmz>({}DiJ5qVSMdf8EO{+W&Tc=y>wHP~yoedx&HL8oQA6;u^&TLDn!#r! z(kGGG`v(3+4tsH2*+B)=>2*H*F@}wYQJw@G?)_%qmROP_U%{UD-)}7l6mbo9i=&F- zla~N{<p{JFGItaz>YwEPB@>k7)erOyjKHm1e^^GOF_-aF8V+@TH|j$}xF>0geskGa zlf0S-+cfG5T*N=o8Ibz|LWF|dm?rd_;j4%c<&*P-i<PgPbjk~Un_o<=pRW6#E*`<J z<5pN4$ZCHNDoNAX4L+>j$s+2V8nWHOM2drPGp}FGK(uQL91ynmr5J69mpYqE7Q*4k zUh9#p`sGn}@_q#U2x~fcJG)LekU`v98mwqcV^;hv09KFeCe%^7!3-+3$CM|(gGW}C z`zbI6Kds#W^L;bV?y-9w2kPrBZj)|KqfcBNu_I(O5o~>*JO(lldupkz>yfJ$$R3w& zdk=mj&4sQ<HXj?4xAlF+{%}%p?X+A6dxV?UMuX<YV%5GA9|14<`Ujuc&du9pzL`tk z$zY#%loI)Wd=(r(-cjbr^6xDV#^d>ljArJ?7bskC_qr=;Km>#yz9FHe%Ho|CINa7g zN<FI|kacREvX`nKj3M3!DJ%>7$n4!37B4Iyj;79kcyMpOFGjK;S3tW7Y^-cjO-iJS zAxhbPS(2-|{3FC$`)*nc|8iS0Dud}?y#C*}ZZ@M=C%KI85Sc^nJd$rq16Ei@W65P- zn*#c{dh!ATV5h$6>`FT2z17rC-qR;`2cgD_H#WQr4jA$t88H#Cg=IK{9tJNoz@dGs za$0=H6-(}JFIlnKoa|5vYx2Mv(fmT$h$}Dn(;R{uVV6`5zE;M-j&7=hQ{&b7UR+uD z$vjQ^nN-WZMe;W7RNZuj+V5bK#R_~}d8cNKwp{qTVoxSKUEZ{wI$l9nsYAL$CF^E? zChgC=1i>Z{bor`Z>VCw>GN-63o2Xt@^si?d!vDEM<rU7-`*yZKzA~ISwB8V)-2gCD zss9G{3zwwFHS+68AQ`+yMsDs_$n>>E$YZH+?-+;pT(}{7rLAXH4+G*_c|=_TK32&k zXbbvnXaW=Bi&X&3lzP=Gm4-v}^f2THjH`T~YiWkuW3d`C*~Iw;EAA%057wo5B>uj7 zJpz296y>{ehG~)EO}cLEZff5Y94e5Qvz6dZI#_~4|Jnl5LAx8yfTM3wMU-ma5V2-$ zXG>u0E(hDcngGRUpHAMv{oNZw-Xwj5o+Fj9QE2~a7}H9Pqlkl1ytF9S`stOnj~g?3 z>)mCAaImGz^g*bqnqv*SY@B)G>H!$j_zs*~6H$UK`>=4BG)$|;;$A@NMrzvu;QX%D zOD?9u?|{v%V|7{6X?BmnzNH8Hg3t<v(P@I)baR;hH_!kFYw3MTSX!texbn|k{+K6W z)qw@S{eSGD<#vIfSR&P1Xos&S?dk;s6-0P)N;GhBua1SEZptpSZi6C+I<Oo52kHcS z5371D2iL_=Bwbbe7LS|z(NTwQ{0l<FYF@`Co^989##G>kBSzdfTCtDufyAImzgM<m zXUi%_e~`Uhx2ZJd5eI`;2pM3X&U+wcp)zNK{|%rt^261(>m+XHgC}JAU^n5U$KUb! zCeq*oIv%H|p1#Yy`mV|OEt!E^fgID0>~`0%@Lce|5n7z9+q{==f2+<{(YM_6+znsh z>_#AqzLLbL>IDd27mmw^KvQKqD(~k=(5~b!H3w~nn15KJ0D*KTsFUhYXZvj}SRDHD z(=3*UiS*>-UY@Th6VLhQ>v|6V9n=KA<l0%XFP@c-Ak|^*uw#v$Py+hN)W_R4Bg1tD z(9W&<2e=p`4o8J^!jE1sVS5T!0Me|sjr)gqL}Oj+@`ON@_8j9a_3ojhfecz-?IVOp zMhod*KpLJTIDhyHEd!x3*JRX!61*H|=LhzmRK@9$qQN(4>MZ<*tB$ji+jRv<+izJh zpdTPS5e5h~<S~N8dLi{ucO#{KzxGhx_B#9x)E!m}3xt^^ztJz8cR&f$s`MnBIRPZ# z*pBnj3X2|`QYl_!F=g=6;<!M$JqU<@SaO_RCSNk!<z5Grfj7W&A2zmH58o~oK_z|P zPj3B4y8_Ql43}d>Ow%g>1m-RARFGd1+!B(VAT>!4p_%Nyq8BXYw+P_AYb7eJttzYb z2sf{i;c4Pq?1m99ds2&YF7zzur4@PRAm0pU5Lb;$<oI-g9RWc*el_4uTIiBbK<zfZ z(=52^nU3GpHA4WB$|zZb+GpPPC`rA3B=APn3}%LE(e<!oY->)JEZO_FNOfV-W$vbC znpJ_0<J##g!m(Ef9580}kY7JQLHXuJWbxvMoSw$yCipd}l=F6|QRwP2LlFG|?B$e` zI8Zx;Mx}vO_v_&L>K@`s0b_j@NbCKw8{2E$4|82p`gy)vY36y`7#HDWKK*r!P@v3W zVe8*RA2y7_F#cT8Z;HQ%f3@6hC7d2;bSp6mL-bmaROPc%*2Z9mrs=3C&nw`Ttp$9L z7y|JV?7<x_<M6iNkg*#jFJ>bPjn-PW`d_ZAB*NEJ6ZNcfT+aU}l;3a}+<2yLz|x<v zCHD3zs_K#n{gmJ-H+_qL4aHu$51-68MH$jWAk)dZlXv^exzjcB!UIN$&DijSC1ZQK zx_a=G{~4T@^-{@?X2P=mH4deJrYc>(1S<a4vQ1%bFvG^F>1?gmjcJ`Fq&KQ~_IRmh zQ1GnblE<d${PWlZPY`Kc36G}xj)`CAT+R+$SvWv+<UywQsjpfR$z62V0&q!aSb@JM zCt$83j&R#-vvjcX@O+zuvkGjTR)8y$*4>#38fbWP+3`)V(QTqs%`k=~O<@+;N)%x% zI#kahTUL$QQ`_TuzW{W#xG9w)bzb;!POqHSMZn;&ZDXi*$V<?xx!W`Ln5>$@W!N_D zz~+%j0fGQj!MJC_LN0AT)ljM2!wC+>dB4ZSKEnKXRDQkCN9Wfo;GF-GuL;ocP#Ij= z`+yMg0t=!K*oNch1O-M`A!Bd%mPfB+h+GfFq!FTX%m!*-MJHy-@&Y&HX9fIQv=qot z7ed^Ip9I#9zFIg8l*Wy>h{Mh&KPJV%-dh5ga@{kV*#Jejr$G5oY|4MQKws~UOPPI{ zURhY#yV3Z?yk3r0x!GH$Ojq}x3RxGu>94<U&A`XfOWnRsXSMeq9W-SA9O;O6A@6aU z6jSDyK7!OF1JRu7*Y2+5j8Ml1PxK~vbtI~&4c@$n#wt#v%`%_BUd)g#^<L<vm$$1B z)HULGv12)noI*HK2_p)$DE;gwit^4~R$D&9+dtTiP#*?c37(WE<=BHl?Q{Ei1&M!Y zu74}r><XonC8J+cKpXIeP9VI^I~754M*pc~%b~K$BocI=piR+H;?ZJ~vB|;2k^Wd{ z@<un92>#-MQM9!Js#ng|V8S9zo=B(~$*f?gWc|(Rmpq$tfXiZ}*UzZ)N2r{vA{&LS z-`0>!5AB3nH3hh&db>}KmgrAC=;oqS?3N=q8u9mOYDc}7&?Zu4T!B1s5dUlFEP5w* z0MYOIzy%IgGJfE3Mre>!yGqLHzt+%)BpP)B8A8*g%opjjO*f+iUnkZ`=2H!vP24No zc?6CDtlW)l(tV2~Rmpg%LFKLp=;9urcF2ps?(=!l(eh5z<As_INzZXxY#D{Q7C3`| z(k|QVwiFCB-$>5%0R?mYD2)JcBdeMW`&Y8CnfqBBn&mzhK3CvIyu?t`_F)Z840ENq z`rmdMGT)5&0Oha)YmdIY^sq>Mq3bJp+1I%1ieQ=sxYq{*j9p1MkEbd)9<Yn^V854h zqA0C3Jm*4euQ}p^kxyD61j$J$>bg+t*etEc=>p$)a<iDd5uM$A&nYR-PuStlyYfV? z1aACOoHQ}W&8hSvLIMAHRAr~~9n=kX#@#U^eTkNOQXAST&yGLG-2Mh^`Uy=#3%~Gx zp%S2ZEy>gM=Svxa|L@TnH(JzBw^%(~du+QR)+d7-Nio!b-hEN(^S<H6JM`3TErj1} z5s91S=J%$qw!K)7gu`CABy1CuBz7?U0T5B8t<1k}O|livG3%RQ13&jH{i;2d|Ci&O zC8m*bCL&9?g1x<7)Qe>}AKgcIyUg;@eBlXGe?x_1T7nD8L(7Eu#u;7657o!Ocdwdh zK#AfWWFf0Dc654O@4XZ(dV>4v2pkySU)EDr8!8HshZ3b%xr3fA7vMi&gFCi2v*Z6G zeylQv8Ir_7V;MbXd1rPb@sSDoLlgFj#(GZ9b(E+O5at?r2y~)Nak-)&$@?nKS6;PN zADVjyJ@{w4Ly}6T^o~_aB&;J4j*-C?{%r107o^Da#DZ0W5hnV+B*+U;-zt4{S?T^j zA)Yuo2XrO7Q*7-qKqFJ6qtsw^$3+-j&$hDNp>4}ZT?QVL_O$tJE9bynySkxfE<Th6 zAC~*9O;!H+iCH=SkU|ypL#_-Fj9lM^s^|gLL9RCLvvlY#rP>gp?yi7wHFVbaVqy%3 z->u=Z$d<&QJF{b?BlN1{u*gUz@pCejRFS&p0IADFwZKx}Hb^t@<9jbIbrHV+#WS<V zy_;FW5Rb39xoQ8s70EOAPV&ka5oR!OH)~3+4Oh%zEy~b>RROs1Pd+XejM!0G#wEc% z=m54arNvMe?Ki%(j7|`oq*)&SQ)h$uS6F4`p#{bozrOoGW_;3Z#hWg1R8LM0A|~kX zEg8R!#wt+@OpBsUUAVNh^)cz|(H-l5$@7iV9#ad`pKOX%#9UAqkRk9?F)@bsWDkMS zS&H;t62`PAGl(N3sz%26=m{tq@>i1<7eH4d12gm`X;DytTU`0q{CuqTWQW|I?ooW& z#lIR84{vPDs_Xtll-<>ue|6QX9G{%L&Xv(#?+3fK%&W+U3TRs)MD1bx`r0%ab(|7c zj3L`GH!H!9`5&w*@+MInV2~I-(7G$BhdM4h+bDSgJ}AHY9CZ4ghD~s7bJ+SVS}FW( zkvFt-j6Ml;EXr;yL$#y3W@hp%FrDOClM8p}lV+I9BCUg}8&RKwI`)|K5RzjyN2;6T zoC7Wtm~4kRMLRN!D<RM84U3Ze9)xesZQeAy)*SkD+{{(COJI(-h|BscK}z%j=ynDx z{*q^X;Y6KMs|6H*iumGCCie@E;!>QA*xj2tH5X!nE}~*epFkZLIL`feI*Yg-%!E~D z+ErJ?ZM@xj7t}iVQTvCKtJDmKQ$Tu=AALLjEEx{iA@?idR&&N_DhdWb@L{yof6TZp zjAk;z{NF+Mf2~f?L&l>-Kqu<|46qwQ*>M<7gp+)2l}JMoPV3QP-<FQw%`%p>=U!wR z4tSTJ9m?As2BHAz_{=vX|F=8&Cyn#cV}N%|txshj>;<&wJXyGVgC8yS|EPNJc&hvO z|Gy$5>l`b496Q;OopEqTlnPlHSs{Dx5yy6r5GtWum5@Xsdz2B$D0>TKg$Tdr+jadu zpU?M?tJ`(EMjhw8&+GMkKAw-~<DPF&d~dku602+1Ok}%Ou1C2b*Smp#u7AR4pv!Pg zahA+U#Q`>S=HU*SB|VT~az~~Nz`r-%-@DeC!`WzFHF47>PXVJ+?EUd~QHT>n<R9|1 zYe8BqUDQ>BW1dQ=NA4su2a{~=N*Y)V-P!l`zty5NuzW0;^K^ua1><jLDz0Ygf6sQ9 z2Ru~N-?}ynzyCO!Af9l0g-LLIc4zD*C$x;%7v@t@;~fe}o7>L?Y&u9aT3gaCvgRGn zJDEogN#BGDdNa5{c#{#>`oK%m2eSB8tpW~=z=svt&NfnX@)ONON&DAGxN9xI8Rs79 z><(MDe&sd*i~98`L24}dI<@uTYr8H<?z6Niemo8nuxsTGO@ny&gN;W8MB69kEr@F? z;x69$Fyd>loWyxy3`yNe1kX^3Sod?Kz%4ImyW-EEkY`b)FQnIPiDOvV>#g>*f6quP zf~shEt?!eGKsS|kCL(`M#&G%|T$nCo?D$m=iE6o&`E#i3$!K67DUbEj=+8%qh5rgz zxcUc7Vz#&E@e8+p|M)s5r}t3|&Gu|Qu8fX{tG9;fWUL|*edWI;Y;|L^Nomf)v!{An zkw}q3kxr4d*nGnXG%&Y%ZK}u8tLA#O+MyvqDWgQ;)NQQ9ruo+JB>w=i#R?=1O}@P6 z0oZn3x?Q}F#<LSiG+H{ugMbsv#!=?9HQuEVF_)Z2m!L-5-~50yv|6p$j2T5}9Oa(s zW?BC-&Cf30VE(6)@q1zS*}-`E14zv7(3W_h%P1@5F)F85{#HZn_IyRu!T?;A2xYn8 zM)lpH%WxheDRNifCcrM<osQnqlxIhW09dch769`Pbl4&ByIfT;6P)hvVH@pbH+^)Z zo6a;}DveMro{>w01C8$I<?#j?KXLIc(d4d22-ETX-K+hEJhs`oa=lcoE?6TN({)-e z6fv^@nsn2adkF(ryn_J!;@z7tp?lqx4&zMBI_jAJ(=>jDHT>pVchwn=#=gY!V+$nI zY!3V7kPr9{@^P{(0|CN@<T`(2bB;-`DQnns0D2R@Pp=I3i44H)(K6%D@DiO$S>%87 zZQs4{bP~mn;HjYs2%ZpL2~&#mYLca;rP5yU*%dLH&h*xh`!#esj%0w2Z(qvA7JF@M zo~)0OtVH(mWco*iygj`*%W|V@FHOFdJPzHb#bke>(31b3rEn)d2<yCqLw|ut`R8wF zDHq5>K%BCBM#*S)AA||wu8nm23_H2;ua;rHqH4C#eL<QA>8m-2iXr_PFAtHOiO%Ap zTpzE5{sV9{yH4B-Zq=ysfTb%t=UejuNx1lMvsmPr*87DYk*d^@6A<_^3Uk3u;}{9C z$9N`mmSsg3@UNI*pUNt;jVYd6CI`91jt*2zB@$~hwsb2(wf)I>qOtawuRA{qQw{FP z99I+WEyVk5Za<@nzw8GWvcD7m!zk>a$^ygy^=TD+nA;xqi|OSo>{%ZCG7}uV&vT9U zIvk-r?l;~3S^(-EAhNaQ_W3r8zc%VNT8#3;i0%%8QRC4>+>lNnMCN}acKd)p<sBb5 zo~JABRLI*7_W1T0uGN1Dwpb(#ToGJt=kX<eJyU;JDa9|-S!p$2E`6k);Je0PWH#BQ z%`CLY+e#vBwHj75&3YDJnhk>ltP$ZB$^zZWv?|#4+6=1<2py5;)wVs12qyDOJe+g+ zg5t|}`}~CZs6%)prixm8&j=wMHCEv<IE{juWtv<SPmF-L=-lW;z-Z9YkHhIS4}0i8 zKi(H}MZYR|QkZ;k)WBd~vLL+xU$Ukennz|l#=s{0TNW*jcC03m^PH>L;D4<yPG%Ph z$$)Jx%Va~vC`+_$wJW{@|BUP({PX2B8RlOuSYzTF-SL5q)f-7zRGa&$G6upq<9U%@ z>7f5L_8~=vI}(eIyu<?1zUK>Pu(HUdi(Y{g?_4k$6ehYt9Pe-c3%d(EbQl0_=^zP7 z!aOLt9Cy^#u?E_38q*V7)Rp0nkk~5XLQ3673qRsxJMKE@=W8uKsD$L~D8q7rm*(#W zi0#TJ5JWn^8h<n>ex@@HkafGlPLC_y`=Wi^U&MII-5_OQx5qc~7xCaj!8NyzX9Z^G zj<kUP{e}A$GMGf6dv&s{n%lsB@DB7MjNViCj}*xMOf+EIvzvzD%n+dxZ4{(lCQEG~ z25tHNS?P|%VV)mpn>+pcT5i9&zanthWz7U8tKPc$5ZuZq|I(Zn91;i)H*kiaH3HM) z+vum0Y9?eQQ=GtD5lyjv@NCWPC^`42Q@}iGdYGw-{4Kn=Mk<3ZsnX<DXu>m)x=X-K z!dT5>M4klhig!>>3UnVeqTUhYv#Kcn@!)Oq_<+K^AaO3!Z%FPox(>p&yy3rv@bI}V zDb)aksD@NGW2a@QG0cn8=nfnSucS>d1n3&_TrY5SqhwO_D-DD+no)QMYN{QR|KD<& z?L2}r$d{-U|3KrXLi)VvA-%!(K;~C&eRjD(5gW^CkG6l{izfP={CCp<Q_dZH`c1W; zVdRZ8VIe^n?mEUGzg>RrWoV|84T07izfj<EM2uuT_5PS+Fkr5JzWj4D#U1x59;MAI z_=OUSPc^9m`FSk6qfK9|2FM{xX<u3~?5hZ@t)y=Ew(HA@NHVBhZ+{O3qMSM0jW2Vx z<*kX0zdbnHrdbM1fs0RrKt-%ZsK#*j7dQq?R$yuiPZ!a2sH9ho|C-3+TF*N0gliiC z^f`x^{F{f4hk_3&4W~6B2R~M`mm%4Km{I;ZIl9|Cr<sj)$?HddM*=H>x<@+t5dup_ zf;Sa}D!r^Q>s;T$<dMk1*FMJ`rwvT~?!mMF4H;}4J^OqCUNDNVd+3h@6N2(F0@;Hu z*0+(+1^C+5NFP$HEI{I->Gy2;QWdYW!S>6XNZO6R5O-;jaEcw%o=%pet?uenm7L*^ zc8K*H9w6s4dk(>TnJWd?iVb{%5ZAD+nQ+n@NKLd;nAm}OPC(JOUu{lqqK>raIkndR zI0Xh*vH4CTIIl}`y@Kzo6L4Zk6jnyS@=*i}R`f6RHY8Rmeg#Ef3CVJ_&cz2g7;zOL z#ziC+GlL@;KiH4pi5(HR@KG(u;4q&i5hWu*?S$9v_ql|_VfIB=IP#SpZFmCKnGH65 zU;*3QXV?}#Pl2KZ7P1p(sY@YLtJ(?9f)z1o$qlZvX&!zMkSSyNt06WG--eJQk>rq- zp|U1OdNj&+B93(UIX?JBZ_oF7Kg3Wz=!&Yl1%}R1a60@DA=m#mu>454!0iB)u#2g$ zHqh7TvD!)Uk}Je&6zE~5KUF>OcCTj~eaG-sF!X8rpd&RglAYPEblWgBdj}GJe4qw; z?aYIWXKXoC@s!d9ZnhuT#IC#pwCid{6k{I+PZ+?Dzc<@8%drgsbW-;d>YV4CZu~Ju z0!8l^VWSc+0RKrmjmn&GP|;ZgMK7yKt?J)r>)#jmXpVN6@ziP2<t}tD34yx*YFwAf zzku8bqVD*9Prf(egs{KK$2xZ4$XFjZB|?^aOEyd1`yaWn1}N%oM~F{32tF!V0{v<h zst3CWu_;#Ro7!!ELDH{+|K;0P;1-ygMhPoE$6jp9@H^dbZ!b2p=QTZDpD7I_#vtB< zd!R5rV6FRCtVRwTH0`QMt8Aow4PI}3rehi;pCXgmqeC(_Oy&#7-*-;XM-*P*(rF>( zyMrgrk#WiXdaY&grR#W|Oi^vF3D*wenQIHT3WOF3+TIF|eY|v`k>*{gEP2@9m{J&6 zzBfGK2(lG_GsI}E7#_rt;m~!LbsXVq%m3($D_$GEf}L0H&!4F@X~0I)jj|nGasQo# zM+agQl$phtR16zNg&;Y|2|3);5Eu#d^AUO-!iloK_Svh{^ZiKc<Z(PMlzI_xyLYN4 zNzPl=AKM0vFgue?_vk`QK|&~z<UVtlUDfbma_SwqN*v}#-}}CY1V&TGRN$uvc<P5c z=#3&-{@FV$i~svJ{d+jWYbnqI#^CeVr~NimY<Q+b8sY&!O`D`6sL>ZeFi{zqGy%P$ zh>%D23Pw1!<ZU?*I0-wD2W0wV+ES}7ZZ$HnCS*T=?vf4NXly44yb*=rcB4`G?|A;h z)gN5~)bcY0CQVD6$qvzwCQULLs4O~k2n-(UJw84|!3Mk!1ZqF}+Bh|&J^IFVT=_p( zInD|15saWd;Uyg~%znHKsqn5Zhq#rNj_!s?1l|q@kOz#1ydlL*Eh56@cG!?fiJ9De z2^&qP?*<#*@cSCZ-*ZF{yU{GhwD^d*6IUUGOE6R}Gd~rhO+#SWP`jI)u`;-(^&eIi zd2e``<-d?pvz5Mk`FPb(GpazQAE|Uf)w%OK8z(FS)Yofh3$#ixr#F<8@8Qml>E~g! z+J+4`H_o8da0Iz|T_vsrk!JskcJ0ds&c{0#|2BQAt{6NK6BVWX&8Pp0M$Ilvwl6ub zD+N>p`v8!3%w+O-qp-_&2>r}NY4r;S$2cUrB^bJ?%w|0hw~9b=g3oW$<DUTz!WVLr z5}ti~{#fm(1x8*so>!gzHVnEEjO<Y&C!J8FE$*>RvcM)719Y8{!sUUSXAwjcrUFzW z6H-chI^807;(AZ5osOh?Xrnwf(5Z#83tIThZQ5G@u5Me}CP~3AN@(N5{+1~WLKx56 zv{L$lo$cW{{FV6ljZG>$=VXa52X(_7OS^k>CKAcsbe_3Gj1RZpcKMgPD7RH+_SFCR zLn7a*>lt+L1}H`c2g4j!N)Lht?6U=}58wTJhE1rie0`c1@Nv|8(EKOD2tC}lg0^AI z#Qkce^Nr{JvCld#Lt^OjVwNOAWPhFpJ^!p5d<{jY)}TmyDUyBJ)Hv$&twU};nVuC$ zLZ9qXI;pk<NuhU=j@y1rFAL1g`?s`1{xnPnfRDe<wiB9aA$T@}dIho7m?)F^2}u`l zO+kR_P=YkFLMeRhSqc?Mo1QdEn<-yQ)p(JRJ9D^aN2CYMY(61?Qp`M3E3uq&nBef6 zI6eqFzk`)7rlyr1vpNVPKK|@UtWIAAAwvX}po;xko(wff_Ugy2JHUq-1chN^04Ahy zUq4%q7ktTvlZgBQmUHvR*H5Dm2?^lRlGpn*5QK@KTPmq2o&Dn4PEHA(kRmx#dFh92 zcbbju2O<(mH!yukOJvJi<j`3QMZW_U%iwK3_ne!d`)^#5ZNI;D^-WgZeddy!?uB@> z*o6m=tFzDFgr6eK`UUdcj3QG;AhB;ABIZKhZn^m?fFbYApp2rpx_xE)&7mwE@G*Vo zwW!@z$9FNqn3a(Ja#9DXF>^S&Rt}N8&>w@T8m+z=^piB`fm?@G6T=K^|9ej~CJa%c zIxlvHO=M*rcNde0<m6`guJW!FnH?u6_dBZv)k5g~iwu38W}}*kwUoM<)QbnUVIL6~ z?Npp_XXGvrkt83}HBoU4B3IgB?A#`grS>HR4oRnhW`t>?nGs-O>2$+w3ZfZXAE|W9 zFP)8lHamhZ=VM^I@(Q2fx9n+-$Ei5*yRbBhH=c1E!=E#*3#$J5&H4hqg^knuB_P|( z-v(~qdEUWr`s}nP{*m*8rC8M!IOX0tMy()HNM9flMGA)4K%ag1dM!aMYr8jP=DR#( z_5DeSuw%CN$<}hj(0a(Dl~m!BBXpJjee3e+NF9$!e=fEA+;g5&G!hR*Lh*l`ch#MH z&L2f8V|h~{1=2}9RjA1K*Vx?Od5AQ4`r;xh>r=UWa_woL(B3yuV2-H+KqSvV`m0GC z+}9#bpCCiga>ZQkuLcSB%+<<U{m-tHz{?pkL!UlseUBdT1QjxMJchPcUn1U3v!5@5 zy*G*MHq=2<+^g`!R<w5@P-}Q{ssW#z8Kz0hJH<J+3d~;*iqoPM4n1%*_cfotU@KM} zfEJSoLQ>K}$EVV$Sb)Tz7oLfiwQ8>rD@Uml8yXy9NRT2fN`X=kABwfL@SnX`0)?B; z*^cAA^lOp`?>Q&5$-6<FgOJjGy=Fdk2zypzm2dPLJmd4CfMJuO6}Jm65$5;?Qb=s! z@j3ajJ3v{{rN5Q;kY5({lYHaZRcw^lAff*bmd)(|``zOv(-5hqIPsMX?oAIR04vxN z?M<4roZMam{&=a))J8!f4{gMs{!GM*;=+tZpFBk`{@5GdJH|h5!?yRc#Jm1NlHSl3 zj<eI>BLP7LFPy^IR{yH6GtTHcXNm8}in#@0r|W=nxRoRR&^~4!h#ku1_VG)HV43+Q z!4<Hfh{@l`S+4<Va^p{)6H-@tm}vdSs_P2QPw&;gZrwkM5y#Uz3=(pqDieOan4^)+ zY0(7l5yGB!SaJWRUoq);QDXH%xA!f><KylkW<o$C-UGwMJcMM<-~RfKt&2a#+wn_B znI4wnzfToAq#E<-mpF+{*wCDS@5D}of5K#)5(yz7rJQ_P8)|?~R*tn4e<Y~UieRFL z_$`yS5%a|+-<7<6JjOaL{Vm+}ug_H-(dIe|54wR=XkYAK+!h(5G`7y9gm4Ww*746E zkx5A?1<n1@ovWSJHdb7-fX^|MNJD~>PtjEwAIFr0O8j#{j>~y{gj=>PDwx{@(}}6v zwdU^4#>WMbpojErT0Jr(XjIdkqGc2Du@hSKXTMKpqwneL4*+Fj?&dr(**j+<R6SY@ z?R?yw{t3GGO^$+E(M{8Mi7zic9Uk~fiB{#Eoo6}raFz{~jUI}%{{2f%=*JL8^qKC4 z3-(EA(?m%z8+^4AY7&jhY5K~J+oZDmQQy+1v`+J!;Bnh<Ud>6F%e1!#<2?TYolpWQ zUhvavq;|?nVBxoB5(~hjYm;}?az{j7`>6OUgk7qRhHMCdQNQ&)x<gk<1*E>^R4g&O zO>B^sXEc*^hg7(_|9B#D4c_HYs$1?2lSwk1E<WE(C-sni&4miVdW4+XPuO9jyGrqG zfShXa?xs&&1Ewi9zUVoUT#l8%YFIsLR$)6U9-_R~OlP-AMZ&aSd_HDPmdO$)z#>$a z?e9qS<~QniRnp|CMk2I(!JzIXd@5$;vd)u|6RP#ACsQm@%PW5_t-D>YuQTP-Nnf2S zphlo2<mdaTE{PQw&dV_Mur7KP`|kotDEo7pXT<77k?RR6{XB&-#lM0d8sm>~-A)y} zPAqpbjQ2KO6WuSFX6<}miGDXxrrSIFmZ8{S$?@bl-hguW{P~Yzs4=VDBUYK1Gif$_ zQ^(Y4zGKSM1<ef}a!b-(>8$4J!)&3C>+*_Q?2^3+O4@~><*he3-4F#djYJYbG|9oJ zkIIvS>~8;cKH4D&ZvCZ(^(MZYl(vLdN%$;(s~tt>g1#PW!Jk<E@I=<q8qCgbL`jVM zW4)8Y@nn>N_zE_GeA@|SIsFp4D<ot~SPtIP1|!@9p6qGr9uIwgN^GYDQ*axc4vE|e z#{7V+>wI*%OA33`_&dw+t1K>8@WYHx$5#}(PO2#+Dx+O4=k&EtOi^U0ux3>95K1eO z9i8~kpFF!VW_qW(g$;F;g6()mK_s2v%FU1WQzZC>KHsb#PP^7A6t3Kwz${f$e5m$- zL4kT@w}Ql8V^<1pfmi1Rs&-~Cx{Vbqlk-`?jPA%M0GFvSk|9ec{_Gd+i|`~D=Z!Q4 z;=sThSKb_{u_4T+WtgfW#qatM1Nju?EogDd57D&R?$M}d3H-CGa{{EdO}J&PRWJ}S za=KB#`zm63jz4G-Z+RWNfQ#Z2^2*XY#+!eSzLSk6`We9ZZV(?QITLl!fD+c&iMi-K zazfsXLBIJxf=^jiCI=;+gSOSd9-k71P}coyGq?1qz38%d7aj+md=J1Vp!iR)5Rv6e z&WD93`3I2*2*axF#pCGvPLcrQc(2TKS=^a0cRq8c2kQ|%l-JWt8Dw~Lw-`K9G657W ztHVQyiGH0*=JNJtlHp73@Q@4ZeTNdE!iW1I!dsVHnGA~|;_8m7@Z=#cZ<%<3i)Lrz zah!k3Q1JvYpm*Qf^hC+HAGBnlNwtgIcP`ST*v70&$u?qI<D38g0wRimjIrQHKPn`W zm>NwcEfdS75!SpDhS&Z_oKiq2*bvo^Kg(yGfwQl9&Wu;)qs<E_?Dr^S6k19N4;So5 z;v$b}>sYiRw=z!e$4!FOF}#eeDcNi28TJRu)<dn6*xecR1M+dOZgs1biA_^HsE|J2 zMou)}c37rW3a<7iYvNkYw#vP)a#$CGpse!V<GhmPEpBWT2AkMdySDI5k1Cx(Ephp7 zb^$p)$Or)wTv~}CY`@zV8dC)HIh@*BPp(*h%OgueFxSvjm%R{{<uMQoh1kCV#-}gH zx+7n3I$9E`;EF^pn&$M;BV$%u4|2PK$|x23r=2>mtN!9Zv@JYs8o;*8p}PvVwzO#` zp6O)K{3I%L!A>FL+W#{ifMH-kU*o4tK~wp6D5KN-bAN{hE;{7aFE*FN56X?rdv$)H z%emkfrtKYF&ukhcpjmj7Oj}!;e3O%L4TZDnbQRdMK0NR^XseI%Jl30oT+IH(X+9Y} z)-~Mg0~a*&J+<RIU*BzKW@WlI#E6mnzJ0i@aRV5^LZ42&?FriIaQD!~zAPU}&a=(_ zed3AZFv)l8;JFR|A~}-7*AnxusRryr54Mb3&uwJ21>idmwr-G|o%Rb)zw@HWK9z#N zh&{%8zShmdA6#Ias3Mp|6euGrR-l{{EHXFi$&6)Dm}QAXb#~^fsH%2{R8+;%-*BJ& z3&fEXI59TX3jdD2b%^iIO402y+BI`Wzu0V4#<EX0<2GF^S+jKIVeGEm|NC)rMC2Lj zR7I^3F*fz9eRI^j{fl?yEPh6g|FT5I{%eFsTB_3MP1F9J#~FM?gk(z4Mg9(|uoxP2 z?h@tNVt9y16IjBD^x!W{{sl{i2LC3`XE)<|TR4GcH3Kj@XAH|5%`dD>zNn_y0?O+G zYy<{Xl)e)QCBs2okOVFFIVg}SEhgMcbAI1wl|PU)u)Ty7TNku@7*8`{cg}t%|2rOI zv$4%y6+Fk|uuH;lu+7u5Z!=XzWTm|HXJeRge%e)`@{e=OO8Lk*=TS`Nz{$|PpzgyL zp^CbspLPH-4pshCw2xqf6FhKTj%5G>JlZ^fa<BYA%lgs2=J!M&ZkwVfRNYi)mZx<P zfnNB|Q+Tg!vOM(gVBl%NxYjUT`6pgYCIObL7m~0&^Wi;GvcK9v+`B$GM5NSyPIu2M z8f`i)xVkC9^Vp+<926kN3~({_R=2>qH<yS}XZW*EJ0w3WNT{99*M)oC3@1V>g%kaj zTuhlF&*6wYSC;hRRKX%2!*{sRg@_`KdJ~+qTM|UW=Rq6u@Qu3f&k;v-w(fMhkY4zg z$KyBEcfP;#etslML(jt6zc4+-6|o63!^+N^h;i0{v%r<#R1XkcwQr{8%Gx+y*R@u; zPrvv;h6s}FH-5gs-}zTdM1*P<Y}X7ma3g2<TL}P|^Y_#XH`YI6a=X@G<J!@WgYVC` z@5$qzfn>ujj2wu5{?FTzQCeF}Ypy5uyg;YOE8Lp>MlkUGR^cdffj)(y2<$k>k|2L- znw}qmxcQ@VBQc7rP@GVLZ>>u^bHnGaBsXSpB1ffJqEG|RRCMdKn(VAIqB7X(Axx9r zX)`ASpQ~r$J2eY7ixgS9-y&5C`F8*O?0b9)hx7lu_$WM!cxQ^?;Px4sDEx^Fw{KiQ zwm9HSkS+#ACJ?|%BIcryJAh7#NH?g44y)!3*7>u~D^LLfC-0s<8`rNd_ZQmbZzx^7 zJio>&LYWEJ{<(tiwYKYtXpH}vXzstvCx8E$p#l9K7vmJ0&PNM^c)`>GL|>k*^#Zfm z%KJ!%U4%V$=FV;aLWX%e7Vta}T9}c&Umsk(!;r3tQPj-gp@!f?&@qDNKr1O-;i|_( zrS<Ir)#0Jjw~FHTz^(;<%;@raZFY+vYemHWnY=NExJh*zsoJ7T430hU&ciSAMFfiI zyHB)|Nk&na#u%6@|9xHrU^n=&@$5N7=*XXSdv|;hlxk?qf>yKK@Aq`k=}mYSvVN=- z?Y=DJoyVI{^24{!9kkDcucI#^driY&mx$0oz6PGzBfI=N@T`}~*Wp{vj|aWh_@H?L zhJO;hv<)6Gv>qGz?6EqbdLGCadm*SS9qbQinx<IJ-&sZ|3Fm#5jh{ci_+uVet?!}h z{}zBRQlx|0{O!U3w3Xu+i+F%qiN0IFJb$b^BauW6T2|S$9<pu3fN(F@>cPl&h`(<j z-V%OQ(+6$ur>;zirrmOFSUdmsM`XY>;5@Nfmmyn<nws75HfL-*aq<iTQ<+r53iz$r z%+w3={rlA?IUe7x@J&y)WHJ+Xjc=+4q&@if)h5#8n>dLg=B^u=&q9@B)0@-~;qX=A zXH`?Pdz5@AqLbB1PenWEG+Sb_v=W#mVa~gNbjn8WeOxY@vyrpOd$nV<fN*5{)^E+) z^^Sw_o7?vazm)(;GxoVgJfk<L6QxU_q-+mMYsqThz~ArLWq41@Ue9xNHUQJQaklxa zSo66nFBQdz8A?Sf@4oJq|Mb%}{KQG!0=|fM;A8%YC^PLFh#eqf?Luz_+jn^Wmt3T+ z{(JE8#?=!M6fZ1vbgn)pBbaUd8h4Gx<JL$R5AV`nzHs>WwRfgA3{wXej;nLG@?a<s zud`IxzhCC6KhO}EK^<ZqL(M)iZ2!<@14ZfXQ}l}`l_Z~~HxcgzAM)#GniByAM$*+> zorF53GIStbY;{*%t<=?E46^{+C_VWe+T52+MsV)8pPErv-vU|WrQvPCiCx+&IzQ~N z78uj&J0Qc#%$s8j(Z*;aI?vHGq8?QK*=@G>MB53#AcQGD7((A6+&=?$DB~tl-^p@I z{(V{HjeLFo8Lka{`~Ls19`ug?M&YK>l+T`&0@-96_9^^44O*kASj}MHXB3X+UtQ!E z1b36qbAU&mn~%E94@O5VCahQRm(`URF2qq^5isN4M{(3c-?A}B#+h&m_7{BV1oSF) z<;hC1V)5-U>5WWJPy_y3v0jOb<{Y<Iqn;`cka7l1bfMJ>7_qT`VI(1-K?L728HD&_ z^!ASV-b)HbGUH^$bv(JwrYru1@YSM(uZ7r|hJn-!u82{OPa;2I0<t!TB^eS$wc^Ni z&rKtsk%<GVw;xma;@{d$4OM$SU4ljH-&R8$y{XFhF#P<QJ5a>mftfh#a@$@ir5-@Y z%9eEcXAs%oWmXXCn0vauZsPFFD#+3|;;eG)(7b4?$disiu{y0n_v_A~OUPaf<(8@z z`aHylrs!!OCaO2XG~mU!gnc&~-4j=U;k-ZiZ(Zl#Ss8)roxz8Qb6N%7<eE=a@CA~< zvO&mv*-xFo+gwvU8G{|%QT3Z;Z&rC~ZvJ`Un5$=B0D3ZxTUaE42k~GjAde*s2k|AF z%rLFHMeu^M(+et1>2R7W$=52OHr^c2WyRd^YAK`ZWpLXpNW=x0VJwmSiTh$Vl}$64 zaKCj;On+)a?A+nkZoV_?z{B`mWKGJQd#(?Asn4$HP<_({yf-iQKS~s)gZJG-R8ec_ zpmEek-FyJauJ=7Qe<?p5ZCYJ2Nf~VNa}t<nFD=BVTVyX)!0LtRH2wc^N6?bz3+Lqn z4A?{e!hXebhzt8#kHWlpq^{1+)|!0bz|VNF4pdX@HyC^4D-hb-kwI=37MU_VrI>?J zAKfg}>uoL!xumiXn4R-Ay!dp|yx!oS;%z|{tnQjWY~B>E-X1D`wvv?-Xz<$Z(jcs2 zJfDmkB_+QD*Wu5*r!7jAMXjB6)-(n=lme=d9g&YATt6`MY2C6TT$iL|K7fg?8sSMH zI>tG-s`!@@lg#;)r_ry-mcX;WqhC>mkZqAF&6xXcClGR6NLIk&7T|do$1biman1lx z6{U=b;pyl)<VKx<E8GPg0+^2b8heD>RS@)10#ipv(JD<kEcG-SmSrBWvDvHIO4qR$ z`u@_AvvL;n@jaoC)@(~;od>R(hsO>84UvN4aSVqCU~eP^wwzwo4txbOP9H;>&rXhK z_u9ZI>Ks<WYpnKZQ8U?v?=&R06fhIVNJ*NlOUPj>guFy$MslzkemMRYp<vhM-zCKy z`S}0?streyNUboH_U#*F1QyijN6(n^XD$BaMnOf@k&>Sw|D+%sp%uMf$d5NehQ_cm za7mV~A!g}E{4kj<thC=P^wnIpsP-uAN~YR<3>Tiz#W)zz?l!?jQq7yGBEy#^{F12y zne^|lPcRcQj(yF!{&QJlCJo2KAu|j+3jh9Yq2CdWh4T=Wdt}gxaP?VTeJd>of#yW{ z2XL0#NZ*c4*!sV{2QO_O1yS);T=;8*yEbH#d}IDHoI769>?ZQb{kX?G%-w>uZhuq0 zQ4rCQ#KHP=CR!b<d`rFF4NUQY8`s*F6ppN?ebj}g84+IyPHg14k=Un&tKdPWGbQ5L zhsw$Z<7`4J0w$=bh2AGVH@AO{{{rKU{jc&NS)b+1;WX=0k+S))iS*5T;d8?SIt8rs zD^TeWmiE?S{0C>6K$ew-bXwyt(#j#bivq7H%I}!Xv$8@`k;>sq=ize3#9TJyHuN?t z4*lqZk$5MqT$+V0Q0ZR+Rpm}2xLlBP`6Kva^009Wr_S}sS@hNPRkwp&{T7R#P>->l zX(!l4aqS!MD!Rh-out9LKJ55hm8!slcS`Fs$<)vGE?weRd@qr2iPv_Sy#D_TpMS%j zQMqEE+;Vy{2r{J}Hpi8Oam8KMd`KL~ob(v~q#&M8LyRk{H~A0jtGlolF_%6kSorl7 zXjfX8A*1g*;3^a~Dlt2B=bAI#nD6;@iSJ=EzJ%;4XYeNBYvAmSqA@4yyMqY8?4@yz z{U0{R(zH{9&n;>L28<lwz3tDSYAoJ?;aWxiSLjvK!L0;cy#jcH(r~oqR=`x?KjUux z3YJWG{c)!V#?M|$0mOWX7>Pzi7OG5X$G|kjT9d8KaEYC#gys#Q4}&ov=2YDG_x%8J z>fFoZaM=C}8tdyv>>~eX>aK+)&K@#&KINq&(p$l+gf9ud>_q=`92t+d;{wKzCHgL- zZ&lbgQ^dMnlGM>d*|6(62VvriF5Es~%yUuW`F-6cu7vD;1B#Q5=N*Tl-)HO~2=bXC zF(!>*ec8%rrRl9VJDo>fuD@oEJF|R0y9)o7tgB3EyZ0EaaOEIGn!kr}-F0d6qr(E* zc=>q*eQLiHGYsawPNOiHm&NSCeKH_X1BH>uYz98a4o;Ha|NH~6FA@s!l3pSb*1D(X zN8BRGmjc9&YK&$Y0{CpPYzcB)cy9nFM#BZ*_Yn1%crDFY5k7=B4f>BSzR&pfs^7Y0 zF~`Rh3f~dPxp6Iyp*yjbBgr;&rJadUw!p4J;I|E$05!G~p+A<v?D*4<$dL%M=pJ*x zOOA~cgzp2VM00>9!LWfr_I%D~oJd0Z+5Zj{Ua~|_MOHBV_Y3E?K<kpF^$;Z#{%in& z3c@z%_d_J8z1yMUYk>Bvi7x$3p5ixHuL$=zhp_RGy{`X;m)4Q#jR;y#WB<z4^iE~6 zpj#+zb>=C?$a1m*juE;(c_Z-PF#rrU|0Vz|LM0os+WTQIDl<&yAG6&O@+%-0ZNpWT zbqtvve(Ic}fzt#INu|wVFnc((g}^*9&{MzRbz5~S$-_cU$ag5awLL4SVF2TFuPYYO z_&Hd28`}79xmJxg4!)^31R}lE``4S)eIYR+?hb87bh<eJcd`rV`K^;!O1wTU?8GgE zox6#Bd!|u3U~(_6DJsY9--_5CnvsEd?(BQc+yy)cj_&0v^I`+O_<~#bOI&o1WAGZy ztsC76J^50_U9in?Io=EzL+f7t{@OnIt<MNz$~K@2g{XOignFkjid=xyS!nXul-O@A z?W?-G<Cf~<$J#o<VRGJl^Ca3F{Y*#+;uVgb30{`IFCZfidxMW89}RqBdvC`@{O96& z;cNJvM>3sI>)O7_+55d@A5D6DtipM?uLhr%x{hpVB6k?(E?5}Gu!8wC2wVJ+ZY3@y z2B(4LRu8~aQW~Mmfk(K)5x6V?pNI6)lS%-ch(O>Z!heohk6P$2P76d_I}qCRLO1OK zYLrcM-~2Yk)ixiXni@_C3~^abhkXj^i}&Q8*HN0G6ws3$keZ7>_@aN|M%5lbG?z~l z-jC<$<MhK!ltqwIEV2Wu<<b2ID9r6gnF@}#w|<T;b!p2PnS0+OcNsMEOoTZ&SDo{C z-DoZN6vlGW%dDD621~8fmp(@cBV);0r>Z2vsUG^l0N~f%fsCQ87rm;JN+0*q=@kPW zp4vqfuxmKa2I?I~B=Hx=iHoNMEW)n+xnDnVCtU}S(WCtA)c854t<bG*VvB$N>`&`w z#L496R@}!GI1rwt%V3B36oxU{@dmtwm&*Anu5zc-7i!=LaX8!q+PI38--m%0y4N@d zYu^G~)7S3j{C+_0U}sQIh}~SyukAmIpKjc7c7UnbXACXDCRu5KUoU4Nx?uShP>J)3 zT;Ow8jYnbL3&QN?sl~NZy4=`&HA4=a<tRtHC#vA+30~HfH^mzDokFf7jaNvmZ{w*~ z4%_TK&UfAD^${xGZ{ge1niO@cb;42Fm5CObm9G%9kjC}RsC2|-VP4SEkeMJ}pXmq3 z^PNNaDLhY&h!pB^K>ro3VYn?gDhiTU|CTPM7-k&=RWyW$dGfD_R_0@)f905T5)1vk z=!L9UEA>cTIrUf~%7LWsq!4>L?$!>g+Y@g27*yyfla19T2bDO5Q(6?<*cvd*%4ie! zN)t;YcJIO=6MVTLj9`EJ&bkAAaZ^}&*-5=SO!nwGX0FuA*fq@>@JHH8^1QPiL3~Os zFps~p+-RCT&)kz|lO)G)d}e8aLsNwRrxP^in>gYmZegxV3X5$!`Z+$|995lKCpkKY z@*ufHPt|DvzS{VaBNtYF8bkgP;-813!EKLpU%FLW_93SK@~1Z-Ts5T1MPdg(sB+D+ z=)&&I2Z3c4xc8FH{U+~n6b5bfYVFOZ`^{z9{|)4?k6+V;1+l-|&Bi3ADC+hszSsFq zWY*kQ4X&hbHYM<pwa-++h#%Fdt$;6K6S(qWZTVI%Ba;GT{6s3>>D&N0<Um98w%QZ4 z$>KToke$h&jt$8X7vxXS=Q|lviQjE^taA5|nzf6VWa?qySG=*a!c${CG8vtjeL5cM zI1H`1O&S)qGGN&{`NGA;OexvN8=}NSvcyKMEV{87YO-(RO8&NKC3CDqlje~Iz18k` zwxDyEvpEZV=(TO8Gfc_wzzl@y7tDYBfjgF?jd;$_-%2q^D3fTb4;J}mb0RNXkwRj^ zEO6z`(VM9lyzBLfTN<E*kEFe;x|!KGE_yLwwvj`Vuz)r7+6U9dC`rArjQuhrh-zEQ z7X)(LBJATnI`Y0dprW2l_=P_<8>otHL4!B2cngM}?{)&9ef(1uHcoDH568qRL4tX5 z6>h1TJ7OPrZr6^vHBps(u+4CQn7;<uUqIAbZ?_0}-Op7AU3o;cBWdrwvkr*4fV7J5 zpOQw|xHU8AT@*{Ddk#ZVLam}^<6F5dmKoKZ6~*V9YTP*)DM6!jC%V9|exmWxX8Kh< z_a09+TBx=xQWjVq@csj>$Q@pI)BH9tAs&bP>*?QW5a$n3kl>i@H7~w*n}}}&{z>&D zsRZq6rA3+bU5XM}O(bpr+Ms#rbZo3O)AYTHd0EDdyy+%F75ulNL&^ZO&Z|pwmU$5) z+c9*0or#&ol1sI-Nj$>J790-Bdi+w|kb<+=CgU`4Hu-0p=X)5N-#KS9j+H2-VtY_M z=vf0aRqrR1^BzBnpPImh6;Zoy>ecdW4K#&6Yf}8GL(gCtOzVQ>F+|U<5tWSQQ|x9Q z@yug_VJ>1^4aqsX*Q>=@y$}~p>Ymzjs~q#v7mmVxGnmKznr6!>lQ6bz7D7Be)sQl( zhQ|tIBOAyxIuBC=9tVZM?@-Gb+m#g}C^MhKXu$`cWh1jqI2bDZE@aD>U`z7RIiUxC zL@}u+V>+{je3&SD-%{^wZzeK7c~lKT-A4`6R${OiJfQ-wNy|uQ>b-p7ttP~O_eyx0 zspO<h?q*|V0f@rN?lol-#wiTqMWFmVOMc2^`m;@C8IG52PU_H~;Boa&e@<*fc);Do zK6YBsxT7~@%zxg$#5;j$gx6m@`p?k6U08dfrL4-TIu|=ceLTI|7{6CNpXV8lP99Gv zzcVU7PBQ(abcB?y(FPojBUxnbYtSXSg`bWjYUIPPUCEQx^I#)u!cIxjJRv8t#yCg_ z9w(4&{*uVVHu~*=anMVGp~qWt%F?fXDc46C0V>x8v)vz_2MEo+iDf1a1G9_Y+t(l9 zd>NxsWnw{*%hjc;IOKvQ$~8uUd`cujthfW^rLCUemw+Zk2S6(zT56z<-)7_7YcM8$ z!O3#0N-tr1m}E+119h=j?(W3%7s^MyWp7L!H}hk+kS8BB#!(FnZRc~gN+At5b|`G^ z<QJIgA2NUW{Hv{jlN;T@z$BHz!t(Sp!s7vLFvuTk)Ow1na<jHWS^Z{i8L>@-am?B4 ze`TNwn9rBADNShfwlZs!wp=DSh$jVsq#C5yV$8JFq<)$qFZ@PdO_v(}L+$xk3zZ-x z@N<oRA!_Ob{J|*hU+JGX(y6B3z0-!P>ru{eCJbi;)4nE27Tz0s8q;p&V8xYmJUTmX zQ%cBP)r<GWDZClh58G~YESV|B4@QneK9o{SCs2au1zhdLs0-8)SQBe{E^FFwDC9A- z5T9UH!!w0GPD6COHy`ioS0QEG%oQeB4Y=Raa|_#;Z)o#B!1jKR$Gs~CgK@w|^YVJP zpUxD$Y4}Sd^L`tiBh2AT;i_?D-8k+P{B?tC+-E!x%GKh1i-2NQMcKEXWgE+HDRD`Q zC$*B@2h&92u?}Abi%$jK*Cg=Lu45xT$-gB^R)c$ez__&Y#;(yb*Wo6A3DtL-@r0N9 z@{7E_V>4`+3mdEx3YW<1gp*=7tlnE;&x}*Rl0`GSg3qSEZ1lR4d#!OYUW)CX8>D5- znQdhfbMx}tCQ>v_q^RLIEBsO>^Mhj_(3H{0uwCoKD(mF=re85OGjAC*&ul2I1<q`D zxZWEV`Ct?B#Y{cq{NJrVVyhp>z6^M-?1-(6PlYnFG#r&~*37$_n?#@Pi~X`8+WjIc zMl0<P29>}MF$W*;R4APeT`7+l98#XuJp8z02iLt1pd?8z?u)#mZExRh_hq$9s0Kq+ zP!Ms!tnIRf*IAp?oRaSk7*XbE6QRJy9Rd0*sS||q)8<};E=ZrwrCR6_IF<0*{e+!! zhb)D?Rr|&V)i_NdwE`kaVm~oULDeX}L^eVhXbR7vD|gO^F&i&6(`6<_DcNM+>fOwa zH>!5`@4oo9RhQ8c78b^+8E@@u$uY$hZ2xm*@se1A%10mnZnxmHh!lMNr>$aP3bH`I z^w)|QK0*mL<irW7$bCe&)u@9R?B1~~yn#XJ<h4IwH{A7%v=L|#i{R8`Aa-b0F}Tfb zf!QrrTnr_pWSYo7b3$}F;{C6>?=3fo9s6Rq?Z&_nD4J0&Ldk^KR^s0fNLcg2tpcp_ zozMajV_f|hHN;O5Vy?a2y2iERQS0Bcma3EJU^BqCe;UK5NtJ)QxTRU5l<jw;aq>np z`2<0WW6fTEn$=*`mcIKnY%JYLA-_aPD2lGA;LE)~QjU_Nnan-R1)o1*AF=#ndSmSZ zta1+8vkjo8_Vq#nq_%rejthgIf4v91eeGdR+UK{|0wzB^F>#+M(C?8w_BcgZ;D*Ca zl3Tm(sqP9z*6<J|>Izx)RGrK^B^%=1iTmb0H?HO7-pI0$HF3+8wJ)KVE=RPlLn4PW zvdOJZmFC3WIap@($;)v>C+C|(ho1~b&PJgei6c*tq{2>NwXZA<PYuh_Q-%FW+(gV# zL#9XOp}WbDg_^;ixpkRY56dRGW0#`4d!r`5$>_FMYDvcNU|E7k0{vUr&*C_$o9G49 z$7kGFPU)aRi+T4p_W9q^O|jGJZan6$vQ{(2=I<*5CBQ2tfws~vI{gD5O&5*9YV_%H zmrVZY65hM@xdV$mL)RA7i^p{)1ZeOWlwV3PV^UHBA=Tq_83S6vAdF%>hEVp{SI(to z{vOV#gpW{;W#g)%t^Qbvl4j<8P5CfQEwIYPqRB;VrtZdle6JfT;bB&z?NyAKn8)`p z?%4J#QP!0)=t!G5UXR>Two~7mIt08ZCwx1$+qdbu_21<t)Vq@Y3eJyi8Ylh09HQ_y zddIws@`GGR=wFUMF6*XLp&$Mh{ekG_wfFNMPzM)wdZG@w53c_0QESRTIw|bgt2KV^ zJvtFr74^b4*B0;h((uI5t_dZi(#z3A2+hi(F1fy6k$FFzq%h*1njp~uqTL7j#~BhN z-H)+vF?F=;pZuZ^6dHM^obE(=x_&82RG7k8Umf%TWz(Jcw@!h4(#!q5ZC`tf?%3Eh zLp;X(ZabGEsycjKizkSUCmbme<Gd0tAsAmAF}`F*xpjhhlCmt(p4ghTm5=06!Jv+7 zfpE_Y=<NM}*wi$jS5W7guC?L4H=AOk`M%L}qnpUk$!s)ZGgx=p+K-A+ACWLG6Jbch zze|wMaxhd(N5>3X2wtNl#66B$7!vPe;Gw{X%xhc|K^KC>$GaCrW1k>Vz-e<ML4>R) z0sU;HX-iwA)dzw^HuX)WQrdAw#9B$Qo^}tHoj#@ui7H!Xs^E)4M0@LU=p3K=htLjx zs()yM5$;LhR{#6gIQm*o4ksFhWjU;E5oI(4`X{8{djx~F`=e(AJM@^6tu_&p%y2Ti z5vW+bb3EpYuTvyWTHRZ@vQDUYxjB!tt*2*kvvFT;=mB>2Lqi6ZS8^J)JGc2johj|I z1)m%fo%q-z&Lk<!z89Md^M%i(0$(Vz+}$`j&#uuge$3>Fa{q=5E(r~?*Cpo~n571! zVkI-Ioj)Ejx#v#XzKB+LBxAk{?>Cme{`)TUk(=B7B8`{-U0J~1InIN&wuACbkzLHO z55)xI8hNQS(NjFi-BQ@&;)0y#98xF}@sS0e`8@99Eil~Ris%T%Uc<=7M%@~x3@Co3 z{?RIdlQNE(__cDQxKNBlepGK2Hc&EID8b<pdA@%v{oD|2RZZq|Iu_!ssd=tTooW;& zIZr$n!x7Ma*S180@C56JsY%UCayst!>8cn*`2C7Td<nEizv({#X6sa$D90X~@L*(u z629kOIeUrwWAXu0@GS%K>1ViyX$MUE79WkHe(z{>tLI=AZQSE-v8mm%la=_1BgbNM z^qGBEm8R1>gl%Y|j9M|o<XjUi@(G2qhS*kz9~@*a$XXL}ncj=%HLh7gD+e1HGMpcp zPyMBq)ns#((`+@CeM1`-F~lxZr3qp+URPy?$>K+UDW)wD!w|uE^n$E!T3)lPk8P7_ zJ=rIu^&B9LX~-q3Dq_)xz0Up5)DDitE~;Z|<@@`X^CXl81GJZPh>y30SrKVzD}K?w z->Jy;>DZOrg7189+;q5Fk@liaaWTn1*`4wf<Jkqm3+I?%_ZQBb?)1Hz5bd+MUB8xQ zavxwthzIy|0uT47L@#v?QCs3fr+mSbb!Rwt65gbnlj!7LvqRgP36=@Ru16OVie`s| zV%368w_;T~1H1WZ4A}(Quq(sqeFaCvdwgePsZKvHbsW3A*J=nRDS+%Hw$>ntdw^%( zgKm?6Zp~sEU){fZ_4dA94*O!$)o~b}{rJ!~&wo2xP+QVIwSgoYP1<2>2NF}>sRz%@ zC4XV*S`8CikzFs&r|920wMLSgDM~T8rJNdNEbm4zK{|Fr;0dj@FrUAhj2&f1rU+lU zg)v??Vvv+Wv|ts}CEkicAFiT!O(O8e`a0Ld>!0B^PiTtvwXQvCQOPi@8ZB3nzg|3= zIZa;D1@5ofN*0blY_KJpt{B!~qC#b!_f58Sfh$+x#0~r0-><p_Y19q;RzsTu&(>Zx zio~&Z$HWM*KkL*iZl=`{V|#FP=b<gdyQSp#9^bR~(d?tJCm~tDR!vDKp7$_V5WCEJ z?^-=XLL6$bF)(XEC{cUx|J;+4eyWRi52IbU%VD0~arMIVi&&LBL#>uPrNDqK_EuGF zo3&PJbf=7aG#1~IMeBb00lywWDDkNQ=J^*2I&XQ%!V!BA!E-k0$>QCmd*{FdWJ!aa znc3FbJYOl<nrY_QO>m0cN%V9y9C8{KAap@o;O4J5qq@^|fpx6ShLR$WDGErYbu*0M zq{$-I4@l7dORl}duw-$@dVG~VwR~lNdwiRevUtO<9+3}Pyp@p^D9#$klMVM)Qu(Rf z#h)~1KcvjVnVpum0b1{+FKcDGeX|Sgv?ASaE>UsxgIAz4H2>qD&RwQa$rBnY00(zR z%rJjLI}dLl8r>erv}ynqu^c%@;>0L;+$Vzl$p7_XsNqq49d(<17cI(dMylLp{MT>2 z)u8nPS={yH#eH^sYHH$rNiJ+PW)3~0dQM91Y$L2m+-gyE<CBeXp_|oK(K*|&_67t& z@ZwM9+ZaYv>B#in8GSd*ci(JERjI(z0><xJCv5_YmOs+zD_S9T|N8;WAs6dUMu@2L zKgO|S<z;SHNYFfxlJ<e&xaV7&G|5Z}?(et0C!mK1kwu12M$ZkqUY|ne>IJL@la~-6 zLkBOo2139t=lu&jd1IIm?%Q<w1z_kHe_|@ZyMB4rF3CL!ckxd1(_EkIz}*S|CdC@d zW3GI+Z@Wviu_g(sH~ZIQ`7J~*E@DCjumj~c4fIPnEEEblc}$McJOGb?Kf#;wu43k& zm+07dQmWSOG(Gta*8{~A2d(Crs<lR|DQ@*MWLwA2UW}tujFG)l+4FAsq05yEiPLjt z{tI8aeefBSJXic3)*kV6ow!os*GTyI6TI5%_-k7oKC=2r3N?(&X?QoqdzMQBFMrCl z)ZqdL3$*EerE>-FT$^Uls0-~QTffYACWVyagkL5{vQymU?vT~n)AxQQbW;rGEoJr{ zraIv&_~$iqPZ(fFpcHl7vWO?8Uu1cJ<O>m4+hcJ?Yz=~ks$Byx7FBfEXH5`f(q9lj z)+XXU$I-?i3e001EEncOqUsK}2?UtZHP!L`zEM_awcTPEZyZy*4k1w<ro5kgfGnRE z@T1sr<uIn4b2AaWnyLTrp5P^eAJ!k5TgitSG!t27ZRn#eIoA!zeo-^jdZ!s#q4|!V z)JEQU;6?H%+n%h;P;Vwv55a|Cv^+3LOz16be>n84iM%W)cATQpg}<_G`;uce%r|%U z`XwcbqTnjVOBN7M*zJK<(PDNkAICZJqFNQvofHi51pKR+thSA4G9!*?Y=dO7;1IKv zonM?uvytK>zaI7DPdFA=j7cBUqf-_xhX@n6qSsOU5i<1Gv}4+u?)#G&ER%-QmZ51l zGswTJU`)y{am+2JO}Da=*&nNUw!n0G^?~P<@q*&#aQKW(lrV1oe%zTDN;<i?M{!J_ zA`@MD7xDBfewW?Z{cvj^<tN|Ne~w*fk>lDb58c{W|0K32=RT_DXXzm#cfPX8Jw=%F z7iLQd@~%G=P0D+D$=c6xzwj7cRXJrP*L<Vqo~%(FMNP(#mWNxgoQ2{)3%Ya?@t<ED zmO&+me)u`L$x66*;uPgyS6Iw>Wpn1S%8}e&K%7r;oUEEWpViY-94#}5L?IFxpghR4 zt#li9!jGjOwRj@hlt)H?xwJ#o?Np^M#!mZ_DFk<oi$+)!WX9w&ucaSL7dN3R4c7do z=gE_>NH*s<R#UBTVsmM*C-N3P3IP%C`|5<ze&Y7AzDj+S*hY%_uF1EmyvJNR^(aCG z@l_<R(g(&5-@vUuKQ7(Cdi|ek9VrtmNGe}GaVSpFa7U`mME)2-d6jmGKi>Cr9<Cr) z<1DtKY2z-bfW_aH?{9s3c(Gdf2k(4VevIjnJy#4`D^bNazmLTmV+5DJKA&&oc%|Jy z5hHkmqw?&<Tg$Mdu(0yC(r*Hi_MTxV*XtLd=MlTeaw<wa>WVxLHu$!tAN!oOK6|%k ztu;TgUVf%A^k?<_-yyW1c9z@zZy58_k13M%V1vs?z+GgEEGh>2x*u>WKJ!~$d-M*} z!M{Ut)QaUp)HEWBNmWT?U1k*W&yfq)<!<SPZ^e#bs~tpXE@rT2>jO#NfmqQ-kwGHa zXcz+R)FAdL9&7)U=u)v$xt^oiqYb_h$MjYzXH<BLHk#HpK5J%bino5zMn1x<$a$Hb zYrAY1iO0zu+iU?D6v!Bb_r#`4>GN6sg)g&n>#Rfc<Zj$N)XeN^J0e_Fsgtzd1%$$p zfIOKmGxe=;qv;FRB@ZnJHRx;L>|Xh-PD7Qk%gUyDBierm%dCK|j}*CI&ye`!fW%aK z%evWc`R%QXlr96eQq^UHfefw`$*~xb<)?27ag4#t87-A#CFTk}BQe2QhqB+3_*odp z(R{06Dt;PnR9`ydcA~s0$h=3w{86-pvFB;g_wYZodAQ*0S~~eP_7q>=J>2yKeHE>f zulP7h_9AT2?*1to^?bk8jL&C0qinvEueSD1t#d{ym-|%g#^;9jaX6>ui{0TXYbsWU zWDhGQt?oW$K$oxyzaq=UH)B6w<}hI%HGVhBLWy<PN78=EmNya7OAkbf<A=|GTIVRc z=MU%xQAargqGTS90O$C3q&aj~-aM8f8YiD`ul_P=b&~)N5=;Eovpv<c)t~;j)oC|; ziq)f}85Fu&R23F)#LO<3WP0>D5Y3;diGPwcWzozC3dr_>gPl_2ksN4E?(EjTtSjVc zk{>>F+AiVKOG|-SdDQ1r`sFu6=gR(AzvVlz6(?LmHg~}4Tt+;Ks!-ojAvVc3D-(K} zek0k%`h5#Y+$CC8k>gTB`5HmU7(uYHiw+%gt{4+SepPltTD?N>?w8nWe4`@01q5`8 zS3N!*Th%nt9He+(&Cgh}@Fd2hDQ9C+n8rlqR!d4tWR?uJah1EPTybYD$okaa$&6XQ ztQ~WVrsSGJ;Uk6bEln{F20ub*g;)n@xmr$GT!0M+7RFv?RXM(e%&0b6+PZn;wN;%@ zZ@A9f>u>cEMWx0r&+asB*ghaDLH!h~(c=yZ#n0vl=dw0C|5)a~i#OZ~{~Yg-v=EmP z-=5%Ws>9BWJfj6v2~>*T7cWl8^6RfOACIKl7yM}P*|qgDFVglC1TABDj)l`2RUeNy zO%}w(YH{b}m3zt}!|SQvSk$@GxtRJ!XkXBN6G)>asYNxb_n&!1e0P;Y!RfZ;1*#_! zH)JZLHdt<0h&*p#ylBb1AMD(US(*8Bk<perpM->O{axBXdc{+WGWSc-Jm-S$!Z4Y9 zj$%HPh4%i%Yr<C^Ba=Ofm0Wr6axl31vyfp#K@+zFKZh5AMm2+N4V#8(Phvga&65w} z|3^#L(5A@yF6H{odOzN*GxxrR5J(x2x(;2?B5}Q`EUyZb`B#V=F?+oCL>tB5dasYz zkU`u|_EX7Lrf9sZ!)LBvC@vhvI8}!^oY3EbEuy8;F}W#E%A~1X&8pd(+Rb!4yM65P z5FdkBZ$$y6-Gu@Megj5Vv8YKT>ra8gYY2zdbr}JN@b|&QC<ha)eu>zW^p&SMbnMKx zd27I2m&YGL-&CMw_rAcNKVlo=jMnx&*l~rO+o~)y@`6ywuIZh4a~q!9Lr$9ss32Xz z*tqI+iI;j_L+M7J{^ixYie5*CE*oZftpcwkyL9wm5hU6kuqKlHEz*9__$HZz>_-9l zd>z~K)$z&0c5iyn@J~(?2WKFGu1~oA8MPFG)7qKcJf8ge<g1&(wA(VgKf3<C(J`ei z2Zaf=`iqZz!6q7oiamwlb-Yz3r1WPd?Qp1(_8vG8-`7%^vJ{(6lmB=%HG&KnNJN+; z!x-u|z+B{i#!7O>>U8rMj#zwlzSPN@PA{?4LeOWhVBco>DP;dqU~ljcr!~-gmuPbz zac}$MQ}$pz?$SA7E<y51$oOh0@w8mh6T5Y%SyW4=ZA8WRydexBu0+L1oIt6eBa-p@ zC{ncCAC9INo@g}=S};0p=`pIY3%Q}M7XQ&X*rwByZO~BVz;#Y@<J!(b66zhap1%s_ zl%}S|`ot{-da?_%=~vAj@iB~dogZH&8oun+VjOF!V-bK=%a|WBCOM8S%fR;|!9v?~ zi~g{Vy<p86A<Rx9Pl11~ID_tPw@-fZ|Izi|;Z*<eA3t6ZN9IBHJa+cp`<P`{M##!0 zE0M@J<s3w2lu<fH?@CsRWM?HJ?;NSjj3`91`#xTJe?Gs@@A_Wfe_U6&>b%bD^?W_Y z<8i;=?uVvMG`ludbYK1hdZVo^rY(YO0JLp>^c=Uh)V2=OT<eqn4z9foa}GDj5n8LP zwYkaODxzQm#=Lo@jk-yq&;!+q9nUajlRb{k=V;&(80^9~L~ssG>N-BSAvq;6l4DMZ zk=K(2fD{;~juivIj;}LhA3qpTdHrE#{YL&tyHlFz6clv(5G)=3livLCeb~}RexNaU zDNMl@JHI^i{6X3sCO1Sn6av&bc=(B0;!~V;GX5;kemOQP$U}NxNy*qK>(+sKezcQm zkkP5i#LcKpIEnlAVk~zy-p0RamjcDcuOqBD&+A_FnukNOil_Cq!t3=`bms!4JLlUI zgU8Qd>b#F!MRnZo54eJOox2r?wqFgqXz4FrL^r!I&)jD$eP6=j18a$s=vRK8q-3zQ zK8ezGH5U9=X7DyKN+$(7ArLLS$k&a5g&Nc_BR1a)Li<&l0(8O*!a5R?Qt9Z!u##AP z+&OZK#&QP!QTl)|9Nx2}RE)<P`>tAQOjpH|6Q6i$S1D2@)R{}WfTAuD%zwsrsOzpD z>WIX2SJSIG=F@-YqK*&p=$Zm*$gk}qC?Xsz;|z%Npy7J;K<~7K-ihzT9|oKH6K2Qg zT~g^ENLW1|zNO>+wV{U2jcX2Rmqjs4jbwhGTzI{Txg{_ha&xuG?HcN-|LuO-9bzbh z4-Ga;_ykK_{vUCA1DzBDe*@z(8~#DXNWlhA9=Q2X_?ra^6Sn`LEy~%_Z+I=?u|FxP z@|6$=sjHGT;{u(!De;w@Gd^ejSoeji%j6jh^YO2;IG%c3YW<P?<nnnJ>CPsCA;U*b z{qnUWO?d$Zmv~LKbHXJ*^ad3ryRw`ss~B_RpQKK39Jw}>49^^UnolnME`zhQ9`QKV z7I%hRpWK4Kn1CH2A><L5%T+-(njVU<8D=PMnWI$Z$D5mz#j<AfR!p-_w|g``=;Jud z?D4X_!i>SF5&aebv<_nTbq!hlm9ox15aiGm%ew#QeDl7RfD@qpe)vREb@OKj%`9L4 z83ZmtlvW8ZPSbSq5=gYjj8Gl?<)xsh-O;F65{6dl&e5Xl3|81C8q9<F=K|P|Elins zZ?(T6-3Jw&L5eCG-Q)?5>h7C7njepv_B!#my%s=SLJ_j2Fb&ywlMX~w+gUQfVYX@B zQ)%R6Ykf>U-Rjn%IHaI$Bb_;=EQF_fU3W4|-2RuSvJr*O5!N=sdP`p1vS^CGP<Q;e zKv!}^|7udc5yV4a*)`&gm36*b@DCm1=KhAg)pR?HRu7wrO$ifvO*JUVMY&L7@|HVK z3yx99lbm`0C#w)T1CW4*Fd2&iMzs<YV=uc6M#ZgPBJg1W8WVj^dO2#0T=62v8Jtvv zVGGp*J-1FM2R$*iHHCBMm94M0$DlOw75y}e=jG%LPDdS~XUo7za>_NMGcB+hxCBi= zF$yZnv;zS`SxSPyp}`(-(yomQD#@DmS^aYp?-Y}k9$uZVgCLr%5NR9cgE4k6TS1ce z>ptBIG&mOv&i2bPpBFk1s}j=wcPjXVa$`9nu4oC0r^zWHC4yH`^oP0Ea$LMVKIj&P zBnypItUAp0Pe7vD%D8&67Hj+M1*QSYbMFmK78{vNzXWcY1=FccMciA^%OCaI<s@I~ z;)&`*2m@(X%u)gT(I9ijUT-k_PDMH&@fuLgr7GZ*FKJZt9+3hg7mN2=H#R;6=tysn zf=PP!Xb_EbB{bk%l91CU3r@}D#?mukC8fuFqRSuY8D*FYeu<vT4^2G-Nj~rCK@H&W zcNn+82*%7EU^=gj4NjFbi7%w1g$dqfS$AsrVNUD8Mj(56g+*ux1%PBrs^a||w$>RS zl1PM)fLrLDEUaxj!#w9&N~hEZ5USD;3U{4BcR~65DSx4-pqedmUr+Eg9O=BqKSiZU z$H?ky4Je{k#BzR5XzgA7gD;d~mx^0wdNQ53N@oom?q`kxIVUarLW_<Wb&5998B1;h z-5v0ZkW+vR+<<Q6<pVAI@nWHd3Q*}F7zZ$Y<Ut@;_s$)x+<6d|Y`~H~2B-Ta2t~Va zaFsd|h!tkZ#zOO7zrK)Y25a=u_ebimOL){E(IF7@m@*>Yk@p#U6l;6z7O1V%yiNQW z-^!cfv6$U!j8q8n;~X%bc0(2HK%|=uY&~_$!B|mSH4)+q6LI1x{t{|#qyB6KRebJn z1ms#&fWPqM|LZnm&cY;>R6zAoEAQW*p!O`DZHXh(RLjj8^6+}lB#tJkn)w#{Syw(s zAAT9R=Bd8FIsF}ihc0tE`1*q$7BTlcf08bh*OI)B$dA#-q3(!6`w6<4*$y?nTLrGc zL-YCJEOFcZ6KDRJv3f;h6aKdnhAv1lf)Qc(!5qqueas*^cpT+Og1`y{a&*GBVrfb| z0NaYeW>hG%7^lsfW=Rd!V;9`I{GdxR_RgB@+!*46hoxvu;xf4k@%E<^4W&|E2WPVm zJ|s{9u|sICG1x7v57id}A_HJqkv`_P|CZ{J4KP3X1eb;9b2t#bnBb^eRXs~SvaaW` zh@3XT+qF{L3g)(-;T;~P;X++tBJoF{_9vz41@+_o0u2vtB>z<E#pb;aFc)|N3!xUo z^DjxJ1+;`G2lL+FAG_K_V<^C<8g&+eJlgQcr<<J0SJuS=neCG_|ChkZ5KQUw>7nE* zXu=Wlv{2oF8vUSrfJ#3G=z*1P+hRu(ZViCub820E@x-nQW2fiAa<CNP@ahnz__Z(+ z$qD)2&ox%ZHd&8f0<o!c*&aZler_Pt7|=+1UE>wEJdgN>O@oW~f53Z`P!jrgQ9HON z|NX%HxVQ05my(<LYA?5CsN!SQyX>hNKaCfG^Mimz_P5~XSAwJIJ=hbMmLVYq#`b1o z{uClUhM<rw1*pOn37^WHcn=U6clWN;XUNoYa!%vGJMj0bAx9LLfIkHTk#h%IF!brr zT;!06$f#@=7gMcADjB`Ty9Z8(?`LPVBgX`=(~Uxt$REgUTGC~k;28t`<^?6F*09>c z8+Me{4bIyap{D#C4vr)cOZ<O*FP;T;h&6#_j?RJcF1*R35DI}10H_>_jX**89h$pU za3-nGJ!mw?7^~;o6mJ0O+z)ss)i&m;uOEb*kNkR^^@gg}5C*2Mk7?49m0amBoA<XL zUF%N@%{Z7D{_j_uN@Wx>B_WnG#QOU#gXB-DY^76~I3y04hCofE(_FV)e0M)V6JD-x zkn%?{BauA|Vu_iLew)7ice!atYBTGSKUBjFhJc|p3i8b#?_CqQXS-@aN96KwX7ac0 zo-O$dl-6Dt4_q0)_9uFHvDFkNkN<lWI2dMwd3aw$$K5O}m(Tk!9L)m<65d+FA|w}s z-7A06=f>zjB?KHH{)6rj8B=BeR4H?Udbv!!|C_Np*7Mt2^8&ShzrZJ)tM(w2aU!rt z>emnB_y$xV1n>9;`1~TG?a1xE4BSx^w>zPR%wYd>5qRA;W^ZCT5|1`AI>h{kX<TSr zEd4kkkPGSjRNsLvY5!tI|6S#QCSdB^Q<U8T*Fa;P4@ky=(BumOKWpf=vP$fLr0LRW zu!Mbf=^w|)9Fa_~fcJItHXmm|1rQV;+1HdNH$uhgIW+P}&R16r{057!TRdC^Pu(c= zjb8EiL&4suw!-ScjWUTs)lkpM(_vr`GZ%7W!RXe*hdzP0mk$68yk~&o4`ET$f}#7X z-=NlexI7)A9J|1u#|7gPgwKDbFR{?Bggj_B*v_;ov3=^SB|4#oyu6q_BtHhpBM07+ z-n$GHmljNj3wZF9qBi`a7N0y{0y!)!S#>4#p4oUaV@hL=4v;%`nrrWc`9W<Dnay{u zg9?u-Cn-9KS<LNx^sj74Kv3{T!>tOT!?hr@+ffp{b)Sl!6DStKOtwJl<nR(~nM)l^ z7BsUnG%6Gb>el)EMymRcApTG!0TRmAuw~v`x}{GS{E|y7_QByj_lm<$O)i*iTRn`P z+f~Bjen5cL2u{dt1Dq)bf`aSkd^<f^$h|7!kf!VZJWMxo8WYrG74OO6lb<U<<@klx zLFK(wnyJmM`7jrV2}hQY-e_$Eu^vfedUC$`OLNpgNuub=uWzG1Wd)va9d*gRgjr(e z7J`<1{|(W`36qb&#6sfkW{`}d;aPXee6+(s3v?zg#C!j!qM;XYJ1(ER{{E!&D`tso z4eT`I(VL{+V9XZ`3aH;Vl7*4^g-UmRAzoSKsRkaS=`5!fVb<YsX!25TUwu`e!-u&j z;~yVu0!`Pf<1e+jr{!nFjQssl9pdYLvJ{BM{%8ZT{keG(MqM>PUIjgd4FeO5Q$oJ> z+QUuOaJZWy4I1fZFn5jtI!3V$c_wnkuoP+bh5#_G&``-LKd&+x3HAe)t0(No>WbXM zb&7C)xsKyFeE;3RhMpg<emk>D>4U@D1K~tb-yOW+eH!BjVS%Svod_GWB64^lg%1vJ z^wY&F2rCL^w%>Q2f!DMO0*Ltkd$l?=)i3|31)1K9!~wJs*Cd%;NW(Om?$eA3|1IZ; zdy{dejy=V?!f^j^PnS%YG+|OOcz6%)@chELRbSJaV8VC<wuqT=E5V2`_tW>tvd$vu zl-e5rOWRJ^yO%)sbNO!K5)}L6Oa3kl`19q1zd)|{QWhazeJVR_(xEL<bhR2OC!7Vi zmIZsa-AUwyU!d#~F6Kc`7DjK_zx=bmqj}O;1MGLb*65x{7#<&y&GKB{zb<bO!j2{< zWxs2>iv@U)YMkIN3iE`jQy0PZ`W-Zl&!ELqAE0^1^5X<7kk1z@UiM1?X6hQRxe;%4 zSmo)Tx4z{rChDZzjD%{#KF^%tw#y)LD#BFo4+X;#;Y`UW?dq%dGq3j0C*##ld)O># zd%q`Jj0VGi)Ug=gaq0SPPaMv&vXU2{utS33SRXumm7r3Pb4Rx)QsEWYiDL?CPB>wG zVFUe|CvpbODeHz~H52*0AMpHhj?5RogYkp8tY_+4%!Wk2ajS>d0>qgz6kDwSMBev4 zy64olmUnS>2lvGtKJYm_b~|_~nh71Sn0j4=Knoe=CY^Px$LrK6XhhqAlzwlwIssXo z`tsy6k2|5yK1>AQ(CMe2uRuZg9AwchK^6HK*la%C*4_22_txXhV{XTn!YcoO*ImWn zSaXjqMIM6Z<~t=BEnNL(eSWb0`giYxJ=#c+zJa$S#Ks|TM9PPVM-?%GTr7@|pWONh zg$H|(jymP)O9*ydgE{Lv2(zCfZ5xFpWHCo%o{IjYcWRe^EDcsipeLUt92R7(yM`c} zvo7py|Jpm8N=ZLvbjaf~f*XC_2ZyH5HQ$Jt=0Ep7!+KH&oYHYRXT^x~{DMCj40Omh zx~eR9Ujfy%@NCL(1IR5CqI8Rb+Ni=I@b1bTS>NL;3<7tagPrWlmvSqCYe6`^JB(Ft zp1E)mPrL9n`~G{PS!yZKcoMc9kqQz=l*BN`Bkv$c^0)Ibegn$-ZGv0$6hTB|DtobY z3uf}SBReyh7V#x-)m4ZA6I`kzKw^>3T~ofAsL^3^xGgxy4E7PceS6X+rr99^%+6+4 zDIKph&0&*_|LPO!>9;#lE*NtriZpjS@ijVwd!`P!HGfj_kT)bf93|J<PjK2mOqWai z(2l5t*IU^RQ)ds6J;^!4r@n)Mf)?PRN4sjt2e8z>_mFL2pukgj*6+5J`xfEg9t~dm z!suIzrgg?xvkKL&n|pUpT^}SLQ`v};<1aqSw{n9C6XfgSSE%ThW7NSY)~D*C-<4zG zVxfQ(ZSa1`K7LB9P1ucB*%GVY*aix97kG)Dfl2s^>?NFD<3$Do^hN|9AJ@-YBv_5L zUof2LQBN~AHNO(_lIe^+RFquOt|j0JK}mecmJUEn{C($`%|=H2eNZV&(P;hIT`S}* zJZ;4s(j`D>T*XdIRbhK&$j^0HU@dqa&&<=OB~FXHW~P@uc6BXQXUP$=Xp7|ESfcV3 zJT!(GT<sIT>XBGR;x8EYylEh^&2D}Kw(8Ez{nyX<+HQxsu=n3T-yHMDv?jLY6y4Pd z?(1*RspzKFt5X~<f_#!3<75+(VSwO@<m}SPlK5i4&&Dhxb5LZmuzncKy=k7AFz-oz zwnA*`$H!-Wn!dLK4$cH1bFwTtR%V<p8tlPbPv7aEQp0v`3U~4}=<H$krWiOQ$B!HW zd2$o>a?1^^2N`2CnMQZ46Q)~vQlhiU&&Hpt6k=+LFYn&+5W#1V?=Yn3{}B{J-Nx3r zWg0YgY{1+V`keDTY=R0~1wIxp!X|TCDcZl)qqIYd%N*bSFiw)=KFf}JU8KU1?N8)f zB_0X=qR46$Osj0da|e4qq^2wRhVBUrFWDI$<JuaoBa*k|*p`JGy9mBtJCn+2-e4-G zR@)M;f4q<F{~0@Bn9r<HYHZL_jjhb+J+zwnouR6y&fC4RF9bUUlT><){+zDb#V;C9 z3B3u_Y2m5tlNs(pA(`HejRmT_IQx#%sg#4Vj;vOjz*|_ql$&^{Pan6YCvg)uJ;kwN zs(HGf6Ro^XoI6ag+=EFtaz=XRtDOmbs~Z1O;$rKiubKtfhsh`+Br)Vp{psCfm8s%i zEFF1gSDmg8_V9C&sqU+u=lQ@zdE^ATrzg(%O?d7mkE#eRtO7J^$TYZ$vO2Qf(?gf} ziKIV6xA}wJYpSJJ<)GijP8lU!cXFwKMAzQ1MgD{jaRiNhPceD(&jnVjz1y+@P3LML zOlO5u=`=VG9gT104|X>NzE_WeMCU`&o^nZ(*c%zyBC%Qv`6}mH{#X>Jsy#zh7pth{ zM3K+=9f6~A8@|<AN5)m_f|mwJUmp;z{M5t0pbTcdpE`fKSd6eT<4Kr18RC2ro1Ia7 z-@eAP&@H~ZZ)GxRzAJ%WlELgvQ`}v3H;kK*Oxj)5HUWCeFKZK%x*gR^Y0NaJat*<@ z@D9U|qBCY$Vm>(ZSxET&dPGVuaHPU%@33wXWq$(Ro=1teY0yXHwh;U|Rz}e#6@Q{Q zWHWYV*F-x7^>$}v*E#`j<NJ+K_Kl)Yk#-k{vrURoKIhJa+B+V@)+6*9Ln;FMnEt6a z!$bi&4kbpMO9iD*j;a^Vrz0E__;-tjH(DW;T}&l=(EXXOQC>JjVih^|;!_gdGVO?9 zgoWOe-?tD`_OBz^SBZ~<L`n%jhy(u^MV)O4?+MhaYeme+WY=J;_I1PdV|R+Nhj^U$ z{a0sqwH;aIOfw2H{C<H5cVFHhr{N@>>33IKk$FNBOREOyQ;&m*aQA<!48wPV?Ir@! zjOWqg=aD8d^L<lT&^dlTGpmtkIC10D6{-|Yehu9FZ5@3H4;dQ#%ZOndMraIWU^t<o zkCtPOM^mHS^bcp);w+1`(C5(1=ya33Q`_f@O$e4kPGnoFCTIG{5)$Rd_%p(RCe8Ex zBRGIxf)>W+yCB~R=2%TL!;pkPMzv;zfx`qxh&fRhDFd)Rnp4qN`CXZ-TC6a3Gk+lJ zTfKE=&RWU7)Lf^kAmzx-ujt4~%OQKc%?p~yjup5!=+47zBXp`Wx9%CtoDJgZq{^wv zLw-?gB--S5?lF{BkX@reBVw0$dwS_9u~SGcN1^ulr;y|^hpNkR^se;h<l`_Toc=lK zr&mi0V%g#^RL;3A3O?em^R`~jNMfzZZb4(tRhiWU;Lgh(b$gUex+6!rW+K%0tAvKv zr?{OefKSnQu<sdAoEnlB$=6p3m!HESrPX@ypio$$`|bgqDCWd7<HM^NcZCN_iQIf4 z*@-;#I>ioX_Epc;d#xd;8~C`%1UcL<(pjP?dk-XCHU3~+v<}Vo?gybiW$2$9i7H>d zNj&#_%fT8SDI_E%78^;b;ZCK$kG`L+<V(lU+N-461V*H&b#W$oH|(k6bAY>=NeJeV z&`^27^EkO|xQSvR;<DAF>~5F-NobX=F`tdNeEngrO}t-wuq(|(em7wtGK9;YOjenh z2&{r1bGs1Aw|%*z;i@!$m<ogQsCKdHLheJ?mheon1m-nDd5O(BU{v;|pCI@<C>3bv zjpqgHoF%$3tsZsfba{-xN$~Rt<%DR)m*V~A<joAjvH)dyKH!%43eIt#V^SpZ4zYIB z!<jXb55mI4-WaN?`sX(?YMQ9GiV`VeAO(F1`bJ?p67f<CH>s3bOI3p=bff{1M!Peo zqQaA|hMK~c3^zmrv|dA$Koy+7ETFjAUu7mha%=9~Zv-12tA9@tyBSgeoZ`Tp!SF;H zuLcowd;vWB*&V-LgS{gMx?Zy%t+=^kYbF=o=ray7T3|5lVlCWMKK=wxp`)@#ysa6i z>jyKfFT-ZbIa9$$4X|WT8xECCr<7WVMV~^bs@Lw-NToLnGquz_1Tim9k7<(2(5~Dc z5V8CoW`f91;ki>*m#q0LlVk5x;9usyfqJnY6nPqwpEEmo{Sj+zzq+|H=}donZ!ma5 zZRHkbNKx^HXM|ssmRQ{Cm#HWn)K_^uaW^TS8(VZMe8unMZhZt0t#%@Vnjo`ek%CV~ zGn|}9cyaiyp4No)X~B%k5EQV_y&Cj&hxuSahmI8ALmP-Lhu6YFw8gDiP=_)~u+D0! z%Y%gIpB)8XQ=~{{9fI@rY(%GK?}Jxhj@>sEl=zO1koXNp)`$;!N3K^&x<7p_^>$;F zerN3Vo}x(Wmn7r9NSC>rM^PW`fgz1-#+6*#$crj(uI({oWpiBBCS{=8tLz1cYia-< zrw>UIj@%z1*hrh>MdMj%VE@CPu6aw3^(jBOR<SjjW0j81FJp?ItCYQS4R36M(Tgn4 zsEZS|scUVgqYwQUF<&K#)%zI1cY~)(=SKujH$Iyv(jrhmDU2>As=7qu3{tOuucYTW z+d>u}`M5neXbF4gXWnoV7iF8oB7<3P@KC45y@JrAsd0ND{@B}c^rUN>hthC+LFO|p zUN4str@wNn=J|E1af$EDhK3ZLUE*El>%Z;S_tQTi)O|ePHbS$Vxohd}G|fQ5rOm#O zrR2pHCA*@mfpnjuxL@ebNZQHVQSCQ|$LgoXSMHVt9{v(Jc!V-eD|$OZM1f<%%=j3~ zH!>r#;z#IBLSyO~W7_^dg^LgW`LuE9(4Tb^tnO)1<b_$62e42SkWoHOFfLmfrO1g9 zi<pi);LE!j2!Q5$LK`lQMp>w7FJ$%;WXYP3f)j_6hw$PQ97CDF=}0QAdV`i=re&z1 z+H5UsytH`sxxRapF!wt6&X?nC#a7|yAK@YX(aids^4PSUJau?@T?ryz`;<^gP%+LD z8!SUT!V_Ji&jb={We@vs+ObTcThr#PhL%D?FYpxeu9zM>|6%$@9&=stL~k9*FgN2i zCDqum2d75qy1Mprb9qZ?-MLe<qbr|U3VtQE2h^C0k|&N87Z5H*v{Xt{ymD2aV+s^! z>`&OjXSc+VC<2xe!&v&n?JDn`Po5#Sb<uhgnu0HwRNCxYUCo=Gloz|5mpdTd)zYDQ zeP`OPJs@bw<fyF+w{`dmA8i?&@T2aMBL(Zf;~aJ`-5R93J?6#~Mn_cL4r2n5T%SC8 zP5?OP@gcRT^d7P7ht#bUX-_ygwdyvz#W>>q1d*K{CPCCH7KjC5;?QF+G}8UMG5z~L zyD=ScgCf`0g>*RbGu6&YV4q=bF}~2}qwg{f6IZ%oN?l43kMy6O0DMFV3c*oueEpMW zOwWBV_h2br0PMLjLivlV9zI(CoAx)R%pVCHEsW>?e>EE%UbFij<5GP&CB|PI)LhZ) zgUBf*Qu3^vgp@;VH=><C2Y$!04Kv!_pH?wJFa<de!0G(_o)_kO5OTJ_vgkOOk{|W8 z_?hU{#*`2)?0eOEE`!Q~#^6*ZFR|yfzVIm~37l~ONJj_NeTU;)eBv4|;Gd=|Uim*) z!GIBi;#CC_fZ*(03Fnf+v$<LAz!Itf1QEqaA^O1vdX1G>3*e(yAts(On7!?RFcV)= ztY6qn+(4nvh<0iqFMDVrvDkN0tG=$X-*d)K<+@-%^3~6_=QerT2GZBsN4mqiz0b`o zHhr|d!rLVL8~%2|=j208L7#)al#|oGdNZHi$0zyfP5;E&T7#w^j{?raKO6qo{(I8T zG+@#Tzst3C$02G{>#Etn?uuebUDm;`Jk*ILl0OwS1H_&sE<e9G9thC!e~_;7pIU={ z`tvrv)Y|%+2$<yqbdLOn%Lkhe{+Y_8)rY6&wUKJ7ddWn(;ocXd6ov#gEF?Aq1qnf^ zKfP-Y){kj!nPVGWC!o0#(nYHlg^W96ZK$FD^5=ly1(d@SE7wq}>MYyKh0?q6Ea`Xa zVbAlu{6T6p6!$c}37Yc**Wj_81zHbM!Nf64{oy|@6RsLBQ*6Li1>~-?7SgAfrO@@{ z#t<f<Z1=7CUh}Q^%>;U_N`x1t&BXQ_T)t5)pH?Q@6NKdH#(Hi`7eULWn6_BlaGhG} z1)ulUHS6t{LIHE39_Kc-7Q~nQ>`AuguH?{8MmyvXt{(kTR(Hx_wxo`RSbNnW2mW{= zZ^oH_VP|GmDEfM|B(>PH60gx=XV>!q3-(I5-#+%jKaXeBm8>6wUtGwmZPau4I8;L; z7+v(Kk@&Ro=>`6)777bclX?ui(mxKVRJsaRdFv91!<|@>66i$#VZLh-@M`4})E>UH z-nU^oR>S58S>DTCc(1&JRugp12^APC<a7-4UxdiVVsS-#s#&COhFIGR;aqbG*jFE3 z1iL>1J!a+1wboQs=wR%C@9?wm7WD3-Sl&SWe)P?KDB3F7$xS1D%4D4|=)@FX`teEC z+eBMzPcqYQ;1s9Fh!TIzSobN;nVD_-s<*fL`~^zBcYajjmtQQaHS1ndlB<ac4`8CN zK;RIw{RN!0yJij}iNx=06i*wzov`4{&&sOXfd!ESJ;+x~@uY~B!;~Zd5Bh<0v?Q4* z@gLRH2QY5Nrw=-h3>Xo_AYS&v;N4>=evjCgNe{9(0UpB#>1M+NZ-`FkONEN_XQ(x> zvpRxgXv(GM4}xfw4h?^+I09|AH;%aP(1K`Yl#F_P+?M>LCxkZZd7uXwka_FQt-9v` zlrHpCakzDst%|{-x>hG~7V7EG;B$B8U>EmA3bGT_L5kDJ(he=nuM4{WUD*@3Q-q|y zPhmz7i%W$Zx9<`2+^DPtA$SZI`k^|l;x|%J@C)`Aeht>u{;;tKhke;cSWS2(w$1}D z!5jJ{m55+`wlB{ef!iU$D;v-p*p6_6aE8_lb`fT$-_%+M^Qi|F7?sOL8k`#=s*F16 zz>mxmv+26bRsa>Hz;dehwEuV34Waw?;4DaC&9$~XU^jdE-JKeS^aijHkHH<$w%=g5 zL?x#RUjDsM(=3nz0C<`+3XmO|Ydj0rP0sAX9f&L-9UOPyHM2h!f5Jx#K?bII82CRq z^C+j|?EhId+-Q7D>i$aa-9!q)tl_hQH1H)J<dHy6Ttd1|z^{tHN=`v(C$SMJ<l_ZW zSC-_U?YQ#z>hKLsXqdwsnDF;rdWfMO0fKb3pEkXMxO<C)jBMmxhacD_T?KEbg+75^ zk+U@)OF86$AdnZBaBtVIm`0!Vt#Srw`B^9;LhtDQI>#K2)Emh^0qu&L&RVqm%6B{- z%{K&38`6)zLKc;BNmftrZf!uZk^E$bG(vLy1xIpFlK(1__5oo-OvOyIGbD!5a;ptf zfC1C>T@}s!e|J}$qko;z4)h&B%3Touyy!w$Zx0tW@4MW;Jc+aykfP(_COBq{9m~gc zM9ka}Da-%dG0c-&<`Lj=C^SVF^E{+D(nqMUusXup(Bjf_t^Fqu&r;2DWm-XNr+QcY zas{$CtP7gdI|nT(KNslT9?MCk8x?M_b}ZuR!TaOBLp|utc`?f!I8uxPXOU5Yy~rOh zoXuQGt3O6-L_l}{({$}Z2yOTEn;GVG3t2I!sw2fR1~}E2nBkI>w>R7e=7ayhjNlAA z5S6W(dKM_0CMWy-&jtU_rB}1YtKd%?2ttVS!#yaSR>(3QB7CR?CkR}2LdEN980|<m zbQBi1oq>*Us6by<|6cn(zT|;^;h*o|MX9kzz2qx~5R;|~waXB(gkU^jbyyKKC4Y{% zU>bCb`Mmn`7cjzG*(OHD-O^U+NLu|F;OD$nmwJcH6<&prrO9=Ui15t;jvr2+h=Gm> zU=yC<`g|`k6(EGrOkuNXXi5Ito(g&eA9%x>Ux7Zk!hcPuD!Mob&4$MP*_@_lr673h zfnxeQ0Jfh&5&DJ8CL&H-KY{UsA>?>ZFu)DkppT&)+d6ue`mKf57V&e~dox(b<ZWjF zSigAxT~W;TLnt_Rq}_}T;z5?ng6NIWn9sQuF}~!Mb&;@@*^xDDqo0PEB)lXBIw>&$ z4{sX<`c}wBJ{gtPmZ%VLCE=Vi7aQO%#w?v$Dsudc^9t3ts*GTcd6jv{=(Tq%lPjR` zzJ3Ymu|`1`b<YtATZAxSn@*@$h9XU=UG)=yJi8_`v*)=LM@G4QIqHMG*Vg4~s7Mdo zjfMjD=I;UeXt;15Duf7&v_xHD@cjx%<x(9=D_ABEehE#Wea)YH9gGOh^UPzrK`4WB z)xt~HuXl{LkUQeC0rk*DAQS%AC8R5?_prV<>!;9i?g?yleyA`%x}_Vh#V}%p4D<yr zpulL+byX>UsRz-}Rhog#bExVP?n}c~NFSI|vWn8)zq0v%8-KXXYwvDVzDeJc;<zVW zY=2*1kY0C;TK?NXF8V{EqmpRNq(hdqHAp9QOy7PT8aN@6w*ov_!n$BCxL`pPcbkQ7 z)a(=&hT{m|lwkY<g!8x_tSh1UD#ct+uNtOwY&Jk%nC$~t?jm_lxoQ}uV9AMgQX=v9 z5=Gx=F|0yEXY|_aeFu6Dh3>Hzco<wYB83rcU_4n^V=%C4--<_O?Du6B&*5oA%$$gq z(&N(`hiufPJg>r4bD>VhFVc3EEpvl6?$t{(oT+C)<uCCL1|wn~g`XvSYBiq$>eG$H z_C3U_rXmdv7HQ|DHi0(=ZO`hVR<D`FJjm2q10`auG`}>q9dH)yzemr0LVEIPQnL-3 z8zlFbef%@jm#edsY*aflxhfa2o;cqeWHH~nA|M$0S;dol1L{(PuU$H<G5K5O=zmrX zCtgaP`6ug-7>Q>}Vyxw4+;R|T0dlmj#nA8YK)dJKY?>@Amw#dy?$xKFMwk9KH}$_6 z%Y&y@AWU@~6TjtlIDQ}8Rc;8t2vDm12{Hq!b6iD$_+pg!brBWL_udyavySBkwiuUG z9kX>IYuX2z2ATd$P6WppBHkGrK}K$gVI^=G1RJ)@P;0<6r{QqxQy=OnDgjk|3SVCS z!O<9}i_^r&k9NW<yFA&k^Zoa4AO0WdV|m6WJG6@x&=G_>gYI3}#5rA9hDH5z_*lRX zD@bD4;BTnrj&Vd{f1cVD<2LW}Z=-eJ>;o9l3#4|hVDZ1h(-x|C^)WDgjRJ0TB^eXg zOa#T!3qde_23MIh!9{iC0>n#c_-227QR-N;!bPH->!DBQ6>^h4A~wh3EKVNe`#mHT zyNvNKV<vwaZhzw!VfQr|lk|~|)+W4f35&$YI&@#^5Ye(GN2=DgchSlR!CuAc7qa7H z;5&4BF{?tjYLIW_EvzU%cC<g+*rON+;SH95doM7>hKQ3K*{0oX@cEVW6R~e28euk7 z0?6ib%8AB4ul&-`420eis=QIWbc05m{P2WeYJfMaQGtowkFC&Abg9#%lLxEh)bZ^U zY&IPvXeu_?9SR^UmCXl{vt{(K(55d{_MN0vIH91tE_4LblcSFlzrxq%r_jSPc-$(T zfVVWqFyb_aHZU`T^^%S+DwD%eA&v?iN*MjaRXKnMPC8XSjK|gTJ5&c?g!PTzwrk|* zI(kH*Vro|(xHhAj!&V6Qgpw3eKGCFQqHI2RVUn`&7Ns&DGs07^hc#l8JjvT0k5c$* zFpU{mA|26Y%n_!C>QKtp4lLFenB)lNMtdy3T-IW}urLvNm0xs=IQdm&ls7?~+>h^D zExhRa0@Dp^PPh>fRR#}LDGl-$KM<DkBqx8ijQ<DyEYG0C%{RZkMlkf{;Uf$f<`i)k z@GPFu*2kv<T4ZY^_ZeD#zy00yyEiz5M^#pZ>3`O>p<^3It@$%w5mv)$TLDv&HiUH@ z#RylQmZgtEQ3!WVT=i@;7q0S-`c=j%7n3eVeOTcozdPGFW$F*o=}P6`n|fXADSF{j zG?&xs#E?Z3A3>%`@5*E*@v8O4AjS9O3H9oibg)&BA00~Mf~?+arGGf%e`JHk{tC;U zOPI*IaII{-*kGOBo~(mMGI$-5bP{z~O4%toG}|&w$WGw|3LK?eL@6*sm<IkjT@}ki zIVJ9WUe4_o^zO^lN2V9qr$(oTuwAqu*BB1Ml7cv6jl1b-+E7j(sMV(?!`ZOcy9%61 zQai49ClwE+W)5I)VU(;Fv#;=!Z}Bg&UgwF+bchCrW1|tX{tIr@D+&Ecbq!XX8CsCO zq=wEq2vIJEJkFP1l;uAwz?jLCx7b7f3bNAo%RENA-Az)vL+9A|7k&@OULV))>ijub z{Xh2=E72BlTf&^}dbj2E_sT*s#k6$^2*nry6C$7_4fW&GyC5$U6yJ2Cci~DyKMI}e zca9;PI^Cn&Q-Yk31@wY9K{}MCX_|G35RWP-mQ6x3uwweNPQzqi|J+-km!;~qoN-oY zo3Q?ZDAqlHOvLQYOxN3(APFOtPF+rs$R!>}_1QEI#ojMh7A2*NIutLw<T`0xnJM!W z;8IQ3Hj*<V1xeg0;VEIHN0st`)@ysC5?le4)cv`S>GyB;`KxpRMRR<BdNn87h9`O2 ztN8Tkvsb$gzT@a&JwK$OoQ8ShZ?3mtk3G9CD))M*S%@hR0S-sfCo1F4ZU?RFF9--9 z)ueKw`J8mmFrJs{kjLGfp^BlCbwHoIfX&0SrT@G^r&!<|BK$t`tKPjkOxH~kbBCV| zTM2crw%+U>c^t2Mh&yT{PNuI4LouD5d*_~QoxeS+GS!pW&4r*$4iN{w{c3tl!03Qj zS^iX4mu$MQDvtNq!+3@o!dao?vf7No6vF(&6|e6emp(+ngiXJZUb-uzN@*>%Mkf3- zJGxY`fl>D49q*sc@+#9&ZZ4g_4NW~T0ro}39W>i)9aR<-{HQXTN)^wFP}CT9-IK3< zqkOsdQ1W8z^Z&YDU=&P~q3a~vnYSTVUE;$RW1FX9dDL{hSe8UcXS;vA?s!p9rR07w z#R7FNz4CmAU5EaxyFji+WHm%z3)@ZonN+c-6F45u)VYW%!WR=!hP#6Cht82doM*t8 zMD?k<q1t&`lt@b9lsVH^T&7(<r3EC+k3na>-YM4ot7bTj7Sr(^IPga0iI5K>NmEF| zo15g|KmNCWr}I@<SD;#RraL#{-fN><(_Q@AWAu6i{8>qOhKwGivz0Eo%0GiE9HmpK z&#`p1saEwNN>R7?<-A{2CAU5&|K$m+qV`OW9H#o2Jp3T!NcF=Z3uH(6y*OFwr*$5x z&EtH)c+;!jpWks0a_N`7BHmKXZZX<USyvxWnWkB8zOP>xF-3r`20tM0bW|P`qPSx; zm>>*KcNy}7O>dsfx-j$}dR3%XBD^57W&I+0<7B|V<6_VT@(|wW#HOlunI!V0%RLK| zA-0rs0y{2%U?fOJuQoYo*-4nf;!2w&6?GZ@VK0~QzPHBHmR97Kc<-%C{9&%H*DbNF zSX3d^?!A@ALP9c;73`!#333#65v7<bYtsf3W+q`5{&2D0CtXcMRbU%JXz+_f(@yu; zI4USf;yb@`RMG52z!q~qTR3lA7dF<8j-E0GY8NUb$F-Xepa95*4<nY+%$_Ll#Z`yj zI=$PRTo$W|)9xHZr4h3(Xe0^94Cbe}qmRiB->RoF@`Xj-xbrD0ScS&@mg{a(jeIfZ zv=dh<niIXvfJRfY|Hd41Yiuoy%T%WOh>s^x2mLb}L11_-)yCEcQD9Pbo^?5*L0Z@l zAZQh6RegtTo>1=2`4@&<yyhfqH{=BNyxHRO4Ec_kRC5(+<!K@9A#rh_oP6nYAI>K+ zH|wPwy(-Aq8yI4Ohi6};YHrvaV8nBD3?-Jd*?#8Q@$Qh(k$~%6iEwiJwRZgf@VrQc zQB5sRfA{bWr6t8B>Zl<Qd(Dp1@1)_3ZD@k7&LISzBHoRRVXmbu+SOOCpQc~neP1&q z&iAT@aK&<qX_#-^TvL7XKGh6|qVbnJm_ab1??#IIM0BI(&G=DO<TgV_f+Ro|nbCT6 z5i6zk<U7tPh-^2m`yoEmBY_H|e+vJg8wadaf-%bVD)>ubdJFfMC{k8>s2KZ`V~qn& zt4)TLLI~pY2?g$R<mYk>I;N+F;^yR!@N-Ak^%&>{VWZ2Y-^w{&{oopfb*Yv(7Hy}_ z!hh>ZDNZ2t6c=w-4__RRWw3Pw#{SzkCVK0GQW~piQxm>l|7FZ>dA;)5M^w9~c39)6 z@Ys~*&V43})1q&x%{JbsaVd`^thutsFz4H#3Nsy*KdR8jXzY5ED3}JH5`Vh7v{zMW zR;ZHErl!Y{Ey@=K@CC_{+^%s^2OtWoB5^Wo9Xcj)DQy`y?G@Cj*piuZ!9Hy{VLA4a zUC!DCCkhBgdpY|NjXpUexmYE+@pk(vum9~!kbXoqesMEu;$yJCzj%(0<t%BF&furZ zL`yQ;GE?9UHsKYWN%h%g?klWoW2flZY-QqSYJZ#6w(upqKWa$NBem;=;g#??D!|-{ z**8l6T{_dUSonuGl_Ncsl`UN+B8Yb)rtqwccX~Ya#gKi@t0QdUn}P3ZxYJcPuT4%` zoT&4T6QKVcQ7AunD1o<`HpP1|cAQ7?S>UT*AE4FHvXlBp=)c1d<$cCE_YS4b<BfA$ zy><zN7*Qtk&Ql(j^$uOo)A7)Ac~EqcMZCjW7^k=W1fRH`fIbs^%u^3aEe0wE5f|M4 zr0C}|c;?M_$@7zjSdD6l7HJH|N}@PztV>-&EPg)uEuTPM6N81S^R`XO!+AgXoR&P! zmxqcL(&WFCj<;@w@T5Ffy;wo%#^03|(Y@su(j)YTk(Qk^s6wKBi?7%1n#<LGtx+u{ zCVwfF1b17PQ)x22YL1CPDT(QjhlIzJ*8v@UCorqXO``kPgvyJ4l4Yg*$}1Q7dN7Ga zbAyF;;!~Ps|L>FnN={u=GyQhLQYLeUfAXcuWSMXeo@o1xflCw5V*_x0J<Ex|+Wgus z9!}3rIiKQZ{JJl<$S<w(=9Bon_eQgKLiZh$Q{v^-`WO6_&+^;FFEXgD9~8B)dgl+n zbo2~pAqTuF*5;%yXPJfBAKq8^a@%~eg(6{EQR2l@f6`)v>EhNe2d_Mk?$S^w?`x~F zj29UAqr~<Z_Zs6l@#sQq>^&1rX5U=FJu3|U=L0WG+&hdMePJbjh(@d9+T^Sf@OOWg z&MJ4c<j;q6u!K~Hx_eZ<Y1x8aB>jhv$`OL@!!DHr%bEf!MJ8fx>LL@R1Nzq;jF>k% zMXRL;nKKG0zwF~5s(38DF*z(i{;)deXNxhD-V>n|>)j^V55%K1!Vw>9q|g*>+$tjZ z{xUhWaEhX3$1F~2-*`{$ygzsZrnBg6tR&~*W-IF^D{65Lm*I}s8&)!B7yf;8Tl;o> zDl%ypYh#NswL@L^|GdGq3SBJ<GYxdE9kcfBYSA}!>}Zo2Vk|S&SVe#6X1;z~6P>qk zwDl*jAAiSaOj8s~AD)xyIK8cp&8v>y{n2yQfGFt`f@bZ(A2+-wmou?RIQBJE5MP7J z@TZSstqOoDm6V+GrGL-tNArElaLDy{%ICz$yD8t01hfwxQTJW0oO7&~8a6k`|4L#w zjW!QH@>OlMFqph61!eN_d|kVE>aTU~t~B1|v58!Pu1PK^Pgh0W`k5O#&Bm@ClA7{# z{!MiN7jr!w(RMaMHaDH0hKzSH*fHfggZ`-Sv_fYEkyZFDcUS*UE~apn>X$;VVipdQ z2_2?bVrm<=Li!gUo1Xq2#4TT6WEbl{7%RAUmmiGdryV`-6(!cV0WV%N%9Qk!{~dl` z%-(<D@)X}~MwNGH+GM5l(*gn!GS4o(KbD&9&CTe<#Mbl?OqP`=-?9-Z?9;F#!>;el zzWD{}sT^@3Z+S$noAw)PEjRx<^p2kixnkjKns4@r^S%_F63LWmJky`T>LcBQTwToK zE@EFXP%NUZJx-=n9rHZ&MyH5#^4)#?y=(E5>dF^eY<TV`-Blrro^?Nsvbo{PrPF~? zD~t|Ji8wEyP|Zst64C8)NEb_YotOM%<A`i*C3gz_t}Wq^*SQD+SyzgP=C3%mZpQm~ zQL|q8#&xtcS|aiu!|0o)cE8pH%&7;l!G|su0Xi{)eDb)h<7C%seTt_%Jmy^V&L2PV zGB}wS+%WFFq&A6T+I_L|h0ehC!`#k9zAD{DqHWAjtCCo~%#9#gS)HI)ZCpE!^7{f2 zUCED)iv9c%btSY1H76pHLPgP~DO7B8e3p!~y>|IAO3|x*u#bJ1QdNHOIMsCe4Az$1 zrjr$a4@JP=N`ZVtv@XZON>6YzY?qp7JEc8_^+Y`#TY{%|dz;t?Wcgj>%ym1k`2th1 ztF+Nt)fdwXU%<(i=Vq^6qO1aiV!i^{q)ngOFr4X)z*W76jzv-6VD`Mjw|8<sIN&U$ zer<|5$v8!(Ab;LeNqD=@Q5t74^iGzd!-P%u?z~;oBe))Cc6I(b%tyD2{0Vl3F5@ZB zF#?z6^>bGx?<}nSt>zP`mComXtrT;kHh&t9<-MiF9sZ{;slr1L0i2JmR=K;6bcOfV zp`EJAm>La=6olrdt$O3VNkn#@h4)0oZc#<>H;(x>Bmo|RZi@brBU|5OPhJ+HHZou% zm*B4^Bc}+|Lg9$trk;V=R%_lsv|};%bop+~*4vOZ519e8!dC4z-e)*8`D$<H-Mhaf z(k#2xXnF-Eg;Sm@8XnDYhXvOtt3yXON%V`mP776BoN8D6i(V~;Kp9l!MH(iFH#&Fk zY9&MlexgY_EX#J7EiR8!+v*jU00nsp8<Ep}9G^k+rJg_YA8G-tAeYEon@&NwP4P8V zr4)L6iGQMdyJ(A6#AXm}MxpjtYiNG>mzwh_S}i~E{iw?O^mKC_va)I0*7>|6GPo^N z8Ie%Rt(y}%yF(!7&-J@5n?T9?t6tXG#j*8W{2&(D4j$Newap7st{aafcjIjoQj6KD zF!Ft%F#HF9Ma4_5&dm{5*{j0$uw7}IzEcI2nWD?KIMI>R(#w`o#YG|Bsi<;qim#WH z;E%-@BQWe`GOzd0My|I^eAoMo|A~ydG`Vi4#3bqFDtfwN#-H8ia01u#sm{AgymRL} zv)TStshgR2sUvZrF}_B81SiWk-9{V{6zdb&j$h@#gn4rFpiS#bPm%m(804(>lc><_ z!FLE3@;1%cFUrfN&gAB@*{*3Gd=ui)?S%Eg8#L@wN?+FX#_7(<PX%~~_KT{dre|M| zp<_3hf9iI3_Qm`;xilKNhpi3kn!&dOBJlgpDhB#NHwBSFkssHuJZMZalfhYjOOJWL zN^J(CR$l7&?Zxx1KQYPJ{HgmXBQk@9fCw#-;f<47w{&Glwd--&Lg=x^)`9;JdkxrL zk5Nc_1*YPkJ-(~(N@mRSUf=Kd--^l~kUmx2YAXK|7M^~DuTS438#}?BipJelBa5L} z;u2{SSz};~^qwHal1wFqQ|KbzxUlKqI+7E;L&?o%(GQcX;&tV}<4f6CWI|j}F7Ntc zV*NVqu~+3JGV_c%ij$icPnR$E@o`xA?YBp;g_^C-q+YeG<gO6<VsQCWaN=B(mwgWZ zKesQfa?I_jQluQyxEj>mV%OG^pXK0qjyxnqE+R41|M9>TF4ix<hV`dD>B%U#cuc;W zI!wW4wUXlYhm8iiaqmt=72$7INj(`CN3fm8QmfsOxQt+3VvXR!MFP!*yp&iw<7UnE z{WNlYRt$G^B#pHMr{_mk8Xdzd%NOm2EhKTDb<8wR-J1x)R|Zz}tt!PJ9{-|Hm!)>n z^}R|itD-*rP51NbzbdWxdZ%zE1!pi8JrZGvuV0IeDMSjJA?NI>?w=5yAx8OteKGWL zinxk)1@~On75<dlBpw)}4qVjF&Z<&W93H#CUDxx1aEVZOf&1eNVSlppT)b`P<)!4+ z<Kz5A^*kwYc4@!zx>SRs33V=<>~RX6DWALTI(}n4!c?lB24Sq#LZ)7{5f-`39p(Lx zyLy&+!`Fv}9XrKHK|guQut@OL=&=QA#(90iY+`!J!u2L$dm9ysZTt0q=MzF4$+s-c zFP=9~A*Vq18CV`)?zxp1T}bFlU${AAMyG)K7y7r<mRBaD6Y%(zL^~s9Au+G|<FYay z?~=XbZ%}m@Xe6P%2nq&$Gn&p4*c|IcW_rIN-O1?oD-q{2Plz+tU1~kbx@nf1WeHx3 zu{TQfTLNtuV_D;`FN~=T)Z9|&b?%(tVg8g-f7o5rRp)J_j7pgj6Z*-gO<BPpE#kPF zD#d4_l+L}cak2byy6Vai#b&C3A0t(QxY*9?y_jVBn*1Wg7L5@ed`6_8z@Do>8={A* ze=>9=sEaKn_?<i^1Nez0Fm3HN=s+^v=S6h|-&@7hXcQUQvpf|~p1^$V=8HJ>6dnx{ zo6B0X4Bn{LbChA94Bw&Qj}M}y;#JR!BqgoiUvH}-0HhRVqI$|s#r3=ecM;0yg_Kg( zejf%0_7S9RtX1cF6*n&`N0*x5sBb!lCBr-keka5oQmf;C_HSgQY-`Tj(83s=crQb2 zkN3Y}LZXBacG76opa3dU_h>*|lcG}ekr?aHaEKNEtr3fhrO*F`F>vtThKw156|rd- zzu&Pn6EzHa9@L)%(J>4n1VMuq_n_1+>MxBb96$as_BN&%!|Yb>vS(RK{XqA<sV|0i z%r%Pm)|6_4bD^wlb@fnN^7Y?b>Uv_G%z+ybPSZZ-L=k!sayN1tatDq2v1fjBzbpye z?c!X)N+CNYt~_(M!q~OSemPW1_~1>@eN`c5svF$_hFW2yKx;Tl&GNri3X<bHp|n7j zMalmrqc>^qke(v?CVm#*ac~|5lf5zh-HZv2<%xHMOwq4~_?Vkvf`6TEtCUmx;eJOV zi_u5#u;VRXm!_gpzVp0PiZj7J9x~+ch|kO*<ImDM;XodDlH3I04=1Fx5n755y2$BI zAex7h-$xNGhTdGcb>WzS6;7=~6{i`Piw^}9?lUI{^gatQ6Gdt7@|elnWUk1IJ=Qnl ztK&?ncReA2`hC+&iT-#XX{jiz6V+5Z9ceDegArR}Agq?_I$}>7U|)fKM&kk#I-ID^ z_g$vz`g0oR#ihhcD$?X0{Z!JPjR}#lMDi}&YJ4I&MtH9E8MbdmgHOmRFFZBQeOApf zfj}wTrN1uiCOJkunQNc3oVfONmvjv^e)wTyMg1&?_W5tz=|4|AoHw13Lbp1KU=n3J zS7HT=(+46<|0{w_aaK>roON^5XJ@wF`Ww6S>F|ap`MbyQIzq)ZVv2E+yqxkyVgmR8 zj)K_7nLWBm9&#}*)1_Q|>_VC5SzUiUUZcmRxX~Ga*Ka7JEG;~7e~+jw<Ro^4Hz8~Y zl_`8kHsezHbdnussnJ(Yc0h6$3o1vDznXF3B`!t-+TU?S;JVa9O@aGL43}bzUt%@i zLy;_U50io#_IRycP}{;46`?_t=5sot_Y)iv(VBsz;X$mUkfhA_;didl<R76cSbwOe zJ~N(mQ2yDc&BsRD<U<Uhr<M{H_0?SJZgZe2hCdU#RYtNYndvbV?;#ZCYn$kp-l@)W z_~9<sZBKIhRB^ea9JShEBBnro?zN%;(fkBXpdsU*yZ}b0li%&Ebp<?Zij*Cm>HH_1 zQl+FT1A$8o66V)sb1)1smt!YPV;OXnNDW(D0hRXdMZzoi-yWGAJkC(~ye9NSW|S>6 zp#|f=?izF^#KvRxtv6ygPJe>*L<Iy)jFMLfB2<HSQFm~g^2Q=U(#qE4W>|w_S+rQa zYIPr!jpo`U*S-NcYRn*uSSaeobHv3Ozv1yR;#sAnZ;JJ~<5f8dUHDh7MA6P8#j1p$ z3)<L+KlAS7BDk>oEWx)Oa+ZqRY10a#r-Su52dl8LA#39=f*)K=yYmlG(q)`Wx~sk8 zCs@<>ZEH`s$z#Ob6jogLoml63HyH9DAxMq&DiR^qT-wvR3JUMm*S0)@V3WC&e%t-) zB+f`}p@47*F{A9g)H!WHoOQURl^e!bmLHO2B&h8Du4SNLnKq7PkVRL;=gZZcuOFv^ zJL-d_{9l51&)MD9r|X~%^xqHQ6p?P+djRGAPlcc#kw80%eNB{V!3v-BUnV`MinJL& zem6Y#t(;iap^h(RE63Y{Lf(T>{I~=+_s`vB4EE0nRC+Sv9d#mp`&1wL4imy*O((F= z{{d51nsvh#SUrci%i?6LH8>_{-j!MKvQ9iWT)@S}0FpNr@RBO}eTW!7dUVG<8*-E) zDbp7Zgqok;(t<{F^pfad40&pm5%;Am#6P8ba+c5LG@!sVAK28k^spE?SKA=(7N&~N z#S7}}Ji6fCkkb{WEMA1hUI0W%1tuoboWNM3UOEnCge@G^y{&~9oi$$yKD_?$Z7(Fp zzj#-3(hU(q1XLRK$5QArWFubBdWx-FFf_F_v~Q0e?D78oNRQ&%5h(cuTRk_ple7+h zsPm5Z1RBd2fDW=+kn|8VT2d2;pzygx=}9>~Mn^p=O|E~t@$BM=8CX!`(=MTR%=Wtt zf5)FSXx?6N8iz>BD5H~8|5yD%7yv5f<kz|Kk!=tw9DO2|S-a$@Aa=f~(JNu$^ULSZ z!W=LMujBxiEs*k9J;dA-QJnvMz;J+&CeyDo*$#I2+NzknD~qEwWtWj2pgSVFyj(5V z^nd;JFPH(-09)n@px3AZbp!bmRmv`Xo#Q^K?b}a?lEQ7-+Z9zfM0A6<VQ5zHF<s31 zGTtZo{L_>oBa4LH#4}>Kwi*a(2~Ynn4F@+#P-bgw?y_zs$CKmYXK5VXBB3^yPK%us z&JY<mUw!8o`b=Qcmgm!iZdwymdK96gOB^HiTNwL(JqUsHA>o>$TFxHWq|CPIJAM^a z;IsiJe|w{4w8FiOc4*apA4{PC$;RrDedeXKGYr)xi9=-;MSs<P_1Rz$1^wDAn?->z zdET9JiyLe13c2!LslT8@11T1)wH}2SgCr6X69k$BS_kAENbkNC!WK1V!0O}yD)bs? z4!m#@7b<U0a!SPye`<k=))#`oGC>1ct4qq&zSi_DF-gL}C&T@&-A>GkUi&*ehg<6{ zul%8sAjOyXP`&&?5O6}qz=G`!`Kmedcc}gogn=~^{})=r??#I?kefif6NthE46YW> zavs5*#-7#*6Pjs)HWy^$=*>ug)w=)@x71yPteT~}08nV~CPbJJ#eXZ3+ZJyk<X&m( z@#h!M6Dsm_{(>3w1RIi!|NBIiEuaz{7_Q0aR9Zmy!c!|e0Lii5@Bx=r6_s0_-PeA4 zu(!l*(u2uAq$;O88h6IGF_m4u6Gnswh=1z#Hf&h`&jZF|6Hd30j*6)pvNSTpQ-X-? zMf9->OK8_kIQ@wA3-1*x`)hsgxMmMRv?wq1D{auNvz~+KZn3JrF-`{~1y7Dpew9GZ z$_arO5VWM=ZN`hF1b7YUr<@8i7ClAL42Ks;VS!KYxW;d=jZkI$C7l~zd_x^na{hZO zsqbkmAli<FIN-9b-BXMn26Ly@?ux#}%e(WIcLKoiQD|-d_wMZLLleL8-K+mUeOd@T zkR~dj{67YMFR-Qu)WBSOG<3)uq*P15KUiDuz{U&90XU%!5l=w4!2jf{|Gfg_Jd1Kg zBopFJ4YiVxn1U#?&NatG1IeToI0;(&o9+jDzz`)XL{s_d6r!?2SOb5BnScKqG_~Lr z=2(*Q<V78JuY-|kv()@&KO6}w0;`5Uq8;WA?UQZIuhpk`g|KTo2uzv=!I%%>LQhuU z)mcJ9fngf82M+h&5%Bl9%?QE(4%I&$SRN^4JqLh=;MQM&E1)?T{`}RvSY(y{7rsAh zEwKpv<--6h@krC$$Q{88olvmS34+`41d+HQQGrN4;`6@`<?jm8t((Lu9SHKIXR!ED zN@AW@gU&WhN_G96egezEQGfI6kC)4Jpkn<9qL!tF8^4!EnMOvPRKoLT7}68r;2Z#G zo1*6UzxuwvgM$l)iUsXd5A?j)YVn_rQE1R)4qF|x<h!ZxQ=gvs-Bu^Z$aqqGYo`M} z4uC)|05ASIWYv8HD9M!EXPJ?&APRnlfRx@-u}V4&-=OCWq~s2>tUQ>~{!_2uxk`X| z@#9zX|3le($78+!|KklL5|@+);zE)_8kA9S$*2frkF1c9Q8F7wT}Fu_ElL_PvLdrc zMaoLH2pOTsEXnu&<ec|8@6Y@9&+q)v?VKam^%~FT<N0{pANR-o4kFb3l@+fz27iCP zu+|Xlt|Uwu?U@bCv~j=oU>WtVE!YiA$*V4;FD4qEzfuWT8{O%53O~D+O#wmeRP<4H zXvI{i?3;_=dZLSMM+V?SN@dEG=kT$)FQqO@fLrL{M+b`_g7Mj|UUGom!r1l`{cL;i zzcPqfCx*BEcg()LM%Ie6A>0yKWmiP<bdF>`gK6ae<YvdTS%{f6(ajLIq87fkDA2pK zIBg6;C$;*XO7j8fRx9G*D~}CP2j{UP31|MjWT_X3jOyU0g65;|qCeY}3*~q7O{S=A zx@ewZRTiNO-uaPB<XUOtN_7|UICCXe51v*dCuh@B(2qXN<P5)FBR?%kc{+NokG;og zRBT#`)&o*s#g@wlv&Uc_e{whnBtE|Bke62KbK&5x#bPeG`}4GBd?y@b3hEAT^!gpr ztGKfdhgx%KxFEKUPmKE$s3H^@&#s(-hr7=$fSQpGQI;A&qo3XI-afFy32Air#-l|% z&Sy<vMk?+^0v4mj*RqK2=pU>GeW9gUXP~5d=2!zU$0IX-yC#TY#8fA9GGXc6c6}>a zWGMPy&xA<^UPj3vn~!6@zX2AVoliWbESa^t>^nH@T8uEn+zP9QaU9BxL@4JC?<wQd ztFuq3LkI4xVP3vO-2!5pL#}JE6DIl~Q<UBJ;i0#e8ACPH{k+;HvGs-vx%}2^rHv+o z75d~z$PByVJIhs3*1UDrYaIHaPmubg@Yh>HA6+Bke1{lwxr3<Jh?%vPRX?EPGi><? z4a(G4zE^tA$WDI`#{lm;5*u*XW<qst(WYTd52cRol1-KvXmMjVmOBVphRzW?OLg|o z?=SOw3tAxUC>JSu=Y7eTn#AXqXZx==p;^{-`OV0B*B!umJGPzq^LtN!p@8FpHsSvH zQ$4cXc^cnOiCM7Lm|q_Et5Ey@&;n^D$8zB4y&{-OCgE5ehwCrXrZg4!whbW6jLxQX z%#_7&ZW_Qw?3#YI?!b*%UN>l@BMP~6vy~F3$>4X&H!z<k6eM345S3c>YvQ~cmzxmg zGuhclt{696f2bNxb&B6;m}y%zD`!OE<)HP66+ksb{4BAmTB<O41Vr}WNC~q~M79Ui z=BvvkOk0*hXhsZ-rRLJKHx~>SX1O_ZHRQWEDIF2^-8?N>vl>I_b@vPt8r8RcR};By zMFfw?C`a}+Ed)}EHRpj7Ush~};*K{4>K(8VPT$*!>DzqUt=ldv-Py}8&ER~mGyemN zbOFqOYvsMMkJn_rmNvdQOY|LT@#;_hcDLdse}TiN{6?MNVU8WJR`Rc#Nq1<Js`Q+7 ziVflv_N#loR^7*}Z+YtaKl0$*ar=16q`lu#A@lM~IZsHa>~P3`WbXvV8PDHAu*=oY zf(*bEmRhTpc8SF3%u0L8$0Cmq1$*6~WPv%!AxdS{OlzvSKj@1#PW|_`E_A2SYH`fv zJW?OskU+2Ioj0|;h}O{4mtAGEC;on0VBxu_a|Kr?Ml0h25t8Hf#|5R-QgR6|JH1>y z!+o&HvrCAto>-G{*F30OvS4j7D|I8~T1x}<xYPcYV;m#Jy}GnJ+@>By*Y?PSa*gV* zGv1Z29H@2e-ODY}l^b7PykcF<d|<rN)!b^`VE7x(ZzAdPE!+Fkr=5*<%k~R9vR8^p z6>~uvJJ9~z*)pGTO3s;eSw-W~&;j-^_908f5lqz>jk`!*Kk<2<{_M_S0^5zQ`psN6 zjY~htLRYsxO<{`ln)!5mKwLkxD!OC#cu?NQ?rPg`=uvyyj+n9V9<h!^K>!v1I&;E# z=b{wNYw=)xLxqx&cRoi`wcCO(AzX^_EL3Jid*p^DbS3`XXO(M}0+iN6y1*t014-kr z*BpN~)R1f>oe0|(Lbb1hP4k2t$$cas0NLZAaDr-0%z0j=U#AK<&QpF&Nxcd8)r8Cj zc8h*w1wDL4v!&exO0d!C7?}GN?ve{st7h=XPOT);IAO7IEqAMSKueB@*~y#Ci<5}s z8tl4syfOX$@enr;7^nHHWxgEm9e4XAvB-$oD!_c(VTL3wJfmcI=IW9BhwEjUJ967E zW{|l}BghWeBa=yEO%m{U;wF!C){YpW$_GcQT2?#-z5Vp*yZUTAYwE*tcMbTD$%Juy za=XR+%=|_GuJQL;0ht{fX5OQ{=HQa2&l;2~2b}WV$|yUV2>ty>+M?@R32wvyG~4>k znjNcTh>2(T26`lOGE^g;66uzC7i{(+I~z=WxzufQ*n$u6gLXA{h63Da9YG6MxPxXP zmAEPIou#51A;LTV1ZLmI+x^*_NO5TAah+=JTSAjNO5vHM#K?1R)E}y3yV5d9Gp9y% zq=l%eh7Wpw%X!0SLOr3DSFZFK+V<(tq^Kv-ZQN%>3#UQr{^{@UGZfFbS4jBdW<|+2 zW7tW}h(6z`Qa?YDITCV$AHT5PjHdhJ`Gw05&N5eH0;4{}38dS|n4{6POva1kLV~t` zkw0nna<qsDWr4uE$Y?WndQQwhh^2st{F`!{im+1MOM#gdFS1GxYksw%nH4UoS$5&z zNaP>~<#(A#?4-+3YFGZt()!wGQ1{Mv;?jD03;F*)*(JS%u{x5UXTh}&trPFnNN%Ui zxH-JH4ALMuNAw{`NCr@5^8)GzwH%P3^HW6qsCH37my~xi1{(=>JP@Ad$oUvVQ%(}D z-`T9Rm3BgTfQYBd|5!d8LD!Abp<JMxERPiHsZOV-(=d>`;xmVNgsNsq9j0Hs)lIbr zIUUsl#1uD_3ve!TdFw92ZQ3ZJ^^j|5uk+q6;oPmlrNUvmi3_YIW&eA=3f}Om?pZ}P zSvObTVpsf%sQ$fY&n3?q8G#K8``s?lAAjDaa*J)x!M(O*%;I;GO9k^wWB=MX6QyT- z#)2s>hEe~nIG8EVNu@eCc$GT|elArTYDlJ7qOeCuc~tPEc(I7qE!stG@2kD<RY{_q zhw-9<3PI^^yAKbhuY6lE|C;C~jsgRaxXy(2zOj*WD6YJ~<4O-nVSY}(Y;Njl%E~Q1 zAbK*0$$H0bXQ5*t5?&HEyn3RbHm9ovYBgQqv9xyTQZqEU#j7+hbuqDT=aDGk<jodC zFg5KiKBk_!bV_KO+sfM^wr`*Ae$nM?n8H|nKmMmY_{&Lf$l?nu&k59ed`okE3-#d0 z?oh6mjcchA)fqgy7D)Q-c*A%7yo@lt`^!!@-g^cIjsJP)NWTWoUA)epgl?_si31`e zm?tQ*X;VeibV7#Ix&%c7!(=*`xw~xH1>zzNpU}_7uUaQBQEV@CcV3PJy-KK6f`0%? zLiNYTUu=)&;DII2DkVyUp29NT5PhCH0p%m{3Y!xAb}Tv;sl7HTGbeuSy5PuO9jbQ1 z!hNePYKF8WBAb$E^azD$t~aE?_E7u}_MSGz=R&WmSlK^YQXky8?w7RO1>d4!mrWF- zgv0w-K9{PRS4eZ+^9;MQhUNVWg||_g`W3~REjna{y`sLmnGwCKSN41<^yYspZe{__ zHGVf!pI<1_pgQ&*Ta2|`l!khO?@KUqaH<MAF~UL2%FN38G$G|7!3~_loZ)cLE7fa? z*jwV7vCd?ZqLpj0@JY2c&mP{k?ceJ$MmVM+xM!<St2pIeJVW=&hPCDJRc`yhPehBw z)gjv6!!M)l9W`R^S$BK0<$0AZYLzKwgbLZR4&<8B_SGzH^BH+B{tgB^EN0ygqnx-u z|AaZ>=*}!2*#$TU5>1?y84j?Gmz_NN{MN3i1mm1^l>%{KNr9G4=O$p%`NRG<hDSYf zzmWN`p80RoHXJ=R;F>~9)b5NNEgKNrp(-fv&>*Rq7fRO%?t)U*|5dEhCdEAUa0R%5 z+-<;bI;$_$3J5RAL^KyaMlBV%6LIWpZxxxMByyd-N+-UIpuCc^kcyDxJX!ll%N=+R zQ}PUZ!dc25imKY+K6SHzTGit98edBzRy@NP{hyss3*bIY2>P-xfJ+9CFy>n{S3zw& zyxyMzlzV4?(^Uh&#Hl^pTH&R}HG=iYM)eiDW_)5*%bKC4w(EG-E3aGJeL*_Gx?gS> z1DqF6N80+aaOr~e&CPm-pCKRijQ-Xo2?A)!pD;T40(e4KbGz(H<h2i19o<D6cP;py z+b`bVl9Qp*fBy2P=>C`K@%y^->8g7VYLx8@TF{3w%RT(M{TO)je*|~`tK`QK)A79P zr`Y|LXhr&xJv1Test&!l-G_v=u9;_Uuw&#{I`XBwCpJik?Zb@gK63+8%5M+l-B!Fb zS?Z>j?s3LJm%g|~?_9|-rJ6wIU<@$t>nk6%=Y^Hg0Q<SCk3Kk0We)QRgx40*ulTIn zDILo4CAyI*wN3JE)Zpa@(Uw*Q-4w>RrwuOnX0SH}?Yw{cM$-Q9V&Rd7we^7~i)|05 zuua{)Jy>0Fy4XIPD`g8hHUs{8Q9Y9~65SbWS+6`ZE)MbR*rkwR7WFyz$6Ht0_<}ck zytOIIhoc6alV0ScZOSU!#yQM-GBlxY&4cDkOfoyjSPk#$xcL>F@$*F9?p)1b{s|%l zQ{Wx>M>Q<G!1-;VvC7=Jn;s0A0exVktpYm@CD(~GYg_$XLw-bWxio87Leu749<9os zzxgtC=eE#;_t~m1EiQ`KnUE>K8DV&Bw3r@C_ug13m2b0(nejkf2$!)^bY;53g~31z z(FKgntjfEil;}$)%H$L-j5KVYI>M4YKi|f)$zai*Wep;jME}Vn*deGWTpl=>6uVXX zs-;Eysu;`l^Dex3otC<!hr@GI1Xx$sBF7recr2yOq??Twd0z?|OlLQ}{_M{!>GHt( z$j&3YSw$tMilo%cSH)QcaUSi+J8H0)G(hJ{NSuq|viy_G50eRI9VKDLml>Q1bf3O{ zr0-#@m%2W9DB|?<54xZH`vkRON?%8Wf6J?8k*4K#L_S1IXn)botqZi{*|k|FFooIw z3<v9l%xYA!DJEdSee>P>@Ne(%*)Nw`(8!J4-W~?1g{Z?e+2V8FUWTZ<S5UkK+lSoX zP|Abl>kg-IP*1Ar9muu&n)M0kg8S=LHVr5z1cv_we=&zUt+%O9x8B!Zb3f!`f{qCJ zEOJd&Bi-*!!<NklPa=Kc*AYIK5(-NAMFe4R1TNqXOc2sM@8y1+gtAUi#D6`PomM|+ z9-9m^A1zW1%DmF^1Y}TdMXLya2hCVQjv$?zno%|jMGU!FdAoksF=USr2bWSH=ZlV^ zbdI&a{gYRW6z-p#_!v{;qv~}1>L;a|FINipMzrM5{_DiHwc}$7>1;K*J~d<fPpu=w zF{a#A$J$sg)n`}PJ9V{N=~%gl$%=@Z*9?tRYpk_zuupl#;`94{eD23ol^wy!(=6Y3 zm52?}TCZ(5{1!EyBhin=VBFh#!}pYtKP5r@ALGcKcZA)Rpo@#?NqbBH>Q_bVK+bQ8 zdrL*uDTP^YqR|un_J7vBBL+v%C=i9MIKq*hQ|MfClHeco^@_YTL=E<a^zm<e{Ax3% z;jub57nMzKd%4||a+rFpY~aU~;V#hxN7lG)vGt?3#Ds1?e^SYjb$`2r(9=r%XiNY3 z07p9mg&%ImMigr@e2yxNC=@*Z953X!uQL5|%om-h{3m0cu`x4d$42<?TW32qcVAiy z<-*}gFdkch!ewAA5%}Q;q1@Li=c+RSn)_c`xKwW<t$y`L>M#WENK6_eN|IY&hR2UR ziTd>1$}6fe*gE5@N5-+d%gf(fKK$n9;pV{1jW;8wE@X<Y9UKW3+Ei}y(K9gq<j<>7 zQ<#Br{MM3VYGaN;#BZZoXcpvQPLzx?j#Xk(D6)68<=@Cm<GHyqh(0j80y`j~lJTYd znm4Tx$th1JivX?8Kdlp^k53_i_wwReSa4n^bBq|IWfX&&o=OoC(Zg}}p+pv*Y*VX6 zb2k^x2RDIE!#BVdlYz780=hYJseyZn@rfcV@Yr5qi17^uY%QUIz-owb>wbccI%0>- zszwtO3kly-02@YV02aiE1%Cf8IfYFF7;K#dOCYuR_r8wO7l@l@Cr{aa2^}=l{LWRF z5H_epV*gz$i8wc=J;iDFZ65XCU^H{M>5uOB_85dt!@A13trgE}U=>&@1hhCEKwC4T z-UB($9}I42HuZmwaVr(L&;Xo3=)XTglx6t_D;RlXB4g8sa<89m_zJ7*%c;vy?6VUP z3YxRA^)6qI!iA)ftvK<&Kxo=gfee^#ze>X7jOiN_e7`L$FKe}KLAi+tLu1W4;hnH| z|0@p8#dU&bO3m}@M=Ib5Xu=(psbOpG$xT3V=3umc{YLmrvc`4_+#e#d>L-n10p~#6 z$7)#q`*>CCvKVj9u+bdSWlod8%e97SM=FFJNaQg-A>Vab$uH;Mkq1{Y41n#o1#}ed z7X12}I12(LQ#TDr!>oim0^PgpJLvdaB_JU|$GxG@I*8s%I^cwyb}x**GtH`J{_8_a zq#^NnqUdDlWr3^{eKmIu#|KWkfB!Vd?Nmaij1x^;n6&Y{<5cv)J|BlHS5v{nCwmgR zKc<*8r$AD`z9IGQa&coBef57m0$eKfPve=HX;OA(2!_dN-(UWr>@=x|Z@au+b$)WE zU5yYahX*lEoPpD{fixG!#4r#XcElyz#Q8lo)EXbo#`#MZk$@(=FUsSPJ@l!dZET)p z@ror8=q^T>KUJVRgY|RcOJ(e?Icd;;ZjQQnx2@yH$C1QXKx1cLJh?f!Gt=x0g_xXd z!tvr{<}(~f-n-lO86bt@n0K5y1U*7B%jt-D=Ay?`v7abZO+4g>UM%!q5q`M#@!@ja zC#Hj<S?my4e%?)@jsMb}rO3hUBR3p&y&JjaK#ZKH-&5TGX@2FM6@t}1=cSL;mfqG; zeagqi#Lnk{0ph2!c{G3IfBNWsSmb`A0mS=#{UuCS$P=U{@~6g~nfU|h>wIX&bBSt~ zWcdF*qZ_WvoJD1Jg19FiGna;~)c$wuB3o}b7oWbUyR1;^u0X)D8;V^FSKo#(Ou2Vu zww<2xJY+ffHXwO{tfvgrIO>}{tc%_GG#ErSoA2uxL#Z)7K?J}n(;tSkoDWGU^6r7E zQ#!U+11fCNrTKGx*O>(E`^KSPGD;04IW!?Ud;G}k$^7V`K(t``0v?v_4h`+>QJ@QX z-L3<kZvY8xqTxQV2-S7TmcLv_X75aPR(junm6J7B?NO|x*0L*hI9_M=Gbit7j#qo7 zVS44JqWRVz+wLzeuIEq?S#GLS>~4CcFzgnGvtZkWWwBR+3qISJHcC@BF4*WkF%;Rp zZr$67;kR1?Cwc`GOJrv#CRhBGBmNjD*PWXuWBrzE!YSv+Td`yUb@PND?v)k~P_@FL zFstH=XZ_cqAhjs`e#0SV?Rz|yGGwBDW<ST?;Jq3QqqN{hnSs@DG{5tdd*((fwcgry zaqYdmu2uZIV0LA|ZQ0C|B2PUpxN<z%AMR%-BM>bW7@lc<Xw$NKKhe;9wtLPmAGJs- zN{2QaaLU{7qp><6gx?!6?e~`9P=VdSdS630_mux!Oev37JF&cxRr*#H>s~+fLg??P z)!VlJ-LpzxNMzX4j;EF_O9*BQlnTiwlClZ{S?4WmT;oKRQErD<-!cynd1C&y)!E`_ z%e?xn`>*dmyK2?pm!hG+tXb}zrML(xH^dijtiST^>VB)oRvXaUW6fZ$Q!H69dw$Rv z{^1t?eW-M_afGXRD!<)GaKJx&cO!Q{I!I$<JZwtQf7!e5+nLWa^%hCxl=SsS`2rdx z<=vuFu8W4QJF1|#Q72wzpOvJd1CZ7vv^h*ST!Hmv_-49x_l~dwX_y{$FQKR~xRn%M z?p>|Y-gnN1jmgl7N?wK`{?E<-IxJ~UOj=7nJ7ES~!Q6Ydm2i_3*I}h|k*ex(B5Kwl z)3^1$xzUrUJ)dP?X1(It%WpZ-F{P}k@|A_rAi%Y7msAjSrPOfiV<(5E_9i%h)U6OV zwk3+GNEW4|1;+zv^)lzyyh7YLO1c#n-nBth;72XVeAoTYA_;HiHyK3t&!@vwnP$H} zg)<zi>nS}fb$Mz8vl_#Wngt<~{*U%Mn9}=b;v>G6tV;390c@}I3)>)X42{z-K8iM! zvSp&VMA5Yl2?{x)IZZklT(3zOWxXT)`sV`tg%P>L*N^;U)~n~AU88#9vJ5ern1V=g z>(W%nXJ{_xQ9SVR-ld&yA0oci1nPdAcfg@aXYv3-<mcGMQ}9W65-+ef0LB~<GvZgN zzh?H7zP3A;*{m*cO93}XX%Qj{;@=w(Xyj~30;m1I3n7T5_$zcy2hor@d5&I5+sb#M zYL71HKZ&TvS&z}uS@tk&b*Gkio|bMXqo3Y;R^)3A&UW4V>dV8tR#5K^aOVfhv=c31 zgi$lHyvZ%i{XsWgT=9i<#m1r0hgU>2v!F5Yg6P2$4~T+4RtOBFPehcZ7pHWrRh2MC z{|B7(+k`e4bNK3=1#e}vn_QqfzWrG3dT*Rgj!0jM3>D+q=Zp*f`6{|yDMOBJHT9;9 zOWgbD%`fdwah3&Fd7-(aPed!g5*denn702rOY65+hv#J*Ipw^<0FiDYd=;k2xd1Jg zrs&O<vu*0OXpX);arU>A+<O7jR-3{bfIZ~DkTe0##WjmGp<@rKk0(Ot&5yuE1eX&A zeIi8R19Zd9i8}w2J}->UHKN~S2mh`#<Ya9}D{k45wK(g*piTD`tlm~}mwyx;;lY%= zZ|N|OS@du32W*<(N~zU^1c6IQLw;9I_yh>sPtnW5QBUDz;aY!$q#lIXQ-?aJIrn5@ zzc^R|i=#?;FQ?q(Drc_1Dd9Ma_tnc>P}K|e*WtS5H#cqh_sgPDQ(?~G-FN?5{v|QH z0EvQ8Z6aqQsYg%xOwN$nm&iHOUoMq>7Xy?V3MmI9rH31H+#ag@A`|dY;wGzS%g1dM zWjCdta5J1~Kewo5>hDjVTMw!X-7qvPw#Q+fgmfjV?R3Oe+W3p(Z0Bas>Kq&W2+2d% zZXty;zlSei%CnWAh6|EZWpkB;=W+Qee0$b;HQV%`#f4{6yxZ#o01}T@T>)1=2xfa1 z)FZQE+!UmV&a+&BD@;$4ApW%{QI(a<ooKTYS*s$E|E$m1&3Bq87&qq}Hq`9mA_^uU zmjPQHsEU~Es*G*Zkon9ICiz4^&0_BPF$6BEhM=1x<U;?vwfXN4is5fMiE;y<pMI@1 z?^H8X?fHB-sV9YU*RAhri2;8`9vIO$?zItB+^Tm(_5JUi0+CSvNHM)8P`?K8d%Diy zrMk%ZEs4ne`xtpyTgu$$1mvR_s;k)9zma{u-Z__l{XR0sy_nL6r^-o^#ChqyL9>*} zEueHY*>VKq7(_!c3*Hv`s9(_*kH2*F8H2E9j2xkZu90<5f|Q5LpIQIl|6CYd1m-4I zBpGmo<3x<l54FmHXXx>R5v!LPz)?LvEwYW+Ul<z^4Wc9>S%$*&NKi`=EGC?=?2<|G zXsTxr&l{AoSmWFRM!!@4`Eas*X}?{5l!+LTP=NH9bb%UrtM56YTWR`zxeIf+Dm`?! z-D|>NP?#Fn;!S#1zbA*cLt0C={p`ZoA{R!nN6K0jE@k`ue3nv%m2aqwqvi%{Bent( zop+>pJx6W&&v(;JNLw=x8Fn%t(wHw4tzHlovJ!M2dRbB98WFvPUIhF4RjJ=NM%~fo z{as#DP!2(edxYrO5Q*4iOvvh@&OUOn<rU#JkvtQeng$3oan9`oZYh{6=XC^&4PfI> zID7uryQ1<vI(XO51l{%R@D`MXGLtcn*J!nhFO_!y3mG}>;Vf)OQahwZl@9U?od&lf zi%6>)+PsT4hsys|c`!r95xbg+Tn`~pge0H*TD!RJ?QO1&`c)q`oa(C)t~VpDI@`F@ z!D53AQFcfQ?v@QD;(s0lvXRL<u-U82J!ww}L_}(d$a#=(6Jm?`{45Y#8=(r;vQ&d> zBXwi-MVeG_$$3>>Dc=aMU#L|wQB4u$4SD{Hy}i)H@rp;0abMo`#;;_C$I!Rg+@Sca z8zCf%5Q7LijEL^fZ6;$?!aX<YBt(ZW#{ctt0JelZ<SPW!?1(yruYj&UiUxTjWMTWO zy=bqrAC3SU9=n=AD~>RX()M9ad&|7)Ie*+TtJ#_tv`7a)%;K3kQ>V}f6EB{Cd_5oL zz%jLZg^17FM{4IiMOCbeP}Y2Wmzp(oXV=fRi#<=;3&_La<j{V2=x@fDRSbH01}IIE z@GJm|yjVDfJ(`841X}6-hc*LEaX$Wf*1y9YaqriE()|DB%stcB`b$+WovDUdM{fix zeu-htqA`=_kOm`KG{&~VoGZ*PsTPuRUxdMk%EvA{AXy%}>$xUMk*OXKzVnOfXd1<* z)VeFokZQ#0Js|s||B_S7vuY73U+v}zavI|$dN&<8t%TPz@qMdc>U;P!JhK&}9YX>( zv%6HDPk!auFO7KULH_@=!vji}lCD_Cbqr;d?YXTtz!=Z-2l<GvA+%HLf6H~y1&z;I zgV%IbGk)`4%*^t{jz+3k@zD;C203>C#%!BGT_Ao(Fg0Ssjm1Ws3pTdtpqBQ13@*WQ z$f$iTirNC-v2a~{%c7#l3*{v9fK=V+nuq`pBvqIEPg+K)v<mFK!NYvIcBVw3Vw#N- z74%5IqyVR%AresIvzv62qMutR*-#auhNtH*;u(5khwOQ#Qfyh@WjEINKh_<;_7-Y7 zH6g}7WIkFP^=g8mK~DyOscKhs87^(4^dsPgXS+4JTy-OwX?mm7Tgx~ybFz%R!?)ui zZ4jB<KOWX=1PN*|Fdok9`=`TE!R`6qR95baNu2#Le!1|h6-8{#jMyqs`|0QQ2eNXH zdsCO$IbMeVG)L?+8>#2;9{r;p;IRG$=OkC*y4xH!R|+3&-&0e6m3}qQW9{jsZ7Lef z&T3{?3RU(W_!Yx^_{5@`87YCsQlxa@dx~0bgHPqtJuOQGLtoN6$@#}(+wI2d>esR^ z_lG=8y2=S5%CI`&Va)1xlqtoy#K}cVKG9PqTHL~VcJv&TAeDRgTq>Tkn5osH?0ihR zPo1PtR#9}3Jd4UZ1oT{U0Jb!rS+|GE62IPD367O%1;nt+?4|92b;m;XvV`n!XzjC9 z(IC|&y;$<`Wzi&wH3ml8Zxxp|4Q=Ccxz1rMsN59qoUg{H^FXp=YYx}*(9Y=MosS8l zO7pYKan%0`0_jqNEjb^0M)H}Jdk<b+Dj0CR_>uX8&^n{{OI>gF1`8HJRdQAg3Squ! zRzG&`j<{Pma_;VPUam+lL9RvyC%aax^cXQS&a@3L0P0{Wz4+xqe@{x@kpTh6`o$u* zjzH`#4b&R1rp#MEHX@x1cbQx29vmhgSS{lvzg}5<E<%)Rqtg6ko40UDE2VAW+9lY3 z`@DtS`WUG|zhl}zMYt^b>Qz{tGH2hVuL;g&F8Cb4zdE?+t_)A`t9;H^Yxe&55z1eD zZK5owa9Gu8naR&-av~5z5W+YhE*R|Hbl*8}Pt|#DsVm35oVV7$2o;MBG#`H4kR_QS zc7^xj^~xHrx5v-?!gSgoxJj8o%R~%uat}goKU46MO!0RU#3{nQfDX<&igNwHI_(AO zT$HVOWsY%)r82HME2f0@Q_g<gKbvLHGk4z>yv0IyDgd%G06a32$Vc825q|bs!Q*~s zbql0My}=!p8>}Z*RmdM*j(g38WSS4h-fVT}<<x$ZtlEKx7=Zpg{rvKRcbfCuUl?cX zOCgL2|6hbn32l_P-clK+`B~t&iQga%0pJJx7xw=h;Hir_O_U!e89sfBY`8D3AIa~R zk8qa7?Vuh14a@dNt`aHZpcu*MM$1<^mQBD!oo*nAYk;Eul`|~>L-)`QWQ8q>zQBS( z_;@I)xM%ie<5?QDOuYxU$%2YD7;Sk82|*lj^dPEkj$ljiRd4+3L#V_2tQ+=tymh^b zf+^Uy1{^sFP7|EXf8`7GE}$cYA;~bgz4p>{f#T!OA>z5Eq|SsgCi8y|QXv*#Y@<sa zS?w@{hs|HD_1UkW)#?}e<PaVeD9V&fI<1pT8`cQU+K2sh5sE@Aum$?DL>I3&W1{WM zuDKpYsU%TKL?dzA<gDMaKtLmowE+a!Y_P8xHc_kZXnaT4lNjdBJrvH%*t&+G@E7Fo z{|h+9T`ft2KVx3^4f|P3r5hS^Xa5Tb0d53QP<_*_7nd!fzZ*RD{m(PGQ)`7J9cHET zpn9rw6<$(0uR)D_2U=MBoqso9$k&!^fz4DJsAH98%1u}yQYBg{yw>dUqnG7>_1?qz z`u=}@h2C-jhk(G4vkVTD0pN!t6LS~!PeR<K8y^+4L`gqKvHZWX6+|T`6)?az5F;Z2 zrSnAO)babLf;o=q-wza@LqCZc!`iL;9nvH3ci=I<yfb$EbW=|AC;ik~rd_|1Og>oO z+4j8MJ@I3gdZN#dK;3U8?#Stzu2;Hltn|t`2OKdB$-woaNH_^y#;fTw9vKlsoaL0d z1``bSv2OCQ=IrC_hEkgUKbtPrFowQkrh-!Pk2i6|c?!``TS^dfW#sE?Etap;ud#wx zO!eiG9X(=i@Z{FvjV4026a&V+A7B#Lj4rib)H|JcRmv26?2>G&;|S5+iVYc3!N*5h zFW;<G?BXIGhB)*autfZ#N>JezrXfFTLI-O$hKw|s9r<unJhQ%AJS+Q}58SX$ufBEY zrQy~Ddq<;~V;6XDMEmZ>`+t0-Ar@uzsX`RG_Mm*IN<zDirU5%!0%37N7&m8Oj96vp znQv#Fs4RlsO1Q#<O}~pZ9%;8|BpJ%#q6z(tCWp>Z$%32%C#KO}bU<yh{Zx@fbDH$? z_ukT-iuUTp4Os~$o?2qEDPFJc2yX_C7{{{fA!?W=)GszTWDdS3BNX%h4x318PrY!n z#?B}05VBos-fVet+G5)VzN1eQBbg0px+Kz4Dv|G`?M5`NKmPkQle|>5X>=ODZP`w7 znTJ6qb3QAI8Liv=E8uY-zK&{7oZ^lY`EeTmpEcJJAo9Avfvu_K@+LpA{ip3xJ{~_= z@LigMt4wDLmRJ@w7ry>keir_Yy9QD(Wshbn_{XHfP*2eIJzvAxDM$dRkSAfq3c5@t zu@z`4MUA(87M=O$*8@0qyh;zN(@)&@Ez{t5A$Mlil7ZOHc8?AsLu^C}*7}cF1R2<M z$7ff5__oU(F~2&_{0=XO@toUBLOVy(5KLy;uaL;vah>tIkL_T}fL;G~hsB1jD=ztW zety<LA)hA$)|11m0fr%jxn_53>1qxW)D*jS{F>X66zkK|V|w51KlBhGJ=*W|-hxPX zwTGv(dU^`>>~nZA>}<?qmX8N+#d?9y>(OnfFuA|m{6-&LM1P`TOSOM7@2Z5E0_msC z(b@4STN@xcj7)6LTuELcnD|`(xL(_z-C6a=4~X$_zj@>GdKu1&EEgyk&&EKjZSgA* zgZv$lmXQ@tE{?i-02u_5xOhN3_)m?Wpo<Jf@x2^;!<*(P-8m_vaY@<~Z_4#5`gM&1 zjTwVru(1%<KK-52MbRaDYPq<fQxBXf6(nt<**W~AFUrU%tx{p?9WsAwGB@c9)!uO& zy#!Bk1SD0|blnmiX7}M&+|Bs7uM^iuf|8v5=@{Cq%u%W_;4U}EDTg=!)R?_e%Jbhy z0CcfsPn{rb0NU^B!B1}-zKEDH#agVnbfxnmcdabv4kppHJ@2k}zJ3gp-tasr@U<3J z6VG3iq*++y;p<5f_NtZy9~_($m4_Z564gAZ55Nv1B%QzI%Qu2S!#f=}e_F5P0~rgG z&%^aKL42vf_kq4K_>}UnBQG>{A4afX{7#-i?+;X{-m653g)v}+H>34!S&J(xmnytk zgb6!dcI==Xug@*wvnBLsLOMnd{fQSpZX%8;PV78C12=}M!!fs!IOk+C9oq-EAsa!; zE3+Rn5!Sn=M|Dz1+t908EAI6P%5v_g$Y<I0=yQGEHS$2?_A!WkW)e=|y`#j2crYQ& zs*KYcMXw{$M6B}XgrYMDeW{T_6t=I3fh4*{H^_tlT$h%&O+W+UD6#&MAUds0*4Ipq zVr(c2<-dolRwnEnQ&sppOPrp4W@`Hsx@yY+cE-eNuaTb0iOxJS3_w`sXuQ=lLl@VM zNN-+*V(abIE>7fKrTbx^<~3m62Xjko>8hcs$#xSTio~1bPvNDTAAR>KUM$i8hU`%c zBf1L`a~BGm$7>$kowx<6Np`AzuPlbWhGK(uRuFk<m8YkHdx+EaDt38;Wip%Kk*rU> zop>>fZm@75rLkx#TCAqOEa1G61-#+NVAoF+V<uhGKyn5!lQdrYdgYzIPGZxz9nBE4 zOO~A;K`%DxJP3U#d(<FKORaJez3+xK$MZioe{K-jAAJP5ft!mb3d!y0&S_rTzvj(T zKm%eJi~D|s*|4rNAIOv^fdNTspo?aATQ<2DN7Zc2^NVLuSDMf8kd8z{)7VXa&0)qj z?}y*){K^}|!?<vjX!}yxfz;W=sZ@?x1is&?Kt^z=DGG7Yq6&ev@U^biAW=nf;yH(K zF6<_`w-bND@?{s*X#<b}Yxmn2w=O)H`JTM@c;-^xo$=+O91FKvtS^>m=C2vcAF0S7 z_Nk28ao_Rok74R>Vmcz`85kt)kR11jjiwv$D05sbo2LU#Ntp2$56UTuU(mbhju43f zl65_5LH?gRq`v0-@o&CBSVqQRwnyQaeOo5Z#>GLZAdcW}z1z>eYq+|32n}=py60Qu z<Q0w@4v8v!o}7pb-|(<(<XZ4FeI<h+m)0VWKj`<C^29g5>G3fzOL-VqL!9*oa~g~m z7Hzt233YMt%S+d6-)LLLb3&40MchQaK_K_9Yv>>f))-}IWLzo08N|rCq5&SVeb@J= zFMy|ZjuG&6lD_)uj-)TQxqULKO-1!7QJ(gk*3+JJ@2`7*Y3JAVnq?s?JrQT0RS~By z&FS*A2qzCzwYuq6YO=_!k`Of9!JdA0d6nV@GX_m<4#9W8vjh38-xf;BEmPZPXmLzE zV^@^rteWxWR`94z7p~Y7Ra-)T5XiFJb@NkX-tHIynJNgWBsP<6_CXG}kqxjW)K&>j zOZJ>iyV)tQ`kG}Uj-*!ng_z>#L91<YdOKUTH>j^Q*o>D?f4*bj^6$FdNx>x5bG5vB zF`i?~619dU6HSt7Rn&AA?TV4mjvQ__=halk(+H_EW4E{z=}Bh`H%+%;<>Di#Q+rB; z#A?u-X)))1Q%}O#ZPP16botabVJK%jQ@iacs+55sdFFLy=vqMo)PT(y%(^ebC%`vc z(*2vQQ#oBYTr22j=zFR_e+`Ca$N^$nalS@wXf)%AVb~wd$thcxq8$eY{4&-wUy5}% z`o8C$V`qIElUw?wDQ{C7J=59^lU&}2gqs(gcg>$kFgXc+fR_#MXxi(ti*aI4m-m%K z6rYA_`W}0SbNY%Z(Hf~7K_z$g__w6qjEuuf%crk?>z*1bsV0=4*|noO@(V1g9dJlw zgU~VE|LGO~B#wtuMUjV!;#VK_<(Ws>jp5kA>W7za^cn)7ozcu-dw@B<yoCaGA*&=W z#M$ec`k&kBYf@qmXSwQN1{;HYoFTwH!UH-{eG;<Jr}=7qtQGb;F&Le9B}`qFI;lq@ zP1nZgHSdpkq_oJM$UOW=UwHNfU7sr2o0n;@O-v{0NL2(ZmNUX^LsC`-so8|xHK;~` znFPCPIwK6+H_|Xr{p{LV^H3uD&#>?JE)r#7@NS3-#%JJK<|wPM#rdVYUpsRVvs>TX z3U5DA-VnZdZN)R0Z+nYnB7cTTubOc&4u?8O(!Q%=8rls*cYZQvHwPa!!z*wew6-yL z?xeRU_MQ7ci(`*T^#=vhg6+0ttB>*NlpWRNTkR7pkCG;Op@grK;mYWg!e7T=DQ!QS zlI|_VduUx#LSa}Dx?kN=f;L_acAqre>VEIr7t6z1<3$72hHu{LeY^YWlr92@&kOaf z>;0|eE?=+oV!j#wOW5MVe2n>AF<H4uFU9x<O;1}ooVt>7t@k52I{Gt6qocnxU4C5I z(DG6^y`7BseXk_c7J?v6?(1@NjT5U*8$zv+>-=u)%VbX5Q^@tR^%=8&dvAO*>3nAl zPArvP@PLFCisT>XzOD7~ZPa?MOd*J14G7+d6Eome^$qjC_p3pXJ^<?K>=S3!dmYaZ zx;aZp{{V~DBgkT(x>-w7lvq_gzlAFWIYmQEHrZuqzK)V%)QMyIyj-POl{8L98pW4B zQ`_>0U`7h=uSBnh9z@}r5w^?3{y_7orBU>y_A7ST1hVq+`24y#z-ijEpV#RPpNYUE zmr*J2ffAnDRBG2WY6kavQ3#3QrW~rO8GhOP#lalZQ%YP*MXwVc>T8QQ7d80`{;TIU z`s>%w*j7ru2rMVlwIgPD^fMIW3C3oA^%d1zcb6A&Z|16AVIFZ+E1pY*E_{Xc{5`a4 zau!L62Cb6(z^<{l`-95f+ShKYHbV$J=d@F80O?nzFXV|Rt+~AG%%8bqMP5?ez9v3s z3}7y=(-r@5cqD!>yRz?P*ul3R%Zj$;r131xxtd$#B9qY0a`mNoQX@EGR{M0*DlpR7 z+o{5!=iytVedhhKV6F{EB;-D{T}qC6>SybITXS#2tmGp%bzK7}Ev-hJn(U#LKFD>$ zT~wPjYFBJyyZ4Ip2QxotWT5|p(B4VL$TCIZn?hIA?hx`?0<hu>=vYY?4ynSNA>tw5 zI~K_w5fvN~mP|Lp1Ey8ACpovh^`=UpD*L|epxWk8X7vqbmnieEOwbcO=5;<Qns?1{ z*?Yq{TF{xG6f%)Fp}9&fgSR`wG0tYkiqNWeHfuJ%l)qTHBw)wVC`-iv;Yi7;ZuyB1 zSp9kPc=&e3ZB*Q(m62~#^-liUScCMF0e@TltV-9>*d0#>=yDx7it)!~=-i6*%h`HP zS*w==Ltq?X+*FqFd*pi(t=d0%^s_5Z*)e+b-B2BjVEadfj=U9nGC6YjDm@<yR#%B8 zFzxg!2W6#Ij}LLMSV-y21Pc40_qV!ir_k$^vK_<Jk_gx6pN)|Z&Qz7EW!br%z_?cH zRO0Q^Z_f-m{v7%8G{b0X=Fj72Y}-!HC{?XC0kSNSH*{-V(ZdGCzCe^*bOsUW2i#1w z7WmG39BRavD`Cy0-$>Gs*l4lvKKBa6_<$PLH+<FmB|@D;K2#zNig6glj3sRiewem9 z+BCYhaF~g+JzV6LJ!XDYsyO9IohN^yExG97nJbYA=h<bBoN1o?9Aa0oKl1kaf>in% zT!rS7Y~{PQao0#PTw4luS;%~%89O%{hXZ~InftdfJE$u~3JeAPu|_=u>a*gmYu!!B z1$-<D(>Ig$Z+rLC*))w#)1yceQwW^@J=>nG(~Kc^5WrF9-y@$Oo6z_SO@qJTkZ{VQ zGk-w7^~jwXP`@xM*zj)nOYRf@QwB;Ji=P<ynyylo7oteFD|=S$S=5N^loLJy0UV-A z!IWb>oP)V&+x+ucz@&P$QW}nuB9gM!r{K#}yGdR6vSNGpTY7s@{dAmHTDqfzP|t~+ z0Xl^n<`@C%z;Dydb9W@B;(oJ(#yHZv?(($&FR&v{3)-{#J}xEWYtOKJvfk9VDgS7_ z=Y4Jzj!yh14}du|kd#qDTEiRXK9H%JFwL{T=V}06;zz1K>|~l(1Nu+IvyGVK%w>{1 z!y}d6xZBFYfO>lgS+U8hp6Mg`H83a%=V*7yId$COPZ@rBV2$?tg%cyTuBZY%-Y0-z z(um4uwyY!{Y<M@U5QYO1ty*aMp853+|1W^<8|P@>%$=xv##+|>+fuxs;y@OL?^2rX zv3iC;EjnU|YlUDmv8)1E{C)N+hiSc=X7D~H?Y9avJq5cTUh4z1afd`eU9wJY!anhu z7nPNyi~=1Oa4AgR)A?!^UD+G`sIDve_m7r#lkT#L5q0*jqCw9toCqhpOZdDuKR%o| z_Z<wBgq6-fG_vmqd-3N+Fb!Um{&X<deC{FDEKUeC18ylXL593=8xl)JwIw~SJssHR zEIc@5@5a3-7WZ&l&r3^Ftwf$6NQa-8wj!%NsvOL<n81-G%Ua6SbjHz`W7t&f@3_`` zAnn^-O~b8!y@jSb>;)K><Tir%Lqcsad49LF9#5JV<s}IM+88svr$*Kb-0YLqDXgIK z{zhGd4&dG=%_0~UXuIrHfH+6&iosjEoRSTaG2fomY_Biz_BXP?$ie}$-AfJcE&BA6 zK$*l03N2YqvWNX(<=lXKwMBun)R0CkcDw)P?3-lcpKnneQ>$^CvAlZ2&PW<+m9x(+ z`;;A0@#vWKJ}wr+h@R_uyV4M`GMYZB1NBV&udZ4=uT*uFiUdj?$UvANf2TI*U?w;j zb-TiA4(daF*vf2!mJ7~AuFMkleb>$$a}*z3;S;Q|L*QBQ=;DRR6~iivVl4=cj)&p5 zj6IGpK#9-EtY7>Fy-S7j*Y@yag%$M%a+{_S+6CyV)qCUYzn$%QJ9dgKTT10HK@);1 zY}TAfb>fb-^<@8@x8e*2wlB&{ZOFBdYQfYfP76<BGa&n`w_%F|ivZ_ZY@ii%o9dJG z-(r(%%D5R~<MwGRP8oXTeI@zGIe$ORG_ns;hdz7)za(S{$Qb1PQYR?5Kte)Crs@7I zr>6-g+se$n*D(8NfViCuh{OHomup~=&}~63`3oX5?N$QY|Jn5C!0qk1Oi>a~X!Ra~ z_u|B~Qqa)~1;L=1mm420f;eGu&SQniUAw%B@!_veiyrn~zTzh~6*KaCs9ne5?u`_x zIg-#YLS!I~Yl1<Aq~gI@TmkajgvD}v78j2rPV9qztm3JN<da+Q7f28Ymuon9`d6O_ zrU`pmTwq{A8{ZQYk4n6a*A%cq*AozXC)_9TDfhnWOK`?AiF{=Kq#U+c(5s8y&SK!A zP>o)es_IIf-)MVpKl8_jOp}uYr-%oipQZ}*&g8`X?qj+x=)!shh#PQ3Z8RXOZ#Du& z{2;M5cGbgDd=~>@*`)htfAT7Su>ZORggl-S5;byhYs=T6X&^HEoc2TxLx$KH_B~`{ z6#C+HBgRnHgIoU6dJ{R1iR0;p&VflXv9`dxgoFqJ4oqI3%xXi*V<=ZJ6N)<Y1J7*M zI=`6zE&2N4As!j9eOq*5_cPaelGFy*^qV^_0b9qu-q`ITug_2sLGtKHOfI9ZxXm)r zQa1|YlOF&rVZ0us%baCDvCjtxhXZ_!Ped)D8T^~)WEz9W4=mlnz(0sFwOQ_J_hNNm z?_s|`6@p0X{UuV*rx81|2}elBR7u&<B0omcKS6p?Q|KiOg8h5K=sm#*`iE{rW~~X| zwl&G<1MYI;Bo}YYElGKgi5aU4?QcDu71H3t6`nePJ`7*=3BW993MtZ8F4}xm_0ZSK zqrwCJH&T|Uu5_Mz+X8>sDuTrHQZfmw0&VXBa#qpY&&~@rxtZGpBk+^+kshbJgVSLI zP`%(mFH#wkgQQxQ8<b3Fr&t8hg?TqOt}PQ92gu!YcK*WrX|(?{$ZR;a_m>5O$iTZ! z=A~Wy4OAq{W7vXt?ie4kE`U@+6E<;yoKAFibZIjt7=L<~=u^xxkAINy;O1r8CDpg~ z^VmZZ?}1>W@0G4a%j10cu%i=8BZsOuaeT^h^aXQ^_%En=X|r7BGY>{b+(B<?f}LH) z2{XkmUDf3k^Njt6N&*YFwq@|F!Oq!yH>w|0aBFUp6X9S9&z`N}y!_9IH#^_Qov>Ss zrAw0O@yaJ=&kJYgn?bm+hkQiHeOdzO*sY9pgyVP5DD4TyEA<^BQm0`QS4UbHI7l-Q z>0hAy?Y_Q*!=RD7IvG@<EF3F&@4FJ86#n@02e{<`VD&7qlxM{~ly+i~(uB9v|3<I_ zJ$7mKPs$f~WluG?vdh^Chsl>et}UoCy_qKyedQ@_N-pjq-fI5~)vbUKD!nC!@tQ0a zQV*hob8w>f-PcR9cA=|w5AnPZJaqCv09~AxawRKxexd6AQgx08fuxbDe?;VN*#51x zz;@S?-BzkW2ugVf!}7(;n_poHWdKc>40!K+H|yMZ%PRHmWv^%8=j(!CEQ|SnA3jPN z^D}x9Jz=yJ=Te`ac;gZ>f?Da2>O1AmZAqvRiEu+B^k!Zs4)^Ob7=>+y5Rvb5B6O3C z**HfT)L}oS>63R)l)W5$8)C#5+p+9Y><HZ&)uQpD7+HcSou2;X>BY3F8SiWRk;|6> zM>iuEsfyUvo>2CJQQ|$?Nt67_%oO<zx=FnY-Q^OME&MhY!XGf^E;yUCj<dcDZ&t?{ z%bw_MUuA*)Yb9aTMRg?*NnMVcP1pv~T5U;-d~`^A>4o<7FAHRAR!O~6^*;jDli1sp z@f?KLJI$w=+b;P<vj56`x}*7(`6Y&NN3N?l>W?2_=>$==?gMB2BQ2$|!p^HkDNe^d zNBCCy1WU*`UD{QLw8fQI?g*LlAl;C71d9?5f`KhP9W5myX3pVC?AcEB5Wp1_Iu+E! z;Ras;uRRSMN{Vtb>Nq#dw2;ko2uRZsk|_u+SXtM%MyEXTog|5cYyAR9%anwK)=L-f z1b2GeSC2H7`(nz*e7_<4I)|OhdX-dR*X6+YB+szzN&3Qf23e`+>JGrpFJI|oDV-40 zN~b;jaourv<B>MnTTc0X>J~LimbnnFm~3DC6~9d(9&uK~aqji+uQA1TuwJ^^83t}# zu(1l@NYKm7$+RUQb^JDmEi<*}u3*@rbtje57gFuL$G%zvXBaQKP$D1@_Y&RfftV_q zl7%Ek&?`vWceFWT<ehZ$X$#IRqgI5`cA3*Pk0p_{Dc>$sh=j)*fU}9uZS->ABVH17 zDA9m2#ofDZZ8WFH<7{<tiOPKvKl5t-itwvVDdDLmbxMbntArglH}lJH?#xE|)&yah z{^E^xp=zS<b|RQ&5n&5K6DV<50p-jMdBSou*ledsb=~T^<W)Yw>@ud8Wcf(fL74eT zd|_u10zP%S4BC*%1kATCU$IuwYMV?eQHdAN(uk2WSjZ$0$FP(Q48oDsdx$q3d%Lp5 z?$ICUW_;WB09Vl6_ZEvzh)M3r!vi<Ft2N}_;4OA7ktsL<Cx$KC&`kR1f8l{<tP^Bl zvXSphdL*JBf4VJ3`gn}Wt&YjJ-T_)XO$lWeUjz@S2W+gW*q)lre}nqiVwu1J$&-c& zV`O|J*K((24nbK3P3-c}UXuS2xn8e^Rob!X(EYs~w-$Ms9A{+Z;qnP~oNcR=j$A9= z832CCw4AEy@dRdl0b1N{lXY?{UUF@zzJnaP4qA2g&^NE*<n7IuKx?8uIih==?2C{L z_`;ZqFtTeMy9V`@O5|G(*!yW<0UDs6*OH((oj55Jdb(If>CE*LRx7<BF&fgm*3@=k ziv5wFKOTI`mvb(ja<5)>IN2dcanHUVawA_wbnkVT>*g5--BGq$PCCD6mFDeH*x{@o z^fdwa`KLEMIh&9u6q8B%@pE(FV)c1WDlI=Efw@PWp%F3F2=M92)`c7o%EtW#kHrmr zy>)8vam7O9W92$8^NbQ741bUgKdePROIiY8J(!c+0nueHqgYncbuf$wpzYaL_aW6> zNwza|i_h*Nex*OQinI$vJE!1r&<%6yra`1V$DjZH5%R~zWu9U`pk@;X;foDQ?D9bO z^S<Sl2d}s|y>lmaW(||wx}5rDjkK-^1~j-zeUGrdSx4xA&9GgcRps(}hIe1YNu}&5 z<*C||C8)Zi(1X)>Pk4$V!~Ppv%ZLvU(+u&J|Ajh3m7znlX1V_#fS~fNY!h7r>I=i9 zMf#-Fl0RTPQnvTbq-q+KCO1TmTtsfU=|fnNCUoHp=7h(zfnwj465nw8c<nt)dSy_t zi`$ukDJQPJ)z9Ns^r`Ri0P;9X<AkVIGE`<rYDQ<{>bo(<PtjT%rA<YSmyM9>IYZ=H z4rj%krG=hgTea=a@_u>e6GNizz4e2~^2XCM{4|G&Q{{qE|FCn<u`1kwn%m#O^{?zu zJHbfPTk;#{$&<+S;l6uimK<1luhh#KK=`9?*%%{b*87?lp&%FPahUf@!}+9zgafx) ztM=4ma4x@vD0aD`i7X)+l=A$~uSCqd)%HM*^ZnE$PJa8@ZZS0^MY1nYdSG0EeNn7y z%w6B(Ss|6Of|Fck_%U7y=dC0Tlbc)ZEI{*}sJHc&7l$F8V5jPF%vNUH+2+mvY6$z) z_@KB^R?^qJ+5D3M)qq*VG7~jHO|>w9068O`(1-GaIu*re_B-Q3Qc|6VS^8_H%$uM6 zY`!BrwIlt6%bJ?+M`fQny}u*;=d$pe<sayW?3w86w%YGjz6m!$&#%=;SFOv&bs$*r z%{gp_Oo0jxcio)xyys;5)lmCY@a2+euf?Rq3E181WBJwDzP>y2j<C1+^MPG4jCzPu zB?|mwt$3#nP?KwP`VFK=Kk&xGmbDbqd+#9=WrvXGUg;fBIq(2GiTFM@qK)Q2`mm&D zg6KBPt`SHYa0M91fs+Ll1G)PME{lzOTPc_;Gkl>_cC}KT!Bcf>|GFfIMeiCf|I-Ox zu;PF}N$H@0XbX4ZR5Sv~UJB0>h2Qox8i@wf+=!ZN+$m^nn~m~4T&iyPUJmwz&Fgl^ zCQbovmHRPAN}<!vD#)FzBPDcybM_O&b<t=+lKc-#C*Rzb`cvX!=AHssgO9-mf`#cO zS(T?7%;Lz%v+voWX+n=6r3m`0E0Dy{zC8d<ZyYlX-kJ8g2Mc{X$%G~>D24U~wE7ZY zIgj`fksc25qO&)hQ>TSU(33yNyjv1}N9+?%Bb5fKMLeHB`!0-BW->~IWx5D@8#G5f zG{i^x?^xwO*0{9UGS6XG_3S%%2EMQZ+I{Xw70MSLVis6HSc9PMo{CaF7llz@*Z_8D zNLcZdE+%rhL@Y<803^_B>YG99!}oMV9d!0ZKQI}g|JxA)DlvzzxN+M(LVkPiQlmVp z-~(PsVXdwQWbF@q_YgD4w@sz}kc|DJA2X&OJD6Gk@zz8RyLNQTvN?s-8DjDKJnjwV zrr%Exj?KQ&qUyk=6w)<q(%G>GGiuYuE`>i4Due(M;_uR*1r!cE(z-W*zDs7aQywO} z$=Xnr1+hMMo0CV}*t4hp2TrHQZaU)@n(RH}X|&Tjv*2e3v$yYC$unQJ48F735oIG^ zr+EUWdH5cVc|%;0^G%t<*N9@Ii8w8rF58g!2%gCZK^26Bg(+^6svFZwfINR-#p-*R zg?47^1P(?dY%ROnA_ul!WfFyFCqlB=+*%0t{LxcsuM#Ed^fB>jM(1O_Q9XqZF>8=s z(U^Xc>2Op>!9JXdUFwgr-}-WN9?%V!K5m)_Uu0sdNf_6Qk{j9I3}fB>`bpe~1M6=E z=g*aN)Z`<H`UPH3!8I%+{-}g<$?MU6?ymt-isS5UF)ih><u-OcNBB|WIE%>0N4V^I zU>Kx@xKCN{5k_waWsH=gz@QczX2gON-V6m#_#T`dsz<m|^O*a_&8&X?pbC6#G}KKo zwj;Rl@{RhE(PFcUA$<XMm(^uJFZ!TiB_aQPJh365^yEQSmg<w}tK*P5+hFiegI5f* z?gwHO<Za)tA`)NHhT+=Ruf7Dk_&%ZK;$c$Us#K=2t_e-VeW+*=R2ip9@WKzNVzZCV zuJ%#*!`>alZE`FgdC595#S2s_4U+&0<@ZdGpC7}9Ov8Za=5pmvzD1s4=&+kjjrMi+ zHO*da09}~0^(!k5gUsNK5}xbxtSNE$fw`zlJ5S!cFR(MB9>=)JU}1+-^x<}(GR%f< zmr`H%qsXww_(KLX&Ki-Et$z2{OR?b>EQji`1<^l4vfhYBW%BCTSjaK+=F{yLjfZB= z@XScAq#-P+X3-QIbwH@%)Jiz0e&09z5Oa{O)`kR*`x_TGrb{fgZkxDGD^=+HKGqlW z=fm%#NtSgJBg4<auJ4%m<c3jIDVxIYBR_pQ!xi-?6v__4ciF4g-W4O#j%fAfoLboc z4`N%pVzt{lpB8}Ij%r<=j6C^*N21V{NXI{_itYLNki@FHr@~I=XOj`#PgiW9;-6s^ z8#AhlL;H(!bqGM1*>JE8qO1O(HMfy@PKeYf?W^GJj*Dx03J(6C83zlF6)TPsljmdg zvk~@0?-2}zv$l$n598bg(T8t`lV4t7pK$v?QjW^Q$}}2H=(H#tx0MJ>;Q(}In$3vB z-mvzxFg4<!dep|g!w-ikxqip$(Ew@y5H&s1P{NPzAQ&<kU7MDXY}f{gH{d|}y%h3A z)SkUoR`Fqb^6^0mj7*U!+m6*9Y$rDqv70M5xa2NSfJQP$Jt(netL+iUu`O*Cq(=O{ zg-ak51gv|d{LH%h@<@wewqlNDX^lrH=wbal_tbYMLP~)(*{kN<>W%}rep;7t14#a` zhcY5#U504QC!v-4DQNFG@_bc`wZK}t0GD=avO0mO7y>t%wxNV~1<!Ow+eB8K#0hx! zevdAJuyE_yctA#AV<_!g#^-MYifjzgbs@7bYqlH>CGK=&j<-sXd^N2DDl=PVjcUJ1 zKvwqFHh9fF?5yHRp;BGffze<E5*_Qb5Y<M>#**q1y34iZ!GXkG?vUhJk6htG3Mt%d z%W{?<%5&W|1H{7t!RW3xC)7QqCIh7p6-2GqDsE;wHQ4l#D0+GYkOfnE9i6m`#4480 zcT}r9LO29-AZ3J^2-!q-c||;tQAv|eD3mOu;W-Qi(yf_?XcdPZTe`^gt#mw~fG||0 ziPw>4UmX`nT(IxPb{Uh7e)j54+RhX$m!?Nrg0rLCS<Ox(Iq?<SG)$PiuB$}W6L?H0 zcl)t-PsVU|HUsII-DDUWnWZX|v97FlWC^If-_j~#)U)F7M!D9Y%Dmjsn~oQcac3;Z z(Ufb|h^2%ip9tsCE%f+S#Tmq=<M|tremj(PjNpJB+YIM;a_qUP_Y{Flm4QLerhvuE z6!+0+5tm43mZ)DqW>w!ds6@Ew<0+(aM5B~cP^}OQyz4FW81eGwcN3FC5+cib?h<v- zL8xS6SgyQ^lR^of8AH^c((4w8a0@vS@wEyFb<7p#h{Qp=<b6Y40DjI##Ta2T6T}e) zao6;kf2inN&_ZI6K9;|R=h8@(sdEwI>9qN7&tI$T-h|ub)Z@y1y{kg_;r{C#J^981 z`jE}ql^x%|4|VEBIXSt}(q%fm8>nj673<ylG4Mp{!S4@9mT_E9VrJjn#9NQuICEi| zUIu>SGDCdgkLQ5b2lO1oPRLK#P8&Vgzse}b^?vsAi}uDRcUhD$leQ?dPz5qaTP)k{ zKu{Y8a7ct=9mr5n>y^oaV}x+SZicdJ@bf5P)f3z1?09b6nc4s@cWv-0nacYatOEVe zg*$?Q{Y-Fy8d;#~HJ`!q_(S!(iF6@r7L!W(+>?~TuN^}Tq9-DC?yHF)W<=z`Z0Dz( z=G4S@_Dw-X0Kk51XaZ&0n`5=vq-8rHgJF(ra+E34a9`3R25}tbi#{A;B66~e3Zuh9 z_@fT$lHH@71+Ahcyqjb|c0`)sC!-fBu1(zDZzBrFYdLHx3O+10##d^r!+o(BD|gUI zpbfXWRJ9EiUl!tKRm8JbJogXP)C8Z8+Bz(XqEa{8$t3UV<HY=9H`LFT1lLszNDN+H zr8;Zq{cN+yCUZiz@)ci>CqYp&coakQ!O6x=G)jp7Y&={z^(_P7?xeC8kuC-W`&T7d z(h)L<llX;hW)sN0b}Zc1v!EaNZ|;Q@w0PM!U0iE?(SWFhKyNtz#wgAlw$>{i_tmbv zPPeK2_E~J|z^i^xxSU9b2*7j;#02}>5`P`WV-Wh;lzluldx{(i$zV6l(%*<E1EGrm zhG;gjJ6ay~o<PTt7f8S9lv@TeNm7C+c6w43->EqPg<vf1pnWVR<o)dMQ)6<7ZXPoh z1=CB<Roo!G>sDZ1nn1}$jL+zWIAOTYYqXb=E8@ahT#pt<6A^n{==4rY$%Ax&yzejk zn3ox$Gmjh`5u?=#9zdZ^SDRop4}i3kMs%sjTqptd^ZoY$!^xLr>8WE#Stg<}+9wAa zb;ngwR?Nw2Bow(6u|GGOEFje;0BoCHK1z_-UstK9$K*!xZ$r)rsiW_DH=Wi?HvBSJ z-LXdR_m=1Ve@}uS%1E8i?07S!G}VK&$Oyg60k9K?j_H|}qk#8Ska*0CZDXl)en}dl z;`ta+^16axGK1^=!3x?w#A__SbA7<H?5^kc0wtFxf$Q`m$1sPTOevGehF4-E&s+=F zBWQ1jF8X)w31cjlPrf02aWo;PzhC<p$RchPJ*-50FTdslA~ie)?pD=IF5~0-wmdr^ zN>JreCQyQPCp2q{?Ar@0oXK%Akz)qzd(hvNp(pcBXK*cn&-@z+sT(W(aiR`6f;rEj z2=chb+5PnlQu~6NWvu^?v9AuRa_hb|kPwv;5J8X<NkK&#1ZfndyF>(}Lpqd@lyoB~ zf(S@=BO#pv2CZ}oNJ-b7i*t_O`F_vuKKJfF&f$5^K6}6Web<_6&N0Ur^Gbz28k7$I z?&=)Zb(v-SaIn9FB$KL8<FvgID1q{fqwtw0OhK=!I@otb2_1@lLq(Es&&@yE1mX8k z+<lu|so4`$U#Z*_g6~elbne_lt6+8y2@z4i9XRt4Cu&GorGq`45wbEvASer_WI58) z(aj^Og9CTF3fPmqeD*6quW&3`=giXw(BsR3oHD^RA{)-gK?oPK2M;#^r&cBSTw>lo z#uK&NMC^^&hN~k{VK=}BawsmO6*oP+EFIJIIa?ln>4d%DSNHtKmI@8EU*BvBzLTr& z?@4vwVh!7=$HcfxvK4=kuvOn0E4w8}%+z568ROXWw^-vZbkVcdOJ|UQhleiGNmg%$ z(cb8&<|S_f^>O^`Wg#V5!dP2@{v$jI3vi0gqw%qJ8a+hH)p2QPP=}l$#|R0L%p+>& z38HGwm{})r;*&Z*P;F&578rXNQe+5E>WmY3i$gnT`6K3Jmt6o0+@BAc08Z_;?)%_w z@D>?x2KU}BVohK@uG(@UCsec=9SF#&CkK;rYM-cTg<HMj;|Or>cbAoEXoOt8S=qR4 zGr?M9{+Rq&Hy1NLT+r-am%zxys+=5Sp~L&-%zhDLA;ZJ1)}8|QLAAcPPeEevyUQD` z<>l06)rdLn8(OMNjZW9z(7a|Fu0@!c&!!&7C`abmk@oEU?MN=`k(&hCe17auH(MQ; z!!iv|x}A{0fPGSDQW-7UaIAzb?tO7d$pI+Mg>ZG?xG|Y66V2U#0OKlg6Ao8|*d(}) zsS#FO{rDTA6EeVYugaVV?3LqYqn(3QdO%W`A3O3U7qj8p>HSxZtCRTBC|6U0KvVrE zNxal;9ZJjORjNF;S^8UY;C?e@A0?pVGbtcKSIA&P$H};v#7NImt2S^{>a>0t7g?jb zu_gvt#aJ=BLAcv-b_J2}*!(d`-)y>w7tHoT0yXMKs!Jx?4^Nve2#>@*V!fMd5HkBf z0J@;oISph0IQ60h9JA3R0L${(O9;4hw`QTW4!niS2P#~v&#K`0;tKlOTN{BWW15vt zTksvPgOhgwJ_zwx20&tE4l@@*BTx1|f!`(5dbT`{Z(xJ~^sp&RE>QARMta3k_-5Ot zkNrA@mM$@Sw#h{L79j9`QLzHRc3q;hYtGgzVkx}7uVD1iSHD-+HH+I~;2W}D1~tw~ zaRrJ)ba>CtFltjtk01b`T0fjmd;F?3JewCmTomP=HlI(|WcbIr@(01LlsRg02mBOY z_5+hz3^MzHjL#j8u<34qsWHuMS?NM|D5_rJ<h<swTF<5eYVSXp{lU52UqJFe={ux> zKc_pPKgl<~UJu{?8H{}TShWFaAHsUQFT;=w*)YWPV_jn#a7=GJ>fF3nXrcgZyI8<F z>Zc>`m{ja%WS6%>o;=l^164%fa~cs{yVvM8N>_}FHA71I73mF?Y_&nn9CgjOqpK1U zAW}p8m)f>6GfaFJ%Iv0#ku$ykvo@qj3CXsXP;e)g4u}mtJiE_6kyYEj7sG9)3Yjm4 zLx(>@Eho<E<)dB*f<C`wc<1F}t{Tk)(z4>ri&WsK%0LNRf)reXzkjSiczC$5C+l>= zsUb*;`w%YD2A7M958@wiAXJ)R-k;>Zwp-N#d=$7Kl3>a#@TuO1gRP4=9MTwciXX+L z!asX?L=TvM6q+uUTr?`s{;0q#LiI|m`6@S>CW!TcR-wtLw|0SXXE8k5PiS_BxBlTH zovwwTmkI1kVNWygmdk<y)Fb;gIT-}j3vZ4f*8|UzAO;^uZnnRdLW@wrBtRNcF1UwD zgzZHx(4XC|P+0aYQ|4oS!)N!t<gVPQXr>^M0n4&UGC1#dDjKW-EHnqi%K@;Vu0&XU zsMJW3iA0r+hcGhEuv%@lr?U5hT!<u*{w6SD%t1EoF<QtG9r6RrXDjKH3@L5Am){}d zHkXZG3z#0n#Gax4=LXQG+A?D8K?@IR$Vw_c+f6|g(6ki-Y}^NdodQw=gi5GUC<EaH zXif8@te*83gj}xw#zkpU__bSp6zN(Yphro5bI5(;heO?Ip43l?{>`Qrt&O(nrWp2+ zPze-)km^QtRT95FA8C0Kkh6F2UdNNVonIifAZfp_d?B14W&?$3P}i~9=lr=(KH1u| zvfa!~<IBn70mQ0#_a)$QgyX!@W{!?V4oW$y@aa{4SrDJ|fkWR1a&wf4|Gs>9c}fLl zy&RNaZ|1%^>bDNRau5wCQqs}}KU(3EI9Ns0<;P)4-G#&b1}+R)kV)<zuo*<}dgny} z%<C$!10etAZ&}-IT&=Rp2e5w%0LIk-hQT}}szuO;<^PQvPJ-{cSK75<<Mlg!{jzc} zEYJFf(1UYW8W9Do&cP%g)~vAGsN?cf!bMzm<<zh%0=>Ad&_P(By`;9YDx{Wr=@O*A zMPT^RXXSSH<}R|yhi>+6I+ATQwdFy*LL`$Z*{Nw<)JmRv-GGU@{>=@~0t`pQ*Zc=3 zA^GlKWOY#gHBZ5=*D-M|g?T#U_T)13%lcqLm_r6ZMon!=AhMf_#wK(!lhlGr+`al6 znSyvkK0w!~5_T7SYHb7Lk{iYyR0I@XlVl8${lkG!yrRu1sF)t2!4)_@Khv#$mL7>8 z?th>K#ojuf&lX#_&F9Jmz=cl>DNanF#Vzf1Z|0RX<Z};!)m;E^LA_R3bN60*Vr#%0 zWYL)*wA#l}xL-$e8IqTE5&6`6NGb^gmQOkM3~Z{K2q9p`i1qee;Ipkq6bFkde8ZF9 zU)o7^e2A%D11*SLmz^FuC$ziLD`CRHP+nm5@Rrt_t~Ka=uO5lwyOXvw;kEjL?Bhx~ zUecAa31WiO$@<M7cV0j8@cbI(3~j0XYZsVtvnZ}5nrYpq`Vdin2dW%@23+54Jio|A z6xx1OA9z%+2v>1dvo2U7l1i4P3BikdYCG|#y0f$|$Wl@akP=mWiQ0nfZDqVkrc`qc z9y%Bpb**`F88yLE%L1pbL*KD7ODK#o0mmNV_O)w;JK%EUbr{?zY1_I6cKgM5L2CQE zTSEGi2M_qomk*ZVc~p#l1fYLmoZ2Us4sxB<lcpX_A?LYUn^L^el2hMJIr18?j*Fhm zp1l3%csID0+|vE_)F~v_9Gq=5p1jnZU3m1qrCRnqqn$z;`C#7o1iHgeFVcmphw^Jo zj<!%6&13ClX?z;AlPBa8<_;3=@Q)Y8Dk0+{9J81lOnMJGBjJXOTbwLw4i8N95gt~7 zlcR<7=_7DM%Y^#RBk@aQbvK^Y7G)fB2(Esa|10a~_#ew|K3m4!V~?-+e03A3<GJvt z5e?-&qK%`L)Ql|C$$Q*)c0BnNwV}$}zxK4MxnKJ6u1Jhw!s56%)avf~`LHGu7-2OW zWWZJ#s#*gw{Ym!lO=1cP)5At7p*tMy%lm%Vo|~trc)M`kK}ODD)f;h^knAf*NEc?2 z&$k@S(AHl7=lxZYU&Lll*x=)Ai{oa6`}s>!?~l&PyH$Nn9yT{q{t!*t{Du#*u>WMA zcv>f1($9S~9y);D`Q}AoQSkTn$vV}i_^Gw*;?p@)uR>A@$vF37SVWge4CwQuUUM3V z9fEU`663&Y*^_KwwJ@AjZFr8~iT5x@)jtHwr+Am9WB9jB8l3|Ww{*MPgq31q)CB?> zaHf=pf!X7i7R<NoVdr*+ig(0NKX`ZvW7yDePh0<PvVFF8nV1=2fB-6+7(_4I-{IZ; zY5dk-)fmCy6>1;6G8S-7pP%UNz{<gTDRY8pRhyzEmTPypQSjoaT$@^5=%JwQMI|Ob z`xP91;S&tWzS*(YND8yn^J-IGsROM_?GvX7<Q2NC088nBNxLvMS*+aGJ!DQ(jK)J* z#axTuJXcSSwqJxz_$j3mFva?_mG%*N-X^!)U3MCuJh!_TdN?J%eoYI?@hJ$%>z+pd zHb4@;gFZshHfbo(a-sSqj8?f@O_Z<LB3mkZ;+o;L-H@rhDOSU)6@G>BQ(n%NqKt*j zWl8@eem)I3p4nB#Re^wMGc?Og!>SbgJxM_61!Jx6Jlgbrev~(xBY7LsTbnl_tFb>a z`m+TD+tLfBa9}dD$l*b*UUaH4N2{bGBeC>en5cHGD)t1PW{ith(EKJJ%ajA6A7uhK z=zzSVAh?TdFbKkLq&s-Lxnw|~o93T%HDWPF(%;!&>w_?^p?40J6IRam%>$uQu1P{3 zj{JbdpnkwDjjilD)n!4^U-5`1jUJcj=4nfx$?xZ^MjL&1L{raWWqvogcITsP!_{#v zZK{TifXOi?8I3<db1AwLaPD=F#|&y#jT<z$Z#C^fNaR7M4YQDt73WM`l5eCN_LK>q zRCK%XYmxS7@*Aa!QIQ_<`=)wznEYLZi?F;Slo?98FsnS+wiFKtu!qXHMmqEbc{+M$ z9@GjxRVHreX_){CU=i@YzN7J3a1O`A*~|{5^;@{z6BD@0o0T^w8LBBaWf>WH(pkJY zZ<H<z(BeKU`z#-)?Zb7XYUSGSDu!~k8JmaNv$*uKzw@Jh0*+1jVE;H=S<}_F=l8fv z6^dG)t9I3FRJ^~aJn5AJ|7e7fYmI8S>RYYPxyU>gukO=DoV)x_buwyGi(r}U#b1DG zF!zWi*#(fy0=(IeCVMAsfdKP18M_StuJaZ%CgZoywb4+V8d#P(!n5BzmfknQqLCeZ zdjIlx)kt0i(=JyO;nPwSjg@6+?T!3dQ{8B<8)@Qp)OpqD9P3Ucy~c)rOqIIr3CHo? z_6^BNLeeZINMET4v`zIk!9rz=&*Hv-qugwQnRrrvTwRlS?^DC|-Wo%P%XIR7Vt3`7 zUMWYhyR)>p>_+kFu;A}l)fD<ODEd6b$|)=|Vq+~mQGIta?qJ9J$c^`uM=c1ytZWE- zZd@Z^)$@j1_eCgZaqIkA<K|6H$&b$$z1L36ow1ykTl#SM{jkh#Rj|vrqp@|+d3$Ug z4-ssh5D9C14?oF0o%7!}_uACrXfk<<*X+iH8zsB~?|Ug%*?xAhHf(3e+Y2ELkcT5o zT5ycPOH~Cm>R6|EiQer=fhUi<<<o05p5w723PsJ^tT4f2F69v?m(t8DUe24>-8QYQ zd?hzu67nj<LkhYFG$36(S%Kn->*RQzPF>mlo;x6HU5cvLW^S7c+4fWZE%Nr=K>`C> zXJM*T>_!q_*owZ95or<^JSLK0zuPB?UveBu+d*Q5k5`k23}ciQ&aeki)*QK7lImR+ z>w3bwAvT_?6mGr&^H)*AVzSHkK3;hupn{d{zWsaoErwZu_vM}7X-j4<dm*Q9=AV8^ zYvt3|79Y5`-&lNJXwg)?pLY;_fj7cB!K|?`ZQg5DQ6qa*QETY7+Z`iD4%`AU4JEB- zo7LE=;$yhgc3uvpqGsA0zegn*jji!n__r$Shj(j+_qk4_)I1+%{aoGXaBGSCW9Piy zl8{$Cky~f)2)4&vY&{LKue~!ox@zBY1Vi4wsJNVZWJ<E+nx&}gL(5<pt{Zd_-_XGu zz_jc50X!CRX22Njxn5;s%NZux!c007{z!+5r>NTB2=r<eo14PvS@6SY{5k4cBTlAR zsC4Yv@=Iq5+shV;2i*wYLvM<Dn-L4U3Rf5P0jvn@px5Q<D{9-IPZRGMB65^Xt<82B z%QI{l=Un$WZPHeo(NGMpunv@pM0^$oFTa}-WjwoZP&Z{_BGax&o@y9A=)o;e$O?y9 z+NyHCp{G^8p=+;SRQ+k}Y>L9kMfPLL*v=GvMw~ChFs9rl63u)}q>{#gmh5`&YZ#nt zlqce3pL)h5$;@n@?2ie1Jg}X3!);69b>4ES#Sho^5OL~)c?w0E>g4?2c;_ss`S&}G zVSg0cc_t;}$r(9cP0r7_a@(*(_f=!M_KU__>MGTN44%qQuswHhvK-5}&JZg5WAikg zC{?Ja={r(A?1djt%Jq=&yVugS(x=l{h9?!gH7rGQ+t^Ew#A;b9@Rp2-*;s1xQh)Cw z@CcQxTy}j)Dau;yxh359URpK*VirRjVXhmb0>aaV2+V*~%j4K}AYJF&1{gI8x{obd z;Q&7O-Hkm*`1WL!!+GVF&)F{)@l1J_nW5s1=S2Vlg3mxxmVr~MZSw;fA0i5f^^YT< z&E3ebqOBoS8r8)lbW(=|$hj_kFiUTb^|%7wTK`BWw(y5`uC{5+2&S_DqK-d9#l(%2 zx&D#wTX1OZmn3r@wY*QQEYF-UR|UajbX}UV@@ML49hZ95JqptX+xP1%Un*jhG@h<1 zX;rnSvD+P!-`Ut8Dq!ECv-t5#daz<6T5X(TkiyirAi3D3;Y;7z%cP<<+q}?|%;FOV zL|s=^Ykda*6z5y`rT_Vs8WEpkt*!{iZ}-@Xf+Mmx*uN#<U1(A#xS<&%!7t7`?X?E> z=xhEW-%LgMfz0j6rj|=oMSL6j>V5G$2=<*R2boCD$%#Oo{Vpc!WD92YKs;OIhKA5b z#9%5xr0F`f9v<jG<P;~<-AKr(efZXEFa5CAVK_UGhNdMU(ffg*t%{+T{)fWB_bX5E zi8gnY!f&qK6kCWycWT%0cjjZ&47a0lb`e)AOjmidX6g9Y<=!uKMMUpa-S?a9hy&NX z_OqH1o68&cHIo48xmERok=VECXt{asJ^&1mv0dMB0zpE}h}~WHiRe2TGzN>G1Rv0= zQ5UV&DfORznUps*S-Vh^Z@SPyJe&FG>2+0p$7s^F80(TYTVIW2{IBX+wWe8*YObrY zNkx~C4wWxP-}ymkz<Lmz`+b_|OiI4J!AU9c2^vri=0hgicS%0h1h~1soty6BRHvLR z4Xh{N&Lo6j04=^%RjPK9v)nh|2^>jaRY_IeQuwqDoLnT5L<8}Vf1M|X$`h<~toMk3 zuhwcylQ0J*<y;L|_X*F5a^OBN?UvPFL$;J?Jc`A0Qe7E)fE9{BCEX<qa{8RWknv0B zQhbAsB0?zQ8F;Ef`(@EnnUe-#GtfpJrRza10o&^fW~kM3;4a}vCgarp8JbqOJ5K8c zuZx&#vzgC6%+ZS+8n{sX!`AeCo2SPkxyWY8oBi>-F-rZPnl?h+Cmk#juCLE6?;V(| z(|QWw@oi-KGjJ6CN^XAM;jI0eo-W`ez&PPfV*0HrMtQz*K%QBm^O+3fo)UU{EIg-> zYRXx;PVu?4)X{;DS4BO|P3~3zAro2e?UiXi{j@>HWgu@bplUZM{M22H75WiKM=Z=k zhQU&{gV{`s_Bn??XLrP_9ud!cKZnuY$^>=`nr9c^CQnRlm(=m&yg_`2ka@Kw|05o~ zS3SDf=Pe%x?Ozjlr1;Szzd9?!chI8Y%RuZWqV<;L-nzN5wE%zXJi%($ncSPB&-@v5 zQ6fEtm%!AWjwN;5l1BgP?x)v0uCDq~*VN1|Mz_aJFJp4KZ$5E-7byPA@P|S?iE>S# zxRn0^xWJ>#q;gOFTc?RwLbnad_{LzS)8`=<SI}GHX$Bnj+L>{t>j5`f58(s>=f=+- z04H2==w+OCHF9@5ad&o0=x-S5_;g=>(Wt2%(-Am*`_+#(fs@h;J9?{|bJ4~7@x4Xn z#y-{ZL`01n??Na7rN>Z4%n--fBDAWsA|+r~{A;*+*b3_GRTklN#WGK5XzAKWca_^s z%jfV<1Qvglc+AQkWXgP7x}mr)TiP5UOYzsDi%pevnXuazWq0O*YqDh=<51Ub?Dmeu z>JT(3s2RQsy^11aFNYu_ogmb2hwgW9kzIIw^&6a!e*Z}+i|;=Z9VCXnt($Dws|xFV z@$k%UrhFJm<#}N;#B=iTb9I|<dMWS-8BQPGWf_2`ko~8w`!>KZuDKF@vTH+dKPum_ zM2>#djh<9qCu%0{u@%tKKB@*Hco^~(^&Gr?ryCxO+?)_MQMr}M2aVW+%uCq2uSbUE z0RnXk3zGE)pbxB1=fpw@(X|IqDwo)Dv=5udI_laqkoEuv*=kz4gjR+sL_GS__j3ky zQ5W*qM$_iwzRYI2)J!NGRV})C-b|Z6%jiygtKM+%c+RSIEe{=WxKp9)hUKEzVP}z; zNQMO^>GdT0H>X=o#MoIhp{X%j!_u9qysQH>tbH7z?q_JuBr=X=YMmAqO936n&fZ0* z``K+kh;bS;NIz;?)4I{VgGAi~I#z&IqY|q#K*o0gj4?Li9qQ;lBkqp~kM`$I@FYn1 zWc?(F0Ob!zCIaB=P=@Z7_ToSh>mTHeoAql|FeOjN5crnvAZrMiY*_>ak`Fa)Kucp~ z_zjnCBCV=xUs$FH3S`L{A)w2WKiitqwAo$TD_rrf)+LgmIOmt(<c05n#4tE#sBnRR zAtQ<i0$iF<f(ucZ0CoiBtUm)5_Gy@+`%A4+2aq#|-!lrXNDNxx4xJ(53U*a!BMGq~ zDWRAgL*9sND+*U4Jje{HbK_O?lE(WBJme(z7<CgRPb2J_6lHzN=!u1wZrt8z=_!*S z#lPz~R!#pOhQKvQSTZ~P8&u1s&#>wVI-1DT>Z_Xr9nHg|MIsN)Km$7ImV`eH$}^Zz zkf9W{g>u@W)(0<vQD*RIV$=MG2C1yoZ{AU~cUWALT}prG3T}NW5U`&may49`-Pvj8 za!q?w%6&Pe=W3ElQIWK*BY<@WBCpTrA?D07MIgI4gXz6wNUE<kU~G_^agYH5f=VFx zs{^g9l1`Q32Exenx;sfRpgR4~$r>9C*lZ)3rV7<n1!}|rAN%?aNR=#LtPpkWrT0Iz z(K3~Z#nnoqe%ICofR!1Tlq^}^I%TdT9j1M(cfw>XzRCPsAbs(Ej-i9fe(re5#Aj7r ze%)Rb@@M^xLQUoqfr-VoFVl4-6usWg{XqUFa5YLJED`l4-*m(oVq{<6$m*PRLHZhC z>bc9m12d@2tDhton3SL!B2qRj>sjlPE=NK+V2|cHmD|sb*<JF4^a*jcU-LgsFL{<Y zpoO4j29{dYbblb2&0?~&D|n#K#0qmk5X5wz$8w%LU3RR<&De*%kJ^;c?tL-k6&bUw zt4y8MR;$#WIy~ADjk3C717y^mm2wAN!#s4%CoYhms~g{l@MmC0At53UI5RHXBM|nd zkK?s7Ww5C6sc37+<ZeNOhp~K1C-FY@I3l%z^UrYtO&C%50J*IKU+o9r{U)#j@q`r7 zWh%1N_Q3rgtW%w89k2a%I0+pCcXkksJLs0!{lpN^J38(ekvVk1lyXCSAem25Yxa8! zjH**4_vvTsSK67=Su;+$AnVp!3umbG+4Ii8jtEzW26HQb_*TgG4h*Tb^;PbRw~Ye( z+Le`e3U3JY>c_U=;CB1PB4!u`yTo6*wbs`gF{nz2-n(;>|NJZ)-P!}b&-LeTn9qED zgu1j>)G_tXmu!|pr19k}4pWiVR~3FY@QvjxlI?so)L9B71nA5c^wJ$jWkO2TwSSb0 zN8lhNf{r)?!NX`?$7@07d;&>@3t`a!t97760I3I#a%-BBQ~_(@!wpEwz$YyR1|ZNY z6w5(B0`^&ruNNc=CCCd2xeX)UD*`%EfS(S$UAY2_)V1ksc_NT02@aXuj4!o`HN6>B z%^al$(sjbAC8H`XvK3x;W_?9p<ktrIQ6cxMUKNIZKKq$4WTp*MCKTh%w8bNC9A2)i zSi9+C=r;{OzPRYEx+@yi$CbjBHHM}qB9$lt79pX_1d`5>ixV{Nk<D$6%e}wJ21JEd z)hjIqZ)oK|2zU<TX~D_u7J(A-NU|G04UP=2V4w%;FsHvm;9QvjoWS$IJ35^uL(J;( zEAu<)tX(--hwRL&tIxR8>=~VO+;@v|`m?%J7|LM4v+v!Q-_Z9$`dl$N35GO9)D5F! zYPhI^SOv)5cGzR*(-|6JDrkTho*4(#k_K=t+$_g|PW1(R%n4BZtMn>?F};YPq6Oqn zAaVX+btW;xH$q!{>k3C4*!YIR(4hwJ9%QBqdFurEz%pj_BT$*PUyzi1w+%w_&;wyB z;1vt!n1KRe@7OJw-4MxF76W$e#R~!tPZYc_rt4R1%)MmSyP|o}=h<FN<+(tGLnI@- zc>!44H;_TBub-b^RG_qCGD6G5<y(+16?-qPZp<|1=aVEKXFaoTsRl5me))!N`!MpG zBe);$JVlY?bB_Dbi;~~{AWtiy9s1yygVTQU{vi*6%<jhpL8mU*KNgS(tnuxn>0h{R z5>|5Ny{!K#A9iNUbbK0PY1c1+Rq?Y%X|S?m7a<0<ag@){c?L6__M{P>DhW1K(s*y5 zCMKtZt-I*lWQ7w#wffqhfd;4<#fX*I!~$U6c}-wLVNg4eh|dTS=O&xO>jrb7Ug3n+ z`cr_>2T_Ce5bf<j<CvrP>>i@ozG`d2$W$9T*n_as=Z-EwH`oG-KjDuhko)XF<yFBF z^;ASm1AFltt}-vm#%zD`J|5c*SiRhl!khC>VyVh~M^HQY79QzMAnt6~-DS}zJCX}~ z9mxFG2sCFkYX!5~r$t<To8;JnZTmYtYw`<&s8it%4o*?Dx3J>_#UetgL#b8=ooDy) zXqAWwbiVGBl>h3Tzf9MHJg?c5-rr7$7iVCWd%QbwLtYApuWV8TH=E_`zlay>Fc!!+ zN?NhzqB;}_g4X8H0aGL3^m}A08dMI6zccrhRkzRSA!T}|ccnhiOdT2DiRH6%!G8-3 z_2EwUbEVJ-d_%AVP0M`jrzm7^xmxvUnrW0gNtUx4o7<>9U)_>@<>gmfV*#6>`q6@7 zt<mqZStdijfwMw8SnXNuNHIEgqoZ<$zjikhHI##faSi#%4TtuDE8yBCOHS5NBQHT% zsyKR{h-kDskJ;$S>)cm2+JLc-%P#Xubw0T8Oe8^n;c2O?$KBRux*R$)aTANH!)LTo znEf&(6R!6ZyOff)rt`!99$qi~Pn$)CvW9^aTiF#5z3(_x5lTzvFC2eTm^&^xXMlZh z4lC&=rjx75`>B|h3HI+X=)R#}R`X+fV*18PVwA)0r5dOZbzJqNUJFcJ8?3ar1HcE% z_uWzpy=$Gt*|C!~%!V@B?NLIm4%MaXV0BKNuehgFYHfgMB95$lB(d?I6(Qb<tjFVB zL?o`^6s#6T`#pCvAHQr?2TAqUk7lz*jaoJqLuatr`R`lZ=6isu@04tL<ChQAW>_Nn zlI1b2U#JgKT8m^4zAI`tMfU@LXxF3ho?=Q*wNdzl<ey(k^OSXwesmlZJ`bRWCXs&z z=1jnum2X^rw-`7#>Q3dk@M9j&@(iBu=6HC*))??Ijek=kBka6CK86U<1E%0KIqwYR zWYerqGra7=oa{Xld8YrDcT=Xt^WUl^GY7?C^4XHvy!!)8G=(vg^gxwl$ZHFy#ppo9 zCT*jbBENmM<JCYqxwMfTQ)qsj-x*Dm#{@<38wD_2K}YgoQ-M1AE2iu&`4!#ynmHKN zJz0~nZ-P=a8QloYnO1A^r*qI8w?q<{M;eXkienO9aPQufuE%$+Sx<1e7P+`&=rBzB zWJiWnua_88<x{{XM+A=_sAvG5s!)AFVBhm)KR2Jlz{=fM10j>u12~J-X3u|B4So;= zQZvGH4!Ir^zGZoc>gGsu;GF<MC$#fV<iI|rYmrtwsYCG-k>wEKUie_w4vk+B0<+x& zS0!q6`Yc;D?Hd-GxF$hzVz62w;nc8AvqR5r-on{d;GVy>xL%=BQ4#HHIwQ`Yq43oj zg&#9C91R(MLyGC1oeAfp#)AhBW_01d5ruEo@Lm3@M_611;v-eyz@NQP3XRU%(u;;H zAKu@K7E<7P<L)Ady_29I347ps#}&2C9yQNF-5AFN_V3iAq<M4^ZV2oq3g@)}DzQsS z5NPE3Axc?-<F3LII(+DspV@T+>#ra5X$Hq}&iuCf3T7gHzYt4-S8eKa0X0u@$rY<M zlOp_-JiQwd>aXJo2F5NBk(E?ROEAzL(iy^em5Lsz%zaG>HENIkjC7q=vyIw_M+$6g z$d!DMu4Ww!UizT9jJop3rWNrv=mP2hR>~u=Y}Qw~a<X7KgMNNZ#?O4VLt5z<ON8Lx zmyU?0NOv=T$Ole@*6stCfOYC`UU^Be<&Q@wQX?v{!;i<k{UA_ygbXUs8zM^2ehMEL z%ESz1x4#~E#x8XK0<2O}fo|s841D(vkKgHf1chY%0EMsdUBP7^cm(YBp@%5IcVzz1 z*^dO(X2VsLV1_P;{)_aO%B8!}l^U$xI#I0c*ldFLZ$(k(iL7S~sW7A=rY-zzaiDi0 z@C5*=_<p1S^ww9V;p~h;pWEE84hH9lLX8aCGGLwxnp=QooXEY=yrlzIy_wAKk>REg zE##~MVeHkwGY+Bq8IEZK@cCb3QsE<Fubpx+`t+(B5oJ_z5Oo3?f?ID7$rCOw4!<O= zA1qK#LxWNvEmOC00A@Pt18+Ins54IIDQY`2rzyq!P-T0r(oXXbzeH-FBq*fsS@qe9 zKn5dzO0;I|0t0)&(FhHjnMVW!#2ek-ShPa$57^GNo}m^z=aPiJOS&DA&0+9p2`F!d z0a!MIn^=TkD}fAa@alnrTv{=b`xZ-vnqbzXhzRDijzc}!ynkV0D{NA>zw*p0wY9Zu zz@k(IJ3U0YLE}xSYl*8upw>hw(O+NHED}P+cONk)kxCt@xFC~T%Vu_){2pO<8?HJj zQ0|#!+4U@yD`AZezeFAmv+<fk*0?z>Pb6cD%4r}Hy(6Xt!@(YaTjxF}`k}#NP|H7b z{PFlD_?fi>r;g;WFH2GemQ4}z8$$pu6n}`=m1BNrYK_MH*~!8ePFx&c)-x?SnUYr# zqu9TwMQ<@!WtiY9&X9IUcA{GjS+@ded<i0tqI3~jl7(=KU|qOB1V@MrzdRrf;|Xa( zcotU-1U2m-;?Bc#3_o|^fq6Woo_<zHQU!zDE6P=}d>~quF~4SNw~c!_Kz2Z6&;|+d zaVb)GY7!`v!g-Y>|7HMDo<>o=i-;wMQ`X?y5m89^U=EC>D!z!KZ;MEQpM>VInIoo^ zUk2>Te8}#$zh~W+fWZL@;CHpU`&|J(l#eBry$BY2k<snftz_n*_lh#4iIWRdP<*x) z-IUGXO{XxS?FG~8oQD_vE0-H7ku}H-gIcU28dL|!Tmra)9QE4f0c0$O+N&32QH!g^ z4xk-CHkqs-nyOWWHxhlJI#6+R&gN{3;li-@k(p|dmIpG(@SC9(DNb)9;8t^jTpegn z3qZong(QC%XZWgd$Gn9<o<7*ma6wWP&#qS`_#4&&eB3;23nK_?g(!i3xPSF4>~bsU zP8ER5YB$1{z`(u$kb4bia(|OlhbIslxK-z-+q*SLXFgZe+@(k)Bm38?dH3Sd9YpoY z0LfDq3?+DgaE40Y{v8^%!e^p6BI__-Kpi$mCWKVsja~rk!4uIUf%|Zmh#{2&DkM?$ zW8s}sxvq&kB+P-?i^PU)ubFbXb39XuOg`5_^tcZ+;d~IQXh4y2%M6Y}84Xz-!iQzo zl8c4>Li*!zLi>p(v*~2y(+!(^t3pXYNKg!u$(-?T!ky}~|Mk5e`8im@+#!>I<}^N+ z->IED4T3p^=Z9cWiP{|?d^CbG-56zGO<dMeAMOu)o9uWqXgk$z3Z^S1hnb#AYTVm= zIySa;nky)n=efS$c`(<t`$*1$2$76LXvVeYVf_>$n%5P#al!eVc2e`@q$-C8!wzkc zOrd%=9f4-46;3C?2C9`PV2_HB?^v$5e0Zl$eTc5$+h!vyNuY^SMN098&4R)l=WN)8 z5W$Bzs&}o5f|Br%Hpfj+aQDfYo^?IH?(3mf7&)_;uW57M(u(i?KD5;W@M9Z+L{<+Z zJ1dl34sXVFk{Pg(lAXd@Sq1N<NpEk#sgF;OqwJHwnx6jgY$`mE<`(V8j>fMAk}8w= z$wtYuZH`i|W?jXum#_f&$J4=Qh7FmT%fYG_9UoT5JMWY&3w7daVsB97^~sXA0JW7G z9Zxd+y5}9cgx|RK#Z|Dp5z?gn&e5C-)gJTV-p3OIZ3S!W0O5PZr=q#73t;I%-H{&) zD2I<<*7vbZWog)j3>w=mjUHy!Dw1+9FBLhS#Ir0sJ|+3Kbs;i5BhzMKO!cx=6iG)* zI*@7q`o{9x0uO!|Unu?{mt4e@BX3OpCWnGfB7zu&(TIzOixtBAg+lUQ-`@rLrU)#5 zJEgPzsaUco$T@i~;IjR5krpod%1S5Aw)5FPuMo+2MEwdbTqL8(n}Zlep6;Xdc^>6X z|MT-s>O^Kwkd=4z6B}rJWwj;^pO`gC>hCxn?qHTzxGuY9&H84pzS>cO!RF6zKV0=+ z;9kwjS|-ee?1igx<bb+Qrs`5wP%dlefk-c;>6n(pgGKTG{p<R4OH~@IA^(bCyQAy) zZ79yBIdEDTGU2oTP>@jVDb6qp+%J2^rmnT_pR-vG;nyMjibsT6kyGcbM-s5ulghli zj(^xCLsxY8YS#Gc^heA3ua_;^-?#3cxA@1NI6RsDc?100SQI7L|9bszAEW3tQx1w` zgiFpNZyn%)0{SorQguTFR?H1men4(3$iNEO20-nHh8oR-8CB6xrR(8zA}D{6>aZUI zrLk4T^0T$Y;bACR%+Yal^f-1OETmgnh@JQ66+UrU!Y>;u5y5(kfC*b7;^^l@sX<_V z2`c}9Q~*XkehZ-%dIYkBe27k4?pT@NC0~Nj9mE;k*xTC}1`)xT*DzfD6Eu;LW(_73 ztsf@8f9^qqTk=fTV_@zTgT4njFms!JsRtnjHGv|KS!a)$q2LF&g9k{b^R9#j2Nzy9 z{i2R2wNNypGw@*A*sBLlIW6$&%7o|)X%D8W2R+3<F9tr@&k1v2fXoITiQoo&eEik0 zA_&vE4X>cOYKys+f|HI^6oK8)`a?C4yECw7cKLiVfK<H^e+`bmxk;|?Qj@H6==k~b z3ZGzwy9C}6;^LcB*>9h7T6k^61oqrqx>m!=<E0*l?{P{0w8ww{FE1D+n0(vE%fXjy zFyAN$(F2jK6s3qq#birl6QDAoo-eNeec8JkDN~?;C3jg5Aew@vQMbc<AJJcV@Shvl zq7X=+gJ!pZ`Y;S8cy*&Gd^slU3h#Un5P!T6&8-9bV%7{avI#U0DcYZ98|H!bWieJC za7ax1^I3EeRPZ#oq2NafO#&ro_gFzsHqR`(tkHJ5!vgA*yf%&x?X`7vLO#e1FAI2! zs&KL+x10qeQ+Nzix(3h=|FSDzLC(#ek;kc(=<No!?!5ne4g3YqeKSBBPXQVv4^b2G z2QX>TYKc!N0_8e#*>goYaG;awl0wf?^8+L-g7!#sy0_(%4fe+caNz7S*~7fN#2+vi zk$UW~Z}`tvl3u}#K^OVoukeDyqU_JA0Qm;nVMXw-H}T;gCO!XpPlwkbtn;7ugcrQ+ z;wD2FBrIlx3R(fihO(1Sa1X8o!2*SuIRnsEvw)Gc$fp{B<f%_L%zD_M$cROGE~E_8 zb0c{OJ%qN;&K_*SwY7q55Qa7Y#yv5(3F-a9NR7A00eI_A%>j=*Q^XPAQ5ep3m6Gee z4;pgSlcTq|lV|$%(lF0|E)D*Y;XSEixC~jd>qUN$4!j03jNf~Z=&pUV1KsTn7{f~- zi*xFnKH?bz>gwXO4I0QkWGM_8X)&-s^l(JkYS`wYfiwX8=x<XUZ_JR88s~#g1{w?t z)nzj*!qGXXQtt|uUH}a#<jbFEZk?0sYvTvCjX7|zs1g4BpBK`sp2t7d0n-xuA@4T> zl(zs7OPDn>YYu|bb*KZ>Q6dYITMAJ0K)F8{Gv-6G14_Y|OsFxDJeR;c%>?<_XF&#p zR?6XUYmkBO#{vec>38M=8sN6?c1*pBTG*`*xK@H_1uXy*paj9*#Rx1!0p>Zi&;Sh8 zGJL7)l2*An7L*|L-}}=CJzq53+LLhvK7i(MU8AsvqK5}Q0YM31=UPA;-OanKU7D){ zhSbnrqqaJbyD8VedUPJ>>OwxruZoaG6iC5y-ksJYvZFycrGX_V8->h`AW|ZlG%Vol zay(<mcXmBDl>W8m06BOj)~l|Zq526?L311!osdtQ1rTf<Mm`?RF`2}!B7TC6dmm5M z^gxbs6dKFhtDX=;2;}hYB9)O!R^i$AYn(N#3;z9N>P$yj)g9H<`#e1!3jg<(kf8$Q z<b6nfRYBotHQW}PuKW&!o6TW0tcqnsal}zyIC%NfRnnei!KBH@kO86$H>YYl{ReQ( zht5a81*!D+p>iOl)2yG=@ETB(xG5KOKiwEXLw{ZjqmUvrykJ(EM_@ey3;_Cb%kDwJ zt@Y)V#iR3JwqgNIg&}??04)-X_o|_zq6r~h@Z5zP=FuXEe!P*3Y3*jy$nOKV(;V*N z4bW&qBK#WW%XEV;ooEqjR>;oU9QpqUj(DO8W^9%f%aQ~){0L}%jhZ3D&-9G!mEt-C z;2s`ZK6wa$pFRuyAda$$2v4n}y_p(cQQUeh<XVgf{?t8aD5|iY84^{fEJFvs;y#+6 zR>k4<4M{5vZ#J-vTEO<KSg?j-4>5OiXJtQ(K_J*3|8pPE9}EUb{A9No&P%~WvV~Ct z2y9|<5hXBmaQk^!R2bwQ@~5+UK_C5hntiy37*sp$<IUe_Dd#QO8vrM5?u%71ce+md z$%zgs;HwGKlOeuIrrYxO1jfIz-@m;`5VCnGTj<e+OBeF%!kgy*w_HYZIo1GSo0t~6 zvEdH@Z=`-X%z*w}HHwi!a)o=zq}G5a-vZh4zg`TC3NtQI@DQy+g|}06pjG`p&y$G% zEy8vpH@JDkr*3X;?uv*+4F<rbYvBtFfu@&>PILH{zd)-$;Y}tTG)+&T2I)sZ7l(lQ z6gyuT%-I_RD=PzJaf|3rfJ%&rX8tGkz+Vg&Ap89SnUDp<Vd(w}3)oKhqb>(3<&eW4 z#FMS7wcQ}}(F802ZB5YaKkX{`<UNQ6Fif&xa*%Wu6u~>IY5u3ZbgDo}w_fOVh^hU# zJiZOMJYOgc`ylosU({S=(hAweLuBfJOf2B*vmg{#p`eF2G>Djm@Dwe4@0$+r+hO>m z6s4e3u3sTyun9p2%fl7)+q--Su1BySb>n}>)v<)GwNpgVfGT#wl$?j?qy~Re=bNtp zV?;K&!>Jw@;LOnhWs^g%j$=Rg9o<Kw6_f=C)67F=VF6r^C>VW#7*UlGm@wpxO5G6! z_9RHEG^`7rwDTA>-8{%A|B?;=Im07(VO`wvNmNb-ABLe@y^xjlA>2zP8#R-mm!k#3 z5j5NVq|kV^3A5mXW<o2WUGU)89@ijWZ2+LEVMvk}>_K$*PWEUdh@BvK{NGVy`QD7n zGnfq_1x!vYrDWMjOa^4P%c^ySWN2bUW%3ei8?nyK96%wq_TZtdO|S9}oI#TkweU&m z(R=cQ_5QV3A*w<L(l`~~+LI(hf{w;vRMEmz-U5g$PA8C#dg1+R%acOeo}WWDf!|RA zo*RQ;f?q+p3?1=#@W5EkT|;>_Q=C&Rjoeb}^Qgv?2LE;4#K0*xz6>V?8oHzj$Cuks z544({x&f5YsQii9(wT<jIDzHqBl|+Us?leZnefPvwQ5cTq}r(>BGBO~21DQ+AESP- z#1Q(1L`{3Hf0h~gLq-to1n4TcYK=e=)`?Ue@s60VLP)WxU%=4h=R?A!u)6m#vZ`Ln zaZ;=Xaj&7%b5I5>8C96@1$!*oGx-&U?>?;SUwV+;nt(QYqo)qdYXvVm+CuU_&l&v@ zaSozZ)7~Sb{Oyj15pQ_xa1~p6aICJg>;vY+TKLy}CeHZ(ZU+$asm*ku6@Mr-koj`` z|5mHJeOU4@ig)V@oIX`h++CM-JC5XFh%~%j0)x8A|9bs@)l&Z|$)p2OFhHuRJvin6 z3S22t|EkB5Oi&NJ$ZB{99^Ijh0iCVOe|^BAuO_4^S#Z|>`2aI2B<&J{=@;nu|1kUh zHL{(79K!(UVY$fb1D!1h>W4W8pP`U@h)l&$6B`*|9D1g}vs(vp7Q*ls5WWRoM4ymV zLnu0pkfRD(z=t!@kb@KSF@`Lw_Z$!<#R?w+<8Rhg7UfiZSayYAxYLIgIgm;UkbfJv zshL6!y0U}dTX_2G)7@EGy^wZ30OR<Q1EecCd_@o^0qlp8D5#b2(c>oK1KQ|#7ZjhF zo(KC;pm#isRSC%S3hJ}1PM_CkCvoVMJGBv4p+XI?PXy2(>aUj`11JSkU~~@w(ln)} zUKxEv?;@}QtQk%HEdWS!5GmKxa&*@r*%<`xjXsbg^5C59hf3F-IuNA}AV)?6X-hzW zv%Py3qG=IgNTBj&2YUAwkbG9{!`;(>Bb{9koGJqUD*#M9fP5zb@$j59Va5os$ivjK zi%q{Cni@QvLt}T~%s%uXMT4n9L;m~bb)X=qz7xkoO*d$5w*{VMz7LsmF<k3TKJe^z zw$c7Uol9ixeS%zjWbPuvr*L{dR3D=>J%JUIr`!)E@$g~>()i{2WWRkCHLV9hI0_0I zf+uA;urI4RAcAiGcea3pXpIR-mR<cN&?kxkQlb^>$eWRa5E2&K(ikSWu#%MHh}~A~ z0N&f(hk$VK;monFi)_i2GJqZK*?d<gn8TXWcUR6-ER$7lGyJ%L`rtb^aofwiwQ~2t zW+%<}&ykX3VqX9jDiSkH@UX*`61%w17(pgDc;Z?LOR7sUBd5XTqcfm$bmyaG+8}bm zHZW5LEl6Zv6i#XUdSi`X)`)AmsrR&`PE$({l8OJdjv_c6O2Cik(4mDcMKZyR>K!|0 z0xOe|PgddY1%NKp3W&22t66L7%QGif2t&ltZ*OoYPyiR<F{Q9usbBScCxqZk=xH%! z-G2iqnOZ%R+dhY#kHdpLiOoI;pTCar5*)AvXpR-swugxd0~Zt?e$gUp;4GI571~xW zkZSq?LNP~HPLP9a8v+B!95w9yvS3#PuF5J6oa)U0Rd#44BDGtp$rA$?&Zc@%9HA@l zpqE$<nNMgxKp4K9`?kyb7y<g*P4NQ$rR`vPKuy=nZo`~j63vKwaiJ~R2?l?op>E_b z0GEb{Uqh<VWg0PBm~_P{uVgVyys2pW_-0(0jt0Tp2PkhV?{H!=phdD0)zJQ<bvx~y z(Ff&DGDuEy8V9S~KXi&bMcFZw9~EC7!zy?9EJ40ij^~zEZq%VhT>v18)h()aAyztD z4x0p=gJEPO^mkGgp)T|vw}R3j)t4RxSqcmH0g#-6*6rF~K%~KB(DWJha62QA7yiG( zGs(uepu{KlVW}lBPGetKMliGlArSC#VaUWF$_B<=p|HzG2op#(vjBXqifuYYE!cMu z_3%{qw34+ANWQi<N1zhQ1PThWYQKV2hFqf{g}&jwZI9Y?6#~?Q_uE&1VX)R)Vo--o z!|DbjecT1Z9xtgkGC<$^K4PiCrsgPYqO;9*|G%9VEt*vH?d?D`iKjv;^1Jf5JavF$ zY$hdh0@yE)r>W7g;gflBcVbJqc15tZAMx@GA?272J;5Y}#>A4a<mwdT#k~}8v>Ybm z=^-y9s{$F?fez1M*)WZnd=R{)PYNB?zhALhx9><k834;H7!ws4+OMFDMp;_XYJ=$o zK|4i>Aq!U^8?N%#WVypW;SccDKO`Sr4W8{lAP&v2>-ck?OwbD>n>FMZya1v8uxL4l zMqyRzPl0{Ovb;O=99DNwLxkXU49j!V*1mY;qzsK^ngQhe!$*;9_RoHV{%mlFgHNh` z4J-I8Abo#!`A-&vt>I)LnzdRC@>9|+lC{Cn`3crU3mX__rN-mmU|G9Zmm4;nL7shx zD@q-$IL`%gqhT^%GUYFdg`x`B8w#RwqSy@==W+D(&`>inrI*P1hI$6>Nb}##tG}*; z_{73vNJ3_K#F`<@FAc{VmLr#YE3O~p-$8z@6VJhR54v{fKtq7ZtLvs?S<ljLBwKLm zEJhy-{`J`YL!uYv?Tbe$$CQ7ijA3$a-)emEu#mw6c$^hp0EQL=xGA^;)Ce~%!I$?i zXB;!Vf4K<8$CoWaaxQ%Oyiz#o?jn#Y{)|8KCpaV~zM05FaV$gl>g(SSa93=$%*!cz zA$RZ`TKjmFrS`5^OMxin5io$=UU71=$$cybVpqJ@VL}K3>Vf0RwO^1C8LO%(fg32@ zJqOPy?a6-Jf%0__u>*mgo$7YCi0y00)7h4lsZVA|;N+}{#>)+_BftpoxOIq5PQI+3 zFO`I}KqPL~osK~m#lB#=F^%&?xTm)k5#Pr3lnm)F?`3-#9s)BG>=eFr-Q^mu596am z>@rU_lA(fA!)~k3<3DoI)IqW8c5HuBa_$8Yz2xS1qCBI0?X?Y{CT>;5G0RIjFF;a) z%g!ed8+<kA1XHZB*YshxOKCp(gZG9NX!bo$ZMvkFvV?CGLGbjT`?QSa?22u~@lWB6 z7KmMpBIK3V{<w@rd&#}=sh`F;-$8sU#6`lF-K6*P)Y_%Q7uMSq1llE{mvtuA(y%Yn zZXe*e{pufvtmj(c#5_XJv@VPy4{-2L+opN2D=<YMiefCBL=!$g6$UmWD?bPFZ0CQi zguS~t{E;+xaEZqeMZq!5dd==0485f#Fr=VK7>ind28Yy6pSU@$T^Sd4b8%{fQ9Io^ z5<!Y%Mgt_*$drLvfc#~w;%$f;&!Z;~r|hL8UX9n-Ij34n;79s;1X9dRF)&A8jwi{~ zcZFV5V!ZulmIpv0Hg@+Nig|md6*RFHF!)YbMB=uIj@YKtjT+LU3=0~(HbSJa;&HfY zr@<NT2XwwDG;LiFDH$LhyP1@}<tpoBx-1>}jdO(WK!7s<#(KY)<^(sCy@qD`?q-in zga-TEyjcme0}-Ig4zo=Xk`LU9$0?hv!4=6vg-I<5T5P>J>l4Q7ks=;Tz`WR|k@N}E zmT==YIOyMv|5(AU{gH5F_)NlOwF1e<`JImDeK}|l<bg;H$lrJE8c9oc^BmvLLH85A zWM)k$Z_ACKPCT{C3~hDpt5(&<ct{>c$QwkKJ|0IgIDQpVT$`7m_!nL-n{mHfjtg5V z%$4Qb@prylg9+srvbx|F!XtJD6%hDhwfp7{+lSD--*6y{rD{H)-`oa(sN$pzq<|j5 zxKhy>qtFc8AiIK<1hk6fj3(ZgcVY;$+`yZ&n{1s_dyimjZ>4Ph@g%=#l3e2a6Sy+C z;<!4cEYBCw#JyFZKYwY6a~i`N#t{=b#;+NGL~2aUDcsjbWnoKHwnkVGwG&?@$|c++ zo`K`CF{hE9m(hG1Xd{*7A!W2C2DLZJj)gvw6DBd=L9n&^m^vFc=^`O1#kGgO16x5I z<>Y!+%&7K`*agja>sXVR+I<9cViQo$597>@Z4wfGaq%Vj3bpsv@;F2INQ5dUz!KFz zz?i{9yN{{3Y1`ZImION41mB`q<34OsR;%JuaRti)nP;l;tZ4F$KG1=bd3C&#Yi!LX zxKuOzVu;~3a&zkrY>yOe-uo;?v$gXIDmQ|3ukktuXM%oXU6P#FvNFe{)_o0;-`WAy zJ&l%er@Ky9`mmdjq0qjIlLgf9YrRsu?K^dN>p(l4r!|1XV$ZH_Zd7Qz^sCFWg{A!h zD=LxoHRzyhj3bi<XWuK`CFXuc6_-Lz4^H#iX!9-`SF(+-)?AIdmHY@mk=@lA<EKqa z>gh4g2e`|94o}A0*WuV7C&wjxu;QHL^}_H|9<DHfpeH~ZRr19(dE<K%?vr~7#F1TZ z47v3`9?4Oj42_yG5IJfJK<%!uaHM(Ansp}F1Gpd1`%SO(PdP2&;2vP(HMG589&dUT z_#o;4uCB_WrzLN!at4?{)x7{8L*`!#3>CM^nghIwjS4BZb@g6o0qylIX*zZCdbID= zRv!)d43?TRb7xrOw>DZ-O0>;CPKR#9ZanG4StL?xMkcfeI;(ti(wF+C`c^%U9vm!H ztsW3<EbGEQ=f<uz82fad%L!uDEsOWesF_~BeJ`Qyz#G8AGlxYGu>T(YqxK?k0A^y! zr(yHtpov1Zm|A2Qv=ewCO2AdJ?d3HkaLZubect9f;^QdOKky^`hO>^31l6?+1<vQB zEpfliWX`pXEIvA>)F^;FUywg<sKm0Ph@r7hE?7)1aj`b?a#a3Stmb;ww0X+&^)-&> zK3YRnkmaoAoosAXXByO}dbUQma@C<>6MNi3(9ecxf5^D~NgjJ~-TpoHHeNi#BW#I* zs^T4$5`**>U&<4st{FZ$sOGqPsryp^1LHP1<=s>d`X`Bj;WuCD`z<|V;l4CJJ>g5D zpKVERLVIz{C!mb7l<xV6-&=nY2Cr09gWiockt42*h&(AF|HTrB03vwfKd(m-eY0L^ z*j6W})dhzLWGAwA)9=Z%u#k%(N2Xv9?K0jT-U=>f+6=u3z4;iowQZ9-){}Vx(x+JY z-|upYr;0Dt1)Ohl-n$4Er}F{{_@WFutrbLAs-H7NH3(`5n4SR~xY2uev!2w+M;pu8 z$J*Sxw;qpqr@lOG9c$;#W|P@F#c=%~&Y-=Exns*b->toI?q|LxL5RHzujGih5eF^F zQ<BcnJzDK7u));<)<_kBdHhC9ZwHsY9$ybu7?s*OhQxU2RtWb~9hif?TRGN8EJ+ee z^wE~C%@_--(CrfLiaJis<#^KCMj*58tm7@>MthT(4AIDE9>>yx=38JjweWGOD?<W9 z@!%rY6iON|Bqmra;naaATtlNKov%A}(%^$&R42Xx?VKUarkf2F-zCBLk1q_HcUtqt z&k<tV(!}3dQm>u-mUgf+Ot{k&Ae4g%I^h(*6};ru(=;8dA11=$6w0fL6<XuQM1{Y9 zXKA2s9p+t5&(VrsGH37!3Hcb;TYtkV-Z>Qat#fA|`98b#eE-4QZp$Yd5hLLunw#U# z+{b?^>f$#Acur#-?9w(YkK0khi6L>OLT@+x*5x+gCG{Suiyd>P_wSBuA-d3TQ?=4M z)27H%!#d+<oy74L`xln{xXGoK_$CP$YjuVkg<m7pJ#>llE9Bvbr%d4H-mv33veV?U zNgv`#<5rApMm^nks~e1iKOR~n!f`84<Jm;wKx}^XS;M*Wp5xv(UsQj<)5cSvz<CfG zkXNP8#tAt$b@bK!kLol>Sq)h-=MY|>7o*Qd%j#Kot)q6_8-E1PfWrF$g&~P~kj=?P zqSEF!%jKztw;{PC7Vynp_93B?H^+Uz8&0QAn>y+<jppu-Jdb2LCgmlRegwYErS$6a zcsxDc@G+l25^6E7I5~Yv(m}f2(fU9V?&6lK$6kW?WlswuInz>w#jcI_2=@uDFK)29 z{LL0T@&p1}BHRRAGd`jRdbnP^F^L1AkNCYPbt!jR`EmLCJqYg;=_)eIhBeH2LStm1 zk<#in34g7y*V`kZOuTe&=_f|l@-3qBs$(zapBCd`;VF9*c`+<qU-yauNuMy2f2?&r zyT_#^dUHl`#uwx2gl;SR&O+uv8&7)cik;YSzvCX|%jWrEA4x+mAK}blaK470DZ@t@ z>s5tE2q{y&k7_IxNv$mv??dG+B27E0wBL;OlRg3;^OD|0W}L<w=N(Ocmj`W+eeHEj zq-AlZYpV?3V2Ui!yd&Yj*Ysx=`84gHT7>h@gitJU#mm)74H=3(4xyc!!isMq9<f{b zG&jNUX2YxNW#^S9|FFn~r6JqQve3mX?L2t=7YiQ<RHV2~ULz!pKf3;=x5Z}MuA}<2 z@P`V^;+mbiBdxCW)6d2w882;C<Oh55WcuBExwyr)q)YN-WlMn6r=^B#a#&-@@2<Vi z*WIJHj<i<`RIN}i2{pZZWG0;A)`<JLZ0X5(eHHcr(~^equ+tkVo_*=D#|5zmB%9hq zZmXWh4)*!5D}JROFg<CqZO4=C_Y9#~ywK#8uC^ZZcqz{2Hf~y3-;>UB2fs8L_pmaQ zpRAURuYTI8H}>nq9!%Vh+6c7xr*wmVC)oqsMI?G6;e;qY>2qZoVh7@rL{o$zgqIZ< zWtv52#NUc8)!O0dCXP9OZ!)~w08K0*27EC!F_P?uhLq;<)_#P3_x!t}_8$DelAkA0 z2@{O7u%%IPn5Q45n!9*!ybMdqM^<?j;e<WK7Fs#i88aX7VVryvGx3!rs@4b0bPZ&q zn{4o~cEkw*IuM8-_c{{3N9!|IN?4(Ay6tK$BVlZQR;q;=UO4Z=d8VV6cUtyW&f`Vl z65;XUb>g0PW?Ljs=c!R%66%gnCImRYz$1|^Y{Tzj_%xBEO)OudGTllQj=KD1X(x$6 z?GOT${CV;m45b16W-O=3<)+Zw;0>=eZ|fIZ+_<sMdst<km$y^>jpXHv$+btDU7M-^ zJRJfi*|<u6g@{kMVBC1)PAk`h(A2rSVINzcFswS!bFJIF@>r?L{$6_%!XeC|^qWSn zeJYg`6~o(?$4YZU3rReHkoeqkT3JP^X}#Z3m;h@hla-gOLd`rVh<G!mQ#@DCE!#Oq zqr>>c+7jRUKxB<wb%#Zvf1^Njrqv8D`}*lz9bFoW3g>uJuG_p+<{<aoTv-h0WQ*tO zsj)G1uXwmGMA)@TZR2J_&;e_YaPI(1__#6`$#<{bcGtSOhax6+cP3fdL`T{V_$ox) zs5g0PciPvt=2xtI3_1R;nVF=FIT|xIDYYSZDFQ8f+5fFKC;evJO*j>Bg-VIUSI$M@ zbUVeSDwN4^+P%lEOBGLQy^5>dcc$j-X6t$%_F$lkZFAL9-^J3CamS-1ba0&566i6> z%1;$%w}AEOM5)O_jTfHUL9fjaOo#hUGxBD17&A*xCl{@Lq7K_!;uvNrV9DQ|-rTUd z|KQ@y`<8c$MT_*Fyk+Hm@78J8XIzzkfzVA-XuW2q*3fIbapSv50rC7-=%ml6`1_R9 z?3}0~zDn}@MBgP$W}#!UW+W%(2<Bqg&4>jOd9S^9$D#~xkzS`|3&k7gP$X)}qc6o@ z=i@&n%c2~U5}Es=>2rEi?rZCiu2&1o+qghZc@od}t3n>m1;KmFt#by|UWUi1>sGxx zd2$3wukeyl4Zihy=}vo*;rnDkty;Qi+AoIRAt4Jy*tYZU4t7RZMG8Ey7D=4ke#bit zVk)tQ%_GO#$`h%pQ{yp_qmKzaR`_vU6HiWAOqS-crz<$;98(CT*lA?{X+ys>!BugC zLm5}tst_wh=lVfh;+UP}OzSk`N7r-uLJC(NjXYivF3|a9=vp&3<r>%K{`d2<wY5Jr zPG@>Zy<(0O>%|gdWbQUDEM??;_b&L}i}f_+aw4a$o~S22k8X)69V4qvxfnd^>=Ue9 z^X8Q3sRfC&OaTS|+G4zrzAMLgy%dV?j*w`Xb<f}ys^g3jv){&hvKhk}U>&IMe^P)& z67LKj8J1_EIHU4J(Fw2I0M5uA)6=(KtFheCVA|=e_Vl!3y}hHFu8()ZH2iimDQWk+ z*x$s0irrF|DY0~q){2Nptp|<ENnEO7&tY^j?~;r%D$Ft(#!GRsatd|wG}&uiPJHwt zP<@EWnkIpHHHEnOM3%Pm8=tq|rAAsh^#==QllM5Ae7AU=-IezhG0n@9PD;t=mG4S6 z2-{?)%_NP5mznqDi0KZQiD`-HiHQ!8YaZBU@)Zld92YgZ6wg&F!NQ&PbFy-TciCg5 zYNg`s3PmBy)M|Ux3TFJ4wfsH#6YLh2TjntRgE*=a_vm$tIKJXM+KUq&#WJ}aTnYR! zA|_53QUaTZBMR>5(yJs_=uzQ_N$po+Vd{M1sI-IyxK8A`MS1mh7&C10oZtO0)wirM zUU?~ca`@^7{m*KNkmH?`bXdhr#?K5p&88~<4_)USj&<Mv{}SbF*?VP|J<2E}BpI2f z2-&jBEL%8BMubjLA{iN($;wJbMxCPUkkd%WDkJOndUuWc{{6nc@A=1d9QS=(N0&~Y z&-?uv&*$Sw+<w-c6uggBZD*U5U=>&s%z7YkWq_P?Xv~}PxBe14uDw%Li&tv%y()E0 zMU8094U<DFzEiu0&HddD!`q5JJXg0avYBZGiinptS1O6!pkir}{wCC#q=t=VLmt7A zZM4!Jk3r9cH=7l6`axl95ai4&F?izik6a+*5;k&FKMmVjgmp9up)RFt)SXd3uG!4B zm)J%rqff;oZyOzRKlWD4hS9)zShL9caI$h6pQgh(yF}^!fI-Wz@&=qNP6`)^rK2vR zHeY^3&Vn+yRx+t`ma2W^$Rqm|zK$VR9bFb_I4(NHn0katcLW3$=49{Gi7@&OxB@^7 zk}Kvk^Io!bxVRUJ0*wNVroC@A0q)B|QAPebbTM-NGk9S0Z^$ah#RxKC2Ks}|&#dI5 z@#HG}1ir`4-*3CuTZQZx$KqvA=I%ivv%oJ(vsaWG_H3$sQ+2jnjarLqz!S(vd)SjG z@A+QJ#qkQo#@tUJyq6@%5jWLeTPtg`clh@dStwGBkS7iBm(yX%Jr85NQMwfxz=r3( zVJ*U~leWX*aQkem&B2k!NZnMz$H?Dh!$B^Magn{V)w!wTaN&5zbkyX>(S)4J*gXku ziS(~uq|J-<xpp1=ja^*06|Clxuz)$4Yc}=rGf3ZpIYMv6_31nvC@__#=*i&Tnv^8i zGY1eh2P&>x1j`j|fIDNEaF9W4F=%-qDzQm#iHTbaI?pdsyZb|rJzT>PTwv0&HM(b) zeqFkuK5GnafN<Q_mVd;|s6cDXVrmpW42b0CC|2HkY$cl}r)_AtDQ>oHb}B5IzjWQX zqFV6a?^#LQdTSC1!%s;mH!fN_G5V$?Gi<b{m<Vm43oz=>ebDZo&D3?j+kRsIqT`nn zyRkOP-_Bc}d&TmV+G@WQg`$D48fD8ij*Zj}SB&!^b;7n$B~oTn_Lqu~D3hFGXTdVI z+?nsG#=BCHQ~6L2Q&Cd2P!3bB7c0I<Yc0_ZJtiQ&!Hi|1-curq{VuV<9XsvcD5ET` zEI=aG``!<OB4wwoD2G6wXcY+kQ6m9&4;xdeV9qi-?z0$RZX>41PvF00{blaV*HeVA z#?WeruEtH0Uc&wqUpTRse`s19*0{6vbXhg~W5`<XQbu_%nHW=SHkH7CM_c)X`614e zvj;<MNY1QA1&;k9O_x|;TM&%>Y9DiCFZ~eFU5NOqw1_lKE`~so&cFF#$*NXp+Gjas zYy;<8v)^1$NwhU(+N0CBW$CMTadc~m&Wo_Vj-8c&)VIIG-0<6z{maHN!bRb(FGbip zN-XOxr*`<aOygQTw0zh%H9H(e_*Wyg?bwZ#je1oZG#GVMPqg0Nj>e?%o7*okP5ZAV ztc3^fs|l|uAM-Q-q1bNn^wMu%p|q8;QTo_@MIn9fh@q5hFCG%1by!QVX>y;EA3s%^ z()VFHK3MQgiLL321Y)cG@pZEmpI)l1*W>m(N0t><{Q3!Fk{@pPUU`w=T9W4SP%+ZD zrNnmoP5oYTn%zsG(<L0N&Z`eyp+0@ItKuU>nEbUYnMSq~YZYuPYUR7QOS8!qpuKUE zP`BdeBh-37@W{@WW-<{*&Zfz2L_C5)g6sb>NZ6SfqkTMTG*>)4AZb#UlB}#bVfHn2 z3=lCs4~sKh=6_sxTqDxR6_fn=cv4HGtxmuz9<2l5_%+-$O|9=Bke#-5PnTx!k(_EC zT^8DenHQo2{}jWQ(5{9=O;;JG)z6<Gd74j0B###Dd@M~6m9ankPz3&-?R{wa3WI}v zT-3YtuCZn6voR(gqI0)*tL2ih(){rcGEeVxY<%JqkyAx`E{i$r(+HmZDQBsv_4PDm z=uWwuVME?_qdXYDZz+DxS+>xT|Mei;tCPE9mrU>DhdYWSGRe<N<6GMl9g^R3yuoT2 z#AzH;KjWBJnd_k)gE9g>&zRA2{<*m$hW;ybL9}u1f0I20SMP7DQc>fr7X6qdaN=?0 zYL0i3*Sn)?>@SV-pH~d3Y7f5`<{XC2`3P0CJGV%-BEz@i=bwvY`*B^E9(Nfr&Gs1| zzou*yYPcG<mMY?hTsz@8Uc(tQ!?0bM*(>;EfE`wV3$`su410xwpZBCk5wzT>Uf*p> z`&$qG9}N|abTb7clXxZL-kq>Kiq*ze`Q3L?k_}Ah@5xTe7s?IDD%IcNFpBF=OqMlV z54)=v1pjclj2;K{>EaapR-;-WSogf6AAVkYWQ;<)7V|HipVXfY(S0dJ>q=1aJkjxe z1vc|~3M5dtDQx2;s!TM!R@Dr)rmclf7V!0XeE(!_tWP>v+<hK@L%=>XpG;Ogi&vz; zmGJp<WZT{X|EkjXe9nyWbY9(w%qR4<Wd=v5?%{(MclqcB0xrQxz2x=&RNp#>P8)vk zP!wv5c-WjoQ@nC(-L{xOkP1tJVL{c6#}9k!ST||D_y}1fXPo*SIGl4f%L8CDVj$03 zNNQd`*t{28uMG|r1V9zWCHF>@TxNd>S*IxQAy!)KfDj=o=T>VMTTCtv21oK7Z<Arc zTNFk(Oq60CrHcr55*3Oso3VJo<6lOTjTc@qOgS;t>;hpugfDG!#nflC-z5|A?eBAv zG#`{#b<(v*)NL`O8H73&9!F*;#CPAR`t!QM3zr$<q%UxB#tg3*ykk)P5fi<1E9nRE z{HCSIhnOSjLRVgb@N{CfJyG~^ta#JO46|aP@2bmkiCko>A&yUB$4Bkl^)$q&4sEk$ z{<32IRbhH0I(^Fd>Kc?QFa<&p$@=2c>$2G_O0J)#&(%}iqQ;$9)dkzI6%sQbB~aEZ z3X%qPVeNq;Y_WuepaVw@O#FlAz)v5bZ6p#+p{uGHw|B@g7@C@OKk&PRv!gfSxyJnM z1TpPYhc$7)U8QkLO2K}t6j`5ui8Z}DEHg9S6xp^MMSEi0^ICT|?glTv)7y?Vrg=RG z6!}5(tH%$QKT{e1;~asATL9I>OIXXUtB-)7BVY(L4kakO0%B(a6`vVhNIgumwKg}< zV>-Ax+ea|XbQ!4`FwN+CbUV;i`;zwADyLWtLv8IhTlC!LqZb89Hs(--+{2zJJbfdm zoXb$Am}%hzs3jDK#!mH!@PVRyhdlsT9zk-?*ewcAX3}+_xvf0NIbT<JS$(k|oHFK- z)$_MPuR&a<3j9q)UNL9~F&0_7M3$UtsRUEz?*+4h=qm9M{Aq6|jv;H8=op(aw(M78 zA%Z<jNS56C-3iiHW9`ghN|dHN>{z3Eo1^_BE^O)hTg7Ew+_k3JQy^#UwB%l0`RpFe zH0Vh0BsRH#7I_r_!#=Z=jdf%6xW_NTw>jNdLDigA{Nx?d$io_3fpCJ8hu;HLPnMFE zks^Gg4^zHTm5EjGdtRi}_8@t;D*N#a&D?e5xZTE8;_^XM_|vXNTlvxtn|h3Oa((DL z6?-r|jtZmuM_&fUe1_wAj{i}olEyKu3tO-n`5ocBSO-!Pf{t=BOBlSW>@L#Zm+W4% zdYS_%LK5kIcUWT{|1+F;myFVOkZ#A6!r-nuqU=$TknKZ5p)Z~UdGmtyGF1>R{%qA{ zY*<Me#kaz|=l$D0_>(r9yUJ*;3PnAOoGpC)fdk~)T+h|;FfeP^%)5XYt&ERuNGML| zinBRS#*@xrn2o)+oCNxt4I<`}=fu0O{7SfR(onPy3lGHl>g!#G_$L%8LtuHcWPgP; z#4Ndm?mE_ApR8S-X5ommc1=J1Y}H(8M~#Ok?9PxMb=1D`f`CcY!I;JS5gS#@^8o2z z%^wE{#t(kG7vb<swUmO7eY2HNCdo<3Ys*^$%+Ok7RtXyzb0>XVW)AzkcGJSA+?k|C zUrTmjb(+AzK%!^92FXfa*AB?=nUw$sLM3f3t?!-tSAP-%Z7$hdTNcui&U~c~S^=|M z>Zx-NdQYU7K?p^bd9uc>PRtBQisXbQBbCf8K<yYHkDa4V1@A}q+e^wrPuaBG0$@S< z4K*J(YuJ@dS9i~Oy5G&D%|k9|*q@!o&OGwU?LM_(Wp=Nm1{9T>HAP;*84|C+2cdA) z2y{anMK&&A2J{%YTnLH+1%>kmq#6y`jX-eCA#IxyDK66chUg&7>J>o~x1Ob8^yg6} zV$zAQO<G9jRN_fL7BU5-fB712vrKtmx<_UE(ycu~vb`hI*aii*zp=U)h~m?Jd-SRt zJJ_g1a=!8GA_~(&7Syfj{;uW3V-LO)avUl&bv1eIb?4jEPp5P4<>KUdBSzpi=Bca! zl$pE>8>}4aH=F%1!I-mQktVt`?Q1CwB}Jt5xK6oL%H%%HJzA5(dyf+)6=HO}QXHuF zcs8?tJz=z}+AKvbcm4Ie6vYEb0_1mtxT?GZ3N`z+#V}V8aGq0!Q*`A@aZn*U&z|S+ z+avOPZ5pKn4f7^eY>MSyT}9vFKOc2-P&?6tDw5PZQ;qUFtKOh?w%yPk6%b&;zGA+l zN~!t!ihww*!Ku(%9ASM&m>=fplBnkyz|>tf?QYsZ<KBy6?^qAx@VI2G1vP6g2+b;V z&T0;s4NmNrZq#aQ{YD;w3Cw*LFdo5Qa|Gk5s$0@lzEDX#TF-S2M0)IVrRMO~M$HSz zn9~?mlD-60$!g#EJ#C*o%jB&B#{|v@7+_K{VFP@0FR;}fWTSvXn23#vq)Z5WmbHM6 zbr8P>eM{YKrt>Eq##O?jvtA(~BM@q|8eW`CRQW9Sxf1(Z|F&iqD_d(geFt{$0cnyO zQy<3!l*`}x$!5<X(%7F5IT=M~g+@pi{12pGCQ_xdt(?$}Q)g^tO~+n?n&6@NNA*M2 zdFqZUN{nYfhf&m?SsgE+lXuzoaEQ?Cv6>83@^#oD7p-+AO4W9<X}nXr%Y;qn9(mZ_ zH`a1Gti30vUz$Ws*);TAqv4b*uQAVkySf7;79`k4Y#z2A^mJ)O_)GQnVdWjT{F)#V zTV=b!pWVGlV)#`)`!Jg~)u9VE)W5{{#@vJr=5`Wg0L^_h)u-A~RwM&s=eq){4gYof z#Czz<C{@U|d_m2)qro@kSaRBoONP{+KJq0U!;2*d7*A30HrehN3P{K<jf*SEwD)}r zIYzFS+#2$$r~P5Ov2x=vV_WJiuxqq|?QL`6-uL%U8&Bq0nwmMb*12=9+g>~HgV=ti z(QHc0P9FQEG*G}E<C5|0*@K}O>v~_|n%>I8BA8N4Msh}C5w`n$(P~zKnBi+|-}%7$ z9GNM3uC8oqX(tCwMy+4hpbFlpbq`27qXIwdpAQdT^egcj=byjI#0BpBc)hUmWPgE9 znu0lwGFlJ{fy{G&(j@nc)_<?AIR=odepsf?3wt=KXnxb66XG<7V=r*oU)z{mD!J$Z zczn%s%TpAC>xyFc+;`H-y8_ZaXNwPJS$lsx*FX7PIJ<!kJ4h|ly}AY~%*A2^Rrw`V zm9j@aL}T%SuGaB(XU<QP{>mDw_-*1u6s1)5jhYh9Jx?GY*=ViwB8i2vZLd0=uwoh} zRg?DzGF*Umband$3@$E$MErURYpE;zc5h&8G5VPHeXPNuF6I=iYcBbI|0<Z{xvIxO zPtx|fQ9QfFsAV5`rGW;Y-E}I27EH?Epqu*o1>q}qy1@$Qzpln&JxI0-ac4n?lr^Vr zKK&(PH3|udUtNP8<*8FTDS4=?sfEnFKB@+tp&>0rtGV~7@<aQ~uA$Vv?PEE19BTKN zCtc&JsPs#t12d>kg5p8JLg4Eh=*GXh-qiVpi=uzm`B-CY0Q9a!Ta$URjk=-6F+I7K z{&PLxcb}?221k%>7r?%T-HRrhT7ZV9r!l$J&5pelpGW}lP^p~nGOl-Z*C()3y`$tQ zwanQwS7WGV@A@55cK_$(iNh&#lCk~z7Sn3XVZk(du%(Ofq3t8_mK79|K}a79TPjnH zq93?R#l5wIfJ$eY#8cZUZ9$G1z?vW~3G>&M)jCLd--Nr|1=iwH;Jiw^19K&ws=osj ztRWkMea8^)%d&HnWyQQMyoZr-jbKzAyc>iVS7}YU8-FqNWPQ^I@d<P>ys-y_LoT;` zwkhMk8icGb2;^1MeG*D3b}=N<Vm}`0t>>-Lf5G%ij`4w^tFOm4%BZr(rIKzY3icIN zjvrKvc$W7H;<|$-nZNSz8<p+a)%P<9xL-c7(%gL~X|);|9%)2Fv8%W3IyF1i<We=v zWA=rJgb0t)+?CiB-Yb?a+#!1h#L0?T1p1<gD%XK<5bF3EimZ(4%Xcn4TYgBq&|z8L zI?E$-Wa=7k%4CvffXrnc-6>y73!nGcx1}jI%$?Ki<)JLI#M-G>k?(e&wWkE<>*X*1 zdER*3ndP0Id={{1=*B%+|GoVmaB9+PXR;uRlD8iA1cwces{qUQv;)LTP{_`{KZw+m z1z*@46Z%w*o5Wu-ll2(K&9!AD;+CXa_A_0#>6|g+G)BHO1|QuEXWjP^uSTmuW!)Qf z=J-#`=xDBkEqj@0G9)eFP7VmT?^u1jsS@x4uAp>MP-yEnf-hxjMV0D+O(=4{x=XZl zAmZ#}i04tfqwUM(VI5VjHkj$HCT!pGX(#wfs#e}(8g&hQwlklpn+!fxdplEnaYz<i zin7ED63ESDm)ahRT6|-NZvQ#J|98|zAxehsZ<A8Q=l?Xg!J<<!g_{4wN1gEm6438x zW27u7UT*dbPkdJ;acx*;w!b9fVv-nV8IR+m|Iz1mL)y$BV+RtnGo0*NI$}0PIB7&{ z+(ajUMKb@MYkG5M!_ScDRo9}7;}Q7<aQ^)i@dB<}CKBJNU=K<n_e{FL8^LBerKLvs zwP9jUsNIK@0Tr7TZhq~QZ$%N)#VPI@ksKf`T!@9JmdzVqshkxzp3)JRuDa%jn<mTg z@6-x%MMQ}tT;R)Lp44~+4VdreB$9t^XK_ujVxF)z8flcSM4mPUyrGtK-o>hBFAF!D zK<uOap@m*vFEch-dh8J=Yvgi_(>L%6`pIZKuYl@m_lzC=*9C<0S<}mH_q=T6;w=a0 znWgETi!n!Uc%>4-C=vJIY`U|A63Z|$RO;X=L$&@n%+FCPW;b)KXDUBnnfGzTT;z4q zs!&hh+mOpe!b4-VPrg`3x=ydlZ$8=JvV}4{*@=<SCqmuu3t_q4XS<lkf>Ie+Qd?Ji zS(CJdL<DcZQ%o(n-J;3oFr)Q229!XTe+)alM@99YPdshcjSARU!78t4<6dtKIE!CF zw<g^(1U|SKgViSZEBiwo@&Y`x>B31yk3j|g8Bq$q0>9b0)+CV<rYJQEMM6q*AZXjJ z(-f)V`Ptb6s1kON7bk=lc}<yuF^EmZ?HGd0URZ`>n(S*+L;`!^`HUmvM$N!J6Z;E4 z`=_MfQ6tR<>j1)!_{~~RSpe@CTGAW9&=`dJ(iQCF3I`V9JS~8qBi%lgeUP@u<W+m$ zTd>%9voG(*Bj0u#L_X5ud|B(ZS552NQP_5n2g=U;!}s~?I0fT4oZ^212*8nztPkcN z|ImZsg?j<b1Y|5}BRq4hu()9b<W3a>5@rwzJbNU(@}^8dHCz7G<jq$g_}(q&<*T$~ zvH+xwHS!sNM__ZSu#+qwfg1Efv8~pRe{CHG7Tloe7m)GumGRhp)etKj<N9P<7Y3ds zzt<Mpwo)$rV>Cp`Sm1n^jR`9xNrtG;Ilg?eM*2)k!UDX@X#^{PZHy#_P3xtjyv*PC zHt3Nn0}MM$2YXT1)TRqo)h+k3gHU!yEzk^AeR~##Oc030;~NzZuA2dH&Rhjk@=Aj6 z;GIRELOJ4g#%*#7*^lFbo6XJ{N7SLU*qVrx<?|8Qd<zeb_JM-?$d>UJP2;a$&wttc zb~_I+Jr>!%YML?F{Nn77PUQNNv@U_1oVV=^eYEP+%%AUoE%+y;(En%NwS(D=Ki$#? z@|UY{W0b<BeJ7FcN_0fGeo`^sU1ew0zGew7Dli!>-)86KD%tp7USiGv67uaS1j0-@ z?}-Ealv>t`py#^&<qYrwDFiWc3_`}1NX4eU2xyr31fnMylhrIZrDlZX5Z@AID2hGk z!XJCE!BA-(E%?@9qXa^(DKu_^i+Hbqrzj}0NBh+8ca%GD4#SKeERl~E_VHi0YkyDz zUXp(J@dGR{p)gideT^jf9AFunnYABsi4yE`IMWRwh@(b>p~cr<B>3`GE+9Sh_Sp1T zq%=4fPC?Mvb$4?B(xISK`21hdL)RWjx$ayQyu$O`u8o!*jFkV+#MR0yd?^Q*K*!*) zHF<reo3ALU_^!>>QwOt4xCRo`_9?dXCh6dpPUYz(R3nz^AMV{3m}kUZ(Wlbfd%<Tt zV%LI_>gE3{zB(mHr>^l+RO+aE{7G0Vy#{sfJXDQ;(AfEg;KI2{ks({M4y!2y2pZA1 zf$R+PtZHx=D^mGF-9KM7ow@>h6B=x@zOd$94QGlev!@c#Pw@%#d><A7KXe7)Pv*ic zJikzpCD0FPQpPZuknh|E(Ip6=uCmwZ&uG}W+-i83@EW<15P0l03T_9#x_L;)>Kjia z%Nvz4%BK>OcKY-V;dB7Q^4Hr9$7_#D3E7n?hsnpRVui*K>A_KvX_<*yTSb>oB^Tgd zn9x8j4+%OL2Skv1vdh7;Nr6-Tvl)`ERUL6y)6_K2yOeAI1_%LD**9EnS+_-3ib59< z!$5IwN2>hm;H)EyFdnKc#aljD$bIw#pjkz+-!GM4e5ZNrH<B)YwpF^t`~`|cr^$|o zYugjzT0T00wu6|k1m5!Z)%|LDo|v0x4pzinl|uWk9>0kpo7<+d*tRWRp|*cu9mKOP z;22Thy{v5Q5~oaidJ~y34{0&J1+t+!2AWaM!Jqn7%v#3?>ieY=B?(TH+NIGTg8TuF zsLhJn{dC2{K5{-TKYLlQ$sSy)9pgw0I!umzWe#v*_G%9sg@HXocBaGDjl_ZTV(Ib( zyZX?ClRs=Y-q>iDiTv|@Qpw6@uRL>RZ>H6n^p-lFw+=<S+&lQX<8S~vIjVO=!&pPm zB2>?0OCn9cFdg?oi-+K0a+Ky#DnK{wKbeHddgf+lap47991MnGCx&n!X_?|hf-ByX zk4ojIF4|g9_I$o3m->C+*vag6d|qG98&|E+{3Y6kf4`X&_7*DejW1tcY94qh$ws{A zUQ)Pz?zw!nJol}u0rBqYE!u=rF*L+S(bt#Ri|3&Vyp4cvvXao5QhHW(3nbmBFI(S+ z{%Gr<B%Fei9rn=rF6Mtgq+!<(#~GH|$Y0p5P%yq=^piL7kw#PM$9%H#UcnhymvZB+ zOKg?(0Q+81ehV!J9Y&T)xH1Drll&9!`@pR<qMtPO>l_*&dv<u}|LZK`@;J@Nk9Yv{ z$PdN=#Ogy@U`1uGUK{3gK|RqZc@Xk^-$prV_A2m5a(!~?FHSeQi<B#H$JrqwwNd7X zM~Cnq`#V`DYd(bjMd%3Ve0v0LlA?GrSh2IZWl)y`kpixwtF;jR)u$<1`-vUEP(|0^ zVtjQEQs7Z$V^I#uXh5iB_Hwv9df9{4t$>U@SFa?{Q572Hbh-Ea4l>OneSbgv5fdHE zCmqH%n-wG}gx`oKy~SH5r#;t6`@zrmUjPdII}qB|539XeWqkXmr!U#R@_t!6{$otg z;L%6UST0Hdb!j+Z(LI%SiTyQzzC~HBYF6O4P>#G!jJ%3Hak1?Nz0G|H0)|rbPUGP* zKN#9bov2nD+X{Z9Uibw}cJ!--nw4+DRC0Z%R21+rzm_gm(~h{kJ)#hFDCjDi%j3Q_ z&j!Zhvz9D1M}JIv=Nx)^_b#bE+in)+^Lje+J(70qw*N7On&BEb&i*g=+W&1|S6K4W z_)km~grrWGF@aqfxgz<rk{}A<<V7?8Pp7p`+lF(;4&;CCF`egfR9@REdg>}fMy({S zVtr2hEi`3vi!g9CbC^j^*H0+CiM^+P*1eF@BMA7WtH4H^qyAmGXHRsC`Z*=+y8Bg; zL74Kd|3t3e6|j%=6c>x3T?9%tsk<I<^aKxQCeOLRZ|UJe;1OE|1-7qcJMsAHvBQYW zRXY|&Le<y<7rt-5df!=P6nty?W4LNQ_j&5F*cyZ%tc<+`2LbZy_%~>T98x_&`}8Nw z(Zlo=4jEnX#$SKDo$heQb>zm7D|^ne-*L-iXe_`e<<CyPa{BmHUl{hw+d_oLCW_?R zk$)pGJ3igCC7X~rIdog?#r8zlB{}<~R|V|X?3Pp3*9sxY;O{{sI!)qi!*VM}e5cv| zP}C7tf^gE*V~Sh~qXd`JcO||zykCBwhX8F(9^ufLXKKeb-*LzGqhU0sz+Qm`Oo$`8 zC$PN7uKq3qD5B5(fjmROg}DQ#e+KSuuO&j=307<a%twrB*tG!huL=T|1J9A&v!VTy zgBL5$aP}rgPosD(^OIe2Q@F;R;IDPv;mA}P!|H3$>yKQ%zwoDtz~4_g*avnnfBv@+ zF8$$897HsnCL#X?T2ZGb-wy?X6-v`NcrH&Y*DMq7+O=O=mdh=((F;y(cCXa-dyzdf z@~NA$iF;$_(c<Euq=0GiRP+x+7(u@ROOrdgTLXPz#9v$eVA^w76V&|(=M$-0NBy+4 zUOfGY=#vs-Bk=Rg0Za0yciIap?)2kyg>s1pjk2}5bzMhls=`a=)IOxh)|N_1VQZF6 z$Zaok^t_-dMV9-8=WlJGz}oU3Jod6MVg4aZgINFT<&8hlSP6K8T})4CgK*`?Z2S;d zH+E~O9=RWy>YO-#x8<ItP$iXvdxnNsCH$Y<a}($Dd&gQ*o(?;lVi|_Fby|9A?~!X* zX%BAlGXaaYRM};N&IEKF<@n8CeCQgM*&{<aKJOBV0*TS;y+|zqApna{7{<6n5#xp_ zrIu6wObAXc|4!z|FW9`+vtpK0$Yz-j8HMM(i+<;gzaKm(w}T`Qcei3}GSJRfH$tP5 z8KR#TxUKA=aNlx2)+zVVzhU#epRu&@^-tbvs$)#2e%d}pW%|N^lwn@k{_N$%8;#iE z)Z;vM78|VHkC^8Kl?2m_>SBKn4x~-6PDH_?tS99UMGP!UsLH+2oi2MNL1Zw$d%rgn z-R#s<0eTUP0R*F<qjl5HpG@6?wbq`@?N|=9{fM2R->$Pe^Zt%dY}tiFFZXA?EikJK zhAmCWM~i(0w*ju;P0<l*hgAgA(_8c8HnUWWu*kI6J&MEJ!LVrhladLhD*0iwLO3vr zrIG9tnD@!mo?HkNIG21K*s%N;AK8L8<^?k9rk#OUqhL{=?HXy)Cfqo@J1<e-4)h?C z7T{1*qL^p$oZ9vu3ps$W+CLW%OvXamvy=J`e2-7+g0bD@K-ml0{$*4jE7gMQ*fO=; z1yk;L1&Y~$P=jk|J5zzl{#_0g7y?E5gLHZxLPb~ar}~;F^FRD<RIU_d)s>y(Yvaqo zM8Obo2#jbjFU@k6`zmmzurRW~wWZDNGj09E#w5XS{b1oi;&;J9zG%POjH90VOlFRZ z-mhOo<r6{$DWNMKIAetIh;K5y{jrY_L~11JL1yBnNU+)#n$A34-q$IPS&efgEjm#> z_Ugc9$BhAt#Fd&Hqf5(@YbEup4CU|Z{&XbpkIZv8jm|1{ndX|uq&he~6#pS`wy_8R zS(~hn&_b+A0P~bQlRPzvC4s({R7bRCF;ss0XHPHG<<|!^czLXtJiQ>;;r)nyIeeGw zi65yGT^Yd43TYA(N{pVasj$ILR0#B=P-bGWJ{-Qpo#!C!(r<}2n^075y-tG(>Prj_ zUw@H7OaF&awSkxc71u_Jeeyosx|>iV2P%To?IQTVpP-?}Dquc01NB-7{q#f)gk?Iy zeDdAHj+ylCgtePsmX-2fbtwv+@{tU8hGMif^3mG8wPlE?U5T_Y*`m%%J!-OtCJ&_u zD!zm<+Y*5^jY&W^_m&;Vc_*Qa>*u7a!0t78|6Z=tETCcf9)T1#CXCL9DN~_sAJ~-_ zqi>sb2M5f~0J!~SnG9i_QMif>Jq1v6BHnISw?Qjruc6geC>SmB8!MM16ZEu$z_ITF zgtgTK@{w-v7;Qv|@za!j9@8iVBP>Bj18kwvikPe?`;9`}v-;3fhQC&iDpf*#3qlj7 z_&=C&wvetqy`l~%r0vWU8j-@&Hf$+!FQe6eRCV8@5iHkaVHmtiDpT^cDcRdCp5P~| zXD>f@{Z^~{c$4!4X}GuBFOD=(l1sfE;$u7!G@{z$Ra`&dN?J+an=&5bc^t7YpaWKC z?93m!Z@d=(VyFk3Ua1wl%~ZJ|vz%0GB47JiB%aTUusg221#8tmkw1!(z31+>R+_;t zG9X1z{DKp{Fa&K9M}N|u))j~Oh7lrP9#|(Gqdh+Xl*oOT%^8Z~#vZJN`RZ;YH>9n$ zpyYCQ`IdFYeYPKrM>s|#TaM%gWmzXKz62Yw`4^2bO)_EO;>#_JeE1IR6Ma<__gHk7 z_av|7bV<#w+2MwDeg;mlOYQxW;4Hh2(yUQjN0c;*pErGdqaZe1g1y6-$0iY~*<U5t z)eRV9tPvZw%iOP~8O{i}Bff<CW92@dMp4(oM_fNAGDBqfWYWhX1sl&6RzEv((CCXh zM=a;L!)|sA{CjbQDff}97+@Zg^HwssV*=;2mC3IR(67)Io10vvZ0Y6;+k=mo@HK~N zO6~0fvs~XMz83&XZBB7$qP>2J*t$t)mog{zaNpPC9LWeKns4eWvf|^WZ}?oBP0^im z;sxN_6oa5g3mShz7waP3pnk;YqW(;~{hb6}?NF4=u*rOEn73h4Lw0IpEHk`UEG4>B zKGeQfg`92dm#0K?kYRzzXK3Rmi&WF|FO2_zUBZYOP=^ATd8~?2O97+3wM+b=btXa7 z4$i@IyG!WDTHnX2^sP6nvoG-4WCz%7-M4(mMUxo8V+40yywod(7=G;Y8{mw~KfC#J z#zuO?CqrlagVA8IZbTb~)bP<(CthDqT#aPjxKcl=0bfN0HpD6Z`za^StKQd~r8B9e zT=r=0gZa<2QOw6nx1Yx684kL4iG<xxSrs6y({nFH@$RPZ?#fdh?Wzu2Oz=HYdHP;{ zQ%=fco@Acp<xy3JD-%Og0^)g&Ri#1#CWCIvO|$&(CMPPO=1>?tk9{$VwqS0_eI14# zHS8v#x@4O7FP?orYaJ-WEd#QJrwc6ja$MVAGdp0NY>8hw_f6vzmyHH05x=)K(O0%d z=!t87KJn%x@wQpn#V98-bfqPo@VdAM7m5pmM4>X2F_f?E=&L+?grpgU9|I~KIWoCE zFx?9XA{Dsc=&#iOZkSx0lZQ8e%u2-5POR<BQ1%fqE4~iLQ(7|2xJ<n(9&NlkmERn$ zXgMD-VK(s9>~AOiowBvaYT`%9ydvqU<WnFN8@b9Y7o$r{+Th|0mcAX&Tk792ftW{* zM^t>?M@SCY*3KPDmkc?{Pay56xgp@`=-fHXS+-9P{|{sG!gA|6wd>Ur0hZ=^*{K?H zj6~}c?HvmsIBp3N{mXc-&c%)&fkLuLE8UsI>W5z58H^}sIjpaDy!M#Xpx`V5uQ&xK zfz~w&!<)Qz>!5BSdB*kv6v4ZmBx+HkAjKTKj_pbn=zR&i%0C&cyo&$<{8|uIMHQnj zkLprC2sluYJs|++>o@Qx<w+%Vvd>ArIljq4W4;gns<ZWMho!Q;_OslBsDQ71B{3iG zn6E|mFVZPfi&j*uF0o&naNH&YxtswlDP4wbU?d_pl+AstFx=fMBYSn=(MIWzXLIzk z?8L~~F>H>()C@Vsb|VG?>bW>O*f;7YzvaqVw@o#g(m|!(7ia``e{|$Ny&|S0&Uw5b z#PLdJb@EO8m^aYkR*}J(#hR~sIx{Z+P{uQ6e4v%Nu~@9|rl#sOt(-lnXhsqK{c@w3 z_S3MoADG;#!2%=!un7O>D!pKhXfeOnnGKxC*k)lQ%`>Bqe!Opol`l1(7f`fun)K%* zm#kWzg~3EQ%r*R3EKL|_E>QpIj;{b_k;2~XD>uJPa(<r~J194pT0FW}z~Qp=PzJBq zN)Gh|EOz@;oryUz$vi%MNo4bP;5L|5a>90!Y2MW|6p5u6B!{)-m+AB@5-F!yOKshZ z3iW@nck0p4Vw|67Y7Kn`fx2i{C3HFfeA5p4b4=18t#G;;A4fEQ9n{n2VvWY*ZP1p# zH9;Y`KuOJfhjS!A!?~(Rd<t@)Vg!q9m0=3E`z=$hWQED;&T@cZ-ick2eXWnm`)W84 zZsR70t-s!N1fn?ss7@Y`Q$0HCz}v~QxE0EqGa)$d2e>sLCQ=+D(DLsEJO8T>PtN$O zo=E5Qtk9otCu}KS?|qS+=GHYLlLw1Plz+10DM5MVO(@wm&Js3oJN>9;0BMsDaJdzv zg^EJ%<1G_6t74zt0PNz<Bgb7+NcE%ecl7U+E5yF-7Qyv4kv64d79X9u&4zN;5h*(w z1_eL(1?AE<lSgmB&Vt?gB?qX$wW;TA{@o~yA8I}nokdltpYuj87m02*kMFl)6_vdV zJ3Ta<KuARjRUPjSX39D-9nb*;vT5bRL|V)r{tMedF*G*#=mP4P?%zoz>QhIj>|4B< zj3(Wq10}MVXrCPWUXtxI0X^uiTll4}u|I48B@pBBpa4g5t7)(t6`-ohYXruIL3XtD zIT%gMaUGmRyIi7J!iN6F<VCvURudow35@qO*`~f<2Yiv<d?V4<W1)v?$i#;1*hve^ z$2W!%?2Ez=SR7X<&QpL0j-OGk9;UhM<I5d&u(n{2_fS6TEnwtc5~MAJL{^45q|ecM zOxD>q0Lu8<U!sP&s2W^tAT2`(^6M|5MIO16M49BR8!-fu@l9xm1Amx?8p8hhs_#+! z3({8DsQ%h;fVqvkpm|LtN+YQ&s$u_kDz@=Ff%Oe1F$~V8<p%shm8z=o1qYwEN2HBm zLpKMMuH~6J?QHl%%uo5l6SdB01^;HiVe06866H4`p7i(W`mJS6j@Ox`i2|R(+5O%X z*6;Ye-k5qED7TdL(0ti@5&w)%*Wu0SoYPs(qd9sR+JiB&_8(Fd6x#bamA>abTTXgL zm-_ZJW6^{R+MXX$>i>c2t<6@SYY>VOurpwv>e~Ws>@+cf_UWxO$eMTKEq9#kr|&5s zGb|kbw)*h&t2^_M5A_V&s{KnM&EQ;z$za=`EycM8L#>p`uFy50MlAcPAvb`L+>+)4 zi^9(NcAK2R2?n89d8%F}Y}2xohknDoRfeY$4`}xG5^k*Xe!ydKSszQ}8?{p38eIbn z=~~{v7<Xg!fKJd-*oN`IsHH3cgiof|T%uf8e0~s1<|K;}ST<Xn?O19qvA5o9T?_!b zjt}dQwXAW=DhRYD6v~@V`>@pj&VH-10q1mM%Hhw!5Z5%H{3D^jGfIFy^+%Hp-QURP z%OS(bV07-aZ?cBjc{pA)^-S5hiKhR_8JrN`QJIz|(L2Z_aOnl333CPG5O;&ER=oQw zD7c3Xai102fcD1(E?IfTKb>|qN)igc4O89fSQ`m#29~_D(yoKH9DzUM81N^r4fj8! z%G4K9N++Mq{QjVkqFjw%&SX(x`5iaAOC1>ON500~KMB^+Rj6D1`xLS@Gv0+B4FLvK z8CrPV*Id`Q%fezVDcz`VF1-mnIeb^Gc!vKdFzJZ|e`pw0G~c&cI3Cgp!F&}}6)m&N z&cQ9U?fEKJbQ92&$Vczf)sA&i+*%Ba4P0bKNRrmuXCHGhMA{m+Y}IkC|1VpVD3Rm{ ze$o)g^RwR9cp>QOj)68$C=Em1@=6<tQL(nRZKZhY9t$Alf1jN?zuqoUPDL6gM3GAK z>wJHkI?2${I{utVg<iH7X@N(33EM8QzYY-gj=psLL3DQGD0-rM(x;%N#ggR>v7xS1 zPUeza%(1jz?lx>Lir^2Y=uL0<7v>mGeUQ5Hcyd=93mJ{ll9CxYh#dThE&V25F0rz@ zGj(dmHSyChTc5v8p>^nn1i%j0et1T6cFV>}RnclvN_Ah1y>>$ja~>~f#j|<Nr)?Sd z=st%mt2e~GnF!AtLW>igCT{amUfm|`i58~5ltw;lza=IjCZ*n>5p{Khzqezj^j?n7 z;UZB7j>CC(m<X9YoOG=p^;A2Y$Gs0o4{{kW!s1jtR^STF9wV=hjSmx!HY&p^_rl+l zH+3~Lqv{<Qn|trClz#!4vwM_oTthmM10NV3%d{^!xhJc1kw<^au<qQo{L4SMIy^=c zo5?;>v7=e<^P`7aFc_<h8-Y<V#~zHuig=e;Rg30{z&z-yqT~}J(2vLmz{&x%TR%F& zG>q~@FN?0k?_Y`N4vcvk7m3Z@iacVNiF+21bw6~qS;>&UCj&_mEjT#m<_2EYHj9S{ z7-TH53S7v|;Wf+BNPKo5q$#~B79?6GtKGt}-kvUt(5Y_zwC9)fU7mPZ=*7!()t{9? z;0h)(IY{_7tv!|$u{Ks=KeKB()2`q#$0YfD)(Z7=#{2PwHB<16_5d%2#U#qt3e%Ah zUL7w1T^JHmJ=#;LA3;M}=n<JOSO|!6=Dz{s@O6b39yrSON=1!JZkSS*PEz`O|E46x zK-`6wmyB+k{t8v+zDusda&_iykMVb7l9S+Dy#Ug|*0Z0S+P;N~{W!N9L~evx2#xXN zKXe7@`-(<vV?LucB{1aa<`oz6la9YSSf7(-;A+u9ZW&h`-&=!il;G1i-X;U7u|r?& z&2OTWm;=wxd(73PR|H%gPX)mGYID_RTkekdw*=XtF8qS*4K##5!YI}NQ*L|MPXCg6 zS7se^x?Iz(2GHhzI{e2<-!vX7m~$L&`kFKh<13Jai$l;^eA$U5%{?iUT}~<}e&o+5 z^BhxSk8!Wo*F<4Yzb{^AvH%MH^#+f3C7bq>4-)LV3fZkZEv79$9c_-7?ITT(rla=T zFD<}f^BRG-|ImjV23SZ7pNF1!ofQ1w`^8YpUY*5F&`G2$HB*(TXEQ(Cljyw*{ltj% zLu=YR2OZU=@#b3P#PSZ(2Xets<gnvXon6+DxEkFKAo!a2T*GP*8G|xr&^*FIOIvUf zHgZ1R&hX01&Ba7cQ(iTg>=>?oVFbTE{;VMN!~B9}BQi|dkq9+H^U;%xzCafC8aoSy z9-X2MbeGFsK4m+9YoRJWT9!VkAs97;lT0$=mPhv&3fXvU!)V4iXzxGQXdF+>cfHVF zc(O-K$Ixb7Q1%e*@iEtM0x1DWHPO%nP&M)tCQQ%gV0VZT%YNq2WL#VZ7_&1FH-2sC z0jQ3b!hE2QCi$dee5|X!dI#ePy4tcO-gSAZmea^9SAZKZB0+rj0bpa!f0a=^iSPkN zuaI_J&~o4d=%{N?C%Q>x7eB5t$>rl~IBLQZ7HQL~RLMGwqFfQ*`x_PXR1b1$-KgIT zHQgKg39Z6v!tH*_7ib)VD9E$jSy2SZhRiuL?`Br=u{^=Trx{sfZv^Vs-$c;ypG_e} z8ug;Cad|uT{n`>T13AEYsQ86A))m~j0FqKPIyd2!Q(KH4lndQdee<_fwfp{ma}1sC z^M*6UR&V7h^NmZa9UO-<s^hJXHX06o(Z9d9?s<X8=j5{eSASshG?H}^Z^iXCYQ^2) zf|GK8lJ`;y;$)p|BXnX|XuZVf)h7ivl?AO@#C#8@ix3mv)Ri2ax@Gso<*`(4GzaTx zuXhkpvnBq9XszPI+{w*ic?P>&I-exQ*Iq&%b7WKHR(pB>&7h;jI&+e(QIm7dFo+Ih z+3K8~`sKdWZx3frYpifA(dVV`NW#+#e3US}1>+j$iCA!K@VHtPd0y6Lea4_zkDcie z-Hpw!sQf*HAUiBpe1=(Q7i+Ntu#08E%x`PpsB%3^UL>2Um95jT@#W^|#<@9cHQEm$ z+e4cDEt+IY?R}IVmJdA^tjn>T6yzsIJ|9AQgJ_V6pBb=RQF>r~dsM=KRFw-u2&+ZB z)yv@`C{r?iP`uD1<6xr2ZzR?}Q2hqC1)_5sfWz*zVm`0@rIe|>m-_016JFHPu~B>Y zr0d|;dx%Tb?ub7jS9Xr)+Kd0G_6p&61MK{c7ocuaFuz$yxkV-A!TsWJoxSWzhD0h0 zE;^cwT7sG}RRdI5{9cEZ)mu((B+rZ8dFL1Ey=2@=@L*RnwK?}iy7w(H)b-_c+=Dq9 z!oBK({zX=Hod%|1pKDr%IeW|BE2st@-FzRUI?6t4A1HU{(ue4R(jQ~)b2f{9B)Hr; z1Io@);ZzoH|2I;X>oc|fUuBrnC4u+{-z;3@IE~j~M>!9HAqvTI_)KgDwNrO*=%w1S z0n2ee?cyZSko<;9>qx<or05;A-Cw1~0VqsNv+@e4;kz#Fyb<*rya|$QQTM_c>oX80 z!qqGq$oFjeq2DK(JNH<me+PE5yb-;j9b`<wADr^7*u2n;7+Hqk))Lwz|F$YT8|lV4 z4YL*|n`+dVn1?Wr9_L9Hw9wl81b6|2Tl^Nc8|!{~khb+FYxY$nLi!emcBcSslpBxa z7cj-BgBWnZNQJ6WBII=K7DVehLl)faKZH0V<;!`Os=i0a9s)q-c!;2qz$lGh3vG31 z*MsR=SZFDT?iq3f*|vqAst<F|XML9h?*qc<JWIL1_y<IU8AoZtioRB_#a;izw*L9S zwPTj#vwvy4xP1istea{9PNk@&7N4nzJT(Gc3lAtKnTQG~F(S(FnT^>`SmQ)5$#$L@ zg4ef;8}wNpqG5n{j=UX%?fMWlmO%d&_hh(L{ZdzVSfqh~mTU><i%EL6uP0`|;yC%R zCHnG1pg_qtt17L9(W|*T3yb!B^5BdQ+zogqmvC81KAqG*?kki>v<ka3pAOqRH=>V; z<-f-*EoYJn{)0yZ6)~!;rWULZ)-}+{6IzcFS?2E~`w3?UT5FtYxs+j}=(xbr<4Nv5 zvknVw4=E5Ea1XkZ&PydlrxwT4*OBH6Q8a4uxl-^wm~P^8nw-f!b~4K^@kR@zg#L6g zo^s4;7E`+B!g<2=Uh?tOgqksNI762s%?2?qV>_pzGdC>q%OXjfPdSd11b=<vlEn9~ zgYC$d69-4&U#fDW0%YU@W;xM{?{fwe#mj<?NjJTrkKV!GN;nH+oM$^VmLs2!-Qq3g z-7}dPP2Ys=IIn714em2%SbvYU8k+sl-%&5O+{y2CFqMOdrcomkYDt11&Bn`E(o!J$ zh<Uy*jV<HWzDxhlkPU=ndu@D6=+v9=mI^(Hm}4HaVK+NeQ8bFu*MKWr4pOgh_GCG+ z7UaElM&lXSo+D5OTI_urfs(up>x%SEFfAE*ZcN<RxBu|sQhyH82^dtNb?yzwOBp;Q zS~GTKZ&)i@1i;4K5>|(s1W(ysBuiQYh%7s7Vk<UQpN*KqK8XXerQ$Nx;BkLu?FDm! z)oxAEji$LW+9?Jf=sE*p`j8?CCED}LYK>@<GaGi1gdOZhFlfQcsNJMc&lq=y@n2PV z`HR@RPXI-Kr<3DQD-NTK-7JFbO4)%wyIoiTnUi%8F?VFsK^_-YK?8qm8CVTIz#L-= zf-{V@vBu^=|10|RpI=^6#M!u#b1ifL)?4s=?2!@1*33+6%)?*PyHL0Jp;Z)Ya2n&V zdiJH#bg7Ibd4TBpDxYAvI~@BF4xR$I%Xb(X-Lox;LF{W?Dij;PnPLM$z$V|%YioDd z2P{T^HfAtq*{&KhHkeb^JH$r1GSNmP7DqE2kX9ZC3(M_P@S&-z_s^Q0rU^$pVo!W` z_obatAXB=6K373pfu^%3`yu5^&`T(U3x3XoTjnJ~QBGU%;&>lSK9sH>PTqQ=VI*LP zIg3DFEA(Q0d%g;UTs!7t29;C+pf2kQ(fkMv8D?#d8mG3dLS~ruu7*#0zyXNJPA_`c zl{hIEYq8uJ1|3iAaO+NAj^5io&+7SD)pKGX_}V2Ff~MhL;^}`~ECJg)WgCwRyy8+4 zc@2CVA}$OY|4&($Fh-RUMyo3&O4&Q785}IMKHH<E_#RuKSPk9N6XK_s$k;j^H4ezF z-fpBM=>SjedcVcb#{1u305(NTMdFEr1SCA2R<{fAfLVWUt^duUJVcnTwP9Bx!lmun zbe9U%`a=-$u{{e56S=Of@hDLj=!6y6HTJe4DPdaRYBGp62x+Y{yjM0tf86>=6}^1= z1TAL+k586AN72e1mTPxk(Ht`<ELpf*YFmOZ&!aTgYJ$x785AzbTM5kuKoD3!N@B_7 z7OmW%$zKxJ+7(_dfCTxMxJirIKpLmYo%MAwf>p2&8*01p!ltXE^C+&X^*XPeNtt{% zU%?qCS;_3x-PvVZ{VypHjul+8bXPESJ<Aue1x<nUB{w|rP?(=31&bD?!M-#(%bLkF z$FxPrt@oMTYZ1K`dO4_#=9Y&CEgL`ERy-eLmI>b5fVaaVbQtC+y-)xU@#O(_uU|a2 z_?B|gO%Zwq3W3YAoX-Rvo_(@y|C)5}-_s&qhDu*T`&|+@F*<so0IHJfdWed?3Xajs zh}aK{r5)Dq-p?v}@5Pi?lNLrR>Z@u#lyB4%DdQ8G6nw+=M#M0~<zaC$Wg-dH;EH~6 z<7vhP+m!h7nqeQI4vhW+l$XJBs*1R`C01Jrx(UDZwUo&O=L392Dh!(Yg*M+Zp0KGP zZN!qU{DNMfEJ~#MUF-SepnKNzk*4JO1N7urM@6k$?@xN7^}z|Rdur2u*Y^K&>{6+l zke`BH&KbI)WfsGnvb1}Gq+zs|x|(CS4xT2ewyru9Xj=L~fPr7DT%K|+piCMt%G$k} zNt%1fmH6>_0L)wV)pM-xs3teZ=wWX99#!S14JJ+Jv$_sx76C)7G=q!Cei?g2RfsmR zI4J1qMg(OcbyD}Gr0<4#x)>bhsSZQBz}}O>VYyEyz4Z#(o$p3E8BM*r$E;7&v>c>= zO6!%Y7ZM9bUM86wJI}~QS^<BNGQ@mWw}eZ6`=JTkF3OsuDPr!;^!zktWV~GQ-6#%Z z_j&*vvJlXUK0GCUD9!Efj4)c2wC&1wG3@us${f9()HfBdZN?77L(Zpf=ZhvXtHjNk zB-0K)spf-MUkXN=TTW-`u$U}cKsfdCY7H)xG~;e`^v|)FB5}@hyo=mhQAaqxf>-dz ze2CJJsma#zFuF6QnVXSI8s(83cvkjhavCMX2V(DP15I=!Xw#KK$42EdKV2EZ<9f@j z_S>+ZEfrBV6);FPNIZsklNF-%Tisy>ChRb0`egbOJnY8?A$W*G(JlxZddZysb4l42 zyln*Tex9?uFXX5iwe$2rGCgCEzr>uO{gIySa|H?tW%y77b44I^z6kGY66d|o=Qdda zO5sED;~dyEz}bG0g1pa7SYvJbqL>U6*axwf3&hFj5Z#cDC6}S{0uF}L2dQNakUzt` z3;PikU;00w_v{zv!G4dzG~!7Ajxpkyk@?)^{iVFN+?k*hb&QE7LWQ(&R8-bUEjGCP zhfrLv#<VuG(zy>Wn1rs!tO#8ZV&I~zUY+S_-6ub_Luw@$V(;>{ysWl4BF_p#n(J^x zxh3ItA!!I{FzzWR9zsSBtcK`5kX5%)`KE!Nh58jh=ANnDBWox%RSZA#(Z{tjxt-7% ztKp-;xY@9e!pHItrs_A!>w%QpsbCeO)rX0-W#_McxV#!J7C)AdJ7le*X+vT(b<gfm zIh2>1pPc!r4ZgLn(RNeDmqzEA<+=N^rc3p-k;z;mZDTc^N;{%#l<jHLnX=6R!Z42K z$GmtiWK*x7Yc<lRhe-!o&yp&iIXLLuH5FRUSYq|efAE@{H5H3?F?7t=pdu&+9Zh&* zOFc?hX(Q!VNjX<SNU?k(=n}Qcm$LpO26n!q)6J8W9%O8ugQ@Dyu(m(*w}vM^#^A^m z)erax=U9_)_3*j>gaZ3w_fl6Mg<wy#?ERcH-QK3$cjiasTNM)$tg>FqP*VMaK%zKl zcu9n?mtE%y(pp0+^*f*l>Wy;LioaEFIf^mRp|92#KLfcKMf-W1?6mN`&1I6=%qOMl zcXwU~!a%Z)qij7(f7SL`cwuyver`uiS*IwPqi^~#62@MM9qpLq<9QyqgmQLKa%2Vh z4y0@B9J#`@o7F5%<UnOvF+R`qb|E#*pYO`AmWR?r4auzmkWU9Cnl@LZ#P@US%^z&% zpb<PMtj<`I2nO}_ws+vPkk^tmN{S6}MU0$u-sccrsD9M-0zJejZ?br&lKpeK#XYza zd2x`1<{h;J+77{pfuF)WtbMRY^_6ge2V7WKJGmIgzB@<RoIt0Dk^kNVD{qN<6nKml z@kj*|s3qn)m^5@MOu$IlsL@23h*V*3b(Qs7NOW-Y?@-&Qn7Y~wxfmrNi1rPk!k4o0 zH%=l~$lWiXQ1kzu`+N>&$}hoIF%Wge`d|(w5g<$@(a!t(={MDGySs5m^F}j3Wye3~ z?RUC~b5Pl>84LA_iY6&8(2S~C)TR(O&LC&_LQ6>J%wfOHU{K+i3s=L&v*XE`ii&}C zSb%L$+@ir0jyx+}0j>5gZ^WAgnk~`D*d5O>FX6z{DCLm$hV-YIdh_SYTjSGCLcKb- z`Hdo$6iPVE23m&qr_>a)6&8=nzKGp8;NY)xp;JMRsy&E$dD-(*0(s*lzC`<AhZQBw zco-7BFESy%dZ{qz?iPB=XVH>EQC9D(hDad~ktb~9NIyj{fzEkYM`rN#&Fd6+SXgW< z@cc59Z!xq@S$FS-lqpt4DWqPqIMw1ld20EQEW4H#A%ZL67a+OuL8@%fAXYy4cJAW2 z5BDIy>^FyU+4`T~<$vQyvS-(Lt^Q}%O?>$-iIEss#&A_=!OZGKjJvXc;=objjp!%h zB5M86YOldipc(Av>&He73fkBBl^LNnQRfhZ;%P}8!ly2`to2_4xm`{C!^ODCvTu{( zHP-~pl3VfHU)`gnOGSqXJK{m@r~8j?>d=XNb#<{4BR+Z&=DJetBP4B3AsjT*%}CSR zD&=!{^WD9`V;8cX;l<UjMF)0^B)2X<x-7cZBavj&EN;nCrZ{EnId@rlvtf3sq(&i? z;5ndk4SMtzPg%bBWuZZK$An(CS1C*eo4ek=5;JRsP~EIHF5w~#`2t75TC;1-Ys`B$ z6Hn^ugJB6vIG|ldZk#N$gUki_Zz?0B>~O`b7IhYtZs}=f-SEBOw5*{cE08v(psA2d z4k|LQt$CKXc3X;bEB^Vb{YJX(s`T?JG9^}lr1@s9s+#wY@qkzET$FAS=6iC*tvwHm zAC@1})6sV@P_FD$CpB{U7#cQD<F$Nxz@o7WK>C|)htdT%cM&OWUAdv-H0CkJt?G2N zEJweEvT@yLmFM&D&srJ;o*i7vn-ubZDIWzT0V~m>T$rYgP~RqMzNT)xv>Lma(=_Sh zCh^vYD#8LLsHnCAEl+JR&&gK|^kA8Saag<*QY_`^W0WzcXJ$FdS|{6i3zMu1Ls5&R zqLinE(Q}+uBG+&jOjkKzLBX_fM0$9Prh&#uf3L>tLnH*0Lz1ruulY>+H^HKs@s<5u z3J={LP*xzp4sVCyWwXoYUsD!V=0ONsc)FQVGo3A3B2IQ@G;BS`CE>VnkImXtb%BeE zH{Dxk&Am9`B-&`R8hg;7aG2{I@7%;GnhEMh`-Our8o4L!(ttcLJv8Z#dnK3HZrC^g zm%q>1_a)=)#UPsY@ux87PM?Pb>Gm(r!@2L~!8nIva0M+LPbi<cKjx&c`o!(g_PyWC z=XiGhj=TaTOjbV6NyBQs!!2vaQ`TWS6;LDb`<}K3)=}aIL)!7VrwQ!Dl#go>;|v1Y zOe)clOU5miXMQtm%X;<Lyoh%<iNj_7Yv2#z4LKn!k&~AxeBO;qwM%_bjqJp{`v$L0 zKQmi_KL(TB`at&qT#8gmvqzOR>ZS!}pW;Q*`8l0|Umf_&FV8jCDNEoNg6RhOgZefw z^d`(A&gM4p9^Zizxt7@#dUOSQ!69PiZOdO+?QHTfjI?YUr%cx5enrp2>&f0IzjjUD z;klN-t$^`BaJj0t@aDU7t4L8xq<qCD#;*m#oVELjeemkOo`BW$`sp`q9Gk3VeE-n} zI7A1F|Df|uB{cCkJZC9uxEGYM$i>+*bUeq><y3ayv*IxKRsfeDG_dwNO2)_UoB_|3 zhXj}c)ZLb;ygd09Cp5&hbC4=B?QE)8oLJ&53BNvjc9zb1jj?w`a?1<_k>8%{$+`*N z24u{gk_|UVkbbCwEt@29G2uo74lft$_TYXJi(zHirrqo3VZTW6nXF+siU%B+v~Fn~ zvRRG0pOn}-mKoE2B`*vUFN?9$9)KjH&27tCTxH5hG7x77etsh~9VB4!$8w6wRBD=* z_DV9F@Q5QsA8fFGB~{P8#CI5RR|d`#HhA%Qnu146HqkNShAoF}{EmLvNva2M?Su<N z*zqf!)$l(Q+6x1>K`35oU-4N9&}Ehl*TQtVX89Dko$S}~S%67wRmml`A}7FZA>t<* z)M_{%se5j?Km7zhBZMrj2)^<efjQPJzw+EZ=_$QQo=Fr@h-k$u=2KdB@xF!2)kuK> zQ-YD+hrNw}y-?&kZdX4}GW$#)zir3i_yk74-XD9z=s8>-%U*UY(3-VMeQT3ckx0X* zy+fXWI_6OezRKrh?vx|{dOUcfqV2`$8DHfORW&d&UzrEom$0aVWu(kCS{X!UQ6Mw+ zP#z)z0csFU@ozJE^}-lU1x77;-dal<&<CK9OEiH2q0L%N67O%B<2J=!M<&EOM_Os! zqJQm=wUK)XvXOGonC;3vw0U1CywD24ve2;IsH@GXKvqz_=)cqpM2wLhm9>WiGAn?x zqGwA$N;?NuT(k87$rkwDH)9M7u#&Ht|37@ac{r4N{60P@Eu&H~DTV5^j--uK_AJq2 zpJ&ESsW7q>%1%m(q7;?v>v#r343Z^E+H5g|ETxcLc4PUz-qq)PzSr+}U0;8k>s;qL zX`W}E=k<QQ?)!e-_rA%Ipr^iJYr=-6f1I-TaH0wDtAXmR7Ux74H)yNv9cAc!g{1AH zU{N3b`lHLs&1)miUAp`-a&6Axt|jMy8lgh4So=;6E7CbD9r9DBN3GlWc1~I?SkkX~ z?sQ$Xd9ju<Bj<dyy3viAs>cuhQKlOGQ^)fp@H1$9zqADCus>K@A2or*EY^)Ak%M-( zj)v<p|2OVSj~uvngOg?2-4W%$jrm!gFxM+^;3nQeSqCwPgbMB7=p+QB=&r5Tik52< zJGD!hX9Tn?ZW{8iK<BfvGyC+b30U@-`AiObx%Vjuh>-1lg~gs*aoJlf!*8T*?j%%1 zWN8IzZs<ODC%pTRg7B9O5bd=`2biLpnT^i{cdcGaJ{V&4x0SiIB)N3Os;&J%;@Xu5 z2~B3+dm!T7^hx;9N$oDt*id%;0{iMNM`_N2ScRhH#jWQb^`Cnu{9Y?}%_rPTl47)b z#eLOy&D@i>HBJU4s@}T4gRC~IdgG#6L)nIpvxSOI`~uhaSbn_II66|YFeKj{?KJqD zRuWmo^;T#<c)qZJ;`2^ij^pm1E)#BK#)!~o?YUK7j6Mc#=pRZCikm1z()*K5TRJcj z12-KnCW-?p?6B~`wEHv4nmzAg67`_%6f5-?HpJ@u`G`tilr||_%Nic5_QNSItK*eu z6^--p9hB~j-0~SSK~-B1uVn@KwcWKI%bc?5icvnd*X@|~bXgS7cOURiLx>2M+t46` zO-REETQ#kM!|glbzIuyWjZgp2_5(BRWCDTU``zx>tW-nh$z!KBX|3_CvmBqWe)_!2 zSLD_Krt$7{(uZi7c|*!>M*Q+t$-22h{jH1{iX(&T8FAtCqyT9(KKcbBmx_WS2VbR| zm$ZT6{vXMFgJ<V%w`c3Gag`%C=;Rfka5|s9zEQ@M>QG$#a?F`*L0OaP;Zwj$wf6?W zO%%-wAh$;K){=S;+%~3I$S#HJO)hwR@O)rQO4*spM&U13cS95&1<E2|6nT?fo!4(H zgso+_Nu?;7=a~G@&Ews%#$5$hnI8Ev!G1KC-Su-Pv6S9<1UR5b)Z(bYCOq~$#8r5+ z^tWEDxvTTR-89CurKdPKm|30B4Qm=K&@g_aH)ag*x4x>Mvxs~WelaljmK0aQD*5pI zP(h*Ll!uVUiL%x6YTWAEO4^}DTY4mU*%kyshXG`9c9O>Fc1z%XZgK0|@0dJpqhEJ0 zk)J<(QE0;*4tL<mt)lfL5zE%Tb2-P$L%l_7^^a{$D0pups#h7}PTqYQO2V+#W#V2K z#xL{Jet_u(8`;;O5_v5qSGU73-|-ATnY0;D>bk|RENgSlll>TGMFm1(@R&{B<mhU* zPElNN<u%w{`U{xq+tHA+HIt}JITsg;@roi=IhLv>27Ko)f*y$(aYd8Ww}G6Y^Eq`- z-M0iMst&F!;9pWOxgS;l_>Xc#v`cL~$DVVJY3F^w-jUri#!)a18&bmfsFb(A00DA6 zcKS;Pt#t{e$sC1{+?<k<GHX(t+*HT)d66#wC@To1&#$bHF!2A!NJub^U@0_|9ewDZ zbV`+DA9dGt?Cpp47fL6~s<*=}Lq8pdbw3zmZgjGwd_C!8>6x>-YzEm7l+(SX_HbaR zur?=8>aSrQ)kH=${3{&LKIUrEJbP1X=F}byY_|tEwIRQ_?yxL+9J4y^+vap1SYYZ$ zi(qIk?z+Z+0EzVD*Z|Uwe`Vx0K5H{)?Xkwh&9OW%EUT+N(Vg+!P-vgY2KUK?pPz}B zv2y0L0cV0{=gA%_N#BAoaIdjBL=-Ik3a2Z={(|uwj!b1A-eEXaplpYY<G--4llLix zT(s+cbSXbZ=o?*3&=Vz_E+VAxhGoE2D!s3DdM(Gia>k5L`_<6oCHJ&1>+SS?S{;_f zTc(|<&7p2nf6thI|42NWBtH~sNxjYdgmIGan-rJS-D$E1Yl6fd4~j3J{Fbn%NbngR zs&}}t2aX6&awZ!4#C3KsoUs;D&AKF<lM?OzzTNy-W-dz443?FuiMrbMQ^Fag7uH>q z2c?DCD%{eRyq`BkCY-DYVC{JifHb|xSr8`b!EFa60@ni{U{z_x4Ir$4Q5sMEZGm0x zvSwb2M0rwvujiO|MZ)@*^sBQ-&)U)sy9`q!B;|@-#V2XH1~WhmO<l#S6MuF%D|Wsm z(7KZXKZB^LS=^QsD}DoYZ}Jxh0rr<4{dmYsViTo+9N9pzy~K3j&<(IM{N$S_0Vio& z&Uc>N`1|P~RA42S7qyU{w_oXR{&2m*#!dD3AUmg4H+<iP_R?<M5&H+5VJUhruScN1 zknx@pcDGdJOq3CqY;k8O&QT|1%8XAGe?zI6a@c*b{<*aed!#kXGJuv!SNJ4wd(#?n zCMQdf3MlF)rX1Fa6Qu2Vt>8qKr;zTJUS4x#8C#k7h;+F((%GA6L-G_2QphV7^Dji2 z`PgjG9x6ztm38~5bjNlw)Sk8JZ@q$2aD}Cgl=v#scwfzIzJ#`s=dJMPwj}9_r0^<j zxse+S`{iBhaV+R1iJ-Up|9V0QzBkTlH9l~PKS|@gj^|VOEGkbJA(`fK&U`LxTm|5^ zoe3vt*aiF~H7o<xx<=pE&y4qRZD)pjL{yF?krgpbe2czQ8Xh(bs_=8#igP)%SQLk8 zHa-p52pkI>&o-)m5|BZ|y;T2NA_V|(FGk>`2B;X=$osM|3!&k(VH}@8)?^-yM7vI> zb4g4dGyihXc&FaoaG*?_N>XBm(yrwU`t&)`W!a*GAe>m19Kpp#Uw~YP?viF{Eow05 zb`^Ydn1)a4NF#BdNE%HHXZcFOBR${Le7?>L%_KF#W2SQIwu;dDh(pKh6#snHghYFM zf8`^|n1H85D<G%r5WKi7fk;~5!))<iqX6?~LTv756&+qC(mvDbcB%r>DBlwau8A=r zqV5?Dr4{kh=P?Op?i=ExfK{8i>}~?4>dx>V&0?&hrTe0_DW8=PAU=smS@{i|EE3sP z)C?P;KaEofm~q>qgt?}7OluH19O>z|baSktm)lU7QQ8Rr;G~=FBElYRSN^#ryVk-J zQ0a3Z$z1a5Yk-q}2-J&va?bTFgd6#zd^gEk>rTe?j&%9gJnvCvfWgK5smzzRCl>qq zs4Ud3+qlu~i`$vsmwb=Yl3>>rvG~fCH)-~9In=!#y^I~YE<b?Wms=wTN^TWfff!|F z{}c$Fil$}ZysT(u0k+iwsZMbUL~W&^v|x|&9>{L&Y7q+=)L!b8L4HUfF(!0n&0JJX z^6aBfMzlDMeK(jnsrQ!o+}veB7h})Nx|^O!$5mZUi>M5EvKK(fIoEa$2&(}YwB_)- z4oZtI!-+GOKeLzUN_tFQBSB&4SThrTa%<go*KibOvTMEUD@$;%@iupBds<W@1cMa$ z9hoY`*ENici!efIoP5;&STghs;?j;+vYFhBnLF;1yjeJ7mFUc9jdun9U9C6woPLg4 zT9d=kLrEh(jXx@tTQ}betuZ^Y!lrG}_(G%k=K_P8@@w;Y4X=9(-rB&T>KypFiW>Au zTF#ZHoBO4b0`?uR_frwtFcV}fL~QmcyRo7HT$48)w!Vi_ev6~LC6dXQh>FkcK1o-0 z+hgc5^SWz1i9{RNe)}%8r<9eWDr7RV<Ei%<u&)p=$^687ci+dch<#g}&1Qnkg_H~S z*Rb9=-%o6GK9;<qWBmD;8Dfb$1sZsctQ+uOgucWTY940@Ry@soi}!2_%Q&I>^*cnO z4gkY7X?`^|>Sn`_xA$LNr}93W*}(z9D;<mu^RlaCKBzQ+*@#Doj~$D;VdlqU+;Uu8 zVvc7JT5q{}QI)Oz`IkC9qZix39*3TTe46=v8w8XuoIN$f49W-VN>?5H<>BR~oD74w zJ}``%ZL}a>1Uc+bHzSkklN+(1WG63Jh;#hOb}q#-!T1%B7tYcQWvu4To+|kg$Vy-8 zdk8))`ux5(;y;a#)fB0=(&~L)^~r^JG6<?p;dsH}JrIUlIuwO(`2N;OZ{+qM8`$Lo zIWBui4|~j#yFBDCi?!NfYfoIBJ@oR4|L>yhlXXHhE(xb{lz-<3Bc^L1p0?X<8&Otj z<BPyhq<4<_V)mep>3<W~<?K`8WE3pdBj6|cq?)+MP3~AakB&c1530?v(O0~wTmt|$ zw{ZC-<4X*$0HX^Go{4CW!IAI{L`SJo&;2XrvvxB$a!X)qY&_FoC@E-t<#lvL@Y4|^ zXw*9&J1DSIy`Y^@btOVwsyKkh(B<tZI+5zak}7s05|0HZj@Em9nwroJP$Fd#2#yDr zn?AVZ?UfXivTn!8DOOrNF&}=l*$MY;&1R(3c<O5?AMEO@vCsK=3ao2*@3pCir6DF= zx&%MX@xRGq?9V)AAdcUGM#CwDd+IQomukUu6RBS}?dp6#X`1LPisy0|;qUQ&-ansm zSi4sy#ilIOwg>0lB4_rr<T(_EFf$6?4=L_Md1Hn^etnbQ)#`MYbrvh%84)N^>_t(! z44l1x?h-;r$yR60ZA7*4TbmqvADwl7P5S7C-=nZ>K0e&@fCIen!Z(`lG+-!A2qXuy zHKxO+n(cj14YRu3v0+@g3})={PP|~eBxgpauVV{C{<3{Te#|kUfQTV%;P}`)IAIh8 z6hzdK{(Rh*is#>jmbZ+GHWB~L`dQqHs9Nyj$%W`}_pF<uy_qS}MFlC3gnt$%4W=xu zi(5o+B(E*lxfZ)k9;WQTy-Sl{QiP5~h;NAv)RTA4N^o0^?Z9KDT{Gx)APRh({1szb zV1>Ppi5JFe<d~@B<%xNNLC^0DZb(Y3xlZ#>QeT>kY=86i*A`#;`PjWZzwf%&c+h^+ zwB27gjL{mCocPHSFsLb9g@Wp5X=g*^Cmt{Ot^9ihKjW%gk#<WS0zn`;kYb!^aZS<L z!QrLvB6Q^4%sp+2CJn&yis7rT<WnUOj)cKup^<gAT<#$<uS3|q!c@oNl9#$Y8$sF^ zK)XpV>RMZ4!hoVY8eSC9;RTbhwB?(X-1dd}?$P`%P{1&CIAxYFE6ke=D4>MLcCDdN z==9x`gvHoo>J-ygD#NMjXvOt*G%$H)T>9zd5-hW<5*{@H=aG0{s+~L~j0+;{&#)SI z9-888MBOd6{Bu!+6WWtYX=w&uCwI7nJcI8PKxQ|e*GW7<Fm6v5$+rg8yM8Y!o!V=X zU-LUAQ;M@lJ1m>LZ7s=m_ZKWFHTXH?rb=qm&MCK=*B6sd*LuB0>M0o!70dmSOrpB; z$^n+8_-=(~x3(+Hd?_fwxrva_N=)Y^bkwgHihK4>6+~-?`4>Sroq*Beqi}2GKT_VN z@-1Pnu8mw4@dy(VBc5}KO9<NJ|Ac6SvGFarfQE=(>5W(Bq!$oUVYLq>WzL&|;Zu`j z1VtAgG8I}^U{G7G1*f;?AhmK;+#GUAJ(hva?(WANE~893)~T+TNI^P^Qb$N8me7ut zGy92Ggzh*s`%QiHpWQdG4kJ*JEJQ{)n{}t|r}m94ZxbN!%!KToQ#Sy{N7?rG?Yq_9 zJ5Vd_RJllYjU_ct$4ER}-laaYr??FX>_7lCQl%2H!8t~EQSa19XVEt-E~QO>z~3cA zw|sMf4`WZ6!t{3m$)1`bMSn&!ZE_;GKURpAq7@}4$MMp}KK5?ty_v#|fOW4d(BX^1 z-1~COk8j_w#}o2;L$I%cWnt~&5Tng~^GSh6)=L<DZx0xhqLbPDinBFC81$X2XP_oA z^S!*6cpeJx&0B#qXEExe^0n_5-z8fI8DzI#zHqX0A>+eS|AM1icC3({5~{iFvwlp{ z8Te_H7eKt-Y=Fvkn0=~I(waNoCuFo3UA5Beg|s$@YSn%=qh~{(*{%dBa=7%^$@j^Q z`mNuf7q9{w!z@-^y*c^b5wn_U2SDTApk;90%@A3cy)61N@ZK|&^W;IDVRta#Z9yRk ztz&|h5#1|lLT_ubd_GzwD<8>mwj>(4q=icu&wPgEDt?)#usGl^j7-<YVV-5u*mJ1r zE57j_t5x@kI!=mVtojA}DZOXLK=o}2GW<Mfucjk&@CeQbEO~B_xt_4cglfRtZ%{$A zDutHTEll!W<XzLkYWJ!;IeJH5r5i`Bq;4JhdUg-totWZ-zi)_d-MNZj5woV$!K?0! z>rv!mn3Qn43MbnA^`z0T&dZHC-I}*h*geQt`hgV9L$+5VBojFAYQ=T66XEYMbHiU6 zn2y&sY3oNI$1M~Ni)Hq{&V%_{r7oScNAI<4U#f~33;<~W_=^tqKJUFzFLJ7Ns(z;d z=Q;5jn-!c+Zm_Jisy*5#n-AJJYl)Qvje|FSpTY1k9V4v0^|1%&M$GG+?*?_u0L)jx z$n83|vpAyyLcryfG<R#d<$}{m%)Wl`$jn4+s<<xa@{z%ua~1I~r5GQftat9&i?vup zF@vSfzP{xX`2e?Pr(08|g!9U1rOe>C^{;`4op93Yv-Hov8S?90IC|FUy=GC3-^zoE zT(ZK)O&1d!@ihfJe{S7N8$HPDMb3KxsqTefsj9$_^Sqf7MS_Wmmm@{%<)Ynt_dp|R z&?BO?7kp66T<|N!4uvB(tK;y_-M*M{+k*0d9~@+KaH-A&fOsayIU)tSc2U`?Q2&Q5 zEWs7>{(|D(ArXpVb8W$K+Bzs<&qM5mC2t`;Y!-NkW{8pONA4o~*Asm8{cHXnM}#U1 zd_M-7F&8X9b)pa*&dVZ?$#(dhvh&973+JqeM(XDc^HA621T~klH#a;_J^u>^h#sec zU@^ruP=1Rvf3qeAzX0)4i&o^3T5&tpi$NJ=b09}pO6Z_$b^d!$`%+G)dt&b*Ap6*% zliBTV?FIaU1aLiO7#?U`xu*r1PF6mIw@2so$Vc<=5?%9!bBI(aW-tcujcwDjq`MHq z3F-4cor=tWi3E<}tAsDx)UiLmd;OA^P1#m?aQlrxo@WO-D6;{4;)4uLL^kfQWO|!1 z7oDU2<=b-}sqmy~s)9Rn8f^T>Nv)X+6o2eFAL&#zV(w~VC?s8wU*oxA#{W^*-kNjc z5gn#N<cMLj^dpByJi*bzv*@_p3%Ah=?dGhX+tdW!_W6B(%ePhYFpE#%Zv14Ue@NRY zJLxe|cgcYipUq>U%?hq!rVo3bSE)G3-rAYdc*%LK;K#|>YQ~QaDX-(~(Hd6sm`>js zFX<vyFf(YksT?dhz6)8=@e!r6EQF*%f%k{X13zm@HZmt$4z2Z&Aj`ZdXnbdVH!x{c zQRp)X!)LF>|Aic6Yp@+UVJ+c%i1WFeo7VkNLp<!zmjcc^3(~J>SFQ7ecj~So*OjXU z$^j{tTb>3OyY;GbaQ`PjQ{wTNk-H({rRk`o^{*?u(Xg!>UwtAr96T1%GLap%H~8ia zKNmnIU$7w`y(|J&sk6bu<1<opw0HymP6f5-i?25~^@9j);@;s5*yosL)jOxb_*}mj zGkv{h4QF<B#6KwJyDixgmK><hFQ0z_2IBob3*4CMRvqAY`Hvq?xv}%t0@AUe6jJeg zcv@SMwW8=qmTBh_O+OkhE!w;QC-~UFZ+GFB3-Ipdg6MIkP=Kxr%jhjUM@Fp`NOMOL zKtB>E_504fcKH7zvcglTjI%KGdi$JKBfYyzJWM$fU$&~1U+!1j*)^ogjJMnNq~20( zkAm)2Zda>q&72J>fUu`BRI_${)`gNEA0NJ1Fn#ndU**Yb4{t1#M_<4dOo7N<7E9bg zdJQi`>-Bd@ryjX;@2ZQsy*9RDhy;+!D26znsHv)n&)j$eD&mT8i5~S!rkl0m=x{sd zV0?*e(-+za&3#rtF|x#0as}TC(Z{{pP6+M5PkTWNmj)$N8pIwBBXPIKq^1j%&#{GT z-E0+>YFe`_^T09c6}2d%^WvBMS_q;2T2ULhB7$GJoAF#wu#0@>?@L&vN`9kJwJ5Hj zF;%0pm^&CWIRee?T=!9P?Kf~<T2#x8o-XW8^hiQd3%eBrrB7P{bZ|bFL@k^te@s@! zR<y((Tg)=yB>p0*lZ<+4#yF9q_P9BCcMXNv2Ch`~AqnFE1&>*lCk-5)yyj=>pFm%m z)=&*i*?5ouZz1s_XPpt}ox5m%O5<U%>)uky?|$+jCy%r$!|rGHtuhXK(vFG>GRVH1 zOF69QApG+9siN5Q%g8C$a45mNl(*&g#7H1m3Ag@(wov=OI90DoKVf!Q{xbr6CnY*P z<N%@bZkJ4jdGte&+&9@2qz5U{ClEq~<N9pki4=K3iv~zL8hqX@3Sk40Xm1-WwW95E zxm%cR2lBR;w1<_O?<M>6gI3NFwS>+KYbOF?AsUDqVGlTHLp&F<%=zV{V(5-5d6O^s zU@4s`nok?@^z&z+(2B}D0s+$$>$4z{x#Jhah}$EO+#!KZ^^&gje-gZvXh~Xa8x`Fb zw?^pqgGx9e@U!^o;9@#ml0dlk4E6lHPl+3)s;})n0tH&RV&%qzQ;|36l4;Zu;$Gyh z_aRLD5$!3xnB!19{ia)S7J}|qS3Y8P^5$q$D3rpj$$qtH?F$*GN%$&4i{-Gu)WJwO z#LMiMt_w8>cuGew4*vX{RNn6;wDim_ORxT{ibDA;?_&)xJ35%B)v!UcTP*hH1NvIl z$v?MjtvhwP;3^}Y=#r!VlF1Eq?=edXJfx)_)S-VOMqOmVdFY_4H7-pcXzfsL+#V`r zOBLgUUIjrcxJ6#}>Di`!tQRr+LOk)ASPL_Xg=>@Oy?z>JQkpG$cz$XW+|wyfRj$u> zJ~j?`Tl0+-0<%-}$+$HbCxw0{Esz5-x-)Xih<YwrF5B4~_F?$LW$cL0<}LhSyjQJ0 z`eA9h-*_7lGDg#b6P{cCeN-aNa0XVY4q95oB(_D+_*=Wt_Ou-caN;ENmuY4v+cZIB zwFThPzqqlz^~(q^Q&oE+RFPe^PiddzEO_p6K%;CWWa@k$ZF-5TkY2(Lb`4r9;#Wu8 zZQ>xnmSjpe!eoK$y|296@yPX*1-l2^vPtJ{D(HNWVoKl?2ahoR3KFczPUbeu5_;|d z(BTg6$GV*=M6OPKVI4b?HhuQG^vh4hULFot)1==b&o6TZG9HmMs8U?;WcgvX=c1nO zyKuO)SlP%wOD34X&QvyM?{Bz-ePs^(&lL-k-|HL;Xx?CcshlL5+Z&xAs;;Ll*J@Q? zR1&*xLY49`F2lPwH)Zbd(y$lJ<{t`Jj7AEFIjWm=lXxnJ)uzr*3bT&Nt=q6!rCV_F z^NKxVHQb)!A7DOf1@iGcXewL48A*l3LvW<u5Scx-@5--A)lbiztoRoLXC!QN{o&c~ zZ|_U{%zG|yXmHM`*e>d*ui-yI8E9vjm(&RVexknpYdP-ivGXiTO|8OUQf6biZdOhl zO)nR0d#0Q%$e}t}<*Bh59;nw^n5SM-1r=tIk}Bm+EeN7tfWcona9C|57Oa`KT{dX_ z1&!wwYdqUhcjT7L#GZQWM_Te8gkrI{Af5J-Iast4TB|J73p>-zy~e|qr4rRhnYe*! zU5t(UA>QQXT=3X2^OyCUax~65>o0VT;hKna_8ph@Ml3}s9u44)C=0km(Q;M)t->%q z^ndeeaJrBf_I{&%Ywx*CqT969dW{o||2m#J4VMF##BQI^4`5$x`UKYVwx|e<54OsV zy;s~bOd&8c_4RLojaB*N(OORy@u1WyLm=7YPh&29(61Ge$DttQ3QN&HBRC9v|HigZ z7Nt!X=2+iH*#*cv)(|*LkW7@lYKN7<mPyQl3+l3_T``_#0o0sSGKk_HR*N7Tgs5{e zdk?#!pbwhDT_dgjA!q~hmz!SFfHmaVzYon8o89&G&X&+l3|D~9K#?h{?85`M*{8m` zTYmsf(batkNDgkj1#--M35`R^Dm#~pk4&#TxvEHcj9~Vmi%GdJ=|7R$#DkrhY`|x< zHYi#CLyTgH_OWp2`&jmX+_B)H|4?n(vd^sW^Cad79;!yLB^R%4o(nLY;&IO$R>4%O zbDd_}`BP`?;gp7s(5&skM%1<5SQTKc)d0v{jnRfbHA!O|-bLBejtCqvgbG4r<!9(G z1cp>tsiaGuEM9*0EN1aU2bhO^a1Z{pFTaBanFS!hIS^N!ecGzmn0`jOx&h6+;<J$l zEN`N{4=O}}Ijl%?B9>YBryP4>K9DesmC|(t;|C5m_JJa(h=<x;4>Dga$ofKzy_lmq zF35m&pq&Gn^532m`)Tdaf20uO#Q%IwLgY?pRC1AKeshYuwN{-!pAg77N95~`Xq*%@ z0-({56SX2KQ=gL@p@Nk%MG@KrjN^M_fdwH@Pd|e})cs!CL>aO%hNYDKWAw5}*uR*c zryodj`ZV1$3R`zxaT3AFMB_?<O&|XeCpwPT6vAv2N&dekB*wu*k0-<jRj}9*d9ASm zQFnQUoaS=>4Ei|pN*TVFQw%bVY%r~T*)lsXBztvm?4G{qIHeq)HX+@_Phw&06>%M| z(7h-uFehr|Sj2}?qCxn@l+#bn0<kwaCpb^fXaZwl*C0Svv`EUd?Ha?j`~TjA)Q~Ry z0iZh2?sK=69qe*pse0u|aoGH=eGfJ5F^V8WuL<fPIxtIEs~!NtV!54*C()E+53A4b zy!Szyk~sj2i-GGUgkki6EuTCPZW(}t;dd$3wY$qHGaP*dl?lI5zWs7&15~A<udIf( zM=nAkYFnxz@Trf6MTEq{s!JPD#b=2-K(uGPYhzFJih(I-jL)$LWwxPL*_B87(z4T_ z#7w*v(4I;hLIZc6a4oB`7natL>6@CG+I0B`<i!1;x&nMijY{^{9<{zai<$>f_nxgK z9krX6&G0@px?)|tRHXa9x@Z=-$j`89>vL6ok_&2dUkJ>}oURvDbs}49EwLMgrC=_j z(|Yh063fB3-&Jz2PO@q2!!tOurpvWpD)#h>mUEk>IYD1DYRPlt5NHP~kk2&CJACQC zU*av^hp0n&R@)|wD9(3WSPyE2NvAfs?>Jv4j|`%WVI#>ax<Ox!6H_3z8&|l?H3>_> zojFd}gX71K&rIM~FyGXQksj~lL2bIvK*D*fnXV{eJm9VN!9ByWZ%&nK-EI-w(6K>g zSvvnjZPCdnV@IvhD;4WJ%?5VKgb!Y$FA2@g3Ys*mesZ5mw#s*5J}4!B{}E%jWk=j6 zsoOo0Gbp`kLu$=47(ga~Xm5cI-X0;ONYSoR33jv<K!u)T6-`9gH9ac_g<)ZOfEn!` z&bQu<H7z38K%YY~mjczxN-u)SZSK)I^-l*#5%l>R@P&MQMJo!}*FR><0v@UvU_~$Q zCH@IA#rs?j8y0(iO*T(n1-w#Y-=UsqKwvrrzKN?g6h}NZt3YdL3uo=Xg>$|My!Ho6 z)2hA(if0Ua2^REjh!9uqM#=>E*)sAoI$l{_KG-vZdz*MbEiRF4?82|_FSUzkqQ<p- zv1JM8S#bLK*6jLAewJvKi?J;dJ+@qU(lf{0@wBcIbM9Mo-3SkDg+jtatqNBlpNF6& z1x-?7pqA!(7F7hS%!k+LojC_DeLpf7(aF}hzfBZ~BMz_szNM4_{B}Eg9(lQRP=r<? zg>FESj2Q%u6e?4NG~jT|hSi{ew(<R@77QZxpu_g;EbKd#G7Y+`V}=AKgrJ2`(Z}9L z14>#Pvd@BYfEg|V^T?x^pj=LOjhnR?Rzr5if>vV{bW^}#=gLmRW%OkC9qRKMe|{>A z{38V5sOlE?-Jk!?68AhAM$W)yw4IkMt^m%ZA4@%<=}(5mZFLwSo}0K-lL)?v$9p1f zjPXhE#+0%O1#$9Q%KoG7W7aX2O6l$ht8jRFA6i7)=A2a1D^2IyP8tl{;uO=aF}rr; z{|GlOOv*GGC+Do%8QaJz8ney#$7cQp2<MDp8OAFHY+^pNc=gPYJbOKz?V;P28|#zS z^<`SpKe=oAvI0$b%ZXO)5DC|ke<?vsJuDsXu&a&tcj>7qg;wrrPo#6z%tx7GzjIzf z?n_F{_;P>4dIUn1U_oQ@*&DG%_Lmd5{vd12;a8a2(pG`A50i7D5y^WzK;GR6oB~&_ zEt2)8zMjw!(kAXwD_O_awe_)#3yxAscHy)argJAx32Gqxy4y=c!85=51r$;CQtF4V zF9r)fbYJ5rpfD_R%H|M1tTGB;|EAdroRJWY?*0-V)!SrI8<|~d!nbZo!ZF#^l`YKh zH|`A0O#CA0OYo+DtAGLSuApk9y>IcIX#8i*-U`!Ye;(Dy6ZQLO`i{Km&JQ-VzR<Td zb72JytrdK{U5dA;KvB5;=ua-iU?o9G?;mGP<%n0<Xoh`DZY4SqN%2T!bx+@Ehqb*v zyHh6<uhDP01ElqDBW53P864!W&>4aH4Ha#6H`Zcidb;P)rDiZxGW7oVk36_NiGsWW zyT;h3Ah?97nb~y#+rbn)WL0(Ns*mYghR6s^xnG6!>BoMnAA&3gcF`r$f}R3i?sn?C zg`W4HOCT&Ho?YhRFUu+Y0ViKSl1~4u1Y1Ef)YB<C$BblEh-QPUm4EJO5sJw(a7lUr z4=9RpK?|8pkw=}Bf48S=3U+R-v@JOEYAJfp^PcOpw4n;kRKfP(R1viLgE4eUUqL$? zU<4lfh2xp~ZVi?!crTo9l4>;RbixtN)reeAy{}#2U^KUKeBVPsSJ71P*Odkt9`gP* zg)W;4K)Fv2o%8;>p6QJq9@Wwe<&J-T@?^r$m<yQE3)lyqn-kn7KFm34n?YqCr?yz~ zzJxX)7imUf`TksV$C%Dqv^!C>MrCpbvNJCcO63WLU*Wd<X@s>F&E<#wqT6LZ(EivX z2q;oEhFNi{?CffyytW`+o(VY4qyT`7Sjo;h^Rb8oEZv`EkGoSAG5t=@C9&MJNNM;d zirqnqrf^}h1=gNkritCdzfrioj~t07NWJgjfhsykt+;&(%fWM387*VZ1>k1vl6@KT zptSShpL=Hawaj1PXQ9#4p3P&$?wVZkmWJFJb@e`yD3ea@BjwU%y`-ZOs*Jni%pcik z(b5~Gi2<BJgY>)OhU_%zdqUM_Bp+Vrfhoe=de!fX9(kJOULr4$)ff*l9*?Ly4Ge=` zYcZzZQWEtrj9B0w5L(mxI%#2oS|L|?4fpT@yi?|I_fP1J2e<a4nZKG-tJPv7)|yAT z6hJ&4tUh_2Q|SP$BTyvnCF-e`@VYkwx_Sl~O!2I3Jyf4VFZdU?_Z;o6o*Z;*R-ass zl;FJL?gM~6<!-XiFAb9Es*17&m1=bRDCLnn=^ixT6@03}YIWIOvm+G^S(fSudzdv# z9#rg&)KZr{w<Ye)zBVg)tK&wgkzX6qwU#pPO@3a8T&&^EaMnCalyS+@Ni#UWukDfr zlCm>t&CA61Vm}zUx_uVB;rJC!`L&5!wV(;zEljT*Gp>zsdZS8T@JbW4xRhY#z<5oT z^QCw%=h8Trf(||3O(vc_%EynT=C1W;Hfwjs53pnQHH;M~gfs{Ngf97hETT%cG=ps8 zvbmOF*>lKR(aVg7_UHM6Bg{LI$JC{yPUTE;;I6S-r~JicuI1!H@5XZA!o(fzII~|f zF8OC|{V~?np*Dqq$1?2$ZAC4MX{3ul2UVawD0f$UjWaNDRLHbYDVL4$nSXw@4%TP5 zvm1UV`>~1IF4bc&oQ&IiDux^|{(um*ZY~`4?j6ibL(|2O_xwX`*OClq>2LoBMC<J# z=`tQf1#TbH8F_QRzSSPoIc<JZ$fhf`5?ZdluRS9?TDtdAGjm|amkNlXWQNWf=CFQU zlFe$vN+xdesor1PbT}uZN`(tSS?^<*8&uUqWx@-V;LQ`@EBMRagXl-f2j|>Z)#I++ ziB%rI55E`0lhLl<R`7e12+U5=-#xqSx>{B)w4r?iheBm5=kSKDbiTh(en-8IaVvDE z29O9{XqO?1#OAbwr61H4?2E>!Eb`qUc1PTMJ<NUQLuD<@uh#?t1Tmx7nN-}IGe4>7 z7wk^d=h$hNrX+9Dm$HLl4@siiZW@F!jU<8QTJ77c9yM0KN}JpJyeBeeq0nu#ADqFT zAwnBDz`&x7=oir-<qKXcqK}ItH9ZiC{OWRSGT;l=B6Y#&8M*%BPa^uZH5m0WDYoa% zC4!?!mH45>$N0Wjw&rr2O`DI$eb4HdPc!<pRR7+d(-7SEa9IQ*rHaNIjEl_{W$-j3 zwn^{|;^3=egdZiZ(@*Nj`T{n^q8DK;azMe(5T<<3nQUO&41ktMgEEXD-4?d(BYCjX z`n~nu9R)cY)g$h;YC=tDIO@h<8V=m!G~@$}sUZKP%Ng@$1{$fxn1^LWH1AcIX&c*! zct8|BM4QB0N1z}NApK#4l<m#jC81()ZF<s3>-GDm<FL;86r*0U>q=4RDaX{mxLgvW zmq41$w5vIvC{h0UOR23C5&RzYSQmKsrGc}I*&euo6xQ)MNpN(shaorf;Q9AcN15zQ zqj`M5QD?w?+stNSpo{m+N1}_%$4;z(e2;2;hD~XhW+r7e@3aN(*U=j0xpiU)M10qw zerLlO;K9|bD{GyvC7636HqO|l5Dp>f%irJDFn1+SuL8!^-e-0sV4>`k&_<(224L;m zSt4A=sE(i5vWWeUTj$+>0kFL!4VZ(E$e$}y`jrr?$4Q_sMzoDP??oWp<cC)_&&?YX z9kE5SaN@*V(d48@lwgzpK9VqA-`qQOID~1mco~*e<UaoExfO{as=a>~?5kMLWq*u3 zT9*NQjKlSn0BI?Ee63S`@X}}MYXFs@vo&VdR)vB!Pxhbjy9-C0$|+v<Oy?)ot98mH z8}v8bh4X$&^3!1&Q(0$j+up4?CHwOI!gs3ciLa>)i5<8y)MkgaV$CCO@BBdfuzGHr z)}plBpAG3xOO_IpLCpg{O3FzM6J;mV?CxM&g>$-Ab=h!6VG4HNkUCL@FU8LIcPVl< zrz1ZK;^$7oLf5Q-*aCir7i@!bLu7KBh5OoK2PJzAKy^8;EWj40Ub+>Wex*!i*#I+^ zilr0JgK3|Mk7@btV|-l}8B`JD7LlOAxZWaXlh(ZYEXogjtwxo#<jTa0H$YM3wAT~B z4^h9~Z)!pU5jtjDlXkv|0Vx9VG4ZaA3*R>LBWz~~zcQ^-alg%{?fjCGMPqs_Z|oLs zNmp2+c@H3scCKWRU?#bv-alaHV=?KAkBeYucLLC7kq8ZQmQB&VT<5I#>2>weszS#= z%%T=tr8c^m5sG!EPI6-Gltz^pyeHQbGyo=T?0w5m(EmLM0DkdpHdRGjsQF^TU#4uk zV4S$`p+#}x_ny_79l4!mR@9t)`pLJFX9eK2G}mY{lN8429S1}?7lmB18Qv$7l@1S{ zn<83cKVgI{nfbB|szjS~K9C@y_a+8gTXsEYd_6`y+g<szdq@gI75v&#BZW}RA9F#d zHg$jnL2pdGq(EeFvDm;r1>`6b=D{2|@ODKsvR(>C_j-M!LvFD{0#yXio+d@_@njvt z?)Vdfq}3pO{So)~Y#}5rAt%;6JP(B%Xa(3v;mW^BMEMC*b2U>{CkF2Lz&B76P9SU- zfuSe<B_(}7PGi}FzuwsNO2KnDJHW`EAxz<<6L(AL&I9xs>~SfUsE;L+>(jtcMGQ(# zGd25yro*z!-wT)H6wHN*>$+@Bv|t0@B-%_~LS;Xhs8yXH+PLiXPer<%;T(Xk!vS=u zsXdz-769y=qG0};s7Ui62ypgBtC=Oq-GAOXg5GNOKU6DO60AJcczyhbPb$=J@Lzn( z_F|_`bK0aR=(FmPw8@Cb{6*QCxKEYx6YnM-`PZTCBGTX^$MOl#<+cD&{9`LlHVoPE zxI{@v0Vi`jmz0{M!zx0jXpqrz@$V3+l_@_~qw*V7m?hFR)0C(Kx1}VN*F5XprgjZ) z``Zb=d~$4ZF=9p*S$T$lAR{`w2Ajk<O_Ie<dU1h+k9gn%Y1D?^+NX2)jAzY3gY={D z-UO}le~K@$gN{@YokxgrhU)k+?`}vi$)u*|^Ce09vF4HFUJiFp4lEqZ$4&M__%1D% z?8vcQlJ@sbz>8aUFKx$t=%C#@@S}!OR!s6Kj<NwM5jVij+aSk)LH#-9)1$e#yHwWh zha4_5RLXi;+Qb{WRobviV}>b=ady{25}l}0_Fs-(fLn2u8ngDl-+n{@TJrlK4|9Et zKc~RAN{7*4Oj-!v&H1tnqyTInxQ!qe48bzFAg@(Tm&W?e6qU3=-@rlJLtN<6`XO>T z2Z{V)y)nd4M3!E^8|}Y9t0J4z_4#ntJj#z6c=-3U0EOP6WB<#5?u8zd3IdZF;ag-Q zsYYK>K$fzQ20L+(sEks7I2pt<;{{|h<XjvxiH&B%LckX>BdRNCosNm?#QH8{(@ANT zOj6cPHqG{o-Bskv%Vor~Vftv3HW-y;e4|!K(lR1T%t04j$j+)#t3YXuLm*<=sF=YZ zU4}Ng=%94*$<O(~MSts#ttNduz(*K)B4rz{cKo=}|4UmFWwefvTK)fJBNs9j>xE`M z?$n&07Gvn?AB!WCFLj|P^ngKx*D7rw1SbJ60dSG@|Fif0Ji@n_uw{qv3)h(O$c;8h zmv0*9$!tthZX2!<C+P8b@4Tj(L^sBMtONAo?@!0+V?BYYNfU3O<>r(4@0Jr%#r}go z;s1<WqTHwo!Y~;wlv0&bBdA%ZgyRX$89^hb&j2_NfVLB9ul|zWzkj<%)pApTraK!C z^&`AlqTB&s9|*OR0}tEf=|@4&X$Ow{{Q{zYXLtBBO23qPB5pzMrUfEXi_mcl0Aov` zTXsOE%FUHo@N_i;hHD3uR9t!`(0~qLY{Lcz>K1^O&H>O$ELvv^$Rpybpi6j+K%+LG z+gR~;Z{N-WXmbi&W`6~WaY3G%hXgO6L7j62HNh&8zrYB5h~M<lEkV~oXr1HZ<M+zQ zG=p!C2fq<1V;<OuHmxJpo6_v+16={in}E)^88(1}>HikOl!|ua`r$uK^nQlA)&#+N zbJK{Ljq&_-ds#Z2CI>n(pBNZrK7)YmTg&ge^!p!2#^F}!0-KCXa1eyeggl`rKzn}E z^Ptrp0Kzx>^pk@k^i65x1^|nUp?OS$jrc1NY=<ZY`8y>4RQ&QBtd#Xv$qwZp(_0iW z^tBhk{~<6Ww7^Jg2?ahIzBL1&4)%h_KJu|L07Ki^BmetZv?P=p^%)@jx&j>Q%$IZ| zaYRQyh9{nSRE2mfag+Sa02aa;){Mh$!>>k6>cyqb<NP#CME30K<uQFy2M>M{w}5mJ zJK&B{<lu}g!g}HRtiDd;&9{nj2^af|cKp8KYCZ0OjI-F8K9uTOn%Z@B4gf|k1?mbu zzU<*)N3rWa{;@H}UeiTs^7YTAKm$FQNyXUE8|MPm;x79Yj>{&93{&y=@3|&u0C0YL z_i`<cuq)If#AbcCxAl77`eGoTihi*C^yLNL)1w=qgP+b7<^&%B!vyb@11Tq|(5!fT z1rp{{iy$%=QfWkjfEQ=kB7;zoX*E?4)E-g<h%xKo-$zF8`tbhj!!{q|EkCY)-Ef$o zgl8{wl(dfx9bLHER_kI!2t5jKPhxl}yketDlxs|$dIYkw`(T^V4qku}$8j)f8Y9!N z60OJkOHqUmiwX|h!2#)^K(K(6<1zABGxtH6ArQ@w4RD!jEIt5c0e0rBhH~5$Q(`tE z2P<R9I{Babs`2w+;;QUBHkI2ZpAP7f7ZFlxGQ1AtN;dD+ch4R>X|^bFH{2kNI9o7I zPO~WW1A*5Xtn??S{(!oAv&kU`%AwoSugGVC*#S?iYhMRcSpyIx%E=X>1VlKVy(6F6 z7rYa<CVeO8Ao0(#7w}nr^n;WK_yLT{q)ISNU*yIFknOHZzxnfkDV=<DbgoprU_bx% z`Q{H^l7!T{;I|tVE}dvtnWcDm(Y<E~_m^n|+@Cev4{#yE8PxmgQbIt>SqbYN{|Wf0 z4k5W_hbEgJiBGl&un&Ho6H4JP;vu9~JTO;l?rT>!Y$5+lZ!O=rS9?8f3Sy6w|I_Kb zi@;5=f!?qTT}lCuMpW+5-K-+`w>|6sr{MXXld$*rTC&1)QKDX(*_6`h-OfqxNg6iG z|7U*LZc7w<7DKx5^~{-x?!gT$?|`V$+c@{a?n9~i%<%pX;RpIVHn=ZR3Ov^Hdzb_C z+3=LW1?tq7!_@7@kLL;`n&<P5%8U^SiL0F&2lB>!$_;LBw%L2NYd>E?4N2qDa#Q`- zo*rwI^9fj_Y|c(MgCch}(*EayEd|)#J%PI+G4{S>6ds(<0Or~1>gvWxWv$+P!~!%C zIq+t3ZQWTg+#en5RV;t~8dYdJQ1HO?r112}rFb8QKi`JNlfd)ZmOGqo1SmHyj$;$< z$#~|?`_9c@%?YcHdQ<g5*?DoI>a66yym}qT!_XMcU1i(QWxP+tyr<$IinbKZM5TQ` zBS2png7X221clGB?Vo?-ts897vpqa+P@2s{<$VT^{Ma0fkLN+9&tLTCzW6>&wrDs^ zmGcnhTGH-FG;OZ@0(bK6!2JWcpBIWQP`7I5|9GeTMEu@5kW?(j-+zI8#X0EIq`^^* z3x)0?JY}Mr$rh&B7w!fGf%|h7bWBqd@$a=U4|)ueWuH&6E&*X2C$CZEYeH@qTEq%T znf!DBQf4~7GW@i#NAqx9-m^f{G(k(g8Wt4`T+9xTk$no@@Q=7|_PKXRZj|j*E#IhK zJB{4%z0;6N*#jXfaGLd3U$?-zi-G@K5IqNGVe=cunglcO8L137_>5p%qCfQ1zL8N3 zOV6$AuCvmwfti?!+Se$T2E%YjE#XTL`*Q#)1%~~j|2VAb$(v`%{MkF6uC6(|K?y(L zGq;HKtvc-J$M@e?=Q$m^EV)VJcA3X!LHFq0$(m0upt=gf@r{NKRlzm*szFeF%gs_; z855;w^D*-hG-76I_<rg!(5~;0Po${XxVq+}nGp<I`1rSpgK`2{&J=++JW}N?N(`n! zpTn;VFmd13#0IE09>wX(hW?<K2_CnM0h*_H2sO%a-Ee)gp3v%F=#F#>MgzzzU5P$} zMgFN!pK>5~+W;-l#9T+U8J0O_y%3xP_I+7sAp{J128V#JQIG{O&fFYI>KjTQ>O>+( zok`#$#)gg$K{S^ee*!EfT0@a$gV8^?8_v9lk_w=Q=43x*Ig7#>J8t>YCCUd#Gzm>% zZ!5xfp_$2``G1>XH}J1eA-I}ZDy`P?-mW%W(N<VI=HD-$F1=W$M9dW@zd62;Q+*+$ z$w4S4rorf;hOHYKIW^#U-}o7#UIXs)5(P6MI;Juj;-1i%M~lPnW|B{V00HCIgKe`K z$kw1|!AUH!>A=|=tq_?f>WB+t*OJPb0Ficg#E12-C7S8?Fk;7kro`l;gm{43`mR-g z*y{V%9}rPn*o=K;DW5EIKvYmO=EQ!Vp4Uc4ynM_l6D0qI66o<Z)r)WaUTXw-1!SVd zx7?S+o3Oy+TsDo3&wvoNCuShr*ggvkq`yE<B<4Q8-!4Uo)@}^&&aAA?7N#$4hzklM zcYj;tW*58k_sg&J9y@52k4dhvH=cO?Sx9`MNw4b)@4Ygwk^{{<=byF5$5-}}wE7fx zFS>Vdq@-<o{QG*?fqQ2>h5yKC?p`WrhOf#{ruqjF&tUg)=^}b3b6A%X2c;(uAb+C= zJ2mCxupc-%urBG8m5_<!HRRc*;E;+}<b;q7IL&#Gk6|Vuyd(;!gK>l#koDz1C2RI= zO=>3gZ6KbLEa=&W5-0-L^!81W*=?t|JsWn#-(v%<R$NqNPGaCP9PZ|j=0)g`o}>}d z=lp8^-513yGr*d9oou-1WGc8iB-;G9B}grIGb~GM;{BO+q12H(U2V;!bG%!MLY_mJ zKOOOOrtUoV;w$soh8$NTTgu+_^NK+YWlAU2Ku9E*kL!&?<2OnFXfcoJ=0iHgBV&*X z$va~fjPNojxMQ&pXBr=<iP_Ru>&u6<G}As1vGHbLj0-<ygT!TCC#Ve~Qm3WkE%d5M zUoO18_qE1d!ge9nXd;YemW2{yn5LxSUbfGvGZ~`SI%cm=pIK}qlsAKM&mk(ZuTXIK z%_@9xv-UNng1S=6vX~Wr>UZj?rY|;Wm$IDKKR4%OaP7W|eH<WeIUn(2&{xy!c{}O= z!gtge#yRD)RwbT8SW5a;(phi7kiZWu#0|4iauPlXM|xqDJyh-@VJenIJjYR>T}x<Q z!Q^CiNy)G04aQZAx*}{nqxCB%@#lIRg(J%yv{gyjF#WDE82w0ZHpiZlJ60-dMTJDi z+){YjWyyJNtH|C*?ePGSi^qO^7)uXjo2B1c+-x@5M83uGc4st?YY;E7%~;}Z8zyj1 z4pjZ$KN?=oE-cSps`kk!A^zvZ9}U(|3(uC=wW_eieIK45&Dg+o{i(opx_ZY{UnUCs zAZGvM(^@#VH^$kn)9pwlV0M0_BjnAi81axHnI#Rzp-2;mj-&v%8mUacbq=~hO_E0b z3=881l(qOYm7U(@jRl?IeU8G-91m?3ywPjIDWDD9#iW={dXG~bDWflXH~VEyxe9*l z-R!IY@C;&vkYWs3yH;Zrh6T>4iuGkjVh6^ajL$%~-_cHkQmeueO|HS(^^q?Dx6X<h zmRV-^=PDDmlAMyVn3AWhnyQG|2Z9nVelOeI^88T;NeSF*4!&7h)ovRj(e9v@?Qh6D z`1A1xk_PXT`K5!g(^^oiJ2+2((u}1ggO)KY8T#@GoP)eInC;NI8Np!WC2D}h1d@+) z0`s7UZwt=@tpwt}nt+9~K>`f4%8eX07o7*wO@6iz)dQN_)m;}VktXpjeKi$pCBLR{ z?BG@nAS%6v5;qLBUhd0jjUIG(`Lu(a;x+OoAAJi4;Fs=5_>F~{PY#xYmg74oGa`oC zom`!qX~@Zmcy$Gsc{KMc@{6!w5j22oA|;f;Lyt-U5-(u2=-I13Kkab-Q;-N6c4e<V z_6n}d^AJzU>)DX~uTXzB|3Y5KwCSSl9uXBTuS0YvCd$07*uUA|rz3woPg7gvzWBXw zAPrAc?=OiRJ{9+*>|kV*pf{fM3^x*U?}@81BHZGDAe-gb7;^IW-Jg<_9ts{IH$Lh< zZWz7y%!F$C$~O0@{;@OR`{Z)g61FeaUG`D@*RH+o4)XtOli2$)tvhLBe_-g(LOU7X zhao3vk(X~r_Wd1L_tBE~zeqK4x7FWKG?)8NbM#|j8!xLNwp-t1OYYkZ{73T-@pd@Z zmiSDF&Q9LzikhFvo13V=qtPd47c$T!)Ty}6#?0>}Nkfz2T)qeB(48KzR#M123_(96 zBR)dbUoqPDa2MGGyN}<zr0KN^##vI$mm^6R8Xujox*L?j{?_!#-~v{he4zO%kH$K> zhbYMooowFohnjcpZMPZ{o4xw50reEk6fFnZBQ2{Y{`nU~rC!vU9+CLl(%wG7ImhRt zXrWRZ^i10)II4YI=}uGA#<Da@@L?((66dQoG;bhi#Yx=HI@7lxEtV<I{a9A__`H_T zg}jH_4wKjkhw|){teml}ym}(awAbP={=w#=6;KP~BWc-H&mfG;-%MUUJ|V#lFo5~D zu%M?Hsz;$b^bxc9G@DnlYI3N3C_Vhut5<V}Gz<(Lv#KMcn39XF)+zt)+Fz!|N=KW| z7qm0q3%bufmu;R<e=2fh>d2H2!SQ`6t}sv<P}bmSl`_)X&?26kC*xlx@5y^lW^KVX zGXP_rp=0ZPxCGeyt(^d;LIY^Zlv&ZDblUIb3J@vvbk_m4QX_t%6UYuWv@}M)Wsmbw z$Xs`E1C;J2aI!%T-dC!Qc7KL*_9CDWE9`h9kN&-bDa~z*59Hcg-O1Z*#+GQlGN@T^ z97kBg+We%f->=^$%{tfd!_ysiaB9cOV?7Zo8KD&HA?{1rozhzYLLiUxsq?O55u))Y zKit`9$&Iy+!WG$fk7E|}7>lA@K3pF(6MaJocGoR?yeOAa55QlpuoM}N7(?wrv!O~O zQVai96s)My<@Okq9$gw1>8>4BvZQ;PFuTaCF}L(+uK{rjFeEEWi!a%<pv-arO46Y_ zy8^K~Q|<#Pjbp7p4NAKo=EneV7d3Cf;vL!)d7TkD=?cvAECS5E?3*F8?qj>;)W>z6 z7m6M=EE^K=6!k)Qd#F!4jN=nSG#0bW1?tMYuw(Ln>m!83^*1u!y@V|n3z#;afkRLe z%<XddFTm(X{yV~y2JZgbHr%Vl>q;V1G69q^hGE64h)34{Dunyy0F&0N`ETnvv=2WA zIQayU7mHl|^0o9k^yOA?7LVE?xUa7%I|aGe$~gB}pr#!_XG5rBDpu!E^dlhH?P<_H zpim}Qvl)r&(CKD06gPK6k;{Y+@6Ou`-^E;!U?4e>qquCwgm?<8eNN|)ktO)DN6pke z7^vKSi%5yiV?DK35Ibg<*ScON=oQRYRw(__Aps1W--~<A!7$Met2V>1>5cSe(7{%! z=z7s)iWSU3%a{g^0~6rX;|5>+QBJpBW?C%Dn8|_3S?rK2XELdpagS1p3|?osjgyH( zNzf!+0lvuyh0&fg@L7s~{OuEv22iIJN-mkX>I5*Rdku3)!-smpl+Cw&*?+o0-+I6J ziE~O@nSP4AZpd1ASrSp`>Ok{(KB0YMYc4^&nY8z;D}OI|P<3%_Vq&Gzc`){3>hdY* zd0LR(du!5Z81+<IP=DD4dL%9iL-w9UK|Ux}Nfs6!y;_ujQIc0pg9g17;;5)O*1G&A z9O0`V`xC{*kH8;r7(mi#FSP#YgWxFcQ3kGmEls%^Wu!umbKwjnCJWFnGZB0a@et^k zWrER*q}U#x`PnOg)EmNn(3}AXfk&!g9hJE0=;iNmy}JIHXz)Xm9aD!?5U6Z`F?&69 zI%ZIVqrn`)N_)_t!aWj>T#}6?kl5TP_u|hO!?5C+k4Po3a1<pxsm~o{%w<(20i=dD z%=n+OV~QR8yNLCmGNH2~b~yeA5Nb35nXtk?5H+s3dH8!u`45o6*&!}ui$0cy+hfDv zcIDo#-a-Y1BvX=8MlH35vC^v@AS#crG<-klGQJL^qTno$jGxa`)(~NVdRf$0Gz6E% zrj20ifwy_IAHiH?DhQ!Y1CTZl7B8bMzW^N3tQ_ey{ps2A!0G9qE_SR~{WEFGji7Y; z3}>^aVTHzS-WvRZ1mN60;b^%a148>)Wt_>l>a_O_N~kUO#FEmA#iByON!!JDQ^V|) z8Acc<m8i#Nb-8k~#=QFE#=4U`CZQ`GQB?GQA*24MZGnF#YQbxKgRDf_7U-v|yPV<s z3_ck(;rJ^4RpuT8Y?aY_WE1S=1|8oGd;8qhY$NaYf>v36mcnp@``io`3H&0vwqEJ~ z{1sGs`p%xPKwvm-@|CXC9Xm<&Pw_h=uiDMrPZ?r1ydiD_dbG>Vn{*DxrKkE=#7$zh zXKT5<7(2eRM+&Q6>TG5t=IK!CVPnYMl~b3?W5mnE2@R8}6+k`D$;!i2S@a%@(G5$d zvu9!U5{<B0|KDY#^2ga8OwObXIFdAAVg^8Y0M_bP6h$~9E&-XQcS~a9N%&#T1%py6 z<<yhZ0Z$O@$VF26%qp{iI@*hU-FPFMUdL3TggqyoAHVe?%B*e#>62NXFyoFb&U1Nw z9h3@62i}2=dArX$C|D~0^m3k$=)~GnMDcn|)(WcyQA@2EP|z_c69s)4qq(opUWoNy zU<Tc6X}H;sd9?f=;?W;NcLdRja89Q3#~XUPp?DqwT>|F`aToeCn+{#LLyJd}Y^J6* z<#y_@o}DwPp;u0DJJh~9&@py}n?ApslqcBWggwE}KMQ6a)gn#xdch7vhlCsHE&e03 zD>Mo$rzDwbLq18kait0u7@Dcc1YZNEbZPr9M{>&F>H4$$Oy=BrvQy<p(2DVB&)ne( zW>*{MpXDawR>?1oV<eUbT<`d^9Dwe0>N0ebW3!>yqjV4lNjX@5iV<@L@<iHoxTA); ztD(@%DdsvjD<v!J>I0}e9i_&ta|OUcw2Z#Gp;OoTGdN9hfi0aq0#1>cfO1R~Cevwq zk=y}k=oNMipvWpaf07Ql-wXM`BE`u-#`7*=F^*Y2)DqFtaEHqS{N61n$AP!L1h6_j zG?{;~gx*Mj>&<KXWMO6dfsfUUlg@`9wqVxq+tN3K_+<R3U=7NS>i&SqT6=Zl-#Av7 z!5pe627h!<aDl${TlenlS@Bdu=IUTS$r}))Rq3U-5eXVXTrE|?Fq*`->3xXUbeM4w z3&VNji;|}?l3uTiU5esyEQ74Ukv3v&!AcWe+pS8QtWl7O4o>g1E)npLmPsbdyLgu> z$ncBkS2ViU%2c-EzE@yFKm3rDmMyqo<Owy{f_7*N@@ZanKO&Dx%B&D5^x2=6rl37M zt=1jaIPTRun{(ICT%M+c<INph&Xr@lc=U(c#f$AyCRY|)$~R_>6_;8yjIb33ucnW? zTSpb|@*0w1b;uH`C_u1f0lsJmiN$|+#Nlc+o@jW5F5<mHBwSykb<Hd@t((X<uES0$ zla;4grwmIj-%MIh7qgRW{&%^FS_@sVG7i@<DUGpS*z#Czt%!bitYwdZjL<;JxQv!# z^rgjWydkCCwcgG9T<ySgrLD~%-5ncu-&V@)<9_14nVXGwF<M=vU46YeX=t0Pc~nU8 z^$w{h2W9yD36`K~o#Tx;I%Q%c6iLf88%h{D;io9;b+f|+J$Ju<?)|zy+mTcAB?tFz z1&7o;5$f{P@E1_p*?_!^F#?*W&<q?`q<t3-Zeu`?I=vPUs-Cp(e|`hOaeFgg=R;kM z)M*oJ5$?0|o1U>HTah}RLRKaf(7Et+i_lXxKQg1S({NR7aL~`)Ouz5By;74&q!Mli zOqBioP5-C6YmaK;%EPQ$x(h|DfK(4sY_*n`E>J4bVk{z7LBK~Kh(;a~vLNCDQV1YY zwbU+(=#m!7qb{;62_zs0K6ss~L^lYiK&Zhg7UU6vLL>oF$$mFNbWh#wIs50%$(eJ8 z;mq8bxpU{c-|zc=KYV>LYp~bzZ|_jvXrQ&7T=n^ImpN0nH1<O6tWMBmW@9%pt;LoG zyOtrj_()wfiZW^&;k3X-?BEKPlN4CcR1Glk-PPS5B8<jN;U3V6t(BEk<ztrB={zVw zkl^T_q+(B`QAyHCn(Z|AjDwwXJIXJ1jfsir_xr{8;;^K;1=0d(bWtAb&>eiX;&=~! zKA4{ee<&#lK?*`)Fc+7^jXbKW!H22!<;b~ia3j#G2U0-rTpb17w$)uhBnU%N35REg zJ_Cp=W8TX41EWxaFM}pH1`=e5KpSLmny8Dc9pez*l&u_&Kq85ejR3Y@@9+`Zx<XKB z+?W)T)PX>0#;4)1DMUb^OoGU*+4QhC5|QR?{1TCSTKV#aXnfdN=SIAYSDrhB(em&Q zO`75h#<H$U6>okEk9IYH7a?|s3ewk(9-ws>%@UKO-`4)C_II%ym`!EC{fLvj{dOR! zG)}CB7_WL;V2OxAes97c_p@Q{>I5+<wM`YKzni>6+Kp*$Cs?<*wwk|_5*MK8B*Z&H z_&MK;Vc!9*ep#h`ggV=(F5<lwHa1OBea$jCpR;23J-A$cHsONIJWu8t1cu|RC?Za= z-ukzrw!1I4DRK95O>F3`2){596_m%*h+4@S^K2@-6YMUZdR%B>YBATlJ%K^Q*Y?EM zan?4dIOzaTBMFj&hc_<E1IcVYZ_mMY8bQE3QWR_9^lTd~Y&OPCbA>|12AQNeA8c8a zoM#v8CUByO0*)0BoV8hu)Mt}5CG*YAiGzb;{H5E54TQ}dB6(<JrU=w#WMoY3Oe9sx z1xIOxJeRv98VjU26kXq#Nr`3}(oN<Hi!jJ{RD^mNCexfnIj{8ZGmsM)arYU_+U6|o z`iI^w#|Kgvk9*`bgJ%OASf(ZOkXfU0DiM>$wMr>s!hwYQpzg?JmvsCPh0ZF0);^4c z7AAHPa8CMd4g2FIZS(z>$S8d|!H!{VPZtQer`y@u2SOs=*&h2k%euWoxK`dK3_!5Q z5w|$D-w|Wc`Ouc(6sGsUqHnm{iJw4T66Q(2@LUsNC>QE6+Rw)U$`J)tq}?y*N-EW2 zzX5IlO=>bnSopCJCXEV`2zk%l(AEjwW>f81owk!J)pM&?4X+U}7gG<_kfe*&G)M8E zdP+$p3d|t{QN}j=9^;|r<yKY;U2io)*!`L1#CJyQ^F#}#LcWaJ-blR4EYVe%%X*?O zEBbF=C4vz{?{+tO^!3I<y?cnS3u;cde;NS+!@h?NDY4JT#1gRP&SrdkV_DNG6|~J_ zO#d$wh8mTa@tSd#xi27PpI8Q-Jx2`JmVt5i2Q8h*@OdL2T4%+&?Ir?J9HsRm7>qgA zzAOBJDq4EE9k3qJoOt4D80p%JvQ2$#lfkO_Vni%SCm6W{iLh2G0(NwBxnWQaKgs0k z?I*<-pA_ggIi-TbkI$4ro~TS;=kugE3CYV~$tvYC(IT1r)~tpR40FOh{_soDF&b`Z z1a$FzD=m|E<V{1xDI=ZcIj_!lw4*Qn^}u|<^%NxaAawW;?7eee*ljeA=F~Pkmf3`~ zc3*Mn8u9MGND!jgX;Ek~V+X`G3L?#f^T^)iDO&j}wmfIeL=VY6$R%c?jo5PfgSKhd zBF%X@Y&~46%`}014V(V|Px$*}05$f}yyahGOz?vexs(*_f#J?fhRIFUjT@hZ0|8FU z%W+REx5rfv-*=8VaeO31-#{G?#wEP{YlGchmCmBG8NHo$u>o0{H6?QeSR;{Q=y;{B zLC|`!QAA4=YcC}>Z84qszptmt%@&xL96a!r{sJ#{;^<92c}o&d+5J&cE{490jIG4! z7NJr^bQF2z$L$H-`?|%$GI$(cwuNwjXR_x^Nk)C|7Wq%caAQgr?lk=>S#_1p%<9F8 zGPV*!okXI)iq&dSxniDLky_qlFZ!)j4qX(8U@K+ZX6Rv1T3=cDlqw2uW9^->5zqAH zEEV0R0!R5Br{%A`;0k`Kig>WUHbLpxswl^KLpZaicl)6cIwEXD9S-66F)0o9qD|Fi zRpH9v&T*Pr{nSStKT$mF<;StfLP05^QEyyo*^AaiS<w%He;~;pI;2^Q<54y1r>{tJ zS^sI}`828%(b>}LuJRq}MK<n_Z6MAUlEB?b1$1KU{>dhXmZKf$1)AlQ{W0q8OBF2x zi<SzOuWA13+dvZh9CQpDk8)84ll%TjMI$A;kG{8uaix;syvMWuP}*ykn-OnGs**OA z<$TCq`@Axw`Sf-3q-VEZoOslI<&O%0mVqNPQF7=9Papf7U313w@=lKr6P$1Und$1f zuQ2>VSY1x*^LG|vX(<_jnXvpuZG!9$X8M$~Dm(kvEgw|d?UU#G2Ypn}^I6t7?jc~H zRtl3ymcFRcbe&Hegi`{P`KyYo9`<t1{9Z<m{_Ew8?Bbu~`HPIUkbquH5~@8BsP1&{ zu&-{XVzHzY{L*w14cxhN9)b1ha?7pj#i0q*@T`ixRiHwgDs^=Z7m(Vkn2-nJn>Ou2 z#Q$4_=p{e9Ep&;#JgKG*j7SBch;a;*4lbhw`z}2|h27At(IK291C!mqA|7nx8(n!X z<-c6;{mBz&Hy8}AHXDx=A&f4R=u?p_w=R+X$V~l5bhHVqJmW=#8q8f2OaF$yJ8`1y z8f7XFU2*icR_}&WYLZgtmS^(oMtg)mRs>t`UI`4WefFUp<KX>v_WV=}S(UB!&%f#x z=o0>N$-N`)n*%Q3Kq$<`E<_Gx!)vP5?~|pVamjjJ3D9h5bf5O+*NgzKtn3QY0(m~_ z*r#f>{6g80;55!`^`o&qm2)I=u2ceRPP*&pTnk0nHwCZ*kyFfnrqmb6SCgOg*gQtx o!GHTv)5P()n&0!v`u&RJt9kD$lv@lM$m_6agQqLsCE$yH0ddK~;Q#;t literal 0 HcmV?d00001 diff --git a/connecting_to_sqream/client_drivers/kafka/index.rst b/connecting_to_sqream/client_drivers/kafka/index.rst index ee8e3e98c..e4c1e3242 100644 --- a/connecting_to_sqream/client_drivers/kafka/index.rst +++ b/connecting_to_sqream/client_drivers/kafka/index.rst @@ -12,121 +12,40 @@ If you are using Kafka Apache for distributed streaming and wish to use it with :depth: 1 -Installation and Configuration -============= - -.. contents:: - :local: - :depth: 1 - Before You Begin ----------------- +================ * You must have JAVA 11 installed -* Your network bandwidth must be at least X gigabits per second -* Supported data formats for streaming data are: - * JSON - * CSV - * Avro +* You must have `JDBC <java_jdbc>`_ installed +* Your network bandwidth must be at least 100 mega per second +* Supported data formats for streamed data is JSON -Kafka Producer --------------- - -The Kafka Producer requires both the Kafka producer and Zookeeper processes to be running in order to create new topics, read data from existing topics, and load data from files. If Zookeeper is not running, the Kafka producer will not start. +Installation and Configuration +============================== .. contents:: :local: :depth: 1 -Kafka Producer Installation -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -The Kafka Producer is installed on the 192.168.0.125 server. - -Kafka Producer Configuration -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Running Zookeeper: - -.. code-block:: postgres - - cd /home/sqream/kafka_2.12-3.2.1/ - bin/zookeeper-server-start.sh -daemon config/zookeeper.properties - -Running Kafka producer: - -.. code-block:: postgres - - cd /home/sqream/kafka_2.12-3.2.1/ - bin/kafka-server-start.sh -daemon config/server.properties - -Verifying that both Zookeeper and Kafka producer are running: - -1. Log in to your machine. - -2. Run the following string: - - .. code-block:: postgres - - [sqream@metadata-0-125 ~]$ ps -ef |grep java - -The following is an example of an output indicating that both processes are running: - - .. code-block:: postgres - - <JAVA_HOME>/bin/java... org.apache.zookeeper.server.quorum.QuorumPeerMain config/zookeeper.properties - <JAVA_HOME>/bin/java... kafka.Kafka config/server.properties - -Creating a new topic: - -.. code-block:: postgres - - cd /home/sqream/kafka_2.12-3.2.1/ - bin/kafka-topics.sh --create --bootstrap-server localhost:2181 --replication-factor 1 --partitions 1 --topic <topic name> - -Reading data from a topic: - -.. code-block:: postgres - - cd /home/sqream/kafka_2.12-3.2.1/ - ./kafka-console-consumer.sh --topic <topic name> --from-beginning --bootstrap-server localhost:9092 - -Loading data from a file: - -.. code-block:: postgres - - cd /home/sqream/kafka_2.12-3.2.1/ - ./kafka-console-producer.sh --bootstrap-server localhost:9092 --topic <topic name> < <full path to file> - -Terminating the Kafka Producer requires that both the Kafka Producer and Zookeeper be terminated. To avoid data inconsistency and potential data loss, terminate the Kafka Producer before terminating the Zookeeper. - -Terminating the Kafka Producer: - -.. code-block:: postgres - - cd /home/sqream/kafka_2.12-3.2.1/ - bin/kafka-server-stop.sh - -SQream Consumer +Sink Connector --------------- .. contents:: :local: :depth: 1 -The SQream Consumer reads Kafka topics and writes messages into text files in either CSV, JSON, or Avro format. The files are created with the extension ``.tmp`` and stored in the specified directory. The ``sqream.batchRecordCount`` parameter defines the number of records to be written to each file. When the specified number of records is reached, the SQream Consumer closes the file, renames it to the ``sqream.fileExtension``, and then creates a new file. +The Sink Connector reads Kafka topics and writes messages into text files in either CSV, JSON, or Avro format. The files are created with the extension ``.tmp`` and stored in the specified directory. The ``sqream.batchRecordCount`` parameter defines the number of records to be written to each file. When the specified number of records is reached, the Sink Connector closes the file, renames it to the ``sqream.fileExtension``, and then creates a new file. SQream tables must be created according to the columns configured in ``csvorder``. -SQream Consumer Installation +.. figure:: /_static/images/kafka_flow.png + +Sink Connector Installation ~~~~~~~~~~~~~~~~~~~~~~~~~~~ -The SQream Consumer version is located under /home/sqream/kafkaconnect1, machine IP 192.168.0.102 -Credentials: -user = sqream -pass = sqprj2021$ -SQream Consumer Configuration + +Sink Connector Configuration ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The following parameters require configuration. From b561e7a775f616e35a17e6522069b66d68ea5775 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 22 Jan 2023 13:20:38 +0200 Subject: [PATCH 410/882] :ref:`healer_detection_frequency_seconds` --- .../healer_detection_frequency_seconds.rst | 14 ++++++++ ...ealer_max_statement_inactivity_seconds.rst | 2 +- configuration_guides/is_healer_on.rst | 6 ++-- feature_guides/query_healer.rst | 34 ++++++++++++------- releases/2021.2.1.24.rst | 6 +++- 5 files changed, 45 insertions(+), 17 deletions(-) create mode 100644 configuration_guides/healer_detection_frequency_seconds.rst diff --git a/configuration_guides/healer_detection_frequency_seconds.rst b/configuration_guides/healer_detection_frequency_seconds.rst new file mode 100644 index 000000000..9e7805852 --- /dev/null +++ b/configuration_guides/healer_detection_frequency_seconds.rst @@ -0,0 +1,14 @@ +.. _healer_detection_frequency_seconds: + +************************* +Healer Detection Frequency Seconds +************************* +The ``healerDetectionFrequencySeconds`` flag is used for defining the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU. + +The following describes the ``healerDetectionFrequencySeconds`` worker level flag: + +* **Data type** - size_t +* **Default value** - ``1`` +* **Allowed values** - 1-3600 + +For related flags, see :ref:`is_healer_on`. \ No newline at end of file diff --git a/configuration_guides/healer_max_statement_inactivity_seconds.rst b/configuration_guides/healer_max_statement_inactivity_seconds.rst index 0de4e68e6..142e76eb7 100644 --- a/configuration_guides/healer_max_statement_inactivity_seconds.rst +++ b/configuration_guides/healer_max_statement_inactivity_seconds.rst @@ -1,7 +1,7 @@ .. _healer_max_statement_inactivity_seconds: ************************* -Configuring the Query Healer +Max Statement Inactivity Seconds ************************* The ``maxStatementInactivitySeconds`` flag is used for defining the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU. diff --git a/configuration_guides/is_healer_on.rst b/configuration_guides/is_healer_on.rst index 8b90654ec..1eb0e6384 100644 --- a/configuration_guides/is_healer_on.rst +++ b/configuration_guides/is_healer_on.rst @@ -1,9 +1,9 @@ .. _is_healer_on: ************************* -Enabling the Query Healer +Is Healer On ************************* -The ``is_healer_on`` flag enables the Query Healer, which periodically examines the progress of running statements and logs statements exceeding the ``healerMaxInactivityHours`` flag setting. +The ``is_healer_on`` flag enables the Query Healer, which periodically examines the progress of running statements and logs statements exceeding the ``maxStatementInactivitySeconds`` flag setting. The following describes the ``is_healer_on`` flag: @@ -11,4 +11,4 @@ The following describes the ``is_healer_on`` flag: * **Default value** - ``true`` * **Allowed values** - ``true``, ``false`` -For related flags, see :ref:`healer_max_inactivity_hours`. \ No newline at end of file +For related flags, see :ref:`healer_max_statement_inactivity_seconds`. \ No newline at end of file diff --git a/feature_guides/query_healer.rst b/feature_guides/query_healer.rst index 4c87ec0a9..257de9e32 100644 --- a/feature_guides/query_healer.rst +++ b/feature_guides/query_healer.rst @@ -11,7 +11,27 @@ The **Query Healer** page describes the following: Overview ---------- -The **Query Healer** periodically examines the progress of running statements, creating a log entry for all statements exceeding the ``maxStatementInactivitySeconds`` worker level flag setting. The default setting of the ``maxStatementInactivitySeconds`` is five hours. The ``maxStatementInactivitySeconds`` log frequency is calculated as 5% of the flag setting. When set to five hours (the default setting), the Query Healer triggers an examination every 15 minutes. +The **Query Healer** periodically examines the progress of running statements, creating a log entry for all statements exceeding a defined time period. + +Configuration +------------- +The following **Administration Worker** flags are required to configure the Query Healer: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Flag + - Description + * - ``is_healer_on`` + - The :ref:`is_healer_on` enables and disables the Query Healer. + * - ``maxStatementInactivitySeconds`` + - The :ref:`healer_max_statement_inactivity_seconds` worker level flag defines the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU. The default setting is five hours. + * - ``healerDetectionFrequencySeconds`` + - The :ref:`healer_detection_frequency_seconds` worker level flag triggers the healer to examine the progress of running statements. The default setting is one hour. + +Query Log +--------------- The following is an example of a log record for a query stuck in the query detection phase for more than five hours: @@ -45,14 +65,4 @@ For more information, see the following: :: -* Configuring the :ref:`shutdown_server` flag. - -Configuring the Healer ------------------- -The following **Administration Worker** flags are required to configure the Query Healer: - - * :ref:`is_healer_on` - Enables the Query Healer. - - :: - - * :ref:`healer_max_statement_inactivity_seconds` - Defines the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU. \ No newline at end of file +* Configuring the :ref:`shutdown_server` flag. \ No newline at end of file diff --git a/releases/2021.2.1.24.rst b/releases/2021.2.1.24.rst index f1ab492dc..2016dd564 100644 --- a/releases/2021.2.1.24.rst +++ b/releases/2021.2.1.24.rst @@ -65,7 +65,11 @@ The following worker level configuration flags were added: :: - * :ref:`healer_max_statement_inactivity_seconds:` + * :ref:`healer_max_statement_inactivity_seconds` + + :: + + * :ref:`healer_detection_frequency_seconds` Naming Changes ------- From cd600b4caffce534b288d15b3dfa67f06b1a5f8d Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 22 Jan 2023 15:38:04 +0200 Subject: [PATCH 411/882] Update ldap.rst --- configuration_guides/ldap.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/configuration_guides/ldap.rst b/configuration_guides/ldap.rst index 657a5c6cd..b06081bb7 100644 --- a/configuration_guides/ldap.rst +++ b/configuration_guides/ldap.rst @@ -72,9 +72,9 @@ To configure LDAP authentication for SQream, you may choose one of the following * - Method - Description * - Basic method - - Use a given username in attempt to bind it to a distinguished name. To simplify usage, the ``ldapPrefix`` and ``ldapSuffix`` flags are used to construct a distinguished name built by ``ldapPrefix``, ``username``, or ``ldapSuffix``. + - A traditional approach to authentication in which the user provides a username and password combination to authenticate with the LDAP server. In this approach, all users are given the same level of access to the server. * - Advanced method - - Bind to the LDAP directory using a fixed username and password, which are set in the flags ``ldapBindDn`` and ``ldapBindDnPassword``. In the case that ``ldapBindDn`` and ``ldapBindDnPassword`` are not set, an anonymous bind will be attempted to the directory. A search will be preformed over the subtree set by ``ldapBaseDn``, by searching for an exact match of the given username in the attribute set in the ``ldapSearchAttribute`` flag. Only a single match is allowed in the search result. Once the user has been found in the search, the server disconnects and re-binds to the directory as this user, using the password specified by the client. Follow this procedure if you are configuring LDAP authentication for SQream. + - This approach allows for compartmentalization, which means that users can be grouped into categories, and each category can be assigned different levels of access to the LDAP server. This allows administrators to control access to different parts of the system. From 4ad3547513e37e9f23d21b73c3e0cc572bc77248 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 22 Jan 2023 15:53:19 +0200 Subject: [PATCH 412/882] Update ldap.rst --- configuration_guides/ldap.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/configuration_guides/ldap.rst b/configuration_guides/ldap.rst index b06081bb7..c312b6986 100644 --- a/configuration_guides/ldap.rst +++ b/configuration_guides/ldap.rst @@ -173,7 +173,7 @@ Logging in will be possible using the username ElonMusk using sqream client .. code-block:: postgres - ./sqream sql --username=ElonMusk --password=sqream123 --databasename=master --port=636 + ./sqream sql --username=ElonMusk --password=sqream123 --databasename=master --port=5000 Advanced Method --------------- @@ -293,7 +293,7 @@ User has value of elonm for attribute ``sAMAccountName``. ALTER SYSTEM SET ldapIpAddress = 'ldaps://192.168.10.20'; - ALTER SYSTEM SET ldapPort = 636 + ALTER SYSTEM SET ldapPort = 5000 ALTER SYSTEM SET ldapBindDn = 'CN=LDAP admin,OU=network admin,DC=sqream,DC=loc'; @@ -310,7 +310,7 @@ Logging in will be possible using the username elonm using sqream client .. code-block:: postgres - ./sqream sql --username=elonm --password=<elonm_password> --databasename=master --port=636 + ./sqream sql --username=elonm --password=<elonm_password> --databasename=master --port=5000 Disabling LDAP Authentication From fb4c29555495a25ad21e4ec3ac050dca1377631a Mon Sep 17 00:00:00 2001 From: TaliaSQream <taliar@sqreamtech.com> Date: Mon, 23 Jan 2023 12:59:31 +0200 Subject: [PATCH 413/882] Update ldap.rst --- configuration_guides/ldap.rst | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/configuration_guides/ldap.rst b/configuration_guides/ldap.rst index c312b6986..9aa8b3d7f 100644 --- a/configuration_guides/ldap.rst +++ b/configuration_guides/ldap.rst @@ -5,12 +5,13 @@ Configuring LDAP authentication ************************************* -Lightweight Directory Access Protocol (LDAP) is an authentication management service widely used with Microsoft Active Directory. Once it has been configured to authenticate SQream roles, all existing and newly added roles will be required to be authenticated by an LDAP server, with the exception of the initial system deployment ``sqream`` role, which is granted full control permissions upon deployment. +Lightweight Directory Access Protocol (LDAP) is an authentication management service used with Microsoft Active Directory and other directory services. Once LDAP authentication has been configured for SQream, authorization for all existing and newly added roles must be handled by the LDAP server, except for the initial system deployment ``sqream`` role, which was immediately given full control permissions when SQream was initially deployed. -Prior to integrating SQream with LDAP, two preconditions must be considered: +Before integrating SQream with LDAP consider the following: - * If SQream DB is being installed within an LDAP-integrated environment, it is best practice to ensure that the newly created SQream role names are consistent with existing LDAP user names. - * If LDAP is being integrated with a SQream environment, it is best practice to ensure that the newly created LDAP user names are consistent with existing SQream role names. Note that after LDAP has been successfully integrated, SQream roles that were mistakenly not configured or have conflicting names with LDAP will be recreated in SQream as roles without the ability to log in, without permissions, and without a default schema. +* If SQream DB is being installed within an environment where LDAP is already configured, it is best practice to ensure that the newly created SQream role names are consistent with existing LDAP user names. + +* If SQream DB has been installed and LDAP has not yet been integrated with SQream, it is best practice to ensure that the newly created LDAP user names are consistent with existing SQream role names. Previously existing SQream roles that were mistakenly not configured in LDAP or that have names which are different than in LDAP, will be recreated in SQream as roles that cannot log in, have no permissions, and have no default schema. .. contents:: In this topic: :local: @@ -39,7 +40,7 @@ Follow this procedure if you already have LDAP configured for your environment. CREATE ROLE <new_role>; -2. Grant new role login permission: +2. Grant the new role login permission: .. code-block:: postgres @@ -82,8 +83,13 @@ Basic Method ------------ Flag Attributes +<<<<<<< Updated upstream ~~~~~~~~~~~~~~~ -To enable LDAP Authentication, configure the following **Cluster** flag attributes using the ``ALTER SYSTEM SET`` command: +To enable LDAP authentication, configure the following **Cluster** flag attributes using the ``ALTER SYSTEM SET`` command: +======= +--------------- +To enable LDAP authentication, configure the following **cluster** flag attributes using the ``ALERT SYSTEM SET`` command: +>>>>>>> Stashed changes .. list-table:: :widths: auto From fa2cfbfbabbb93ed8b67af33bb4009fe6fbe936a Mon Sep 17 00:00:00 2001 From: TaliaSQream <taliar@sqreamtech.com> Date: Mon, 23 Jan 2023 13:16:47 +0200 Subject: [PATCH 414/882] Update ldap.rst --- configuration_guides/ldap.rst | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/configuration_guides/ldap.rst b/configuration_guides/ldap.rst index 9aa8b3d7f..ddbeae199 100644 --- a/configuration_guides/ldap.rst +++ b/configuration_guides/ldap.rst @@ -73,9 +73,9 @@ To configure LDAP authentication for SQream, you may choose one of the following * - Method - Description * - Basic method - - A traditional approach to authentication in which the user provides a username and password combination to authenticate with the LDAP server. In this approach, all users are given the same level of access to the server. + - A traditional approach to authentication in which the user provides a username and password combination to authenticate with the LDAP server. In this approach, all users are given access to SQream. * - Advanced method - - This approach allows for compartmentalization, which means that users can be grouped into categories, and each category can be assigned different levels of access to the LDAP server. This allows administrators to control access to different parts of the system. + - This approach allows for compartmentalization, which means that users can be grouped into categories, and each category can be assigned or denied access to SQream. This allows administrators to control access to SQream. @@ -83,13 +83,9 @@ Basic Method ------------ Flag Attributes -<<<<<<< Updated upstream ~~~~~~~~~~~~~~~ + To enable LDAP authentication, configure the following **Cluster** flag attributes using the ``ALTER SYSTEM SET`` command: -======= ---------------- -To enable LDAP authentication, configure the following **cluster** flag attributes using the ``ALERT SYSTEM SET`` command: ->>>>>>> Stashed changes .. list-table:: :widths: auto From 1591d73c519f2f09d6283999ee62a2c237701ada Mon Sep 17 00:00:00 2001 From: TaliaSQream <taliar@sqreamtech.com> Date: Mon, 23 Jan 2023 14:04:14 +0200 Subject: [PATCH 415/882] Update ldap.rst --- configuration_guides/ldap.rst | 32 ++++++++++++++++---------------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/configuration_guides/ldap.rst b/configuration_guides/ldap.rst index ddbeae199..ec16f9c69 100644 --- a/configuration_guides/ldap.rst +++ b/configuration_guides/ldap.rst @@ -85,7 +85,7 @@ Basic Method Flag Attributes ~~~~~~~~~~~~~~~ -To enable LDAP authentication, configure the following **Cluster** flag attributes using the ``ALTER SYSTEM SET`` command: +To enable basic LDAP authentication, configure the following **Cluster** flag attributes using the ``ALTER SYSTEM SET`` command: .. list-table:: :widths: auto @@ -94,17 +94,17 @@ To enable LDAP authentication, configure the following **Cluster** flag attribut * - Attribute - Description * - ``authenticationMethod`` - - Configure an authentication method. Attribute may be set to either ``sqream`` or ``ldap``. To configure LDAP authentication, choose ``ldap``. + - Configure an authentication method: ``sqream`` or ``ldap``. To configure LDAP authentication, choose ``ldap``. * - ``ldapIpAddress`` - - Configure the IP address or the Fully Qualified Domain Name (FQDN) of your LDAP server and select a protocol. Out of the ``ldap`` and ``ldaps``, we recommend to use the encrypted ``ldaps`` protocol. + - Configure the IP address or the Fully Qualified Domain Name (FQDN) of your LDAP server and select a protocol: ``ldap`` or ``ldaps``. Sqream recommends using the encrypted ``ldaps`` protocol. * - ``ldapConnTimeoutSec`` - - Configure the LDAP connection timeout threshold (seconds). The default is 30 seconds. + - Configure the LDAP connection timeout threshold (seconds). Default = 30 seconds. * - ``ldapPort`` - LDAP server port number. * - ``ldapAdvancedMode`` - - Configure either basic or advanced authentication method. Default is ``false``. + - Configure either basic or advanced authentication method. Default = ``false``. * - ``ldapPrefix`` - - String to prepend to the user name when forming the DN to bind as, when doing simple bind authentication. + - String to prefix to the user name when forming the DN to bind as, when doing simple bind authentication. * - ``ldapSuffix`` - String to append to the user name when forming the DN to bind as, when doing simple bind authentication. @@ -112,7 +112,7 @@ To enable LDAP authentication, configure the following **Cluster** flag attribut Basic Method Configuration ~~~~~~~~~~~~~~~~~~~~~~~~~~ -Only roles with admin privileges and higher may enable LDAP Authentication. +Only roles with admin privileges or higher may enable LDAP Authentication. **Procedure** @@ -157,7 +157,7 @@ Only roles with admin privileges and higher may enable LDAP Authentication. Example ~~~~~~~ -After completing the setup above we can try to bind to a user by a distinguished name. For example if the DN of the user is: +After completing the setup above, we can try to bind to a user by a distinguished name. For example, if the DN of the user is: .. code-block:: postgres @@ -183,7 +183,7 @@ Advanced Method Flag Attributes ~~~~~~~~~~~~~~~ -To enable LDAP Authentication, configure the following **Cluster** flag attributes using the ``ALTER SYSTEM SET`` command: +To enable advanced LDAP authentication, configure the following **Cluster** flag attributes using the ``ALTER SYSTEM SET`` command: .. list-table:: :widths: auto @@ -192,23 +192,23 @@ To enable LDAP Authentication, configure the following **Cluster** flag attribut * - Attribute - Description * - ``authenticationMethod`` - - Configure an authentication method. Attribute may be set to either ``sqream`` or ``ldap``. To configure LDAP authentication, choose ``ldap``. + - Configure an authentication method: ``sqream`` or ``ldap``. To configure LDAP authentication, choose ``ldap``. * - ``ldapIpAddress`` - - Configure the IP address or the Fully Qualified Domain Name (FQDN) of your LDAP server and select a protocol. Out of the ``ldap`` and ``ldaps``, we recommend to use the encrypted ``ldaps`` protocol. + - Configure the IP address or the Fully Qualified Domain Name (FQDN) of your LDAP server and select a protocol: ``ldap`` or ``ldaps``. Sqream recommends using the encrypted ``ldaps`` protocol. * - ``ldapConnTimeoutSec`` - - Configure the LDAP connection timeout threshold (seconds). The default is 30 seconds. + - Configure the LDAP connection timeout threshold (seconds). Default = 30 seconds. * - ``ldapPort`` - LDAP server port number. * - ``ldapAdvancedMode`` - - Configure either basic or advanced authentication method. Default is ``false``. + - Set ``ldapAdvancedMode`` = ``true``. * - ``ldapBaseDn`` - Root DN to begin the search for the user in, when doing advanced authentication. * - ``ldapBindDn`` - - DN of user to bind to the directory with to perform the search when doing advanced authentication. + - DN of user with which to bind to the directory to perform the search when doing search + bind authentication. * - ``ldapBindDnPassword`` - - Password for user to bind to the directory with to perform the search when doing advanced authentication. + - Password for user with which to bind to the directory to perform the search when doing search + bind authentication. * - ``ldapSearchAttribute`` - - Attribute to match against the user name in the search when doing advanced authentication. If no attribute is specified, the ``uid`` attribute will be used. + - Attribute to match against the user name in the search when doing search + bind authentication. If no attribute is specified, ``the uid`` attribute will be used. Advanced Method Configuration ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ From 91ae1721f2f928172f14d82ebef7149454e7a008 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 24 Jan 2023 13:32:21 +0200 Subject: [PATCH 416/882] Update compression.rst --- feature_guides/compression.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/feature_guides/compression.rst b/feature_guides/compression.rst index 74874b980..e6143bc59 100644 --- a/feature_guides/compression.rst +++ b/feature_guides/compression.rst @@ -35,7 +35,7 @@ When loading data, SQream DB automatically decides on the compression schemes fo Compression Methods ------------------------ -In some cases, if SQream finds that the given compression method cannot effectively compress the data, it will return to the default compression type. + The following table shows the supported compression methods: @@ -155,6 +155,8 @@ In other cases, you may want to force SQream to use a specific compression schem ); +However, if SQream finds that the given compression method cannot effectively compress the data, it will return to the default compression type. + Examining Compression Effectiveness -------------------------------------- Queries made on the internal metadata catalog can expose how effective the compression is, as well as what compression schemes were selected. From 988b5f85f7266d5db85ee3f68a9a04a92fc26c46 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 25 Jan 2023 09:51:12 +0200 Subject: [PATCH 417/882] Update 4.0.0_index.rst --- releases/4.0.0_index.rst | 57 +++++++++++++++++++++------------------- 1 file changed, 30 insertions(+), 27 deletions(-) diff --git a/releases/4.0.0_index.rst b/releases/4.0.0_index.rst index 1b962fbdc..c592cf1bd 100644 --- a/releases/4.0.0_index.rst +++ b/releases/4.0.0_index.rst @@ -39,33 +39,36 @@ Known Issues Version 4.0.0 resolved Issues ----------------------------- -+---------------+------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+===============+==========================================================================================+ -| SQ-10544 | SQream Studio Worker Panel issue | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-11199 | AWS S3 internal runtime error when executing ``COPY TO`` statement | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-11296 | Slow catalog queries | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-11772 | Slow ``JOIN`` query | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-11948 | ``SAVED QUERY`` execution using ``SELECT`` or ``INSERT INTO`` returns error | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-12228 | ``CREATE AS SELECT`` statement fails when executed with ``UNION ALL`` and ``GROUP BY`` | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-12310 | ``DICT`` compression buffer size issue | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-12318 | JDBC ``insertBuffer`` parameter issue | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-12364 | ``GET DDL`` foreign table output issue | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-12468 | Internal compiler error | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-12580 | Server Picker GPU dependency | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-12652 | SQream Studio result panel adjustment | -+---------------+------------------------------------------------------------------------------------------+ ++------------------------+------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++========================+==========================================================================================+ +| SQ-10544 | SQream Studio Worker Panel issue | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-11199 | AWS S3 internal runtime error when executing ``COPY TO`` statement | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-11296 | Slow catalog queries | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-11772 | Slow ``JOIN`` query | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-11948 | ``SAVED QUERY`` execution using ``SELECT`` or ``INSERT INTO`` returns error | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12228 | ``CREATE AS SELECT`` statement fails when executed with ``UNION ALL`` and ``GROUP BY`` | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12310 | ``DICT`` compression buffer size issue | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12318 | JDBC ``insertBuffer`` parameter issue | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12364 | ``GET DDL`` foreign table output issue | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12446 | | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12468 | Internal compiler error | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12580 | Server Picker GPU dependency | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12652 + 12844 | SQream Studio result panel adjustment | ++------------------------+------------------------------------------------------------------------------------------+ + Configuration Changes --------------------- From aa6e2b02af12a0a18d38cb712977d9370b2d9212 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 25 Jan 2023 17:34:50 +0200 Subject: [PATCH 418/882] Update index.rst --- .../client_drivers/kafka/index.rst | 26 ++++++++++--------- 1 file changed, 14 insertions(+), 12 deletions(-) diff --git a/connecting_to_sqream/client_drivers/kafka/index.rst b/connecting_to_sqream/client_drivers/kafka/index.rst index e4c1e3242..63535820e 100644 --- a/connecting_to_sqream/client_drivers/kafka/index.rst +++ b/connecting_to_sqream/client_drivers/kafka/index.rst @@ -20,6 +20,16 @@ Before You Begin * Your network bandwidth must be at least 100 mega per second * Supported data formats for streamed data is JSON +High Level Workflow +=================== + +1. Install the JDBC Connector. +2. Install kafka_2.12-3.2.1 +3. Run your Kafka Connect API. +4. + + + Installation and Configuration ============================== @@ -30,19 +40,13 @@ Installation and Configuration Sink Connector --------------- -.. contents:: - :local: - :depth: 1 - -The Sink Connector reads Kafka topics and writes messages into text files in either CSV, JSON, or Avro format. The files are created with the extension ``.tmp`` and stored in the specified directory. The ``sqream.batchRecordCount`` parameter defines the number of records to be written to each file. When the specified number of records is reached, the Sink Connector closes the file, renames it to the ``sqream.fileExtension``, and then creates a new file. +The Sink Connector reads JSON format Kafka topics and writes the messages inside each topic into text files. The files are created with the extension ``.tmp`` and stored in a specified directory. The ``sqream.batchRecordCount`` parameter defines the number of records to be written to each file, and when the specified number is reached, the Sink Connector closes the file, renames it to ``sqream.fileExtension``, and then creates a new file. Unlike data streaming, which continuously sends data from the Kafka topic to the database, the Sink Connector only sends the data when the file size reaches a predefined threshold. This means that data will arrive in batches. SQream tables must be created according to the columns configured in ``csvorder``. -.. figure:: /_static/images/kafka_flow.png -Sink Connector Installation -~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.. figure:: /_static/images/kafka_flow.png Sink Connector Configuration @@ -116,14 +120,12 @@ SQream Loader SQream Loader Installation ~~~~~~~~~~~~~~~~~~~~~~~~~~ -Sqream loader credentials: -ip machine: 192.168.0.102 -user = sqream -pass = sqprj2021$ + SQream Loader Configuration ~~~~~~~~~~~~~~~~~~~~~~~~~~~ + Building the SQream Loader: .. code-block:: postgres From aee60e42ade69ef251d679588eb16fe9bd751a3e Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 29 Jan 2023 15:14:38 +0200 Subject: [PATCH 419/882] -Trino --- .../client_drivers/kafka/index.rst | 90 +++++++---- .../client_platforms/index.rst | 1 - .../client_platforms/trino.rst | 144 ------------------ 3 files changed, 59 insertions(+), 176 deletions(-) delete mode 100644 connecting_to_sqream/client_platforms/trino.rst diff --git a/connecting_to_sqream/client_drivers/kafka/index.rst b/connecting_to_sqream/client_drivers/kafka/index.rst index 63535820e..983b0b96e 100644 --- a/connecting_to_sqream/client_drivers/kafka/index.rst +++ b/connecting_to_sqream/client_drivers/kafka/index.rst @@ -33,6 +33,12 @@ High Level Workflow Installation and Configuration ============================== +Before you configure the Kafka Connector, make sure that Kafka and Zookeeper are both running. + +Kafka Connector workflow: + +.. figure:: /_static/images/kafka_flow.png + .. contents:: :local: :depth: 1 @@ -45,12 +51,31 @@ The Sink Connector reads JSON format Kafka topics and writes the messages inside SQream tables must be created according to the columns configured in ``csvorder``. +Sink Connector Configuration +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. figure:: /_static/images/kafka_flow.png +Configuration file structure: + .. code-block:: postgres -Sink Connector Configuration -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + name=SQReamFileSink + topics=topsqreamtest1 + tasks.max=4 + connector.class=tr.com.entegral.FileSinkConnector + errors.tolerance=all + errors.log.enable=true + errors.log.include.messages=true + value.converter=org.apache.kafka.connect.json.JsonConverter + value.converter.schemas.enable=false + transforms=flatten + transforms.flatten.type=org.apache.kafka.connect.transforms.Flatten$Value + transforms.flatten.delimiter=. + sqream.outputdir=/home/sqream/kafkaconnect/outputs + sqream.batchRecordCount =10 + sqream.fileExtension=csv + sqream.removeNewline =false + sqream.outputType=csv + sqream.csvOrder=receivedTime,equipmentId,asdf,timestamp,intv The following parameters require configuration. @@ -76,31 +101,6 @@ Connection string: vi /home/sqream/kafkaconnect1/sqream-kafka-connector/sqream-kafkaconnect/config/sqream-filesink.properties -Configuration file structure: - - .. code-block:: postgres - - name=SQReamFileSink - topics=topsqreamtest1 - tasks.max=4 - connector.class=tr.com.entegral.FileSinkConnector - errors.tolerance=all - errors.log.enable=true - errors.log.include.messages=true - value.converter=org.apache.kafka.connect.json.JsonConverter - value.converter.schemas.enable=false - transforms=flatten - transforms.flatten.type=org.apache.kafka.connect.transforms.Flatten$Value - transforms.flatten.delimiter=. - sqream.outputdir=/home/sqream/kafkaconnect/outputs - sqream.batchRecordCount =10 - sqream.fileExtension=csv - sqream.removeNewline =false - sqream.outputType=csv - sqream.csvOrder=receivedTime,equipmentId,asdf,timestamp,intv - - - Running commands: .. code-block:: postgres @@ -110,17 +110,45 @@ Running commands: -SQream Loader +JDBC ------------- +The JDBC connector can be used to ingest data from Kafka, allowing SQream DB to consume the messages directly. This enables efficient and secure data ingestion into SQream DB. + .. contents:: :local: :depth: 1 -SQream Loader Installation -~~~~~~~~~~~~~~~~~~~~~~~~~~ +JDBC Configuration +~~~~~~~~~~~~~~~~~~ +.. code-block:: postgres + vi /home/sqream/kafkaconnect1/sqream-kafka-connector/sqream-kafkaconnect/config/sqream-jdbcsink.properties + +Example +.. code-block:: postgres + + name=SQReamJDBCSink + topics=demo1 + tasks.max=1 + connector.class=tr.com.entegral.JDBCSinkConnector + errors.tolerance=all + errors.log.enable=true + errors.log.include.messages=true + value.converter=org.apache.kafka.connect.json.JsonConverter + value.converter.schemas.enable=false + transforms=flatten + transforms.flatten.type=org.apache.kafka.connect.transforms.Flatten$Value + transforms.flatten.delimiter=. + sqream.batchRecordCount =3 + #sqream.jdbc.connectionstring=jdbc:sqlserver://localhost;databaseName=TestDB;user=kafka;password=kafka;encrypt=true;trustServerCertificate=true; + sqream.jdbc.connectionstring=jdbc:Sqream://192.168.0.102:5001/kafka;user=sqream;password=sqream;cluster=false + sqream.input.inputfields=intStr,inInt,indateTime,inFloat + sqream.jdbc.tablename=testtable + sqream.jdbc.table.columnnames=colStr,colInt,Coldatetime,ColFloat + sqream.jdbc.table.columntypes=VARCHAR,INTEGER,TIMESTAMP,FLOAT + sqream.jdbc.dateformat=yyyy-MM-dd HH:mm:ss SQream Loader Configuration ~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/connecting_to_sqream/client_platforms/index.rst b/connecting_to_sqream/client_platforms/index.rst index 903800b35..e765f56af 100644 --- a/connecting_to_sqream/client_platforms/index.rst +++ b/connecting_to_sqream/client_platforms/index.rst @@ -23,7 +23,6 @@ If you are looking for a tool that is not listed, SQream and our partners can he spark - trino informatica microstrategy pentaho diff --git a/connecting_to_sqream/client_platforms/trino.rst b/connecting_to_sqream/client_platforms/trino.rst deleted file mode 100644 index be1e7e9b7..000000000 --- a/connecting_to_sqream/client_platforms/trino.rst +++ /dev/null @@ -1,144 +0,0 @@ -.. _trino: - -************************* -Connecting to SQream Using Trino -************************* - - -If you are using Trino for distributed SQL query processing and wish to use it to connect to a SQream, follow these instructions. - - -.. contents:: - :local: - :depth: 1 - -Prerequisites -------------- -To use Trino with SQream, you must have the following installed: - -* SQream version 2022.1.8 or later -* Trino version 403 or later -* SQream Trino plugin xxxx -* JDBC version 4.5.6 or later - - - -Installation ------------- - -.. contents:: - :local: - :depth: 1 - -JDBC -~~~~ - -In case JDBC is not yet configured, follow the `JDBC Client Drivers page <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/jdbc/index.html>`_ for registration and configuration guidance. - - -SQream Trino Plugin -~~~~~~~~~~~~~~~~~~~ - -The SQream Trino plugin must be installed on each cluster node dedicated to Trino. - -1. Create a dedicated directory for the SQream Trino plugin. - -2. Download the `SQream Trino Plugin<...>` and extract the content of the ZIP file to the dedicated directory, as shown in the example: - - -.. code-block:: postgres - - trino-server/ - └── plugin - └── sqream - ├── sqream-jdbc.jar - ├── trino-sqream-services.jar - ├── trino-sqream-SNAPSHOT.jar - └── all dependencies - - - -Connecting to SQream --------------------- - -Trino uses catalogs for referencing stored objects such as tables, databases, and functions. Each Trino catalog may be configured with access to a single SQream database. If you wish Trino to have access to more than one SQream database or server, you must create additional catalogs. - -Catalogs may be created using ``properties`` files. Start by creating a ``sqream.properties`` file and placing it under ``trino-server/etc/catalog``. - -The following is an example of a properties file: - -.. code-block:: postgres - - connector.name=<name> - connection-url=jdbc:Sqream://<host and port>/<database name>;[<optional parameters>; ...] - connection-user=<user> - connection-password=<password> - -Syntax examples ---------------- - -The following is an example of the ``SHOW SCHEMAS FROM`` statement: - -.. code-block:: postgres - - SHOW SCHEMAS FROM sqream; - -The following is an example of the ``SHOW TABLES FROM`` statement: - -.. code-block:: postgres - - SHOW TABLES FROM sqream.public; - -The following is an example of the ``DESCRIBE sqream.public.t`` statement: - -.. code-block:: postgres - - DESCRIBE sqream.public.t; - - -Supported Data Types and Mapping --------------------------------- -Use the appropriate Trino data type for executing queries. Upon execution, incompatible data types will be converted by Trino to SQream data types. - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Trino type - - SQream type - * - ``BOOLEAN`` - - ``BOOL`` - * - ``TINYINT`` - - ``TINYINT`` - * - ``SMALLINT`` - - ``SMALLINT`` - * - ``INT`` - - ``INT`` - * - ``BIGINT`` - - ``BIGINT`` - * - ``REAL`` - - ``REAL`` - * - ``DOUBLE`` - - ``DOUBLE`` - * - ``DATE`` - - ``DATE`` - * - ``TIMESTAMP`` - - ``DATETIME`` - * - ``VARCHAR(N)`` - - ``VARCHAR(N)``. - * - ``VARCHAR`` - - ``TEXT`` - * - ``DECIMAL(P,S)`` - - ``NUMERIC(P,S)`` - -.. note:: ``VARCHAR`` is soon to be deprecated and may not be used in SQream DB. - -Limitations ------------ - -The SQream Trino plugin does not support the following SQL statements: - -* ``GRANT`` -* ``REVOKE`` -* ``SHOW GRANTSHOW ROLES`` -* ``SHOW ROLE GRANTS`` \ No newline at end of file From 9e33de08ea2bc5e242f119d73b93813109acdc1e Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 31 Jan 2023 08:58:30 +0200 Subject: [PATCH 420/882] Update tibco_spotfire.rst --- .../client_platforms/tibco_spotfire.rst | 52 +++++++++---------- 1 file changed, 26 insertions(+), 26 deletions(-) diff --git a/connecting_to_sqream/client_platforms/tibco_spotfire.rst b/connecting_to_sqream/client_platforms/tibco_spotfire.rst index 4c032ba84..2d85fecf1 100644 --- a/connecting_to_sqream/client_platforms/tibco_spotfire.rst +++ b/connecting_to_sqream/client_platforms/tibco_spotfire.rst @@ -128,52 +128,52 @@ After creating a connection, you can create your SQream data source template. .. code-block:: console <jdbc-type-settings> - <type-name>SQream </type-name> - <driver>com.sqream.jdbc.SQDriver </driver> - <connection-url-pattern>jdbc:Sqream://&lt;host&gt;:&lt;port&gt;/database;user=sqream;password=sqream;cluster=true </connection-url-pattern> - <supports-catalogs>true </supports-catalogs> - <supports-schemas>true </supports-schemas> - <supports-procedures>false </supports-procedures> - <table-types>TABLE,EXTERNAL_TABLE </table-types> + <type-name>SQream</type-name> + <driver>com.sqream.jdbc.SQDriver</driver> + <connection-url-pattern>jdbc:Sqream://&lt;host&gt;:&lt;port&gt;/database;user=sqream;password=sqream;cluster=true</connection-url-pattern> + <supports-catalogs>true</supports-catalogs> + <supports-schemas>true</supports-schemas> + <supports-procedures>false</supports-procedures> + <table-types>TABLE,EXTERNAL_TABLE</table-types> <java-to-sql-type-conversions> <type-mapping> - <from>Bool </from> - <to>Integer </to> + <from>Bool</from> + <to>Integer</to> </type-mapping> <type-mapping> - <from>VARCHAR(2048) </from> - <to>String </to> + <from>VARCHAR(2048)</from> + <to>String</to> </type-mapping> <type-mapping> - <from>INT </from> - <to>Integer </to> + <from>INT</from> + <to>Integer</to> </type-mapping> <type-mapping> - <from>BIGINT </from> - <to>LongInteger </to> + <from>BIGINT</from> + <to>LongInteger</to> </type-mapping> <type-mapping> - <from>Real </from> - <to>Real </to> + <from>Real</from> + <to>Real</to> </type-mapping> <type-mapping> - <from>Decimal </from> - <to>Float </to> + <from>Decimal</from> + <to>Float</to> </type-mapping> <type-mapping> - <from>Numeric </from> - <to>Float </to> + <from>Numeric</from> + <to>Float</to> </type-mapping> <type-mapping> - <from>Date </from> - <to>DATE </to> + <from>Date</from> + <to>DATE</to> </type-mapping> <type-mapping> - <from>DateTime </from> - <to>DateTime </to> + <from>DateTime</from> + <to>DateTime</to> </type-mapping> </java-to-sql-type-conversions> - <ping-command> </ping-command> + <ping-command></ping-command> </jdbc-type-settings> 4. Click **Save configuration**. From f64dc5198708bfb45902a598a757c6338a16e1ea Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 31 Jan 2023 09:05:10 +0200 Subject: [PATCH 421/882] Update hardware_guide.rst --- getting_started/hardware_guide.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/getting_started/hardware_guide.rst b/getting_started/hardware_guide.rst index c502f60bf..b8d9691fd 100644 --- a/getting_started/hardware_guide.rst +++ b/getting_started/hardware_guide.rst @@ -58,9 +58,9 @@ An average single-node cluster can be a rackmount server or workstation, contain .. note:: If you are using internal storage, your volumes must be formatted as xfs. -In this system configuration, SQream can store about 200TB of raw data (assuming average compression ratio and ~50TB of usable raw storage). +In this system configuration, SQream can store about 100TB of raw data (assuming average compression ratio and ~30TB of usable raw storage). -If a NAS is used, the 14x SSD drives can be omitted, but SQream recommends 2TB of local spool space on SSD or NVMe drives. +If a NAS is used, the 10x SSD drives can be omitted, but SQream recommends 2TB of local spool space on SSD or NVMe drives. Multi-Node Cluster Examples ----------------------------------- From 66494b93da7a50cfe3d2db9872c6a0477d5826f9 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 31 Jan 2023 11:00:07 +0200 Subject: [PATCH 422/882] get_all_roles --- .../get_all_roles_database_ddl.rst | 46 ++++++++++++++++++ .../get_all_roles_global_ddl.rst | 47 +++++++++++++++++++ .../get_role_database_ddl.rst | 4 +- 3 files changed, 95 insertions(+), 2 deletions(-) create mode 100644 reference/sql/sql_statements/utility_commands/get_all_roles_database_ddl.rst create mode 100644 reference/sql/sql_statements/utility_commands/get_all_roles_global_ddl.rst diff --git a/reference/sql/sql_statements/utility_commands/get_all_roles_database_ddl.rst b/reference/sql/sql_statements/utility_commands/get_all_roles_database_ddl.rst new file mode 100644 index 000000000..bd7856776 --- /dev/null +++ b/reference/sql/sql_statements/utility_commands/get_all_roles_database_ddl.rst @@ -0,0 +1,46 @@ +.. _get_all_roles_database_ddl: + +******************** +GET_ALL_ROLES_DATABASE_DDL +******************** +The ``GET_ALL_ROLES_DATABASE_DDL`` statement returns the definition of all global roles in DDL format. + +.. contents:: + :local: + :depth: 1 + +Syntax +========== +The following is the correct syntax for using the ``GET_ALL_ROLES_DATABASE_DDL`` statement: + +.. code-block:: postgres + + select get_all_roles_database_ddl() + +Example +=========== +The following is an example of using the ``GET_ALL_ROLES_DATABASE_DDL`` statement: + +.. code-block:: psql + + select get_all_roles_database_ddl(); + +Output +========== +The following is an example of the output of the ``GET_ALL_ROLES_DATABASE_DDL`` statement: + +.. code-block:: postgres + + grant create, usage on schema "public" to "public" ; alter default schema for "public" to "public"; alter default permissions for "public" for schemas grant superuser to creator_role ; alter default permissions for "public" for tables grant select, insert, delete, ddl, update to creator_role ; grant select, insert, delete, ddl, update on table "public"."customer" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."d_customer" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."demo_customer" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."demo_lineitem" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."lineitem" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."nation" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."orders" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."part" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."partsupp" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."region" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."supplier" to "sqream" ; alter default schema for "sqream" to "public"; + +Permissions +============= +Using the ``GET_ALL_ROLES_DATABASE_DDL`` statement requires no special permissions. + +For more information, see the following: + +* :ref:`get_all_roles_global_ddl` + + :: + +* :ref:`get_role_permissions` \ No newline at end of file diff --git a/reference/sql/sql_statements/utility_commands/get_all_roles_global_ddl.rst b/reference/sql/sql_statements/utility_commands/get_all_roles_global_ddl.rst new file mode 100644 index 000000000..7a77dd810 --- /dev/null +++ b/reference/sql/sql_statements/utility_commands/get_all_roles_global_ddl.rst @@ -0,0 +1,47 @@ +.. _get_all_roles_global_ddl: + +******************** +GET_ALL_ROLES_GLOBAL_DDL +******************** +The ``GET_ALL_ROLES_GLOBAL_DDL`` statement returns the definition of all global roles in DDL format. + +.. contents:: + :local: + :depth: 1 + +Syntax +========== +The following is the correct syntax for using the ``GET_ALL_ROLES_GLOBAL_DDL`` statement: + +.. code-block:: postgres + + select get_all_roles_global_ddl() + +Example +=========== +The following is an example of using the ``GET_ALL_ROLES_GLOBAL_DDL`` statement: + +.. code-block:: psql + + select get_all_roles_global_ddl(); + + +Output +========== +The following is an example of the output of the ``GET_ALL_ROLES_GLOBAL_DDL`` statement: + +.. code-block:: postgres + + create role "public"; create role "sqream"; grant superuser, login to "sqream" ; + +Permissions +============= +Using the ``GET_ALL_ROLES_GLOBAL_DDL`` statement requires no special permissions. + +For more information, see the following: + +* :ref:`get_all_roles_database_ddl` + + :: + +* :ref:`get_role_permissions` \ No newline at end of file diff --git a/reference/sql/sql_statements/utility_commands/get_role_database_ddl.rst b/reference/sql/sql_statements/utility_commands/get_role_database_ddl.rst index e6b806244..85db79a4a 100644 --- a/reference/sql/sql_statements/utility_commands/get_role_database_ddl.rst +++ b/reference/sql/sql_statements/utility_commands/get_role_database_ddl.rst @@ -21,11 +21,11 @@ The following is the correct syntax for using the ``GET_ROLE_DATABASE_DDL`` stat Example =========== -The following is an example of using the ``GET_ROLE_GLOBAL_DDL`` statement: +The following is an example of using the ``GET_ROLE_DATABASE_DDL`` statement: .. code-block:: psql - select get_role_global_ddl('public'); + select get_role_database_ddl('public'); Parameters ============ From a493a8f3ee963a2f4817c634addb00d89d11acdf Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 31 Jan 2023 11:13:00 +0200 Subject: [PATCH 423/882] get_all_roles --- reference/sql/sql_statements/index.rst | 6 +++++- .../utility_commands/get_all_roles_database_ddl.rst | 2 +- .../utility_commands/get_role_database_ddl.rst | 2 +- 3 files changed, 7 insertions(+), 3 deletions(-) diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index af6e9f06a..325647bda 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -192,8 +192,12 @@ The following table shows the Access Control commands: - Returns all permissions granted to a role in table format * - :ref:`get_role_global_ddl` - Returns the definition of a global role in DDL format + * - :ref:`get_all_roles_global_ddl` + - Returns the definition of all global roles in DDL format * - :ref:`get_role_database_ddl` - - Returns the definition of a database role in DDL format + - Returns the definition of a role's database in DDL format + * - :ref:`get_all_roles_database_ddl` + - Returns the definition of all role databases in DDL format * - :ref:`get_statement_permissions` - Returns a list of permissions required to run a statement or query * - :ref:`grant` diff --git a/reference/sql/sql_statements/utility_commands/get_all_roles_database_ddl.rst b/reference/sql/sql_statements/utility_commands/get_all_roles_database_ddl.rst index bd7856776..430ede73e 100644 --- a/reference/sql/sql_statements/utility_commands/get_all_roles_database_ddl.rst +++ b/reference/sql/sql_statements/utility_commands/get_all_roles_database_ddl.rst @@ -3,7 +3,7 @@ ******************** GET_ALL_ROLES_DATABASE_DDL ******************** -The ``GET_ALL_ROLES_DATABASE_DDL`` statement returns the definition of all global roles in DDL format. +The ``GET_ALL_ROLES_DATABASE_DDL`` statement returns the definition of all role databases in DDL format. .. contents:: :local: diff --git a/reference/sql/sql_statements/utility_commands/get_role_database_ddl.rst b/reference/sql/sql_statements/utility_commands/get_role_database_ddl.rst index 85db79a4a..5ff3ecf79 100644 --- a/reference/sql/sql_statements/utility_commands/get_role_database_ddl.rst +++ b/reference/sql/sql_statements/utility_commands/get_role_database_ddl.rst @@ -3,7 +3,7 @@ ******************** GET_ROLE_DATABASE_DDL ******************** -The ``GET_ROLE_DATABASE_DDL`` statement returns the definition of a global role in DDL format. +The ``GET_ROLE_DATABASE_DDL`` statement returns the definition of a role's database in DDL format. The ``GET_ROLE_DATABASE_DDL`` page describes the following: From e38e3494d181c77f921cc7f4a890e6833552bf1a Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 31 Jan 2023 13:27:20 +0200 Subject: [PATCH 424/882] Update converting_and_casting_types.rst --- data_type_guides/converting_and_casting_types.rst | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/data_type_guides/converting_and_casting_types.rst b/data_type_guides/converting_and_casting_types.rst index 940e21822..25e150881 100644 --- a/data_type_guides/converting_and_casting_types.rst +++ b/data_type_guides/converting_and_casting_types.rst @@ -15,7 +15,7 @@ You can rectify this by casting the value to a larger data type, as shown below: SQream supports the following three data conversion types: -* ``CAST(<value> TO <data type>)``, to convert a value from one type to another. For example, ``CAST('1997-01-01' TO DATE)``, ``CAST(3.45 TO SMALLINT)``, ``CAST(some_column TO TEXT(30))``. +* ``CAST(<value> TO <data type>)``, to convert a value from one type to another. For example, ``CAST('1997-01-01' TO DATE)``, ``CAST(3.45 TO SMALLINT)``, ``CAST(some_column TO TEXT)``. :: @@ -38,11 +38,9 @@ Supported Casts +----------------------------------------------+-----------+----------------------------------------------+-----------------+--------------+------------------------+-----------------------+ | **REAL/FLOAT** | ✗ | ✓ | N/A | ✓ | ✗ | ✓ | +----------------------------------------------+-----------+----------------------------------------------+-----------------+--------------+------------------------+-----------------------+ -| **NUMERIC** | ✗ | ✓ | ✓ | N/A | ✗ | ✓ | +| **NUMERIC** | ✗ | ✓ | ✓ | ✓ | ✗ | ✓ | +----------------------------------------------+-----------+----------------------------------------------+-----------------+--------------+------------------------+-----------------------+ | **DATE**/**DATETIME** | ✗ | ✗ | ✗ | ✗ | N/A | ✓ | +----------------------------------------------+-----------+----------------------------------------------+-----------------+--------------+------------------------+-----------------------+ | **VARCHAR**/**TEXT** | ✓ | ✓ | ✓ | ✓ | ✓ | N/A | +----------------------------------------------+-----------+----------------------------------------------+-----------------+--------------+------------------------+-----------------------+ - - :check_mark: \ No newline at end of file From 882f928a4cfca52ff3e3fc29384feebdda745a6f Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 31 Jan 2023 17:03:32 +0200 Subject: [PATCH 425/882] RN --- releases/4.0.0.rst | 127 +++++++++++++++++++++++++++++++++++++++ releases/4.0.0_index.rst | 127 +++------------------------------------ releases/4.1.0.rst | 127 +++++++++++++++++++++++++++++++++++++++ 3 files changed, 261 insertions(+), 120 deletions(-) create mode 100644 releases/4.0.0.rst create mode 100644 releases/4.1.0.rst diff --git a/releases/4.0.0.rst b/releases/4.0.0.rst new file mode 100644 index 000000000..95bfb7aab --- /dev/null +++ b/releases/4.0.0.rst @@ -0,0 +1,127 @@ +.. _4.0.0: + +************************** +Release Notes 4.0.0 +************************** + +SQream is introducing a new version release system that follows the more commonly used Major.Minor.Patch versioning schema. The newly released **4.0.0 version** is a minor version upgrade and does not require considerable preparation. + +The 4.0.0 release notes were released on xx/xx/20xx and describe the following: + +.. contents:: + :local: + :depth: 1 + +New Features +------------ + + * Re-enabling an enhanced version of the :ref:`License Storage Capacity<monitoring_workers_and_services_from_the_dashboard>` feature + + :: + + * :ref:`Lightweight Directory Access Protocol(LDAP)<ldap>` may be used to authenticate SQream roles + + :: + + * :ref:`Physical deletion performance enhancement<delete>` by supporting file systems with parallelism capabilities + +SQream Studio Updates and Improvements +-------------------------------------- + + * When creating a **New Role**, you may now create a group role by selecting **Set as a group role**. + + :: + +Known Issues +------------ +:ref:`Percentile<percentile_disc>` is not supported for Window functions. + +Version 4.0.0 resolved Issues +----------------------------- + ++------------------------+------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++========================+==========================================================================================+ +| SQ-10544 | SQream Studio Worker Panel issue | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-11199 | AWS S3 internal runtime error when executing ``COPY TO`` statement | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-11296 | Slow catalog queries | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-11772 | Slow ``JOIN`` query | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-11948 | ``SAVED QUERY`` execution using ``SELECT`` or ``INSERT INTO`` returns error | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12228 | ``CREATE AS SELECT`` statement fails when executed with ``UNION ALL`` and ``GROUP BY`` | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12310 | ``DICT`` compression buffer size issue | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12318 | JDBC ``insertBuffer`` parameter issue | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12364 | ``GET DDL`` foreign table output issue | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12468 | Internal compiler error | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12580 | Server Picker GPU dependency | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12652 + 12844 | SQream Studio result panel adjustment | ++------------------------+------------------------------------------------------------------------------------------+ + + +Configuration Changes +--------------------- +No configuration changes were made. + +Naming Changes +-------------- +No relevant naming changes were made. + +Deprecated Features +------------------- +SQream is declaring end of support of VARCHAR data type, the decision resulted by SQream's effort to enhance its core functionalities and with respect to ever changing echo system requirements. + +VARCHAR is no longer supported for new customers - effective from Version 2022.1.3 (September 2022). + +TEXT data type is replacing VARCHAR and NVARCHAR - SQream will maintain VARCHAR data type support until 09/30/2023. + + +End of Support +--------------- +No End of Support changes were made. + +Upgrading to v4.0.0 +------------------- +1. Generate a back-up of the metadata by running the following command: + + .. code-block:: console + + $ select backup_metadata('out_path'); + + .. tip:: SQream recommends storing the generated back-up locally in case needed. + + SQream runs the Garbage Collector and creates a clean backup tarball package. + +2. Shut down all SQream services. + + :: + +3. Extract the recently created back-up file. + + :: + +4. Replace your current metadata with the metadata you stored in the back-up file. + + :: + +5. Navigate to the new SQream package bin folder. + + :: + +6. Run the following command: + + .. code-block:: console + + $ ./upgrade_storage <levelDB path> + + .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. + diff --git a/releases/4.0.0_index.rst b/releases/4.0.0_index.rst index c592cf1bd..5f072fd35 100644 --- a/releases/4.0.0_index.rst +++ b/releases/4.0.0_index.rst @@ -1,129 +1,16 @@ -.. _4.0.0: +.. _4.0.0_index: ************************** Release Notes 4.0.0 ************************** - -SQream is introducing a new version release system that follows the more commonly used Major.Minor.Patch versioning schema. The newly released **4.0.0 version** is a minor version upgrade and does not require considerable preparation. - -The 4.0.0 release notes were released on xx/xx/20xx and describe the following: +The 4.0.0 Release Notes describe the following releases: .. contents:: :local: - :depth: 1 - -New Features ------------- - - * Re-enabling an enhanced version of the :ref:`License Storage Capacity<monitoring_workers_and_services_from_the_dashboard>` feature - - :: - - * :ref:`Lightweight Directory Access Protocol(LDAP)<ldap>` may be used to authenticate SQream roles - - :: - - * :ref:`Physical deletion performance enhancement<delete>` by supporting file systems with parallelism capabilities - -SQream Studio Updates and Improvements --------------------------------------- - - * When creating a **New Role**, you may now create a group role by selecting **Set as a group role**. - - :: - -Known Issues ------------- -:ref:`Percentile<percentile_disc>` is not supported for Window functions. - -Version 4.0.0 resolved Issues ------------------------------ - -+------------------------+------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+========================+==========================================================================================+ -| SQ-10544 | SQream Studio Worker Panel issue | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-11199 | AWS S3 internal runtime error when executing ``COPY TO`` statement | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-11296 | Slow catalog queries | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-11772 | Slow ``JOIN`` query | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-11948 | ``SAVED QUERY`` execution using ``SELECT`` or ``INSERT INTO`` returns error | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12228 | ``CREATE AS SELECT`` statement fails when executed with ``UNION ALL`` and ``GROUP BY`` | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12310 | ``DICT`` compression buffer size issue | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12318 | JDBC ``insertBuffer`` parameter issue | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12364 | ``GET DDL`` foreign table output issue | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12446 | | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12468 | Internal compiler error | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12580 | Server Picker GPU dependency | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12652 + 12844 | SQream Studio result panel adjustment | -+------------------------+------------------------------------------------------------------------------------------+ - - -Configuration Changes ---------------------- -No configuration changes were made. - -Naming Changes --------------- -No relevant naming changes were made. - -Deprecated Features -------------------- -SQream is declaring end of support of VARCHAR data type, the decision resulted by SQream's effort to enhance its core functionalities and with respect to ever changing echo system requirements. - -VARCHAR is no longer supported for new customers - effective from Version 2022.1.3 (September 2022). - -TEXT data type is replacing VARCHAR and NVARCHAR - SQream will maintain VARCHAR data type support until 09/30/2023. - - -End of Support ---------------- -No End of Support changes were made. - -Upgrading to v4.0.0 -------------------- -1. Generate a back-up of the metadata by running the following command: - - .. code-block:: console - - $ select backup_metadata('out_path'); - - .. tip:: SQream recommends storing the generated back-up locally in case needed. - - SQream runs the Garbage Collector and creates a clean backup tarball package. - -2. Shut down all SQream services. - - :: - -3. Extract the recently created back-up file. - - :: - -4. Replace your current metadata with the metadata you stored in the back-up file. - - :: - -5. Navigate to the new SQream package bin folder. - - :: - -6. Run the following command: - - .. code-block:: console + :depth: 1 - $ ./upgrade_storage <levelDB path> +.. toctree:: + :maxdepth: 1 + :glob: - .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. - + 4.0.0 diff --git a/releases/4.1.0.rst b/releases/4.1.0.rst new file mode 100644 index 000000000..d24ea13a2 --- /dev/null +++ b/releases/4.1.0.rst @@ -0,0 +1,127 @@ +.. _4.1.0: + +************************** +Release Notes 4.1.0 +************************** + +SQream is introducing a new version release system that follows the more commonly used Major.Minor.Patch versioning schema. The newly released **4.0.0 version** is a minor version upgrade and does not require considerable preparation. + +The 4.0.0 release notes were released on xx/xx/20xx and describe the following: + +.. contents:: + :local: + :depth: 1 + +New Features +------------ + + * Re-enabling an enhanced version of the :ref:`License Storage Capacity<monitoring_workers_and_services_from_the_dashboard>` feature + + :: + + * :ref:`Lightweight Directory Access Protocol(LDAP)<ldap>` may be used to authenticate SQream roles + + :: + + * :ref:`Physical deletion performance enhancement<delete>` by supporting file systems with parallelism capabilities + +SQream Studio Updates and Improvements +-------------------------------------- + + * When creating a **New Role**, you may now create a group role by selecting **Set as a group role**. + + :: + +Known Issues +------------ +:ref:`Percentile<percentile_disc>` is not supported for Window functions. + +Version 4.0.0 resolved Issues +----------------------------- + ++------------------------+------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++========================+==========================================================================================+ +| SQ-10544 | SQream Studio Worker Panel issue | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-11199 | AWS S3 internal runtime error when executing ``COPY TO`` statement | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-11296 | Slow catalog queries | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-11772 | Slow ``JOIN`` query | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-11948 | ``SAVED QUERY`` execution using ``SELECT`` or ``INSERT INTO`` returns error | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12228 | ``CREATE AS SELECT`` statement fails when executed with ``UNION ALL`` and ``GROUP BY`` | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12310 | ``DICT`` compression buffer size issue | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12318 | JDBC ``insertBuffer`` parameter issue | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12364 | ``GET DDL`` foreign table output issue | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12468 | Internal compiler error | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12580 | Server Picker GPU dependency | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12652 + 12844 | SQream Studio result panel adjustment | ++------------------------+------------------------------------------------------------------------------------------+ + + +Configuration Changes +--------------------- +No configuration changes were made. + +Naming Changes +-------------- +No relevant naming changes were made. + +Deprecated Features +------------------- +SQream is declaring end of support of VARCHAR data type, the decision resulted by SQream's effort to enhance its core functionalities and with respect to ever changing echo system requirements. + +VARCHAR is no longer supported for new customers - effective from Version 2022.1.3 (September 2022). + +TEXT data type is replacing VARCHAR and NVARCHAR - SQream will maintain VARCHAR data type support until 09/30/2023. + + +End of Support +--------------- +No End of Support changes were made. + +Upgrading to v4.0.0 +------------------- +1. Generate a back-up of the metadata by running the following command: + + .. code-block:: console + + $ select backup_metadata('out_path'); + + .. tip:: SQream recommends storing the generated back-up locally in case needed. + + SQream runs the Garbage Collector and creates a clean backup tarball package. + +2. Shut down all SQream services. + + :: + +3. Extract the recently created back-up file. + + :: + +4. Replace your current metadata with the metadata you stored in the back-up file. + + :: + +5. Navigate to the new SQream package bin folder. + + :: + +6. Run the following command: + + .. code-block:: console + + $ ./upgrade_storage <levelDB path> + + .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. + From 6acdd029bf0c901c0e39d39d3bfdb1f34877ae57 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 9 Feb 2023 14:02:13 +0200 Subject: [PATCH 426/882] 4.1 --- connecting_to_sqream/client_drivers/index.rst | 4 - .../client_drivers/kafka/index.rst | 250 ------------------ releases/2022.1.8.rst | 116 -------- releases/2022.1_index.rst | 1 - releases/4.0.rst | 121 +++++++++ releases/4.0_index.rst | 17 ++ releases/index.rst | 6 +- 7 files changed, 141 insertions(+), 374 deletions(-) delete mode 100644 connecting_to_sqream/client_drivers/kafka/index.rst delete mode 100644 releases/2022.1.8.rst create mode 100644 releases/4.0.rst create mode 100644 releases/4.0_index.rst diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index d35b1662f..a4400e40a 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -27,10 +27,6 @@ The following are applicable to all operating systems: * `.NET .dll file <https://get.sqream-share.com/share/sIsu8fxv>`_ * :ref:`net` -* **Kafka**: - - * `Kafka download file <>`_ - * :ref:`kafka` .. _python: diff --git a/connecting_to_sqream/client_drivers/kafka/index.rst b/connecting_to_sqream/client_drivers/kafka/index.rst deleted file mode 100644 index 983b0b96e..000000000 --- a/connecting_to_sqream/client_drivers/kafka/index.rst +++ /dev/null @@ -1,250 +0,0 @@ -.. _kafka: - -************************* -Connecting to SQream Using Kafka -************************* - -If you are using Kafka Apache for distributed streaming and wish to use it with SQream, follow these instructions. - - -.. contents:: - :local: - :depth: 1 - - -Before You Begin -================ - -* You must have JAVA 11 installed -* You must have `JDBC <java_jdbc>`_ installed -* Your network bandwidth must be at least 100 mega per second -* Supported data formats for streamed data is JSON - -High Level Workflow -=================== - -1. Install the JDBC Connector. -2. Install kafka_2.12-3.2.1 -3. Run your Kafka Connect API. -4. - - - -Installation and Configuration -============================== - -Before you configure the Kafka Connector, make sure that Kafka and Zookeeper are both running. - -Kafka Connector workflow: - -.. figure:: /_static/images/kafka_flow.png - -.. contents:: - :local: - :depth: 1 - -Sink Connector ---------------- - -The Sink Connector reads JSON format Kafka topics and writes the messages inside each topic into text files. The files are created with the extension ``.tmp`` and stored in a specified directory. The ``sqream.batchRecordCount`` parameter defines the number of records to be written to each file, and when the specified number is reached, the Sink Connector closes the file, renames it to ``sqream.fileExtension``, and then creates a new file. Unlike data streaming, which continuously sends data from the Kafka topic to the database, the Sink Connector only sends the data when the file size reaches a predefined threshold. This means that data will arrive in batches. - -SQream tables must be created according to the columns configured in ``csvorder``. - - -Sink Connector Configuration -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Configuration file structure: - - .. code-block:: postgres - - name=SQReamFileSink - topics=topsqreamtest1 - tasks.max=4 - connector.class=tr.com.entegral.FileSinkConnector - errors.tolerance=all - errors.log.enable=true - errors.log.include.messages=true - value.converter=org.apache.kafka.connect.json.JsonConverter - value.converter.schemas.enable=false - transforms=flatten - transforms.flatten.type=org.apache.kafka.connect.transforms.Flatten$Value - transforms.flatten.delimiter=. - sqream.outputdir=/home/sqream/kafkaconnect/outputs - sqream.batchRecordCount =10 - sqream.fileExtension=csv - sqream.removeNewline =false - sqream.outputType=csv - sqream.csvOrder=receivedTime,equipmentId,asdf,timestamp,intv - -The following parameters require configuration. - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - Topic - - A category or feed name to which messages are published and subscribed to - * - ``sqream.batchrecordcount`` - - The record count to be written to each file - * - ``outputdir`` - - Copy the ``sqream.outputdir`` path, from its beginning and until ``outputs``, included, and save it to a known location. It is required to configure SQream loader to use this section of the path - * - ``csvorder`` - - Defines table columns. SQream table columns must align with the ``csvorder`` table columns - - -Connection string: - - .. code-block:: postgres - - vi /home/sqream/kafkaconnect1/sqream-kafka-connector/sqream-kafkaconnect/config/sqream-filesink.properties - -Running commands: - - .. code-block:: postgres - - export JAVA_HOME=/home/sqream/copy-from-util/jdk-11;export CLASSPATH=.:$JAVA_HOME/jre/lib:$JAVA_HOME/lib:$JAVA_HOME/lib/tools.jar;cd /home/sqream/kafkaconnect1/kafka/bin/ && ./connect-standalone.sh /home/sqream/kafkaconnect1/sqream-kafka-connector/sqream-kafkaconnect/config/connect-standalone.properties /home/sqream/kafkaconnect1/sqream-kafka-connector/sqream-kafkaconnect/config/sqream-filesink.properties & - - - - -JDBC -------------- - -The JDBC connector can be used to ingest data from Kafka, allowing SQream DB to consume the messages directly. This enables efficient and secure data ingestion into SQream DB. - -.. contents:: - :local: - :depth: 1 - -JDBC Configuration -~~~~~~~~~~~~~~~~~~ - -.. code-block:: postgres - vi /home/sqream/kafkaconnect1/sqream-kafka-connector/sqream-kafkaconnect/config/sqream-jdbcsink.properties - -Example - -.. code-block:: postgres - - name=SQReamJDBCSink - topics=demo1 - tasks.max=1 - connector.class=tr.com.entegral.JDBCSinkConnector - errors.tolerance=all - errors.log.enable=true - errors.log.include.messages=true - value.converter=org.apache.kafka.connect.json.JsonConverter - value.converter.schemas.enable=false - transforms=flatten - transforms.flatten.type=org.apache.kafka.connect.transforms.Flatten$Value - transforms.flatten.delimiter=. - sqream.batchRecordCount =3 - #sqream.jdbc.connectionstring=jdbc:sqlserver://localhost;databaseName=TestDB;user=kafka;password=kafka;encrypt=true;trustServerCertificate=true; - sqream.jdbc.connectionstring=jdbc:Sqream://192.168.0.102:5001/kafka;user=sqream;password=sqream;cluster=false - sqream.input.inputfields=intStr,inInt,indateTime,inFloat - sqream.jdbc.tablename=testtable - sqream.jdbc.table.columnnames=colStr,colInt,Coldatetime,ColFloat - sqream.jdbc.table.columntypes=VARCHAR,INTEGER,TIMESTAMP,FLOAT - sqream.jdbc.dateformat=yyyy-MM-dd HH:mm:ss - -SQream Loader Configuration -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - -Building the SQream Loader: - - .. code-block:: postgres - - git clone -b develop http://gitlab.sq.l/java/copy-from-util.git - mvn clean package - - -Running the SQream Loader: - - .. code-block:: postgres - - git clone -b develop http://gitlab.sq.l/java/copy-from-util.git - mvn clean package - -What needs to be configured: - -.. list-table:: - :widths: auto - :header-rows: 1 - - - * - Parameter - - Description - * - ``root`` - – paste copied path to root - * - ``schema`` - - - * - ``name`` - - - -Configuration file structure: - - .. code-block:: postgres - - #config.yaml - - com: - sqream: - kafka: - common: - root: "/home/sqream/copy_from_root" - readyFileSuffix: ".csv" - connection: - ip: "127.0.0.1" - port: 3108 - database: "master" - cluster: true - user: sqream - pass: sqream - delimiter: "," - tables: - - schema: "public" - name: "t1" - parallel: 5 - - schema: "public" - name: "t2" - parallel: 3 - - schema: "public" - name: "t3" - parallel: 1 - - - - -Running commands: - - .. code-block:: postgres - - /home/sqream/copy-from-util/jdk-11/bin/java -jar /home/sqream/copy-from-util/copy-from-util/target/copy-from-util-0.0.1-SNAPSHOT.jar --spring.config.additional-location=/home/sqream/copy-from-util/config.yaml & - -Logging and Monitoring -======================== - -The following log files are created: - * JAVA application fails (consumer or loader?) - * Files cannot be saved to folder due to -Either - * Folder permission issue -Or - * SQream loader folder is not the same as Kenan folder - -Purging -======= -Ingested files are automatically zipped and archived for 60 days. - -Limitations -=========== - -Latency -Retention - -Examples -========= diff --git a/releases/2022.1.8.rst b/releases/2022.1.8.rst deleted file mode 100644 index c7ea25263..000000000 --- a/releases/2022.1.8.rst +++ /dev/null @@ -1,116 +0,0 @@ -.. _2022.1.8: - -************************** -Release Notes 2022.1.8 -************************** -The 2022.1.8 release notes were released on xx/xx/2022 and describe the following: - -.. contents:: - :local: - :depth: 1 - -New Features ----------- - - * Re-enabling an enhanced version of the :ref:`License Storage Capacity<monitoring_workers_and_services_from_the_dashboard>` feature - - :: - - * :ref:`Physical deletion performance enhancement<delete>` for file systems with delete parallelism capabilities - - :: - - -Known Issues ---------- -:ref:`Percentile<percentile_disc>` is not supported for Window functions. - -Version 2022.1.8 resolved Issues ---------- - -+---------------+------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+===============+==========================================================================================+ -| SQ-11199 | AWS S3 internal runtime error when executing ``COPY TO`` statement | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-11772 | Slow ``JOIN`` query | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-12228 | ``CREATE AS SELECT`` statement fails when executed with ``UNION ALL`` and ``GROUP BY`` | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-11296 | Slow catalog queries | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-11948 | ``SAVED QUERY`` execution using ``SELECT`` or ``INSERT INTO`` returns error | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-12255 | ``COPY TO`` string export error | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-12310 | ``DICT`` compression buffer size issue | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-12318 | JDBC ``insertBuffer`` parameter issue | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-12364 | ``GET DDL`` foreign table output issue | -+---------------+------------------------------------------------------------------------------------------+ -| SQ-12468 | Internal compiler error | -+---------------+------------------------------------------------------------------------------------------+ - - - - - - -Configuration Changes --------- -No configuration changes were made. - -Naming Changes -------- -No relevant naming changes were made. - -Deprecated Features -------- -SQream is declaring end of support of VARCHAR data type, the decision resulted by SQream's effort to enhance its core functionalities and with respect to ever changing echo system requirements. - -VARCHAR is no longer supported for new customers - effective from Version 2022.1.3 (September 2022). - -TEXT data type is replacing VARCHAR and NVARCHAR - SQream will maintain VARCHAR data type support until 09/30/2023. - - -End of Support -------- -No End of Support changes were made. - -Upgrading to v2022.1.8 -------- -1. Generate a back-up of the metadata by running the following command: - - .. code-block:: console - - $ select backup_metadata('out_path'); - - .. tip:: SQream recommends storing the generated back-up locally in case needed. - - SQream runs the Garbage Collector and creates a clean backup tarball package. - -2. Shut down all SQream services. - - :: - -3. Extract the recently created back-up file. - - :: - -4. Replace your current metadata with the metadata you stored in the back-up file. - - :: - -5. Navigate to the new SQream package bin folder. - - :: - -6. Run the following command: - - .. code-block:: console - - $ ./upgrade_storage <levelDB path> - - .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. - diff --git a/releases/2022.1_index.rst b/releases/2022.1_index.rst index a41453b32..e63294405 100644 --- a/releases/2022.1_index.rst +++ b/releases/2022.1_index.rst @@ -13,7 +13,6 @@ The 2022.1 Release Notes describe the following releases: :maxdepth: 1 :glob: - 2022.1.8 2022.1.7 2022.1.6 2022.1.5 diff --git a/releases/4.0.rst b/releases/4.0.rst new file mode 100644 index 000000000..c0b47b5b8 --- /dev/null +++ b/releases/4.0.rst @@ -0,0 +1,121 @@ +.. _4.0: + +************************** +Release Notes 4.0 +************************** + +SQream is introducing a new version release system that follows the more commonly used Major.Minor versioning schema. The newly released **4.0 version** is a minor version upgrade and does not require considerable preparation. + +The 4.0 release notes were released on 01/25/2023 and describe the following: + +.. contents:: + :local: + :depth: 1 + +New Features +------------ + + * Re-enabling an enhanced version of the :ref:`License Storage Capacity<monitoring_workers_and_services_from_the_dashboard>` feature + + :: + + * :ref:`Lightweight Directory Access Protocol(LDAP)<ldap>` may be used to authenticate SQream roles + + :: + + * :ref:`Physical deletion performance enhancement<delete>` by supporting file systems with parallelism capabilities + +SQream Studio Updates and Improvements +-------------------------------------- + + * When creating a **New Role**, you may now create a group role by selecting **Set as a group role**. + + :: + + * When editing an **Existing Role**, you are no longer obligated to update the role's password. + +Known Issues +------------ +:ref:`Percentile<percentile_disc>` is not supported for Window functions. + +Version 4.0 resolved Issues +----------------------------- + ++------------------------+------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++========================+==========================================================================================+ +| SQ-10544 | SQream Studio dashboard periodic update enhancement | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-11772 | Slow query performance when using ``JOIN`` clause | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12318 | JDBC ``insertBuffer`` parameter issue | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12364 | ``GET DDL`` foreign table output issue | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12446 | SQream Studio group role modification issue | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12468 | Internal compiler error | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12580 | Server Picker GPU dependency | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12652 | SQream Studio result panel adjustment | ++------------------------+------------------------------------------------------------------------------------------+ + + +Configuration Changes +--------------------- +No configuration changes were made. + +Naming Changes +-------------- +No relevant naming changes were made. + +Deprecated Features +------------------- +SQream is declaring end of support of VARCHAR data type, the decision resulted by SQream's effort to enhance its core functionalities and with respect to ever changing echo system requirements. + +VARCHAR is no longer supported for new customers - effective from Version 2022.1.3 (September 2022). + +TEXT data type is replacing VARCHAR and NVARCHAR - SQream will maintain VARCHAR data type support until 09/30/2023. + + +End of Support +--------------- +No End of Support changes were made. + +Upgrading to version 4.0 +------------------- +1. Generate a back-up of the metadata by running the following command: + + .. code-block:: console + + $ select backup_metadata('out_path'); + + .. tip:: SQream recommends storing the generated back-up locally in case needed. + + SQream runs the Garbage Collector and creates a clean backup tarball package. + +2. Shut down all SQream services. + + :: + +3. Extract the recently created back-up file. + + :: + +4. Replace your current metadata with the metadata you stored in the back-up file. + + :: + +5. Navigate to the new SQream package bin folder. + + :: + +6. Run the following command: + + .. code-block:: console + + $ ./upgrade_storage <levelDB path> + + .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. + diff --git a/releases/4.0_index.rst b/releases/4.0_index.rst new file mode 100644 index 000000000..680957f22 --- /dev/null +++ b/releases/4.0_index.rst @@ -0,0 +1,17 @@ +.. _4.0_index: + +************************** +Release Notes 4.0 +************************** +The 4.0 Release Notes describe the following releases: + +.. contents:: + :local: + :depth: 1 + +.. toctree:: + :maxdepth: 1 + :glob: + + 4.0 + 4.1 \ No newline at end of file diff --git a/releases/index.rst b/releases/index.rst index 107f323c8..196502b60 100644 --- a/releases/index.rst +++ b/releases/index.rst @@ -12,8 +12,8 @@ Release Notes * - Version - Release Date - * - :ref:`4.0.0` - - XXXX xx, xxxx + * - :ref:`4.0` + - January 25, 2023 * - :ref:`2022.1` - July 19, 2022 * - :ref:`2021.2` @@ -34,7 +34,7 @@ Release Notes :glob: :hidden: - 4.0.0_index + 4.0_index 2022.1_index 2021.2_index 2021.1_index From c4858bb951b54904e2d06583bab4b539c7643711 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 16 Feb 2023 17:16:38 +0200 Subject: [PATCH 427/882] Update generic_regular_flags.rst --- .../generic_regular_flags.rst | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/configuration_guides/generic_regular_flags.rst b/configuration_guides/generic_regular_flags.rst index 34ff6850c..c262982ec 100644 --- a/configuration_guides/generic_regular_flags.rst +++ b/configuration_guides/generic_regular_flags.rst @@ -6,16 +6,16 @@ Regular Generic Flags The **Regular Generic Flags** page describes **Regular** modification type flags, which can be modified by standard users on a session basis: -* `Flipping Join Order to Force Equijoins <https://docs.sqream.com/en/v2022.1.1/configuration_guides/flip_join_order.html>`_ -* `Determining Client Level <https://docs.sqream.com/en/v2022.1.1/configuration_guides/log_sys_level.html>`_ -* `Setting CPU to Compress Defined Columns <https://docs.sqream.com/en/v2022.1.1/configuration_guides/max_avg_blob_size_to_compress_on_gpu.html>`_ -* `Setting Query Memory Processing Limit <https://docs.sqream.com/en/v2022.1.1/configuration_guides/limit_query_memory_gb.html>`_ -* `Setting the Spool Memory <https://docs.sqream.com/en/v2022.1.1/configuration_guides/limit_query_memory_gb.html>`_ -* `Setting Cache Partitions <https://docs.sqream.com/en/v2022.1.1/configuration_guides/cache_partitions.html>`_ -* `Setting Cache Flushing <https://docs.sqream.com/en/v2022.1.1/configuration_guides/cache_eviction_milliseconds.html>`_ -* `Setting InMemory Spool Memory <https://docs.sqream.com/en/v2022.1.1/configuration_guides/cache_ram_gb.html>`_ -* `Setting Disk Spool Memory <https://docs.sqream.com/en/v2022.1.1/configuration_guides/cache_disk_gb.html>`_ -* `Setting Spool Saved File Directory Location <https://docs.sqream.com/en/v2022.1.1/configuration_guides/cache_disk_dir.html>`_ -* `Setting Data Stored Persistently on Cache <https://docs.sqream.com/en/v2022.1.1/configuration_guides/cache_persistent_gb.html>`_ -* `Setting Persistent Spool Saved File Directory Location <https://docs.sqream.com/en/v2022.1.1/configuration_guides/cache_persistent_dir.html>`_ -* `Setting Session Tag Name <https://docs.sqream.com/en/v2022.1.1/configuration_guides/session_tag.html>`_ \ No newline at end of file +* :ref:`Flipping Join Order to Force Equijoins<flip_join_order>` +* :ref:`Determining Client Level<log_sys_level>` +* :ref:`Setting CPU to Compress Defined Columns<max_avg_blob_size_to_compress_on_gpu>` +* :ref:`Setting Query Memory Processing Limit<limit_query_memory_gb>` +* :ref:`Setting the Spool Memory<spool_memory_gb>` +* :ref:`Setting Cache Partitions<cache_partitions>` +* :ref:`Setting Cache Flushing<cache_eviction_milliseconds>` +* :ref:`Setting InMemory Spool Memory<cache_ram_gb>` +* :ref:`Setting Disk Spool Memory<cache_disk_gb>` +* :ref:`Setting Spool Saved File Directory Location<cache_disk_dir>` +* :ref:`Setting Data Stored Persistently on Cache<cache_persistent_gb>` +* :ref:`Setting Persistent Spool Saved File Directory Location<cache_persistent_dir>` +* :ref:`Setting Session Tag Name<session_tag>` \ No newline at end of file From aed56a4c5f048fb02712331061ec7c3417da5a0c Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 19 Feb 2023 09:01:53 +0200 Subject: [PATCH 428/882] Update 4.1.0.rst --- releases/4.1.0.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/releases/4.1.0.rst b/releases/4.1.0.rst index d24ea13a2..0b279a2bd 100644 --- a/releases/4.1.0.rst +++ b/releases/4.1.0.rst @@ -6,7 +6,7 @@ Release Notes 4.1.0 SQream is introducing a new version release system that follows the more commonly used Major.Minor.Patch versioning schema. The newly released **4.0.0 version** is a minor version upgrade and does not require considerable preparation. -The 4.0.0 release notes were released on xx/xx/20xx and describe the following: +The 4.1.0 release notes were released on xx/xx/20xx and describe the following: .. contents:: :local: @@ -36,7 +36,7 @@ Known Issues ------------ :ref:`Percentile<percentile_disc>` is not supported for Window functions. -Version 4.0.0 resolved Issues +Version 4.1.0 resolved Issues ----------------------------- +------------------------+------------------------------------------------------------------------------------------+ @@ -89,7 +89,7 @@ End of Support --------------- No End of Support changes were made. -Upgrading to v4.0.0 +Upgrading to v4.1.0 ------------------- 1. Generate a back-up of the metadata by running the following command: From 8f0908ae0a44adf3b7146e5ba325cc6afdeaac19 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 19 Feb 2023 14:56:21 +0200 Subject: [PATCH 429/882] RN --- connecting_to_sqream/client_drivers/index.rst | 10 +- .../client_drivers/trino/index.rst | 144 ++++++++++++++++++ .../client_platforms/index.rst | 2 +- releases/4.1.0.rst | 127 --------------- releases/4.1.rst | 129 ++++++++++++++++ 5 files changed, 282 insertions(+), 130 deletions(-) create mode 100644 connecting_to_sqream/client_drivers/trino/index.rst delete mode 100644 releases/4.1.0.rst create mode 100644 releases/4.1.rst diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index a4400e40a..7ffd95138 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -27,6 +27,12 @@ The following are applicable to all operating systems: * `.NET .dll file <https://get.sqream-share.com/share/sIsu8fxv>`_ * :ref:`net` +.. _trino: + +* **Trino**: + + * `Trino connector <>`_ + * :ref:`trino` .. _python: @@ -96,16 +102,16 @@ The following are applicable to Linux: :caption: Client Driver Documentation: :titlesonly: + trino/index jdbc/index python/index - dotnet/index - kafka/index nodejs/index odbc/index dotnet/index + .. rubric:: Need help? If you couldn't find what you're looking for, we're always happy to help. Visit :ref:`information_for_support` for additional support. diff --git a/connecting_to_sqream/client_drivers/trino/index.rst b/connecting_to_sqream/client_drivers/trino/index.rst new file mode 100644 index 000000000..6a8ac9bac --- /dev/null +++ b/connecting_to_sqream/client_drivers/trino/index.rst @@ -0,0 +1,144 @@ +.. _trino: + +************************* +Connecting to SQream Using Trino +************************* + + +If you are using Trino for distributed SQL query processing and wish to use it to connect to a SQream, follow these instructions. + + +.. contents:: + :local: + :depth: 1 + +Prerequisites +------------- +To use Trino with SQream, you must have the following installed: + +* SQream version 4.1 or later +* Trino version 403 or later +* Trino Connector xxxx +* JDBC version 4.5.6 or later + + + +Installation +------------ + +.. contents:: + :local: + :depth: 1 + +JDBC +~~~~ + +In case JDBC is not yet configured, follow the `JDBC Client Drivers page <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/jdbc/index.html>`_ for registration and configuration guidance. + + +Trino Connector +~~~~~~~~~~~~~~~~~~~ + +The Trino Connector must be installed on each cluster node dedicated to Trino. + +1. Create a dedicated directory for the Trino Connector. + +2. Download the `Trino Connector<...>` and extract the content of the ZIP file to the dedicated directory, as shown in the example: + + +.. code-block:: postgres + + trino-server/ + └── plugin + └── sqream + ├── sqream-jdbc.jar + ├── trino-sqream-services.jar + ├── trino-sqream-SNAPSHOT.jar + └── all dependencies + + + +Connecting to SQream +-------------------- + +Trino uses catalogs for referencing stored objects such as tables, databases, and functions. Each Trino catalog may be configured with access to a single SQream database. If you wish Trino to have access to more than one SQream database or server, you must create additional catalogs. + +Catalogs may be created using ``properties`` files. Start by creating a ``sqream.properties`` file and placing it under ``trino-server/etc/catalog``. + +The following is an example of a properties file: + +.. code-block:: postgres + + connector.name=<name> + connection-url=jdbc:Sqream://<host and port>/<database name>;[<optional parameters>; ...] + connection-user=<user> + connection-password=<password> + +Syntax examples +--------------- + +The following is an example of the ``SHOW SCHEMAS FROM`` statement: + +.. code-block:: postgres + + SHOW SCHEMAS FROM sqream; + +The following is an example of the ``SHOW TABLES FROM`` statement: + +.. code-block:: postgres + + SHOW TABLES FROM sqream.public; + +The following is an example of the ``DESCRIBE sqream.public.t`` statement: + +.. code-block:: postgres + + DESCRIBE sqream.public.t; + + +Supported Data Types and Mapping +-------------------------------- +Use the appropriate Trino data type for executing queries. Upon execution, incompatible data types will be converted by Trino to SQream data types. + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Trino type + - SQream type + * - ``BOOLEAN`` + - ``BOOL`` + * - ``TINYINT`` + - ``TINYINT`` + * - ``SMALLINT`` + - ``SMALLINT`` + * - ``INT`` + - ``INT`` + * - ``BIGINT`` + - ``BIGINT`` + * - ``REAL`` + - ``REAL`` + * - ``DOUBLE`` + - ``DOUBLE`` + * - ``DATE`` + - ``DATE`` + * - ``TIMESTAMP`` + - ``DATETIME`` + * - ``VARCHAR(N)`` + - ``VARCHAR(N)``. + * - ``VARCHAR`` + - ``TEXT`` + * - ``DECIMAL(P,S)`` + - ``NUMERIC(P,S)`` + +.. note:: ``VARCHAR`` is soon to be deprecated and may not be used in SQream DB. + +Limitations +----------- + +The Trino Connector does not support the following SQL statements: + +* ``GRANT`` +* ``REVOKE`` +* ``SHOW GRANTSHOW ROLES`` +* ``SHOW ROLE GRANTS`` \ No newline at end of file diff --git a/connecting_to_sqream/client_platforms/index.rst b/connecting_to_sqream/client_platforms/index.rst index e765f56af..5a13fb6f4 100644 --- a/connecting_to_sqream/client_platforms/index.rst +++ b/connecting_to_sqream/client_platforms/index.rst @@ -22,7 +22,7 @@ If you are looking for a tool that is not listed, SQream and our partners can he :titlesonly: - spark + informatica microstrategy pentaho diff --git a/releases/4.1.0.rst b/releases/4.1.0.rst deleted file mode 100644 index 0b279a2bd..000000000 --- a/releases/4.1.0.rst +++ /dev/null @@ -1,127 +0,0 @@ -.. _4.1.0: - -************************** -Release Notes 4.1.0 -************************** - -SQream is introducing a new version release system that follows the more commonly used Major.Minor.Patch versioning schema. The newly released **4.0.0 version** is a minor version upgrade and does not require considerable preparation. - -The 4.1.0 release notes were released on xx/xx/20xx and describe the following: - -.. contents:: - :local: - :depth: 1 - -New Features ------------- - - * Re-enabling an enhanced version of the :ref:`License Storage Capacity<monitoring_workers_and_services_from_the_dashboard>` feature - - :: - - * :ref:`Lightweight Directory Access Protocol(LDAP)<ldap>` may be used to authenticate SQream roles - - :: - - * :ref:`Physical deletion performance enhancement<delete>` by supporting file systems with parallelism capabilities - -SQream Studio Updates and Improvements --------------------------------------- - - * When creating a **New Role**, you may now create a group role by selecting **Set as a group role**. - - :: - -Known Issues ------------- -:ref:`Percentile<percentile_disc>` is not supported for Window functions. - -Version 4.1.0 resolved Issues ------------------------------ - -+------------------------+------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+========================+==========================================================================================+ -| SQ-10544 | SQream Studio Worker Panel issue | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-11199 | AWS S3 internal runtime error when executing ``COPY TO`` statement | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-11296 | Slow catalog queries | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-11772 | Slow ``JOIN`` query | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-11948 | ``SAVED QUERY`` execution using ``SELECT`` or ``INSERT INTO`` returns error | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12228 | ``CREATE AS SELECT`` statement fails when executed with ``UNION ALL`` and ``GROUP BY`` | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12310 | ``DICT`` compression buffer size issue | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12318 | JDBC ``insertBuffer`` parameter issue | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12364 | ``GET DDL`` foreign table output issue | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12468 | Internal compiler error | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12580 | Server Picker GPU dependency | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12652 + 12844 | SQream Studio result panel adjustment | -+------------------------+------------------------------------------------------------------------------------------+ - - -Configuration Changes ---------------------- -No configuration changes were made. - -Naming Changes --------------- -No relevant naming changes were made. - -Deprecated Features -------------------- -SQream is declaring end of support of VARCHAR data type, the decision resulted by SQream's effort to enhance its core functionalities and with respect to ever changing echo system requirements. - -VARCHAR is no longer supported for new customers - effective from Version 2022.1.3 (September 2022). - -TEXT data type is replacing VARCHAR and NVARCHAR - SQream will maintain VARCHAR data type support until 09/30/2023. - - -End of Support ---------------- -No End of Support changes were made. - -Upgrading to v4.1.0 -------------------- -1. Generate a back-up of the metadata by running the following command: - - .. code-block:: console - - $ select backup_metadata('out_path'); - - .. tip:: SQream recommends storing the generated back-up locally in case needed. - - SQream runs the Garbage Collector and creates a clean backup tarball package. - -2. Shut down all SQream services. - - :: - -3. Extract the recently created back-up file. - - :: - -4. Replace your current metadata with the metadata you stored in the back-up file. - - :: - -5. Navigate to the new SQream package bin folder. - - :: - -6. Run the following command: - - .. code-block:: console - - $ ./upgrade_storage <levelDB path> - - .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. - diff --git a/releases/4.1.rst b/releases/4.1.rst new file mode 100644 index 000000000..20d57aaf6 --- /dev/null +++ b/releases/4.1.rst @@ -0,0 +1,129 @@ +.. _4.1: + +************************** +Release Notes 4.1 +************************** + +SQream is introducing a new version release system that follows the more commonly used Major.Minor.Patch versioning schema. The newly released **4.0 version** is a minor version upgrade and does not require considerable preparation. + +The 4.1 release notes were released on xx/xx/20xx and describe the following: + +.. contents:: + :local: + :depth: 1 + +New Features +------------ + + * :ref:`Lightweight Directory Access Protocol (LDAP)<ldap>` enhanced management + + :: + + * The :ref:`Trino<trino>` ETL tool may now be used for distributed SQL query processing + + :: + + * A brute-force attack protection locks out user accounts for 15 minutes following 5 consecutive failed login attempts + +SQream Studio Updates and Improvements +-------------------------------------- + +No Studio updates + + :: + +Known Issues +------------ + +No known issues + + +Version 4.1 resolved Issues +----------------------------- + ++------------------------+------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++========================+==========================================================================================+ +| SQ-11287 | Function definition SQL UDF parenthesis issue | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-11296 | Slow catalog queries | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12255 | Text column additional characters when using ``COPY TO`` statement | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12510 | Encryption memory issues | ++------------------------+------------------------------------------------------------------------------------------+ + + +Configuration Changes +--------------------- + +No configuration changes + + +Naming Changes +-------------- +No naming changes + + +Deprecated Features +------------------- + +► Square Brackets ``[]`` + +To facilitate the use of array data types, the ``[]``, which are frequently used to delimit identifiers such as column names, table names, and other database objects, have been deprecated. + +* Support in ``[]`` for delimiting database object identifiers ends at xx/xx/20xx. + +* You may still use double quotes ``""`` to delimit database object identifiers. + +► ``VARCHAR`` + +``VARCHAR`` is deprecated to improve the core functionalities of the platform and to align with the constantly evolving ecosystem requirements. + +* ``VARCHAR`` is no longer supported for new customers, effective from Version 2022.1.3 (September 2022). + +* The ``TEXT`` data type is replacing ``VARCHAR`` and ``NVARCHAR``. + +*Support in ``VARCHAR`` ends at September 30th, 2023. + + +End of Support +--------------- +No End of Support changes were made. + +Upgrading to v4.1 +------------------- +1. Generate a back-up of the metadata by running the following command: + + .. code-block:: console + + $ select backup_metadata('out_path'); + + .. tip:: SQream recommends storing the generated back-up locally in case needed. + + SQream runs the Garbage Collector and creates a clean backup tarball package. + +2. Shut down all SQream services. + + :: + +3. Extract the recently created back-up file. + + :: + +4. Replace your current metadata with the metadata you stored in the back-up file. + + :: + +5. Navigate to the new SQream package bin folder. + + :: + +6. Run the following command: + + .. code-block:: console + + $ ./upgrade_storage <levelDB path> + + .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. + From f1d1b34e7d2bb97a8cf9642b7b0fd3c373d6de7a Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 19 Feb 2023 14:57:44 +0200 Subject: [PATCH 430/882] Update 4.1.rst --- releases/4.1.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/4.1.rst b/releases/4.1.rst index 20d57aaf6..0f174e8a9 100644 --- a/releases/4.1.rst +++ b/releases/4.1.rst @@ -70,7 +70,7 @@ Deprecated Features ► Square Brackets ``[]`` -To facilitate the use of array data types, the ``[]``, which are frequently used to delimit identifiers such as column names, table names, and other database objects, have been deprecated. +To facilitate the use of array data types, the ``[]``, which are frequently used to delimit :ref:`identifiers<keywords_and_identifiers>` such as column names, table names, and other database objects, have been deprecated. * Support in ``[]`` for delimiting database object identifiers ends at xx/xx/20xx. From 77351a42a45487120f4982c72189d898d9c52ae1 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 19 Feb 2023 14:59:25 +0200 Subject: [PATCH 431/882] Update 4.1.rst --- releases/4.1.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/4.1.rst b/releases/4.1.rst index 0f174e8a9..0fde2a2cc 100644 --- a/releases/4.1.rst +++ b/releases/4.1.rst @@ -70,7 +70,7 @@ Deprecated Features ► Square Brackets ``[]`` -To facilitate the use of array data types, the ``[]``, which are frequently used to delimit :ref:`identifiers<keywords_and_identifiers>` such as column names, table names, and other database objects, have been deprecated. +To facilitate the use of Array data types, the ``[]``, which are frequently used to delimit :ref:`identifiers<keywords_and_identifiers>` such as column names, table names, and other database objects, have been deprecated. * Support in ``[]`` for delimiting database object identifiers ends at xx/xx/20xx. From 142f7a628caf00f68c6fb53e8cb82eed36ae86fb Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 19 Feb 2023 17:10:05 +0200 Subject: [PATCH 432/882] oracle --- data_ingestion/index.rst | 1 - index.rst | 2 -- 2 files changed, 3 deletions(-) diff --git a/data_ingestion/index.rst b/data_ingestion/index.rst index 6e8530710..290e0fce3 100644 --- a/data_ingestion/index.rst +++ b/data_ingestion/index.rst @@ -14,7 +14,6 @@ The **Data Ingestion Sources** page provides information about the following: csv parquet orc - oracle json For information about database tools and interfaces that SQream supports, see `Third Party Tools <https://docs.sqream.com/en/v2022.1.1/connecting_to_sqream/index.html>`_. \ No newline at end of file diff --git a/index.rst b/index.rst index 61e31b593..d09ca5bdd 100644 --- a/index.rst +++ b/index.rst @@ -33,8 +33,6 @@ SQream DB is a columnar analytic SQL database management system. SQream DB suppo +--------------------------+------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`parquet` | :ref:`orc` | | +--------------------------+------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ -| :ref:`oracle` | -+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | **Connecting to SQream** | +--------------------------+------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`client_platforms` | Describes how to install and connect a variety of third party connection platforms and tools. | From cf3940b004569215c3164d513c948e932c41acd9 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 19 Feb 2023 17:30:05 +0200 Subject: [PATCH 433/882] Update 4.1.rst --- releases/4.1.rst | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/releases/4.1.rst b/releases/4.1.rst index 0fde2a2cc..bb6f9a290 100644 --- a/releases/4.1.rst +++ b/releases/4.1.rst @@ -70,21 +70,24 @@ Deprecated Features ► Square Brackets ``[]`` -To facilitate the use of Array data types, the ``[]``, which are frequently used to delimit :ref:`identifiers<keywords_and_identifiers>` such as column names, table names, and other database objects, have been deprecated. +The ``[]``, which are frequently used to delimit :ref:`identifiers<keywords_and_identifiers>` such as column names, table names, and other database objects, will soon be deprecated to facilitate the use of the ``ARRAY`` data type. * Support in ``[]`` for delimiting database object identifiers ends at xx/xx/20xx. -* You may still use double quotes ``""`` to delimit database object identifiers. +* To delimit database object identifiers, you will be able to use double quotes ``""``. + ► ``VARCHAR`` -``VARCHAR`` is deprecated to improve the core functionalities of the platform and to align with the constantly evolving ecosystem requirements. +The ``VARCHAR`` data type is deprecated to improve the core functionalities of the platform and to align with the constantly evolving ecosystem requirements. + +* Support in the ``VARCHAR`` data type ends at September 30th, 2023. + +* ``VARCHAR`` is no longer supported for new customers, effective from Version 2022.1.3. -* ``VARCHAR`` is no longer supported for new customers, effective from Version 2022.1.3 (September 2022). +* The ``TEXT`` data type is replacing the ``VARCHAR`` and ``NVARCHAR`` data types. -* The ``TEXT`` data type is replacing ``VARCHAR`` and ``NVARCHAR``. -*Support in ``VARCHAR`` ends at September 30th, 2023. End of Support From 8cdd9ec641933fb7d40dd24b9c971b706e3f5663 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 19 Feb 2023 17:31:19 +0200 Subject: [PATCH 434/882] Update conf.py --- conf.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/conf.py b/conf.py index 104b75e03..2fee1f392 100644 --- a/conf.py +++ b/conf.py @@ -21,12 +21,12 @@ # -- Project information ----------------------------------------------------- project = 'SQream DB' -copyright = '2022 SQream' +copyright = '2023 SQream' author = 'SQream Documentation' # The full version, including alpha/beta/rc tags -release = '2022.1.7' +release = '4.1' From 3ba77725ad544bde0899d0d135ed0e622e7baf43 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 21 Feb 2023 09:57:06 +0200 Subject: [PATCH 435/882] Transactions --- feature_guides/index.rst | 1 - feature_guides/transactions.rst | 17 ----------------- reference/sql_feature_support.rst | 6 ++---- 3 files changed, 2 insertions(+), 22 deletions(-) delete mode 100644 feature_guides/transactions.rst diff --git a/feature_guides/index.rst b/feature_guides/index.rst index abb975c5d..4fe0652ce 100644 --- a/feature_guides/index.rst +++ b/feature_guides/index.rst @@ -17,6 +17,5 @@ This section describes the following features: compression python_functions workload_manager - transactions concurrency_and_locks concurrency_and_scaling_in_sqream \ No newline at end of file diff --git a/feature_guides/transactions.rst b/feature_guides/transactions.rst deleted file mode 100644 index 675957d51..000000000 --- a/feature_guides/transactions.rst +++ /dev/null @@ -1,17 +0,0 @@ -.. _transactions: - -*********************** -Transactions -*********************** - -SQream DB supports serializable transactions. This is also called 'ACID compliance'. - -The implementation of transactions means that commit, rollback and recovery are all extremely fast. - -SQream DB has extremely fast bulk insert speed, with minimal slowdown when running concurrent inserts. There is no performance reason to break large inserts up into multiple transactions. - -The phrase "supporting transactions" for a database system sometimes means having good performance for OLTP workloads, SQream DB's transaction system does not have high performance for high concurrency OLTP workloads. - -SQream DB also supports :ref:`transactional DDL<ddl_commands_list>`. - - diff --git a/reference/sql_feature_support.rst b/reference/sql_feature_support.rst index 4443d631a..d940215b0 100644 --- a/reference/sql_feature_support.rst +++ b/reference/sql_feature_support.rst @@ -64,10 +64,10 @@ Read more about :ref:`Yes data types<data_types>`. - Can be stored as a text string or as part of a ``DATETIME`` -Contraints +Constraints =============== -.. list-table:: Contraints +.. list-table:: Constraints :widths: auto :header-rows: 1 @@ -92,8 +92,6 @@ SQream DB treats each statement as an auto-commit transaction. Each transaction If a statement fails, the entire transaction is cancelled and rolled back. The database is unchanged. -Read more about :ref:`transactions in SQream DB<transactions>`. - Indexes ============ From 7943c19eeca507cf77d5be9b3e93f1911a234041 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 21 Feb 2023 11:10:12 +0200 Subject: [PATCH 436/882] Kafka --- .../client_drivers/Kafka/index.rst | 257 ++++++++++++++++++ connecting_to_sqream/client_drivers/index.rst | 5 + 2 files changed, 262 insertions(+) create mode 100644 connecting_to_sqream/client_drivers/Kafka/index.rst diff --git a/connecting_to_sqream/client_drivers/Kafka/index.rst b/connecting_to_sqream/client_drivers/Kafka/index.rst new file mode 100644 index 000000000..313a90f28 --- /dev/null +++ b/connecting_to_sqream/client_drivers/Kafka/index.rst @@ -0,0 +1,257 @@ +.. _kafka: + +************************* +Connecting to SQream Using Kafka +************************* + +If you are using Kafka Apache for distributed streaming and wish to use it with SQream, follow these instructions. +We support multi-topic streaming which means that numerous instances are required to be + + +.. contents:: + :local: + :depth: 1 + + +Before You Begin +================ + +* You must have JAVA 11 installed +* You must have `JDBC <java_jdbc>`_ deployed +* Your network bandwidth must be at least 100 mega per second +* Supported data formats for streamed data is JSON - Remove +* Kafka *** + +High Level Workflow +=================== + +1. Deploy the JDBC Connector. +2. Install kafka_2.12-3.2.1 +3. Configure +3. Run your Kafka Connect API. +4. + + + +Installation and Configuration +============================== + +Before you configure the Kafka Connector, make sure that Kafka and Zookeeper are both running. + +Kafka Connector workflow: + +.. figure:: /_static/images/kafka_flow.png + +.. contents:: + :local: + :depth: 1 + +Sink Connector +--------------- + +Download sink connector + +The Sink Connector reads JSON format Kafka topics and writes the messages inside each topic into text files. The files are created with the extension ``.tmp`` and stored in a specified directory. The ``sqream.batchRecordCount`` parameter defines the number of records to be written to each file, and when the specified number is reached, the Sink Connector closes the file, renames it to ``sqream.fileExtension``, and then creates a new file. Unlike data streaming, which continuously sends data from the Kafka topic to the database, the Sink Connector only sends the data when the file size reaches a predefined threshold. This means that data will arrive in batches. + +SQream tables must be created according to the columns configured in ``csvorder``. + + +Sink Connector Configuration +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Configuration file structure: + + .. code-block:: postgres + + name=SQReamFileSink + topics=topsqreamtest1 + tasks.max=4 + connector.class=tr.com.entegral.FileSinkConnector + errors.tolerance=all + errors.log.enable=true + errors.log.include.messages=true + value.converter=org.apache.kafka.connect.json.JsonConverter + value.converter.schemas.enable=false + transforms=flatten + transforms.flatten.type=org.apache.kafka.connect.transforms.Flatten$Value + transforms.flatten.delimiter=. + sqream.outputdir=/home/sqream/kafkaconnect/outputs + sqream.batchRecordCount =10 + sqream.fileExtension=csv + sqream.removeNewline =false + sqream.outputType=csv + sqream.csvOrder=receivedTime,equipmentId,asdf,timestamp,intv + +The following parameters require configuration. + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - Topic + - A category or feed name to which messages are published and subscribed to + * - ``sqream.batchrecordcount`` + - The record count to be written to each file + * - ``outputdir`` + - Copy the ``sqream.outputdir`` path, from its beginning and until ``outputs``, included, and save it to a known location. It is required to configure SQream loader to use this section of the path + * - ``csvorder`` + - Defines table columns. SQream table columns must align with the ``csvorder`` table columns + + +Connection string: + + .. code-block:: postgres + + vi /home/sqream/kafkaconnect1/sqream-kafka-connector/sqream-kafkaconnect/config/sqream-filesink.properties + +Running commands: + + .. code-block:: postgres + + export JAVA_HOME=/home/sqream/copy-from-util/jdk-11;export CLASSPATH=.:$JAVA_HOME/jre/lib:$JAVA_HOME/lib:$JAVA_HOME/lib/tools.jar;cd /home/sqream/kafkaconnect1/kafka/bin/ && ./connect-standalone.sh /home/sqream/kafkaconnect1/sqream-kafka-connector/sqream-kafkaconnect/config/connect-standalone.properties /home/sqream/kafkaconnect1/sqream-kafka-connector/sqream-kafkaconnect/config/sqream-filesink.properties & + + + + +JDBC +------------- + +The JDBC connector can be used to ingest data from Kafka, allowing SQream DB to consume the messages directly. This enables efficient and secure data ingestion into SQream DB. + +.. contents:: + :local: + :depth: 1 + +JDBC Configuration +~~~~~~~~~~~~~~~~~~ + +.. code-block:: postgres + vi /home/sqream/kafkaconnect1/sqream-kafka-connector/sqream-kafkaconnect/config/sqream-jdbcsink.properties + +Example + +.. code-block:: postgres + + name=SQReamJDBCSink + topics=demo1 + tasks.max=1 + connector.class=tr.com.entegral.JDBCSinkConnector + errors.tolerance=all + errors.log.enable=true + errors.log.include.messages=true + value.converter=org.apache.kafka.connect.json.JsonConverter + value.converter.schemas.enable=false + transforms=flatten + transforms.flatten.type=org.apache.kafka.connect.transforms.Flatten$Value + transforms.flatten.delimiter=. + sqream.batchRecordCount =3 + #sqream.jdbc.connectionstring=jdbc:sqlserver://localhost;databaseName=TestDB;user=kafka;password=kafka;encrypt=true;trustServerCertificate=true; + sqream.jdbc.connectionstring=jdbc:Sqream://192.168.0.102:5001/kafka;user=sqream;password=sqream;cluster=false + sqream.input.inputfields=intStr,inInt,indateTime,inFloat + sqream.jdbc.tablename=testtable + sqream.jdbc.table.columnnames=colStr,colInt,Coldatetime,ColFloat + sqream.jdbc.table.columntypes=VARCHAR,INTEGER,TIMESTAMP,FLOAT + sqream.jdbc.dateformat=yyyy-MM-dd HH:mm:ss + +SQream Loader Configuration +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +Building the SQream Loader: + + .. code-block:: postgres + + git clone -b develop http://gitlab.sq.l/java/copy-from-util.git + mvn clean package + + +Running the SQream Loader: + + .. code-block:: postgres + + git clone -b develop http://gitlab.sq.l/java/copy-from-util.git + mvn clean package + +What needs to be configured: + +.. list-table:: + :widths: auto + :header-rows: 1 + + + * - Parameter + - Description + * - ``root`` + – paste copied path to root + * - ``schema`` + - + * - ``name`` + - + +Configuration file structure: + + .. code-block:: postgres + + #config.yaml + + com: + sqream: + kafka: + common: + root: "/home/sqream/copy_from_root" + readyFileSuffix: ".csv" + connection: + ip: "127.0.0.1" + port: 3108 + database: "master" + cluster: true + user: sqream + pass: sqream + delimiter: "," + tables: + - schema: "public" + name: "t1" + parallel: 5 + - schema: "public" + name: "t2" + parallel: 3 + - schema: "public" + name: "t3" + parallel: 1 + + + + +Running commands: + + .. code-block:: postgres + + /home/sqream/copy-from-util/jdk-11/bin/java -jar /home/sqream/copy-from-util/copy-from-util/target/copy-from-util-0.0.1-SNAPSHOT.jar --spring.config.additional-location=/home/sqream/copy-from-util/config.yaml & + +Logging and Monitoring +======================== + +The following log files are created: + * JAVA application fails (consumer or loader?) + * Files cannot be saved to folder due to +Either + * Folder permission issue +Or + * SQream loader folder is not the same as Kenan folder + +Purging +======= +Ingested files are automatically zipped and archived for 60 days. +User needs to prepare storage. +User may configure archive time. + +Limitations +=========== + +Latency +Retention + +Examples +========= diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index 7ffd95138..ff35fed10 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -64,6 +64,11 @@ The following are applicable to all operating systems: * `Power BI PowerQuery connector <https://sq-ftp-public.s3.amazonaws.com/SqlODBC__v1.0.mez>`_ - SQream (.mez) * :ref:`power_bi` + +* **Kafka**: + + * :ref:`Kafka<kafka>` + Windows From 47e5fa6c3681de2b394a1b11342cc82c196e549d Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 21 Feb 2023 11:16:53 +0200 Subject: [PATCH 437/882] Update index.rst --- connecting_to_sqream/client_drivers/Kafka/index.rst | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/connecting_to_sqream/client_drivers/Kafka/index.rst b/connecting_to_sqream/client_drivers/Kafka/index.rst index 313a90f28..a69b5503f 100644 --- a/connecting_to_sqream/client_drivers/Kafka/index.rst +++ b/connecting_to_sqream/client_drivers/Kafka/index.rst @@ -20,16 +20,17 @@ Before You Begin * You must have `JDBC <java_jdbc>`_ deployed * Your network bandwidth must be at least 100 mega per second * Supported data formats for streamed data is JSON - Remove -* Kafka *** +* Kafka 2.12-3.2.1 High Level Workflow =================== -1. Deploy the JDBC Connector. -2. Install kafka_2.12-3.2.1 -3. Configure -3. Run your Kafka Connect API. -4. +1. Deploy the JDBC Connector +2. Download Sink Connector +3. Configure Sink Connector +4. Download SQream Loader +5. Configure SQream Loader +6. Run your Kafka Connect API From 9d365085aceb0ce7cbf99ab299b6f3c7b0e28d3d Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 21 Feb 2023 14:03:37 +0200 Subject: [PATCH 438/882] Kafka --- .../client_drivers/Kafka/index.rst | 258 ------------------ connecting_to_sqream/client_drivers/index.rst | 3 - 2 files changed, 261 deletions(-) delete mode 100644 connecting_to_sqream/client_drivers/Kafka/index.rst diff --git a/connecting_to_sqream/client_drivers/Kafka/index.rst b/connecting_to_sqream/client_drivers/Kafka/index.rst deleted file mode 100644 index a69b5503f..000000000 --- a/connecting_to_sqream/client_drivers/Kafka/index.rst +++ /dev/null @@ -1,258 +0,0 @@ -.. _kafka: - -************************* -Connecting to SQream Using Kafka -************************* - -If you are using Kafka Apache for distributed streaming and wish to use it with SQream, follow these instructions. -We support multi-topic streaming which means that numerous instances are required to be - - -.. contents:: - :local: - :depth: 1 - - -Before You Begin -================ - -* You must have JAVA 11 installed -* You must have `JDBC <java_jdbc>`_ deployed -* Your network bandwidth must be at least 100 mega per second -* Supported data formats for streamed data is JSON - Remove -* Kafka 2.12-3.2.1 - -High Level Workflow -=================== - -1. Deploy the JDBC Connector -2. Download Sink Connector -3. Configure Sink Connector -4. Download SQream Loader -5. Configure SQream Loader -6. Run your Kafka Connect API - - - -Installation and Configuration -============================== - -Before you configure the Kafka Connector, make sure that Kafka and Zookeeper are both running. - -Kafka Connector workflow: - -.. figure:: /_static/images/kafka_flow.png - -.. contents:: - :local: - :depth: 1 - -Sink Connector ---------------- - -Download sink connector - -The Sink Connector reads JSON format Kafka topics and writes the messages inside each topic into text files. The files are created with the extension ``.tmp`` and stored in a specified directory. The ``sqream.batchRecordCount`` parameter defines the number of records to be written to each file, and when the specified number is reached, the Sink Connector closes the file, renames it to ``sqream.fileExtension``, and then creates a new file. Unlike data streaming, which continuously sends data from the Kafka topic to the database, the Sink Connector only sends the data when the file size reaches a predefined threshold. This means that data will arrive in batches. - -SQream tables must be created according to the columns configured in ``csvorder``. - - -Sink Connector Configuration -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Configuration file structure: - - .. code-block:: postgres - - name=SQReamFileSink - topics=topsqreamtest1 - tasks.max=4 - connector.class=tr.com.entegral.FileSinkConnector - errors.tolerance=all - errors.log.enable=true - errors.log.include.messages=true - value.converter=org.apache.kafka.connect.json.JsonConverter - value.converter.schemas.enable=false - transforms=flatten - transforms.flatten.type=org.apache.kafka.connect.transforms.Flatten$Value - transforms.flatten.delimiter=. - sqream.outputdir=/home/sqream/kafkaconnect/outputs - sqream.batchRecordCount =10 - sqream.fileExtension=csv - sqream.removeNewline =false - sqream.outputType=csv - sqream.csvOrder=receivedTime,equipmentId,asdf,timestamp,intv - -The following parameters require configuration. - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - Topic - - A category or feed name to which messages are published and subscribed to - * - ``sqream.batchrecordcount`` - - The record count to be written to each file - * - ``outputdir`` - - Copy the ``sqream.outputdir`` path, from its beginning and until ``outputs``, included, and save it to a known location. It is required to configure SQream loader to use this section of the path - * - ``csvorder`` - - Defines table columns. SQream table columns must align with the ``csvorder`` table columns - - -Connection string: - - .. code-block:: postgres - - vi /home/sqream/kafkaconnect1/sqream-kafka-connector/sqream-kafkaconnect/config/sqream-filesink.properties - -Running commands: - - .. code-block:: postgres - - export JAVA_HOME=/home/sqream/copy-from-util/jdk-11;export CLASSPATH=.:$JAVA_HOME/jre/lib:$JAVA_HOME/lib:$JAVA_HOME/lib/tools.jar;cd /home/sqream/kafkaconnect1/kafka/bin/ && ./connect-standalone.sh /home/sqream/kafkaconnect1/sqream-kafka-connector/sqream-kafkaconnect/config/connect-standalone.properties /home/sqream/kafkaconnect1/sqream-kafka-connector/sqream-kafkaconnect/config/sqream-filesink.properties & - - - - -JDBC -------------- - -The JDBC connector can be used to ingest data from Kafka, allowing SQream DB to consume the messages directly. This enables efficient and secure data ingestion into SQream DB. - -.. contents:: - :local: - :depth: 1 - -JDBC Configuration -~~~~~~~~~~~~~~~~~~ - -.. code-block:: postgres - vi /home/sqream/kafkaconnect1/sqream-kafka-connector/sqream-kafkaconnect/config/sqream-jdbcsink.properties - -Example - -.. code-block:: postgres - - name=SQReamJDBCSink - topics=demo1 - tasks.max=1 - connector.class=tr.com.entegral.JDBCSinkConnector - errors.tolerance=all - errors.log.enable=true - errors.log.include.messages=true - value.converter=org.apache.kafka.connect.json.JsonConverter - value.converter.schemas.enable=false - transforms=flatten - transforms.flatten.type=org.apache.kafka.connect.transforms.Flatten$Value - transforms.flatten.delimiter=. - sqream.batchRecordCount =3 - #sqream.jdbc.connectionstring=jdbc:sqlserver://localhost;databaseName=TestDB;user=kafka;password=kafka;encrypt=true;trustServerCertificate=true; - sqream.jdbc.connectionstring=jdbc:Sqream://192.168.0.102:5001/kafka;user=sqream;password=sqream;cluster=false - sqream.input.inputfields=intStr,inInt,indateTime,inFloat - sqream.jdbc.tablename=testtable - sqream.jdbc.table.columnnames=colStr,colInt,Coldatetime,ColFloat - sqream.jdbc.table.columntypes=VARCHAR,INTEGER,TIMESTAMP,FLOAT - sqream.jdbc.dateformat=yyyy-MM-dd HH:mm:ss - -SQream Loader Configuration -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - -Building the SQream Loader: - - .. code-block:: postgres - - git clone -b develop http://gitlab.sq.l/java/copy-from-util.git - mvn clean package - - -Running the SQream Loader: - - .. code-block:: postgres - - git clone -b develop http://gitlab.sq.l/java/copy-from-util.git - mvn clean package - -What needs to be configured: - -.. list-table:: - :widths: auto - :header-rows: 1 - - - * - Parameter - - Description - * - ``root`` - – paste copied path to root - * - ``schema`` - - - * - ``name`` - - - -Configuration file structure: - - .. code-block:: postgres - - #config.yaml - - com: - sqream: - kafka: - common: - root: "/home/sqream/copy_from_root" - readyFileSuffix: ".csv" - connection: - ip: "127.0.0.1" - port: 3108 - database: "master" - cluster: true - user: sqream - pass: sqream - delimiter: "," - tables: - - schema: "public" - name: "t1" - parallel: 5 - - schema: "public" - name: "t2" - parallel: 3 - - schema: "public" - name: "t3" - parallel: 1 - - - - -Running commands: - - .. code-block:: postgres - - /home/sqream/copy-from-util/jdk-11/bin/java -jar /home/sqream/copy-from-util/copy-from-util/target/copy-from-util-0.0.1-SNAPSHOT.jar --spring.config.additional-location=/home/sqream/copy-from-util/config.yaml & - -Logging and Monitoring -======================== - -The following log files are created: - * JAVA application fails (consumer or loader?) - * Files cannot be saved to folder due to -Either - * Folder permission issue -Or - * SQream loader folder is not the same as Kenan folder - -Purging -======= -Ingested files are automatically zipped and archived for 60 days. -User needs to prepare storage. -User may configure archive time. - -Limitations -=========== - -Latency -Retention - -Examples -========= diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index ff35fed10..6f8f5909a 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -65,9 +65,6 @@ The following are applicable to all operating systems: * `Power BI PowerQuery connector <https://sq-ftp-public.s3.amazonaws.com/SqlODBC__v1.0.mez>`_ - SQream (.mez) * :ref:`power_bi` -* **Kafka**: - - * :ref:`Kafka<kafka>` From 38db8fc9f8b5c51d42094f15fafb521b9b833007 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 21 Feb 2023 17:22:23 +0200 Subject: [PATCH 439/882] Update alter_default_permissions.rst --- .../access_control_commands/alter_default_permissions.rst | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst b/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst index a49e53f88..d9849602a 100644 --- a/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst +++ b/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst @@ -36,9 +36,7 @@ The following is the syntax for altering default permissions: grant_clause ::= GRANT - { CREATE FUNCTION - | SUPERUSER - | CONNECT + { SUPERUSER | CREATE | USAGE | SELECT @@ -46,7 +44,6 @@ The following is the syntax for altering default permissions: | UPDATE | DELETE | DDL - | EXECUTE | ALL } From 47da8645e21a0d441a813e92cd317679f552f746 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 22 Feb 2023 10:10:14 +0200 Subject: [PATCH 440/882] Update get_statement_permissions.rst --- .../get_statement_permissions.rst | 55 ++++++++++++++++++- 1 file changed, 52 insertions(+), 3 deletions(-) diff --git a/reference/sql/sql_statements/access_control_commands/get_statement_permissions.rst b/reference/sql/sql_statements/access_control_commands/get_statement_permissions.rst index 0846c5cc4..f83a2efb2 100644 --- a/reference/sql/sql_statements/access_control_commands/get_statement_permissions.rst +++ b/reference/sql/sql_statements/access_control_commands/get_statement_permissions.rst @@ -58,9 +58,58 @@ If the statement requires no special permissions, the utility returns an empty r * - ``object_name`` - The object name -.. include:: grant.rst - :start-line: 127 - :end-line: 180 +The following table describes the supported permissions: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Permission + - Object + - Description + * - ``LOGIN`` + - Cluster + - Login permissions (with a password) allows a role to be a user and login to a database + * - ``PASSWORD`` + - Cluster + - Sets the password for a user role + * - ``CREATE FUNCTION`` + - Database + - Allows a user to :ref:`create a Python UDF<create_function>` + * - ``SUPERUSER`` + - Cluster, Database, Schema + - The most privileged role, with full control over a cluster, database, or schema + * - ``CONNECT`` + - Database + - Allows a user to connect and use a database + * - ``CREATE`` + - Database, Schema + - For a role to create and manage objects, it needs the ``CREATE`` and ``USAGE`` permissions at the respective level + * - ``USAGE`` + - Schema + - For a role to see tables in a schema, it needs the ``USAGE`` permissions + * - ``SELECT`` + - Table + - Allows a user to run :ref:`select` queries on table contents + * - ``INSERT`` + - Table + - Allows a user to run :ref:`copy_from` and :ref:`insert` statements to load data into a table + * - ``UPDATE`` + - Table + - Allows a user to modify the value of certain columns in existing rows without creating a table + * - ``DELETE`` + - Table + - Allows a user to run :ref:`delete`, :ref:`truncate` statements to delete data from a table + * - ``DDL`` + - Database, Schema, Table, Function + - Allows a user to :ref:`alter tables<alter_table>`, rename columns and tables, etc. + * - ``EXECUTE`` + - Function + - Allows a user to execute UDFs + * - ``ALL`` + - Cluster, Database, Schema, Table, Function + - All of the above permissions at the respective level + Examples =========== From 5372bf05619beab908786abe2eff090a7f4462db Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 22 Feb 2023 11:56:40 +0200 Subject: [PATCH 441/882] ascii --- reference/sql/sql_functions/index.rst | 2 + .../sql_functions/scalar_functions/index.rst | 3 +- .../scalar_functions/string/decode.rst | 12 ++--- .../scalar_functions/string/select_ascii.rst | 46 +++++++++++++++++++ 4 files changed, 54 insertions(+), 9 deletions(-) create mode 100644 reference/sql/sql_functions/scalar_functions/string/select_ascii.rst diff --git a/reference/sql/sql_functions/index.rst b/reference/sql/sql_functions/index.rst index a66760b7f..af0b0e166 100644 --- a/reference/sql/sql_functions/index.rst +++ b/reference/sql/sql_functions/index.rst @@ -267,6 +267,8 @@ The following table shows the **string** functions: - Trims whitespaces from an argument * - :ref:`upper` - Converts an argument to an upper-case equivalent + * - :ref:`select_ascii` + - Return the ASCII code value of the leftmost character of a string User-Defined Scalar Functions --------------------- diff --git a/reference/sql/sql_functions/scalar_functions/index.rst b/reference/sql/sql_functions/scalar_functions/index.rst index ae70874e3..a3dd88448 100644 --- a/reference/sql/sql_functions/scalar_functions/index.rst +++ b/reference/sql/sql_functions/scalar_functions/index.rst @@ -83,4 +83,5 @@ The **Built-In Scalar Functions** page describes functions that return one value * :ref:`rtrim` * :ref:`substring` * :ref:`trim` - * :ref:`upper` \ No newline at end of file + * :ref:`upper` + * :ref:`select_ascii` \ No newline at end of file diff --git a/reference/sql/sql_functions/scalar_functions/string/decode.rst b/reference/sql/sql_functions/scalar_functions/string/decode.rst index 1ed10e399..a83b027b2 100644 --- a/reference/sql/sql_functions/scalar_functions/string/decode.rst +++ b/reference/sql/sql_functions/scalar_functions/string/decode.rst @@ -3,7 +3,7 @@ ******************** DECODE ******************** -The **DECODE** function is a PostgreSQL function used for decoding or extracting binary data from a textual input string. +The **DECODE** function is used for decoding or extracting binary data from a textual input string. Syntax ========== @@ -11,7 +11,7 @@ The following shows the correct syntax for the DECODE function: .. code-block:: postgres - decode(string input_text, format type_text) + DECODE(string input_text, format type_text) Parameters ============ @@ -30,18 +30,14 @@ The following table shows the DECODE parameters: Returns ========= -**Comment** - *What does it return?* -Notes -=========== -**Comment** - *Are there any relevant notes?* + Examples =========== -**Comment** - *What does the actual output look like? Can you provide an example?* + Permissions ============= -**Comment** - *Please confirm what permissions the role requires.* The role must have the ``SUPERUSER`` permissions. \ No newline at end of file diff --git a/reference/sql/sql_functions/scalar_functions/string/select_ascii.rst b/reference/sql/sql_functions/scalar_functions/string/select_ascii.rst new file mode 100644 index 000000000..cf9e2c058 --- /dev/null +++ b/reference/sql/sql_functions/scalar_functions/string/select_ascii.rst @@ -0,0 +1,46 @@ +.. _select_ascii: + +******************** +SELECT ASCII +******************** +The **SELECT ASCII** function is used to return the ASCII code value of the leftmost character of a string. + +Syntax +========== +The following shows the syntax for the SELECT ASCII function: + +.. code-block:: postgres + + SELECT ASCII(''); + +Parameters +============ +The following table shows the DECODE parameters: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - + - + * - + - + +Returns +========= + +The SELECT ASCII function returns ``integer``. + +Example +=========== +.. code-block:: postgres + + SELECT ASCII('hello'); + + +Permissions +============= + +The role must have the ``SUPERUSER`` permissions. \ No newline at end of file From 647b0f526d0da53ed2b33387b7998292b7770e28 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 22 Feb 2023 13:47:32 +0200 Subject: [PATCH 442/882] ASCII --- .../scalar_functions/string/select_ascii.rst | 25 ++----------------- 1 file changed, 2 insertions(+), 23 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/string/select_ascii.rst b/reference/sql/sql_functions/scalar_functions/string/select_ascii.rst index cf9e2c058..562a7e355 100644 --- a/reference/sql/sql_functions/scalar_functions/string/select_ascii.rst +++ b/reference/sql/sql_functions/scalar_functions/string/select_ascii.rst @@ -3,7 +3,7 @@ ******************** SELECT ASCII ******************** -The **SELECT ASCII** function is used to return the ASCII code value of the leftmost character of a string. +The **SELECT ASCII** function is commonly used in combination with other SQL functions for operations such as data transformation, validation, and storing based on ASCII values. Syntax ========== @@ -13,34 +13,13 @@ The following shows the syntax for the SELECT ASCII function: SELECT ASCII(''); -Parameters -============ -The following table shows the DECODE parameters: - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Parameter - - Description - * - - - - * - - - - Returns ========= -The SELECT ASCII function returns ``integer``. +The SELECT ASCII function returns the ASCII code value of the leftmost character of a string. Example =========== .. code-block:: postgres SELECT ASCII('hello'); - - -Permissions -============= - -The role must have the ``SUPERUSER`` permissions. \ No newline at end of file From 30c16898cbf53e2bd66ba28e72075453810a1582 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 26 Feb 2023 09:44:13 +0200 Subject: [PATCH 443/882] Update 4.1.rst --- releases/4.1.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/releases/4.1.rst b/releases/4.1.rst index bb6f9a290..6c502e377 100644 --- a/releases/4.1.rst +++ b/releases/4.1.rst @@ -15,7 +15,7 @@ The 4.1 release notes were released on xx/xx/20xx and describe the following: New Features ------------ - * :ref:`Lightweight Directory Access Protocol (LDAP)<ldap>` enhanced management + * :ref:`Lightweight Directory Access Protocol (LDAP)<ldap>` management enhancement :: @@ -23,7 +23,7 @@ New Features :: - * A brute-force attack protection locks out user accounts for 15 minutes following 5 consecutive failed login attempts + * A new brute-force attack protection mechanism locks out user accounts for 15 minutes following 5 consecutive failed login attempts SQream Studio Updates and Improvements -------------------------------------- From 4e752088785c6ddd9f71f394d49c6413e66e8626 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 26 Feb 2023 11:23:01 +0200 Subject: [PATCH 444/882] Update 4.0.rst --- releases/4.0.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/releases/4.0.rst b/releases/4.0.rst index c0b47b5b8..1db6492d2 100644 --- a/releases/4.0.rst +++ b/releases/4.0.rst @@ -46,6 +46,8 @@ Version 4.0 resolved Issues +========================+==========================================================================================+ | SQ-10544 | SQream Studio dashboard periodic update enhancement | +------------------------+------------------------------------------------------------------------------------------+ +| SQ-11296 | Slow catalog queries | ++------------------------+------------------------------------------------------------------------------------------+ | SQ-11772 | Slow query performance when using ``JOIN`` clause | +------------------------+------------------------------------------------------------------------------------------+ | SQ-12318 | JDBC ``insertBuffer`` parameter issue | @@ -58,8 +60,12 @@ Version 4.0 resolved Issues +------------------------+------------------------------------------------------------------------------------------+ | SQ-12580 | Server Picker GPU dependency | +------------------------+------------------------------------------------------------------------------------------+ +| SQ-12598 | Executing ``SELECT`` on a foreign table with no valid path produces no error message | ++------------------------+------------------------------------------------------------------------------------------+ | SQ-12652 | SQream Studio result panel adjustment | +------------------------+------------------------------------------------------------------------------------------+ +| SQ-13055 | NULL issue when executing query with pysqream | ++------------------------+------------------------------------------------------------------------------------------+ Configuration Changes From 15110ae5b35b0d019e42d9f3a069c825c45a3428 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 26 Feb 2023 11:53:07 +0200 Subject: [PATCH 445/882] Update 4.0.rst --- releases/4.0.rst | 51 ++++++++++++++++++++++++------------------------ 1 file changed, 26 insertions(+), 25 deletions(-) diff --git a/releases/4.0.rst b/releases/4.0.rst index 1db6492d2..65e8c25f5 100644 --- a/releases/4.0.rst +++ b/releases/4.0.rst @@ -41,31 +41,32 @@ Known Issues Version 4.0 resolved Issues ----------------------------- -+------------------------+------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+========================+==========================================================================================+ -| SQ-10544 | SQream Studio dashboard periodic update enhancement | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-11296 | Slow catalog queries | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-11772 | Slow query performance when using ``JOIN`` clause | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12318 | JDBC ``insertBuffer`` parameter issue | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12364 | ``GET DDL`` foreign table output issue | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12446 | SQream Studio group role modification issue | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12468 | Internal compiler error | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12580 | Server Picker GPU dependency | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12598 | Executing ``SELECT`` on a foreign table with no valid path produces no error message | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12652 | SQream Studio result panel adjustment | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-13055 | NULL issue when executing query with pysqream | -+------------------------+------------------------------------------------------------------------------------------+ ++-----------------+---------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++=================+=======================================================================================+ +| SQ-10544 | SQream Studio dashboard periodic update enhancement | ++-----------------+---------------------------------------------------------------------------------------+ +| SQ-11296 | Slow catalog queries | ++-----------------+---------------------------------------------------------------------------------------+ +| SQ-11772 | Slow query performance when using ``JOIN`` clause | ++-----------------+---------------------------------------------------------------------------------------+ +| SQ-12318 | JDBC ``insertBuffer`` parameter issue | ++-----------------+---------------------------------------------------------------------------------------+ +| SQ-12364 | ``GET DDL`` foreign table output issue | ++-----------------+---------------------------------------------------------------------------------------+ +| SQ-12446 | SQream Studio group role modification issue | ++-----------------+---------------------------------------------------------------------------------------+ +| SQ-12468 | Internal compiler error | ++-----------------+---------------------------------------------------------------------------------------+ +| SQ-12580 | Server Picker GPU dependency | ++-----------------+---------------------------------------------------------------------------------------+ +| SQ-12598 | Executing ``SELECT`` on a foreign table with no valid path produces no error message | ++-----------------+---------------------------------------------------------------------------------------+ +| SQ-12652 | SQream Studio result panel adjustment | ++-----------------+---------------------------------------------------------------------------------------+ +| SQ-13055 | NULL issue when executing query with pysqream | ++-----------------+---------------------------------------------------------------------------------------+ + Configuration Changes From ab2e1f3403eb917c72165be22be2fc981bb47ce4 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 26 Feb 2023 13:57:55 +0200 Subject: [PATCH 446/882] Update installing_sqream_with_binary.rst --- installation_guides/installing_sqream_with_binary.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/installation_guides/installing_sqream_with_binary.rst b/installation_guides/installing_sqream_with_binary.rst index 7a3c7fff8..6a21ee29f 100644 --- a/installation_guides/installing_sqream_with_binary.rst +++ b/installation_guides/installing_sqream_with_binary.rst @@ -272,6 +272,6 @@ For an example of stopping actively running SQream services, see :ref:`Launching 1 row time: 0.050603s -For more information, see the `upgrade_storage <https://docs.sqream.com/en/v2020-1/reference/cli/upgrade_storage.html>`_ command line program. +For more information, see the :ref:`upgrade_storage<upgrade_storage_cli_reference>` command line program. -For more information about installing Studio on a stand-alone server, see `Installing Studio on a Stand-Alone Server <https://docs.sqream.com/en/v2020-1/installation_guides/installing_studio_on_stand_alone_server.html>`_. \ No newline at end of file +For more information about installing Studio on a stand-alone server, see :ref:`Installing Studio on a Stand-Alone Server<installing_studio_on_stand_alone_server>`. \ No newline at end of file From 6bef242d21cec8e544673ea9379e1c020ee94ffe Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 26 Feb 2023 17:34:27 +0200 Subject: [PATCH 447/882] SIGN function --- reference/sql/sql_functions/index.rst | 2 + .../sql_functions/scalar_functions/index.rst | 3 +- .../scalar_functions/numeric/sign.rst | 53 +++++++++++++++++++ 3 files changed, 57 insertions(+), 1 deletion(-) create mode 100644 reference/sql/sql_functions/scalar_functions/numeric/sign.rst diff --git a/reference/sql/sql_functions/index.rst b/reference/sql/sql_functions/index.rst index af0b0e166..b06a754f7 100644 --- a/reference/sql/sql_functions/index.rst +++ b/reference/sql/sql_functions/index.rst @@ -206,6 +206,8 @@ The following table shows the **arithmetic operator** functions: - Calculates the tangent of an argument * - :ref:`trunc` - Rounds a number to its integer representation towards 0 + * - :ref:`sign` + - Returns an integer value of -1, 0, or 1, depending on the sign of the input expression. Strings ^^^^^^^^^^^ diff --git a/reference/sql/sql_functions/scalar_functions/index.rst b/reference/sql/sql_functions/scalar_functions/index.rst index a3dd88448..aac74d8e2 100644 --- a/reference/sql/sql_functions/scalar_functions/index.rst +++ b/reference/sql/sql_functions/scalar_functions/index.rst @@ -84,4 +84,5 @@ The **Built-In Scalar Functions** page describes functions that return one value * :ref:`substring` * :ref:`trim` * :ref:`upper` - * :ref:`select_ascii` \ No newline at end of file + * :ref:`select_ascii` + * :ref:`sign` \ No newline at end of file diff --git a/reference/sql/sql_functions/scalar_functions/numeric/sign.rst b/reference/sql/sql_functions/scalar_functions/numeric/sign.rst new file mode 100644 index 000000000..1fc32d1b7 --- /dev/null +++ b/reference/sql/sql_functions/scalar_functions/numeric/sign.rst @@ -0,0 +1,53 @@ +.. _sign: + +************************** +SIGN +************************** + +The SIGN function takes a single argument, which can be any numeric data type such as INTEGER, FLOAT, or DECIMAL. The function returns an integer value of -1, 0, or 1, depending on the sign of the input expression. + + + +Syntax +========== + +.. code-block:: postgres + + SELECT SIGN (); + +Arguments +========= + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``numeric_expression`` + - Numeric data types + +Returns +============ + +* -1 if the input expression is negative + +* 0 if the input expression is zero + +* 1 if the input expression is positive + + +Example +======= + +.. code-block:: postgres + + SELECT SIGN(-10), SIGN(0), SIGN(5) ; + +Output: + +.. code-block:: postgres + + sign | sign0 | sign1 + -----+------+------- + -1 | 0 | 1 From 88785ce02dc52dd28b5501076ec493954519c9ce Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 28 Feb 2023 13:22:37 +0200 Subject: [PATCH 448/882] Update access_control_permissions.rst --- .../access_control_permissions.rst | 28 +++++++++---------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/operational_guides/access_control_permissions.rst b/operational_guides/access_control_permissions.rst index 2d8b9bf0e..e0a3efa24 100644 --- a/operational_guides/access_control_permissions.rst +++ b/operational_guides/access_control_permissions.rst @@ -11,27 +11,27 @@ The following table displays the access control permissions: +====================+=========================================================================================================================+ | **Object/Layer: All Databases** | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``LOGIN`` | use role to log into the system (the role also needs connect permission on the database it is connecting to) | +| ``LOGIN`` | Use role to log into the system (the role also needs connect permission on the database it is connecting to) | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``PASSWORD`` | the password used for logging into the system | +| ``PASSWORD`` | The password used for logging into the system | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``SUPERUSER`` | no permission restrictions on any activity | +| ``SUPERUSER`` | No permission restrictions on any activity | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ | **Object/Layer: Database** | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``SUPERUSER`` | no permission restrictions on any activity within that database (this does not include modifying roles or permissions) | +| ``SUPERUSER`` | No permission restrictions on any activity within that database (this does not include modifying roles or permissions) | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``CONNECT`` | connect to the database | +| ``CONNECT`` | Connect to the database | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``CREATE`` | create schemas in the database | +| ``CREATE`` | Create schemas in the database | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``CREATE FUNCTION``| create and drop functions | +| ``CREATE FUNCTION``| Create and drop functions | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ | **Object/Layer: Schema** | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``USAGE`` | allows additional permissions within the schema | +| ``USAGE`` | Grants access to schema objects | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``CREATE`` | create tables in the schema | +| ``CREATE`` | Create tables in the schema | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ | **Object/Layer: Table** | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ @@ -43,17 +43,17 @@ The following table displays the access control permissions: +--------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``DELETE`` | :ref:`delete` and :ref:`truncate` on the table | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``DDL`` | drop and alter on the table | +| ``DDL`` | Drop and alter on the table | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``ALL`` | all the table permissions | +| ``ALL`` | All the table permissions | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ | **Object/Layer: Function** | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``EXECUTE`` | use the function | +| ``EXECUTE`` | Use the function | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``DDL`` | drop and alter on the function | +| ``DDL`` | Drop and alter on the function | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``ALL`` | all function permissions | +| ``ALL`` | All function permissions | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ From a2b20ecbbe58a00f4ee4d70c3559c2d8084df15f Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 28 Feb 2023 17:10:27 +0200 Subject: [PATCH 449/882] alter_default_permissions --- .../client_drivers/odbc/index.rst | 4 +- .../scalar_functions/numeric/sqrt.rst | 2 +- .../scalar_functions/string/decode.rst | 19 +++---- .../alter_default_permissions.rst | 50 +++++++++++++++---- 4 files changed, 49 insertions(+), 26 deletions(-) diff --git a/connecting_to_sqream/client_drivers/odbc/index.rst b/connecting_to_sqream/client_drivers/odbc/index.rst index 691e7e999..4494ef4ec 100644 --- a/connecting_to_sqream/client_drivers/odbc/index.rst +++ b/connecting_to_sqream/client_drivers/odbc/index.rst @@ -1,7 +1,7 @@ .. _odbc: ************************* -Connecting to SQream Using ODBC +ODBC ************************* .. toctree:: @@ -38,8 +38,6 @@ SQream has an ODBC driver to connect to SQream DB. This tutorial shows how to in Other distributions may also work, but are not officially supported by SQream. -.. contents:: In this topic: - :local: Downloading the ODBC driver ================================== diff --git a/reference/sql/sql_functions/scalar_functions/numeric/sqrt.rst b/reference/sql/sql_functions/scalar_functions/numeric/sqrt.rst index cda10c4e9..41654db67 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/sqrt.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/sqrt.rst @@ -60,7 +60,7 @@ For these examples, consider the following table and contents: 1.4142135623730951 .. note:: - * ``SQRT`` always returns a floating point result. + * Some clients may show fewer digits. See your client settings to change the precision shown. Replacing negative values with ``NULL`` diff --git a/reference/sql/sql_functions/scalar_functions/string/decode.rst b/reference/sql/sql_functions/scalar_functions/string/decode.rst index a83b027b2..9530341b2 100644 --- a/reference/sql/sql_functions/scalar_functions/string/decode.rst +++ b/reference/sql/sql_functions/scalar_functions/string/decode.rst @@ -3,7 +3,7 @@ ******************** DECODE ******************** -The **DECODE** function is used for decoding or extracting binary data from a textual input string. +The **DECODE** function is used to translate a code value into a corresponding value that is meaningful to humans. This function is typically used in situations where a code needs to be presented to a user in a more understandable format, such as when displaying data in a report or on a user interface. Syntax ========== @@ -11,7 +11,7 @@ The following shows the correct syntax for the DECODE function: .. code-block:: postgres - DECODE(string input_text, format type_text) + DECODE(string input_text, format type_text); Parameters ============ @@ -28,16 +28,9 @@ The following table shows the DECODE parameters: * - ``type_text`` - Defines the format used for decoding the input text. -Returns -========= +Return +====== +Returns the same type as the argument supplied. - -Examples -=========== - - -Permissions -============= - -The role must have the ``SUPERUSER`` permissions. \ No newline at end of file + diff --git a/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst b/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst index d9849602a..4234267e2 100644 --- a/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst +++ b/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst @@ -3,7 +3,6 @@ ***************************** ALTER DEFAULT PERMISSIONS ***************************** -The **ALTER DEFAULT PERMISSIONS** page describes the following: .. contents:: :local: @@ -28,11 +27,11 @@ The following is the syntax for altering default permissions: .. code-block:: postgres alter_default_permissions_statement ::= - ALTER DEFAULT PERMISSIONS FOR target_role_name + ALTER DEFAULT PERMISSIONS FOR { target_role_name | ALL ROLES } [IN schema_name, ...] FOR { TABLES | SCHEMAS } - { grant_clause | DROP grant_clause} - TO ROLE { role_name | public }; + { grant_clause [, ...] | DROP grant_clause[, ...]} + TO { role_name [, ...] | public }; grant_clause ::= GRANT @@ -45,7 +44,7 @@ The following is the syntax for altering default permissions: | DELETE | DDL | ALL - } + } [, ...] target_role_name ::= identifier @@ -54,13 +53,46 @@ The following is the syntax for altering default permissions: schema_name ::= identifier -.. include:: grant.rst - :start-line: 127 - :end-line: 180 +Supported Permissions +======================= +The following table describes the supported permissions: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Permission + - Object + - Description + * - ``SUPERUSER`` + - Cluster, Database, Schema + - The most privileged role, with full control over a cluster, database, or schema + * - ``CREATE`` + - Database, Schema + - For a role to create and manage objects, it needs the ``CREATE`` and ``USAGE`` permissions at the respective level + * - ``USAGE`` + - Schema + - For a role to see tables in a schema, it needs the ``USAGE`` permissions + * - ``SELECT`` + - Table + - Allows a user to run :ref:`select` queries on table contents + * - ``INSERT`` + - Table + - Allows a user to run :ref:`copy_from` and :ref:`insert` statements to load data into a table + * - ``UPDATE`` + - Table + - Allows a user to modify the value of certain columns in existing rows without creating a table + * - ``DELETE`` + - Table + - Allows a user to run :ref:`delete`, :ref:`truncate` statements to delete data from a table + * - ``DDL`` + - Database, Schema, Table, Function + - Allows a user to :ref:`alter tables<alter_table>`, rename columns and tables, etc. + + Examples ============ -This section includes the following examples: .. contents:: :local: From 833e837c74b2257ad42b6e634e4ce089cf1be5d2 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Wed, 1 Mar 2023 09:20:46 +0200 Subject: [PATCH 450/882] 4.1 release finishes --- releases/4.0.0.rst | 127 --------------------------------------- releases/4.0.0_index.rst | 16 ----- releases/4.1.rst | 4 +- releases/index.rst | 2 + 4 files changed, 4 insertions(+), 145 deletions(-) delete mode 100644 releases/4.0.0.rst delete mode 100644 releases/4.0.0_index.rst diff --git a/releases/4.0.0.rst b/releases/4.0.0.rst deleted file mode 100644 index 95bfb7aab..000000000 --- a/releases/4.0.0.rst +++ /dev/null @@ -1,127 +0,0 @@ -.. _4.0.0: - -************************** -Release Notes 4.0.0 -************************** - -SQream is introducing a new version release system that follows the more commonly used Major.Minor.Patch versioning schema. The newly released **4.0.0 version** is a minor version upgrade and does not require considerable preparation. - -The 4.0.0 release notes were released on xx/xx/20xx and describe the following: - -.. contents:: - :local: - :depth: 1 - -New Features ------------- - - * Re-enabling an enhanced version of the :ref:`License Storage Capacity<monitoring_workers_and_services_from_the_dashboard>` feature - - :: - - * :ref:`Lightweight Directory Access Protocol(LDAP)<ldap>` may be used to authenticate SQream roles - - :: - - * :ref:`Physical deletion performance enhancement<delete>` by supporting file systems with parallelism capabilities - -SQream Studio Updates and Improvements --------------------------------------- - - * When creating a **New Role**, you may now create a group role by selecting **Set as a group role**. - - :: - -Known Issues ------------- -:ref:`Percentile<percentile_disc>` is not supported for Window functions. - -Version 4.0.0 resolved Issues ------------------------------ - -+------------------------+------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+========================+==========================================================================================+ -| SQ-10544 | SQream Studio Worker Panel issue | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-11199 | AWS S3 internal runtime error when executing ``COPY TO`` statement | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-11296 | Slow catalog queries | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-11772 | Slow ``JOIN`` query | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-11948 | ``SAVED QUERY`` execution using ``SELECT`` or ``INSERT INTO`` returns error | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12228 | ``CREATE AS SELECT`` statement fails when executed with ``UNION ALL`` and ``GROUP BY`` | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12310 | ``DICT`` compression buffer size issue | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12318 | JDBC ``insertBuffer`` parameter issue | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12364 | ``GET DDL`` foreign table output issue | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12468 | Internal compiler error | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12580 | Server Picker GPU dependency | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-12652 + 12844 | SQream Studio result panel adjustment | -+------------------------+------------------------------------------------------------------------------------------+ - - -Configuration Changes ---------------------- -No configuration changes were made. - -Naming Changes --------------- -No relevant naming changes were made. - -Deprecated Features -------------------- -SQream is declaring end of support of VARCHAR data type, the decision resulted by SQream's effort to enhance its core functionalities and with respect to ever changing echo system requirements. - -VARCHAR is no longer supported for new customers - effective from Version 2022.1.3 (September 2022). - -TEXT data type is replacing VARCHAR and NVARCHAR - SQream will maintain VARCHAR data type support until 09/30/2023. - - -End of Support ---------------- -No End of Support changes were made. - -Upgrading to v4.0.0 -------------------- -1. Generate a back-up of the metadata by running the following command: - - .. code-block:: console - - $ select backup_metadata('out_path'); - - .. tip:: SQream recommends storing the generated back-up locally in case needed. - - SQream runs the Garbage Collector and creates a clean backup tarball package. - -2. Shut down all SQream services. - - :: - -3. Extract the recently created back-up file. - - :: - -4. Replace your current metadata with the metadata you stored in the back-up file. - - :: - -5. Navigate to the new SQream package bin folder. - - :: - -6. Run the following command: - - .. code-block:: console - - $ ./upgrade_storage <levelDB path> - - .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. - diff --git a/releases/4.0.0_index.rst b/releases/4.0.0_index.rst deleted file mode 100644 index 5f072fd35..000000000 --- a/releases/4.0.0_index.rst +++ /dev/null @@ -1,16 +0,0 @@ -.. _4.0.0_index: - -************************** -Release Notes 4.0.0 -************************** -The 4.0.0 Release Notes describe the following releases: - -.. contents:: - :local: - :depth: 1 - -.. toctree:: - :maxdepth: 1 - :glob: - - 4.0.0 diff --git a/releases/4.1.rst b/releases/4.1.rst index 6c502e377..e050f762b 100644 --- a/releases/4.1.rst +++ b/releases/4.1.rst @@ -6,7 +6,7 @@ Release Notes 4.1 SQream is introducing a new version release system that follows the more commonly used Major.Minor.Patch versioning schema. The newly released **4.0 version** is a minor version upgrade and does not require considerable preparation. -The 4.1 release notes were released on xx/xx/20xx and describe the following: +The 4.1 release notes were released on 03/01/2023 and describe the following: .. contents:: :local: @@ -72,7 +72,7 @@ Deprecated Features The ``[]``, which are frequently used to delimit :ref:`identifiers<keywords_and_identifiers>` such as column names, table names, and other database objects, will soon be deprecated to facilitate the use of the ``ARRAY`` data type. -* Support in ``[]`` for delimiting database object identifiers ends at xx/xx/20xx. +* Support in ``[]`` for delimiting database object identifiers ends at 06/01/2023. * To delimit database object identifiers, you will be able to use double quotes ``""``. diff --git a/releases/index.rst b/releases/index.rst index 196502b60..5563bbb7f 100644 --- a/releases/index.rst +++ b/releases/index.rst @@ -12,6 +12,8 @@ Release Notes * - Version - Release Date + * - :ref:`4.1` + - March 01, 2023 * - :ref:`4.0` - January 25, 2023 * - :ref:`2022.1` From 6994cba336ffc8f8460047bb592b8f692609b1f9 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 2 Mar 2023 09:30:03 +0200 Subject: [PATCH 451/882] Update alter_default_permissions.rst --- .../access_control_commands/alter_default_permissions.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst b/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst index 4234267e2..95c5acfd0 100644 --- a/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst +++ b/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst @@ -65,10 +65,10 @@ The following table describes the supported permissions: - Object - Description * - ``SUPERUSER`` - - Cluster, Database, Schema + - Schema - The most privileged role, with full control over a cluster, database, or schema * - ``CREATE`` - - Database, Schema + - Schema - For a role to create and manage objects, it needs the ``CREATE`` and ``USAGE`` permissions at the respective level * - ``USAGE`` - Schema @@ -86,11 +86,12 @@ The following table describes the supported permissions: - Table - Allows a user to run :ref:`delete`, :ref:`truncate` statements to delete data from a table * - ``DDL`` - - Database, Schema, Table, Function + - Schema, Table - Allows a user to :ref:`alter tables<alter_table>`, rename columns and tables, etc. + Examples ============ From c804159f43d85a18f8c0c918e0ca1bf2e737a2eb Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 2 Mar 2023 10:08:00 +0200 Subject: [PATCH 452/882] Update 4.1.rst --- releases/4.1.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/4.1.rst b/releases/4.1.rst index e050f762b..6954063c4 100644 --- a/releases/4.1.rst +++ b/releases/4.1.rst @@ -35,7 +35,7 @@ No Studio updates Known Issues ------------ -No known issues +:ref:`Percentile<percentile_disc>` is not supported for Window functions. Version 4.1 resolved Issues From 8ff91182b207054517f98109749b0af744e917d4 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 2 Mar 2023 11:05:37 +0200 Subject: [PATCH 453/882] SQream support link --- connecting_to_sqream/client_drivers/index.rst | 2 +- connecting_to_sqream/client_drivers/odbc/index.rst | 6 +++--- connecting_to_sqream/client_platforms/index.rst | 2 +- connecting_to_sqream/client_platforms/sas_viya.rst | 2 +- connecting_to_sqream/client_platforms/tableau.rst | 2 +- connecting_to_sqream/index.rst | 2 +- .../installing_sqream_with_kubernetes.rst | 4 ++-- .../installing_studio_on_stand_alone_server.rst | 2 +- .../running_sqream_in_a_docker_container.rst | 6 +++--- troubleshooting/information_for_support.rst | 12 ++++-------- troubleshooting/remedying_slow_queries.rst | 4 ++-- 11 files changed, 20 insertions(+), 24 deletions(-) diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index 6f8f5909a..08ff79a4f 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -116,7 +116,7 @@ The following are applicable to Linux: .. rubric:: Need help? -If you couldn't find what you're looking for, we're always happy to help. Visit :ref:`information_for_support` for additional support. +If you couldn't find what you're looking for, contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_ .. rubric:: Looking for older drivers? diff --git a/connecting_to_sqream/client_drivers/odbc/index.rst b/connecting_to_sqream/client_drivers/odbc/index.rst index 4494ef4ec..195bc6897 100644 --- a/connecting_to_sqream/client_drivers/odbc/index.rst +++ b/connecting_to_sqream/client_drivers/odbc/index.rst @@ -39,10 +39,10 @@ SQream has an ODBC driver to connect to SQream DB. This tutorial shows how to in Other distributions may also work, but are not officially supported by SQream. -Downloading the ODBC driver -================================== +Getting the ODBC driver +======================= -The SQream DB ODBC driver is distributed by your SQream account manager. Before contacting your account manager, verify which platform the ODBC driver will be used on. Go to `SQream Support <http://support.sqream.com/>`_ or contact your SQream account manager to get the driver. +The SQream ODBC driver is distributed by your SQream account manager. Before contacting your account manager, verify which platform the ODBC driver will be used on. Go to `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_ or contact your SQream account manager to get the driver. The driver is provided as an executable installer for Windows, or a compressed tarball for Linux platforms. After downloading the driver, follow the relevant instructions to install and configure the driver for your platform: diff --git a/connecting_to_sqream/client_platforms/index.rst b/connecting_to_sqream/client_platforms/index.rst index 5a13fb6f4..6cd49667e 100644 --- a/connecting_to_sqream/client_platforms/index.rst +++ b/connecting_to_sqream/client_platforms/index.rst @@ -14,7 +14,7 @@ SQream DB is designed to work with most common database tools and interfaces, al The tools listed have been tested and approved for use with SQream DB. Most 3\ :sup:`rd` party tools that work through JDBC, ODBC, and Python should work. -If you are looking for a tool that is not listed, SQream and our partners can help. Go to `SQream Support <http://support.sqream.com/>`_ or contact your SQream account manager for more information. +If you are looking for a tool that is not listed, SQream and our partners can help. Go to `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_ or contact your SQream account manager for more information. .. toctree:: :maxdepth: 4 diff --git a/connecting_to_sqream/client_platforms/sas_viya.rst b/connecting_to_sqream/client_platforms/sas_viya.rst index ef4a338a4..d827fdc40 100644 --- a/connecting_to_sqream/client_platforms/sas_viya.rst +++ b/connecting_to_sqream/client_platforms/sas_viya.rst @@ -178,7 +178,7 @@ In some cases, SAS Viya cannot locate the SQream JDBC driver, generating the fol 3. Restart SAS Viya. -For more troubleshooting assistance, see the `SQream Support Portal <https://sqream.atlassian.net/servicedesk/customer/portals>`_. +For more troubleshooting assistance, see the `SQream Support Portal <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_. Supporting TEXT ~~~~~~~~~~~~~~~~~~ diff --git a/connecting_to_sqream/client_platforms/tableau.rst b/connecting_to_sqream/client_platforms/tableau.rst index 1d2ca17b6..279552c34 100644 --- a/connecting_to_sqream/client_platforms/tableau.rst +++ b/connecting_to_sqream/client_platforms/tableau.rst @@ -212,4 +212,4 @@ If Tableau cannot locate the SQream JDBC driver, do the following: .. image:: /_static/images/Third_Party_Connectors/tableau/envrionment_variable_for_classpath.png -If you experience issues after restarting Tableau, see the `SQream support portal <https://support.sqream.com>`_. \ No newline at end of file +If you experience issues after restarting Tableau, contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_ \ No newline at end of file diff --git a/connecting_to_sqream/index.rst b/connecting_to_sqream/index.rst index ecb9e4715..668af4d1e 100644 --- a/connecting_to_sqream/index.rst +++ b/connecting_to_sqream/index.rst @@ -15,4 +15,4 @@ This section provides information about the following third party tools: client_platforms/index client_drivers/index -If you need a tool that SQream does not support, contact SQream Support or your SQream account manager for more information. \ No newline at end of file +If you need a tool that SQream does not support, contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_ or your SQream account manager for more information. \ No newline at end of file diff --git a/installation_guides/installing_sqream_with_kubernetes.rst b/installation_guides/installing_sqream_with_kubernetes.rst index fbf2566ed..0abde10d3 100644 --- a/installation_guides/installing_sqream_with_kubernetes.rst +++ b/installation_guides/installing_sqream_with_kubernetes.rst @@ -1769,7 +1769,7 @@ Before Upgrading Your System ---------------------------- Before upgrading your system you must do the following: -1. Contact SQream support for a new SQream package tarball file. +1. Contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_ for a new SQream package tarball file. :: @@ -1813,4 +1813,4 @@ If you continue upgrading, all running SQream workers (master and editor) are st 4. When SQream has successfully upgraded, load the SQream console and restart your services. -For questions, contact SQream Support. +For questions, contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_. diff --git a/installation_guides/installing_studio_on_stand_alone_server.rst b/installation_guides/installing_studio_on_stand_alone_server.rst index ecec67c7f..362828313 100644 --- a/installation_guides/installing_studio_on_stand_alone_server.rst +++ b/installation_guides/installing_studio_on_stand_alone_server.rst @@ -121,7 +121,7 @@ After installing the Dashboard Data Collector, you can install Studio. **To install Studio:** -1. Copy the SQream Studio package from SQream Artifactory into the target server. For access to the Sqream Studio package, contact SQream Support. +1. Copy the SQream Studio package from SQream Artifactory into the target server. For access to the Sqream Studio package, contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_. :: diff --git a/installation_guides/running_sqream_in_a_docker_container.rst b/installation_guides/running_sqream_in_a_docker_container.rst index 2a2454164..97fc76476 100644 --- a/installation_guides/running_sqream_in_a_docker_container.rst +++ b/installation_guides/running_sqream_in_a_docker_container.rst @@ -807,7 +807,7 @@ After preparing your local environment you must deploy the SQream software. Depl **To deploy the SQream software:** -1. Contact the SQream Support team for access to the **sqream_installer-nnn-DBnnn-COnnn-EDnnn-<arch>.tar.gz** file. +1. Contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_ for access to the **sqream_installer-nnn-DBnnn-COnnn-EDnnn-<arch>.tar.gz** file. The **sqream_installer-nnn-DBnnn-COnnn-EDnnn-<arch>.tar.gz** file includes the following parameter values: @@ -1426,7 +1426,7 @@ This section describes how to upgrade your SQream system. **To upgrade your SQream system:** -1. Contact the SQream Support team for access to the new SQream package tarball file. +1. Contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_ team for access to the new SQream package tarball file. :: @@ -1466,4 +1466,4 @@ This section describes how to upgrade your SQream system. 7. When the upgrade is complete, load the SQream console and restart your services. - For assistance, contact SQream Support. + For assistance, contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_. diff --git a/troubleshooting/information_for_support.rst b/troubleshooting/information_for_support.rst index 16dcb4174..fd1cab1fa 100644 --- a/troubleshooting/information_for_support.rst +++ b/troubleshooting/information_for_support.rst @@ -4,18 +4,14 @@ Gathering Information for SQream Support ******************************************* -.. What do we want to look into a performance issue - -.. what about other kinds of issues - -.. what about bug reports - -`SQream Support <https://sqream.atlassian.net/servicedesk/>`_ is ready to answer any questions, and help solve any issues with SQream DB. +.. contents:: + :local: + :depth: 1 Getting Support and Reporting Bugs ======================================= -When contacting `SQream Support <https://sqream.atlassian.net/servicedesk/>`_, we recommend reporting the following information: +When contacting `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_, we recommend reporting the following information: * What is the problem encountered? * What was the expected outcome? diff --git a/troubleshooting/remedying_slow_queries.rst b/troubleshooting/remedying_slow_queries.rst index 9bd05b324..2c18f5278 100644 --- a/troubleshooting/remedying_slow_queries.rst +++ b/troubleshooting/remedying_slow_queries.rst @@ -58,7 +58,7 @@ The following table is a checklist you can use to identify the cause of your slo #. If there are more statements than available resources, some statements may be in an ``In queue`` mode. #. If there is a statement that has been running for too long and is blocking the queue, consider stopping it (use ``SELECT stop_statement(<statement id>)``). - If the statement does not stop correctly, contact SQream support. + If the statement does not stop correctly, contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_. If there are no long running statements or this does not help, continue to step 7. * - 7 @@ -76,4 +76,4 @@ The following table is a checklist you can use to identify the cause of your slo #. If the machine has less than 5% free memory, consider **lowering** the ``limitQueryMemoryGB`` and ``spoolMemoryGB`` settings. Refer to the :ref:`spooling` guide. #. If the machine has a lot of free memory, consider **increasing** the ``limitQueryMemoryGB`` and ``spoolMemoryGB`` settings. - If performance does not improve, contact SQream support for more help. \ No newline at end of file + If performance does not improve, contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_. \ No newline at end of file From 6092e58a1f24547f0376ea8e7252365cb10c2c71 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 2 Mar 2023 14:33:07 +0200 Subject: [PATCH 454/882] Update decode.rst --- .../scalar_functions/string/decode.rst | 38 ++++++++++++++++--- 1 file changed, 32 insertions(+), 6 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/string/decode.rst b/reference/sql/sql_functions/scalar_functions/string/decode.rst index 9530341b2..f2048e2b4 100644 --- a/reference/sql/sql_functions/scalar_functions/string/decode.rst +++ b/reference/sql/sql_functions/scalar_functions/string/decode.rst @@ -3,7 +3,7 @@ ******************** DECODE ******************** -The **DECODE** function is used to translate a code value into a corresponding value that is meaningful to humans. This function is typically used in situations where a code needs to be presented to a user in a more understandable format, such as when displaying data in a report or on a user interface. +The ``DECODE`` function takes an expression or column and compares it to a series of search values. It returns a result value that corresponds to the first matching search value, or the default value ``NULL`` if no matches are found. Syntax ========== @@ -11,7 +11,7 @@ The following shows the correct syntax for the DECODE function: .. code-block:: postgres - DECODE(string input_text, format type_text); + DECODE( <expr> , <search1> , <result1> [ , <search2> , <result2> ... ] [ , <default> ] ) Parameters ============ @@ -23,14 +23,40 @@ The following table shows the DECODE parameters: * - Parameter - Description - * - ``input_text`` - - Defines the input text string. - * - ``type_text`` - - Defines the format used for decoding the input text. + * - ``expr`` + - The expression to be evaluated. + * - ``search`` + - A value that ``expr`` is compared against. + * - ``result1`` + - A value that is returnd if ``expr`` matches ``search``. Return ====== Returns the same type as the argument supplied. +Example +======= + +.. code-block:: postgres + + CREATE TABLE test1 (european_size int not null); + INSERT INTO test1 values (8),(9),(10),(11); + + SELECT european_size,DECODE(european_size,8,40,9,41,10,42,99) from test1; + + Output: + +---------------+---------+ + |european_size |decode | + +-------------------------+ + |8 |40 | + +---------------+---------+ + |9 |41 | + +-------------------------+ + |10 |42 | + +-------------------------+ + |11 |99 | + +-------------------------+ + + From efb4f64912c45cb916d26ab0356b7d2a91d4bd0d Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 5 Mar 2023 09:15:42 +0200 Subject: [PATCH 455/882] Update index.rst --- connecting_to_sqream/client_drivers/jdbc/index.rst | 13 +++---------- 1 file changed, 3 insertions(+), 10 deletions(-) diff --git a/connecting_to_sqream/client_drivers/jdbc/index.rst b/connecting_to_sqream/client_drivers/jdbc/index.rst index 438df0ad7..1929da509 100644 --- a/connecting_to_sqream/client_drivers/jdbc/index.rst +++ b/connecting_to_sqream/client_drivers/jdbc/index.rst @@ -1,7 +1,7 @@ .. _java_jdbc: ************************* -Connecting to SQream Using JDBC +JDBC ************************* The SQream JDBC driver lets you connect to SQream using many Java applications and tools. This page describes how to write a Java application using the JDBC interface. The JDBC driver requires Java 1.8 or newer. @@ -35,15 +35,8 @@ The SQream JDBC driver requires Java 1.8 or newer, and SQream recommends using O Getting the JAR file --------------------- -SQream provides the JDBC driver as a zipped JAR file, available for download from the :ref:`client drivers download page<client_drivers>`. This JAR file can be integrated into your Java-based applications or projects. +The SQream JDBC driver is available for download from the :ref:`client drivers download page<client_drivers>`. This JAR file can be integrated into your Java-based applications or projects. -Extracting the ZIP Archive -------------------------- -Run the following command to extract the JAR file from the ZIP archive: - -.. code-block:: console - - $ unzip sqream-jdbc-4.3.0.zip Setting Up the Class Path ---------------------------- @@ -82,7 +75,7 @@ The following is the syntax for SQream: .. code-block:: text - jdbc:Sqream://<host and port>/<database name>;user=<username>;password=<password>;[<optional parameters>; ...] + jdbc:Sqream://<host and port>/<database name>;user=<username>;password=<password>sqream;[<optional parameters>; ...] Connection Parameters ^^^^^^^^^^^^^^^^^^^^^^^^ From 9bf3a714f923140b65294ac3a30794d01aa90ae3 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 5 Mar 2023 15:03:26 +0200 Subject: [PATCH 456/882] Update 4.1.rst --- releases/4.1.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/releases/4.1.rst b/releases/4.1.rst index 6954063c4..f26308ac2 100644 --- a/releases/4.1.rst +++ b/releases/4.1.rst @@ -52,7 +52,8 @@ Version 4.1 resolved Issues +------------------------+------------------------------------------------------------------------------------------+ | SQ-12510 | Encryption memory issues | +------------------------+------------------------------------------------------------------------------------------+ - +| SQ-13219 | JDBC ``supportsSchemasInDataManipulation()`` method issue | ++------------------------+------------------------------------------------------------------------------------------+ Configuration Changes --------------------- From 68c7881b1ccdfb47fa5e12a011a03604837f1f09 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 7 Mar 2023 15:29:00 +0200 Subject: [PATCH 457/882] Update 4.1.rst --- releases/4.1.rst | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/releases/4.1.rst b/releases/4.1.rst index f26308ac2..9f83d7901 100644 --- a/releases/4.1.rst +++ b/releases/4.1.rst @@ -25,6 +25,11 @@ New Features * A new brute-force attack protection mechanism locks out user accounts for 15 minutes following 5 consecutive failed login attempts +Storage Version +--------------- + +The storage version presently in effect is version 45. + SQream Studio Updates and Improvements -------------------------------------- @@ -111,7 +116,7 @@ Upgrading to v4.1 :: -3. Extract the recently created back-up file. +3. Copy the recently created back-up file. :: From 051724daa6dce09a1ca8887e4b0147add4c7ab75 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 7 Mar 2023 15:51:48 +0200 Subject: [PATCH 458/882] Storage --- releases/2022.1.1.rst | 42 ++++++++++++++++++++++----------------- releases/2022.1.2.rst | 15 +++++++++++--- releases/2022.1.3.rst | 12 +++++++++++ releases/2022.1.4.rst | 5 +++++ releases/2022.1.5.rst | 5 ++++- releases/2022.1.6.rst | 46 ++++++++++++++++++++++++++----------------- releases/2022.1.7.rst | 4 ++++ releases/2022.1.rst | 11 +++++++++++ releases/4.0.rst | 6 ++++++ 9 files changed, 106 insertions(+), 40 deletions(-) diff --git a/releases/2022.1.1.rst b/releases/2022.1.1.rst index 436287c6c..3ba0cb8b6 100644 --- a/releases/2022.1.1.rst +++ b/releases/2022.1.1.rst @@ -13,7 +13,13 @@ Version Content ---------- The 2022.1.1 Release Notes describes the following: -* Enhanced security features. +* Enhanced security features +* For more information, see `SQream Acceleration Studio 5.4.7 <https://docs.sqream.com/en/v2022.1.1/sqream_studio_5.4.7/index.html>`_. + +Storage Version +--------------- + +The storage version presently in effect is version 40. New Features ---------- @@ -27,29 +33,25 @@ Password Security Compliance ************ In compliance with GDPR standards, SQream now requires a strong password policy when accessing the CLI or Studio. -For more information, see :ref:`access_control_password_policy`. +For more information, see `Password Policy <https://docs.sqream.com/en/v2022.1.1/operational_guides/access_control_password_policy.html>`_. Known Issues --------- -The following table lists the known issues for Version 2022.1.1: +There were no known issues in Version 2022.1.1. + +Resolved Issues +--------- +The following table lists the issues that were resolved in Version 2022.1.1: +-------------+------------------------------------------------------------------------------------------------+ | **SQ No.** | **Description** | +=============+================================================================================================+ | SQ-6419 | An internal compiler error occurred when casting Numeric literals in an aggregation function. | +-------------+------------------------------------------------------------------------------------------------+ - -Resolved Issues ---------- -The following table lists the issues that were resolved in Version 2022.1.1: - -+-------------+----------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+=============+========================================================================================+ -| SQ-10873 | Inserting 100K bytes into a text column resulted in an unclear error message. | -+-------------+----------------------------------------------------------------------------------------+ -| SQ-10892 | An unclear message was displayed when users ran ``UPDATE`` on foreign tables. | -+-------------+----------------------------------------------------------------------------------------+ +| SQ-10873 | Inserting 100K bytes into a text column resulted in an unclear error message. | ++-------------+------------------------------------------------------------------------------------------------+ +| SQ-10955 | Unneeded reads were occurring when filtering by date. | ++-------------+------------------------------------------------------------------------------------------------+ Operations and Configuration Changes -------- @@ -63,9 +65,7 @@ No relevant naming changes were made. Deprecated Features ------- -In SQream version 2022.1 the ``VARCHAR`` data type has been deprecated and replaced with ``TEXT``. SQream will maintain ``VARCHAR`` in all previous versions until completing the migration to ``TEXT``, at which point it will be deprecated in all earlier versions. SQream also provides an automated and secure tool to facilitate and simplify migration from ``VARCHAR`` to ``TEXT``. - -If you are using an earlier version of SQream, see the `Using Legacy String Literals <https://docs.sqream.com/en/v2022.1/configuration_guides/use_legacy_string_literals.html>`_ configuration flag. +In `SQream Acceleration Studio 5.4.7 <https://docs.sqream.com/en/v2022.1.1/sqream_studio_5.4.7/index.html>`_, the **Configuration** section has been temporarily disabled and will be enabled at a later date. In addition, the **Log Lines** tab in the **Log** section has been removed. End of Support ------- @@ -107,3 +107,9 @@ Upgrading to v2022.1.1 .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <https://docs.sqream.com/en/v2022.1.1/installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2022.1.1 \ No newline at end of file diff --git a/releases/2022.1.2.rst b/releases/2022.1.2.rst index 5c007f0ec..cbefa3f00 100644 --- a/releases/2022.1.2.rst +++ b/releases/2022.1.2.rst @@ -19,6 +19,11 @@ The 2022.1.2 Release Notes describes the following: * Optimized queries on external Parquet tables. +Storage Version +--------------- + +The storage version presently in effect is version 41. + New Features ---------- The 2022.1.2 Release Notes include the following new features: @@ -53,9 +58,7 @@ No relevant naming changes were made. Deprecated Features ------- -In SQream version 2022.1 the ``VARCHAR`` data type has been deprecated and replaced with ``TEXT``. SQream will maintain ``VARCHAR`` in all previous versions until completing the migration to ``TEXT``, at which point it will be deprecated in all earlier versions. SQream also provides an automated and secure tool to facilitate and simplify migration from ``VARCHAR`` to ``TEXT``. - -If you are using an earlier version of SQream, see the `Using Legacy String Literals <https://docs.sqream.com/en/v2022.1/configuration_guides/use_legacy_string_literals.html>`_ configuration flag. +No features were deprecated for Version 2022.1.2. End of Support ------- @@ -97,3 +100,9 @@ Upgrading to v2022.1.2 .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <https://docs.sqream.com/en/v2022.1.2/installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2022.1.2 \ No newline at end of file diff --git a/releases/2022.1.3.rst b/releases/2022.1.3.rst index b88eb78d9..e31c6728f 100644 --- a/releases/2022.1.3.rst +++ b/releases/2022.1.3.rst @@ -27,6 +27,12 @@ The 2022.1.3 Release Notes describes the following: * Support sub-queries in the UPDATE condition. +Storage Version +--------------- + +The storage version presently in effect is version 42. + + Known Issues --------- The following table lists the issues that are known limitations in Version 2022.1.3: @@ -120,3 +126,9 @@ Upgrading to v2022.1.3 .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2022.1.3 \ No newline at end of file diff --git a/releases/2022.1.4.rst b/releases/2022.1.4.rst index 338fdf164..30a81b231 100644 --- a/releases/2022.1.4.rst +++ b/releases/2022.1.4.rst @@ -18,6 +18,11 @@ The 2022.1.4 Release Notes describes the following: :: +Storage Version +--------------- + +The storage version presently in effect is version 42. + Known Issues --------- No relevant Known Issues. diff --git a/releases/2022.1.5.rst b/releases/2022.1.5.rst index d63bf3b7a..2c3149039 100644 --- a/releases/2022.1.5.rst +++ b/releases/2022.1.5.rst @@ -23,7 +23,10 @@ The 2022.1.5 Release Notes include the following new features: * release_defunct_locks utility function enhancement to receive new optional input parameter to specify timeout - for more details see `Lock Related Issues <../troubleshooting/lock_related_issues.html>`_. - +Storage Version +--------------- + +The storage version presently in effect is version 42. Known Issues diff --git a/releases/2022.1.6.rst b/releases/2022.1.6.rst index 67eb46222..efd0a4ab2 100644 --- a/releases/2022.1.6.rst +++ b/releases/2022.1.6.rst @@ -3,7 +3,7 @@ ************************** Release Notes 2022.1.6 ************************** -The 2022.1.6 release notes were released on 11/29/2022 and describe the following: +The 2022.1.6 release notes were released on 12/11/2022 and describe the following: .. contents:: :local: @@ -16,6 +16,11 @@ New Features :: +Storage Version +--------------- + +The storage version presently in effect is version 42. + Known Issues --------- :ref:`Percentile<percentile_disc>` is not supported for Window functions. @@ -23,26 +28,31 @@ Known Issues Version 2022.1.6 resolved Issues --------- -+--------------------------------+--------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+================================+============================================================================================+ -| SQ-10160 | Spotfire casting issues when reading SQream data | -+--------------------------------+--------------------------------------------------------------------------------------------+ -| SQ-12089 | ``COUNT (*)`` execution fails when using foreign table | -+--------------------------------+--------------------------------------------------------------------------------------------+ -| SQ-12019 | Using ``PERCENTILE_DISC`` function with ``PARTITION BY`` function causes internal error | -+--------------------------------+--------------------------------------------------------------------------------------------+ -| SQ-12117 | Running TCPH-21 results in out of memory | -+--------------------------------+--------------------------------------------------------------------------------------------+ -| SQ-11940, SQ-11926, SQ-11874 | Known encryption issues | -+--------------------------------+--------------------------------------------------------------------------------------------+ -| SQ-11295 | ``max_file_size`` when executing ``COPY_TO`` is imprecise | -+--------------------------------+--------------------------------------------------------------------------------------------+ -| SQ-12204 | Possible issue when trying to INSERT Unicode data using .Net client | -+--------------------------------+--------------------------------------------------------------------------------------------+ ++--------------------------------+------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++================================+==========================================================================================+ +| SQ-10160 | Spotfire casting issues when reading SQream data | ++--------------------------------+------------------------------------------------------------------------------------------+ +| SQ-11295 | ``max_file_size`` when executing ``COPY_TO`` is imprecise | ++--------------------------------+------------------------------------------------------------------------------------------+ +| SQ-11940, SQ-11926, SQ-11874 | Known encryption issues | ++--------------------------------+------------------------------------------------------------------------------------------+ +| SQ-11975 | Internal runtime error | ++--------------------------------+------------------------------------------------------------------------------------------+ +| SQ-12019 | Using ``PERCENTILE_DISC`` function with ``PARTITION BY`` function causes internal error | ++--------------------------------+------------------------------------------------------------------------------------------+ +| SQ-12089 | ``COUNT (*)`` execution fails when using foreign table | ++--------------------------------+------------------------------------------------------------------------------------------+ +| SQ-12117 | Running TCPH-21 results in out of memory | ++--------------------------------+------------------------------------------------------------------------------------------+ +| SQ-12204 | Possible issue when trying to INSERT Unicode data using .Net client | ++--------------------------------+------------------------------------------------------------------------------------------+ + + + Configuration Changes -------- No configuration changes were made. diff --git a/releases/2022.1.7.rst b/releases/2022.1.7.rst index b3fda33ff..c5f738eba 100644 --- a/releases/2022.1.7.rst +++ b/releases/2022.1.7.rst @@ -20,6 +20,10 @@ New Features :: +Storage Version +--------------- + +The storage version presently in effect is version 43. Known Issues --------- diff --git a/releases/2022.1.rst b/releases/2022.1.rst index 6614d6458..be50ab11b 100644 --- a/releases/2022.1.rst +++ b/releases/2022.1.rst @@ -17,6 +17,11 @@ The 2022.1 Release Notes describes the following: * New data manipulation command. * Additional data ingestion format. +Storage Version +--------------- + +The storage version presently in effect is version 40. + New Features ---------- The 2022.1 Release Notes include the following new features: @@ -129,3 +134,9 @@ Upgrading to v2022.1 .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <https://docs.sqream.com/en/v2022.1/installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. +.. toctree:: + :maxdepth: 2 + :glob: + :hidden: + + 2022.1 diff --git a/releases/4.0.rst b/releases/4.0.rst index 65e8c25f5..ed6dc628c 100644 --- a/releases/4.0.rst +++ b/releases/4.0.rst @@ -25,6 +25,12 @@ New Features * :ref:`Physical deletion performance enhancement<delete>` by supporting file systems with parallelism capabilities +Storage Version +--------------- + +The storage version presently in effect is version 45. + + SQream Studio Updates and Improvements -------------------------------------- From acf624d4be38ce087837730971c723a424193334 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 7 Mar 2023 15:53:39 +0200 Subject: [PATCH 459/882] Update 4.1.rst --- releases/4.1.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/4.1.rst b/releases/4.1.rst index 9f83d7901..10b249f40 100644 --- a/releases/4.1.rst +++ b/releases/4.1.rst @@ -33,7 +33,7 @@ The storage version presently in effect is version 45. SQream Studio Updates and Improvements -------------------------------------- -No Studio updates +SQream Studio v5.5.4 has been released. :: From 96bcb30bec812a93bca7faf3c4e98d2d6fa549a7 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 7 Mar 2023 16:19:48 +0200 Subject: [PATCH 460/882] REAL to DOUBLE --- reference/sql/sql_functions/index.rst | 6 ++---- .../scalar_functions/numeric/atan.rst | 2 +- .../scalar_functions/numeric/atn2.rst | 2 +- .../scalar_functions/numeric/ceiling.rst | 2 +- .../scalar_functions/numeric/cos.rst | 4 ++-- .../scalar_functions/numeric/degrees.rst | 2 +- .../scalar_functions/numeric/exp.rst | 4 ++-- .../scalar_functions/numeric/floor.rst | 2 ++ .../scalar_functions/numeric/log.rst | 2 +- .../scalar_functions/numeric/log10.rst | 2 +- .../scalar_functions/numeric/radians.rst | 2 +- .../scalar_functions/numeric/round.rst | 21 +++++++------------ .../scalar_functions/numeric/square.rst | 2 +- .../scalar_functions/numeric/tan.rst | 2 +- .../scalar_functions/numeric/trunc.rst | 2 ++ 15 files changed, 27 insertions(+), 30 deletions(-) diff --git a/reference/sql/sql_functions/index.rst b/reference/sql/sql_functions/index.rst index b06a754f7..add12c95d 100644 --- a/reference/sql/sql_functions/index.rst +++ b/reference/sql/sql_functions/index.rst @@ -174,8 +174,6 @@ The following table shows the **arithmetic operator** functions: - Calculates the cosine of an argument * - :ref:`cot` - Calculates the cotangent of an argument - * - :ref:`crc64` - - Calculates a CRC-64 hash of an argument * - :ref:`degrees` - Converts a value from radian values to degrees * - :ref:`exp` @@ -206,8 +204,6 @@ The following table shows the **arithmetic operator** functions: - Calculates the tangent of an argument * - :ref:`trunc` - Rounds a number to its integer representation towards 0 - * - :ref:`sign` - - Returns an integer value of -1, 0, or 1, depending on the sign of the input expression. Strings ^^^^^^^^^^^ @@ -225,6 +221,8 @@ The following table shows the **string** functions: - Calculates the position where a string starts inside another string * - :ref:`concat` - Concatenates two strings + * - :ref:`crc64` + - Calculates a CRC-64 hash of an argument * - :ref:`decode` - Decodes or extracts binary data from a textual input string * - :ref:`isprefixof` diff --git a/reference/sql/sql_functions/scalar_functions/numeric/atan.rst b/reference/sql/sql_functions/scalar_functions/numeric/atan.rst index d730e8dfc..6a500383a 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/atan.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/atan.rst @@ -29,7 +29,7 @@ Arguments Returns ============ -Always returns a floating point result of the inverse tangent, in radians. +When using the ``ATAN`` floating point number scalar function, ``real`` arguments are automatically cast to ``double`` precision. Notes ======= diff --git a/reference/sql/sql_functions/scalar_functions/numeric/atn2.rst b/reference/sql/sql_functions/scalar_functions/numeric/atn2.rst index f727a9abe..e7a356338 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/atn2.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/atn2.rst @@ -35,7 +35,7 @@ Arguments Returns ============ -Always returns a floating point result of the inverse tangent, in radians. +When using the ``ATN2`` floating point number scalar function, ``real`` arguments are automatically cast to ``double`` precision. Notes ======= diff --git a/reference/sql/sql_functions/scalar_functions/numeric/ceiling.rst b/reference/sql/sql_functions/scalar_functions/numeric/ceiling.rst index 314c33c02..9d91611a6 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/ceiling.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/ceiling.rst @@ -32,7 +32,7 @@ Arguments Returns ============ -``CEILING`` and ``CEIL`` always return a ``double`` floating point number. +When using the ``CEILING`` and ``CEIL`` floating point number scalar functions, ``real`` arguments are automatically cast to ``double`` precision. Notes diff --git a/reference/sql/sql_functions/scalar_functions/numeric/cos.rst b/reference/sql/sql_functions/scalar_functions/numeric/cos.rst index 5861b7bc8..dbd322488 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/cos.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/cos.rst @@ -4,7 +4,7 @@ COS ************************** -Returns the cosine value of a numeric expression +Returns the cosine value of a numeric expression. Syntax ========== @@ -29,7 +29,7 @@ Arguments Returns ============ -Always returns a floating point result of the cosine. +When using the ``COS`` floating point number scalar function, ``real`` arguments are automatically cast to ``double`` precision. Notes ======= diff --git a/reference/sql/sql_functions/scalar_functions/numeric/degrees.rst b/reference/sql/sql_functions/scalar_functions/numeric/degrees.rst index d1d806792..7ef7b3c2c 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/degrees.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/degrees.rst @@ -30,7 +30,7 @@ Arguments Returns ============ -Always returns a floating point result of the value in degrees. +When using the ``DEGREES`` floating point number scalar function, ``real`` arguments are automatically cast to ``double`` precision. Notes ======= diff --git a/reference/sql/sql_functions/scalar_functions/numeric/exp.rst b/reference/sql/sql_functions/scalar_functions/numeric/exp.rst index 16116614e..abebebbe0 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/exp.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/exp.rst @@ -4,7 +4,7 @@ EXP ************************** -Returns the natural exponent value of a numeric expression (*e*\ :sup:`x`) +Returns the natural exponent value of a numeric expression (*e*\ :sup:`x`). See also :ref:`log`. @@ -30,7 +30,7 @@ Arguments Returns ============ -Always returns a floating point result. +When using the ``EXP`` floating point number scalar function, ``real`` arguments are automatically cast to ``double`` precision. Notes ======= diff --git a/reference/sql/sql_functions/scalar_functions/numeric/floor.rst b/reference/sql/sql_functions/scalar_functions/numeric/floor.rst index 56dcac0a2..e528dcc5d 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/floor.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/floor.rst @@ -32,6 +32,8 @@ Returns Returns the same type as the argument supplied. +When using the ``FLOOR`` floating point number scalar function, ``real`` arguments are automatically cast to ``double`` precision. + Notes ======= diff --git a/reference/sql/sql_functions/scalar_functions/numeric/log.rst b/reference/sql/sql_functions/scalar_functions/numeric/log.rst index 3a1b9156d..4baa0f7a7 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/log.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/log.rst @@ -32,7 +32,7 @@ Arguments Returns ============ -Always returns a floating point result. +When using the ``LOG`` floating point number scalar function, ``real`` arguments are automatically cast to ``double`` precision. Notes ======= diff --git a/reference/sql/sql_functions/scalar_functions/numeric/log10.rst b/reference/sql/sql_functions/scalar_functions/numeric/log10.rst index 99b8311e3..844373aca 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/log10.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/log10.rst @@ -30,7 +30,7 @@ Arguments Returns ============ -Always returns a floating point result. +When using the ``LOG10`` floating point number scalar function, ``real`` arguments are automatically cast to ``double`` precision. Notes ======= diff --git a/reference/sql/sql_functions/scalar_functions/numeric/radians.rst b/reference/sql/sql_functions/scalar_functions/numeric/radians.rst index 4d6859de8..e79b6b20b 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/radians.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/radians.rst @@ -30,7 +30,7 @@ Arguments Returns ============ -Always returns a floating point result of the value in radians. +When using the ``RADIANS`` floating point number scalar function, ``real`` arguments are automatically cast to ``double`` precision. Notes ======= diff --git a/reference/sql/sql_functions/scalar_functions/numeric/round.rst b/reference/sql/sql_functions/scalar_functions/numeric/round.rst index 420bd3c0f..462ec606f 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/round.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/round.rst @@ -13,10 +13,8 @@ Syntax .. code-block:: postgres - ROUND( numeric ) -> numeric - ROUND( numeric [, int ] ) -> numeric - ROUND( double ) -> double - + ROUND( expr [, scale ] ) + Arguments ============ @@ -26,23 +24,20 @@ Arguments * - Parameter - Description - * - ``numeric`` - - Stores numeric values such as integers, decimal numbers, and currency values - * - ``int`` - - Stores integer values + * - ``expr`` + - Numeric expression to round + * - ``scale`` + - Number of digits after the decimal point to round to. Defaults to 0 if not specified. Returns ============ -The ``ROUND()`` function returns a ``numeric`` value when used with numeric input types, such as ``integer`` or ``decimal``. When the input is ``double``, the return type is also ``double``. - - -.. note:: ``integer`` data types are automatically cast to ``numeric`` data types. +When using the ``ROUND`` floating point number scalar function, ``real`` arguments are automatically cast to ``double`` precision. Notes ======= -If the input value is NULL, the result is NULL. +* If the input value is NULL, the result is NULL. Examples =========== diff --git a/reference/sql/sql_functions/scalar_functions/numeric/square.rst b/reference/sql/sql_functions/scalar_functions/numeric/square.rst index edf7b11ab..d8b7cd585 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/square.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/square.rst @@ -30,7 +30,7 @@ Arguments Returns ============ -Always returns a floating point result +When using the ``SQUARE`` floating point number scalar function, ``real`` arguments are automatically cast to ``double`` precision. Notes ======= diff --git a/reference/sql/sql_functions/scalar_functions/numeric/tan.rst b/reference/sql/sql_functions/scalar_functions/numeric/tan.rst index 7a6915d3b..88e332d5a 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/tan.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/tan.rst @@ -29,7 +29,7 @@ Arguments Returns ============ -Always returns a floating point result of the tangent. +When using the ``TAN`` floating point number scalar function, ``real`` arguments are automatically cast to ``double`` precision. Notes ======= diff --git a/reference/sql/sql_functions/scalar_functions/numeric/trunc.rst b/reference/sql/sql_functions/scalar_functions/numeric/trunc.rst index 322b1274b..643bfd6d9 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/trunc.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/trunc.rst @@ -34,6 +34,8 @@ Returns Returns the same type as the argument supplied. +When using the ``TRUNC`` floating point number scalar function, ``real`` arguments are automatically cast to ``double`` precision. + Notes ======= From b5c2af503c414f3c53b44821725abdb4aa813202 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 9 Mar 2023 08:48:15 +0200 Subject: [PATCH 461/882] Update sql_feature_support.rst --- reference/sql_feature_support.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql_feature_support.rst b/reference/sql_feature_support.rst index d940215b0..0997b72bb 100644 --- a/reference/sql_feature_support.rst +++ b/reference/sql_feature_support.rst @@ -182,7 +182,7 @@ Statements - Yes - :ref:`truncate` * - UPDATE - - No + - Yes - * - VALUES - Yes From dd9fc1dbb6b87936bb38b3c58d74d60f7850016a Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 12 Mar 2023 09:00:42 +0200 Subject: [PATCH 462/882] Update 4.1.rst --- releases/4.1.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/4.1.rst b/releases/4.1.rst index 10b249f40..0dcfccef7 100644 --- a/releases/4.1.rst +++ b/releases/4.1.rst @@ -78,7 +78,7 @@ Deprecated Features The ``[]``, which are frequently used to delimit :ref:`identifiers<keywords_and_identifiers>` such as column names, table names, and other database objects, will soon be deprecated to facilitate the use of the ``ARRAY`` data type. -* Support in ``[]`` for delimiting database object identifiers ends at 06/01/2023. +* Support in ``[]`` for delimiting database object identifiers ends on June 1st, 2023. * To delimit database object identifiers, you will be able to use double quotes ``""``. From a1ddeb8ac39096a4bd02f1282c73813e46b70ed8 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 12 Mar 2023 11:16:46 +0200 Subject: [PATCH 463/882] RN --- conf.py | 2 +- releases/4.0_index.rst | 3 +- releases/4.2.rst | 140 +++++++++++++++++++++++++++++++++++++++++ releases/index.rst | 15 +---- 4 files changed, 146 insertions(+), 14 deletions(-) create mode 100644 releases/4.2.rst diff --git a/conf.py b/conf.py index 2fee1f392..bee87ebd0 100644 --- a/conf.py +++ b/conf.py @@ -26,7 +26,7 @@ # The full version, including alpha/beta/rc tags -release = '4.1' +release = '4.2' diff --git a/releases/4.0_index.rst b/releases/4.0_index.rst index 680957f22..d61a919f3 100644 --- a/releases/4.0_index.rst +++ b/releases/4.0_index.rst @@ -14,4 +14,5 @@ The 4.0 Release Notes describe the following releases: :glob: 4.0 - 4.1 \ No newline at end of file + 4.1 + 4.2 \ No newline at end of file diff --git a/releases/4.2.rst b/releases/4.2.rst new file mode 100644 index 000000000..b5684eb20 --- /dev/null +++ b/releases/4.2.rst @@ -0,0 +1,140 @@ +.. _4.2: + +************************** +Release Notes 4.2 +************************** + +SQream is introducing a new version release system that follows the more commonly used Major.Minor.Patch versioning schema. The newly released **4.0 version** is a minor version upgrade and does not require considerable preparation. + +The 4.2 release notes were released on xx/xx/2023 and describe the following: + +.. contents:: + :local: + :depth: 1 + +New Features +------------ + + +:ref:`Apache Spark<spark>` may now be used for large-scale data processing. + + :: + +:ref:`Physical deletion<delete_guide>` performance enhancement by supporting file systems with parallelism capabilities + + +Connectors +---------- + +Pysqream - Supports Python 9 + +ODBC + +JDBC + +Storage Version +--------------- + +The storage version presently in effect is version xx. + +SQream Studio Updates and Improvements +-------------------------------------- + +SQream Studio v5.5.4 has been released. + + :: + +Known Issues +------------ + +:ref:`Percentile<percentile_disc>` is not supported for Window functions. + + +Version 4.2 resolved Issues +----------------------------- + ++------------------------+------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++========================+==========================================================================================+ +| SQ-12598 | External table ``SELECT`` statement issue | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-13055 | Pysqream ``NULL`` value issue | ++------------------------+------------------------------------------------------------------------------------------+ + + +Configuration Changes +--------------------- + +No configuration changes + + +Naming Changes +-------------- +No naming changes + + +Deprecated Features +------------------- + +► Square Brackets ``[]`` + +The ``[]``, which are frequently used to delimit :ref:`identifiers<keywords_and_identifiers>` such as column names, table names, and other database objects, will soon be deprecated to facilitate the use of the ``ARRAY`` data type. + +* Support in ``[]`` for delimiting database object identifiers ends on June 1st, 2023. + +* To delimit database object identifiers, you will be able to use double quotes ``""``. + + +► ``VARCHAR`` + +The ``VARCHAR`` data type is deprecated to improve the core functionalities of the platform and to align with the constantly evolving ecosystem requirements. + +* Support in the ``VARCHAR`` data type ends at September 30th, 2023. + +* ``VARCHAR`` is no longer supported for new customers, effective from Version 2022.1.3. + +* The ``TEXT`` data type is replacing the ``VARCHAR`` and ``NVARCHAR`` data types. + + + + +End of Support +--------------- +No End of Support changes were made. + +Upgrading to v4.2 +------------------- +1. Generate a back-up of the metadata by running the following command: + + .. code-block:: console + + $ select backup_metadata('out_path'); + + .. tip:: SQream recommends storing the generated back-up locally in case needed. + + SQream runs the Garbage Collector and creates a clean backup tarball package. + +2. Shut down all SQream services. + + :: + +3. Copy the recently created back-up file. + + :: + +4. Replace your current metadata with the metadata you stored in the back-up file. + + :: + +5. Navigate to the new SQream package bin folder. + + :: + +6. Run the following command: + + .. code-block:: console + + $ ./upgrade_storage <levelDB path> + + .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. + diff --git a/releases/index.rst b/releases/index.rst index 5563bbb7f..c12430d8a 100644 --- a/releases/index.rst +++ b/releases/index.rst @@ -12,22 +12,13 @@ Release Notes * - Version - Release Date + * - :ref:`4.2` + - March xx, 2023 * - :ref:`4.1` - March 01, 2023 * - :ref:`4.0` - January 25, 2023 - * - :ref:`2022.1` - - July 19, 2022 - * - :ref:`2021.2` - - September 13, 2021 - * - :ref:`2021.1` - - June 13, 2021 - * - :ref:`2020.3` - - October 8, 2020 - * - :ref:`2020.2` - - July 22, 2020 - * - :ref:`2020.1` - - January 15, 2020 + From ade1238fcf179f1e8b7e91d194217b9332b044da Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 12 Mar 2023 11:27:17 +0200 Subject: [PATCH 464/882] Update 4.2.rst --- releases/4.2.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/4.2.rst b/releases/4.2.rst index b5684eb20..1330a1c81 100644 --- a/releases/4.2.rst +++ b/releases/4.2.rst @@ -35,7 +35,7 @@ JDBC Storage Version --------------- -The storage version presently in effect is version xx. +The storage version presently in effect is version 46. SQream Studio Updates and Improvements -------------------------------------- From a3bbea5dbcee2951d73ae45338b093435d1c7f94 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 12 Mar 2023 11:44:14 +0200 Subject: [PATCH 465/882] Spark --- .../Spark}/spark.rst | 0 connecting_to_sqream/client_drivers/index.rst | 11 +++++++---- 2 files changed, 7 insertions(+), 4 deletions(-) rename connecting_to_sqream/{client_platforms => client_drivers/Spark}/spark.rst (100%) diff --git a/connecting_to_sqream/client_platforms/spark.rst b/connecting_to_sqream/client_drivers/Spark/spark.rst similarity index 100% rename from connecting_to_sqream/client_platforms/spark.rst rename to connecting_to_sqream/client_drivers/Spark/spark.rst diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index 08ff79a4f..0847fbd3b 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -31,8 +31,13 @@ The following are applicable to all operating systems: * **Trino**: - * `Trino connector <>`_ + * `Trino Connector <>`_ * :ref:`trino` + +* **Spark**: + + * `Spark Connector <>`_ + * :ref:`spark` .. _python: @@ -41,7 +46,6 @@ The following are applicable to all operating systems: * `Python .tar file <https://github.com/SQream/pysqream/releases/tag/v3.1.3>`_ - pysqream v3.1.3 (.tar.gz) * :ref:`pysqream` - .. _nodejs: * **Node.JS** - Recommended installation via ``npm``: @@ -49,7 +53,6 @@ The following are applicable to all operating systems: * `Node.JS <https://sq-ftp-public.s3.amazonaws.com/sqream-sqreamdb-4.2.4.tgz>`_ - sqream-v4.2.4 (.tar.gz) * :ref:`nodejs` - .. _tableau_connector: * **Tableau**: @@ -62,7 +65,7 @@ The following are applicable to all operating systems: * **Power BI**: - * `Power BI PowerQuery connector <https://sq-ftp-public.s3.amazonaws.com/SqlODBC__v1.0.mez>`_ - SQream (.mez) + * `Power BI PowerQuery Connector <https://sq-ftp-public.s3.amazonaws.com/SqlODBC__v1.0.mez>`_ - SQream (.mez) * :ref:`power_bi` From cba00956bf9f176e790641a3931d65d6e0da3770 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 12 Mar 2023 14:44:02 +0200 Subject: [PATCH 466/882] Spark --- connecting_to_sqream/client_drivers/index.rst | 1 + .../client_platforms/spark.rst | 282 ++++++++++++++++++ 2 files changed, 283 insertions(+) create mode 100644 connecting_to_sqream/client_platforms/spark.rst diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index 0847fbd3b..7b321d77b 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -34,6 +34,7 @@ The following are applicable to all operating systems: * `Trino Connector <>`_ * :ref:`trino` + * **Spark**: * `Spark Connector <>`_ diff --git a/connecting_to_sqream/client_platforms/spark.rst b/connecting_to_sqream/client_platforms/spark.rst new file mode 100644 index 000000000..39225a2b4 --- /dev/null +++ b/connecting_to_sqream/client_platforms/spark.rst @@ -0,0 +1,282 @@ +.. _spark: + +************************* +Using Spark With SQream +************************* + + +Spark may be used for large-scale data processing. + + +.. contents:: + :local: + :depth: 1 + +Installation and Configuration +------------------------------ + + +Before You Begin +~~~~~~~~~~~~~~~~ + +To use Spark with SQream, it is essential that you have the following installed: + +* JDBC version 4.5.6 or later +* SQream version 2022.1.8 or later +* Spark version 3.3.1 or later +* Spark Connector 1.0.0 + + +JDBC +~~~~ + +If JDBC is not yet configured, follow the :ref:`JDBC Client Drivers page<java_jdbc>` for guidance in registring and configuring. + + +Connecting Spark to SQream +~~~~~~~~~~~~~~~~~~~ + +The Spark Connector enables inserting Spark DataFrames into SQream tables and exporting tables or queries as Spark DataFrames for compatibility with Spark. DataFrames are data structures within the Spark framework designed for transferring data between disparate data sources. + +1. In the Spark Shell, run: + +.. code-block:: postgres + + ./spark-shell --driver-class-path {driver path} --jars {Spark-Sqream-Connector.jar path} + + +Example: + +.. code-block:: postgres + + ./spark-shell --driver-class-path /home/sqream/sqream-jdbc-4.5.6.jar --jars Spark-Sqream-Connector-1.0.jar + + +Connector Configuration +~~~~~~~~~~~~~~~~~~~~~~~ + +The Spark JDBC connection properties allow users to configure connections between Spark and databases. These properties enable database access, query execution, and result retrieval, as well as authentication, encryption, and connection pooling. + +SQream supports the following Spark connection properties: + +.. list-table:: + :widths: 1 4 20 + :header-rows: 1 + + + * - Item + - Default + - Description + * - ``url`` + - + - The JDBC URL to connect to the database. + * - ``dbtable`` + - + - The name of the table or view to be queried or written to in a relational database when using the JDBC data source. + * - ``query`` + - + - The SQL query to be executed when using the JDBC data source, instead of specifying a table or view name with the dbtable property. + * - ``driver`` + - + - The fully qualified class name of the JDBC driver to use when connecting to a relational database. + * - ``numPartitions`` + - + - The number of partitions to use when reading data from a data source. + * - ``queryTimeout`` + - 0 + - The maximum time in seconds for a JDBC query to execute before timing out. + * - ``fetchsize`` + - 1 + - The number of rows to fetch in a single JDBC fetch operation. + * - ``batchsize`` + - 1000000 + - The number of rows to write in a single JDBC batch operation when writing to a database. + * - ``sessionInitStatement`` + - + - A SQL statement to be executed once at the beginning of a JDBC session, such as to set session-level properties. + * - ``truncate`` + - ``false`` + - A boolean value indicating whether to truncate an existing table before writing data to it. + * - ``cascadeTruncate`` + - The default cascading truncate behavior of the JDBC database in question, specified in the ``isCascadeTruncate`` in each JDBCDialect. + - A boolean value indicating whether to recursively truncate child tables when truncating a table. + * - ``createTableOptions`` + - + - Additional options to include when creating a new table in a relational database. + * - ``createTableColumnTypes`` + - + - A map of column names to column data types to use when creating a new table in a relational database. + * - ``customSchema`` + - + - A custom schema to use when reading data from a file format that does not support schema inference, such as CSV or JSON. + * - ``pushDownPredicate`` + - ``true`` + - A boolean value indicating whether to push down filters to the data source. + * - ``pushDownAggregate`` + - ``false`` + - A boolean value indicating whether to push down aggregations to the data source. + * - ``pushDownLimit`` + - ``false`` + - A boolean value indicating whether to push down limits to the data source. + * - ``c`` + - ``false`` + - A shorthand for specifying connection properties in the JDBC data source. + * - ``connectionProvider`` + - + - A fully qualified class name of a custom connection provider to use when connecting to a data source. + + +Transferring Data From SQream to Spark +------------------------------------- + +#. From the ``SqlContext`` object, use the ``read()`` method to construct a ``DataFrameReader``. + +#. Use the ``format()`` method to specify ``SQREAM_SOURCE_NAME``. + +#. Use either the ``option()`` or ``options()` method to specify the connector options. + +#. Specify one of the following options for reading tables: + + * ``dbtable``: equivalent to the ``SELECT * FROM <table_name>`` command. + + * ``query``: equivalent to the ``SELECT`` statement. + +Examples +~~~~~~~~ + +Reading an entire table: + +.. code-block:: postgres + + val df: DataFrame = sqlContext.read .format(SQREAM_SOURCE_NAME) .options(sfOptions) .option("<sqream_table_name>", "<table_name>") .load() + +Reading query results: + +.. code-block:: postgres + + val df: DataFrame = sqlContext.read .format(SQREAM_SOURCE_NAME) .options(sfOptions) .option("query", "<EXECUTED_QUERY> <table_name>") .load() + + +Transferring data From Spark to SQream +-------------------------------------- + +#. Use the ``write()`` method of the ``DataFrame`` to construct a ``DataFrameWriter``. + +#. Specify ``SQREAM_SOURCE_NAME`` using the ``format()`` method. + +#. Use either the ``option()`` or the ``options()` method to specify the connector options. + +#. To specify the table to which data is written, use the ``dbtable`` option. + +#. To specify the content saving mode, use the ``mode()`` method. + +Example +~~~~~~~~ +Read an entire table: + +.. code-block:: postgres + + df.write .format(SQREAM_SOURCE_NAME) .options(sfOptions) .option("<sqream_table_name>", "<table_name>") .mode(SaveMode.Overwrite) .save() + + +Supported Data Types and Mapping +-------------------------------- + +SQream data types mapped to Spark + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - SQream + - Spark + * - ``BIGINT`` + - ``LONGINT`` + * - ``BOOL`` + - ``BooleanType`` + * - ``DATE`` + - ``DateType`` + * - ``DOUBLE`` + - ``DoubleType`` + * - ``REAL`` + - ``FloateType`` + * - ``DECIMAL`` + - ``DeciamlType`` + * - ``INT`` + - ``Integer`` + * - ``SMALLINT`` + - ``ShortType`` + * - ``TINYINT`` + - ``ShortType`` + * - ``DATETIME`` + - ``TimestampType`` + +Spark data types mapped to SQream + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Spark + - SQream + * - ``BooleanType`` + - ``BOOL`` + * - ``ByteType`` + - ``SMALLINT`` + * - ``DateType`` + - ``DATE`` + * - ``DecimalType`` + - ``DECIMAL`` + * - ``DoubleType`` + - ``DOUBLE`` + * - ``FloatType`` + - ``REAL`` + * - ``IntegerType`` + - ``INT`` + * - ``LongType`` + - ``BIGINT`` + * - ``ShortType`` + - ``SMALLINT`` + * - ``StringType`` + - ``TEXT`` + * - ``TimestampType`` + - ``DATETIME`` + + +Example +------- + +JAVA + +.. code-block:: postgres + + import com.sqream.driver.SqreamSession; + import org.apache.spark.sql.Dataset; + import org.apache.spark.sql.Row; + + import java.util.HashMap; + + public class main { + public static void main(String[] args) { + HashMap<String, String> config = new HashMap<>(); + //spark configuration + //optional configuration here: https://spark.apache.org/docs/latest/configuration.html + config.put("spark.master", "local"); + SqreamSession sqreamSession = SqreamSession.getSession(config); + + //spark properties + //optional properties here: https://spark.apache.org/docs/latest/sql-data-sources-jdbc.html + HashMap<String, String> props = new HashMap<>(); + + props.put("url", "jdbc:Sqream://192.168.4.51:5000/master;user=sqream;password=sqream;cluster=false;logfile=logsFiles.txt;loggerlevel=DEBUG"); + props.put("dbtable", "test"); + + /*Read from sqream table*/ + Dataset<Row> dataFrame = sqreamSession.read(props); + + /*Added to sqream table*/ + sqreamSession.write(dataFrame, props); + + } + } + From d0063e4638fd61368945764cdbb619d0b643d246 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 12 Mar 2023 15:41:28 +0200 Subject: [PATCH 467/882] Update index.rst --- connecting_to_sqream/client_drivers/jdbc/index.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/connecting_to_sqream/client_drivers/jdbc/index.rst b/connecting_to_sqream/client_drivers/jdbc/index.rst index 1929da509..e50648dfa 100644 --- a/connecting_to_sqream/client_drivers/jdbc/index.rst +++ b/connecting_to_sqream/client_drivers/jdbc/index.rst @@ -133,6 +133,10 @@ The following table shows the connection string parameters: - Optional - ``true`` - Enables the file appender and defines the file name. The file name can be set as either the file name or the file path. + * - ``<idleconnectiontimeout>`` + - Optional + - 0 + - Sets the duration, in seconds, for which a database connection can remain idle before it is terminated. If the parameter is set to its default value, idle connections will not be terminated. The idle connection timer begins counting after the completion of a query execution. Connection String Examples ^^^^^^^^^^^^^^^^^^^^^^^^^^^ From 631cc72ca851aba0c3342ffc1400b74e8a7ea3f0 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 12 Mar 2023 17:06:47 +0200 Subject: [PATCH 468/882] Update 4.2.rst --- releases/4.2.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/releases/4.2.rst b/releases/4.2.rst index 1330a1c81..3af086c6c 100644 --- a/releases/4.2.rst +++ b/releases/4.2.rst @@ -76,6 +76,11 @@ No naming changes Deprecated Features ------------------- +► ``INT96`` + +Due to Parquet's lack of support for the "INT96" data type, SQream has decided to immediately deprecate this data type. + + ► Square Brackets ``[]`` The ``[]``, which are frequently used to delimit :ref:`identifiers<keywords_and_identifiers>` such as column names, table names, and other database objects, will soon be deprecated to facilitate the use of the ``ARRAY`` data type. From 91e33c91e67de10648161c6642e501c5582079eb Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 14 Mar 2023 09:33:25 +0200 Subject: [PATCH 469/882] Update 4.2.rst --- releases/4.2.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/releases/4.2.rst b/releases/4.2.rst index 3af086c6c..d4768a0e2 100644 --- a/releases/4.2.rst +++ b/releases/4.2.rst @@ -23,14 +23,14 @@ New Features :ref:`Physical deletion<delete_guide>` performance enhancement by supporting file systems with parallelism capabilities -Connectors ----------- +Newly Released Connector Drivers +-------------------------------- -Pysqream - Supports Python 9 +Pysqream 3.2.4 - `.tar.gz file <https://github.com/SQream/pysqream/releases>`_ Supports Python 9(??) -ODBC +ODBC 4.4.4 :ref:`Getting the ODBC Driver<odbc>` -JDBC +JDBC 4.5.8 `.jar file <https://sq-ftp-public.s3.amazonaws.com/sqream-jdbc-4.5.8.jar>`_ Storage Version --------------- @@ -78,7 +78,7 @@ Deprecated Features ► ``INT96`` -Due to Parquet's lack of support for the "INT96" data type, SQream has decided to immediately deprecate this data type. +Due to Parquet's lack of support of the ``INT96`` data type, SQream has decided to deprecate this data type. ► Square Brackets ``[]`` From 137aec2c0385213c013360cb3d8d485f05ba5f5e Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 14 Mar 2023 13:49:39 +0200 Subject: [PATCH 470/882] Update 4.1.rst --- releases/4.1.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/releases/4.1.rst b/releases/4.1.rst index 0dcfccef7..a9203569b 100644 --- a/releases/4.1.rst +++ b/releases/4.1.rst @@ -25,6 +25,11 @@ New Features * A new brute-force attack protection mechanism locks out user accounts for 15 minutes following 5 consecutive failed login attempts +Newly Released Connector Drivers +-------------------------------- + +JDBC 4.5.7 `.jar file <https://sq-ftp-public.s3.amazonaws.com/sqream-jdbc-4.5.7.jar>`_ + Storage Version --------------- From 43a8043ad918f8f0518f2762506b1cf4b4a98c97 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 14 Mar 2023 15:38:05 +0200 Subject: [PATCH 471/882] Update spark.rst --- .../client_drivers/Spark/spark.rst | 150 ++++++++---------- 1 file changed, 65 insertions(+), 85 deletions(-) diff --git a/connecting_to_sqream/client_drivers/Spark/spark.rst b/connecting_to_sqream/client_drivers/Spark/spark.rst index f10191b70..45109eaa0 100644 --- a/connecting_to_sqream/client_drivers/Spark/spark.rst +++ b/connecting_to_sqream/client_drivers/Spark/spark.rst @@ -5,7 +5,7 @@ Using Spark With SQream ************************* -If you are using Spark for distributed processing and analysis and wish to use it with SQream, follow these instructions. +Spark may be used for large-scale data processing. .. contents:: @@ -15,44 +15,15 @@ If you are using Spark for distributed processing and analysis and wish to use i Installation and Configuration ------------------------------ -.. contents:: - :local: - :depth: 1 - Before You Begin ~~~~~~~~~~~~~~~~ -To use Spark with SQream, you must have the following installed: +To use Spark with SQream, it is essential that you have the following installed: * SQream version 2022.1.8 or later * Spark version 3.3.1 or later * SQream Spark Connector 1.0.0 -* JDBC version 4.5.6 or later - -JDBC -~~~~ - -If JDBC is not yet configured, follow the `JDBC Client Drivers page <https://docs.sqream.com/en/v2021.1/third_party_tools/client_drivers/jdbc/index.html>`_ for guidance in registring and configuring. - - -Connecting Spark to SQream -~~~~~~~~~~~~~~~~~~~ - -The SQream-Spark Connector enables inserting DataFrames into SQream tables and exporting tables or queries as DataFrames for use with Spark. DataFrames are Spark objects used for transferring data from one data source to another. - -1. In the Spark Shell, run: - -.. code-block:: postgres - - ./spark-shell --driver-class-path {driver path} --jars {Spark-Sqream-Connector.jar path} - - -Example: - -.. code-block:: postgres - - ./spark-shell --driver-class-path /home/sqream/sqream-jdbc-4.5.6.jar --jars Spark-Sqream-Connector-1.0.jar - +* :ref:`JDBC<jdbc>` version 4.5.6 or later Connector Configuration ~~~~~~~~~~~~~~~~~~~~~~~ @@ -71,119 +42,125 @@ The following Spark connection properties are supported by SQream: - Description * - ``url`` - - - The JDBC URL ``jdbc:subprotocol:subname`` establishes the connection between SQream and Spark. Source-specific connection properties may be specified in the URL, such as ``user`` and ``password``, e.g. ``jdbc:Sqream://localhost/test?user=fred&password=secret``. + - The JDBC URL to connect to the database. * - ``dbtable`` - - - A JDBC table to read from or write to. When reading from a ``dbtable``, anything that is valid in an SQL ``FROM`` clause may be used. For example, you may use a subquery in parentheses instead of querying a full table. It is not allowed to specify ``dbtable`` and ``query`` options at the same time. + - The JDBC URL to connect to the database. * - ``query`` - - - The ``query`` property in Spark is used to read data into the program by specifying a query. This query is used as a subquery in the ``FROM`` clause and Spark will assign an alias to the subquery. For example, when using a JDBC Source, Spark will issue a query in the format of ``SELECT <columns> FROM (<user_specified_query>) spark_gen_alias``. It's important to note that it is not allowed to use both the ``dbtable`` and ``query`` options at the same time, and the ``query`` option cannot be used with the ``partitionColumn`` option. If the ``partitionColumn`` option is needed, it must be specified using the ``dbtable`` option and qualified using the subquery alias provided in ``dbtable``. An example of how to use this option would be: spark.read.format("jdbc").option("url", jdbcUrl).option("query", "select c1, c2 from t1").load() + - The SQL query to be executed when using the JDBC data source, instead of specifying a table or view name with the dbtable property. * - ``driver`` - - - The class name of the JDBC driver to use to connect to this URL. + - The fully qualified class name of the JDBC driver to use when connecting to a relational database. * - ``numPartitions`` - - - The maximum number of partitions that can be used for parallelism in table reading and writing. This also determines the maximum number of concurrent JDBC connections. If the number of partitions to write exceeds this limit, we decrease it to this limit by calling ``coalesce(numPartitions)`` before writing. + - The number of partitions to use when reading data from a data source. * - ``queryTimeout`` - 0 - - The number of seconds the driver will wait for a Statement object to execute to the given number of seconds. Zero means there is no limit. In the write path, this option depends on how JDBC drivers implement the API ``setQueryTimeout``, e.g., the h2 JDBC driver checks the timeout of each query instead of an entire JDBC batch. + - The maximum time in seconds for a JDBC query to execute before timing out. * - ``fetchsize`` - 1 - - The JDBC fetch size, which determines how many rows to fetch per round trip. This can help performance on JDBC drivers which default to low fetch size (e.g. Oracle with 10 rows). + - The number of rows to fetch in a single JDBC fetch operation. * - ``batchsize`` - 1000000 - - The JDBC batch size, which determines how many rows to insert per round trip. This can help performance on JDBC drivers. This option applies only to writing. + - The number of rows to write in a single JDBC batch operation when writing to a database. * - ``sessionInitStatement`` - - - After each database session is opened to the remote DB and before starting to read data, this option executes a custom SQL statement (or a PL/SQL block). Use this to implement session initialization code. Example: ``option("sessionInitStatement", """BEGIN execute immediate 'alter session set "_serial_direct_read"=true'; END;""")`` + - A SQL statement to be executed once at the beginning of a JDBC session, such as to set session-level properties. * - ``truncate`` - ``false`` - - This is a JDBC writer related option. When ``SaveMode.Overwrite`` is enabled, this option causes Spark to truncate an existing table instead of dropping and recreating it. This can be more efficient, and prevents the table metadata (e.g., indices) from being removed. However, it will not work in some cases, such as when the new data has a different schema. In case of failures, users should turn off ``truncate`` option to use ``DROP TABLE`` again. Also, due to the different behavior of ``TRUNCATE TABLE`` among DBMS, it's not always safe to use this. MySQLDialect, DB2Dialect, MsSqlServerDialect, DerbyDialect, and OracleDialect supports this while PostgresDialect and default JDBCDirect doesn't. For unknown and unsupported JDBCDirect, the user option ``truncate`` is ignored. + - A boolean value indicating whether to truncate an existing table before writing data to it. * - ``cascadeTruncate`` - the default cascading truncate behaviour of the JDBC database in question, specified in the ``isCascadeTruncate`` in each JDBCDialect - - This is a JDBC writer related option. If enabled and supported by the JDBC database (PostgreSQL and Oracle at the moment), this options allows execution of a ``TRUNCATE TABLE t CASCADE`` (in the case of PostgreSQL a TRUNCATE TABLE ONLY t CASCADE is executed to prevent inadvertently truncating descendant tables). This will affect other tables, and thus should be used with care. + - A boolean value indicating whether to recursively truncate child tables when truncating a table. * - ``createTableOptions`` - - - This is a JDBC writer related option. If specified, this option allows setting of database-specific table and partition options when creating a table (e.g., ``CREATE TABLE t (name string) ENGINE=InnoDB.``). + - Additional options to include when creating a new table in a relational database. * - ``createTableColumnTypes`` - - - The database column data types to use instead of the defaults, when creating the table. Data type information should be specified in the same format as CREATE TABLE columns syntax (e.g: ``"name CHAR(64), comments VARCHAR(1024)"``). The specified types should be valid spark sql data types. + - A map of column names to column data types to use when creating a new table in a relational database. * - ``customSchema`` - - - The custom schema to use for reading data from JDBC connectors. For example, ``"id DECIMAL(38, 0), name STRING"``. You can also specify partial fields, and the others use the default type mapping. For example, ``"id DECIMAL(38, 0)"``. The column names should be identical to the corresponding column names of JDBC table. Users can specify the corresponding data types of Spark SQL instead of using the defaults. + - A custom schema to use when reading data from a file format that does not support schema inference, such as CSV or JSON. * - ``pushDownPredicate`` - ``true`` - - The option to enable or disable predicate push-down into the JDBC data source. The default value is true, in which case Spark will push down filters to the JDBC data source as much as possible. Otherwise, if set to false, no filter will be pushed down to the JDBC data source and thus all filters will be handled by Spark. Predicate push-down is usually turned off when the predicate filtering is performed faster by Spark than by the JDBC data source. + - A boolean value indicating whether to push down filters to the data source. * - ``pushDownAggregate`` - ``false`` - - The option to enable or disable aggregate push-down in V2 JDBC data source. The default value is false, in which case Spark will not push down aggregates to the JDBC data source. Otherwise, if sets to true, aggregates will be pushed down to the JDBC data source. Aggregate push-down is usually turned off when the aggregate is performed faster by Spark than by the JDBC data source. Please note that aggregates can be pushed down if and only if all the aggregate functions and the related filters can be pushed down. If ``numPartitions`` equals to 1 or the group by key is the same as ``partitionColumn``, Spark will push down aggregate to data source completely and not apply a final aggregate over the data source output. Otherwise, Spark will apply a final aggregate over the data source output. + - A boolean value indicating whether to push down aggregations to the data source. * - ``pushDownLimit`` - ``false`` - - The option to enable or disable LIMIT push-down into V2 JDBC data source. The LIMIT push-down also includes LIMIT + SORT , a.k.a. the Top N operator. The default value is false, in which case Spark does not push down LIMIT or LIMIT with SORT to the JDBC data source. Otherwise, if sets to true, LIMIT or LIMIT with SORT is pushed down to the JDBC data source. If ``numPartitions`` is greater than 1, SPARK still applies LIMIT or LIMIT with SORT on the result from data source even if LIMIT or LIMIT with SORT is pushed down. Otherwise, if LIMIT or LIMIT with SORT is pushed down and ``numPartitions`` equals to 1, SPARK will not apply LIMIT or LIMIT with SORT on the result from data source. + - A boolean value indicating whether to push down limits to the data source. * - ``pushDownTableSample`` - ``false`` - - The option to enable or disable TABLESAMPLE push-down into V2 JDBC data source. The default value is false, in which case Spark does not push down TABLESAMPLE to the JDBC data source. Otherwise, if value sets to true, TABLESAMPLE is pushed down to the JDBC data source. + - Used to optimize the performance of SQL queries on large tables by pushing down the sampling operation closer to the data source, reducing the amount of data that needs to be processed. * - ``connectionProvider`` - - - The name of the JDBC connection provider to use to connect to this URL, e.g. ``db2``, ``mssql``. Must be one of the providers loaded with the JDBC data source. Used to disambiguate when more than one provider can handle the specified driver and options. The selected provider must not be disabled by ``spark.sql.sources.disabledJdbcConnProviderList``. - - -Transferring Data From SQream to Spark -------------------------------------- + - A fully qualified class name of a custom connection provider to use when connecting to a data source. + * - ``c`` + - ``false`` + - A shorthand for specifying connection properties in the JDBC data source. + -In the Spark UI, configure Spark to write to the SQream database. -1. From the SqlContext object, use the read() method to construct a DataFrameReader. +Connecting Spark to SQream +-------------------------- -2. Use the format() method to specify SQREAM_SOURCE_NAME. +The SQream-Spark Connector enables inserting DataFrames into SQream tables and exporting tables or queries as DataFrames for use with Spark. DataFrames are Spark objects used for transferring data from one data source to another. -3. Use either the option() or options() method to specify the connector options. +1. To open the Spark Shell, run the following command under the ``Spark/bin`` directory: -4. Specify one of the following options for reading tables: +.. code-block:: postgres - * dbtable: The name of the table to be read. All columns and records are retrieved (i.e. it is equivalent to ``SELECT * FROM db_table``). + ./spark-shell --driver-class-path {driver path} --jars {Spark-Sqream-Connector.jar path} - * query: The exact query (SELECT statement) to run. - -Examples ---------------- -To read an entire table: +Example: .. code-block:: postgres - val df: DataFrame = sqlContext.read .format(SQREAM_SOURCE_NAME) .options(sfOptions) .option("<sqream_table_name>", "<table_name>") .load() - -To read query results: - -.. code-block:: postgres + ./spark-shell --driver-class-path /home/sqream/sqream-jdbc-4.5.6.jar --jars Spark-Sqream-Connector-1.0.jar - val df: DataFrame = sqlContext.read .format(SQREAM_SOURCE_NAME) .options(sfOptions) .option("query", "<EXECUTED_QUERY> <table_name>") .load() +2. To create a SQream session, run the following commands in the Spark Shell: +.. code-block:: postgres + + import scala.collection.JavaConverters.mapAsJavaMapConverter + val config = Map("spark.master"->"local").asJava + import com.sqream.driver.SqreamSession; + val sqreamSession=SqreamSession.getSession(config) -Transferring data From Spark to SQream + +Transferring Data From SQream to Spark -------------------------------------- -In the Spark UI, configure Spark to read from the SQream database. +1. Create a mapping of Spark options: + +.. code-block:: postgres -1. Use the write() method of the DataFrame to construct a DataFrameWriter. + val options = Map("query"->"select * from <table_name>", "url"->"jdbc:<jdbc_path>/master;user=<username>;password=<password>;cluster=false").asJava -2. Specify SQREAM_SOURCE_NAME using the format() method. +2. Create a Spark DataFrame: -3. Specify the connector options using either the option() or options() method. +.. code-block:: postgres -4. Use the dbtable option to specify the table to which data is written. + val df=sqreamSession.read(options) -5. Use the mode() method to specify the save mode for the content. +Transferring Data From Spark to SQream +-------------------------------------- -Examples ---------------- -To read an entire table: +1. Create a mapping of Spark options, using the ``dbtable`` Spark option (``query`` is not allowed for writing): .. code-block:: postgres - df.write .format(SQREAM_SOURCE_NAME) .options(sfOptions) .option("<sqream_table_name>", "<table_name>") .mode(SaveMode.Overwrite) .save() + val options = Map("dbtable"-> <table_name>", "url"->"jdbc:<jdbc_path>/master;user=<username>;password=<password>;cluster=false").asJava + +2. Create a Spark DataFrame: + +.. code-block:: postgres + import org.apache.spark.sql.SaveMode + val df=sqreamSession.write((df, options, SaveMode.Overwrite)) Supported Data Types and Mapping -------------------------------- @@ -249,8 +226,8 @@ Spark data types mapped to SQream - ``DATETIME`` -Examples ---------- +Example +------- JAVA @@ -259,6 +236,7 @@ JAVA import com.sqream.driver.SqreamSession; import org.apache.spark.sql.Dataset; import org.apache.spark.sql.Row; + import org.apache.spark.sql.SaveMode; import java.util.HashMap; @@ -282,6 +260,8 @@ JAVA /*Added to sqream table*/ sqreamSession.write(dataFrame, props); + sqreamSession.write(dataFrame, props, SaveMode.Overwrite); + } } From 7128d2925a16381b7cbec9f405fdc438e1412741 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 14 Mar 2023 15:49:13 +0200 Subject: [PATCH 472/882] Delete spark.rst --- .../client_drivers/Spark/spark.rst | 268 ------------------ 1 file changed, 268 deletions(-) delete mode 100644 connecting_to_sqream/client_drivers/Spark/spark.rst diff --git a/connecting_to_sqream/client_drivers/Spark/spark.rst b/connecting_to_sqream/client_drivers/Spark/spark.rst deleted file mode 100644 index 45109eaa0..000000000 --- a/connecting_to_sqream/client_drivers/Spark/spark.rst +++ /dev/null @@ -1,268 +0,0 @@ -.. _spark: - -************************* -Using Spark With SQream -************************* - - -Spark may be used for large-scale data processing. - - -.. contents:: - :local: - :depth: 1 - -Installation and Configuration ------------------------------- - -Before You Begin -~~~~~~~~~~~~~~~~ - -To use Spark with SQream, it is essential that you have the following installed: - -* SQream version 2022.1.8 or later -* Spark version 3.3.1 or later -* SQream Spark Connector 1.0.0 -* :ref:`JDBC<jdbc>` version 4.5.6 or later - -Connector Configuration -~~~~~~~~~~~~~~~~~~~~~~~ - -The Spark JDBC connection properties allow users to configure connections between Spark and databases. These properties enable database access, query execution, and result retrieval, as well as authentication, encryption, and connection pooling. - -The following Spark connection properties are supported by SQream: - -.. list-table:: - :widths: auto - :header-rows: 1 - - - * - Item - - Default - - Description - * - ``url`` - - - - The JDBC URL to connect to the database. - * - ``dbtable`` - - - - The JDBC URL to connect to the database. - * - ``query`` - - - - The SQL query to be executed when using the JDBC data source, instead of specifying a table or view name with the dbtable property. - * - ``driver`` - - - - The fully qualified class name of the JDBC driver to use when connecting to a relational database. - * - ``numPartitions`` - - - - The number of partitions to use when reading data from a data source. - * - ``queryTimeout`` - - 0 - - The maximum time in seconds for a JDBC query to execute before timing out. - * - ``fetchsize`` - - 1 - - The number of rows to fetch in a single JDBC fetch operation. - * - ``batchsize`` - - 1000000 - - The number of rows to write in a single JDBC batch operation when writing to a database. - * - ``sessionInitStatement`` - - - - A SQL statement to be executed once at the beginning of a JDBC session, such as to set session-level properties. - * - ``truncate`` - - ``false`` - - A boolean value indicating whether to truncate an existing table before writing data to it. - * - ``cascadeTruncate`` - - the default cascading truncate behaviour of the JDBC database in question, specified in the ``isCascadeTruncate`` in each JDBCDialect - - A boolean value indicating whether to recursively truncate child tables when truncating a table. - * - ``createTableOptions`` - - - - Additional options to include when creating a new table in a relational database. - * - ``createTableColumnTypes`` - - - - A map of column names to column data types to use when creating a new table in a relational database. - * - ``customSchema`` - - - - A custom schema to use when reading data from a file format that does not support schema inference, such as CSV or JSON. - * - ``pushDownPredicate`` - - ``true`` - - A boolean value indicating whether to push down filters to the data source. - * - ``pushDownAggregate`` - - ``false`` - - A boolean value indicating whether to push down aggregations to the data source. - * - ``pushDownLimit`` - - ``false`` - - A boolean value indicating whether to push down limits to the data source. - * - ``pushDownTableSample`` - - ``false`` - - Used to optimize the performance of SQL queries on large tables by pushing down the sampling operation closer to the data source, reducing the amount of data that needs to be processed. - * - ``connectionProvider`` - - - - A fully qualified class name of a custom connection provider to use when connecting to a data source. - * - ``c`` - - ``false`` - - A shorthand for specifying connection properties in the JDBC data source. - - - -Connecting Spark to SQream --------------------------- - -The SQream-Spark Connector enables inserting DataFrames into SQream tables and exporting tables or queries as DataFrames for use with Spark. DataFrames are Spark objects used for transferring data from one data source to another. - -1. To open the Spark Shell, run the following command under the ``Spark/bin`` directory: - -.. code-block:: postgres - - ./spark-shell --driver-class-path {driver path} --jars {Spark-Sqream-Connector.jar path} - - -Example: - -.. code-block:: postgres - - ./spark-shell --driver-class-path /home/sqream/sqream-jdbc-4.5.6.jar --jars Spark-Sqream-Connector-1.0.jar - -2. To create a SQream session, run the following commands in the Spark Shell: - -.. code-block:: postgres - - import scala.collection.JavaConverters.mapAsJavaMapConverter - val config = Map("spark.master"->"local").asJava - import com.sqream.driver.SqreamSession; - val sqreamSession=SqreamSession.getSession(config) - - -Transferring Data From SQream to Spark --------------------------------------- - -1. Create a mapping of Spark options: - -.. code-block:: postgres - - val options = Map("query"->"select * from <table_name>", "url"->"jdbc:<jdbc_path>/master;user=<username>;password=<password>;cluster=false").asJava - -2. Create a Spark DataFrame: - -.. code-block:: postgres - - val df=sqreamSession.read(options) - -Transferring Data From Spark to SQream --------------------------------------- - -1. Create a mapping of Spark options, using the ``dbtable`` Spark option (``query`` is not allowed for writing): - -.. code-block:: postgres - - val options = Map("dbtable"-> <table_name>", "url"->"jdbc:<jdbc_path>/master;user=<username>;password=<password>;cluster=false").asJava - -2. Create a Spark DataFrame: - -.. code-block:: postgres - - import org.apache.spark.sql.SaveMode - val df=sqreamSession.write((df, options, SaveMode.Overwrite)) - -Supported Data Types and Mapping --------------------------------- - -SQream data types mapped to Spark - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - SQream - - Spark - * - ``BIGINT`` - - ``LONGINT`` - * - ``BOOL`` - - ``BooleanType`` - * - ``DATE`` - - ``DateType`` - * - ``DOUBLE`` - - ``DoubleType`` - * - ``REAL`` - - ``FloateType`` - * - ``DECIMAL`` - - ``DeciamlType`` - * - ``INT`` - - ``Integer`` - * - ``SMALLINT`` - - ``ShortType`` - * - ``TINYINT`` - - ``ShortType`` - * - ``DATETIME`` - - ``TimestampType`` - -Spark data types mapped to SQream - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Spark - - SQream - * - ``BooleanType`` - - ``BOOL`` - * - ``ByteType`` - - ``SMALLINT`` - * - ``DateType`` - - ``DATE`` - * - ``DecimalType`` - - ``DECIMAL`` - * - ``DoubleType`` - - ``DOUBLE`` - * - ``FloatType`` - - ``REAL`` - * - ``IntegerType`` - - ``INT`` - * - ``LongType`` - - ``BIGINT`` - * - ``ShortType`` - - ``SMALLINT`` - * - ``StringType`` - - ``TEXT`` - * - ``TimestampType`` - - ``DATETIME`` - - -Example -------- - -JAVA - -.. code-block:: postgres - - import com.sqream.driver.SqreamSession; - import org.apache.spark.sql.Dataset; - import org.apache.spark.sql.Row; - import org.apache.spark.sql.SaveMode; - - import java.util.HashMap; - - public class main { - public static void main(String[] args) { - HashMap<String, String> config = new HashMap<>(); - //spark configuration - //optional configuration here: https://spark.apache.org/docs/latest/configuration.html - config.put("spark.master", "local"); - SqreamSession sqreamSession = SqreamSession.getSession(config); - - //spark properties - //optional properties here: https://spark.apache.org/docs/latest/sql-data-sources-jdbc.html - HashMap<String, String> props = new HashMap<>(); - - props.put("url", "jdbc:Sqream://192.168.4.51:5000/master;user=sqream;password=sqream;cluster=false;logfile=logsFiles.txt;loggerlevel=DEBUG"); - props.put("dbtable", "test"); - - /*Read from sqream table*/ - Dataset<Row> dataFrame = sqreamSession.read(props); - - /*Added to sqream table*/ - sqreamSession.write(dataFrame, props); - sqreamSession.write(dataFrame, props, SaveMode.Overwrite); - - - } - } - From d82734b65c51dc3e715e701dd6c91d456c149576 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 14 Mar 2023 16:05:11 +0200 Subject: [PATCH 473/882] Create spark.rst --- .../client_drivers/Spark/spark.rst | 268 ++++++++++++++++++ 1 file changed, 268 insertions(+) create mode 100644 connecting_to_sqream/client_drivers/Spark/spark.rst diff --git a/connecting_to_sqream/client_drivers/Spark/spark.rst b/connecting_to_sqream/client_drivers/Spark/spark.rst new file mode 100644 index 000000000..45109eaa0 --- /dev/null +++ b/connecting_to_sqream/client_drivers/Spark/spark.rst @@ -0,0 +1,268 @@ +.. _spark: + +************************* +Using Spark With SQream +************************* + + +Spark may be used for large-scale data processing. + + +.. contents:: + :local: + :depth: 1 + +Installation and Configuration +------------------------------ + +Before You Begin +~~~~~~~~~~~~~~~~ + +To use Spark with SQream, it is essential that you have the following installed: + +* SQream version 2022.1.8 or later +* Spark version 3.3.1 or later +* SQream Spark Connector 1.0.0 +* :ref:`JDBC<jdbc>` version 4.5.6 or later + +Connector Configuration +~~~~~~~~~~~~~~~~~~~~~~~ + +The Spark JDBC connection properties allow users to configure connections between Spark and databases. These properties enable database access, query execution, and result retrieval, as well as authentication, encryption, and connection pooling. + +The following Spark connection properties are supported by SQream: + +.. list-table:: + :widths: auto + :header-rows: 1 + + + * - Item + - Default + - Description + * - ``url`` + - + - The JDBC URL to connect to the database. + * - ``dbtable`` + - + - The JDBC URL to connect to the database. + * - ``query`` + - + - The SQL query to be executed when using the JDBC data source, instead of specifying a table or view name with the dbtable property. + * - ``driver`` + - + - The fully qualified class name of the JDBC driver to use when connecting to a relational database. + * - ``numPartitions`` + - + - The number of partitions to use when reading data from a data source. + * - ``queryTimeout`` + - 0 + - The maximum time in seconds for a JDBC query to execute before timing out. + * - ``fetchsize`` + - 1 + - The number of rows to fetch in a single JDBC fetch operation. + * - ``batchsize`` + - 1000000 + - The number of rows to write in a single JDBC batch operation when writing to a database. + * - ``sessionInitStatement`` + - + - A SQL statement to be executed once at the beginning of a JDBC session, such as to set session-level properties. + * - ``truncate`` + - ``false`` + - A boolean value indicating whether to truncate an existing table before writing data to it. + * - ``cascadeTruncate`` + - the default cascading truncate behaviour of the JDBC database in question, specified in the ``isCascadeTruncate`` in each JDBCDialect + - A boolean value indicating whether to recursively truncate child tables when truncating a table. + * - ``createTableOptions`` + - + - Additional options to include when creating a new table in a relational database. + * - ``createTableColumnTypes`` + - + - A map of column names to column data types to use when creating a new table in a relational database. + * - ``customSchema`` + - + - A custom schema to use when reading data from a file format that does not support schema inference, such as CSV or JSON. + * - ``pushDownPredicate`` + - ``true`` + - A boolean value indicating whether to push down filters to the data source. + * - ``pushDownAggregate`` + - ``false`` + - A boolean value indicating whether to push down aggregations to the data source. + * - ``pushDownLimit`` + - ``false`` + - A boolean value indicating whether to push down limits to the data source. + * - ``pushDownTableSample`` + - ``false`` + - Used to optimize the performance of SQL queries on large tables by pushing down the sampling operation closer to the data source, reducing the amount of data that needs to be processed. + * - ``connectionProvider`` + - + - A fully qualified class name of a custom connection provider to use when connecting to a data source. + * - ``c`` + - ``false`` + - A shorthand for specifying connection properties in the JDBC data source. + + + +Connecting Spark to SQream +-------------------------- + +The SQream-Spark Connector enables inserting DataFrames into SQream tables and exporting tables or queries as DataFrames for use with Spark. DataFrames are Spark objects used for transferring data from one data source to another. + +1. To open the Spark Shell, run the following command under the ``Spark/bin`` directory: + +.. code-block:: postgres + + ./spark-shell --driver-class-path {driver path} --jars {Spark-Sqream-Connector.jar path} + + +Example: + +.. code-block:: postgres + + ./spark-shell --driver-class-path /home/sqream/sqream-jdbc-4.5.6.jar --jars Spark-Sqream-Connector-1.0.jar + +2. To create a SQream session, run the following commands in the Spark Shell: + +.. code-block:: postgres + + import scala.collection.JavaConverters.mapAsJavaMapConverter + val config = Map("spark.master"->"local").asJava + import com.sqream.driver.SqreamSession; + val sqreamSession=SqreamSession.getSession(config) + + +Transferring Data From SQream to Spark +-------------------------------------- + +1. Create a mapping of Spark options: + +.. code-block:: postgres + + val options = Map("query"->"select * from <table_name>", "url"->"jdbc:<jdbc_path>/master;user=<username>;password=<password>;cluster=false").asJava + +2. Create a Spark DataFrame: + +.. code-block:: postgres + + val df=sqreamSession.read(options) + +Transferring Data From Spark to SQream +-------------------------------------- + +1. Create a mapping of Spark options, using the ``dbtable`` Spark option (``query`` is not allowed for writing): + +.. code-block:: postgres + + val options = Map("dbtable"-> <table_name>", "url"->"jdbc:<jdbc_path>/master;user=<username>;password=<password>;cluster=false").asJava + +2. Create a Spark DataFrame: + +.. code-block:: postgres + + import org.apache.spark.sql.SaveMode + val df=sqreamSession.write((df, options, SaveMode.Overwrite)) + +Supported Data Types and Mapping +-------------------------------- + +SQream data types mapped to Spark + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - SQream + - Spark + * - ``BIGINT`` + - ``LONGINT`` + * - ``BOOL`` + - ``BooleanType`` + * - ``DATE`` + - ``DateType`` + * - ``DOUBLE`` + - ``DoubleType`` + * - ``REAL`` + - ``FloateType`` + * - ``DECIMAL`` + - ``DeciamlType`` + * - ``INT`` + - ``Integer`` + * - ``SMALLINT`` + - ``ShortType`` + * - ``TINYINT`` + - ``ShortType`` + * - ``DATETIME`` + - ``TimestampType`` + +Spark data types mapped to SQream + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Spark + - SQream + * - ``BooleanType`` + - ``BOOL`` + * - ``ByteType`` + - ``SMALLINT`` + * - ``DateType`` + - ``DATE`` + * - ``DecimalType`` + - ``DECIMAL`` + * - ``DoubleType`` + - ``DOUBLE`` + * - ``FloatType`` + - ``REAL`` + * - ``IntegerType`` + - ``INT`` + * - ``LongType`` + - ``BIGINT`` + * - ``ShortType`` + - ``SMALLINT`` + * - ``StringType`` + - ``TEXT`` + * - ``TimestampType`` + - ``DATETIME`` + + +Example +------- + +JAVA + +.. code-block:: postgres + + import com.sqream.driver.SqreamSession; + import org.apache.spark.sql.Dataset; + import org.apache.spark.sql.Row; + import org.apache.spark.sql.SaveMode; + + import java.util.HashMap; + + public class main { + public static void main(String[] args) { + HashMap<String, String> config = new HashMap<>(); + //spark configuration + //optional configuration here: https://spark.apache.org/docs/latest/configuration.html + config.put("spark.master", "local"); + SqreamSession sqreamSession = SqreamSession.getSession(config); + + //spark properties + //optional properties here: https://spark.apache.org/docs/latest/sql-data-sources-jdbc.html + HashMap<String, String> props = new HashMap<>(); + + props.put("url", "jdbc:Sqream://192.168.4.51:5000/master;user=sqream;password=sqream;cluster=false;logfile=logsFiles.txt;loggerlevel=DEBUG"); + props.put("dbtable", "test"); + + /*Read from sqream table*/ + Dataset<Row> dataFrame = sqreamSession.read(props); + + /*Added to sqream table*/ + sqreamSession.write(dataFrame, props); + sqreamSession.write(dataFrame, props, SaveMode.Overwrite); + + + } + } + From ee9efc65c4d10c40607979a46adb97624850f067 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 14 Mar 2023 16:12:45 +0200 Subject: [PATCH 474/882] Delete spark.rst --- .../client_platforms/spark.rst | 282 ------------------ 1 file changed, 282 deletions(-) delete mode 100644 connecting_to_sqream/client_platforms/spark.rst diff --git a/connecting_to_sqream/client_platforms/spark.rst b/connecting_to_sqream/client_platforms/spark.rst deleted file mode 100644 index 39225a2b4..000000000 --- a/connecting_to_sqream/client_platforms/spark.rst +++ /dev/null @@ -1,282 +0,0 @@ -.. _spark: - -************************* -Using Spark With SQream -************************* - - -Spark may be used for large-scale data processing. - - -.. contents:: - :local: - :depth: 1 - -Installation and Configuration ------------------------------- - - -Before You Begin -~~~~~~~~~~~~~~~~ - -To use Spark with SQream, it is essential that you have the following installed: - -* JDBC version 4.5.6 or later -* SQream version 2022.1.8 or later -* Spark version 3.3.1 or later -* Spark Connector 1.0.0 - - -JDBC -~~~~ - -If JDBC is not yet configured, follow the :ref:`JDBC Client Drivers page<java_jdbc>` for guidance in registring and configuring. - - -Connecting Spark to SQream -~~~~~~~~~~~~~~~~~~~ - -The Spark Connector enables inserting Spark DataFrames into SQream tables and exporting tables or queries as Spark DataFrames for compatibility with Spark. DataFrames are data structures within the Spark framework designed for transferring data between disparate data sources. - -1. In the Spark Shell, run: - -.. code-block:: postgres - - ./spark-shell --driver-class-path {driver path} --jars {Spark-Sqream-Connector.jar path} - - -Example: - -.. code-block:: postgres - - ./spark-shell --driver-class-path /home/sqream/sqream-jdbc-4.5.6.jar --jars Spark-Sqream-Connector-1.0.jar - - -Connector Configuration -~~~~~~~~~~~~~~~~~~~~~~~ - -The Spark JDBC connection properties allow users to configure connections between Spark and databases. These properties enable database access, query execution, and result retrieval, as well as authentication, encryption, and connection pooling. - -SQream supports the following Spark connection properties: - -.. list-table:: - :widths: 1 4 20 - :header-rows: 1 - - - * - Item - - Default - - Description - * - ``url`` - - - - The JDBC URL to connect to the database. - * - ``dbtable`` - - - - The name of the table or view to be queried or written to in a relational database when using the JDBC data source. - * - ``query`` - - - - The SQL query to be executed when using the JDBC data source, instead of specifying a table or view name with the dbtable property. - * - ``driver`` - - - - The fully qualified class name of the JDBC driver to use when connecting to a relational database. - * - ``numPartitions`` - - - - The number of partitions to use when reading data from a data source. - * - ``queryTimeout`` - - 0 - - The maximum time in seconds for a JDBC query to execute before timing out. - * - ``fetchsize`` - - 1 - - The number of rows to fetch in a single JDBC fetch operation. - * - ``batchsize`` - - 1000000 - - The number of rows to write in a single JDBC batch operation when writing to a database. - * - ``sessionInitStatement`` - - - - A SQL statement to be executed once at the beginning of a JDBC session, such as to set session-level properties. - * - ``truncate`` - - ``false`` - - A boolean value indicating whether to truncate an existing table before writing data to it. - * - ``cascadeTruncate`` - - The default cascading truncate behavior of the JDBC database in question, specified in the ``isCascadeTruncate`` in each JDBCDialect. - - A boolean value indicating whether to recursively truncate child tables when truncating a table. - * - ``createTableOptions`` - - - - Additional options to include when creating a new table in a relational database. - * - ``createTableColumnTypes`` - - - - A map of column names to column data types to use when creating a new table in a relational database. - * - ``customSchema`` - - - - A custom schema to use when reading data from a file format that does not support schema inference, such as CSV or JSON. - * - ``pushDownPredicate`` - - ``true`` - - A boolean value indicating whether to push down filters to the data source. - * - ``pushDownAggregate`` - - ``false`` - - A boolean value indicating whether to push down aggregations to the data source. - * - ``pushDownLimit`` - - ``false`` - - A boolean value indicating whether to push down limits to the data source. - * - ``c`` - - ``false`` - - A shorthand for specifying connection properties in the JDBC data source. - * - ``connectionProvider`` - - - - A fully qualified class name of a custom connection provider to use when connecting to a data source. - - -Transferring Data From SQream to Spark -------------------------------------- - -#. From the ``SqlContext`` object, use the ``read()`` method to construct a ``DataFrameReader``. - -#. Use the ``format()`` method to specify ``SQREAM_SOURCE_NAME``. - -#. Use either the ``option()`` or ``options()` method to specify the connector options. - -#. Specify one of the following options for reading tables: - - * ``dbtable``: equivalent to the ``SELECT * FROM <table_name>`` command. - - * ``query``: equivalent to the ``SELECT`` statement. - -Examples -~~~~~~~~ - -Reading an entire table: - -.. code-block:: postgres - - val df: DataFrame = sqlContext.read .format(SQREAM_SOURCE_NAME) .options(sfOptions) .option("<sqream_table_name>", "<table_name>") .load() - -Reading query results: - -.. code-block:: postgres - - val df: DataFrame = sqlContext.read .format(SQREAM_SOURCE_NAME) .options(sfOptions) .option("query", "<EXECUTED_QUERY> <table_name>") .load() - - -Transferring data From Spark to SQream --------------------------------------- - -#. Use the ``write()`` method of the ``DataFrame`` to construct a ``DataFrameWriter``. - -#. Specify ``SQREAM_SOURCE_NAME`` using the ``format()`` method. - -#. Use either the ``option()`` or the ``options()` method to specify the connector options. - -#. To specify the table to which data is written, use the ``dbtable`` option. - -#. To specify the content saving mode, use the ``mode()`` method. - -Example -~~~~~~~~ -Read an entire table: - -.. code-block:: postgres - - df.write .format(SQREAM_SOURCE_NAME) .options(sfOptions) .option("<sqream_table_name>", "<table_name>") .mode(SaveMode.Overwrite) .save() - - -Supported Data Types and Mapping --------------------------------- - -SQream data types mapped to Spark - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - SQream - - Spark - * - ``BIGINT`` - - ``LONGINT`` - * - ``BOOL`` - - ``BooleanType`` - * - ``DATE`` - - ``DateType`` - * - ``DOUBLE`` - - ``DoubleType`` - * - ``REAL`` - - ``FloateType`` - * - ``DECIMAL`` - - ``DeciamlType`` - * - ``INT`` - - ``Integer`` - * - ``SMALLINT`` - - ``ShortType`` - * - ``TINYINT`` - - ``ShortType`` - * - ``DATETIME`` - - ``TimestampType`` - -Spark data types mapped to SQream - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Spark - - SQream - * - ``BooleanType`` - - ``BOOL`` - * - ``ByteType`` - - ``SMALLINT`` - * - ``DateType`` - - ``DATE`` - * - ``DecimalType`` - - ``DECIMAL`` - * - ``DoubleType`` - - ``DOUBLE`` - * - ``FloatType`` - - ``REAL`` - * - ``IntegerType`` - - ``INT`` - * - ``LongType`` - - ``BIGINT`` - * - ``ShortType`` - - ``SMALLINT`` - * - ``StringType`` - - ``TEXT`` - * - ``TimestampType`` - - ``DATETIME`` - - -Example -------- - -JAVA - -.. code-block:: postgres - - import com.sqream.driver.SqreamSession; - import org.apache.spark.sql.Dataset; - import org.apache.spark.sql.Row; - - import java.util.HashMap; - - public class main { - public static void main(String[] args) { - HashMap<String, String> config = new HashMap<>(); - //spark configuration - //optional configuration here: https://spark.apache.org/docs/latest/configuration.html - config.put("spark.master", "local"); - SqreamSession sqreamSession = SqreamSession.getSession(config); - - //spark properties - //optional properties here: https://spark.apache.org/docs/latest/sql-data-sources-jdbc.html - HashMap<String, String> props = new HashMap<>(); - - props.put("url", "jdbc:Sqream://192.168.4.51:5000/master;user=sqream;password=sqream;cluster=false;logfile=logsFiles.txt;loggerlevel=DEBUG"); - props.put("dbtable", "test"); - - /*Read from sqream table*/ - Dataset<Row> dataFrame = sqreamSession.read(props); - - /*Added to sqream table*/ - sqreamSession.write(dataFrame, props); - - } - } - From 782fc155394914e5384c5141c8534bee62a16c13 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 14 Mar 2023 16:45:59 +0200 Subject: [PATCH 475/882] Update spark.rst --- connecting_to_sqream/client_drivers/Spark/spark.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/connecting_to_sqream/client_drivers/Spark/spark.rst b/connecting_to_sqream/client_drivers/Spark/spark.rst index 45109eaa0..812cebd75 100644 --- a/connecting_to_sqream/client_drivers/Spark/spark.rst +++ b/connecting_to_sqream/client_drivers/Spark/spark.rst @@ -160,7 +160,7 @@ Transferring Data From Spark to SQream .. code-block:: postgres import org.apache.spark.sql.SaveMode - val df=sqreamSession.write((df, options, SaveMode.Overwrite)) + val df=sqreamSession.write(df, options, SaveMode.Overwrite) Supported Data Types and Mapping -------------------------------- From bf58f7ccea34325c8774ae9643d4f4f6b188c73b Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 14 Mar 2023 16:49:25 +0200 Subject: [PATCH 476/882] Update index.rst --- connecting_to_sqream/index.rst | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/connecting_to_sqream/index.rst b/connecting_to_sqream/index.rst index 668af4d1e..10533b0ac 100644 --- a/connecting_to_sqream/index.rst +++ b/connecting_to_sqream/index.rst @@ -3,9 +3,7 @@ ************************* Connecting to SQream ************************* -SQream supports the most common database tools and interfaces, giving you direct access through a variety of drivers, connectors, and visualiztion tools and utilities. The tools described on this page have been tested and approved for use with SQream. Most third party tools that work through JDBC, ODBC, and Python should work. - -This section provides information about the following third party tools: +SQream supports the most common database tools and interfaces, giving you direct access through a variety of drivers, connectors, and visualization tools and utilities. The tools described on this page have been tested and approved for use with SQream. .. toctree:: :maxdepth: 2 From a32026f367f7cc805112cbab4b69caa015042481 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 16 Mar 2023 09:16:40 +0200 Subject: [PATCH 477/882] Update index.rst --- connecting_to_sqream/client_drivers/index.rst | 20 +------------------ 1 file changed, 1 insertion(+), 19 deletions(-) diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index 7b321d77b..c02c37be7 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -44,7 +44,7 @@ The following are applicable to all operating systems: * **Python** - Recommended installation via ``pip``: - * `Python .tar file <https://github.com/SQream/pysqream/releases/tag/v3.1.3>`_ - pysqream v3.1.3 (.tar.gz) + * `Python .tar file <https://github.com/SQream/pysqream/releases/tag/v3.2.4>`_ - pysqream v3.2.4 (.tar.gz) * :ref:`pysqream` .. _nodejs: @@ -82,24 +82,6 @@ The following are applicable to Windows: * **Net driver** - `SQream .Net driver v3.0.2 <https://sq-ftp-public.s3.amazonaws.com/SqreamNet_net48_3.0.2.zip>`_ - - - -Linux --------------- -The following are applicable to Linux: - -* `SQream SQL (x86_64) <https://sq-ftp-public.s3.amazonaws.com/sqream-sql-v2020.1.1_stable.x86_64.tar.gz>`_ - sqream-sql-v2020.1.1_stable.x86_64.tar.gz -* :ref:`sqream_sql_cli_reference` - Interactive command-line SQL client for Intel-based machines - - :: - -* `SQream SQL*(IBM POWER9) <https://sq-ftp-public.s3.amazonaws.com/sqream-sql-v2020.1.1_stable.ppc64le.tar.gz>`_ - sqream-sql-v2020.1.1_stable.ppc64le.tar.gz -* :ref:`sqream_sql_cli_reference` - Interactive command-line SQL client for IBM POWER9-based machines - - :: - -* ODBC Installer - Please contact your SQream representative for this installer. From 6b172dfda7415286f183a227a0af20aad568eaf8 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 16 Mar 2023 14:55:42 +0200 Subject: [PATCH 478/882] Update index.rst --- .../client_drivers/python/index.rst | 27 +++++++++---------- 1 file changed, 12 insertions(+), 15 deletions(-) diff --git a/connecting_to_sqream/client_drivers/python/index.rst b/connecting_to_sqream/client_drivers/python/index.rst index f29679bc0..37bcd59a6 100644 --- a/connecting_to_sqream/client_drivers/python/index.rst +++ b/connecting_to_sqream/client_drivers/python/index.rst @@ -3,28 +3,22 @@ ************************* Connecting to SQream Using Python (pysqream) ************************* -The **Python** connector page describes the following: + +The Pysqream connector is a set of packages that allows Python programs to connect to SQream DB. It includes ``pysqream`` and ``pysqream-sqlalchemy``. ``pysqream`` is a pure Python connector. It can be installed with ``pip`` on any operating system, including Linux, Windows, and macOS. ``pysqream-sqlalchemy`` is a SQLAlchemy dialect for ``pysqream``. + +The connector supports Python version 3.9 and newer. The base ``pysqream`` package conforms to Python DB-API specifications `PEP-249 <https://www.python.org/dev/peps/pep-0249/>`_. .. contents:: :local: :depth: 1 -Overview -============= -The SQream Python connector is a set of packages that allows Python programs to connect to SQream DB. - -* ``pysqream`` is a pure Python connector. It can be installed with ``pip`` on any operating system, including Linux, Windows, and macOS. - -* ``pysqream-sqlalchemy`` is a SQLAlchemy dialect for ``pysqream`` - -The connector supports Python 3.6.5 and newer. The base ``pysqream`` package conforms to Python DB-API specifications `PEP-249 <https://www.python.org/dev/peps/pep-0249/>`_. - Installing the Python Connector ================================== Prerequisites ---------------- -Installing the Python connector includes the following prerequisites: + +It is essential that you have the following installed: .. contents:: :local: @@ -33,17 +27,20 @@ Installing the Python connector includes the following prerequisites: Python ^^^^^^^^^^^^ -The connector requires Python 3.6.5 or newer. To verify your version of Python: +The connector requires Python 3.9 or newer. + +To see your current Python version, run the following command: .. code-block:: console $ python --version - Python 3.7.3 + + PIP ^^^^^^^^^^^^ -The Python connector is installed via ``pip``, the Python package manager and installer. +The Python connector is installed via ``pip``, the standard package manager for Python, which is used to install, upgrade and manage Python packages (libraries) and their dependencies. We recommend upgrading to the latest version of ``pip`` before installing. To verify that you are on the latest version, run the following command: From c72db066731f82ce83a7e66850c2d627fc847d49 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 16 Mar 2023 17:04:19 +0200 Subject: [PATCH 479/882] Update index.rst --- .../client_drivers/python/index.rst | 88 +++++++++++-------- 1 file changed, 53 insertions(+), 35 deletions(-) diff --git a/connecting_to_sqream/client_drivers/python/index.rst b/connecting_to_sqream/client_drivers/python/index.rst index 37bcd59a6..dfd3507ee 100644 --- a/connecting_to_sqream/client_drivers/python/index.rst +++ b/connecting_to_sqream/client_drivers/python/index.rst @@ -4,9 +4,10 @@ Connecting to SQream Using Python (pysqream) ************************* -The Pysqream connector is a set of packages that allows Python programs to connect to SQream DB. It includes ``pysqream`` and ``pysqream-sqlalchemy``. ``pysqream`` is a pure Python connector. It can be installed with ``pip`` on any operating system, including Linux, Windows, and macOS. ``pysqream-sqlalchemy`` is a SQLAlchemy dialect for ``pysqream``. +The Pysqream connector supports Python version 3.9 and newer. It includes a set of packages that allows Python programs to connect to SQream DB. The base ``pysqream`` package conforms to Python DB-API specifications `PEP-249 <https://www.python.org/dev/peps/pep-0249/>`_. + +``pysqream`` is a pure Python connector that can be installed with ``pip`` on any operating system, including Linux, Windows, and macOS. ``pysqream-sqlalchemy`` is a SQLAlchemy dialect for ``pysqream``. -The connector supports Python version 3.9 and newer. The base ``pysqream`` package conforms to Python DB-API specifications `PEP-249 <https://www.python.org/dev/peps/pep-0249/>`_. .. contents:: :local: @@ -16,7 +17,7 @@ Installing the Python Connector ================================== Prerequisites ----------------- +------------- It is essential that you have the following installed: @@ -25,9 +26,9 @@ It is essential that you have the following installed: :depth: 1 Python -^^^^^^^^^^^^ +~~~~~~ -The connector requires Python 3.9 or newer. +The connector requires Python version 3.9 or newer. To see your current Python version, run the following command: @@ -36,89 +37,106 @@ To see your current Python version, run the following command: $ python --version - - PIP -^^^^^^^^^^^^ +~~~ The Python connector is installed via ``pip``, the standard package manager for Python, which is used to install, upgrade and manage Python packages (libraries) and their dependencies. -We recommend upgrading to the latest version of ``pip`` before installing. To verify that you are on the latest version, run the following command: +We recommend upgrading to the latest version of ``pip`` before installing. + +To verify that you have the latest version, run the following command: .. code-block:: console - $ python3 -m pip install --upgrade pip - Collecting pip - Downloading https://files.pythonhosted.org/packages/00/b6/9cfa56b4081ad13874b0c6f96af8ce16cfbc1cb06bedf8e9164ce5551ec1/pip-19.3.1-py2.py3-none-any.whl (1.4MB) - |████████████████████████████████| 1.4MB 1.6MB/s - Installing collected packages: pip - Found existing installation: pip 19.1.1 - Uninstalling pip-19.1.1: - Successfully uninstalled pip-19.1.1 - Successfully installed pip-19.3.1 + $ python3 -m pip install --upgrade pip + Collecting pip + Downloading https://files.pythonhosted.org/packages/00/b6/9cfa56b4081ad13874b0c6f96af8ce16cfbc1cb06bedf8e9164ce5551ec1/pip-19.3.1-py2.py3-none-any.whl (1.4MB) + |████████████████████████████████| 1.4MB 1.6MB/s + Installing collected packages: pip + Found existing installation: pip 19.1.1 + Uninstalling pip-19.1.1: + Successfully uninstalled pip-19.1.1 + Successfully installed pip-19.3.1 + .. note:: * On macOS, you may want to use virtualenv to install Python and the connector, to ensure compatibility with the built-in Python environment * If you encounter an error including ``SSLError`` or ``WARNING: pip is configured with locations that require TLS/SSL, however the ssl module in Python is not available.`` - please be sure to reinstall Python with SSL enabled, or use virtualenv or Anaconda. OpenSSL for Linux -^^^^^^^^^^^^^^^^^^^^^^^^^^ -Some distributions of Python do not include OpenSSL. The Python connector relies on OpenSSL for secure connections to SQream DB. +~~~~~~~~~~~~~~~~~ +The Python connector relies on OpenSSL for secure connections to SQream DB. Some distributions of Python do not include OpenSSL. -* To install OpenSSL on RHEL/CentOS +To install OpenSSL on RHEL/CentOS, run the following command: .. code-block:: console $ sudo yum install -y libffi-devel openssl-devel -* To install OpenSSL on Ubuntu +To install OpenSSL on Ubuntu, run the following command: .. code-block:: console $ sudo apt-get install libssl-dev libffi-dev -y -Installing via PIP ------------------ + +Installing via PIP with an internet connection +---------------------------------------------- The Python connector is available via `PyPi <https://pypi.org/project/pysqream/>`_. -Install the connector with ``pip``: +To install the connector using pip, it is advisable to use the ``-U`` or ``--user`` flags instead of sudo, as it ensures packages are installed per user. However, it is worth noting that the connector can only be accessed under the same user. + +To install ``pysqream`` and ``pysqream-sqlalchemy`` with the ``--user`` flag, run the following command: .. code-block:: console - $ pip3 install pysqream pysqream-sqlalchemy + $ pip3.9 install pysqream pysqream-sqlalchemy --user ``pip3`` will automatically install all necessary libraries and modules. +Installing via PIP without an internet connection +---------------------------------------------- + +#. To get the ``.whl`` package file, contact you SQream support representative. + +#. Run the following command: + +.. code-block:: console + + tar -xf pysqream_connector_3.2.5.tar.gz + cd pysqream_connector_3.2.5 + #Install all packages with --no-index --find-links . + python3 -m pip install *.whl -U --no-index --find-links . + python3.9 -m pip install pysqream-3.2.5.zip -U --no-index --find-links . + python3.9 -m pip install pysqream-sqlalchemy-0.8.zip -U --no-index --find-links . + Upgrading an Existing Installation -------------------------------------- The Python drivers are updated periodically. To upgrade an existing pysqream installation, use pip's ``-U`` flag: .. code-block:: console - $ pip3 install pysqream pysqream-sqlalchemy -U + $ pip3.9 install pysqream pysqream-sqlalchemy -U Validating Your Installation ----------------------------- -This section describes how to validate your installation. - -**To validate your installation**: -1. Create a file called ``sample.py``, containing the following: +#. Create a file called ``sample.py``, containing the following: .. literalinclude:: sample.py :language: python :caption: pysqream Validation Script :linenos: -2. Verify that the parameters in the connection have been replaced with your respective SQream installation parameters. +#. Verify that the parameters in the connection have been replaced with your respective SQream installation parameters. :: -3. Run the sample file to verify that you can connect to SQream: +#. Run the sample file to verify that you can connect to SQream: .. code-block:: console - $ python sample.py - Version: v2020.1 + $ python3.9 sample.py + Version: v2020.1 If the validation was successful, you can build an application using the SQream Python connector. If you receive a connection error, verify the following: From 09c41b120c140acf53a8e55975c1a48a247ec6e6 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 16 Mar 2023 17:31:55 +0200 Subject: [PATCH 480/882] spark --- .../client_drivers/Spark/{spark.rst => index.rst} | 3 ++- connecting_to_sqream/client_drivers/index.rst | 4 +++- 2 files changed, 5 insertions(+), 2 deletions(-) rename connecting_to_sqream/client_drivers/Spark/{spark.rst => index.rst} (98%) diff --git a/connecting_to_sqream/client_drivers/Spark/spark.rst b/connecting_to_sqream/client_drivers/Spark/index.rst similarity index 98% rename from connecting_to_sqream/client_drivers/Spark/spark.rst rename to connecting_to_sqream/client_drivers/Spark/index.rst index 812cebd75..d8f583c39 100644 --- a/connecting_to_sqream/client_drivers/Spark/spark.rst +++ b/connecting_to_sqream/client_drivers/Spark/index.rst @@ -1,11 +1,12 @@ .. _spark: + ************************* Using Spark With SQream ************************* -Spark may be used for large-scale data processing. +The Spark connector enables reading and writing data to and from SQreamDB and may be used for large-scale data processing. .. contents:: diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index c02c37be7..87c356a36 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -4,6 +4,8 @@ Client Drivers ************** + + The guides on this page describe how to use the Sqream DB client drivers and client applications with SQream. Client Driver Downloads @@ -38,7 +40,7 @@ The following are applicable to all operating systems: * **Spark**: * `Spark Connector <>`_ - * :ref:`spark` + * :ref:`spark` .. _python: From 0d56aaf0cc2c7e91e3890d8c0c3df0d0e5488e30 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 16 Mar 2023 18:17:25 +0200 Subject: [PATCH 481/882] Python --- .../client_drivers/Spark/index.rst | 1 - connecting_to_sqream/client_drivers/index.rst | 3 +- .../client_drivers/python/index.rst | 60 +++++-------------- 3 files changed, 16 insertions(+), 48 deletions(-) diff --git a/connecting_to_sqream/client_drivers/Spark/index.rst b/connecting_to_sqream/client_drivers/Spark/index.rst index d8f583c39..5f3d6caac 100644 --- a/connecting_to_sqream/client_drivers/Spark/index.rst +++ b/connecting_to_sqream/client_drivers/Spark/index.rst @@ -1,6 +1,5 @@ .. _spark: - ************************* Using Spark With SQream ************************* diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index 87c356a36..fb302e3f0 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -4,8 +4,6 @@ Client Drivers ************** - - The guides on this page describe how to use the Sqream DB client drivers and client applications with SQream. Client Driver Downloads @@ -36,6 +34,7 @@ The following are applicable to all operating systems: * `Trino Connector <>`_ * :ref:`trino` +.. _spark: * **Spark**: diff --git a/connecting_to_sqream/client_drivers/python/index.rst b/connecting_to_sqream/client_drivers/python/index.rst index dfd3507ee..6de634cd8 100644 --- a/connecting_to_sqream/client_drivers/python/index.rst +++ b/connecting_to_sqream/client_drivers/python/index.rst @@ -4,7 +4,7 @@ Connecting to SQream Using Python (pysqream) ************************* -The Pysqream connector supports Python version 3.9 and newer. It includes a set of packages that allows Python programs to connect to SQream DB. The base ``pysqream`` package conforms to Python DB-API specifications `PEP-249 <https://www.python.org/dev/peps/pep-0249/>`_. +The current Pysqream connector supports Python version 3.9 and newer. It includes a set of packages that allows Python programs to connect to SQream DB. The base ``pysqream`` package conforms to Python DB-API specifications `PEP-249 <https://www.python.org/dev/peps/pep-0249/>`_. ``pysqream`` is a pure Python connector that can be installed with ``pip`` on any operating system, including Linux, Windows, and macOS. ``pysqream-sqlalchemy`` is a SQLAlchemy dialect for ``pysqream``. @@ -163,16 +163,9 @@ Standard Connection Example .. code-block:: python import sqlalchemy as sa - from sqlalchemy.engine.url import URL - - engine_url = URL('sqream' - , username='rhendricks' - , password='secret_passwor" - , host='localhost' - , port=5000 - , database='raviga' - , query={'use_ssl': False}) + engine_url = "sqream://rhendricks:secret_passwor@localhost:5000/raviga" + engine = sa.create_engine(engine_url) res = engine.execute('create or replace table test (ints int, ints2 int)') @@ -189,17 +182,10 @@ The following example is for using a ServerPicker: .. code-block:: python import sqlalchemy as sa - from sqlalchemy.engine.url import URL - - - engine_url = URL('sqream' - , username='dor' - , password='DorBerg123$' - , host='localhost' - , port=3108 - , database='pushlive') - - engine = sa.create_engine(engine_url,connect_args={"clustered": True}) + + engine_url = "sqream://dor:DorBerg123$@localhost:3108/pushlive" + + engine = sa.create_engine(engine_url, connect_args={"clustered": True}) res = engine.execute("create or replace table test100 (dor int);") res = engine.execute('insert into test100 values (5), (6);') @@ -216,20 +202,12 @@ The following example shows how to pull a table in Pandas. This examples uses th import sqlalchemy as sa import pandas as pd - from sqlalchemy.engine.url import URL - - engine_url = URL('sqream' - , username='rhendricks' - , password='secret_passwor" - , host='localhost' - , port=5000 - , database='raviga' - , query={'use_ssl': False}) + engine_url = "sqream://rhendricks:secret_passwor@localhost:5000/raviga" - engine = sa.create_engine(engine_url) - - table_df = pd.read_sql("select * from nba", con=engine) + engine = sa.create_engine(engine_url) + + table_df = pd.read_sql("select * from nba", con=engine) API Examples =============== @@ -421,20 +399,12 @@ This section shows how to use the ORM to create and populate tables from Python .. code-block:: python - import sqlalchemy as sa - import pandas as pd - from sqlalchemy.engine.url import URL - + import sqlalchemy as sa + import pandas as pd - engine_url = URL('sqream' - , username='rhendricks' - , password='secret_passwor" - , host='localhost' - , port=5000 - , database='raviga' - , query={'use_ssl': False}) + engine_url = "sqream://rhendricks:secret_passwor@localhost:5000/raviga" - engine = sa.create_engine(engine_url) + engine = sa.create_engine(engine_url) 2. Build a metadata object and bind it: From 78bba0d65967a99c75c1968732cc2100e051d5c9 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Sun, 19 Mar 2023 09:54:13 +0200 Subject: [PATCH 482/882] 4.2 RN --- releases/4.2.rst | 6 ++++-- releases/index.rst | 2 +- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/releases/4.2.rst b/releases/4.2.rst index d4768a0e2..94e524849 100644 --- a/releases/4.2.rst +++ b/releases/4.2.rst @@ -6,7 +6,7 @@ Release Notes 4.2 SQream is introducing a new version release system that follows the more commonly used Major.Minor.Patch versioning schema. The newly released **4.0 version** is a minor version upgrade and does not require considerable preparation. -The 4.2 release notes were released on xx/xx/2023 and describe the following: +The 4.2 release notes were released on 03/19/2023 and describe the following: .. contents:: :local: @@ -47,7 +47,9 @@ SQream Studio v5.5.4 has been released. Known Issues ------------ -:ref:`Percentile<percentile_disc>` is not supported for Window functions. +:ref:`Percentile<percentile_disc>` is not supported for :ref:`Window Functions<window_functions>`. + +Performance degradation when using ``VARCHAR`` partition key in a :ref:`Window Functions<window_functions>` expression. Version 4.2 resolved Issues diff --git a/releases/index.rst b/releases/index.rst index c12430d8a..63eca8c7f 100644 --- a/releases/index.rst +++ b/releases/index.rst @@ -13,7 +13,7 @@ Release Notes * - Version - Release Date * - :ref:`4.2` - - March xx, 2023 + - March 19, 2023 * - :ref:`4.1` - March 01, 2023 * - :ref:`4.0` From cc044d2172adf17343467a02a750f7fe875d83fe Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Sun, 19 Mar 2023 11:15:16 +0200 Subject: [PATCH 483/882] Update index.rst --- connecting_to_sqream/client_drivers/index.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index fb302e3f0..d9ed6d160 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -97,6 +97,7 @@ The following are applicable to Windows: nodejs/index odbc/index dotnet/index + Spark/index From 3cd9619b5b157f0bbae0f0ebf20f50e340493c8e Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Sun, 19 Mar 2023 11:38:10 +0200 Subject: [PATCH 484/882] Update 4.2.rst --- releases/4.2.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/releases/4.2.rst b/releases/4.2.rst index 94e524849..b795b2ec3 100644 --- a/releases/4.2.rst +++ b/releases/4.2.rst @@ -26,7 +26,7 @@ New Features Newly Released Connector Drivers -------------------------------- -Pysqream 3.2.4 - `.tar.gz file <https://github.com/SQream/pysqream/releases>`_ Supports Python 9(??) +Pysqream 3.2.4 - `.tar.gz file <https://github.com/SQream/pysqream/releases>`_ Supports Python 3.9 ODBC 4.4.4 :ref:`Getting the ODBC Driver<odbc>` @@ -49,7 +49,8 @@ Known Issues :ref:`Percentile<percentile_disc>` is not supported for :ref:`Window Functions<window_functions>`. -Performance degradation when using ``VARCHAR`` partition key in a :ref:`Window Functions<window_functions>` expression. +Performance degradation when using ``VARCHAR`` partition key in a :ref:`Window Functions<window_functions>` expression + Version 4.2 resolved Issues From 7a45fee70d699d3fba87caa085caca64e14641e9 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 21 Mar 2023 11:34:16 +0200 Subject: [PATCH 485/882] Update power.rst --- reference/sql/sql_functions/scalar_functions/numeric/power.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_functions/scalar_functions/numeric/power.rst b/reference/sql/sql_functions/scalar_functions/numeric/power.rst index 2653f5510..27184118d 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/power.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/power.rst @@ -66,7 +66,7 @@ On floating point .. code-block:: psql - numbers=> SELECT POWER(3.0,x) FROM (VALUES (1), (2), (3), (4), (5)) AS t(x); + numbers=> SELECT POWER(3.0::double precision,x) FROM (VALUES (1), (2), (3), (4), (5)) AS t(x); power ----- 3.0 From 9b97e568ffa60e89719b7f4eebe499656116de24 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 21 Mar 2023 12:35:09 +0200 Subject: [PATCH 486/882] Update installing_sqream_with_binary.rst --- installation_guides/installing_sqream_with_binary.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/installation_guides/installing_sqream_with_binary.rst b/installation_guides/installing_sqream_with_binary.rst index 6a21ee29f..613b4b9fc 100644 --- a/installation_guides/installing_sqream_with_binary.rst +++ b/installation_guides/installing_sqream_with_binary.rst @@ -192,13 +192,14 @@ For an example of stopping actively running SQream services, see :ref:`Launching $ sudo netstat -nltp #to make sure sqream stopped listening on 500X, 510X and 310X ports. -3. Replace the old version ``sqream-db-v2020.2``, with the new version ``sqream-db-v2021.1``: +3. Replace the old version ``sqream-db-v2021.1``, with the new version ``sqream-db-v2021.1``: .. code-block:: console $ cd /home/sqream $ mkdir tempfolder $ mv sqream-db-v2021.1.tar.gz tempfolder/ + $ cd tempfolder/ $ tar -xf sqream-db-v2021.1.tar.gz $ sudo mv sqream /usr/local/sqream-db-v2021.1 $ cd /usr/local From e490c0c27522c531d40b46be861a9c27e95ce9b2 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 21 Mar 2023 14:08:23 +0200 Subject: [PATCH 487/882] Update keywords_and_identifiers.rst --- .../sql_syntax/keywords_and_identifiers.rst | 30 ++++++++++--------- 1 file changed, 16 insertions(+), 14 deletions(-) diff --git a/reference/sql/sql_syntax/keywords_and_identifiers.rst b/reference/sql/sql_syntax/keywords_and_identifiers.rst index bc2cb1de6..598b12a17 100644 --- a/reference/sql/sql_syntax/keywords_and_identifiers.rst +++ b/reference/sql/sql_syntax/keywords_and_identifiers.rst @@ -44,29 +44,31 @@ The following table shows a full list of the reserved keywords: +-------------------+---------------------+--------------------+------------------+---------------+ | ``AS`` | ``DESC`` | ``INTERSECT`` | ``OPTION`` | ``TRAILING`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``ASC`` | ``DISTINCT`` | ``INTO`` | ``OR`` | ``TRUE`` | +| ``ASC`` | ``DISTINCT`` | ``INTO`` | ``OR`` | ``TRAN`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``AUTHORIZATION`` | ``DO`` | ``IS`` | ``ORDER`` | ``UNION`` | +| ``AUTHORIZATION`` | ``DO`` | ``IS`` | ``ORDER`` | ``TRUE`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``BINARY`` | ``ELSE`` | ``ISNULL`` | ``OUTER`` | ``UNIQUE`` | +| ``BINARY`` | ``ELSE`` | ``ISNULL`` | ``OUTER`` | ``UNION`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``BOTH`` | ``END`` | ``JOIN`` | ``OVER`` | ``USER`` | +| ``BIGINT`` | ``END`` | ``JOIN`` | ``OVER`` | ``UNIQUE`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``CASE`` | ``EXCEPT`` | ``LEADING`` | ``OVERLAPS`` | ``USING`` | +| ``BOTH`` | ``EXCEPT`` | ``LEADING`` | ``OVERLAPS`` | ``USER`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``CAST`` | ``FALSE`` | ``LEFT`` | ``PLACING`` | ``VARIADIC`` | +| ``CASE`` | ``FALSE`` | ``LEFT`` | ``PLACING`` | ``USING`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``CHECK`` | ``FETCH`` | ``LIKE`` | ``PRIMARY`` | ``VERBOSE`` | +| ``CAST`` | ``FETCH`` | ``LIKE`` | ``PRIMARY`` | ``VARIADIC`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``COLLATE`` | ``FOR`` | ``LIMIT`` | ``REFERENCES`` | ``WHEN`` | +| ``CHECK`` | ``FOR`` | ``LIMIT`` | ``REFERENCES`` | ``VERBOSE`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``COLUMN`` | ``FREEZE`` | ``LOCALTIME`` | ``RETURNING`` | ``WHERE`` | +| ``COLLATE`` | ``FREEZE`` | ``LOCALTIME`` | ``RETURNING`` | ``WHEN`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``CONCURRENTLY`` | ``FROM`` | ``LOCALTIMESTAMP`` | ``RIGHT`` | ``WINDOW`` | +| ``COLUMN`` | ``FROM`` | ``LOCALTIMESTAMP`` | ``RIGHT`` | ``WHERE`` | +-------------------+---------------------+--------------------+------------------+---------------+ -| ``CONSTRAINT`` | ``FULL`` | ``LOOP`` | ``RLIKE`` | ``WITH`` | +| ``CONCURRENTLY`` | ``FULL`` | ``LOOP`` | ``RLIKE`` | ``WINDOW`` | ++-------------------+---------------------+--------------------+------------------+---------------+ +| ``CONSTRAINT`` | ``FUNCTION`` | ``MERGE`` | ``SELECT`` | ``WITH`` | +-------------------+---------------------+--------------------+------------------+ | -| ``CREATE`` | ``GRANT`` | ``MERGE`` | ``SELECT`` | | -+-------------------+---------------------+--------------------+------------------+ | -| ``CROSS`` | ``GROUP`` | ``NATURAL`` | ``SESSION_USER`` | | +| ``CREATE`` | ``GRANT`` | ``NATURAL`` | ``SESSION_USER`` | | ++-------------------+---------------------+--------------------+------------------+ | +| ``CROSS`` | ``GROUP`` | | | | +-------------------+---------------------+--------------------+------------------+---------------+ From d8567f4159bac827fab50199fbb50d33f0e007d1 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 21 Mar 2023 15:52:08 +0200 Subject: [PATCH 488/882] Update index.rst --- .../client_drivers/python/index.rst | 27 ------------------- 1 file changed, 27 deletions(-) diff --git a/connecting_to_sqream/client_drivers/python/index.rst b/connecting_to_sqream/client_drivers/python/index.rst index 6de634cd8..7db435a3b 100644 --- a/connecting_to_sqream/client_drivers/python/index.rst +++ b/connecting_to_sqream/client_drivers/python/index.rst @@ -117,34 +117,7 @@ The Python drivers are updated periodically. To upgrade an existing pysqream ins $ pip3.9 install pysqream pysqream-sqlalchemy -U -Validating Your Installation ------------------------------ -#. Create a file called ``sample.py``, containing the following: - -.. literalinclude:: sample.py - :language: python - :caption: pysqream Validation Script - :linenos: - -#. Verify that the parameters in the connection have been replaced with your respective SQream installation parameters. - - :: - -#. Run the sample file to verify that you can connect to SQream: - - .. code-block:: console - - $ python3.9 sample.py - Version: v2020.1 - - If the validation was successful, you can build an application using the SQream Python connector. If you receive a connection error, verify the following: - - * You have access to a running SQream database. - - :: - - * The connection parameters are correct. SQLAlchemy Examples ======================== From 7e1b4cfe92543cc5da7512b9d0ecbe1c9291200b Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 21 Mar 2023 15:54:50 +0200 Subject: [PATCH 489/882] Update index.rst --- connecting_to_sqream/client_drivers/index.rst | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index d9ed6d160..662e6fc4b 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -45,7 +45,7 @@ The following are applicable to all operating systems: * **Python** - Recommended installation via ``pip``: - * `Python .tar file <https://github.com/SQream/pysqream/releases/tag/v3.2.4>`_ - pysqream v3.2.4 (.tar.gz) + * `Python .tar file <https://github.com/SQream/pysqream/releases/tag/v3.2.5>`_ - pysqream v3.2.5 (.tar.gz) * :ref:`pysqream` .. _nodejs: @@ -97,8 +97,7 @@ The following are applicable to Windows: nodejs/index odbc/index dotnet/index - Spark/index - + spark/index From f5700a3ca2e3d3f724608b6cb9debd80c210c1f3 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 21 Mar 2023 17:41:42 +0200 Subject: [PATCH 490/882] Update 4.2.rst --- releases/4.2.rst | 19 +++++++++++-------- 1 file changed, 11 insertions(+), 8 deletions(-) diff --git a/releases/4.2.rst b/releases/4.2.rst index b795b2ec3..f0f357775 100644 --- a/releases/4.2.rst +++ b/releases/4.2.rst @@ -26,11 +26,17 @@ New Features Newly Released Connector Drivers -------------------------------- -Pysqream 3.2.4 - `.tar.gz file <https://github.com/SQream/pysqream/releases>`_ Supports Python 3.9 +► Pysqream 3.2.5 + * Supports Python version 3.9 and newer + * `.tar.gz file <`Python .tar file <https://github.com/SQream/pysqream/releases/tag/v3.2.5>`_ + * :ref:`Documentation<pysqream>` -ODBC 4.4.4 :ref:`Getting the ODBC Driver<odbc>` +► ODBC 4.4.4 + * :ref:`Getting the ODBC Driver<odbc>` -JDBC 4.5.8 `.jar file <https://sq-ftp-public.s3.amazonaws.com/sqream-jdbc-4.5.8.jar>`_ +► JDBC 4.5.8 + * `.jar file <https://sq-ftp-public.s3.amazonaws.com/sqream-jdbc-4.5.8.jar>`_ + * :ref:`Documentation<java_jdbc>` Storage Version --------------- @@ -47,9 +53,9 @@ SQream Studio v5.5.4 has been released. Known Issues ------------ -:ref:`Percentile<percentile_disc>` is not supported for :ref:`Window Functions<window_functions>`. +* :ref:`Percentile<percentile_disc>` is not supported for :ref:`Window Functions<window_functions>`. -Performance degradation when using ``VARCHAR`` partition key in a :ref:`Window Functions<window_functions>` expression +* Performance degradation when using ``VARCHAR`` partition key in a :ref:`Window Functions<window_functions>` expression @@ -89,7 +95,6 @@ Due to Parquet's lack of support of the ``INT96`` data type, SQream has decided The ``[]``, which are frequently used to delimit :ref:`identifiers<keywords_and_identifiers>` such as column names, table names, and other database objects, will soon be deprecated to facilitate the use of the ``ARRAY`` data type. * Support in ``[]`` for delimiting database object identifiers ends on June 1st, 2023. - * To delimit database object identifiers, you will be able to use double quotes ``""``. @@ -98,9 +103,7 @@ The ``[]``, which are frequently used to delimit :ref:`identifiers<keywords_and_ The ``VARCHAR`` data type is deprecated to improve the core functionalities of the platform and to align with the constantly evolving ecosystem requirements. * Support in the ``VARCHAR`` data type ends at September 30th, 2023. - * ``VARCHAR`` is no longer supported for new customers, effective from Version 2022.1.3. - * The ``TEXT`` data type is replacing the ``VARCHAR`` and ``NVARCHAR`` data types. From a6de4c4eae75cb6fef2dd9fa08ee0abf70dbffec Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 21 Mar 2023 17:43:55 +0200 Subject: [PATCH 491/882] Update 4.2.rst --- releases/4.2.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/4.2.rst b/releases/4.2.rst index f0f357775..457422739 100644 --- a/releases/4.2.rst +++ b/releases/4.2.rst @@ -28,7 +28,7 @@ Newly Released Connector Drivers ► Pysqream 3.2.5 * Supports Python version 3.9 and newer - * `.tar.gz file <`Python .tar file <https://github.com/SQream/pysqream/releases/tag/v3.2.5>`_ + * `.tar file <https://github.com/SQream/pysqream/releases/tag/v3.2.5>`_ * :ref:`Documentation<pysqream>` ► ODBC 4.4.4 From 2c0e604d3205825d47e91c879073c95b683fec59 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 23 Mar 2023 09:41:37 +0200 Subject: [PATCH 492/882] Update power.rst --- reference/sql/sql_functions/scalar_functions/numeric/power.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_functions/scalar_functions/numeric/power.rst b/reference/sql/sql_functions/scalar_functions/numeric/power.rst index 27184118d..66d379c62 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/power.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/power.rst @@ -66,7 +66,7 @@ On floating point .. code-block:: psql - numbers=> SELECT POWER(3.0::double precision,x) FROM (VALUES (1), (2), (3), (4), (5)) AS t(x); + numbers=> SELECT POWER(3.0::double,x) FROM (VALUES (1), (2), (3), (4), (5)) AS t(x); power ----- 3.0 From ebb6c317f227d8b314c3322b3a5b94f4d26eeeac Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 23 Mar 2023 11:51:28 +0200 Subject: [PATCH 493/882] Update sign.rst --- .../scalar_functions/numeric/sign.rst | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/numeric/sign.rst b/reference/sql/sql_functions/scalar_functions/numeric/sign.rst index 1fc32d1b7..db2ff7547 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/sign.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/sign.rst @@ -4,7 +4,7 @@ SIGN ************************** -The SIGN function takes a single argument, which can be any numeric data type such as INTEGER, FLOAT, or DECIMAL. The function returns an integer value of -1, 0, or 1, depending on the sign of the input expression. +The ``SIGN`` function takes a single argument, which can be any numeric data type such as INTEGER, FLOAT, or DECIMAL, and returns an ``INT`` value of -1, 0, or 1, depending on the sign of the input argument. @@ -13,7 +13,7 @@ Syntax .. code-block:: postgres - SELECT SIGN (); + SELECT SIGN(expr); Arguments ========= @@ -27,14 +27,18 @@ Arguments * - ``numeric_expression`` - Numeric data types -Returns -============ +Return +====== +Returns an output of the same data type as the input data type. -* -1 if the input expression is negative +Depending on the sign of the input argument, the return is: -* 0 if the input expression is zero +* -1, if the input expression is negative -* 1 if the input expression is positive +* 0, if the input expression is zero + +* 1, if the input expression is positive + Example From 47fb2564f84471bd830a2354b156440f245b035a Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 23 Mar 2023 11:58:49 +0200 Subject: [PATCH 494/882] Update joins.rst --- reference/sql/sql_syntax/joins.rst | 5 ----- 1 file changed, 5 deletions(-) diff --git a/reference/sql/sql_syntax/joins.rst b/reference/sql/sql_syntax/joins.rst index b12b08875..b9d04c589 100644 --- a/reference/sql/sql_syntax/joins.rst +++ b/reference/sql/sql_syntax/joins.rst @@ -47,7 +47,6 @@ The following shows the correct syntax for creating an **inner join**: .. code-block:: postgres left_side [ INNER ] JOIN left_side ON value_expr - left_side [ INNER ] JOIN left_side USING ( join_column [, ... ] ) Inner joins are the default join type and return rows from the ``left_side`` and ``right_side`` based on a matching condition. @@ -77,7 +76,6 @@ The following shows the correct syntax for creating an **left outer join**: .. code-block:: postgres left_side LEFT [ OUTER ] JOIN right_side ON value_expr - left_side LEFT [ OUTER ] JOIN right_side USING ( join_column [, ... ] ) Left outer joins are similar to inner joins, except that for every ``left_side`` row without a matching condition, a ``NULL`` value is returned for the corresponding ``right_side`` column. @@ -93,7 +91,6 @@ The following shows the correct syntax for creating an **right outer join**: .. code-block:: postgres left_side RIGHT [ OUTER ] JOIN right_side ON value_expr - left_side RIGHT [ OUTER ] JOIN right_side USING ( join_column [, ... ] ) Right outer joins are similar to inner joins, except that for every ``right_side`` row without a matching condition, a ``NULL`` value is returned for the corresponding ``left_side`` column. @@ -161,8 +158,6 @@ For example, the following is displayed when two name columns match: The ``ON`` clause is optional for ``LEFT`` and ``RIGHT`` joins. However, excluding it results in a computationally intensive cross join. -.. tip:: SQream DB does not support the ``USING`` syntax. However, queries can be easily rewritten. ``left_side JOIN right_side using (name)`` is equivalent to ``ON left_side.name = right_side.name`` - Join Type Examples From 898ae7c0b0c05e8ebb91e903835912dae60388ac Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 23 Mar 2023 15:43:38 +0200 Subject: [PATCH 495/882] Update installing_sqream_with_binary.rst --- installation_guides/installing_sqream_with_binary.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/installation_guides/installing_sqream_with_binary.rst b/installation_guides/installing_sqream_with_binary.rst index 613b4b9fc..bb26a8180 100644 --- a/installation_guides/installing_sqream_with_binary.rst +++ b/installation_guides/installing_sqream_with_binary.rst @@ -199,7 +199,7 @@ For an example of stopping actively running SQream services, see :ref:`Launching $ cd /home/sqream $ mkdir tempfolder $ mv sqream-db-v2021.1.tar.gz tempfolder/ - $ cd tempfolder/ + $ cd tempfolder/ $ tar -xf sqream-db-v2021.1.tar.gz $ sudo mv sqream /usr/local/sqream-db-v2021.1 $ cd /usr/local From 7e33349d32e15b337673d19e01a58d44a20351fd Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 23 Mar 2023 16:25:55 +0200 Subject: [PATCH 496/882] Update update.rst --- .../sql_statements/dml_commands/update.rst | 20 ------------------- 1 file changed, 20 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/update.rst b/reference/sql/sql_statements/dml_commands/update.rst index 9f1d321b9..07718fc7a 100644 --- a/reference/sql/sql_statements/dml_commands/update.rst +++ b/reference/sql/sql_statements/dml_commands/update.rst @@ -144,27 +144,7 @@ The following shows an example of updating tables that contain multi-table expre ELSE 1 END FROM countries c - -Configuring Update Behavior ------------------ -The ``failOnNondeterministicUpdate`` flag is used to configure ``UPDATE`` behavior when updating tables containing multi-table expressions. This flag is needed when you use the ``FROM`` clause along with a set expression containing columns from additional tables. Doing this can cause a match to occur between a row from the target table with multiple rows from the additional tables. - -For instance, the example in the previous section sets the records sold to ``2`` when the country name is Israel. If you were to insert a new entry into this table with Israel spelled in Hebrew (using the same country ID), you would have two rows with identical country ID's. - -When this happens, both rows 5 and 6 in the ``bands`` table match both Israel entries. Because no algorithm exists for determining which entry to use, updating this table may either increase ``records_sold`` by 2 (for Israel in English) or 1 (for Israel in Hebrew). - -You must set the ``failOnNondeterministicUpdate`` flag to ``FALSE`` to prevent an error from occuring. - -Note that a similar ambiguity can occur when the Hebrew spelling is used in the following example: -.. code-block:: postgres - - UPDATE bands - SET record_count = record_count + 1 - FROM countries c - WHERE c.name = 'Israel' - -However, the ``WHERE`` clause above prevents a match with any entry other than the defined one. Because the target table row must match with the ``WHERE`` condition at least once to be included in the UPDATE statment, this scenario does not require configuring the ``failOnNondeterministicUpdate`` flag. Triggering a Clean-Up --------------------------------------- From 85610864dbe42fb261c93f6401a7c514ac1b22a3 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 23 Mar 2023 16:26:42 +0200 Subject: [PATCH 497/882] Update update.rst --- reference/sql/sql_statements/dml_commands/update.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/update.rst b/reference/sql/sql_statements/dml_commands/update.rst index 07718fc7a..3fa78a1a2 100644 --- a/reference/sql/sql_statements/dml_commands/update.rst +++ b/reference/sql/sql_statements/dml_commands/update.rst @@ -35,10 +35,10 @@ The following is the correct syntax for the ``UPDATE`` command: .. code-block:: postgres - UPDATE target_table_name [[AS] alias1] - SET column_name = expression [,...] - [FROM additional_table_name [[AS] alias2][,...]] - [WHERE condition] + UPDATE target_table_name [[AS] alias1] + SET column_name = expression [,...] + [FROM additional_table_name [[AS] alias2][,...]] + [WHERE condition] The following is the correct syntax for triggering a clean-up: From 101bbc228a2d6170611dc7d90672b01375800880 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 28 Mar 2023 09:43:49 +0300 Subject: [PATCH 498/882] Update update.rst --- .../sql_statements/dml_commands/update.rst | 138 ++++++++++-------- 1 file changed, 79 insertions(+), 59 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/update.rst b/reference/sql/sql_statements/dml_commands/update.rst index 3fa78a1a2..6ead55166 100644 --- a/reference/sql/sql_statements/dml_commands/update.rst +++ b/reference/sql/sql_statements/dml_commands/update.rst @@ -40,12 +40,7 @@ The following is the correct syntax for the ``UPDATE`` command: [FROM additional_table_name [[AS] alias2][,...]] [WHERE condition] -The following is the correct syntax for triggering a clean-up: -.. code-block:: postgres - - SELECT cleanup_chunks('schema_name','table_name'); - SELECT cleanup_extents('schema_name','table_name'); Parameters ============ @@ -65,12 +60,57 @@ The following table describes the ``UPDATE`` parameters: - Additional tables used in the WHERE condition for performing complex joins. * - ``condition`` - Specifies the condition for updating the data. - -.. note:: Similar to a DELETE statement, an UPDATE statement may leave some uncleaned data behind, which requires a cleanup operation. Examples =========== -The **Examples** section includes the following examples: + +The examples section shows how to modify the value of certain columns in existing rows without creating a table. + +To be able to follow the examples, create these two tables: + +**countries** + ++----+--------+--------------+ +| id | name | records_sold | ++====+========+==============+ +| 1 | Israel | null | ++----+--------+--------------+ +| 2 | UK | null | ++----+--------+--------------+ +| 3 | USA | null | ++----+--------+--------------+ +| 4 | Sweden | null | ++----+--------+--------------+ + +**bands** + ++----+-------------+------------+ +| id | name | country_id | ++====+=============+============+ +| 1 | The Beatles | 2 | ++----+-------------+------------+ +| 2 | The Ramones | 3 | ++----+-------------+------------+ +| 3 | ABBA | 4 | ++----+-------------+------------+ +| 4 | Ace of Base | 4 | ++----+-------------+------------+ + +.. code-block:: postgres + + create or replace table countries ( id int, name text, records_sold int); + insert into countries values (1, 'Israel', null); + insert into countries values (2, 'UK', null); + insert into countries values (3, 'USA', null); + insert into countries values (4, 'Sweden', null); + + create or replace table bands ( id int, name text, country_id int); + insert into bands values (1, 'The Beatles', 2); + insert into bands values (2, 'The Ramones', 3); + insert into bands values (3, 'ABBA', 4); + insert into bands values (4, 'Ace of Base', 4); + + .. contents:: :local: @@ -78,27 +118,17 @@ The **Examples** section includes the following examples: Updating an Entire Table ----------------- -The Examples section shows how to modify the value of certain columns in existing rows without creating a table. The examples are based on the following tables: - -.. image:: /_static/images/delete_optimization.png -The following methods for updating an entire table generate the same output, and result with the ``bands`` record set to ``NULL``: +Two different ``UPDATE`` methods for updating an entire table. .. code-block:: postgres - UPDATE bands SET records_sold = 0; + UPDATE countries SET records_sold = 0; .. code-block:: postgres - UPDATE bands SET records_sold = 0 WHERE true; - -.. code-block:: postgres + UPDATE countries SET records_sold = 0 WHERE true; - UPDATE bands SET records_sold = 0 USING countries; - -.. code-block:: postgres - - UPDATE bands SET records_sold = 0 USING countries WHERE 1=1; Performing Simple Updates ----------------- @@ -106,7 +136,7 @@ The following is an example of performing a simple update: .. code-block:: postgres - UPDATE bands SET records_sold = records_sold + 1 WHERE name LIKE 'The %'; + UPDATE countries SET records_sold = records_sold + 1 WHERE name = 'Israel'; Updating Tables that Contain Multi-Table Conditions ----------------- @@ -114,61 +144,51 @@ The following shows an example of updating tables that contain multi-table condi .. code-block:: postgres - UPDATE bands - SET records_sold = records_sold + 1 - WHERE EXISTS ( - SELECT 1 FROM countries - WHERE countries.id=bands.country_id - AND country.name = 'Sweden' - ); - -You can also write the statement above using the FROM clause: + UPDATE countries + SET records_sold = records_sold + 1 + WHERE EXISTS ( + SELECT 1 FROM bands + WHERE bands.country_id = countries.id + AND bands.name = 'ABBA' + ); -.. code-block:: psql - - UPDATE bands - SET records_sold = records_sold + 1 - FROM countries - WHERE countries.id=bands.country_id AND country.name = 'Sweden'; Updating Tables that Contain Multi-Table Expressions ------------------ +---------------------------------------------------- The following shows an example of updating tables that contain multi-table expressions: .. code-block:: postgres - UPDATE bands - SET records_sold = records_sold + - CASE - WHEN c.name = 'Israel' THEN 2 - ELSE 1 - END - FROM countries c - + UPDATE countries + SET records_sold = records_sold + + CASE + WHEN name = 'Israel' THEN 2 + ELSE 1 + END + FROM countries c + ; + +Triggering a Cleanup +--------------------- -Triggering a Clean-Up ---------------------------------------- -The following shows an example of triggering a clean-up: +When an ``UPDATE`` statement is executed, it creates a new table that contains the updated data, while the original table remains intact. As a result, residual data may be left behind, and a cleanup operation is necessary to ensure the database remains in a consistent state. -.. code-block:: psql + +The following is the syntax for triggering a cleanup: - SELECT * FROM sqream_catalog.discarded_chunks; - SELECT cleanup_discarded_chunks('public','t'); +.. code-block:: postgres -The following is an example of the output generated from the above: + SELECT cleanup_chunks('schema_name','table_name'); + SELECT cleanup_extents('schema_name','table_name'); -* **database_name** - _discarded_master -* **table_id** - 24 -* **column_id** - 1 -* **extent_ID** - 0 Permissions -============= +=========== Executing an ``UPDATE`` statement requires the following permissions: * Both ``UPDATE`` and ``SELECT`` permissions on the target table. * The ``SELECT`` permission for each additional table you reference in the statement (in ither the ``FROM`` clause or ``WHERE`` subquery section). Locking and Concurrency -============= +======================= Executing the ``UPDATE`` statement obtains an exclusive UPDATE lock on the target table, but does not lock the destination tables. \ No newline at end of file From ba4ff2b52d0600b1173547a1f7833865294bd5c5 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 28 Mar 2023 09:46:03 +0300 Subject: [PATCH 499/882] Update update.rst --- reference/sql/sql_statements/dml_commands/update.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/dml_commands/update.rst b/reference/sql/sql_statements/dml_commands/update.rst index 6ead55166..3bbeceeef 100644 --- a/reference/sql/sql_statements/dml_commands/update.rst +++ b/reference/sql/sql_statements/dml_commands/update.rst @@ -187,7 +187,7 @@ Permissions Executing an ``UPDATE`` statement requires the following permissions: * Both ``UPDATE`` and ``SELECT`` permissions on the target table. -* The ``SELECT`` permission for each additional table you reference in the statement (in ither the ``FROM`` clause or ``WHERE`` subquery section). +* The ``SELECT`` permission for each additional table you reference in the statement (in either the ``FROM`` clause or ``WHERE`` subquery section). Locking and Concurrency ======================= From 6c28dcfcf5d30e12a0372e27f410d3be17e7d099 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 3 Apr 2023 13:55:19 +0300 Subject: [PATCH 500/882] Update converting_and_casting_types.rst --- data_type_guides/converting_and_casting_types.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data_type_guides/converting_and_casting_types.rst b/data_type_guides/converting_and_casting_types.rst index 25e150881..349d4c04d 100644 --- a/data_type_guides/converting_and_casting_types.rst +++ b/data_type_guides/converting_and_casting_types.rst @@ -15,7 +15,7 @@ You can rectify this by casting the value to a larger data type, as shown below: SQream supports the following three data conversion types: -* ``CAST(<value> TO <data type>)``, to convert a value from one type to another. For example, ``CAST('1997-01-01' TO DATE)``, ``CAST(3.45 TO SMALLINT)``, ``CAST(some_column TO TEXT)``. +* ``CAST(<value> AS <data type>)``, to convert a value from one type to another. For example, ``CAST('1997-01-01' AS DATE)``, ``CAST(3.45 AS SMALLINT)``, ``CAST(some_column AS TEXT)``. :: From aae27fa8d616cd5552c1b89ac3c41e47f81ec1c6 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 3 Apr 2023 17:46:34 +0300 Subject: [PATCH 501/882] Update copy_to.rst --- reference/sql/sql_statements/dml_commands/copy_to.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/copy_to.rst b/reference/sql/sql_statements/dml_commands/copy_to.rst index 167f70c23..00264f50d 100644 --- a/reference/sql/sql_statements/dml_commands/copy_to.rst +++ b/reference/sql/sql_statements/dml_commands/copy_to.rst @@ -140,9 +140,9 @@ The following table shows the supported printable ASCII characters: +---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ | ) | Right Parenthesis | 41 | 51 | 29 | 101001 | &#41; | &rpar; | +---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ -| * | Asterisk | 42 | 52 | 2A | 101010 | &#42; | &ast; | +| \*\ | Asterisk | 42 | 52 | 2A | 101010 | &#42; | &ast; | +---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ -| + | Plus Sign | 43 | 53 | 2B | 101011 | &#43; | &plus; | +| \+\ | Plus Sign | 43 | 53 | 2B | 101011 | &#43; | &plus; | +---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ | , | Comma | 44 | 54 | 2C | 101100 | &#44; | &comma; | +---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ @@ -162,7 +162,7 @@ The following table shows the supported printable ASCII characters: +---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ | [ | Left Square Bracket | 91 | 133 | 5B | 1011011 | &#91; | &lsqb; | +---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ -| \ | Backslash | 92 | 134 | 5C | 1011100 | \&\#92\; | &bsol; | +| \\ | Backslash | 92 | 134 | 5C | 1011100 | \&\#92\; | &bsol; | +---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ | ] | Right Square Bracket | 93 | 135 | 5D | 1011101 | &#93; | &rsqb; | +---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ @@ -174,7 +174,7 @@ The following table shows the supported printable ASCII characters: +---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ | { | Left Curly Bracket | 123 | 173 | 7B | 1111011 | &#123; | &lcub; | +---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ -| | | Vertical Bar | 124 | 174 | 7C | 1111100 | &#124; | &verbar; | +| \|\ | Vertical Bar | 124 | 174 | 7C | 1111100 | &#124; | &verbar; | +---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ | } | Right Curly Bracket | 125 | 175 | 7D | 1111101 | &#125; | &rcub; | +---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ @@ -270,7 +270,7 @@ The following table shows the unsupported ASCII field delimiters: +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ | 34 | " | Double Quote | 42 | 22 | 100010 | &#34; | &quot; | +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 45 | - | Minus Sign | 55 | 2D | 101101 | &#45; | &minus; | +| 45 | \-\ | Minus Sign | 55 | 2D | 101101 | &#45; | &minus; | +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ | 46 | . | Period | 56 | 2E | 101110 | &#46; | &period; | +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ From 58d86291ad440e7635c349d89ab8f2dcb1513cc8 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 10 Apr 2023 13:08:49 +0300 Subject: [PATCH 502/882] Update not.rst --- .../scalar_functions/bitwise/not.rst | 32 ++++++++----------- 1 file changed, 13 insertions(+), 19 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/bitwise/not.rst b/reference/sql/sql_functions/scalar_functions/bitwise/not.rst index 20bf60f02..a45495657 100644 --- a/reference/sql/sql_functions/scalar_functions/bitwise/not.rst +++ b/reference/sql/sql_functions/scalar_functions/bitwise/not.rst @@ -1,10 +1,10 @@ .. _bitwise_not: *************************** -``~`` (bitwise ``NOT``) +``~`` (bitwise NOT) *************************** -Returns the bitwise ``NOT`` (negation) of two numeric expressions. This is the bitwise complement. +The bitwise NOT operator (``~``) is a unary operator used to invert the bits of a binary value. It converts each 0 to a 1 and each 1 to a 0, resulting in the ones' complement of the original value. Syntax ========== @@ -32,12 +32,12 @@ Arguments Returns ============ -Returns an integer that is the bitwise ``NOT`` of the input. +Returns an integer that is the bitwise ``NOT`` of the input and preserves the data type of the argument supplied. Notes ======= -* If the value is NULL, the result is NULL. +* If the value is ``NULL``, the result is ``NULL``. Examples =========== @@ -56,21 +56,15 @@ Examples .. code-block:: psql - master=> CREATE TABLE bit(b1 int, b2 int, b3 int); - executed - - master=> INSERT INTO bit VALUES (1,2,3), (2, 4, 6), (4, 2, 6), (2, 8, 16), (null, null, 64), (5, 3, 1), (6, 1, 0); - executed + + master=> CREATE OR REPLACE TABLE t (xtinyInt tinyInt, xsmallInt smallInt, xint int, xbigInt bigInt); + + master=> INSERT INTO t VALUES (1,1,1,1); + + master=> SELECT ~xtinyInt, ~xsmallInt, ~xint, ~xbigInt from t; - SELECT b1, b2, b3, ~b1, ~b2, ~b3 FROM bit; - b1 | b2 | b3 | ?column? | ?column?0 | ?column?1 - ---+----+----+----------+-----------+---------- - 1 | 2 | 3 | -2 | -3 | -4 - 2 | 4 | 6 | -3 | -5 | -7 - 4 | 2 | 6 | -5 | -3 | -7 - 2 | 8 | 16 | -3 | -9 | -17 - | | 64 | | | -65 - 5 | 3 | 1 | -6 | -4 | -2 - 6 | 1 | 0 | -7 | -2 | -1 + ?column? | ?column?0 | ?column?1 | ?column?2 | + ---------+-----------+-----------+-----------+ + 254 | -2 | -2 | -2 | From a8c63278e9821087b614b4d370ccf6c2102813f9 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 10 Apr 2023 13:15:10 +0300 Subject: [PATCH 503/882] Update charindex.rst --- .../sql/sql_functions/scalar_functions/string/charindex.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/string/charindex.rst b/reference/sql/sql_functions/scalar_functions/string/charindex.rst index 3ad4ca1f3..9b00084f5 100644 --- a/reference/sql/sql_functions/scalar_functions/string/charindex.rst +++ b/reference/sql/sql_functions/scalar_functions/string/charindex.rst @@ -29,7 +29,7 @@ Arguments * - ``haystack_string_expr`` - String to search within * - ``start_location`` - - An integer at which the search starts. This value is optinoal and when not supplied, the search starts at the beggining of ``needle_string_expr`` + - An integer at which the search starts. This value is optional and when not supplied, the search starts at the beggining of ``needle_string_expr`` Returns ============ @@ -73,4 +73,4 @@ Using ``CHARINDEX`` "Beware the Jabberwock, my son! | 9 The jaws that bite, the claws that catch! | 27 Beware the Jubjub bird, and shun | 8 - The frumious Bandersnatch!" | 0 \ No newline at end of file + The frumious Bandersnatch!" | 0 From 0d120ad606400f9a3a72663e0b519b7412b3dde3 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 11 Apr 2023 09:59:29 +0300 Subject: [PATCH 504/882] Update len.rst --- .../scalar_functions/string/len.rst | 16 +++++++--------- 1 file changed, 7 insertions(+), 9 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/string/len.rst b/reference/sql/sql_functions/scalar_functions/string/len.rst index fdd671423..2dee61a61 100644 --- a/reference/sql/sql_functions/scalar_functions/string/len.rst +++ b/reference/sql/sql_functions/scalar_functions/string/len.rst @@ -4,13 +4,13 @@ LEN ************************** -Calculates the number of characters in a string. +The LEN function calculates the number of characters in a string. Keep in mind that SQream DB does not count trailing spaces, but does count leading spaces. For UTF-8 encoded ``TEXT`` strings, multi-byte characters are counted as a single character. To get the length in bytes, see :ref:`octet_length`. To get the length in characters, see :ref:`char_length`. + .. note:: - - * This function is provided for SQL Server compatability. - - * For UTF-8 encoded ``TEXT`` strings, multi-byte characters are counted as a single character. To get the length in bytes, see :ref:`octet_length`. To get the length in characters, see :ref:`char_length`. + + This function is provided for SQL Server compatibility. + Syntax ========== @@ -35,12 +35,12 @@ Arguments Returns ============ -Returns an integer containing the number of characters in the string. +The LEN function returns an integer value representing the length of the input string, which includes any leading spaces but excludes any trailing spaces. Notes ======= -* If the value is NULL, the result is NULL. +* If the value is ``NULL``, the result is ``NULL``. Examples =========== @@ -81,8 +81,6 @@ ASCII characters take up 1 byte per character, while Thai takes up 3 bytes and H Length of an ASCII string ---------------------------- -.. note:: SQream DB does not count trailing spaces, but does keep leading spaces. - .. code-block:: psql t=> SELECT LEN('Trailing spaces are not counted '); From d7b7b60772f22fbee77ce7ac3f7a26c92ac965a2 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 18 Apr 2023 11:14:13 +0300 Subject: [PATCH 505/882] Update not.rst --- reference/sql/sql_functions/scalar_functions/bitwise/not.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_functions/scalar_functions/bitwise/not.rst b/reference/sql/sql_functions/scalar_functions/bitwise/not.rst index a45495657..69d81e1ce 100644 --- a/reference/sql/sql_functions/scalar_functions/bitwise/not.rst +++ b/reference/sql/sql_functions/scalar_functions/bitwise/not.rst @@ -32,7 +32,7 @@ Arguments Returns ============ -Returns an integer that is the bitwise ``NOT`` of the input and preserves the data type of the argument supplied. +Returns an integer that is the bitwise NOT of the input and preserves the data type of the argument supplied. Notes ======= From cf8ab4e65911bc298e487697efab17d078a0ce30 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 18 Apr 2023 13:26:53 +0300 Subject: [PATCH 506/882] Update upgrade_storage.rst --- reference/cli/upgrade_storage.rst | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/reference/cli/upgrade_storage.rst b/reference/cli/upgrade_storage.rst index 867df3e03..0747981f7 100644 --- a/reference/cli/upgrade_storage.rst +++ b/reference/cli/upgrade_storage.rst @@ -28,11 +28,17 @@ Command line arguments :header-rows: 1 * - Argument - - Required + - State - Description - * - Storage path - - ✓ - - Full path to a valid storage cluster + * - ``storage_path`` + - Mandatory + - Full path to a valid storage cluster. + * - ``storage_version`` + - Optional + - Displays your current storage version. + * - ``check_predicates=0`` + - Optional + - Allows the upgrade process to proceed even if there are predicates marked for deletion. Results and error codes ======================== From 9550cfd841d7cc7cba92c7f78161f08ced314749 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 18 Apr 2023 16:32:16 +0300 Subject: [PATCH 507/882] Update catalog_reference_examples.rst --- reference/catalog_reference_examples.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/reference/catalog_reference_examples.rst b/reference/catalog_reference_examples.rst index 4531dfefc..3e605ee05 100644 --- a/reference/catalog_reference_examples.rst +++ b/reference/catalog_reference_examples.rst @@ -28,10 +28,10 @@ Listing All Schemas in a Database .. code-block:: psql master=> SELECT * FROM sqream_catalog.schemas; - schema_id | schema_name | schema_owner | rechunker_ignore - ----------+---------------+--------------+----------------- - 0 | public | sqream | false - 1 | secret_schema | mjordan | false + schema_id | schema_name | rechunker_ignore + ----------+---------------+----------------- + 0 | public | false + 1 | secret_schema | false Listing Columns and Their Types for a Specific Table From 93a5904241dda9e22a67e224a0cb3d227ced28db Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 18 Apr 2023 16:48:15 +0300 Subject: [PATCH 508/882] Update catalog_reference_catalog_tables.rst --- reference/catalog_reference_catalog_tables.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/reference/catalog_reference_catalog_tables.rst b/reference/catalog_reference_catalog_tables.rst index 4f4d60b76..b62b6c321 100644 --- a/reference/catalog_reference_catalog_tables.rst +++ b/reference/catalog_reference_catalog_tables.rst @@ -319,7 +319,9 @@ The ``roles_memberships`` data object identifies the role memberships in the dat * - ``member_role_id`` - Shows the ID of the parent role that this role inherits from. * - ``inherit`` - - Identifies whether permissions are inherited (``1`` - yes, ``0`` - no). + - Identifies whether permissions are inherited (``1`` - yes, ``0`` - no). + * - ``admin`` + - Identifies whether role is admin (``1`` - yes, ``0`` - no). .. _schemas: From 119e84f81a9a692a65f41d449ef648ed8f23efb8 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 18 Apr 2023 17:24:30 +0300 Subject: [PATCH 509/882] =?UTF-8?q?Altering=20Public=20Role=20Permissions?= =?UTF-8?q?=EF=83=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- operational_guides/access_control_managing_roles.rst | 2 +- operational_guides/foreign_tables.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/operational_guides/access_control_managing_roles.rst b/operational_guides/access_control_managing_roles.rst index 15729fa53..384a101ba 100644 --- a/operational_guides/access_control_managing_roles.rst +++ b/operational_guides/access_control_managing_roles.rst @@ -80,7 +80,7 @@ Altering Public Role Permissions There is a public role which always exists. Each role is granted to the ``PUBLIC`` role (i.e. is a member of the public group), and this cannot be revoked. You can alter the permissions granted to the public role. -The ``PUBLIC`` role has ``USAGE`` and ``CREATE`` permissions on ``PUBLIC`` schema by default, therefore, new users can ``CREATE``, :ref:`insert`, :ref:`delete`, :ref:`select` and :ref:`UPDATE` from objects in the ``PUBLIC`` schema. +The ``PUBLIC`` role has ``USAGE`` and ``CREATE`` permissions on ``PUBLIC`` schema by default, therefore, new users can :ref:`insert`, :ref:`delete`, :ref:`select`, :ref:`UPDATE` and ``CREATE`` (:ref:`databases<create_database>`, :ref:`schemas<create_schema>`, :ref:`roles<create_role>`, :ref:`functions<create_function>`, :ref:`views<create_view>`, and :ref:`tables<create_table>`) from objects in the ``PUBLIC`` schema. Altering Role Membership (Groups) diff --git a/operational_guides/foreign_tables.rst b/operational_guides/foreign_tables.rst index bc8c401a6..557e76c16 100644 --- a/operational_guides/foreign_tables.rst +++ b/operational_guides/foreign_tables.rst @@ -47,7 +47,7 @@ We will make note of the file structure, to create a matching ``CREATE_EXTERNAL_ Creating a Foreign Table ----------------------------- -Based on the source file structure, we we :ref:`create a foreign table<create_external_table>` with the appropriate structure, and point it to the file. +Based on the source file structure, we :ref:`create a foreign table<create_external_table>` with the appropriate structure, and point it to the file. .. code-block:: postgres From 1cffc5ebe9b4f66dbea088f28f6117257f01ee9a Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 18 Apr 2023 17:26:46 +0300 Subject: [PATCH 510/882] Update access_control_managing_roles.rst --- operational_guides/access_control_managing_roles.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/operational_guides/access_control_managing_roles.rst b/operational_guides/access_control_managing_roles.rst index 384a101ba..3f032bcd5 100644 --- a/operational_guides/access_control_managing_roles.rst +++ b/operational_guides/access_control_managing_roles.rst @@ -89,7 +89,7 @@ Altering Role Membership (Groups) Many database administrators find it useful to group user roles together. By grouping users, permissions can be granted to, or revoked from a group with one command. In SQream DB, this is done by creating a group role, granting permissions to it, and then assigning users to that group role. To use a role purely as a group, omit granting it ``LOGIN`` and ``PASSWORD`` permissions. - + The ``CONNECT`` permission can be given directly to user roles, and/or to the groups they are part of. .. code-block:: postgres From 017d4a8a35b100c2f7dc62fc86746437111380c4 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 20 Apr 2023 09:41:05 +0300 Subject: [PATCH 511/882] Update upgrade_storage.rst --- reference/cli/upgrade_storage.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/reference/cli/upgrade_storage.rst b/reference/cli/upgrade_storage.rst index 0747981f7..5b3f60625 100644 --- a/reference/cli/upgrade_storage.rst +++ b/reference/cli/upgrade_storage.rst @@ -21,7 +21,7 @@ Command line arguments .. code-block:: console - $ upgrade_storage <storage path> + $ upgrade_storage <storage path> [option] .. list-table:: :widths: auto @@ -33,10 +33,10 @@ Command line arguments * - ``storage_path`` - Mandatory - Full path to a valid storage cluster. - * - ``storage_version`` + * - ``--storage_version`` - Optional - Displays your current storage version. - * - ``check_predicates=0`` + * - ``--check_predicates=0`` - Optional - Allows the upgrade process to proceed even if there are predicates marked for deletion. From 8382c3c2ead1ee905c7b738316d9035c413693f9 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 20 Apr 2023 10:05:44 +0300 Subject: [PATCH 512/882] Update upgrade_storage.rst --- reference/cli/upgrade_storage.rst | 37 +++++++++++++++++++------------ 1 file changed, 23 insertions(+), 14 deletions(-) diff --git a/reference/cli/upgrade_storage.rst b/reference/cli/upgrade_storage.rst index 5b3f60625..669d47c45 100644 --- a/reference/cli/upgrade_storage.rst +++ b/reference/cli/upgrade_storage.rst @@ -14,31 +14,40 @@ Running upgrade_storage ``upgrade_storage`` can be found in the ``bin`` directory of your SQream DB installation. -Command line arguments -========================== - -``upgrade_storage`` contains one positional argument: - -.. code-block:: console - - $ upgrade_storage <storage path> [option] +Command line arguments and options +---------------------------------- .. list-table:: :widths: auto :header-rows: 1 - * - Argument - - State + * - Parameter + - Parameter Type - Description * - ``storage_path`` - - Mandatory + - Argument - Full path to a valid storage cluster. * - ``--storage_version`` - - Optional + - Option - Displays your current storage version. * - ``--check_predicates=0`` - - Optional - - Allows the upgrade process to proceed even if there are predicates marked for deletion. + - Option + - Allows the upgrade process to proceed even if there are predicates marked for deletion. + + +Syntax +------ + +.. code-block:: console + + $ upgrade_storage <storage path> [option] + + +.. code-block:: console + + $ upgrade_storage <storage path> [--storage_version] [--check_predicates=0] + + Results and error codes ======================== From 058e98c103f1c3b5099c9d18eb4810c582c5e141 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 20 Apr 2023 15:11:39 +0300 Subject: [PATCH 513/882] 4.2 release --- .../client_drivers/Spark/index.rst | 2 +- connecting_to_sqream/client_drivers/index.rst | 2 +- releases/4.2.rst | 19 ++++++++++++++----- 3 files changed, 16 insertions(+), 7 deletions(-) diff --git a/connecting_to_sqream/client_drivers/Spark/index.rst b/connecting_to_sqream/client_drivers/Spark/index.rst index 5f3d6caac..a7b031e53 100644 --- a/connecting_to_sqream/client_drivers/Spark/index.rst +++ b/connecting_to_sqream/client_drivers/Spark/index.rst @@ -22,7 +22,7 @@ To use Spark with SQream, it is essential that you have the following installed: * SQream version 2022.1.8 or later * Spark version 3.3.1 or later -* SQream Spark Connector 1.0.0 +* `SQream Spark Connector 5.0.0 <https://sq-ftp-public.s3.amazonaws.com/Spark-Sqream-Connector-5.0.0.jar>`_ * :ref:`JDBC<jdbc>` version 4.5.6 or later Connector Configuration diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index 662e6fc4b..cc6b670c0 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -38,7 +38,7 @@ The following are applicable to all operating systems: * **Spark**: - * `Spark Connector <>`_ + * `Spark Connector <https://sq-ftp-public.s3.amazonaws.com/Spark-Sqream-Connector-5.0.0.jar>`_ * :ref:`spark` .. _python: diff --git a/releases/4.2.rst b/releases/4.2.rst index 457422739..872b2da0f 100644 --- a/releases/4.2.rst +++ b/releases/4.2.rst @@ -6,7 +6,7 @@ Release Notes 4.2 SQream is introducing a new version release system that follows the more commonly used Major.Minor.Patch versioning schema. The newly released **4.0 version** is a minor version upgrade and does not require considerable preparation. -The 4.2 release notes were released on 03/19/2023 and describe the following: +The 4.2 release notes were released on 04/23/2023 and describe the following: .. contents:: :local: @@ -38,6 +38,10 @@ Newly Released Connector Drivers * `.jar file <https://sq-ftp-public.s3.amazonaws.com/sqream-jdbc-4.5.8.jar>`_ * :ref:`Documentation<java_jdbc>` +► Spark 5.0.0 + * `.jar file <https://sq-ftp-public.s3.amazonaws.com/Spark-Sqream-Connector-5.0.0.jar>`_ + * :ref:`Documentation<spark>` + Storage Version --------------- @@ -65,11 +69,18 @@ Version 4.2 resolved Issues +------------------------+------------------------------------------------------------------------------------------+ | **SQ No.** | **Description** | +========================+==========================================================================================+ -| SQ-12598 | External table ``SELECT`` statement issue | +| SQ-12078 | | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-12598 | Foreign table ``SELECT`` statement issue | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-13018 | | +------------------------+------------------------------------------------------------------------------------------+ | SQ-13055 | Pysqream ``NULL`` value issue | +------------------------+------------------------------------------------------------------------------------------+ - +| SQ-13322 | | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-13450 | Storage upgrade issue | ++------------------------+------------------------------------------------------------------------------------------+ Configuration Changes --------------------- @@ -107,8 +118,6 @@ The ``VARCHAR`` data type is deprecated to improve the core functionalities of t * The ``TEXT`` data type is replacing the ``VARCHAR`` and ``NVARCHAR`` data types. - - End of Support --------------- No End of Support changes were made. From 39674aa25c59ac4430a04f8c14d926761400197a Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 20 Apr 2023 15:32:22 +0300 Subject: [PATCH 514/882] release --- releases/4.2.rst | 2 -- releases/index.rst | 2 +- 2 files changed, 1 insertion(+), 3 deletions(-) diff --git a/releases/4.2.rst b/releases/4.2.rst index 872b2da0f..578e645aa 100644 --- a/releases/4.2.rst +++ b/releases/4.2.rst @@ -69,8 +69,6 @@ Version 4.2 resolved Issues +------------------------+------------------------------------------------------------------------------------------+ | **SQ No.** | **Description** | +========================+==========================================================================================+ -| SQ-12078 | | -+------------------------+------------------------------------------------------------------------------------------+ | SQ-12598 | Foreign table ``SELECT`` statement issue | +------------------------+------------------------------------------------------------------------------------------+ | SQ-13018 | | diff --git a/releases/index.rst b/releases/index.rst index 63eca8c7f..a827d375a 100644 --- a/releases/index.rst +++ b/releases/index.rst @@ -13,7 +13,7 @@ Release Notes * - Version - Release Date * - :ref:`4.2` - - March 19, 2023 + - April 23, 2023 * - :ref:`4.1` - March 01, 2023 * - :ref:`4.0` From 7bdd63aca488131a10a0addd1fac376aba64cf47 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 20 Apr 2023 16:09:11 +0300 Subject: [PATCH 515/882] Update 4.2.rst --- releases/4.2.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/4.2.rst b/releases/4.2.rst index 578e645aa..395c14f0b 100644 --- a/releases/4.2.rst +++ b/releases/4.2.rst @@ -71,7 +71,7 @@ Version 4.2 resolved Issues +========================+==========================================================================================+ | SQ-12598 | Foreign table ``SELECT`` statement issue | +------------------------+------------------------------------------------------------------------------------------+ -| SQ-13018 | | +| SQ-13018 | `cleanup_extent` operation buffer issue | +------------------------+------------------------------------------------------------------------------------------+ | SQ-13055 | Pysqream ``NULL`` value issue | +------------------------+------------------------------------------------------------------------------------------+ From d4d99f46c73e70146f424d0fbaca3d00b62134cb Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 20 Apr 2023 16:57:20 +0300 Subject: [PATCH 516/882] LEFT RIGHT --- reference/sql/sql_functions/scalar_functions/string/left.rst | 4 +--- .../sql/sql_functions/scalar_functions/string/right.rst | 5 ++--- 2 files changed, 3 insertions(+), 6 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/string/left.rst b/reference/sql/sql_functions/scalar_functions/string/left.rst index 143c6eeb7..ce76244e9 100644 --- a/reference/sql/sql_functions/scalar_functions/string/left.rst +++ b/reference/sql/sql_functions/scalar_functions/string/left.rst @@ -27,9 +27,7 @@ Arguments * - ``expr`` - String expression * - ``character_count`` - - A positive integer that specifies how many characters to return - * - ``cnt`` - - The number of characters to be returned. If ``cnt <= 0``, an empty string is returned. + - The number of characters to be returned. If ``character_count <= 0``, an empty string is returned. Returns ============ diff --git a/reference/sql/sql_functions/scalar_functions/string/right.rst b/reference/sql/sql_functions/scalar_functions/string/right.rst index 8cf750510..9c3d89838 100644 --- a/reference/sql/sql_functions/scalar_functions/string/right.rst +++ b/reference/sql/sql_functions/scalar_functions/string/right.rst @@ -27,9 +27,8 @@ Arguments * - ``expr`` - String expression * - ``character_count`` - - A positive integer that specifies how many characters to return. - * - ``cnt`` - - The number of characters to be returned. If ``cnt <= 0``, an empty string is returned. + - The number of characters to be returned. If ``character_count <= 0``, an empty string is returned. + Returns ============ From 293121ddf81a51a56e9d5145166516bde93576f9 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Sun, 23 Apr 2023 14:35:46 +0300 Subject: [PATCH 517/882] Update 4.2.rst --- releases/4.2.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/4.2.rst b/releases/4.2.rst index 395c14f0b..7fe2f2be3 100644 --- a/releases/4.2.rst +++ b/releases/4.2.rst @@ -75,7 +75,7 @@ Version 4.2 resolved Issues +------------------------+------------------------------------------------------------------------------------------+ | SQ-13055 | Pysqream ``NULL`` value issue | +------------------------+------------------------------------------------------------------------------------------+ -| SQ-13322 | | +| SQ-13322 | Clean up process is case sensitive | +------------------------+------------------------------------------------------------------------------------------+ | SQ-13450 | Storage upgrade issue | +------------------------+------------------------------------------------------------------------------------------+ From 8bd41eca57b0c4e0746f91da2ef89394c37572df Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 24 Apr 2023 11:15:56 +0300 Subject: [PATCH 518/882] Update delete_guide.rst --- operational_guides/delete_guide.rst | 88 +++++++++++++---------------- 1 file changed, 40 insertions(+), 48 deletions(-) diff --git a/operational_guides/delete_guide.rst b/operational_guides/delete_guide.rst index 0d6c4a41c..d257f0882 100644 --- a/operational_guides/delete_guide.rst +++ b/operational_guides/delete_guide.rst @@ -31,7 +31,7 @@ Deleting rows occurs in the following two phases: :: -* **Phase 2 - Clean-up** - The rows you marked for deletion in Phase 1 are physically deleted. The clean-up phase is not automated, letting users or DBAs control when to activate it. The files you marked for deletion during Phase 1 are removed from disk, which you do by by sequentially running the utility function commands ``CLEANUP_CHUNKS`` and ``CLEANUP_EXTENTS``. +* **Phase 2 - Clean-up** - The rows you marked for deletion in Phase 1 are physically deleted. The clean-up phase is not automated, letting users or DBAs control when to activate it. The files you marked for deletion during Phase 1 are removed from disk, which you do by sequentially running the utility function commands ``CLEANUP_CHUNKS`` and ``CLEANUP_EXTENTS``. .. TODO: isn't the delete cleanup able to complete a certain amount of work transactionally, so that you can do a massive cleanup in stages? @@ -39,7 +39,6 @@ Deleting rows occurs in the following two phases: Usage Notes ===================== -The **Usage Notes** section includes important information about the DELETE statement: .. contents:: :local: @@ -47,7 +46,6 @@ The **Usage Notes** section includes important information about the DELETE stat General Notes ---------------- -This section describes the general notes applicable when deleting rows: * The :ref:`alter_table` command and other DDL operations are locked on tables that require clean-up. If the estimated clean-up time exceeds the permitted threshold, an error message is displayed describing how to override the threshold limitation. For more information, see :ref:`concurrency_and_locks`. @@ -98,19 +96,22 @@ The following example shows how to delete rows from a table. The following table is displayed: .. code-block:: psql - - 1,Dog ,7 - 2,Possum ,3 - 3,Cat ,5 - 4,Elephant ,6500 - 5,Rhinoceros ,2100 - 6,\N,\N + animal_id | animal_name | animal_weight + ------------+------------------+-------------------- + 1 | Dog | 7 + 2 | Possum | 3 + 3 | Cat | 5 + 4 | Elephant | 6500 + 5 | Rhinoceros | 2100 + 6 | NULL | NULL + + 2. Delete rows from the table: .. code-block:: psql - farm=> DELETE FROM cool_animals WHERE weight > 1000; + farm=> DELETE FROM cool_animals WHERE animal_weight > 1000; 3. Display the table: @@ -122,10 +123,12 @@ The following example shows how to delete rows from a table. .. code-block:: psql - 1,Dog ,7 - 2,Possum ,3 - 3,Cat ,5 - 6,\N,\N + animal_id | animal_name | animal_weight + ------------+------------------+-------------------- + 1 | Dog | 7 + 2 | Possum | 3 + 3 | Cat | 5 + 6 | NULL | NULL Deleting Values Based on Complex Predicates --------------------------------------------------- @@ -141,18 +144,21 @@ The following example shows how to delete values based on complex predicates. .. code-block:: psql - 1,Dog ,7 - 2,Possum ,3 - 3,Cat ,5 - 4,Elephant ,6500 - 5,Rhinoceros ,2100 - 6,\N,\N + animal_id | animal_name | animal_weight + ------------+------------------+-------------------- + 1 | Dog | 7 + 2 | Possum | 3 + 3 | Cat | 5 + 4 | Elephant | 6500 + 5 | Rhinoceros | 2100 + 6 | NULL | NULL 2. Delete rows from the table: .. code-block:: psql - farm=> DELETE FROM cool_animals WHERE weight > 1000; + farm=> DELETE FROM cool_animals + WHERE animal_weight < 100 AND animal_name LIKE '%o%'; 3. Display the table: @@ -164,14 +170,14 @@ The following example shows how to delete values based on complex predicates. .. code-block:: psql - 1,Dog ,7 - 2,Possum ,3 - 3,Cat ,5 - 6,\N,\N + animal_id | animal_name | animal_weight + ------------+------------------+-------------------- + 3 | Cat | 5 + 4 | Elephant | 6500 + 6 | NULL | NULL Identifying and Cleaning Up Tables --------------------------------------- -The **Identifying and Cleaning Up Tables** section includes the following examples: .. contents:: :local: @@ -179,7 +185,6 @@ The **Identifying and Cleaning Up Tables** section includes the following exampl Listing Tables that Have Not Been Cleaned Up ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -The following example shows how to list tables that have not been cleaned up: .. code-block:: psql @@ -193,7 +198,6 @@ The following example shows how to list tables that have not been cleaned up: Identifying Predicates for Clean-Up ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -The following example shows how to identify predicates for clean-up: .. code-block:: psql @@ -209,9 +213,8 @@ The following example shows how to identify predicates for clean-up: Triggering a Clean-Up ^^^^^^^^^^^^^^^^^^^^^^ -The following example shows how to trigger a clean-up: -1. Run the chunk ``CLEANUP_CHUNKS`` command (also known as ``SWEEP``) to reorganize the chunks: +1. Run the ``CLEANUP_CHUNKS`` command (also known as ``SWEEP``) to reorganize the chunks: .. code-block:: psql @@ -233,30 +236,19 @@ The following example shows how to trigger a clean-up: WHERE t.table_name = 'cool_animals'; Best Practices -===================================== -This section includes the best practices when deleting rows: +============== -* Run ``CLEANUP_CHUNKS`` and ``CLEANUP_EXTENTS`` after running large ``DELETE`` operations. - - :: -* When you delete large segments of data from very large tables, consider running a ``CREATE TABLE AS`` operation instead, renaming, and dropping the original table. +* After running large ``DELETE`` operations, run ``CLEANUP_CHUNKS`` and ``CLEANUP_EXTENTS`` to improve performance and free up space. These commands remove empty chunks and extents, respectively, and can help prevent fragmentation of the table. :: -* Avoid killing ``CLEANUP_EXTENTS`` operations in progress. +* If you need to delete large segments of data from very large tables, consider using a ``CREATE TABLE AS`` operation instead. This involves creating a new table with the desired data and then renaming and dropping the original table. This approach can be faster and more efficient than running a large ``DELETE`` operation, especially if you don't need to preserve any data in the original table. :: -* SQream is optimized for time-based data, which is data naturally ordered according to date or timestamp. Deleting rows based on such columns leads to increased performance. +* Avoid interrupting or killing ``CLEANUP_EXTENTS`` operations that are in progress. These operations can take a while to complete, especially if the table is very large or has a lot of fragmentation, but interrupting them can cause data inconsistencies or other issues. -.. soft update concept - -.. delete cleanup and it's properties. automatic/manual, in transaction or background - -.. automatic background gives fast delete, minimal transaction overhead, -.. small cost to queries until background reorganised - -.. when does delete use the metadata effectively + :: -.. more examples \ No newline at end of file +* SQream is optimized for time-based data, which means that data that is naturally ordered according to date or timestamp fields will generally perform better. If you need to delete rows from such tables, consider using the time-based columns in your ``DELETE`` predicates to improve performance. From 5fb2f2d2aa71ea55350da189fe46dfdf1a98cc4d Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 24 Apr 2023 14:11:45 +0300 Subject: [PATCH 519/882] Update delete_guide.rst --- operational_guides/delete_guide.rst | 34 ++++++++++------------------- 1 file changed, 12 insertions(+), 22 deletions(-) diff --git a/operational_guides/delete_guide.rst b/operational_guides/delete_guide.rst index d257f0882..618c05a1a 100644 --- a/operational_guides/delete_guide.rst +++ b/operational_guides/delete_guide.rst @@ -11,31 +11,30 @@ The **Deleting Data** page describes how the **Delete** statement works and how Overview ======================================== -Deleting data typically refers to deleting rows, but can refer to deleting other table content as well. The general workflow for deleting data is to delete data followed by triggering a cleanup operation. The cleanup operation reclaims the space occupied by the deleted rows, discussed further below. +When working with a table in a database, deleting data typically involves removing rows, although it can also involve removing columns. The process for deleting data involves first deleting the desired content, followed by a cleanup operation that reclaims the space previously occupied by the deleted data. This process is further explained below. -The **DELETE** statement deletes rows defined by a predicate that you have specified, preventing them from appearing in subsequent queries. - -For example, the predicate below defines and deletes rows containing animals heavier than 1000 weight units: +The ``DELETE`` statement is used to remove rows that match a specified predicate, thereby preventing them from being included in subsequent queries. For example, the following statement deletes all rows in the ``cool_animals`` table where the weight of the animal is greater than 1000 weight units: .. code-block:: psql - farm=> DELETE FROM cool_animals WHERE weight > 1000; + DELETE FROM cool_animals WHERE weight > 1000; + +By using the WHERE clause in the DELETE statement, you can specify a condition or predicate that determines which rows should be deleted from the table. In this example, the predicate "weight > 1000" specifies that only rows with an animal weight greater than 1000 should be deleted. -The major benefit of the DELETE statement is that it deletes transactions simply and quickly. The Deletion Process ========== -Deleting rows occurs in the following two phases: -* **Phase 1 - Deletion** - All rows you mark for deletion are ignored when you run any query. These rows are not deleted until the clean-up phase. +When you delete rows from a SQL database, the actual deletion process occurs in two steps: + +* Marking for Deletion: When you issue a ``DELETE`` statement to remove one or more rows from a table, the database marks these rows for deletion. These rows are not actually removed from the database immediately, but are instead temporarily ignored when you run any query. :: -* **Phase 2 - Clean-up** - The rows you marked for deletion in Phase 1 are physically deleted. The clean-up phase is not automated, letting users or DBAs control when to activate it. The files you marked for deletion during Phase 1 are removed from disk, which you do by sequentially running the utility function commands ``CLEANUP_CHUNKS`` and ``CLEANUP_EXTENTS``. +* Clean-up: Once the rows have been marked for deletion, you need to trigger a clean-up operation to permanently remove them from the database. During the clean-up process, the database frees up the disk space previously occupied by the deleted rows. To remove all files associated with the deleted rows, you can use the utility function commands ``CLEANUP_CHUNKS`` and ``CLEANUP_EXTENTS``. These commands should be run sequentially to ensure that these files removed from disk. -.. TODO: isn't the delete cleanup able to complete a certain amount of work transactionally, so that you can do a massive cleanup in stages? +If you want to delete all rows from a table, you can use the :ref:`TRUNCATE<truncate>` command, which deletes all rows in a table and frees up the associated disk space. -.. TODO: our current best practices is to use a cron job with sqream sql to run the delete cleanup. we should document how to do this, we have customers with very different delete schedules so we can give a few extreme examples and when/why you'd use them. Usage Notes ===================== @@ -57,15 +56,6 @@ General Notes set mixedColumnChunksThreshold=XXX; -Deleting Data does not Free Space ------------------------------------------ -With the exception of running a full table delete, deleting data does not free unused disk space. To free unused disk space you must trigger the clean-up process. - -For more information on running a full table delete, see :ref:`TRUNCATE<truncate>`. - - :: - -For more information on freeing disk space, see :ref:`Triggering a Clean-Up<trigger_cleanup>`. Clean-Up Operations Are I/O Intensive ------------------------------- @@ -235,8 +225,8 @@ Triggering a Clean-Up ON dp.table_id = t.table_id WHERE t.table_name = 'cool_animals'; -Best Practices -============== +Best Practice +============= * After running large ``DELETE`` operations, run ``CLEANUP_CHUNKS`` and ``CLEANUP_EXTENTS`` to improve performance and free up space. These commands remove empty chunks and extents, respectively, and can help prevent fragmentation of the table. From 31a8c70cb7f6fb5eefe5192816513fd640d273a0 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 24 Apr 2023 16:27:00 +0300 Subject: [PATCH 520/882] clean up --- operational_guides/delete_guide.rst | 173 ++++++++++++++-------------- reference/cli/upgrade_storage.rst | 4 +- 2 files changed, 87 insertions(+), 90 deletions(-) diff --git a/operational_guides/delete_guide.rst b/operational_guides/delete_guide.rst index 618c05a1a..dae2d02d1 100644 --- a/operational_guides/delete_guide.rst +++ b/operational_guides/delete_guide.rst @@ -3,14 +3,7 @@ *********************** Deleting Data *********************** -The **Deleting Data** page describes how the **Delete** statement works and how to maintain data that you delete: -.. contents:: - :local: - :depth: 1 - -Overview -======================================== When working with a table in a database, deleting data typically involves removing rows, although it can also involve removing columns. The process for deleting data involves first deleting the desired content, followed by a cleanup operation that reclaims the space previously occupied by the deleted data. This process is further explained below. The ``DELETE`` statement is used to remove rows that match a specified predicate, thereby preventing them from being included in subsequent queries. For example, the following statement deletes all rows in the ``cool_animals`` table where the weight of the animal is greater than 1000 weight units: @@ -21,30 +14,29 @@ The ``DELETE`` statement is used to remove rows that match a specified predicate By using the WHERE clause in the DELETE statement, you can specify a condition or predicate that determines which rows should be deleted from the table. In this example, the predicate "weight > 1000" specifies that only rows with an animal weight greater than 1000 should be deleted. +.. contents:: + :local: + :depth: 1 The Deletion Process ========== When you delete rows from a SQL database, the actual deletion process occurs in two steps: -* Marking for Deletion: When you issue a ``DELETE`` statement to remove one or more rows from a table, the database marks these rows for deletion. These rows are not actually removed from the database immediately, but are instead temporarily ignored when you run any query. +* **Marking for Deletion**: When you issue a ``DELETE`` statement to remove one or more rows from a table, the database marks these rows for deletion. These rows are not actually removed from the database immediately, but are instead temporarily ignored when you run any query. :: -* Clean-up: Once the rows have been marked for deletion, you need to trigger a clean-up operation to permanently remove them from the database. During the clean-up process, the database frees up the disk space previously occupied by the deleted rows. To remove all files associated with the deleted rows, you can use the utility function commands ``CLEANUP_CHUNKS`` and ``CLEANUP_EXTENTS``. These commands should be run sequentially to ensure that these files removed from disk. +* **Clean-up**: Once the rows have been marked for deletion, you need to trigger a clean-up operation to permanently remove them from the database. During the clean-up process, the database frees up the disk space previously occupied by the deleted rows. To remove all files associated with the deleted rows, you can use the utility function commands ``CLEANUP_CHUNKS`` and ``CLEANUP_EXTENTS``. These commands should be run sequentially to ensure that these files removed from disk. If you want to delete all rows from a table, you can use the :ref:`TRUNCATE<truncate>` command, which deletes all rows in a table and frees up the associated disk space. Usage Notes ===================== - -.. contents:: - :local: - :depth: 1 General Notes ----------------- +------------- * The :ref:`alter_table` command and other DDL operations are locked on tables that require clean-up. If the estimated clean-up time exceeds the permitted threshold, an error message is displayed describing how to override the threshold limitation. For more information, see :ref:`concurrency_and_locks`. @@ -58,7 +50,7 @@ General Notes Clean-Up Operations Are I/O Intensive -------------------------------- +------------------------------------- The clean-up process reduces table size by removing all unused space from column chunks. While this reduces query time, it is a time-costly operation occupying disk space for the new copy of the table until the operation is complete. .. tip:: Because clean-up operations can create significant I/O load on your database, consider using them sparingly during ideal times. @@ -66,27 +58,39 @@ The clean-up process reduces table size by removing all unused space from column If this is an issue with your environment, consider using ``CREATE TABLE AS`` to create a new table and then rename and drop the old table. Examples -============= -The **Examples** section includes the following examples: +======== -.. contents:: - :local: - :depth: 1 +To follow the examples section, create the following table: + + .. code-block:: psql -Deleting Rows from a Table ------------------------------- -The following example shows how to delete rows from a table. + CREATE OR REPLACE TABLE cool_animals ( + animal_id INT, + animal_name TEXT, + animal_weight FLOAT + ); -1. Display the table: +Insert the following content: .. code-block:: psql - - farm=> SELECT * FROM cool_animals; - The following table is displayed: + INSERT INTO cool_animals (animal_id, animal_name, animal_weight) + VALUES + (1, 'Dog', 7), + (2, 'Possum', 3), + (3, 'Cat', 5), + (4, 'Elephant', 6500), + (5, 'Rhinoceros', 2100), + (6, NULL, NULL); - .. code-block:: psql +View table content: + +.. code-block:: psql + farm=> SELECT * FROM cool_animals; + + Return: + animal_id | animal_name | animal_weight ------------+------------------+-------------------- 1 | Dog | 7 @@ -96,85 +100,65 @@ The following example shows how to delete rows from a table. 5 | Rhinoceros | 2100 6 | NULL | NULL +Now you may use the following examples for: -2. Delete rows from the table: +.. contents:: + :local: + :depth: 1 + +Deleting Rows from a Table +-------------------------- - .. code-block:: psql +1. Delete rows from the table: - farm=> DELETE FROM cool_animals WHERE animal_weight > 1000; +.. code-block:: psql + + farm=> DELETE FROM cool_animals WHERE animal_weight > 1000; -3. Display the table: +2. Display the table: - .. code-block:: psql +.. code-block:: psql - farm=> SELECT * FROM cool_animals; + farm=> SELECT * FROM cool_animals; - The following table is displayed: - - .. code-block:: psql + Return - animal_id | animal_name | animal_weight - ------------+------------------+-------------------- - 1 | Dog | 7 - 2 | Possum | 3 - 3 | Cat | 5 - 6 | NULL | NULL + animal_id | animal_name | animal_weight + ------------+------------------+-------------------- + 1 | Dog | 7 + 2 | Possum | 3 + 3 | Cat | 5 + 6 | NULL | NULL + Deleting Values Based on Complex Predicates --------------------------------------------------- -The following example shows how to delete values based on complex predicates. - -1. Display the table: - - .. code-block:: psql - - farm=> SELECT * FROM cool_animals; - The following table is displayed: +1. Delete rows from the table: - .. code-block:: psql - - animal_id | animal_name | animal_weight - ------------+------------------+-------------------- - 1 | Dog | 7 - 2 | Possum | 3 - 3 | Cat | 5 - 4 | Elephant | 6500 - 5 | Rhinoceros | 2100 - 6 | NULL | NULL - -2. Delete rows from the table: - - .. code-block:: psql +.. code-block:: psql - farm=> DELETE FROM cool_animals - WHERE animal_weight < 100 AND animal_name LIKE '%o%'; + farm=> DELETE FROM cool_animals + WHERE animal_weight < 100 AND animal_name LIKE '%o%'; -3. Display the table: +2. Display the table: - .. code-block:: psql +.. code-block:: psql - farm=> SELECT * FROM cool_animals; - - The following table is displayed: - - .. code-block:: psql + farm=> SELECT * FROM cool_animals; - animal_id | animal_name | animal_weight - ------------+------------------+-------------------- - 3 | Cat | 5 - 4 | Elephant | 6500 - 6 | NULL | NULL + Return + + animal_id | animal_name | animal_weight + ------------+------------------+-------------------- + 3 | Cat | 5 + 4 | Elephant | 6500 + 6 | NULL | NULL Identifying and Cleaning Up Tables --------------------------------------- - -.. contents:: - :local: - :depth: 1 Listing Tables that Have Not Been Cleaned Up -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: psql @@ -187,7 +171,6 @@ Listing Tables that Have Not Been Cleaned Up 1 row Identifying Predicates for Clean-Up -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: psql @@ -204,19 +187,33 @@ Identifying Predicates for Clean-Up Triggering a Clean-Up ^^^^^^^^^^^^^^^^^^^^^^ +When running the clean-up operation, you need to specify two parameters: ``schema_name`` and ``table_name``. However, it's important to note that the second parameter is case-sensitive for both ``CLEANUP_CHUNKS`` and ``CLEANUP_EXTENTS``. By default, both operations will accept lowercase table names. + 1. Run the ``CLEANUP_CHUNKS`` command (also known as ``SWEEP``) to reorganize the chunks: .. code-block:: psql - farm=> SELECT CLEANUP_CHUNKS('public','cool_animals'); + farm=> SELECT CLEANUP_CHUNKS('<schema_name>','<table_name>'); 2. Run the ``CLEANUP_EXTENTS`` command (also known as ``VACUUM``) to delete the leftover files: .. code-block:: psql - farm=> SELECT CLEANUP_EXTENTS('public','cool_animals'); + farm=> SELECT CLEANUP_EXTENTS('<schema_name>','<table_name>'); + + +If you need to run a clean-up operation for a table name that contains uppercase letters, you can use the ``false`` flag to convert the uppercase letters to lowercase, such as in the following examples: + + .. code-block:: psql + + farm=> SELECT CLEANUP_CHUNKS('<schema_name>','<table_name>', false); + + .. code-block:: psql + + farm=> SELECT CLEANUP_EXTENTS('<schema_name>','<table_name>', false); + -3. Display the table: +To display the table: .. code-block:: psql diff --git a/reference/cli/upgrade_storage.rst b/reference/cli/upgrade_storage.rst index 669d47c45..bf9e8554f 100644 --- a/reference/cli/upgrade_storage.rst +++ b/reference/cli/upgrade_storage.rst @@ -40,12 +40,12 @@ Syntax .. code-block:: console - $ upgrade_storage <storage path> [option] + $ upgrade_storage <storage path> [--check_predicates=0] .. code-block:: console - $ upgrade_storage <storage path> [--storage_version] [--check_predicates=0] + $ upgrade_storage <storage path> [--storage_version] From af77e0d930bb85e352f1095f6d905ed8b623acc4 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 24 Apr 2023 16:51:31 +0300 Subject: [PATCH 521/882] release --- releases/4.0_index.rst | 3 ++- releases/index.rst | 2 ++ 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/releases/4.0_index.rst b/releases/4.0_index.rst index d61a919f3..1413bd07b 100644 --- a/releases/4.0_index.rst +++ b/releases/4.0_index.rst @@ -15,4 +15,5 @@ The 4.0 Release Notes describe the following releases: 4.0 4.1 - 4.2 \ No newline at end of file + 4.2 + 4.3 \ No newline at end of file diff --git a/releases/index.rst b/releases/index.rst index a827d375a..abb8ab7a9 100644 --- a/releases/index.rst +++ b/releases/index.rst @@ -12,6 +12,8 @@ Release Notes * - Version - Release Date + * - :ref:`4.3` + - xxxxxxxxx * - :ref:`4.2` - April 23, 2023 * - :ref:`4.1` From 3f3bcd58f15c95400fe7bfd8350be1f026187ce4 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 24 Apr 2023 16:53:09 +0300 Subject: [PATCH 522/882] Create 4.3.rst --- releases/4.3.rst | 158 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 158 insertions(+) create mode 100644 releases/4.3.rst diff --git a/releases/4.3.rst b/releases/4.3.rst new file mode 100644 index 000000000..08322f63a --- /dev/null +++ b/releases/4.3.rst @@ -0,0 +1,158 @@ +.. _4.3: + +************************** +Release Notes 4.3 +************************** + +SQream is introducing a new version release system that follows the more commonly used Major.Minor.Patch versioning schema. The newly released **4.0 version** is a minor version upgrade and does not require considerable preparation. + +The 4.3 release notes were released on xx/xx/xxxx and describe the following: + +.. contents:: + :local: + :depth: 1 + +New Features +------------ + + +:ref:`Apache Spark<spark>` may now be used for large-scale data processing. + + :: + +:ref:`Physical deletion<delete_guide>` performance enhancement by supporting file systems with parallelism capabilities + + +Newly Released Connector Drivers +-------------------------------- + +► Pysqream 3.2.5 + * Supports Python version 3.9 and newer + * `.tar file <https://github.com/SQream/pysqream/releases/tag/v3.2.5>`_ + * :ref:`Documentation<pysqream>` + +► ODBC 4.4.4 + * :ref:`Getting the ODBC Driver<odbc>` + +► JDBC 4.5.8 + * `.jar file <https://sq-ftp-public.s3.amazonaws.com/sqream-jdbc-4.5.8.jar>`_ + * :ref:`Documentation<java_jdbc>` + +► Spark 5.0.0 + * `.jar file <https://sq-ftp-public.s3.amazonaws.com/Spark-Sqream-Connector-5.0.0.jar>`_ + * :ref:`Documentation<spark>` + +Storage Version +--------------- + +The storage version presently in effect is version 46. + +SQream Studio Updates and Improvements +-------------------------------------- + +SQream Studio v5.5.4 has been released. + + :: + +Known Issues +------------ + +* :ref:`Percentile<percentile_disc>` is not supported for :ref:`Window Functions<window_functions>`. + +* Performance degradation when using ``VARCHAR`` partition key in a :ref:`Window Functions<window_functions>` expression + + + +Version 4.3 resolved Issues +----------------------------- + ++------------------------+------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++========================+==========================================================================================+ +| SQ-12598 | Foreign table ``SELECT`` statement issue | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-13018 | `cleanup_extent` operation buffer issue | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-13055 | Pysqream ``NULL`` value issue | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-13322 | Clean up process is case sensitive | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-13450 | Storage upgrade issue | ++------------------------+------------------------------------------------------------------------------------------+ + +Configuration Changes +--------------------- + +No configuration changes + + +Naming Changes +-------------- +No naming changes + + +Deprecated Features +------------------- + +► ``INT96`` + +Due to Parquet's lack of support of the ``INT96`` data type, SQream has decided to deprecate this data type. + + +► Square Brackets ``[]`` + +The ``[]``, which are frequently used to delimit :ref:`identifiers<keywords_and_identifiers>` such as column names, table names, and other database objects, will soon be deprecated to facilitate the use of the ``ARRAY`` data type. + +* Support in ``[]`` for delimiting database object identifiers ends on June 1st, 2023. +* To delimit database object identifiers, you will be able to use double quotes ``""``. + + +► ``VARCHAR`` + +The ``VARCHAR`` data type is deprecated to improve the core functionalities of the platform and to align with the constantly evolving ecosystem requirements. + +* Support in the ``VARCHAR`` data type ends at September 30th, 2023. +* ``VARCHAR`` is no longer supported for new customers, effective from Version 2022.1.3. +* The ``TEXT`` data type is replacing the ``VARCHAR`` and ``NVARCHAR`` data types. + + +End of Support +--------------- +No End of Support changes were made. + +Upgrading to v4.2 +------------------- +1. Generate a back-up of the metadata by running the following command: + + .. code-block:: console + + $ select backup_metadata('out_path'); + + .. tip:: SQream recommends storing the generated back-up locally in case needed. + + SQream runs the Garbage Collector and creates a clean backup tarball package. + +2. Shut down all SQream services. + + :: + +3. Copy the recently created back-up file. + + :: + +4. Replace your current metadata with the metadata you stored in the back-up file. + + :: + +5. Navigate to the new SQream package bin folder. + + :: + +6. Run the following command: + + .. code-block:: console + + $ ./upgrade_storage <levelDB path> + + .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. + From 5fb20dedc788df8d9dc7781ad4772dcb55ac3ff8 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 25 Apr 2023 13:47:56 +0300 Subject: [PATCH 523/882] Update delete_guide.rst --- operational_guides/delete_guide.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/operational_guides/delete_guide.rst b/operational_guides/delete_guide.rst index dae2d02d1..abd6faf9d 100644 --- a/operational_guides/delete_guide.rst +++ b/operational_guides/delete_guide.rst @@ -187,22 +187,22 @@ Identifying Predicates for Clean-Up Triggering a Clean-Up ^^^^^^^^^^^^^^^^^^^^^^ -When running the clean-up operation, you need to specify two parameters: ``schema_name`` and ``table_name``. However, it's important to note that the second parameter is case-sensitive for both ``CLEANUP_CHUNKS`` and ``CLEANUP_EXTENTS``. By default, both operations will accept lowercase table names. +When running the clean-up operation, you need to specify two parameters: ``schema_name`` and ``table_name``. However, it's important to note that the second parameter is case-sensitive for both ``CLEANUP_CHUNKS`` and ``CLEANUP_EXTENTS``. -1. Run the ``CLEANUP_CHUNKS`` command (also known as ``SWEEP``) to reorganize the chunks: +Running a ``CLEANUP_CHUNKS`` command (also known as ``SWEEP``) to reorganize the chunks: .. code-block:: psql farm=> SELECT CLEANUP_CHUNKS('<schema_name>','<table_name>'); -2. Run the ``CLEANUP_EXTENTS`` command (also known as ``VACUUM``) to delete the leftover files: +Running a ``CLEANUP_EXTENTS`` command (also known as ``VACUUM``) to delete the leftover files: .. code-block:: psql farm=> SELECT CLEANUP_EXTENTS('<schema_name>','<table_name>'); -If you need to run a clean-up operation for a table name that contains uppercase letters, you can use the ``false`` flag to convert the uppercase letters to lowercase, such as in the following examples: +If you should want to run a clean-up operation without worrying about uppercase and lowercase letters, you can use the ``false`` flag to enable lowercase letters for both lowercase and uppercase table and schema names, such as in the following examples: .. code-block:: psql From b5af45ad43ce26be06950f1d059682f50af5418c Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 27 Apr 2023 09:22:22 +0300 Subject: [PATCH 524/882] Update delete_guide.rst --- operational_guides/delete_guide.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/operational_guides/delete_guide.rst b/operational_guides/delete_guide.rst index abd6faf9d..abf99a0b4 100644 --- a/operational_guides/delete_guide.rst +++ b/operational_guides/delete_guide.rst @@ -220,7 +220,7 @@ To display the table: farm=> SELECT delete_predicate FROM sqream_catalog.delete_predicates dp JOIN sqream_catalog.tables t ON dp.table_id = t.table_id - WHERE t.table_name = 'cool_animals'; + WHERE t.table_name = '<table_name>'; Best Practice ============= From e961c5f0414418af88d8cc4051d33c2252d39935 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 27 Apr 2023 09:51:43 +0300 Subject: [PATCH 525/882] Update 4.3.rst --- releases/4.3.rst | 18 +++++------------- 1 file changed, 5 insertions(+), 13 deletions(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index 08322f63a..86568d66e 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -16,11 +16,11 @@ New Features ------------ -:ref:`Apache Spark<spark>` may now be used for large-scale data processing. +:ref:`<>` :: -:ref:`Physical deletion<delete_guide>` performance enhancement by supporting file systems with parallelism capabilities +:ref:`<>` Newly Released Connector Drivers @@ -34,7 +34,7 @@ Newly Released Connector Drivers ► ODBC 4.4.4 * :ref:`Getting the ODBC Driver<odbc>` -► JDBC 4.5.8 +► JDBC 5.0.0 * `.jar file <https://sq-ftp-public.s3.amazonaws.com/sqream-jdbc-4.5.8.jar>`_ * :ref:`Documentation<java_jdbc>` @@ -69,16 +69,8 @@ Version 4.3 resolved Issues +------------------------+------------------------------------------------------------------------------------------+ | **SQ No.** | **Description** | +========================+==========================================================================================+ -| SQ-12598 | Foreign table ``SELECT`` statement issue | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-13018 | `cleanup_extent` operation buffer issue | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-13055 | Pysqream ``NULL`` value issue | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-13322 | Clean up process is case sensitive | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-13450 | Storage upgrade issue | -+------------------------+------------------------------------------------------------------------------------------+ +| SQ-11108 | Slow ``COPY FROM`` statements using ORC files | ++------------------------+------------------------------------------------------------------------------------------+ Configuration Changes --------------------- From 881158000928d17ffbe9951a7d2ff0e663357c23 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 27 Apr 2023 10:58:37 +0300 Subject: [PATCH 526/882] metadata server --- reference/cli/metadata_server.rst | 34 ++++++++++++++++++++++++++++--- releases/4.3.rst | 2 +- 2 files changed, 32 insertions(+), 4 deletions(-) diff --git a/reference/cli/metadata_server.rst b/reference/cli/metadata_server.rst index 716237c11..933bf1407 100644 --- a/reference/cli/metadata_server.rst +++ b/reference/cli/metadata_server.rst @@ -10,8 +10,36 @@ In general, you should not need to run ``metadata_server`` manually, but it is s This page serves as a reference for the options and parameters. -Positional command line arguments -=================================== +Command Line Arguments +====================== + +The ``metadata_server`` supports the following command line arguments: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Argument + - Default + - Description + * - ``--log_path`` + - ``./metadata_server_log`` + - The ``metadata_server`` log file output contains information about the activities and events related to the metadata server of a system. + * - ``--log4_config`` + - None + - Specifies the location of the configuration file for the ``Log4cxx`` logging library. + * - ``--num_deleters`` + - 1 + - Specifies the number of threads to use for the file reaper in a system or program. + * - ``--metadata_path`` + - ``<...sqreamd/leveldb>`` + - Specifies the path to the directory where metadata files are stored for a system or program. + * - ``--help`` + - + - Used to display a help message or documentation for a particular program or command. + +Positional Command Line Arguments +--------------------------------- .. code-block:: console @@ -39,7 +67,7 @@ Starting temporarily .. code-block:: console - $ nohup metadata_server & + $ nohup metadata_server -config ~/.sqream/metadata_server_config.json & $ MS_PID=$! Using ``nohup`` and ``&`` sends metadata server to run in the background. diff --git a/releases/4.3.rst b/releases/4.3.rst index 86568d66e..e98b6868f 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -75,7 +75,7 @@ Version 4.3 resolved Issues Configuration Changes --------------------- -No configuration changes +You may now configure the ``metadata_server`` using the ``metadata_server_config.json`` :ref:`configuration file<metadata_server>`. Naming Changes From 4ba53e08851e0b759e7f4e44125d78b53c7d4693 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 27 Apr 2023 11:41:35 +0300 Subject: [PATCH 527/882] Update metadata_server.rst --- reference/cli/metadata_server.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/cli/metadata_server.rst b/reference/cli/metadata_server.rst index 933bf1407..76caf3d13 100644 --- a/reference/cli/metadata_server.rst +++ b/reference/cli/metadata_server.rst @@ -35,7 +35,7 @@ The ``metadata_server`` supports the following command line arguments: - ``<...sqreamd/leveldb>`` - Specifies the path to the directory where metadata files are stored for a system or program. * - ``--help`` - - + - None - Used to display a help message or documentation for a particular program or command. Positional Command Line Arguments From aabc2c4d4e832115a70842a075ab89f699e1387a Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 27 Apr 2023 12:05:08 +0300 Subject: [PATCH 528/882] Update metadata_server.rst --- reference/cli/metadata_server.rst | 22 +--------------------- 1 file changed, 1 insertion(+), 21 deletions(-) diff --git a/reference/cli/metadata_server.rst b/reference/cli/metadata_server.rst index 76caf3d13..6bd58d821 100644 --- a/reference/cli/metadata_server.rst +++ b/reference/cli/metadata_server.rst @@ -38,26 +38,6 @@ The ``metadata_server`` supports the following command line arguments: - None - Used to display a help message or documentation for a particular program or command. -Positional Command Line Arguments ---------------------------------- - -.. code-block:: console - - $ metadata_server [ <logging path> [ <listen port> ] ] - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Argument - - Default - - Description - * - Logging path - - Current directory - - Path to store metadata logs into - * - Listen port - - ``3105`` - - TCP listen port. If used, log path must be specified beforehand. Starting metadata server ============================ @@ -83,7 +63,7 @@ To use a non-default port, specify the logging path as well. .. code-block:: console - $ nohup metadata_server /home/rhendricks/metadata_logs 9241 & + $ nohup metadata_server --log_path=/home/rhendricks/metadata_logs 9241 & $ MS_PID=$! Using ``nohup`` and ``&`` sends metadata server to run in the background. From a5b8003141d0d465979665d0e451f83b3f9a312d Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 27 Apr 2023 12:12:31 +0300 Subject: [PATCH 529/882] Update 4.3.rst --- releases/4.3.rst | 14 -------------- 1 file changed, 14 deletions(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index e98b6868f..63c3d2111 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -26,21 +26,7 @@ New Features Newly Released Connector Drivers -------------------------------- -► Pysqream 3.2.5 - * Supports Python version 3.9 and newer - * `.tar file <https://github.com/SQream/pysqream/releases/tag/v3.2.5>`_ - * :ref:`Documentation<pysqream>` -► ODBC 4.4.4 - * :ref:`Getting the ODBC Driver<odbc>` - -► JDBC 5.0.0 - * `.jar file <https://sq-ftp-public.s3.amazonaws.com/sqream-jdbc-4.5.8.jar>`_ - * :ref:`Documentation<java_jdbc>` - -► Spark 5.0.0 - * `.jar file <https://sq-ftp-public.s3.amazonaws.com/Spark-Sqream-Connector-5.0.0.jar>`_ - * :ref:`Documentation<spark>` Storage Version --------------- From aa9780f326a3e101867f9604b38549f34ed6d2a7 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 27 Apr 2023 14:45:43 +0300 Subject: [PATCH 530/882] Update metadata_server.rst --- reference/cli/metadata_server.rst | 34 ++++++++++++------------------- 1 file changed, 13 insertions(+), 21 deletions(-) diff --git a/reference/cli/metadata_server.rst b/reference/cli/metadata_server.rst index 6bd58d821..d39924684 100644 --- a/reference/cli/metadata_server.rst +++ b/reference/cli/metadata_server.rst @@ -10,10 +10,12 @@ In general, you should not need to run ``metadata_server`` manually, but it is s This page serves as a reference for the options and parameters. -Command Line Arguments -====================== +Positional command line arguments +=================================== -The ``metadata_server`` supports the following command line arguments: +.. code-block:: console + + $ metadata_server [ <logging path> [ <listen port> ] ] .. list-table:: :widths: auto @@ -22,22 +24,12 @@ The ``metadata_server`` supports the following command line arguments: * - Argument - Default - Description - * - ``--log_path`` - - ``./metadata_server_log`` - - The ``metadata_server`` log file output contains information about the activities and events related to the metadata server of a system. - * - ``--log4_config`` - - None - - Specifies the location of the configuration file for the ``Log4cxx`` logging library. - * - ``--num_deleters`` - - 1 - - Specifies the number of threads to use for the file reaper in a system or program. - * - ``--metadata_path`` - - ``<...sqreamd/leveldb>`` - - Specifies the path to the directory where metadata files are stored for a system or program. - * - ``--help`` - - None - - Used to display a help message or documentation for a particular program or command. - + * - Logging path + - Current directory + - Path to store metadata logs into + * - Listen port + - ``3105`` + - TCP listen port. If used, log path must be specified beforehand. Starting metadata server ============================ @@ -47,7 +39,7 @@ Starting temporarily .. code-block:: console - $ nohup metadata_server -config ~/.sqream/metadata_server_config.json & + $ nohup metadata_server & $ MS_PID=$! Using ``nohup`` and ``&`` sends metadata server to run in the background. @@ -63,7 +55,7 @@ To use a non-default port, specify the logging path as well. .. code-block:: console - $ nohup metadata_server --log_path=/home/rhendricks/metadata_logs 9241 & + nohup metadata_server --log_path=/home/rhendricks/metadata_logs --port=9241 & $ MS_PID=$! Using ``nohup`` and ``&`` sends metadata server to run in the background. From 9d74995bd16c6b569c126fa4500a9cef2eb28697 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 1 May 2023 09:39:56 +0300 Subject: [PATCH 531/882] Enabling High Bin Control Granularity --- configuration_guides/copy_to_restrict_utf8.rst | 4 ++-- configuration_guides/cpu_reduce_hashtable_size.rst | 11 ----------- 2 files changed, 2 insertions(+), 13 deletions(-) delete mode 100644 configuration_guides/cpu_reduce_hashtable_size.rst diff --git a/configuration_guides/copy_to_restrict_utf8.rst b/configuration_guides/copy_to_restrict_utf8.rst index 5d5990243..869de3bea 100644 --- a/configuration_guides/copy_to_restrict_utf8.rst +++ b/configuration_guides/copy_to_restrict_utf8.rst @@ -3,10 +3,10 @@ ************************* Enabling High Bin Control Granularity ************************* -The ``copyToRestrictUtf8`` flag sets sets the custom bin size in the cache to enable high bin control granularity. +The ``copyToRestrictUtf8`` flag sets the custom bin size in the cache to enable high bin control granularity. The following describes the ``copyToRestrictUtf8`` flag: * **Data type** - boolean * **Default value** - ``false`` -* **Allowed values** - ``true``, ``false`` \ No newline at end of file +* **Allowed values** - ``true``, ``false`` diff --git a/configuration_guides/cpu_reduce_hashtable_size.rst b/configuration_guides/cpu_reduce_hashtable_size.rst deleted file mode 100644 index c2b01604c..000000000 --- a/configuration_guides/cpu_reduce_hashtable_size.rst +++ /dev/null @@ -1,11 +0,0 @@ -.. _cpu_reduce_hashtable_size: - -************************* -Enabling High Bin Control Granularity -************************* -The ``copyToRestrictUtf8`` flag sets the custom bin size in the cache to enable high bin control granularity. - -The following describes the ``checkCudaMemory`` flag: - -* **Data type** - boolean -* **Default value** - ``FALSE`` \ No newline at end of file From c3cbd34723057d5401c0855881ac7e1576d03d97 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 1 May 2023 10:08:31 +0300 Subject: [PATCH 532/882] Update trunc.rst --- .../sql_functions/scalar_functions/date_and_time/trunc.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/date_and_time/trunc.rst b/reference/sql/sql_functions/scalar_functions/date_and_time/trunc.rst index 1e888cfe5..e3511281f 100644 --- a/reference/sql/sql_functions/scalar_functions/date_and_time/trunc.rst +++ b/reference/sql/sql_functions/scalar_functions/date_and_time/trunc.rst @@ -1,7 +1,7 @@ .. _date_trunc: ************************** -TRUNC +Date and Time TRUNC ************************** Truncates a ``DATE`` or ``DATETIME`` value to a specified resolution. @@ -104,7 +104,7 @@ For these examples, consider the following table and contents: .. code-block:: postgres - CREATE TABLE cool_dates(name TEXT(40), d DATE, dt DATETIME); + CREATE TABLE cool_dates(name VARCHAR(40), d DATE, dt DATETIME); INSERT INTO cool_dates VALUES ('Marty McFly goes back to this time','1955-11-05','1955-11-05 01:21:00.000') , ('Marty McFly came from this time', '1985-10-26', '1985-10-26 01:22:00.000') From fca1920d0327330978f4ce68d77eecaab294d4ed Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 1 May 2023 15:41:39 +0300 Subject: [PATCH 533/882] Update 4.2.rst --- releases/4.2.rst | 31 ++++++++++++++++++++++++++----- 1 file changed, 26 insertions(+), 5 deletions(-) diff --git a/releases/4.2.rst b/releases/4.2.rst index 7fe2f2be3..cdf623084 100644 --- a/releases/4.2.rst +++ b/releases/4.2.rst @@ -42,10 +42,31 @@ Newly Released Connector Drivers * `.jar file <https://sq-ftp-public.s3.amazonaws.com/Spark-Sqream-Connector-5.0.0.jar>`_ * :ref:`Documentation<spark>` -Storage Version ---------------- - -The storage version presently in effect is version 46. +System Requirements +------------------- + ++-----------------------+------------------------------------------------------------------------+ +| System Requirement | Details | ++=======================+========================================================================+ +| Prerequisites version | 4.16 | ++-----------------------+------------------------------------------------------------------------+ +| OS support | * CentOS / REHL - 7.6 - 7.9 | +| | * IBM RedHat 7.6 | ++-----------------------+------------------------------------------------------------------------+ +| Nvidia driver | CUDA version 10.1 and 11.4.3 | ++-----------------------+------------------------------------------------------------------------+ +| Storage version | 46 | ++-----------------------+------------------------------------------------------------------------+ +| Driver compatibility | * JDBC 4.5.3 | +| | * ODBC 4.4.4 | +| | * NodeJS | +| | * .NET 3.0.2 | +| | * Pysqream 3.2.5 | ++-----------------------+------------------------------------------------------------------------+ + +Protocol +-------- +The client-server protocol version in this release is 8. SQream Studio Updates and Improvements -------------------------------------- @@ -63,7 +84,7 @@ Known Issues -Version 4.2 resolved Issues +Version 4.2 Resolved Issues ----------------------------- +------------------------+------------------------------------------------------------------------------------------+ From 541b91314a747f14e4c9e1debfedf8431f3ab651 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 1 May 2023 15:42:17 +0300 Subject: [PATCH 534/882] Update 4.3.rst --- releases/4.3.rst | 29 ++++++++++++++++++++++++----- 1 file changed, 24 insertions(+), 5 deletions(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index 63c3d2111..e951cc345 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -26,12 +26,31 @@ New Features Newly Released Connector Drivers -------------------------------- - +System Requirements +------------------- -Storage Version ---------------- - -The storage version presently in effect is version 46. ++-----------------------+------------------------------------------------------------------------+ +| System Requirement | Details | ++=======================+========================================================================+ +| Prerequisites version | 4.16 | ++-----------------------+------------------------------------------------------------------------+ +| OS support | * CentOS / REHL - 7.6 - 7.9 | +| | * IBM RedHat 7.6 | ++-----------------------+------------------------------------------------------------------------+ +| Nvidia driver | CUDA version 10.1 and 11.4.3 | ++-----------------------+------------------------------------------------------------------------+ +| Storage version | 46 | ++-----------------------+------------------------------------------------------------------------+ +| Driver compatibility | * JDBC 4.5.3 | +| | * ODBC 4.4.4 | +| | * NodeJS | +| | * .NET 3.0.2 | +| | * Pysqream 3.2.5 | ++-----------------------+------------------------------------------------------------------------+ + +Protocol +-------- +The client-server protocol version in this release is 8. SQream Studio Updates and Improvements -------------------------------------- From 9cae9c32e70d503fd75a6a2f009d62e566820ced Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 1 May 2023 16:37:18 +0300 Subject: [PATCH 535/882] Update 4.2.rst --- releases/4.2.rst | 49 ++++++++++++++++++++++++------------------------ 1 file changed, 25 insertions(+), 24 deletions(-) diff --git a/releases/4.2.rst b/releases/4.2.rst index cdf623084..d941f2076 100644 --- a/releases/4.2.rst +++ b/releases/4.2.rst @@ -42,31 +42,32 @@ Newly Released Connector Drivers * `.jar file <https://sq-ftp-public.s3.amazonaws.com/Spark-Sqream-Connector-5.0.0.jar>`_ * :ref:`Documentation<spark>` -System Requirements -------------------- +Compatibility Matrix +-------------------- -+-----------------------+------------------------------------------------------------------------+ -| System Requirement | Details | -+=======================+========================================================================+ -| Prerequisites version | 4.16 | -+-----------------------+------------------------------------------------------------------------+ -| OS support | * CentOS / REHL - 7.6 - 7.9 | -| | * IBM RedHat 7.6 | -+-----------------------+------------------------------------------------------------------------+ -| Nvidia driver | CUDA version 10.1 and 11.4.3 | -+-----------------------+------------------------------------------------------------------------+ -| Storage version | 46 | -+-----------------------+------------------------------------------------------------------------+ -| Driver compatibility | * JDBC 4.5.3 | -| | * ODBC 4.4.4 | -| | * NodeJS | -| | * .NET 3.0.2 | -| | * Pysqream 3.2.5 | -+-----------------------+------------------------------------------------------------------------+ - -Protocol --------- -The client-server protocol version in this release is 8. ++-------------------------+------------------------------------------------------------------------+ +| System Requirement | Details | ++=========================+========================================================================+ +| Supported OS | * CentOS / REHL - 7.6 - 7.9 | +| | * IBM RedHat 7.6 | ++-------------------------+------------------------------------------------------------------------+ +| Prerequisites version | 4.16 | ++-------------------------+------------------------------------------------------------------------+ +| supported Nvidia driver | CUDA version from 10.1 up to 11.4.3 | ++-------------------------+------------------------------------------------------------------------+ +| Storage version | 46 | ++-------------------------+------------------------------------------------------------------------+ +| Connection Protocol | The client-server protocol version in this release is 8 | ++-------------------------+------------------------------------------------------------------------+ +| Driver compatibility | * JDBC 4.5.8 | +| | * ODBC 4.4.4 | +| | * NodeJS | +| | * .NET 3.0.2 | +| | * Pysqream 3.2.5 | +| | * Spark | ++-------------------------+------------------------------------------------------------------------+ + + SQream Studio Updates and Improvements -------------------------------------- From b457712d30fe7b4d4083985814f1dddb2aa15f4e Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 1 May 2023 16:37:45 +0300 Subject: [PATCH 536/882] Update 4.3.rst --- releases/4.3.rst | 47 +++++++++++++++++++++++------------------------ 1 file changed, 23 insertions(+), 24 deletions(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index e951cc345..19d032b84 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -26,31 +26,30 @@ New Features Newly Released Connector Drivers -------------------------------- -System Requirements -------------------- +Compatibility Matrix +-------------------- -+-----------------------+------------------------------------------------------------------------+ -| System Requirement | Details | -+=======================+========================================================================+ -| Prerequisites version | 4.16 | -+-----------------------+------------------------------------------------------------------------+ -| OS support | * CentOS / REHL - 7.6 - 7.9 | -| | * IBM RedHat 7.6 | -+-----------------------+------------------------------------------------------------------------+ -| Nvidia driver | CUDA version 10.1 and 11.4.3 | -+-----------------------+------------------------------------------------------------------------+ -| Storage version | 46 | -+-----------------------+------------------------------------------------------------------------+ -| Driver compatibility | * JDBC 4.5.3 | -| | * ODBC 4.4.4 | -| | * NodeJS | -| | * .NET 3.0.2 | -| | * Pysqream 3.2.5 | -+-----------------------+------------------------------------------------------------------------+ - -Protocol --------- -The client-server protocol version in this release is 8. ++-------------------------+------------------------------------------------------------------------+ +| System Requirement | Details | ++=========================+========================================================================+ +| Supported OS | * CentOS / REHL - 7.6 - 7.9 | +| | * IBM RedHat 7.6 | ++-------------------------+------------------------------------------------------------------------+ +| Prerequisites version | 4.16 | ++-------------------------+------------------------------------------------------------------------+ +| supported Nvidia driver | CUDA version from 10.1 up to 11.4.3 | ++-------------------------+------------------------------------------------------------------------+ +| Storage version | 46 | ++-------------------------+------------------------------------------------------------------------+ +| Connection Protocol | The client-server protocol version in this release is 8 | ++-------------------------+------------------------------------------------------------------------+ +| Driver compatibility | * JDBC 4.5.8 | +| | * ODBC 4.4.4 | +| | * NodeJS | +| | * .NET 3.0.2 | +| | * Pysqream 3.2.5 | +| | * Spark | ++-------------------------+------------------------------------------------------------------------+ SQream Studio Updates and Improvements -------------------------------------- From a41c4ce72534f425c91a6281285fb56536c8b54f Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 2 May 2023 09:43:22 +0300 Subject: [PATCH 537/882] release --- releases/4.2.rst | 4 ---- releases/4.3.rst | 4 ---- 2 files changed, 8 deletions(-) diff --git a/releases/4.2.rst b/releases/4.2.rst index d941f2076..87f266740 100644 --- a/releases/4.2.rst +++ b/releases/4.2.rst @@ -51,14 +51,10 @@ Compatibility Matrix | Supported OS | * CentOS / REHL - 7.6 - 7.9 | | | * IBM RedHat 7.6 | +-------------------------+------------------------------------------------------------------------+ -| Prerequisites version | 4.16 | -+-------------------------+------------------------------------------------------------------------+ | supported Nvidia driver | CUDA version from 10.1 up to 11.4.3 | +-------------------------+------------------------------------------------------------------------+ | Storage version | 46 | +-------------------------+------------------------------------------------------------------------+ -| Connection Protocol | The client-server protocol version in this release is 8 | -+-------------------------+------------------------------------------------------------------------+ | Driver compatibility | * JDBC 4.5.8 | | | * ODBC 4.4.4 | | | * NodeJS | diff --git a/releases/4.3.rst b/releases/4.3.rst index 19d032b84..35403320c 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -35,14 +35,10 @@ Compatibility Matrix | Supported OS | * CentOS / REHL - 7.6 - 7.9 | | | * IBM RedHat 7.6 | +-------------------------+------------------------------------------------------------------------+ -| Prerequisites version | 4.16 | -+-------------------------+------------------------------------------------------------------------+ | supported Nvidia driver | CUDA version from 10.1 up to 11.4.3 | +-------------------------+------------------------------------------------------------------------+ | Storage version | 46 | +-------------------------+------------------------------------------------------------------------+ -| Connection Protocol | The client-server protocol version in this release is 8 | -+-------------------------+------------------------------------------------------------------------+ | Driver compatibility | * JDBC 4.5.8 | | | * ODBC 4.4.4 | | | * NodeJS | From 82e46f731921e326fe665893ba8c809fab7e2dc9 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 4 May 2023 09:16:13 +0300 Subject: [PATCH 538/882] Update supported_data_types.rst --- data_type_guides/supported_data_types.rst | 11 +++-------- 1 file changed, 3 insertions(+), 8 deletions(-) diff --git a/data_type_guides/supported_data_types.rst b/data_type_guides/supported_data_types.rst index afc735ad1..5889307ff 100644 --- a/data_type_guides/supported_data_types.rst +++ b/data_type_guides/supported_data_types.rst @@ -51,21 +51,16 @@ The following table shows the supported data types. - 8 bytes - ``0.000003`` - ``FLOAT``/``DOUBLE PRECISION`` - * - ``TEXT [(n)]`` + * - ``TEXT (n)`` - Variable length string - UTF-8 unicode - - Up to ``4*n`` bytes - - ``'キウイは楽しい鳥です'`` + - Up to ``4`` bytes + - ``'Kiwis have tiny wings, but cannot fly.'`` - ``CHAR VARYING``, ``CHAR``, ``CHARACTER VARYING``, ``CHARACTER``, ``NATIONAL CHARACTER VARYING``, ``NATIONAL CHARACTER``, ``NCHAR VARYING``, ``NCHAR`` * - ``NUMERIC`` - 38 digits - 16 bytes - ``0.123245678901234567890123456789012345678`` - ``DECIMAL`` - * - ``TEXT (n)`` - - Variable length string - ASCII only - - ``n`` bytes - - ``'Kiwis have tiny wings, but cannot fly.'`` - - ``SQL VARIANT`` * - ``DATE`` - Date - 4 bytes From c2e12b8ac57e01f4524f5376676f31880bb1553c Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 4 May 2023 10:57:11 +0300 Subject: [PATCH 539/882] Update index.rst --- .../sql/sql_functions/scalar_functions/index.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/index.rst b/reference/sql/sql_functions/scalar_functions/index.rst index aac74d8e2..cb749a8b6 100644 --- a/reference/sql/sql_functions/scalar_functions/index.rst +++ b/reference/sql/sql_functions/scalar_functions/index.rst @@ -8,12 +8,12 @@ The **Built-In Scalar Functions** page describes functions that return one value .. hlist:: :columns: 5 - * `AND <https://docs.sqream.com/en/v2022.1/reference/sql/sql_functions/scalar_functions/bitwise/and.html>`_ - * `NOT <https://docs.sqream.com/en/v2022.1/reference/sql/sql_functions/scalar_functions/bitwise/not.html>`_ - * `OR <https://docs.sqream.com/en/v2022.1/reference/sql/sql_functions/scalar_functions/bitwise/or.html>`_ - * `SHIFT_LEFT <https://docs.sqream.com/en/v2022.1/reference/sql/sql_functions/scalar_functions/bitwise/shift_left.html>`_ - * `SHIFT_RIGHT <https://docs.sqream.com/en/v2022.1/reference/sql/sql_functions/scalar_functions/bitwise/shift_right.html>`_ - * `XOR <https://docs.sqream.com/en/v2022.1/reference/sql/sql_functions/scalar_functions/bitwise/xor.html>`_ + * :ref:`bitwise_and` + * :ref:`bitwise_not` + * :ref:`bitwise_or` + * :ref:`bitwise_shift_left` + * :ref:`bitwise_shift_right` + * :ref:`bitwise_xor` * :ref:`between` * :ref:`case` * :ref:`coalesce` From e6b418aa82c746d8040f74deba3dfc15f239b1ca Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 4 May 2023 10:57:11 +0300 Subject: [PATCH 540/882] Update index.rst From ec3dd3c15adc80fb9881bf79b585c003d7f59407 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 4 May 2023 12:22:34 +0300 Subject: [PATCH 541/882] Tableau Connector --- .../client_drivers/jdbc/index.rst | 2 - .../client_platforms/tableau.rst | 102 +++++++----------- 2 files changed, 39 insertions(+), 65 deletions(-) diff --git a/connecting_to_sqream/client_drivers/jdbc/index.rst b/connecting_to_sqream/client_drivers/jdbc/index.rst index e50648dfa..3f625759c 100644 --- a/connecting_to_sqream/client_drivers/jdbc/index.rst +++ b/connecting_to_sqream/client_drivers/jdbc/index.rst @@ -5,8 +5,6 @@ JDBC ************************* The SQream JDBC driver lets you connect to SQream using many Java applications and tools. This page describes how to write a Java application using the JDBC interface. The JDBC driver requires Java 1.8 or newer. -The JDBC page includes the following sections: - .. contents:: :local: :depth: 1 diff --git a/connecting_to_sqream/client_platforms/tableau.rst b/connecting_to_sqream/client_platforms/tableau.rst index 279552c34..bd21a756a 100644 --- a/connecting_to_sqream/client_platforms/tableau.rst +++ b/connecting_to_sqream/client_platforms/tableau.rst @@ -4,91 +4,69 @@ Connecting to SQream Using Tableau ************************* -Overview -===================== -SQream's Tableau connector plugin, based on standard JDBC, enables storing and fast querying large volumes of data. +SQream's Tableau connector, based on standard JDBC, enables storing and fast querying large volumes of data. This connector is useful for users who want to integrate and analyze data from various sources within the Tableau platform. With the Tableau connector, users can easily connect to databases and cloud applications and perform high-speed queries on large datasets. Additionally, the connector allows for seamless integration with Tableau, enabling users to visualize their data. -The **Connecting to SQream Using Tableau** page is a Quick Start Guide that describes how install Tableau and the JDBC driver and connect to SQream for data analysis. It also describes using best practices and troubleshoot issues that may occur while installing Tableau. SQream supports both Tableau Desktop and Tableau Server on Windows, MacOS, and Linux distributions. +SQream supports both Tableau Desktop and Tableau Server on Windows, MacOS, and Linux distributions. -For more information on SQream's integration with Tableau, see `Tableau's Extension Gallery <https://extensiongallery.tableau.com/connectors?version=2019.4>`_. - -The Connecting to SQream Using Tableau page describes the following: +For more information on SQream's integration with Tableau, see `Tableau Connectors <https://extensiongallery.tableau.com/connectors?version=2019.4>`_. .. contents:: :local: :depth: 1 -Installing the JDBC Driver and Tableau Connector Plugin -------------------- -This section describes how to install the JDBC driver using the fully-integrated Tableau connector plugin (Tableau Connector, or **.taco** file). SQream has been tested with Tableau versions 9.2 and newer. - -You can connect to SQream using Tableau by doing one of the following: +Prerequisites +------------- - * **For MacOS or Linux** - See :ref:`Installing the JDBC Driver <tableau_jdbc_installer>`. - -.. _tableau_jdbc_installer: - -Installing the JDBC Driver -------------------- -If you are using MacOS, Linux, or the Tableau server, after installing the Tableau Desktop application you can install the JDBC driver manually. When the driver is installed, you can connect to SQream. +It is essential that you have the following installed: -**To install the JDBC driver:** - -1. Download the JDBC installer and SQream Tableau connector (.taco) file from the :ref:`from the client drivers page<client_drivers>`. - - :: +* :ref:`JDBC <java_jdbc>` +* Tableau version 9.2 or newer -2. Based on your operating system, your Tableau driver directory is located in one of the following places: +Installing the Tableau Connector +-------------------------------- - * **Tableau Desktop on MacOS:** *~/Library/Tableau/Drivers* - - :: - - * **Tableau Desktop on Windows:** *C:\\Program Files\\Tableau\\Drivers* - - :: - - * **Tableau on Linux**: */opt/tableau/tableau_driver/jdbc* - - Note the following when installing the JDBC driver: +#. Download the :ref:`Tableau Connector <client_drivers>` ``SQreamDB.taco`` file. - * You must have read permissions on the .jar file. - - :: - - * Tableau requires a JDBC 4.0 or later driver. - - :: - - * Tableau requires a Type 4 JDBC driver. + Based on your operating system, you may find the Tableau driver directory here: - :: - - * The latest 64-bit version of Java 8 is installed. - -3. Install the **SQreamDB.taco** file by moving the SQreamDB.taco file into the Tableau connectors directory. + * Tableau Desktop on MacOS: ``~/Library/Tableau/Drivers`` + * Tableau Desktop on Windows: ``C:\Program Files\Tableau\Drivers`` + * Tableau on Linux: ``/opt/tableau/tableau_driver/jdbc`` - Based on the installation method that you used, your Tableau driver directory is located in one of the following places: +#. Based on the installation method that you used for installing Tableau, place the Tableau Connector ``SQreamDB.taco`` file in the Tableau connector directory: - * **Tableau Desktop on Windows:** *C:\\Users\\<your user>\\My Tableau Repository\\Connectors* +.. list-table:: + :widths: auto + :header-rows: 1 - :: - - * **Tableau Desktop on MacOS:** *~/My Tableau Repository/Connectors* + * - Product / Platform + - Path + * - Tableau Desktop for Windows + - ``C:\Users[user]\Documents\My Tableau Repository\Connectors`` + * - Tableau Desktop for Mac + - ``/Users/[user]/Documents/My Tableau Repository/Connectors`` + * - Tableau Prep for Windows + - ``C:\Users[user]\Documents\My Tableau Prep Repository\Connectors`` + * - Tableau Prep for Mac + - ``/Users/[user]/Documents/My Tableau Prep Repository/Connectors`` + * - Flow web authoring on Tableau Server + - ``/data/tabsvc/flowqueryservice/Connectors`` + * - Tableau Prep Conductor on Tableau Server + - ``/data/tabsvc/flowprocessor/Connectors`` + * - Tableau Server + - ``C:\ProgramData\Tableau\Tableau Server\data\tabsvc\vizqlserver\Connectors`` -You can now restart Tableau Desktop or Server to begin using the SQream driver by connecting to SQream as described in the section below. +3. Restart Tableau Desktop or Tableau server. Connecting to SQream --------------------- -After installing the JDBC driver you can connect to SQream. -**To connect to SQream:** #. Start Tableau Desktop. :: -#. In the **Connect** menu, in the **To a Server** sub-menu, click **More...**. +#. In the **Connect** menu, click **More** in the To a Server sub-menu. More connection options are displayed. @@ -102,6 +80,8 @@ After installing the JDBC driver you can connect to SQream. #. In the New Connection dialog box, fill in the fields and click **Sign In**. + The connection is established, and the data source page is displayed. + The following table describes the fields: .. list-table:: @@ -133,10 +113,6 @@ After installing the JDBC driver you can connect to SQream. - Sets SSL as a requirement for establishing this connection. - -The connection is established and the data source page is displayed. - -.. _set_up_sqream_tables_as_data_sources: - Setting Up SQream Tables as Data Sources ---------------- After connecting to SQream you must set up the SQream tables as data sources. From ea0b065b2b7d73b832d2a3584df1e9e4cc2b73d0 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 4 May 2023 15:02:18 +0300 Subject: [PATCH 542/882] Update tableau.rst --- .../client_platforms/tableau.rst | 103 +++--------------- 1 file changed, 17 insertions(+), 86 deletions(-) diff --git a/connecting_to_sqream/client_platforms/tableau.rst b/connecting_to_sqream/client_platforms/tableau.rst index bd21a756a..7e4e92509 100644 --- a/connecting_to_sqream/client_platforms/tableau.rst +++ b/connecting_to_sqream/client_platforms/tableau.rst @@ -19,19 +19,24 @@ Prerequisites It is essential that you have the following installed: -* :ref:`JDBC <java_jdbc>` * Tableau version 9.2 or newer -Installing the Tableau Connector --------------------------------- +Setting Up JDBC +---------------- -#. Download the :ref:`Tableau Connector <client_drivers>` ``SQreamDB.taco`` file. +#. Download the SQream JDBC Connector :ref:`.jar file <client_drivers>`. +#. Place the JDBC .jar file in the Tableau driver directory. - Based on your operating system, you may find the Tableau driver directory here: + Based on your operating system, you may find the Tableau driver directory in one of the following locations: * Tableau Desktop on MacOS: ``~/Library/Tableau/Drivers`` * Tableau Desktop on Windows: ``C:\Program Files\Tableau\Drivers`` * Tableau on Linux: ``/opt/tableau/tableau_driver/jdbc`` + +Installing the Tableau Connector +-------------------------------- + +#. Download the :ref:`Tableau Connector <client_drivers>` ``SQreamDB.taco`` file. #. Based on the installation method that you used for installing Tableau, place the Tableau Connector ``SQreamDB.taco`` file in the Tableau connector directory: @@ -66,29 +71,29 @@ Connecting to SQream :: -#. In the **Connect** menu, click **More** in the To a Server sub-menu. +#. In the **Connect** menu, under the **To a Server** option , click **More**. - More connection options are displayed. + Additional connection options are displayed. :: #. Select **SQream DB by SQream Technologies**. - The **New Connection** dialog box is displayed. + The connection dialog box is displayed. :: -#. In the New Connection dialog box, fill in the fields and click **Sign In**. +#. In the connection dialog box, fill in the fields and click **Sign In**. The connection is established, and the data source page is displayed. - The following table describes the fields: +Information about step 4 fields: .. list-table:: :widths: 15 38 38 :header-rows: 1 - * - Item + * - Field name - Description - Example * - Server @@ -109,83 +114,9 @@ Connecting to SQream * - Password - Specifies the password of the selected role. - ``Tr0ub4dor&3`` - * - Require SSL (recommended) + * - Require SSL - Sets SSL as a requirement for establishing this connection. - -Setting Up SQream Tables as Data Sources ----------------- -After connecting to SQream you must set up the SQream tables as data sources. - -**To set up SQream tables as data sources:** - -1. From the **Table** menu, select the desired database and schema. - - SQream's default schema is **public**. - - :: - -#. Drag the desired tables into the main area (labeled **Drag tables here**). - - This area is also used for specifying joins and data source filters. - - :: - -#. Open a new sheet to analyze data. - -Tableau Best Practices and Troubleshooting ---------------- -This section describes the following best practices and troubleshooting procedures when connecting to SQream using Tableau: - -.. contents:: - :local: - -Using Tableau's Table Query Syntax -~~~~~~~~~~~~~~~~~~~ -Dragging your desired tables into the main area in Tableau builds queries based on its own syntax. This helps ensure increased performance, while using views or custom SQL may degrade performance. In addition, SQream recommends using the :ref:`create_view` to create pre-optimized views, which your datasources point to. - -Creating a Separate Service for Tableau -~~~~~~~~~~~~~~~~~~~ -SQream recommends creating a separate service for Tableau with the DWLM. This reduces the impact that Tableau has on other applications and processes, such as ETL. In addition, this works in conjunction with the load balancer to ensure good performance. - -Troubleshooting Workbook Performance Before Deploying to the Tableau Server -~~~~~~~~~~~~~~~~~~~ -Tableau has a built-in `performance recorder <https://help.tableau.com/current/pro/desktop/en-us/perf_record_create_desktop.htm>`_ that shows how time is being spent. If you're seeing slow performance, this could be the result of a misconfiguration such as setting concurrency too low. - -Use the Tableau Performance Recorder for viewing the performance of queries run by Tableau. You can use this information to identify queries that can be optimized by using views. - -Troubleshooting Error Codes -~~~~~~~~~~~~~~~~~~~ -Tableau may be unable to locate the SQream JDBC driver. The following message is displayed when Tableau cannot locate the driver: - -.. code-block:: console - - Error Code: 37CE01A3, No suitable driver installed or the URL is incorrect - -**To troubleshoot error codes:** - -If Tableau cannot locate the SQream JDBC driver, do the following: - - 1. Verify that the JDBC driver is located in the correct directory: - - * **Tableau Desktop on Windows:** *C:\Program Files\Tableau\Drivers* - - :: - - * **Tableau Desktop on MacOS:** *~/Library/Tableau/Drivers* - - :: - - * **Tableau on Linux**: */opt/tableau/tableau_driver/jdbc* - - 2. Find the file path for the JDBC driver and add it to the Java classpath: - - * **For Linux** - ``export CLASSPATH=<absolute path of SQream DB JDBC driver>;$CLASSPATH`` - - :: - - * **For Windows** - add an environment variable for the classpath: - .. image:: /_static/images/Third_Party_Connectors/tableau/envrionment_variable_for_classpath.png -If you experience issues after restarting Tableau, contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_ \ No newline at end of file From 0f2646b9229fdef476d0e00475fd95b8c18f8a6d Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 4 May 2023 15:04:55 +0300 Subject: [PATCH 543/882] Update index.rst --- connecting_to_sqream/client_drivers/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index cc6b670c0..d32b9684b 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -17,7 +17,7 @@ The following are applicable to all operating systems: * **JDBC** - recommended installation via ``mvn``: - * `JDBC .jar file <https://sq-ftp-public.s3.amazonaws.com/sqream-jdbc-4.5.6.jar>`_ - sqream-jdbc-4.5.3 (.jar) + * `JDBC .jar file <https://sq-ftp-public.s3.amazonaws.com/sqream-jdbc-4.5.6.jar>`_ - sqream-jdbc-4.5.6 (.jar) * :ref:`java_jdbc` .. _.net: From 6527df050608b4dbd380be9e319e688bb9ed8fb5 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 4 May 2023 15:07:39 +0300 Subject: [PATCH 544/882] Update hardware_guide.rst --- getting_started/hardware_guide.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/getting_started/hardware_guide.rst b/getting_started/hardware_guide.rst index b8d9691fd..ace6734cf 100644 --- a/getting_started/hardware_guide.rst +++ b/getting_started/hardware_guide.rst @@ -95,7 +95,7 @@ The following table shows SQream's recommended hardware specifications: * - External Storage - * Mellanox Connectx5/6 100G NVIDIA Network Card (if applicable) or other high speed network card minimum 40G compatible to customer’s infrastructure - * 50 TB (NAS connected over GPFS, Lustre, or NFS) GPFS recommended + * 50 TB (NAS connected over GPFS, Lustre, Weka, or VAST) GPFS recommended * - GPU - 2x A100 NVIDIA * - Operating System @@ -126,7 +126,7 @@ The following table shows SQream's recommended metadata server specifications: * - Operating System - Red Hat Enterprise Linux v7.x or CentOS v7.x or Amazon Linux -.. note:: With a NAS connected over GPFS, Lustre, or NFS, each SQream worker can read data at up to 5GB/s. +.. note:: With a NAS connected over GPFS, Lustre, Weka, or VAST, each SQream worker can read data at up to 5GB/s. SQream Studio Server Example ----------------------------------- From 0328263fcb33ed501934fb61c19cab492b9d6d31 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 8 May 2023 10:40:30 +0300 Subject: [PATCH 545/882] GET TOTAL CHUNKS SIZE --- reference/sql/sql_statements/index.rst | 2 + .../get_all_roles_database_ddl.rst | 52 ++++++++++++------- 2 files changed, 36 insertions(+), 18 deletions(-) diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index 325647bda..db8241ec8 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -122,6 +122,8 @@ The following table shows the Utility commands: - View the ``CREATE TABLE`` statement for a table * - :ref:`SELECT GET_FUNCTION_DDL<get_function_ddl>` - View the ``CREATE FUNCTION`` statement for a UDF + * - :ref:`SELECT GET_TOTAL_CHUNKS_SIZE<get_total_chunks_size>` + - Shows the total size of all data chunks saved in the system in both compressed and uncompressed formats * - :ref:`SELECT GET_VIEW_DDL<get_view_ddl>` - View the ``CREATE VIEW`` statement for a view * - :ref:`SELECT RECOMPILE_VIEW<recompile_view>` diff --git a/reference/sql/sql_statements/utility_commands/get_all_roles_database_ddl.rst b/reference/sql/sql_statements/utility_commands/get_all_roles_database_ddl.rst index 430ede73e..b6c8ad141 100644 --- a/reference/sql/sql_statements/utility_commands/get_all_roles_database_ddl.rst +++ b/reference/sql/sql_statements/utility_commands/get_all_roles_database_ddl.rst @@ -1,9 +1,9 @@ -.. _get_all_roles_database_ddl: +.. _get_total_chunks_size: ******************** -GET_ALL_ROLES_DATABASE_DDL +GET TOTAL CHUNKS SIZE ******************** -The ``GET_ALL_ROLES_DATABASE_DDL`` statement returns the definition of all role databases in DDL format. +The ``get_total_chunks_size`` function returns the total size of all data chunks saved in the system in both compressed and uncompressed formats. .. contents:: :local: @@ -11,36 +11,52 @@ The ``GET_ALL_ROLES_DATABASE_DDL`` statement returns the definition of all role Syntax ========== -The following is the correct syntax for using the ``GET_ALL_ROLES_DATABASE_DDL`` statement: .. code-block:: postgres - select get_all_roles_database_ddl() + SELECT get_total_chunks_size(<OUTPUT_UNITS>, [DATABASE_NAME], [SCHEMA_NAME, [TABLE_NAME]]) + +Parameters +============ +The following table shows the ``SELECT get_total_chunks_size`` parameters: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - State + - Description + * - ``OUTPUT_UNITS`` + - Mandatory + - Specifies the desired unit of measurement for the output size, with valid values of ``BYTE``, ``MB``, ``GB``, ``TB``, or ``PB`` + * - ``DATABASE_NAME`` + - Optional + - Specifies the name of the database to analyze. If not specified, the function will analyze all databases in the cluster. + * - ``SCHEMA_NAME`` + - Optional + - Specifies the name of the schema to analyze. If not specified, the function will analyze all schemas in the specified database. + * - ``TABLE_NAME`` + - Optional + - Specifies the name of a specific table to analyze. If not specified, the function will analyze all tables in the specified schema. Example =========== -The following is an example of using the ``GET_ALL_ROLES_DATABASE_DDL`` statement: .. code-block:: psql - select get_all_roles_database_ddl(); + SELECT get_total_chunks_size('MB'); Output ========== -The following is an example of the output of the ``GET_ALL_ROLES_DATABASE_DDL`` statement: + .. code-block:: postgres - grant create, usage on schema "public" to "public" ; alter default schema for "public" to "public"; alter default permissions for "public" for schemas grant superuser to creator_role ; alter default permissions for "public" for tables grant select, insert, delete, ddl, update to creator_role ; grant select, insert, delete, ddl, update on table "public"."customer" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."d_customer" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."demo_customer" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."demo_lineitem" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."lineitem" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."nation" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."orders" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."part" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."partsupp" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."region" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."supplier" to "sqream" ; alter default schema for "sqream" to "public"; + compression-type | value | size | + -------------------------+--------------------------------+-------+ + Compressed | 0.00036144256591796875 | MB | + Uncompressed | 0.00036144256591796875 | MB | Permissions ============= -Using the ``GET_ALL_ROLES_DATABASE_DDL`` statement requires no special permissions. - -For more information, see the following: - -* :ref:`get_all_roles_global_ddl` - - :: - -* :ref:`get_role_permissions` \ No newline at end of file From f0df1c91b19af5fd5fe1237c5dd31aa97d603a02 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 8 May 2023 11:35:27 +0300 Subject: [PATCH 546/882] Update index.rst --- reference/sql/sql_statements/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index db8241ec8..3a682bf3c 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -103,7 +103,7 @@ The following table shows the Utility commands: .. list-table:: :widths: 10 100 :header-rows: 1 - + * - Command - Usage * - :ref:`DROP SAVED QUERY<drop_saved_query>` From 5fe95343b675764ba4dd87f20cb7f9e8092150c0 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 8 May 2023 13:07:20 +0300 Subject: [PATCH 547/882] Update index.rst --- reference/sql/sql_statements/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index 3a682bf3c..e13113ae4 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -103,7 +103,7 @@ The following table shows the Utility commands: .. list-table:: :widths: 10 100 :header-rows: 1 - + * - Command - Usage * - :ref:`DROP SAVED QUERY<drop_saved_query>` From f4cf974c799750d2268349e8a70fefae38987822 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 8 May 2023 13:31:32 +0300 Subject: [PATCH 548/882] ODBC Installer --- connecting_to_sqream/client_drivers/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index d32b9684b..26a6750ea 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -77,7 +77,7 @@ Windows -------------- The following are applicable to Windows: -* **ODBC installer** - SQream Drivers v2020.2.0, with Tableau customizations. Please contact your `Sqream represenative <https://sqream.atlassian.net/servicedesk/customer/portal/2>`_ for this installer. +* **ODBC installer** - SQream Drivers v2020.2.0. Please contact your `Sqream representative <https://sqream.atlassian.net/servicedesk/customer/portal/2>`_ for this installer. For more information on installing and configuring ODBC on Windows, see :ref:`Install and configure ODBC on Windows <install_odbc_windows>`. From c31eedb95ea662f6cc28f3815f0dc6a790440a60 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Tue, 9 May 2023 14:34:31 +0300 Subject: [PATCH 549/882] Update requirements.txt --- requirements.txt | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/requirements.txt b/requirements.txt index 806fe2730..a4fb056dd 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,7 +1,9 @@ # File: docs/requirements.txt # Defining the exact version will make sure things don't break -sphinx==3.5.3 -sphinx_rtd_theme==0.5.2 +sphinx==5.3.0 +sphinx_rtd_theme==1.2.0 +urllib3<=2.0.0 +openssl-python>=0.1.1 sphinx-notfound-page -Pygments>=2.4.0 +Pygments>=2.4.0 \ No newline at end of file From 8cb2c58efd4e3033cb4bcac88493409ddb7d7d49 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Sun, 14 May 2023 14:26:28 +0300 Subject: [PATCH 550/882] Update index.rst --- .../client_drivers/python/index.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/connecting_to_sqream/client_drivers/python/index.rst b/connecting_to_sqream/client_drivers/python/index.rst index 7db435a3b..bd71820d8 100644 --- a/connecting_to_sqream/client_drivers/python/index.rst +++ b/connecting_to_sqream/client_drivers/python/index.rst @@ -137,7 +137,7 @@ Standard Connection Example import sqlalchemy as sa - engine_url = "sqream://rhendricks:secret_passwor@localhost:5000/raviga" + engine_url = "sqream://rhendricks:secret_password@localhost:5000/raviga" engine = sa.create_engine(engine_url) @@ -156,13 +156,13 @@ The following example is for using a ServerPicker: import sqlalchemy as sa - engine_url = "sqream://dor:DorBerg123$@localhost:3108/pushlive" + engine_url = "sqream://rhendricks:secret_password@localhost:5000/raviga" engine = sa.create_engine(engine_url, connect_args={"clustered": True}) - res = engine.execute("create or replace table test100 (dor int);") - res = engine.execute('insert into test100 values (5), (6);') - res = engine.execute('select * from test100') + res = engine.execute("create or replace table tab1 (x int);") + res = engine.execute('insert into tab1 values (5), (6);') + res = engine.execute('select * from tab1') for item in res: print(item) @@ -176,7 +176,7 @@ The following example shows how to pull a table in Pandas. This examples uses th import sqlalchemy as sa import pandas as pd - engine_url = "sqream://rhendricks:secret_passwor@localhost:5000/raviga" + engine_url = "sqream://rhendricks:secret_password@localhost:5000/raviga" engine = sa.create_engine(engine_url) @@ -375,7 +375,7 @@ This section shows how to use the ORM to create and populate tables from Python import sqlalchemy as sa import pandas as pd - engine_url = "sqream://rhendricks:secret_passwor@localhost:5000/raviga" + engine_url = "sqream://rhendricks:secret_password@localhost:5000/raviga" engine = sa.create_engine(engine_url) From b4f270feb27d900bb756c6fbe0490435c4271b52 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 15 May 2023 17:17:07 +0300 Subject: [PATCH 551/882] Update 4.3.rst --- releases/4.3.rst | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index 35403320c..40f56cc37 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -70,7 +70,26 @@ Version 4.3 resolved Issues | **SQ No.** | **Description** | +========================+==========================================================================================+ | SQ-11108 | Slow ``COPY FROM`` statements using ORC files | -+------------------------+------------------------------------------------------------------------------------------+ ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-13112 | ``GRANT`` query queue issue | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-13201 | | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-13210 | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-13322 | Cleanup operation failure ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-13401 | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-13453 | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-13566 | ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-13587 | Large number multiple query execution using Python failure ++------------------------+------------------------------------------------------------------------------------------+ +| SQ-13694 | S3 access issue ++------------------------+------------------------------------------------------------------------------------------+ + Configuration Changes --------------------- From 8a672a88c23c9d402893eba9de718e5a3c10ec34 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 16 May 2023 11:30:10 +0300 Subject: [PATCH 552/882] Parquet compression algorithm --- data_ingestion/parquet.rst | 29 ++-- operational_guides/exporting_data.rst | 15 -- operational_guides/index.rst | 1 - .../sql_statements/dml_commands/copy_to.rst | 139 +++++++++--------- 4 files changed, 77 insertions(+), 107 deletions(-) delete mode 100644 operational_guides/exporting_data.rst diff --git a/data_ingestion/parquet.rst b/data_ingestion/parquet.rst index 2128cf17c..bb6bf05bb 100644 --- a/data_ingestion/parquet.rst +++ b/data_ingestion/parquet.rst @@ -3,16 +3,13 @@ ********************** Ingesting Data from a Parquet File ********************** -This guide covers ingesting data from Parquet files into SQream using :ref:`FOREIGN TABLE<foreign_tables>`, and describes the following; + +Ingesting Parquet files into SQream is generally useful when you want to store the data permanently and perform frequent queries on it. Ingesting the data can also make it easier to join with other tables in your database. However, if you wish to retain your data on external Parquet files instead of ingesting it into SQream due to it being an open-source column-oriented data storage format, you may also execute :ref:`FOREIGN TABLE<foreign_tables>` queries. .. contents:: :local: :depth: 1 - -Overview -=================== -SQream supports ingesting data into SQream from Parquet files. However, because it is an open-source column-oriented data storage format, you may want to retain your data on external Parquet files instead of ingesting it into SQream. SQream supports executing queries on external Parquet files. - + Preparing Your Parquet Files ===================== Prepare your source Parquet files according to the requirements described in the following table: @@ -155,7 +152,7 @@ Prepare your source Parquet files according to the requirements described in the - - Supported [#f4]_ -* Your statements will succeed even if your Parquet file contains an unsupported type, such as ``enum``, ``uuid``, ``time``, ``json``, ``bson``, ``lists``, ``maps``, but the data is not referenced in the table (it does not appear in the :ref:`SELECT` query). If the column containing the unsupported type is referenced, an error message is displayed explaining that the type is not supported and that the column may be ommitted. For solutions to this error message, see more information in **Managing Unsupported Column Types** example in the **Example** section. +Your statements will succeed even if your Parquet file contains unsupported types, such as ``enum``, ``uuid``, ``time``, ``json``, ``bson``, ``lists``, ``maps``, but the data is not referenced in the table (it does not appear in the :ref:`SELECT` query). If the column containing the unsupported type is referenced, an error message is displayed explaining that the type is not supported and that the column may be ommitted. For solutions to this error message, see more information in **Managing Unsupported Column Types** example in the **Example** section. .. rubric:: Footnotes @@ -169,17 +166,17 @@ Prepare your source Parquet files according to the requirements described in the Making Parquet Files Accessible to Workers ================================================================ -To give workers access to files every node must have the same view of the storage being used. +To give workers access to files, every node must have the same view of the storage being used. * For files hosted on NFS, ensure that the mount is accessible from all servers. -* For HDFS, ensure that SQream servers have access to the HDFS name node with the correct user-id. For more information, see :ref:`hdfs` guide for more information. +* For HDFS, ensure that SQream servers have access to the HDFS name node with the correct user-id. For more information, see :ref:`hdfs` guide. -* For S3, ensure network access to the S3 endpoint. For more information, see :ref:`s3` guide for more information. +* For S3, ensure network access to the S3 endpoint. For more information, see :ref:`s3` guide. Creating a Table =============================================== -Before loading data, you must build the CREATE TABLE to correspond with the file structure of the inserted table. +Before loading data, you must create a table that corresponds to the file structure of the table you wish to insert. The example in this section is based on the source nba.parquet table shown below: @@ -188,7 +185,7 @@ The example in this section is based on the source nba.parquet table shown below :widths: auto :header-rows: 1 -The following example shows the correct file structure used to create the ``CREATE EXTERNAL TABLE`` statement based on the nba.parquet table: +The following example shows the correct file structure used for creating a :ref:`FOREIGN TABLE<foreign_tables>` based on the nba.parquet table: .. code-block:: postgres @@ -215,12 +212,7 @@ The following example shows the correct file structure used to create the ``CREA .. note:: The **nba.parquet** file is stored on S3 at ``s3://sqream-demo-data/nba.parquet``. Ingesting Data into SQream -=================================== -This section describes the following: - -.. contents:: - :local: - :depth: 1 +========================== Syntax ----------- @@ -233,7 +225,6 @@ You can use the :ref:`create_table_as` statement to load the data into SQream, a Examples ---------------- -This section describes the following examples: .. contents:: :local: diff --git a/operational_guides/exporting_data.rst b/operational_guides/exporting_data.rst deleted file mode 100644 index 402887da7..000000000 --- a/operational_guides/exporting_data.rst +++ /dev/null @@ -1,15 +0,0 @@ -.. _exporting_data: - -*********************** -Exporting Data -*********************** -You can export data from SQream, which you may want to do for the following reasons: - - -* To use data in external tables. See `Working with External Data <https://docs.sqream.com/en/v2020-2/installation_guides/external_data.html>`_. -* To share data with other clients or consumers with different systems. -* To copy data into another SQream cluster. - -SQream provides the following methods for exporting data: - -* Copying data from a SQream database table or query to another file - See `COPY TO <https://docs.sqream.com/en/latest/reference/sql/sql_statements/dml_commands/copy_to.html>`_. \ No newline at end of file diff --git a/operational_guides/index.rst b/operational_guides/index.rst index 048efb06f..989d32435 100644 --- a/operational_guides/index.rst +++ b/operational_guides/index.rst @@ -17,7 +17,6 @@ This section summarizes the following operational guides: external_data foreign_tables delete_guide - exporting_data logging monitoring_query_performance security diff --git a/reference/sql/sql_statements/dml_commands/copy_to.rst b/reference/sql/sql_statements/dml_commands/copy_to.rst index 00264f50d..e10cbb677 100644 --- a/reference/sql/sql_statements/dml_commands/copy_to.rst +++ b/reference/sql/sql_statements/dml_commands/copy_to.rst @@ -3,19 +3,19 @@ ********************** COPY TO ********************** -The **COPY TO** page includes the following sections: -.. contents:: - :local: - :depth: 1 +The ``COPY TO`` statement is used for exporting data from a SQream database table or for exporting query results to a file on the filesystem. +You may wish to export data from SQream for any of the following reasons: -Overview -========== -``COPY ... TO`` is a statement that can be used to export data from a SQream database table or query to a file on the filesystem. +* To use data in external tables. See :ref:`Working with External Data<external_data>`. +* To share data with other clients or consumers using different systems. +* To copy data into another SQream cluster. -In general, ``COPY`` moves data between filesystem files and SQream DB tables. +In general, ``COPY`` moves data between filesystem files and SQream DB tables. If you wish to copy data from a file to a table, see :ref:`COPY FROM<copy_from>`. -.. note:: To copy data from a file to a table, see :ref:`COPY FROM<copy_from>`. +.. contents:: + :local: + :depth: 1 Syntax ========== @@ -100,8 +100,7 @@ The following table shows the ``COPY_TO`` elements: - Enforces the maximum file size (bytes). Permitted values: ``true`` - creates one file of unlimited size, ``false`` - permits creating several files together limited by the ``MAX_FILE_SIZE``. When set to ``true``, the single file size is not limited by the ``MAX_FILE_SIZE`` setting. When set to ``false``, the combined file sizes cannot exceed the ``MAX_FILE_SIZE``. Default value: ``TRUE``. Usage Notes -=============== -The **Usage Notes** describes the following: +=========== .. contents:: :local: @@ -109,7 +108,6 @@ The **Usage Notes** describes the following: Supported Field Delimiters ------------------------------ -The **Supported Field Delimiters** section describes the following: .. contents:: :local: @@ -410,15 +408,40 @@ The date format in the output CSV is formatted as ISO 8601 (``2019-12-31 20:30:5 For more information on the ``datetime`` format, see :ref:`sql_data_types_date`. Examples -=========== -The **Examples** section shows the following examples: +======== .. contents:: :local: :depth: 1 -Exporting a Table to a CSV File without a HEADER Row ------------------------------------- +Exporting Data From SQream to External File Tables +-------------------------------------------------- + +Exporting Tables to Parquet Files +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +The compression algorithm used for exporting data from SQream to Parquet files is Snappy. + +.. code-block:: psql + + COPY nba TO WRAPPER parquet_fdw OPTIONS (LOCATION = '/tmp/nba_export.parquet'); + +Exporting Query Results to Parquet Files +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. code-block:: psql + + COPY (select x,y from t where z=0) TO WRAPPER parquet_fdw OPTIONS (LOCATION = '/tmp/file.parquet'); + +Exporting Tables to ORC Files +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. code-block:: psql + + COPY nba TO WRAPPER orc_fdw OPTIONS (LOCATION = '/tmp/nba_export.orc'); + +CSV Files +^^^^^^^^^ + The following is an example of exporting a table to a CSV file without a HEADER row: .. code-block:: psql @@ -435,8 +458,6 @@ The following is an example of exporting a table to a CSV file without a HEADER Jonas Jerebko,Boston Celtics,8,PF,29,6-10,231,\N,5000000 Amir Johnson,Boston Celtics,90,PF,29,6-9,240,\N,12000000 -Exporting a Table to a CSV with a HEADER Row ------------------------------------------ The following is an example of exporting a table to a CSV file with a HEADER row: .. code-block:: psql @@ -452,9 +473,25 @@ The following is an example of exporting a table to a CSV file with a HEADER row John Holland,Boston Celtics,30,SG,27,6-5,205,Boston University,\N R.J. Hunter,Boston Celtics,28,SG,22,6-5,185,Georgia State,1148640 Jonas Jerebko,Boston Celtics,8,PF,29,6-10,231,\N,5000000 + +The following is an example of exporting the result of a query to a CSV file: + +.. code-block:: psql + + COPY (SELECT "Team", AVG("Salary") FROM nba GROUP BY 1) TO WRAPPER csv_fdw OPTIONS (LOCATION = '/tmp/nba_export.csv'); + +.. code-block:: console + + $ head -n5 nba_salaries.csv + Atlanta Hawks,4860196 + Boston Celtics,4181504 + Brooklyn Nets,3501898 + Charlotte Hornets,5222728 + Chicago Bulls,5785558 + +TSV Files +^^^^^^^^^ -Exporting a Table to TSV with a HEADER Row ------------------------------------------ The following is an example of exporting a table to a TSV file with a HEADER row: .. code-block:: psql @@ -471,78 +508,36 @@ The following is an example of exporting a table to a TSV file with a HEADER row R.J. Hunter Boston Celtics 28 SG 22 6-5 185 Georgia State 1148640 Jonas Jerebko Boston Celtics 8 PF 29 6-10 231 \N 5000000 -Using Non-Printable ASCII Characters as Delimiters -------------------------------------------------------- -The following is an example of using non-printable ASCII characters as delimiters: +Exporting Data From SQream to Cloud Storage +------------------------------------------- -Non-printable characters can be specified using their octal representations, by using the ``E'\000'`` format, where ``000`` is the octal value of the character. - -For example, ASCII character ``15``, known as "shift in", can be specified using ``E'\017'``. - -.. code-block:: psql - - COPY nba TO WRAPPER csv_fdw OPTIONS (LOCATION = '/tmp/nba_export.csv', DELIMITER = E'\017'); - -.. code-block:: psql - - COPY nba TO WRAPPER csv_fdw OPTIONS (LOCATION = '/tmp/nba_export.csv', DELIMITER = E'\011'); -- 011 is a tab character - -Exporting the Result of a Query to CSV File --------------------------------------------- -The following is an example of exporting the result of a query to a CSV file: - -.. code-block:: psql - - COPY (SELECT "Team", AVG("Salary") FROM nba GROUP BY 1) TO WRAPPER csv_fdw OPTIONS (LOCATION = '/tmp/nba_export.csv'); - -.. code-block:: console - - $ head -n5 nba_salaries.csv - Atlanta Hawks,4860196 - Boston Celtics,4181504 - Brooklyn Nets,3501898 - Charlotte Hornets,5222728 - Chicago Bulls,5785558 - -Saving Files to an Authenticated S3 Bucket --------------------------------------------- The following is an example of saving files to an authenticated S3 bucket: .. code-block:: psql COPY (SELECT "Team", AVG("Salary") FROM nba GROUP BY 1) TO WRAPPER csv_fdw OPTIONS (LOCATION = 's3://my_bucket/salaries/nba_export.csv', AWS_ID = 'my_aws_id', AWS_SECRET = 'my_aws_secret'); -Saving Files to an HDFS Path --------------------------------------------- The following is an example of saving files to an HDFS path: .. code-block:: psql COPY (SELECT "Team", AVG("Salary") FROM nba GROUP BY 1) TO WRAPPER csv_fdw OPTIONS (LOCATION = 'hdfs://pp_namenode:8020/nba_export.csv'); -Exporting a Table to a Parquet File ------------------------------- -The following is an example of exporting a table to a Parquet file: +Using Non-Printable ASCII Characters as Delimiters +-------------------------------------------------- +The following is an example of using non-printable ASCII characters as delimiters: -.. code-block:: psql - - COPY nba TO WRAPPER parquet_fdw OPTIONS (LOCATION = '/tmp/nba_export.parquet'); +Non-printable characters can be specified using their octal representations, by using the ``E'\000'`` format, where ``000`` is the octal value of the character. -Exporting a Query to a Parquet File --------------------------------- -The following is an example of exporting a query to a Parquet file: +For example, ASCII character ``15``, known as "shift in", can be specified using ``E'\017'``. .. code-block:: psql - - COPY (select x,y from t where z=0) TO WRAPPER parquet_fdw OPTIONS (LOCATION = '/tmp/file.parquet'); - -Exporting a Table to an ORC File ------------------------------- -The following is an example of exporting a table to an ORC file: + + COPY nba TO WRAPPER csv_fdw OPTIONS (LOCATION = '/tmp/nba_export.csv', DELIMITER = E'\017'); .. code-block:: psql - COPY nba TO WRAPPER orc_fdw OPTIONS (LOCATION = '/tmp/nba_export.orc'); + COPY nba TO WRAPPER csv_fdw OPTIONS (LOCATION = '/tmp/nba_export.csv', DELIMITER = E'\011'); -- 011 is a tab character Permissions ============= From 435809f9b3c815dea04e785ecbeb5f27fe135c2e Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 16 May 2023 16:38:49 +0300 Subject: [PATCH 553/882] Update not.rst --- reference/sql/sql_functions/scalar_functions/bitwise/not.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_functions/scalar_functions/bitwise/not.rst b/reference/sql/sql_functions/scalar_functions/bitwise/not.rst index 69d81e1ce..5a0d4bb7b 100644 --- a/reference/sql/sql_functions/scalar_functions/bitwise/not.rst +++ b/reference/sql/sql_functions/scalar_functions/bitwise/not.rst @@ -15,7 +15,7 @@ Syntax expr ::= integer - + Arguments ============ From e45ad5d628a1d9904f791cbcea7ae6a3291a48df Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 16 May 2023 17:12:15 +0300 Subject: [PATCH 554/882] Update charindex.rst --- .../scalar_functions/string/charindex.rst | 72 ++++++++++--------- 1 file changed, 38 insertions(+), 34 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/string/charindex.rst b/reference/sql/sql_functions/scalar_functions/string/charindex.rst index 9b00084f5..c8f2e4223 100644 --- a/reference/sql/sql_functions/scalar_functions/string/charindex.rst +++ b/reference/sql/sql_functions/scalar_functions/string/charindex.rst @@ -9,14 +9,14 @@ Returns the starting position of a string inside another string. See also :ref:`patindex`, :ref:`regexp_instr`. Syntax -========== +====== -.. code-block:: postgres +.. code-block:: sql - CHARINDEX ( needle_string_expr , haystack_string_expr [ , start_location ] ) + CHARINDEX ( needle_string_expr , haystack_string_expr [ , start_location ] ) -Arguments -============ +Parameters +========== .. list-table:: :widths: auto @@ -32,45 +32,49 @@ Arguments - An integer at which the search starts. This value is optional and when not supplied, the search starts at the beggining of ``needle_string_expr`` Returns -============ - -Integer start position of a match, or 0 if no match was found. - -Notes ======= -* If the value is NULL, the result is NULL. +Integer start position of a match, or 0 if no match was found. +If one of the parameters is NULL, then the return value is NULL. Examples -=========== +======== For these examples, consider the following table and contents: -.. code-block:: postgres +.. code-block:: sql - CREATE TABLE jabberwocky(line TEXT(50)); + CREATE TABLE users ( + id INT, + username TEXT, + email TEXT, + password TEXT + ); - INSERT INTO jabberwocky VALUES - ('''Twas brillig, and the slithy toves '), (' Did gyre and gimble in the wabe: ') - ,('All mimsy were the borogoves, '), (' And the mome raths outgrabe. ') - ,('"Beware the Jabberwock, my son! '), (' The jaws that bite, the claws that catch! ') - ,('Beware the Jubjub bird, and shun '), (' The frumious Bandersnatch!" '); + INSERT INTO users (id, username, email, password) + VALUES (1, 'john_doe', 'john.doe@example.com', 'password1'), + (2, 'jane_doe', 'jane.doe@example.com', 'password2'), + (3, 'bob_smith', 'bob.smith@example.com', 'password3'), + (4, 'susan_jones', 'susan.jones@example.com', 'password4'); Using ``CHARINDEX`` ------------------------------------------ - -.. code-block:: psql - - t=> SELECT line, CHARINDEX('the', line) FROM jabberwocky - line | charindex - ------------------------------------------------+---------- - 'Twas brillig, and the slithy toves | 20 - Did gyre and gimble in the wabe: | 30 - All mimsy were the borogoves, | 16 - And the mome raths outgrabe. | 11 - "Beware the Jabberwock, my son! | 9 - The jaws that bite, the claws that catch! | 27 - Beware the Jubjub bird, and shun | 8 - The frumious Bandersnatch!" | 0 +------------------- + +.. code-block:: sql + + SELECT CHARINDEX('john', username) FROM users; + +Output: + +.. code-block:: none + + charindex| + ---------+ + 1 | + 0 | + 0 | + 0 | + + From bc9ae0bfc28f7a8354120b362503ea828f328792 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 18 May 2023 11:29:59 +0300 Subject: [PATCH 555/882] get total chunks size --- .../get_all_roles_database_ddl.rst | 46 +++++++++++++++++++ reference/sql/sql_statements/index.rst | 6 ++- ...base_ddl.rst => get_total_chunks_size.rst} | 2 + 3 files changed, 52 insertions(+), 2 deletions(-) create mode 100644 reference/sql/sql_statements/access_control_commands/get_all_roles_database_ddl.rst rename reference/sql/sql_statements/utility_commands/{get_all_roles_database_ddl.rst => get_total_chunks_size.rst} (95%) diff --git a/reference/sql/sql_statements/access_control_commands/get_all_roles_database_ddl.rst b/reference/sql/sql_statements/access_control_commands/get_all_roles_database_ddl.rst new file mode 100644 index 000000000..1f6b6d734 --- /dev/null +++ b/reference/sql/sql_statements/access_control_commands/get_all_roles_database_ddl.rst @@ -0,0 +1,46 @@ +.. _get_all_roles_database_ddl: + +************************** +GET_ALL_ROLES_DATABASE_DDL +************************** +The ``GET_ALL_ROLES_DATABASE_DDL`` statement returns the definition of all role databases in DDL format. + +.. contents:: + :local: + :depth: 1 + +Syntax +========== +The following is the correct syntax for using the ``GET_ALL_ROLES_DATABASE_DDL`` statement: + +.. code-block:: postgres + + select get_all_roles_database_ddl() + +Example +=========== +The following is an example of using the ``GET_ALL_ROLES_DATABASE_DDL`` statement: + +.. code-block:: psql + + select get_all_roles_database_ddl(); + +Output +========== +The following is an example of the output of the ``GET_ALL_ROLES_DATABASE_DDL`` statement: + +.. code-block:: postgres + + grant create, usage on schema "public" to "public" ; alter default schema for "public" to "public"; alter default permissions for "public" for schemas grant superuser to creator_role ; alter default permissions for "public" for tables grant select, insert, delete, ddl, update to creator_role ; grant select, insert, delete, ddl, update on table "public"."customer" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."d_customer" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."demo_customer" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."demo_lineitem" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."lineitem" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."nation" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."orders" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."part" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."partsupp" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."region" to "sqream" ; grant select, insert, delete, ddl, update on table "public"."supplier" to "sqream" ; alter default schema for "sqream" to "public"; + +Permissions +============= +Using the ``GET_ALL_ROLES_DATABASE_DDL`` statement requires no special permissions. + +For more information, see the following: + +* :ref:`get_all_roles_global_ddl` + + :: + +* :ref:`get_role_permissions` \ No newline at end of file diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index e13113ae4..7044b3a80 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -106,6 +106,8 @@ The following table shows the Utility commands: * - Command - Usage + * - :ref:`GET TOTAL CHUNKS SIZE<get_total_chunks_size>` + - Returns the total size of all data chunks saved in the system * - :ref:`DROP SAVED QUERY<drop_saved_query>` - Drops a saved query * - :ref:`EXECUTE SAVED QUERY<execute_saved_query>` @@ -190,6 +192,8 @@ The following table shows the Access Control commands: - Creates a roles, which lets a database administrator control permissions on tables and databases * - :ref:`drop_role` - Removes roles + * - :ref:`get_all_roles_database_ddl` + - Returns the definition of all role databases in DDL format * - :ref:`get_role_permissions` - Returns all permissions granted to a role in table format * - :ref:`get_role_global_ddl` @@ -198,8 +202,6 @@ The following table shows the Access Control commands: - Returns the definition of all global roles in DDL format * - :ref:`get_role_database_ddl` - Returns the definition of a role's database in DDL format - * - :ref:`get_all_roles_database_ddl` - - Returns the definition of all role databases in DDL format * - :ref:`get_statement_permissions` - Returns a list of permissions required to run a statement or query * - :ref:`grant` diff --git a/reference/sql/sql_statements/utility_commands/get_all_roles_database_ddl.rst b/reference/sql/sql_statements/utility_commands/get_total_chunks_size.rst similarity index 95% rename from reference/sql/sql_statements/utility_commands/get_all_roles_database_ddl.rst rename to reference/sql/sql_statements/utility_commands/get_total_chunks_size.rst index b6c8ad141..cd2c213f4 100644 --- a/reference/sql/sql_statements/utility_commands/get_all_roles_database_ddl.rst +++ b/reference/sql/sql_statements/utility_commands/get_total_chunks_size.rst @@ -60,3 +60,5 @@ Output Permissions ============= + +Using the ``get_total_chunks_size`` command requires no special permissions. \ No newline at end of file From a8fa2eae220f536c30b5bb12360c1bf66dfb705f Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 18 May 2023 14:02:18 +0300 Subject: [PATCH 556/882] Update supported_data_types.rst --- data_type_guides/supported_data_types.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data_type_guides/supported_data_types.rst b/data_type_guides/supported_data_types.rst index 5889307ff..740016249 100644 --- a/data_type_guides/supported_data_types.rst +++ b/data_type_guides/supported_data_types.rst @@ -55,7 +55,7 @@ The following table shows the supported data types. - Variable length string - UTF-8 unicode - Up to ``4`` bytes - ``'Kiwis have tiny wings, but cannot fly.'`` - - ``CHAR VARYING``, ``CHAR``, ``CHARACTER VARYING``, ``CHARACTER``, ``NATIONAL CHARACTER VARYING``, ``NATIONAL CHARACTER``, ``NCHAR VARYING``, ``NCHAR`` + - ``CHAR VARYING``, ``CHAR``, ``CHARACTER VARYING``, ``CHARACTER``, ``NATIONAL CHARACTER VARYING``, ``NATIONAL CHARACTER``, ``NCHAR VARYING``, ``NCHAR``, ``NATIONAL CHAR``, ``NATIONAL CHAR VARYING`` * - ``NUMERIC`` - 38 digits - 16 bytes From 9c49dcefd1de2b431e82e17fd8df320d17bbd2c9 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 22 May 2023 09:33:28 +0300 Subject: [PATCH 557/882] docker --- sqream_studio_5.4.7/getting_started.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sqream_studio_5.4.7/getting_started.rst b/sqream_studio_5.4.7/getting_started.rst index 21d9348c0..03aeca142 100644 --- a/sqream_studio_5.4.7/getting_started.rst +++ b/sqream_studio_5.4.7/getting_started.rst @@ -5,7 +5,7 @@ Getting Started with SQream Acceleration Studio 5.4.7 **************************** Setting Up and Starting Studio ---------------- -Studio is included with all `dockerized installations of SQream DB <https://docs.sqream.com/en/v2020-2/guides/operations/setup/local_docker.html#installing-sqream-db-docker>`_. When starting Studio, it listens on the local machine on port 8080. +Studio is included with all :ref:`dockerized installations of SQream DB<running_sqream_in_a_docker_container>`. When starting Studio, it listens on the local machine on port 8080. Logging In to Studio --------------- From 706a54124b1758a9ceef4375a1720be858e3f529 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 22 May 2023 10:36:28 +0300 Subject: [PATCH 558/882] Update copy_to.rst --- .../sql_statements/dml_commands/copy_to.rst | 58 ++++++++++++++----- 1 file changed, 42 insertions(+), 16 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/copy_to.rst b/reference/sql/sql_statements/dml_commands/copy_to.rst index e10cbb677..32e462f5d 100644 --- a/reference/sql/sql_statements/dml_commands/copy_to.rst +++ b/reference/sql/sql_statements/dml_commands/copy_to.rst @@ -417,32 +417,58 @@ Examples Exporting Data From SQream to External File Tables -------------------------------------------------- -Exporting Tables to Parquet Files -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Parquet +^^^^^^^ The compression algorithm used for exporting data from SQream to Parquet files is Snappy. +Exporting tables to Parquet files: + .. code-block:: psql COPY nba TO WRAPPER parquet_fdw OPTIONS (LOCATION = '/tmp/nba_export.parquet'); -Exporting Query Results to Parquet Files -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Exporting query results to Parquet files: .. code-block:: psql - COPY (select x,y from t where z=0) TO WRAPPER parquet_fdw OPTIONS (LOCATION = '/tmp/file.parquet'); + COPY (SELECT name FROM nba WHERE salary<1148640) TO WRAPPER parquet_fdw OPTIONS (LOCATION = '/tmp/file.parquet'); + +ORC +^^^ +The compression algorithm used for exporting data from SQream to ORC files is ZLIB. -Exporting Tables to ORC Files -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Exporting tables to ORC files: .. code-block:: psql COPY nba TO WRAPPER orc_fdw OPTIONS (LOCATION = '/tmp/nba_export.orc'); + +Exporting query results to ORC files: + +.. code-block:: psql + + COPY (SELECT name from nba where salary<1148640) TO WRAPPER orc_fdw OPTIONS (LOCATION = '/tmp/file.orc'); + +AVRO +^^^^ +The compression algorithm used for exporting data from SQream to Parquet files is Snappy. + +Exporting tables to AVRO files: + +.. code-block:: psql + + COPY nba TO WRAPPER avro_fdw OPTIONS (LOCATION = '/tmp/nba_export.avro'); + +Exporting query results to AVRO files: + +.. code-block:: psql + + COPY (SELECT name from nba where salary<1148640) TO WRAPPER avro_fdw OPTIONS (LOCATION = '/tmp/file.avro'); -CSV Files -^^^^^^^^^ +CSV +^^^ -The following is an example of exporting a table to a CSV file without a HEADER row: +Exporting a table to a CSV file without a HEADER row: .. code-block:: psql @@ -458,7 +484,7 @@ The following is an example of exporting a table to a CSV file without a HEADER Jonas Jerebko,Boston Celtics,8,PF,29,6-10,231,\N,5000000 Amir Johnson,Boston Celtics,90,PF,29,6-9,240,\N,12000000 -The following is an example of exporting a table to a CSV file with a HEADER row: +Exporting a table to a CSV file with a HEADER row: .. code-block:: psql @@ -474,11 +500,11 @@ The following is an example of exporting a table to a CSV file with a HEADER row R.J. Hunter,Boston Celtics,28,SG,22,6-5,185,Georgia State,1148640 Jonas Jerebko,Boston Celtics,8,PF,29,6-10,231,\N,5000000 -The following is an example of exporting the result of a query to a CSV file: +Exporting the result of a query to a CSV file: .. code-block:: psql - COPY (SELECT "Team", AVG("Salary") FROM nba GROUP BY 1) TO WRAPPER csv_fdw OPTIONS (LOCATION = '/tmp/nba_export.csv'); + COPY (SELECT Team, AVG(Salary) FROM nba GROUP BY 1) TO WRAPPER csv_fdw OPTIONS (LOCATION = '/tmp/nba_export.csv'); .. code-block:: console @@ -489,10 +515,10 @@ The following is an example of exporting the result of a query to a CSV file: Charlotte Hornets,5222728 Chicago Bulls,5785558 -TSV Files -^^^^^^^^^ +TSV +^^^ -The following is an example of exporting a table to a TSV file with a HEADER row: +Exporting a table to a TSV file with a HEADER row: .. code-block:: psql From 46ad6c468e5d19f34f2100b74882ac852372b03d Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 22 May 2023 12:01:14 +0300 Subject: [PATCH 559/882] Update 4.3.rst --- releases/4.3.rst | 55 +++++++++++++++++++++++++++--------------------- 1 file changed, 31 insertions(+), 24 deletions(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index 40f56cc37..c2adb44a0 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -66,29 +66,36 @@ Known Issues Version 4.3 resolved Issues ----------------------------- -+------------------------+------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+========================+==========================================================================================+ -| SQ-11108 | Slow ``COPY FROM`` statements using ORC files | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-13112 | ``GRANT`` query queue issue | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-13201 | | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-13210 | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-13322 | Cleanup operation failure -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-13401 | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-13453 | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-13566 | -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-13587 | Large number multiple query execution using Python failure -+------------------------+------------------------------------------------------------------------------------------+ -| SQ-13694 | S3 access issue -+------------------------+------------------------------------------------------------------------------------------+ ++------------------------+-----------------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++========================+=====================================================================================================+ +| SQ-11108 | Slow ``COPY FROM`` statements using ORC files | ++------------------------+-----------------------------------------------------------------------------------------------------+ +| SQ-13112 | ``GRANT`` query queue issue | ++------------------------+-----------------------------------------------------------------------------------------------------+ +| SQ-13201 | ``INSERT INTO`` statement error while copying data from non-clustered table to clustered table | ++------------------------+-----------------------------------------------------------------------------------------------------+ +| SQ-13210 | Slow query execution time | ++------------------------+-----------------------------------------------------------------------------------------------------+ +| SQ-13322 | Cleanup operation failure | ++------------------------+-----------------------------------------------------------------------------------------------------+ +| SQ-13401 | JDBC causes the log summery of ``INSERT`` statements to fail | ++------------------------+-----------------------------------------------------------------------------------------------------+ +| SQ-13453 | | ++------------------------+-----------------------------------------------------------------------------------------------------+ +| SQ-13566 | | ++------------------------+-----------------------------------------------------------------------------------------------------+ +| SQ-13587 | Large number query execution using Python failure | ++------------------------+-----------------------------------------------------------------------------------------------------+ +| SQ-13694 | S3 endpoint access issue | ++------------------------+-----------------------------------------------------------------------------------------------------+ +| SQ-13467 | Snapshot issue causes metadata to crash | ++------------------------+-----------------------------------------------------------------------------------------------------+ +| SQ-13426 | Slow query execution time | ++------------------------+-----------------------------------------------------------------------------------------------------+ +| SQ-11804 | | ++------------------------+-----------------------------------------------------------------------------------------------------+ + Configuration Changes @@ -131,7 +138,7 @@ End of Support --------------- No End of Support changes were made. -Upgrading to v4.2 +Upgrading to v4.3 ------------------- 1. Generate a back-up of the metadata by running the following command: From 2681af554f92f8e7903ebf7d67fee54ff0bb2d5c Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 22 May 2023 12:12:52 +0300 Subject: [PATCH 560/882] Update sql_data_types_numeric.rst --- data_type_guides/sql_data_types_numeric.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/data_type_guides/sql_data_types_numeric.rst b/data_type_guides/sql_data_types_numeric.rst index 8a78e19fa..8d63a82f5 100644 --- a/data_type_guides/sql_data_types_numeric.rst +++ b/data_type_guides/sql_data_types_numeric.rst @@ -5,7 +5,7 @@ Numeric ************************* The **Numeric** data type (also known as **Decimal**) is recommended for values that tend to occur as exact decimals, such as in Finance. While Numeric has a fixed precision of ``38``, higher than ``REAL`` (``9``) or ``DOUBLE`` (``17``), it runs calculations more slowly. For operations that require faster performance, using :ref:`Floating Point <floating_point>` is recommended. -The correct syntax for Numeric is ``numeric(p, s)``), where ``p`` is the total number of digits (``38`` maximum), and ``s`` is the total number of decimal digits. +The correct syntax for Numeric is ``numeric(p, s)``), where ``p`` is the total number of digits (``38`` maximum), and ``s`` is the total number of decimal digits. If no parameters are specified, Numeric defaults to ``numeric(38, 0)``. Numeric Examples ^^^^^^^^^^ @@ -14,9 +14,9 @@ The following is an example of the Numeric syntax: .. code-block:: postgres - $ create or replace table t(x numeric(20, 10), y numeric(38, 38)); - $ insert into t values(1234567890.1234567890, 0.123245678901234567890123456789012345678); - $ select x + y from t; + CREATE OR REPLACE table t(x numeric(20, 10), y numeric(38, 38)); + INSERT INTO t VALUES(1234567890.1234567890, 0.123245678901234567890123456789012345678); + SELECT x + y FROM t; The following table shows information relevant to the Numeric data type: From 6a8db6c182f8e53901e47bfe0a8532a6b465f199 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 23 May 2023 16:59:31 +0300 Subject: [PATCH 561/882] 4.3 RN --- external_storage_platforms/nba-t10.csv | 10 ++ external_storage_platforms/s3.rst | 79 +++++++++----- .../access_control_permissions.rst | 10 +- releases/4.3.rst | 102 ++++++------------ 4 files changed, 103 insertions(+), 98 deletions(-) create mode 100644 external_storage_platforms/nba-t10.csv diff --git a/external_storage_platforms/nba-t10.csv b/external_storage_platforms/nba-t10.csv new file mode 100644 index 000000000..c9816d654 --- /dev/null +++ b/external_storage_platforms/nba-t10.csv @@ -0,0 +1,10 @@ +Name,Team,Number,Position,Age,Height,Weight,College,Salary +Avery Bradley,Boston Celtics,0,PG,25,2-Jun,180,Texas,7730337 +Jae Crowder,Boston Celtics,99,SF,25,6-Jun,235,Marquette,6796117 +John Holland,Boston Celtics,30,SG,27,5-Jun,205,Boston University, +R.J. Hunter,Boston Celtics,28,SG,22,5-Jun,185,Georgia State,1148640 +Jonas Jerebko,Boston Celtics,8,PF,29,10-Jun,231,,5000000 +Amir Johnson,Boston Celtics,90,PF,29,9-Jun,240,,12000000 +Jordan Mickey,Boston Celtics,55,PF,21,8-Jun,235,LSU,1170960 +Kelly Olynyk,Boston Celtics,41,C,25,Jul-00,238,Gonzaga,2165160 +Terry Rozier,Boston Celtics,12,PG,22,2-Jun,190,Louisville,1824360 diff --git a/external_storage_platforms/s3.rst b/external_storage_platforms/s3.rst index a3111f3b9..bb0a22f27 100644 --- a/external_storage_platforms/s3.rst +++ b/external_storage_platforms/s3.rst @@ -5,19 +5,19 @@ Inserting Data Using Amazon S3 *********************** SQream uses a native S3 connector for inserting data. The ``s3://`` URI specifies an external file path on an S3 bucket. File names may contain wildcard characters, and the files can be in CSV or columnar format, such as Parquet and ORC. -The **Amazon S3** describes the following topics: - .. contents:: :local: S3 Configuration -============================== +================ + +A best practice for granting access to AWS S3 is by creating an `Identity and Access Management (IAM) <https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started.html>`_ user account. If creating an IAM user account is not possible, you may follow AWS guidelines for `using the global configuration object <https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/global-config-object.html>`_ and setting an `AWS region <https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/setting-region.html>`_. + -A best practice for granting access to AWS S3 is by creating an `Identity and Access Management (IAM) <https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started.html>`_ user account. If creating an IAM user account is not possible, you may follow AWS guidelines for `using the global configuration object <https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/global-config-object.html>`_ and setting an `AWS region <https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/setting-region.html>`_ S3 URI Format -=============== -With S3, specify a location for a file (or files) when using :ref:`copy_from` or :ref:`external_tables`. +============= +With S3, specify a location for a file (or files) when using :ref:`copy_from` or :ref:`foreign_tables`. The following is an example of the general S3 syntax: @@ -26,45 +26,72 @@ The following is an example of the general S3 syntax: s3://bucket_name/path Authentication -================= +============== SQream supports ``AWS ID`` and ``AWS SECRET`` authentication. These should be specified when executing a statement. Examples -========== -Use a foreign table to stage data from S3 before loading from CSV, Parquet, or ORC files. +======== + +AwsEndpointOverride - Enables custom endpoint + +Example: 'https://s3.amazonaws.com' -The **Examples** section includes the following examples: +AwsObjectAccessStyle - whether to use path-style or virtual object style access - read about in AWS documentation. + +If you wish to use custom endpoint, you need to configure sqream using our legacy configuration file, and add AwsEndpointOverride - Enables custom endpoint. And you may add the AwsObjectAccessStyle flag to send request for a different access style. + + + +Use a foreign table to stage data from S3 before loading from CSV, Parquet, or ORC files. .. contents:: :local: :depth: 1 Planning for Data Staging --------------------------------- -The examples in this section are based on a CSV file, as shown in the following table: +------------------------- +The examples in this section are based on the following table: + ++---------------+----------------+--------+----------+-----+--------+--------+-------------------+-----------+ +| Name | Team | Number | Position | Age | Height | Weight | College | Salary | ++===============+================+========+==========+=====+========+========+===================+===========+ +| Avery Bradley | Boston Celtics | 0 | PG | 25 | 2-Jun | 180 | Texas | 7730337 | ++---------------+----------------+--------+----------+-----+--------+--------+-------------------+-----------+ +| Jae Crowder | Boston Celtics | 99 | SF | 25 | 6-Jun | 235 | Marquette | 6796117 | ++---------------+----------------+--------+----------+-----+--------+--------+-------------------+-----------+ +| John Holland | Boston Celtics | 30 | SG | 27 | 5-Jun | 205 | Boston University | | ++---------------+----------------+--------+----------+-----+--------+--------+-------------------+-----------+ +| R.J. Hunter | Boston Celtics | 28 | SG | 22 | 5-Jun | 185 | Georgia State | 1148640 | ++---------------+----------------+--------+----------+-----+--------+--------+-------------------+-----------+ +| Jonas Jerebko | Boston Celtics | 8 | PF | 29 | 10-Jun | 231 | | 5000000 | ++---------------+----------------+--------+----------+-----+--------+--------+-------------------+-----------+ +| Amir Johnson | Boston Celtics | 90 | PF | 29 | 9-Jun | 240 | | 12000000 | ++---------------+----------------+--------+----------+-----+--------+--------+-------------------+-----------+ +| Jordan Mickey | Boston Celtics | 55 | PF | 21 | 8-Jun | 235 | LSU | 1170960 | ++---------------+----------------+--------+----------+-----+--------+--------+-------------------+-----------+ +| Kelly Olynyk | Boston Celtics | 41 | C | 25 | Jul-00 | 238 | Gonzaga | 2165160 | ++---------------+----------------+--------+----------+-----+--------+--------+-------------------+-----------+ +| Terry Rozier | Boston Celtics | 12 | PG | 22 | 2-Jun | 190 | Louisville | 1824360 | ++---------------+----------------+--------+----------+-----+--------+--------+-------------------+-----------+ -.. csv-table:: nba.csv - :file: ../nba-t10.csv - :widths: auto - :header-rows: 1 The file is stored on Amazon S3, and this bucket is public and listable. To create a matching ``CREATE FOREIGN TABLE`` statement you can make note of the file structure. Creating a Foreign Table ------------------------------ +------------------------ Based on the source file's structure, you can create a foreign table with the appropriate structure, and point it to your file as shown in the following example: .. code-block:: postgres CREATE FOREIGN TABLE nba ( - Name varchar(40), - Team varchar(40), + Name text(40), + Team text(40), Number tinyint, - Position varchar(2), + Position text(2), Age tinyint, - Height varchar(4), + Height text(4), Weight real, - College varchar(40), + College text(40), Salary float ) WRAPPER csv_fdw @@ -79,11 +106,11 @@ In the example above the file format is CSV, and it is stored as an S3 object. I For more information, see the following: -* **Creating a foreign table** - see :ref:`create a foreign table<create_foreign_table>`. -* **Using SQream in an HDFS environment** - see :ref:`hdfs`. +* :ref:`create a foreign table<create_foreign_table>` +* :ref:`hdfs` Querying Foreign Tables ------------------------------- +----------------------- The following shows the data in the foreign table: .. code-block:: psql @@ -103,7 +130,7 @@ The following shows the data in the foreign table: Marcus Smart | Boston Celtics | 36 | PG | 22 | 6-4 | 220 | Oklahoma State | 3431040 Bulk Loading a File from a Public S3 Bucket ----------------------------------------------- +------------------------------------------- The ``COPY FROM`` command can also be used to load data without staging it first. .. note:: The bucket must be publicly available and objects can be listed. diff --git a/operational_guides/access_control_permissions.rst b/operational_guides/access_control_permissions.rst index e0a3efa24..e03e9198d 100644 --- a/operational_guides/access_control_permissions.rst +++ b/operational_guides/access_control_permissions.rst @@ -25,7 +25,7 @@ The following table displays the access control permissions: +--------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``CREATE`` | Create schemas in the database | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``CREATE FUNCTION``| Create and drop functions | +| ``CREATE FUNCTION``| Create and drop functions | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ | **Object/Layer: Schema** | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ @@ -35,13 +35,13 @@ The following table displays the access control permissions: +--------------------+-------------------------------------------------------------------------------------------------------------------------+ | **Object/Layer: Table** | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``SELECT`` | :ref:`select` from the table | +| ``SELECT`` | :ref:`select` from the table | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``INSERT`` | :ref:`insert` into the table | +| ``INSERT`` | :ref:`insert` into the table | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``UPDATE`` | :ref:`update` the value of certain columns in existing rows | +| ``UPDATE`` | :ref:`update` the value of certain columns in existing rows | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``DELETE`` | :ref:`delete` and :ref:`truncate` on the table | +| ``DELETE`` | :ref:`delete` and :ref:`truncate` on the table | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``DDL`` | Drop and alter on the table | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ diff --git a/releases/4.3.rst b/releases/4.3.rst index c2adb44a0..62571e42c 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -1,8 +1,8 @@ .. _4.3: -************************** +***************** Release Notes 4.3 -************************** +***************** SQream is introducing a new version release system that follows the more commonly used Major.Minor.Patch versioning schema. The newly released **4.0 version** is a minor version upgrade and does not require considerable preparation. @@ -12,20 +12,6 @@ The 4.3 release notes were released on xx/xx/xxxx and describe the following: :local: :depth: 1 -New Features ------------- - - -:ref:`<>` - - :: - -:ref:`<>` - - -Newly Released Connector Drivers --------------------------------- - Compatibility Matrix -------------------- @@ -46,13 +32,6 @@ Compatibility Matrix | | * Pysqream 3.2.5 | | | * Spark | +-------------------------+------------------------------------------------------------------------+ - -SQream Studio Updates and Improvements --------------------------------------- - -SQream Studio v5.5.4 has been released. - - :: Known Issues ------------ @@ -62,41 +41,40 @@ Known Issues * Performance degradation when using ``VARCHAR`` partition key in a :ref:`Window Functions<window_functions>` expression - Version 4.3 resolved Issues ------------------------------ - -+------------------------+-----------------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+========================+=====================================================================================================+ -| SQ-11108 | Slow ``COPY FROM`` statements using ORC files | -+------------------------+-----------------------------------------------------------------------------------------------------+ -| SQ-13112 | ``GRANT`` query queue issue | -+------------------------+-----------------------------------------------------------------------------------------------------+ -| SQ-13201 | ``INSERT INTO`` statement error while copying data from non-clustered table to clustered table | -+------------------------+-----------------------------------------------------------------------------------------------------+ -| SQ-13210 | Slow query execution time | -+------------------------+-----------------------------------------------------------------------------------------------------+ -| SQ-13322 | Cleanup operation failure | -+------------------------+-----------------------------------------------------------------------------------------------------+ -| SQ-13401 | JDBC causes the log summery of ``INSERT`` statements to fail | -+------------------------+-----------------------------------------------------------------------------------------------------+ -| SQ-13453 | | -+------------------------+-----------------------------------------------------------------------------------------------------+ -| SQ-13566 | | -+------------------------+-----------------------------------------------------------------------------------------------------+ -| SQ-13587 | Large number query execution using Python failure | -+------------------------+-----------------------------------------------------------------------------------------------------+ -| SQ-13694 | S3 endpoint access issue | -+------------------------+-----------------------------------------------------------------------------------------------------+ -| SQ-13467 | Snapshot issue causes metadata to crash | -+------------------------+-----------------------------------------------------------------------------------------------------+ -| SQ-13426 | Slow query execution time | -+------------------------+-----------------------------------------------------------------------------------------------------+ -| SQ-11804 | | -+------------------------+-----------------------------------------------------------------------------------------------------+ - - +--------------------------- + ++--------------------+------------------------------------------------------------------------------------------------+ +| **SQ No.** | **Description** | ++====================+================================================================================================+ +| SQ-11108 | Slow ``COPY FROM`` statements using ORC files | ++--------------------+------------------------------------------------------------------------------------------------+ +| SQ-13112 | ``GRANT`` query queue issue | ++--------------------+------------------------------------------------------------------------------------------------+ +| SQ-13201 | ``INSERT INTO`` statement error while copying data from non-clustered table to clustered table | ++--------------------+------------------------------------------------------------------------------------------------+ +| SQ-13210, SQ-13426 | Slow query execution time | ++--------------------+------------------------------------------------------------------------------------------------+ +| SQ-13322 | Cleanup operation case-sensitivity issue | ++--------------------+------------------------------------------------------------------------------------------------+ +| SQ-13401 | The JDBC driver causes the log summery of ``INSERT`` statements to fail | ++--------------------+------------------------------------------------------------------------------------------------+ +| SQ-13453 | Metadata performance issue | ++--------------------+------------------------------------------------------------------------------------------------+ +| SQ-13566, SQ-13694 | S3 access to bucket failure when using custom endpoint | ++--------------------+------------------------------------------------------------------------------------------------+ +| SQ-13587 | Large number of worker connections failure | ++--------------------+------------------------------------------------------------------------------------------------+ +| SQ-13467 | Snapshot issue causes metadata failure | ++--------------------+------------------------------------------------------------------------------------------------+ +| SQ-11804 | Slow metadata optimization | ++--------------------+------------------------------------------------------------------------------------------------+ +| SQ-13225 | LoopJoin performance enhancement supports ``=``, ``>``, ``<``, and ``<=`` operators | ++--------------------+------------------------------------------------------------------------------------------------+ +| SQ-12799 | Catalog queries may not be terminated | ++--------------------+------------------------------------------------------------------------------------------------+ +| SQ-12721 | ``maxConnectionInactivitySeconds`` flag issue when executing Batch Shell Program ETLs | ++--------------------+------------------------------------------------------------------------------------------------+ Configuration Changes --------------------- @@ -104,11 +82,6 @@ Configuration Changes You may now configure the ``metadata_server`` using the ``metadata_server_config.json`` :ref:`configuration file<metadata_server>`. -Naming Changes --------------- -No naming changes - - Deprecated Features ------------------- @@ -133,11 +106,6 @@ The ``VARCHAR`` data type is deprecated to improve the core functionalities of t * ``VARCHAR`` is no longer supported for new customers, effective from Version 2022.1.3. * The ``TEXT`` data type is replacing the ``VARCHAR`` and ``NVARCHAR`` data types. - -End of Support ---------------- -No End of Support changes were made. - Upgrading to v4.3 ------------------- 1. Generate a back-up of the metadata by running the following command: From d3fb180f80ce82610edb5cd0ad0d93c302ffef37 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 25 May 2023 08:55:12 +0300 Subject: [PATCH 562/882] Delete running_sqream_in_a_docker_container.rst --- .../running_sqream_in_a_docker_container.rst | 1469 ----------------- 1 file changed, 1469 deletions(-) delete mode 100644 installation_guides/running_sqream_in_a_docker_container.rst diff --git a/installation_guides/running_sqream_in_a_docker_container.rst b/installation_guides/running_sqream_in_a_docker_container.rst deleted file mode 100644 index 97fc76476..000000000 --- a/installation_guides/running_sqream_in_a_docker_container.rst +++ /dev/null @@ -1,1469 +0,0 @@ -.. _running_sqream_in_a_docker_container: - -*********************** -Installing and Running SQream in a Docker Container -*********************** -The **Installing and Running SQream in a Docker Container** page describes how to prepare your machine's environment for installing and running SQream in a Docker container. - -This page describes the following: - -.. contents:: - :local: - :depth: 1 - -Setting Up a Host -==================================== - -Operating System Requirements ------------------------------------- -SQream was tested and verified on the following versions of Linux: - - * x86 CentOS/RHEL 7.6 - 7.9 - * IBM RHEL 7.6 - -SQream recommends installing a clean OS on the host to avoid any installation issues. - -.. warning:: Docker-based installation supports only single host deployment and cannot be used on a multi-node cluster. Installing Docker on a single host you will not be able to scale it to a multi-node cluster. - - -Creating a Local User ----------------- -To run SQream in a Docker container you must create a local user. - -**To create a local user:** - -1. Add a local user: - - .. code-block:: - - $ useradd -m -U <local user name> - -2. Set the local user's password: - - .. code-block:: - - $ passwd <local user name> - -3. Add the local user to the ``wheel`` group: - - .. code-block:: - - $ usermod -aG wheel <local user name> - - You can remove the local user from the ``wheel`` group when you have completed the installation. - -4. Log out and log back in as the local user. - -Setting a Local Language ----------------- -After creating a local user you must set a local language. - -**To set a local language:** - -1. Set the local language: - - .. code-block:: - - $ sudo localectl set-locale LANG=en_US.UTF-8 - -2. Set the time stamp (time and date) of the locale: - - .. code-block:: - - $ sudo timedatectl set-timezone Asia/Jerusalem - -You can run the ``timedatectl list-timezones`` command to see your timezone. - -Adding the EPEL Repository ----------------- -After setting a local language you must add the EPEL repository. - -**To add the EPEL repository:** - -1. As a root user, upgrade the **epel-release-latest-7.noarch.rpm** repository: - - 1. RedHat (RHEL 7): - - .. code-block:: - - $ sudo rpm -Uvh http://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm - - 2. CentOS 7 - - .. code-block:: - - $ sudo yum install epel-release - -Installing the Required NTP Packages ----------------- -After adding the EPEL repository, you must install the required NTP packages. - -You can install the required NTP packages by running the following command: - -.. code-block:: - - $ sudo yum install ntp pciutils python36 kernel-devel-$(uname -r) kernel-headers-$(uname -r) gcc - -Installing the Recommended Tools ----------------- -After installin gthe required NTP packages you must install the recommended tools. - -SQream recommends installing the following recommended tools: - -.. code-block:: - - $ sudo yum install bash-completion.noarch vim-enhanced.x86_64 vim-common.x86_64 net-tools iotop htop psmisc screen xfsprogs wget yum-utils deltarpm dos2unix - -Updating to the Current Version of the Operating System ----------------- -After installing the recommended tools you must update to the current version of the operating system. - -SQream recommends updating to the current version of the operating system. This is not recommended if the nvidia driver has **not been installed.** - - - -Configuring the NTP Package ----------------- -After updating to the current version of the operating system you must configure the NTP package. - -**To configure the NTP package:** - -1. Add your local servers to the NTP configuration. - - :: - -2. Configure the **ntpd** service to begin running when your machine is started: - - .. code-block:: - - $ sudo systemctl enable ntpd - $ sudo systemctl start ntpd - $ sudo ntpq -p - -Configuring the Performance Profile ----------------- -After configuring the NTP package you must configure the performance profile. - -**To configure the performance profile:** - -1. *Optional* - Switch the active profile: - - .. code-block:: - - $ sudo tuned-adm profile throughput-performance - -2. Change the multi-user's default run level: - - .. code-block:: - - $ sudo systemctl set-default multi-user.target - -Configuring Your Security Limits ----------------- -After configuring the performance profile you must configure your security limits. Configuring your security limits refers to configuring the number of open files, processes, etc. - -**To configure your security limits:** - -1. Run the **bash** shell as a super-user: - - .. code-block:: - - $ sudo bash - -2. Run the following command: - - .. code-block:: - - $ echo -e "sqream soft nproc 500000\nsqream hard nproc 500000\nsqream soft nofile 500000\nsqream hard nofile 500000\nsqream soft core unlimited\nsqream hard core unlimited" >> /etc/security/limits.conf - -3. Run the following command: - - .. code-block:: - - $ echo -e "vm.dirty_background_ratio = 5 \n vm.dirty_ratio = 10 \n vm.swappiness = 10 \n vm.zone_reclaim_mode = 0 \n vm.vfs_cache_pressure = 200 \n" >> /etc/sysctl.conf - -Disabling Automatic Bug-Reporting Tools ----------------- -After configuring your security limits you must disable the following automatic bug-reporting tools: - -* ccpp.service -* oops.service -* pstoreoops.service -* vmcore.service -* xorg.service - -You can abort the above but-reporting tools by running the following command: - -.. code-block:: - - $ for i in abrt-ccpp.service abrtd.service abrt-oops.service abrt-pstoreoops.service abrt-vmcore.service abrt-xorg.service ; do sudo systemctl disable $i; sudo systemctl stop $i; done - -Installing the Nvidia CUDA Driver -------------------------------------- - -1. Verify that the Tesla NVIDIA card has been installed and is detected by the system: - - .. code-block:: - - $ lspci | grep -i nvidia - - The correct output is a list of Nvidia graphic cards. If you do not receive this output, verify that an NVIDIA GPU card has been installed. - -#. Verify that the open-source upstream Nvidia driver is running: - - .. code-block:: - - $ lsmod | grep nouveau - - No output should be generated. - -#. If you receive any output, do the following: - - 1. Disable the open-source upstream Nvidia driver: - - .. code-block:: - - $ sudo bash - $ echo "blacklist nouveau" > /etc/modprobe.d/blacklist-nouveau.conf - $ echo "options nouveau modeset=0" >> /etc/modprobe.d/blacklist-nouveau.conf - $ dracut --force - $ modprobe --showconfig | grep nouveau - - 2. Reboot the server and verify that the Nouveau model has not been loaded: - - .. code-block:: - - $ lsmod | grep nouveau - -#. Check if the Nvidia CUDA driver has already been installed: - - .. code-block:: - - $ nvidia-smi - - The following is an example of the correct output: - - .. code-block:: - - nvidia-smi - Wed Oct 30 14:05:42 2019 - +-----------------------------------------------------------------------------+ - | NVIDIA-SMI 470.82.01 Driver Version: 470.82.01 CUDA Version: 10.1 | - |-------------------------------+----------------------+----------------------+ - | GPU Name Persistence-M| Bus-Id Disp.A | Volatile Uncorr. ECC | - | Fan Temp Perf Pwr:Usage/Cap| Memory-Usage | GPU-Util Compute M. | - |===============================+======================+======================| - | 0 Tesla V100-SXM2... On | 00000004:04:00.0 Off | 0 | - | N/A 32C P0 37W / 300W | 0MiB / 16130MiB | 0% Default | - +-------------------------------+----------------------+----------------------+ - | 1 Tesla V100-SXM2... On | 00000035:03:00.0 Off | 0 | - | N/A 33C P0 37W / 300W | 0MiB / 16130MiB | 0% Default | - +-------------------------------+----------------------+----------------------+ - - +-----------------------------------------------------------------------------+ - | Processes: GPU Memory | - | GPU PID Type Process name Usage | - |=============================================================================| - | No running processes found | - +-----------------------------------------------------------------------------+ - -#. Verify that the installed CUDA version shown in the output above is ``10.1``. - - :: - - -#. Do one of the following: - - :: - - 1. If CUDA version 10.1 has already been installed, skip to Docktime Runtime (Community Edition). - :: - - 2. If CUDA version 10.1 has not been installed yet, continue with Step 7 below. - -#. Do one of the following: - - * Install :ref:`CUDA Driver version 10.1 for x86_64 <CUDA_10.1_x8664>`. - - :: - - * Install :ref:`CUDA driver version 10.1 for IBM Power9 <CUDA_10.1_IBMPower9>`. - -.. _CUDA_10.1_x8664: - -Installing the CUDA Driver Version 10.1 for x86_64 -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**To install the CUDA driver version 10.1 for x86_64:** - -1. Make the following target platform selections: - - :: - - * **Operating system**: Linux - * **Architecture**: x86_64 - * **Distribution**: CentOS - * **Version**: 7 - * **Installer type**: the relevant installer type - -For installer type, SQream recommends selecting **runfile (local)**. The available selections shows only the supported platforms. - -2. Download the base installer for Linux CentOS 7 x86_64: - - .. code-block:: - - wget http://developer.download.nvidia.com/compute/cuda/10.1/Prod/local_installers/cuda-repo-rhel7-10-1-local-10.1.243-418.87.00-1.0-1.x86_64.rpm - -3. Install the base installer for Linux CentOS 7 x86_64 by running the following commands: - - .. code-block:: - - $ sudo yum localinstall cuda-repo-rhel7-10-1-local-10.1.243-418.87.00-1.0-1.x86_64.rpm - $ sudo yum clean all - $ sudo yum install nvidia-driver-latest-dkms - -.. warning:: Verify that the output indicates that driver **418.87** will be installed. - -4. Follow the command line prompts. - - - :: - - -5. Enable the Nvidia service to start at boot and start it: - - .. code-block:: - - $ sudo systemctl enable nvidia-persistenced.service && sudo systemctl start nvidia-persistenced.service - -7. Reboot the server. - - :: -8. Verify that the Nvidia driver has been installed and shows all available GPU's: - - .. code-block:: - - $ nvidia-smi - - The following is the correct output: - - .. code-block:: - - nvidia-smi - Wed Oct 30 14:05:42 2019 - +-----------------------------------------------------------------------------+ - | NVIDIA-SMI 470.82.01 Driver Version: 470.82.01 CUDA Version: 10.1 | - |-------------------------------+----------------------+----------------------+ - | GPU Name Persistence-M| Bus-Id Disp.A | Volatile Uncorr. ECC | - | Fan Temp Perf Pwr:Usage/Cap| Memory-Usage | GPU-Util Compute M. | - |===============================+======================+======================| - | 0 Tesla V100-SXM2... On | 00000004:04:00.0 Off | 0 | - | N/A 32C P0 37W / 300W | 0MiB / 16130MiB | 0% Default | - +-------------------------------+----------------------+----------------------+ - | 1 Tesla V100-SXM2... On | 00000035:03:00.0 Off | 0 | - | N/A 33C P0 37W / 300W | 0MiB / 16130MiB | 0% Default | - +-------------------------------+----------------------+----------------------+ - - +-----------------------------------------------------------------------------+ - | Processes: GPU Memory | - | GPU PID Type Process name Usage | - |=============================================================================| - | No running processes found | - +-----------------------------------------------------------------------------+ - -.. _CUDA_10.1_IBMPower9: - -Installing the CUDA Driver Version 10.1 for IBM Power9 -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**To install the CUDA driver version 10.1 for IBM Power9:** - -1. Download the base installer for Linux CentOS 7 PPC64le: - - .. code-block:: - - wget http://developer.download.nvidia.com/compute/cuda/10.1/Prod/local_installers/cuda-repo-rhel7-10-1-local-10.1.243-418.87.00-1.0-1.ppc64le.rpm - - -#. Install the base installer for Linux CentOS 7 x86_64 by running the following commands: - - .. code-block:: - - $ sudo rpm -i cuda-repo-rhel7-10-1-local-10.1.243-418.87.00-1.0-1.ppc64le.rpm - $ sudo yum clean all - $ sudo yum install nvidia-driver-latest-dkms - -.. warning:: Verify that the output indicates that driver **418.87** will be installed. - - - -3. Copy the file to the **/etc/udev/rules.d** directory. - - :: - -4. If you are using RHEL 7 version (7.6 or later), comment out, remove, or change the hot-pluggable memory rule located in file copied to the **/etc/udev/rules.d** directory by running the following command: - - .. code-block:: - - $ sudo cp /lib/udev/rules.d/40-redhat.rules /etc/udev/rules.d - $ sudo sed -i 's/SUBSYSTEM!="memory",.*GOTO="memory_hotplug_end"/SUBSYSTEM=="*", GOTO="memory_hotplug_end"/' /etc/udev/rules.d/40-redhat.rules - -#. Enable the **nvidia-persisted.service** file: - - .. code-block:: - - $ sudo systemctl enable nvidia-persistenced.service - -#. Reboot your system to initialize the above modifications. - - :: - -#. Verify that the Nvidia driver and the **nvidia-persistenced.service** files are running: - - .. code-block:: - - $ nvidia smi - - The following is the correct output: - - .. code-block:: - - nvidia-smi - Wed Oct 30 14:05:42 2019 - +-----------------------------------------------------------------------------+ - | NVIDIA-SMI 418.87.00 Driver Version: 418.87.00 CUDA Version: 10.1 | - |-------------------------------+----------------------+----------------------+ - | GPU Name Persistence-M| Bus-Id Disp.A | Volatile Uncorr. ECC | - | Fan Temp Perf Pwr:Usage/Cap| Memory-Usage | GPU-Util Compute M. | - |===============================+======================+======================| - | 0 Tesla V100-SXM2... On | 00000004:04:00.0 Off | 0 | - | N/A 32C P0 37W / 300W | 0MiB / 16130MiB | 0% Default | - +-------------------------------+----------------------+----------------------+ - | 1 Tesla V100-SXM2... On | 00000035:03:00.0 Off | 0 | - | N/A 33C P0 37W / 300W | 0MiB / 16130MiB | 0% Default | - +-------------------------------+----------------------+----------------------+ - - +-----------------------------------------------------------------------------+ - | Processes: GPU Memory | - | GPU PID Type Process name Usage | - |=============================================================================| - | No running processes found | - +-----------------------------------------------------------------------------+ - -#. Verify that the **nvidia-persistenced** service is running: - - .. code-block:: - - $ systemctl status nvidia-persistenced - - The following is the correct output: - - .. code-block:: - - root@gpudb ~]systemctl status nvidia-persistenced - nvidia-persistenced.service - NVIDIA Persistence Daemon - Loaded: loaded (/usr/lib/systemd/system/nvidia-persistenced.service; enabled; vendor preset: disabled) - Active: active (running) since Tue 2019-10-15 21:43:19 KST; 11min ago - Process: 8257 ExecStart=/usr/bin/nvidia-persistenced --verbose (code=exited, status=0/SUCCESS) - Main PID: 8265 (nvidia-persiste) - Tasks: 1 - Memory: 21.0M - CGroup: /system.slice/nvidia-persistenced.service - └─8265 /usr/bin/nvidia-persistenced --verbose - -Installing the Docker Engine (Community Edition) -======================= -After installing the Nvidia CUDA driver you must install the Docker engine. - -This section describes how to install the Docker engine using the following processors: - -* :ref:`Using x86_64 processor on CentOS <dockerx8664centos>` -* :ref:`Using x86_64 processor on Ubuntu <dockerx8664ubuntu>` -* :ref:`Using IBM Power9 (PPC64le) processor <docker_ibmpower9>` - - -.. _dockerx8664centos: - -Installing the Docker Engine Using an x86_64 Processor on CentOS ---------------------------------- -The x86_64 processor supports installing the **Docker Community Edition (CE)** versions 18.03 and higher. - -For more information on installing the Docker Engine CE on an x86_64 processor, see `Install Docker Engine on CentOS <https://docs.docker.com/engine/install/centos/>`_ - - - -.. _dockerx8664ubuntu: - -Installing the Docker Engine Using an x86_64 Processor on Ubuntu ------------------------------------------------------ - - -The x86_64 processor supports installing the **Docker Community Edition (CE)** versions 18.03 and higher. - -For more information on installing the Docker Engine CE on an x86_64 processor, see `Install Docker Engine on Ubuntu <https://docs.docker.com/install/linux/docker-ce/ubuntu/>`_ - -.. _docker_ibmpower9: - -Installing the Docker Engine on an IBM Power9 Processor ----------------------------------------- -The x86_64 processor only supports installing the **Docker Community Edition (CE)** version 18.03. - -**To install the Docker Engine on an IBM Power9 processor:** - -You can install the Docker Engine on an IBM Power9 processor by running the following command: - -.. code-block:: - - wget http://ftp.unicamp.br/pub/ppc64el/rhel/7_1/docker-ppc64el/container-selinux-2.9-4.el7.noarch.rpm - wget http://ftp.unicamp.br/pub/ppc64el/rhel/7_1/docker-ppc64el/docker-ce-18.03.1.ce-1.el7.centos.ppc64le.rpm - yum install -y container-selinux-2.9-4.el7.noarch.rpm docker-ce-18.03.1.ce-1.el7.centos.ppc64le.rpm - -For more information on installing the Docker Engine CE on an IBM Power9 processor, see `Install Docker Engine on Ubuntu <https://developer.ibm.com/components/ibm-power/tutorials/install-docker-on-linux-on-power/>`_. - -Docker Post-Installation -================================= -After installing the Docker engine you must configure Docker on your local machine. - -**To configure Docker on your local machine:** - -1. Enable Docker to start on boot: - - .. code-block:: - - $ sudo systemctl enable docker && sudo systemctl start docker - -2. Enable managing Docker as a non-root user: - - .. code-block:: - - $ sudo usermod -aG docker $USER - -3. Log out and log back in via SSH. This causes Docker to re-evaluate your group membership. - - :: - -4. Verify that you can run the following Docker command as a non-root user (without ``sudo``): - - .. code-block:: - - $ docker run hello-world - -If you can run the above Docker command as a non-root user, the following occur: - -* Docker downloads a test image and runs it in a container. -* When the container runs, it prints an informational message and exits. - -For more information on installing the Docker Post-Installation, see `Docker Post-Installation <https://docs.docker.com/install/linux/linux-postinstall/>`_. - -Installing the Nvidia Docker2 ToolKit -========================================== -After configuring Docker on your local machine you must install the Nvidia Docker2 ToolKit. The NVIDIA Docker2 Toolkit lets you build and run GPU-accelerated Docker containers. The Toolkit includes a container runtime library and related utilities for automatically configuring containers to leverage NVIDIA GPU's. - -This section describes the following: - -* :ref:`Installing the NVIDIA Docker2 Toolkit on an x86_64 processor <install_nvidia_docker2_toolkit_x8664_processor>` -* :ref:`Installing the NVIDIA Docker2 Toolkit on a PPC64le processor <install_nvidia_docker2_toolkit_ppc64le_processor>` - -.. _install_nvidia_docker2_toolkit_x8664_processor: - -Installing the NVIDIA Docker2 Toolkit on an x86_64 Processor ----------------------------------------- - -This section describes the following: - -* :ref:`Installing the NVIDIA Docker2 Toolkit on a CentOS operating system <install_nvidia_docker2_toolkit_centos>` - -* :ref:`Installing the NVIDIA Docker2 Toolkit on an Ubuntu operating system <install_nvidia_docker2_toolkit_ubuntu>` - -.. _install_nvidia_docker2_toolkit_centos: - -Installing the NVIDIA Docker2 Toolkit on a CentOS Operating System -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**To install the NVIDIA Docker2 Toolkit on a CentOS operating system:** - -1. Install the repository for your distribution: - - .. code-block:: - - distribution=$(. /etc/os-release;echo $ID$VERSION_ID) - curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.repo | \ - sudo tee /etc/yum.repos.d/nvidia-docker.repo - -2. Install the ``nvidia-docker2`` package and reload the Docker daemon configuration: - - .. code-block:: - - $ sudo yum install nvidia-docker2 - $ sudo pkill -SIGHUP dockerd - -3. Do one of the following: - - * If you received an error when installing the ``nvidia-docker2`` package, skip to :ref:`Step 4 <step_4_centos>`. - * If you successfully installed the ``nvidia-docker2`` package, skip to :ref:`Step 5 <step_5_centos>`. - -.. _step_4_centos: - -4. Do the following: - - 1. Run the ``sudo vi /etc/yum.repos.d/nvidia-docker.repo`` command if the following error is displayed when installing the ``nvidia-docker2`` package: - - - .. code-block:: - - https://nvidia.github.io/nvidia-docker/centos7/ppc64le/repodata/repomd.xml: - [Errno -1] repomd.xml signature could not be verified for nvidia-docker - - 2. Change ``repo_gpgcheck=1`` to ``repo_gpgcheck=0``. - -.. _step_5_centos: - -5. Verify that the NVIDIA-Docker run has been installed correctly: - - .. code-block:: - - $ docker run --runtime=nvidia --rm nvidia/cuda:10.1.3-base-centos7 nvidia-smi - -For more information on installing the NVIDIA Docker2 Toolkit on a CentOS operating system, see :ref:`Installing the NVIDIA Docker2 Toolkit on a CentOS operating system <https://github.com/NVIDIA/nvidia-docker/wiki/Installation-(version-2.0)#centos-distributions-1>` - - -.. _install_nvidia_docker2_toolkit_ubuntu: - -Installing the NVIDIA Docker2 Toolkit on an Ubuntu Operating System -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**To install the NVIDIA Docker2 Toolkit on an Ubuntu operating system:** - -1. Install the repository for your distribution: - - .. code-block:: - - curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add - - distribution=$(. /etc/os-release;echo $ID$VERSION_ID) - curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list - sudo apt-get update - -2. Install the ``nvidia-docker2`` package and reload the Docker daemon configuration: - - .. code-block:: - - $ sudo apt-get install nvidia-docker2 - $ sudo pkill -SIGHUP dockerd - -3. Do one of the following: - - * If you received an error when installing the ``nvidia-docker2`` package, skip to :ref:`Step 4 <step_4_ubuntu>`. - * If you successfully installed the ``nvidia-docker2`` package, skip to :ref:`Step 5 <step_5_ubuntu>`. - - .. _step_4_ubuntu: - -4. Do the following: - - 1. Run the ``sudo vi /etc/yum.repos.d/nvidia-docker.repo`` command if the following error is displayed when installing the ``nvidia-docker2`` package: - - .. code-block:: - - https://nvidia.github.io/nvidia-docker/centos7/ppc64le/repodata/repomd.xml: - [Errno -1] repomd.xml signature could not be verified for nvidia-docker - - 2. Change ``repo_gpgcheck=1`` to ``repo_gpgcheck=0``. - -.. _step_5_ubuntu: - -5. Verify that the NVIDIA-Docker run has been installed correctly: - - .. code-block:: - - $ docker run --runtime=nvidia --rm nvidia/cuda:10.1.3-base-centos7 nvidia-smi - -For more information on installing the NVIDIA Docker2 Toolkit on a CentOS operating system, see :ref:`Installing the NVIDIA Docker2 Toolkit on an Ubuntu operating system <https://github.com/NVIDIA/nvidia-docker/wiki/Installation-(version-2.0)#ubuntu-distributions-1>` - -.. _install_nvidia_docker2_toolkit_ppc64le_processor: - -Installing the NVIDIA Docker2 Toolkit on a PPC64le Processor --------------------------------------- - -This section describes how to install the NVIDIA Docker2 Toolkit on an IBM RHEL operating system: - -**To install the NVIDIA Docker2 Toolkit on an IBM RHEL operating system:** - -1. Import the repository and install the ``libnvidia-container`` and the ``nvidia-container-runtime`` containers. - - .. code-block:: - - $ distribution=$(. /etc/os-release;echo $ID$VERSION_ID) - $ curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.repo | \ - sudo tee /etc/yum.repos.d/nvidia-docker.repo - $ sudo yum install -y libnvidia-container* - -2. Do one of the following: - - * If you received an error when installing the containers, skip to :ref:`Step 3 <step_3_installing_nvidia_docker2_toolkit_ppc64le_processor>`. - * If you successfully installed the containers, skip to :ref:`Step 4 <step_4_installing_nvidia_docker2_toolkit_ppc64le_processor>`. - -.. _step_3_installing_nvidia_docker2_toolkit_ppc64le_processor: - -3. Do the following: - - 1. Run the ``sudo vi /etc/yum.repos.d/nvidia-docker.repo`` command if the following error is displayed when installing the containers: - - .. code-block:: - - https://nvidia.github.io/nvidia-docker/centos7/ppc64le/repodata/repomd.xml: - [Errno -1] repomd.xml signature could not be verified for nvidia-docker - - 2. Change ``repo_gpgcheck=1`` to ``repo_gpgcheck=0``. - - :: - - 3. Install the ``libnvidia-container`` container. - - .. code-block:: - - $ sudo yum install -y libnvidia-container* - - .. _step_4_installing_nvidia_docker2_toolkit_ppc64le_processor: - -4. Install the ``nvidia-container-runtime`` container: - - .. code-block:: - - $ sudo yum install -y nvidia-container-runtime* - -5. Add ``nvidia runtime`` to the Docker daemon: - - .. code-block:: - - $ sudo mkdir -p /etc/systemd/system/docker.service.d/ - $ sudo vi /etc/systemd/system/docker.service.d/override.conf - - $ [Service] - $ ExecStart= - $ ExecStart=/usr/bin/dockerd - -6. Restart Docker: - - .. code-block:: - - $ sudo systemctl daemon-reload - $ sudo systemctl restart docker - -7. Verify that the NVIDIA-Docker run has been installed correctly: - - .. code-block:: - - $ docker run --runtime=nvidia --rm nvidia/cuda-ppc64le nvidia-smi - -.. _accessing_hadoop_kubernetes_configuration_files: - -Accessing the Hadoop and Kubernetes Configuration Files --------------------------------------- -The information this section is optional and is only relevant for Hadoop users. If you require Hadoop and Kubernetes (Krb5) connectivity, contact your IT department for access to the following configuration files: - -* Hadoop configuration files: - - * core-site.xml - * hdfs-site.xml - - :: - -* Kubernetes files: - - * Configuration file - krb.conf - * Kubernetes Hadoop client certificate - hdfs.keytab - -Once you have the above files, you must copy them into the correct folders in your working directory. - -For more information about the correct directory to copy the above files into, see the :ref:`Installing the SQream Software <installing_sqream_software>` section below. - -For related information, see the following sections: - -* :ref:`Configuring the Hadoop and Kubernetes Configuration Files <configure_hadoop_kubernetes_configuration_files>` -* :ref:`Setting the Hadoop and Kubernetes Configuration Parameters <setting_hadoop_kubernetes_connectivity_parameters>` - -.. _installing_sqream_software: - -Installing the SQream Software -============================== - -Preparing Your Local Environment -------------------------- -After installing the Nvidia Docker2 toolKit you must prepare your local environment. - -.. note:: You must install the SQream software under a *sqream* and not a *root* user. - -The Linux user preparing the local environment must have **read/write** access to the following directories for the SQream software to correctly read and write the required resources: - -* **Log directory** - default: /var/log/sqream/ -* **Configuration directory** - default: /etc/sqream/ -* **Cluster directory** - the location where SQream writes its DB system, such as */mnt/sqreamdb* -* **Ingest directory** - the location where the required data is loaded, such as */mnt/data_source/* - -.. _download_sqream_software: - -Deploying the SQream Software -------------------------- -After preparing your local environment you must deploy the SQream software. Deploying the SQream software requires you to access and extract the required files and to place them in the correct directory. - -**To deploy the SQream software:** - -1. Contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_ for access to the **sqream_installer-nnn-DBnnn-COnnn-EDnnn-<arch>.tar.gz** file. - -The **sqream_installer-nnn-DBnnn-COnnn-EDnnn-<arch>.tar.gz** file includes the following parameter values: - -* **sqream_installer-nnn** - sqream installer version -* **DBnnn** - SQreamDB version -* **COnnn** - SQream console version -* **EDnnn** - SQream editor version -* **arch** - server arch (applicable to X86.64 and ppc64le) - -2. Extract the tarball file: - - .. code-block:: - - $ tar -xvf sqream_installer-1.1.5-DB2019.2.1-CO1.5.4-ED3.0.0-x86_64.tar.gz - - When the tarball file has been extracted, a new folder will be created. The new folder is automatically given the name of the tarball file: - - .. code-block:: - - drwxrwxr-x 9 sqream sqream 4096 Aug 11 11:51 sqream_istaller-1.1.5-DB2019.2.1-CO1.5.4-ED3.0.0-x86_64/ - -rw-rw-r-- 1 sqream sqream 3130398797 Aug 11 11:20 sqream_installer-1.1.5-DB2019.2.1-CO1.5.4-ED3.0.0-x86_64.tar.gz - -3. Change the directory to the new folder that you created in the previous step. - -:: - -4. Verify that the folder you just created contains all of the required files. - - .. code-block:: - - $ ls -la - - The following is an example of the files included in the new folder: - - .. code-block:: - - drwxrwxr-x. 10 sqream sqream 198 Jun 3 17:57 . - drwx------. 25 sqream sqream 4096 Jun 7 18:11 .. - drwxrwxr-x. 2 sqream sqream 226 Jun 7 18:09 .docker - drwxrwxr-x. 2 sqream sqream 64 Jun 3 12:55 .hadoop - drwxrwxr-x. 2 sqream sqream 4096 May 31 14:18 .install - drwxrwxr-x. 2 sqream sqream 39 Jun 3 12:53 .krb5 - drwxrwxr-x. 2 sqream sqream 22 May 31 14:18 license - drwxrwxr-x. 2 sqream sqream 82 May 31 14:18 .sqream - -rwxrwxr-x. 1 sqream sqream 1712 May 31 14:18 sqream-console - -rwxrwxr-x. 1 sqream sqream 4608 May 31 14:18 sqream-install - -For information relevant to Hadoop users, see the following sections: - -* :ref:`Accessing the Hadoop and Kubernetes Configuration Files <accessing_hadoop_kubernetes_configuration_files>`. -* :ref:`Configuring the Hadoop and Kubernetes Configuration Files <configure_hadoop_kubernetes_configuration_files>`. -* :ref:`Setting the Hadoop and Kubernetes Configuration Parameters <setting_hadoop_kubernetes_connectivity_parameters>`. - -.. _configure_hadoop_kubernetes_configuration_files: - -Configuring the Hadoop and Kubernetes Configuration Files ------------------------------ -The information in this section is optional and is only relevant for Hadoop users. If you require Hadoop and Kubernetes (Krb5) connectivity, you must copy the Hadoop and Kubernetes files into the correct folders in your working directory as shown below: - -* .hadoop/core-site.xml -* .hadoop/hdfs-site.xml -* .krb5/krb5.conf -* .krb5/hdfs.keytab - -For related information, see the following sections: - -* :ref:`Accessing the Hadoop and Kubernetes Configuration Files <accessing_hadoop_kubernetes_configuration_files>`. -* :ref:`Setting the Hadoop and Kubernetes Configuration Parameters <setting_hadoop_kubernetes_connectivity_parameters>`. - -Configuring the SQream Software -------------------------------- -After deploying the SQream software, and optionally configuring the Hadoop and Kubernetes configuration files, you must configure the SQream software. - -Configuring the SQream software requires you to do the following: - -* Configure your local environment -* Understand the ``sqream-install`` flags -* Install your SQream license -* Validate your SQream icense -* Change your data ingest folder - -Configuring Your Local Environment -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Once you've downloaded the SQream software, you can begin configuring your local environment. The following commands must be run (as **sudo**) from the same directory that you located your packages. - -For example, you may have saved your packages in **/home/sqream/sqream-console-package/**. - -The following table shows the flags that you can use to configure your local directory: - -.. list-table:: - :widths: 10 50 40 - :header-rows: 1 - - * - Flag - - Function - - Note - * - **-i** - - Loads all software from the hidden folder **.docker**. - - Mandatory - * - **-k** - - Loads all license packages from the **/license** directory. - - Mandatory - * - **-f** - - Overwrites existing folders. **Note** Using ``-f`` overwrites **all files** located in mounted directories. - - Mandatory - * - **-c** - - Defines the origin path for writing/reading SQream configuration files. The default location is ``/etc/sqream/``. - - If you are installing the Docker version on a server that already works with SQream, do not use the default path. - * - **-v** - - The SQream cluster location. If a cluster does not exist yet, ``-v`` creates one. If a cluster already exists, ``-v`` mounts it. - - Mandatory - * - **-l** - - SQream system startup logs location, including startup logs and docker logs. The default location is ``/var/log/sqream/``. - - - * - **-d** - - The directory containing customer data to be imported and/or copied to SQream. - - - * - **-s** - - Shows system settings. - - - * - **-r** - - Resets the system configuration. This value is run without any other variables. - - Mandatory - * - **-h** - - Help. Shows the available flags. - - Mandatory - * - **-K** - - Runs license validation - - - * - **-e** - - Used for inserting your RKrb5 server DNS name. For more information on setting your Kerberos configuration parameters, see :ref:`Setting the Hadoop and Kubernetes Configuration Parameters <setting_hadoop_kubernetes_connectivity_parameters>`. - - - * - **-p** - - Used for inserting your Kerberos user name. For more information on setting your Kerberos configuration parameters, see :ref:`Setting the Hadoop and Kubernetes Configuration Parameters <setting_hadoop_kubernetes_connectivity_parameters>`. - - - - -Installing Your License -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Once you've configured your local environment, you must install your license by copying it into the SQream installation package folder located in the **./license** folder: - -.. code-block:: - - $ sudo ./sqream-install -k - -You do not need to extract this folder after uploading into the **./license**. - - -Validating Your License -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -You can copy your license package into the SQream console folder located in the **/license** folder by running the following command: - -.. code-block:: - - $ sudo ./sqream-install -K - -The following mandatory flags must be used in the first run: - -.. code-block:: - - $ sudo ./sqream-install -i -k -v <volume path> - -The following is an example of the correct command syntax: - -.. code-block:: - - $ sudo ./sqream-install -i -k -c /etc/sqream -v /home/sqream/sqreamdb -l /var/log/sqream -d /home/sqream/data_ingest - -.. _setting_hadoop_kubernetes_connectivity_parameters: - -Setting the Hadoop and Kubernetes Connectivity Parameters -------------------------------- -The information in this section is optional, and is only relevant for Hadoop users. If you require Hadoop and Kubernetes (Krb5) connectivity, you must set their connectivity parameters. - -The following is the correct syntax when setting the Hadoop and Kubernetes connectivity parameters: - -.. code-block:: - - $ sudo ./sqream-install -p <Kerberos user name> -e <Kerberos server DNS name>:<Kerberos server IP> - -The following is an example of setting the Hadoop and Kubernetes connectivity parameters: - -.. code-block:: - - $ sudo ./sqream-install -p <nn1@SQ.COM> -e kdc.sq.com:<192.168.1.111> - -For related information, see the following sections: - -* :ref:`Accessing the Hadoop and Kubernetes Configuration Files <accessing_hadoop_kubernetes_configuration_files>`. -* :ref:`Configuring the Hadoop and Kubernetes Configuration Files <configure_hadoop_kubernetes_configuration_files>`. - -Modifying Your Data Ingest Folder -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Once you've validated your license, you can modify your data ingest folder after the first run by running the following command: - -.. code-block:: - - $ sudo ./sqream-install -d /home/sqream/data_in - -Configuring Your Network for Docker -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Once you've modified your data ingest folder (if needed), you must validate that the server network and Docker network that you are setting up do not overlap. - -**To configure your network for Docker:** - -1. To verify that your server network and Docker network do not overlap, run the following command: - -.. code-block:: - - $ ifconfig | grep 172. - -2. Do one of the following: - - * If running the above command output no results, continue the installation process. - * If running the above command output results, run the following command: - - .. code-block:: - - $ ifconfig | grep 192.168. - - -Checking and Verifying Your System Settings -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Once you've configured your network for Docker, you can check and verify your system settings. - -Running the following command shows you all the variables used by your SQream system: - -.. code-block:: - - $ ./sqream-install -s - -The following is an example of the correct output: - -.. code-block:: - - SQREAM_CONSOLE_TAG=1.5.4 - SQREAM_TAG=2019.2.1 - SQREAM_EDITOR_TAG=3.0.0 - license_worker_0=f0:cc: - license_worker_1=26:91: - license_worker_2=20:26: - license_worker_3=00:36: - SQREAM_VOLUME=/media/sqreamdb - SQREAM_DATA_INGEST=/media/sqreamdb/data_in - SQREAM_CONFIG_DIR=/etc/sqream/ - LICENSE_VALID=true - SQREAM_LOG_DIR=/var/log/sqream/ - SQREAM_USER=sqream - SQREAM_HOME=/home/sqream - SQREAM_ENV_PATH=/home/sqream/.sqream/env_file - PROCESSOR=x86_64 - METADATA_PORT=3105 - PICKER_PORT=3108 - NUM_OF_GPUS=2 - CUDA_VERSION=10.1 - NVIDIA_SMI_PATH=/usr/bin/nvidia-smi - DOCKER_PATH=/usr/bin/docker - NVIDIA_DRIVER=418 - SQREAM_MODE=single_host - -Using the SQream Console -========================= -After configuring the SQream software and veriying your system settings you can begin using the SQream console. - -SQream Console - Basic Commands ---------------------------------- -The SQream console offers the following basic commands: - -* :ref:`Starting your SQream console <starting_sqream_console>` -* :ref:`Starting Metadata and Picker <starting_metadata_and_picker>` -* :ref:`Starting the running services <starting_running_services>` -* :ref:`Listing the running services <listing_running_services>` -* :ref:`Stopping the running services <stopping_running_services>` -* :ref:`Using the SQream editor <using_sqream_editor>` -* :ref:`Using the SQream Client <using_sqream_client>` - -.. _starting_sqream_console: - -Starting Your SQream Console -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -You can start your SQream console by running the following command: - -.. code-block:: - - $ ./sqream-console - -.. _starting_metadata_and_picker: - -Starting the SQream Master -~~~~~~~~~~~~~~~~~ - -**To listen to metadata and picker:** - -1. Start the metadata server (default port 3105) and picker (default port 3108) by running the following command: - - .. code-block:: - - $ sqream master --start - - The following is the correct output: - - .. code-block:: - - sqream-console> sqream master --start - starting master server in single_host mode ... - sqream_single_host_master is up and listening on ports: 3105,3108 - - -2. *Optional* - Change the metadata and server picker ports by adding ``-p <port number>`` and ``-m <port number>``: - - .. code-block:: - - $ sqream-console>sqream master --start -p 4105 -m 43108 - $ starting master server in single_host mode ... - $ sqream_single_host_master is up and listening on ports: 4105,4108 - - - -.. _starting_running_services: - -Starting SQream Workers -~~~~~~~~~~~~~~~~~ - - -When starting SQream workers, setting the ``<number of workers>`` value sets how many workers to start. Leaving the ``<number of workers>`` value unspecified runs all of the available resources. - - -.. code-block:: - - $ sqream worker --start <number of workers> - - The following is an example of expected output when setting the ``<number of workers>`` value to ``2``: - - .. code-block:: - - sqream-console>sqream worker --start 2 - started sqream_single_host_worker_0 on port 5000, allocated gpu: 0 - started sqream_single_host_worker_1 on port 5001, allocated gpu: 1 - - -.. _listing_running_services: - -Listing the Running Services -~~~~~~~~~~~~~~~~~ - -You can list running SQream services to look for container names and ID's by running the following command: - -.. code-block:: - - $ sqream master --list - -The following is an example of the expected output: - -.. code-block:: - - sqream-console>sqream master --list - container name: sqream_single_host_worker_0, container id: c919e8fb78c8 - container name: sqream_single_host_master, container id: ea7eef80e038-- - - -.. _stopping_running_services: - -Stopping the Running Services -~~~~~~~~~~~~~~~~~ - -You can stop running services either for a single SQream worker, or all SQream services for both master and worker. - -The following is the command for stopping a running service for a single SQream worker: - -.. code-block:: - - $ sqream worker --stop <full worker name> - -The following is an example of expected output when stopping a running service for a single SQream worker: - -.. code-block:: - - sqream worker stop <full worker name> - stopped container sqream_single_host_worker_0, id: 892a8f1a58c5 - - -You can stop all running SQream services (both master and worker) by running the following command: - -.. code-block:: - - $ sqream-console>sqream master --stop --all - -The following is an example of expected output when stopping all running services: - -.. code-block:: - - sqream-console>sqream master --stop --all - stopped container sqream_single_host_worker_0, id: 892a8f1a58c5 - stopped container sqream_single_host_master, id: 55cb7e38eb22 - - -.. _using_sqream_editor: - -Using SQream Studio -~~~~~~~~~~~~~~~~~ -SQream Studio is an SQL statement editor. - -**To start SQream Studio:** - -1. Run the following command: - - .. code-block:: - - $ sqream studio --start - -The following is an example of the expected output: - - .. code-block:: - - SQream Acceleration Studio is available at http://192.168.1.62:8080 - -2. Click the ``http://192.168.1.62:8080`` link shown in the CLI. - - -**To stop SQream Studio:** - -You can stop your SQream Studio by running the following command: - -.. code-block:: - - $ sqream studio --stop - -The following is an example of the expected output: - -.. code-block:: - - sqream_admin stopped - - -.. _using_sqream_client: - -Using the SQream Client -~~~~~~~~~~~~~~~~~ -You can use the embedded SQream Client on the following nodes: - -* Master node -* Worker node - - -When using the SQream Client on the Master node, the following default settings are used: - -* **Default port**: 3108. You can change the default port using the ``-p`` variable. -* **Default database**: master. You can change the default database using the ``-d`` variable. - -The following is an example: - -.. code-block:: - - $ sqream client --master -u sqream -w sqream - - -When using the SQream Client on a Worker node (or nodes), you should use the ``-p`` variable for Worker ports. The default database is ``master``, but you can use the ``-d`` variable to change databases. - -The following is an example: - -.. code-block:: - - $ sqream client --worker -p 5000 -u sqream -w sqream - - -Moving from Docker Installation to Standard On-Premises Installation ------------------------------------------------ - -Because Docker creates all files and directories on the host at the **root** level, you must grant ownership of the SQream storage folder to the working directory user. - -SQream Console - Advanced Commands ------------------------------ - -The SQream console offers the following advanced commands: - - -* :ref:`Controlling the spool size <controlling_spool_size>` -* :ref:`Splitting a GPU <splitting_gpu>` -* :ref:`Splitting a GPU and setting the spool size <splitting_gpu_setting_spool_size>` -* :ref:`Using a custom configuration file <using_custom_configuration_file>` -* :ref:`Clustering your Docker environment <clustering_docker_environment>` - - - - -.. _controlling_spool_size: - -Controlling the Spool Size -~~~~~~~~~~~~~~~~~~ - -From the console you can define a spool size value. - -The following example shows the spool size being set to ``50``: - -.. code-block:: - - $ sqream-console>sqream worker --start 2 -m 50 - - -If you don't define the SQream spool size, the SQream console automatically distributes the available RAM between all running workers. - -.. _splitting_gpu: - -Splitting a GPU -~~~~~~~~~~~~~~~~~~ - -You can start more than one sqreamd on a single GPU by splitting it. - - -The following example shows the GPU being split into **two** sqreamd's on the GPU in **slot 0**: - -.. code-block:: - - $ sqream-console>sqream worker --start 2 -g 0 - -.. _splitting_gpu_setting_spool_size: - -Splitting GPU and Setting the Spool Size -~~~~~~~~~~~~~~~~~~ - -You can simultaneously split a GPU and set the spool size by appending the ``-m`` flag: - -.. code-block:: - - $ sqream-console>sqream worker --start 2 -g 0 -m 50 - -.. note:: The console does not validate whether the user-defined spool size is available. Before setting the spool size, verify that the requested resources are available. - -.. _using_custom_configuration_file: - -Using a Custom Configuration File -~~~~~~~~~~~~~~~~~~ - -SQream lets you use your own external custom configuration json files. You must place these json files in the path mounted in the installation. SQream recommends placing the json file in the Configuration folder. - -The SQream console does not validate the integrity of your external configuration files. - -When using your custom configuration file, you can use the ``-j`` flag to define the full path to the Configuration file, as in the example below: - -.. code-block:: - - $ sqream-console>sqream worker --start 1 -j /etc/sqream/configfile.json - -.. note:: To start more than one sqream daemon, you must provide files for each daemon, as in the example below: - -.. code-block:: - - $ sqream worker --start 2 -j /etc/sqream/configfile.json /etc/sqream/configfile2.json - -.. note:: To split a specific GPU, you must also list the GPU flag, as in the example below: - -.. code-block:: - - $ sqream worker --start 2 -g 0 -j /etc/sqream/configfile.json /etc/sqream/configfile2.json - -.. _clustering_docker_environment: - -Clustering Your Docker Environment -~~~~~~~~~~~~~~~~~~ - -SQream lets you connect to a remote Master node to start Docker in Distributed mode. If you have already connected to a Slave node server in Distributed mode, the **sqream Master** and **Client** commands are only available on the Master node. - -.. code-block:: - - $ --master-host - $ sqream-console>sqream worker --start 1 --master-host 192.168.0.1020 - -Checking the Status of SQream Services ---------------------------- -SQream lets you check the status of SQream services from the following locations: - -* :ref:`From the Sqream console <inside_sqream_console>` -* :ref:`From outside the Sqream console <outside_sqream_console>` - -.. _inside_sqream_console: - -Checking the Status of SQream Services from the SQream Console -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -From the SQream console, you can check the status of SQream services by running the following command: - -.. code-block:: - - $ sqream-console>sqream master --list - -The following is an example of the expected output: - -.. code-block:: - - $ sqream-console>sqream master --list - $ checking 3 sqream services: - $ sqream_single_host_worker_1 up, listens on port: 5001 allocated gpu: 1 - $ sqream_single_host_worker_0 up, listens on port: 5000 allocated gpu: 1 - $ sqream_single_host_master up listens on ports: 3105,3108 - -.. _outside_sqream_console: - -Checking the Status of SQream Services from Outside the SQream Console -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -From outside the Sqream Console, you can check the status of SQream services by running the following commands: - -.. code-block:: - - $ sqream-status - $ NAMES STATUS PORTS - $ sqream_single_host_worker_1 Up 3 minutes 0.0.0.0:5001->5001/tcp - $ sqream_single_host_worker_0 Up 3 minutes 0.0.0.0:5000->5000/tcp - $ sqream_single_host_master Up 3 minutes 0.0.0.0:3105->3105/tcp, 0.0.0.0:3108->3108/tcp - $ sqream_editor_3.0.0 Up 3 hours (healthy) 0.0.0.0:3000->3000/tcp - -Upgrading Your SQream System ----------------------------- -This section describes how to upgrade your SQream system. - -**To upgrade your SQream system:** - -1. Contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_ team for access to the new SQream package tarball file. - - :: - -2. Set a maintenance window to enable stopping the system while upgrading it. - - :: - -3. Extract the following tarball file received from the SQream Support team, under it with the same user and in the same folder that you used while :ref:`Downloading the SQream Software <_download_sqream_software>`. - - - .. code-block:: - - $ tar -xvf sqream_installer-2.0.5-DB2019.2.1-CO1.6.3-ED3.0.0-x86_64/ - -4. Navigate to the new folder created as a result of extracting the tarball file: - - .. code-block:: - - $ cd sqream_installer-2.0.5-DB2019.2.1-CO1.6.3-ED3.0.0-x86_64/ - -5. Initiate the upgrade process: - - .. code-block:: - - $ ./sqream-install -i - - Initiating the upgrade process checks if any SQream services are running. If any services are running, you will be prompted to stop them. - -6. Do one of the following: - - * Select **Yes** to stop all running SQream workers (Master and Editor) and continue the upgrade process. - * Select **No** to stop the upgrade process. - - SQream periodically upgrades the metadata structure. If an upgrade version includes a change to the metadata structure, you will be prompted with an approval request message. Your approval is required to finish the upgrade process. - - Because SQream supports only certain metadata versions, all SQream services must be upgraded at the same time. - -7. When the upgrade is complete, load the SQream console and restart your services. - - For assistance, contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_. From 67f1306aeee307dbf61e9a24c73c764d3f5fbb20 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 25 May 2023 09:02:49 +0300 Subject: [PATCH 563/882] Update getting_started.rst --- sqream_studio_5.4.7/getting_started.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/sqream_studio_5.4.7/getting_started.rst b/sqream_studio_5.4.7/getting_started.rst index 03aeca142..8771e5545 100644 --- a/sqream_studio_5.4.7/getting_started.rst +++ b/sqream_studio_5.4.7/getting_started.rst @@ -4,8 +4,9 @@ Getting Started with SQream Acceleration Studio 5.4.7 **************************** Setting Up and Starting Studio ----------------- -Studio is included with all :ref:`dockerized installations of SQream DB<running_sqream_in_a_docker_container>`. When starting Studio, it listens on the local machine on port 8080. +------------------------------ + +When starting Studio, it listens on the local machine on port 8080. Logging In to Studio --------------- From 140417e91afe32cb44a985d434992ce1639515ad Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 25 May 2023 09:09:43 +0300 Subject: [PATCH 564/882] Update installing_studio_on_stand_alone_server.rst --- ...nstalling_studio_on_stand_alone_server.rst | 179 +----------------- 1 file changed, 1 insertion(+), 178 deletions(-) diff --git a/installation_guides/installing_studio_on_stand_alone_server.rst b/installation_guides/installing_studio_on_stand_alone_server.rst index 362828313..6c6c2e05a 100644 --- a/installation_guides/installing_studio_on_stand_alone_server.rst +++ b/installation_guides/installing_studio_on_stand_alone_server.rst @@ -5,7 +5,7 @@ *********************** Installing Studio on a Stand-Alone Server *********************** -The **Installing Studio on a Stand-Alone Server** guide describes how to install SQream Studio on a stand-alone server. A stand-alone server is a server that does not run SQream based on binary files, Docker, or Kubernetes. +A stand-alone server is a server that does not run SQream based on binary files or Kubernetes. The Installing Studio on a Stand-Alone Server guide includes the following sections: @@ -431,180 +431,3 @@ To upgrade Studio you need to stop the version that you currently have. Back to :ref:`Installing Studio on a Stand-Alone Server<install_studio_top>` -.. _install_studio_docker_container: - -Installing Studio in a Docker Container -^^^^^^^^^^^^^^^^^^^^^^^ -This guide explains how to install SQream Studio in a Docker container and includes the following sections: - -.. contents:: - :local: - :depth: 1 - -Installing Studio --------------- -If you have already installed Docker, you can install Studio in a Docker container. - -**To install Studio:** - -1. Copy the downloaded image onto the target server. - -:: - -2. Load the Docker image. - - .. code-block:: console - - $ docker load -i <docker_image_file> - -:: - -3. If the downloaded image is called **sqream-acceleration-studio-5.1.3.x86_64.docker18.0.3.tar,** run the following command: - - .. code-block:: console - - $ docker load -i sqream-acceleration-studio-5.1.3.x86_64.docker18.0.3.tar - -:: - -4. Start the Docker container. - - .. code-block:: console - - $ docker run -d --restart=unless-stopped -p <external port>:8080 -e runtime=docker -e SQREAM_K8S_PICKER=<SQream host IP or VIP> -e SQREAM_PICKER_PORT=<SQream picker port> -e SQREAM_DATABASE_NAME=<SQream database name> -e SQREAM_ADMIN_UI_PORT=8080 --name=sqream-admin-ui <docker_image_name> - - The following is an example of the command above: - - .. code-block:: console - - $ docker run -d --name sqream-studio -p 8080:8080 -e runtime=docker -e SQREAM_K8S_PICKER=192.168.0.183 -e SQREAM_PICKER_PORT=3108 -e SQREAM_DATABASE_NAME=master -e SQREAM_ADMIN_UI_PORT=8080 sqream-acceleration-studio:5.1.3 - -Back to :ref:`Installing Studio in a Docker Container<install_studio_docker_container>` - -Accessing Studio ------------------ -You can access Studio from Port 8080: ``http://<server ip>:8080``. - -If you want to use Studio over a secure connection (https), you must use the parameter values shown in the following table: - -.. list-table:: - :widths: 10 25 65 - :header-rows: 1 - - * - Parameter - - Default Value - - Description - * - ``--web-ssl-port`` - - 8443 - - - * - ``--web-ssl-key-path`` - - None - - The path of SSL key PEM file for enabling https. Leave empty to disable. - * - ``--web-ssl-cert-path`` - - None - - The path of SSL certificate PEM file for enabling https. Leave empty to disable. - -You can configure the above parameters using the following syntax: - -.. code-block:: console - - $ npm run setup -- -y --host=127.0.0.1 --port=3108 - -.. _using_docker_container_commands: - -Back to :ref:`Installing Studio in a Docker Container<install_studio_docker_container>` - -Using Docker Container Commands ---------------- -When installing Studio in Docker, you can run the following commands: - -* View Docker container logs: - - .. code-block:: console - - $ docker logs -f sqream-admin-ui - -* Restart the Docker container: - - .. code-block:: console - - $ docker restart sqream-admin-ui - -* Kill the Docker container: - - .. code-block:: console - - $ docker rm -f sqream-admin-ui - -Back to :ref:`Installing Studio in a Docker Container<install_studio_docker_container>` - -Setting Up Argument Configurations ----------------- -When creating the **sqream-admin-config.json** configuration file, you can add ``-y`` to create the configuration file in non-interactive mode. Configuration files created in non-interactive mode use all the parameter defaults not provided in the command. - -The following table shows the available arguments: - -.. list-table:: - :widths: 10 25 65 - :header-rows: 1 - - * - Parameter - - Default Value - - Description - * - ``--web--host`` - - 8443 - - - * - ``--web-port`` - - 8080 - - - * - ``--web-ssl-port`` - - 8443 - - - * - ``--web-ssl-key-path`` - - None - - The path of the SSL Key PEM file for enabling https. Leave empty to disable. - * - ``--web-ssl-cert-path`` - - None - - The path of the SSL Certificate PEM file for enabling https. Leave empty to disable. - * - ``--debug-sqream (flag)`` - - false - - - * - ``--host`` - - 127.0.0.1 - - - * - ``--port`` - - 3108 - - - * - ``is-cluster (flag)`` - - true - - - * - ``--service`` - - sqream - - - * - ``--ssl (flag)`` - - false - - Enables the SQream SSL connection. - * - ``--name`` - - default - - - * - ``--data-collector-url`` - - localhost:8100/api/dashboard/data - - Enables the Dashboard. Leaving this blank disables the Dashboard. Using a mock URL uses mock data. - * - ``--cluster-type`` - - standalone (``standalone`` or ``k8s``) - - - * - ``--config-location`` - - ./sqream-admin-config.json - - - * - ``--network-timeout`` - - 60000 (60 seconds) - - - * - ``--access-key`` - - None - - If defined, UI access is blocked unless ``?ui-access=<access key>`` is included in the URL. - -Back to :ref:`Installing Studio in a Docker Container<install_studio_docker_container>` - - :: - -Back to :ref:`Installing Studio on a Stand-Alone Server<install_studio_top>` \ No newline at end of file From 2bde6c3a6509179c76191396135560ef4afd054c Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 29 May 2023 11:59:20 +0300 Subject: [PATCH 565/882] Update 4.3.rst --- releases/4.3.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/releases/4.3.rst b/releases/4.3.rst index 62571e42c..36e838428 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -106,6 +106,12 @@ The ``VARCHAR`` data type is deprecated to improve the core functionalities of t * ``VARCHAR`` is no longer supported for new customers, effective from Version 2022.1.3. * The ``TEXT`` data type is replacing the ``VARCHAR`` and ``NVARCHAR`` data types. +End of Support +-------------- + +Support in an :ref:`old method <previous_configuration_method>` of configuring the SQreamDB instance ends on September xxx, 2023. + + Upgrading to v4.3 ------------------- 1. Generate a back-up of the metadata by running the following command: From 2883de426db6ecc10bbea80e6171b6180a6cef54 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 29 May 2023 16:04:04 +0300 Subject: [PATCH 566/882] S3 and permissions --- external_storage_platforms/s3.rst | 22 +++++++++++++- .../access_control_permissions.rst | 30 +++++++++++++++++-- 2 files changed, 49 insertions(+), 3 deletions(-) diff --git a/external_storage_platforms/s3.rst b/external_storage_platforms/s3.rst index bb0a22f27..18dca4476 100644 --- a/external_storage_platforms/s3.rst +++ b/external_storage_platforms/s3.rst @@ -14,7 +14,6 @@ S3 Configuration A best practice for granting access to AWS S3 is by creating an `Identity and Access Management (IAM) <https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started.html>`_ user account. If creating an IAM user account is not possible, you may follow AWS guidelines for `using the global configuration object <https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/global-config-object.html>`_ and setting an `AWS region <https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/setting-region.html>`_. - S3 URI Format ============= With S3, specify a location for a file (or files) when using :ref:`copy_from` or :ref:`foreign_tables`. @@ -25,10 +24,30 @@ The following is an example of the general S3 syntax: s3://bucket_name/path + Authentication ============== SQream supports ``AWS ID`` and ``AWS SECRET`` authentication. These should be specified when executing a statement. + +Access +====== +You may use the following flags within your SQreamDB configuration file to configure access to S3: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + - Default Value + * - ``AwsEndpointOverride`` + - Override the HTTP endpoint used to talk to a service. + - + - ``AwsObjectAccessStyle`` + - There are two main S3 object access styles, which determine how you can access and interact with the objects stored in an S3 bucket. + - + Examples ======== @@ -47,6 +66,7 @@ Use a foreign table to stage data from S3 before loading from CSV, Parquet, or O .. contents:: :local: :depth: 1 + Planning for Data Staging ------------------------- The examples in this section are based on the following table: diff --git a/operational_guides/access_control_permissions.rst b/operational_guides/access_control_permissions.rst index e03e9198d..3f1923024 100644 --- a/operational_guides/access_control_permissions.rst +++ b/operational_guides/access_control_permissions.rst @@ -55,8 +55,34 @@ The following table displays the access control permissions: +--------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``ALL`` | All function permissions | +--------------------+-------------------------------------------------------------------------------------------------------------------------+ - - +| **Object/Layer: View** | ++--------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``SELECT`` | Select from view | ++--------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``DDL`` | DDL operations of view results | ++--------------------+-------------------------------------------------------------------------------------------------------------------------+ +| **Object/Layer: Foreign Table** | ++--------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``SELECT`` | Select from foreign table | ++--------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``DDL`` | Foreign table DDL operations | ++--------------------+-------------------------------------------------------------------------------------------------------------------------+ +| **Object/Layer: Column** | ++--------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``SELECT`` | Select from catalog | ++--------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``DDL`` | Column DDL operations | ++--------------------+-------------------------------------------------------------------------------------------------------------------------+ +| **Object/Layer: Catalog** | ++--------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``SELECT`` | Select from catalog | ++--------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``DDL`` | Catalog DDL operations | ++--------------------+-------------------------------------------------------------------------------------------------------------------------+ +| **Object/Services** | ++--------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``USAGE`` | Using a specific service | ++--------------------+-------------------------------------------------------------------------------------------------------------------------+ GRANT From efc297b0844454fd5b1835287d758d73ba3cb0f0 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 29 May 2023 16:51:42 +0300 Subject: [PATCH 567/882] Update delete_guide.rst --- operational_guides/delete_guide.rst | 25 ++++++++++++------------- 1 file changed, 12 insertions(+), 13 deletions(-) diff --git a/operational_guides/delete_guide.rst b/operational_guides/delete_guide.rst index abf99a0b4..bec0f296d 100644 --- a/operational_guides/delete_guide.rst +++ b/operational_guides/delete_guide.rst @@ -1,8 +1,8 @@ .. _delete_guide: -*********************** +************* Deleting Data -*********************** +************* When working with a table in a database, deleting data typically involves removing rows, although it can also involve removing columns. The process for deleting data involves first deleting the desired content, followed by a cleanup operation that reclaims the space previously occupied by the deleted data. This process is further explained below. @@ -19,7 +19,7 @@ By using the WHERE clause in the DELETE statement, you can specify a condition o :depth: 1 The Deletion Process -========== +==================== When you delete rows from a SQL database, the actual deletion process occurs in two steps: @@ -33,7 +33,7 @@ If you want to delete all rows from a table, you can use the :ref:`TRUNCATE<trun Usage Notes -===================== +=========== General Notes ------------- @@ -124,7 +124,7 @@ Deleting Rows from a Table Return animal_id | animal_name | animal_weight - ------------+------------------+-------------------- + ------------+------------------+-------------- 1 | Dog | 7 2 | Possum | 3 3 | Cat | 5 @@ -132,7 +132,7 @@ Deleting Rows from a Table Deleting Values Based on Complex Predicates ---------------------------------------------------- +------------------------------------------- 1. Delete rows from the table: @@ -158,7 +158,7 @@ Deleting Values Based on Complex Predicates Identifying and Cleaning Up Tables --------------------------------------- -Listing Tables that Have Not Been Cleaned Up +Listing tables that have not been cleaned up: .. code-block:: psql @@ -170,7 +170,7 @@ Listing Tables that Have Not Been Cleaned Up 1 row -Identifying Predicates for Clean-Up +Identifying predicates for Clean-Up: .. code-block:: psql @@ -181,13 +181,12 @@ Identifying Predicates for Clean-Up weight > 1000 1 row - -.. _trigger_cleanup: + Triggering a Clean-Up ^^^^^^^^^^^^^^^^^^^^^^ -When running the clean-up operation, you need to specify two parameters: ``schema_name`` and ``table_name``. However, it's important to note that the second parameter is case-sensitive for both ``CLEANUP_CHUNKS`` and ``CLEANUP_EXTENTS``. +When running the clean-up operation, you need to specify two parameters: ``schema_name`` and ``table_name``. Note that both parameters are case-sensitive and cannot operate with upper-cased schema or table names. Running a ``CLEANUP_CHUNKS`` command (also known as ``SWEEP``) to reorganize the chunks: @@ -206,11 +205,11 @@ If you should want to run a clean-up operation without worrying about uppercase .. code-block:: psql - farm=> SELECT CLEANUP_CHUNKS('<schema_name>','<table_name>', false); + farm=> SELECT CLEANUP_CHUNKS('<schema_name>','<table_name>', true); .. code-block:: psql - farm=> SELECT CLEANUP_EXTENTS('<schema_name>','<table_name>', false); + farm=> SELECT CLEANUP_EXTENTS('<schema_name>','<table_name>', true); To display the table: From cb3397f687da5634117f6cabad60ae2155c25edf Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 30 May 2023 09:47:16 +0300 Subject: [PATCH 568/882] S3 --- external_storage_platforms/s3.rst | 37 +++++++++++++++++++++++-------- releases/4.3.rst | 11 ++++++--- 2 files changed, 36 insertions(+), 12 deletions(-) diff --git a/external_storage_platforms/s3.rst b/external_storage_platforms/s3.rst index 18dca4476..d5433c294 100644 --- a/external_storage_platforms/s3.rst +++ b/external_storage_platforms/s3.rst @@ -7,6 +7,7 @@ SQream uses a native S3 connector for inserting data. The ``s3://`` URI specifie .. contents:: :local: + :depth: 1 S3 Configuration ================ @@ -30,9 +31,11 @@ Authentication SQream supports ``AWS ID`` and ``AWS SECRET`` authentication. These should be specified when executing a statement. -Access -====== -You may use the following flags within your SQreamDB configuration file to configure access to S3: +Connecting to S3 Using SQreamDB Legacy Configuration File +========================================================= + + +You may use the following parameters within your SQreamDB legacy configuration file: .. list-table:: :widths: auto @@ -40,13 +43,29 @@ You may use the following flags within your SQreamDB configuration file to confi * - Parameter - Description - - Default Value + - Parameter Value + - Example * - ``AwsEndpointOverride`` - - Override the HTTP endpoint used to talk to a service. - - - - ``AwsObjectAccessStyle`` - - There are two main S3 object access styles, which determine how you can access and interact with the objects stored in an S3 bucket. - - + - Overrides the AWS S3 HTTP endpoint when using Virtual Private Cloud (VPC) + - ``URL`` + Default: None + - .. code-block:: + + sqream_config_legacy.json: + { + ..., + "AwsEndpointOverride": "https://my.endpoint.local" + } + * - ``AwsObjectAccessStyle`` + - Enables configuration of S3 object access styles, which determine how you can access and interact with the objects stored in an S3 bucket + - ``virtual-host`` or ``path``. Default is ``virtual-host`` + - .. code-block:: + + sqream_config_legacy.json: + { + ..., + "AwsObjectAccessStyle": "path" + } Examples ======== diff --git a/releases/4.3.rst b/releases/4.3.rst index 36e838428..c4e2b7e32 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -76,10 +76,15 @@ Version 4.3 resolved Issues | SQ-12721 | ``maxConnectionInactivitySeconds`` flag issue when executing Batch Shell Program ETLs | +--------------------+------------------------------------------------------------------------------------------------+ -Configuration Changes ---------------------- +Configuration Adjustments +------------------------- -You may now configure the ``metadata_server`` using the ``metadata_server_config.json`` :ref:`configuration file<metadata_server>`. +When using SQreamDB legacy configuration file and AWS S3, you may be required to use the following new parameters: + +* ``AwsEndpointOverride`` +* ``AwsObjectAccessStyle`` + +To learn more about how and when you should use them, visit :ref:`s3`. Deprecated Features From 4808556ceb03a4220570f62a27c6160fff395add Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 30 May 2023 09:52:10 +0300 Subject: [PATCH 569/882] Update s3.rst --- external_storage_platforms/s3.rst | 10 ---------- 1 file changed, 10 deletions(-) diff --git a/external_storage_platforms/s3.rst b/external_storage_platforms/s3.rst index d5433c294..2314170cf 100644 --- a/external_storage_platforms/s3.rst +++ b/external_storage_platforms/s3.rst @@ -70,16 +70,6 @@ You may use the following parameters within your SQreamDB legacy configuration f Examples ======== -AwsEndpointOverride - Enables custom endpoint - -Example: 'https://s3.amazonaws.com' - -AwsObjectAccessStyle - whether to use path-style or virtual object style access - read about in AWS documentation. - -If you wish to use custom endpoint, you need to configure sqream using our legacy configuration file, and add AwsEndpointOverride - Enables custom endpoint. And you may add the AwsObjectAccessStyle flag to send request for a different access style. - - - Use a foreign table to stage data from S3 before loading from CSV, Parquet, or ORC files. .. contents:: From 0a8c5c93bb3943ebbfaf1d06da8cd5fb29c47cba Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 30 May 2023 11:45:30 +0300 Subject: [PATCH 570/882] Permissions --- connecting_to_sqream/client_drivers/index.rst | 2 +- .../access_control_permissions.rst | 320 ++++++++++++------ 2 files changed, 210 insertions(+), 112 deletions(-) diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index 26a6750ea..f8a61d90b 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -17,7 +17,7 @@ The following are applicable to all operating systems: * **JDBC** - recommended installation via ``mvn``: - * `JDBC .jar file <https://sq-ftp-public.s3.amazonaws.com/sqream-jdbc-4.5.6.jar>`_ - sqream-jdbc-4.5.6 (.jar) + * `JDBC .jar file <https://sq-ftp-public.s3.amazonaws.com/sqream-jdbc-4.5.9.jar>`_ - sqream-jdbc-4.5.9 (.jar) * :ref:`java_jdbc` .. _.net: diff --git a/operational_guides/access_control_permissions.rst b/operational_guides/access_control_permissions.rst index 3f1923024..15b41182c 100644 --- a/operational_guides/access_control_permissions.rst +++ b/operational_guides/access_control_permissions.rst @@ -4,6 +4,10 @@ Permissions ************** +.. contents:: + :local: + :depth: 1 + The following table displays the access control permissions: +--------------------+-------------------------------------------------------------------------------------------------------------------------+ @@ -85,161 +89,255 @@ The following table displays the access control permissions: +--------------------+-------------------------------------------------------------------------------------------------------------------------+ -GRANT ------ +GRANT Syntax +============ :ref:`grant` gives permissions to a role. .. code-block:: postgres - -- Grant permissions at the instance/ storage cluster level: - GRANT + -- Grant permissions at the instance/ storage cluster level: + GRANT + + { SUPERUSER + | LOGIN + | PASSWORD '<password>' + } + TO <role> [, ...] + + -- Grant permissions at the database level: + GRANT {{CREATE | CONNECT| DDL | SUPERUSER | CREATE FUNCTION} [, ...] | ALL [PERMISSIONS]} + + ON DATABASE <database> [, ...] + TO <role> [, ...] + + -- Grant permissions at the schema level: + GRANT {{ CREATE | DDL | USAGE | SUPERUSER } [, ...] | ALL [ + PERMISSIONS ]} + ON SCHEMA <schema> [, ...] + TO <role> [, ...] + + -- Grant permissions at the object level: + GRANT {{SELECT | INSERT | DELETE | DDL | UPDATE } [, ...] | ALL [PERMISSIONS]} + ON { TABLE <table_name> [, ...] | ALL TABLES IN SCHEMA <schema_name> [, ...] | VIEW <view_name> [, ...] | ALL VIEWS IN SCHEMA <schema_name> [, ...] | FOREIGN TABLE <table_name> [, ...] | ALL FOREIGN TABLE IN SCHEMA <schema_name> [, ...] | CATALOG <catalog_name> [, ...] } + TO <role> [, ...]; + + -- Grant execute function permission: + GRANT {ALL | EXECUTE | DDL} ON FUNCTION function_name + TO role; + + -- Grant permissions at the column level: + GRANT {{SELECT | DDL } [, ...] | ALL [PERMISSIONS]} + ON { COLUMN <column_name> [, ...] | ALL COLUMNS IN TABLE <table_name> [, ...] | ALL COLUMNS IN FOREIGN TABLE <foreign_table_name> [, ...] | ALL COLUMNS IN VIEW <view_name> [, ...] | ALL COLUMNS IN CATALOG <catalog_name> [, ...]} + TO <role> [, ...]; + + -- Grant permissions at the Service level: + GRANT {{USAGE} [, ...] | ALL [PERMISSIONS]} + ON { SERVICE <service_name> [, ...] | ALL SERVICES IN SYSTEM } + TO <role> [, ...] + + -- Allows role2 to use permissions granted to role1 + GRANT <role1> [, ...] + TO <role2> + + -- Also allows the role2 to grant role1 to other roles: + GRANT <role1> [, ...] + TO <role2> + WITH ADMIN OPTION + +REVOKE Syntax +============= - { SUPERUSER - | LOGIN - | PASSWORD '<password>' - } - TO <role> [, ...] +:ref:`revoke` removes permissions from a role. - -- Grant permissions at the database level: - GRANT {{CREATE | CONNECT| DDL | SUPERUSER | CREATE FUNCTION} [, ...] | ALL [PERMISSIONS]} +.. code-block:: postgres - ON DATABASE <database> [, ...] - TO <role> [, ...] + -- Revoke permissions at the instance/ storage cluster level: + REVOKE + { SUPERUSER + | LOGIN + | PASSWORD + } + FROM <role> [, ...] + + -- Revoke permissions at the database level: + REVOKE {{CREATE | CONNECT | DDL | SUPERUSER | CREATE FUNCTION}[, ...] |ALL [PERMISSIONS]} + ON DATABASE <database> [, ...] + FROM <role> [, ...] + + -- Revoke permissions at the schema level: + REVOKE { { CREATE | DDL | USAGE | SUPERUSER } [, ...] | ALL [PERMISSIONS]} + ON SCHEMA <schema> [, ...] + FROM <role> [, ...] + + -- Revoke permissions at the object level: + REVOKE { { SELECT | INSERT | DELETE | DDL | UPDATE } [, ...] | ALL } + ON { [ TABLE ] <table_name> [, ...] | ALL TABLES IN SCHEMA <schema_name> [, ...] | VIEW <view_name> [, ...] | ALL VIEWS IN SCHEMA <schema_name> [, ...] | FOREIGN TABLE <table_name> [, ...] | ALL FOREIGN TABLES IN SCHEMA <schema_name> [, ...] | CATALOG <catalog_name> [, ...] } + FROM <role> [, ...]; + + -- Revoke permissions at the column level: + REVOKE {{SELECT | DDL } [, ...] | ALL [PERMISSIONS]} + ON { COLUMN <column_name> [, ...] | ALL COLUMNS IN TABLE <table_name> [, ...] | ALL COLUMNS IN FOREIGN TABLE <foreign_table_name> [, ...] | ALL COLUMNS IN VIEW <view_name> [, ...] | ALL COLUMNS IN CATALOG <catalog_name> [, ...]} + FROM <role> [, ...]; + + -- Revoke permissions at the column level: + REVOKE {{USAGE} [, ...] | ALL [PERMISSIONS]} + ON { SERVICE <service_name> [, ...] | ALL SERVICES IN SYSTEM} + FROM <role> [, ...] + + -- Removes access to permissions in role1 by role 2 + REVOKE <role1> [, ...] FROM <role2> [, ...] WITH ADMIN OPTION + + -- Removes permissions to grant role1 to additional roles from role2 + REVOKE <role1> [, ...] FROM <role2> [, ...] WITH ADMIN OPTION + +Altering Default Permissions +============================ - -- Grant permissions at the schema level: - GRANT {{ CREATE | DDL | USAGE | SUPERUSER } [, ...] | ALL [ - PERMISSIONS ]} - ON SCHEMA <schema> [, ...] - TO <role> [, ...] - - -- Grant permissions at the object level: - GRANT {{SELECT | INSERT | DELETE | DDL | UPDATE } [, ...] | ALL [PERMISSIONS]} - ON { TABLE <table_name> [, ...] | ALL TABLES IN SCHEMA <schema_name> [, ...]} - TO <role> [, ...] - - -- Grant execute function permission: - GRANT {ALL | EXECUTE | DDL} ON FUNCTION function_name - TO role; - - -- Allows role2 to use permissions granted to role1 - GRANT <role1> [, ...] - TO <role2> +The default permissions system (See :ref:`alter_default_permissions`) +can be used to automatically grant permissions to newly +created objects (See the departmental example below for one way it can be used). + +A default permissions rule looks for a schema being created, or a +table (possibly by schema), and is table to grant any permission to +that object to any role. This happens when the create table or create +schema statement is run. - -- Also allows the role2 to grant role1 to other roles: - GRANT <role1> [, ...] - TO <role2> - WITH ADMIN OPTION - -``GRANT`` examples: .. code-block:: postgres - GRANT LOGIN,superuser TO admin; + ALTER DEFAULT PERMISSIONS FOR target_role_name + [IN schema_name, ...] + FOR { SCHEMAS | TABLES | FOREIGN TABLE | VIEWS | COLUMN | SERVICES | CATALOG } + { grant_clause | DROP grant_clause} + TO ROLE { role_name | public }; + + grant_clause ::= + GRANT + { CREATE FUNCTION + | SUPERUSER + | CONNECT + | CREATE + | USAGE + | SELECT + | INSERT + | DELETE + | DDL + | UPDATE + | EXECUTE + | ALL + } + +Examples +======== - GRANT CREATE FUNCTION ON database master TO admin; +GRANT Examples +-------------- - GRANT SELECT ON TABLE admin.table1 TO userA; +Grant superuser privileges and login capability to a role: - GRANT EXECUTE ON FUNCTION my_function TO userA; +.. code-block:: postgres - GRANT ALL ON FUNCTION my_function TO userA; + GRANT SUPERUSER, LOGIN TO role_name; + +Grant specific permissions on a database to a role: - GRANT DDL ON admin.main_table TO userB; +.. code-block:: postgres - GRANT ALL ON all tables IN schema public TO userB; + GRANT CREATE, CONNECT, DDL, SUPERUSER, CREATE FUNCTION ON DATABASE database_name TO role_name; + +Grant various permissions on a schema to a role: - GRANT admin TO userC; +.. code-block:: postgres - GRANT superuser ON schema demo TO userA + GRANT CREATE, DDL, USAGE, SUPERUSER ON SCHEMA schema_name TO role_name; + +Grant permissions on specific objects (table, view, foreign table, or catalog) to a role: - GRANT admin_role TO userB; +.. code-block:: postgres -REVOKE ------- + GRANT SELECT, INSERT, DELETE, DDL, UPDATE ON TABLE table_name TO role_name; -:ref:`revoke` removes permissions from a role. +Grant execute function permission to a role: .. code-block:: postgres - -- Revoke permissions at the instance/ storage cluster level: - REVOKE - { SUPERUSER - | LOGIN - | PASSWORD - } - FROM <role> [, ...] - - -- Revoke permissions at the database level: - REVOKE {{CREATE | CONNECT | DDL | SUPERUSER | CREATE FUNCTION}[, ...] |ALL [PERMISSIONS]} - ON DATABASE <database> [, ...] - FROM <role> [, ...] + GRANT EXECUTE ON FUNCTION function_name TO role_name; - -- Revoke permissions at the schema level: - REVOKE { { CREATE | DDL | USAGE | SUPERUSER } [, ...] | ALL [PERMISSIONS]} - ON SCHEMA <schema> [, ...] - FROM <role> [, ...] - - -- Revoke permissions at the object level: - REVOKE { { SELECT | INSERT | DELETE | DDL | UPDATE } [, ...] | ALL } - ON { [ TABLE ] <table_name> [, ...] | ALL TABLES IN SCHEMA +Grant column-level permissions to a role: - <schema_name> [, ...] } - FROM <role> [, ...] - - -- Removes access to permissions in role1 by role 2 - REVOKE <role1> [, ...] FROM <role2> [, ...] WITH ADMIN OPTION +.. code-block:: postgres - -- Removes permissions to grant role1 to additional roles from role2 - REVOKE <role1> [, ...] FROM <role2> [, ...] WITH ADMIN OPTION + GRANT SELECT, DDL ON COLUMN column_name TO role_name; +Grant usage permissions on a service to a role: -Examples: +.. code-block:: postgres + + GRANT USAGE ON SERVICE service_name TO role_name; + +Grant role2 the ability to use permissions granted to role1: .. code-block:: postgres - REVOKE superuser on schema demo from userA; + GRANT role1 TO role2; - REVOKE delete on admin.table1 from userB; +Grant role2 the ability to grant role1 to other roles: - REVOKE login from role_test; +.. code-block:: postgres - REVOKE CREATE FUNCTION FROM admin; + GRANT role1 TO role2 WITH ADMIN OPTION; -Default permissions -------------------- -The default permissions system (See :ref:`alter_default_permissions`) -can be used to automatically grant permissions to newly -created objects (See the departmental example below for one way it can be used). +REVOKE Examples +--------------- -A default permissions rule looks for a schema being created, or a -table (possibly by schema), and is table to grant any permission to -that object to any role. This happens when the create table or create -schema statement is run. +Revoke superuser privileges or login capability from a role: + +.. code-block:: postgres + REVOKE SUPERUSER, LOGIN FROM role_name; + +Revoke specific permissions on a database from a role: .. code-block:: postgres + REVOKE CREATE, CONNECT, DDL, SUPERUSER, CREATE FUNCTION FROM role_name; + +Revoke permissions on a schema from a role: + +.. code-block:: postgres + + REVOKE CREATE, DDL, USAGE, SUPERUSER FROM role_name; + +Revoke permissions on specific objects (table, view, foreign table, or catalog) from a role: + +.. code-block:: postgres + + REVOKE SELECT, INSERT, DELETE, DDL, UPDATE FROM TABLE table_name; + +Revoke column-level permissions from a role: + +.. code-block:: postgres + + REVOKE SELECT, DDL FROM COLUMN column_name; + +Revoke usage permissions on a service from a role: + +.. code-block:: postgres + + REVOKE USAGE FROM SERVICE service_name; + +Remove access to permissions in role1 by role2: + +.. code-block:: postgres + + REVOKE role1 FROM role2 WITH ADMIN OPTION; + +Remove permissions to grant role1 to additional roles from role2: + +.. code-block:: postgres + + REVOKE role1 FROM role2 WITH ADMIN OPTION; - ALTER DEFAULT PERMISSIONS FOR target_role_name - [IN schema_name, ...] - FOR { TABLES | SCHEMAS } - { grant_clause | DROP grant_clause} - TO ROLE { role_name | public }; - grant_clause ::= - GRANT - { CREATE FUNCTION - | SUPERUSER - | CONNECT - | CREATE - | USAGE - | SELECT - | INSERT - | DELETE - | DDL - | UPDATE - | EXECUTE - | ALL - } \ No newline at end of file From b5836d4e638d4d15e4fb09c1dcdf2b90606431b4 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 30 May 2023 12:00:33 +0300 Subject: [PATCH 571/882] Update 4.3.rst --- releases/4.3.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/releases/4.3.rst b/releases/4.3.rst index c4e2b7e32..ef0cc6adf 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -33,6 +33,19 @@ Compatibility Matrix | | * Spark | +-------------------------+------------------------------------------------------------------------+ +New Features and Enhancements +----------------------------- + +Access control permissions in SQreamDB have been expanded, allowing roles to now grant and revoke access to other roles for the following: + +* VIEWS +* FOREIGN TABLE +* COLUMN +* CATALOG +* SERVICE + +To learn more about how and when you should use the new permissions, visit :ref:`access_control_permissions`. + Known Issues ------------ From 4f9b138ab9d61d953097081390caa81c2de29fbd Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 30 May 2023 12:02:35 +0300 Subject: [PATCH 572/882] Update 4.3.rst --- releases/4.3.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index ef0cc6adf..6b0fcd857 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -38,11 +38,11 @@ New Features and Enhancements Access control permissions in SQreamDB have been expanded, allowing roles to now grant and revoke access to other roles for the following: -* VIEWS -* FOREIGN TABLE -* COLUMN -* CATALOG -* SERVICE + * VIEWS + * FOREIGN TABLE + * COLUMN + * CATALOG + * SERVICE To learn more about how and when you should use the new permissions, visit :ref:`access_control_permissions`. From f8e26e3cd11e261f7ce063d9364050794d8d6ed9 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 30 May 2023 17:13:43 +0300 Subject: [PATCH 573/882] Update index.rst --- .../client_drivers/python/index.rst | 97 ++++++++++--------- 1 file changed, 53 insertions(+), 44 deletions(-) diff --git a/connecting_to_sqream/client_drivers/python/index.rst b/connecting_to_sqream/client_drivers/python/index.rst index bd71820d8..12b4a7b3b 100644 --- a/connecting_to_sqream/client_drivers/python/index.rst +++ b/connecting_to_sqream/client_drivers/python/index.rst @@ -119,53 +119,56 @@ The Python drivers are updated periodically. To upgrade an existing pysqream ins -SQLAlchemy Examples -======================== -SQLAlchemy is an **Object-Relational Mapper (ORM) for Python. When you install the SQream dialect (``pysqream-sqlalchemy``) you can use frameworks such as Pandas, TensorFlow, and Alembic to query SQream directly. - -This section includes the following examples: +SQLAlchemy +========== +SQLAlchemy is an Object-Relational Mapper (ORM) for Python. When you install the SQream dialect (``pysqream-sqlalchemy``) you can use frameworks such as Pandas, TensorFlow, and Alembic to query SQream directly. .. contents:: :local: :depth: 1 -Standard Connection Example ---------------------------------- - - -.. code-block:: python - - import sqlalchemy as sa - - engine_url = "sqream://rhendricks:secret_password@localhost:5000/raviga" - - engine = sa.create_engine(engine_url) +Creating a Standard Connection +------------------------------ - res = engine.execute('create or replace table test (ints int, ints2 int)') - res = engine.execute('insert into test (ints,ints2) values (5,1), (6,2)') - res = engine.execute('select * from test') - for item in res: - print(item) - -Multi Cluster Connection Example ------------------------- +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``username`` + - Username of a role to use for connection + * - ``password`` + - Specifies the password of the selected role + * - ``host`` + - Specifies the host name + * - ``port`` + - Specifies the port number + * - ``port_ssl`` + - An optional parameter + * - ``database`` + - Specifies the database name + * - ``clustered`` + - Establishing a multi-clustered connection. Input values: ``True``, ``False``. Default is ``False`` + * - ``service`` + - Specifies service queue to use -The following example is for using a ServerPicker: .. code-block:: python import sqlalchemy as sa - - engine_url = "sqream://rhendricks:secret_password@localhost:5000/raviga" - - engine = sa.create_engine(engine_url, connect_args={"clustered": True}) - res = engine.execute("create or replace table tab1 (x int);") - res = engine.execute('insert into tab1 values (5), (6);') - res = engine.execute('select * from tab1') - for item in res: - print(item) + from sqlalchemy.engine.url import URL + engine_url = URL('sqream' + , username='<user_name>' + , password='<password>' + , host='<host_name>' + , port=<port_number> + , port_ssl=<port_ssl> + , database='<database_name>') + engine = sa.create_engine(engine_url,connect_args={"clustered": False, "service": "<service_name>"}) + Pulling a Table into Pandas --------------------------- @@ -174,25 +177,31 @@ The following example shows how to pull a table in Pandas. This examples uses th .. code-block:: python import sqlalchemy as sa + + from sqlalchemy.engine.url import URL + import pandas as pd - engine_url = "sqream://rhendricks:secret_password@localhost:5000/raviga" - engine = sa.create_engine(engine_url) + engine_url = URL('sqream' + , username='sqream' + , password='12345' + , host='127.0.0.1' + , port=3108 + , database='master') + engine = sa.create_engine(engine_url,connect_args={"clustered": True, "service": "admin"}) table_df = pd.read_sql("select * from nba", con=engine) -API Examples -=============== -This section includes the following examples: +API +=== .. contents:: :local: :depth: 1 - Using the Cursor --------------------------------------------- +---------------- The DB-API specification includes several methods for fetching results from the cursor. This sections shows an example using the ``nba`` table, which looks as follows: .. csv-table:: nba @@ -261,7 +270,7 @@ The following is an example of the contents of the row variables used in our exa .. note:: Calling a fetch command after all rows have been fetched will return an empty array (``[]``). Reading Result Metadata ----------------------------- +----------------------- When you execute a statement, the connection object also contains metadata about the result set, such as **column names**, **types**, etc). The metadata is stored in the :py:attr:`Connection.description` object of the cursor: @@ -287,7 +296,7 @@ You can fetch a list of column names by iterating over the ``description`` list: ['Name', 'Team', 'Number', 'Position', 'Age (as of 2018)', 'Height', 'Weight', 'College', 'Salary'] Loading Data into a Table ---------------------------- +------------------------- This example shows how to load 10,000 rows of dummy data to an instance of SQream. **To load data 10,000 rows of dummy data to an instance of SQream:** @@ -363,7 +372,7 @@ This example shows how to load 10,000 rows of dummy data to an instance of SQrea Using SQLAlchemy ORM to Create and Populate Tables ------------------------------------------------------------------------ +-------------------------------------------------- This section shows how to use the ORM to create and populate tables from Python objects. **To use SQLAlchemy ORM to create and populate tables:** From 75b1962e48eee056b984d9d195d3dc5360b6fd17 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Wed, 31 May 2023 16:02:47 +0300 Subject: [PATCH 574/882] 4.3 release date --- releases/4.3.rst | 2 +- releases/index.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index 6b0fcd857..d8546efcb 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -6,7 +6,7 @@ Release Notes 4.3 SQream is introducing a new version release system that follows the more commonly used Major.Minor.Patch versioning schema. The newly released **4.0 version** is a minor version upgrade and does not require considerable preparation. -The 4.3 release notes were released on xx/xx/xxxx and describe the following: +The 4.3 release notes were released on 31/05/2023 and describe the following: .. contents:: :local: diff --git a/releases/index.rst b/releases/index.rst index abb8ab7a9..b02e21ff9 100644 --- a/releases/index.rst +++ b/releases/index.rst @@ -13,7 +13,7 @@ Release Notes * - Version - Release Date * - :ref:`4.3` - - xxxxxxxxx + - May 31, 2023 * - :ref:`4.2` - April 23, 2023 * - :ref:`4.1` From 69b5026395b3f49bb59997f69234ed808bac277f Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Wed, 31 May 2023 16:29:03 +0300 Subject: [PATCH 575/882] Update 4.3.rst --- releases/4.3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index d8546efcb..99a6fbb85 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -127,7 +127,7 @@ The ``VARCHAR`` data type is deprecated to improve the core functionalities of t End of Support -------------- -Support in an :ref:`old method <previous_configuration_method>` of configuring the SQreamDB instance ends on September xxx, 2023. +Support in an :ref:`old method <previous_configuration_method>` of configuring the SQreamDB instance ends on September 30th, 2023. Upgrading to v4.3 From c2bf828ce7f33fbe95a4d544351975c0196d478f Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 1 Jun 2023 09:13:28 +0300 Subject: [PATCH 576/882] Update 4.3.rst --- releases/4.3.rst | 21 +++++---------------- 1 file changed, 5 insertions(+), 16 deletions(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index 99a6fbb85..0eaccf68e 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -4,9 +4,7 @@ Release Notes 4.3 ***************** -SQream is introducing a new version release system that follows the more commonly used Major.Minor.Patch versioning schema. The newly released **4.0 version** is a minor version upgrade and does not require considerable preparation. - -The 4.3 release notes were released on 31/05/2023 and describe the following: +The 4.3 release notes were released on xx/06/2023 and describe the following: .. contents:: :local: @@ -44,7 +42,7 @@ Access control permissions in SQreamDB have been expanded, allowing roles to now * CATALOG * SERVICE -To learn more about how and when you should use the new permissions, visit :ref:`access_control_permissions`. +To learn more about how and when you should use this new capability, visit :ref:`access_control_permissions`. Known Issues ------------ @@ -110,10 +108,7 @@ Due to Parquet's lack of support of the ``INT96`` data type, SQream has decided ► Square Brackets ``[]`` -The ``[]``, which are frequently used to delimit :ref:`identifiers<keywords_and_identifiers>` such as column names, table names, and other database objects, will soon be deprecated to facilitate the use of the ``ARRAY`` data type. - -* Support in ``[]`` for delimiting database object identifiers ends on June 1st, 2023. -* To delimit database object identifiers, you will be able to use double quotes ``""``. +The ``[]``, which are frequently used to delimit :ref:`identifiers<keywords_and_identifiers>` such as column names, table names, and other database objects, are officially deprecated to facilitate the use of the ``ARRAY`` data type. To delimit database object identifiers, use double quotes ``""``. ► ``VARCHAR`` @@ -121,17 +116,11 @@ The ``[]``, which are frequently used to delimit :ref:`identifiers<keywords_and_ The ``VARCHAR`` data type is deprecated to improve the core functionalities of the platform and to align with the constantly evolving ecosystem requirements. * Support in the ``VARCHAR`` data type ends at September 30th, 2023. -* ``VARCHAR`` is no longer supported for new customers, effective from Version 2022.1.3. +* ``VARCHAR`` is no longer supported for new customers, effective from version 2022.1.3. * The ``TEXT`` data type is replacing the ``VARCHAR`` and ``NVARCHAR`` data types. -End of Support --------------- - -Support in an :ref:`old method <previous_configuration_method>` of configuring the SQreamDB instance ends on September 30th, 2023. - - Upgrading to v4.3 -------------------- +----------------- 1. Generate a back-up of the metadata by running the following command: .. code-block:: console From 3802ea9ac54e52b81d6b4cb950aeaee7db17ef03 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 1 Jun 2023 09:58:31 +0300 Subject: [PATCH 577/882] Remove "Previous configuration method" --- configuration_guides/configuration_flags.rst | 3 - .../configuration_methods.rst | 19 -- .../current_method_configuration_levels.rst | 1 - .../current_method_modification_methods.rst | 7 +- .../previous_configuration_method.rst | 268 ------------------ configuration_guides/spool_memory_gb.rst | 1 - configuration_guides/spooling.rst | 44 +-- .../shutdown_server_command.rst | 7 +- 8 files changed, 15 insertions(+), 335 deletions(-) delete mode 100644 configuration_guides/configuration_methods.rst delete mode 100644 configuration_guides/previous_configuration_method.rst diff --git a/configuration_guides/configuration_flags.rst b/configuration_guides/configuration_flags.rst index 3a25dc9bd..a61267a6f 100644 --- a/configuration_guides/configuration_flags.rst +++ b/configuration_guides/configuration_flags.rst @@ -3,9 +3,6 @@ ************************* Configuration Flags ************************* -SQream provides two methods for configuration your instance of SQream. The current configuration method is based on cluster and session-based configuration, described in more detail below. Users can also use the previous configuration method done using a configuration file. - -The **Configuration Methods** page describes the following configurations methods: .. toctree:: :maxdepth: 1 diff --git a/configuration_guides/configuration_methods.rst b/configuration_guides/configuration_methods.rst deleted file mode 100644 index 00a70ab5c..000000000 --- a/configuration_guides/configuration_methods.rst +++ /dev/null @@ -1,19 +0,0 @@ -.. _configuration_methods: - -************************* -Configuration Methods -************************* -SQream provides two methods for configuration your instance of SQream. The current configuration method is based on cluster and session-based configuration, described in more detail below. Users can also use the previous configuration method done using a configuration file. - -The **Configuration Methods** page describes the following configurations methods: - -.. toctree:: - :maxdepth: 1 - :glob: - :titlesonly: - - current_configuration_method - previous_configuration_method - - - diff --git a/configuration_guides/current_method_configuration_levels.rst b/configuration_guides/current_method_configuration_levels.rst index ad5143def..c7443ede2 100644 --- a/configuration_guides/current_method_configuration_levels.rst +++ b/configuration_guides/current_method_configuration_levels.rst @@ -19,7 +19,6 @@ Worker-Based Configuration -------------- Worker-based configuration lets you modify individual workers using a worker configuration file. Worker-based configuration modifications are persistent. -For more information on making configurations from the worker configuration file, see :ref:`previous_configuration_method`. Session-Based Configuration -------------- diff --git a/configuration_guides/current_method_modification_methods.rst b/configuration_guides/current_method_modification_methods.rst index 05825b07a..be12a9b4c 100644 --- a/configuration_guides/current_method_modification_methods.rst +++ b/configuration_guides/current_method_modification_methods.rst @@ -3,7 +3,7 @@ ************************** Modification Methods ************************** -SQream provides two different ways to modify your configurations. The current method is based on hierarchical configuration as described above. This method is based on making modifications on the **worker configuration file**, while you can still make modifications using the previous method using the **legacy configuration file**, both described below: + .. contents:: :local: @@ -35,7 +35,7 @@ Modifying Your Configuration Using a Legacy Configuration File --------------------- You can modify your configuration using a legacy configuration file. -The Legacy configuration file provides access to the read/write flags used in SQream’s previous configuration method. A link to this file is provided in the **legacyConfigFilePath** parameter in the worker configuration file. +The Legacy configuration file provides access to the read/write flags. A link to this file is provided in the **legacyConfigFilePath** parameter in the worker configuration file. The following is an example of the legacy configuration file: @@ -46,5 +46,4 @@ The following is an example of the legacy configuration file: “reextentUse”: false, “useClientLog”: true, “useMetadataServer”” false - } -For more information on using the previous configuration method, see :ref:`previous_configuration_method`. \ No newline at end of file + } \ No newline at end of file diff --git a/configuration_guides/previous_configuration_method.rst b/configuration_guides/previous_configuration_method.rst deleted file mode 100644 index ff48e7cc1..000000000 --- a/configuration_guides/previous_configuration_method.rst +++ /dev/null @@ -1,268 +0,0 @@ -.. _previous_configuration_method: - -************************** -Configuring SQream Using the Previous Configuration Method -************************** -The **Configuring SQream Using the Previous Configuration Method** page describes SQream’s previous method for configuring your instance of SQream, and includes the following topics: - -.. contents:: - :local: - :depth: 1 - -By default, configuration files are stored in ``/etc/sqream``. - -A very minimal configuration file looks like this: - -.. code-block:: json - - { - "compileFlags": { - }, - "runtimeFlags": { - }, - "runtimeGlobalFlags": { - }, - "server": { - "gpu": 0, - "port": 5000, - "cluster": "/home/sqream/sqream_storage", - "licensePath": "/etc/sqream/license.enc" - } - } - -* Each SQream DB worker (``sqreamd``) has a dedicated configuration file. - -* The configuration file contains four distinct sections, ``compileFlags``, ``runtimeFlags``, ``runtimeGlobalFlags``, and ``server``. - -In the example above, the worker will start on port 5000, and will use GPU #0. - -Frequently Set Parameters ------- -.. todo - list-table:: Compiler flags - :widths: auto - :header-rows: 1 - - * - Name - - Section - - Description - - Default - - Value range - - Example - * - - - - - - - - - - - - -.. list-table:: Server flags - :widths: auto - :header-rows: 1 - - * - Name - - Section - - Description - - Default - - Value range - - Example - * - ``gpu`` - - ``server`` - - Controls the GPU ordinal to use - - ✗ - - 0 to (number of GPUs in the machine -1). Check with ``nvidia-smi -L`` - - ``"gpu": 0`` - * - ``port`` - - ``server`` - - Controls the TCP port to listen on - - ✗ - - 1024 to 65535 - - ``"port" : 5000`` - * - ``ssl_port`` - - ``server`` - - Controls the SSL TCP port to listen on. Must be different from ``port`` - - ✗ - - 1024 to 65535 - - ``"ssl_port" : 5100`` - * - ``cluster`` - - ``server`` - - Specifies the cluster path root - - ✗ - - Valid local system path - - ``"cluster" : "/home/sqream/sqream_storage"`` - * - ``license_path`` - - ``server`` - - Specifies the license file for this worker - - ✗ - - Valid local system path to license file - - ``"license_path" : "/etc/sqream/license.enc"`` - -.. list-table:: Runtime global flags - :widths: auto - :header-rows: 1 - - * - Name - - Section - - Description - - Default - - Value range - - Example - * - ``spoolMemoryGb`` - - ``runtimeGlobalFlags`` - - Modifies RAM allocated for the worker for intermediate results. Statements that use more memory than this setting will spool to disk, which could degrade performance. We recommend not to exceed the amount of RAM in the machine. This setting must be set lower than the ``limitQueryMemoryGB`` setting. - - ``128`` - - 1 to maximum available RAM in gigabytes. - - ``"spoolMemoryGb": 250`` - * - ``limitQueryMemoryGB`` - - ``runtimeGlobalFlags`` - - Modifies the maximum amount of RAM allocated for a query. The recommended value for this is ``total host memory`` / ``sqreamd workers on host``. For example, for a machine with 512GB of RAM and 4 workers, the recommended setting is ``512/4 → 128``. - - ``10000`` - - ``1`` to ``10000`` - - ``"limitQueryMemoryGB" : 128`` - * - ``cudaMemQuota`` - - ``runtimeGlobalFlags`` - - Modifies the maximum amount of GPU RAM allocated for a worker. The recommended value is 99% for a GPU with a single worker, or 49% for a GPU with two workers. - - ``90`` % - - ``1`` to ``99`` - - ``"cudaMemQuota" : 99`` - * - ``showFullExceptionInfo`` - - ``runtimeGlobalFlags`` - - Shows complete error message with debug information. Use this for debugging. - - ``false`` - - ``true`` or ``false`` - - ``"showFullExceptionInfo" : true`` - * - ``initialSubscribedServices`` - - ``runtimeGlobalFlags`` - - Comma separated list of :ref:`service queues<workload_manager>` that the worker is subscribed to - - ``"sqream"`` - - Comma separated list of service names, with no spaces. Services that don't exist will be created. - - ``"initialSubscribedServices": "sqream,etl,management"`` - * - ``logClientLevel`` - - ``runtimeGlobalFlags`` - - Used to control which log level should appear in the logs - - ``4`` (``INFO``) - - ``0`` SYSTEM (lowest) - ``4`` INFO (highest). See :ref:`information level table<information_level>` for explanation about these log levels. - - ``"logClientLevel" : 3`` - * - ``nodeInfoLoggingSec`` - - ``runtimeGlobalFlags`` - - Sets an interval for automatically logging long-running statements' :ref:`show_node_info` output. Output is written as a message type ``200``. - - ``60`` (every minute) - - Positive whole number >=1. - - ``"nodeInfoLoggingSec" : 5`` - * - ``useLogMaxFileSize`` - - ``runtimeGlobalFlags`` - - Defines whether SQream logs should be cycled when they reach ``logMaxFileSizeMB`` size. When ``true``, set the ``logMaxFileSizeMB`` accordingly. - - ``false`` - - ``false`` or ``true`` - - ``"useLogMaxFileSize" : true`` - * - ``logMaxFileSizeMB`` - - ``runtimeGlobalFlags`` - - Sets the size threshold in megabytes after which a new log file will be opened. - - ``20`` - - ``1`` to ``1024`` (1MB to 1GB) - - ``"logMaxFileSizeMB" : 250`` - * - ``logFileRotateTimeFrequency`` - - ``runtimeGlobalFlags`` - - Control frequency of log rotation - - ``never`` - - ``daily``, ``weekly``, ``monthly``, ``never`` - - ``"logClientLevel" : 3`` - * - ``useMetadataServer`` - - ``runtimeGlobalFlags`` - - Specifies if this worker connects to a cluster (``true``) or is standalone (``false``). If set to ``true``, also set ``metadataServerIp`` - - ``true`` - - ``false`` or ``true`` - - ``"useMetadataServer" : true`` - * - ``metadataServerIp`` - - ``runtimeGlobalFlags`` - - Specifies the hostname or IP of the metadata server, when ``useMetadataServer`` is set to ``true``. - - ``127.0.0.1`` - - A valid IP or hostname - - ``"metadataServerIp": "127.0.0.1"`` - * - ``useConfigIP`` - - ``runtimeGlobalFlags`` - - Specifies if the metadata should use a pre-determined hostname or IP to refer to this worker. If set to ``true``, set the ``machineIp`` configuration accordingly. - - ``false`` - automatically derived by the TCP socket - - ``false`` or ``true`` - - ``"useConfigIP" : true`` - * - ``machineIP`` - - ``runtimeGlobalFlags`` - - Specifies the worker's external IP or hostname, when used from a remote network. - - No default - - A valid IP or hostname - - ``"machineIP": "10.0.1.4"`` - * - ``tempPath`` - - ``runtimeGlobalFlags`` - - Specifies an override for the temporary file path on the local machine. Set this to a local path to improve performance for spooling. - - Defaults to the central storage's built-in temporary folder - - A valid path to a folder on the local machine - - ``"tempPath": "/mnt/nvme0/temp"`` - - - -.. list-table:: Runtime flags - :widths: auto - :header-rows: 1 - - * - Name - - Section - - Description - - Default - - Value range - - Example - * - ``insertParsers`` - - ``runtimeFlags`` - - Sets the number of CSV parsing threads launched during bulk load - - 4 - - 1 to 32 - - ``"insertParsers" : 8`` - * - ``insertCompressors`` - - ``runtimeFlags`` - - Sets the number of compressor threads launched during bulk load - - 4 - - 1 to 32 - - ``"insertCompressors" : 8`` - * - ``statementLockTimeout`` - - ``runtimeGlobalFlags`` - - Sets the delay in seconds before SQream DB will stop waiting for a lock and return an error - - 3 - - >=1 - - ``"statementLockTimeout" : 10`` - - -.. list the main configuration options and how they are used - -.. point to the best practices as well - -.. warning:: JSON files can't contain any comments. - -Recommended Configuration File ------ - -.. code-block:: json - - { - "compileFlags":{ - }, - "runtimeFlags":{ - "insertParsers": 16, - "insertCompressors": 8 - }, - "runtimeGlobalFlags":{ - "limitQueryMemoryGB" : 121, - "spoolMemoryGB" : 108, - "cudaMemQuota": 90, - "initialSubscribedServices" : "sqream", - "useMetadataServer": true, - "metadataServerIp": "127.0.0.1", - "useConfigIP": true, - "machineIP": "127.0.0.1" - }, - "server":{ - "gpu":0, - "port":5000, - "ssl_port": 5100, - "cluster":"/home/sqream/sqream_storage", - "licensePath":"/etc/sqream/license.enc" - } - } \ No newline at end of file diff --git a/configuration_guides/spool_memory_gb.rst b/configuration_guides/spool_memory_gb.rst index 9aa651a74..5ed3264b1 100644 --- a/configuration_guides/spool_memory_gb.rst +++ b/configuration_guides/spool_memory_gb.rst @@ -5,7 +5,6 @@ Setting the Spool Memory ************************* The ``spoolMemoryGB`` flag sets the amount of memory (GB) available to the server for spooling. -The following describes the ``spoolMemoryGB`` flag: * **Data type** - uint * **Default value** - ``8`` \ No newline at end of file diff --git a/configuration_guides/spooling.rst b/configuration_guides/spooling.rst index 45c88d3ee..0235b757a 100644 --- a/configuration_guides/spooling.rst +++ b/configuration_guides/spooling.rst @@ -3,16 +3,8 @@ ************************** Configuring the Spooling Feature ************************** -The **Configuring the Spooling Feature** page includes the following topics: -.. contents:: - :local: - :depth: 1 - - -Overview ----------- -From the SQream Acceleration Studio you can allocate the amount of memory (GB) available to the server for spooling using the ``spoolMemoryGB`` flag. SQream recommends setting the ``spoolMemoryGB`` flag to 90% of the ``limitQueryMemoryGB`` flag. The ``limitQueryMemoryGB`` flag is the total memory you’ve allocated for processing queries. +From the SQream Acceleration Studio you can allocate the amount of memory (GB) available to the server for spooling using the :ref:`spoolMemoryGB flag<spool_memory_gb>`. SQream recommends setting the ``spoolMemoryGB`` flag to 90% of the ``limitQueryMemoryGB`` flag. The ``limitQueryMemoryGB`` flag is the total memory you’ve allocated for processing queries. In addition, the ``limitQueryMemoryGB`` defines how much total system memory is used by each worker. SQream recommends setting ``limitQueryMemoryGB`` to 5% less than the total host memory divided by the amount of ``sqreamd`` workers on host. @@ -20,24 +12,10 @@ Note that ``spoolMemoryGB`` must bet set to less than the ``limitQueryMemoryGB`` Example Configurations ---------- -The **Example Configurations** section shows the following example configurations: -.. contents:: - :local: - :depth: 1 - -Example 1 - Recommended Settings +Setting Spool Memory ~~~~~~~~~~~ -The following is an example of the recommended settings for a machine with 512GB of RAM and 4 workers: - -.. code-block:: console - - limitQueryMemoryGB - ⌊(512 * 0.95 / 4)⌋ → ~ 486 / 4 → 121 - spoolMemoryGB - ⌊( 0.9 * limitQueryMemoryGB )⌋ → ⌊( 0.9 * 121 )⌋ → 108 - -Example 2 - Setting Spool Memory -~~~~~~~~~~~ -The following is an example of setting ``spoolMemoryGB`` value in the current configuration method per-worker for 512GB of RAM and 4 workers: +The following is an example of setting ``spoolMemoryGB`` value per-worker for 512GB of RAM and 4 workers: .. code-block:: console @@ -54,16 +32,12 @@ The following is an example of setting ``spoolMemoryGB`` value in the current co “spoolMemoryGB" : 108 “legacyConfigFilePath”: “home/SQream_develop/SqrmRT/utils/json/legacy_congif.json” } - -The following is an example of setting ``spoolMemoryGB`` value in the previous configuration method per-worker for 512GB of RAM and 4 workers: + +Recommended Settings +~~~~~~~~~~~ +The following is an example of the recommended settings for a machine with 512GB of RAM and 4 workers: .. code-block:: console - “runtimeFlags”: { - “limitQueryMemoryGB” : 121, - “spoolMemoryGB” : 108 - -For more information about configuring the ``spoolMemoryGB`` flag, see the following: - -* `Current configuration method <https://docs.sqream.com/en/latest/configuration_guides/spool_memory_gb.html>`_ -* `Previous configuration method <https://docs.sqream.com/en/latest/configuration_guides/previous_configuration_method.html#id2>`_ \ No newline at end of file + limitQueryMemoryGB - ⌊(512 * 0.95 / 4)⌋ → ~ 486 / 4 → 121 + spoolMemoryGB - ⌊( 0.9 * limitQueryMemoryGB )⌋ → ⌊( 0.9 * 121 )⌋ → 108 diff --git a/reference/sql/sql_statements/utility_commands/shutdown_server_command.rst b/reference/sql/sql_statements/utility_commands/shutdown_server_command.rst index bc42fcd5d..669e0dbd2 100644 --- a/reference/sql/sql_statements/utility_commands/shutdown_server_command.rst +++ b/reference/sql/sql_statements/utility_commands/shutdown_server_command.rst @@ -3,15 +3,14 @@ ******************** SHUTDOWN SERVER ******************** -The **SHUTDOWN_SERVER** guide describes the following: + + +SQream's method for stopping the SQream server is running the ``shutdown_server()`` utility command. Because this command abruptly shuts down the server while executing operations, it has been modified to perform a graceful shutdown by setting it to ``select shutdown_server([is_graceful, [timeout]]);``. This causes the server to wait for any queued statements to complete before shutting down. .. contents:: :local: :depth: 1 -Overview -=============== -SQream's current method for stopping the SQream server is running the ``shutdown_server()`` utility command. Because this command abruptly shuts down the server while executing operations, it has been modified to perform a graceful shutdown by setting it to ``select shutdown_server([is_graceful, [timeout]]);``. This causes the server to wait for any queued statements to complete before shutting down. How Does it Work? ======================== From 8ae2d0b013ff534e64da57558c5ee2301613eb16 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 1 Jun 2023 10:15:22 +0300 Subject: [PATCH 578/882] Update configuration_flags.rst --- configuration_guides/configuration_flags.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/configuration_guides/configuration_flags.rst b/configuration_guides/configuration_flags.rst index a61267a6f..d6f5265ce 100644 --- a/configuration_guides/configuration_flags.rst +++ b/configuration_guides/configuration_flags.rst @@ -4,6 +4,8 @@ Configuration Flags ************************* + + .. toctree:: :maxdepth: 1 :glob: From 9a0ef0b92ca8dba8fa96292a17a490a1c0bf93fb Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 1 Jun 2023 10:22:05 +0300 Subject: [PATCH 579/882] driver's page --- connecting_to_sqream/client_drivers/index.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index f8a61d90b..8c404ab06 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -74,10 +74,10 @@ The following are applicable to all operating systems: Windows --------------- +------- The following are applicable to Windows: -* **ODBC installer** - SQream Drivers v2020.2.0. Please contact your `Sqream representative <https://sqream.atlassian.net/servicedesk/customer/portal/2>`_ for this installer. +* For the **ODBC installer**, please contact your `Sqream representative <https://sqream.atlassian.net/servicedesk/customer/portal/2>`_. For more information on installing and configuring ODBC on Windows, see :ref:`Install and configure ODBC on Windows <install_odbc_windows>`. @@ -107,4 +107,4 @@ If you couldn't find what you're looking for, contact `SQream Support <https://s .. rubric:: Looking for older drivers? -If you're looking for an older version of SQream DB drivers, versions 1.10 through 2019.2.1 are available at https://sqream.com/product/client-drivers/. \ No newline at end of file +If you're looking for an older version of SQreamDB drivers, visit `here <https://sqream.com/product/client-drivers/>`_. \ No newline at end of file From cccda261203ce356de2b013769c0cf7e7b16ddbc Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 1 Jun 2023 10:39:17 +0300 Subject: [PATCH 580/882] Update scalar_sql_udf.rst --- .../user_defined_functions/scalar_sql_udf.rst | 37 +++++++++---------- 1 file changed, 18 insertions(+), 19 deletions(-) diff --git a/reference/sql/sql_functions/user_defined_functions/scalar_sql_udf.rst b/reference/sql/sql_functions/user_defined_functions/scalar_sql_udf.rst index de399c3ff..67b23248c 100644 --- a/reference/sql/sql_functions/user_defined_functions/scalar_sql_udf.rst +++ b/reference/sql/sql_functions/user_defined_functions/scalar_sql_udf.rst @@ -1,13 +1,12 @@ .. _scalar_sql_udf: Scalar SQL UDF ------------------------ -A **scalar SQL UDF** is a user-defined function that returns a single value, such as the sum of a group of values. Scalar UDFs are different than table-value functions, which return a result set in the form of a table. +============== -This page describes the correct syntax when building simple scalar UDFs and provides three examples. +A **scalar SQL UDF** is a user-defined function that returns a single value, such as the sum of a group of values. Scalar UDFs are different than table-value functions, which return a result set in the form of a table. Syntax -~~~~~~~~~~~~ +------ The following example shows the correct syntax for simple scalar SQL UDF's returning the type name: @@ -28,9 +27,11 @@ The following example shows the correct syntax for simple scalar SQL UDF's retur $ function_body ::= A valid SQL statement Examples -~~~~~~~~~~ -Example 1 – Support for Different Syntax -############ +-------- + +Support for Different Syntax +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + Scalar SQL UDF supports standard functionality even when different syntax is used. In the example below, the syntax ``dateadd`` is used instead of ``add_months``, although the function of each is identical. In addition, the operation works correctly even though the order of the expressions in ``add_months`` (``dt``, ``datetime``, and ``n int``) is different than ``MONTH``, ``n``, and ``dt`` in ``dateadd``. @@ -43,8 +44,9 @@ In the example below, the syntax ``dateadd`` is used instead of ``add_months``, $ SELECT dateadd(MONTH ,n,dt) $ $$ LANGUAGE SQL; -Example 2 – Manipulating Strings -############ +Manipulating Strings +~~~~~~~~~~~~~~~~~~~~ + The Scalar SQL UDF can be used to manipulate strings. The following example shows the correct syntax for converting a TEXT date to the DATE type: @@ -57,8 +59,9 @@ The following example shows the correct syntax for converting a TEXT date to the $ select (substring(f,1,4)||'-'||substring(f,5,2)||'-'||substring(f,7,2))::date $ $$ LANGUAGE SQL; -Example 3 – Manually Building Functionality -############ +Manually Building Functionality +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + You can use the Scalar SQL UDF to manually build functionality for otherwise unsupported operations. .. code-block:: console @@ -76,16 +79,13 @@ You can use the Scalar SQL UDF to manually build functionality for otherwise uns $ language sql; Usage Notes -~~~~~~~~~~~~~~ -The following usage notes apply when using simple scalar SQL UDF's: +~~~~~~~~~~~ * During this stage, the SQL embedded in the function body must be of the type ``SELECT expr;``. Creating a UDF with invalid SQL, or with valid SQL of any other type, results in an error. * As with Python UDFs, the argument list can be left empty. -* SQL UDFs can reference other UDF's, including Python UDF's. +* A function cannot (directly or indirectly) reference itself (such as by referencing another function that references it). -**NOTICE:** A function cannot (directly or indirectly) reference itself (such as by referencing another function that references it). - -Because SQL UDF's are one type of supported UDFs, the following Python UDF characteristics apply: +Since SQL UDF's are one type of supported UDFs, the following Python UDF characteristics apply: * UDF permission rules - see `Access Control <https://docs.sqream.com/en/latest/guides/features/access_control.html#access-control>`_. @@ -94,8 +94,7 @@ Because SQL UDF's are one type of supported UDFs, the following Python UDF chara * SQL UDF's should appear in the catalog with Python UDF's - see `Finding Existing UDFs in the Catalog <https://docs.sqream.com/en/latest/guides/features/python_functions.html#finding-existing-udfs-in-the-catalog>`_. Restrictions -~~~~~~~~~~~~~~~~ -The following restrictions apply to simple scalar SQL UDFs: +~~~~~~~~~~~~ * Simple scalar SQL UDF's cannot currently reference other UDFs. * Like Python UDF's, Sqream does not support overloading. From 2ec668056fb5898b01296b57b3de742df5eb6c12 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 1 Jun 2023 10:54:50 +0300 Subject: [PATCH 581/882] Update optimization_best_practices.rst --- operational_guides/optimization_best_practices.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/operational_guides/optimization_best_practices.rst b/operational_guides/optimization_best_practices.rst index 51982f527..2860b193b 100644 --- a/operational_guides/optimization_best_practices.rst +++ b/operational_guides/optimization_best_practices.rst @@ -195,7 +195,7 @@ Use saved queries to reduce recurring compilation time :ref:`saved_queries` are compiled when they are created. The query plan is saved in SQream DB's metadata for later re-use. -Because the query plan is saved, they can be used to reduce compilation overhead, especially with very complex queries, such as queries with lots of values in an :ref:`IN` predicate. +Saved query plans enable reduced compilation overhead, especially with very complex queries, such as queries with lots of values in an :ref:`IN` predicate. When executed, the saved query plan is recalled and executed on the up-to-date data stored on disk. From 39a612f3415fd08812c9d2a3a2dd4e4c03ec6886 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 1 Jun 2023 10:58:57 +0300 Subject: [PATCH 582/882] Update monitoring_query_performance.rst --- operational_guides/monitoring_query_performance.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/operational_guides/monitoring_query_performance.rst b/operational_guides/monitoring_query_performance.rst index 057512968..e727d18d0 100644 --- a/operational_guides/monitoring_query_performance.rst +++ b/operational_guides/monitoring_query_performance.rst @@ -4,7 +4,7 @@ Monitoring Query Performance ********************************* When analyzing options for query tuning, the first step is to analyze the query plan and execution. -The query plan and execution details explains how SQream DB processes a query and where time is spent. +The query plan and execution details explain how SQream DB processes a query and where time is spent. This document details how to analyze query performance with execution plans. This guide focuses specifically on identifying bottlenecks and possible optimization techniques to improve query performance. Performance tuning options for each query are different. You should adapt the recommendations and tips for your own workloads. From 0cd036e069baffb2682fce2085176d8dfd2025bd Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 1 Jun 2023 11:05:07 +0300 Subject: [PATCH 583/882] Update monitoring_query_performance.rst --- operational_guides/monitoring_query_performance.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/operational_guides/monitoring_query_performance.rst b/operational_guides/monitoring_query_performance.rst index e727d18d0..cca8eb4ea 100644 --- a/operational_guides/monitoring_query_performance.rst +++ b/operational_guides/monitoring_query_performance.rst @@ -135,7 +135,9 @@ Each row represents a single logical database operation, which is also called a several metrics during query execution, such as how much data it has read and written, how many chunks and rows, and how much time has elapsed. Consider the example show_node_info presented above. The source node with ID #11 (``ReadTable``), has a parent node ID #10 (``CpuDecompress``). If we were to draw this out in a graph, it'd look like this: + .. figure:: /_static/images/show_node_info_graph.png + :height: 70em :align: center From ff54924884ce086844dd198d60d32a4fa3d5a05e Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 1 Jun 2023 11:55:42 +0300 Subject: [PATCH 584/882] CHR function --- reference/sql/sql_functions/index.rst | 2 + .../scalar_functions/conversion/chr.rst | 50 +++++++++++++++++++ .../sql_functions/scalar_functions/index.rst | 3 +- 3 files changed, 54 insertions(+), 1 deletion(-) create mode 100644 reference/sql/sql_functions/scalar_functions/conversion/chr.rst diff --git a/reference/sql/sql_functions/index.rst b/reference/sql/sql_functions/index.rst index add12c95d..bcac9819b 100644 --- a/reference/sql/sql_functions/index.rst +++ b/reference/sql/sql_functions/index.rst @@ -81,6 +81,8 @@ The following table shows the **conversion** functions: - Converts a number to a hexadecimal string representation * - :ref:`to_unixts` - Converts a ``DATE`` or ``DATETIME`` to a UNIX Timestamp + * - :ref:`chr` + - Returns the ASCII character representation of the supplied integer Date and Time ^^^^^^^^^^^^^^^^ diff --git a/reference/sql/sql_functions/scalar_functions/conversion/chr.rst b/reference/sql/sql_functions/scalar_functions/conversion/chr.rst new file mode 100644 index 000000000..aa52694e1 --- /dev/null +++ b/reference/sql/sql_functions/scalar_functions/conversion/chr.rst @@ -0,0 +1,50 @@ +.. _chr: + +*** +CHR +*** + +The ``CHR`` function takes an integer parameter representing the ASCII code and returns the corresponding character. + +Syntax +====== + +.. code-block:: postgres + + CHR(n) + +Returns +======= + +Returns the ASCII character representation of the supplied integer. + + +Example +======= + +Create the following table: + +.. code-block:: postgres + + CREATE OR REPLACE TABLE t(x INT NOT NULL); + + INSERT INTO t (x) + VALUES (72), (101), (108), (108), (111); + +Execute the ``CHR`` function: + +.. code-block:: postgres + + SELECT CHR(x) FROM t; + +Output: + +.. code-block:: postgres + + CHR | + ------+ + H | + e | + l | + l | + o | \ No newline at end of file diff --git a/reference/sql/sql_functions/scalar_functions/index.rst b/reference/sql/sql_functions/scalar_functions/index.rst index cb749a8b6..94c1db412 100644 --- a/reference/sql/sql_functions/scalar_functions/index.rst +++ b/reference/sql/sql_functions/scalar_functions/index.rst @@ -85,4 +85,5 @@ The **Built-In Scalar Functions** page describes functions that return one value * :ref:`trim` * :ref:`upper` * :ref:`select_ascii` - * :ref:`sign` \ No newline at end of file + * :ref:`sign` + * :ref:`chr` \ No newline at end of file From f7ec880a7b103e7b18db645ecd8153e9fe0efcc1 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 1 Jun 2023 12:24:57 +0300 Subject: [PATCH 585/882] error_verbosity --- data_ingestion/csv.rst | 1 - .../sql_statements/dml_commands/copy_from.rst | 56 +++++++++---------- 2 files changed, 26 insertions(+), 31 deletions(-) diff --git a/data_ingestion/csv.rst b/data_ingestion/csv.rst index afe819fb5..2ee17bc81 100644 --- a/data_ingestion/csv.rst +++ b/data_ingestion/csv.rst @@ -217,7 +217,6 @@ See :ref:`capturing_rejected_rows` for more information about the error handling COPY table_name FROM 'filename.psv' WITH DELIMITER '|' ERROR_LOG '/temp/load_error.log' -- Save error log - ERROR_VERBOSITY 0; -- Only save rejected rows Stopping the load if a certain amount of rows were rejected diff --git a/reference/sql/sql_statements/dml_commands/copy_from.rst b/reference/sql/sql_statements/dml_commands/copy_from.rst index 05d5083aa..bab998e15 100644 --- a/reference/sql/sql_statements/dml_commands/copy_from.rst +++ b/reference/sql/sql_statements/dml_commands/copy_from.rst @@ -87,7 +87,7 @@ Syntax .. _copy_from_config_options: Elements -============ +======== .. list-table:: :widths: auto @@ -254,15 +254,15 @@ Supported Date Formats .. _field_delimiters: Supported Field Delimiters -===================================================== +========================== Field delimiters can be one or more characters. Customizing Quotations Using Alternative Characters ---------------------------- -Syntax Example 1 - Customizing Quotations Using Alternative Characters -************ +Customizing Quotations Using Alternative Characters +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The following is the correct syntax for customizing quotations using alternative characters: @@ -271,8 +271,8 @@ The following is the correct syntax for customizing quotations using alternative copy t from wrapper csv_fdw options (location = '/tmp/source_file.csv', quote='@'); copy t to wrapper csv_fdw options (location = '/tmp/destination_file.csv', quote='@'); -Usage Example 1 - Customizing Quotations Using Alternative Characters -************ +Customizing Quotations Using Alternative Characters +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The following is an example of line taken from a CSV when customizing quotations using a character: @@ -281,8 +281,8 @@ The following is an example of line taken from a CSV when customizing quotations Pepsi-"Cola",@Coca-"Cola"@,Sprite,Fanta -Syntax Example 2 - Customizing Quotations Using ASCII Character Codes -************ +Customizing Quotations Using ASCII Character Codes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The following is the correct syntax for customizing quotations using ASCII character codes: @@ -291,8 +291,8 @@ The following is the correct syntax for customizing quotations using ASCII chara copy t from wrapper csv_fdw options (location = '/tmp/source_file.csv', quote=E'\064'); copy t to wrapper csv_fdw options (location = '/tmp/destination_file.csv', quote=E'\064'); -Usage Example 2 - Customizing Quotations Using ASCII Character Codes -************ +Customizing Quotations Using ASCII Character Codes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The following is an example of line taken from a CSV when customizing quotations using an ASCII character code: @@ -303,14 +303,14 @@ The following is an example of line taken from a CSV when customizing quotations Multi-Character Delimiters ----------------------------------- +-------------------------- SQream DB supports multi-character field delimiters, sometimes found in non-standard files. A multi-character delimiter can be specified. For example, ``DELIMITER '%%'``, ``DELIMITER '{~}'``, etc. Printable Characters ------------------------ +-------------------- Any printable ASCII character (or characters) can be used as a delimiter without special syntax. The default CSV field delimiter is a comma (``,``). @@ -319,7 +319,7 @@ A printable character is any ASCII character in the range 32 - 126. :ref:`Literal quoting rules<string_literals>` apply with delimiters. For example, to use ``'`` as a field delimiter, use ``DELIMITER ''''`` Non-Printable Characters ----------------------------- +------------------------ A non-printable character (1 - 31, 127) can be used in its octal form. @@ -370,22 +370,18 @@ The following ASCII field delimiters (octal range 001 - 176) are not supported: Capturing Rejected Rows -========================== +======================= Prior to the column process and storage, the ``COPY`` command parses the data. -Whenever the data can’t be parsed because it is improperly formatted or doesn’t match the data structure, the entire record (or row) will be rejected. - -.. image:: /_static/images/copy_from_rejected_rows.png +Whenever the data can’t be parsed because it is improperly formatted or doesn’t match the data structure, the entire record (or row) will be rejected. +When ``ERROR_LOG`` is not used, the ``COPY`` command will stop and roll back the transaction upon the first error. -#. When ``ERROR_LOG`` is not used, the ``COPY`` command will stop and roll back the transaction upon the first error. - -#. When ``ERROR_LOG`` is set and ``ERROR_VERBOSITY`` is set to ``1`` (default), all errors and rejected rows are saved to the file path specified. +.. image:: /_static/images/copy_from_rejected_rows.png -#. When ``ERROR_LOG`` is set and ``ERROR_VERBOSITY`` is set to ``0``, rejected rows are saved to the file path specified, but errors are not logged. This is useful for replaying the file later. CSV Support -================ +=========== By default, SQream DB's CSV parser can handle `RFC 4180 standard CSVs <https://tools.ietf.org/html/rfc4180>`_ , but can also be modified to support non-standard CSVs (with multi-character delimiters, unquoted fields, etc). @@ -421,10 +417,10 @@ Marking Null Markers .. note:: If a text field is quoted but contains no content (``""``) it is considered an empty text field. It is not considered ``NULL``. Examples -=========== +======== Loading a Standard CSV File ------------------------------- +--------------------------- .. code-block:: postgres @@ -432,7 +428,7 @@ Loading a Standard CSV File Skipping Faulty Rows ------------------------------- +-------------------- .. code-block:: postgres @@ -463,7 +459,7 @@ Loading a Tab Separated Value (TSV) File Loading an ORC File -------------------------------------------- +------------------- .. code-block:: postgres @@ -471,7 +467,7 @@ Loading an ORC File Loading a Parquet File -------------------------------------------- +---------------------- .. code-block:: postgres @@ -479,7 +475,7 @@ Loading a Parquet File Loading a Text File with Non-Printable Delimiters ------------------------------------------------------ +------------------------------------------------- In the file below, the separator is ``DC1``, which is represented by ASCII 17 decimal or 021 octal. @@ -488,7 +484,7 @@ In the file below, the separator is ``DC1``, which is represented by ASCII 17 de COPY table_name FROM WRAPPER psv_fdw OPTIONS (location = '/tmp/file.txt', delimiter = E'\021'); Loading a Text File with Multi-Character Delimiters ------------------------------------------------------ +-------------------------------------------------- In the file below, the separator is ``^|``. @@ -504,7 +500,7 @@ In the file below, the separator is ``'|``. The quote character has to be repeat Loading Files with a Header Row ------------------------------------ +------------------------------- Use ``OFFSET`` to skip rows. From 79e8206510e36d28beba32bbf1612e0e95f16e93 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 1 Jun 2023 12:29:44 +0300 Subject: [PATCH 586/882] Update csv.rst --- data_ingestion/csv.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/data_ingestion/csv.rst b/data_ingestion/csv.rst index 2ee17bc81..77f396ebc 100644 --- a/data_ingestion/csv.rst +++ b/data_ingestion/csv.rst @@ -192,7 +192,7 @@ Loading a file from a public S3 bucket COPY nba FROM 's3://sqream-demo-data/nba.csv' WITH OFFSET 2 RECORD DELIMITER '\r\n'; Loading files from an authenticated S3 bucket ---------------------------------------------------- +--------------------------------------------- .. code-block:: postgres @@ -201,7 +201,7 @@ Loading files from an authenticated S3 bucket .. _hdfs_copy_from_example: Loading files from an HDFS storage ---------------------------------------------------- +---------------------------------- .. code-block:: postgres @@ -220,7 +220,7 @@ See :ref:`capturing_rejected_rows` for more information about the error handling Stopping the load if a certain amount of rows were rejected ------------------------------------------------------------------- +----------------------------------------------------------- .. code-block:: postgres From 8b00d8bc9036ea9080cce43dba35fe37aca59104 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 1 Jun 2023 14:18:10 +0300 Subject: [PATCH 587/882] error_verbosity --- data_ingestion/csv.rst | 26 +++++++++++-------- .../scalar_functions/string/substring.rst | 6 ++--- 2 files changed, 18 insertions(+), 14 deletions(-) diff --git a/data_ingestion/csv.rst b/data_ingestion/csv.rst index 77f396ebc..db63a38ca 100644 --- a/data_ingestion/csv.rst +++ b/data_ingestion/csv.rst @@ -46,7 +46,7 @@ Prepare the source CSVs, with the following requirements: Place CSVs where SQream DB workers can access -======================================================= +============================================= During data load, the :ref:`copy_from` command can run on any worker (unless explicitly speficied with the :ref:`workload_manager`). It is important that every node has the same view of the storage being used - meaning, every SQream DB worker should have access to the files. @@ -58,7 +58,7 @@ It is important that every node has the same view of the storage being used - me * For S3, ensure network access to the S3 endpoint. See our :ref:`s3` guide for more information. Figure out the table structure -=============================================== +============================== Prior to loading data, you will need to write out the table structure, so that it matches the file structure. @@ -97,7 +97,7 @@ We will make note of the file structure to create a matching ``CREATE TABLE`` st Bulk load the data with COPY FROM -==================================== +================================= The CSV is a standard CSV, but with two differences from SQream DB defaults: @@ -117,13 +117,13 @@ Repeat steps 3 and 4 for every CSV file you want to import. Loading different types of CSV files -======================================= +==================================== :ref:`copy_from` contains several configuration options. See more in :ref:`the COPY FROM elements section<copy_from_config_options>`. Loading a standard CSV file from a local filesystem ---------------------------------------------------------- +--------------------------------------------------- .. code-block:: postgres @@ -215,8 +215,12 @@ See :ref:`capturing_rejected_rows` for more information about the error handling .. code-block:: postgres - COPY table_name FROM 'filename.psv' WITH DELIMITER '|' - ERROR_LOG '/temp/load_error.log' -- Save error log + COPY table_name FROM WRAPPER csv_fdw OPTIONS (location = '/tmp/file.psv' + ,delimiter = '|' + ,continue_on_error = True + ,error_log = '/temp/load_error.log' -- Save error log + ,rejected_data = '/temp/load_rejected.log' -- Only save rejected rows + ); Stopping the load if a certain amount of rows were rejected @@ -225,10 +229,10 @@ Stopping the load if a certain amount of rows were rejected .. code-block:: postgres COPY table_name FROM 'filename.csv' WITH delimiter '|' - ERROR_LOG '/temp/load_err.log' -- Save error log - OFFSET 2 -- skip header row - LIMIT 100 -- Only load 100 rows - STOP AFTER 5 ERRORS; -- Stop the load if 5 errors reached + ERROR_LOG '/temp/load_err.log' -- Save error log + OFFSET 2 -- skip header row + LIMIT 100 -- Only load 100 rows + STOP AFTER 5 ERRORS; -- Stop the load if 5 errors reached Load CSV files from a set of directories ------------------------------------------ diff --git a/reference/sql/sql_functions/scalar_functions/string/substring.rst b/reference/sql/sql_functions/scalar_functions/string/substring.rst index 6e6359167..f08656a02 100644 --- a/reference/sql/sql_functions/scalar_functions/string/substring.rst +++ b/reference/sql/sql_functions/scalar_functions/string/substring.rst @@ -27,11 +27,11 @@ Arguments * - Parameter - Description * - ``expr`` - - String expression + - Original string expression from which you want to extract the substring * - ``start_pos`` - - Starting position (starts at 1) + - Starting position within the string where the extraction should start (starts at 1) * - ``length`` - - Number of characters to extract + - Number of characters to be extracted from the string Returns ============ From 553590c347d40e55cfd08f9e978ef023478a01c4 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 1 Jun 2023 14:35:13 +0300 Subject: [PATCH 588/882] Update substring.rst --- .../scalar_functions/string/substring.rst | 23 ++++++++++--------- 1 file changed, 12 insertions(+), 11 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/string/substring.rst b/reference/sql/sql_functions/scalar_functions/string/substring.rst index f08656a02..205e83d5d 100644 --- a/reference/sql/sql_functions/scalar_functions/string/substring.rst +++ b/reference/sql/sql_functions/scalar_functions/string/substring.rst @@ -1,8 +1,8 @@ .. _substring: -************************** +********* SUBSTRING -************************** +********* Returns a substring of the input starting at ``start_pos``. @@ -11,14 +11,14 @@ Returns a substring of the input starting at ``start_pos``. See also :ref:`regexp_substr`. Syntax -========== +====== .. code-block:: postgres SUBSTRING( expr, start_pos, length ) Arguments -============ +========= .. list-table:: :widths: auto @@ -29,24 +29,25 @@ Arguments * - ``expr`` - Original string expression from which you want to extract the substring * - ``start_pos`` - - Starting position within the string where the extraction should start (starts at 1) + - The start parameter, which accepts an integer or bigint expression, indicates the position from which the returned characters begin. If start is less than 1, the expression starts from the first character. The number of characters returned is determined by the larger value between start + length - 1 and 0. If start exceeds the number of characters in the expression, an empty string is returned * - ``length`` - - Number of characters to be extracted from the string + - A positive integer or bigint expression that specifies the number of characters to be returned from the expression. If the sum of start and length exceeds the total number of characters in the expression, the entire value starting from the position specified by start is returned. If length is negative or zero, the function returns an empty string Returns -============ +======= + +* Returns the same type as the argument supplied -Returns the same type as the argument supplied. +* If any of the arguments is NULL, the return is NULL Notes -======= +===== * Character count starts at 1. -* If the value is NULL, the result is NULL. Examples -=========== +======== For these examples, assume a table named ``nba``, with the following structure: From eb1b2311de499f9511e936f14c6977f4c62e26ac Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 5 Jun 2023 09:32:29 +0300 Subject: [PATCH 589/882] Services --- feature_guides/workload_manager.rst | 12 ++++-------- ...oring_workers_and_services_from_the_dashboard.rst | 6 +++--- 2 files changed, 7 insertions(+), 11 deletions(-) diff --git a/feature_guides/workload_manager.rst b/feature_guides/workload_manager.rst index aece3d11f..9cf582dde 100644 --- a/feature_guides/workload_manager.rst +++ b/feature_guides/workload_manager.rst @@ -4,15 +4,11 @@ Workload Manager *********************** -The **Workload Manager** allows SQream workers to identify their availability to clients with specific service names. The load balancer uses that information to route statements to specific workers. - -Overview -=============================== -The Workload Manager allows a system engineer or database administrator to allocate specific workers and compute resources for various tasks. +The Workload Manager enables SQream workers to identify their availability to clients with specific service names, allowing a system engineer or database administrator to allocate specific workers and compute resources for various tasks. The load balancer then uses this information to route statements to the designated workers. For example: -#. Creating a service queue named ``ETL`` and allocating two workers exclusively to this service prevents non-``ETL`` statements from utilizing these compute resources. +#. Creating a service queue named ``ETL`` and allocating two workers exclusively to this service prevents non-``ETL`` statements from using these compute resources. #. Creating a service for the company's leadership during working hours for dedicated access, and disabling this service at night to allow maintenance operations to use the available compute. @@ -115,7 +111,7 @@ Each worker gets a comma-separated list of service queues that it subscribes to. Verifying the Configuration ----------------------------------- -Use :ref:`show_subscribed_instances` to view service subscriptions for each worker. Use `SHOW_SERVER_STATUS <https://docs.sqream.com/en/v2020.3/reference/sql/sql_statements/monitoring_commands/show_server_status.html>`_ to see the statement queues. +Use :ref:`show_subscribed_instances` to view service subscriptions for each worker. Use :ref:`SHOW_SERVER_STATUS<show_server_status>` to see the statement queues. @@ -151,7 +147,7 @@ When using **SQream Studio**, you can configure a client connection to a specifi -For more information, in Studio, see `Executing Statements from the Toolbar <https://docs.sqream.com/en/v2020.3/sqream_studio_5.4.3/executing_statements_and_running_queries_from_the_editor.html#executing-statements-from-the-toolbar>`_. +For more information, in Studio, see :ref:`Executing Statements from the Toolbar<executing_statements_and_running_queries_from_the_editor>`. diff --git a/sqream_studio_5.4.7/monitoring_workers_and_services_from_the_dashboard.rst b/sqream_studio_5.4.7/monitoring_workers_and_services_from_the_dashboard.rst index 4283f64a8..b24736945 100644 --- a/sqream_studio_5.4.7/monitoring_workers_and_services_from_the_dashboard.rst +++ b/sqream_studio_5.4.7/monitoring_workers_and_services_from_the_dashboard.rst @@ -47,7 +47,7 @@ The following is a brief description of the Dashboard panels: Subscribing to Workers from the Services Panel -------------------------- -Services are used to categorize and associate (also known as **subscribing**) workers to particular services. The **Service** panel is used for viewing, monitoring, and adding defined `service queues <https://docs.sqream.com/en/v2020.3/feature_guides/workload_manager.html>`_. +Services are used to categorize and associate (also known as **subscribing**) workers to particular services. The **Service** panel is used for viewing, monitoring, and adding defined :ref:`service queues<workload_manager>`. @@ -79,7 +79,7 @@ You can add a service by clicking **+ Add** and defining the service name. You can manage workers from the **Workers** panel. For more information about managing workers, see the following: * :ref:`Managing Workers from the Workers Panel<workers_panel_>` -* `Workers <https://docs.sqream.com/en/v2020-2/reference/cli/sqream_console.html?highlight=workers#workers>`_ +* :ref:`Workers<sqream_console_cli_reference>` :ref:`Back to Monitoring Workers and Services from the Dashboard<back_to_dashboard_>` @@ -151,7 +151,7 @@ Clicking the ellipsis in a service shows the following additional options: * **Stop Query** - stops the query. * **Show Execution Plan** - shows the execution plan as a table. The columns in the **Show Execution Plan** table can be sorted. -For more information on the current query plan, see `SHOW_NODE_INFO <https://docs.sqream.com/en/v2020-2/reference/sql/sql_statements/monitoring_commands/show_node_info.html#show-node-info>`_. For more information on checking active sessions across the cluster, see `SHOW_SERVER_STATUS <https://docs.sqream.com/en/v2020-2/reference/sql/sql_statements/monitoring_commands/show_server_status.html>`_. +For more information on the current query plan, see :ref:`SHOW_NODE_INFO<show_node_info>`. For more information on checking active sessions across the cluster, see :ref:`SHOW_SERVER_STATUS<show_server_status>`. .. include:: /reference/sql/sql_statements/monitoring_commands/show_server_status.rst :start-line: 67 From d826517e4413a2b9c9e46599404e945efd22ed74 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 5 Jun 2023 10:50:21 +0300 Subject: [PATCH 590/882] Services --- connecting_to_sqream/client_drivers/index.rst | 2 +- operational_guides/access_control_permissions.rst | 9 +++++---- 2 files changed, 6 insertions(+), 5 deletions(-) diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index 8c404ab06..dbbd33933 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -31,7 +31,7 @@ The following are applicable to all operating systems: * **Trino**: - * `Trino Connector <>`_ + * Trino Connector * :ref:`trino` .. _spark: diff --git a/operational_guides/access_control_permissions.rst b/operational_guides/access_control_permissions.rst index 15b41182c..bbb3ba4b2 100644 --- a/operational_guides/access_control_permissions.rst +++ b/operational_guides/access_control_permissions.rst @@ -132,8 +132,8 @@ GRANT Syntax TO <role> [, ...]; -- Grant permissions at the Service level: - GRANT {{USAGE} [, ...] | ALL [PERMISSIONS]} - ON { SERVICE <service_name> [, ...] | ALL SERVICES IN SYSTEM } + GRANT {{USAGE} [PERMISSIONS]} + ON { SERVICE <service_name> } TO <role> [, ...] -- Allows role2 to use permissions granted to role1 @@ -179,10 +179,11 @@ REVOKE Syntax REVOKE {{SELECT | DDL } [, ...] | ALL [PERMISSIONS]} ON { COLUMN <column_name> [, ...] | ALL COLUMNS IN TABLE <table_name> [, ...] | ALL COLUMNS IN FOREIGN TABLE <foreign_table_name> [, ...] | ALL COLUMNS IN VIEW <view_name> [, ...] | ALL COLUMNS IN CATALOG <catalog_name> [, ...]} FROM <role> [, ...]; + - -- Revoke permissions at the column level: + -- Revoke permissions at the service level: REVOKE {{USAGE} [, ...] | ALL [PERMISSIONS]} - ON { SERVICE <service_name> [, ...] | ALL SERVICES IN SYSTEM} + ON { SERVICE <service_name> } FROM <role> [, ...] -- Removes access to permissions in role1 by role 2 From c97cd5a1b8d345ca4d745a5d18337355ce14cabd Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 5 Jun 2023 16:02:51 +0300 Subject: [PATCH 591/882] =?UTF-8?q?GRANT=5FUSAGE=5FON=5FSERVICE=5FTO=5FALL?= =?UTF-8?q?=5FROLES=EF=83=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../grant_usage_on_service_to_all_roles.rst | 74 +++++++++++++++++++ reference/sql/sql_statements/index.rst | 12 +-- .../get_role_database_ddl.rst | 23 +++--- ...ing_and_managing_roles_and_permissions.rst | 8 +- 4 files changed, 92 insertions(+), 25 deletions(-) create mode 100644 reference/sql/sql_statements/access_control_commands/grant_usage_on_service_to_all_roles.rst diff --git a/reference/sql/sql_statements/access_control_commands/grant_usage_on_service_to_all_roles.rst b/reference/sql/sql_statements/access_control_commands/grant_usage_on_service_to_all_roles.rst new file mode 100644 index 000000000..2c0f1d338 --- /dev/null +++ b/reference/sql/sql_statements/access_control_commands/grant_usage_on_service_to_all_roles.rst @@ -0,0 +1,74 @@ +.. _grant_usage_on_service_to_all_roles: + +*********************************** +GRANT_USAGE_ON_SERVICE_TO_ALL_ROLES +*********************************** + +The ``grant_usage_on_service_to_all_roles`` utility function enables a ``SUPERUSER`` to grant access to services for other system roles. + +You may use it to perform one of the following options: + +* Granting access to all services for all roles +* Granting access to a specific service for all roles + + +This utility function is particularly beneficial during the upgrade process from SQreamDB version 4.2 or earlier to version 4.3 or later. In previous versions, service access permissions were not required. In this scenario, you can easily grant access to all services for all roles immediately after the upgrade. If you are already using SQreamDB version 4.3 or later, you can grant or revoke access to services by following the :ref:`access permission guide<access_control_permissions>`. + +.. note:: + + When you create a new role, it automatically inherits access permissions to all services from the ``PUBLIC`` role. If you prefer to create new roles without automatically granting them access permissions to all services, you will need to follow the :ref:`ALTER DEFAULT PERMISSIONS<alter_default_permissions>` guide to revoke the access permissions of the ``PUBLIC`` role. + +Syntax +====== + +.. code-block:: psql + + SELECT grant_usage_on_service_to_all_roles (<'single service'>) + + +Examples +======== +Granting access to all services for all roles: + +.. code-block:: psql + + SELECT grant_usage_on_service_to_all_roles(); + +Output: + +.. code-block:: + + role_name | service_name | status + ----------+---------------+-------------------- + role1 | service1 | Permission Granted + role1 | service2 | Permission Granted + role1 | service3 | Permission Granted + role2 | service1 | Permission Granted + role2 | service2 | Permission Granted + role2 | service3 | Permission Granted + role3 | service1 | Permission Exists + role3 | service2 | Permission Exists + role3 | service3 | Permission Exists + +Granting access to one specific service for all roles: + +.. code-block:: psql + + SELECT grant_usage_on_service_to_all_roles('service1'); + +Output: + +.. code-block:: + + role_name | service_name | status + ----------+---------------+-------------------- + role1 | service1 | Permission Granted + role2 | service1 | Permission Granted + role3 | service1 | Permission Exists + + +Permissions +=========== + +Using the ``grant_usage_on_service_to_all_roles`` requires ``SUPERUSER`` permission. + diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index 7044b3a80..f8c6c4332 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -18,7 +18,7 @@ Data Definition Commands (DDL) The following table shows the Data Definition commands: .. list-table:: - :widths: 10 100 + :widths: 30 100 :header-rows: 1 :name: ddl_commands @@ -71,7 +71,7 @@ Data Manipulation Commands (DML) The following table shows the Data Manipulation commands: .. list-table:: - :widths: 10 100 + :widths: 30 100 :header-rows: 1 :name: dml_commands @@ -101,7 +101,7 @@ Utility Commands The following table shows the Utility commands: .. list-table:: - :widths: 10 100 + :widths: 30 100 :header-rows: 1 * - Command @@ -162,7 +162,7 @@ Workload Management The following table shows the Workload Management commands: .. list-table:: - :widths: 10 100 + :widths: 30 100 :header-rows: 1 * - Command @@ -179,7 +179,7 @@ Access Control Commands The following table shows the Access Control commands: .. list-table:: - :widths: 10 100 + :widths: 30 100 :header-rows: 1 * - Command @@ -206,6 +206,8 @@ The following table shows the Access Control commands: - Returns a list of permissions required to run a statement or query * - :ref:`grant` - Grant permissions to a role + * - :ref:`GRANT_USAGE_ON_SERVICE_TO_ALL_ROLES` + - Grant service usage permissions * - :ref:`revoke` - Revoke permissions from a role * - :ref:`rename_role` diff --git a/reference/sql/sql_statements/utility_commands/get_role_database_ddl.rst b/reference/sql/sql_statements/utility_commands/get_role_database_ddl.rst index 5ff3ecf79..ed7adfcf5 100644 --- a/reference/sql/sql_statements/utility_commands/get_role_database_ddl.rst +++ b/reference/sql/sql_statements/utility_commands/get_role_database_ddl.rst @@ -5,11 +5,7 @@ GET_ROLE_DATABASE_DDL ******************** The ``GET_ROLE_DATABASE_DDL`` statement returns the definition of a role's database in DDL format. -The ``GET_ROLE_DATABASE_DDL`` page describes the following: - -.. contents:: - :local: - :depth: 1 +The ``GET_ROLE_DATABASE_DDL`` page describes the following: Syntax ========== @@ -19,14 +15,6 @@ The following is the correct syntax for using the ``GET_ROLE_DATABASE_DDL`` stat select get_role_database_ddl(<'role_name'>) -Example -=========== -The following is an example of using the ``GET_ROLE_DATABASE_DDL`` statement: - -.. code-block:: psql - - select get_role_database_ddl('public'); - Parameters ============ The following table shows the ``GET_ROLE_DATABASE_DDL`` parameters: @@ -39,6 +27,15 @@ The following table shows the ``GET_ROLE_DATABASE_DDL`` parameters: - Description * - ``role_name`` - The definition of the database role in DDL format. + +Example +=========== +The following is an example of using the ``GET_ROLE_DATABASE_DDL`` statement: + +.. code-block:: psql + + select get_role_database_ddl('public'); + Output ========== diff --git a/sqream_studio_5.4.7/creating_assigning_and_managing_roles_and_permissions.rst b/sqream_studio_5.4.7/creating_assigning_and_managing_roles_and_permissions.rst index 648117ca7..6f0e43ef3 100644 --- a/sqream_studio_5.4.7/creating_assigning_and_managing_roles_and_permissions.rst +++ b/sqream_studio_5.4.7/creating_assigning_and_managing_roles_and_permissions.rst @@ -5,14 +5,8 @@ **************************** Creating, Assigning, and Managing Roles and Permissions **************************** -The **Creating, Assigning, and Managing Roles and Permissions** describes the following: -.. contents:: - :local: - :depth: 1 - -Overview ---------------- + In the **Roles** area you can create and assign roles and manage user permissions. The **Type** column displays one of the following assigned role types: From 080fd343b23525515185583829d1fc34012f874f Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 5 Jun 2023 16:37:49 +0300 Subject: [PATCH 592/882] Update 4.3.rst --- releases/4.3.rst | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index 0eaccf68e..749de6cba 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -90,13 +90,14 @@ Version 4.3 resolved Issues Configuration Adjustments ------------------------- -When using SQreamDB legacy configuration file and AWS S3, you may be required to use the following new parameters: +► You may now configure the object access style and your endpoint URL with Virtual Private Cloud (VPC) when using AWS S3. + +Visit :ref:`s3` to learn more about how and when you should use these two new parameters: * ``AwsEndpointOverride`` * ``AwsObjectAccessStyle`` -To learn more about how and when you should use them, visit :ref:`s3`. - +► Upgrading from SQreamDB version 4.2 to 4.3 requires you to grant access to all services for all roles. To learn more, visit :ref:`grant_usage_on_service_to_all_roles`. Deprecated Features ------------------- @@ -152,6 +153,14 @@ Upgrading to v4.3 .. code-block:: console $ ./upgrade_storage <levelDB path> + + :: + +7. To grant access to all services for all roles, run the following command: + + .. code-block:: psql + + SELECT grant_usage_on_service_to_all_roles(); .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. From 22b97d640ec0de1f9ff689b0a012250fcb117584 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 5 Jun 2023 16:45:34 +0300 Subject: [PATCH 593/882] Update hardware_guide.rst --- getting_started/hardware_guide.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/getting_started/hardware_guide.rst b/getting_started/hardware_guide.rst index ace6734cf..bc6276019 100644 --- a/getting_started/hardware_guide.rst +++ b/getting_started/hardware_guide.rst @@ -165,7 +165,7 @@ This section describes the following cluster design considerations: :: -* When using SAN or NAS devices, SQream recommends approximately 5GB/s of burst throughput from storage per GPU. +* When using NAS devices, SQream recommends approximately 5GB/s of burst throughput from storage per GPU. Balancing Cost and Performance -------------------------------- @@ -221,7 +221,7 @@ SQream can run on the following 64-bit Linux operating systems: Storage ----------- -For clustered scale-out installations, SQream relies on NAS/SAN storage. For stand-alone installations, SQream relies on redundant disk configurations, such as RAID 5, 6, or 10. These RAID configurations replicate blocks of data between disks to avoid data loss or system unavailability. +For clustered scale-out installations, SQream relies on NAS storage. For stand-alone installations, SQream relies on redundant disk configurations, such as RAID 5, 6, or 10. These RAID configurations replicate blocks of data between disks to avoid data loss or system unavailability. SQream recommends using enterprise-grade SAS SSD or NVMe drives. For a 32-user configuration, the number of GPUs should roughly match the number of users. SQream recommends 1 Tesla V100 or A100 GPU per 2 users, for full, uninterrupted dedicated access. From 371e9bafc524c32b17b9d0398fea112ce933d4b2 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 8 Jun 2023 14:05:08 +0300 Subject: [PATCH 594/882] ASCII --- reference/sql/sql_functions/index.rst | 2 +- .../scalar_functions/string/select_ascii.rst | 18 +++++++++--------- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/reference/sql/sql_functions/index.rst b/reference/sql/sql_functions/index.rst index bcac9819b..30495bd6a 100644 --- a/reference/sql/sql_functions/index.rst +++ b/reference/sql/sql_functions/index.rst @@ -270,7 +270,7 @@ The following table shows the **string** functions: * - :ref:`upper` - Converts an argument to an upper-case equivalent * - :ref:`select_ascii` - - Return the ASCII code value of the leftmost character of a string + - Returns an ``INT`` value representing the ASCII code of the leftmost character in a string User-Defined Scalar Functions --------------------- diff --git a/reference/sql/sql_functions/scalar_functions/string/select_ascii.rst b/reference/sql/sql_functions/scalar_functions/string/select_ascii.rst index 562a7e355..2792e4b67 100644 --- a/reference/sql/sql_functions/scalar_functions/string/select_ascii.rst +++ b/reference/sql/sql_functions/scalar_functions/string/select_ascii.rst @@ -1,22 +1,22 @@ .. _select_ascii: -******************** -SELECT ASCII -******************** -The **SELECT ASCII** function is commonly used in combination with other SQL functions for operations such as data transformation, validation, and storing based on ASCII values. +***** +ASCII +***** +The **ASCII** function is commonly used in combination with other SQL functions for operations such as data transformation, validation, and storing based on ASCII values. Syntax -========== +====== The following shows the syntax for the SELECT ASCII function: .. code-block:: postgres - SELECT ASCII(''); + ASCII() -Returns -========= +Return +====== -The SELECT ASCII function returns the ASCII code value of the leftmost character of a string. +The function returns an 'INT' value representing the ASCII code of the leftmost character in a string. Example =========== From c4e84a7744bc9ca7c59e06418a7a0af4096b484b Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 8 Jun 2023 15:16:52 +0300 Subject: [PATCH 595/882] Update to_hex.rst --- .../scalar_functions/conversion/to_hex.rst | 55 +++++++++++++++---- 1 file changed, 43 insertions(+), 12 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/conversion/to_hex.rst b/reference/sql/sql_functions/scalar_functions/conversion/to_hex.rst index d33643f22..2885a605f 100644 --- a/reference/sql/sql_functions/scalar_functions/conversion/to_hex.rst +++ b/reference/sql/sql_functions/scalar_functions/conversion/to_hex.rst @@ -7,14 +7,14 @@ TO_HEX Converts an integer to a hexadecimal representation. Syntax -========== +====== .. code-block:: postgres TO_HEX( expr ) --> TEXT Arguments -============ +========= .. list-table:: :widths: auto @@ -23,32 +23,35 @@ Arguments * - Parameter - Description * - ``expr`` - - An integer expression + - This function accepts ``INT`` and ``BIGINT`` expressions Returns -============ - -* Representation of the hexadecimal number of type ``TEXT``. +======= +If the input number is of type ``INT``, the return string will be 10 characters long (8 characters for the digits and 2 characters for the "0x" prefix). If the input number is of type ``BIGINT``, the return string will be 18 characters long (16 characters for the digits and 2 characters for the "0x" prefix). Examples -=========== +======== -For these examples, consider the following table and contents: +``BIGINT`` data type +-------------------- .. code-block:: postgres CREATE TABLE cool_numbers(number BIGINT NOT NULL); + +.. code-block:: postgres INSERT INTO cool_numbers VALUES (42), (3735928559), (666), (3135097598), (3221229823); +.. code-block:: postgres -Convert numbers to hexadecimal -------------------------------------- + SELECT TO_HEX(number) FROM cool_numbers; + +Output: -.. code-block:: psql +.. code-block:: none - master=> SELECT TO_HEX(number) FROM cool_numbers; to_hex ------------------ 0x000000000000002a @@ -56,3 +59,31 @@ Convert numbers to hexadecimal 0x000000000000029a 0x00000000baddcafe 0x00000000c00010ff + + +``INT`` data type +----------------- + +.. code-block:: postgres + + CREATE TABLE cool_numbers(number INT NOT NULL); + +.. code-block:: postgres + + INSERT INTO cool_numbers VALUES (42), (373592855), (666), (313509759), (322122982); + +.. code-block:: postgres + + SELECT TO_HEX(number) FROM cool_numbers; + +Output: + +.. code-block:: none + + to_hex + ------------------ + 0x0000002a + 0x16449317 + 0x0000029a + 0x12afc77f + 0x133334e6 \ No newline at end of file From deacf02edaf59b2e751d57dc6fd3ccc87a75913b Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 8 Jun 2023 15:23:28 +0300 Subject: [PATCH 596/882] Update access_control_permissions.rst --- operational_guides/access_control_permissions.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/operational_guides/access_control_permissions.rst b/operational_guides/access_control_permissions.rst index bbb3ba4b2..276b969c5 100644 --- a/operational_guides/access_control_permissions.rst +++ b/operational_guides/access_control_permissions.rst @@ -143,7 +143,7 @@ GRANT Syntax -- Also allows the role2 to grant role1 to other roles: GRANT <role1> [, ...] TO <role2> - WITH ADMIN OPTION + REVOKE Syntax ============= @@ -187,10 +187,10 @@ REVOKE Syntax FROM <role> [, ...] -- Removes access to permissions in role1 by role 2 - REVOKE <role1> [, ...] FROM <role2> [, ...] WITH ADMIN OPTION + REVOKE <role1> [, ...] FROM <role2> [, ...] -- Removes permissions to grant role1 to additional roles from role2 - REVOKE <role1> [, ...] FROM <role2> [, ...] WITH ADMIN OPTION + REVOKE <role1> [, ...] FROM <role2> [, ...] Altering Default Permissions ============================ From 76ce16a6e749fe8b1cfa56dc59a69fb4f9c8b869 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Thu, 8 Jun 2023 17:39:04 +0300 Subject: [PATCH 597/882] Update hardware_guide.rst --- getting_started/hardware_guide.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/getting_started/hardware_guide.rst b/getting_started/hardware_guide.rst index bc6276019..61d1aae50 100644 --- a/getting_started/hardware_guide.rst +++ b/getting_started/hardware_guide.rst @@ -225,6 +225,5 @@ For clustered scale-out installations, SQream relies on NAS storage. For stand-a SQream recommends using enterprise-grade SAS SSD or NVMe drives. For a 32-user configuration, the number of GPUs should roughly match the number of users. SQream recommends 1 Tesla V100 or A100 GPU per 2 users, for full, uninterrupted dedicated access. -Download the full `SQream Reference Architecture <https://sqream.com/product/hardware/#download>`_ document. .. note:: Non production HW requirements may be found at `Non Production HW Requirements <non_production_hardware_guide.html>`_ \ No newline at end of file From 97e06700ab301bbbbb5e2e4343208fb91e2ab7a1 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Sun, 11 Jun 2023 07:59:36 +0300 Subject: [PATCH 598/882] 4.3 date update --- releases/4.3.rst | 2 +- releases/index.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index 749de6cba..a8dc5421e 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -4,7 +4,7 @@ Release Notes 4.3 ***************** -The 4.3 release notes were released on xx/06/2023 and describe the following: +The 4.3 release notes were released on 11/06/2023 and describe the following: .. contents:: :local: diff --git a/releases/index.rst b/releases/index.rst index b02e21ff9..241381e3b 100644 --- a/releases/index.rst +++ b/releases/index.rst @@ -13,7 +13,7 @@ Release Notes * - Version - Release Date * - :ref:`4.3` - - May 31, 2023 + - June 11, 2023 * - :ref:`4.2` - April 23, 2023 * - :ref:`4.1` From d73a1e945bd6a5532af2a0df0f56618aa8fd1439 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Sun, 11 Jun 2023 08:10:56 +0300 Subject: [PATCH 599/882] Update 4.3.rst --- releases/4.3.rst | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index a8dc5421e..29d06176c 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -156,11 +156,8 @@ Upgrading to v4.3 :: -7. To grant access to all services for all roles, run the following command: +7. v4.3 introduced a new SERVICE permission, existing users may lose SERVICE access. To resolve, either grant users with SERVICE USAGE permission or grant access to all services for all roles using :ref:`grant-usage-on-service-to-all-roles`. - .. code-block:: psql - - SELECT grant_usage_on_service_to_all_roles(); .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. From 38044d00ac546496fbebe2393aaddef0124b4dc6 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Sun, 11 Jun 2023 08:20:15 +0300 Subject: [PATCH 600/882] Update 4.3.rst --- releases/4.3.rst | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index 29d06176c..b36a9c93a 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -97,8 +97,6 @@ Visit :ref:`s3` to learn more about how and when you should use these two new pa * ``AwsEndpointOverride`` * ``AwsObjectAccessStyle`` -► Upgrading from SQreamDB version 4.2 to 4.3 requires you to grant access to all services for all roles. To learn more, visit :ref:`grant_usage_on_service_to_all_roles`. - Deprecated Features ------------------- @@ -156,7 +154,7 @@ Upgrading to v4.3 :: -7. v4.3 introduced a new SERVICE permission, existing users may lose SERVICE access. To resolve, either grant users with SERVICE USAGE permission or grant access to all services for all roles using :ref:`grant-usage-on-service-to-all-roles`. +7. v4.3 introduced a new SERVICE permission, existing users may lose SERVICE access. To resolve, either grant users with SERVICE USAGE permission or grant access to all services for all roles using :ref:`grant_usage_on_service_to_all_roles`. .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. From c016581b40d1ce60e6070225a545ccdbad8df153 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Sun, 11 Jun 2023 08:29:02 +0300 Subject: [PATCH 601/882] Create .readthedocs.yaml --- .readthedocs.yaml | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 .readthedocs.yaml diff --git a/.readthedocs.yaml b/.readthedocs.yaml new file mode 100644 index 000000000..a330e260d --- /dev/null +++ b/.readthedocs.yaml @@ -0,0 +1,23 @@ +# .readthedocs.yaml +# Read the Docs configuration file +# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details + +# Required +version: 2 + +# Set the version of Python and other tools you might need +build: + os: ubuntu-22.04 + tools: + python: "3.11" + +# Build documentation in the docs/ directory with Sphinx +sphinx: + configuration: conf.py + +# We recommend specifying your dependencies to enable reproducible builds: +# https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html +# python: + install: + requirements: requirements.txt + \ No newline at end of file From c619ae9de6b5a61a0c6c9aab98dafe959b5dffce Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Sun, 11 Jun 2023 08:35:44 +0300 Subject: [PATCH 602/882] gg --- .readthedocs.yaml | 20 +++++++++++++------- conf.py | 2 +- 2 files changed, 14 insertions(+), 8 deletions(-) diff --git a/.readthedocs.yaml b/.readthedocs.yaml index a330e260d..eeec35071 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -10,14 +10,20 @@ build: os: ubuntu-22.04 tools: python: "3.11" + # You can also specify other tool versions: + # nodejs: "19" + # rust: "1.64" + # golang: "1.19" # Build documentation in the docs/ directory with Sphinx sphinx: - configuration: conf.py + configuration: conf.py -# We recommend specifying your dependencies to enable reproducible builds: -# https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html -# python: - install: - requirements: requirements.txt - \ No newline at end of file +# If using Sphinx, optionally build your docs in additional formats such as PDF +# formats: +# - pdf + +# Optionally declare the Python requirements required to build your docs +python: + install: + - requirements: requirements.txt \ No newline at end of file diff --git a/conf.py b/conf.py index bee87ebd0..4cefff76e 100644 --- a/conf.py +++ b/conf.py @@ -26,7 +26,7 @@ # The full version, including alpha/beta/rc tags -release = '4.2' +release = '4.3' From 4af89163812c1802695e46d23122c6cef83ea269 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Sun, 11 Jun 2023 12:04:19 +0300 Subject: [PATCH 603/882] Update 4.3.rst --- releases/4.3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index b36a9c93a..3071e083a 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -21,7 +21,7 @@ Compatibility Matrix +-------------------------+------------------------------------------------------------------------+ | supported Nvidia driver | CUDA version from 10.1 up to 11.4.3 | +-------------------------+------------------------------------------------------------------------+ -| Storage version | 46 | +| Storage version | 49 | +-------------------------+------------------------------------------------------------------------+ | Driver compatibility | * JDBC 4.5.8 | | | * ODBC 4.4.4 | From 3e0b974728b481fe22410fc01c6909ba4b8e0392 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Mon, 12 Jun 2023 06:32:45 +0300 Subject: [PATCH 604/882] Update .readthedocs.yaml Enable PDF download --- .readthedocs.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.readthedocs.yaml b/.readthedocs.yaml index eeec35071..3475abda8 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -20,8 +20,8 @@ sphinx: configuration: conf.py # If using Sphinx, optionally build your docs in additional formats such as PDF -# formats: -# - pdf + formats: + - pdf # Optionally declare the Python requirements required to build your docs python: From 468f43a5fe53deb5294e97c2f75c6269197d02f9 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Mon, 12 Jun 2023 06:35:29 +0300 Subject: [PATCH 605/882] Update .readthedocs.yaml --- .readthedocs.yaml | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/.readthedocs.yaml b/.readthedocs.yaml index 3475abda8..88fe3c408 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -20,9 +20,8 @@ sphinx: configuration: conf.py # If using Sphinx, optionally build your docs in additional formats such as PDF - formats: - - pdf - +formats: pdf + # Optionally declare the Python requirements required to build your docs python: install: From d42050b03295e222b8974e65640c0b9bf3c0878e Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Mon, 12 Jun 2023 06:36:42 +0300 Subject: [PATCH 606/882] Update .readthedocs.yaml --- .readthedocs.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.readthedocs.yaml b/.readthedocs.yaml index 88fe3c408..49e20dbc4 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -20,7 +20,7 @@ sphinx: configuration: conf.py # If using Sphinx, optionally build your docs in additional formats such as PDF -formats: pdf +formats: [pdf] # Optionally declare the Python requirements required to build your docs python: From 06d9deeebb8abe771e57b38169913653207e77e4 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Mon, 12 Jun 2023 06:41:56 +0300 Subject: [PATCH 607/882] Update requirements.txt --- requirements.txt | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/requirements.txt b/requirements.txt index a4fb056dd..8f42b94c9 100644 --- a/requirements.txt +++ b/requirements.txt @@ -6,4 +6,5 @@ sphinx_rtd_theme==1.2.0 urllib3<=2.0.0 openssl-python>=0.1.1 sphinx-notfound-page -Pygments>=2.4.0 \ No newline at end of file +Pygments>=2.4.0 +pdftex>=1.0.0 \ No newline at end of file From f2678cee38d6ba58c7b44e5308e9289cf0ed02fa Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Mon, 12 Jun 2023 06:52:56 +0300 Subject: [PATCH 608/882] Update requirements.txt --- requirements.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/requirements.txt b/requirements.txt index 8f42b94c9..a8c8329d7 100644 --- a/requirements.txt +++ b/requirements.txt @@ -7,4 +7,4 @@ urllib3<=2.0.0 openssl-python>=0.1.1 sphinx-notfound-page Pygments>=2.4.0 -pdftex>=1.0.0 \ No newline at end of file +pdftex \ No newline at end of file From 35ff00b314e75d74cfe975c620e234d60f4580d3 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Mon, 12 Jun 2023 07:03:37 +0300 Subject: [PATCH 609/882] Update .readthedocs.yaml --- .readthedocs.yaml | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/.readthedocs.yaml b/.readthedocs.yaml index 49e20dbc4..139a8d030 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -20,9 +20,16 @@ sphinx: configuration: conf.py # If using Sphinx, optionally build your docs in additional formats such as PDF -formats: [pdf] +formats: [htmlzip,pdf] # Optionally declare the Python requirements required to build your docs python: install: - - requirements: requirements.txt \ No newline at end of file + - requirements: requirements.txt + - method: pip + path: . + extra_requirements: + - docs + - method: pip + path: another/package + system_packages: true \ No newline at end of file From 78869344d64b21ac1ccd8d263c45fac3fc465009 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Mon, 12 Jun 2023 07:06:22 +0300 Subject: [PATCH 610/882] Update .readthedocs.yaml --- .readthedocs.yaml | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/.readthedocs.yaml b/.readthedocs.yaml index 139a8d030..8ebde2625 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -27,9 +27,4 @@ python: install: - requirements: requirements.txt - method: pip - path: . - extra_requirements: - - docs - - method: pip - path: another/package - system_packages: true \ No newline at end of file +system_packages: true \ No newline at end of file From 7f82277e6220da2d66a51a8982bd8cef1f0c06e7 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Mon, 12 Jun 2023 07:07:30 +0300 Subject: [PATCH 611/882] Update .readthedocs.yaml --- .readthedocs.yaml | 1 - 1 file changed, 1 deletion(-) diff --git a/.readthedocs.yaml b/.readthedocs.yaml index 8ebde2625..b95f412b9 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -26,5 +26,4 @@ formats: [htmlzip,pdf] python: install: - requirements: requirements.txt - - method: pip system_packages: true \ No newline at end of file From 08fc11048524bf6f313633e85ae6683dc98945eb Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Mon, 12 Jun 2023 07:08:03 +0300 Subject: [PATCH 612/882] Update .readthedocs.yaml --- .readthedocs.yaml | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/.readthedocs.yaml b/.readthedocs.yaml index b95f412b9..77b6f73c2 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -25,5 +25,4 @@ formats: [htmlzip,pdf] # Optionally declare the Python requirements required to build your docs python: install: - - requirements: requirements.txt -system_packages: true \ No newline at end of file + - requirements: requirements.txt \ No newline at end of file From ae8317c50eab1bafe871817dd7de74f7deaeb4de Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 12 Jun 2023 08:37:25 +0300 Subject: [PATCH 613/882] Update copy_from.rst --- reference/sql/sql_statements/dml_commands/copy_from.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/dml_commands/copy_from.rst b/reference/sql/sql_statements/dml_commands/copy_from.rst index bab998e15..91c32cd01 100644 --- a/reference/sql/sql_statements/dml_commands/copy_from.rst +++ b/reference/sql/sql_statements/dml_commands/copy_from.rst @@ -105,7 +105,7 @@ Elements - " - - Specifies an alternative quote character. The quote character must be a single, 1-byte printable ASCII character, and the equivalent octal syntax of the copy command can be used. The quote character cannot be contained in the field delimiter, the record delimiter, or the null marker. ``QUOTE`` can be used with ``csv_fdw`` in **COPY FROM** and foreign tables. - * - ``name_fdw`` + * - ``fdw_name`` - - ``csv_fdw``, ``orc_fdw``, or ``parquet_fdw`` - The name of the Foreign Data Wrapper to use From 35acc01d826dd55662cb774a5c149221a958a4f0 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 12 Jun 2023 09:11:18 +0300 Subject: [PATCH 614/882] Update regexp_replace.rst --- .../string/regexp_replace.rst | 23 +++++++++++-------- 1 file changed, 13 insertions(+), 10 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/string/regexp_replace.rst b/reference/sql/sql_functions/scalar_functions/string/regexp_replace.rst index ba3424190..aa8724d47 100644 --- a/reference/sql/sql_functions/scalar_functions/string/regexp_replace.rst +++ b/reference/sql/sql_functions/scalar_functions/string/regexp_replace.rst @@ -7,16 +7,15 @@ The ``REGEXP_REPLACE`` function finds and replaces text column substrings using For related information, see the following: -* `REGEXP_COUNT <https://docs.sqream.com/en/latest/reference/sql/sql_functions/scalar_functions/string/regexp_count.html>`_ -* `REGEXP_INSTR <https://docs.sqream.com/en/latest/reference/sql/sql_functions/scalar_functions/string/regexp_instr.html>`_ -* `REGEXP_SUBSTR <https://docs.sqream.com/en/latest/reference/sql/sql_functions/scalar_functions/string/regexp_substr.html>`_ +* :ref:`REGEXP_COUNT<regexp_count>` +* :ref:`REGEXP_INSTR<regexp_instr>` +* :ref:`REGEXP_SUBSTR<regexp_substr>` Syntax --------------- -The following is a syntactic example of the ``REGEXP_REPLACE`` function: +------ .. code-block:: postgres @@ -92,15 +91,15 @@ The following table shows the ``REGEXP_REPLACE`` test patterns: Any character that does not have a defined special meaning inside a [] pair matches only itself. Returns ------------- +------- The ``REGEXP_REPLACE`` function returns the replaced input value. Notes --------------- +----- The test pattern must be a literal string. Example --------------- +------- The following is an example of the ``REGEXP_REPLACE`` function: .. code-block:: @@ -109,8 +108,12 @@ The following is an example of the ``REGEXP_REPLACE`` function: INSERT INTO test values('SWEDEN'); SELECT REGEXP_REPLACE(country_name, 'WEDE', 'PAI') FROM test; - SELECT * FROM test; +Output: + +.. code-block:: none -The output generated from the example above is ``SPAIN``. + country_name| + ------------+ + SPAIN | From ea15a809871bc99d58fef533c0c1784bf8815e54 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 12 Jun 2023 09:12:18 +0300 Subject: [PATCH 615/882] Update regexp_replace.rst --- .../sql_functions/scalar_functions/string/regexp_replace.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/string/regexp_replace.rst b/reference/sql/sql_functions/scalar_functions/string/regexp_replace.rst index aa8724d47..dcf0f85ce 100644 --- a/reference/sql/sql_functions/scalar_functions/string/regexp_replace.rst +++ b/reference/sql/sql_functions/scalar_functions/string/regexp_replace.rst @@ -43,8 +43,7 @@ The following table shows the ``REGEXP_REPLACE`` arguments: - (Optional) Sets a specific occurrence to replace. Using ``0`` replaces all occurrences. Test Patterns --------------- -The following table shows the ``REGEXP_REPLACE`` test patterns: +------------- .. list-table:: :widths: auto From c6361746ee08f99dfa311259d0f35f6afb11af24 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 12 Jun 2023 10:38:29 +0300 Subject: [PATCH 616/882] Update 4.3.rst --- releases/4.3.rst | 21 +++++++++------------ 1 file changed, 9 insertions(+), 12 deletions(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index 3071e083a..1995e7fd8 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -34,7 +34,7 @@ Compatibility Matrix New Features and Enhancements ----------------------------- -Access control permissions in SQreamDB have been expanded, allowing roles to now grant and revoke access to other roles for the following: +► Access control permissions in SQreamDB have been expanded, allowing roles to now grant and revoke access to other roles for the following: * VIEWS * FOREIGN TABLE @@ -44,6 +44,8 @@ Access control permissions in SQreamDB have been expanded, allowing roles to now To learn more about how and when you should use this new capability, visit :ref:`access_control_permissions`. +► RocksDB's metadata scale-up improvements have been implemented. + Known Issues ------------ @@ -132,29 +134,24 @@ Upgrading to v4.3 2. Shut down all SQream services. - :: - 3. Copy the recently created back-up file. - :: - 4. Replace your current metadata with the metadata you stored in the back-up file. - :: - 5. Navigate to the new SQream package bin folder. - :: - 6. Run the following command: .. code-block:: console $ ./upgrade_storage <levelDB path> - :: - -7. v4.3 introduced a new SERVICE permission, existing users may lose SERVICE access. To resolve, either grant users with SERVICE USAGE permission or grant access to all services for all roles using :ref:`grant_usage_on_service_to_all_roles`. +7. Version 4.3 introduces a service permission feature that enables superusers to grant and revoke role access to services. However, when upgrading from version 4.2 or earlier to version 4.3 or later, this feature initializes access to services, causing existing roles to lose their access to services. + +There are two methods of granting back access to services: + + * Grant access to all services for all roles using the :ref:`grant_usage_on_service_to_all_roles` utility function + * Selectively grant or revoke access to services by following the :ref:`access permission guide<access_control_permissions>` .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. From 95096674d32a8b27928143bb6fa2ec27ea724ca7 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 12 Jun 2023 11:00:42 +0300 Subject: [PATCH 617/882] Update to_hex.rst --- .../scalar_functions/conversion/to_hex.rst | 32 +++++++++---------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/conversion/to_hex.rst b/reference/sql/sql_functions/scalar_functions/conversion/to_hex.rst index 2885a605f..68c695f09 100644 --- a/reference/sql/sql_functions/scalar_functions/conversion/to_hex.rst +++ b/reference/sql/sql_functions/scalar_functions/conversion/to_hex.rst @@ -42,7 +42,7 @@ Examples .. code-block:: postgres - INSERT INTO cool_numbers VALUES (42), (3735928559), (666), (3135097598), (3221229823); + INSERT INTO cool_numbers VALUES (-42), (3735928559), (666), (3135097598), (3221229823); .. code-block:: postgres @@ -52,13 +52,13 @@ Output: .. code-block:: none - to_hex - ------------------ - 0x000000000000002a - 0x00000000deadbeef - 0x000000000000029a - 0x00000000baddcafe - 0x00000000c00010ff + to_hex + ------------------ + 0xffffffffffffffd6 + 0x00000000deadbeef + 0x000000000000029a + 0x00000000baddcafe + 0x00000000c00010ff ``INT`` data type @@ -70,7 +70,7 @@ Output: .. code-block:: postgres - INSERT INTO cool_numbers VALUES (42), (373592855), (666), (313509759), (322122982); + INSERT INTO cool_numbers VALUES (-42), (373592855), (666), (313509759), (322122982); .. code-block:: postgres @@ -80,10 +80,10 @@ Output: .. code-block:: none - to_hex - ------------------ - 0x0000002a - 0x16449317 - 0x0000029a - 0x12afc77f - 0x133334e6 \ No newline at end of file + to_hex + ---------- + 0xffffffd6 + 0x16449317 + 0x0000029a + 0x12afc77f + 0x133334e6 \ No newline at end of file From 052d0012f7b8891e270284669d5f7d5842496131 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Mon, 12 Jun 2023 13:41:48 +0300 Subject: [PATCH 618/882] Create 3c9c4e8b-49bd-44a8-9829-81d1772ed962.gif --- .../3c9c4e8b-49bd-44a8-9829-81d1772ed962.gif | Bin 0 -> 35371 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 _static/images/3c9c4e8b-49bd-44a8-9829-81d1772ed962.gif diff --git a/_static/images/3c9c4e8b-49bd-44a8-9829-81d1772ed962.gif b/_static/images/3c9c4e8b-49bd-44a8-9829-81d1772ed962.gif new file mode 100644 index 0000000000000000000000000000000000000000..0369bff1c90bd6ddac4a6b608742043ad92e0d13 GIT binary patch literal 35371 zcmeFZWl)?^w=NjNB?;0553UUf?gY2s-nhGK&;$+c5ZqlG8n*z!-5r8E1b3KjlJA^z zr)p+u=EwZHU6lsjZA+iE*4{gBkerMd8ZsX8vuDrHB*cXko;`!pfA;LfE#gb)lTUM~ z3(z0W9Tda_pOp;}>_Go`Wg;Lg@a!2l0_9E*4*K^Wxz9=>(4Wi8%hS`-b8~ah@7dW| z==aRb%-<)_htMZ~zoEZCKhXZ@=;-+P_%t*$^mITrR(3WvHi1uq0-uD0g@q-=rKBW3 z%gf6vDk!O{sHv)eG(cL~TDm$qI(oW#h6YAPh9(x~mKGM)mKIjfkAuCFlcTeflk*o> zcQ-dTFHdi8FYm8keFFRgzXt|=|NcGbdr(+dcvx6OOiWB{Y<yf?Tta+8a&l@)a!Pu7 zMs`+Cc6N4dZf<^lL2+?OMR~>32V7NI)!5kB)YRP4($d}C1O4>&_V)MpL+M|4wxWje z@WxR=M)BF3_a8pV>DqpcNH1?4UOpnj^9hEwA=!$nJ3M=a^A`5+c^~B||FdV`3nYXE zlw7qBQjxqTY5<)pPCC6WNWNA0=e{yUWWmB~cr^#nOZIrQIX!IV0$KJ~k*}$*pFTFL zvP@S3HN?a!o7M&Kaayl#Zi&5`9Cu<PbAOLTEPG#`<KSd2Gn2JH#<x>p+QM&W-QDdG zSFn-vcjnsg1%?hk^OqeOxLo#t#|>L0H4=?aB5vgzSG!on!Q$h@S@uQ(qOGm6HwlwU z4YNP`rgd+ws`Be=2@Vb9%2T=@Tj0^t_>`0Ee7sH}Q)9yRx_S}acY^CAD!CG9XVT>t zvaCxXI5b!*ryNku;YR^?jP1yafe!3pG22^Y^a?@si*0j>yg=mJ8u9s@uy5Gbc~lV_ zsc`jtl?a(}sb`{h;XJD&`UP%>!A?caOFSZ}Knjr)-d9U~365%GaOd?emgFgnnA#2a zvpb@#3zklAkmUs>4YnQNaIWc}?|hdU`O#LE65C&~W$@)(l#A?3#>VR9_qPf}{DPaf zEuR2_T<>MN?UTO7e%@<@q)@)s!pK8rfc-s?TVvC1Ybn6hxr}gy*NQ|F6Q9t<crp*l zQT!0P@jgCQ#_QcJMLfpX+e5fl==u^n9tM)-9gR&n1`8kJRi$zqX(OoJ_&NjyxrEBo zyWFgeY(4xY<lx1+#otznueXQ{_p^_2y5Z}hW)j+zmX(y09ITq4_%=KBR#%=AwIZp% zvuAJOkp09ZR-P_8jJaQ0W_>_-SXNr{+F^LDG%hT)qxm2%j#n5_9gB$>4hQ@_68(Dl z9i~Dc9sc2ow~f)@!ywa)+9JN`s;j}q2&o@E`k)E&l`&4@bDc22oUYSgi6V#QtUyt( zH9=EZxqaDJ`gem7ZGW0yGQDge0z#VOT=Oj~;DRVEG{jTVT6AzfT1fSjn6(J^Gm^*P z{#i85v??VfAt-_HezZ*)`bp{B*wa)`|K1bc@xU{O+d#+J9@ESoJ;}SvBDzs)jaQy| z(}BIelT$<D=-Li4GQ}48W~p|mk4v0NmmNb@Teq)j#`{pa#odRcaO7@b>T1}RxO5Mb z6`#!dV`zfKPDW>1gjBYFO-;C;EyVt-Qfh}G*NP*ZdTyAv_CixpoXh>@12N)Y(h0rF z@U~Nqg#RWP+*%7e-;BD};w<-!I=(%X{(@$EH$TyW(vD{R_3ut5$3V!80~5%UyEoF& zCig&eO1Cn|hdqyJIL`Y`8gN6s1Q0Yx@;a22sjTy`%(C&edA?)8p-D5J__AD$;u``Y z<A=ZF5$x8v-Z8zb01$6;y>n{ZThkg>T}J~9#LKT<U+o^EkUMP8p%{bbJjzL>i+-w+ zeUDgmWkr2g1F{hbP24++2ySEOWVz+kK*AL=J;p6rZ==_flOJ2@V^io=)c*1S#(lA} zE6uK6@dI%CDIUE_PRo6CQ@>ohg)^PbrxT$IPrw6fzF1((H*TuG>e!xFevq2orlG%X zqjpBV)Gw3-a!FUr7EZWNK8L%%z5W2QmxjPa@PefBjhIvF((WkpbeDPRD}Mlr!*qM; z;~_5%!rt=*pE=vyDle$jr*vq~x+qpqm0JUJ!Py`rTrtyb3p$H=Zv0}e8VL@N&g{(W z{GytAgwSkiTwH1D!Fk-|+e@YL<RJ{z`#RYWD_;ONP`BjmFR>_@(!&ynR(e>>-fQK7 z4Fuw2Mc30;L2v;8cbP8Cxut+mwc0EvbQRUb*tRzF6Uyo1sky%0uERg-FPOvnr!i9p z(Lk2zU%{eph(&%p!*repIy;s{IG<l2x5mSR_BnA?P4lrQE&c1iUefhqM}KJ7**Fom z*zXhMDHRMk!2B?UxSFjd%QrCkz_R+T-f`;W1OrvWVnlzqw@wg0N7jOnDnW#M=YCwW zjEC*};F1rd!6Q3j_|`;S=EBB&*!xtX&R@}vV9=)8Vm?-{9i{XrSudr+JJ()$^ULY) z-Hm=#;yXp`2zStN-yn`Pn%27A_`7OUy~`QReHOl!hGGX2)g#K6@v5)su~hjyom9~e zB$KE*<F&m{z{cRgxFsIDTsQsO+O^ucH?n~b7F5XjGx3`B$$Sy}Ogf&w^DXh>MtOWF zUOs6%=x2m#4A?wwwBGWKJFEMJoYk#r$65%-yo-+i-3jwT<<})RX%^P2;lX~@z1PVW zLz_1<r@ff7i*b!R9*ejdK^jN)u@d()d@XgwxMj68tvp?C=0=ygl3Hpj8^FGWKF#aO z43D4of7?zkS*xqh&k;H|N(~=j=M>ke+(#r9J@82o9W;dC;TwZ%^6VFPCh}VFvI8PO zTV2J%JiX(=GDuf?1+I9wcZVI)`gB2-%kXsQ{Ddc>ujf|$-;q*V`v2+ajPo9QX<g=s zf!=jM<i@7$Kdu*;qGmbc;X!*U!oicW12STX(A{}bcc<>;YdHk`WAO784nkSTCUVnQ zOoDe)uW~X{_mFh~m;BdS$@>*q&qaOT^$daPtsDO=2J5n;3ri724`yx)I*C_1DB9dL z)DYeITxLmA-$f_Z>4Vfo;ANYYXPqv0s%0g@iwNgm+S9ep&Szym_{>JwQmViB+`XJu zNjPj1u$pZ9h(>Mvy_52~{D%TP9+PhbEx+#JcKZeXOj#tG5}r67bqM7prjXN3P4=HU z_R<9_^gzWgBao347KsSq+6V*FGCvdM(1uRR`h(}0reKMeqA{UXO14I2Dx#-|@vq-m zygH5|SWP=Tb~_nZ1@Cy!C7H3Q2B)rxYT>I`QL1t`npyb?_)y*#MgR(f^5B8$#rZ5) z)3v<$3gGQT4T;=Au82}1jdziVHFXH6ICGy;9IP&9@ON)Jtd2FBX$3!x_Gh7avUATI zW<Ff|hBfszh=vm@TSnp6OG<O!*4-F-KYq*A?4NG%LCs*4RzuUq;h$S}*-H*gw%^TG zE4Az2uEFbc*yts;S!$~6Y`A!6(VQ#bctw>5g0FRtT0OtNr?L(;IS>n9-F--Ax6xMn z95GS$rkp2ghFG>Nsc#Tm))M`>ftuj8ZLP>z&&N;~Tqe5uc5(31zD~J%N$O{s-UmLA z6l8`@;hl@)c1X$}n?7gyw+=UbrbKNRFJN$#^zwM@Al1n`M0FMl=W~nmAPM6Erg~b_ zMMx7sf6};`$Z8vE2qwx&C;2VrU}-e-$|Z-r_RSlW0y;{zTIOjMX|<SI42vpN;rnt& z0~yUY17>9{PZB}5^Y`8~8t*&&^5B!t#>1Pdzn#r|G*6!aEtVQ_FG)`({Ao|M2+SkA z>96<k>RuNv%P+yx%HP+9M=_q$2iNu45f<*yG2>X=)>%u9Dr#Jv1<%LK18H?)_)_{a zEN=Hm@Wp?ewj5XKZc4eZX7%4WevR)22IZC}#uJ9o)p5V${=FdCFrwo&hcRAt4;kNz zuNMf8TTWd~j-Qq(s-_NUSQ~GeVxf&2<?u0j1@nDWc<w#A;=Nv-&vPA!`W30D>iG3V zrnz5sxY}r)=SnLXbfWrP{p)4<r*r8zi^oit^po*YEE(8J-KUZ2NIx%0vUswVP4TcT zg44sbRS2aA-ejWH+@*6DFmVu)M-=SuHd$_R`arXbg)rsfMLoct==c0b(>c{tX$JL; zy<H$+kKbEA8OdTwPN!|;;4J(6mf_%@%qd2Rrye!w=bM+3W4|OK!{a5LOgm(8>`mF% zP%;y3d(t4lIkO7l#5lg)_F#Ss8hV$FGxb_y{*pf<b){Cm9=tSOfemoyi;_kx;kvlr zU>F~xw0fl4VZc&dYs8G!mc2ESZiHE)H>tmRtaw)_yqH+)C5H(F%#Y}zYfb5cA0&s{ zleR)je+dVAnxb2P;|#{1H}E4g>wO<_Rsj*)g}t^S>~yKxBgh#>b`xZ!O>*95oPMzS zRvhX|qbE6TJ~k;tXf|SATPc6K7VpNQfmBOSGB3)N@v*j0n1_bMm$KcYw8SqHF@P}Q zk$q8adj&2vIlQ~j&w$m@R39NmL&70|8!H$vYrlsZl&m~n<5WuhaOJrfthmRCBxIw5 z8%Cxk3X6i>`X9uT1?T50CpB5m2;9_@bkVqrjfISJoPt2r7M|n{zjoutgh$*&eWM)J zHFYit?iQSZa9kF2h3^Wus){&xYd}H=NJ4&W>+b5lteWo$OUi1B&ACrW^+e#=<3^-Z z@G7T1Gc}BhfMh{pnE+PP>uf`;`;EcOfP?ljL#$hW2;$yg$bBQ__dM57H+bn^8#n!Q zJL`iF57Jfy)~CC+3FTYqtzcqtuA<J@2qo9MbhFhD%1sf4raSa5=V$(8V6qF1V_=p& z-kBI;Kz1>48`G162DgnK-V`l%phfhRP)(b-YOuu=i_V?4GHnDZTGD8I#U!?1DG=yr z+00sEjhfaa)SA-dN9_7)UL;b`V_-@r5q%iAS<%GcXLq>KH}11B&Hy=EnTGG)quZNr z<UUzmP<k;_tSyW?nOE$0QzN1cXWk^i#vgzZo^9&YuNXx6!d&hk3iH^*vDW*O5YH@X z(svQmR+&5C3n8+pQbgCoksbO@V#wRB(g1$QzT`uY&t8j`S(Me{?hcBW0%xb!I9r6A zfKOb?IhmRyOih6fO^r2`l?~O+RgEM;adCukXXf`-vzHeO($RElmDuGUS#&2cilhtB z@D2tn1Rtd>hBhR!okUb59J<cw@Gdtvpi#%k#*~Mb&71D%ByRoV$ttcf7+5Pxcq4PL z+i;s*1vGp_4NF^b?emvgj#DY!5eBx9HUr<0$WkOB76>@WW665V{K7yxHe@y>1&ls2 zdE&*7$KS7sLKMW6;}2?l_)W8mB)m<p<Jwh8?9%y5iot3%w&Zb&`|MU!xjwJxIQPUV zVqwYV>or#kBO|h<zG^WeXIX@u-v%xl_d83weQrroNumzhdinJV<9HS362(olqXqK! z?4_IuRAEyV&5}vXW$ETTvDqL$IiILfVP9;PG@|4;Et^+{g^WRzD+2(!CgRO<!72UH z(!2u}CDUAG3oiNooa~wSARoYSU0^g(lk2H0ZKv>GjZEk;{eW0$d!FnLN@PjP1DfQB zbHT1~-Xo&QF%KhiDmUE`i3h86CB;!NPHM1Q*;~!HX|T!FdJA*@@lu=Z-IMW9Ffe*C zwX@@PGFI0DY;1m;X5ol>k@R|E#+4=UR+5&c^rT3binvpTPhM^^D7FIR_kQia$Uhk+ z+Qw+N3LWE&=nN;d0JHT~A$h!^g^U$d8%LXfoT8Gx8>3_A2^4FEb>S6jo2erDu(mU5 z5H}Zf;jQ)>j|fNRH!G0n6(}LiLDRa*5PDww`)Oj6m|d;uKgFK8{Eq2|n<^s?PFX)) z<i3QI#$zhkb4CAiehu7`t@MJzCg80$G0HGcKI@Ejp*QR7kak@J&9+T(yquL!>J>*j z%Gi`G$f2x@<*hMWGkjG}|LRS{*33XgQdLbfIj%$mT1s8*uT|dWO3viY-TBHJg@ZX2 z>#5$DNB8PHNKQH0xt7`FZj2qZ`D954)!_b7Y&SxTC8j_;$U7{_d4|D<{6IiZx&ZZ! zG!ai>P=1sErk>Jjgy5rqgk|_R1tA-HtoJ!81dVMMA^VH3Sxu>-`xp}(uLY?i*VNg* zIBmX~OHQJdou_3ISgq}!`!Dr5?-3W_m-t1rK$?Jb1XFyG>+m=`RGVkD%2EYvZRTVu zkc)6iCNy`&;K__2-6*uS-0jNE8|+k9v-IjX)1kf(S`raJU0EO2EPs3W5JCd0kj63_ ztE0MlPxpK_u_gUMh8Tu{WW{P_jWXR>T9)FsF*GMX<mf}J+D&SRcXUZa4yL9095H_R zh9zZWxn}&ZgqL=;uxEsSzb#nC809ULUHLNB+X>TdM5{Y^BRQ-ZkNadm5?pQ008|{Q zD&5kM;E`7ksrI2%MHQtmSwoC}3(Lva;18BPMr)0%*4>&|*KMd-Tg*&Vdk%xVguFr3 zN|xdd%IP81=Hj1ekf+(+rs<yJ4MgieA-hQ3d**5*v{V@1#DJ*K-cmqZz@0Zk%hdOV zCDy<;gV>+<&$Or*!n_*-c54yAR(f&uO})oB?+d>|Txk_h^>{Y3{-qJNhQ4PLKGKg6 zazIGg^5>aJ?ac#*d5onLCKS|FyE#ZT=JD^3_m=Qd_0zTs+#m2Jy|oG#^(6JZiTx{_ zHgpuNT+_}Y+`4Tx?B{LMF)OlrOU}9;1&(a}-<?^$^|)BTHvHZ>mw3iI(T!8HXFhcE zmYxh&Az2aBqU-zf;;Qc-T9=fe*Dq^aXAcB7YB|C!huwA`mazk;G_ghRM5k?~N&wQU zRFrJ0Xz}(3B<3G(omIU&7puHK{<K&7LeKhz&TeX7jQz3BUNs!(p)Ga!Cd;4s#J;d= z^hR>+qfbX^-1%GYoeZDJ4BK-`ZEa^|wQ9Be?yImD@1lBzmcgxu))tfi_v_7vWY6)? z`CzkZHZF$<&Yc@3NR^e@1hV7lYtQRBtPNy6>EA{BkJ5a;lzx9GYbCk>{1viTY6^n4 zhlAFa&!3GK<eqi4C9BGovE^(ATwgVPjUP2KEhDGeZ=;*7@PuS=;q2M(^{+)=2FF7s z(hyU0xxLgBDb%}BLi{)PToSz{hNy<uu1i{1AG>{#?9g8WUMIVnbD4lmiB|C8K77hY zE|e=InGY2KQdghuPR0}nu)iroqdMJd+_b-L3*jG&P)PyD=@PqKE;n5Z^;`GTbyHgG zUUDy#j=Pd*uwjDsmn3VJ`P2x{#Z2gaVvudVRt}MF-KM<COf#}q)4>ByB?hnDNQQ`R zaA_h~YO;%%j&ym1=e*HVwK>6MSs9qL)%vpVfZck1W}5ovc$K{X=cA)QyYIH|U|h7r zH}!7?TP(GnH3mOAyYlT~J!E8U(x~5AgWC%t$k>5we7ArP>4hN6yU2{yW!`gZYEAY+ z4LQsp_>bcjJ2TM)v*%XBU^y=n6AKFL4dj|8d&`}uYS}pKE<=EO-PlE3NZ2}NWwr!A zT(M^cP4-xkzi@=AeguyBV;l_)$g)7^e%()>bI&1kwBE)GLfDWYVyS$O;QuEN$nSv5 z0wzYFtW!J5t-Fa>_RyDmC>)EB@Qx%%rlR+ZzS4Eb&9I(LrnAr58j;KGNg^-?@3@$N z3q@r{(zo=*H0U3!$PB>w`G+qpiJJPNl#-)(movwk9!BG#^h=}d^5JReIeX4KsM$}> zUqfqN0&R$UXfSPed{5|b=jN=rx0Z9yUJa*=_Dni_oyYxQOZl{9G27Db`J*_-gY>Im zFt?`}V)U16Z_MAu9_cL1ICQ^Jj#fM5dAzbKi@H2W9!Ag_B6>}jO!Xhnvb8aCy;pup z+G)9kRb2D$Gh%ACT$6LwVg4dAT$b#l+M;MB0?C<r=6Wya_}4xBJZjD|x!ZU}QyCBl zDmj#wJ&#M4{Sc^H8oKb79{<S?QLARwnyqeM4(!dlA1J~>!O5X8jxwK1$uoB@HiD5} z_P}F)vPXJH(*m%^`Yun$!2v92?76R=pxL(gwtE&NL4AGR$hdH{3-)yM9$b+e6Yn=+ z3Xy({wF@hqYV}^=m1iOk3|^wI8HVKuwWH?XL%Q=l4eojTn@@u`*8TokA)PYV*biUK zYxKY7U{Y4iTnw8VwO%vPnSzCoUK5<*Jt5>$Eswn7wdDP+(0zcw!|7?a)e^S|#MlfR zf(ESd*gsp}By)ocW%aodM!ir`-L>f_s`m8qf;Sx;)5pOFSsu?UzNsOD%_L!ZE$P|6 zwPo@ZIUUeAGos(W?tfdn>~mWqf3$^^rw`_)1D50MPcFx&z6Di7W;z1^8kF{uW&E?R zy;*J4mvMfO!sHe+@*rci5y3Q!UaA4w*Jn-~ah^{%;7nOx^raCBvC_>akM#1$DTnba z`!mwT+~oM`6MU&Aw5vmWi^obvC!4K~t*swF!JGvw52VuV$*zQ`jlBTY$gMUK&L-gB zAi%hJHKO0Uj-?0o3w<ieUI2#mdsl@*DDI!ZYP1)oU_*OTa1Qa)GS7hVpV5KwXD?xF zBDpR<n8b!3lzU^2eFaF}JcrK4L6Rz%8Rhj1TIkA%=gXP?9fvta(~L8BIykr`J{0Mm zoNN;{z|^78ytvR5XxO*8NvYufG$7UisS>3$Hk%(r4~z#$nSxV4vS;4ko-MI*h9%b? z@!n%*)_)4g?Hu|p!j}t~8Tt{^+0sIiKN4fH!t4u>3Q2t%;vs1U9fcEe{~o(&q0wdj zLBLg?ugQx;31=<RbZa?3B5F4!5wzc1UK`aX5R!_m$e-Im=S<24nW<te&YVwK{pK>v zLw}(|*uHc%>B)T4ksd(|T15>V>*NqVfVfIi4NT|<);<I6m;AV)NnM3+teRnFgAUZB zwHs>F=iesSFTb*5Fa;ZY)Qp78sDC_H<myBl)8{ro2e`XCoX)k1r@sd6tD)kM1D#bq z-^a?>`N9}!9`TAhb+9&Y9MSLAuX}F>uF~JlcMQhQ>2&Ve_jk5(IHif+@&|AOI^ZP! zQmwe~9$3R{%mA6TcjJ4Xs_%5Sa*f6xWP75N&Q^D6G2ni($J;EsDHMJ7iC|DU$;0(t zj(O2*_wf@QgzV9^>Ag08?9%TpgK{3KxZ2n3?0f9uj~?{?HtUcvO%#ER^+MyO%LeID zVy{UPe;fYCH`rSIKm}S}q}ny-#U(@KMMw!qBpzOqTnAJ_Jgn8jSm%G7qOK*rKKI9= zSq)|?!{N4)S_dtj(CBHfEm2KBO%$w4P~#udJ<VogNXxdG##vszW&RP~pBYi17tpV0 z#+IF|99J7rJ-Y26SP8FR-GN)W4QH?^*sm6w>2xQsIIMiGC{4qz3nV5Yd#`LwawoS? zZ&eb#Qa=&5hNtcN)fo>|(M^OJT0a;J@kP|PyTfI2d)tuWC41bZJ=1OFX<kb6o&TP8 z`T;GtEH&QH<Z^_~$|e)?P{HFQP!n5I-;xs*9B4ntUgTN>P@2Mpd5lS53PVE0+_`=8 zrmWst&W#Cvu8(d*G|&CCdA2+_%Dcln`Stj@2X;4t>kw&Ajs7=KRZzE|%DAZt4e>7m zf`~P?y+CHrC`#9WKV^0NMfUSj1DAl@qCq8Ve$O%!oDO#0D)vL(+HXa?SeJM8p$BZl z{rtm|mQ2NlBmS3>z3Nzy(~E0|<3IQftaNE^JJo^1)s3PF87gPxcPIMC+ck&0US*!A zd8br^*Cy1cKKc1`Vww(Owi*Bytb_e|l?KW$*_{F7t4X<r;3!L;kC!>K5_$&<ev6zk z>tD$Wx{dG$64<I*ax~lfJYN>q6^-lnjPk~}iBxGZ(8BPiiY!H8G9^W*09Vj5Md?(b z+||T5`sO!5t~~fH+H!#7ia|72R3;<sX!3mGt62s5+uB)6QTF0j7VYc{3cUCXApVrm zVC@gaK*(!*(#k=Fp^5Tj_H}}0z*eNWU20>R)0U|X`%(QlBwlx{kO9i|Ow)>ra%vr| zO1(yVQ&(=q!dZ4>)xqv6bni~fMZxp;{t~N;Q`v2^-rL?UYe{sW*4=OiZ0Y^i<&uSV zfQc4jkcC5PJ)QCf#8mymhta59_dC#q^DTT=pN&Z1v}V97b(F&RvCXO1bUQMO3cQ^S ze}qZjoTk5%WPJV~c1ITu2Irl3&-Rnv;8Q7E^lZq#<zzKg77uj2A-RKi7xOH8?3;`1 zT8!tC+s!LyS!1_VAyww8UD%Y(hMKD&RpMw;)vr`hI0Pzk{>jV22~|gtmT{E<Y*Mg~ z(3n&5znPSoFIu(wz{WXQHzh&ORx1gw+Ulcp%qq1GRH@nLR+rE6H#!bmc*gTN&x{OA zy8ZE{-E=PchNXi4)%cg@@0I<wNcraWxstLW)})U2MJjY*ha|C5RljXXD+vl~#*C*f z>CApH#<69fY=p9iz7K&O`1oAyBcAKNWL7H5k^UYQQ^Xg_qwid{7ISV*Uf&K+cZU~C zfz~D=!*nBw%7uy~9l_WWudn`o+EPiUBT1Q@1zTV;%*q%&-~P9>2;;jDLvUvFXe`=s zJIFm=`u91fx=E8VQ_taNBJ~ioRrws_YC!cmtNcXd>I{dlLqPj?SD;o@>}CN?LuLQA z<BnNjkpi-HYK=7=Q5k`IHeCX$cy3PaV9AlHqzf(Slz-*cfbd+_)1eKwAa4&6YTPd4 z9v+o4`5SUlbQ5%%FWKUAv}_nPG`K<(yQuyT?xF%USp8mGNnzG=M^ueGk!*V0BI59? zG=0Q%s%Ji6alqa(x5}h{Qlzn#J29uV;FN$<gc^l!iSC|cbEZBf@H=Yul889Sp<#Z7 zmAVrwZ8nraG#d+Nlu3+=oK>Ebl}jMe`u^52S5hXV!Ko67*U;u3d|H-*_?{$3VeCoV zy)tX^QedM@?dSBXwt5_Y4Qax6!f792<5e-%E|oIXX%xgiPi$6jw?oet*yELwMPVQp zZaL#)f@!D$-gkL2owu`+XPSi3q_~KI<MzL`p_su#Ut|3|AcffbCPwmY^!S&Pi|MUP z^6Ut4j0RJ!+}^<2@^t=*{7(UDmJ1bM2}&t&mL9I}z`XK+&;9Me%U(_gedwq`<iRMp z(YA6%rO#$WjchVI^OTrTfmWK!VsuiA3{K*{NEH+>U{T)LPZ76S@DuBltocOl?_3%U zajQa*1I=TL=fgw`c>RJb=zXxEhRK^Jf{n=d@`uR{6WqylxIPpSXdKw$A!sX~`Fym< z+@UU1NkHekf4J+R_>3Kr#xv=FNFS}F?iEJ~4JE-ZYOG6kgi*|Y(j*B1wrX!cWwtyu zg@!_Ux7FJ9q-@z-p@=Y1YZ@yfzYlRVFQOdWj4$>Xh-0g5p`Y@0%*S@j9E`PM*md|0 ze2OvXoF)wNb~xVc7F4W-lpXHsZetr%3fN10;Wti#v3~c(pHfY*pfsPQTUJSE2szh_ z1^nVmCk=@*Cz3h;i4OxO2A0D5{V(FXYDHDS@W-~BVeSzd$S<il%3`!~k<$7aosTlh zboWH-sX!H)NJ(VsDH!|%1;dfEd9<8h&mc5*!C7IZ0w~o?Qz-94m^RF<IkDFZ#=6eI z(e$PID6$ar9Ht^ww-B@^M~r0N#E^FoEU4I(5D|eZ318RIKs4w7rWsCGd$i*YS7tsQ zT3~a%MejoZqQ?oIIQO@GpY}@N;*H7MXi^h&Duw}Cx3(YkBf?@~w;v@Hy6r2EW({nJ zf_6-I)A;JvLCp`zWicALL3|drFI}jO$l|}-mzzJIw=*3wv<r63oK9<D{U~W?sTh|s z)ADPqLna*1!w@t3C|5+DZQ0KI>bYT*Ox|Q4t4Efuk{LcG9LPH56$0{?ET6K0DInKB z%NCkQiJY)?Q=qUM_HegcVzF$Kzug%@Y3M$zXSBiwNHJ%%RO@T~6qkH%m>T*%5Fqs+ zGNY&Q`7BQBFp4+F{A7NBP)3c~5UW{tK-1K_Z>JZ{E1Ii})lFz9r~H|EC?>&lZ|RtD zQ9r+JR<$8a?(?R|WmY(DF%!$Vf0Q+QgAVpy1);o?CMyxWldhDMC`$elVrXNg5%szE zcgOd=>R70)=oHqB`_)$ZpN04O`~{Qt!q6nlF+3R=bBc(372Mf|sA66nnzop+P`NE! zI8KP#q|kE-iynr{t9jdSxu%5`^6nT#s71SH?ub`fzYw&)ku3^aij3J+jpph=3g25- zF(bY9ZR{7dTr5ZwMq!$;b``7S5KwuYz}^x}$9aEo{}4J5>ZnYdWphc#33S_x9+Ifd z%ommw<4Gr-Sg02&%7xUQ-%D1G8-7p}kx_I5*U$XTn&e(X4FuGIEVH|}n=$m(Vyxhv zC5KBW6^a{g#zVDJF}Qu9Ql*==9Gi;NI+Q0QrP&t${5VJ?W6#401?VcAq_n0F@u3q< zIV#JA;yGE7@lGCbMk;2}`$9RZWAcXz$xEr`ibtZPaeg_~+i0((RPAq2dp|7roUisF za=T^s4O+4B0-2)4CEw3iP<61{V3n=Qnm|x{pCwq*SXp}p&9&Os+|#0&*M0`z!>WMU zw?irlXp?v<wh9~RXK&TS4m|pYMK2SAW%2x_^7pP$O)%F-^f!{i%D76@MWT<3QnBZa zFKnY<4%0x5xp`!ObTL7bz@{`$F}L?i@oUF5iE8%+1{&JqEtV=t%vl85(WSGR`%bPg zv__?kK^$4o>|6Ck6lKXZHs#)(+VZr+?hNPCx;#_t@9bjkvt4ntyg+QU9X89LB7RM} z9c{eQp)E@wlyHfe)&`D3dWyS=i-7gjzh-eqBh5mU5daPKtH-{;_m*vM>DWlmHwdNk zKc>DJKX2k1X6TuM(mq&VjQv*U=N6vkie>5kN~j#vG!URw>`J-}=NHf6)Y=KD{TeJU zPgkpax!oBw&&Q@b`;pjGoulGJ<s4FT`1c*3Oei0h(32$B8AuqPl@8_4oVAt}XeTK< zezvZ;Us=hs98Xpmz^!2vvmLa0IIp%)n6rg^I!bBKYH4oXDetGv7paZ&%Kk~1yDyDC zVN|KFK}%5+3`=GbVx`2bG8Zaa2&Yfy%glDWhnre(i2o`^#w@E|t^*qLr`B8ZoKF@e zKh5}%nYg(19?@>ptAH`}8?@!NW?w<gKhfAgs@bcupO;EObJ~xeXZn7YttyaN@F@;W zb%EOt+%Mq2a@$}tg0;`PI<|(-*UD<tWGVPYv(F9dOR}4fudc1M!1cl3GmW2tg093P zt$$r4^k{`R9o64jgsJ>;mrb9~rv(};=_?mp<xL4)x3ZW1V76Sw{sSiTIio`pnHPV) z+~`IyRb+gYTghm(^4rm749|MaKq#?So)BZf>qbfJB@mh_FiIrYZZtsCWzRT8G6jzN zQWHv4Zoq#rJf)9MH7RPZ031HgbW7m3Y>QH|6iyxWRNM<7hpE(uYnZZUrPG`(S$>eV z%}RX&s0F?Dw25xw2hG;%)k-`^X@2wND3-2WsY`gzohi{xKVXGj;fai>SeB47BrOm! zwI|4?7t>o-3m<O&Y{9#K@WWU68EhxoZcV(4=~h!HIaGHac{;Z@H_El@!jaxpZI0`G zj_^jx%AI+KcJO0K1``(fq{`gpO|&R&JW4l(|H~bZ;eRR5x?jC;R{ey&07s!fX^~rq zc;CbMui!Ah-G)-)FVKLdb5V{l`Gry-oLVItmT%JN^|L>qK@oKb5$gJ<U^PzWsfgYR zOz*u$`R=O*Z?!|d>N1@roG?GU$)(Gr+f|SOcD;Rtx8lC++nLKziu?n{xZ9wE7pkm> zA%CV1dHrQoLz&z7C~eXWFQHJIXssh<5g4fqDJfVJr_)j^P8;<Me3)yt1y!(XoL`JL zZFss`i&^!?kFib3%2eJ0n!QSKLLMQ@wZzlz75?!55{o2r(h1wmoQA%orpqf<hO!R8 zCj~Ilg$vx74b>}I$!V#{FYp4$LLtgFZ0#e)%5CA@_XlBhgPSW#=uL&t5>Ok!{jzLw z3#l(>@J0d~YT0&zT)CQ=_wy-K)EJ<BR~T+WHyAdM56&@o<s6Aj!E4X|Za>7*LAvjM zP-S$6BmLc)P$(Oz^oGm(^xs|NO#9J+&OESc4`~Mr*=jbkGaR-n^0bcu<c7=~!)|R* z<tS1^i~<4NM6f96=ZNet`hUOMfrYn&@V~qM|1W_vLDQFaQf{dK)Ll0cep$mlrK+l; zGF4OKvP>p^gZQthawOb&x>FOA%{jc{`x*LwnH8Z`n;M;^E%m(OUz><k@W1d9%SV9D z;Bpxrj^KM4h~OpOC>?V^@s~ZxOu>0(-^Cf;E*pc2T0P3fz~#=4c@Lz2tx<yb`voy& z#H%Llqe%?2ZRPeWRxR-V8iNG!x9RtHwY^YXGAJA6&#uC2ukHWYGaRy227J{Lmt$3@ z#fBTb&FKd0Dgo3Ik+G6M15+PRCe8fNa-@7~ujl@mXdmWW*-Y>EUX{VhFh})2Y&vxR zma!9@$7Gx(VnwR}CZb0&ATDj<zxXGHq!D<gPz_?<QCghg;!Z7&h?YV2u0$HZKY6fZ z9t8I)l|`ST{<4)!rro}_YLWj(pFh$;GpfEz6j9%|D`~xs8SUjwd{~wX^&EvCBQ@Pb z1-&1fQF@uS&#hWMK2f+fzV;=rN-=&Uyi=&FDa?slT?()3;+k#wX~QVS?)RRLNgjP> z&~OPECkAd8;0#MK-R3mx$sKW#bZ~fH8zEU)_#nir7k#nh*7k7oNVfS5(^4<uRm1OV zYDrVBSo}tJ!tXM{Q4+9`PhO9U3?0cRf^;AkU@smnAi)gB3+0gkCK|(c9$J4EuqasS zL218fUGr0>Q(<#j!se9V_Rz9LhPL7MOUv!(_vD6d-MA;)cs#YyLEG@4ZSuc<7;uVo zIpi)JCH-Mr#*1!-RZ}UDwrRM0L3zO#FIETX@vc!}=Gu_Y-ZrPw&tUQ~6Y8#jts83$ zHsGmS|DqGxd2z|M{0b)57{I!{$wYOO@y@}X&zeH)h~WqJZ=Jimq~r-HK{lu7VD+b7 zJka$eu_z$tNM#9DSs9TMy-Q1*$**8ai}o)^kqOE2tNA!e@kihzrbKh|Ap4Usl7~3{ zf{vqw@%xHs51T4b6A7C%yahTE@oA(lbYxhTAKNU&AH#&{kbz&d*T{*!Y5!~Eaq2lz zmsiMV9Vk1mVC?k%gfc58FE}p7*WI#AK??$|*YEuIq~D;EMpXJyCa@dGmIE9On#*gi zDW9Zd2-Wv^HdNp4q1=iYwSrPR9=C4EHl$Ay#%y8W5b486n!5O*D6Y@a$ulxNJ@0|} z1nfzFoZ4uhHuj6JYdip5KjdT5e=RpAe6x?l;OKVK@VgF+lBKyFx1Uo)c%vzf>Da1; zPkXuzCS%GNt!*qv)oc_=%%m1|-maIQyVv;Cn+eX&*p`K#<Vy*aQ*bOLOX{<Cyy8`w z{ygB^&#uYk8AC>Y^&iu_8U1$+Dwe{dD9<9VLC@-(>z=g#$Z|}WJ|3or6Tdv0WK{1% zhxgNy{);aUwyau$o_s+XYOz=}a;D}P2j1u%VR}+kiC+IT*bh213d27SF!w-GV}RR@ z_UMk=FU}8@_><e3wL>K?9wj*5N;AP!fWQB}w`4zdvx4_Oiq3)hN(!kFvh<dL110y2 zvac5KSSwchKNd1(Scz~;=^k9;f<?=cj21b>dLGjj6{f2?)yI+u>-7v~4P#G4==;~0 zIMX&CUmUiLuCy%;1)!81#<^uKbVGIVv}ONS7ZoFC=yIu(i#{f#-F1VtqvJtp&tZ;W z7<rfk<s~S~-?`vrW6$oC-Yoh!6dc!J>9-6MRF6CI4I}6-F174aQ_vfW7vcSv2}DqM zf>joF(J<S2ja*9Y=9+Ay`D7O8^$%-MtNA8K7y7WciI4eTc8i8w%HigcZ1WV!B>+(C z0a8O=m@RB_Z#TD%=~KbDK|wD4ykON*owl%vkMJ}y5c(7eIqc~;!*1*aRBY%JC{}+S z)Q&DKZA!{*EG=j6iDd>ZpWtvT0FN39CG7slR<@83?j5J88kY#yjRm3qhJ;uuNZaw! zklT{>OMGrj54#^&PiG=#uyww*`>}C+Mkp^X-qX<F=5`MZL~y$_F#tL(mGTbZogu*p zVtUoW;OZrb0opAu)@YpN-Vt->K7^w-GH?l{dKAZfvQ0gx)EpGUN5X4<mlyAGBM6l` z*w!_!R0e-WZkm9`7J?^a<A5Se3Kl7(t*v45wr_XnN5nUx!<*548G#3={7au^l84PC z?>DkAar^3Fmt(F&*Lm$(lu<zKb-<H;L_4P8h6SDr`nHu>r>wB%wWZ<rmoe7&p0F*8 z!+7phgHBLYc_w%Y@4m^c8fZ=3*wW<E0#z0PtQl!1mI7z)r*v0&s>Sa8j265V<JLAb zz;(gy{ia09s9R?e&Ptb^F3<b*GAygkLdQKJFLay{VD6_jU*b>)S+}ur$5M~>Curk~ z|4a&)i$d>K$#-sZ*UfIEaMSVs528Tl1ZB<!PN=ZueOd0ZvXg+XY#L-I`5OiMDv<}Z z_meMBD8+U`2k8LNd+40{Pke|&o$-sBLT3HzLh0r-E7PV|MDw@v9wx8@uoP4%ET$!I zV9kA^&r2S@BlzwLxMwuKcwk#jeDY)<%!(^g1TiDjc|W=JZKu=E3A%mUxwUFxhTSHU zv4^%7f@1~8%hjAWks6NS9warEZBA2hVG1An3bl-wT&%fxC3BbYPx$sLq3f%or}G|L zPis%WAkqle|3cdw(m|8)&C*Lg(2=)w(1i#_w*)k@rEv9ALz=?_6G;={Qj_*Cty)f> zFp|_mtKwz6ys1WgD<zAFGtNbTYB_Y#Cx=;G+4D)Q2o;QBs2abO52T~B5N7~*whX#h z!)6VF^6UJI30eB4UnafFol#K89=r`j&(kNHz-nQb!R@DJDeRP?leftysh2yuVq3;~ zk_6O$_R&F>F(TD74^SBSo8&+zLk8CLW`QhW0T6a>Xa|KaZhyeMp**mrw)Q#?hH0+L zP?`v#hnkfIfcg1(4@DS!G;KjeSC-kyrmhrnuxBR=^VwrBs8MnU0_Oby8c&C$%>mFA zUIS~8fHlG}^4-y(R1kqIF+r9=Fe|^rg<`==Q?Rrtm;$DcB@?K!QK4s}nVs>lT+lUQ z6nSgUM+>^PU<mN(stgfy36tmlV@g!0oZ%odl#m$=SPpjd5gHx<Bl^iB`ckkX)241H zo$8<d#{@zGgD?IE3Ga~2|CjD^a#dgdn*-hepQQg~cB~2d|4CnFhVlPG3>+)U|6s>} zy5Rr3w2u+i-0kI2<L!%NQtnUYnYtkyuVFs$v=G+Z$xndYll{1(LZ_mJY<vT*@;r$O zMkll&da3d23rwL$A7PY?#3R&vKZSw)($iX*z}KG8NJID}Y*e5#bj067-phBOeQ0-a z{=Z|Pr=Oqxodho#n1ZXm3X(mYC^vPF=$kzMS3tQ&WOfd{_=mv9L_#5{aQ`Wtcmn|3 zDAX)tum7JGf+^!aG(hXX|BV0NRoefR1kOOFj5dpIeunF#r5cP;<Z%DW<q`co`hd=* z2B$q6a;hyGb$p4{e<g=0*vS-Z^aN+(`Ot3A8x1hShk|%!=M>bD{*~8)A*Dhgz$c7h zBILXG*n7|sk9h^MBm`L|!VE0ov&wH1y-+k>%+bYbKVsmS!jFDh$g+2f!`{@r2`m21 z-mGWguXL{mUX}ABeyQ!D?B%h(N5eLa2ro(h)5BV^%3kgWL#U^Jg4u+WaXf%dC?+Z? zx03<wsDv+0EXe7BDjumx;vrwfeBqjq<m2j_&wi&0cazNSA@>@$0o?rEOp-JYeD`O` z1Y4;lk0g|Vr}M+k>-_f^27TVG+nLMWXY<^*JF#~%wb$cPDerlUTD=>b#KI32hik2Q zg{~Hlh9M?VOSGEn5)RRjbG-<`Z-!FQ>MjnCiSxacFfnQ~5p*&<lcIq<PGEU?T`PEQ z<jWPe_A_4JivwR$n&BR)k>llWG(L(47Rz(czA52`Qg#+{s9b+ksyOzjzJqP!SR^;h z_#G+z7t=Rx0>zUfHGC@Z@Lm4f`%5bBKk2}t+vBSx$)xdq*_PL*TVm0AAujRueP}Qk zGBh>=uMKpL=_kN}r_wE{&l6Z~OaK_%lT$}smPcMLPWLi^<ys3I2Lu=F?8&<r3MUqX zmG6Gm_m;^Mc1NMWix?+tMx7$XrElGm3WOKoGRA&;jKBuRcV!NUM0+VS=eTY9M;2ly zG3W0XD8-x}r#yR4_Ge4E8|2vmlgdURH8{BWwDt^^a(6wJfGt6VhR)lXBYEFA|0j@q zqV7|O7Di6X(Qo~8#zJQDPV6TBFNUVOi=P&!g2>;=lcu;-;vN<2(=*qo;dU&2#GFhF zzXd2rH9G7K*+k!P$KIW_>O9y7o-(+t7otgOUH;i&)M|^Rr&H(8%68zUt2DwL@f!19 zXXzDa(B7UsvSv<a$;JovtB(Tv(j3`c=#5qO1Ik+^+7FEDVIakb3)+7H4TPAoNR-r+ zzsJmLs^iPMa49jJQ1h&_s!<(++oN8USfK-oDcZ5)onMvx!Z_s(h;N#5N%4vf<p8A` zB8u&d0QG%7G0&}-iq~W<(YJ1V-9w=1KA?PUnAplTf>!?)(j`aK%aQ8Lt?}1rC5Jew z(MI(XUZ%eNLs<yFwyQ0w*GBOzwDto$rs17&9yy&Z9@E?Kcd`{*i5exbJU#3LGLDdO z#iMAN%vd+gm9JlEXNTqYN`d#Pf;Z(QE;{js^lT}p5`MD@6DOWu)*(~FXG}1-)<!Oq z<ljLHwiO$j+*zLFPViY2Yd#-m%*2%t-Py3H<?!FEVy|CRLnwJg_)=Y~#&s{MH6cl@ z<l=ti`74@;ho;klhwpMo^qC{HLo}?1bB)v_^)C%`masq5ILYOIA}KtW)hPK+R{-i> zjgR#9-RY)T6Q|B4PR%cf_8cH46Rb=-9AJ$_UNQ7jr1e|u*=>oG;=+Of3L{+c*z!c- zE5|^Ue7D5xD{Dn_IjiwM(xR%?3#$Ws?lJSy(96K37{8NLW5XA{{{)|0%KOi<H78d1 z2`Zwv?#QdFDLqIx>QG$yKF^jsO?=@$5p8S@=Ayn_n^eQNX8+N`n0I_><Gi3(DSY#G zAul+Ga$8kYJY1&M0uAo&ve8ODzOFf^5rvA3<~7inWR!Li$;m}*%qbefJrCTMDzz7P z#N&P)vgvyy*|iBA+J{Lgg->DKCAKhY)-k4GFsW08P^GHZI$G?Tq&_FGCRk)+`M1RT zD_@f0!WUy6h|1F04Jw!0LxXEr%DLF(Dxbx#$E#+Rvttz&IC!4NsFfsDcUQk@4Zx5I zpg-Tp>|`KUup&iw|0;SUp5$HsV+loBwxc>-=Blwf%jlzrjAEEZ3TU+6#0Ia?t|vMJ zUj%2(?CjCY!55J+HMnCp_FJPC9d1((au#_=r=M(wdHjjg7CnVdfhc2eu$j{IF45u_ zIJ&e))zOzV!me^th=6%&Yd4;UcW<Nj8?=JvKzZk1El9l3C@i(&Z%&kkrcVA^PZ0*Q zgn;?vjaEoKk($NeWX42c>)~~$%hGIUZv~4vX)V6kfI&e_ci<GEHrI`-{s$AZsT1r@ zdypk4?$d6eHEUMxy6Bq)L0Z1`Q;ji;b6wLmWn(|u5}&wVkHuH|<}Th_x%jXB6eP3w z5C~&SuHydDvwLz1u>R;bj)x&QBdw6;xF-eMXK<wvuZHV5RsPW>%(H2JlM+@g*{o{5 zqbXWy!tV)SjhYY3zUj~V+VSe$SI09DkYm4c*UU0r&h(o0Epx%LS_0SWORLY)Tm#ZT z2{%0|WO_x&X=;5ZY2tf<W%PCfc(;uW5&R}ujKYdA#~AG^L<#4`GGQmD1C2Ya>Jh=Q zJPhZUSQCllzmycr-Rq91W_HoPzbeAQ?o=TG{`9F2C2fTI)9fNgQL7_r3aTBU43}~s z>)V^ldMQIB|2*Twi8notNuW%<lTWX7%Spufyc2Vj4}?i1eUIkisvP3fNw`t1@x*;w z2y?9Qnq(vTF^~*2O76yc-eJPzKm^(sj8;jeQjN2ZBI+i^U?CnbLUm&NwNVdUQOdDG zGritnY&0G(EnePG%-#ub$ez#zP2z>eJp2`lA$;d#goQ_TPI%+5vLi$|t19r*WUv(W ztV67=nW!x&dl>K+J<ZMB45z+)$7&8Zk7H2n8=%86shY7BBeSB-Oq39XF0bgsAy!7K zEK*l*{yI-BKvT4E^Fwq{zeA&)QbK_wURj}lr&mUi%fg#F9q3I*8v5*!v%XdI7S*dm zMjfp=&Lx+mKg-l|w?WI)Ux6V-XLfwe612*D!YlXJHbFg)Da8ZG%@3Cs*y8$glpZf$ z+TP~9lMGsuNbJ#HR0qrU)-C2pce1mC_S^r`v9XLCPm&-X52xPsR|b`|qq<f}pRU*W z9k$YRs6%tHl6b}Qmphs2-+ynZIB`uyQ##HC9trI>R+c@8HQ{B+dDpn8S>Ka}2UeT- zc^W>OmPmgPRb?Q_7rJ%*8WI#>_47ss6N<S!E(=>W(KcA2CSb}h>gO@;SM#Z%kix4? z(GV@yG4s>)qOrNpK1Mx8u|``EwP|;%AC62!dpa*svKWFkus|ns;!K!kd^>+wDJId0 z{G-yCO;6*gk(muv*yGwl_c%Rh`x{<RS%g3_XDk*$U^kVc*H}w}Y06n70li!2T>0|| z3UOvp=PtRwvp~)BR_8e-4~Ohd1|H==hxH;RB{NBe>;j-+=zsL!BjldqsN@)C1~QwV z?C9c>8jeOrJCa%cawY{*J<?8+;B^CV_qw#2c2W?h0M1emxcM!#D6_7#PG+U1t7>P? zG*-QS6^S7%C<S6@vot-rfcn<&g<Loak=$0u$i)hiV+u-%_|(0&YHgXu@>Y}afzB(v zUv$c79j+^JH<qD3a6K6|haoR<PxL$|dph~N9w>yvZX-p{or`28alMyVU*d@Vu)5ot zz^2)pen;_Y=R-TOm^kp_Y}{sQ<?f96!DHwOu-CF>*Z*)BZbMT4Bxd`igks55HS>kQ zKBL%>_P?HHE+wqGvcvE?Cp*DFJt9u4*3u&=voreX_Ng}V8mL6(S!kSm^Ndq58@B(3 zfrjO2@3$H5`RPq&BDxw)?>f)x|LzU-HNLhJOv<5$+r`dG-1A@wkBXE1!7G4;Vp&9r z*mSG>@3ix_cb61^KI}N*J@)o^Vi5h`L!R8o)0Ps4)rW1e%Pqf!6U(lrh;hd-U)flC zqZ&bU{d%aOu?{cVJ7uzqlag?4^`o;^$)#I03!DrzS(A``N=5vSfhrx(UG&n1f4E=d z8L`uNv9G*@2rlX$920MWCCWCp*pUBo$<~zy;;J*GFS}gd%4GZamXCHK{^RNX;41+1 zf0&)}xDeg160lXzxS|{!B^(yEaX;8h;K2X8v<p2u^Z!?f!Ls*%)f()4>tCe>I|ci< zA@={O>qa{TIU)`0A~kG@zqf$}H)3Elp!OfKP*&LQwkrtGK8eK8L<mHm_?%z+3P2+$ zx#|AS!p|3l>7`fQA2bEO*a3EEv5J6W2=C#&f|3L6&!|@tRSx!pz7S%wT?F>v5xR{_ zpc#q#r_&#WpHxD;Uel+X($-eM`0Lq0N+`v~DWM0ezc0!d=M6bZd4l+L&j#ovI)nJu zjFpP>W{x9+7K>tOd*X{R&h+B3nZ%f}>p7lkbOapen=bGf_Xi|)SkkHFT7D@Aa=q~6 zPH&?$ifNps&|Loz?--n(vHBq%YcO{>Wdz^$ofH?vXSriu90jK9L^b~owJ{R@uEr82 zJemaIZ6`i4*t<BsSllxEA<{%FFoV;MA_F4}Pl3Y5whF<qlBf6@NKI=Z4O!0Tzm`&B zdutEIU-dmkhDGk!_bzdXUlE}o(gYC)aMR}-NQklUrGJSc{zkR&aZK+z3VjSoM?f3t zOih8nfP>yfI1;^wqvYqcngU=sVyz;D?)~_t!fAvh#})Dmn(tCNVOteA3?5xu$URus z;CoI1$uO*r*Bxnrr5#6(k%b@cR(I&uNev5ey%G1WqO(z$ut8KvJdXz6GVy6r%e9`@ zxrE^iJ=eI!7LUu*36ZIhM(bnKG594X*kYCIns*;As>gAb$BcUI?ROd(DU(UXukS4Q z8pMZsUN3*1s`9?rm|lJq&!*__$R%#M-7Fp+IxG(l!Qx8{l`3jt9CqFiMkMijBl!RM z%doBPs&jhT<FO-G>P}JA@LRp(PWMsE{mtp=!z9D|tjC8y;=(UXlnGvU4~^x+C+wVz zUJt-WJSufc2G3iHU+yXlC$b~a%=SCU!<kvfS9kaqtA<F|)=a6Yb>iL>TPxi*U4;GG zchL%D{e7=Z2>P_w3w%<NZ5|Lf(Kb-<=+%wAczk=ubbB4I@Pf^^9H38}y{=Hri4ukj z+?Xgtzel8U()ifC-#)$yE}|M=qwAqX;C4_z#6&fOzAeTHF%fxLKwX;8#6%`|1*O0Z z3#YXM+3#}@aYiXulO`#}$9*@TU?9af)e%@nkA}qP!_6iGVZ39<<%lXWVSH@YJEB{( zN(?6DB-o2&Ha?ypsY6R0Vb8Q(sUg@~X6%Odn4u3u&J*Jw<;`=18PGhP_f{`^M0+N# z-_kNuvno(yr%tc1Jl}~tQ~5a!eUS{_vfvsn!^vEjV^8jt^t%@OPkp(bMPJEK#%RFq zTP)9M5~d3OkM`a=D6Z&P1B?L)1W5>kLkJe!A-H>h;O_43mIMn-a0?z>1{>T75Zv7% z36{YLFgWZTNPh2Cz1rHXt=j!#>+v6V?m4$__t!`Ibbt2&zz@@XYPg+vDkl|M#b4hk zOb^5J3IF}7^$PH3AXzbh6q*_p@&4$|CrZ=U8;v$x4H+r(I=a_DyV=zcXe#x~G-IwN zgzxnZbvdQKcZoROy&S`$Nn4<f5$s?U;aT-x;jd?Xvoz07@I#U}pkuL_Jm-n#OIClM zBz1dWXy8Z~i%?UK3qLtcGcUKTSHsv(i3%cPQ~s7{-uv|Qygew|zgDW)*>}&wp{}xm z)#j5|Qv)se;!41AJo;abnb@~c=n>uZJcLZR_<g+rkVGbZ&-gQF>Zd;v^5=V{+YLbJ z`0*s%aofOkXC~K8-A(6XlsMVp+qTm(c9N1U(}gZFzZzz}(m$sw=ke5}(E@@OiQ!js zkyj9PeGLoP=|THVl+~JtD_Y_Bi70Y`w&SP9>Ian!*d-?^Qn99Feo-B4yAP29(k3U< zngi0RGetuVoM`OR7n-uV91nM|1s^l8QG3xV?5`~Fjg~wygC2C#U2S0YLv3^j_;DIj z@Ydln^ZaFP0JBOmqZghmSXUz1p7is@hmVW#w)y8fh7BZ4(=Zra{hx3hahFif>~5A4 zxPhPVTJJSBaRrs2&6_QW8rkmO(l;d>6oDO6vokA4jMH-(mC*jVlyRfP=ym-Af^nl* zNF7<C`N|s4)kXuY!2JWtbyEJ%D5nPplZ(!}!}E2MjlzFcf~XQ*WZaGxODC9?%eKi> z&6y@A;k3_1HI|lAL5-i;_uLKJUe~AxRG`qcNp5{k+=>sU3EbjZ+|RlPo(%AMUq6H5 zB(_0dy%dM;(O7!v;dIs)gJGl~xvah@b@|63*Ov8$nPd6bl|oB%{jSHGQhw0qSHwm+ zwwZkz_16ws{y!wlNN=ztD^yqtXwv(iOoG~xX$2D!M`N#fdoQ<kW#-9|V3%74t`j=j zN+;`8Gp0FbQul#A(zN8}MdBTu(!NZTW&Fr@aKa50c~jfD`2>});8H_RLVMe>Y1gxL zPN27e#2nQvSU`}D-rZgvQ1_4>^gy8WDT@|^+h-jsp##=BF$*Yu*O#N^KhF08!Y6;H z1*|lu9Ra1*bk=x3NphU}p{vc@3~n@tO)zPvms6uV#1+}*vkv^nsO#lxAYvWN63D5c zuZhdVzoe}ju7FNdGTUDPakPUwn6CY}g8i_tHf=6}pvW#E4D=ik4p-d%-e0*gIn~yI zSN|41Yi_Qh=tO+dee5uOIfy;zyS5Hy#*kj@PmlG=rU?%NDWvxlsqbn@ou0mQcmBNs zZuA15oi93=U$3C)-fTW>O+Q$_?^aS<9=z*%v$;m+#78j2cV4y;9+73_o;8fj&YL(V zJO}5GCxx|y%i!bi-cKwOJjjRmNu+cO@OC|)D@}&=^?AJ;h3#%`E*<>1YMbk0eD$it zwZEo;tKBfMnJd4O@iuQF8?X5MevwXRC+MY@!k#R^gEFI>eg@$%e>}xFFuYWtf6v~b zV_;}XWtXQPnxD3bx!JmZBG_K6^Vxu(Y_@vWc1G{`;Qm#~jRnco^kG*R);UUbZ9_c= zhLa7rBwq391l;Uvc{SS{9~_@GeFQnAQM<8wln3+5c`9EU#)cf?J<p4x>6>eTG+4%E zzq>N2Tlk*N^2Y7Yue@W=_}#?{-CHUf`y+<UeyE_h^hig44SXkfX>jx1hXEpl;-iU- zY{*1EolXoK1OtWJIGyQ(@kTrRf}dFBc$5|Ek-OQM@$j=QC|bvJB}C1zbbIDMYf|i! zr@Kryd?53#7OB-Lc71*QOw-$iv#u`NGivwI`@Tq*<w4eTzqbPfdr7Lp7KbzDy)z=R z(Twx+I|jBr?r0SQ^<4JbqQql$81pyXFE$^K<KLXxs9%pVc!2qzc$OImmQu8YD4b9K z?lU1l1Y9H6g_>Nv&2<?Uu-@=5{$m><q3BsHGH6F54??Z^4Qz!tV0Os*0GpjVnK{8u zL#x-?pGoSAi_(%WAt~oY4YjJJEgpyKgAf#TdZWIkvu;AJA1*0w=)d~{0In2uhKUw+ zz9$r|$E1VgNHwFumyP~Lo=uKhBv#k~NdbJ(q{%LXQvNv?b_t^-yA78=22%uWloKFM z2*fA@h&lMVw6wb`TvzY<rK!&qYb+o;pqaRrV~DTq((91yqV5;L`?dWaYg_)m;=6Eg zm@iqMc*|)^FHq%}NRt8uTug|A4P)jRO?^$><uKz=exDiVzeFM$0g`ht1r}8y#|u)0 z<x9tNMUEhhd42(s7wOZ@ktuOI#OVW*DZ9UDkz?SIw&bNA;sLt?>{C9u#v_K_lb8n0 zGV4arZ)K&1N3S=VYK*?Fy&Shy_51G2)&E<o>Iy@y(n*4_TR>X^aU5LYTpUqCj6I_F z$7B23U>Anl4zFm}rkcwSDz_u&twCpim}Ya3Fr~zi@in)dRpQBa+Ho1Hu=0{dj_C2C zi@uhlhz4cl!gz|K{hG>@iZd>z-7%vLG$8D8`X%RK$m-9|x%mpwVBB?CsT7Cs?^w*+ z<?iCmWJ&Ed_hw4H1)n;k99U0{d@vFJKx;xeQu2GLq*+BmP!zto-uCF~1D~ZELwyR( zi08+-trP|n?%+<&{sL?Alxk&LXgu588~7}%h($NREd(KKl<W=|?+DOM^Pj_#T-0ha z64xJ^+N&$ECnahnZ4z8qT*69OwA&ikSV%F4|1`s~5we<}YkhJsvo1$j6XPvAg07<* z4$~{+!JK+9SE>W}%@(F0HEYOqEX6GzI}M_e&F>gP-r`AZxa^hXs7gDM$nCT-+PNM# z?dnc5`b;?J?tODJguJ0IyD4Fia4#Gy)f=hZ<Csgm7D{JtOjywMwCYpn|CkU!)L}$u zI-#ia2FdE1p~+U|WTbD`Q=B;ib63;sKkvVd!oy~)&tnpsr>bij6k!9Hl-l!zdTN4F z8#(J+r725I^_cqn4d38Dyv=J>u|MuEo&<2Z+Y8bMU0Em&OqBqxgxMv#j)AbkYh+2M z4|(bq*4m9<Xl3=Wy5}pBbT}p?n|5#N3m>VfK7zmu^yPoefor#x(8jNdv`oHLd7atS z<y6YOv=ua=1A#Zy=S~RJ>?$=HH;h&=)2PeE#1c(0oT?DEpk_*aaFq#B8M3&VF&|*g zBrYjYNgIC?b>Eg17m~q%x6RpA9I$hgG#gjtw;hPDXr)KKc(gv~d-|C+bk3x%j6X&G z@i76FPu1H@CsoPhPK;rQq<@_uV-jK~^{az>Nq0P{3?PX@_kQjpNho&yv96in!q2@q z8KD1&SF<nR$=YRjWF9u#Zc(Xwq6jk#z#sT2{u48m$o8J{{Y3v7_K}w9I#P6Uh1@si zqLOh9dNw^0^TH7|GiLZKuDGKyx#m@l+iYf^Mk3UwwFS;uHPA>K@QTZ7bcl${)|Ru= z?CqBpLKNmPDHLwbjBi5u>u_l4<*8sy^Xj7S8fdP#Y`Ow{keE<o>k%hR0-skH((utb zK6mgtjxF|`yx9)3vv)P+AFNjN3?}-b5ug+Ia&7`EE06fvoVKQDcZIV9+4(Ya@GVqO z(V(&T9Rsq(vh_k_aCE*Bk>J%=(U`f%6+5@C8;Fx^I^nCf&%oKM#t+A56SJ`X*;|Y( zc|A<pV^DoOrDpV<#_gyVCTB&@&!T(04ii|w5eu{3mYZYQbZf7h9ATJY(zn0QAndx# z^A=RPJDh1Hjf9vB+>S8u#Wq}sZ0*z1OQ|z9M`}%Lxnj(_;@k9`vj$%1)NjR3`VRV1 zP5I7`h;W*6nIff;RqLu1fF4%uaaiee^e8h#)L@P_Un={n6z#lhteDw^4u5gWM8BFx z;-!OlcjtG9h~9jbxNg*Ot1;q#oY@sDH8@mzZBuqsH(1{GG~8EZBz%@%R+J-azR*sg z)}WPL7KuUFcDaW4r;Ke&#=vcTvl{YNy(cTBr#8H~g&`%n{xkn3`HOK?+JKkwVPqCO z80T-Z<^=Om%QlymKRU#!#wVz5m@Ee)DLtNlltq$)3DJ`UoDd;xteN{Xq|62a{UkKq zOJvee(id62XNE88{I)PvQ4*MO0mhq^gjyA%?r{4T?A!$cBM;UWQn=uX!klLKrF%CA zR4v^&s1~OM(qBI&d`(ujo?0hlWhG}rLL6en!_lhRWKMs}_Rm+e8(v{9&bn%POh`Xg zlIE}!!0!YiId<9S_=6tQ8rg;h2}^#qE7^8>ZdO5sa&lVqHLr4g%M@1#y0jWz+6mRV zPkSYF5n1%#LDf|t%ZOTL?X%Y<pxjCzIK*w6zc*plqrIK#eb^;nm0Yz^$BeQ)s6vSa zp}H(WMGXuHy<F+)OpQ*vO{BDaI@fxZW#2#7bL>HPCLx*D#f7f=Cb3McdCk?n-iOLN zri(p~pdDSeGOXYtO4EOWsh8hQuFYDjR&nq6*obH6Vek$@e-_9MFY)JpE7&Sj!(Ubr zty+L>6Gq?GURMdNeddhttw~)pk{maJy2-Ck0ZMyjUx=@j<R^Q5V53c~5?5-{sd~kM z-2c-+saQ;y=Wd#>RXnqHafPd?)wsEHsfG9+7951^?lWFJ+(4l|uuTl38gwxDPHpx& zkFPP_&g$Z~*Y;QM<pg@0SN(jLBm!-j^)C5SZa#UDOg25n7yG{No4F@jrVAX=jYS*2 zwMtU{o||*9mV0Z#-NQm(qbXsVdwqO79!p(Qa5n)CSwXwKy?N&wL+X2{gutCc)m&w} zqFibz_on;AI5hOXS~^QDucdG@giLYjHH53I;!fm^z9eS7J=mXrLtqAF_0!eW1oprW z$8*kV#X3%8N|)K&P~{eRv89)+T#yafOcTrIQqJb^o-cx*w48PfO4cVB%H{KvH_|{_ z4$2NvGPE>H1xC3DNp(KFS;Qz4e6n`~VAX=pRb(D0UR&m?Q1x*xi4we%{}4H4&O4j1 zQU{p(_~1!SAb_G}Cos`eeX2$)-*}$hExp;(m2^Grr>vd-Z?h6sThY=lYRs`^5TX+< z$JB4^FhLUM^GLAjsyne#CHjP{h#4y4e1fopK@IOIvHmJO{3!b{<Wb{Gh*mLM(R<R5 znp7(?wrUfE?iTl_2#TC4u^a-z`c62ac#rOf1<jolJrV7gN#Y<uY5)$Q>c*7+pcKO1 z?XOB2K?hlR8sQqHefYK{7jG?b=Ps(7z9Tno0jx_07j3YMj%H$C?J3{-uWdiIWT^$a zmzruY`yJQXzyNJsFT4uNjzH9_nOdE3E3eqVja1paNMC5Ao%ciizHaYj2xGa1xL-^a z=H<+R7Za89ZN5$TC<yF7-*YW~$)$JR<(dyGq7qjhy((=le#Djajx;>j*a~eBMoVGF zy_G%l-k+1*kCJg#u1ck<cB*+!NxWkT)a+>FJoQB@FoR#}ilg0#&GfT=f2`B2sp;Bh zvk2dW&(F2e+U%~<=EghvxE8yN{F*&&N#hwud%LV<{H*k-bMcxkUrLOZ8)SxE>MXQT zqpl;?K!9rL;U4zdtzK0%EzQ#cs!`P%`24#oX$dGl$$K~!(aIJi&q+N-3GFX&!GvZf zGS|&chw&$o1C#UJ>X<5<>UO)-Y})o%-Z3)=y=W)2?@k{+*zrap!0^5hb=F5OQ-r~_ zQ6iE8if!o56rsSR1}%heofvM!vnBJxXIU~kNz5~F_?Bt}`PrTvZVql;ND2H7Ggt3W zvjdju>?Ynu+WQY=1@a@dGC|-qXXqiK@S!PO4LsTZ=E~}4gzuh(Y4aJpF1ynxUuJR} zglQ}5tA1?)x@g$}ZMJD`9e%JK$VY5KzF(Jrd_i8Er(N%(?3R>Vc;))=f=$v=<>oTF zVf(o8`Xz0aprb$Q@6E-1$!9%Hh_JE!itkk?V~8JtB?Di{>Giu-!yf`9+8cF)-uY7E zw&0M(t>2AD)Ri+kQxRvr=Zdwnl|Pio4{vE!Um<%#obc6&O^J5o`4l-hKsqO0_({#P zlhjn$b6Q)Z+;CFY6znPu)(40wP8!d~bh(g!Nz2k6FRfyxp*G~>uc!J7NpCIA&vrmH zmQa&u#I80YFfBeo9UTskV+?%?nrdF0G=Sv%jmQf;+1Z=0n+8ZP(9s|lT$u13Og0X^ zK^Q5(NpU+C00b4h)s-GTFFSr|6~A~}$Ui(T`5)$qZ&8w_mQdBy&R_+UBm94%cWfar zF`+O236G#y*;}fraCnF^e4T9>6Cka4gjoAvmwSL@K^bh1ZJz<5{%43ar~-n+LY@pH z+w&N4AWsbh)v16o#oKz0(??CiR|j_8(5qv65rPpT>DyeU|EuV@Pg`AW{TZk?a3dvU zIGPXFo{MXbOxo<xKb{Pv0FX98zYUc9I3|$}cDwy$+kmgH+fuLr8Ds!)#oe=u&)k(Q zZmwT2)UdCUu`52SJ2~Q8=E?4iIk?p<hl1*<!a+8W{ldO(4Hapekq`k>-X_utSeM!^ zHP(1O6if#CGnNN=U!*(C^TD@O{RF`LXRbY;@n{eQ4hQ&$`JZV??Ch>XGte!dxh&M+ zps?#EGLj33tisS4y&C-U3)n-1+SnwvkC&%YQZNrHfz&g^^YTeeDCYe}*&k@p<KGoq z{SiK9yqUdxF9c-wSPsk@9XD9^>`eXy$V5&NY93C|-`Nd#YC2!Kh<KDeST*0ew(Y<D zOvsrP^+Eht;#;rs=;nI!wCbSW>G2Xr@7bm3l96DOUqLOKT}Zc+PHAnVDK!`E@Fs96 zvzxk}YDL7p^O%(U>z2OvYg0!J(X)M>GOk>TkEV53?8G6hzQvUFKh?doW(T(%s;Ct> z=9~3XL{A&2U%LK*q$gVU63mXJ@xk4(ZmRhMKhi(=2R`$@RtG}IA%BJ+SoSUp*HIR5 zg<eyg3odi$@YSzD>pD-f`t3|+bY$2Kq|~?xSjRgG(~mxQv)eXB;d#ykch&yPyZw@= zt<^AXkg!JG7tW>CMDH50F}=_fP12-jSrpSj+3tCO77{OyD=T?_VNBd$2?UA%>HQj3 zwWhuuN2#=zA8)8z5kvg!@<IjWQOijz$3xJYt3zn1%Zg*Mxf1BsE^91ik5`vhEyd3$ z$*VVb?llr~Y}xF=oI`bDiO|8-@iqtR9Mb|5My~fPwf_j43)PYe`oF$W3rP&FdF4&q zo}gi7^P|T4OH9n~<_#X7I1CX^M?zkq4&QL%8L6rI!kqTEJx`oAeQ_=OO24^AhKDdn zAz!F7XsUV8%S|&3B<==)2GmARn>U6@`=)GuiZI)Qaa2!bsUS3K$)sys7na=pYLPOf zvLKP+#Ltgo?BJPGZ-Eo6UgU0-yr!OChy*DCWw8-6pI6_kLGS!jXOj%yIEq%rcv&PZ z&J<fhxpa6HmmQ~1=f2o{g<Z}fO}@8ll+zmT(cJEk!~dT8iKYm>0sXhyBBN>A{Lu62 zuaTo5SCk=fjtyJ$Bzsd=XSZH_GZ6|~%4oax@M2f$W2IGkwWe9Y1$aL1v$L@)THo(5 zlrtLB_S4gV+9)K0ArOS8U2~%JGI-0{Q8zQcY)YZguee#(4*yv}jh&#&Re1!7e7fLt z)a6ONYTWKm5;*Zd>Wf<nAo^#R?~TMm^(;umT>W~?$@%j&M@>8`WW^WDXS(skHr3Mf zQwE;JyF6Z!a$2W{2irR&&)N$m=Mm=h@%X8AGzrwG*V51w=y&&(`4tVn{o1*ixw$z9 zF<{#~AAJ`-qJpETd2_HtWI?lto*^4nD>Sv41nEpKpmOjtDl2GC<BcBl^HND%V14D$ zayFw{XN9B6M3acMtLwZ~ATo6M6kpQ<F}RsaAKk+z@py>SD}ldt9B;|#@hOXOp?v03 zv9V^gv`4m5Y-LsPrt#DfD~Qn8(#(=hO+#~+pMDTxc~z_Q4s7)>HeS&{)9#@bH{9Xz z*bHPnsak_Ob+a*pAs4MNF`WL#Jxh6zwY@v+%UFgRPW0Xf5mS>3Sf;L1|EC|*@7O97 z=o5n&$pY*3nmL8lW&3Wa27(J3zUr}%EKkci@Au(e-cyK6uY2cGOr*Cl$3y@1(>cfM z^u(tGIfJY8Q-sQE(kQ*w7>V@LF0Uau$D}ZNrN+2LD~#FaZgl+|?>s>o@?r~-(Ulsu z$Ck!6bh`V7+_Hvz&2I*JjXo?@Ipyfqs|fkNrt#ca2;Yo3B>xyV!`3H~SnzUQ=UYTn z>g_m&|7!E;^tF*Vv`oRL&09|O)2sQ^PCt)}^E1)r$gQbp9mT7ecQ2Y=$-Od%`rX7Y zo;F$173CghXn_w>qDtFmS2(!(ig)q1BrXjJHHua!b@T{q0p(1Kwgv4yU@-@y=c~TJ zrIRV5ewOyilLM04@l&_LhKKEy)F;|Fxdt($*>6!lA86{`TI<tqmICGNDQV4+ngj=r zvO=rcUyMIG%Dj@0>Fp_TIaP>n)WV0}>5GgFR#SOkR|d&Y>Ea)2;1?4{w?Q-;pYq#A z(RFK!2R!qi3D&pb(&Ow<7O>3)(}j_LqEk;7Ocr#m(BP-@?`v&SrwomYO5L*(WH{z( zl1=bQdiLR9Z+=5zr=N`hbO9gUh_v1P2-2oNj5(E})F`ww%nB;0dhFhVeZRzd@xfQ> z)wID*dzthuTY!gMOCu+Fg3-x(b=p$CFsQJ?*eRs&Z5aG%XhHTNg+aw%+oW;}gLA1X zY8*O<+j_=&+v@mEK$aEu5g_Y)QUz4@33GgctD^$OdQ-8Nnxxtx76!!9^?`qQU}Tn1 z@!OaHZ>m1U%)Y!zsyx^ekimp`s!F5z!296|9z_|Y7CmQuDWNSia)*V`z`AeBHZw-L zU$8J!8h>G;m|b`F24(p}!Lbnp1B`5>j1$wG%2%8Ios+x5rLVO#m%5wJe%%VHg>L60 zvsoWzW&t0sSRY~3d{zJK1AhnoLQB3qB|F1ZE1T0^y4q`on%l|;^N=dv=6*D>3pX_N zy@#_#A<lWHWulLCVsmvoLbQ1+kor?9XEu|aW(5X}=m__7*7|cq$(;k`dc+&?vM;CW zbt|E2QngCF<eaRN;h*V=JxW@jZ(@-St2Kz5w3KLnAfHo(q-MSqWU!`MRGu<&CV!BI z;<cTwmtbY3Rs7VjjNjM#W4vneq!j8cN0-^B`J7)W<OeIv>?p$7a0sm!%R(}}sVAQ8 zsjCx+5UK3b&#7=mTk#=~H3d3lVgl5Y)ia;cb?w|it`UnSXzMZSNx3qGzQybqri!hy zTPAsabnfBrN-@i%^?n})HHCEEgCw?iSiYodF9Z1le1X&Re$8S$UynCpeG*`X+jEE{ zvazBn@6i_Bc4-vSG|?j%JE2_&jZpwT_&8juxI5Pwl)^`BR>L)6)QJ*nt|M&odbX;n zebX7bdmzKxB4`?LJ!A516)jbmH6->WtO_UOtTj3ptp~r5bp7&6Wv5kI3T@7VO;PV& zwY_{vx89zOeewr|aAx1AN{vvYoqqX$K%twUrgb-TDbGt*4>=O4_5Ph_Fu1E~so=rI z0O~+)o^wV3R$J{|YqENCZw?4T7u4OySAn5)R<-@oMo4xO{F2a*o;b)pQmJlV${U;e z$u*L^=CCbyD#NkbmAeY89krrbqN^To>`83<d^OruJ6mbaWrfJ?m`d`GDq@P5j>@5| zsx!w<QLhl|^9&p-7O4k<O<39u>*>+HzB|c}CkpkDu~K#eKG@saQw<@RKpT(FPu$Aa z#Co7-1+mL)xfy&DI}<5yJB_M8)DOg5)zifVZtGJfs>!}>QN$v>ZiRa881k8=oH&QL zo&R*b3eyh}-93Ehze!WhAlMpCgCh8yShc|$Q<p_P2d_8qS85V)m=!vWA-P54B7)I7 z^*f)ErAl@v;<3qmOO~q|XsbslP9zRytwRb_9e@y-+^5A@u&H&FPD;5%stLl#9c+R! z(UtPdt?CeXb$B<<A-lW_<p~1@PIXCawT3md7nlBn+7xGNRd6+O&hkCa(qX2CaOrQ? zsuh;45x$mmp3O46@%yE@f&(GL8C%nbo4F$c*B%pSSPgk=3CGOs#ELxJBC{>N7EH}s z{O0SnP{a2{wW&U?mzFqDTL{d}KKlTV8WPR0?@K6;h<kvG-Jr;Jh>7V6WM1BRqnO## z%m7wp4wAHIuoig&$xF`7@gh&2_7GS)WN?PZ6I^{z?zks9sSvL9+D1)g1(`0U!av^U zyo9Nhz0ibFi0R3Ah<Aq}>Y#)f|A&_wLf4RI&bki+Ruyy6sEd_8d$PHMC-vvn>g2U~ z7%m(jj6KKW*$u0gpM*Hp1%A1T#%M@3U%|)oc_K!18!<IE6RG~8kzA}UJUae2Mxp|( z>WQXFndVxF-}zvRVJcMPg!++9VX^gAmBuzq`c(FQHUr4t%J6V$WxAZ^?B{b4?YWkp zO`dy})!5OmRHz^6)XZc0cTV~R)n4<C820-&I35`L>(V}DSPb!DSs%D$P-}E2cJGp( zpZ3hlAep4xkbGn~UVD6a;742{AgpAV7LpwMcR&wx>APf@%6nWa+fI6~;bg&GWYAA5 zprgTrlIxX6$;$mJG@;PW20=-a#p0`Gq<Jca8WqIs^#3$5=>MH`qyO#o|34b&J$<^* zlyvW3+8HZGxA#2Z7K9EcOw*ok+<Qi`@~@CcUc#xWk#Rk_9O@h>ZbI>|)W_tJq&D*u zDj`uHK=|{dq^XxgUZ3GHV)0_~de7a(%fQss*M0A|2eXI2$B&SzdG=YT23}@7*X%eL z23dm%BjDZ33?DGya*I5e$J@5Ga52Sf?PUguTCB;z;{<)HZTN3_11!zUv&VD=zYhmy zbLdtC=$kwSzpVNL)Y4|OXtk5vmc&%CzQZruT`N<;m@t{<#^j7SLjwd#|CL{sP=SKj z$Wz-sRjJ-8skQ=7|AuCNX&mWG*{1P5x03e80`};RW5I4Y+8y*N`Oi3`sB8x`5fZ!r zBq;tXfuZ`QbD$PSKj&CZ&>5=jk;!mZjP9p60pIGTyE}R-sjKVxWgzo0uzQv<=A|NZ z_7(X@FbL%?wjuDI(g`1Qia)auU<sEo!U0D9B*?7*KIc|RcLKzisy9`#;>MZ3T%^rM z4Q5q9C`$SKXp;5hB|@bX-QM`$cVF?xJuGy@Fb-jn{P(-k-`_(DTn74|;dj}QNjnWF z+-eYzZsD(V4t#zLBr<A1OJ>2$UXT3p-t<2a1?@3^8wVWaZAnFltqw%uJT<iYkL-K5 zHj)l5c|y{Pty@ec%{m}=s~Mo@?Z2AI!lgI%cQ*Q#^f7Zl_TOXw{rKvEuDH|FH_FU$ zo(O=Xw*&TQxwD7d>YV?_`t-E5rdnpYb;_zI)ZSg3WoL?~N0VcBQsso|KtGq5DzlN! zTbaxM6DoJ_PNCR^+bm@oFY2u{Ka!0se2M+1&$GV<6<bX@8&M#X#FlP#ACR`dR)D{C zSY#!o63ALhZqd5FgAIH1IpN9y->^4KF`7bdodSU>Q~*`i0?!bIR_xKT2~X(N_5xo? zCj)&TFaf;z<=;225NIool6$eg7~uBbTK?^L_KQW<hCx#6@GSpf<xDS?cS4(yZ2Esa zcozRqT%emI15DhN8mP8pqVRKEy?>dy9f;uomGW{&Z#hFJc>ia&NvCJgPf8uUy8m0F z07T#?mg?N#aAuO>isr^=8tZ>FG>NjlfgabpV7?ss!u=mpwBDHlKPQsNJx{0=lkWrj z`Ty+sDUY(l`=iG>ylZ@I%s|hffTb>!U_>+kdjD!WMwF-bU{f0f>XUAOclcb(GnRji zSh4TVN$4$hL;T?8^cyc|oUwQTAlSC|rUzXVNX7m)G-$4#`=@pvMRbO7V<YbQ4_Fie z5zebw^;{A>;lyxBvE-AKa%*bub1T?i*V&Mw^_d8vLe^HA^w}|Z<BW}XevpDbgE!`F z@toG17m>u*E{8(w(5KEGho*kFSlWg`O#cF$(CX`!sFhN8dA~b1r}H{B0tS7&S*Ws0 zce+)Z5K-5LTxtY1RkVf9C=Mvz;+)^Ndi5_9%q1T!vdR;0OQ|<hh=vgN@&zGGIt!R| z@vaB5g0Fu`0oM4o@di}?bue+)0e<ixa&fUue)IZ|9*J@~Yo7!IqIEiUj?`zd{M!Al zG^}0E7!Lk37MQ&8Hp?Hws&&VVz`%sNaq1YjM#ereW--4V6W~Xa&+qhZ^1>^la%htg z-R<o<!|gi(09?8Q=;!r!O!}`N+9>QZ(4@Q35YVXQokm$fA&rgmgx1yoo3nTK(X_P2 zz1yyjjwUPMx5E*znh|-7Fj5xa(Uo^F%25W1S%mkdcbL{@BQ8V#b6L{DuEM<eYj1iC zaJlTxq=?*SCy9jO|N8GP9R1%GJghNo7skzy`etZL3lwVV&MoPO@yX*~%5*O?vSg!& zUe3@Qd{@!Z9gpY3zYOatW*~!6b9mm`z}S3SP<BE4UlZwwHbWi{U0vN}#Frv@`S?b> zQwgmL5AAjwrws7GWC$I-@vXMFbtvS*R^VfKW*NBLbMua6XEcP3#+TfmTUgx@su&Le zhW72d;W0d$p}^hMcf+8-6$8VaOGj;#^X8ri+TjZX41K?}XieRzJm)FKl&)#%?&q`e z!=I(3gS-1Y4BZR2&VM$pF8dcLpDsw&{)-pj+4H2xTe$n5Tg~1X=hp{-7~t({SwvfU zESyKKW{B^$i-U1>q@!EgeE*3KAHZ?{9oXDrA{sK3RR6bwqEB~nync8R)K~578~JC( zm(aqS#=MQkxa-y>PGJxwuiN?X6_F-!#!Wyg^Q`VAMf=-ZI0H{uyL*BdttP~ZM_)yd zvyudE9(K|7G-!RNAoX@mk&wQFH1}ATR@z+E(1*#3m>c{N8dkPj2wfhjYTn-9v5f!a z0au=;q#c;3hsTT(p?jH(7TS_q)a-G?ry29F)Tbj<cpzXeTTWv$a>O0LluuiFcL&#c z`8cV=+{hOa>jAO96OXFFt;a7}BP(%1(ths>9am~(2XnJL{P*n8yJwe0r@I{AgV8us zsI~;Tl)?1=wKuzKZ;p|x#<O+ivJxV7k~DPt_ONmFpgZjQn#l(8Eqck%YG`UoRt&q` zx)wt8>N~+$_Ht!-E*a;9I0fCghcilVn*+mp=UsDtv$7S#JeMiw^!NIYct8k{<SOXn z%-;?aCtpf{PsLF18YXfz1xEa9x%RiE#Ke@PtCVjU*{pE`&fkXde;eY}N9`Rcs7M)W zidS^I&>@rs%w)86e`V604la7qOEO;acb+WzaSMjqvT)(rTkG$`ARlibc2^O;i28RB zM%}%|xi_Nf9MSP+xq~Wb;jg&uolP%CjHt7LOFkZm!Ja?QfraUD)lBbeop>Zt62w7b zB#q7h+5-kRR#bJ<wh$B`9KB?WihKA`2%Pr0T~%}cCxRd5<jend^?zSiCwt47QQOF~ z_mvO@`}j!SQA&4e1WNG{x}OP%`-q8&Si>NS#pNa1NOE4>*(cCN=AXIgwCKskfep<Q zq`L*z|5@ew|Cagxf2M)vl{<0(w*M3z?S1VWO27z&_m}Xtl1ukwA*w`|cmZYy({quF zorL`i*&7DwL>{yaZSSI{i2$W*38AkliKvK!$0gy#p#&J3oE7r~8AAd+D#AUR0~*p8 zh&m%Wmzi+1wx1)|MV5FA=4Zz~jKtK>7|~A&gLQA|S-eqPd9@pG2>#Qs0|s|L+ZY-S zO;uRFdX=dy$S-T0-+JSt|A+s4C-&m(ty7b;^iRRFHA&??zcXpSpwAyK<8H364vC+f zoLzG<xIM_>1M<Ib(~aB<>;wx_Xh$#ngvFk+%&hwVD#OtEQdD?tMkB6PAFyg~lq2Dj zEajKla(LkxY=8+s_<dXmsIeF^GoN6L?%1>bYC4n(NfRF75okV+1uuT+zRqv)+!!UV zRLFPLypE-O!SX|2M`pU^roZ1jdEC30!uDb0fY}9aL|XbtyPW&aXGTL5I|RS3nGT-+ z+Dj~@CA|VM@=)ZLs?_^P)5Bw@RLg6ZkAJQBIf;{BfRKE=3NJiCOeT49TEPx&xu$1l zOy9L+|D3Qj|2XG<HrKeEk>s`~ct|H0qrAUs4m%J`^E+P~Dv_)+m%3wG*&CsvqK#iK zz&Nc$+r*pFDnP~BIZ3Nw#lGC5Rgr}a+LZOTifAcw)?MXTi^5}KCS9`ksyONlFkuTu zd#TqEKZx}?q=$~WX0pdyuUtdH65y+xi0#T?aHNO0ao2j8YP(-vgiVtbv{ke1g+Eyw zQ*XWlj+@{MjQdF4WT1=Qp>O@ls+%Pj*ZX;&UTA3vmFQy?qwUYU7kBDwYZ*UPm?LS+ zUp_jzIg-sKuiWu;2&2e;v`5`6Q+c6iNzoj!y0`oBIU>QrUE|QvTvt1ba!I<~O7~rf z7IELmM5OtoZHc0POb}lErW04z<ozg2nYAno%8e3Ud1I?KoVKG-*pr<TNufCtBWPq5 z{^GPj0aMA$Ma*b2<y`%6Xg@9_(g2DRQVovG(6<t8K2~1%CEKV5y>gi{?5lx*E)qfQ zx{rmw&c<k*`Fouyg|p3+=9sFw*U1+eL5J-YqrdrbV>gU`_st8kf$!beWQgonDrl`r zmCuZDoMIDuw~gd2yrgVPdqsGPm#NMIE^!n5^RVMJSwvU^B9h<aPSH13sA_GcbOW7~ z!hx_(xCK0@ww-b+f;OyGjMUmf#1dn~XyG|)M_`OVDh3+jPMP@Mvy*gBXGZpz92;(? zf~2&Dc)hAK6|FCqjOZ||D}~i&{m*=A`dtKxHDVQU!lYE)HkksyLT#jvYTlO=tgq)@ zZo5yHr8H}{NY?H`UUNh~GLaqa%nN=o_qKG5NdwZj*KltKwYd0sCCMuF7OG=b39b+P z4=#t6{Rn61Vb8JW+{vt=rNoZpF{%I9gpu`Pq*fg-x=3!C0`aZulezwaFuv9*DtE+{ zJ=(H2lctoF@6QBn28(NT${%H=l#37k-kdMX47^2H$73micf~AU`*kHZoEoZBpd1|b z(78VW)<q$iie3GfPh_^-E}|1iHog0L<ez7L@vU>R4B1<aqYEWLLEiFeoBVyxM3ggb z9KBC%!fo|YpVl?I{Id<uYCmB@Fphp1mJg-0{MoUTe7Wlbx2)>ZVH;w8d7@8h#c80$ zr(HQ(91WW=>cN?%tMAy<J?&BH0=FZTDD9MciQcFdy5g*byHZ)`y$&tBmAo#k!Z#B( zt+pJw-r(cuFJ6jcZ`Q~X*2QqBRnul-CLFLneF>Dc=7qN;Z~M*l=*5t~tNpX~yuLnd zT_(m#^|DftCqsd=Ko@K$a!$Z~E-`eN9VAhh-Q4RL$gxS&O{OL9?&WG?v?VpLtN_0< zAX=`AX^fkQVQOlyEzb2i2{2YOik!VA_G=cE_p}gp>Z@+>1v`Ju%{wbXtz~3`no9Fm zPLtxC{Zs?@U&x(+2+gK*%4CZMo)wV|!sr&Rv|VSIy>lM5#^?rni}vp3hi~&f3zuRZ zAm1z)cwQgV^C9HnJ5piRABVlj92u7?C(+q^Ki-&-W-@0^0y3S4@oOYwmoN}-2cn6T zP!c(6l&;LalU4dKB);~IU@>xCtU2VD%R|JfYfs3Opn!S#*L!f@nNg4?C4^DzPm6P$ z6jE(6MU#dXAR5@Dx=)}!@w$4n-l{;g!jPreMxK$B4qL3k%c4oQMqc4{Ni>PVYri~- zIl4eU2{z=zvpsj-ClzGclGl@i{ZuZEF_i(vF}~~<L92DYgmbx{$!V!J1xi^D*-I_3 z7F#!m5x1(TH(!i~>X<hg7A!owH7mKAV?lWp#v)T;IlDeBN=`dvj&1Hou<R>KhAYz= z5SV4af9%o2Qi7uR?U64LPM1BBqh?kuIX$37nO??5inu8$$^szwU?5H`G4mVKjvHpp zfs+0CJ#9(O0<Z~ogRW*tfN>G--19$Wf{ZlSJXP$}1#j}{Yr~#sJ3b_08+YNPwiD2n zbrR9Zpy434lXXXM#d+*W(ScO6UGXIDw@6Ux7w?!bxQE8*$s5se{29Gw(FVIZmSlf| z1k1>Og>JHcux$#9bTg1dH*pWOP%5-iv{lTbXej<@`cz?ppeDlR9d0k6n+h$IZWX4g z>gSGPF2)2R+Op0MN`zf-n5qNH|D2&o3d`(nD~a@m{$UfF)f&sQf`I+=ePI)bSmhqE zW#@TVnCt7FpzNVKS=UZ$P;=LQthAfEEGyE(At~{Ku&=EHz&8_Lv3rmz&<9x+tUdxk zJd17qyI6)nzszN_`e|o4O?I?B1P9B=$<TWg7E6n#+E^yhY$-<shPz77#Xc-sCSzM9 zDeI^ahXfDSsZ#vJ7~I$Hn|{7q9aO(qia1TX6(^Pvy02F}v}l1GAL6cB(&!LQhI1Y3 z)}N^vtet_=P&#627!2B?wl}GJp0_H(q2lxacYIW@0G42u94VjnPK!L=stz1aBfUFf zv%jAI<%*|5c(Lg+u$}i!UeyTHz$;>_Od^N-Lm+M4pF-}bC8TH-r>xaPVyl*f1=sxR zSj#-+TRI!}9GopWT9=BCZb@q4zp`2~t(FPZly<^?tnfcWpQu*C74}a`>kKxO(IU+x za1vNG@)9SW^X1gnUP<H0tdgLeJem!bkS>C7Q|Q0JXa!7l*bC@{$P%SH4#abWmVEC3 zX_=k6C-6}-*^^7c!I&d-wJ3eJ%QLMp;aC$mv4i>T0wkge<U6TBO$bz{CqU?baiPY9 zIvp?dRYjB@vc(;q*yAk*+n%J(Y8Jc18D<TsL*4vK3Fa84(%mshQd;*??VFUT0T}1f zhB>Fl(1rHYvh=?`Yd;7RvL&AVYNrQ+xi!{mEHlldM1>Dem|U`ZC+DV~Y%Q-vyRJO5 zmaSf&Rgz`3YOrT(xZaiK`YVu8K-NyR%S|qWzB`ZfMr#$0B=@dj+|f0j9leyiw>_qI zqRN=odH(?Y)bRdHVRuUAIqJ3rz!Oe%hKeI-wd7%E*)&cC2$e&7A(`n!sVF`Le5-n& zz0fzcXDS-qic>RZerL(ZxAkS3{<?&6GIoI`r_Z}N!|Y+OBy~^l!iUwN@UN4X@<WPW zo^B)G&Op&>#i?Ge*?j7LO{Hn<XhlZ!nJ?Q|6)5Ra8DTOSP^hZ=GQpONbW^JKlIqo{ zRc&e|_kSlqf`RV^muifdxc>0oa6egD)GrTC=;E~%u|(&_*w*8J(a;wUd`n_YZ&C2- z=!A(%ji1vO=Q#F4C#-~=Z~_>U%#5H)R?|#97;O5YQrcOPeRHp4SHa3_LftvnewFfv z^_5d<vR22hBG)^6RsK0!aKp20Orji8Je&o6kx$F>kLH}nJcj)f4yP0ZLyp(f0nN#t zfV{Wz^%t;<{a#wJ`3u(D+xPnGa6AQ$V)L$#wdA(Wcd^MCr=~pegSQ8F-kn_Z?DR*# zHWHb3*xvi$ePIY~L_H)0IG~CHkn1bPkYcJ_S3?+M<y@?wP;C)5#WLITlvNvm1&C5G zv;OL&QJa2nCtpH&>}(eJo*|K>HUsRM5_hwf?(Rr1&W>Tq6WpPd`fN9n&x_i#8>*q* z>0K<xbZ=qO#=1%QVdJ63fLRd{JcyZGKgI)xsxF=Cau7okcWa=>i16y8yc-=)BAouI z2#|$soZ#anRO&Hhj5-%^`LQ4E?a)tI?UrA2R=uUX&dxZ>i1j+KiG)oV<=($G>X_Ul z)vXjvGIN)t*wX-6+s@k`$2R8FAO6PmzZ$!Jd&W+r<tun4x7s<^&pDYt(`;;MlEY0; z>J^k5Td6}_%}k*$;b@lmIG;JJp;~qK@*a#u-5@*jaBm0<QdUjH;JX{w81^Ah4Qyp` z8Od1qwX~ln2^ytx`jnoa@vyosOPyd>dV=HqIx80akDeb2Smp6tAFuC}{ITCs@pDoh zmVhwZloG>+5MvjRM9NdHaYK)#Ddf~uSULX%?CQRpbr$jAsqhtj<IqLwTHC$qnYqPS z*e%bZRKCvX{ZJTLcFw|n2>k<YFphdSOLe1*lKG2+Q8V$4f#}qGG%AO}O*Dr9xxz;z zAPgF`7yX66Ynoe+D5mq3F_Z`Rj6ub@H9L=kxKhD20k-S$5bqj-dV&6BjxwW9z<1BH zJ+2MNW_d5yNRQE|5%fSWHhGnTywA#S_VPP6()o;ZcNy{HWgsM?A%qZzAoMT`9moAG zPwQ`Tb1Gx#`9R!7K<r0&6gIy=uIRg)0ijFTNbIkXY&rJkZr_2@qn@KZ5v;M*c3i1c z+-eO;pL+@PMEGFWVVW(pS4_u-4f}XoU+O|ekI*VAcAi|F;hrdYPcymE=mSR&K-w`H zqmJ0Gh0Ei&DH<!fycO?&d@x4%LwIxUlY*vnl8kC%G`6+XEj{8tf&hI4NY?CIBrfCS zCkog@O)&q}(fshPYjH+wzG?URqAVBa3O1XQtw<xcwxze|_@pJ7`O4h#vE_b85ZW?= zKZ1SFP4UzO<l}E>6$=fdXB;e?DFn)CdazpRnVWkxL_i7aD)ikT6OhHm5E_*dPm<?@ z2!<Z|k)bQ+oF_E#OsNpHpW%9A+`9sFxe|Tr-C(LC0)U7jZKX7$<vWu|->UVvC$W52 z%uw4gb_g`bgwYfQI>8SkV&cazmhN3efu_>DOvBFU#?_UoUo|&E5>OW6q2i<O2|<;r zHzB2FK5cphi?b(V|B(1LM<qFf<te~D(XcvZj+NYA_&|xO1YnM+YDsu272GHH{)S9S zN>S&W2z9t46AAWNYi|gqq4X+guQkWPLbxGow9!8ZDKM@hDpUi7RD*(ebb`d*GkOdU zhTw<@DGq!aziRpM9)ChyCmx2k;ko~MderzhX+^E3r+<8$*u1u`D&wC7+$0{)kTrfL zC9Fh=1sJN%>YIeONt_|g4nNua@B`x7Fgr4)iU2|iR@D|#I5Q`;iS!d6-nXmhZ^R|? zx^v5bz2Za7ilfVsYu%50D*Q<x<4=2Zec|+M*%Hq*Pj%iTAsdH9QpqMHu;CXwL@zJC z+E^QNPil2d-9Xz6rzcBnx%p#*47uFflAU=<X8vPr8kS!zaY(sW8I${K?8Kbtn?%cL z0;BBE_uRdfHv#9@CjbS7|FHDKiXS=+M;-3VKF713SCg4pH_;NZU1nd-8Ffwt+d*zb UwgDcz_kcfXae1*)5rdEa2eVx1fdBvi literal 0 HcmV?d00001 From b1509113ca01ac23c3e91face3c1bf8c1526cd87 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Mon, 12 Jun 2023 13:53:15 +0300 Subject: [PATCH 619/882] Create connection_tested_successfully_2.png --- .../connection_tested_successfully_2.png | Bin 0 -> 19529 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 _static/images/Third_Party_Connectors/pentaho/connection_tested_successfully_2.png diff --git a/_static/images/Third_Party_Connectors/pentaho/connection_tested_successfully_2.png b/_static/images/Third_Party_Connectors/pentaho/connection_tested_successfully_2.png new file mode 100644 index 0000000000000000000000000000000000000000..7818a28ae80bac86b230d5ba31071aede96af541 GIT binary patch literal 19529 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 Ch4K~v literal 0 HcmV?d00001 From 36913765048207d74f81b35a91080cfa40964182 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Mon, 12 Jun 2023 14:17:03 +0300 Subject: [PATCH 620/882] Create New Text Document.txt --- .../images/third_party_connectors/pentaho/New Text Document.txt | 0 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 _static/images/third_party_connectors/pentaho/New Text Document.txt diff --git a/_static/images/third_party_connectors/pentaho/New Text Document.txt b/_static/images/third_party_connectors/pentaho/New Text Document.txt new file mode 100644 index 000000000..e69de29bb From 1b17d74fb7ae7f8fba2cfa632d3e1f66663688f0 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Mon, 12 Jun 2023 14:24:59 +0300 Subject: [PATCH 621/882] remove pantaho images --- .../third_party_connectors/pentaho/New Text Document.txt | 0 connecting_to_sqream/client_platforms/pentaho.rst | 9 +-------- 2 files changed, 1 insertion(+), 8 deletions(-) delete mode 100644 _static/images/third_party_connectors/pentaho/New Text Document.txt diff --git a/_static/images/third_party_connectors/pentaho/New Text Document.txt b/_static/images/third_party_connectors/pentaho/New Text Document.txt deleted file mode 100644 index e69de29bb..000000000 diff --git a/connecting_to_sqream/client_platforms/pentaho.rst b/connecting_to_sqream/client_platforms/pentaho.rst index fa8146c41..370f65935 100644 --- a/connecting_to_sqream/client_platforms/pentaho.rst +++ b/connecting_to_sqream/client_platforms/pentaho.rst @@ -170,9 +170,6 @@ After creating your transformation you must define your output. - Password - Your password. If you leave this blank, you will be prompted to provide it when you connect. - The following message is displayed: - -.. image:: /_static/images/third_party_connectors/pentaho/connection_tested_successfully_2.png 6. Click **OK** in the window above, in the Database Connection window, and Table Output window. @@ -204,11 +201,9 @@ For more information about backing up users, permissions, or schedules, see `Bac 1. On the CSV file input step item, click the **new hop connection** icon. - .. image:: /_static/images/third_party_connectors/pentaho/csv_file_input_options.png 2. Drag an arrow from the **CSV file input** step item to the **Table output** step item. - - .. image:: /_static/images/third_party_connectors/pentaho/csv_file_input_options_2.png + 3. Release the mouse button. The following options are displayed. @@ -216,7 +211,6 @@ For more information about backing up users, permissions, or schedules, see `Bac 4. Select **Main output of step**. - .. image:: /_static/images/third_party_connectors/pentaho/main_output_of_step.png :: @@ -242,7 +236,6 @@ For more information about backing up users, permissions, or schedules, see `Bac 10. Click the play button to execute the transformation. - .. image:: /_static/images/third_party_connectors/pentaho/execute_transformation.png The **Run Options** dialog box is displayed. From f3391e1d5d25acb61fd65e0a7167de5fee8b4289 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 12 Jun 2023 16:49:52 +0300 Subject: [PATCH 622/882] Update pentaho.rst --- connecting_to_sqream/client_platforms/pentaho.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/connecting_to_sqream/client_platforms/pentaho.rst b/connecting_to_sqream/client_platforms/pentaho.rst index 370f65935..5bf4c3685 100644 --- a/connecting_to_sqream/client_platforms/pentaho.rst +++ b/connecting_to_sqream/client_platforms/pentaho.rst @@ -207,7 +207,6 @@ For more information about backing up users, permissions, or schedules, see `Bac 3. Release the mouse button. The following options are displayed. - :: 4. Select **Main output of step**. From bb9f6b5d6bad849c9565e00bcf196a9fdab598da Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 12 Jun 2023 17:07:24 +0300 Subject: [PATCH 623/882] H100 --- getting_started/hardware_guide.rst | 10 +++++----- .../recommended_pre-installation_configurations.rst | 5 ++--- 2 files changed, 7 insertions(+), 8 deletions(-) diff --git a/getting_started/hardware_guide.rst b/getting_started/hardware_guide.rst index 61d1aae50..df3e4f093 100644 --- a/getting_started/hardware_guide.rst +++ b/getting_started/hardware_guide.rst @@ -52,7 +52,7 @@ An average single-node cluster can be a rackmount server or workstation, contain * 10x 3.84TB SSD 2.5in Hot plug for storage, RAID6 * - GPU - - 2x A100 NVIDIA + - NVIDIA 2x A100 or H100 * - Operating System - Red Hat Enterprise Linux v7.x or CentOS v7.x or Amazon Linux @@ -97,7 +97,7 @@ The following table shows SQream's recommended hardware specifications: * Mellanox Connectx5/6 100G NVIDIA Network Card (if applicable) or other high speed network card minimum 40G compatible to customer’s infrastructure * 50 TB (NAS connected over GPFS, Lustre, Weka, or VAST) GPFS recommended * - GPU - - 2x A100 NVIDIA + - NVIDIA 2x A100 or H100 * - Operating System - Red Hat Enterprise Linux v7.x or CentOS v7.x or Amazon Linux @@ -200,9 +200,9 @@ SQream relies on multi-core Intel Gold Xeon processors or IBM POWER9 processors, GPU Compute and RAM ------------------------- -The NVIDIA Tesla range of high-throughput GPU accelerators provides the best performance for enterprise environments. Most cards have ECC memory, which is crucial for delivering correct results every time. SQream recommends the NVIDIA Tesla V100 32GB or NVIDIA Tesla A100 40GB GPU for best performance and highest concurrent user support. +The NVIDIA Tesla range of high-throughput GPU accelerators provides the best performance for enterprise environments. Most cards have ECC memory, which is crucial for delivering correct results every time. SQream recommends the NVIDIA Tesla A100 40GB or H100 GPU for best performance and highest concurrent user support. -GPU RAM, sometimes called GRAM or VRAM, is used for processing queries. It is possible to select GPUs with less RAM, like the NVIDIA Tesla V100 16GB or P100 16GB, or T4 16GB. However, the smaller GPU RAM results in reduced concurrency, as the GPU RAM is used extensively in operations like JOINs, ORDER BY, GROUP BY, and all SQL transforms. +GPU RAM, sometimes called GRAM or VRAM, is used for processing queries. It is possible to select GPUs with less RAM. However, the smaller GPU RAM results in reduced concurrency, as the GPU RAM is used extensively in operations like JOINs, ORDER BY, GROUP BY, and all SQL transforms. RAM -------- @@ -223,7 +223,7 @@ Storage ----------- For clustered scale-out installations, SQream relies on NAS storage. For stand-alone installations, SQream relies on redundant disk configurations, such as RAID 5, 6, or 10. These RAID configurations replicate blocks of data between disks to avoid data loss or system unavailability. -SQream recommends using enterprise-grade SAS SSD or NVMe drives. For a 32-user configuration, the number of GPUs should roughly match the number of users. SQream recommends 1 Tesla V100 or A100 GPU per 2 users, for full, uninterrupted dedicated access. +SQream recommends using enterprise-grade SAS SSD or NVMe drives. For a 32-user configuration, the number of GPUs should roughly match the number of users. SQream recommends 1 Tesla A100 GPU or H100 per 2 users, for full, uninterrupted dedicated access. .. note:: Non production HW requirements may be found at `Non Production HW Requirements <non_production_hardware_guide.html>`_ \ No newline at end of file diff --git a/installation_guides/recommended_pre-installation_configurations.rst b/installation_guides/recommended_pre-installation_configurations.rst index cf6328a34..9e965e221 100644 --- a/installation_guides/recommended_pre-installation_configurations.rst +++ b/installation_guides/recommended_pre-installation_configurations.rst @@ -830,7 +830,6 @@ Installing the CUDA driver from the Repository is the recommended installation m $ wget https://developer.download.nvidia.com/compute/cuda/10.1/Prod/local_installers/cuda-repo-rhel7-10-1-local-10.1.243-418.87.00-1.0-1.ppc64le.rpm $ sudo yum localinstall cuda-repo-rhel7-10-1-local-10.1.243-418.87.00-1.0-1.ppc64le.rpm -.. warning:: For Power9 with V100 GPUs, you must install the **CUDA 10.1** driver. 4. Install the CUDA drivers: @@ -961,7 +960,7 @@ To Tune Up NVIDIA Performance when Driver Installed from the Repository $ sudo systemctl enable nvidia-persistenced -5. For **V100/A100**, add the following lines: +5. For **H100/A100**, add the following lines: .. code-block:: console @@ -1000,7 +999,7 @@ To Tune Up NVIDIA Performance when Driver Installed from the Runfile 3. Add the following lines: - * **For V100/A100**: + * **For H100/A100**: .. code-block:: console From 7e0a9abfcb0165a82493c899c2535e99c98beee7 Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Sun, 18 Jun 2023 09:41:27 +0300 Subject: [PATCH 624/882] Update sql_data_types_date.rst Remove confusing warning --- data_type_guides/sql_data_types_date.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/data_type_guides/sql_data_types_date.rst b/data_type_guides/sql_data_types_date.rst index 88236c113..d25d2a7b8 100644 --- a/data_type_guides/sql_data_types_date.rst +++ b/data_type_guides/sql_data_types_date.rst @@ -95,7 +95,6 @@ The following is an example of the correct output: 1997-01-01 00:00:00.0,1955-11-05 -.. warning:: Some client applications may alter the ``DATETIME`` value by modifying the timezone. Date Casts and Conversions ^^^^^^^^^^^^^^^^^^^^^^^ From 74c4e811b9a994f65473347dd67a7b70a5b7d3ae Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 19 Jun 2023 09:19:57 +0300 Subject: [PATCH 625/882] Update chr.rst --- .../scalar_functions/conversion/chr.rst | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/reference/sql/sql_functions/scalar_functions/conversion/chr.rst b/reference/sql/sql_functions/scalar_functions/conversion/chr.rst index aa52694e1..b98ea5c45 100644 --- a/reference/sql/sql_functions/scalar_functions/conversion/chr.rst +++ b/reference/sql/sql_functions/scalar_functions/conversion/chr.rst @@ -11,7 +11,20 @@ Syntax .. code-block:: postgres - CHR(n) + CHR(int) + +Argument +======== + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Argument + - Description + * - ``int`` + - Integer argument that represents the ASCII code of the character you want to retrieve + Returns ======= From 930ad5e74119f7f7740eb5baf965f41d5d0bc3ea Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 19 Jun 2023 09:31:04 +0300 Subject: [PATCH 626/882] Update conf.py --- conf.py | 1 + 1 file changed, 1 insertion(+) diff --git a/conf.py b/conf.py index 4cefff76e..c3ef50146 100644 --- a/conf.py +++ b/conf.py @@ -38,6 +38,7 @@ extensions = [ 'sphinx_rtd_theme' ,'notfound.extension' # 404 handling + ,'versionwarning.extension' ] # Mark 'index' as the main page From 0e500163ae7145aa9163f2d86a9b5c20e3f0c4c7 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 19 Jun 2023 09:54:34 +0300 Subject: [PATCH 627/882] Update conf.py --- conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/conf.py b/conf.py index c3ef50146..2be8ee0f1 100644 --- a/conf.py +++ b/conf.py @@ -50,7 +50,7 @@ # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. # This pattern also affects html_static_path and html_extra_path. -exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store'] +exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store'] # -- Options for HTML output ------------------------------------------------- From 44e5d5dc5839e0cd783d8a9582facd54d43404c8 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 19 Jun 2023 10:01:30 +0300 Subject: [PATCH 628/882] Update conf.py --- conf.py | 2 ++ 1 file changed, 2 insertions(+) diff --git a/conf.py b/conf.py index 2be8ee0f1..d9938a54f 100644 --- a/conf.py +++ b/conf.py @@ -13,6 +13,8 @@ # import os # import sys # sys.path.insert(0, os.path.abspath('.')) +# print(sys.executable) + import sphinx_rtd_theme From fb1bd1a52a462c3bbf75f1d1773fce9521990308 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 19 Jun 2023 10:03:35 +0300 Subject: [PATCH 629/882] Update conf.py --- conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/conf.py b/conf.py index d9938a54f..357881806 100644 --- a/conf.py +++ b/conf.py @@ -40,7 +40,7 @@ extensions = [ 'sphinx_rtd_theme' ,'notfound.extension' # 404 handling - ,'versionwarning.extension' + ] # Mark 'index' as the main page From 1f2d4363a5a9ae016f9368f888a36ebdfdf20dc2 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 19 Jun 2023 10:19:16 +0300 Subject: [PATCH 630/882] Update conf.py --- conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/conf.py b/conf.py index 357881806..1bc43e581 100644 --- a/conf.py +++ b/conf.py @@ -38,7 +38,7 @@ # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom # ones. extensions = [ - 'sphinx_rtd_theme' + 'sphinx_rtd_theme' ,'notfound.extension' # 404 handling ] From 759ff0c2f3fe439b14f6b31904da39d01b68e826 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 19 Jun 2023 10:23:39 +0300 Subject: [PATCH 631/882] Update conf.py --- conf.py | 1 + 1 file changed, 1 insertion(+) diff --git a/conf.py b/conf.py index 1bc43e581..c1b31e1a8 100644 --- a/conf.py +++ b/conf.py @@ -40,6 +40,7 @@ extensions = [ 'sphinx_rtd_theme' ,'notfound.extension' # 404 handling + , 'versionwarning.extension' ] From 4be13b59982ce4f81f23b8755b82ca8a50e81743 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 19 Jun 2023 10:23:53 +0300 Subject: [PATCH 632/882] Update conf.py --- conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/conf.py b/conf.py index c1b31e1a8..5cf7480fd 100644 --- a/conf.py +++ b/conf.py @@ -40,7 +40,7 @@ extensions = [ 'sphinx_rtd_theme' ,'notfound.extension' # 404 handling - , 'versionwarning.extension' + ,'versionwarning.extension' ] From 210e1404e050d55a333fd80fce994f03b84c9caf Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 19 Jun 2023 10:34:02 +0300 Subject: [PATCH 633/882] Update conf.py --- conf.py | 1 - 1 file changed, 1 deletion(-) diff --git a/conf.py b/conf.py index 5cf7480fd..00df41282 100644 --- a/conf.py +++ b/conf.py @@ -41,7 +41,6 @@ 'sphinx_rtd_theme' ,'notfound.extension' # 404 handling ,'versionwarning.extension' - ] # Mark 'index' as the main page From 69ec6f0a70db07607f05e610f41b5c9d9509855b Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 19 Jun 2023 10:36:08 +0300 Subject: [PATCH 634/882] Update conf.py --- conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/conf.py b/conf.py index 00df41282..191909b68 100644 --- a/conf.py +++ b/conf.py @@ -42,7 +42,7 @@ ,'notfound.extension' # 404 handling ,'versionwarning.extension' ] - + # Mark 'index' as the main page master_doc = 'index' From c53e52eca248998dc32664a5f7aa80115e5f56e3 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 19 Jun 2023 11:05:21 +0300 Subject: [PATCH 635/882] Update requirements.txt --- requirements.txt | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/requirements.txt b/requirements.txt index a8c8329d7..634ac675a 100644 --- a/requirements.txt +++ b/requirements.txt @@ -7,4 +7,5 @@ urllib3<=2.0.0 openssl-python>=0.1.1 sphinx-notfound-page Pygments>=2.4.0 -pdftex \ No newline at end of file +pdftex +sphinx-version-warning From 8d1b9ad5675c01a07e97b8dfdaec99954af77a29 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 19 Jun 2023 13:20:11 +0300 Subject: [PATCH 636/882] Update drop_role.rst --- .../access_control_commands/drop_role.rst | 32 ++++++++----------- 1 file changed, 14 insertions(+), 18 deletions(-) diff --git a/reference/sql/sql_statements/access_control_commands/drop_role.rst b/reference/sql/sql_statements/access_control_commands/drop_role.rst index 61c4d5bb9..951cbfc1c 100644 --- a/reference/sql/sql_statements/access_control_commands/drop_role.rst +++ b/reference/sql/sql_statements/access_control_commands/drop_role.rst @@ -4,29 +4,22 @@ DROP ROLE ***************** -``DROP ROLE`` remove roles. - -Learn more about the permission system in the :ref:`access control guide<access_control>`. +The ``DROP ROLE`` command is used for removing roles. See also :ref:`create_role`. -Permissions -============= - -To drop a role, the current role must have a ``SUPERUSER`` cluster-level permission. - Syntax -========== +====== .. code-block:: postgres drop_role_statement ::= - DROP ROLE role_name ; + DROP ROLE <role_name> role_name ::= identifier - + Parameters -============ +========== .. list-table:: :widths: auto @@ -35,15 +28,18 @@ Parameters * - Parameter - Description * - ``role_name`` - - The name of the role to drop. - + - Role name to be removed Examples -=========== - -Dropping a role ------------------------------------------ +======== .. code-block:: postgres DROP ROLE new_role; + +Permissions +=========== + +To drop a role, the current role must have a ``SUPERUSER`` permission. + +You can learn more about system permissions in the :ref:`access control guide<access_control>`. \ No newline at end of file From 6e973f38c308640523c34d8821e18052d29fdba4 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 19 Jun 2023 13:33:31 +0300 Subject: [PATCH 637/882] Update drop_role.rst --- .../sql/sql_statements/access_control_commands/drop_role.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/sql/sql_statements/access_control_commands/drop_role.rst b/reference/sql/sql_statements/access_control_commands/drop_role.rst index 951cbfc1c..fe46890ba 100644 --- a/reference/sql/sql_statements/access_control_commands/drop_role.rst +++ b/reference/sql/sql_statements/access_control_commands/drop_role.rst @@ -4,7 +4,7 @@ DROP ROLE ***************** -The ``DROP ROLE`` command is used for removing roles. +The ``DROP ROLE`` command is used for removing roles from the database. The optional ``IF EXISTS`` clause can be included to prevent an error if the specified role does not exist. If the ``IF EXISTS`` clause is omitted and the role does not exist, an error will be raised. See also :ref:`create_role`. @@ -14,7 +14,7 @@ Syntax .. code-block:: postgres drop_role_statement ::= - DROP ROLE <role_name> + DROP ROLE [IF EXISTS] <role_name> role_name ::= identifier From 428afd7c09e33fb5cbc95e0d68e675bac32646a3 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 20 Jun 2023 08:50:57 +0300 Subject: [PATCH 638/882] Update conf.py --- conf.py | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/conf.py b/conf.py index 191909b68..cfc66507b 100644 --- a/conf.py +++ b/conf.py @@ -30,7 +30,10 @@ # The full version, including alpha/beta/rc tags release = '4.3' - +# -- Version Warning Banner configuration ------------------------------------ +versionwarning_messages = { + 'latest': 'This is a custom message only for version "latest" of this documentation.', +} # -- General configuration --------------------------------------------------- From 8695df76d66c34dd706735d581c285f9cd197b66 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 26 Jun 2023 08:50:36 +0300 Subject: [PATCH 639/882] Update 4.3.rst --- releases/4.3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index 1995e7fd8..eb0ecebfe 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -19,7 +19,7 @@ Compatibility Matrix | Supported OS | * CentOS / REHL - 7.6 - 7.9 | | | * IBM RedHat 7.6 | +-------------------------+------------------------------------------------------------------------+ -| supported Nvidia driver | CUDA version from 10.1 up to 11.4.3 | +| Supported Nvidia driver | CUDA version from 10.1 up to 11.4.3 | +-------------------------+------------------------------------------------------------------------+ | Storage version | 49 | +-------------------------+------------------------------------------------------------------------+ From fe60c3139ea193c03a72dfbc1bdada89f846af65 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 26 Jun 2023 08:57:44 +0300 Subject: [PATCH 640/882] Update ingesting_data.rst --- data_ingestion/ingesting_data.rst | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/data_ingestion/ingesting_data.rst b/data_ingestion/ingesting_data.rst index 97d57ef4c..4f0155255 100644 --- a/data_ingestion/ingesting_data.rst +++ b/data_ingestion/ingesting_data.rst @@ -76,11 +76,9 @@ For more information, see the following: * :ref:`workload_manager` Supported Load Methods -------------------------------- +---------------------- You can use the ``COPY FROM`` syntax to load CSV files. -.. note:: The ``COPY FROM`` cannot be used for loading data from Parquet and ORC files. - You can use foreign tables to load text files, Parquet, and ORC files, and to transform your data before generating a full table, as described in the following table: .. list-table:: @@ -95,8 +93,8 @@ You can use foreign tables to load text files, Parquet, and ORC files, and to tr - Streaming Data * - COPY FROM - Supported - - Not supported - - Not supported + - Supported + - Supported - Not supported * - Foreign tables - Supported From d3a3b097a2fb4c6673bf2fd07724819aa11f4840 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 26 Jun 2023 09:23:15 +0300 Subject: [PATCH 641/882] Update substring.rst --- .../sql/sql_functions/scalar_functions/string/substring.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/string/substring.rst b/reference/sql/sql_functions/scalar_functions/string/substring.rst index 205e83d5d..578a0e892 100644 --- a/reference/sql/sql_functions/scalar_functions/string/substring.rst +++ b/reference/sql/sql_functions/scalar_functions/string/substring.rst @@ -4,7 +4,7 @@ SUBSTRING ********* -Returns a substring of the input starting at ``start_pos``. +the ``SUBSTRING`` function is used to extract a portion of a string based on specified starting position and length. .. note:: Some systems call this function ``SUBSTR``. @@ -29,9 +29,9 @@ Arguments * - ``expr`` - Original string expression from which you want to extract the substring * - ``start_pos`` - - The start parameter, which accepts an integer or bigint expression, indicates the position from which the returned characters begin. If start is less than 1, the expression starts from the first character. The number of characters returned is determined by the larger value between start + length - 1 and 0. If start exceeds the number of characters in the expression, an empty string is returned + - Accepts an integer or bigint expression that specifies the position within the string where the extraction should begin. If start exceeds the number of characters in the expression, an empty string is returned. If start is less than 1, the expression starts from the first character * - ``length`` - - A positive integer or bigint expression that specifies the number of characters to be returned from the expression. If the sum of start and length exceeds the total number of characters in the expression, the entire value starting from the position specified by start is returned. If length is negative or zero, the function returns an empty string + - Accepts an integer or bigint expression that specifies the number of characters to be returned from the expression. If the sum of start and length exceeds the total number of characters in the expression, the entire value starting from the position specified by start is returned. If length is negative or zero, the function returns an empty string Returns ======= From 3eb0f6dde64793404e71ca2e5fd15948fff6907e Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 29 Jun 2023 08:21:22 +0300 Subject: [PATCH 642/882] Update keywords_and_identifiers.rst --- .../sql/sql_syntax/keywords_and_identifiers.rst | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/reference/sql/sql_syntax/keywords_and_identifiers.rst b/reference/sql/sql_syntax/keywords_and_identifiers.rst index 598b12a17..efe1ba42f 100644 --- a/reference/sql/sql_syntax/keywords_and_identifiers.rst +++ b/reference/sql/sql_syntax/keywords_and_identifiers.rst @@ -1,25 +1,26 @@ .. _keywords_and_identifiers: -*************************** +*********** Identifiers -*************************** +*********** + **Identifiers** are names given to SQL entities, such as tables, columns, databases, and variables. Identifiers must be unique so that entities can be correctly identified during the execution of a program. Identifiers can also be used to change a column name in the result (column alias) in a ``SELECT`` statement. Identifiers can be either quoted or unquoted and a maximum 128 characters long. Identifiers are sometimes referred to as "names". Regular identifiers must follow these rules: -* Must not contain any special characters except for underscores (``_``). -* Must be case-insensitive. SQream converts all identifiers to lowercase unless quoted. -* Does not equal any keywords, such as ``SELECT``, ``OR``, or ``AND``, etc. +* Must not contain a whitespace character or any special characters except for underscores (``_``) +* Must be case-insensitive. SQream converts all identifiers to lowercase unless quoted +* Does not equal any keywords, such as ``SELECT``, ``OR``, or ``AND``, etc -To bypass the rules above you can surround an identifier with double quotes (``"``) or square brackets (``[]``). +To bypass the rules above you can surround an identifier with double quotes (``"``). Quoted identifiers must follow these rules: -* Must be surrounded with double quotes (``"``) or square brackets (``[]``). +* Must be surrounded with double quotes (``"``) * May contain any ASCII character except ``@``, ``$`` or ``"``. -* Must be case-sensitive and referenced with double quotes or square brackets (``[]``). +* Must be case-sensitive and referenced with double quotes (``"``) Identifiers are different than **keywords**, which are predefined words reserved with specific meanings in a statement. Some examples of keywords are ``SELECT``, ``CREATE``, and ``WHERE``. Note that keywords **cannot** be used as identifiers. From b349bf7dd640c5c5602d020197492fb631b43506 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 29 Jun 2023 17:25:57 +0300 Subject: [PATCH 643/882] flags --- .../default_graceful_shutdown_timeout_minutes.rst | 11 +++++++++++ .../healer_action_cleanup_connection.rst | 11 +++++++++++ .../healer_action_graceful_shutdown.rst | 11 +++++++++++ .../healer_detection_frequency_seconds.rst | 11 +++++------ .../healer_run_action_automatically.rst | 11 +++++++++++ configuration_guides/is_healer_on.rst | 7 +++---- .../max_connection_inactivity_seconds.rst | 12 ++++++++++++ .../max_statement_inactivity_seconds.rst | 12 ++++++++++++ 8 files changed, 76 insertions(+), 10 deletions(-) create mode 100644 configuration_guides/default_graceful_shutdown_timeout_minutes.rst create mode 100644 configuration_guides/healer_action_cleanup_connection.rst create mode 100644 configuration_guides/healer_action_graceful_shutdown.rst create mode 100644 configuration_guides/healer_run_action_automatically.rst create mode 100644 configuration_guides/max_connection_inactivity_seconds.rst create mode 100644 configuration_guides/max_statement_inactivity_seconds.rst diff --git a/configuration_guides/default_graceful_shutdown_timeout_minutes.rst b/configuration_guides/default_graceful_shutdown_timeout_minutes.rst new file mode 100644 index 000000000..dbdedcfcd --- /dev/null +++ b/configuration_guides/default_graceful_shutdown_timeout_minutes.rst @@ -0,0 +1,11 @@ +.. _default_graceful_shutdown_timeout_minutes: + +***************************************** +DEFAULT GRACEFUL SHUTDOWN TIMEOUT MINUTES +***************************************** + +The ``defaultGracefulShutdownTimeoutMinutes`` flag determines the duration of the default grace period for shutting down the system before forcefully terminating it. + +* **Data type** - size_t +* **Default value** - ``5`` +* **Allowed values** - 1-4000000000 \ No newline at end of file diff --git a/configuration_guides/healer_action_cleanup_connection.rst b/configuration_guides/healer_action_cleanup_connection.rst new file mode 100644 index 000000000..180d920df --- /dev/null +++ b/configuration_guides/healer_action_cleanup_connection.rst @@ -0,0 +1,11 @@ +.. _healer_action_cleanup_connection: + +******************************** +HEALER ACTION CLEANUP CONNECTION +******************************** + +The ``healerActionCleanupConnection`` enables the automatic cleanup of connections during the execution of healer actions, ensuring the proper management and termination of connections in the system. + +* **Data type** - Boolean +* **Default value** - ``true`` +* **Allowed values** - ``true`` or ``false`` \ No newline at end of file diff --git a/configuration_guides/healer_action_graceful_shutdown.rst b/configuration_guides/healer_action_graceful_shutdown.rst new file mode 100644 index 000000000..7787af229 --- /dev/null +++ b/configuration_guides/healer_action_graceful_shutdown.rst @@ -0,0 +1,11 @@ +.. _healer_action_graceful_shutdown: + +******************************* +HEALER ACTION GRACEFUL SHUTDOWN +******************************* + +The ``healerActionGracefulShutdown`` sets the option for performing a graceful shutdown during the execution of healer actions, allowing ongoing operations to complete before terminating the process or system. + +* **Data type** - Boolean +* **Default value** - ``false`` +* **Allowed values** - ``true`` or ``false`` \ No newline at end of file diff --git a/configuration_guides/healer_detection_frequency_seconds.rst b/configuration_guides/healer_detection_frequency_seconds.rst index 9e7805852..f64497600 100644 --- a/configuration_guides/healer_detection_frequency_seconds.rst +++ b/configuration_guides/healer_detection_frequency_seconds.rst @@ -1,14 +1,13 @@ .. _healer_detection_frequency_seconds: -************************* +********************************** Healer Detection Frequency Seconds -************************* -The ``healerDetectionFrequencySeconds`` flag is used for defining the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU. +********************************** -The following describes the ``healerDetectionFrequencySeconds`` worker level flag: +The ``healerDetectionFrequencySeconds`` flag determines the default frequency for the healer to check that its conditions are met. * **Data type** - size_t -* **Default value** - ``1`` -* **Allowed values** - 1-3600 +* **Default value** - ``60*60*24`` +* **Allowed values** - 1-4000000000 For related flags, see :ref:`is_healer_on`. \ No newline at end of file diff --git a/configuration_guides/healer_run_action_automatically.rst b/configuration_guides/healer_run_action_automatically.rst new file mode 100644 index 000000000..afb0578f9 --- /dev/null +++ b/configuration_guides/healer_run_action_automatically.rst @@ -0,0 +1,11 @@ +.. _healer_run_action_automatically: + +******************************* +HEALER RUN ACTION AUTOMATICALLY +******************************* + +The ``healerRunActionAutomatically`` flag determines whether the healer component automatically executes actions to resolve issues or requires manual intervention for each action. + +* **Data type** - Boolean +* **Default value** - ``true`` +* **Allowed values** - ``true`` or ``false`` \ No newline at end of file diff --git a/configuration_guides/is_healer_on.rst b/configuration_guides/is_healer_on.rst index 1eb0e6384..add20259f 100644 --- a/configuration_guides/is_healer_on.rst +++ b/configuration_guides/is_healer_on.rst @@ -1,11 +1,10 @@ .. _is_healer_on: -************************* +************ Is Healer On -************************* -The ``is_healer_on`` flag enables the Query Healer, which periodically examines the progress of running statements and logs statements exceeding the ``maxStatementInactivitySeconds`` flag setting. +************ -The following describes the ``is_healer_on`` flag: +The ``is_healer_on`` flag enables the Query Healer, which periodically examines the progress of running statements and logs statements exceeding the ``maxStatementInactivitySeconds`` flag setting. * **Data type** - boolean * **Default value** - ``true`` diff --git a/configuration_guides/max_connection_inactivity_seconds.rst b/configuration_guides/max_connection_inactivity_seconds.rst new file mode 100644 index 000000000..31a4f36c7 --- /dev/null +++ b/configuration_guides/max_connection_inactivity_seconds.rst @@ -0,0 +1,12 @@ +.. _max_connection_inactivity_seconds: + +******************************** +MAX CONNECTION INACTIVITY SECONDS +******************************** + +The ``maxConnectionInactivitySeconds`` determines the maximum period of session idleness, after which the connection is terminated. + +* **Data type** - size_t +* **Default value** - ``60*60*24 - 86400`` +* **Allowed values** - ``1-4000000000`` + diff --git a/configuration_guides/max_statement_inactivity_seconds.rst b/configuration_guides/max_statement_inactivity_seconds.rst new file mode 100644 index 000000000..a6e35d28c --- /dev/null +++ b/configuration_guides/max_statement_inactivity_seconds.rst @@ -0,0 +1,12 @@ +.. _max_statement_inactivity_seconds: + +******************************** +MAX STATEMENT INACTIVITY SECONDS +******************************** + +The ``maxConnectionInactivitySeconds`` determines the maximum period of session idleness, after which the connection is terminated. + +* **Data type** - size_t +* **Default value** - ``5*60*60 seconds (18000)`` +* **Allowed values** - ``1-4000000000`` + From b2e16b3e6789a781cac782c806fc7e2e35f75bf4 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 3 Jul 2023 09:05:56 +0300 Subject: [PATCH 644/882] Update current_method_configuring_your_parameter_values.rst --- ...thod_configuring_your_parameter_values.rst | 21 +++++++------------ 1 file changed, 7 insertions(+), 14 deletions(-) diff --git a/configuration_guides/current_method_configuring_your_parameter_values.rst b/configuration_guides/current_method_configuring_your_parameter_values.rst index d082db693..027a1a710 100644 --- a/configuration_guides/current_method_configuring_your_parameter_values.rst +++ b/configuration_guides/current_method_configuring_your_parameter_values.rst @@ -1,24 +1,19 @@ .. _current_method_configuring_your_parameter_values: -************************** -Configuring Your Parameter Values -************************** -The method you must use to configure your parameter values depends on the configuration level. Each configuration level has its own command or set of commands used to configure values, as shown below: +**************** +Parameter Values +**************** -+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| **Configuration Level** | -+=================================================================================================================================================================================================================================================================================================================+ -| **Regular, Worker, and Cluster** | +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ | **Command** | **Description** | **Example** | -+-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ -| ``SET <flag_name>`` | Used for modifying flag attributes. | ``SET developerMode=true`` | ++=====================================================+===========================================================================================================================================+===============================================================================================================+ +| ``SET<flag_name>`` | Used for modifying flag attributes. | ``SET enableLogDebug=false`` | +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ | ``SHOW <flag-name> / ALL`` | Used to preset either a specific flag value or all flag values. | ``SHOW <heartbeatInterval>`` | +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ | ``SHOW ALL LIKE`` | Used as a wildcard character for flag names. | ``SHOW <heartbeat*>`` | +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ -| ``show_conf_UF`` | Used to print all flags with the following attributes: | ``rechunkThreshold,90,true,RND,regular`` | +| ``SELECT show_conf() ;`` | Used to print all flags with the following attributes: | ``rechunkThreshold,90,true,RND,regular`` | | | | | | | * Flag name | | | | * Default value | | @@ -26,14 +21,12 @@ The method you must use to configure your parameter values depends on the config | | * Flag category | | | | * Flag type | | +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ -| ``show_conf_extended UF`` | Used to print all information output by the show_conf UF command, in addition to description, usage, data type, default value and range. | ``rechunkThreshold,90,true,RND,regular`` | +| ``SELECT show_conf_extended();`` | Used to print all information output by the show_conf UF command, in addition to description, usage, data type, default value and range. | ``rechunkThreshold,90,true,RND,regular`` | +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ | ``show_md_flag UF`` | Used to show a specific flag/all flags stored in the metadata file. |* Example 1: ``* master=> ALTER SYSTEM SET heartbeatTimeout=111;`` | | | |* Example 2: ``* master=> select show_md_flag(‘all’); heartbeatTimeout,111`` | | | |* Example 3: ``* master=> select show_md_flag(‘heartbeatTimeout’); heartbeatTimeout,111`` | +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ -| **Worker and Cluster** | -+-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ | ``ALTER SYSTEM SET <flag-name>`` | Used for storing or modifying flag attributes in the metadata file. | ``ALTER SYSTEM SET <heartbeatInterval=12;>`` | +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ | ``ALTER SYSTEM RESET <flag-name / ALL>`` | Used to remove a flag or all flag attributes from the metadata file. | ``ALTER SYSTEM RESET <heartbeatInterval ALTER SYSTEM RESET ALL>`` | From e1b782d9d012e485d280fdb044943cd284078ad5 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 6 Jul 2023 11:27:34 +0300 Subject: [PATCH 645/882] Update creating_your_first_table.rst --- getting_started/creating_your_first_table.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/getting_started/creating_your_first_table.rst b/getting_started/creating_your_first_table.rst index 2837907f8..05c601c3e 100644 --- a/getting_started/creating_your_first_table.rst +++ b/getting_started/creating_your_first_table.rst @@ -60,7 +60,7 @@ You can list the full, verbose ``CREATE TABLE`` statement for a table by using t .. note:: - * SQream DB identifier names such as table names and column names are not case sensitive. SQream DB lowercases all identifiers bu default. If you want to maintain case, enclose the identifiers with double-quotes. + * SQream DB identifier names such as table names and column names are not case sensitive. SQreamDB lowercases all identifiers by default. If you want to maintain case, enclose the identifiers with double-quotes. * SQream DB places all tables in the `public` schema, unless another schema is created and specified as part of the table name. For information on listing a ``CREATE TABLE`` statement, see :ref:`get_ddl`. From 08ad35b6d1973c6161afc1c70a7047685a3c46cb Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 6 Jul 2023 13:39:47 +0300 Subject: [PATCH 646/882] CRC --- reference/index.rst | 8 ++++---- .../scalar_functions/numeric/crc64.rst | 16 ++++++++-------- 2 files changed, 12 insertions(+), 12 deletions(-) diff --git a/reference/index.rst b/reference/index.rst index f1a4a600e..6187b0b1f 100644 --- a/reference/index.rst +++ b/reference/index.rst @@ -1,13 +1,13 @@ .. _reference: -************************* -Reference Guides -************************* +********** +References +********** The **Reference Guides** section provides reference for using SQream DB's interfaces and SQL features. .. toctree:: - :maxdepth: 5 + :maxdepth: 1 :caption: In this section: :glob: diff --git a/reference/sql/sql_functions/scalar_functions/numeric/crc64.rst b/reference/sql/sql_functions/scalar_functions/numeric/crc64.rst index 8d067485d..4fb4dfdc0 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/crc64.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/crc64.rst @@ -1,20 +1,20 @@ .. _crc64: -************************** +***** CRC64 -************************** +***** -Calculates the CRC-64 hash of a text expression +The ``CRC64`` function calculates the CRC-64 hash of a text expression. Syntax -========== +====== .. code-block:: postgres CRC64( expr ) --> BIGINT Arguments -============ +========= .. list-table:: :widths: auto @@ -26,17 +26,17 @@ Arguments - Text expression (``TEXT``) Returns -============ +======= Returns a CRC-64 hash of the text input, of type ``BIGINT``. .. note:: If the input value is NULL, the result is NULL. Examples -=========== +======== Calculate a CRC-64 hash of a string ---------------------------------------- +----------------------------------- .. code-block:: psql From 61248fbbda645a39230bc7b1b88fce735dfd8e7e Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 6 Jul 2023 17:05:47 +0300 Subject: [PATCH 647/882] Update sum.rst --- .../sql_functions/aggregate_functions/sum.rst | 29 +++++++++---------- 1 file changed, 14 insertions(+), 15 deletions(-) diff --git a/reference/sql/sql_functions/aggregate_functions/sum.rst b/reference/sql/sql_functions/aggregate_functions/sum.rst index 51d7f6d97..f33f0521e 100644 --- a/reference/sql/sql_functions/aggregate_functions/sum.rst +++ b/reference/sql/sql_functions/aggregate_functions/sum.rst @@ -1,14 +1,13 @@ .. _sum: -************************** +*** SUM -************************** +*** Returns the sum of numeric values, or only the distinct values. Syntax -========== - +====== .. code-block:: postgres @@ -23,7 +22,7 @@ Syntax ) Arguments -============ +========= .. list-table:: :widths: auto @@ -37,27 +36,27 @@ Arguments - Specifies that the operation should operate only on unique values Returns -============ +======= -Return type is dependant on the argument. +Return type is dependent on the argument. -* For ``TINYINT``, ``SMALLINT`` and ``INT``, the return type is ``INT``. +* For ``TINYINT``, ``SMALLINT`` and ``INT``, the return type is ``INT`` -* For ``BIGINT``, the return type is ``BIGINT``. +* For ``BIGINT``, the return type is ``BIGINT`` -* For ``REAL``, the return type is ``REAL`` +* For ``REAL``, the return type is ``DOUBLE`` * For ``DOUBLE``, rhe return type is ``DOUBLE`` Notes -======= +===== * ``NULL`` values are ignored * Because ``SUM`` returns the same data type, it can very quickly overflow on large data sets. If the SUM is over 2\ :sup:`31` for example, up-cast to a larger type like ``BIGINT``: ``SUM(expr :: BIGINT)`` Examples -=========== +======== For these examples, assume a table named ``nba``, with the following structure: @@ -85,7 +84,7 @@ Here's a peek at the table contents (:download:`Download nba.csv </_static/sampl :header-rows: 1 Simple sum -------------- +---------- .. code-block:: psql @@ -95,7 +94,7 @@ Simple sum 12311 Sum only distinct values ----------------------------- +------------------------ .. code-block:: psql @@ -105,7 +104,7 @@ Sum only distinct values 649 Combine sum with GROUP BY ------------------------------- +------------------------- .. code-block:: psql From f313db054205da0d1d2c6ff5a0627c270576534d Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 6 Jul 2023 17:47:39 +0300 Subject: [PATCH 648/882] Update regexp_replace.rst --- .../string/regexp_replace.rst | 25 +++++++++---------- 1 file changed, 12 insertions(+), 13 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/string/regexp_replace.rst b/reference/sql/sql_functions/scalar_functions/string/regexp_replace.rst index dcf0f85ce..ff3a0cc6a 100644 --- a/reference/sql/sql_functions/scalar_functions/string/regexp_replace.rst +++ b/reference/sql/sql_functions/scalar_functions/string/regexp_replace.rst @@ -1,8 +1,9 @@ .. _regexp_replace: -************************** +************** REGEXP_REPLACE -************************** +************** + The ``REGEXP_REPLACE`` function finds and replaces text column substrings using constant regexp-based patterns with constant replacement strings. For related information, see the following: @@ -11,18 +12,16 @@ For related information, see the following: * :ref:`REGEXP_INSTR<regexp_instr>` * :ref:`REGEXP_SUBSTR<regexp_substr>` - - - Syntax ------- +====== .. code-block:: postgres REGEXP_REPLACE(input, pattern [, replacement [, position [, occurrence]]]) Arguments --------------- +========= + The following table shows the ``REGEXP_REPLACE`` arguments: .. list-table:: @@ -43,7 +42,7 @@ The following table shows the ``REGEXP_REPLACE`` arguments: - (Optional) Sets a specific occurrence to replace. Using ``0`` replaces all occurrences. Test Patterns -------------- +============= .. list-table:: :widths: auto @@ -90,16 +89,17 @@ Test Patterns Any character that does not have a defined special meaning inside a [] pair matches only itself. Returns -------- +======= + The ``REGEXP_REPLACE`` function returns the replaced input value. Notes ------ +===== + The test pattern must be a literal string. Example -------- -The following is an example of the ``REGEXP_REPLACE`` function: +======= .. code-block:: @@ -115,4 +115,3 @@ Output: ------------+ SPAIN | - From 2c79294c971e8d69f9711fb83d4620b419676c9f Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 10 Jul 2023 11:35:07 +0300 Subject: [PATCH 649/882] Update hardware_guide.rst --- getting_started/hardware_guide.rst | 44 ++++++++++++++++++++---------- 1 file changed, 29 insertions(+), 15 deletions(-) diff --git a/getting_started/hardware_guide.rst b/getting_started/hardware_guide.rst index df3e4f093..ea6f3606a 100644 --- a/getting_started/hardware_guide.rst +++ b/getting_started/hardware_guide.rst @@ -1,8 +1,9 @@ .. _hardware_guide: -*********************** +************** Hardware Guide -*********************** +************** + The **Hardware Guide** describes the SQream reference architecture, emphasizing the benefits to the technical audience, and provides guidance for end-users on selecting the right configuration for a SQream installation. .. rubric:: Need help? @@ -12,7 +13,8 @@ This page is intended as a "reference" to suggested hardware. However, different Visit `SQream's support portal <https://sqream.atlassian.net/servicedesk/customer/portals>`_ for additional support. A SQream Cluster -============================ +================ + SQream recommends rackmount servers by server manufacturers Dell, Lenovo, HP, Cisco, Supermicro, IBM, and others. A typical SQream cluster includes one or more nodes, consisting of @@ -28,7 +30,8 @@ A typical SQream cluster includes one or more nodes, consisting of * High density chassis design, offering between 2 and 4 GPUs in a 1U, 2U, or 3U package, for best-in-class performance per cm\ :sup:`2`. Single-Node Cluster Example ------------------------------------ +--------------------------- + A single-node SQream cluster can handle between 1 and 8 concurrent users, with up to 1PB of data storage (when connected via NAS). An average single-node cluster can be a rackmount server or workstation, containing the following components: @@ -63,7 +66,8 @@ In this system configuration, SQream can store about 100TB of raw data (assuming If a NAS is used, the 10x SSD drives can be omitted, but SQream recommends 2TB of local spool space on SSD or NVMe drives. Multi-Node Cluster Examples ------------------------------------ +--------------------------- + Multi-node clusters can handle any number of concurrent users. A typical SQream cluster relies on a minimum of two GPU-enabled servers and shared storage connected over a network fabric, such as InfiniBand EDR, 40GbE, or 100GbE. The **Multi-Node Cluster Examples** section describes the following specifications: @@ -73,7 +77,8 @@ The **Multi-Node Cluster Examples** section describes the following specificatio :depth: 1 Hardware Specifications -~~~~~~~~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~ + The following table shows SQream's recommended hardware specifications: .. list-table:: @@ -102,7 +107,8 @@ The following table shows SQream's recommended hardware specifications: - Red Hat Enterprise Linux v7.x or CentOS v7.x or Amazon Linux Metadata Specifications -~~~~~~~~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~ + The following table shows SQream's recommended metadata server specifications: .. list-table:: @@ -129,7 +135,8 @@ The following table shows SQream's recommended metadata server specifications: .. note:: With a NAS connected over GPFS, Lustre, Weka, or VAST, each SQream worker can read data at up to 5GB/s. SQream Studio Server Example ------------------------------------ +---------------------------- + The following table shows SQream's recommended Studio server specifications: .. list-table:: @@ -150,7 +157,8 @@ The following table shows SQream's recommended Studio server specifications: - Red Hat Enterprise Linux v7.x or CentOS v7.x Cluster Design Considerations -==================================== +============================= + This section describes the following cluster design considerations: * In a SQream installation, the storage and compute are logically separated. While they may reside on the same machine in a standalone installation, they may also reside on different hosts, providing additional flexibility and scalability. @@ -168,7 +176,8 @@ This section describes the following cluster design considerations: * When using NAS devices, SQream recommends approximately 5GB/s of burst throughput from storage per GPU. Balancing Cost and Performance --------------------------------- +------------------------------ + Prior to designing and deploying a SQream cluster, a number of important factors must be considered. The **Balancing Cost and Performance** section provides a breakdown of deployment details to ensure that this installation exceeds or meets the stated requirements. The rationale provided includes the necessary information for modifying configurations to suit the customer use-case scenario, as shown in the following table: @@ -195,23 +204,27 @@ The **Balancing Cost and Performance** section provides a breakdown of deploymen - Balance price and performance CPU Compute -------------- +----------- + SQream relies on multi-core Intel Gold Xeon processors or IBM POWER9 processors, and recommends a dual-socket machine populated with CPUs with 18C/36HT or better. While a higher core count may not necessarily affect query performance, more cores will enable higher concurrency and better load performance. GPU Compute and RAM -------------------------- +------------------- + The NVIDIA Tesla range of high-throughput GPU accelerators provides the best performance for enterprise environments. Most cards have ECC memory, which is crucial for delivering correct results every time. SQream recommends the NVIDIA Tesla A100 40GB or H100 GPU for best performance and highest concurrent user support. GPU RAM, sometimes called GRAM or VRAM, is used for processing queries. It is possible to select GPUs with less RAM. However, the smaller GPU RAM results in reduced concurrency, as the GPU RAM is used extensively in operations like JOINs, ORDER BY, GROUP BY, and all SQL transforms. RAM --------- +--- + SQream requires using **Error-Correcting Code memory (ECC)**, standard on most enterprise servers. Large amounts of memory are required for improved performance for heavy external operations, such as sorting and joining. SQream recommends at least 256GB of RAM per GPU on your machine. Operating System ---------------------- +---------------- + SQream can run on the following 64-bit Linux operating systems: * Red Hat Enterprise Linux (RHEL) v7 @@ -220,7 +233,8 @@ SQream can run on the following 64-bit Linux operating systems: * Other Linux distributions may be supported via nvidia-docker Storage ------------ +------- + For clustered scale-out installations, SQream relies on NAS storage. For stand-alone installations, SQream relies on redundant disk configurations, such as RAID 5, 6, or 10. These RAID configurations replicate blocks of data between disks to avoid data loss or system unavailability. SQream recommends using enterprise-grade SAS SSD or NVMe drives. For a 32-user configuration, the number of GPUs should roughly match the number of users. SQream recommends 1 Tesla A100 GPU or H100 per 2 users, for full, uninterrupted dedicated access. From 700c1c48db36ef2b4a1dc9e371460236453bf74a Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 11 Jul 2023 18:00:18 +0300 Subject: [PATCH 650/882] Update index.rst --- loading_and_unloading_data/index.rst | 31 ++++++++++++++-------------- 1 file changed, 16 insertions(+), 15 deletions(-) diff --git a/loading_and_unloading_data/index.rst b/loading_and_unloading_data/index.rst index bc515f023..72a698dc1 100644 --- a/loading_and_unloading_data/index.rst +++ b/loading_and_unloading_data/index.rst @@ -1,36 +1,37 @@ .. _loading_and_unloading_data: -*********************** +************************** Loading and Unloading Data -*********************** +************************** + The **Loading Data** section describes concepts and operations related to importing data into your SQream database: -* `Overview of loading data <https://docs.sqream.com/en/v2022.1/data_ingestion/inserting_data.html>`_ - Describes best practices and considerations for loading data into SQream from a variety of sources and locations. +* :ref:`Overview of loading data <inserting_data>` - Describes best practices and considerations for loading data into SQream from a variety of sources and locations. -* `Alternatives to loading data (foreign tables) <https://docs.sqream.com/en/v2022.1/operational_guides/foreign_tables.html>`_ - Useful for running queries directly on external data without importing into your SQream database. +* :ref:`Alternatives to loading data (foreign tables) <foreign_tables>` - Useful for running queries directly on external data without importing into your SQream database. -* `Supported data types <https://docs.sqream.com/en/v2022.1/data_type_guides/supported_data_types.html>`_ - Overview of supported data types, including descriptions, examples, and relevant aliases. +* :ref:`Supported data types <supported_data_types>` - Overview of supported data types, including descriptions, examples, and relevant aliases. -* `Ingesting data from external sources <https://docs.sqream.com/en/v2022.1/data_ingestion/index.html>`_ - List of data ingestion sources that SQream supports. +* :ref:`Ingesting data from external sources <data_ingestion>` - List of data ingestion sources that SQream supports. -* `Inserting data from external tables <https://docs.sqream.com/en/v2022.1/reference/sql/sql_statements/dml_commands/insert.html#insert>`_ - Inserts one or more rows into a table. +* :ref:`Inserting data from external tables <insert>` - Inserts one or more rows into a table. -* `Ingesting data from third party client platforms <https://docs.sqream.com/en/v2022.1/third_party_tools/client_platforms/index.html>`_ - Gives you direct access to a variety of drivers, connectors, tools, vizualisers, and utilities.. +* :ref:`Ingesting data from third party client platforms <client_platforms>` - Gives you direct access to a variety of drivers, connectors, tools, visualizers, and utilities.. -* `Using the COPY FROM statement <https://docs.sqream.com/en/v2022.1/reference/sql/sql_statements/dml_commands/copy_from.html>`_ - Used for loading data from files located on a filesystem into SQream tables. +* :ref:`Using the COPY FROM statement <copy_from>` - Used for loading data from files located on a filesystem into SQream tables. -* `Importing data using Studio <https://docs.sqream.com/en/v2022.1/sqream_studio_5.4.3/executing_statements_and_running_queries_from_the_editor.html#performing-statement-related-operations-from-the-database-tree>`_ - SQream's web-based client providing users with all functionality available from the command line in an intuitive and easy-to-use format. +* :ref:`Importing data using Studio <executing_statements_and_running_queries_from_the_editor>` - SQream's web-based client providing users with all functionality available from the command line in an intuitive and easy-to-use format. -* `Loading data using Amazon S3 <https://docs.sqream.com/en/v2022.1/operational_guides/s3.html>`_ - Used for loading data from Amazon S3. +* :ref:`Loading data using Amazon S3 <s3>` - Used for loading data from Amazon S3. * Troubleshooting - Describes troubleshooting solutions related to importing data from the following: - * `SAS Viya <https://docs.sqream.com/en/v2022.1/troubleshooting/sas_viya_related_issues.html>`_ + * :ref:`SAS Viya <connect_to_sas_viya>` - * `Tableau <https://docs.sqream.com/en/v2022.1/troubleshooting/tableau_related_issues.html>`_ + * :ref:`Tableau <tableau>` The **Unloading Data** section describes concepts and operations related to exporting data from your SQream database: -* `Overview of unloading data <https://docs.sqream.com/en/v2022.1/operational_guides/external_tables.html>`_ - Describes best practices and considerations for unloading data from SQream to a variety of sources and locations. +* :ref:`Overview of unloading data <foreign_tables>` - Describes best practices and considerations for unloading data from SQream to a variety of sources and locations. -* `The COPY TO statement <https://docs.sqream.com/en/v2022.1/reference/sql/sql_statements/dml_commands/copy_to.html>`_ - Used for unloading data from a SQream database table or query to a file on a filesystem. \ No newline at end of file +* :ref:`The COPY TO statement <copy_to>` - Used for unloading data from a SQream database table or query to a file on a filesystem. \ No newline at end of file From 0a8abdbd4990859e34706b693832de1b42058606 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 17 Jul 2023 15:24:36 +0300 Subject: [PATCH 651/882] Update index.rst --- loading_and_unloading_data/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/loading_and_unloading_data/index.rst b/loading_and_unloading_data/index.rst index 72a698dc1..88ee2d47a 100644 --- a/loading_and_unloading_data/index.rst +++ b/loading_and_unloading_data/index.rst @@ -6,7 +6,7 @@ Loading and Unloading Data The **Loading Data** section describes concepts and operations related to importing data into your SQream database: -* :ref:`Overview of loading data <inserting_data>` - Describes best practices and considerations for loading data into SQream from a variety of sources and locations. +* :ref:`Overview of loading data <ingesting_data>` - Describes best practices and considerations for loading data into SQream from a variety of sources and locations. * :ref:`Alternatives to loading data (foreign tables) <foreign_tables>` - Useful for running queries directly on external data without importing into your SQream database. From 6415fe5f5153b255d466b842d9608b5ac2378657 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 18 Jul 2023 08:50:58 +0300 Subject: [PATCH 652/882] Update 404.rst --- 404.rst | 18 +++++++----------- 1 file changed, 7 insertions(+), 11 deletions(-) diff --git a/404.rst b/404.rst index aa18f4738..44f92acfd 100644 --- a/404.rst +++ b/404.rst @@ -1,18 +1,14 @@ :orphan: -********************************* - Couldn't find the page - 404 -********************************* +************************** +Page Cannot Be Found - 404 +************************** -Unfortunately we could not find this page. - -Use the **search bar**, or use the navigation sidebar to find what you're looking for. - -.. rubric:: Looking for the old documentation? - -If you're looking for an older version of the documentation, versions 1.10 through 2019.2.1 are available at http://previous.sqream.com . +Use the **Search docs** bar, or use the navigation sidebar to find what you're looking for. .. rubric:: Need help? -If you couldn't find what you're looking for, we're always happy to help. Visit `SQream's support portal <https://support.sqream.com>`_ for additional support. +If you couldn't find what you're looking for, we're always happy to help. + +Visit the `SQreamDB support portal <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_ for additional help. From 66de603d45ccf2cc5c70ddfa43b2f9dc03fe566e Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 18 Jul 2023 09:42:00 +0300 Subject: [PATCH 653/882] SEO --- connecting_to_sqream/index.rst | 9 ++-- data_ingestion/index.rst | 2 +- .../executing_statements_in_sqream.rst | 21 ++++++--- getting_started/installing_sqream.rst | 21 ++++++--- reference/cli/sqream_sql.rst | 46 +++++++++---------- sqream_studio_5.4.7/index.rst | 7 +-- 6 files changed, 62 insertions(+), 44 deletions(-) diff --git a/connecting_to_sqream/index.rst b/connecting_to_sqream/index.rst index 10533b0ac..fb88022e0 100644 --- a/connecting_to_sqream/index.rst +++ b/connecting_to_sqream/index.rst @@ -1,9 +1,10 @@ .. _connecting_to_sqream: -************************* -Connecting to SQream -************************* -SQream supports the most common database tools and interfaces, giving you direct access through a variety of drivers, connectors, and visualization tools and utilities. The tools described on this page have been tested and approved for use with SQream. +********************** +Connecting to SQreamDB +********************** + +SQreamDB supports the most common database tools and interfaces, giving you direct access through a variety of drivers, connectors, and visualization tools and utilities. The tools described on this page have been tested and approved for use with SQreamDB. .. toctree:: :maxdepth: 2 diff --git a/data_ingestion/index.rst b/data_ingestion/index.rst index 290e0fce3..8bb8d9aeb 100644 --- a/data_ingestion/index.rst +++ b/data_ingestion/index.rst @@ -16,4 +16,4 @@ The **Data Ingestion Sources** page provides information about the following: orc json -For information about database tools and interfaces that SQream supports, see `Third Party Tools <https://docs.sqream.com/en/v2022.1.1/connecting_to_sqream/index.html>`_. \ No newline at end of file +For information about database tools and interfaces that SQream supports, see :ref:`Third Party Tools <connecting_to_sqream>`. \ No newline at end of file diff --git a/getting_started/executing_statements_in_sqream.rst b/getting_started/executing_statements_in_sqream.rst index 26916f1e6..a9fb5e7a5 100644 --- a/getting_started/executing_statements_in_sqream.rst +++ b/getting_started/executing_statements_in_sqream.rst @@ -1,10 +1,19 @@ .. _executing_statements_in_sqream: -**************************** -Executing Statements in SQream -**************************** -You can execute statements in SQream using one of the following tools: +******************************** +Executing Statements in SQreamDB +******************************** -* `SQream SQL CLI <https://docs.sqream.com/en/latest/reference/cli/sqream_sql.html>`_ - a command line interface -* `SQream Acceleration Studio <https://docs.sqream.com/en/latest/sqream_studio_5.4.3/index.html>`_ - an intuitive and easy-to-use interface. +You may choose one of the following tools for executing statements in SQreamDB: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Tool + - Description + * - :ref:`SQream SQL CLI <sqream_sql_cli_reference>` + - A command line interface + * - :ref:`SQreamDB Acceleration Studio <sqream_studio_>` + - An intuitive and easy-to-use interface diff --git a/getting_started/installing_sqream.rst b/getting_started/installing_sqream.rst index 2ed54c1ab..fef12ab36 100644 --- a/getting_started/installing_sqream.rst +++ b/getting_started/installing_sqream.rst @@ -1,11 +1,18 @@ .. _installing_sqream: -**************************** -Installing SQream -**************************** +******************* +Installing SQreamDB +******************* -The **Installing SQream** section includes the following SQream installation methods: +You may choose one of the following installation methods: -* `Installing SQream natively <https://docs.sqream.com/en/latest/installation_guides/installing_sqream_with_binary.html>`_ - Describes installing SQream using binary packages provided by SQream. -* `Installing SQream with Kubernetes <https://docs.sqream.com/en/latest/installation_guides/installing_sqream_with_kubernetes.html>`_ - Describes installing SQream using the Kubernetes open source platform. -* `Installing and running SQream in a Docker container <https://docs.sqream.com/en/latest/installation_guides/running_sqream_in_a_docker_container.html>`_ - Describes how to run SQream in a Docker container. \ No newline at end of file +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Method + - Description + * - :ref:`Installing SQreamDB natively <installing_sqream_with_binary>` + - Describes installing SQreamDB using binary packages provided by SQreamDB + * - :ref:`Installing SQreamDB with Kubernetes <installing_sqream_with_kubernetes>` + - Describes installing SQreamDB using the Kubernetes open source platform diff --git a/reference/cli/sqream_sql.rst b/reference/cli/sqream_sql.rst index a4af489cf..b9feff992 100644 --- a/reference/cli/sqream_sql.rst +++ b/reference/cli/sqream_sql.rst @@ -1,8 +1,8 @@ .. _sqream_sql_cli_reference: -********************************* +************************ Sqream SQL CLI Reference -********************************* +************************ SQream DB comes with a built-in client for executing SQL statements either interactively or from the command-line. @@ -12,7 +12,7 @@ This page serves as a reference for the options and parameters. Learn more about :local: Installing Sqream SQL -========================= +===================== If you have a SQream DB installation on your server, ``sqream sql`` can be found in the ``bin`` directory of your SQream DB installation, under the name ``sqream``. @@ -41,7 +41,7 @@ To run ``sqream sql`` on any other Linux host: master=> _ Troubleshooting Sqream SQL Installation -------------------------------------------- +--------------------------------------- Upon running sqream sql for the first time, you may get an error ``error while loading shared libraries: libtinfo.so.5: cannot open shared object file: No such file or directory``. @@ -70,12 +70,12 @@ Solving this error requires installing the ncruses or libtinfo libraries, depend ``$ sudo ln -s /usr/lib64/libtinfo.so.6 /usr/lib64/libtinfo.so.5`` Using Sqream SQL -================= +================ By default, sqream sql runs in interactive mode. You can issue commands or SQL statements. Running Commands Interactively (SQL shell) --------------------------------------------- +------------------------------------------ When starting sqream sql, after entering your password, you are presented with the SQL shell. @@ -139,7 +139,7 @@ The prompt for a multi-line statement will change from ``=>`` to ``.``, to alert Executing Batch Scripts (``-f``) ---------------------------------- +-------------------------------- To run an SQL script, use the ``-f <filename>`` argument. @@ -152,7 +152,7 @@ For example, .. tip:: Output can be saved to a file by using redirection (``>``). Executing Commands Immediately (``-c``) -------------------------------------------- +--------------------------------------- To run a statement from the console, use the ``-c <statement>`` argument. @@ -173,10 +173,10 @@ For example, Examples -=========== +======== Starting a Regular Interactive Shell ------------------------------------ +------------------------------------ Connect to local server 127.0.0.1 on port 5000, to the default built-in database, `master`: @@ -203,7 +203,7 @@ Connect to local server 127.0.0.1 via the built-in load balancer on port 3108, t master=>_ Executing Statements in an Interactive Shell ------------------------------------------------ +-------------------------------------------- Note that all SQL commands end with a semicolon. @@ -256,7 +256,7 @@ Executing SQL Statements from the Command Line .. _controlling_output: Controlling the Client Output ----------------------------------------- +----------------------------- Two parameters control the dispay of results from the client: @@ -264,7 +264,7 @@ Two parameters control the dispay of results from the client: * ``--delimiter`` - changes the record delimiter Exporting SQL Query Results to CSV -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Using the ``--results-only`` flag removes the row counts and timing. @@ -278,7 +278,7 @@ Using the ``--results-only`` flag removes the row counts and timing. 4,bull ,1 Changing a CSV to a TSV -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^ The ``--delimiter`` parameter accepts any printable character. @@ -318,7 +318,7 @@ Assuming a file containing SQL statements (separated by semicolons): time: 0.090697s Connecting Using Environment Variables -------------------------------------- +-------------------------------------- You can save connection parameters as environment variables: @@ -329,7 +329,7 @@ You can save connection parameters as environment variables: $ sqream sql --port=3105 --clustered --username=$SQREAM_USER -d $SQREAM_DATABASE Connecting to a Specific Queue ------------------------------------ +------------------------------ When using the :ref:`dynamic workload manager<workload_manager>` - connect to ``etl`` queue instead of using the default ``sqream`` queue. @@ -345,10 +345,10 @@ When using the :ref:`dynamic workload manager<workload_manager>` - connect to `` Operations and Flag References -=============================== +============================== Command Line Arguments ------------------------ +---------------------- **Sqream SQL** supports the following command line arguments: @@ -401,7 +401,7 @@ Command Line Arguments .. _supported_record_delimiters: Supported Record Delimiters -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^ The supported record delimiters are printable ASCII values (32-126). @@ -410,7 +410,7 @@ The supported record delimiters are printable ASCII values (32-126). * The following characters are **not supported**: ``\``, ``N``, ``-``, ``:``, ``"``, ``\n``, ``\r``, ``.``, lower-case latin letters, digits (0-9) Meta-Commands ----------------- +------------- * Meta-commands in Sqream SQL start with a backslash (``\``) @@ -436,7 +436,7 @@ Meta-Commands - Changes the current connection to an alternate database Basic Commands ------------------------ +-------------- .. list-table:: :widths: 20 30 50 @@ -456,7 +456,7 @@ Basic Commands Moving Around the Command Line ---------------------------------- +------------------------------ .. list-table:: :widths: 17 83 @@ -498,7 +498,7 @@ Moving Around the Command Line - Swaps a character at the cursor with the previous character. Searching ------------- +--------- .. list-table:: :widths: 17 83 diff --git a/sqream_studio_5.4.7/index.rst b/sqream_studio_5.4.7/index.rst index 17c7ae05c..de8138b89 100644 --- a/sqream_studio_5.4.7/index.rst +++ b/sqream_studio_5.4.7/index.rst @@ -1,9 +1,10 @@ .. _sqream_studio_: -********************************** +******************************** SQream Acceleration Studio 5.4.7 -********************************** -The SQream Acceleration Studio 5.4.7 is a web-based client for use with SQream. Studio provides users with all functionality available from the command line in an intuitive and easy-to-use format. This includes running statements, managing roles and permissions, and managing SQream clusters. +******************************** + +The SQreamDB Acceleration Studio 5.4.7 is a web-based client for use with SQreamDB. Studio provides users with all functionality available from the command line in an intuitive and easy-to-use format. This includes running statements, managing roles and permissions, and managing SQreamDB clusters. This section describes how to use the SQream Accleration Studio version 5.4.7: From ff89623f038ec0e09dcd3358c9902de468eba0cb Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 18 Jul 2023 09:43:42 +0300 Subject: [PATCH 654/882] Update index.rst --- data_ingestion/index.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/data_ingestion/index.rst b/data_ingestion/index.rst index 8bb8d9aeb..cf107b3d9 100644 --- a/data_ingestion/index.rst +++ b/data_ingestion/index.rst @@ -1,8 +1,9 @@ .. _data_ingestion: -************************* +********************** Data Ingestion Sources -************************* +********************** + The **Data Ingestion Sources** page provides information about the following: .. toctree:: @@ -16,4 +17,5 @@ The **Data Ingestion Sources** page provides information about the following: orc json + For information about database tools and interfaces that SQream supports, see :ref:`Third Party Tools <connecting_to_sqream>`. \ No newline at end of file From 8f6895b4ece6814a0bd6bb292d4d510ed32be3ef Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 18 Jul 2023 09:52:03 +0300 Subject: [PATCH 655/882] Update executing_statements_and_running_queries_from_the_editor.rst --- ...ts_and_running_queries_from_the_editor.rst | 58 ++++++++++++------- 1 file changed, 37 insertions(+), 21 deletions(-) diff --git a/sqream_studio_5.4.7/executing_statements_and_running_queries_from_the_editor.rst b/sqream_studio_5.4.7/executing_statements_and_running_queries_from_the_editor.rst index 882b226e0..22666c2bd 100644 --- a/sqream_studio_5.4.7/executing_statements_and_running_queries_from_the_editor.rst +++ b/sqream_studio_5.4.7/executing_statements_and_running_queries_from_the_editor.rst @@ -2,9 +2,10 @@ .. _editor_top_5.4.7: -**************************** +******************************************************** Executing Statements and Running Queries from the Editor -**************************** +******************************************************** + The **Editor** is used for the following: * Selecting an active database and executing queries. @@ -42,7 +43,8 @@ The following is a brief description of the Editor panels: .. _studio_5.4.7_editor_toolbar: Executing Statements from the Toolbar -================ +===================================== + You can access the following from the Toolbar pane: * **Database dropdown list** - select a database that you want to run statements on. @@ -82,7 +84,8 @@ For more information on stopping active statements, see the :ref:`STOP_STATEMENT .. _studio_5.4.7_editor_db_tree: Performing Statement-Related Operations from the Database Tree -================ +============================================================== + From the Database Tree you can perform statement-related operations and show metadata (such as a number indicating the amount of rows in the table). @@ -207,8 +210,9 @@ The database object functions are used to perform the following: - The `DDL Optimizer <https://docs.sqream.com/en/latest/sqream_studio_5.4.7/executing_statements_and_running_queries_from_the_editor.html#optimizing-database-tables-using-the-ddl-optimizer>`_ lets you analyze database tables and recommends possible optimizations. Optimizing Database Tables Using the DDL Optimizer ------------------------ -The **DDL Optimizer** tab analyzes database tables and recommends possible optimizations according to SQream's best practices. +-------------------------------------------------- + +The **DDL Optimizer** tab analyzes database tables and recommends possible optimizations according to SQreamDB's best practices. As described in the previous table, you can access the DDL Optimizer by clicking the **additional options icon** and selecting **DDL Optimizer**. @@ -232,21 +236,23 @@ Clicking **Run Optimizer** adds a tab to the Statement panel showing the optimiz For more information, see `Optimization and Best Practices <https://docs.sqream.com/en/latest/operational_guides/optimization_best_practices.html>`_. Executing Pre-Defined Queries from the System Queries Panel ---------------- +----------------------------------------------------------- + The **System Queries** panel lets you execute predefined queries and includes the following system query types: * **Catalog queries** - Used for analyzing table compression rates, users and permissions, etc. :: -* **Admin queries** - Queries useful for SQream database management. +* **Admin queries** - Queries useful for SQreamDB database management. Clicking an item pastes the query into the Statement pane, and you can undo a previous operation by pressing **Ctrl + Z**. .. _studio_5.4.7_editor_statement_area: Writing Statements and Queries from the Statement Panel -============== +======================================================= + The multi-tabbed statement area is used for writing queries and statements, and is used in tandem with the toolbar. When writing and executing statements, you must first select a database from the **Database** dropdown menu in the toolbar. When you execute a statement, it passes through a series of statuses until completed. Knowing the status helps you with statement maintenance, and the statuses are shown in the **Results panel**. The auto-complete feature assists you when writing statements by suggesting statement options. @@ -274,11 +280,11 @@ You can add and name new tabs for each statement that you need to execute, and S You can also rename the default tab name by double-clicking it and typing a new name and write multiple statements in tandem in the same tab by separating them with semicolons (``;``).If too many tabs to fit into the Statement Pane are open at the same time, the tab arrows are displayed. You can scroll through the tabs by clicking |icon-left| or |icon-right|, and close tabs by clicking |icon-close|. You can also close all tabs at once by clicking **Close all** located to the right of the tabs. -.. tip:: If this is your first time using SQream, see `Getting Started <https://docs.sqream.com/en/latest/first_steps.html#first-steps>`_. +.. tip:: If this is your first time using SQreamDB, see :ref:`Getting Started <getting_started>`. .. Keyboard shortcuts -.. ^^^^^^^^^^^^^^^^^^^^^^^^^ +.. ^^^^^^^^^^^^^^^^^^ .. :kbd:`Ctrl` +: kbd:`Enter` - Execute all queries in the statement area, or just the highlighted part of the query. @@ -297,7 +303,8 @@ You can also rename the default tab name by double-clicking it and typing a new .. _results_panel_5.4.7: Viewing Statement and Query Results from the Results Panel -============== +========================================================== + The results panel shows statement and query results. By default, only the first 10,000 results are returned, although you can modify this from the :ref:`studio_editor_toolbar`, as described above. By default, executing several statements together opens a separate results tab for each statement. Executing statements together executes them serially, and any failed statement cancels all subsequent executions. .. image:: /_static/images/results_panel.png @@ -323,7 +330,8 @@ The following is a brief description of the Results panel views highlighted in t :ref:`Back to Executing Statements and Running Queries from the Editor<editor_top_5.4.7>` Searching Query Results in the Results View ----------------- +------------------------------------------- + The **Results view** lets you view search query results. From this view you can also do the following: @@ -335,13 +343,15 @@ From this view you can also do the following: * Sort column results. Saving Results to the Clipboard -^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + The **Save results to clipboard** function lets you save your results to the clipboard to paste into another text editor or into Excel for further analysis. .. _save_results_to_local_file_5.4.7: Saving Results to a Local File -^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + The **Save results to local file** functions lets you save your search query results to a local file. Clicking **Save results to local file** downloads the contents of the Results panel to an Excel sheet. You can then use copy and paste this content into other editors as needed. In the Results view you can also run parallel statements, as described in **Running Parallel Statements** below. @@ -349,7 +359,8 @@ In the Results view you can also run parallel statements, as described in **Runn .. _running_parallel_statements_5.4.7: Running Parallel Statements -^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^ + While Studio's default functionality is to open a new tab for each executed statement, Studio supports running parallel statements in one statement tab. Running parallel statements requires using macros and is useful for advanced users. The following shows the syntax for running parallel statements: @@ -371,7 +382,8 @@ The following shows the syntax for running parallel statements: .. _execution_tree_5.4.7: Execution Details View --------------- +---------------------- + The **Execution Details View** section describes the following: .. contents:: @@ -379,7 +391,8 @@ The **Execution Details View** section describes the following: :depth: 1 Overview -^^^^^^^^^^^^ +^^^^^^^^ + Clicking **Execution Details View** displays the **Execution Tree**, which is a chronological tree of processes that occurred to execute your queries. The purpose of the Execution Tree is to analyze all aspects of your query for troubleshooting and optimization purposes, such as resolving queries with an exceptionally long runtime. .. note:: The **Execution Details View** button is enabled only when a query takes longer than five seconds. @@ -415,7 +428,8 @@ Each node displays a number displaying its **node ID**, its **type**, **table na .. image:: /_static/images/nodes.png Viewing Query Statistics -^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^ + The following statistical information is displayed in the top left corner, as shown in the figure above: * **Query Statistics**: @@ -460,7 +474,8 @@ Note that you can scroll the Node Statistics table. You can also download the ex :align: middle Using the Plain View -^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^ + You can use the **Plain View** instead of viewing the execution tree by clicking **Plain View** |icon-plain| in the top right corner. The plain view displays the same information as shown in the execution tree in table format. .. |icon-plain| image:: /_static/images/studio_icon_plain.png @@ -482,7 +497,8 @@ This can be seen in the **timeSum** column as follows: .. _sql_view_5.4.7: Viewing Wrapped Strings in the SQL View ------------------- +--------------------------------------- + The SQL View panel allows you to more easily view certain queries, such as a long string that appears on one line. The SQL View makes it easier to see by wrapping it so that you can see the entire string at once. It also reformats and organizes query syntax entered in the Statement panel for more easily locating particular segments of your queries. The SQL View is identical to the **Format SQL** feature in the Toolbar, allowing you to retain your originally constructed query while viewing a more intuitively structured snapshot of it. .. _save_results_to_clipboard_5.4.7: From d308df47f9a807ee65bc0e1d02866be8707522a4 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 18 Jul 2023 09:52:35 +0300 Subject: [PATCH 656/882] Update index.rst --- getting_started/index.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/getting_started/index.rst b/getting_started/index.rst index 87b98870d..36f2c3296 100644 --- a/getting_started/index.rst +++ b/getting_started/index.rst @@ -1,9 +1,10 @@ .. _getting_started: -************************* +*************** Getting Started -************************* -The **Getting Started** page describes the following things you need to start using SQream: +*************** + +The **Getting Started** page describes the following things you need to start using SQreamDB: .. toctree:: :maxdepth: 1 From c6f0f4394f60956e7e5918676516933e09f97ae3 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 20 Jul 2023 13:51:17 +0300 Subject: [PATCH 657/882] Update subqueries.rst --- reference/sql/sql_syntax/subqueries.rst | 58 +++++++++++++++++-------- 1 file changed, 39 insertions(+), 19 deletions(-) diff --git a/reference/sql/sql_syntax/subqueries.rst b/reference/sql/sql_syntax/subqueries.rst index 7f788ff46..739098db6 100644 --- a/reference/sql/sql_syntax/subqueries.rst +++ b/reference/sql/sql_syntax/subqueries.rst @@ -1,26 +1,22 @@ .. _subqueries: -*************************** +********** Subqueries -*************************** +********** -Subqueries allows you to reuse of results from another query. +Subqueries enable the reuse of results of other queries. -SQream DB supports relational (also called *derived table*) subqueries, which appear as :ref:`select` queries as part of a table expression. +SQreamDB supports relational (also called *derived table*) subqueries, which appear as :ref:`select` queries as part of a table expression. -SQream DB also supports :ref:`common_table_expressions`, which are a form of subquery. With CTEs, a subquery can be named for reuse in a query. +SQreamDB also supports :ref:`common_table_expressions`, which are a form of subquery. With CTEs, a subquery can be named for reuse in a query. .. note:: - * SQream DB does not currently support correlated subqueries or scalar subqueries. - * There is no limit to the number of subqueries or nesting limits in a statement - - - + You may include an unlimited number of subqueries within a single SQL statement, and you can also nest subqueries to an unlimited depth Table Subqueries -=========================== +================ The following is an example of table named ``nba`` with the following structure: @@ -48,13 +44,14 @@ To see the table contents, click :download:`Download nba.csv </_static/samples/n :header-rows: 1 Scalar Subqueries -=================== +================= + The following are examples of scalar subqueries. Simple Subquery ------------------- +--------------- -.. code-block:: psql +.. code-block:: sql t=> SELECT AVG("Age") FROM . (SELECT "Name","Team","Age" FROM nba WHERE "Height" > '7-0'); @@ -63,9 +60,9 @@ Simple Subquery 26 Combining a Subquery with a Join ----------------------------------- +-------------------------------- -.. code-block:: psql +.. code-block:: sql t=> SELECT * FROM . (SELECT "Name" FROM nba WHERE "Height" > '7-0') AS t(name) @@ -89,11 +86,11 @@ Combining a Subquery with a Join Walter Tavares | Walter Tavares | Atlanta Hawks | 22 | C | 24 | 7-3 | 260 | \N | 1000000 ``WITH`` subqueries ---------------------- +------------------- See :ref:`common_table_expressions` for more information. -.. code-block:: psql +.. code-block:: sql nba=> WITH . nba_ct AS (SELECT "Name", "Team" FROM nba WHERE "College"='Connecticut'), @@ -102,4 +99,27 @@ See :ref:`common_table_expressions` for more information. Name | Team | name0 | team0 ----------------+-----------------+----------------+---------------- Stanley Johnson | Detroit Pistons | Andre Drummond | Detroit Pistons - Aaron Gordon | Orlando Magic | Shabazz Napier | Orlando Magic \ No newline at end of file + Aaron Gordon | Orlando Magic | Shabazz Napier | Orlando Magic + +Correlated subqueries +===================== + +Correlated subqueries are currently not supported. However, you may use the following workaround: + +.. code-block:: sql + + # Unsupported correlated subquery + + SELECT + x,y,z + FROM + t + where x in ( select x from t1 ); + + # Correlated subquery workaround + + SELECT + x,y,z + FROM + t + JOIN (select x from t1) t1 on t.x = t1.x; \ No newline at end of file From 8e4a745a63cd08e01ef4968759243a80b4b48b35 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 20 Jul 2023 14:18:51 +0300 Subject: [PATCH 658/882] SEO --- configuration_guides/admin_worker_flags.rst | 18 ++++---- configuration_guides/generic_worker_flags.rst | 7 ++-- configuration_guides/login_max_retries.rst | 5 ++- glossary.rst | 4 +- .../user_defined_functions/scalar_sql_udf.rst | 2 +- releases/2022.1.1.rst | 42 ++++++++++++------- releases/2022.1.2.rst | 31 +++++++++----- 7 files changed, 65 insertions(+), 44 deletions(-) diff --git a/configuration_guides/admin_worker_flags.rst b/configuration_guides/admin_worker_flags.rst index 130131b57..144255abb 100644 --- a/configuration_guides/admin_worker_flags.rst +++ b/configuration_guides/admin_worker_flags.rst @@ -1,8 +1,8 @@ .. _admin_worker_flags: -************************* +*************************** Worker Administration Flags -************************* +*************************** .. |icon-new_gray_2022.1.1| image:: /_static/images/new_gray_2022.1.1.png :align: middle @@ -11,10 +11,10 @@ Worker Administration Flags The **Worker Administration Flags** page describes **Worker** modification type flags, which can be modified by administrators on a session and cluster basis using the ``ALTER SYSTEM SET`` command: -* `Setting Total Device Memory Usage in SQream Instance <https://docs.sqream.com/en/v2022.1.2/configuration_guides/cuda_mem_quota.html>`_ -* `Enabling Manually Setting Reported IP <https://docs.sqream.com/en/v2022.1.2/configuration_guides/machine_ip.html>`_ -* `Setting Port Used for Metadata Server Connection <https://docs.sqream.com/en/v2022.1.2/configuration_guides/metadata_server_port.html>`_ -* `Assigning Local Network IP <https://docs.sqream.com/en/v2022.1.2/configuration_guides/use_config_ip.html>`_ -* `Enabling the Query Healer <https://docs.sqream.com/en/v2022.1.2/configuration_guides/is_healer_on.html>`_ -* `Configuring the Query Healer <https://docs.sqream.com/en/v2022.1.2/configuration_guides/healer_max_inactivity_hours.html>`_ -* `Adjusting Permitted Log-in Attempts <https://docs.sqream.com/en/v2022.1.2/configuration_guides/login_max_retries.html>`_ \ No newline at end of file +* :ref:`Setting Total Device Memory Usage in SQream Instance <cuda_mem_quota>` +* :ref:`Enabling Manually Setting Reported IP <machine_ip>` +* :ref:`Setting Port Used for Metadata Server Connection <metadata_server_port>` +* :ref:`Assigning Local Network IP <use_config_ip>` +* :ref:`Enabling the Query Healer <is_healer_on>` +* :ref:`Configuring the Query Healer <healer_detection_frequency_seconds>` +* :ref:`Adjusting Permitted Log-in Attempts <login_max_retries>` \ No newline at end of file diff --git a/configuration_guides/generic_worker_flags.rst b/configuration_guides/generic_worker_flags.rst index 7ae2a0ee7..172df3d18 100644 --- a/configuration_guides/generic_worker_flags.rst +++ b/configuration_guides/generic_worker_flags.rst @@ -1,8 +1,9 @@ .. _generic_worker_flags: -************************* +******************** Worker Generic Flags -************************* +******************** + The Worker Generic Flags** page describes **Worker** modification type flags, which can be modified by standard users on a session basis: - * `Persisting Your Cache Directory <https://docs.sqream.com/en/v2022.1.1/configuration_guides/limit_query_memory_gb.html>`_ \ No newline at end of file +:ref:`Persisting Your Cache Directory <limit_query_memory_gb>` \ No newline at end of file diff --git a/configuration_guides/login_max_retries.rst b/configuration_guides/login_max_retries.rst index bf3ae6d40..90f5e077f 100644 --- a/configuration_guides/login_max_retries.rst +++ b/configuration_guides/login_max_retries.rst @@ -1,8 +1,9 @@ .. _login_max_retries: -************************* +*********************************** Adjusting Permitted Log-in Attempts -************************* +*********************************** + The ``loginMaxRetries`` flag sets the permitted log-in attempts. The following describes the ``loginMaxRetries`` flag: diff --git a/glossary.rst b/glossary.rst index fd3cb246e..f4634d712 100644 --- a/glossary.rst +++ b/glossary.rst @@ -1,7 +1,7 @@ .. glossary: Glossary -===================================== +======== The following table shows the **Glossary** descriptions: @@ -27,7 +27,7 @@ The following table shows the **Glossary** descriptions: +-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Node | A machine used to run SQream workers. | +-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| Role | A group or a user. For more information see `SQream Studio <https://docs.sqream.com/en/latest/sqream_studio_5.4.3/creating_assigning_and_managing_roles_and_permissions.html>`_. | +| Role | A group or a user. For more information see :ref:`SQream Studio <creating_assigning_and_managing_roles_and_permissions>`. | +-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Storage cluster | The directory where SQream stores data. | +-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ diff --git a/reference/sql/sql_functions/user_defined_functions/scalar_sql_udf.rst b/reference/sql/sql_functions/user_defined_functions/scalar_sql_udf.rst index 67b23248c..84f48f971 100644 --- a/reference/sql/sql_functions/user_defined_functions/scalar_sql_udf.rst +++ b/reference/sql/sql_functions/user_defined_functions/scalar_sql_udf.rst @@ -87,7 +87,7 @@ Usage Notes Since SQL UDF's are one type of supported UDFs, the following Python UDF characteristics apply: -* UDF permission rules - see `Access Control <https://docs.sqream.com/en/latest/guides/features/access_control.html#access-control>`_. +* UDF permission rules - see :ref:`Access Control <access_control>`. * The ``get_function_ddl`` utility function works on these functions - see `Getting the DDL for a Function <https://docs.sqream.com/en/latest/guides/features/python_functions.html#getting-the-ddl-for-a-function>`_. diff --git a/releases/2022.1.1.rst b/releases/2022.1.1.rst index 3ba0cb8b6..db64d9b6c 100644 --- a/releases/2022.1.1.rst +++ b/releases/2022.1.1.rst @@ -1,8 +1,9 @@ .. _2022.1.1: -************************** +********************** Release Notes 2022.1.1 -************************** +********************** + The 2022.1.1 release notes were released on 7/19/2022 and describe the following: .. contents:: @@ -10,11 +11,12 @@ The 2022.1.1 release notes were released on 7/19/2022 and describe the following :depth: 1 Version Content ----------- +--------------- + The 2022.1.1 Release Notes describes the following: * Enhanced security features -* For more information, see `SQream Acceleration Studio 5.4.7 <https://docs.sqream.com/en/v2022.1.1/sqream_studio_5.4.7/index.html>`_. +* For more information, see :ref:`SQream Acceleration Studio 5.4.7 <sqream_studio_>`. Storage Version --------------- @@ -22,7 +24,8 @@ Storage Version The storage version presently in effect is version 40. New Features ----------- +------------ + The 2022.1.1 Release Notes include the following new features: .. contents:: @@ -33,14 +36,16 @@ Password Security Compliance ************ In compliance with GDPR standards, SQream now requires a strong password policy when accessing the CLI or Studio. -For more information, see `Password Policy <https://docs.sqream.com/en/v2022.1.1/operational_guides/access_control_password_policy.html>`_. +For more information, see :ref:`Password Policy <access_control_password_policy>`. Known Issues ---------- +------------ + There were no known issues in Version 2022.1.1. Resolved Issues ---------- +--------------- + The following table lists the issues that were resolved in Version 2022.1.1: +-------------+------------------------------------------------------------------------------------------------+ @@ -54,25 +59,30 @@ The following table lists the issues that were resolved in Version 2022.1.1: +-------------+------------------------------------------------------------------------------------------------+ Operations and Configuration Changes --------- +------------------------------------ + The ``login_max_retries`` configuration flag is required for adjusting the permitted log-in attempts. -For more information, see `Adjusting the Permitted Log-In Attempts <https://docs.sqream.com/en/v2022.1.1/configuration_guides/login_max_retries.html>`_. +For more information, see :ref:`Adjusting the Permitted Log-In Attempts <login_max_retries>`. Naming Changes -------- +-------------- + No relevant naming changes were made. Deprecated Features -------- -In `SQream Acceleration Studio 5.4.7 <https://docs.sqream.com/en/v2022.1.1/sqream_studio_5.4.7/index.html>`_, the **Configuration** section has been temporarily disabled and will be enabled at a later date. In addition, the **Log Lines** tab in the **Log** section has been removed. +------------------- + +In :ref:`SQream Acceleration Studio 5.4.7 <sqream_studio_>`, the **Configuration** section has been temporarily disabled and will be enabled at a later date. In addition, the **Log Lines** tab in the **Log** section has been removed. End of Support -------- +-------------- + The End of Support section is not relevant to Version 2022.1.1. Upgrading to v2022.1.1 -------- +---------------------- + 1. Generate a back-up of the metadata by running the following command: .. code-block:: console @@ -105,7 +115,7 @@ Upgrading to v2022.1.1 $ ./upgrade_storage <levelDB path> - .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <https://docs.sqream.com/en/v2022.1.1/installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. + .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the :ref:`Upgrading SQream Version <installing_sqream_with_binary>` procedure. .. toctree:: :maxdepth: 2 diff --git a/releases/2022.1.2.rst b/releases/2022.1.2.rst index cbefa3f00..d19f8aa60 100644 --- a/releases/2022.1.2.rst +++ b/releases/2022.1.2.rst @@ -1,8 +1,9 @@ .. _2022.1.2: -************************** +********************** Release Notes 2022.1.2 -************************** +********************** + The 2022.1.2 release notes were released on 8/24/2022 and describe the following: .. contents:: @@ -10,7 +11,8 @@ The 2022.1.2 release notes were released on 8/24/2022 and describe the following :depth: 1 Version Content ----------- +--------------- + The 2022.1.2 Release Notes describes the following: * Automatic schema identification. @@ -25,7 +27,8 @@ Storage Version The storage version presently in effect is version 41. New Features ----------- +------------ + The 2022.1.2 Release Notes include the following new features: .. contents:: @@ -37,7 +40,8 @@ Parquet Read Optimization Querying Parquet foreign tables has been optimized and is now up to 20x faster than in previous versions. Resolved Issues ---------- +--------------- + The following table lists the issues that were resolved in Version 2022.1.2: +-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ @@ -49,23 +53,28 @@ The following table lists the issues that were resolved in Version 2022.1.2: +-------------+-------------------------------------------------------------------------------------------------------------------------------------------+ Operations and Configuration Changes --------- +------------------------------------ + No configuration changes were made. Naming Changes -------- +-------------- + No relevant naming changes were made. Deprecated Features -------- +------------------- + No features were deprecated for Version 2022.1.2. End of Support -------- +-------------- + The End of Support section is not relevant to Version 2022.1.2. Upgrading to v2022.1.2 -------- +---------------------- + 1. Generate a back-up of the metadata by running the following command: .. code-block:: console @@ -98,7 +107,7 @@ Upgrading to v2022.1.2 $ ./upgrade_storage <levelDB path> - .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <https://docs.sqream.com/en/v2022.1.2/installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. + .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the :ref:`Upgrading SQream Version <installing_sqream_with_binary>` procedure. .. toctree:: :maxdepth: 2 From 13168cde7b6599c27fa56291eaa2ec5d2af71611 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 24 Jul 2023 09:46:42 +0300 Subject: [PATCH 659/882] Update 2022.1.5.rst --- releases/2022.1.5.rst | 50 +++++++++++++++++++++++++++++-------------- 1 file changed, 34 insertions(+), 16 deletions(-) diff --git a/releases/2022.1.5.rst b/releases/2022.1.5.rst index 2c3149039..e6324e9cb 100644 --- a/releases/2022.1.5.rst +++ b/releases/2022.1.5.rst @@ -1,8 +1,9 @@ .. _2022.1.5: -************************** +********************** Release Notes 2022.1.5 -************************** +********************** + The 2022.1.5 release notes were released on 11/02/2022 and describe the following: .. contents:: @@ -10,18 +11,23 @@ The 2022.1.5 release notes were released on 11/02/2022 and describe the followin :depth: 1 New Features ----------- +------------ + The 2022.1.5 Release Notes include the following new features: -* keys_evaluate utility function enhancement - add problematic chunk ID to the function's output report. +* ``keys_evaluate`` utility function enhancement - add problematic chunk ID to the function's output report + + :: + +* Automatically close database client connections that have been open for 24 hours without any active statements :: -* Automatically close database client connections that have been open for 24 hours without any active statements. +* ``release_defunct_locks`` utility function enhancement to receive new optional input parameter to specify timeout - for more details see :ref:`Lock Related Issues <lock_related_issues>`. :: -* release_defunct_locks utility function enhancement to receive new optional input parameter to specify timeout - for more details see `Lock Related Issues <../troubleshooting/lock_related_issues.html>`_. +* Metadata scale up process improvement through RocksDB configuration improvements Storage Version --------------- @@ -30,12 +36,14 @@ The storage version presently in effect is version 42. Known Issues ---------- +------------ + Recently discovered issue with the encryption feature, at this time SQream recommends to avoid using this feature - a fix will be introduced in the near future. Resolved Issues ---------- +--------------- + The following table lists the issues that were resolved in Version 2022.1.5: +--------------+------------------------------------------------------------------------------------------+ @@ -55,21 +63,29 @@ The following table lists the issues that were resolved in Version 2022.1.5: +--------------+------------------------------------------------------------------------------------------+ | SQ-11905 | GetDate casting to as text returns DATE with 0s in the time part or no time part at all | +--------------+------------------------------------------------------------------------------------------+ - - - +| SQ-12580 | Server Picker and Meta Data server may not be deployed on servers without GPU | ++--------------+------------------------------------------------------------------------------------------+ +| SQ-12690 | Worker thread increase | ++--------------+------------------------------------------------------------------------------------------+ +| SQ-13775 | Worker down issue | ++--------------+------------------------------------------------------------------------------------------+ +| SQ-13947 | Non-Unicode character query execution error | ++--------------+------------------------------------------------------------------------------------------+ Operations and Configuration Changes --------- +------------------------------------ + No configuration changes were made. Naming Changes -------- +-------------- + No relevant naming changes were made. Deprecated Features -------- +------------------- + SQream is declaring end of support of VARCHAR data type, the decision resulted by SQream's effort to enhance its core functionalities and with respect to ever changing echo system requirements. VARCHAR is no longer supported for new customers - effective from Version 2022.1.3 (September 2022). @@ -78,11 +94,13 @@ TEXT data type is replacing VARCHAR - SQream will maintain VARCHAR data type sup End of Support -------- +-------------- + No End of Support changes were made. Upgrading to v2022.1.5 -------- +---------------------- + 1. Generate a back-up of the metadata by running the following command: .. code-block:: console From ee647b5ff686e60f0ca42dff2ee33bfecb070e11 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 25 Jul 2023 09:32:24 +0300 Subject: [PATCH 660/882] Update sql_data_types_string.rst --- data_type_guides/sql_data_types_string.rst | 26 +++++++++++++--------- 1 file changed, 15 insertions(+), 11 deletions(-) diff --git a/data_type_guides/sql_data_types_string.rst b/data_type_guides/sql_data_types_string.rst index df4261d8f..c8986a088 100644 --- a/data_type_guides/sql_data_types_string.rst +++ b/data_type_guides/sql_data_types_string.rst @@ -1,32 +1,35 @@ .. _sql_data_types_string: -************************* +****** String -************************* -``TEXT`` is designed for storing text or strings of characters. +****** -SQream UTF-8 representations (``TEXT``). +``TEXT`` is designed for storing text or strings of characters. SQreamDB blocks non-UTF8 string inputs. Length -^^^^^^^^^ +^^^^^^ + When using ``TEXT``, specifying a size is optional. If not specified, the text field carries no constraints. To limit the size of the input, use ``TEXT(n)``, where ``n`` is the permitted number of characters. The following apply to setting the String type length: -* If the data exceeds the column length limit on ``INSERT`` or ``COPY`` operations, SQream DB will return an error. +* If the data exceeds the column length limit on ``INSERT`` or ``COPY`` operations, SQreamDB will return an error. * When casting or converting, the string has to fit in the target. For example, ``'Kiwis are weird birds' :: TEXT(5)`` will return an error. Use ``SUBSTRING`` to truncate the length of the string. Syntax -^^^^^^^^ +^^^^^^ + String types can be written with standard SQL string literals, which are enclosed with single quotes, such as ``'Kiwi bird'``. To include a single quote in the string, use double quotations, such as ``'Kiwi bird''s wings are tiny'``. String literals can also be dollar-quoted with the dollar sign ``$``, such as ``$$Kiwi bird's wings are tiny$$`` is the same as ``'Kiwi bird''s wings are tiny'``. Size -^^^^^^ -``TEXT(n)`` can occupy up to *4*n* bytes. However, the size of strings is variable and is compressed by SQream. +^^^^ + +``TEXT(n)`` can occupy up to *4*n* bytes. However, the size of strings is variable and is compressed by SQreamDB. String Examples -^^^^^^^^^^ +^^^^^^^^^^^^^^^ + The following is an example of the String syntax: .. code-block:: postgres @@ -49,7 +52,8 @@ The following is an example of the correct output: .. note:: Most clients control the display precision of floating point numbers, and values may appear differently in some clients. String Casts and Conversions -^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + The following table shows the possible String value conversions: .. list-table:: From 7f0b4e505d4c7f1d82b3286acb554934407f3935 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 25 Jul 2023 12:56:13 +0300 Subject: [PATCH 661/882] Update keywords_and_identifiers.rst --- .../sql_syntax/keywords_and_identifiers.rst | 161 ++++++++++++------ 1 file changed, 113 insertions(+), 48 deletions(-) diff --git a/reference/sql/sql_syntax/keywords_and_identifiers.rst b/reference/sql/sql_syntax/keywords_and_identifiers.rst index efe1ba42f..75687998c 100644 --- a/reference/sql/sql_syntax/keywords_and_identifiers.rst +++ b/reference/sql/sql_syntax/keywords_and_identifiers.rst @@ -24,52 +24,117 @@ Quoted identifiers must follow these rules: Identifiers are different than **keywords**, which are predefined words reserved with specific meanings in a statement. Some examples of keywords are ``SELECT``, ``CREATE``, and ``WHERE``. Note that keywords **cannot** be used as identifiers. -The following table shows a full list of the reserved keywords: +SQreamDB reserved keywords: -+-------------------------------------------------------------------------------------------------+ -| **Keywords** | -+-------------------+---------------------+--------------------+------------------+---------------+ -| **A - C** | **C - G** | **H - N** | **N - S** | **S - W** | -+-------------------+---------------------+--------------------+------------------+---------------+ -| ``ALL`` | ``CURRENT_CATALOG`` | ``HASH`` | ``NOT`` | ``SIMILAR`` | -+-------------------+---------------------+--------------------+------------------+---------------+ -| ``ANALYSE`` | ``CURRENT_ROLE`` | ``HAVING`` | ``NOTNULL`` | ``SOME`` | -+-------------------+---------------------+--------------------+------------------+---------------+ -| ``ANALYZE`` | ``CURRENT_TIME`` | ``ILIKE`` | ``NULL`` | ``SYMMETRIC`` | -+-------------------+---------------------+--------------------+------------------+---------------+ -| ``AND`` | ``CURRENT_USER`` | ``IN`` | ``OFFSET`` | ``TABLE`` | -+-------------------+---------------------+--------------------+------------------+---------------+ -| ``ANY`` | ``DEFAULT`` | ``INITIALLY`` | ``ON`` | ``THEN`` | -+-------------------+---------------------+--------------------+------------------+---------------+ -| ``ARRAY`` | ``DEFERRABLE`` | ``INNER`` | ``ONLY`` | ``TO`` | -+-------------------+---------------------+--------------------+------------------+---------------+ -| ``AS`` | ``DESC`` | ``INTERSECT`` | ``OPTION`` | ``TRAILING`` | -+-------------------+---------------------+--------------------+------------------+---------------+ -| ``ASC`` | ``DISTINCT`` | ``INTO`` | ``OR`` | ``TRAN`` | -+-------------------+---------------------+--------------------+------------------+---------------+ -| ``AUTHORIZATION`` | ``DO`` | ``IS`` | ``ORDER`` | ``TRUE`` | -+-------------------+---------------------+--------------------+------------------+---------------+ -| ``BINARY`` | ``ELSE`` | ``ISNULL`` | ``OUTER`` | ``UNION`` | -+-------------------+---------------------+--------------------+------------------+---------------+ -| ``BIGINT`` | ``END`` | ``JOIN`` | ``OVER`` | ``UNIQUE`` | -+-------------------+---------------------+--------------------+------------------+---------------+ -| ``BOTH`` | ``EXCEPT`` | ``LEADING`` | ``OVERLAPS`` | ``USER`` | -+-------------------+---------------------+--------------------+------------------+---------------+ -| ``CASE`` | ``FALSE`` | ``LEFT`` | ``PLACING`` | ``USING`` | -+-------------------+---------------------+--------------------+------------------+---------------+ -| ``CAST`` | ``FETCH`` | ``LIKE`` | ``PRIMARY`` | ``VARIADIC`` | -+-------------------+---------------------+--------------------+------------------+---------------+ -| ``CHECK`` | ``FOR`` | ``LIMIT`` | ``REFERENCES`` | ``VERBOSE`` | -+-------------------+---------------------+--------------------+------------------+---------------+ -| ``COLLATE`` | ``FREEZE`` | ``LOCALTIME`` | ``RETURNING`` | ``WHEN`` | -+-------------------+---------------------+--------------------+------------------+---------------+ -| ``COLUMN`` | ``FROM`` | ``LOCALTIMESTAMP`` | ``RIGHT`` | ``WHERE`` | -+-------------------+---------------------+--------------------+------------------+---------------+ -| ``CONCURRENTLY`` | ``FULL`` | ``LOOP`` | ``RLIKE`` | ``WINDOW`` | -+-------------------+---------------------+--------------------+------------------+---------------+ -| ``CONSTRAINT`` | ``FUNCTION`` | ``MERGE`` | ``SELECT`` | ``WITH`` | -+-------------------+---------------------+--------------------+------------------+ | -| ``CREATE`` | ``GRANT`` | ``NATURAL`` | ``SESSION_USER`` | | -+-------------------+---------------------+--------------------+------------------+ | -| ``CROSS`` | ``GROUP`` | | | | -+-------------------+---------------------+--------------------+------------------+---------------+ + + - ``ALL`` + - ``ANALYSE`` + - ``ANALYZE`` + - ``AND`` + - ``ANY`` + - ``ARRAY`` + - ``AS`` + - ``ASC`` + - ``AUTHORIZATION`` + - ``BINARY`` + - ``BIGINT`` + - ``BOTH`` + - ``CASE`` + - ``CAST`` + - ``CHECK`` + - ``COLLATE`` + - ``COLUMN`` + - ``CONCURRENTLY`` + - ``CONSTRAINT`` + - ``CREATE`` + - ``CROSS`` + - ``CURRENT_CATALOG`` + - ``CURRENT_ROLE`` + - ``CURRENT_TIME`` + - ``CURRENT_USER`` + - ``DEFAULT`` + - ``DEFERRABLE`` + - ``DESC`` + - ``DISTINCT`` + - ``DO`` + - ``ELSE`` + - ``END`` + - ``EXCEPT`` + - ``FALSE`` + - ``FETCH`` + - ``FOR`` + - ``FREEZE`` + - ``FROM`` + - ``FULL`` + - ``FUNCTION`` + - ``GRANT`` + - ``GROUP`` + - ``HASH`` + - ``HAVING`` + - ``ILIKE`` + - ``IN`` + - ``INITIALLY`` + - ``INNER`` + - ``INTERSECT`` + - ``INTO`` + - ``IS`` + - ``ISNULL`` + - ``JOIN`` + - ``KEY`` + - ``LEADING`` + - ``LEFT`` + - ``LIKE`` + - ``LIMIT`` + - ``LOCALTIME`` + - ``LOCALTIMESTAMP`` + - ``LOOP`` + - ``MERGE`` + - ``NATURAL`` + - ``NOT`` + - ``NOTNULL`` + - ``NULL`` + - ``OFFSET`` + - ``ON`` + - ``ONLY`` + - ``OPTION`` + - ``OR`` + - ``ORDER`` + - ``OUTER`` + - ``OVER`` + - ``OVERLAPS`` + - ``PERCENT`` + - ``PLACING`` + - ``PRIMARY`` + - ``PRECISION`` + - ``PROC`` + - ``REFERENCES`` + - ``RETURNING`` + - ``RIGHT`` + - ``RLIKE`` + - ``SELECT`` + - ``SESSION_USER`` + - ``SET`` + - ``SIMILAR`` + - ``SOME`` + - ``SYMMETRIC`` + - ``TABLE`` + - ``THEN`` + - ``TO`` + - ``TRAILING`` + - ``TRAN`` + - ``TRUE`` + - ``UNION`` + - ``UNIQUE`` + - ``USER`` + - ``USING`` + - ``VARIADIC`` + - ``VERBOSE`` + - ``WHEN`` + - ``WHERE`` + - ``WINDOW`` + - ``WITH`` + + + + + From 13fda93d94b440cbe5f4ae3a09bcb2e9195dae4b Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 25 Jul 2023 15:40:40 +0300 Subject: [PATCH 662/882] Update creating_assigning_and_managing_roles_and_permissions.rst --- ...igning_and_managing_roles_and_permissions.rst | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/sqream_studio_5.4.7/creating_assigning_and_managing_roles_and_permissions.rst b/sqream_studio_5.4.7/creating_assigning_and_managing_roles_and_permissions.rst index 6f0e43ef3..8231c3d9c 100644 --- a/sqream_studio_5.4.7/creating_assigning_and_managing_roles_and_permissions.rst +++ b/sqream_studio_5.4.7/creating_assigning_and_managing_roles_and_permissions.rst @@ -2,9 +2,9 @@ .. _roles_5.4.7: -**************************** +******************************************************* Creating, Assigning, and Managing Roles and Permissions -**************************** +******************************************************* In the **Roles** area you can create and assign roles and manage user permissions. @@ -30,7 +30,8 @@ The **Type** column displays one of the following assigned role types: Viewing Information About a Role --------------------- +-------------------------------- + Clicking a role in the roles table displays the following information: * **Parent Roles** - displays the parent roles of the selected role. Roles inherit all roles assigned to the parent. @@ -47,7 +48,8 @@ Clicking a role in the roles table displays the following information: Creating a New Role --------------------- +------------------- + You can create a new role by clicking **New Role**. @@ -70,7 +72,8 @@ When adding a new role, you must select the **Enable login for this role** and * :ref:`Back to Creating, Assigning, and Managing Roles and Permissions<roles_5.4.7>` Editing a Role --------------------- +-------------- + Once you've created a role, clicking the **Edit Role** button lets you do the following: * Edit role name @@ -86,7 +89,8 @@ From the Edit Role panel you view directly and indirectly (or inherited) granted :ref:`Back to Creating, Assigning, and Managing Roles and Permissions<roles_5.4.7>` Deleting a Role ------------------ +--------------- + Clicking the **delete** icon displays a confirmation message with the amount of users and groups that will be impacted by deleting the role. :ref:`Back to Creating, Assigning, and Managing Roles and Permissions<roles_5.4.7>` \ No newline at end of file From 311bbcc08a08547d30b444a063766d3a690d11b1 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 27 Jul 2023 08:01:35 +0300 Subject: [PATCH 663/882] Update char_length.rst --- .../scalar_functions/string/char_length.rst | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/string/char_length.rst b/reference/sql/sql_functions/scalar_functions/string/char_length.rst index 79bbdcdbc..25e684c82 100644 --- a/reference/sql/sql_functions/scalar_functions/string/char_length.rst +++ b/reference/sql/sql_functions/scalar_functions/string/char_length.rst @@ -1,8 +1,8 @@ .. _char_length: -************************** +****************************** CHARACTER_LENGTH / CHAR_LENGTH -************************** +****************************** Calculates the number of characters in a string. @@ -11,15 +11,15 @@ Calculates the number of characters in a string. * To get the length in bytes, see :ref:`octet_length`. Syntax -========== +====== .. code-block:: postgres - CHAR_LEN( text_expr ) --> INT - CHARACTER_LEN( text_expr ) --> INT + CHAR_LENGTH( text_expr ) --> INT + CHARACTER_LENGTH( text_expr ) --> INT Arguments -============ +========= .. list-table:: :widths: auto @@ -31,19 +31,19 @@ Arguments - ``TEXT`` expression Returns -============ +======= Return an integer containing the number of characters in the string. Notes -======= +===== * To get the length in bytes, see :ref:`octet_length` * If the value is NULL, the result is NULL. Examples -=========== +======== For these examples, consider the following table and contents: @@ -56,7 +56,7 @@ For these examples, consider the following table and contents: , ('אבגדהוזחטיכלמנסעפצקרשת'); Length in characters and bytes of strings --------------------------------------------------- +----------------------------------------- ASCII characters take up 1 byte per character, while Thai takes up 3 bytes and Hebrew takes up 2 bytes. From cd5eedaa66b26cbb8439518bff84bb8967d13aca Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 27 Jul 2023 09:16:42 +0300 Subject: [PATCH 664/882] SQLoader --- data_ingestion/avro.rst | 225 +++++++++++--------- data_ingestion/csv.rst | 44 ++-- data_ingestion/index.rst | 2 +- data_ingestion/ingesting_from_databases.rst | 1 + data_ingestion/json.rst | 2 +- data_ingestion/orc.rst | 42 ++-- data_ingestion/parquet.rst | 54 +++-- 7 files changed, 201 insertions(+), 169 deletions(-) create mode 100644 data_ingestion/ingesting_from_databases.rst diff --git a/data_ingestion/avro.rst b/data_ingestion/avro.rst index a548ec265..348a3ec4f 100644 --- a/data_ingestion/avro.rst +++ b/data_ingestion/avro.rst @@ -1,9 +1,10 @@ .. _avro: -************************** -Ingesting Data from Avro -************************** -The **Ingesting Data from Avro** page describes ingesting data from Avro into SQream and includes the following: +**** +Avro +**** + +The **Ingesting Data from Avro** page describes ingesting data from Avro into SQreamDB and includes the following: @@ -12,25 +13,28 @@ The **Ingesting Data from Avro** page describes ingesting data from Avro into SQ :depth: 1 Overview -=========== -**Avro** is a well-known data serialization system that relies on schemas. Due to its flexibility as an efficient data storage method, SQream supports the Avro binary data format as an alternative to JSON. Avro files are represented using the **Object Container File** format, in which the Avro schema is encoded alongside binary data. Multiple files loaded in the same transaction are serialized using the same schema. If they are not serialized using the same schema, an error message is displayed. SQream uses the **.avro** extension for ingested Avro files. +======== + +**Avro** is a well-known data serialization system that relies on schemas. Due to its flexibility as an efficient data storage method, SQreamDB supports the Avro binary data format as an alternative to JSON. Avro files are represented using the **Object Container File** format, in which the Avro schema is encoded alongside binary data. Multiple files loaded in the same transaction are serialized using the same schema. If they are not serialized using the same schema, an error message is displayed. SQreamDB uses the **.avro** extension for ingested Avro files. Making Avro Files Accessible to Workers -================ +======================================= + To give workers access to files every node must have the same view of the storage being used. The following apply for Avro files to be accessible to workers: * For files hosted on NFS, ensure that the mount is accessible from all servers. -* For HDFS, ensure that SQream servers have access to the HDFS name node with the correct **user-id**. For more information, see :ref:`hdfs`. +* For HDFS, ensure that SQreamDB servers have access to the HDFS name node with the correct **user-id**. For more information, see :ref:`hdfs`. * For S3, ensure network access to the S3 endpoint. For more information, see :ref:`s3`. For more information about restricted worker access, see :ref:`workload_manager`. Preparing Your Table -=============== +==================== + You can build your table structure on both local and foreign tables: .. contents:: @@ -38,7 +42,8 @@ You can build your table structure on both local and foreign tables: :depth: 1 Creating a Table ---------------------- +---------------- + Before loading data, you must build the ``CREATE TABLE`` to correspond with the file structure of the inserted table. The example in this section is based on the source ``nba.avro`` table shown below: @@ -73,12 +78,13 @@ The following example shows the correct file structure used to create the ``CREA .. tip:: - An exact match must exist between the SQream and Avro types. For unsupported column types, you can set the type to any type and exclude it from subsequent queries. + An exact match must exist between SQreamDB and Avro types. For unsupported column types, you can set the type to any type and exclude it from subsequent queries. .. note:: The **nba.avro** file is stored on S3 at ``s3://sqream-demo-data/nba.avro``. Creating a Foreign Table ---------------------- +------------------------ + Before loading data, you must build the ``CREATE FOREIGN TABLE`` to correspond with the file structure of the inserted table. The example in this section is based on the source ``nba.avro`` table shown below: @@ -113,106 +119,112 @@ The following example shows the correct file structure used to create the ``CREA .. tip:: - An exact match must exist between the SQream and Avro types. For unsupported column types, you can set the type to any type and exclude it from subsequent queries. + An exact match must exist between the SQreamDB and Avro types. For unsupported column types, you can set the type to any type and exclude it from subsequent queries. .. note:: The **nba.avro** file is stored on S3 at ``s3://sqream-demo-data/nba.avro``. .. note:: The examples in the sections above are identical except for the syntax used to create the tables. -Mapping Between SQream and Avro Data Types -================= -Mapping between SQream and Avro data types depends on the Avro data type: +Mapping Between SQreamDB and Avro Data Types +========================================== + +Mapping between SQreamDB and Avro data types depends on the Avro data type: .. contents:: :local: :depth: 1 Primitive Data Types --------------- +-------------------- + The following table shows the supported **Primitive** data types: -+-------------+------------------------------------------------------+ -| Avro Type | SQream Type | -| +-----------+---------------+-----------+--------------+ -| | Number | Date/Datetime | String | Boolean | -+=============+===========+===============+===========+==============+ -| ``null`` | Supported | Supported | Supported | Supported | -+-------------+-----------+---------------+-----------+--------------+ -| ``boolean`` | | | Supported | Supported | -+-------------+-----------+---------------+-----------+--------------+ -| ``int`` | Supported | | Supported | | -+-------------+-----------+---------------+-----------+--------------+ -| ``long`` | Supported | | Supported | | -+-------------+-----------+---------------+-----------+--------------+ -| ``float`` | Supported | | Supported | | -+-------------+-----------+---------------+-----------+--------------+ -| ``double`` | Supported | | Supported | | -+-------------+-----------+---------------+-----------+--------------+ -| ``bytes`` | | | | | -+-------------+-----------+---------------+-----------+--------------+ -| ``string`` | | Supported | Supported | | -+-------------+-----------+---------------+-----------+--------------+ ++-------------+--------------------------------------------------------+ +| Avro Type | SQreamDB Type | +| +-----------+---------------+-----------+----------------+ +| | Number | Date/Datetime | String | Boolean | ++=============+===========+===============+===========+================+ +| ``null`` | Supported | Supported | Supported | Supported | ++-------------+-----------+---------------+-----------+----------------+ +| ``boolean`` | | | Supported | Supported | ++-------------+-----------+---------------+-----------+----------------+ +| ``int`` | Supported | | Supported | | ++-------------+-----------+---------------+-----------+----------------+ +| ``long`` | Supported | | Supported | | ++-------------+-----------+---------------+-----------+----------------+ +| ``float`` | Supported | | Supported | | ++-------------+-----------+---------------+-----------+----------------+ +| ``double`` | Supported | | Supported | | ++-------------+-----------+---------------+-----------+----------------+ +| ``bytes`` | | | | | ++-------------+-----------+---------------+-----------+----------------+ +| ``string`` | | Supported | Supported | | ++-------------+-----------+---------------+-----------+----------------+ Complex Data Types --------------- +------------------ + The following table shows the supported **Complex** data types: -+------------+-------------------------------------------------------+ -| | SQream Type | -| +------------+----------------+-------------+-----------+ -|Avro Type | Number | Date/Datetime | String | Boolean | -+============+============+================+=============+===========+ -| ``record`` | | | | | -+------------+------------+----------------+-------------+-----------+ -| ``enum`` | | | Supported | | -+------------+------------+----------------+-------------+-----------+ -| ``array`` | | | | | -+------------+------------+----------------+-------------+-----------+ -| ``map`` | | | | | -+------------+------------+----------------+-------------+-----------+ -| ``union`` | Supported | Supported | Supported | Supported | -+------------+------------+----------------+-------------+-----------+ -| ``fixed`` | | | | | -+------------+------------+----------------+-------------+-----------+ ++------------+---------------------------------------------------------+ +| | SQreamDB Type | +| +------------+----------------+-------------+-------------+ +|Avro Type | Number | Date/Datetime | String | Boolean | ++============+============+================+=============+=============+ +| ``record`` | | | | | ++------------+------------+----------------+-------------+-------------+ +| ``enum`` | | | Supported | | ++------------+------------+----------------+-------------+-------------+ +| ``array`` | | | | | ++------------+------------+----------------+-------------+-------------+ +| ``map`` | | | | | ++------------+------------+----------------+-------------+-------------+ +| ``union`` | Supported | Supported | Supported | Supported | ++------------+------------+----------------+-------------+-------------+ +| ``fixed`` | | | | | ++------------+------------+----------------+-------------+-------------+ Logical Data Types --------------- +------------------ + The following table shows the supported **Logical** data types: -+----------------------------+-------------------------------------------------+ -| Avro Type | SQream Type | -| +-----------+---------------+-----------+---------+ -| | Number | Date/Datetime | String | Boolean | -+============================+===========+===============+===========+=========+ -| ``decimal`` | Supported | | Supported | | -+----------------------------+-----------+---------------+-----------+---------+ -| ``uuid`` | | | Supported | | -+----------------------------+-----------+---------------+-----------+---------+ -| ``date`` | | Supported | Supported | | -+----------------------------+-----------+---------------+-----------+---------+ -| ``time-millis`` | | | | | -+----------------------------+-----------+---------------+-----------+---------+ -| ``time-micros`` | | | | | -+----------------------------+-----------+---------------+-----------+---------+ -| ``timestamp-millis`` | | Supported | Supported | | -+----------------------------+-----------+---------------+-----------+---------+ -| ``timestamp-micros`` | | Supported | Supported | | -+----------------------------+-----------+---------------+-----------+---------+ -| ``local-timestamp-millis`` | | | | | -+----------------------------+-----------+---------------+-----------+---------+ -| ``local-timestamp-micros`` | | | | | -+----------------------------+-----------+---------------+-----------+---------+ -| ``duration`` | | | | | -+----------------------------+-----------+---------------+-----------+---------+ ++----------------------------+---------------------------------------------------+ +| Avro Type | SQreamDB Type | +| +-----------+---------------+-----------+-----------+ +| | Number | Date/Datetime | String | Boolean | ++============================+===========+===============+===========+===========+ +| ``decimal`` | Supported | | Supported | | ++----------------------------+-----------+---------------+-----------+-----------+ +| ``uuid`` | | | Supported | | ++----------------------------+-----------+---------------+-----------+-----------+ +| ``date`` | | Supported | Supported | | ++----------------------------+-----------+---------------+-----------+-----------+ +| ``time-millis`` | | | | | ++----------------------------+-----------+---------------+-----------+-----------+ +| ``time-micros`` | | | | | ++----------------------------+-----------+---------------+-----------+-----------+ +| ``timestamp-millis`` | | Supported | Supported | | ++----------------------------+-----------+---------------+-----------+-----------+ +| ``timestamp-micros`` | | Supported | Supported | | ++----------------------------+-----------+---------------+-----------+-----------+ +| ``local-timestamp-millis`` | | | | | ++----------------------------+-----------+---------------+-----------+-----------+ +| ``local-timestamp-micros`` | | | | | ++----------------------------+-----------+---------------+-----------+-----------+ +| ``duration`` | | | | | ++----------------------------+-----------+---------------+-----------+-----------+ .. note:: Number types include **tinyint**, **smallint**, **int**, **bigint**, **real** and **float**, and **numeric**. String types include **text**. Mapping Objects to Rows -=============== -When mapping objects to rows, each Avro object or message must contain one ``record`` type object corresponding to a single row in SQream. The ``record`` fields are associated by name to their target table columns. Additional unmapped fields will be ignored. Note that using the JSONPath option overrides this. +======================= + +When mapping objects to rows, each Avro object or message must contain one ``record`` type object corresponding to a single row in SQreamDB. The ``record`` fields are associated by name to their target table columns. Additional unmapped fields will be ignored. Note that using the JSONPath option overrides this. + +Ingesting Data into SQreamDB +============================ -Ingesting Data into SQream -============== This section includes the following: .. contents:: @@ -220,8 +232,9 @@ This section includes the following: :depth: 1 Syntax ------------ -Before ingesting data into SQream from an Avro file, you must create a table using the following syntax: +------ + +Before ingesting data into SQreamDB from an Avro file, you must create a table using the following syntax: .. code-block:: postgres @@ -229,14 +242,15 @@ Before ingesting data into SQream from an Avro file, you must create a table usi FROM WRAPPER fdw_name ; -After creating a table you can ingest data from an Avro file into SQream using the following syntax: +After creating a table you can ingest data from an Avro file into SQreamDB using the following syntax: .. code-block:: postgres avro_fdw Example ------------ +------- + The following is an example of creating a table: .. code-block:: postgres @@ -249,7 +263,7 @@ The following is an example of creating a table: ) ; -The following is an example of loading data from an Avro file into SQream: +The following is an example of loading data from an Avro file into SQreamDB: .. code-block:: postgres @@ -262,7 +276,8 @@ The following is an example of loading data from an Avro file into SQream: For more examples, see :ref:`additional_examples`. Parameters -=================== +========== + The following table shows the Avro parameter: .. list-table:: @@ -275,8 +290,9 @@ The following table shows the Avro parameter: - The schema name for the table. Defaults to ``public`` if not specified. Best Practices -============ -Because external tables do not automatically verify the file integrity or structure, SQream recommends manually verifying your table output when ingesting Avro files into SQream. This lets you determine if your table output is identical to your originally inserted table. +============== + +Because external tables do not automatically verify the file integrity or structure, SQreamDB recommends manually verifying your table output when ingesting Avro files into SQreamDB. This lets you determine if your table output is identical to your originally inserted table. The following is an example of the output based on the **nba.avro** table: @@ -301,16 +317,18 @@ The following is an example of the output based on the **nba.avro** table: .. _additional_examples: Additional Examples -=============== -This section includes the following additional examples of loading data into SQream: +=================== + +This section includes the following additional examples of loading data into SQreamDB: .. contents:: :local: :depth: 1 Omitting Unsupported Column Types --------------- -When loading data, you can omit columns using the ``NULL as`` argument. You can use this argument to omit unsupported columns from queries that access external tables. By omitting them, these columns will not be called and will avoid generating a "type mismatch" error. +--------------------------------- + +When loading data, you can omit columns using the ``NULL as`` argument. You can use this argument to omit unsupported columns from queries that access foreign tables. By omitting them, these columns will not be called and will avoid generating a "type mismatch" error. In the example below, the ``Position`` column is not supported due its type. @@ -320,8 +338,9 @@ In the example below, the ``Position`` column is not supported due its type. SELECT Name, Team, Number, NULL as Position, Age, Height, Weight, College, Salary FROM ext_nba; Modifying Data Before Loading --------------- -One of the main reasons for staging data using the ``EXTERNAL TABLE`` argument is to examine and modify table contents before loading it into SQream. +----------------------------- + +One of the main reasons for staging data using the ``FOREIGN TABLE`` argument is to examine and modify table contents before loading it into SQreamDB. For example, we can replace pounds with kilograms using the :ref:`create_table_as` statement @@ -335,7 +354,8 @@ In the example below, the ``Position`` column is set to the default ``NULL``. ORDER BY weight; Loading a Table from a Directory of Avro Files on HDFS --------------- +------------------------------------------------------ + The following is an example of loading a table from a directory of Avro files on HDFS: .. code-block:: postgres @@ -353,7 +373,8 @@ The following is an example of loading a table from a directory of Avro files on For more configuration option examples, navigate to the :ref:`create_foreign_table` page and see the **Parameters** table. Loading a Table from a Directory of Avro Files on S3 --------------- +---------------------------------------------------- + The following is an example of loading a table from a directory of Avro files on S3: .. code-block:: postgres diff --git a/data_ingestion/csv.rst b/data_ingestion/csv.rst index db63a38ca..8370335d9 100644 --- a/data_ingestion/csv.rst +++ b/data_ingestion/csv.rst @@ -1,10 +1,10 @@ .. _csv: -********************** -Ingesting Data from a CSV File -********************** +*** +CSV +*** -This guide covers ingesting data from CSV files into SQream DB using the :ref:`copy_from` method. +This guide covers ingesting data from CSV files into SQreamDB using the :ref:`copy_from` method. .. contents:: @@ -12,11 +12,11 @@ This guide covers ingesting data from CSV files into SQream DB using the :ref:`c :depth: 1 Prepare CSVs -===================== +============ Prepare the source CSVs, with the following requirements: -* Files should be a valid CSV. By default, SQream DB's CSV parser can handle `RFC 4180 standard CSVs <https://tools.ietf.org/html/rfc4180>`_ , but can also be modified to support non-standard CSVs (with multi-character delimiters, unquoted fields, etc). +* Files should be a valid CSV. By default, SQreamDB's CSV parser can handle `RFC 4180 standard CSVs <https://tools.ietf.org/html/rfc4180>`_ , but can also be modified to support non-standard CSVs (with multi-character delimiters, unquoted fields, etc). * Files are UTF-8 or ASCII encoded @@ -45,15 +45,15 @@ Prepare the source CSVs, with the following requirements: .. note:: If a text field is quoted but contains no content (``""``) it is considered an empty text field. It is not considered ``NULL``. -Place CSVs where SQream DB workers can access +Place CSVs where SQreamDB workers can access ============================================= During data load, the :ref:`copy_from` command can run on any worker (unless explicitly speficied with the :ref:`workload_manager`). -It is important that every node has the same view of the storage being used - meaning, every SQream DB worker should have access to the files. +It is important that every node has the same view of the storage being used - meaning, every SQreamDB worker should have access to the files. * For files hosted on NFS, ensure that the mount is accessible from all servers. -* For HDFS, ensure that SQream DB servers can access the HDFS name node with the correct user-id. See our :ref:`hdfs` guide for more information. +* For HDFS, ensure that SQreamDB servers can access the HDFS name node with the correct user-id. See our :ref:`hdfs` guide for more information. * For S3, ensure network access to the S3 endpoint. See our :ref:`s3` guide for more information. @@ -99,7 +99,7 @@ We will make note of the file structure to create a matching ``CREATE TABLE`` st Bulk load the data with COPY FROM ================================= -The CSV is a standard CSV, but with two differences from SQream DB defaults: +The CSV is a standard CSV, but with two differences from SQreamDB defaults: * The record delimiter is not a Unix newline (``\n``), but a Windows newline (``\r\n``) @@ -131,21 +131,21 @@ Loading a standard CSV file from a local filesystem Loading a PSV (pipe separated value) file -------------------------------------------- +----------------------------------------- .. code-block:: postgres COPY table_name FROM '/home/rhendricks/file.psv' WITH DELIMITER '|'; Loading a TSV (tab separated value) file -------------------------------------------- +---------------------------------------- .. code-block:: postgres COPY table_name FROM '/home/rhendricks/file.tsv' WITH DELIMITER '\t'; Loading a text file with non-printable delimiter ------------------------------------------------------ +------------------------------------------------ In the file below, the separator is ``DC1``, which is represented by ASCII 17 decimal or 021 octal. @@ -154,7 +154,7 @@ In the file below, the separator is ``DC1``, which is represented by ASCII 17 de COPY table_name FROM 'file.txt' WITH DELIMITER E'\021'; Loading a text file with multi-character delimiters ------------------------------------------------------ +--------------------------------------------------- In the file below, the separator is ``'|``. @@ -163,7 +163,7 @@ In the file below, the separator is ``'|``. COPY table_name FROM 'file.txt' WITH DELIMITER '''|'; Loading files with a header row ------------------------------------ +------------------------------- Use ``OFFSET`` to skip rows. @@ -176,14 +176,14 @@ Use ``OFFSET`` to skip rows. .. _changing_record_delimiter: Loading files formatted for Windows (``\r\n``) ---------------------------------------------------- +---------------------------------------------- .. code-block:: postgres COPY table_name FROM 'filename.psv' WITH DELIMITER '|' RECORD DELIMITER '\r\n'; Loading a file from a public S3 bucket ------------------------------------------- +-------------------------------------- .. note:: The bucket must be publicly available and objects can be listed @@ -209,7 +209,7 @@ Loading files from an HDFS storage Saving rejected rows to a file ----------------------------------- +------------------------------ See :ref:`capturing_rejected_rows` for more information about the error handling capabilities of ``COPY FROM``. @@ -235,7 +235,7 @@ Stopping the load if a certain amount of rows were rejected STOP AFTER 5 ERRORS; -- Stop the load if 5 errors reached Load CSV files from a set of directories ------------------------------------------- +---------------------------------------- Use glob patterns (wildcards) to load multiple files to one table. @@ -245,7 +245,7 @@ Use glob patterns (wildcards) to load multiple files to one table. Rearrange destination columns ---------------------------------- +----------------------------- When the source of the files does not match the table structure, tell the ``COPY`` command what the order of columns should be @@ -256,9 +256,9 @@ When the source of the files does not match the table structure, tell the ``COPY .. note:: Any column not specified will revert to its default value or ``NULL`` value if nullable Loading non-standard dates ----------------------------------- +-------------------------- -If files contain dates not formatted as ``ISO8601``, tell ``COPY`` how to parse the column. After parsing, the date will appear as ``ISO8601`` inside SQream DB. +If files contain dates not formatted as ``ISO8601``, tell ``COPY`` how to parse the column. After parsing, the date will appear as ``ISO8601`` inside SQreamDB. In this example, ``date_col1`` and ``date_col2`` in the table are non-standard. ``date_col3`` is mentioned explicitly, but can be left out. Any column that is not specified is assumed to be ``ISO8601``. diff --git a/data_ingestion/index.rst b/data_ingestion/index.rst index cf107b3d9..ad3e27e93 100644 --- a/data_ingestion/index.rst +++ b/data_ingestion/index.rst @@ -16,6 +16,6 @@ The **Data Ingestion Sources** page provides information about the following: parquet orc json - + ingesting_from_databases For information about database tools and interfaces that SQream supports, see :ref:`Third Party Tools <connecting_to_sqream>`. \ No newline at end of file diff --git a/data_ingestion/ingesting_from_databases.rst b/data_ingestion/ingesting_from_databases.rst new file mode 100644 index 000000000..546c712cf --- /dev/null +++ b/data_ingestion/ingesting_from_databases.rst @@ -0,0 +1 @@ +.. _ingesting_from_databases: ****************** External Databases ****************** The **SQLoader** is a CLI program that enables you to load data into SQreamDB from other databases. **SQLoader** supports Oracle and Postgresql. .. contents:: :local: :depth: 1 Before You Begin ================ It is essential that you have the following: * Java 17 * SQLoader configuration files * SQLoader.jar file Getting the SQLoader Configuration and JAR Files ================================================ 1. Download the ``.tar`` file using the following command: .. code-block:: linux curl -O https://sq-ftp-public.s3.amazonaws.com/sqloader-0.0.6.tar.gz 2. Extract the ``.tar`` file using the following command: .. code-block:: linux tar -xf sqloader-0.0.6.tar.gz A folder named ``sqloader-0.0.6`` with the following files is created: .. list-table:: SQLoader Files :widths: auto :header-rows: 1 * - File - Description * - ``sqream-mapping.json`` - Maps Postgresql and Oracle data types into SQreamDB data types during ingestion * - ``sqload-jdbc-oracle.properties`` - Used for defining a connection string and may also be used to reconfigure data loading * - ``reserved_words.txt`` - A list of reserved words which cannot be used as table and/or column names * - ``sqloader-0.0.6.jar`` - The SQLoader package file Connection String ================= The ``sqload-jdbc-oracle-incr.properties`` file contains a connection string that must be configured to enable data loading into SQreamDB. .. literalinclude:: connection_string.java :language: java :caption: Properties File Sample :linenos: Configuring SQLoader Connection ------------------------------- 1. Open the ``sqload-jdbc-oracle.properties`` file. 2. Configure the following parameters for: a. Postgresql, Oracle, or SQreamDB connection strings b. Oracle or SQreamDB catalogs (recommended) .. list-table:: Connection String Parameters :widths: auto :header-rows: 1 * - Parameter - Description * - ``HostIp:port`` - The host and IP address number * - ``database_name`` - The name of the database from which data is loaded * - ``user`` - Username of a role to use for connection * - ``password`` - Specifies the password of the selected role * - ``ssl`` - Specifies SSL for this connection Loading Data into SQreamDB Tables ================================= 1. Run the ``sqloader.jar`` file using the following CLI command: .. code-block:: console java -jar sqloader-0.0.6.jar 2. You may load the entire data of a source table using the following CLI command: .. code-block:: console java -jar sqloader-0.0.6.jar -table source_table_name 3. You may customize the data load either by using each of the following parameters within a CLI command or by configuring the ``properties`` file: .. list-table:: SQLoader CLI Parameters :widths: auto :header-rows: 1 * - CLI Parameter - State - Default - Description * - ``-batchsize`` - Optional - ``10.000`` - The number of records to be inserted into SQreamDB at once. Please note that the configured batch size may impact chunk sizes. * - ``-casesensative`` - Optional - ``false`` - If ``true``, keeps table name uppercase and lowercase characters when table is created in SQreamDB * - ``-chunkSize`` - Optional - ``0`` - The number of records read at once from the source database * - ``-columnlist`` - Optional - None - The name of the file that contains all column names * - ``-columns`` - Optional - All columns - The name or names of columns to be loaded into SQreamDB ("col1,col2, ...") * - ``-config`` - Optional - ``config/sqload-jdbc-oracle-incr.properties`` - Defines the configuration file you wish to use * - ``-count`` - Optional - ``true`` - Defines whether or not table rows will be counted before being loaded into SQreamDB * - ``-delete`` - Optional - ``true`` - Defines whether or not loading using Change Data Capture (CDC) includes deleted rows * - ``-drop`` - Optional - ``true`` - Defines whether or not a new target table in SQreamDB is created. If ``false``, you will need to configure a target table name using the ``-target`` parameter * - ``-fetchsize`` - Optional - ``100000`` - The number of records to be read at once from source database. * - ``-filter`` - Optional - ``1=1`` - Defines whether or not only records with SQL conditions are loaded * - ``-h, --help`` - Optional - None - Displays the help menu and exits * - ``-limit`` - Optional - ``0`` (no limit) - Limits the number of rows to be loaded * - ``-load_dttm`` - Optional - ``true`` - Add an additional ``load_dttm`` column that defines the time and date of loading * - ``-lock_check`` - Optional - ``true`` - Defines whether or not SQLoader will check source table is locked before the loading starts * - ``-lock_table`` - Optional - ``true`` - Defines whether or not SQLoader will lock target table before the loading starts * - ``-log_dir`` - Optional - ``logs`` - Defines the path of log directory created when loading data. If no value is specified, a ``logs`` folder is created under the same location as the ``sqloader.jar`` file * - ``-partition`` - Optional - None - Defines the partition to load data from if table is partitioned * - ``-rowid`` - Optional - ``false`` - Defines whether or not SQLoader will get row IDs from Oracle tables * - ``-split`` - Optional - None - Column name for split (required for multi-thread loads) * - ``-table`` - Mandatory - None - Source table name to load data from * - ``-target`` - Optional - Source table name - Target table name to load data into * - ``-target_db`` - Optional - None - Target database name to load data into * - ``-thread`` - Optional - ``1`` - Number of threads to be used during loading * - ``-truncate`` - Optional - ``false`` - Truncate target table before loading * - ``-type`` - Optional - ``full`` - Defines a loading type that affects the table that is created in SQreamDB. Options are ``full``, ``cdc``, or ``incremental``. Please note that ``cdc``, and ``incremental`` are supported only for Oracle * - ``-use_dbms_lob`` - Optional - ``true`` - Defines whether or not SQLoader uses ``dbms_lob_substr`` function for ``CLOB`` and ``BLOB`` data types * - ``-use_partitions`` - Optional - ``true`` - Defines whether or not SQLoader uses partitions in ``SELECT`` statements Using the ``type`` Parameter ============================ Using the ``type`` parameter you may define a loading type that affects the table that is created in SQreamDB. .. list-table:: The ``type`` Parameter :widths: auto :header-rows: 1 * - Loading Type - Description * - Full Table - The entire data of the source table is loaded into SQreamDB * - Change Data Capture (CDC) - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT``, ``UPDATE``, and ``DELETE`` statements. SQLoader recognizes tables by table name and metadata. Supported for Oracle only * - Incremental - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT`` statement. SQLoader recognizes the table by table name and metadata. Supported for Oracle only Data Type Mapping ================= The **SQLoader** automatically maps data types used in Postgresql and Oracle tables that are loaded into SQreamDB. .. list-table:: Postgresql :widths: auto :header-rows: 1 * - Postgresql Type - SQreamDB Type * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``NVARCHAR``, ``NVARCHAR2``, ``CHARACTER``, ``NTEXT`` - ``TEXT`` * - ``TEXT`` - ``TEXT`` * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INT``, ``TINYINT`` - ``BIGINT`` * - ``DATETIME``, ``TIMESTAMP``, ``SMALLDATETIME``, ``DATETIMEOFFSET``, ``DATETIME2`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BIT`` - ``BOOL`` * - ``decimal``, ``numeric`` - ``numeric`` * - ``float``, ``double`` - ``double`` * - ``REAL`` - ``REAL`` * - ``VARBINARY`` - ``TEXT`` .. list-table:: Oracle :widths: auto :header-rows: 1 * - Oracle Type - SQreamDB Type * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGE`` - ``BIGINT`` * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``VARCHAR2``, ``NVARCHAR``, ``NVARCHAR2``, ``CHARACTER`` - ``TEXT`` * - ``DATE``, ``DATETIME`` - ``DATETIME`` * - ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOLEAN`` - ``BOOL`` * - ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``CLOB`` - ``TEXT`` * - ``BLOB`` - ``TEXT`` CLI Examples ============ Loading data into a CDC table using the ``type`` and ``limit`` parameters: .. code-block:: console java -jar sqloader-0.0.6.jar -table source_table_name -type cdc -limit 100 Loading data into a table using your own configuration file (this will override the default configuration file): .. code-block:: console java -jar sqloader-0.0.6.jar -config path/to/your/config/file Loading data into a table using a custom configuration file: .. code-block:: console java -jar -config MyConfigFile.properties -table source_table_name -type cdc -target target_table_name -drop true -lock_check false Loading data into a table using a the ``filter`` parameter: .. code-block:: console java -jar sqloader-0.0.6.jar -table source_table_name -filter column_name>50 \ No newline at end of file diff --git a/data_ingestion/json.rst b/data_ingestion/json.rst index 50fe2258c..3612ad64e 100644 --- a/data_ingestion/json.rst +++ b/data_ingestion/json.rst @@ -1 +1 @@ -.. _json: ************************** Ingesting Data from JSON ************************** .. contents:: :local: :depth: 1 Overview ======== JSON (Java Script Object Notation) is used both as a file format and as a serialization method. The JSON file format is flexible and is commonly used for dynamic, nested, and semi-structured data representations. The SQream DB JSON parser supports the `RFC 8259 <https://datatracker.ietf.org/doc/html/rfc8259>`_ data interchange format and supports both JSON objects and JSON object arrays. Only the `JSON Lines <https://jsonlines.org/>`_ data format is supported by SQream. Making JSON Files Accessible to Workers ======================================= To give workers access to files, every node in your system must have access to the storage being used. The following are required for JSON files to be accessible to workers: * For files hosted on NFS, ensure that the mount is accessible from all servers. * For HDFS, ensure that SQream servers have access to the HDFS NameNode with the correct **user-id**. For more information, see :ref:`hdfs`. * For S3, ensure network access to the S3 endpoint. For more information, see :ref:`s3`. For more information about configuring worker access, see :ref:`workload_manager`. Mapping between JSON and SQream =============================== A JSON field consists of a key name and a value. Key names, which are case sensitive, are mapped to SQream columns. Key names which do not have corresponding SQream table columns are treated as errors by default, unless the ``IGNORE_EXTRA_FIELDS`` parameter is set to ``true``, in which case these key names will be ignored during the mapping process. SQream table columns which do not have corresponding JSON fields are automatically set to ``null`` as a value. Values may be one of the following reserved words (lower-case): ``false``, ``true``, or ``null``, or any of the following data types: .. list-table:: :widths: auto :header-rows: 1 * - JSON Data Type - Representation in SQream * - Number - ``TINYINT``, ``SMALLINT``, ``INT``, ``BIGINT``, ``FLOAT``, ``DOUBLE``, ``NUMERIC`` * - String - ``TEXT`` * - JSON Literal - ``NULL``, ``TRUE``, ``FALSE`` * - JSON Array - ``TEXT`` * - JSON Object - ``TEXT`` Character Escaping ------------------ The ASCII 10 character (LF) marks the end of JSON objects. Use ``\\n`` to escape the ``\n`` character when you do not mean it be a new line. Ingesting JSON Data into SQream =============================== .. contents:: In this topic: :local: Syntax ------- To access JSON files, use the ``json_fdw`` with a ``COPY FROM``, ``COPY TO``, or ``CREATE FOREIGN TABLE`` statement. The Foreign Data Wrapper (FDW) syntax is: .. code-block:: json_fdw [OPTIONS(option=value[,...])] Parameters ------------ The following parameters are supported by ``json_fdw``: .. list-table:: :widths: auto :header-rows: 1 * - Parameter - Description * - ``DATETIME_FORMAT`` - Default format is ``yyyy-mm-dd``. Other supported date formats are:``iso8601``, ``iso8601c``, ``dmy``, ``ymd``, ``mdy``, ``yyyymmdd``, ``yyyy-m-d``, ``yyyy-mm-dd``, ``yyyy/m/d``, ``yyyy/mm/dd``, ``d/m/yyyy``, ``dd/mm/yyyy``, ``mm/dd/yyyy``, ``dd-mon-yyyy``, ``yyyy-mon-dd``. * - ``IGNORE_EXTRA_FIELDS`` - Default value is ``false``. When value is ``true``, key names which do not have corresponding SQream table columns will be ignored. Parameter may be used with the ``COPY TO`` and ``IGNORE FOREIGN TABLE`` statements. * - ``COMPRESSION`` - Supported values are ``auto``, ``gzip``, and ``none``. ``auto`` means that the compression type is automatically detected upon import. Parameter is not supported for exporting. ``gzip`` means that a ``gzip`` compression is applied. ``none`` means that no compression or an attempt to decompress will take place. * - ``LOCATION`` - A path on the local filesystem, on S3, or on HDFS URI. The local path must be an absolute path that SQream DB can access. * - ``LIMIT`` - When specified, tells SQream DB to stop ingesting after the specified number of rows. Unlimited if unset. * - ``OFFSET`` - The row number from which to start ingesting. * - ``ERROR_LOG`` - If when using the ``COPY`` command, copying a row fails, the ``ERROR LOG`` command writes error information to the error log specified in the ``ERROR LOG`` command. * If an existing file path is specified, the file will be overwritten. * Specifying the same file for ``ERROR_LOG`` and ``REJECTED_DATA`` is not allowed and will result in error. * Specifying an error log when creating a foreign table will write a new error log for every query on the foreign table. * - ``CONTINUE_ON_ERROR`` - Specifies if errors should be ignored or skipped. When set to true, the transaction will continue despite rejected data. This parameter should be set together with ``ERROR_COUNT``. When reading multiple files, if an entire file cannot be opened, it will be skipped. * - ``ERROR_COUNT`` - Specifies the maximum number of faulty records that will be ignored. This setting must be used in conjunction with ``continue_on_error``. * - ``MAX_FILE_SIZE`` - Sets the maximum file size (bytes). * - ``ENFORCE_SINGLE_FILE`` - Permitted values are ``true`` or ``false``. When set to ``true``, a single file of unlimited size is created. This single file is not limited by the ``MAX_FILE_SIZE`` parameter. ``false`` permits creating several files together limited by the ``MAX_FILE_SIZE`` parameter. Default value: ``false``. * - ``AWS_ID``, ``AWS_SECRET`` - Specifies the authentication details for secured S3 buckets. Automatic Schema Inference --------------------------- You may let SQream DB automatically infer the schema of a foreign table when using ``json_fdw``. For more information, follow the :ref:`Automatic Foreign Table DDL Resolution<automatic_foreign_table_ddl_resolution>` page. Automatic Schema Inference example: .. code-block:: postgres CREATE FOREIGN TABLE t WRAPPER json_fdw OPTIONS ( location = 'somefile.json' ) ; Examples ------------ JSON object array: .. code-block:: postgres { "name":"Avery Bradley", "age":25, "position":"PG" } { "name":"Jae Crowder", "age":25, "position":"PG" } { "name":"John Holland", "age":27, "position":"SG" } JSON objects: .. code-block:: postgres [ { "name":"Avery Bradley", "age":25, "position":"PG" }, { "name":"Jae Crowder", "age":25, "position":"SF" }, { "name":"John Holland", "age":27, "position":"SG" } ] Using the ``COPY FROM`` statement: .. code-block:: postgres COPY t FROM WRAPPER json_fdw OPTIONS ( location = 'somefile.json' ) ; Note that JSON files generated using the ``COPY TO`` statement will store objects, and not object arrays. .. code-block:: postgres COPY t TO WRAPPER json_fdw OPTIONS ( location = 'somefile.json' ) ; When using the ``CREATE FOREIGN TABLE`` statement, make sure that the table schema corresponds with the JSON file structure. .. code-block:: postgres CREATE FOREIGN TABLE t ( id int not null ) WRAPPER json_fdw OPTIONS ( location = 'somefile.json' ) ; The following is an example of loading data from a JSON file into SQream: .. code-block:: postgres WRAPPER json_fdw OPTIONS ( LOCATION = 'somefile.json' ); .. tip:: An exact match must exist between the SQream and JSON types. For unsupported column types, you can set the type to any type and exclude it from subsequent queries. \ No newline at end of file +.. _json: **** JSON **** .. contents:: :local: :depth: 1 Overview ======== JSON (Java Script Object Notation) is used both as a file format and as a serialization method. The JSON file format is flexible and is commonly used for dynamic, nested, and semi-structured data representations. The SQreamDB JSON parser supports the `RFC 8259 <https://datatracker.ietf.org/doc/html/rfc8259>`_ data interchange format and supports both JSON objects and JSON object arrays. Only the `JSON Lines <https://jsonlines.org/>`_ data format is supported by SQreamDB. Making JSON Files Accessible to Workers ======================================= To give workers access to files, every node in your system must have access to the storage being used. The following are required for JSON files to be accessible to workers: * For files hosted on NFS, ensure that the mount is accessible from all servers. * For HDFS, ensure that SQreamDB servers have access to the HDFS NameNode with the correct **user-id**. For more information, see :ref:`hdfs`. * For S3, ensure network access to the S3 endpoint. For more information, see :ref:`s3`. For more information about configuring worker access, see :ref:`workload_manager`. Mapping between JSON and SQreamDB ================================= A JSON field consists of a key name and a value. Key names, which are case sensitive, are mapped to SQreamDB columns. Key names which do not have corresponding SQreamDB table columns are treated as errors by default, unless the ``IGNORE_EXTRA_FIELDS`` parameter is set to ``true``, in which case these key names will be ignored during the mapping process. SQreamDB table columns which do not have corresponding JSON fields are automatically set to ``null`` as a value. Values may be one of the following reserved words (lower-case): ``false``, ``true``, or ``null``, or any of the following data types: .. list-table:: :widths: auto :header-rows: 1 * - JSON Data Type - Representation in SQreamDB * - Number - ``TINYINT``, ``SMALLINT``, ``INT``, ``BIGINT``, ``FLOAT``, ``DOUBLE``, ``NUMERIC`` * - String - ``TEXT`` * - JSON Literal - ``NULL``, ``TRUE``, ``FALSE`` * - JSON Array - ``TEXT`` * - JSON Object - ``TEXT`` Character Escaping ------------------ The ASCII 10 character (LF) marks the end of JSON objects. Use ``\\n`` to escape the ``\n`` character when you do not mean it be a new line. Ingesting JSON Data into SQreamDB ================================= .. contents:: In this topic: :local: Syntax ------ To access JSON files, use the ``json_fdw`` with a ``COPY FROM``, ``COPY TO``, or ``CREATE FOREIGN TABLE`` statement. The Foreign Data Wrapper (FDW) syntax is: .. code-block:: json_fdw [OPTIONS(option=value[,...])] Parameters ---------- The following parameters are supported by ``json_fdw``: .. list-table:: :widths: auto :header-rows: 1 * - Parameter - Description * - ``DATETIME_FORMAT`` - Default format is ``yyyy-mm-dd``. Other supported date formats are:``iso8601``, ``iso8601c``, ``dmy``, ``ymd``, ``mdy``, ``yyyymmdd``, ``yyyy-m-d``, ``yyyy-mm-dd``, ``yyyy/m/d``, ``yyyy/mm/dd``, ``d/m/yyyy``, ``dd/mm/yyyy``, ``mm/dd/yyyy``, ``dd-mon-yyyy``, ``yyyy-mon-dd``. * - ``IGNORE_EXTRA_FIELDS`` - Default value is ``false``. When value is ``true``, key names which do not have corresponding SQreamDB table columns will be ignored. Parameter may be used with the ``COPY TO`` and ``IGNORE FOREIGN TABLE`` statements. * - ``COMPRESSION`` - Supported values are ``auto``, ``gzip``, and ``none``. ``auto`` means that the compression type is automatically detected upon import. Parameter is not supported for exporting. ``gzip`` means that a ``gzip`` compression is applied. ``none`` means that no compression or an attempt to decompress will take place. * - ``LOCATION`` - A path on the local filesystem, on S3, or on HDFS URI. The local path must be an absolute path that SQreamDB can access. * - ``LIMIT`` - When specified, tells SQreamDB to stop ingesting after the specified number of rows. Unlimited if unset. * - ``OFFSET`` - The row number from which to start ingesting. * - ``ERROR_LOG`` - If when using the ``COPY`` command, copying a row fails, the ``ERROR LOG`` command writes error information to the error log specified in the ``ERROR LOG`` command. * If an existing file path is specified, the file will be overwritten. * Specifying the same file for ``ERROR_LOG`` and ``REJECTED_DATA`` is not allowed and will result in error. * Specifying an error log when creating a foreign table will write a new error log for every query on the foreign table. * - ``CONTINUE_ON_ERROR`` - Specifies if errors should be ignored or skipped. When set to true, the transaction will continue despite rejected data. This parameter should be set together with ``ERROR_COUNT``. When reading multiple files, if an entire file cannot be opened, it will be skipped. * - ``ERROR_COUNT`` - Specifies the maximum number of faulty records that will be ignored. This setting must be used in conjunction with ``continue_on_error``. * - ``MAX_FILE_SIZE`` - Sets the maximum file size (bytes). * - ``ENFORCE_SINGLE_FILE`` - Permitted values are ``true`` or ``false``. When set to ``true``, a single file of unlimited size is created. This single file is not limited by the ``MAX_FILE_SIZE`` parameter. ``false`` permits creating several files together limited by the ``MAX_FILE_SIZE`` parameter. Default value: ``false``. * - ``AWS_ID``, ``AWS_SECRET`` - Specifies the authentication details for secured S3 buckets. Automatic Schema Inference -------------------------- You may let SQreamDB automatically infer the schema of a foreign table when using ``json_fdw``. For more information, follow the :ref:`Automatic Foreign Table DDL Resolution<automatic_foreign_table_ddl_resolution>` page. Automatic Schema Inference example: .. code-block:: postgres CREATE FOREIGN TABLE t WRAPPER json_fdw OPTIONS ( location = 'somefile.json' ) ; Examples -------- JSON object array: .. code-block:: postgres { "name":"Avery Bradley", "age":25, "position":"PG" } { "name":"Jae Crowder", "age":25, "position":"PG" } { "name":"John Holland", "age":27, "position":"SG" } JSON objects: .. code-block:: postgres [ { "name":"Avery Bradley", "age":25, "position":"PG" }, { "name":"Jae Crowder", "age":25, "position":"SF" }, { "name":"John Holland", "age":27, "position":"SG" } ] Using the ``COPY FROM`` statement: .. code-block:: postgres COPY t FROM WRAPPER json_fdw OPTIONS ( location = 'somefile.json' ) ; Note that JSON files generated using the ``COPY TO`` statement will store objects, and not object arrays. .. code-block:: postgres COPY t TO WRAPPER json_fdw OPTIONS ( location = 'somefile.json' ) ; When using the ``CREATE FOREIGN TABLE`` statement, make sure that the table schema corresponds with the JSON file structure. .. code-block:: postgres CREATE FOREIGN TABLE t ( id int not null ) WRAPPER json_fdw OPTIONS ( location = 'somefile.json' ) ; The following is an example of loading data from a JSON file into SQreamDB: .. code-block:: postgres WRAPPER json_fdw OPTIONS ( LOCATION = 'somefile.json' ); .. tip:: An exact match must exist between the SQreamDB and JSON types. For unsupported column types, you can set the type to any type and exclude it from subsequent queries. \ No newline at end of file diff --git a/data_ingestion/orc.rst b/data_ingestion/orc.rst index 4906a80de..8a88b4228 100644 --- a/data_ingestion/orc.rst +++ b/data_ingestion/orc.rst @@ -1,18 +1,18 @@ .. _orc: -********************** -Ingesting Data from an ORC File -********************** +*** +ORC +*** .. contents:: :local: :depth: 1 -This guide covers ingesting data from ORC files into SQream DB using :ref:`FOREIGN TABLE<external_tables>`. +This guide covers ingesting data from ORC files into SQreamDB using :ref:`FOREIGN TABLE<external_tables>`. Prepare the files -===================== +================= Prepare the source ORC files, with the following requirements: @@ -21,7 +21,7 @@ Prepare the source ORC files, with the following requirements: :header-rows: 1 - * - SQream DB type → + * - SQreamDB type → ORC source - ``BOOL`` @@ -157,20 +157,20 @@ Prepare the source ORC files, with the following requirements: .. [#f7] Will succeed if all values fit the destination type -Place ORC files where SQream DB workers can access them -================================================================ +Place ORC files where SQreamDB workers can access them +====================================================== Any worker may try to access files (unless explicitly speficied with the :ref:`workload_manager`). -It is important that every node has the same view of the storage being used - meaning, every SQream DB worker should have access to the files. +It is important that every node has the same view of the storage being used - meaning, every SQreamDB worker should have access to the files. * For files hosted on NFS, ensure that the mount is accessible from all servers. -* For HDFS, ensure that SQream DB servers can access the HDFS name node with the correct user-id. See our :ref:`hdfs` guide for more information. +* For HDFS, ensure that SQreamDB servers can access the HDFS name node with the correct user-id. See our :ref:`hdfs` guide for more information. * For S3, ensure network access to the S3 endpoint. See our :ref:`s3` guide for more information. Figure out the table structure -=============================================== +============================== Prior to loading data, you will need to write out the table structure, so that it matches the file structure. @@ -208,13 +208,13 @@ We will make note of the file structure to create a matching ``CREATE FOREIGN TA .. tip:: - Types in SQream DB must match ORC types according to the table above. + Types in SQreamDB must match ORC types according to the table above. If the column type isn't supported, a possible workaround is to set it to any arbitrary type and then exclude it from subsequent queries. Verify table contents -==================================== +===================== External tables do not verify file integrity or structure, so verify that the table definition matches up and contains the correct data. @@ -236,10 +236,10 @@ External tables do not verify file integrity or structure, so verify that the ta If any errors show up at this stage, verify the structure of the ORC files and match them to the external table structure you created. -Copying data into SQream DB -=================================== +Copying data into SQreamDB +========================== -To load the data into SQream DB, use the :ref:`create_table_as` statement: +To load the data into SQreamDB, use the :ref:`create_table_as` statement: .. code-block:: postgres @@ -247,7 +247,7 @@ To load the data into SQream DB, use the :ref:`create_table_as` statement: SELECT * FROM ext_nba; Working around unsupported column types ---------------------------------------------- +--------------------------------------- Suppose you only want to load some of the columns - for example, if one of the columns isn't supported. @@ -264,7 +264,7 @@ For this example, assume that the ``Position`` column isn't supported because of Modifying data during the copy process ------------------------------------------- +-------------------------------------- One of the main reasons for staging data with ``EXTERNAL TABLE`` is to examine the contents and modify them before loading them. @@ -281,13 +281,13 @@ Similar to the previous example, we will also set the ``Position`` column as a d Further ORC loading examples -======================================= +============================ :ref:`create_foreign_table` contains several configuration options. See more in :ref:`the CREATE FOREIGN TABLE parameters section<cft_parameters>`. Loading a table from a directory of ORC files on HDFS ------------------------------------------------------------- +----------------------------------------------------- .. code-block:: postgres @@ -302,7 +302,7 @@ Loading a table from a directory of ORC files on HDFS CREATE TABLE users AS SELECT * FROM ext_users; Loading a table from a bucket of files on S3 ------------------------------------------------ +-------------------------------------------- .. code-block:: postgres diff --git a/data_ingestion/parquet.rst b/data_ingestion/parquet.rst index bb6bf05bb..fbc5aa383 100644 --- a/data_ingestion/parquet.rst +++ b/data_ingestion/parquet.rst @@ -1,24 +1,25 @@ .. _parquet: -********************** -Ingesting Data from a Parquet File -********************** +******* +Parquet +******* -Ingesting Parquet files into SQream is generally useful when you want to store the data permanently and perform frequent queries on it. Ingesting the data can also make it easier to join with other tables in your database. However, if you wish to retain your data on external Parquet files instead of ingesting it into SQream due to it being an open-source column-oriented data storage format, you may also execute :ref:`FOREIGN TABLE<foreign_tables>` queries. +Ingesting Parquet files into SQreamDB is generally useful when you want to store the data permanently and perform frequent queries on it. Ingesting the data can also make it easier to join with other tables in your database. However, if you wish to retain your data on external Parquet files instead of ingesting it into SQreamDB due to it being an open-source column-oriented data storage format, you may also execute :ref:`FOREIGN TABLE<foreign_tables>` queries. .. contents:: :local: :depth: 1 Preparing Your Parquet Files -===================== +============================ + Prepare your source Parquet files according to the requirements described in the following table: .. list-table:: :widths: 40 5 20 20 20 20 5 5 5 5 10 :header-rows: 1 - * - SQream Type → + * - SQreamDB Type → :: @@ -165,17 +166,19 @@ Your statements will succeed even if your Parquet file contains unsupported type .. [#f4] Any microseconds will be rounded down to milliseconds. Making Parquet Files Accessible to Workers -================================================================ +========================================== + To give workers access to files, every node must have the same view of the storage being used. * For files hosted on NFS, ensure that the mount is accessible from all servers. -* For HDFS, ensure that SQream servers have access to the HDFS name node with the correct user-id. For more information, see :ref:`hdfs` guide. +* For HDFS, ensure that SQreamDB servers have access to the HDFS name node with the correct user-id. For more information, see :ref:`hdfs` guide. * For S3, ensure network access to the S3 endpoint. For more information, see :ref:`s3` guide. Creating a Table -=============================================== +================ + Before loading data, you must create a table that corresponds to the file structure of the table you wish to insert. The example in this section is based on the source nba.parquet table shown below: @@ -207,16 +210,17 @@ The following example shows the correct file structure used for creating a :ref: LOCATION = 's3://sqream-demo-data/nba.parquet' ); -.. tip:: An exact match must exist between the SQream and Parquet types. For unsupported column types, you can set the type to any type and exclude it from subsequent queries. +.. tip:: An exact match must exist between the SQreamDB and Parquet types. For unsupported column types, you can set the type to any type and exclude it from subsequent queries. .. note:: The **nba.parquet** file is stored on S3 at ``s3://sqream-demo-data/nba.parquet``. -Ingesting Data into SQream -========================== +Ingesting Data into SQreamDB +============================ Syntax ------------ -You can use the :ref:`create_table_as` statement to load the data into SQream, as shown below: +------ + +You can use the :ref:`create_table_as` statement to load the data into SQreamDB, as shown below: .. code-block:: postgres @@ -224,14 +228,16 @@ You can use the :ref:`create_table_as` statement to load the data into SQream, a SELECT * FROM ext_nba; Examples ----------------- +-------- + .. contents:: :local: :depth: 1 Omitting Unsupported Column Types -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + When loading data, you can omit columns using the NULL as argument. You can use this argument to omit unsupported columns from queries that access external tables. By omitting them, these columns will not be called and will avoid generating a “type mismatch” error. In the example below, the ``Position column`` is not supported due its type. @@ -242,8 +248,9 @@ In the example below, the ``Position column`` is not supported due its type. SELECT Name, Team, Number, NULL as Position, Age, Height, Weight, College, Salary FROM ext_nba; Modifying Data Before Loading -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -One of the main reasons for staging data using the ``EXTERNAL TABLE`` argument is to examine and modify table contents before loading it into SQream. +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +One of the main reasons for staging data using the ``EXTERNAL TABLE`` argument is to examine and modify table contents before loading it into SQreamDB. For example, we can replace **pounds** with **kilograms** using the ``CREATE TABLE AS`` statement. @@ -257,7 +264,8 @@ In the example below, the ``Position column`` is set to the default ``NULL``. ORDER BY weight; Loading a Table from a Directory of Parquet Files on HDFS -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + The following is an example of loading a table from a directory of Parquet files on HDFS: .. code-block:: postgres @@ -273,7 +281,8 @@ The following is an example of loading a table from a directory of Parquet files CREATE TABLE users AS SELECT * FROM ext_users; Loading a Table from a Directory of Parquet Files on S3 -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + The following is an example of loading a table from a directory of Parquet files on S3: .. code-block:: postgres @@ -292,8 +301,9 @@ The following is an example of loading a table from a directory of Parquet files For more configuration option examples, navigate to the :ref:`create_foreign_table` page and see the **Parameters** table. Best Practices -============ -Because external tables do not automatically verify the file integrity or structure, SQream recommends manually verifying your table output when ingesting Parquet files into SQream. This lets you determine if your table output is identical to your originally inserted table. +============== + +Because external tables do not automatically verify the file integrity or structure, SQreamDB recommends manually verifying your table output when ingesting Parquet files into SQreamDB. This lets you determine if your table output is identical to your originally inserted table. The following is an example of the output based on the **nba.parquet** table: From ed60341c5294e11e074042b12433208f6e0446b0 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 27 Jul 2023 09:26:16 +0300 Subject: [PATCH 665/882] Update 4.3.rst --- releases/4.3.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/releases/4.3.rst b/releases/4.3.rst index eb0ecebfe..35e00d73b 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -34,6 +34,8 @@ Compatibility Matrix New Features and Enhancements ----------------------------- +► A new :re:`SQLoader <ingesting_from_databases>` will enable you to load data into SQreamDB from other databases. + ► Access control permissions in SQreamDB have been expanded, allowing roles to now grant and revoke access to other roles for the following: * VIEWS From ad9fd46f70f517c00fcd3b7a189d86578109ae4a Mon Sep 17 00:00:00 2001 From: shaharf111 <112806728+shaharf111@users.noreply.github.com> Date: Sun, 30 Jul 2023 11:32:29 +0300 Subject: [PATCH 666/882] Remove k8s --- .../installing_and_launching_sqream.rst | 1 - .../installing_sqream_with_kubernetes.rst | 1816 ----------------- 2 files changed, 1817 deletions(-) delete mode 100644 installation_guides/installing_sqream_with_kubernetes.rst diff --git a/installation_guides/installing_and_launching_sqream.rst b/installation_guides/installing_and_launching_sqream.rst index 6a41ba52b..2c325c3a7 100644 --- a/installation_guides/installing_and_launching_sqream.rst +++ b/installation_guides/installing_and_launching_sqream.rst @@ -12,6 +12,5 @@ The **Installing and Launching SQream** page includes the following installation recommended_pre-installation_configurations installing_sqream_with_binary running_sqream_in_a_docker_container - installing_sqream_with_kubernetes installing_monit launching_sqream_with_monit \ No newline at end of file diff --git a/installation_guides/installing_sqream_with_kubernetes.rst b/installation_guides/installing_sqream_with_kubernetes.rst deleted file mode 100644 index 0abde10d3..000000000 --- a/installation_guides/installing_sqream_with_kubernetes.rst +++ /dev/null @@ -1,1816 +0,0 @@ -.. _installing_sqream_with_kubernetes: - -********************************************* -Installing SQream with Kubernetes -********************************************* -**Kubernetes**, also known as **k8s**, is a portable open source platform that automates Linux container operations. Kubernetes supports outsourcing data centers to public cloud service providers or can be scaled for web hosting. SQream uses Kubernetes as an orchestration and recovery solution. - -The **Installing SQream with Kubernetes** guide describes the following: - -.. contents:: - :local: - :depth: 1 - -.. _preparing_sqream_environment: - -Preparing the SQream Environment to Launch SQream Using Kubernetes -=============== - -The **Preparing the SQream environment to Launch SQream Using Kubernetes** section describes the following: - -.. contents:: - :local: - :depth: 1 - -Overview --------------- - -A minimum of three servers is required for preparing the SQream environment using Kubernetes. - -Kubernetes uses clusters, which are sets of nodes running containterized applications. A cluster consists of at least two GPU nodes and one additional server without GPU to act as the quorum manager. - -Each server must have the following IP addresses: - -* An IP address located in the management network. -* An additional IP address from the same subnet to function as a floating IP. - -All servers must be mounted in the same shared storage folder. - -The following list shows the server host name format requirements: - -* A maximum of 253 characters. -* Only lowercase alphanumeric characters, such as ``-`` or ``.``. -* Starts and ends with alphanumeric characters. - -Go back to :ref:`Preparing the SQream Environment to Launch SQream Using Kubernetes<preparing_sqream_environment>` - - -Operating System Requirements ------------------------------- -The required operating system is a version of x86 CentOS/RHEL between 7.6 and 7.9. Regarding PPC64le, the required version is RHEL 7.6. - -Go back to :ref:`Preparing the SQream Environment to Launch SQream Using Kubernetes<preparing_sqream_environment>` - - -Compute Server Specifications ------------------------------- -Installing SQream with Kubernetes includes the following compute server specifications: - -* **CPU:** 4 cores -* **RAM:** 16GB -* **HD:** 500GB - -Go back to :ref:`Preparing the SQream Environment to Launch SQream Using Kubernetes<preparing_sqream_environment>` - -.. _set_up_your_hosts: - -Setting Up Your Hosts -=============================== -SQream requires you to set up your hosts. Setting up your hosts requires the following: - -.. contents:: - :local: - :depth: 1 - -Configuring the Hosts File --------------------------------- -**To configure the /etc/hosts file:** - -1. Edit the **/etc/hosts** file: - - .. code-block:: console - - $ sudo vim /etc/hosts - -2. Call your local host: - - .. code-block:: console - - $ 127.0.0.1 localhost - $ <server ip> <server_name> - - -Installing the Required Packages ----------------------------------- -The first step in setting up your hosts is to install the required packages. - -**To install the required packages:** - -1. Run the following command based on your operating system: - - * RHEL: - - .. code-block:: postgres - - $ sudo yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm - - * CentOS: - - .. code-block:: postgres - - $ sudo yum install epel-release - $ sudo yum install pciutils openssl-devel python36 python36-pip kernel-devel-$(uname -r) kernel-headers-$(uname -r) gcc jq net-tools ntp - -2. Verify that that the required packages were successfully installed. The following is the correct output: - - .. code-block:: postgres - - ntpq --version - jq --version - python3 --version - pip3 --version - rpm -qa |grep kernel-devel-$(uname -r) - rpm -qa |grep kernel-headers-$(uname -r) - gcc --version - -3. Enable the **ntpd (Network Time Protocol daemon)** program on all servers: - - .. code-block:: postgres - - $ sudo systemctl start ntpd - $ sudo systemctl enable ntpd - $ sudo systemctl status ntpd - $ sudo ntpq -p - -Go back to :ref:`Setting Up Your Hosts<set_up_your_hosts>` - - -Disabling the Linux UI ----------------------------------- -After installing the required packages, you must disable the Linux UI if it has been installed. - -You can disable Linux by running the following command: - - .. code-block:: postgres - - $ sudo systemctl set-default multi-user.target - -Go back to :ref:`Setting Up Your Hosts<set_up_your_hosts>` - - -Disabling SELinux ----------------------------------- -After disabling the Linux UI you must disable SELinux. - -**To disable SELinux:** - - 1. Run the following command: - - .. code-block:: postgres - - $ sed -i -e s/enforcing/disabled/g /etc/selinux/config - $ sudo reboot - - 2. Reboot the system as a root user: - - .. code-block:: postgres - - $ sudo reboot - -Go back to :ref:`Setting Up Your Hosts<set_up_your_hosts>` - -Disabling Your Firewall ----------------------------------- -After disabling SELinux, you must disable your firewall by running the following commands: - - .. code-block:: postgres - - $ sudo systemctl stop firewalld - $ sudo systemctl disable firewalld - -Go back to :ref:`Setting Up Your Hosts<set_up_your_hosts>` - - -Checking the CUDA Version ----------------------------------- -After completing all of the steps above, you must check the CUDA version. - -**To check the CUDA version:** - -1. Check the CUDA version: - - .. code-block:: postgres - - $ nvidia-smi - - The following is an example of the correct output: - - .. code-block:: postgres - - +-----------------------------------------------------------------------------+ - | NVIDIA-SMI 470.82.01 Driver Version: 470.82.01 CUDA Version: 10.1 | - |-------------------------------+----------------------+----------------------+ - | GPU Name Persistence-M| Bus-Id Disp.A | Volatile Uncorr. ECC | - | Fan Temp Perf Pwr:Usage/Cap| Memory-Usage | GPU-Util Compute M. | - | | | MIG M. | - |===============================+======================+======================| - | 0 NVIDIA A100-PCI... On | 00000000:17:00.0 Off | 0 | - | N/A 34C P0 64W / 300W | 79927MiB / 80994MiB | 0% Default | - | | | Disabled | - +-------------------------------+----------------------+----------------------+ - | 1 NVIDIA A100-PCI... On | 00000000:CA:00.0 Off | 0 | - | N/A 35C P0 60W / 300W | 79927MiB / 80994MiB | 0% Default | - | | | Disabled | - +-------------------------------+----------------------+----------------------+ - - +-----------------------------------------------------------------------------+ - | Processes: GPU Memory | - | GPU PID Type Process name Usage | - |=============================================================================| - | No running processes found | - +-----------------------------------------------------------------------------+ - -In the above output, the CUDA version is **10.1**. - -If the above output is not generated, CUDA has not been installed. To install CUDA, see :ref:`installing-the-cuda-driver`. - -Go back to :ref:`Setting Up Your Hosts<set_up_your_hosts>` - -.. _install_kubernetes_cluster: - -Installing Your Kubernetes Cluster -=================================== -After setting up your hosts, you must install your Kubernetes cluster. The Kubernetes and SQream software must be installed from the management host, and can be installed on any server in the cluster. - -Installing your Kubernetes cluster requires the following: - -.. contents:: - :local: - :depth: 1 - -Generating and Sharing SSH Keypairs Across All Existing Nodes ------------------------------------- -You can generate and share SSH keypairs across all existing nodes. Sharing SSH keypairs across all nodes enables passwordless access from the management server to all nodes in the cluster. All nodes in the cluster require passwordless access. - -.. note:: You must generate and share an SSH keypair across all nodes even if you are installing the Kubernetes cluster on a single host. - -**To generate and share an SSH keypair:** - -1. Switch to root user access: - - .. code-block:: postgres - - $ sudo su - - -2. Generate an RSA key pair: - - .. code-block:: postgres - - $ ssh-keygen - -The following is an example of the correct output: - - .. code-block:: postgres - - $ ssh-keygen - $ Generating public/private rsa key pair. - $ Enter file in which to save the key (/root/.ssh/id_rsa): - $ Created directory '/root/.ssh'. - $ Enter passphrase (empty for no passphrase): - $ Enter same passphrase again: - $ Your identification has been saved in /root/.ssh/id_rsa. - $ Your public key has been saved in /root/.ssh/id_rsa.pub. - $ The key fingerprint is: - $ SHA256:xxxxxxxxxxxxxxdsdsdffggtt66gfgfg root@localhost.localdomain - $ The key's randomart image is: - $ +---[RSA 2048]----+ - $ | =*. | - $ | .o | - $ | ..o o| - $ | . .oo +.| - $ | = S =...o o| - $ | B + *..o+.| - $ | o * *..o .+| - $ | o * oo.E.o| - $ | . ..+..B.+o| - $ +----[SHA256]-----+ - -The generated file is ``/root/.ssh/id_rsa.pub``. - -3. Copy the public key to all servers in the cluster, including the one that you are running on. - - .. code-block:: postgres - - $ ssh-copy-id -i ~/.ssh/id_rsa.pub root@remote-host - -4. Replace the ``remote host`` with your host IP address. - -Go back to :ref:`Installing Your Kubernetes Cluster<install_kubernetes_cluster>` - -Installing and Deploying a Kubernetes Cluster Using Kubespray ------------------------------------- -SQream uses the Kubespray software package to install and deploy Kubernetes clusters. - -**To install and deploy a Kubernetes cluster using Kubespray:** - - -1. Clone Kubernetes: - - 1. Clone the **kubespray.git** repository: - - .. code-block:: postgres - - $ git clone https://github.com/kubernetes-incubator/kubespray.git - - 2. Nagivate to the **kubespray** directory: - - .. code-block:: postgres - - $ cd kubespray - - 3. Install the **requirements.txt** configuration file: - - .. code-block:: postgres - - $ pip3 install -r requirements.txt - -2. Create your SQream inventory directory: - - 1. Run the following command: - - .. code-block:: postgres - - $ cp -rp inventory/sample inventory/sqream - - 2. Replace the **<cluster node IP>** with the defined cluster node IP address(es). - - .. code-block:: postgres - - $ declare -a IPS=(<host>, <cluster node IP address>) - - For example, the following replaces ``192.168.0.93`` with ``192.168.0.92``: - - .. code-block:: postgres - - $ declare -a IPS=(host-93,192.168.0.93 host-92,192.168.0.92) - -Note the following: - * Running a declare requires defining a pair (host name and cluster node IP address), as shown in the above example. - * You can define more than one pair. - -3. When the reboot is complete, switch back to the root user: - - .. code-block:: postgres - - $ sudo su - - -4. Navigate to **root/kubespray**: - - .. code-block:: postgres - - $ cd /root/kubespray - -5. Copy ``inventory/sample`` as ``inventory/sqream``: - - .. code-block:: postgres - - $ cp -rfp inventory/sample inventory/sqream - -6. Update the Ansible inventory file with the inventory builder: - - .. code-block:: postgres - - $ declare -a IPS=(<hostname1>,<IP1> <hostname2>,<IP2> <hostname3>,<IP3>) - -7. In the **kubespray hosts.yml** file, set the node IP's: - - .. code-block:: postgres - - $ CONFIG_FILE=inventory/sqream/hosts.yml python3 contrib/inventory_builder/inventory.py ${IPS[@]} - - If you do not set a specific hostname in declare, the server hostnames will change to ``node1``, ``node2``, etc. To maintain specific hostnames, run declare as in the following example: - - .. code-block:: postgres - - $ declare -a IPS=(eks-rhl-1,192.168.5.81 eks-rhl-2,192.168.5.82 eks-rhl-3,192.168.5.83) - - Note that the declare must contain pairs (hostname,ip). - -:: - -8. Verify that the following have been done: - - * That the **hosts.yml** file is configured correctly. - * That all children are included with their relevant nodes. - -You can save your current server hostname by replacing <nodeX> with your server hostname. - -9. Generate the content output of the **hosts.yml** file. Make sure to include the file's directory: - - .. code-block:: postgres - - $ cat inventory/sqream/hosts.yml - -The hostname can be lowercase and contain ``-`` or ``.`` only, and must be aligned with the server's hostname. - -The following is an example of the correct output. Each host and IP address that you provided in Step 2 should be displayed once: - - .. code-block:: postgres - - $ all: - $ hosts: - $ node1: - $ ansible_host: 192.168.5.81 - $ ip: 192.168.5.81 - $ access_ip: 192.168.5.81 - $ node2: - $ ansible_host: 192.168.5.82 - $ ip: 192.168.5.82 - $ access_ip: 192.168.5.82 - $ node3: - $ ansible_host: 192.168.5.83 - $ ip: 192.168.5.83 - $ access_ip: 192.168.5.83 - $ children: - $ kube-master: - $ hosts: - $ node1: - $ node2: - $ node3: - $ kube-node: - $ hosts: - $ node1: - $ node2: - $ node3: - $ etcd: - $ hosts: - $ node1: - $ node2: - $ node3: - $ k8s-cluster: - $ children: - $ kube-master: - $ kube-node: - $ calico-rr: - $ hosts: {} - -Go back to :ref:`Installing Your Kubernetes Cluster<install_kubernetes_cluster>` - -Adjusting Kubespray Deployment Values -------------------------------------- -After downloading and configuring Kubespray, you can adjust your Kubespray deployment values. A script is used to modify how the Kubernetes cluster is deployed, and you must set the cluster name variable before running this script. - -.. note:: The script must be run from the **kubespray** folder. - -**To adjust Kubespray deployment values:** - -1. Add the following export to the local user’s **~/.bashrc** file by replacing the <VIP IP> with the user's Virtual IP address: - - .. code-block:: postgres - - $ export VIP_IP=<VIP IP> - -2. Logout, log back in, and verify the following: - - .. code-block:: postgres - - $ echo $VIP_IP - -3. Make the following replacements to the **kubespray.settings.sh** file: - - .. code-block:: postgres - - $ cat <<EOF > kubespray_settings.sh - $ sed -i "/cluster_name: cluster.local/c \cluster_name: cluster.local.$cluster_name" inventory/sqream/group_vars/k8s-cluster/k8s-cluster.yml - $ sed -i "/dashboard_enabled/c \dashboard_enabled\: "false"" inventory/sqream/group_vars/k8s-cluster/addons.yml - $ sed -i "/kube_version/c \kube_version\: "v1.18.3"" inventory/sqream/group_vars/k8s-cluster/k8s-cluster.yml - $ sed -i "/metrics_server_enabled/c \metrics_server_enabled\: "true"" inventory/sample/group_vars/k8s-cluster/addons.yml - $ echo 'kube_apiserver_node_port_range: "3000-6000"' >> inventory/sqream/group_vars/k8s-cluster/k8s-cluster.yml - $ echo 'kube_controller_node_monitor_grace_period: 20s' >> inventory/sqream/group_vars/k8s-cluster/k8s-cluster.yml - $ echo 'kube_controller_node_monitor_period: 2s' >> inventory/sqream/group_vars/k8s-cluster/k8s-cluster.yml - $ echo 'kube_controller_pod_eviction_timeout: 30s' >> inventory/sqream/group_vars/k8s-cluster/k8s-cluster.yml - $ echo 'kubelet_status_update_frequency: 4s' >> inventory/sqream/group_vars/k8s-cluster/k8s-cluster.yml - $ echo 'ansible ALL=(ALL) NOPASSWD: ALL' >> /etc/sudoers - $ EOF - -.. note:: In most cases, the Docker data resides on the system disk. Because Docker requires a high volume of data (images, containers, volumes, etc.), you can change the default Docker data location to prevent the system disk from running out of space. - -4. *Optional* - Change the default Docker data location: - - .. code-block:: postgres - - $ sed -i "/docker_daemon_graph/c \docker_daemon_graph\: "</path/to/desired/location>"" inventory/sqream/group_vars/all/docker.yml - -5. Make the **kubespray_settings.sh** file executable for your user: - - .. code-block:: postgres - - $ chmod u+x kubespray_settings.sh && ./kubespray_settings.sh - -6. Run the following script: - - .. code-block:: postgres - - $ ./kubespray_settings.sh - -7. Run a playbook on the **inventory/sqream/hosts.yml cluster.yml** file: - - .. code-block:: postgres - - $ ansible-playbook -i inventory/sqream/hosts.yml cluster.yml -v - -The Kubespray installation takes approximately 10 - 15 minutes. - -The following is an example of the correct output: - - .. code-block:: postgres - - $ PLAY RECAP - $ ********************************************************************************************* - $ node-1             : ok=680  changed=133  unreachable=0    failed=0 - $ node-2             : ok=583  changed=113  unreachable=0    failed=0 - $ node-3             : ok=586  changed=115  unreachable=0    failed=0 - $ localhost          : ok=1    changed=0    unreachable=0    failed=0 - -In the event that the output is incorrect, or a failure occurred during the installation, please contact a SQream customer support representative. - -Go back to :ref:`Installing Your Kubernetes Cluster<install_kubernetes_cluster>`. - -Checking Your Kubernetes Status -------------------------------- -After adjusting your Kubespray deployment values, you must check your Kubernetes status. - -**To check your Kuberetes status:** - -1. Check the status of the node: - - .. code-block:: postgres - - $ kubectl get nodes - -The following is an example of the correct output: - - .. code-block:: postgres - - $ NAME STATUS ROLES AGE VERSION - $ eks-rhl-1 Ready control-plane,master 29m v1.21.1 - $ eks-rhl-2 Ready control-plane,master 29m v1.21.1 - $ eks-rhl-3 Ready <none> 28m v1.21.1 - -2. Check the status of the pod: - - .. code-block:: postgres - - $ kubectl get pods --all-namespaces - - The following is an example of the correct output: - - .. code-block:: postgres - - $ NAMESPACE NAME READY STATUS RESTARTS AGE - $ kube-system calico-kube-controllers-68dc8bf4d5-n9pbp 1/1 Running 0 160m - $ kube-system calico-node-26cn9 1/1 Running 1 160m - $ kube-system calico-node-kjsgw 1/1 Running 1 160m - $ kube-system calico-node-vqvc5 1/1 Running 1 160m - $ kube-system coredns-58687784f9-54xsp 1/1 Running 0 160m - $ kube-system coredns-58687784f9-g94xb 1/1 Running 0 159m - $ kube-system dns-autoscaler-79599df498-hlw8k 1/1 Running 0 159m - $ kube-system kube-apiserver-k8s-host-1-134 1/1 Running 0 162m - $ kube-system kube-apiserver-k8s-host-194 1/1 Running 0 161m - $ kube-system kube-apiserver-k8s-host-68 1/1 Running 0 161m - $ kube-system kube-controller-manager-k8s-host-1-134 1/1 Running 0 162m - $ kube-system kube-controller-manager-k8s-host-194 1/1 Running 0 161m - $ kube-system kube-controller-manager-k8s-host-68 1/1 Running 0 161m - $ kube-system kube-proxy-5f42q 1/1 Running 0 161m - $ kube-system kube-proxy-bbwvk 1/1 Running 0 161m - $ kube-system kube-proxy-fgcfb 1/1 Running 0 161m - $ kube-system kube-scheduler-k8s-host-1-134 1/1 Running 0 161m - $ kube-system kube-scheduler-k8s-host-194 1/1 Running 0 161m - -Go back to :ref:`Installing Your Kubernetes Cluster<install_kubernetes_cluster>` - -Adding a SQream Label to Your Kubernetes Cluster Nodes -------------------------------------------------- -After checking your Kubernetes status, you must add a SQream label on your Kubernetes cluster nodes. - -**To add a SQream label on your Kubernetes cluster nodes:** - -1. Get the cluster node list: - - .. code-block:: postgres - - $ kubectl get nodes - - The following is an example of the correct output: - - .. code-block:: postgres - - $ NAME        STATUS   ROLES    AGE   VERSION - $ eks-rhl-1 Ready control-plane,master 29m v1.21.1 - $ eks-rhl-2 Ready control-plane,master 29m v1.21.1 - $ eks-rhl-3 Ready <none> 28m v1.21.1 - -2. Set the node label, change the ``node-name`` to the node NAME(s) in the above example: - - .. code-block:: postgres - - $ kubectl label nodes <node-name> cluster=sqream - - The following is an example of the correct output: - - .. code-block:: postgres - - $ [root@edk-rhl-1 kubespray]# kubectl label nodes eks-rhl-1 cluster=sqream - $ node/eks-rhl-1 labeled - $ [root@edk-rhl-1 kubespray]# kubectl label nodes eks-rhl-2 cluster=sqream - $ node/eks-rhl-2 labeled - $ [root@edk-rhl-1 kubespray]# kubectl label nodes eks-rhl-3 cluster=sqream - $ node/eks-rhl-3 labeled - -Go back to :ref:`Installing Your Kubernetes Cluster<install_kubernetes_cluster>` - -Copying Your Kubernetes Configuration API File to the Master Cluster Nodes -------------------------------------------------- -After adding a SQream label on your Kubernetes cluster nodes, you must copy your Kubernetes configuration API file to your Master cluster nodes. - -When the Kubernetes cluster installation is complete, an API configuration file is automatically created in the **.kube** folder of the root user. This file enables the **kubectl** command access Kubernetes' internal API service. Following this step lets you run **kubectl** commands from any node in the cluster. - - -.. warning:: You must perform this on the management server only! - -**To copy your Kubernetes configuration API file to your Master cluster nodes:** - -1. Create the **.kube** folder in the **local user** directory: - - .. code-block:: postgres - - $ mkdir /home/<local user>/.kube - -2. Copy the configuration file from the root user directory to the <local user> directory: - - .. code-block:: postgres - - $ sudo cp /root/.kube/config /home/<local user>/.kube - -3. Change the file owner from **root user** to the <local user>: - - .. code-block:: postgres - - $ sudo chown <local user>.<local user> /home/<local user>/.kube/config - -4. Create the **.kube** folder in the other nodes located in the <local user> directory: - - .. code-block:: postgres - - $ ssh <local user>@<node name> mkdir .kube - -5. Copy the configuration file from the management node to the other nodes: - - .. code-block:: postgres - - $ scp /home/<local user>/.kube/config <local user>@<node name>:/home/<local user>/.kube/ - -6. Under local user on each server you copied **.kube** to, run the following command: - - .. code-block:: postgres - - $ sudo usermod -aG docker $USER - -This grants the local user the necessary permissions to run Docker commands. - -Go back to :ref:`Installing Your Kubernetes Cluster<install_kubernetes_cluster>` - -Creating an env_file in Your Home Directory -------------------------------------------------- -After copying your Kubernetes configuration API file to your Master cluster nodes, you must create an **env_file** in your home directory, and must set the VIP address as a variable. - -.. warning:: You must perform this on the management server only! - - - -**To create an env_file for local users in the user's home directory:** - -1. Set a variable that includes the VIP IP address: - - .. code-block:: postgres - - $ export VIP_IP=<VIP IP> - -.. note:: If you use Kerberos, replace the ``KRB5_SERVER`` value with the IP address of your Kerberos server. - -2. Do one of the following: - - * For local users: - - .. code-block:: postgres - - $ mkdir /home/$USER/.sqream - -3. Make the following replacements to the **kubespray.settings.sh** file, verifying that the ``KRB5_SERVER`` parameter is set to your server IP: - - - .. code-block:: postgres - - $ cat <<EOF > /home/$USER/.sqream/env_file - SQREAM_K8S_VIP=$VIP_IP - SQREAM_ADMIN_UI_PORT=8080 - SQREAM_DASHBOARD_DATA_COLLECTOR_PORT=8100 - SQREAM_DATABASE_NAME=master - SQREAM_K8S_ADMIN_UI=sqream-admin-ui - SQREAM_K8S_DASHBOARD_DATA_COLLECTOR=dashboard-data-collector - SQREAM_K8S_METADATA=sqream-metadata - SQREAM_K8S_NAMESPACE=sqream - SQREAM_K8S_PICKER=sqream-picker - SQREAM_K8S_PROMETHEUS=prometheus - SQREAM_K8S_REGISTRY_PORT=6000 - SQREAM_METADATA_PORT=3105 - SQREAM_PICKER_PORT=3108 - SQREAM_PROMETHEUS_PORT=9090 - SQREAM_SPOOL_MEMORY_RATIO=0.25 - SQREAM_WORKER_0_PORT=5000 - KRB5CCNAME=FILE:/tmp/tgt - KRB5_SERVER=kdc.sq.com:<server IP>1 - KRB5_CONFIG_DIR=${ $ SQREAM_MOUNT_DIR}/krb5 - KRB5_CONFIG_FILE=${KRB5_CONFIG_DIR}/krb5.conf - HADOOP_CONFIG_DIR=${ $ SQREAM_MOUNT_DIR}/hadoop - HADOOP_CORE_XML=${HADOOP_CONFIG_DIR}/core-site.xml - HADOOP_HDFS_XML=${HADOOP_CONFIG_DIR}/hdfs-site.xml - EOF - -Go back to :ref:`Installing Your Kubernetes Cluster<install_kubernetes_cluster>` - - - - - -Creating a Base Kubernetes Namespace ------------------------------------- -After creating an env_file in the user's home directory, you must create a base Kubernetes namespace. - -You can create a Kubernetes namespace by running the following command: - -.. code-block:: postgres - - $ kubectl create namespace sqream-init - -The following is an example of the correct output: - -.. code-block:: postgres - - $ namespace/sqream-init created - -Go back to :ref:`Installing Your Kubernetes Cluster<install_kubernetes_cluster>` - - -Pushing the **env_file** File to the Kubernetes Configmap --------------------------------------- -After creating a base Kubernetes namespace, you must push the **env_file** to the Kubernetes configmap. You must push the **env_file** file to the Kubernetes **configmap** in the **sqream-init** namespace. - -This is done by running the following command: - -.. code-block:: postgres - - $ kubectl create configmap sqream-init -n sqream-init --from-env-file=/home/$USER/.sqream/env_file - -The following is an example of the correct output: - -.. code-block:: postgres - - $ configmap/sqream-init created - - -Go back to :ref:`Installing Your Kubernetes Cluster<install_kubernetes_cluster>` - - -Installing the NVIDIA Docker2 Toolkit -------------------------------------- -After pushing the **env_file** file to the Kubernetes configmap, you must install the NVIDIA Docker2 Toolkit. The **NVIDIA Docker2 Toolkit** lets users build and run GPU-accelerated Docker containers, and must be run only on GPU servers. The NVIDIA Docker2 Toolkit includes a container runtime library and utilities that automatically configure containers to leverage NVIDIA GPUs. - - -Installing the NVIDIA Docker2 Toolkit on an x86_64 Bit Processor on CentOS -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -**To install the NVIDIA Docker2 Toolkit on an x86_64 bit processor on CentOS:** - -1. Add the repository for your distribution: - - .. code-block:: postgres - - $ distribution=$(. /etc/os-release;echo $ID$VERSION_ID) - $ curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.repo | \ - $ sudo tee /etc/yum.repos.d/nvidia-docker.repo - -2. Install the **nvidia-docker2** package and reload the Docker daemon configuration: - - .. code-block:: postgres - - $ sudo yum install nvidia-docker2 - $ sudo pkill -SIGHUP dockerd - -3. Verify that the **nvidia-docker2** package has been installed correctly: - - .. code-block:: postgres - - $ docker run --runtime=nvidia --rm nvidia/cuda:10.1.3-base-centos7 nvidia-smi - - The following is an example of the correct output: - - .. code-block:: postgres - - docker run --runtime=nvidia --rm nvidia/cuda:10.1.3-base-centos7 nvidia-smi - Unable to find image 'nvidia/cuda:10.1.3-base-centos7' locally - 10.1.3-base-centos7: Pulling from nvidia/cuda - d519e2592276: Pull complete - d22d2dfcfa9c: Pull complete - b3afe92c540b: Pull complete - 13a10df09dc1: Pull complete - 4f0bc36a7e1d: Pull complete - cd710321007d: Pull complete - Digest: sha256:635629544b2a2be3781246fdddc55cc1a7d8b352e2ef205ba6122b8404a52123 - Status: Downloaded newer image for nvidia/cuda:10.1.3-base-centos7 - Sun Feb 14 13:27:58 2021 - +-----------------------------------------------------------------------------+ - | NVIDIA-SMI 470.82.01 Driver Version: 470.82.01 CUDA Version: 10.1 | - |-------------------------------+----------------------+----------------------+ - | GPU Name Persistence-M| Bus-Id Disp.A | Volatile Uncorr. ECC | - | Fan Temp Perf Pwr:Usage/Cap| Memory-Usage | GPU-Util Compute M. | - | | | MIG M. | - |===============================+======================+======================| - | 0 NVIDIA A100-PCI... On | 00000000:17:00.0 Off | 0 | - | N/A 34C P0 64W / 300W | 79927MiB / 80994MiB | 0% Default | - | | | Disabled | - +-------------------------------+----------------------+----------------------+ - | 1 NVIDIA A100-PCI... On | 00000000:CA:00.0 Off | 0 | - | N/A 35C P0 60W / 300W | 79927MiB / 80994MiB | 0% Default | - | | | Disabled | - +-------------------------------+----------------------+----------------------+ - - +-----------------------------------------------------------------------------+ - | Processes: GPU Memory | - | GPU PID Type Process name Usage | - |=============================================================================| - | No running processes found | - +-----------------------------------------------------------------------------+ - -For more information on installing the NVIDIA Docker2 Toolkit on an x86_64 Bit Processor on CentOS, see `NVIDIA Docker Installation - CentOS distributions <https://github.com/NVIDIA/nvidia-docker/wiki/Installation-(version-2.0)#centos-distributions-1>`_ - -Installing the NVIDIA Docker2 Toolkit on an x86_64 Bit Processor on Ubuntu -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -**To install the NVIDIA Docker2 Toolkit on an x86_64 bit processor on Ubuntu:** - -1. Add the repository for your distribution: - - .. code-block:: postgres - - $ curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | \ - $ sudo apt-key add - - $ distribution=$(. /etc/os-release;echo $ID$VERSION_ID) - $ curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | \ - $ sudo tee /etc/apt/sources.list.d/nvidia-docker.list - $ sudo apt-get update - -2. Install the **nvidia-docker2** package and reload the Docker daemon configuration: - - .. code-block:: postgres - - $ sudo apt-get install nvidia-docker2 - $ sudo pkill -SIGHUP dockerd - -3. Verify that the nvidia-docker2 package has been installed correctly: - - .. code-block:: postgres - - $ docker run --runtime=nvidia --rm nvidia/cuda nvidia-smi - -For more information on installing the NVIDIA Docker2 Toolkit on an x86_64 Bit Processor on Ubuntu, see `NVIDIA Docker Installation - Ubuntu distributions <https://github.com/NVIDIA/nvidia-docker/wiki/Installation-(version-2.0)#ubuntu-distributions-1>`_ - -Go back to :ref:`Installing Your Kubernetes Cluster<install_kubernetes_cluster>` - -Modifying the Docker Daemon JSON File for GPU and Compute Nodes -------------------------------------- -After installing the NVIDIA Docker2 toolkit, you must modify the Docker daemon JSON file for GPU and Compute nodes. - -Modifying the Docker Daemon JSON File for GPU Nodes -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - -**To modify the Docker daemon JSON file for GPU nodes:** - -1. Enable GPU and set HTTP access to the local Kubernetes Docker registry. - -.. note:: The Docker daemon JSON file must be modified on all GPU nodes. - -.. note:: Contact your IT department for a virtual IP. - -2. Replace the ``VIP address`` with your assigned VIP address. - -:: - -3. Connect as a root user: - - .. code-block:: postgres - - $ sudo -i - -4. Set a variable that includes the VIP address: - - .. code-block:: postgres - - $ export VIP_IP=<VIP IP> - -5. Replace the <VIP IP> with the VIP address:  - - .. code-block:: postgres - - $ cat <<EOF > /etc/docker/daemon.json - $ { - $ "insecure-registries": ["$VIP_IP:6000"], - $ "default-runtime": "nvidia", - $ "runtimes": { - $ "nvidia": { - $ "path": "nvidia-container-runtime", - $ "runtimeArgs": [] - $ } - $ } - $ } - $ EOF - -6. Apply the changes and restart Docker: - - .. code-block:: postgres - - $ systemctl daemon-reload && systemctl restart docker - -7. Exit the root user: - - .. code-block:: postgres - - $ exit - -Go back to :ref:`Installing Your Kubernetes Cluster<install_kubernetes_cluster>` - - -Modifying the Docker Daemon JSON File for Compute Nodes -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -You must follow this procedure only if you have a Compute node. - -**To modify the Docker daemon JSON file for Compute nodes:** - -1. Switch to a root user: - - .. code-block:: postgres - - $ sudo -i - -2. Set a variable that includes a VIP address. - -.. note:: Contact your IT department for a virtual IP. - -3. Replace the ``VIP address`` with your assigned VIP address. - - .. code-block:: postgres - - $ cat <<EOF > /etc/docker/daemon.json - $ { - $ "insecure-registries": ["$VIP_IP:6000"] - $ } - $ EOF - -4. Restart the services: - - .. code-block:: postgres - - $ systemctl daemon-reload && systemctl restart docker - -5. Exit the root user: - - - .. code-block:: postgres - - $ exit - -Go back to :ref:`Installing Your Kubernetes Cluster<install_kubernetes_cluster>` - -Installing the Nvidia-device-plugin Daemonset ----------------------------------------------- -After modifying the Docker daemon JSON file for GPU or Compute Nodes, you must installing the Nvidia-device-plugin daemonset. The Nvidia-device-plugin daemonset is only relevant to GPU nodes. - -**To install the Nvidia-device-plugin daemonset:** - -1. Set ``nvidia.com/gpu`` to ``true`` on all GPU nodes: - -.. code-block:: postgres - - $ kubectl label nodes <GPU node name> nvidia.com/gpu=true - -2. Replace the *<GPU node name>* with your GPU node name: - - For a complete list of GPU node names, run the ``kubectl get nodes`` command. - - The following is an example of the correct output: - - .. code-block:: postgres - - $ [root@eks-rhl-1 ~]# kubectl label nodes eks-rhl-1 nvidia.com/gpu=true - $ node/eks-rhl-1 labeled - $ [root@eks-rhl-1 ~]# kubectl label nodes eks-rhl-2 nvidia.com/gpu=true - $ node/eks-rhl-2 labeled - $ [root@eks-rhl-1 ~]# kubectl label nodes eks-rhl-3 nvidia.com/gpu=true - $ node/eks-rhl-3 labeled - -Go back to :ref:`Installing Your Kubernetes Cluster<install_kubernetes_cluster>` - -Creating an Nvidia Device Plugin ----------------------------------------------- -After installing the Nvidia-device-plugin daemonset, you must create an Nvidia-device-plugin. You can create an Nvidia-device-plugin by running the following command - -.. code-block:: postgres - - $ kubectl create -f https://raw.githubusercontent.com/NVIDIA/k8s-device-plugin/1.0.0-beta6/nvidia-device-plugin.yml - -If needed, you can check the status of the Nvidia-device-plugin-daemonset pod status: - -.. code-block:: postgres - - $ kubectl get pods -n kube-system -o wide | grep nvidia-device-plugin - -The following is an example of the correct output: - -.. code-block:: postgres - - $ NAME READY STATUS RESTARTS AGE - $ nvidia-device-plugin-daemonset-fxfct 1/1 Running 0 6h1m - $ nvidia-device-plugin-daemonset-jdvxs 1/1 Running 0 6h1m - $ nvidia-device-plugin-daemonset-xpmsv 1/1 Running 0 6h1m - -Go back to :ref:`Installing Your Kubernetes Cluster<install_kubernetes_cluster>` - -Checking GPU Resources Allocatable to GPU Nodes -------------------------------------- -After creating an Nvidia Device Plugin, you must check the GPU resources alloctable to the GPU nodes. Each GPU node has records, such as ``nvidia.com/gpu: <#>``. The ``#`` indicates the number of allocatable, or available, GPUs in each node. - -You can output a description of allocatable resources by running the following command: - -.. code-block:: postgres - - $ kubectl describe node | grep -i -A 7 -B 2 allocatable: - -The following is an example of the correct output: - -.. code-block:: postgres - - $ Allocatable: - $ cpu: 3800m - $ ephemeral-storage: 94999346224 - $ hugepages-1Gi: 0 - $ hugepages-2Mi: 0 - $ memory: 15605496Ki - $ nvidia.com/gpu: 1 - $ pods: 110 - -Go back to :ref:`Installing Your Kubernetes Cluster<install_kubernetes_cluster>` - -Preparing the WatchDog Monitor ------------------------------- -SQream's deployment includes installing two watchdog services. These services monitor Kuberenetes management and the server's storage network. - -You can enable the storage watchdogs by adding entries in the **/etc/hosts** file on each server: - -.. code-block:: postgres - - $ <address 1> k8s-node1.storage - $ <address 2> k8s-node2.storage - $ <address 3> k8s-node3.storage - -The following is an example of the correct syntax: - -.. code-block:: postgres - - $ 10.0.0.1 k8s-node1.storage - $ 10.0.0.2 k8s-node2.storage - $ 10.0.0.3 k8s-node3.storage - -Go back to :ref:`Installing Your Kubernetes Cluster<install_kubernetes_cluster>` - -.. _installing_sqream_software: - -Installing the SQream Software -================================= -Once you've prepared the SQream environment for launching it using Kubernetes, you can begin installing the SQream software. - -The **Installing the SQream Software** section describes the following: - -.. contents:: - :local: - :depth: 1 - - -.. _getting_sqream_package: - -Getting the SQream Package --------------------------------- -The first step in installing the SQream software is getting the SQream package. Please contact the SQream Support team to get the **sqream_k8s-nnn-DBnnn-COnnn-SDnnn-<arch>.tar.gz** tarball file. - -This file includes the following values: - -* **sqream_k8s-<nnn>** - the SQream installer version. -* **DB<nnn>** - the SQreamDB version. -* **CO<nnn>** - the SQream console version. -* **SD<nnn>** - the SQream Acceleration Studio version. -* **arch** - the server architecture. - -You can extract the contents of the tarball by running the following command: - -.. code-block:: postgres - - $ tar -xvf sqream_k8s-1.0.15-DB2020.1.0.2-SD0.7.3-x86_64.tar.gz - $ cd sqream_k8s-1.0.15-DB2020.1.0.2-SD0.7.3-x86_64 - $ ls - -Extracting the contents of the tarball file generates a new folder with the same name as the tarball file. - -The following shows the output of the extracted file: - -.. code-block:: postgres - - drwxrwxr-x. 2 sqream sqream 22 Jan 27 11:39 license - lrwxrwxrwx. 1 sqream sqream 49 Jan 27 11:39 sqream -> .sqream/sqream-sql-v2020.3.1_stable.x86_64/sqream - -rwxrwxr-x. 1 sqream sqream 9465 Jan 27 11:39 sqream-install - -rwxrwxr-x. 1 sqream sqream 12444 Jan 27 11:39 sqream-start - -Go back to :ref:`Installing Your SQream Software<installing_sqream_software>` - -Setting Up and Configuring Hadoop --------------------------------- -After getting the SQream package, you can set up and configure Hadoop by configuring the **keytab** and **krb5.conf** files. - -.. note:: You only need to configure the **keytab** and **krb5.conf** files if you use Hadoop with Kerberos authentication. - - -**To set up and configure Hadoop:** - -1. Contact IT for the **keytab** and **krb5.conf** files. - -:: - -2. Copy both files into the respective empty **.hadoop/** and **.krb5/** directories: - -.. code-block:: postgres - - $ cp hdfs.keytab krb5.conf .krb5/ - $ cp core-site.xml hdfs-site.xml .hadoop/ - -The SQream installer automatically copies the above files during the installation process. - -Go back to :ref:`Installing Your SQream Software<installing_sqream_software>` - -Starting a Local Docker Image Registry --------------------------------- -After getting the SQream package, or (optionally) setting up and configuring Hadoop, you must start a local Docker image registry. Because Kubernetes is based on Docker, you must start the local Docker image registry on the host's shared folder. This allows all hosts to pull the SQream Docker images. - -**To start a local Docker image registry:** - -1. Create a Docker registry folder: - - .. code-block:: postgres - - $ mkdir <shared path>/docker-registry/ - -2. Set the ``docker_path`` for the Docker registry folder: - - .. code-block:: postgres - - $ export docker_path=<path> - -3. Apply the **docker-registry** service to the cluster: - - .. code-block:: postgres - - $ cat .k8s/admin/docker_registry.yaml | envsubst | kubectl create -f - - - The following is an example of the correct output: - - .. code-block:: postgres - - namespace/sqream-docker-registry created - configmap/sqream-docker-registry-config created - deployment.apps/sqream-docker-registry created - service/sqream-docker-registry created - -4. Check the pod status of the **docker-registry** service: - - .. code-block:: postgres - - $ kubectl get pods -n sqream-docker-registry - -The following is an example of the correct output: - - .. code-block:: postgres - - NAME READY STATUS RESTARTS AGE - sqream-docker-registry-655889fc57-hmg7h 1/1 Running 0 6h40m - -Go back to :ref:`Installing Your SQream Software<installing_sqream_software>` - -Installing the Kubernetes Dashboard --------------------------------- -After starting a local Docker image registry, you must install the Kubernetes dashboard. The Kubernetes dashboard lets you see the Kubernetes cluster, nodes, services, and pod status. - -**To install the Kubernetes dashboard:** - -1. Apply the **k8s-dashboard** service to the cluster: - - .. code-block:: postgres - - $ kubectl apply -f https://raw.githubusercontent.com/kubernetes/dashboard/v2.0.0/aio/deploy/recommended.yaml - - The following is an example of the correct output: - - .. code-block:: postgres - - namespace/kubernetes-dashboard created - serviceaccount/kubernetes-dashboard created - service/kubernetes-dashboard created - secret/kubernetes-dashboard-certs created - secret/kubernetes-dashboard-csrf created - secret/kubernetes-dashboard-key-holder created - configmap/kubernetes-dashboard-settings created - role.rbac.authorization.k8s.io/kubernetes-dashboard created - clusterrole.rbac.authorization.k8s.io/kubernetes-dashboard created - rolebinding.rbac.authorization.k8s.io/kubernetes-dashboard created - clusterrolebinding.rbac.authorization.k8s.io/kubernetes-dashboard created - deployment.apps/kubernetes-dashboard created - service/dashboard-metrics-scraper created - deployment.apps/dashboard-metrics-scraper created - -2. Grant the user external access to the Kubernetes dashboard: - - .. code-block:: postgres - - $ cat .k8s/admin/kubernetes-dashboard-svc-metallb.yaml | envsubst | kubectl create -f - - - The following is an example of the correct output: - - .. code-block:: postgres - - service/kubernetes-dashboard-nodeport created - -3. Create the ``cluster-admin-sa.yaml`` file: - - .. code-block:: postgres - - $ kubectl create -f .k8s/admin/cluster-admin-sa.yaml - - The following is an example of the correct output: - - .. code-block:: postgres - - clusterrolebinding.rbac.authorization.k8s.io/cluster-admin-sa-cluster-admin created - -4. Check the pod status of the **K8s-dashboard** service: - - .. code-block:: postgres - - $ kubectl get pods -n kubernetes-dashboard - - The following is an example of the correct output: - - .. code-block:: postgres - - NAME READY STATUS RESTARTS AGE - dashboard-metrics-scraper-6b4884c9d5-n8p57 1/1 Running 0 4m32s - kubernetes-dashboard-7b544877d5-qc8b4 1/1 Running 0 4m32s - -5. Obtain the **k8s-dashboard** access token: - - .. code-block:: postgres - - $ kubectl -n kube-system describe secrets cluster-admin-sa-token - - The following is an example of the correct output: - - .. code-block:: postgres - - Name: cluster-admin-sa-token-rbl9p - Namespace: kube-system - Labels: <none> - Annotations: kubernetes.io/service-account.name: cluster-admin-sa - kubernetes.io/service-account.uid: 81866d6d-8ef3-4805-840d-58618235f68d - - Type: kubernetes.io/service-account-token - - Data - ==== - ca.crt: 1025 bytes - namespace: 11 bytes - token: eyJhbGciOiJSUzI1NiIsImtpZCI6IjRMV09qVzFabjhId09oamQzZGFFNmZBeEFzOHp3SlJOZWdtVm5lVTdtSW8ifQ.eyJpc3MiOiJrdWJlcm5ldGVzL3NlcnZpY2VhY2NvdW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9uYW1lc3BhY2UiOiJrdWJlLXN5c3RlbSIsImt1YmVybmV0ZXMuaW8vc2VydmljZWFjY291bnQvc2VjcmV0Lm5hbWUiOiJjbHVzdGVyLWFkbWluLXNhLXRva2VuLXJibDlwIiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9zZXJ2aWNlLWFjY291bnQubmFtZSI6ImNsdXN0ZXItYWRtaW4tc2EiLCJrdWJlcm5ldGVzLmlvL3NlcnZpY2VhY2NvdW50L3NlcnZpY2UtYWNjb3VudC51aWQiOiI4MTg2NmQ2ZC04ZWYzLTQ4MDUtODQwZC01ODYxODIzNWY2OGQiLCJzdWIiOiJzeXN0ZW06c2VydmljZWFjY291bnQ6a3ViZS1zeXN0ZW06Y2x1c3Rlci1hZG1pbi1zYSJ9.mNhp8JMr5y3hQ44QrvRDCMueyjSHSrmqZcoV00ZC7iBzNUqh3n-fB99CvC_GR15ys43jnfsz0tdsTy7VtSc9hm5ENBI-tQ_mwT1Zc7zJrEtgFiA0o_eyfYZOARdhdyFEJg84bzkIxJFPKkBWb4iPWU1Xb7RibuMCjNTarZMZbqzKYfQEcMZWJ5UmfUqp-HahZZR4BNbjSWybs7t6RWdcQZt6sO_rRCDrOeEJlqKKjx4-5jFZB8Du_0kKmnw2YJmmSCEOXrpQCyXIiZJpX08HyDDYfFp8IGzm61arB8HDA9dN_xoWvuz4Cj8klUtTzL9effJJPjHJlZXcEqQc9hE3jw - -6. Navigate to ``https://<VIP address>:5999``. - -:: - -7. Select the **Token** radio button, paste the token from the previous command output, and click **Sign in**. - -The Kubernetes dashboard is displayed. - -Go back to :ref:`Installing Your SQream Software<installing_sqream_software>` - -Installing the SQream Prometheus Package --------------------------------- -After installing the Kubernetes dashboard, you must install the SQream Prometheus package. To properly monitor the host and GPU statistics the **exporter service** must be installed on each Kubernetes cluster node. - -This section describes how to install the following: - -* **node_exporter** - collects host data, such as CPU memory usage. -* **nvidia_exporter** - collects GPU utilization data. - - -.. note:: The steps in this section must be done on **all** cluster nodes. - -To install the **sqream-prometheus** package, you must do the following: - -1. :ref:`Install the exporter service <install_exporter_service>` - -:: - -2. :ref:`Check the exporter service <check_exporter_status>` - -Go back to :ref:`Installing Your SQream Software<installing_sqream_software>` - - -.. _install_exporter_service: - -Installing the Exporter Service -~~~~~~~~~~~~~~~~~~~~~~~~ - -**To install the exporter service:** - -1. Create a user and group that will be used to run the exporter services: - - .. code-block:: console - - $ sudo groupadd --system prometheus && sudo useradd -s /sbin/nologin --system -g prometheus prometheus - -2. Extract the **sqream_exporters_prometheus.0.1.tar.gz** file: - - .. code-block:: console - - $ cd .prometheus - $ tar -xf sqream_exporters_prometheus.0.1.tar.gz - -3. Copy the exporter software files to the **/usr/bin** directory: - - .. code-block:: console - - $ cd sqream_exporters_prometheus.0.1 - $ sudo cp node_exporter/node_exporter /usr/bin/ - $ sudo cp nvidia_exporter/nvidia_exporter /usr/bin/ - -4. Copy the exporters service file to the **/etc/systemd/system/** directory: - - .. code-block:: console - - $ sudo cp services/node_exporter.service /etc/systemd/system/ - $ sudo cp services/nvidia_exporter.service /etc/systemd/system/ - -5. Set the permission and group of the service files: - - .. code-block:: console - - $ sudo chown prometheus:prometheus /usr/bin/node_exporter - $ sudo chmod u+x /usr/bin/node_exporter - $ sudo chown prometheus:prometheus /usr/bin/nvidia_exporter - $ sudo chmod u+x /usr/bin/nvidia_exporter - -6. Reload the services: - - .. code-block:: console - - $ sudo systemctl daemon-reload - -7. Start both services and set them to start when the server is booted up: - - * Node_exporter: - - .. code-block:: console - - $ sudo systemctl start node_exporter && sudo systemctl enable node_exporter - - * Nvidia_exporter: - - .. code-block:: console - - $ sudo systemctl start nvidia_exporter && sudo systemctl enable nvidia_exporter - - - -.. _check_exporter_status: - -Checking the Exporter Status -~~~~~~~~~~~~~~~~~~~~~~~~ -After installing the **exporter** service, you must check its status. - -You can check the exporter status by running the following command: - -.. code-block:: console - - $ sudo systemctl status node_exporter && sudo systemctl status nvidia_exporter - -Go back to :ref:`Installing Your SQream Software<installing_sqream_software>` - - -.. _running_sqream_install_service: - -Running the Sqream-install Service -================================ -The **Running the Sqream-install Service** section describes the following: - -.. contents:: - :local: - :depth: 1 - -Installing Your License --------------------------------- -After install the SQream Prometheus package, you must install your license. - -**To install your license:** - -1. Copy your license package to the sqream **/license** folder. - -.. note:: You do not need to untar the license package after copying it to the **/license** folder because the installer script does it automatically. - -The following flags are **mandatory** during your first run: - -.. code-block:: console - - $ sudo ./sqream-install -i -k -m <path to sqream cluster> - -.. note:: If you cannot run the script with **sudo**, verify that you have the right permission (**rwx** for the user) on the relevant directories (config, log, volume, and data-in directories). - -Go back to :ref:`Running the SQream_install Service<running_sqream_install_service>`. - -Changing Your Data Ingest Folder --------------------------------- -After installing your license, you must change your data ingest folder. - -You can change your data ingest folder by running the following command: - -.. code-block:: console - - $ sudo ./sqream-install -d /media/nfs/sqream/data_in - -Go back to :ref:`Running the SQream_install Service<running_sqream_install_service>`. - -Checking Your System Settings --------------------------------- -After changing your data ingest folder, you must check your system settings. - -The following command shows you all the variables that your SQream system is running with: - -.. code-block:: console - - $ ./sqream-install -s - -After optionally checking your system settings, you can use the **sqream-start** application to control your Kubernetes cluster. - -Go back to :ref:`Running the SQream_install Service<running_sqream_install_service>`. - -SQream Installation Command Reference --------------------------------- -If needed, you can use the **sqream-install** flag reference for any needed flags by typing: - -.. code-block:: console - - $ ./sqream-install --help - -The following shows the **sqream--install** flag descriptions: - -.. list-table:: - :widths: 22 59 25 - :header-rows: 1 - - * - Flag - - Function - - Note - * - **-i** - - Loads all the software from the hidden **.docker** folder. - - Mandatory - * - **-k** - - Loads the license package from the **/license** directory. - - Mandatory - * - **-m** - - Sets the relative path for all SQream folders under the shared filesystem available from all nodes (sqreamdb, config, logs and data_in). No other flags are required if you use this flag (such as c, v, l or d). - - Mandatory - * - **-c** - - Sets the path where to write/read SQream configuration files from. The default is **/etc/sqream/**. - - Optional - * - **-v** - - Shows the location of the SQream cluster. ``v`` creates a cluster if none exist, and mounts it if does. - - Optional - * - **-l** - - Shows the location of the SQream system startup logs. The logs contain startup and Docker logs. The default is **/var/log/sqream/**. - - Optional - * - **-d** - - Shows the folder containing data that you want to import into or copy from SQream. - - Optional - * - **-n** <Namespace> - - Sets the Kubernetes namespace. The default is **sqream**. - - Optional - * - **-N** <Namespace> - - Deletes a specific Kubernetes namespace and sets the factory default namespace (sqream). - - Optional - * - **-f** - - Overwrite existing folders and all files located in mounted directories. - - Optional - * - **-r** - - Resets the system configuration. This flag is run without any other variables. - - Optional - * - **-s** - - Shows the system settings. - - Optional - * - **-e** - - Sets the Kubernetes cluster's virtual IP address. - - Optional - * - **-h** - - Help, shows all available flags. - - Optional - -Go back to :ref:`Running the SQream_install Service<running_sqream_install_service>`. - -Controlling Your Kubernetes Cluster Using SQream Flags --------------------------------- -You can control your Kubernetes cluster using SQream flags. - -The following command shows you the available Kubernetes cluster control options: - -.. code-block:: console - - $ ./sqream-start -h - -The following describes the **sqream-start** flags: - -.. list-table:: - :widths: 22 59 25 - :header-rows: 1 - - * - Flag - - Function - - Note - * - **-s** - - Starts the sqream services, starting metadata, server picker, and workers. The number of workers started is based on the number of available GPU’s. - - Mandatory - * - **-p** - - Sets specific ports to the workers services. You must enter the starting port for the sqream-start application to allocate it based on the number of workers. - - - * - **-j** - - Uses an external .json configuration file. The file must be located in the **configuration** directory. - - The workers must each be started individually. - * - **-m** - - Allocates worker spool memory. - - The workers must each be started individually. - * - **-a** - - Starts the SQream Administration dashboard and specifies the listening port. - - - * - **-d** - - Deletes all running SQream services. - - - * - **-h** - - Shows all available flags. - - Help - -Go back to :ref:`Running the SQream_install Service<running_sqream_install_service>`. - -.. _using_sqream_start_commands: - -Using the sqream-start Commands -======================= -In addition to controlling your Kubernetes cluster using SQream flags, you can control it using **sqream-start** commands. - -The **Using the sqream-start Commands** section describes the following: - -.. contents:: - :local: - :depth: 1 - -Starting Your SQream Services ------------------------- -You can run the **sqream-start** command with the **-s** flag to start SQream services on all available GPU's: - -.. code-block:: console - - $ sudo ./sqream-start -s - -This command starts the SQream metadata, server picker, and sqream workers on all available GPU’s in the cluster. - -The following is an example of the correct output: - -.. code-block:: console - - ./sqream-start -s - Initializing network watchdogs on 3 hosts... - Network watchdogs are up and running - - Initializing 3 worker data collectors ... - Worker data collectors are up and running - - Starting Prometheus ... - Prometheus is available at 192.168.5.100:9090 - - Starting SQream master ... - SQream master is up and running - - Starting up 3 SQream workers ... - All SQream workers are up and running, SQream-DB is available at 192.168.5.100:3108 - All SQream workers are up and running, SQream-DB is available at 192.168.5.100:3108 - - -Go back to :ref:`Using the SQream-start Commands<using_sqream_start_commands>`. - -Starting Your SQream Services in Split Mode ------------------------- -Starting SQream services in split mode refers to running multiple SQream workers on a single GPU. You can do this by running the **sqream-start** command with the **-s** and **-z** flags. In addition, you can define the amount of hosts to run the multiple workers on. In the example below, the command defines to run the multiple workers on three hosts. - -**To start SQream services in split mode:** - -1. Run the following command: - -.. code-block:: console - - $ ./sqream-start -s -z 3 - -This command starts the SQream metadata, server picker, and sqream workers on a single GPU for three hosts: - -The following is an example of the correct output: - -.. code-block:: console - - Initializing network watchdogs on 3 hosts... - Network watchdogs are up and running - - Initializing 3 worker data collectors ... - Worker data collectors are up and running - - Starting Prometheus ... - Prometheus is available at 192.168.5.101:9090 - - Starting SQream master ... - SQream master is up and running - - Starting up 9 SQream workers over <#> available GPUs ... - All SQream workers are up and running, SQream-DB is available at 192.168.5.101:3108 - -2. Verify all pods are properly running in k8s cluster (**STATUS** column): - -.. code-block:: console - - kubectl -n sqream get pods - - NAME READY STATUS RESTARTS AGE - prometheus-bcf877867-kxhld 1/1 Running 0 106s - sqream-metadata-fbcbc989f-6zlkx 1/1 Running 0 103s - sqream-picker-64b8c57ff5-ndfr9 1/1 Running 2 102s - sqream-split-workers-0-1-2-6bdbfbbb86-ml7kn 1/1 Running 0 57s - sqream-split-workers-3-4-5-5cb49d49d7-596n4 1/1 Running 0 57s - sqream-split-workers-6-7-8-6d598f4b68-2n9z5 1/1 Running 0 56s - sqream-workers-start-xj75g 1/1 Running 0 58s - watchdog-network-management-6dnfh 1/1 Running 0 115s - watchdog-network-management-tfd46 1/1 Running 0 115s - watchdog-network-management-xct4d 1/1 Running 0 115s - watchdog-network-storage-lr6v4 1/1 Running 0 116s - watchdog-network-storage-s29h7 1/1 Running 0 116s - watchdog-network-storage-sx9mw 1/1 Running 0 116s - worker-data-collector-62rxs 0/1 Init:0/1 0 54s - worker-data-collector-n8jsv 0/1 Init:0/1 0 55s - worker-data-collector-zp8vf 0/1 Init:0/1 0 54s - -Go back to :ref:`Using the SQream-start Commands<using_sqream_start_commands>`. - -Starting the Sqream Studio UI --------------------------------- -You can run the following command the to start the SQream Studio UI (Editor and Dashboard): - -.. code-block:: console - - $ ./sqream-start -a - -The following is an example of the correct output: - -.. code-block:: console - - $ ./sqream-start -a - Please enter USERNAME: - sqream - Please enter PASSWORD: - ****** - Please enter port value or press ENTER to keep 8080: - - Starting up SQream Admin UI... - SQream admin ui is available at 192.168.5.100:8080 - -Go back to :ref:`Using the SQream-start Commands<using_sqream_start_commands>`. - -Stopping the SQream Services --------------------------------- -You can run the following command to stop all SQream services: - -.. code-block:: console - - $ ./sqream-start -d - -The following is an example of the correct output: - -.. code-block:: console - - $ ./sqream-start -d - $ Cleaning all SQream services in sqream namespace ... - $ All SQream service removed from sqream namespace - -Go back to :ref:`Using the SQream-start Commands<using_sqream_start_commands>`. - -Advanced sqream-start Commands --------------------------------- -Controlling Your SQream Spool Size -~~~~~~~~~~~~~~~~~~~~~~~~ -If you do not specify the SQream spool size, the console automatically distributes the available RAM between all running workers. - -You can define a specific spool size by running the following command: - -.. code-block:: console - - $ ./sqream-start -s -m 4 - -Using a Custom .json File -~~~~~~~~~~~~~~~~~~~~~~~~ -You have the option of using your own .json file for your own custom configurations. Your .json file must be placed within the path mounted in the installation. SQream recommends placing your .json file in the **configuration** folder. - -The SQream console does not validate the integrity of external .json files. - -You can use the following command (using the ``j`` flag) to set the full path of your .json file to the configuration file: - -.. code-block:: console - - $ ./sqream-start -s -f <full path>.json - -This command starts one worker with an external configuration file. - -.. note:: The configuration file must be available in the shared configuration folder. - - -Checking the Status of the SQream Services -~~~~~~~~~~~~~~~~~~~~~~~~ -You can show all running SQream services by running the following command: - -.. code-block:: console - - $ kubectl get pods -n <namespace> -o wide - -This command shows all running services in the cluster and which nodes they are running in. - -Go back to :ref:`Using the SQream-start Commands<using_sqream_start_commands>`. - -Upgrading Your SQream Version -================================ -The **Upgrading Your SQream Version** section describes the following: - -.. contents:: - :local: - :depth: 1 - -Before Upgrading Your System ----------------------------- -Before upgrading your system you must do the following: - -1. Contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_ for a new SQream package tarball file. - -:: - -2. Set a maintenance window. - - -.. note:: You must stop the system while upgrading it. - - -Upgrading Your System ----------------------------- -After completing the steps in **Before Upgrading Your System** above, you can upgrade your system. - -**To upgrade your system:** - -1. Extract the contents of the tarball file that you received from SQream support. Make sure to extract the contents to the same directory as in :ref:`getting_sqream_package` and for the same user: - - .. code-block:: console - - $ tar -xvf sqream_installer-2.0.5-DB2019.2.1-CO1.6.3-ED3.0.0-x86_64/ - $ cd sqream_installer-2.0.5-DB2019.2.1-CO1.6.3-ED3.0.0-x86_64/ - -2. Start the upgrade process run the following command: - - .. code-block:: console - - $ ./sqream-install -i - -The upgrade process checks if the SQream services are running and will prompt you to stop them. - -3. Do one of the following: - - * Stop the upgrade by writing ``No``. - * Continue the upgrade by writing ``Yes``. - -If you continue upgrading, all running SQream workers (master and editor) are stopped. When all services have been stopped, the new version is loaded. - - -.. note:: SQream periodically upgrades its metadata structure. If an upgrade version includes an upgraded metadata service, an approval request message is displayed. This approval is required to finish the upgrade process. Because SQream supports only specific metadata versions, all SQream services must be upgraded at the same time. - - -4. When SQream has successfully upgraded, load the SQream console and restart your services. - -For questions, contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_. From bf3611832d64fc04bddc65a8c7ae0c0351123be7 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 1 Aug 2023 12:58:53 +0300 Subject: [PATCH 667/882] Update logging.rst --- operational_guides/logging.rst | 40 +++++++++++++++++----------------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/operational_guides/logging.rst b/operational_guides/logging.rst index 03950784d..90499e971 100644 --- a/operational_guides/logging.rst +++ b/operational_guides/logging.rst @@ -1,11 +1,11 @@ .. _logging: -*********************** +******* Logging -*********************** +******* Locating the Log Files -========================== +====================== The :ref:`storage cluster<storage_cluster>` contains a ``logs`` directory. Each worker produces a log file in its own directory, which can be identified by the worker's hostname and port. @@ -24,7 +24,7 @@ The worker logs contain information messages, warnings, and errors pertaining to * Statement execution statistics Log Structure and Contents ---------------------------------- +-------------------------- The log is a CSV, with several fields. @@ -192,7 +192,7 @@ The log is a CSV, with several fields. - ``"Server shutdown"`` Log-Naming ---------------------------- +---------- Log file name syntax @@ -211,10 +211,10 @@ See the :ref:`log_rotation` below for information about controlling this setting Log Control and Maintenance -====================================== +=========================== Changing Log Verbosity --------------------------- +---------------------- A few configuration settings alter the verbosity of the logs: @@ -240,7 +240,7 @@ A few configuration settings alter the verbosity of the logs: .. _log_rotation: Changing Log Rotation ------------------------ +--------------------- A few configuration settings alter the log rotation policy: @@ -253,7 +253,7 @@ A few configuration settings alter the log rotation policy: - Default - Values * - ``useLogMaxFileSize`` - - Rotate log files once they reach a certain file size. When ``true``, set the ``logMaxFileSizeMB`` accordingly. + - Rotate log files once they reach a certain file size. When ``true``, set the ``logMaxFileSizeMB`` accordingly. When ``false`` set the ``logFileRotateTimeFrequency`` accordingly. - ``false`` - ``false`` or ``true``. * - ``logMaxFileSizeMB`` @@ -268,7 +268,7 @@ A few configuration settings alter the log rotation policy: .. _collecting_logs2: Collecting Logs from Your Cluster -==================================== +================================= Collecting logs from your cluster can be as simple as creating an archive from the ``logs`` subdirectory: ``tar -czvf logs.tgz *.log``. @@ -290,7 +290,7 @@ SQL Syntax Command Line Utility --------------------------- +-------------------- If you cannot access SQream DB for any reason, you can also use a command line toolto collect the same information: @@ -300,7 +300,7 @@ If you cannot access SQream DB for any reason, you can also use a command line t Parameters ---------------- +---------- .. list-table:: :widths: auto @@ -318,7 +318,7 @@ Parameters * ``'db_and_log'`` - Collect both log files and metadata database Example ------------------ +------- Write an archive to ``/home/rhendricks``, containing log files: @@ -343,10 +343,10 @@ Using the command line utility: Troubleshooting with Logs -=============================== +========================= Loading Logs with Foreign Tables ---------------------------------------- +-------------------------------- Assuming logs are stored at ``/home/rhendricks/sqream_storage/logs/``, a database administrator can access the logs using the :ref:`external_tables` concept through SQream DB. @@ -379,13 +379,13 @@ Assuming logs are stored at ``/home/rhendricks/sqream_storage/logs/``, a databas ) ; -For more information, see `Loading Logs with Foreign Tables <https://docs.sqream.com/en/latest/reference/sql/sql_statements/dml_commands/copy_from.html>`_. +For more information, see :ref:`Loading Logs with Foreign Tables <copy_from>`. Counting Message Types ------------------------------- +---------------------- .. code-block:: psql @@ -411,7 +411,7 @@ Counting Message Types 1010 | 5 Finding Fatal Errors ----------------------- +-------------------- .. code-block:: psql @@ -423,7 +423,7 @@ Finding Fatal Errors Internal Runtime Error,open cluster metadata database:IO error: lock /home/rhendricks/sqream_storage/LOCK: Resource temporarily unavailable Countng Error Events Within a Certain Timeframe ---------------------------------------------------- +----------------------------------------------- .. code-block:: psql @@ -442,7 +442,7 @@ Countng Error Events Within a Certain Timeframe .. _tracing_errors: Tracing Errors to Find Offending Statements -------------------------------------------------- +------------------------------------------- If we know an error occured, but don't know which statement caused it, we can find it using the connection ID and statement ID. From 3d25404cbc154f74411b590964f1afc11e386f84 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 1 Aug 2023 13:10:22 +0300 Subject: [PATCH 668/882] Update current_method_showing_all_flags_in_the_catalog_table.rst --- ...rrent_method_showing_all_flags_in_the_catalog_table.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/configuration_guides/current_method_showing_all_flags_in_the_catalog_table.rst b/configuration_guides/current_method_showing_all_flags_in_the_catalog_table.rst index 647a401b6..5683bf624 100644 --- a/configuration_guides/current_method_showing_all_flags_in_the_catalog_table.rst +++ b/configuration_guides/current_method_showing_all_flags_in_the_catalog_table.rst @@ -1,15 +1,16 @@ .. _current_method_showing_all_flags_in_the_catalog_table: -************************** +************************************** Showing All Flags in the Catalog Table -************************** +************************************** + SQream uses the **sqream_catalog.parameters** catalog table for showing all flags, providing the scope (default, cluster and session), description, default value and actual value. The following is the correct syntax for a catalog table query: .. code-block:: console - SELECT * FROM sqream_catalog.settings + SELECT * FROM sqream_catalog.parameters The following is an example of a catalog table query: From ea75c6afddbc13f3249cd73f5fba9a06750edd65 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 2 Aug 2023 14:28:51 +0300 Subject: [PATCH 669/882] Update index.rst --- index.rst | 12 ------------ 1 file changed, 12 deletions(-) diff --git a/index.rst b/index.rst index d09ca5bdd..6a174af67 100644 --- a/index.rst +++ b/index.rst @@ -49,25 +49,13 @@ SQream DB is a columnar analytic SQL database management system. SQream DB suppo .. only:: html - .. tip:: - Want to read this offline? - `Download the documentation as a single PDF <https://docs.sqream.com/_/downloads/en/latest/pdf/>`_ . - .. only:: pdf or latex - - .. tip:: This documentation is available online at https://docs.sqream.com/ - .. rubric:: Need help? If you couldn't find what you're looking for, we're always happy to help. Visit `SQream's support portal <https://sqream.atlassian.net/servicedesk/>`_ for additional support. -.. rubric:: Looking for older versions? - - -If you're looking for an older version of the documentation, go to http://previous.sqream.com . - .. toctree:: :caption: Contents: :glob: From feeba812696a480f6e928590d82d06b3ee784ab9 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 2 Aug 2023 14:47:25 +0300 Subject: [PATCH 670/882] Update sas_viya.rst --- .../client_platforms/sas_viya.rst | 42 ++++++++++++------- 1 file changed, 27 insertions(+), 15 deletions(-) diff --git a/connecting_to_sqream/client_platforms/sas_viya.rst b/connecting_to_sqream/client_platforms/sas_viya.rst index d827fdc40..d84e9a038 100644 --- a/connecting_to_sqream/client_platforms/sas_viya.rst +++ b/connecting_to_sqream/client_platforms/sas_viya.rst @@ -1,11 +1,12 @@ .. _connect_to_sas_viya: -************************* -Connect to SQream Using SAS Viya -************************* +******** +SAS Viya +******** Overview -========== +======== + SAS Viya is a cloud-enabled analytics engine used for producing useful insights. The **Connect to SQream Using SAS Viya** page describes how to connect to SAS Viya, and describes the following: .. contents:: @@ -14,6 +15,7 @@ SAS Viya is a cloud-enabled analytics engine used for producing useful insights. Installing SAS Viya ------------------- + The **Installing SAS Viya** section describes the following: .. contents:: @@ -21,13 +23,15 @@ The **Installing SAS Viya** section describes the following: :depth: 1 Downloading SAS Viya -~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~ + Integrating with SQream has been tested with SAS Viya v.03.05 and newer. To download SAS Viya, see `SAS Viya <https://www.sas.com/en_us/software/viya.html>`_. Installing the JDBC Driver -~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~ + The SQream JDBC driver is required for establishing a connection between SAS Viya and SQream. **To install the JDBC driver:** @@ -41,7 +45,8 @@ The SQream JDBC driver is required for establishing a connection between SAS Viy SQream recommends creating the directory ``/opt/sqream`` on the SAS Viya server. Configuring SAS Viya -------------------- +-------------------- + After installing the JDBC driver, you must configure the JDBC driver from the SAS Studio so that it can be used with SQream Studio. **To configure the JDBC driver from the SAS Studio:** @@ -62,7 +67,8 @@ After installing the JDBC driver, you must configure the JDBC driver from the SA For more information about writing a connection string, see **Connect to SQream DB with a JDBC Application** and navigate to `Connection String <https://docs.sqream.com/en/v2022.1/connecting_to_sqream/client_drivers/jdbc/index.html#connection-string-examples>`_. Operating SAS Viya --------------------- +------------------ + The **Operating SAS Viya** section describes the following: .. contents:: @@ -70,12 +76,13 @@ The **Operating SAS Viya** section describes the following: :depth: 1 Using SAS Viya Visual Analytics -~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + This section describes how to use SAS Viya Visual Analytics. **To use SAS Viya Visual Analytics:** -#. Log in to `SAS Viya Visual Analytics <http://192.168.4.63/SASLogon/login>`_ using your credentials: +#. Log in to SAS Viya Visual Analytics using your credentials: :: @@ -137,7 +144,8 @@ If your connection is not successful, see :ref:`troubleshooting_sas_viya` below. .. _troubleshooting_sas_viya: Troubleshooting SAS Viya -------------------------- +------------------------ + The **Best Practices and Troubleshooting** section describes the following best practices and troubleshooting procedures when connecting to SQream using SAS Viya: .. contents:: @@ -145,7 +153,8 @@ The **Best Practices and Troubleshooting** section describes the following best :depth: 1 Inserting Only Required Data -~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + When using SAS Viya, SQream recommends using only data that you need, as described below: * Insert only the data sources you need into SAS Viya, excluding tables that don’t require analysis. @@ -155,11 +164,13 @@ When using SAS Viya, SQream recommends using only data that you need, as describ * To increase query performance, add filters before analyzing. Every modification you make while analyzing data queries the SQream database, sometimes several times. Adding filters to the datasource before exploring limits the amount of data analyzed and increases query performance. Creating a Separate Service for SAS Viya -~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + SQream recommends creating a separate service for SAS Viya with the DWLM. This reduces the impact that Tableau has on other applications and processes, such as ETL. In addition, this works in conjunction with the load balancer to ensure good performance. Locating the SQream JDBC Driver -~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + In some cases, SAS Viya cannot locate the SQream JDBC driver, generating the following error message: .. code-block:: text @@ -181,5 +192,6 @@ In some cases, SAS Viya cannot locate the SQream JDBC driver, generating the fol For more troubleshooting assistance, see the `SQream Support Portal <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_. Supporting TEXT -~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~ + In SAS Viya versions lower than 4.0, casting ``TEXT`` to ``CHAR`` changes the size to 1,024, such as when creating a table including a ``TEXT`` column. This is resolved by casting ``TEXT`` into ``CHAR`` when using the JDBC driver. \ No newline at end of file From a0d04608b12c03a356dbeabb669a4f49c5ac6de1 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 2 Aug 2023 15:04:18 +0300 Subject: [PATCH 671/882] Update microstrategy.rst --- .../client_platforms/microstrategy.rst | 22 +++++++++---------- 1 file changed, 10 insertions(+), 12 deletions(-) diff --git a/connecting_to_sqream/client_platforms/microstrategy.rst b/connecting_to_sqream/client_platforms/microstrategy.rst index 370312a0d..57afb861e 100644 --- a/connecting_to_sqream/client_platforms/microstrategy.rst +++ b/connecting_to_sqream/client_platforms/microstrategy.rst @@ -1,14 +1,15 @@ .. _microstrategy: -************************* -Connect to SQream Using MicroStrategy -************************* +************* +MicroStrategy +************* .. _ms_top: Overview ---------------- +-------- + This document is a Quick Start Guide that describes how to install MicroStrategy and connect a datasource to the MicroStrategy dasbhoard for analysis. @@ -20,12 +21,9 @@ The **Connecting to SQream Using MicroStrategy** page describes the following: :local: - - - - What is MicroStrategy? -================ +====================== + MicroStrategy is a Business Intelligence software offering a wide variety of data analytics capabilities. SQream uses the MicroStrategy connector for reading and loading data into SQream. MicroStrategy provides the following: @@ -48,7 +46,7 @@ For more information about Microstrategy, see `MicroStrategy <https://www.micros Connecting a Data Source -======================= +======================== 1. Activate the **MicroStrategy Desktop** app. The app displays the Dossiers panel to the right. @@ -125,7 +123,7 @@ Connecting a Data Source odbc:Driver={SqreamODBCDriver};DSN={SQreamDB ODBC};Server=<Host>;Port=<Port>;Database=<database name>;User=<username>;Password=<password>;Cluster=<boolean>; - For more information about the available **connection parameters** and other examples, see `Connection Parameters <https://docs.sqream.com/en/latest/guides/client_drivers/jdbc/index.html#connection-parameters>`_. + For more information about the available **connection parameters** and other examples, see `Connection Parameters <java_jdbc>`. 7. In the **User** and **Password** fields, fill out your user name and password. @@ -172,7 +170,7 @@ Your populated dashboard is displayed and is ready for data discovery and analyt :ref:`Back to Overview <ms_top>` Supported SQream Drivers -================ +======================== The following list shows the supported SQream drivers and versions: From dc9c29c01e1c038d471ffa327cb74dbee0c6b7bb Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 2 Aug 2023 15:06:48 +0300 Subject: [PATCH 672/882] Update microstrategy.rst --- connecting_to_sqream/client_platforms/microstrategy.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/connecting_to_sqream/client_platforms/microstrategy.rst b/connecting_to_sqream/client_platforms/microstrategy.rst index 57afb861e..8947eb0e6 100644 --- a/connecting_to_sqream/client_platforms/microstrategy.rst +++ b/connecting_to_sqream/client_platforms/microstrategy.rst @@ -123,7 +123,7 @@ Connecting a Data Source odbc:Driver={SqreamODBCDriver};DSN={SQreamDB ODBC};Server=<Host>;Port=<Port>;Database=<database name>;User=<username>;Password=<password>;Cluster=<boolean>; - For more information about the available **connection parameters** and other examples, see `Connection Parameters <java_jdbc>`. + For more information about the available **connection parameters** and other examples, see :ref:`Connection Parameters <java_jdbc>`. 7. In the **User** and **Password** fields, fill out your user name and password. From 94c79c5ccd8575f4fc041abb2681de13233d85fc Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 2 Aug 2023 15:16:23 +0300 Subject: [PATCH 673/882] Update index.rst --- connecting_to_sqream/client_drivers/odbc/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/connecting_to_sqream/client_drivers/odbc/index.rst b/connecting_to_sqream/client_drivers/odbc/index.rst index 195bc6897..080c25ee9 100644 --- a/connecting_to_sqream/client_drivers/odbc/index.rst +++ b/connecting_to_sqream/client_drivers/odbc/index.rst @@ -42,7 +42,7 @@ Other distributions may also work, but are not officially supported by SQream. Getting the ODBC driver ======================= -The SQream ODBC driver is distributed by your SQream account manager. Before contacting your account manager, verify which platform the ODBC driver will be used on. Go to `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_ or contact your SQream account manager to get the driver. +The SQream ODBC driver is distributed by your SQream account manager. Before contacting your account manager, verify which platform the ODBC driver will be used on. Go to `SQream Support <https://sqream.atlassian.net/servicedesk/>`_ or contact your SQream account manager to get the driver. The driver is provided as an executable installer for Windows, or a compressed tarball for Linux platforms. After downloading the driver, follow the relevant instructions to install and configure the driver for your platform: From 4a7ea2f97c7e0434a75ad2fbf0e969497e35306e Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 3 Aug 2023 08:09:52 +0300 Subject: [PATCH 674/882] Update glossary.rst --- glossary.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/glossary.rst b/glossary.rst index f4634d712..818cf3cf0 100644 --- a/glossary.rst +++ b/glossary.rst @@ -27,7 +27,7 @@ The following table shows the **Glossary** descriptions: +-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Node | A machine used to run SQream workers. | +-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| Role | A group or a user. For more information see :ref:`SQream Studio <creating_assigning_and_managing_roles_and_permissions>`. | +| Role | A group or a user. For more information see :ref:`SQream Studio <creating_assigning_and_managing_roles_and_permissions>`. | +-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Storage cluster | The directory where SQream stores data. | +-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ From 1736605c73da04098e5db3b8d1726249c9ddfd4c Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 6 Aug 2023 09:45:13 +0300 Subject: [PATCH 675/882] Reorder menu items.rst --- configuration_guides/index.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/configuration_guides/index.rst b/configuration_guides/index.rst index 9c0b206e7..f93fce2ae 100644 --- a/configuration_guides/index.rst +++ b/configuration_guides/index.rst @@ -1,8 +1,8 @@ .. _configuration_guides: -************************* +******************** Configuration Guides -************************* +******************** The **Configuration Guides** page describes the following configuration information: @@ -10,8 +10,8 @@ The **Configuration Guides** page describes the following configuration informat :maxdepth: 1 :glob: - spooling configuring_sqream - ldap configuration_flags - previous_configuration_method \ No newline at end of file + spooling + ldap + previous_configuration_method From 3b4c1bda5b01097d70244d52ac9374dc3c21ad95 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 6 Aug 2023 12:06:55 +0300 Subject: [PATCH 676/882] Create rename_schema.rst --- .../ddl_commands/rename_schema.rst | 55 +++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 reference/sql/sql_statements/ddl_commands/rename_schema.rst diff --git a/reference/sql/sql_statements/ddl_commands/rename_schema.rst b/reference/sql/sql_statements/ddl_commands/rename_schema.rst new file mode 100644 index 000000000..6ddcf7979 --- /dev/null +++ b/reference/sql/sql_statements/ddl_commands/rename_schema.rst @@ -0,0 +1,55 @@ +.. _rename_schema: + +************* +RENAME SCHEMA +************* + +``RENAME SCHEMA`` can be used to rename a schema. + +.. warning:: Renaming a schema can void existing views that use this schema. See more about :ref:`recompiling views <recompile_view>`. + +Permissions +=========== + +The role must have the ``DDL`` permission at the database or table level. + +Syntax +====== + +.. code-block:: postgres + + alter_schema_rename_schema_statement ::= + ALTER SCHEMA [database_name.]current_name RENAME TO new_name + ; + + current_name ::= identifier + + database_name ::= identifier + + new_name ::= identifier + +Parameters +========== + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``schema_name`` + - The database name for the schema. Defaults to ``master`` if not specified. + * - ``current_name`` + - The schema name to apply the change to. + * - ``new_name`` + - The new schema name. + +Examples +======== + + +.. code-block:: postgres + + ALTER SCHEMA master.staging RENAME TO staging_new; + + From 49665cc33d01eb036f2afe4c5c9a1f36cfe8c0d1 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 6 Aug 2023 12:08:17 +0300 Subject: [PATCH 677/882] Update index.rst --- reference/sql/sql_statements/index.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index f8c6c4332..47a26b0a9 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -64,6 +64,9 @@ The following table shows the Data Definition commands: - Rename a column * - :ref:`RENAME_TABLE<rename_table>` - Rename a table + * - :ref:`RENAME_SCHEMA<rename_schema>` + - Rename a schema + Data Manipulation Commands (DML) @@ -211,4 +214,4 @@ The following table shows the Access Control commands: * - :ref:`revoke` - Revoke permissions from a role * - :ref:`rename_role` - - Rename a role \ No newline at end of file + - Rename a role From 19faf35ec5397b894a6061dbde072ab5dc4fd6ec Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 6 Aug 2023 12:13:57 +0300 Subject: [PATCH 678/882] Update create_schema.rst --- .../ddl_commands/create_schema.rst | 26 ++++++++++++------- 1 file changed, 16 insertions(+), 10 deletions(-) diff --git a/reference/sql/sql_statements/ddl_commands/create_schema.rst b/reference/sql/sql_statements/ddl_commands/create_schema.rst index aefa64b4f..cba68bc73 100644 --- a/reference/sql/sql_statements/ddl_commands/create_schema.rst +++ b/reference/sql/sql_statements/ddl_commands/create_schema.rst @@ -1,8 +1,9 @@ .. _create_schema: -***************** +************* CREATE SCHEMA -***************** +************* + The **CREATE SCHEMA** page describes the following: @@ -11,7 +12,7 @@ The **CREATE SCHEMA** page describes the following: :depth: 2 Overview -============ +======== ``CREATE SCHEMA`` creates a new schema in an existing database. A schema is a virtual space for storing tables. @@ -25,15 +26,16 @@ The **CREATE SCHEMA** statement can be used to query tables from different schem select <schema_name>.table_name.column_name from <schema_name>.table_name -See also: :ref:`drop_schema`, :ref:`alter_default_schema`. +See also: :ref:`drop_schema`, :ref:`alter_default_schema`, :ref:`rename_schema`. Permissions -============= +=========== The role must have the ``CREATE`` permission at the database level. Syntax -========== +====== + The following example shows the correct syntax for creating a schema: .. code-block:: postgres @@ -46,7 +48,8 @@ The following example shows the correct syntax for creating a schema: Parameters -============ +========== + The following table shows the ``schema_name`` parameters: .. list-table:: @@ -59,7 +62,8 @@ The following table shows the ``schema_name`` parameters: - The name of the schema to create. Examples -=========== +======== + This section includes the following examples: .. contents:: @@ -68,7 +72,8 @@ This section includes the following examples: Creating a Schema --------------------- +----------------- + The following example shows an example of the syntax for creating a schema: .. code-block:: postgres @@ -80,7 +85,8 @@ The following example shows an example of the syntax for creating a schema: SELECT * FROM staging.users; Altering the Default Schema for a Role ------------------------------------------ +-------------------------------------- + The following example shows an example of the syntax for altering the default schema for a role: .. code-block:: postgres From 0be0da9651facdc6f6397f41e313c4a97746ba5c Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 6 Aug 2023 12:19:21 +0300 Subject: [PATCH 679/882] Update rename_schema.rst --- reference/sql/sql_statements/ddl_commands/rename_schema.rst | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/reference/sql/sql_statements/ddl_commands/rename_schema.rst b/reference/sql/sql_statements/ddl_commands/rename_schema.rst index 6ddcf7979..0024d59c3 100644 --- a/reference/sql/sql_statements/ddl_commands/rename_schema.rst +++ b/reference/sql/sql_statements/ddl_commands/rename_schema.rst @@ -4,14 +4,14 @@ RENAME SCHEMA ************* -``RENAME SCHEMA`` can be used to rename a schema. +Renaming schemas is mainly used for improving the clarity and organization of a database by giving schemas more meaningful or concise names. .. warning:: Renaming a schema can void existing views that use this schema. See more about :ref:`recompiling views <recompile_view>`. Permissions =========== -The role must have the ``DDL`` permission at the database or table level. +The role must have the ``DDL`` permission at the database level. Syntax ====== @@ -47,7 +47,6 @@ Parameters Examples ======== - .. code-block:: postgres ALTER SCHEMA master.staging RENAME TO staging_new; From 2826864b896360dfc5a0b1b082b17ebce5827dd6 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 6 Aug 2023 15:07:49 +0300 Subject: [PATCH 680/882] Update alter_default_schema.rst --- .../sql/sql_statements/ddl_commands/alter_default_schema.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/ddl_commands/alter_default_schema.rst b/reference/sql/sql_statements/ddl_commands/alter_default_schema.rst index bca483060..8c5722f48 100644 --- a/reference/sql/sql_statements/ddl_commands/alter_default_schema.rst +++ b/reference/sql/sql_statements/ddl_commands/alter_default_schema.rst @@ -6,7 +6,7 @@ ALTER DEFAULT SCHEMA The ``ALTER DEFAULT SCHEMA`` command can be used to change a role's default schema. The default schema in SQream is ``public``. -For more information, see :ref:`create_schema` and :ref:`drop_schema`. +For more information, see :ref:`create_schema`, :ref:`drop_schema`, and :ref:`rename_schema`. From c3556641d684a1408e40133bd9abcc10924f2665 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 6 Aug 2023 15:11:59 +0300 Subject: [PATCH 681/882] Update drop_schema.rst --- reference/sql/sql_statements/ddl_commands/drop_schema.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/sql/sql_statements/ddl_commands/drop_schema.rst b/reference/sql/sql_statements/ddl_commands/drop_schema.rst index 0f2dfd454..79597b49a 100644 --- a/reference/sql/sql_statements/ddl_commands/drop_schema.rst +++ b/reference/sql/sql_statements/ddl_commands/drop_schema.rst @@ -10,7 +10,7 @@ The schema has to be empty before removal. SQream DB does not support dropping a schema with objects. -See also: :ref:`create_schema`, :ref:`alter_default_schema`. +See also: :ref:`create_schema`, :ref:`alter_default_schema`, and :ref:`rename_schema`. Permissions ============= @@ -74,4 +74,4 @@ To drop the schema, drop the schema's tables first, and then drop the schema: t=> DROP TABLE test.bar; executed t=> DROP SCHEMA test; - executed \ No newline at end of file + executed From d1fc62dcc9efa648a7257d6372147dbeea7f720d Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 6 Aug 2023 15:13:45 +0300 Subject: [PATCH 682/882] Update sql_feature_support.rst --- reference/sql_feature_support.rst | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/reference/sql_feature_support.rst b/reference/sql_feature_support.rst index 0997b72bb..70c101dae 100644 --- a/reference/sql_feature_support.rst +++ b/reference/sql_feature_support.rst @@ -1,8 +1,8 @@ .. _sql_feature_support: -************************* +********************* SQL Feature Checklist -************************* +********************* To understand which ANSI SQL and other SQL features SQream DB supports, use the tables below. @@ -12,7 +12,7 @@ To understand which ANSI SQL and other SQL features SQream DB supports, use the Data Types and Values -========================= +===================== Read more about :ref:`Yes data types<data_types>`. @@ -65,7 +65,7 @@ Read more about :ref:`Yes data types<data_types>`. Constraints -=============== +=========== .. list-table:: Constraints :widths: auto @@ -86,15 +86,15 @@ Constraints Transactions -================ +============ SQream DB treats each statement as an auto-commit transaction. Each transaction is isolated from other transactions with serializable isolation. -If a statement fails, the entire transaction is cancelled and rolled back. The database is unchanged. +If a statement fails, the entire transaction is canceled and rolled back. The database is unchanged. Indexes -============ +======= SQream DB has a range-index collected on all columns as part of the metadata collection process. @@ -143,8 +143,8 @@ Schema Changes - No - * - Rename schema - - No - - + - Yes + - :ref:`rename_schema` * - Drop schema - Yes - :ref:`drop_schema` From d2fc0c36abdd722709c808b0e4c6775c23bc32a6 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 8 Aug 2023 13:52:11 +0300 Subject: [PATCH 683/882] CTEs --- .../sql_statements/dml_commands/select.rst | 112 ++++++------ .../sql_syntax/common_table_expressions.rst | 172 +++++++++++++----- 2 files changed, 185 insertions(+), 99 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/select.rst b/reference/sql/sql_statements/dml_commands/select.rst index 03bd20d70..bb1e44af4 100644 --- a/reference/sql/sql_statements/dml_commands/select.rst +++ b/reference/sql/sql_statements/dml_commands/select.rst @@ -1,8 +1,8 @@ .. _select: -********************** +****** SELECT -********************** +****** ``SELECT`` is the main statement that allows reading and processing of data. It is used to retrieve rows and columns from one or more tables. @@ -14,12 +14,12 @@ When used alone, the statement is known as a "``SELECT`` statement" or "``SELECT :local: Permissions -============= +=========== The role must have the ``SELECT`` permission on every table or schema that is referenced by the ``SELECT`` query. Syntax -========== +====== .. code-block:: postgres @@ -87,7 +87,7 @@ Syntax Elements -============ +======== .. list-table:: :widths: auto @@ -113,10 +113,10 @@ Elements - Concatenates the results of two queries together. ``UNION ALL`` does not remove duplicates. Notes -=========== +===== -Query processing ------------------ +Query Processing +---------------- Queries are processed in a manner equivalent to the following order: @@ -136,8 +136,8 @@ Inside the ``FROM`` clause, the processing occurs in the usual way, from the out .. _select_lists: -Select lists ----------------- +Select Lists +------------ The ``select_list`` is a comma separated list of column names and value expressions. @@ -155,7 +155,7 @@ The ``select_list`` is a comma separated list of column names and value expressi SELECT a, SUM(b) FROM t GROUP BY 1 ORDER BY 2 DESC; Examples -=========== +======== Assume a table named ``nba``, with the following structure: @@ -183,8 +183,8 @@ Here's a peek at the table contents (:download:`Download nba.csv </_static/sampl :header-rows: 1 -Simple queries ------------------- +Simple Queries +-------------- This query will get the Name, Team name, and Age from the NBA table, but only show the first 10 results. @@ -202,8 +202,8 @@ This query will get the Name, Team name, and Age from the NBA table, but only sh Terry Rozier,Boston Celtics,22 Marcus Smart,Boston Celtics,22 -Show a count of the rows ---------------------------- +Show Row Count +-------------- Use ``COUNT(*)`` to retrieve the number of rows in a result. @@ -212,8 +212,8 @@ Use ``COUNT(*)`` to retrieve the number of rows in a result. nba=> SELECT COUNT(*) FROM nba; 457 -Get all columns ------------------ +Get All Columns +--------------- ``*`` is used as shorthand for "all columns". @@ -237,8 +237,8 @@ Get all columns .. _where: -Filter on conditions ------------------------ +Filter On Conditions +-------------------- Use the ``WHERE`` clause to filter results. @@ -259,8 +259,8 @@ Use the ``WHERE`` clause to filter results. Joel Embiid,22,4626960 Nerlens Noel,22,3457800 -Filter based on a list ------------------------- +Filter Based On a List +---------------------- ``WHERE column IN (value_expr in comma separated list)`` matches the column with any value in the list. @@ -277,8 +277,8 @@ Filter based on a list Jeff Withey,26,947276,Utah Jazz -Select only distinct rows ---------------------------- +Select Only Distinct Rows +------------------------- .. code-block:: psql @@ -314,16 +314,16 @@ Select only distinct rows Utah Jazz Washington Wizards -Count distinct values ------------------------ +Count Distinct Values +--------------------- .. code-block:: psql nba=> SELECT COUNT(DISTINCT "Team") FROM nba; 30 -Rename columns with aliases ------------------------------ +Rename Columns With Aliases +--------------------------- .. code-block:: psql @@ -341,8 +341,8 @@ Rename columns with aliases R.J. Hunter | Boston Celtics | 1148640 Jonas Jerebko | Boston Celtics | 5000000 -Searching with ``LIKE`` -------------------------- +Searching With ``LIKE`` +----------------------- :ref:`like` allows pattern matching text in the ``WHERE`` clause. @@ -359,8 +359,8 @@ Searching with ``LIKE`` Allen Crabbe,24,947276,Portland Trail Blazers Ed Davis,27,6980802,Portland Trail Blazers -Aggregate functions ----------------------- +Aggregate Functions +------------------- Aggregate functions compute a single result from a column. @@ -390,8 +390,8 @@ Aggregate functions are often combined with ``GROUP BY``. A query like ``SELECT "Team",max("Salary") FROM nba`` is not valid, and will result in an error. -Filtering on aggregates --------------------------- +Filtering on Aggregates +----------------------- Filtering on aggregates is done with the ``HAVING`` clause, rather than the ``WHERE`` clause. @@ -410,8 +410,8 @@ Filtering on aggregates is done with the ``HAVING`` clause, rather than the ``WH .. _order_by: -Sorting results -------------------- +Sorting Results +--------------- ``ORDER BY`` takes a comma separated list of ordering specifications - a column followed by ``ASC`` for ascending or ``DESC`` for descending. @@ -450,8 +450,8 @@ Sorting results Portland Trail Blazers | 3220121 Philadelphia 76ers | 2213778 -Sorting with multiple columns ------------------------------------ +Sorting With Multiple Columns +----------------------------- Order retrieved rows by multiple columns: @@ -471,8 +471,8 @@ Order retrieved rows by multiple columns: Aaron Brooks | PG | 161 | 2250000 -Combining two or more queries ---------------------------------- +Combining Two or More Queries +----------------------------- ``UNION ALL`` can be used to combine the results of two or more queries into one result set. @@ -488,17 +488,15 @@ Combining two or more queries PG PG -Common table expressions (CTE) --------------------------------- - -Common table expressions or CTEs allow a possibly complex subquery to be represented in a short way later on, for improved readability. +Common Table Expression +----------------------- -It does not affect query performance. +A Common Table Expression (CTE) is a temporary named result set that can be referenced within a statement, allowing for more readable and modular queries. CTEs do not affect query performance. .. code-block:: psql - nba=> WITH s AS (SELECT "Name" FROM nba WHERE "Salary" > 20000000) - . SELECT * FROM nba AS n, s WHERE n."Name" = s."Name"; + WITH s AS (SELECT Name FROM nba WHERE Salary > 20000000) + SELECT * FROM nba AS n, s WHERE n.Name = s.Name; Name | Team | Number | Position | Age | Height | Weight | College | Salary | name0 ----------------+-----------------------+--------+----------+-----+--------+--------+--------------+----------+---------------- Carmelo Anthony | New York Knicks | 7 | SF | 32 | 6-8 | 240 | Syracuse | 22875000 | Carmelo Anthony @@ -510,31 +508,31 @@ It does not affect query performance. Kobe Bryant | Los Angeles Lakers | 24 | SF | 37 | 6-6 | 212 | | 25000000 | Kobe Bryant LeBron James | Cleveland Cavaliers | 23 | SF | 31 | 6-8 | 250 | | 22970500 | LeBron James -In this example, the ``WITH`` clause defines the temporary name ``r`` for the subquery which finds salaries over $20 million. The result set becomes a valid table reference in any table expression of the subsequent SELECT clause. +In this example, the ``WITH`` clause defines the temporary name ``s`` for the subquery which finds salaries over $20 million. The result set becomes a valid table reference in any table expression of the subsequent ``SELECT`` clause. Nested CTEs -^^^^^^^^^^^^^^ +^^^^^^^^^^^ -SQream DB also supports any amount of nested CTEs, such as this: +SQreamDB also supports any amount of nested CTEs, such as this: .. code-block:: postgres WITH w AS (SELECT * FROM - (WITH x AS (SELECT * FROM nba) SELECT * FROM x ORDER BY "Salary" DESC)) - SELECT * FROM w ORDER BY "Weight" DESC; + (WITH x AS (SELECT * FROM nba) SELECT * FROM x ORDER BY Salary DESC)) + SELECT * FROM w ORDER BY Weight DESC; Reusing CTEs -^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^ -SQream DB supports reusing CTEs several times in a query: +SQreamDB supports reusing CTEs several times in a query: .. code-block:: psql - nba=> WITH - . nba_ct AS (SELECT "Name", "Team" FROM nba WHERE "College"='Connecticut'), - . nba_az AS (SELECT "Name", "Team" FROM nba WHERE "College"='Arizona') - . SELECT * FROM nba_az JOIN nba_ct ON nba_ct."Team" = nba_az."Team"; + WITH + nba_ct AS (SELECT "Name", "Team" FROM nba WHERE "College"='Connecticut'), + nba_az AS (SELECT "Name", "Team" FROM nba WHERE "College"='Arizona') + SELECT * FROM nba_az JOIN nba_ct ON nba_ct."Team" = nba_az."Team"; Name | Team | name0 | team0 ----------------+-----------------+----------------+---------------- Stanley Johnson | Detroit Pistons | Andre Drummond | Detroit Pistons diff --git a/reference/sql/sql_syntax/common_table_expressions.rst b/reference/sql/sql_syntax/common_table_expressions.rst index 8ea74dba7..a1958f02e 100644 --- a/reference/sql/sql_syntax/common_table_expressions.rst +++ b/reference/sql/sql_syntax/common_table_expressions.rst @@ -1,15 +1,13 @@ .. _common_table_expressions: -********************************* -Common table expressions (CTEs) -********************************* +************************ +Common Table Expressions +************************ -Common table expressions or CTEs allow a complex subquery to be represented in a short way later on for improved readability, and reuse multiple times in a query. - -CTEs do not affect query performance. +A Common Table Expression (CTE) is a temporary named result set that can be referenced within a statement, allowing for more readable and modular queries. CTEs do not affect query performance. Syntax -========== +====== .. code-block:: postgres @@ -39,62 +37,103 @@ Syntax | ( VALUES ( value_expr [, ... ] ) [, ... ] ) Examples -========== +======== + +Create the following ``nba`` table: + +.. code-block:: psql + + CREATE OR REPLACE TABLE nba ( + Name TEXT, + Team TEXT, + Number INTEGER, + Position TEXT, + Age INTEGER, + Height TEXT, + Weight INTEGER, + College TEXT, + Salary INTEGER, + name0 TEXT + ); + + INSERT INTO nba (Name, Team, Number, Position, Age, Height, Weight, College, Salary, name0) + VALUES + ('Carmelo Anthony', 'New York Knicks', 7, 'SF', 32, '6-8', 240, 'Syracuse', 22875000, 'Carmelo Anthony'), + ('Chris Bosh', 'Miami Heat', 1, 'PF', 32, '6-11', 235, 'Georgia Tech', 22192730, 'Chris Bosh'), + ('Chris Paul', 'Los Angeles Clippers', 3, 'PG', 31, '6-0', 175, 'Wake Forest', 21468695, 'Chris Paul'), + ('Derrick Rose', 'Chicago Bulls', 1, 'PG', 27, '6-3', 190, 'Memphis', 20093064, 'Derrick Rose'), + ('Dwight Howard', 'Houston Rockets', 12, 'C', 30, '6-11', 265, NULL, 22359364, 'Dwight Howard'), + ('Kevin Durant', 'Oklahoma City Thunder', 35, 'SF', 27, '6-9', 240, 'Texas', 20158622, 'Kevin Durant'), + ('Kobe Bryant', 'Los Angeles Lakers', 24, 'SF', 37, '6-6', 212, NULL, 25000000, 'Kobe Bryant'), + ('LeBron James', 'Cleveland Cavaliers', 23, 'SF', 31, '6-8', 250, NULL, 22970500, 'LeBron James') + ('Stanley Johnson', 'Detroit Pistons', 3, 'SF', 26, '6-7', 245, 'Connecticut', 3120360, 'Stanley Johnson'), + ('Andre Drummond', 'Detroit Pistons', 0, 'C', 28, '6-10', 279, 'Connecticut', 27093019, 'Andre Drummond'), + ('Aaron Gordon', 'Orlando Magic', 0, 'PF', 26, '6-8', 235, 'Arizona', 18136364, 'Aaron Gordon'), + ('Shabazz Napier', 'Orlando Magic', 13, 'PG', 31, '6-1', 175, 'Connecticut', 1378242, 'Shabazz Napier'); Simple CTE --------------- +---------- .. code-block:: psql - nba=> WITH s AS (SELECT "Name" FROM nba WHERE "Salary" > 20000000) - . SELECT * FROM nba AS n, s WHERE n."Name" = s."Name"; - Name | Team | Number | Position | Age | Height | Weight | College | Salary | name0 - ----------------+-----------------------+--------+----------+-----+--------+--------+--------------+----------+---------------- - Carmelo Anthony | New York Knicks | 7 | SF | 32 | 6-8 | 240 | Syracuse | 22875000 | Carmelo Anthony - Chris Bosh | Miami Heat | 1 | PF | 32 | 6-11 | 235 | Georgia Tech | 22192730 | Chris Bosh - Chris Paul | Los Angeles Clippers | 3 | PG | 31 | 6-0 | 175 | Wake Forest | 21468695 | Chris Paul - Derrick Rose | Chicago Bulls | 1 | PG | 27 | 6-3 | 190 | Memphis | 20093064 | Derrick Rose - Dwight Howard | Houston Rockets | 12 | C | 30 | 6-11 | 265 | | 22359364 | Dwight Howard - Kevin Durant | Oklahoma City Thunder | 35 | SF | 27 | 6-9 | 240 | Texas | 20158622 | Kevin Durant - Kobe Bryant | Los Angeles Lakers | 24 | SF | 37 | 6-6 | 212 | | 25000000 | Kobe Bryant - LeBron James | Cleveland Cavaliers | 23 | SF | 31 | 6-8 | 250 | | 22970500 | LeBron James - -In this example, the ``WITH`` clause defines the temporary name ``r`` for the subquery which finds salaries over $20 million. The result set becomes a valid table reference in any table expression of the subsequent SELECT clause. + WITH s AS (SELECT Name FROM nba WHERE Salary > 20000000) + SELECT * FROM nba AS n, s WHERE n.Name = s.Name; + name |team |number|position|age|height|weight|college |salary |name0 |name1 | + ---------------+---------------------+------+--------+---+------+------+------------+--------+---------------+---------------+ + Kobe Bryant |Los Angeles Lakers | 24|SF | 37|6-6 | 212| |25000000|Kobe Bryant |Kobe Bryant | + LeBron James |Cleveland Cavaliers | 23|SF | 31|6-8 | 250| |22970500|LeBron James |LeBron James | + Dwight Howard |Houston Rockets | 12|C | 30|6-11 | 265| |22359364|Dwight Howard |Dwight Howard | + Carmelo Anthony|New York Knicks | 7|SF | 32|6-8 | 240|Syracuse |22875000|Carmelo Anthony|Carmelo Anthony| + Chris Bosh |Miami Heat | 1|PF | 32|6-11 | 235|Georgia Tech|22192730|Chris Bosh |Chris Bosh | + Chris Paul |Los Angeles Clippers | 3|PG | 31|6-0 | 175|Wake Forest |21468695|Chris Paul |Chris Paul | + Kevin Durant |Oklahoma City Thunder| 35|SF | 27|6-9 | 240|Texas |20158622|Kevin Durant |Kevin Durant | + Derrick Rose |Chicago Bulls | 1|PG | 27|6-3 | 190|Memphis |20093064|Derrick Rose |Derrick Rose | + +In this example, the ``WITH`` clause defines the temporary name ``s`` for the subquery which finds salaries over $20 million. The result set becomes a valid table reference in any table expression of the subsequent ``SELECT`` clause. Nested CTEs ---------------- +----------- -SQream DB also supports any amount of nested CTEs, such as this: +SQreamDB also supports any amount of nested CTEs, such as this: .. code-block:: postgres WITH w AS (SELECT * FROM - (WITH x AS (SELECT * FROM nba) SELECT * FROM x ORDER BY "Salary" DESC)) - SELECT * FROM w ORDER BY "Weight" DESC; + (WITH x AS (SELECT * FROM nba) SELECT * FROM x ORDER BY Salary DESC)) + SELECT * FROM w ORDER BY Weight DESC; + name |team |number|position|age|height|weight|college |salary |name0 | + ---------------+---------------------+------+--------+---+------+------+------------+--------+---------------+ + Dwight Howard |Houston Rockets | 12|C | 30|6-11 | 265| |22359364|Dwight Howard | + LeBron James |Cleveland Cavaliers | 23|SF | 31|6-8 | 250| |22970500|LeBron James | + Carmelo Anthony|New York Knicks | 7|SF | 32|6-8 | 240|Syracuse |22875000|Carmelo Anthony| + Kevin Durant |Oklahoma City Thunder| 35|SF | 27|6-9 | 240|Texas |20158622|Kevin Durant | + Chris Bosh |Miami Heat | 1|PF | 32|6-11 | 235|Georgia Tech|22192730|Chris Bosh | + Kobe Bryant |Los Angeles Lakers | 24|SF | 37|6-6 | 212| |25000000|Kobe Bryant | + Derrick Rose |Chicago Bulls | 1|PG | 27|6-3 | 190|Memphis |20093064|Derrick Rose | + Chris Paul |Los Angeles Clippers | 3|PG | 31|6-0 | 175|Wake Forest |21468695|Chris Paul | Reusing CTEs ----------------- +------------ -SQream DB supports reusing CTEs several times in a query. +SQreamDB supports reusing CTEs several times in a query. CTEs are separated with commas. .. code-block:: psql - nba=> WITH - . nba_ct AS (SELECT "Name", "Team" FROM nba WHERE "College"='Connecticut'), - . nba_az AS (SELECT "Name", "Team" FROM nba WHERE "College"='Arizona') - . SELECT * FROM nba_az JOIN nba_ct ON nba_ct."Team" = nba_az."Team"; - Name | Team | name0 | team0 - ----------------+-----------------+----------------+---------------- - Stanley Johnson | Detroit Pistons | Andre Drummond | Detroit Pistons - Aaron Gordon | Orlando Magic | Shabazz Napier | Orlando Magic + WITH + nba_ct AS (SELECT "Name", "Team" FROM nba WHERE "College"='Connecticut'), + nba_az AS (SELECT "Name", "Team" FROM nba WHERE "College"='Arizona') + SELECT * FROM nba_az JOIN nba_ct ON nba_ct."Team" = nba_az."Team"; + name |team |name0 |team0 | + ------------+-------------+--------------+-------------+ + Aaron Gordon|Orlando Magic|Shabazz Napier|Orlando Magic| -Using CTEs with :ref:`create_table_as` ----------------------------------------- +Using CTEs with ``CREATE TABLE AS`` +----------------------------------- When used with :ref:`create_table_as`, the ``CREATE TABLE`` statement should appear before ``WITH``. @@ -103,6 +142,55 @@ When used with :ref:`create_table_as`, the ``CREATE TABLE`` statement should app CREATE TABLE weights AS WITH w AS - (SELECT * FROM - (WITH x AS (SELECT * FROM nba) SELECT * FROM x ORDER BY "Salary" DESC)) - SELECT * FROM w ORDER BY "Weight" DESC; + (SELECT * FROM + (WITH x AS (SELECT * FROM nba) SELECT * FROM x ORDER BY Salary DESC)) + SELECT * FROM w ORDER BY Weight DESC; + + SELECT * FROM weights; + + name |team |number|position|age|height|weight|college |salary |name0 | + ---------------+---------------------+------+--------+---+------+------+------------+--------+---------------+ + Andre Drummond |Detroit Pistons | 0|C | 28|6-10 | 279|Connecticut |27093019|Andre Drummond | + Dwight Howard |Houston Rockets | 12|C | 30|6-11 | 265| |22359364|Dwight Howard | + LeBron James |Cleveland Cavaliers | 23|SF | 31|6-8 | 250| |22970500|LeBron James | + Stanley Johnson|Detroit Pistons | 3|SF | 26|6-7 | 245|Connecticut | 3120360|Stanley Johnson| + Carmelo Anthony|New York Knicks | 7|SF | 32|6-8 | 240|Syracuse |22875000|Carmelo Anthony| + Kevin Durant |Oklahoma City Thunder| 35|SF | 27|6-9 | 240|Texas |20158622|Kevin Durant | + Chris Bosh |Miami Heat | 1|PF | 32|6-11 | 235|Georgia Tech|22192730|Chris Bosh | + Aaron Gordon |Orlando Magic | 0|PF | 26|6-8 | 235|Arizona |18136364|Aaron Gordon | + Kobe Bryant |Los Angeles Lakers | 24|SF | 37|6-6 | 212| |25000000|Kobe Bryant | + Derrick Rose |Chicago Bulls | 1|PG | 27|6-3 | 190|Memphis |20093064|Derrick Rose | + Chris Paul |Los Angeles Clippers | 3|PG | 31|6-0 | 175|Wake Forest |21468695|Chris Paul | + Shabazz Napier |Orlando Magic | 13|PG | 31|6-1 | 175|Connecticut | 1378242|Shabazz Napier | + +Using CTEs with ``INSERT`` +-------------------------- + +The :ref:`insert` statement should appear before ``WITH``. + +.. code-block:: postgres + + CREATE OR REPLACE TABLE nba_archive ( + Name TEXT, + Team TEXT, + Number INTEGER, + Position TEXT, + Age INTEGER, + Height TEXT, + Weight INTEGER, + College TEXT, + Salary INTEGER, + name0 TEXT + ); + + INSERT INTO nba_archive + WITH nba_info AS( + SELECT * + FROM nba + ) + SELECT * + FROM nba_info; + + SELECT * FROM nba_archive ; + + \ No newline at end of file From c4969ca20d1876e324296dd19e1ffe4d75f6f2e2 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 9 Aug 2023 10:12:14 +0300 Subject: [PATCH 684/882] Update charindex.rst --- .../scalar_functions/string/charindex.rst | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/string/charindex.rst b/reference/sql/sql_functions/scalar_functions/string/charindex.rst index c8f2e4223..e519d31e7 100644 --- a/reference/sql/sql_functions/scalar_functions/string/charindex.rst +++ b/reference/sql/sql_functions/scalar_functions/string/charindex.rst @@ -1,10 +1,11 @@ .. _charindex: -************************** +********* CHARINDEX -************************** +********* + +``CHARINDEX`` is a 1-based indexing function that returns the starting position of a specified substring within a given string. -Returns the starting position of a string inside another string. See also :ref:`patindex`, :ref:`regexp_instr`. @@ -64,7 +65,7 @@ Using ``CHARINDEX`` .. code-block:: sql - SELECT CHARINDEX('john', username) FROM users; + SELECT CHARINDEX('doe', username) FROM users; Output: @@ -72,8 +73,8 @@ Output: charindex| ---------+ - 1 | - 0 | + 6 | + 6 | 0 | 0 | From c42ca5521cc338b83720495f2c700912bab5c8a5 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 16 Aug 2023 08:50:21 +0300 Subject: [PATCH 685/882] Update executing_statements_and_running_queries_from_the_editor.rst --- ...executing_statements_and_running_queries_from_the_editor.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/sqream_studio_5.4.7/executing_statements_and_running_queries_from_the_editor.rst b/sqream_studio_5.4.7/executing_statements_and_running_queries_from_the_editor.rst index 22666c2bd..76baf51c2 100644 --- a/sqream_studio_5.4.7/executing_statements_and_running_queries_from_the_editor.rst +++ b/sqream_studio_5.4.7/executing_statements_and_running_queries_from_the_editor.rst @@ -200,8 +200,6 @@ The database object functions are used to perform the following: - Generates an `RENAME TABLE AS <https://docs.sqream.com/en/latest/reference/sql/sql_statements/ddl_commands/rename_table.html#rename-table>`_ statement for renaming the selected table in the editing area. * - Adding column statement - Generates an `ADD COLUMN <https://docs.sqream.com/en/latest/reference/sql/sql_statements/ddl_commands/add_column.html#add-column>`_ statement for adding columns to the selected table in the editing area. - * - Truncate table statement - - Generates a `TRUNCATE_IF_EXISTS <https://docs.sqream.com/en/latest/reference/sql/sql_statements/dml_commands/truncate_if_exists.html#truncate>`_ statement for the selected table in the editing area. * - Drop table statement - Generates a ``DROP`` statement for the selected object in the editing area. * - Table DDL From 4b923215414ec61047b04536c665c57d79a314e8 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 16 Aug 2023 08:54:52 +0300 Subject: [PATCH 686/882] Update executing_statements_and_running_queries_from_the_editor.rst --- .../executing_statements_and_running_queries_from_the_editor.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/sqream_studio_5.4.7/executing_statements_and_running_queries_from_the_editor.rst b/sqream_studio_5.4.7/executing_statements_and_running_queries_from_the_editor.rst index 76baf51c2..2a2a9475e 100644 --- a/sqream_studio_5.4.7/executing_statements_and_running_queries_from_the_editor.rst +++ b/sqream_studio_5.4.7/executing_statements_and_running_queries_from_the_editor.rst @@ -278,7 +278,6 @@ You can add and name new tabs for each statement that you need to execute, and S You can also rename the default tab name by double-clicking it and typing a new name and write multiple statements in tandem in the same tab by separating them with semicolons (``;``).If too many tabs to fit into the Statement Pane are open at the same time, the tab arrows are displayed. You can scroll through the tabs by clicking |icon-left| or |icon-right|, and close tabs by clicking |icon-close|. You can also close all tabs at once by clicking **Close all** located to the right of the tabs. -.. tip:: If this is your first time using SQreamDB, see :ref:`Getting Started <getting_started>`. .. Keyboard shortcuts From 52ccb0dd9dc1da513a657e173ae0da838ceed9e5 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 16 Aug 2023 14:02:36 +0300 Subject: [PATCH 687/882] Update charindex.rst --- .../scalar_functions/string/charindex.rst | 58 +++++++++++++------ 1 file changed, 40 insertions(+), 18 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/string/charindex.rst b/reference/sql/sql_functions/scalar_functions/string/charindex.rst index e519d31e7..893332d7d 100644 --- a/reference/sql/sql_functions/scalar_functions/string/charindex.rst +++ b/reference/sql/sql_functions/scalar_functions/string/charindex.rst @@ -4,7 +4,7 @@ CHARINDEX ********* -``CHARINDEX`` is a 1-based indexing function that returns the starting position of a specified substring within a given string. +``CHARINDEX`` is a 1-based indexing function (both input and output) that returns the starting position of a specified substring within a given string. See also :ref:`patindex`, :ref:`regexp_instr`. @@ -39,29 +39,25 @@ Integer start position of a match, or 0 if no match was found. If one of the parameters is NULL, then the return value is NULL. +Empty string search returns 0. + Examples ======== -For these examples, consider the following table and contents: - -.. code-block:: sql - - CREATE TABLE users ( - id INT, - username TEXT, - email TEXT, - password TEXT - ); +For these examples, consider the following table: - INSERT INTO users (id, username, email, password) - VALUES (1, 'john_doe', 'john.doe@example.com', 'password1'), - (2, 'jane_doe', 'jane.doe@example.com', 'password2'), - (3, 'bob_smith', 'bob.smith@example.com', 'password3'), - (4, 'susan_jones', 'susan.jones@example.com', 'password4'); +.. code-block:: none + id | username | email | password + ----+-------------+-------------------------+----------- + 1 | john_doe | john.doe@example.com | password1 + ----+-------------+-------------------------+----------- + 2 | jane_doe | jane.doe@example.com | password2 + ----+-------------+-------------------------+----------- + 3 | bob_smith | bob.smith@example.com | password3 + ----+-------------+-------------------------+----------- + 4 | susan_jones | susan.jones@example.com | password4 -Using ``CHARINDEX`` -------------------- .. code-block:: sql @@ -77,5 +73,31 @@ Output: 6 | 0 | 0 | + +.. code-block:: sql + + SELECT CHARINDEX('doe', username, 10) FROM users; + +Output: + +.. code-block:: none + + charindex| + ---------+ + 0 | + 0 | + 0 | + 0 | +.. code-block:: sql + SELECT CHARINDEX('jane_doe', username, -10) FROM users; + +.. code-block:: none + + charindex| + ---------+ + 0 | + 1 | + 0 | + 0 | \ No newline at end of file From c166da5a9549304310f4bad7cd2a37db992f795c Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 16 Aug 2023 14:17:17 +0300 Subject: [PATCH 688/882] Update sign.rst --- .../sql_functions/scalar_functions/numeric/sign.rst | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/numeric/sign.rst b/reference/sql/sql_functions/scalar_functions/numeric/sign.rst index db2ff7547..b86f9c573 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/sign.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/sign.rst @@ -1,15 +1,15 @@ .. _sign: -************************** +**** SIGN -************************** +**** The ``SIGN`` function takes a single argument, which can be any numeric data type such as INTEGER, FLOAT, or DECIMAL, and returns an ``INT`` value of -1, 0, or 1, depending on the sign of the input argument. Syntax -========== +====== .. code-block:: postgres @@ -29,7 +29,8 @@ Arguments Return ====== -Returns an output of the same data type as the input data type. + +Returns an ``INT`` value. Depending on the sign of the input argument, the return is: @@ -50,7 +51,7 @@ Example Output: -.. code-block:: postgres +.. code-block:: none sign | sign0 | sign1 -----+------+------- From 480e862986ccab4b5ccb5de1d6ec7f88562f08b1 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 17 Aug 2023 08:43:55 +0300 Subject: [PATCH 689/882] Update crc64.rst --- .../sql_functions/scalar_functions/numeric/crc64.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/numeric/crc64.rst b/reference/sql/sql_functions/scalar_functions/numeric/crc64.rst index 4fb4dfdc0..de3693aa2 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/crc64.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/crc64.rst @@ -30,15 +30,15 @@ Returns Returns a CRC-64 hash of the text input, of type ``BIGINT``. -.. note:: If the input value is NULL, the result is NULL. +If the input value is ``NULL``, the result is ``NULL``. Examples ======== -Calculate a CRC-64 hash of a string ------------------------------------ - -.. code-block:: psql +.. code-block:: sql SELECT CRC64(x) FROM (VALUES ('This is a relatively long text string, that can be converted to a shorter hash' :: text)) as t(x); - -8397827068206190216 \ No newline at end of file + +.. code-block:: none + + -8397827068206190216 \ No newline at end of file From dfd749914b49515c72b7ed7cdd5f180b990ae611 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 20 Aug 2023 12:01:22 +0300 Subject: [PATCH 690/882] Update index.rst --- releases/index.rst | 4 ---- 1 file changed, 4 deletions(-) diff --git a/releases/index.rst b/releases/index.rst index 241381e3b..0ce60dfe7 100644 --- a/releases/index.rst +++ b/releases/index.rst @@ -32,7 +32,3 @@ Release Notes 4.0_index 2022.1_index 2021.2_index - 2021.1_index - 2020.3_index - 2020.2 - 2020.1 \ No newline at end of file From a30653b75caebe172c01d7a436fb40fede741cd8 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 20 Aug 2023 17:04:01 +0300 Subject: [PATCH 691/882] Update supported_data_types.rst --- data_type_guides/supported_data_types.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/data_type_guides/supported_data_types.rst b/data_type_guides/supported_data_types.rst index 740016249..25309ad65 100644 --- a/data_type_guides/supported_data_types.rst +++ b/data_type_guides/supported_data_types.rst @@ -59,7 +59,7 @@ The following table shows the supported data types. * - ``NUMERIC`` - 38 digits - 16 bytes - - ``0.123245678901234567890123456789012345678`` + - ``0.12324567890123456789012345678901234567`` - ``DECIMAL`` * - ``DATE`` - Date @@ -72,4 +72,4 @@ The following table shows the supported data types. - ``'1955-11-05 01:24:00.000'`` - ``TIMESTAMP``, ``DATETIME2`` -.. note:: SQream compresses all columns and types. The data size noted is the maximum data size allocation for uncompressed data. \ No newline at end of file +.. note:: SQream compresses all columns and types. The data size noted is the maximum data size allocation for uncompressed data. From 4a5f5138fcc6335271bbae1e608cfd4ebe9305c3 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 20 Aug 2023 17:15:07 +0300 Subject: [PATCH 692/882] Update sql_data_types_numeric.rst --- data_type_guides/sql_data_types_numeric.rst | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/data_type_guides/sql_data_types_numeric.rst b/data_type_guides/sql_data_types_numeric.rst index 8d63a82f5..6a7a7b6ec 100644 --- a/data_type_guides/sql_data_types_numeric.rst +++ b/data_type_guides/sql_data_types_numeric.rst @@ -1,21 +1,22 @@ .. _sql_data_types_numeric: -************************* +******* Numeric -************************* +******* + The **Numeric** data type (also known as **Decimal**) is recommended for values that tend to occur as exact decimals, such as in Finance. While Numeric has a fixed precision of ``38``, higher than ``REAL`` (``9``) or ``DOUBLE`` (``17``), it runs calculations more slowly. For operations that require faster performance, using :ref:`Floating Point <floating_point>` is recommended. The correct syntax for Numeric is ``numeric(p, s)``), where ``p`` is the total number of digits (``38`` maximum), and ``s`` is the total number of decimal digits. If no parameters are specified, Numeric defaults to ``numeric(38, 0)``. Numeric Examples -^^^^^^^^^^ +^^^^^^^^^^^^^^^^ The following is an example of the Numeric syntax: .. code-block:: postgres CREATE OR REPLACE table t(x numeric(20, 10), y numeric(38, 38)); - INSERT INTO t VALUES(1234567890.1234567890, 0.123245678901234567890123456789012345678); + INSERT INTO t VALUES(1234567890.1234567890, 0.12324567890123456789012345678901234567); SELECT x + y FROM t; The following table shows information relevant to the Numeric data type: @@ -29,10 +30,10 @@ The following table shows information relevant to the Numeric data type: - Example * - 38 digits - 16 bytes - - ``0.123245678901234567890123456789012345678`` + - ``0.12324567890123456789012345678901234567`` Numeric supports the following operations: * All join types. * All aggregation types (not including Window functions). - * Scalar functions (not including some trigonometric and logarithmic functions). \ No newline at end of file + * Scalar functions (not including some trigonometric and logarithmic functions). From a21bcd01cf2677122a74e65bd27437bacc5b9b39 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 21 Aug 2023 08:30:11 +0300 Subject: [PATCH 693/882] Update drop_saved_query.rst --- .../sql/sql_statements/utility_commands/drop_saved_query.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/utility_commands/drop_saved_query.rst b/reference/sql/sql_statements/utility_commands/drop_saved_query.rst index 9e7d8d725..f8174edd2 100644 --- a/reference/sql/sql_statements/utility_commands/drop_saved_query.rst +++ b/reference/sql/sql_statements/utility_commands/drop_saved_query.rst @@ -8,7 +8,7 @@ DROP_SAVED_QUERY Read more in the :ref:`saved_queries<saved_queries>` guide. -See also: ref:`save_query`, :ref:`execute_saved_query`, ref:`show_saved_query`, ref:`list_saved_queries`. +See also: :ref:`save_query`, :ref:`execute_saved_query`, :ref:`show_saved_query`, :ref:`list_saved_queries`. Permissions ============= From 67f421712edb8de3768b7942898f49a41ab0b2ca Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 21 Aug 2023 08:34:45 +0300 Subject: [PATCH 694/882] Update execute_saved_query.rst --- .../sql/sql_statements/utility_commands/execute_saved_query.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/utility_commands/execute_saved_query.rst b/reference/sql/sql_statements/utility_commands/execute_saved_query.rst index 39675d47f..fdc626577 100644 --- a/reference/sql/sql_statements/utility_commands/execute_saved_query.rst +++ b/reference/sql/sql_statements/utility_commands/execute_saved_query.rst @@ -109,7 +109,7 @@ Use parameters to replace them later at execution time. .. tip:: Use dollar quoting (`$$`) to avoid escaping strings. - .. code-block:: psql +.. code-block:: psql t=> SELECT SAVE_QUERY('select_by_weight_and_team',$$SELECT * FROM nba WHERE Weight > ? AND Team = ?$$); executed From c5e12341f41baa8be7a1c85901cb486e54a3057d Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 21 Aug 2023 08:39:08 +0300 Subject: [PATCH 695/882] Update list_saved_queries.rst --- .../sql/sql_statements/utility_commands/list_saved_queries.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/utility_commands/list_saved_queries.rst b/reference/sql/sql_statements/utility_commands/list_saved_queries.rst index bb1781840..a50bbc43f 100644 --- a/reference/sql/sql_statements/utility_commands/list_saved_queries.rst +++ b/reference/sql/sql_statements/utility_commands/list_saved_queries.rst @@ -10,7 +10,7 @@ This is an alternative way to using the ``savedqueries`` catalog view. Read more in the :ref:`saved_queries` guide. -See also: ref:`save_query`, :ref:`execute_saved_query`, ref:`drop_saved_query`, ref:`show_saved_query`. +See also: :ref:`save_query`, :ref:`execute_saved_query`, :ref:`drop_saved_query`, :ref:`show_saved_query` Permissions ============= From 18b4ad5301735f14ae6c8b87396a48a88e19d314 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 21 Aug 2023 15:11:29 +0300 Subject: [PATCH 696/882] Update power_bi.rst --- .../client_platforms/power_bi.rst | 60 +++++++------------ 1 file changed, 23 insertions(+), 37 deletions(-) diff --git a/connecting_to_sqream/client_platforms/power_bi.rst b/connecting_to_sqream/client_platforms/power_bi.rst index b43adf578..2c19567d3 100644 --- a/connecting_to_sqream/client_platforms/power_bi.rst +++ b/connecting_to_sqream/client_platforms/power_bi.rst @@ -1,11 +1,9 @@ .. _power_bi: -************************* -Connecting to SQream Using Power BI Desktop -************************* +********** +BI Desktop +********** -Overview -========= **Power BI Desktop** lets you connect to SQream and use underlying data as with other data sources in Power BI Desktop. SQream integrates with Power BI Desktop to do the following: @@ -35,7 +33,8 @@ The **Connect to SQream Using Power BI** page describes the following: :depth: 1 Prerequisites -------------------- +------------- + To connect to SQream, the following must be installed: * **ODBC data source administrator** - 32 or 64, depending on your operating system. For Windows users, the ODBC data source administrator is embedded within the operating system. @@ -43,49 +42,47 @@ To connect to SQream, the following must be installed: * **SQream driver** - The SQream application required for interacting with the ODBC according to the configuration specified in the ODBC administrator tool. Installing Power BI Desktop -------------------- +--------------------------- + **To install Power BI Desktop:** -1. Download `Power BI Desktop 64x <https://powerbi.microsoft.com/en-us/downloads/>`_. +#. Download `Power BI Desktop 64x <https://powerbi.microsoft.com/en-us/downloads/>`_. :: -2. Download and configure your ODBC driver. +#. Download and configure your ODBC driver. - For more information about configuring your ODBC driver, see `ODBC <https://docs.sqream.com/en/v2022.1/connecting_to_sqream/client_drivers/odbc/index.html>`_. + For information about downloading and configuring your ODBC driver, see :ref:`ODBC <odbc>` or contact `SQream Support <https://sqream.atlassian.net/servicedesk/>`_. -3. Navigate to **Windows** > **Documents** and create a folder called **Power BI Desktop Custom Connectors**. +#. Navigate to **Windows** > **Documents** and create a folder named **Power BI Desktop** with a subfolder named **Custom Connectors**. :: - -4. In the **Power BI Desktop** folder, create a folder called **Custom Connectors**. - -5. From the Client Drivers page, download the **PowerQuery.mez** file. +#. From the Client Drivers page, :ref:`download<client_drivers>` the **PowerQuery.mez** file. :: -5. Save the PowerQuery.mez file in the **Custom Connectors** folder you created in Step 3. +#. Save the PowerQuery.mez file in the **Custom Connectors** folder you created in Step 3. :: -6. Open the Power BI application. +#. Open the Power BI application. :: -7. Navigate to **File** > **Options and Settings** > **Option** > **Security** > **Data Extensions**, and select **(Not Recommended) Allow any extension to load without validation or warning**. +#. Navigate to **File** > **Options and Settings** > **Option** > **Security** > **Data Extensions**, and select **(Not Recommended) Allow any extension to load without validation or warning**. :: -8. Restart the Power BI Desktop application. +#. Restart the Power BI Desktop application. :: -9. From the **Get Data** menu, select **SQream**. +#. From the **Get Data** menu, select **SQream**. :: -10. Click **Connect** and provide the information shown in the following table: +#. Click **Connect** and provide the information shown in the following table: .. list-table:: :widths: 6 31 @@ -104,18 +101,19 @@ Installing Power BI Desktop * - Passwords - Provide a password for your user. -11. Under **Data Connectivity mode**, select **DirectQuery mode**. +#. Under **Data Connectivity mode**, select **DirectQuery mode**. :: -12. Click **Connect**. +#. Click **Connect**. :: -13. Provide your user name and password and click **Connect**. +#. Provide your user name and password and click **Connect**. Best Practices for Power BI ---------------- +--------------------------- + SQream recommends using Power BI in the following ways for acquiring the best performance metrics: * Creating bar, pie, line, or plot charts when illustrating one or more columns. @@ -128,16 +126,4 @@ SQream recommends using Power BI in the following ways for acquiring the best pe * Creating a unified view using **PowerQuery** to connect different data sources into a single dashboard. -Supported SQream Driver Versions ---------------- -SQream supports the following SQream driver versions: - -* The **PowerQuery Connector** is an additional layer on top of the ODBC. - - :: - -* SQream Driver Installation (ODBC v4.1.1) - Contact your administrator for the link to download ODBC v4.1.1. -Related Information -------------------- -For more information, see the `Glossary <https://docs.sqream.com/en/v2022.1/glossary.html>`_. \ No newline at end of file From 0da71699fc3c4f7826df8ffd2dcfb8b12bfe3b31 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 21 Aug 2023 15:32:06 +0300 Subject: [PATCH 697/882] Update logging.rst --- operational_guides/logging.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/operational_guides/logging.rst b/operational_guides/logging.rst index 90499e971..28ffca44b 100644 --- a/operational_guides/logging.rst +++ b/operational_guides/logging.rst @@ -374,7 +374,7 @@ Assuming logs are stored at ``/home/rhendricks/sqream_storage/logs/``, a databas OPTIONS ( LOCATION = '/home/rhendricks/sqream_storage/logs/**/sqream*.log', - DELIMITER = '|' + DELIMITER = '|', CONTINUE_ON_ERROR = true ) ; From d277d039d3b6dae1c4eec0d83978701ff3cc8640 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 22 Aug 2023 08:55:57 +0300 Subject: [PATCH 698/882] Update trunc.rst --- .../sql/sql_functions/scalar_functions/date_and_time/trunc.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/reference/sql/sql_functions/scalar_functions/date_and_time/trunc.rst b/reference/sql/sql_functions/scalar_functions/date_and_time/trunc.rst index e3511281f..442fc7e4b 100644 --- a/reference/sql/sql_functions/scalar_functions/date_and_time/trunc.rst +++ b/reference/sql/sql_functions/scalar_functions/date_and_time/trunc.rst @@ -8,7 +8,8 @@ Truncates a ``DATE`` or ``DATETIME`` value to a specified resolution. For example, truncating a ``DATE`` down to the nearest month returns the date of the first day of the month. -.. note:: This function is overloaded. The function :ref:`TRUNC<trunc>` can also round numbers towards zero. +.. note:: * This function is overloaded. The function :ref:`TRUNC<trunc>` can also round numbers towards zero. + * Specifying the ``MILLISECOND`` interval with the ``TRUNC`` function is redundant, as there is nothing smaller than milliseconds. Syntax ========== From 1f06f9a3af62ff330f5b1c126e7d2e85893e3505 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 22 Aug 2023 14:53:50 +0300 Subject: [PATCH 699/882] Update index.rst --- .../client_drivers/jdbc/index.rst | 27 +++++++++++++------ 1 file changed, 19 insertions(+), 8 deletions(-) diff --git a/connecting_to_sqream/client_drivers/jdbc/index.rst b/connecting_to_sqream/client_drivers/jdbc/index.rst index 3f625759c..734b61efc 100644 --- a/connecting_to_sqream/client_drivers/jdbc/index.rst +++ b/connecting_to_sqream/client_drivers/jdbc/index.rst @@ -3,6 +3,7 @@ ************************* JDBC ************************* + The SQream JDBC driver lets you connect to SQream using many Java applications and tools. This page describes how to write a Java application using the JDBC interface. The JDBC driver requires Java 1.8 or newer. .. contents:: @@ -11,6 +12,7 @@ The SQream JDBC driver lets you connect to SQream using many Java applications a Installing the JDBC Driver ================================== + The **Installing the JDBC Driver** section describes the following: .. contents:: @@ -19,6 +21,7 @@ The **Installing the JDBC Driver** section describes the following: Prerequisites ---------------- + The SQream JDBC driver requires Java 1.8 or newer, and SQream recommends using Oracle Java or OpenJDK.: * **Oracle Java** - Download and install `Java 8 <https://www.java.com/en/download/manual.jsp>`_ from Oracle for your platform. @@ -33,11 +36,13 @@ The SQream JDBC driver requires Java 1.8 or newer, and SQream recommends using O Getting the JAR file --------------------- + The SQream JDBC driver is available for download from the :ref:`client drivers download page<client_drivers>`. This JAR file can be integrated into your Java-based applications or projects. Setting Up the Class Path ---------------------------- + To use the driver, you must include the JAR named ``sqream-jdbc-<version>.jar`` in the class path, either by inserting it in the ``CLASSPATH`` environment variable, or by using flags on the relevant Java command line. For example, if the JDBC driver has been unzipped to ``/home/sqream/sqream-jdbc-4.3.0.jar``, the following command is used to run application: @@ -55,6 +60,7 @@ Alternatively, you can pass ``-classpath`` to the Java executable file: Connecting to SQream Using a JDBC Application ============================================== + You can connect to SQream using one of the following JDBC applications: .. contents:: @@ -63,20 +69,23 @@ You can connect to SQream using one of the following JDBC applications: Driver Class -------------- + Use ``com.sqream.jdbc.SQDriver`` as the driver class in the JDBC application. Connection String -------------------- + JDBC drivers rely on a connection string. The following is the syntax for SQream: .. code-block:: text - jdbc:Sqream://<host and port>/<database name>;user=<username>;password=<password>sqream;[<optional parameters>; ...] + jdbc:Sqream://<host and port>/<database name>;user=<username>;password=<password>;[<optional parameters>; ...] Connection Parameters ^^^^^^^^^^^^^^^^^^^^^^^^ + The following table shows the connection string parameters: .. list-table:: @@ -96,13 +105,13 @@ The following table shows the connection string parameters: - None - Database name to connect to. For example, ``master`` * - ``username=<username>`` - - Mandatory + - Optional - None - - Username of a role to use for connection. For example, ``username=rhendricks`` + - Username of a role to use for connection. For example, ``username=SqreamRole`` * - ``password=<password>`` - - Mandatory + - Optional - None - - Specifies the password of the selected role. For example, ``password=Tr0ub4dor&3`` + - Specifies the password of the selected role. For example, ``password=SqreamRolePassword2023 `` * - ``service=<service>`` - Optional - ``sqream`` @@ -138,19 +147,20 @@ The following table shows the connection string parameters: Connection String Examples ^^^^^^^^^^^^^^^^^^^^^^^^^^^ -The following is an example of a SQream cluster with load balancer and no service queues (with SSL): + +The following is an example of a SQream cluster with a load balancer and no service queues (with SSL): .. code-block:: text jdbc:Sqream://sqream.mynetwork.co:3108/master;user=rhendricks;password=Tr0ub4dor&3;ssl=true;cluster=true -The following is a minimal example for a local standalone SQream database: +The following is a minimal example of a local standalone SQream database: .. code-block:: text jdbc:Sqream://127.0.0.1:5000/master;user=rhendricks;password=Tr0ub4dor&3 -The following is an example of a SQream cluster with load balancer and a specific service queue named ``etl``, to the database named ``raviga`` +The following is an example of a SQream cluster with a load balancer and a specific service queue named ``etl``, to the database named ``raviga`` .. code-block:: text @@ -158,6 +168,7 @@ The following is an example of a SQream cluster with load balancer and a specifi Sample Java Program -------------------- + You can download the :download:`JDBC Application Sample File <sample.java>` below by right-clicking and saving it to your computer. .. literalinclude:: sample.java From 20370d089e78ac85fa2d2ae525e36edde0b816d1 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 22 Aug 2023 14:54:34 +0300 Subject: [PATCH 700/882] Update index.rst --- connecting_to_sqream/client_drivers/jdbc/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/connecting_to_sqream/client_drivers/jdbc/index.rst b/connecting_to_sqream/client_drivers/jdbc/index.rst index 734b61efc..efed488d6 100644 --- a/connecting_to_sqream/client_drivers/jdbc/index.rst +++ b/connecting_to_sqream/client_drivers/jdbc/index.rst @@ -111,7 +111,7 @@ The following table shows the connection string parameters: * - ``password=<password>`` - Optional - None - - Specifies the password of the selected role. For example, ``password=SqreamRolePassword2023 `` + - Specifies the password of the selected role. For example, ``password=SqreamRolePassword2023`` * - ``service=<service>`` - Optional - ``sqream`` From 838eaef1eb054217397f200dbd07bed106d95713 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 23 Aug 2023 09:31:27 +0300 Subject: [PATCH 701/882] Update keywords_and_identifiers.rst --- .../sql_syntax/keywords_and_identifiers.rst | 154 ++++++------------ 1 file changed, 46 insertions(+), 108 deletions(-) diff --git a/reference/sql/sql_syntax/keywords_and_identifiers.rst b/reference/sql/sql_syntax/keywords_and_identifiers.rst index 75687998c..646b12e20 100644 --- a/reference/sql/sql_syntax/keywords_and_identifiers.rst +++ b/reference/sql/sql_syntax/keywords_and_identifiers.rst @@ -1,8 +1,11 @@ .. _keywords_and_identifiers: -*********** +************************ +Identifiers and Keywords +************************ + Identifiers -*********** +=========== **Identifiers** are names given to SQL entities, such as tables, columns, databases, and variables. Identifiers must be unique so that entities can be correctly identified during the execution of a program. Identifiers can also be used to change a column name in the result (column alias) in a ``SELECT`` statement. Identifiers can be either quoted or unquoted and a maximum 128 characters long. @@ -22,117 +25,52 @@ Quoted identifiers must follow these rules: * May contain any ASCII character except ``@``, ``$`` or ``"``. * Must be case-sensitive and referenced with double quotes (``"``) +Examples +-------- + +Creating quoted and unquoted identifiers: + +.. code-block:: sql + + CREATE ROLE "developer"; --quoted identifiers preserves case - will create "developer" + CREATE ROLE "Developer"; --quoted identifiers preserves case - will create "Developer" + CREATE ROLE Developer; --unquoted identifiers ignores case - will create "developer" + +Valid and invalid use of identifiers: + +.. code-block:: sql + + -- these are all valid examples when quoted: + + CREATE SCHEMA "my schema"; + CREATE SCHEMA "123schema"; + + -- but are invalid when unquoted: + + CREATE SCHEMA my schema; --invalid + CREATE SCHEMA 123schema; --invalid + + -- Use of invalid characters: + + CREATE SCHEMA "my schema@master"; + + Status: Ended with errorError preparing statement: Unsupported character '@' in identifier: "my schema@master" + Quoted identifiers cannot contain the character '@'. + Quoted identifiers may contain any ASCII character with code between 32 and 126 except for: + - @ + - $ + - " + + +Keywords +======== + Identifiers are different than **keywords**, which are predefined words reserved with specific meanings in a statement. Some examples of keywords are ``SELECT``, ``CREATE``, and ``WHERE``. Note that keywords **cannot** be used as identifiers. SQreamDB reserved keywords: - - ``ALL`` - - ``ANALYSE`` - - ``ANALYZE`` - - ``AND`` - - ``ANY`` - - ``ARRAY`` - - ``AS`` - - ``ASC`` - - ``AUTHORIZATION`` - - ``BINARY`` - - ``BIGINT`` - - ``BOTH`` - - ``CASE`` - - ``CAST`` - - ``CHECK`` - - ``COLLATE`` - - ``COLUMN`` - - ``CONCURRENTLY`` - - ``CONSTRAINT`` - - ``CREATE`` - - ``CROSS`` - - ``CURRENT_CATALOG`` - - ``CURRENT_ROLE`` - - ``CURRENT_TIME`` - - ``CURRENT_USER`` - - ``DEFAULT`` - - ``DEFERRABLE`` - - ``DESC`` - - ``DISTINCT`` - - ``DO`` - - ``ELSE`` - - ``END`` - - ``EXCEPT`` - - ``FALSE`` - - ``FETCH`` - - ``FOR`` - - ``FREEZE`` - - ``FROM`` - - ``FULL`` - - ``FUNCTION`` - - ``GRANT`` - - ``GROUP`` - - ``HASH`` - - ``HAVING`` - - ``ILIKE`` - - ``IN`` - - ``INITIALLY`` - - ``INNER`` - - ``INTERSECT`` - - ``INTO`` - - ``IS`` - - ``ISNULL`` - - ``JOIN`` - - ``KEY`` - - ``LEADING`` - - ``LEFT`` - - ``LIKE`` - - ``LIMIT`` - - ``LOCALTIME`` - - ``LOCALTIMESTAMP`` - - ``LOOP`` - - ``MERGE`` - - ``NATURAL`` - - ``NOT`` - - ``NOTNULL`` - - ``NULL`` - - ``OFFSET`` - - ``ON`` - - ``ONLY`` - - ``OPTION`` - - ``OR`` - - ``ORDER`` - - ``OUTER`` - - ``OVER`` - - ``OVERLAPS`` - - ``PERCENT`` - - ``PLACING`` - - ``PRIMARY`` - - ``PRECISION`` - - ``PROC`` - - ``REFERENCES`` - - ``RETURNING`` - - ``RIGHT`` - - ``RLIKE`` - - ``SELECT`` - - ``SESSION_USER`` - - ``SET`` - - ``SIMILAR`` - - ``SOME`` - - ``SYMMETRIC`` - - ``TABLE`` - - ``THEN`` - - ``TO`` - - ``TRAILING`` - - ``TRAN`` - - ``TRUE`` - - ``UNION`` - - ``UNIQUE`` - - ``USER`` - - ``USING`` - - ``VARIADIC`` - - ``VERBOSE`` - - ``WHEN`` - - ``WHERE`` - - ``WINDOW`` - - ``WITH`` +``ALL`` | ``ANALYSE`` | ``ANALYZE`` | ``AND`` | ``ANY`` | ``ARRAY`` | ``AS`` | ``ASC`` | ``AUTHORIZATION`` | ``BINARY`` | ``BIGINT`` | ``BOTH`` | ``CASE`` | ``CAST`` | ``CHECK`` | ``COLLATE`` | ``COLUMN`` | ``CONCURRENTLY`` | ``CONSTRAINT`` | ``CREATE`` | ``CROSS`` | ``CURRENT_CATALOG`` | ``CURRENT_ROLE`` | ``CURRENT_TIME`` | ``CURRENT_USER`` | ``DEFAULT`` | ``DEFERRABLE`` | ``DESC`` | ``DISTINCT`` | ``DO`` | ``ELSE`` | ``END`` | ``EXCEPT`` | ``FALSE`` | ``FETCH`` | ``FOR`` | ``FREEZE`` | ``FROM`` | ``FULL`` | ``FUNCTION`` | ``GRANT`` | ``GROUP`` | ``HASH`` | ``HAVING`` | ``ILIKE`` | ``IN`` | ``INITIALLY`` | ``INNER`` | ``INTERSECT`` | ``INTO`` | ``IS`` | ``ISNULL`` | ``JOIN`` | ``KEY`` | ``LEADING`` | ``LEFT`` | ``LIKE`` | ``LIMIT`` | ``LOCALTIME`` | ``LOCALTIMESTAMP`` | ``LOOP`` | ``MERGE`` | ``NATURAL`` | ``NOT`` | ``NOTNULL`` | - ``NULL`` | ``OFFSET`` | ``ON`` | ``ONLY`` | ``OPTION`` | ``OR`` | ``ORDER`` | ``OUTER`` | ``OVER`` | ``OVERLAPS`` | ``PERCENT`` | ``PLACING`` | ``PRIMARY`` | ``PRECISION`` | ``PROC`` | ``REFERENCES`` | ``RETURNING`` | ``RIGHT`` | ``RLIKE`` | ``SELECT`` | ``SESSION_USER`` | ``SET`` | ``SIMILAR`` | ``SOME`` | ``SYMMETRIC`` | ``TABLE`` | ``THEN`` | ``TO`` | ``TRAILING`` | ``TRAN`` | ``TRUE`` | ``UNION`` | ``UNIQUE`` | ``USER`` | ``USING`` | ``VARIADIC`` | ``VERBOSE`` | ``WHEN`` | ``WHERE`` | ``WINDOW`` | ``WITH`` From 88bebc00a39bef057403926db967d82e2219becd Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 23 Aug 2023 10:08:21 +0300 Subject: [PATCH 702/882] Remove Trino --- connecting_to_sqream/client_drivers/index.rst | 7 ------- releases/4.1.rst | 4 ---- 2 files changed, 11 deletions(-) diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index dbbd33933..a76f64b07 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -26,13 +26,6 @@ The following are applicable to all operating systems: * `.NET .dll file <https://get.sqream-share.com/share/sIsu8fxv>`_ * :ref:`net` - -.. _trino: - -* **Trino**: - - * Trino Connector - * :ref:`trino` .. _spark: diff --git a/releases/4.1.rst b/releases/4.1.rst index a9203569b..38df59422 100644 --- a/releases/4.1.rst +++ b/releases/4.1.rst @@ -18,10 +18,6 @@ New Features * :ref:`Lightweight Directory Access Protocol (LDAP)<ldap>` management enhancement :: - - * The :ref:`Trino<trino>` ETL tool may now be used for distributed SQL query processing - - :: * A new brute-force attack protection mechanism locks out user accounts for 15 minutes following 5 consecutive failed login attempts From be07d8fb7404983faa8e81240e82f4eb9d115c3a Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 23 Aug 2023 13:34:08 +0300 Subject: [PATCH 703/882] Update copy_to.rst --- .../sql_statements/dml_commands/copy_to.rst | 27 ++++++++++++++++--- 1 file changed, 24 insertions(+), 3 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/copy_to.rst b/reference/sql/sql_statements/dml_commands/copy_to.rst index 32e462f5d..f15b7e36f 100644 --- a/reference/sql/sql_statements/dml_commands/copy_to.rst +++ b/reference/sql/sql_statements/dml_commands/copy_to.rst @@ -19,6 +19,7 @@ In general, ``COPY`` moves data between filesystem files and SQream DB tables. I Syntax ========== + The following is the correct syntax for using the **COPY TO** statement: .. code-block:: postgres @@ -70,6 +71,7 @@ The following is the correct syntax for using the **COPY TO** statement: Elements ============ + The following table shows the ``COPY_TO`` elements: .. list-table:: @@ -114,7 +116,8 @@ Supported Field Delimiters :depth: 1 Printable ASCII Characters -^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^ + Any printable ASCII character can be used as a delimiter without special syntax. The default CSV field delimiter is a comma (``,``). The following table shows the supported printable ASCII characters: @@ -180,7 +183,8 @@ The following table shows the supported printable ASCII characters: +---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ Non-Printable ASCII Characters -^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + The following table shows the supported non-printable ASCII characters: +---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ @@ -256,7 +260,8 @@ For example, ASCII character ``15``, known as "shift in", can be specified using .. note:: Delimiters are only applicable to the CSV file format. Unsupported ASCII Field Delimiters ------------------------------- +----------------------------------- + The following table shows the unsupported ASCII field delimiters: +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ @@ -403,6 +408,7 @@ The following table shows the unsupported ASCII field delimiters: Date Format --------------- + The date format in the output CSV is formatted as ISO 8601 (``2019-12-31 20:30:55.123``), regardless of how it was parsed initially with :ref:`COPY FROM date parsers<copy_date_parsers>`. For more information on the ``datetime`` format, see :ref:`sql_data_types_date`. @@ -419,6 +425,7 @@ Exporting Data From SQream to External File Tables Parquet ^^^^^^^ + The compression algorithm used for exporting data from SQream to Parquet files is Snappy. Exporting tables to Parquet files: @@ -551,6 +558,7 @@ The following is an example of saving files to an HDFS path: Using Non-Printable ASCII Characters as Delimiters -------------------------------------------------- + The following is an example of using non-printable ASCII characters as delimiters: Non-printable characters can be specified using their octal representations, by using the ``E'\000'`` format, where ``000`` is the octal value of the character. @@ -565,6 +573,19 @@ For example, ASCII character ``15``, known as "shift in", can be specified using COPY nba TO WRAPPER csv_fdw OPTIONS (LOCATION = '/tmp/nba_export.csv', DELIMITER = E'\011'); -- 011 is a tab character +Using the ``MAX_FILE_SIZE`` and ``ENFORCE_SINGLE_FILE`` parameters: +------------------------------------------------------------------- + +.. code-block:: psql + + COPY nba TO WRAPPER csv_fdw OPTIONS( + max_file_size = '250000000', + enforce_single_file = 'true', + location = '/tmp/nba_export.parquet' + ); + + Permissions ============= + The role must have the ``SELECT`` permission on every table or schema that is referenced by the statement. \ No newline at end of file From de223113523d7bb41cb8a9a9e25187e488c19616 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 23 Aug 2023 14:33:45 +0300 Subject: [PATCH 704/882] Update sample.java --- connecting_to_sqream/client_drivers/jdbc/sample.java | 1 + 1 file changed, 1 insertion(+) diff --git a/connecting_to_sqream/client_drivers/jdbc/sample.java b/connecting_to_sqream/client_drivers/jdbc/sample.java index 3ff670747..ca591aa26 100644 --- a/connecting_to_sqream/client_drivers/jdbc/sample.java +++ b/connecting_to_sqream/client_drivers/jdbc/sample.java @@ -52,6 +52,7 @@ public void testJDBC() throws SQLException, IOException { } rs.close(); // Close the result set stmt.close(); // Close the statement handle + conn.close() } From 40c55a0f1d911ac8fd091de64735d090d12f06d7 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 23 Aug 2023 16:42:39 +0300 Subject: [PATCH 705/882] Update 4.3.rst --- releases/4.3.rst | 32 +++++++++++++++++++++++++++----- 1 file changed, 27 insertions(+), 5 deletions(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index 35e00d73b..07bafb3c4 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -64,31 +64,47 @@ Version 4.3 resolved Issues +====================+================================================================================================+ | SQ-11108 | Slow ``COPY FROM`` statements using ORC files | +--------------------+------------------------------------------------------------------------------------------------+ +| SQ-11804 | Slow metadata optimization | ++--------------------+------------------------------------------------------------------------------------------------+ +| SQ-12721 | ``maxConnectionInactivitySeconds`` flag issue when executing Batch Shell Program ETLs | ++--------------------+------------------------------------------------------------------------------------------------+ +| SQ-12799 | Catalog queries may not be terminated | ++--------------------+------------------------------------------------------------------------------------------------+ | SQ-13112 | ``GRANT`` query queue issue | +--------------------+------------------------------------------------------------------------------------------------+ | SQ-13201 | ``INSERT INTO`` statement error while copying data from non-clustered table to clustered table | +--------------------+------------------------------------------------------------------------------------------------+ | SQ-13210, SQ-13426 | Slow query execution time | +--------------------+------------------------------------------------------------------------------------------------+ +| SQ-13225 | LoopJoin performance enhancement supports ``=``, ``>``, ``<``, and ``<=`` operators | ++--------------------+------------------------------------------------------------------------------------------------+ | SQ-13322 | Cleanup operation case-sensitivity issue | +--------------------+------------------------------------------------------------------------------------------------+ | SQ-13401 | The JDBC driver causes the log summery of ``INSERT`` statements to fail | +--------------------+------------------------------------------------------------------------------------------------+ | SQ-13453 | Metadata performance issue | +--------------------+------------------------------------------------------------------------------------------------+ +| SQ-13460 | ``GRANT ALL ON ALL TABLES`` statement slow compilation time | ++--------------------+------------------------------------------------------------------------------------------------+ +| SQ-13461 | ``WHERE`` clause filter issue | ++--------------------+------------------------------------------------------------------------------------------------+ +| SQ-13467 | Snapshot issue causes metadata failure | ++--------------------+------------------------------------------------------------------------------------------------+ +| SQ-13529 | Pysqream concurrency issue | ++--------------------+------------------------------------------------------------------------------------------------+ | SQ-13566, SQ-13694 | S3 access to bucket failure when using custom endpoint | +--------------------+------------------------------------------------------------------------------------------------+ | SQ-13587 | Large number of worker connections failure | +--------------------+------------------------------------------------------------------------------------------------+ -| SQ-13467 | Snapshot issue causes metadata failure | +| SQ-13947 | Unicode character issue when using Tableau | +--------------------+------------------------------------------------------------------------------------------------+ -| SQ-11804 | Slow metadata optimization | +| SQ-14094 | Metadata server error stops workers and query queue | +--------------------+------------------------------------------------------------------------------------------------+ -| SQ-13225 | LoopJoin performance enhancement supports ``=``, ``>``, ``<``, and ``<=`` operators | +| SQ-14268 | Internal runtime memory issue | +--------------------+------------------------------------------------------------------------------------------------+ -| SQ-12799 | Catalog queries may not be terminated | +| SQ-14724 | Alias issue when executing ``DELETE`` statement | +--------------------+------------------------------------------------------------------------------------------------+ -| SQ-12721 | ``maxConnectionInactivitySeconds`` flag issue when executing Batch Shell Program ETLs | +| SQ-13387 | Simple query slow compilation time due to metadata size | +--------------------+------------------------------------------------------------------------------------------------+ Configuration Adjustments @@ -124,6 +140,7 @@ The ``VARCHAR`` data type is deprecated to improve the core functionalities of t Upgrading to v4.3 ----------------- + 1. Generate a back-up of the metadata by running the following command: .. code-block:: console @@ -158,3 +175,8 @@ There are two methods of granting back access to services: .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. +Version 4.3.1 Rollback To Version 4.0.1 +--------------------------------------- + + + From 006e7ff5ea1a561ae1605348c7c87a1c54cb74b1 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 24 Aug 2023 13:45:55 +0300 Subject: [PATCH 706/882] Update add_column.rst --- .../ddl_commands/add_column.rst | 24 ++++++++++++++----- 1 file changed, 18 insertions(+), 6 deletions(-) diff --git a/reference/sql/sql_statements/ddl_commands/add_column.rst b/reference/sql/sql_statements/ddl_commands/add_column.rst index bac71bd2c..da4587fc0 100644 --- a/reference/sql/sql_statements/ddl_commands/add_column.rst +++ b/reference/sql/sql_statements/ddl_commands/add_column.rst @@ -3,10 +3,12 @@ ********************** ADD COLUMN ********************** + The ``ADD COLUMN`` command is used to add columns to an existing table. Syntax ========== + The following is the correct syntax for adding a column to an existing table: .. code-block:: postgres @@ -19,7 +21,7 @@ The following is the correct syntax for adding a column to an existing table: schema_name ::= identifier - column_def :: = { column_name type_name [ default ] [ column_constraint ] } + column_def :: = { column_name type_name [ default ] [ column_constraint ] CHECK('CS "compression_type"') } column_name ::= identifier @@ -31,6 +33,7 @@ The following is the correct syntax for adding a column to an existing table: Parameters ============ + The following parameters can be used for adding a table: .. list-table:: @@ -50,6 +53,7 @@ The following parameters can be used for adding a table: Usage Notes =========== + The following usage notes apply when adding a column to an existing table: * When adding a new column to an existing table, a default (or null constraint) has to be specified, even if the table is empty. @@ -60,14 +64,10 @@ The following usage notes apply when adding a column to an existing table: Examples =========== -The **Examples** section includes the following examples: - -.. contents:: - :local: - :depth: 1 Adding a Simple Column with a Default Value ----------------------------------------- + This example shows how to add a simple column with a default value: .. code-block:: postgres @@ -77,6 +77,7 @@ This example shows how to add a simple column with a default value: Adding Several Columns in One Command ------------------------------------------- + This example shows how to add several columns in one command: .. code-block:: postgres @@ -84,7 +85,18 @@ This example shows how to add several columns in one command: ALTER TABLE cool_animals ADD COLUMN number_of_eyes INT DEFAULT 2 NOT NULL, ADD COLUMN date_seen DATE DEFAULT '2019-08-01'; + +Adding Compressed Column +-------------------------- + +.. code-block:: + + ALTER TABLE coo_animals ADD COLUMN animal_salary INT CHECK('CS "dict"'); + +Follow SQreamDB :ref:`compression guide<compression>` for compression types and methods. + Permissions ============= + The role must have the ``DDL`` permission at the database or table level. \ No newline at end of file From c9a71af384845e53ca8da1c1bbf0e36ce623e5de Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 27 Aug 2023 13:58:07 +0300 Subject: [PATCH 707/882] Update 2022.1.rst --- releases/2022.1.rst | 49 ++++++++++++++++++++++++++++----------------- 1 file changed, 31 insertions(+), 18 deletions(-) diff --git a/releases/2022.1.rst b/releases/2022.1.rst index be50ab11b..6659d455e 100644 --- a/releases/2022.1.rst +++ b/releases/2022.1.rst @@ -3,6 +3,7 @@ ************************** Release Notes 2022.1 ************************** + The 2022.1 release notes were released on 7/19/2022 and describe the following: .. contents:: @@ -10,8 +11,9 @@ The 2022.1 release notes were released on 7/19/2022 and describe the following: :depth: 1 Version Content ----------- -The 2022.1 Release Notes describes the following: +---------------- + +The 2022.1 Release Notes describe the following: * Enhanced security features. * New data manipulation command. @@ -23,7 +25,8 @@ Storage Version The storage version presently in effect is version 40. New Features ----------- +------------- + The 2022.1 Release Notes include the following new features: .. contents:: @@ -31,7 +34,8 @@ The 2022.1 Release Notes include the following new features: :depth: 1 Data Encryption -************ +***************** + SQream now supports data encryption mechanisms in accordance with **General Data Protection Regulation (GDPR)** standards. Using the data encryption feature may lead to a maximum of a 10% increase in performance degradation. @@ -39,19 +43,22 @@ Using the data encryption feature may lead to a maximum of a 10% increase in per For more information, see `Data Encryption <https://docs.sqream.com/en/v2022.1/feature_guides/data_encryption.html>`_. Update Feature -************ +**************** + SQream now supports the DML **Update** feature, which is used for modifying the value of certain columns in existing rows. For more information, see `UPDATE <https://docs.sqream.com/en/v2022.1/reference/sql/sql_statements/dml_commands/update.html#update>`_. Avro Ingestion -************ +*************** + SQream now supports ingesting data from Avro files. For more information, see `Inserting Data from Avro <https://docs.sqream.com/en/v2022.1/data_ingestion/avro.html>`_. Known Issues ---------- +------------- + The following table lists the known issues for Version 2022.1: +-------------+-------------------------------------------------------------------------------------------+ @@ -71,7 +78,8 @@ The following table lists the known issues for Version 2022.1: +-------------+-------------------------------------------------------------------------------------------+ Resolved Issues ---------- +---------------- + The following table lists the issues that were resolved in Version 2022.1: +-------------+-------------------------------------------------------------------------------------------+ @@ -81,32 +89,37 @@ The following table lists the issues that were resolved in Version 2022.1: +-------------+-------------------------------------------------------------------------------------------+ Operations and Configuration Changes --------- +---------------------------------------- + No relevant operations and configuration changes were made. Naming Changes -------- +----------------- + No relevant naming changes were made. Deprecated Features -------- +--------------------- + In SQream version 2022.1 the ``VARCHAR`` data type has been deprecated and replaced with ``TEXT``. SQream will maintain ``VARCHAR`` in all previous versions until completing the migration to ``TEXT``, at which point it will be deprecated in all earlier versions. SQream also provides an automated and secure tool to facilitate and simplify migration from ``VARCHAR`` to ``TEXT``. If you are using an earlier version of SQream, see the `Using Legacy String Literals <https://docs.sqream.com/en/v2022.1/configuration_guides/use_legacy_string_literals.html>`_ configuration flag. End of Support -------- +---------------- + The End of Support section is not relevant to Version 2022.1. Upgrading to v2022.1 -------- -1. Generate a back-up of the metadata by running the following command: +----------------------- + +1. Generate a backup of the metadata by running the following command: .. code-block:: console - $ select backup_metadata('out_path'); + $ select backup_metadata('out_path', 'single_file'); - .. tip:: SQream recommends storing the generated back-up locally in case needed. + .. tip:: SQream recommends storing the generated backup locally in case needed. SQream runs the Garbage Collector and creates a clean backup tarball package. @@ -114,11 +127,11 @@ Upgrading to v2022.1 :: -3. Extract the recently created back-up file. +3. Extract the recently created backup file. :: -4. Replace your current metadata with the metadata you stored in the back-up file. +4. Replace your current metadata with the metadata you stored in the backup file. :: From 6c30faf1825500246bb0cbc1543db8bb9edba21e Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 27 Aug 2023 15:26:50 +0300 Subject: [PATCH 708/882] Update avg.rst --- reference/sql/sql_functions/aggregate_functions/avg.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/sql/sql_functions/aggregate_functions/avg.rst b/reference/sql/sql_functions/aggregate_functions/avg.rst index 4768061c8..9176b33b3 100644 --- a/reference/sql/sql_functions/aggregate_functions/avg.rst +++ b/reference/sql/sql_functions/aggregate_functions/avg.rst @@ -36,13 +36,13 @@ Arguments Returns ============ -Return type is dependant on the argument. +The return type depends on the argument. * For ``TINYINT``, ``SMALLINT`` and ``INT``, the return type is ``INT``. * For ``BIGINT``, the return type is ``BIGINT``. -* For ``REAL``, the return type is ``REAL`` +* For ``REAL``, the return type is ``DOUBLE`` * For ``DOUBLE``, rhe return type is ``DOUBLE`` From 846ab9e41d9ebaeb65e4ed7a88f3261091685ff9 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 28 Aug 2023 08:43:19 +0300 Subject: [PATCH 709/882] Update rename_column.rst --- .../sql/sql_statements/ddl_commands/rename_column.rst | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/ddl_commands/rename_column.rst b/reference/sql/sql_statements/ddl_commands/rename_column.rst index 1022ce0f2..239d7c7f8 100644 --- a/reference/sql/sql_statements/ddl_commands/rename_column.rst +++ b/reference/sql/sql_statements/ddl_commands/rename_column.rst @@ -3,10 +3,12 @@ ********************** RENAME COLUMN ********************** + The ``RENAME COLUMN`` command can be used to rename columns in a table. Syntax ========== + The following is the correct syntax for the ``RENAME_COLUMN`` command: .. code-block:: postgres @@ -25,6 +27,7 @@ The following is the correct syntax for the ``RENAME_COLUMN`` command: Parameters ============ + The following table describes the `RENAME_COLUMN`` parameters: .. list-table:: @@ -44,6 +47,7 @@ The following table describes the `RENAME_COLUMN`` parameters: Examples =========== + The **Examples** section includes the following examples: .. contents:: @@ -52,6 +56,7 @@ The **Examples** section includes the following examples: Renaming a Column ----------------------------------------- + The following is an example of renaming a column: .. code-block:: postgres @@ -61,12 +66,14 @@ The following is an example of renaming a column: Renaming a Quoted Name -------------------------- + The following is an example of renaming a quoted name: .. code-block:: postgres - ALTER TABLE users RENAME COLUMN "mass" TO "Mass (Kilograms); + ALTER TABLE users RENAME COLUMN "mass" TO "Mass" (Kilograms); Permissions ============= + The role must have the ``DDL`` permission at the database or table level. \ No newline at end of file From 6324391efb8158ee246293253c43402238e9984e Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 28 Aug 2023 08:57:02 +0300 Subject: [PATCH 710/882] Update installing_prometheus_using_binary_packages.rst --- ...lling_prometheus_using_binary_packages.rst | 39 +++++++------------ 1 file changed, 14 insertions(+), 25 deletions(-) diff --git a/installation_guides/installing_prometheus_using_binary_packages.rst b/installation_guides/installing_prometheus_using_binary_packages.rst index 5031ec181..bd46d2fcc 100644 --- a/installation_guides/installing_prometheus_using_binary_packages.rst +++ b/installation_guides/installing_prometheus_using_binary_packages.rst @@ -2,24 +2,19 @@ .. _install_prometheus_binary_top: -*********************** +********************************************** Installing Prometheus Using Binary Packages -*********************** +********************************************** - - -The **Installing Prometheus Using Binary Packages** guide includes the following sections: +Prometheus is an application used for event monitoring and alerting. .. contents:: :local: :depth: 1 -Overview -^^^^^^^^^^^^^^^ -Prometheus is an application used for event monitoring and alerting. - Installing Prometheus -^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^ + You must install Prometheus before installing the Dashboard Data Collector. **To install Prometheus:** @@ -102,12 +97,13 @@ You must install Prometheus before installing the Dashboard Data Collector. $ sudo chown -R prometheus:prometheus /etc/prometheus/consoles $ sudo chown -R prometheus:prometheus /etc/prometheus/console_libraries -For more information on installing the Dashboard Data Collector, see `Installing the Dashboard Data Collector <https://docs.sqream.com/en/v2022.1/installation_guides/installing_dashboard_data_collector.html>`_. +For more information on installing the Dashboard Data Collector, see :ref:`Installing the Dashboard Data Collector<installing_dashboard_data_collector>`. Back to :ref:`Installing Prometheus Using Binary Packages<install_prometheus_binary_top>` Configuring Your Prometheus Settings -^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + After installing Prometheus you must configure your Prometheus settings. You must perform all Prometheus configurations in the **/etc/prometheus/prometheus.yml** file. **To configure your Prometheus settings:** @@ -163,7 +159,8 @@ After installing Prometheus you must configure your Prometheus settings. You mus Back to :ref:`Installing Prometheus Using Binary Packages<install_prometheus_binary_top>` Configuring Your Prometheus Service File -^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + After configuring your Prometheus settings you must configure your Prometheus service file. **To configure your Prometheus service file**: @@ -219,8 +216,9 @@ After configuring your Prometheus settings you must configure your Prometheus se Back to :ref:`Installing Prometheus Using Binary Packages<install_prometheus_binary_top>` Accessing the Prometheus User Interface -^^^^^^^^^^^^^^^ -After configuring your prometheus service file, you can access the Prometheus user interface. +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +After configuring your Prometheus service file, you can access the Prometheus user interface. You can access the Prometheus user interface by running the following command: @@ -228,14 +226,5 @@ You can access the Prometheus user interface by running the following command: $ http://<prometheus-ip>:9090/graph -The Prometheus user interface is displayed. - -From the **Query** tab you can query metrics, as shown below: - -.. list-table:: - :widths: auto - :header-rows: 0 - - * - .. image:: /_static/images/3c9c4e8b-49bd-44a8-9829-81d1772ed962.gif +Once the Prometheus user interface is displayed, go to the **Query** tab and query metrics. -Back to :ref:`Installing Prometheus Using Binary Packages<install_prometheus_binary_top>` \ No newline at end of file From 0402b5f79285a871a260a704d58f3bda38ebba5c Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 28 Aug 2023 09:05:50 +0300 Subject: [PATCH 711/882] Update window_functions.rst --- reference/sql/sql_syntax/window_functions.rst | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/reference/sql/sql_syntax/window_functions.rst b/reference/sql/sql_syntax/window_functions.rst index 7718e8b3a..b236c73b2 100644 --- a/reference/sql/sql_syntax/window_functions.rst +++ b/reference/sql/sql_syntax/window_functions.rst @@ -152,6 +152,7 @@ Window frame functions allows a user to perform rolling operations, such as calc ``PARTITION BY`` ------------------ + The ``PARTITION BY`` clause groups the rows of the query into partitions, which are processed separately by the window function. ``PARTITION BY`` works similarly to a query-level ``GROUP BY`` clause, but expressions are always just expressions and cannot be output-column names or numbers. @@ -168,10 +169,6 @@ Without ``ORDER BY``, rows are processed in an unspecified order. Frames ------- - - -.. note:: Frames and frame exclusions have been tested extensively, but are a complex feature. They are released as a preview in v2020.1 pending longer-term testing. - The ``frame_clause`` specifies the set of rows constituting the window frame, which is a subset of the current partition, for those window functions that act on the frame instead of the whole partition. The set of rows in the frame can vary depending on which row is the current row. The frame can be specified in ``RANGE`` or ``ROWS`` mode; in each case, it runs from the ``frame_start`` to the ``frame_end``. If ``frame_end`` is omitted, the end defaults to ``CURRENT ROW``. @@ -207,10 +204,9 @@ Frame Exclusion The ``frame_exclusion`` option allows rows around the current row to be excluded from the frame, even if they would be included according to the frame start and frame end options. ``EXCLUDE CURRENT ROW`` excludes the current row from the frame. ``EXCLUDE GROUP`` excludes the current row and its ordering peers from the frame. ``EXCLUDE TIES`` excludes any peers of the current row from the frame, but not the current row itself. ``EXCLUDE NO OTHERS`` simply specifies explicitly the default behavior of not excluding the current row or its peers. Limitations -================== -Window functions do not support the Numeric data type. - +================= +Window functions do not support the Numeric data type. Examples ========== From 0d7b723ae0d66d4e2ee3ff8801bd83111af75eec Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 28 Aug 2023 10:15:03 +0300 Subject: [PATCH 712/882] Update internals_architecture.rst --- architecture/internals_architecture.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/architecture/internals_architecture.rst b/architecture/internals_architecture.rst index 571b5f9a0..86e189f7a 100644 --- a/architecture/internals_architecture.rst +++ b/architecture/internals_architecture.rst @@ -1,4 +1,4 @@ -.. _internals_architecture: +.. _internals_architecture: *************************** Internals and architecture From 3005e332f41cb6bcde49965685b0f12cf1a325f7 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 28 Aug 2023 10:49:06 +0300 Subject: [PATCH 713/882] Sizing --- .../concurrency_and_scaling_in_sqream.rst | 140 ++++++++++++++++++ .../filesystem_and_filesystem_usage.rst | 34 ++--- architecture/index.rst | 19 ++- architecture/internals_architecture.rst | 104 +++++++------ 4 files changed, 217 insertions(+), 80 deletions(-) create mode 100644 architecture/concurrency_and_scaling_in_sqream.rst diff --git a/architecture/concurrency_and_scaling_in_sqream.rst b/architecture/concurrency_and_scaling_in_sqream.rst new file mode 100644 index 000000000..3671474b2 --- /dev/null +++ b/architecture/concurrency_and_scaling_in_sqream.rst @@ -0,0 +1,140 @@ +.. _concurrency_and_scaling_in_sqream: + +****** +Sizing +****** + +Concurrency and Scaling in SQreamDB +=================================== + +A SQreamDB cluster can execute one statement per worker process while also supporting the concurrent operation of multiple workers. Utility functions with minimal resource requirements, such as :ref:`show_server_status`, will be executed regardless of the workload. + +Minimum Resource Required Per Worker: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Component + - CPU Cores + - RAM (GB) + - Local Storage (GB) + * - Worker + - 8 + - 128 + - 10 + * - Metadata Server + - 16 cores per 100 Workers + - 20 GB RAM for every 1 trillion rows + - 10 + * - SqreamDB Acceleration Studio + - 16 + - 16 + - 50 + * - Server Picker + - 1 + - 2 + - + + +Lightweight queries, such as :ref:`copy_to` and :ref:`Clean-Up<delete_guide>` require 64 RAM (GB). + +Maximum Workers Per GPU: + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - GPU + - Workers + * - NVIDIA Tesla T4 (16GB) + - 1 + * - NVIDIA Tesla V100 (32GB) + - 2 + * - NVIDIA Tesla A100 (40GB) + - 3 + * - NVIDIA Tesla A100 (80GB) + - 6 + * - NVIDIA Tesla H100 (80GB) + - 6 + + + +.. tip:: Your GPU is not on the list? Visit `SQreamDB Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_ for additional information. + + +Scaling When Data Sizes Grow +---------------------------- + +For many statements, SQreamDB scales linearly when adding more storage and querying on large data sets. It uses optimized 'brute force' algorithms and implementations, which don't suffer from sudden performance cliffs at larger data sizes. + +Scaling When Queries Are Queuing +-------------------------------- + +SQreamDB scales well by adding more workers, GPUs, and nodes to support more concurrent statements. + +What To Do When Queries Are Slow +-------------------------------- + +Adding more workers or GPUs does not boost the performance of a single statement or query. + +To boost the performance of a single statement, start by examining the :ref:`best practices<sql_best_practices>` and ensure the guidelines are followed. + +Adding additional RAM to nodes, using more GPU memory, and faster CPUs or storage can also sometimes help. + +Spooling Configuration +====================== + +:math:`limitQueryMemoryGB=\frac{\text{Total RAM - Internal Operation - metadata Server - Server picker}}{\text{Number of Workers}}` + +:math:`spoolMemoryGB=limitQueryMemoryGB - 50GB` + +SQreamDB recommends setting the ``spoolMemoryGB`` flag to 90% of the ``limitQueryMemoryGB`` flag. The ``limitQueryMemoryGB`` flag is the total memory you’ve allocated for processing queries. In addition, the ``limitQueryMemoryGB`` defines how much total system memory is used by each worker. Note that ``spoolMemoryGB`` must bet set to less than the ``limitQueryMemoryGB``. + +Example +------- + +Setting Spool Memory +~~~~~~~~~~~~~~~~~~~~ + +The following examples are for 2T of RAM and 9 workers running on 3 A100(40) GPUs: + +Configuring the ``limitQueryMemoryGB`` using the Worker configuration file: + +.. code-block:: console + + { + “cluster”: “/home/test_user/sqream_testing_temp/sqreamdb”, + “gpu”: 0, + “licensePath”: “home/test_user/SQream/tests/license.enc”, + “machineIP”: “127.0.0.1”, + “metadataServerIp”: “127.0.0.1”, + “metadataServerPort”: “3105, + “port”: 5000, + “useConfigIP”” true, + “limitQueryMemoryGB" : 201, + } + +Configuring the ``spoolMemoryGB`` using the legacy configuration file: + +.. code-block:: console + + { + "diskSpaceMinFreePercent": 10, + "enableLogDebug": false, + "insertCompressors": 8, + "insertParsers": 8, + "isUnavailableNode": false, + "logBlackList": "webui", + "logDebugLevel": 6, + "nodeInfoLoggingSec": 60, + "useClientLog": true, + "useMetadataServer": true, + "spoolMemoryGB": 151, + "waitForClientSeconds": 18000, + "enablePythonUdfs": true + } + +.. rubric:: Need help? + +Visit `SQreamDB Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_ for additional information. diff --git a/architecture/filesystem_and_filesystem_usage.rst b/architecture/filesystem_and_filesystem_usage.rst index 634097e23..1bd670efb 100644 --- a/architecture/filesystem_and_filesystem_usage.rst +++ b/architecture/filesystem_and_filesystem_usage.rst @@ -1,29 +1,29 @@ .. _filesystem_and_filesystem_usage: -******************************* -Filesystem and usage -******************************* +******************** +Filesystem and Usage +******************** -SQream DB writes and reads data from disk. +SQreamDB writes and reads data from disk. -The SQream DB storage directory, sometimes refered to as a **storage cluster** is a collection of database objects, metadata database, and logs. +The SQreamDB storage directory, sometimes referred to as a **storage cluster** is a collection of database objects, metadata database, and logs. -Each SQream DB worker and the metadata server must have access to the storage cluster in order to function properly. +Each SQreamDB worker and the metadata server must have access to the storage cluster in order to function properly. .. _storage_cluster: Directory organization -============================ +====================== .. figure:: /_static/images/storage_organization.png -The **cluster root** is the directory in which all data for SQream DB is stored. +The **cluster root** is the directory in which all data for SQreamDB is stored. -.. contents:: SQream DB storage cluster directories +.. contents:: SQreamDB storage cluster directories :local: ``databases`` ----------------- +------------- The databases directory houses all of the actual data in tables and columns. @@ -64,26 +64,26 @@ Each column directory will contain extents, which are collections of chunks. .. figure:: /_static/images/chunks_and_extents.png ``metadata`` or ``rocksdb`` ----------------------------- +--------------------------- -SQream DB's metadata is an embedded key-value store, based on RocksDB. RocksDB helps SQream DB ensure efficient storage for keys, handle atomic writes, snapshots, durability, and automatic recovery. +SQreamDB's metadata is an embedded key-value store, based on RocksDB. RocksDB helps SQreamDB ensure efficient storage for keys, handle atomic writes, snapshots, durability, and automatic recovery. The metadata is where all database objects are stored, including roles, permissions, database and table structures, chunk mappings, and more. ``temp`` ----------------- +-------- -The ``temp`` directory is where SQream DB writes temporary data. +The ``temp`` directory is where SQreamDB writes temporary data. -The directory to which SQream DB writes temporary data can be changed to any other directory on the filesystem. SQream recommends remapping this directory to a fast local storage to get better performance when executing intensive larger-than-RAM operations like sorting. SQream recommends an SSD or NVMe drive, in mirrored RAID 1 configuration. +The directory to which SQreamDB writes temporary data can be changed to any other directory on the filesystem. SQreamDB recommends remapping this directory to a fast local storage to get better performance when executing intensive larger-than-RAM operations like sorting. SQreamDB recommends an SSD or NVMe drive, in mirrored RAID 1 configuration. If desired, the ``temp`` folder can be redirected to a local disk for improved performance, by setting the ``tempPath`` setting in the :ref:`configuration<configuration>` file. ``logs`` ----------------- +-------- -The logs directory contains logs produced by SQream DB. +The logs directory contains logs produced by SQreamDB. See more about the logs in the :ref:`logging` guide. diff --git a/architecture/index.rst b/architecture/index.rst index 5e4d6c867..83111b8cd 100644 --- a/architecture/index.rst +++ b/architecture/index.rst @@ -1,21 +1,20 @@ .. _architecture: -*********************** +******************* System Architecture -*********************** +******************* -This topic includes guides that walk an end-user, database administrator, or system architect through the main ideas behind SQream DB. +The :ref:`internals_architecture` and :ref:`filesystem_and_filesystem_usage` guides are walk-throughs for end-users, database administrators, and system architects who wish to get familiarized with the SQreamDB system and its unique capabilities. + +.. figure:: /_static/images/sqream_db_table_crop.png + :scale: 60 % -While SQream DB has many similarities to other database management systems, it has some unique and additional capabilities. -Explore the guides below for information about SQream DB's architecture. .. toctree:: - :maxdepth: 2 - :caption: In this section: - :glob: - :titlesonly: + :hidden: internals_architecture - xxprocesses_and_network_architecture filesystem_and_filesystem_usage + concurrency_and_scaling_in_sqream + diff --git a/architecture/internals_architecture.rst b/architecture/internals_architecture.rst index 86e189f7a..97075a0af 100644 --- a/architecture/internals_architecture.rst +++ b/architecture/internals_architecture.rst @@ -1,95 +1,93 @@ -.. _internals_architecture: +.. _internals_architecture: -*************************** -Internals and architecture -*************************** +************************** +Internals and Architecture +************************** -SQream DB internals -============================== - -Here is a high level architecture diagram of SQream DB's internals. +Get to know the SQreamDB key functions and system architecture components and the best practices and customization possibilities. .. figure:: /_static/images/sqream_db_internals.png - :alt: SQream DB internals + :align: left + :width: 75% + :alt: SQreamDB internals -Statement compiler ------------------------- +Key Functions and Components +============================ -The statement compiler is written in Haskell. This takes SQL text and produces an optimised statement plan. +Statement Compiler +------------------ -Concurrency and concurrency control ----------------------------------------- +The Statement Compiler, developed using Haskell, accepts SQL text and generates optimized statement plans. -The execution engine in SQream DB is built around thread workers with message passing. It uses threads to overlap different kinds of operations (including IO and GPU operations with CPU operations), and to accelerate CPU intensive operations. +Concurrency and Admission Control +--------------------------------- -Transactions --------------------- +The SQreamDB execution engine employs thread workers and message passing for its foundation. This threading approach enables the concurrent execution of diverse operations, seamlessly integrating IO and GPU tasks with CPU operations while boosting the performance of CPU-intensive tasks. -SQream DB has serializable transactions, with these features: +Learn more about :ref:`concurrency_and_scaling_in_sqream`. -* Serializable, with any kind of statement +Storage Layer +------------- -* Run multiple :ref:`SELECT queries<select>` concurrently with anything +The storage is split into the metadata layer and an append-only / garbage collected bulk data layer. -* Run multiple inserts to the same table at the same time +Metadata Layer +^^^^^^^^^^^^^^ -* Cannot run multiple statements in a single transaction +The metadata layer uses RocksDB, and uses RocksDB's snapshot and write atomic features as part of the transaction system. -* Other operations such as :ref:`delete`, :ref:`truncate`, and DDL use :ref:`coarse-grained exclusive locking<concurrency_and_locks>`. +The metadata layer, together with the append-only bulk data layer help ensure consistency. -Storage ----------- +Bulk Data Layer +^^^^^^^^^^^^^^^ -The storage is split into the :ref:`metadata layer<metadata_system>` and an append-only/ garbage collected bulk data layer. +The bulk data layer is comprised of extents, which are optimized for IO performance as much as possible. Inside the extents, are chunks, which are optimized for processing in the CPU and GPU. Compression is used in the extents and chunks. -Metadata layer -^^^^^^^^^^^^^^^^^^^^^^ +When you run small inserts, you will get less optimized chunks and extents, but the system is designed to both be able to still run efficiently on this, and to be able to reorganize them transactionally in the background, without blocking DML operations. By writing small chunks in small inserts, then reorganizing later, it supports both fast medium sized insert transactions and fast querying. -The metadata layer uses RocksDB, and uses RocksDB's snapshot and write atomic features as part of the transaction system. +Columnar Storage +^^^^^^^^^^^^^^^^ -The metadata layer, together with the append-only bulk data layer help ensure consistency. +Like many other analytical database management systems, SQreamDB uses a column store for tables. + +Column stores offer better I/O and performance with analytic workloads. Columns also compress much better, and lend themselves well to bulk data. -Bulk data layer -^^^^^^^^^^^^^^^^^^^^^^^^ +Transactions +------------ -The bulk data layer is comprised of extents, which are optimised for IO performance as much as possible. Inside the extents, are chunks, which are optimised for processing in the CPU and GPU. Compression is used in the extents and chunks. +SQreamDB has serializable transactions, with these features: -When you run small inserts, you will get less optimised chunks and extents, but the system is designed to both be able to still run efficiently on this, and to be able to reorganise them transactionally in the background, without blocking DML operations. By writing small chunks in small inserts, then reorganising later, it supports both fast medium sized insert transactions and fast querying. +* Serializable, with any kind of statement -Building blocks ----------------------- +* Run multiple :ref:`SELECT queries<select>` concurrently with anything -The heavy lifting in SQream DB is done by single purpose C++/CUDA building blocks. +* Run multiple inserts to the same table at the same time -These are purposely designed to not be smart - they have to be instructed exactly what to do. +* Cannot run multiple statements in a single transaction -Most of the intelligence in piecing things together is in the statement compiler. +* Other operations such as :ref:`delete`, :ref:`truncate`, and DDL use :ref:`coarse-grained exclusive locking<concurrency_and_locks>`. -Columnar -============= -Like many other analytical database management systems, SQream DB uses a column store for tables. +Building Blocks +--------------- -Column stores offer better I/O and performance with analytic workloads. Columns also compress much better, and lend themselves well to bulk data. +The heavy lifting in SQreamDB is done by single purpose C++/CUDA building blocks. -GPU usage -============= +These are purposely designed to not be smart - they have to be instructed exactly what to do. -SQream DB uses GPUs for accelerating database operations. This acceleration brings additional benefit to columnar data processing. +Most of the intelligence in piecing things together is in the statement compiler. -SQream DB's GPU acceleration is integral to database operations. It is not an additional feature, but rather core to most data operations, e.g. ``GROUP BY``, scalar functions, ``JOIN``, ``ORDER BY``, and more. -Using a GPU is an extended form of SIMD (Single-instruction, multiple data) intended for high throughput operations. When GPU acceleraiton is used, SQream DB uses special building blocks to take advantage of the high degree of parallelism of the GPU. This means that GPU operations use a single instruction that runs on multiple values. +GPU Usage +========= -.. describe the concepts behind the storage, transaction, statement -.. engine +SQreamDB uses GPUs for accelerating database operations. This acceleration brings additional benefit to columnar data processing. +SQreamDB's GPU acceleration is integral to database operations. It is not an additional feature, but rather core to most data operations, e.g. ``GROUP BY``, scalar functions, ``JOIN``, ``ORDER BY``, and more. -.. some of this might be better in another document, if you're reading to -.. understand how sqream performs, this is not the internal architecture -.. but something more directly important to a customer/user +Using a GPU is an extended form of SIMD (Single-instruction, multiple data) intended for high throughput operations. When GPU acceleraiton is used, SQreamDB uses special building blocks to take advantage of the high degree of parallelism of the GPU. This means that GPU operations use a single instruction that runs on multiple values. From 7bd46b6306bb1ef80bf8ba40ef0fe34286f399aa Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 28 Aug 2023 10:50:08 +0300 Subject: [PATCH 714/882] Create sqream_db_table_crop.png --- _static/images/sqream_db_table_crop.png | Bin 0 -> 139122 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 _static/images/sqream_db_table_crop.png diff --git a/_static/images/sqream_db_table_crop.png b/_static/images/sqream_db_table_crop.png new file mode 100644 index 0000000000000000000000000000000000000000..dcfe3bf466cef7035e58054a4244b038736c5c48 GIT binary patch literal 139122 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 Kv07_F(tiOru>)NI literal 0 HcmV?d00001 From 21c8627faa0185b9d23b3332060caf404b1f9228 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 28 Aug 2023 13:07:10 +0300 Subject: [PATCH 715/882] Update concurrency_and_scaling_in_sqream.rst --- architecture/concurrency_and_scaling_in_sqream.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/architecture/concurrency_and_scaling_in_sqream.rst b/architecture/concurrency_and_scaling_in_sqream.rst index 3671474b2..990f49075 100644 --- a/architecture/concurrency_and_scaling_in_sqream.rst +++ b/architecture/concurrency_and_scaling_in_sqream.rst @@ -108,10 +108,10 @@ Configuring the ``limitQueryMemoryGB`` using the Worker configuration file: “gpu”: 0, “licensePath”: “home/test_user/SQream/tests/license.enc”, “machineIP”: “127.0.0.1”, - “metadataServerIp”: “127.0.0.1”, - “metadataServerPort”: “3105, + “metadataServerIp”: 127.0.0.1, + “metadataServerPort”: 3105, “port”: 5000, - “useConfigIP”” true, + “useConfigIP”: true, “limitQueryMemoryGB" : 201, } From c94468b13bea7d796a737193de1b5ecf9eac5f6a Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 28 Aug 2023 13:28:17 +0300 Subject: [PATCH 716/882] Update drop_database.rst --- .../sql_statements/ddl_commands/drop_database.rst | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/reference/sql/sql_statements/ddl_commands/drop_database.rst b/reference/sql/sql_statements/ddl_commands/drop_database.rst index f45b0a5c4..76b75c5b3 100644 --- a/reference/sql/sql_statements/ddl_commands/drop_database.rst +++ b/reference/sql/sql_statements/ddl_commands/drop_database.rst @@ -17,7 +17,7 @@ Syntax .. code-block:: postgres drop_database_statement ::= - DROP DATABASE database_name + DROP DATABASE [ IF EXISTS ] database_name ; database_name ::= identifier @@ -35,7 +35,9 @@ Parameters - Description * - ``database_name`` - The name of the database to drop. This can not be the current database in use. - + * - ``IF EXISTS`` + - Drop the database if it exists. No error if the database does not exist. + Examples =========== @@ -60,4 +62,10 @@ The current database in use can't be dropped. Switch to another database first. raviga=> \c master master=> DROP DATABASE raviga; - executed \ No newline at end of file + executed + +.. code-block:: sql + + DROP DATABASE IF EXISTS green_database; + + Status: Ended successfully \ No newline at end of file From cfdd38eec8633e01eb7b320836849d23b6d48657 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 28 Aug 2023 15:22:15 +0300 Subject: [PATCH 717/882] Update create_table.rst --- .../ddl_commands/create_table.rst | 38 +++++++++++++------ 1 file changed, 27 insertions(+), 11 deletions(-) diff --git a/reference/sql/sql_statements/ddl_commands/create_table.rst b/reference/sql/sql_statements/ddl_commands/create_table.rst index 5ca988f19..76b3e3086 100644 --- a/reference/sql/sql_statements/ddl_commands/create_table.rst +++ b/reference/sql/sql_statements/ddl_commands/create_table.rst @@ -14,6 +14,7 @@ The ``CREATE TABLE`` statement is used to create a new table in an existing data Syntax ========== + The following is the correct syntax for creating a table: .. code-block:: postgres @@ -42,6 +43,7 @@ The following is the correct syntax for creating a table: Parameters ============ + The following parameters can be used when creating a table: .. list-table:: @@ -60,9 +62,9 @@ The following parameters can be used when creating a table: - A comma separated list of column definitions. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally. * - ``CLUSTER BY column_name1 ...`` - - A commma separated list of clustering column keys. + A comma separated list of clustering column keys. - See :ref:`flexible_data_clustering` for more information. + See :ref:`cluster_by` for more information. * - ``LIKE`` - Duplicates the column structure of an existing table. @@ -70,7 +72,7 @@ The following parameters can be used when creating a table: .. _default_values: Default Value Constraints -=============== +=========================== The ``DEFAULT`` value constraint specifies a value to use if one is not defined in an :ref:`insert` or :ref:`copy_from` statement. @@ -80,6 +82,7 @@ The default value may be a literal or NULL. Syntax --------- + The following is the correct syntax for using the **DEFAULT** value constraints: @@ -105,6 +108,7 @@ The following is the correct syntax for using the **DEFAULT** value constraints: Identity ----------------------- + The ``Identity`` (or sequence) columns can be used for generating key values. Some databases call this ``AUTOINCREMENT``. The **identity** property on a column guarantees that each new row inserted is generated based on the current seed & increment. @@ -127,6 +131,7 @@ The following table describes the identity parameters: Examples =========== + This section includes the following examples: .. contents:: @@ -134,7 +139,8 @@ This section includes the following examples: :depth: 1 Creating a Standard Table ------------------ +-------------------------- + The following is an example of the syntax used to create a standard table: .. code-block:: postgres @@ -147,7 +153,8 @@ The following is an example of the syntax used to create a standard table: ); Creating a Table with Default Value Constraints for Some Columns ---------------------------------------------------- +-------------------------------------------------------------------- + The following is an example of the syntax used to create a table with default value constraints for some columns: @@ -164,6 +171,7 @@ The following is an example of the syntax used to create a table with default va Creating a Table with an Identity Column --------------------------------------------------- + The following is an example of the syntax used to create a table with an identity (auto-increment) column: @@ -179,6 +187,7 @@ The following is an example of the syntax used to create a table with an identit Creating a Table from a SELECT Query ----------------------------------------- + The following is an example of the syntax used to create a table from a SELECT query: .. code-block:: postgres @@ -189,6 +198,7 @@ For more information on creating a new table from the results of a SELECT query, Creating a Table with a Clustering Key ---------------------------------------------- + When data in a table is stored in a sorted order, the sorted columns are considered clustered. Good clustering can have a significant positive impact on performance. In the following example, we expect the ``start_date`` column to be naturally clustered, as new users sign up and get a newer start date. @@ -205,13 +215,14 @@ The following is an example of the syntax used to create a table with a clusteri country TEXT(30) DEFAULT 'Unknown' NOT NULL ) CLUSTER BY start_date; -For more information on data clustering, see :ref:`data_clustering`. +For more information on data clustering, see :ref:`cluster_by`. Duplicating the Column Structure of an Existing Table ------------------ +------------------------------------------------------------ Syntax ************ + The following is the correct syntax for duplicating the column structure of an existing table: .. code-block:: postgres @@ -226,6 +237,7 @@ The following is the correct syntax for duplicating the column structure of an e Examples ************** + This section includes the following examples of duplicating the column structure of an existing table using the ``LIKE`` clause: .. contents:: @@ -233,15 +245,17 @@ This section includes the following examples of duplicating the column structure :depth: 3 Creating a Table Using an Explicit Column List -~~~~~~~~~~~~ -The following is an example of creating a table using an explict column list: +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The following is an example of creating a table using an explicit column list: .. code-block:: postgres CREATE TABLE t1(x int default 0 not null, y text(10) null); Creating a Second Table Based on the Structure of Another Table -~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + Either of the following examples can be used to create a second table based on the structure of another table. **Example 1** @@ -259,7 +273,8 @@ Either of the following examples can be used to create a second table based on t The generated output of both of the statements above is identical. Creating a Table based on Foreign Tables and Views -~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + The following is an example of creating a table based on foreign tables and views: @@ -290,4 +305,5 @@ The following table describes which properties are copied from the target table Permissions ============= + The role must have the ``CREATE`` permission at the schema level. From a0afec000353ede24b5cf90dad46e83997a06bec Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 28 Aug 2023 15:27:19 +0300 Subject: [PATCH 718/882] connectors and platforms --- connecting_to_sqream/client_drivers/index.rst | 12 ++++++------ connecting_to_sqream/client_platforms/index.rst | 1 + 2 files changed, 7 insertions(+), 6 deletions(-) diff --git a/connecting_to_sqream/client_drivers/index.rst b/connecting_to_sqream/client_drivers/index.rst index a76f64b07..86be7e95d 100644 --- a/connecting_to_sqream/client_drivers/index.rst +++ b/connecting_to_sqream/client_drivers/index.rst @@ -29,9 +29,9 @@ The following are applicable to all operating systems: .. _spark: -* **Spark**: +* ** Apache Spark**: - * `Spark Connector <https://sq-ftp-public.s3.amazonaws.com/Spark-Sqream-Connector-5.0.0.jar>`_ + * `Apache Spark Connector <https://sq-ftp-public.s3.amazonaws.com/Spark-Sqream-Connector-5.0.0.jar>`_ * :ref:`spark` .. _python: @@ -52,15 +52,15 @@ The following are applicable to all operating systems: * **Tableau**: - * `Tableau connector <https://sq-ftp-public.s3.amazonaws.com/SQreamDB.taco>`_ - SQream (.taco) + * `Tableau Connector <https://sq-ftp-public.s3.amazonaws.com/SQreamDB.taco>`_ - SQream (.taco) * :ref:`tableau` .. _powerbi_connector: -* **Power BI**: +* **Power BI Desktop**: - * `Power BI PowerQuery Connector <https://sq-ftp-public.s3.amazonaws.com/SqlODBC__v1.0.mez>`_ - SQream (.mez) + * `Power BI Power Query Connector <https://sq-ftp-public.s3.amazonaws.com/SqlODBC__v1.0.mez>`_ - SQream (.mez) * :ref:`power_bi` @@ -84,7 +84,7 @@ The following are applicable to Windows: :caption: Client Driver Documentation: :titlesonly: - trino/index + jdbc/index python/index nodejs/index diff --git a/connecting_to_sqream/client_platforms/index.rst b/connecting_to_sqream/client_platforms/index.rst index 6cd49667e..d1a336e86 100644 --- a/connecting_to_sqream/client_platforms/index.rst +++ b/connecting_to_sqream/client_platforms/index.rst @@ -3,6 +3,7 @@ ************************************ Client Platforms ************************************ + These topics explain how to install and connect a variety of third party tools. Browse the articles below, in the sidebar, or use the search to find the information you need. From 75dede3a96e266c46a43610074064ad5746ad533 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 28 Aug 2023 15:35:28 +0300 Subject: [PATCH 719/882] Update ceiling.rst --- .../sql/sql_functions/scalar_functions/numeric/ceiling.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_functions/scalar_functions/numeric/ceiling.rst b/reference/sql/sql_functions/scalar_functions/numeric/ceiling.rst index 9d91611a6..8c48420fd 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/ceiling.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/ceiling.rst @@ -32,7 +32,7 @@ Arguments Returns ============ -When using the ``CEILING`` and ``CEIL`` floating point number scalar functions, ``real`` arguments are automatically cast to ``double`` precision. +``Real`` arguments are automatically cast to ``double`` precision. Notes From 392d4f80422fbe8391d02e87ee10747044f4c199 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 29 Aug 2023 09:48:52 +0300 Subject: [PATCH 720/882] Update add_column.rst --- reference/sql/sql_statements/ddl_commands/add_column.rst | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) diff --git a/reference/sql/sql_statements/ddl_commands/add_column.rst b/reference/sql/sql_statements/ddl_commands/add_column.rst index da4587fc0..0cf7143fd 100644 --- a/reference/sql/sql_statements/ddl_commands/add_column.rst +++ b/reference/sql/sql_statements/ddl_commands/add_column.rst @@ -54,13 +54,7 @@ The following parameters can be used for adding a table: Usage Notes =========== -The following usage notes apply when adding a column to an existing table: - - * When adding a new column to an existing table, a default (or null constraint) has to be specified, even if the table is empty. - - :: - - * New columns you add to the table cannot be TEXT or contain an IDENTITY. +When adding an empty column, the default values for that column will be set to ``NULL``. Examples =========== From 91460900f2e4d27d23ea254ed1f06e3e41f3cb5c Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 29 Aug 2023 11:53:49 +0300 Subject: [PATCH 721/882] Update current_method_configuring_your_parameter_values.rst --- .../current_method_configuring_your_parameter_values.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/configuration_guides/current_method_configuring_your_parameter_values.rst b/configuration_guides/current_method_configuring_your_parameter_values.rst index 027a1a710..91c79e6d4 100644 --- a/configuration_guides/current_method_configuring_your_parameter_values.rst +++ b/configuration_guides/current_method_configuring_your_parameter_values.rst @@ -23,11 +23,11 @@ Parameter Values +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ | ``SELECT show_conf_extended();`` | Used to print all information output by the show_conf UF command, in addition to description, usage, data type, default value and range. | ``rechunkThreshold,90,true,RND,regular`` | +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ -| ``show_md_flag UF`` | Used to show a specific flag/all flags stored in the metadata file. |* Example 1: ``* master=> ALTER SYSTEM SET heartbeatTimeout=111;`` | +| ``show_md_flag UF`` | Used to show a specific flag/all flags stored in the metadata. |* Example 1: ``* master=> ALTER SYSTEM SET heartbeatTimeout=111;`` | | | |* Example 2: ``* master=> select show_md_flag(‘all’); heartbeatTimeout,111`` | | | |* Example 3: ``* master=> select show_md_flag(‘heartbeatTimeout’); heartbeatTimeout,111`` | +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ -| ``ALTER SYSTEM SET <flag-name>`` | Used for storing or modifying flag attributes in the metadata file. | ``ALTER SYSTEM SET <heartbeatInterval=12;>`` | +| ``ALTER SYSTEM SET <flag-name>`` | Used for storing or modifying flag attributes in the metadata. | ``ALTER SYSTEM SET <heartbeatInterval=12;>`` | +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ -| ``ALTER SYSTEM RESET <flag-name / ALL>`` | Used to remove a flag or all flag attributes from the metadata file. | ``ALTER SYSTEM RESET <heartbeatInterval ALTER SYSTEM RESET ALL>`` | +| ``ALTER SYSTEM RESET <flag-name / ALL>`` | Used to remove a flag or all flag attributes from the metadata. | ``ALTER SYSTEM RESET <heartbeatInterval ALTER SYSTEM RESET ALL>`` | +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+ \ No newline at end of file From 17ae2109797111c99ea8e44af0454328614b1a6d Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 29 Aug 2023 15:32:58 +0300 Subject: [PATCH 722/882] Update 4.3.rst --- releases/4.3.rst | 4 ---- 1 file changed, 4 deletions(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index 07bafb3c4..baa9790d3 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -175,8 +175,4 @@ There are two methods of granting back access to services: .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. -Version 4.3.1 Rollback To Version 4.0.1 ---------------------------------------- - - From d78c4382290aadc21791b91620a3438df8946130 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 30 Aug 2023 09:04:41 +0300 Subject: [PATCH 723/882] Update internals_architecture.rst --- architecture/internals_architecture.rst | 45 +++++++++---------------- 1 file changed, 15 insertions(+), 30 deletions(-) diff --git a/architecture/internals_architecture.rst b/architecture/internals_architecture.rst index 97075a0af..0d319678f 100644 --- a/architecture/internals_architecture.rst +++ b/architecture/internals_architecture.rst @@ -19,38 +19,37 @@ Statement Compiler The Statement Compiler, developed using Haskell, accepts SQL text and generates optimized statement plans. -Concurrency and Admission Control ---------------------------------- - -The SQreamDB execution engine employs thread workers and message passing for its foundation. This threading approach enables the concurrent execution of diverse operations, seamlessly integrating IO and GPU tasks with CPU operations while boosting the performance of CPU-intensive tasks. +Building Blocks +--------------- -Learn more about :ref:`concurrency_and_scaling_in_sqream`. +In SQreamDB, the main workload is carried out by specialized C++/CUDA building blocks intentionally kept devoid of inherent intelligence; they require precise instructions for operation. The task of effectively assembling these components relies largely on the capabilities of the statement compiler. Storage Layer ------------- -The storage is split into the metadata layer and an append-only / garbage collected bulk data layer. +The storage is split into the metadata layer and an append-only / garbage-collected bulk data layer. Metadata Layer ^^^^^^^^^^^^^^ -The metadata layer uses RocksDB, and uses RocksDB's snapshot and write atomic features as part of the transaction system. - -The metadata layer, together with the append-only bulk data layer help ensure consistency. +Utilizing RocksDB, the metadata layer incorporates features such as snapshots and atomic writes within the transaction system, while working in conjunction with the append-only bulk data layer to maintain overall data consistency. Bulk Data Layer ^^^^^^^^^^^^^^^ -The bulk data layer is comprised of extents, which are optimized for IO performance as much as possible. Inside the extents, are chunks, which are optimized for processing in the CPU and GPU. Compression is used in the extents and chunks. - -When you run small inserts, you will get less optimized chunks and extents, but the system is designed to both be able to still run efficiently on this, and to be able to reorganize them transactionally in the background, without blocking DML operations. By writing small chunks in small inserts, then reorganizing later, it supports both fast medium sized insert transactions and fast querying. +The bulk data layer consists of IO-optimized extents, containing CPU and GPU-efficient chunks, both of which incorporate compression. During small insert operations, less optimized chunks and extents might result, yet the system is intentionally designed to maintain operational efficiency in such scenarios. It achieves this by facilitating background transactional reorganization without disrupting DML operations. By initially writing small chunks via small inserts and subsequently reorganizing them, the system accommodates swift medium-sized insert transactions while enabling rapid querying capabilities. Columnar Storage ^^^^^^^^^^^^^^^^ -Like many other analytical database management systems, SQreamDB uses a column store for tables. +Similar to numerous other analytical database management systems, SQreamDB employs a column store structure for its tables, leveraging the advantages it provides. This approach enhances I/O efficiency and overall performance when dealing with analytic workloads. Furthermore, columns exhibit superior compression properties and are particularly suited for handling bulk data operations. + +Concurrency and Admission Control +--------------------------------- + +The SQreamDB execution engine employs thread workers and message passing for its foundation. This threading approach enables the concurrent execution of diverse operations, seamlessly integrating IO and GPU tasks with CPU operations while boosting the performance of CPU-intensive tasks. -Column stores offer better I/O and performance with analytic workloads. Columns also compress much better, and lend themselves well to bulk data. +Learn more about :ref:`concurrency_and_scaling_in_sqream`. Transactions ------------ @@ -67,27 +66,13 @@ SQreamDB has serializable transactions, with these features: * Other operations such as :ref:`delete`, :ref:`truncate`, and DDL use :ref:`coarse-grained exclusive locking<concurrency_and_locks>`. - - -Building Blocks ---------------- - -The heavy lifting in SQreamDB is done by single purpose C++/CUDA building blocks. - -These are purposely designed to not be smart - they have to be instructed exactly what to do. - -Most of the intelligence in piecing things together is in the statement compiler. - - - - GPU Usage ========= -SQreamDB uses GPUs for accelerating database operations. This acceleration brings additional benefit to columnar data processing. +SQreamDB uses GPUs for accelerating database operations. This acceleration brings additional benefits to columnar data processing. SQreamDB's GPU acceleration is integral to database operations. It is not an additional feature, but rather core to most data operations, e.g. ``GROUP BY``, scalar functions, ``JOIN``, ``ORDER BY``, and more. -Using a GPU is an extended form of SIMD (Single-instruction, multiple data) intended for high throughput operations. When GPU acceleraiton is used, SQreamDB uses special building blocks to take advantage of the high degree of parallelism of the GPU. This means that GPU operations use a single instruction that runs on multiple values. +Using a GPU is an extended form of SIMD (Single-Instruction, Multiple Data) intended for high throughput operations. When GPU acceleration is used, SQreamDB uses special building blocks to take advantage of the high degree of parallelism of the GPU. This means that GPU operations use a single instruction that runs on multiple values. From 3f295cf20cdf988194c134e7599f2364eb8af46a Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 30 Aug 2023 14:27:20 +0300 Subject: [PATCH 724/882] Update catalog_reference_catalog_tables.rst --- .../catalog_reference_catalog_tables.rst | 67 +++++++++++++------ 1 file changed, 47 insertions(+), 20 deletions(-) diff --git a/reference/catalog_reference_catalog_tables.rst b/reference/catalog_reference_catalog_tables.rst index b62b6c321..e771b9697 100644 --- a/reference/catalog_reference_catalog_tables.rst +++ b/reference/catalog_reference_catalog_tables.rst @@ -1,8 +1,9 @@ .. _catalog_reference_catalog_tables: -************************************* +************** Catalog Tables -************************************* +************** + The ``sqream_catalog`` includes the following tables: .. contents:: @@ -13,6 +14,7 @@ The ``sqream_catalog`` includes the following tables: Clustering Keys ---------------- + The ``clustering_keys`` data object is used for explicit clustering keys for tables. If you define more than one clustering key, each key is listed in a separate row, and is described in the following table: .. list-table:: @@ -36,6 +38,7 @@ The ``clustering_keys`` data object is used for explicit clustering keys for tab Columns ---------------- + The **Columns** database object shows the following tables: .. contents:: @@ -44,6 +47,7 @@ The **Columns** database object shows the following tables: Columns *********** + The ``column`` data object is used with standard tables and is described in the following table: .. list-table:: @@ -80,7 +84,8 @@ The ``column`` data object is used with standard tables and is described in the - Shows the timestamp displaying when the column was last altered. External Table Columns -*********** +************************ + The ``external_table_columns`` is used for viewing data from foreign tables. For more information on foreign tables, see :ref:`CREATE FOREIGN TABLE<create_foreign_table>`. @@ -89,6 +94,7 @@ For more information on foreign tables, see :ref:`CREATE FOREIGN TABLE<create_fo Databases ---------------- + The ``databases`` data object is used for displaying database information, and is described in the following table: .. list-table:: @@ -116,17 +122,17 @@ The ``databases`` data object is used for displaying database information, and i Permissions ---------------- -The ``permissions`` data object is used for displaying permissions information, such as roles (also known as **grantees**), and is described in the following tables: + +The ``permissions`` data object is used for displaying permission information, such as roles (also known as **grantees**), and is described in the following tables: .. contents:: :local: :depth: 1 Permission Types -*********** -The ``permission_types`` object identifies the permission names existing in the database. +***************** -The following table describes the ``permission_types`` data object: +The ``permission_types`` object identifies the permission names existing in the database. .. list-table:: :widths: 20 180 @@ -140,7 +146,8 @@ The following table describes the ``permission_types`` data object: - Shows the name of the permission type. Default Permissions -*********** +******************** + The commands included in the **Default Permissions** section describe how to check the following default permissions: .. contents:: @@ -148,7 +155,8 @@ The commands included in the **Default Permissions** section describe how to che :depth: 1 Default Table Permissions -~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~ + The ``sqream_catalog.table_default_permissions`` command shows the columns described below: .. list-table:: @@ -169,7 +177,8 @@ The ``sqream_catalog.table_default_permissions`` command shows the columns descr - Shows the type of permission granted. Default Schema Permissions -~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + The ``sqream_catalog.schema_default_permissions`` command shows the columns described below: .. list-table:: @@ -186,11 +195,14 @@ The ``sqream_catalog.schema_default_permissions`` command shows the columns desc - Shows the role that the permission is granted to. * - ``permission_type`` - Shows the type of permission granted. + * - ``getter_role_type`` + - Shows the type of role that is granted permissions. -For an example of using the ``sqream_catalog.table_default_permissions`` command, see `Granting Default Table Permissions <https://docs.sqream.com/en/v2022.1/reference/sql/sql_statements/access_control_commands/alter_default_permissions.html#granting-default-table-permissions>`_. +For an example of using the ``sqream_catalog.table_default_permissions`` command, see :ref:`Granting Default Table Permissions <alter_default_permissions>`. Table Permissions -*********** +****************** + The ``table_permissions`` data object identifies all permissions granted to tables. Each role-permission combination displays one row. The following table describes the ``table_permissions`` data object: @@ -211,7 +223,8 @@ The following table describes the ``table_permissions`` data object: - Identifies the permission type. Database Permissions -*********** +********************* + The ``database_permissions`` data object identifies all permissions granted to databases. Each role-permission combination displays one row. The following table describes the ``database_permissions`` data object: @@ -230,7 +243,8 @@ The following table describes the ``database_permissions`` data object: - Identifies the permission type. Schema Permissions -*********** +******************** + The ``schema_permissions`` data object identifies all permissions granted to schemas. Each role-permission combination displays one row. The following table describes the ``schema_permissions`` data object: @@ -251,13 +265,15 @@ The following table describes the ``schema_permissions`` data object: - Identifies the permission type. UDF Permissions -*********** +***************** + **Comment** - *No content.* .. _queries: Queries ---------------- + The ``savedqueries`` data object identifies the saved_queries in the database, as shown in the following table: .. list-table:: @@ -277,6 +293,7 @@ For more information, see :ref:`saved_queries<saved_queries>`. Roles ---------------- + The ``roles`` data object is used for displaying role information, and is described in the following tables: .. contents:: @@ -285,6 +302,7 @@ The ``roles`` data object is used for displaying role information, and is descri Roles *********** + The ``roles`` data object identifies the roles in the database, as shown in the following table: .. list-table:: @@ -305,7 +323,8 @@ The ``roles`` data object identifies the roles in the database, as shown in the - Identifies whether the role has a password (``1`` - yes, ``0`` - no). Role Memberships -*********** +******************* + The ``roles_memberships`` data object identifies the role memberships in the database, as shown below: .. list-table:: @@ -327,6 +346,7 @@ The ``roles_memberships`` data object identifies the role memberships in the dat Schemas ---------------- + The ``schemas`` data object identifies all the database's schemas, as shown below: .. list-table:: @@ -348,16 +368,19 @@ The ``schemas`` data object identifies all the database's schemas, as shown belo Sequences ---------------- + The ``sequences`` data object is used for displaying identity key information, as shown below: Identity Key -*********** +************* + **Comment** - *No content.* .. _tables: Tables ---------------- + The ``tables`` data object is used for displaying table information, and is described in the following tables: .. contents:: @@ -366,6 +389,7 @@ The ``tables`` data object is used for displaying table information, and is desc Tables *********** + The ``tables`` data object identifies proper (**Comment** - *What does "proper" mean?*) SQream tables in the database, as shown in the following table: .. list-table:: @@ -390,7 +414,8 @@ The ``tables`` data object identifies proper (**Comment** - *What does "proper" - Relevant for internal use. Foreign Tables -*********** +**************** + The ``external_tables`` data object identifies foreign tables in the database, as shown below: .. list-table:: @@ -416,6 +441,7 @@ The ``external_tables`` data object identifies foreign tables in the database, a Views ---------------- + The ``views`` data object is used for displaying views in the database, as shown below: .. list-table:: @@ -438,7 +464,8 @@ The ``views`` data object is used for displaying views in the database, as shown .. _udfs: User Defined Functions ----------------- +----------------------- + The ``udf`` data object is used for displaying UDFs in the database, as shown below: .. list-table:: @@ -452,4 +479,4 @@ The ``udf`` data object is used for displaying UDFs in the database, as shown be * - ``function_id`` - Shows the UDF's database-unique ID. * - ``function_name`` - - Shows the name of the UDF. \ No newline at end of file + - Shows the name of the UDF. From 08405584d2f5de07ff633cbf1f5278cfb09fed54 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 31 Aug 2023 08:08:24 +0300 Subject: [PATCH 725/882] Update 4.3.rst --- releases/4.3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index baa9790d3..9a47fe2c9 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -34,7 +34,7 @@ Compatibility Matrix New Features and Enhancements ----------------------------- -► A new :re:`SQLoader <ingesting_from_databases>` will enable you to load data into SQreamDB from other databases. +► A new :ref:`SQLoader <ingesting_from_databases>` will enable you to load data into SQreamDB from other databases. ► Access control permissions in SQreamDB have been expanded, allowing roles to now grant and revoke access to other roles for the following: From 0e50c7456d4eeea18d725e49e286acc3ab2ec39f Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 31 Aug 2023 10:04:54 +0300 Subject: [PATCH 726/882] Update show_node_info.rst --- .../sql/sql_statements/utility_commands/show_node_info.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/utility_commands/show_node_info.rst b/reference/sql/sql_statements/utility_commands/show_node_info.rst index 9c1e1ec11..47e43be5b 100644 --- a/reference/sql/sql_statements/utility_commands/show_node_info.rst +++ b/reference/sql/sql_statements/utility_commands/show_node_info.rst @@ -4,7 +4,7 @@ SHOW_NODE_INFO ******************** -``SHOW_NODE_INFO`` returns a snapshot of the current query plan, similar to ``EXPLAIN ANALYZE`` from other databases. +``SHOW_NODE_INFO`` returns a snapshot of the current query plan, similarly to the ``EXPLAIN ANALYZE`` function used in other databases. The snapshot provides information about execution which can be used for monitoring and troubleshooting slow running statements by helping identify long-running execution nodes (components that process data), etc. From 653fbdc4439ddd7a76f30ff125b614bdeb03fc47 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 31 Aug 2023 16:25:16 +0300 Subject: [PATCH 727/882] Update compression.rst --- feature_guides/compression.rst | 77 +++++++++++++++++++++++++--------- 1 file changed, 57 insertions(+), 20 deletions(-) diff --git a/feature_guides/compression.rst b/feature_guides/compression.rst index e6143bc59..a56826ffa 100644 --- a/feature_guides/compression.rst +++ b/feature_guides/compression.rst @@ -3,40 +3,37 @@ *********************** Compression *********************** -The **Compression** page describes the following: + +SQreamDB uses a variety of compression and encoding methods to optimize query performance and to save disk space. .. contents:: :local: :depth: 1 -.. |icon-new_dark_gray_2022.1.1.png| image:: /_static/images/new_dark_gray_2022.1.1.png - :align: middle - :width: 110 - -SQream uses a variety of compression and encoding methods to optimize query performance and to save disk space. - Encoding ============= + **Encoding** is an automatic operation used to convert data into common formats. For example, certain formats are often used for data stored in columnar format, in contrast with data stored in a CSV file, which stores all data in text format. Encoding enhances performance and reduces data size by using specific data formats and encoding methods. SQream encodes data in a number of ways in accordance with the data type. For example, a **date** is stored as an **integer**, starting with **March 1st 1CE**, which is significantly more efficient than encoding the date as a string. In addition, it offers a wider range than storing it relative to the Unix Epoch. Lossless Compression -============== +======================= + **Compression** transforms data into a smaller format without sacrificing accuracy, known as **lossless compression**. -After encoding a set of column values, SQream packs the data and compresses it and decompresses it to make it accessible to users. Depending on the compression scheme used, these operations can be performed on the CPU or the GPU. Some users find that GPU compressions provide better performance. +After encoding a set of column values, SQream packs the data and compresses it and decompresses it to make it accessible to users. Depending on the compression scheme used, these operations can be performed on the CPU or the GPU. Some users find that GPU compression provide better performance. Automatic Compression ------------------------ -By default, SQream automatically compresses every column (see :ref:`Specifying Compression Strategies<specifying_compressions>` below for overriding default compressions). This feature is called **automatic adaptive compression** strategy. -When loading data, SQream DB automatically decides on the compression schemes for specific chunks of data by trying several compression schemes and selecting the one that performs best. SQream DB tries to balance more agressive compressions with the time and CPU/GPU time required to compress and decompress the data. +By default, SQream automatically compresses every column (see :ref:`Specifying Compression Strategies<specifying_compressions>` below for overriding default compression). This feature is called **automatic adaptive compression** strategy. + +When loading data, SQreamDB automatically decides on the compression schemes for specific chunks of data by trying several compression schemes and selecting the one that performs best. SQreamDB tries to balance more aggressive compression with the time and CPU/GPU time required to compress and decompress the data. Compression Methods ------------------------ - The following table shows the supported compression methods: .. list-table:: @@ -56,9 +53,9 @@ The following table shows the supported compression methods: - Automatic scheme selection - NA * - ``DICT`` - - Integer types, dates and timestamps, short texts + - All types - - Dictionary compression with RLE. For each chunk, SQream DB creates a dictionary of distinct values and stores only their indexes. + Dictionary compression with RLE. For each chunk, SQreamDB creates a dictionary of distinct values and stores only their indexes. Works best for integers and texts shorter than 120 characters, with <10% unique values. @@ -67,7 +64,7 @@ The following table shows the supported compression methods: If the data is optionally sorted, this compression will perform even better. - GPU * - ``P4D`` - - Integer types, dates and timestamps + - ``Integer``, ``dates``, ``timestamps``, and ``float`` types - Patched frame-of-reference + Delta @@ -84,16 +81,44 @@ The following table shows the supported compression methods: - CPU * - ``RLE`` - Integer types, dates and timestamps - - Run-length encoding. This replaces sequences of values with a single pair. It is best for low cardinality columns that are used to sort data (``ORDER BY``). + - Run-Length Encoding. This replaces sequences of values with a single pair. It is best for low cardinality columns that are used to sort data (``ORDER BY``). - GPU * - ``SEQUENCE`` - - Integer types + - ``Integer``, ``date``, and ``timestamp`` - Optimized RLE + Delta type for built-in :ref:`identity columns<identity>`. - GPU * - ``zlib`` - All types - The **basic_zlib_compressor** and **basic_zlib_decompressor** compress and decompress data in the **ZLIB** format, using **DualUseFilters** for input and output. In general, compression filters are for output, and decompression filters for input. - CPU + * - ``SPACES`` + - All types + - Reduces the storage space required for data by identifying repeating sequences of values and replacing them with a compact representation. This method is particularly effective when there are repetitive patterns in the data. + - CPU + * - ``DELTA_RLE`` + - Integer types + - Optimized RLE + Delta type for built-in :ref:`identity columns<identity>`. + - CPU + * - ``SPADES`` + - All types + - An extension of ``SPACES`` compression, optimizing the compression scheme further to handle specific data patterns and types efficiently. + - CPU + * - ``SPAPPY`` + - All types + - Specialized variation of the ``Snappy`` compression algorithm. ``Snappy`` is a fast and efficient compression method that works well with various types of data, offering good compression ratios and decompression speeds. + - CPU + * - ``SPAZLY`` + - All types + - An encryption method involving the transformation of plaintext characters into a jumbled or disorderly arrangement + - CPU + * - ``CRLE`` + - All types + - An encryption process involving the compression and run-length encoding of data to secure it + - CPU + * - ``LZ4_ZIGZAG`` + - All types + - An encryption approach combining LZ4 compression with a zigzag pattern + - CPU .. note:: Automatic compression does **not** select the ``zlib`` compression method. @@ -101,6 +126,7 @@ The following table shows the supported compression methods: Specifying Compression Strategies ---------------------------------- + When you create a table without defining any compression specifications, SQream defaults to automatic adaptive compression (``"default"``). However, you can prevent this by specifying a compression strategy when creating a table. This section describes the following compression strategies: @@ -111,6 +137,7 @@ This section describes the following compression strategies: Explicitly Specifying Automatic Compression ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + When you explicitly specify automatic compression, the following two are equivalent: .. code-block:: postgres @@ -131,6 +158,7 @@ In this version, the default compression is specified explicitly: Forcing No Compression ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + **Forcing no compression** is also known as "flat", and can be used in the event that you want to remove compression entirely on some columns. This may be useful for reducing CPU or GPU resource utilization at the expense of increased I/O. The following is an example of removing compression: @@ -144,6 +172,7 @@ The following is an example of removing compression: Forcing Compression ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + In other cases, you may want to force SQream to use a specific compression scheme based on your knowledge of the data, as shown in the following example: .. code-block:: postgres @@ -159,6 +188,7 @@ However, if SQream finds that the given compression method cannot effectively co Examining Compression Effectiveness -------------------------------------- + Queries made on the internal metadata catalog can expose how effective the compression is, as well as what compression schemes were selected. This section describes the following: @@ -169,6 +199,7 @@ This section describes the following: Querying the Catalog ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + The following is a sample query that can be used to query the catalog: .. code-block:: postgres @@ -191,7 +222,8 @@ The following is a sample query that can be used to query the catalog: 2; Example Subset from "Ontime" Table -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + The following is an example (subset) from the ``ontime`` table: .. code-block:: psql @@ -283,7 +315,8 @@ The following is an example (subset) from the ``ontime`` table: year | rle | 6 | 2065915 | 317216.08 | default Notes on Reading the "Ontime" Table -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + The following are some useful notes on reading the "Ontime" table shown above: #. Higher numbers in the **Compression effectiveness** column represent better compressions. **0** represents a column that has **not been compressed**. @@ -302,6 +335,7 @@ The following are some useful notes on reading the "Ontime" table shown above: Best Practices ============================== + This section describes the best compression practices: .. contents:: @@ -309,16 +343,19 @@ This section describes the best compression practices: :depth: 1 Letting SQream Determine the Best Compression Strategy ----------------------------------------------------- +------------------------------------------------------- + In general, SQream determines the best compression strategy for most cases. If you decide to override SQream's selected compression strategies, we recommend benchmarking your query and load performance **in addition to** your storage size. Maximizing the Advantage of Each Compression Scheme ------------------------------------------------------- + Some compression schemes perform better when data is organized in a specific way. For example, to take advantage of RLE, sorting a column may result in better performance and reduced disk-space and I/O usage. Sorting a column partially may also be beneficial. As a rule of thumb, aim for run-lengths of more than 10 consecutive values. Choosing Data Types that Fit Your Data --------------------------------------- + Adapting to the narrowest data type improves query performance while reducing disk space usage. However, smaller data types may compress better than larger types. For example, SQream recommends using the smallest numeric data type that will accommodate your data. Using ``BIGINT`` for data that fits in ``INT`` or ``SMALLINT`` can use more disk space and memory for query execution. Using ``FLOAT`` to store integers will reduce compression's effectiveness significantly. \ No newline at end of file From df3b1e9207bd9ceac1ffbc81f5b15bc58859f217 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 4 Sep 2023 11:03:04 +0300 Subject: [PATCH 728/882] Update tableau.rst --- .../client_platforms/tableau.rst | 32 ++++++++++--------- 1 file changed, 17 insertions(+), 15 deletions(-) diff --git a/connecting_to_sqream/client_platforms/tableau.rst b/connecting_to_sqream/client_platforms/tableau.rst index 7e4e92509..8161a96ac 100644 --- a/connecting_to_sqream/client_platforms/tableau.rst +++ b/connecting_to_sqream/client_platforms/tableau.rst @@ -59,7 +59,7 @@ Installing the Tableau Connector * - Tableau Prep Conductor on Tableau Server - ``/data/tabsvc/flowprocessor/Connectors`` * - Tableau Server - - ``C:\ProgramData\Tableau\Tableau Server\data\tabsvc\vizqlserver\Connectors`` + - ``C:\<directory_name>\Tableau\Tableau Server\<directory_name>\Connectors`` 3. Restart Tableau Desktop or Tableau server. @@ -83,12 +83,8 @@ Connecting to SQream :: -#. In the connection dialog box, fill in the fields and click **Sign In**. +#. In the connection dialog box, fill in the following fields: - The connection is established, and the data source page is displayed. - -Information about step 4 fields: - .. list-table:: :widths: 15 38 38 :header-rows: 1 @@ -97,26 +93,32 @@ Information about step 4 fields: - Description - Example * - Server - - Defines the server of the SQream worker. - - ``127.0.0.1`` or ``sqream.mynetwork.co`` + - Defines the SQreamDB worker machine IP. + + Avoid using the loopback address (127.0.0.1) or "localhost" as a server address since it typically refers to the local machine where Tableau is installed and may create issues and limitations + - ``192.162.4.182`` or ``sqream.mynetwork.com`` * - Port - - Defines the TCP port of the SQream worker. - - ``3108`` when using a load balancer, or ``5100`` when connecting directly to a worker with SSL. + - Defines the TCP port of the SQream worker + - ``3108`` when using a load balancer, or ``5100`` when connecting directly to a worker with SSL * - Database - - Defines the database to establish a connection with. + - Defines the database to establish a connection with - ``master`` * - Cluster - - Enables (``true``) or disables (``false``) the load balancer. After enabling or disabling the load balance, verify the connection. + - Enables (``true``) or disables (``false``) the load balancer. After enabling or disabling the load balance, verify the connection - * - Username - - Specifies the username of a role to use when connecting. + - Specifies the username of a role to use when connecting - ``rhendricks`` * - Password - - Specifies the password of the selected role. + - Specifies the password of the selected role - ``Tr0ub4dor&3`` * - Require SSL - - Sets SSL as a requirement for establishing this connection. + - Sets SSL as a requirement for establishing this connection - +5. Click **Sign In**. + The connection is established, and the data source page is displayed. + + From 1466fd162b2d3e35d80621b640b5ee4f20b77635 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 4 Sep 2023 11:13:48 +0300 Subject: [PATCH 729/882] User-Defined Functions page edit --- reference/sql/sql_functions/user_defined_functions/index.rst | 5 +++-- .../user_defined_functions/simple_scalar_sql_udf.rst | 3 +++ 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/reference/sql/sql_functions/user_defined_functions/index.rst b/reference/sql/sql_functions/user_defined_functions/index.rst index 028e35a07..b3c52022b 100644 --- a/reference/sql/sql_functions/user_defined_functions/index.rst +++ b/reference/sql/sql_functions/user_defined_functions/index.rst @@ -8,5 +8,6 @@ The following user-defined functions are functions that can be defined and confi The **User-Defined Functions** page describes the following: -* `Python user-defined functions <https://docs.sqream.com/en/v2022.1/feature_guides/python_functions.html>`_ -* `Scalar SQL user-defined functions <https://docs.sqream.com/en/v2022.1/reference/sql/sql_functions/user_defined_functions/scalar_sql_udf.html>`_ \ No newline at end of file +* :ref:`Python user-defined functions<python_functions>` +* :ref:`Scalar SQL user-defined functions<scalar_sql_udf>` +* :ref:`Simple Scalar SQL UDF's<simple_scalar_sql_udf>` \ No newline at end of file diff --git a/reference/sql/sql_functions/user_defined_functions/simple_scalar_sql_udf.rst b/reference/sql/sql_functions/user_defined_functions/simple_scalar_sql_udf.rst index 1a78e2e8c..f47983c4a 100644 --- a/reference/sql/sql_functions/user_defined_functions/simple_scalar_sql_udf.rst +++ b/reference/sql/sql_functions/user_defined_functions/simple_scalar_sql_udf.rst @@ -6,6 +6,7 @@ Simple Scalar SQL UDF's Syntax ~~~~~~~~~~~~ + The following example shows the correct syntax for simple scalar SQL UDF's: @@ -27,6 +28,7 @@ The following example shows the correct syntax for simple scalar SQL UDF's: Usage Notes ~~~~~~~~~~~~~~ + The following usage notes apply when using simple scalar SQL UDF's: * During this stage, the SQL embedded in the function body must be of the type ``SELECT expr;``. Creating a UDF with invalid SQL, or with valid SQL of any other type, results in an error. @@ -45,6 +47,7 @@ Because SQL UDF's are one type of supported UDFs, the following Python UDF chara Restrictions ~~~~~~~~~~~~~~~~~~~~~ + The following restrictions apply to simple scalar SQL UDF's: * Simple scalar SQL UDF's cannot currently reference other UDF's. From ef7e40fb1b778cebc8293b8992d09135a3cbc944 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 4 Sep 2023 14:03:53 +0300 Subject: [PATCH 730/882] Update monitoring_query_performance.rst --- .../monitoring_query_performance.rst | 212 +++++++++++------- 1 file changed, 133 insertions(+), 79 deletions(-) diff --git a/operational_guides/monitoring_query_performance.rst b/operational_guides/monitoring_query_performance.rst index cca8eb4ea..4d65abbbc 100644 --- a/operational_guides/monitoring_query_performance.rst +++ b/operational_guides/monitoring_query_performance.rst @@ -1,8 +1,9 @@ .. _monitoring_query_performance: -********************************* +**************************** Monitoring Query Performance -********************************* +**************************** + When analyzing options for query tuning, the first step is to analyze the query plan and execution. The query plan and execution details explain how SQream DB processes a query and where time is spent. This document details how to analyze query performance with execution plans. @@ -10,20 +11,25 @@ This guide focuses specifically on identifying bottlenecks and possible optimiza Performance tuning options for each query are different. You should adapt the recommendations and tips for your own workloads. See also our :ref:`sql_best_practices` guide for more information about data loading considerations and other best practices. -.. contents:: In this section: +.. contents:: :local: + :depth: 1 + Setting Up the System for Monitoring -================================================= +==================================== + By default, SQream DB logs execution details for every statement that runs for more than 60 seconds. If you want to see the execution details for a currently running statement, see :ref:`using_show_node_info` below. Adjusting the Logging Frequency ---------------------------------------- +------------------------------- + To adjust the frequency of logging for statements, you may want to reduce the interval from 60 seconds down to, say, 5 or 10 seconds. Modify the configuration files and set the ``nodeInfoLoggingSec`` parameter as you see fit: -.. code-block:: json +.. code-block:: sql + :emphasize-lines: 7 { @@ -38,13 +44,15 @@ say, 5 or 10 seconds. Modify the configuration files and set the ``nodeInfoLoggi } } After restarting the SQream DB cluster, the execution plan details will be logged to the :ref:`standard SQream DB logs directory<logging>`, as a message of type ``200``. -You can see these messages with a text viewer or with queries on the log :ref:`external_tables`. +You can see these messages with a text viewer or with queries on the log :ref:`foreign_tables`. Reading Execution Plans with a Foreign Table ------------------------------------------------------ +-------------------------------------------- + First, create a foreign table for the logs -.. code-block:: postgres +.. code-block:: sql + CREATE FOREIGN TABLE logs ( start_marker TEXT(4), @@ -73,7 +81,8 @@ First, create a foreign table for the logs Once you've defined the foreign table, you can run queries to observe the previously logged execution plans. This is recommended over looking at the raw logs. -.. code-block:: psql +.. code-block:: sql + t=> SELECT message . FROM logs . WHERE message_type_id = 200 @@ -103,7 +112,8 @@ This is recommended over looking at the raw logs. .. _using_show_node_info: Using the ``SHOW_NODE_INFO`` Command -===================================== +==================================== + The :ref:`show_node_info` command returns a snapshot of the current query plan, similar to ``EXPLAIN ANALYZE`` from other databases. The :ref:`show_node_info` result, just like the periodically-logged execution plans described above, are an at-the-moment view of the compiler's execution plan and runtime statistics for the specified statement. @@ -111,7 +121,7 @@ To inspect a currently running statement, execute the ``show_node_info`` utility :ref:`sqream sql<sqream_sql_cli_reference>`, the :ref:`SQream Studio Editor<studio_editor>`, or any other :ref:`third party SQL terminal<third_party_tools>`. In this example, we inspect a statement with statement ID of 176. The command looks like this: -.. code-block:: psql +.. code-block:: sql t=> SELECT SHOW_NODE_INFO(176); stmt_id | node_id | node_type | rows | chunks | avg_rows_in_chunk | time | parent_node_id | read | write | comment | timeSum @@ -129,7 +139,8 @@ In this example, we inspect a statement with statement ID of 176. The command lo 176 | 11 | ReadTable | 457 | 1 | 457 | 2019-12-25 23:53:13 | 10 | 4MB | | public.nba | 0.0004 Understanding the Query Execution Plan Output -================================================== +============================================= + Both :ref:`show_node_info` and the logged execution plans represents the query plan as a graph hierarchy, with data separated into different columns. Each row represents a single logical database operation, which is also called a **node** or **chunk producer**. A node reports several metrics during query execution, such as how much data it has read and written, how many chunks and rows, and how much time has elapsed. @@ -137,8 +148,7 @@ Consider the example show_node_info presented above. The source node with ID #11 (``CpuDecompress``). If we were to draw this out in a graph, it'd look like this: .. figure:: /_static/images/show_node_info_graph.png - - :height: 70em + :scale: 60 % :align: center This graph explains how the query execution details are arranged in a logical order, from the bottom up. @@ -186,13 +196,15 @@ When using :ref:`show_node_info`, a tabular representation of the currently runn See the examples below to understand how the query execution plan is instrumental in identifying bottlenecks and optimizing long-running statements. Information Presented in the Execution Plan ----------------------------------------------------- +------------------------------------------- + .. include:: /reference/sql/sql_statements/monitoring_commands/show_node_info.rst :start-line: 47 :end-line: 78 Commonly Seen Nodes ----------------------- +------------------- + .. list-table:: Node types :widths: auto :header-rows: 1 @@ -297,15 +309,18 @@ Commonly Seen Nodes .. tip:: The full list of nodes appears in the :ref:`Node types table<node_types>`, as part of the :ref:`show_node_info` reference. Examples -================== +======== + In general, looking at the top three longest running nodes (as is detailed in the ``timeSum`` column) can indicate the biggest bottlenecks. In the following examples you will learn how to identify and solve some common issues. .. contents:: In this section: :local: + :depths: 1 + +Spooling to Disk +---------------- -1. Spooling to Disk ------------------------ When there is not enough RAM to process a statement, SQream DB will spill over data to the ``temp`` folder in the storage disk. While this ensures that a statement can always finish processing, it can slow down the processing significantly. It's worth identifying these statements, to figure out if the cluster is configured correctly, as well as potentially reduce @@ -315,13 +330,14 @@ A node that spools will have a value, shown in megabytes in the ``write`` column Common nodes that write spools include ``Join`` or ``LoopJoin``. Identifying the Offending Nodes -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + #. Run a query. For example, a query from the TPC-H benchmark: - .. code-block:: postgres + .. code-block:: sql SELECT o_year, SUM(CASE WHEN nation = 'BRAZIL' THEN volume ELSE 0 END) / SUM(volume) AS mkt_share @@ -347,7 +363,8 @@ Identifying the Offending Nodes The execution below has been shortened, but note the highlighted rows for ``LoopJoin``: - .. code-block:: psql + .. code-block:: sql + :emphasize-lines: 33,35,37,39 t=> SELECT message FROM logs WHERE message_type_id = 200 LIMIT 1; @@ -396,7 +413,8 @@ Identifying the Offending Nodes The total spool used by this query is around 20GB (1915MB + 2191MB + 3064MB + 12860MB). Common Solutions for Reducing Spool -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + * Increase the amount of spool memory available for the workers, as a proportion of the maximum statement memory. When the amount of spool memory is increased, SQream DB may not need to write to disk. @@ -405,19 +423,22 @@ Common Solutions for Reducing Spool * Reduce the amount of **workers** per host, and increase the amount of spool available to the (now reduced amount of) active workers. This may reduce the amount of concurrent statements, but will improve performance for heavy statements. -2. Queries with Large Result Sets ------------------------------------- + +Queries with Large Result Sets +------------------------------ + When queries have large result sets, you may see a node called ``DeferredGather``. This gathering occurs when the result set is assembled, in preparation for sending it to the client. Identifying the Offending Nodes -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + #. Run a query. For example, a modified query from the TPC-H benchmark: - .. code-block:: postgres + .. code-block:: sql SELECT s.*, l.*, @@ -446,7 +467,8 @@ Identifying the Offending Nodes The execution below has been shortened, but note the highlighted rows for ``DeferredGather``: - .. code-block:: psql + .. code-block:: sql + :emphasize-lines: 7,9,11 t=> SELECT show_node_info(494); @@ -469,7 +491,7 @@ Identifying the Offending Nodes #. Modify the statement to see the difference Altering the select clause to be more restrictive will reduce the deferred gather time back to a few milliseconds. - .. code-block:: postgres + .. code-block:: sql SELECT DATEPART(year, o_orderdate) AS o_year, l_extendedprice * (1 - l_discount / 100.0) as volume, @@ -477,19 +499,22 @@ Identifying the Offending Nodes FROM ... Common Solutions for Reducing Gather Time -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + * Reduce the effect of the preparation time. Avoid selecting unnecessary columns (``SELECT * FROM...``), or reduce the result set size by using more filters. .. `` -3. Inefficient Filtering --------------------------------- +Inefficient Filtering +--------------------- + When running statements, SQream DB tries to avoid reading data that is not needed for the statement by :ref:`skipping chunks<chunks_and_extents>`. If statements do not include efficient filtering, SQream DB will read a lot of data off disk. In some cases, you need the data and there's nothing to do about it. However, if most of it gets pruned further down the line, it may be efficient to skip reading the data altogether by using the :ref:`metadata<metadata_system>`. Identifying the Situation -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^ + We consider the filtering to be inefficient when the ``Filter`` node shows that the number of rows processed is less than a third of the rows passed into it by the ``ReadTable`` node. For example: @@ -499,7 +524,7 @@ For example: In this example, we execute a modified query from the TPC-H benchmark. Our ``lineitem`` table contains 600,037,902 rows. - .. code-block:: postgres + .. code-block:: sql SELECT o_year, SUM(CASE WHEN nation = 'BRAZIL' THEN volume ELSE 0 END) / SUM(volume) AS mkt_share @@ -526,7 +551,8 @@ For example: The execution below has been shortened, but note the highlighted rows for ``ReadTable`` and ``Filter``: - .. code-block:: psql + .. code-block:: sql + :linenos: :emphasize-lines: 9,17,19,27 @@ -571,7 +597,8 @@ For example: #. Modify the statement to see the difference Altering the statement to have a ``WHERE`` condition on the clustered ``l_orderkey`` column of the ``lineitem`` table will help SQream DB skip reading the data. - .. code-block:: postgres + .. code-block:: sql + :emphasize-lines: 15 SELECT o_year, @@ -594,7 +621,8 @@ For example: GROUP BY o_year ORDER BY o_year; - .. code-block:: psql + .. code-block:: sql + :linenos: :emphasize-lines: 5,13 @@ -619,20 +647,24 @@ For example: The metadata skipping has performed very well, and has pre-filtered the data for us by pruning unnecessary chunks. Common Solutions for Improving Filtering -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + * Use :ref:`clustering keys and naturally ordered data<data_clustering>` in your filters. * Avoid full table scans when possible -4. Joins with ``text`` Keys ------------------------------------ +Joins with ``text`` Keys +------------------------ + Joins on long text keys do not perform as well as numeric data types or very short text keys. Identifying the Situation -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^ + When a join is inefficient, you may note that a query spends a lot of time on the ``Join`` node. For example, consider these two table structures: -.. code-block:: postgres +.. code-block:: sql + CREATE TABLE t_a ( amt FLOAT NOT NULL, @@ -653,7 +685,7 @@ For example, consider these two table structures: In this example, we will join ``t_a.fk`` with ``t_b.id``, both of which are ``TEXT(50)``. - .. code-block:: postgres + .. code-block:: sql SELECT AVG(t_b.j :: BIGINT), t_a.country_code @@ -668,7 +700,8 @@ For example, consider these two table structures: The ``Join`` node is by far the most time-consuming part of this statement - clocking in at 69.7 seconds joining 1.5 billion records. - .. code-block:: psql + .. code-block:: sql + :linenos: :emphasize-lines: 8 @@ -689,7 +722,8 @@ For example, consider these two table structures: 5 | 42 | ReadTable | 10000000 | 2 | 5000000 | 2020-09-08 18:26:09 | 41 | 14MB | | public.t_a | 0 Improving Query Performance -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^ + * In general, try to avoid ``TEXT`` as a join key. As a rule of thumb, ``BIGINT`` works best as a join key. * Convert text values on-the-fly before running the query. For example, the :ref:`crc64` function takes a text @@ -697,17 +731,18 @@ Improving Query Performance For example: - .. code-block:: postgres + .. code-block:: sql - SELECT AVG(t_b.j :: BIGINT), - t_a.country_code - FROM t_a - JOIN t_b ON (crc64_join(t_a.fk) = crc64_join(t_b.id)) - GROUP BY t_a.country_code + SELECT AVG(t_b.j::BIGINT), t_a.country_code + FROM "public"."t_a" + JOIN "public"."t_b" ON (CRC64(t_a.fk::TEXT) = CRC64(t_b.id::TEXT)) + GROUP BY t_a.country_code; + The execution below has been shortened, but note the highlighted rows for ``Join``. The ``Join`` node went from taking nearly 70 seconds, to just 6.67 seconds for joining 1.5 billion records. - .. code-block:: psql + .. code-block:: sql + :linenos: :emphasize-lines: 8 @@ -728,13 +763,15 @@ Improving Query Performance * You can map some text values to numeric types by using a dimension table. Then, reconcile the values when you need them by joining the dimension table. -5. Sorting on big ``TEXT`` fields ---------------------------------------- +Sorting on big ``TEXT`` fields +------------------------------ + In general, SQream DB automatically inserts a ``Sort`` node which arranges the data prior to reductions and aggregations. When running a ``GROUP BY`` on large ``TEXT`` fields, you may see nodes for ``Sort`` and ``Reduce`` taking a long time. Identifying the Situation -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^ + When running a statement, inspect it with :ref:`show_node_info`. If you see ``Sort`` and ``Reduce`` among your top five longest running nodes, there is a potential issue. For example: @@ -744,7 +781,8 @@ For example: Our ``t_inefficient`` table contains 60,000,000 rows, and the structure is simple, but with an oversized ``country_code`` column: - .. code-block:: postgres + .. code-block:: sql + :emphasize-lines: 5 CREATE TABLE t_inefficient ( @@ -775,7 +813,8 @@ For example: [...] - .. code-block:: psql + .. code-block:: sql + :emphasize-lines: 8,9 t=> select show_node_info(30); @@ -796,7 +835,7 @@ For example: #. We can look to see if there's any shrinking we can do on the ``GROUP BY`` key - .. code-block:: psql + .. code-block:: sql t=> SELECT MAX(LEN(country_code)) FROM t_inefficient; max @@ -806,7 +845,8 @@ For example: #. We can recreate the table with a more restrictive ``TEXT(3)``, and can examine the difference in performance: - .. code-block:: psql + .. code-block:: sql + t=> CREATE TABLE t_efficient . AS SELECT i, . amt, @@ -833,7 +873,8 @@ For example: This time, the entire query took just 4.75 seconds, or just about 91% faster. Improving Sort Performance on Text Keys -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + When using TEXT, ensure that the maximum length defined in the table structure is as small as necessary. For example, if you're storing phone numbers, don't define the field as ``TEXT(255)``, as that affects sort performance. @@ -841,8 +882,9 @@ You can run a query to get the maximum column length (e.g. ``MAX(LEN(a_column))` .. _high_selectivity_data_opt: -6. High Selectivity Data --------------------------- +High Selectivity Data +--------------------- + Selectivity is the ratio of cardinality to the number of records of a chunk. We define selectivity as :math:`\frac{\text{Distinct values}}{\text{Total number of records in a chunk}}` SQream DB has a hint called ``HIGH_SELECTIVITY``, which is a function you can wrap a condition in. The hint signals to SQream DB that the result of the condition will be very sparse, and that it should attempt to rechunk @@ -852,11 +894,12 @@ the results into fewer, fuller chunks. well-clustered data, which is the more common scenario. Identifying the Situation -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^ + This is easily identifiable - when the amount of average of rows in a chunk is small, following a ``Filter`` operation. Consider this execution plan: -.. code-block:: psql +.. code-block:: sql t=> select show_node_info(30); stmt_id | node_id | node_type | rows | chunks | avg_rows_in_chunk | time | parent_node_id | read | write | comment | timeSum @@ -870,25 +913,28 @@ The filter node reduced the output to just 18,160 relevant rows, but they're dis All of these rows could fit in one single chunk, instead of spanning 74 rather sparse chunks. Improving Performance with High Selectivity Hints -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ * Use when there's a ``WHERE`` condition on an :ref:`unclustered column<data_clustering>`, and when you expect the filter to cut out more than 60% of the result set. * Use when the data is uniformly distributed or random -7. Performance of unsorted data in joins ------------------------------------------- +Performance of unsorted data in joins +------------------------------------- + When data is not well-clustered or naturally ordered, a join operation can take a long time. Identifying the Situation -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^ + When running a statement, inspect it with :ref:`show_node_info`. If you see ``Join`` and ``DeferredGather`` among your top five longest running nodes, there is a potential issue. In this case, we're also interested in the number of chunks produced by these nodes. Consider this execution plan: -.. code-block:: psql +.. code-block:: sql + :emphasize-lines: 6,11 t=> select show_node_info(30); @@ -914,13 +960,15 @@ The filter node reduced the output to just 18,160 relevant rows, but they're dis All of these rows could fit in one single chunk, instead of spanning 74 rather sparse chunks. Improving Join Performance when Data is Sparse -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + You can tell SQream DB to reduce the amount of chunks involved, if you know that the filter is going to be quite agressive by using the :ref:`HIGH_SELECTIVITY<high_selectivity>` hint described :ref:`above<high_selectivity_data_opt>`. This forces the compiler to rechunk the data into fewer chunks. To tell SQream DB to rechunk the data, wrap a condition (or several) in the ``HIGH_SELECTIVITY`` hint: -.. code-block:: postgres +.. code-block:: sql + :emphasize-lines: 13 -- Without the hint @@ -939,16 +987,19 @@ To tell SQream DB to rechunk the data, wrap a condition (or several) in the ``HI AND EnterpriseID=1150 AND MSISDN='9724871140341'; -8. Manual Join Reordering --------------------------------- +Manual Join Reordering +---------------------- + When joining multiple tables, you may wish to change the join order to join the smallest tables first. Identifying the situation -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^ + When joining more than two tables, the ``Join`` nodes will be the most time-consuming nodes. Changing the Join Order -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^ + Always prefer to join the smallest tables first. .. note:: We consider small tables to be tables that only retain a small amount of rows after conditions @@ -956,7 +1007,8 @@ Always prefer to join the smallest tables first. Changing the join order can reduce the query runtime significantly. In the examples below, we reduce the time from 27.3 seconds to just 6.4 seconds. -.. code-block:: postgres +.. code-block:: sql + :caption: Original query -- This variant runs in 27.3 seconds @@ -975,7 +1027,8 @@ from 27.3 seconds to just 6.4 seconds. AND l_shipdate <= dateadd(DAY,122,'1994-01-01') GROUP BY c_nationkey -.. code-block:: postgres +.. code-block:: sql + :caption: Modified query with improved join order -- This variant runs in 6.4 seconds @@ -995,5 +1048,6 @@ from 27.3 seconds to just 6.4 seconds. GROUP BY c_nationkey Further Reading -================== +=============== + See our :ref:`sql_best_practices` guide for more information about query optimization and data loading considerations. \ No newline at end of file From 0099cda9301e0c267d9a6ad684401e73d0ca6725 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 4 Sep 2023 16:58:33 +0300 Subject: [PATCH 731/882] Update copy_from.rst --- .../sql_statements/dml_commands/copy_from.rst | 45 +++++++++++-------- 1 file changed, 26 insertions(+), 19 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/copy_from.rst b/reference/sql/sql_statements/dml_commands/copy_from.rst index 91c32cd01..403836e27 100644 --- a/reference/sql/sql_statements/dml_commands/copy_from.rst +++ b/reference/sql/sql_statements/dml_commands/copy_from.rst @@ -107,7 +107,7 @@ Elements - Specifies an alternative quote character. The quote character must be a single, 1-byte printable ASCII character, and the equivalent octal syntax of the copy command can be used. The quote character cannot be contained in the field delimiter, the record delimiter, or the null marker. ``QUOTE`` can be used with ``csv_fdw`` in **COPY FROM** and foreign tables. * - ``fdw_name`` - - - ``csv_fdw``, ``orc_fdw``, or ``parquet_fdw`` + - ``csv_fdw``, ``orc_fdw``, ``parquet_fdw``, ``json_fdw``, or ``avro_fdw`` - The name of the Foreign Data Wrapper to use * - ``LOCATION`` - None @@ -259,20 +259,16 @@ Supported Field Delimiters Field delimiters can be one or more characters. Customizing Quotations Using Alternative Characters ----------------------------- +----------------------------------------------------- -Customizing Quotations Using Alternative Characters -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -The following is the correct syntax for customizing quotations using alternative characters: +Syntax: .. code-block:: postgres - copy t from wrapper csv_fdw options (location = '/tmp/source_file.csv', quote='@'); - copy t to wrapper csv_fdw options (location = '/tmp/destination_file.csv', quote='@'); + COPY t FROM wrapper csv_fdw OPTIONS (location = '/tmp/source_file.csv', quote='@'); + COPY t TO wrapper csv_fdw OPTIONS (location = '/tmp/destination_file.csv', quote='@'); -Customizing Quotations Using Alternative Characters -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Example: The following is an example of line taken from a CSV when customizing quotations using a character: @@ -284,15 +280,14 @@ The following is an example of line taken from a CSV when customizing quotations Customizing Quotations Using ASCII Character Codes ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -The following is the correct syntax for customizing quotations using ASCII character codes: +Syntax: .. code-block:: postgres copy t from wrapper csv_fdw options (location = '/tmp/source_file.csv', quote=E'\064'); copy t to wrapper csv_fdw options (location = '/tmp/destination_file.csv', quote=E'\064'); -Customizing Quotations Using ASCII Character Codes -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Example: The following is an example of line taken from a CSV when customizing quotations using an ASCII character code: @@ -300,12 +295,10 @@ The following is an example of line taken from a CSV when customizing quotations Pepsi-"Cola",@Coca-"Cola"@,Sprite,Fanta - - Multi-Character Delimiters -------------------------- -SQream DB supports multi-character field delimiters, sometimes found in non-standard files. +SQreamDB supports multi-character field delimiters, sometimes found in non-standard files. A multi-character delimiter can be specified. For example, ``DELIMITER '%%'``, ``DELIMITER '{~}'``, etc. @@ -378,6 +371,7 @@ Whenever the data can’t be parsed because it is improperly formatted or doesn When ``ERROR_LOG`` is not used, the ``COPY`` command will stop and roll back the transaction upon the first error. .. image:: /_static/images/copy_from_rejected_rows.png + :width: 50% CSV Support @@ -472,7 +466,20 @@ Loading a Parquet File .. code-block:: postgres COPY table_name FROM WRAPPER parquet_fdw OPTIONS (location = '/tmp/file.parquet'); + +Loading a JSON File +---------------------- + +.. code-block:: postgres + + COPY t FROM WRAPPER json_fdw OPTIONS (location = 'somefile.json'); + +Loading an AVRO File +---------------------- + +.. code-block:: postgres + COPY t FROM WRAPPER fdw_name OPTIONS ([ copy_from_option [, ...] ]); Loading a Text File with Non-Printable Delimiters ------------------------------------------------- @@ -577,12 +584,12 @@ When the source of the files does not match the table structure, tell the ``COPY Loading Non-Standard Dates ---------------------------------- -If files contain dates not formatted as ``ISO8601``, tell ``COPY`` how to parse the column. After parsing, the date will appear as ``ISO8601`` inside SQream DB. +If files contain dates not formatted as ``ISO8601``, tell ``COPY`` how to parse the column. After parsing, the date will appear as ``ISO8601`` inside SQreamDB. -These are called date parsers. You can find the supported dates in the :ref:`'Supported date parsers' table<copy_date_parsers>` above +These are called date parsers. You can find the supported dates in the :ref:`'Supported date parsers' table<copy_date_parsers>` above. In this example, ``date_col1`` and ``date_col2`` in the table are non-standard. ``date_col3`` is mentioned explicitly, but can be left out. Any column that is not specified is assumed to be ``ISO8601``. .. code-block:: postgres - COPY table_name FROM WRAPPER csv_fdw OPTIONS (location = '/tmp/*.csv', datetime_format = 'DMY'); + COPY my_table (date_col1, date_col2, date_col3) FROM '/tmp/my_data.csv' WITH CSV HEADER datetime_format 'DMY'; From 885f68821e3f98433a688d2ddf5ed99b0015db71 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 5 Sep 2023 08:41:23 +0300 Subject: [PATCH 732/882] Update internals_architecture.rst --- architecture/internals_architecture.rst | 25 ++++++++++--------------- 1 file changed, 10 insertions(+), 15 deletions(-) diff --git a/architecture/internals_architecture.rst b/architecture/internals_architecture.rst index 0d319678f..af5ec0acf 100644 --- a/architecture/internals_architecture.rst +++ b/architecture/internals_architecture.rst @@ -17,32 +17,27 @@ Key Functions and Components Statement Compiler ------------------ -The Statement Compiler, developed using Haskell, accepts SQL text and generates optimized statement plans. +The Statement Compiler, developed using Haskell, accepts SQL text and generates optimized statement execution plans. -Building Blocks ---------------- +Building Blocks (GPU Workers) +----------------------------- -In SQreamDB, the main workload is carried out by specialized C++/CUDA building blocks intentionally kept devoid of inherent intelligence; they require precise instructions for operation. The task of effectively assembling these components relies largely on the capabilities of the statement compiler. +In SQreamDB, the main workload is carried out by specialized C++/CUDA building blocks, also known as Workers, which intentionally lack inherent intelligence and require precise instructions for operation. Effectively assembling these components relies largely on the capabilities of the statement compiler. Storage Layer ------------- -The storage is split into the metadata layer and an append-only / garbage-collected bulk data layer. +The storage is split into the metadata layer and an append-only data layer. Metadata Layer ^^^^^^^^^^^^^^ -Utilizing RocksDB, the metadata layer incorporates features such as snapshots and atomic writes within the transaction system, while working in conjunction with the append-only bulk data layer to maintain overall data consistency. +Utilizing RocksDB key/value data store, the metadata layer incorporates features such as snapshots and atomic writes within the transaction system, while working in conjunction with the append-only bulk data layer to maintain overall data consistency. -Bulk Data Layer -^^^^^^^^^^^^^^^ +Bulk Data Layer Optimization +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -The bulk data layer consists of IO-optimized extents, containing CPU and GPU-efficient chunks, both of which incorporate compression. During small insert operations, less optimized chunks and extents might result, yet the system is intentionally designed to maintain operational efficiency in such scenarios. It achieves this by facilitating background transactional reorganization without disrupting DML operations. By initially writing small chunks via small inserts and subsequently reorganizing them, the system accommodates swift medium-sized insert transactions while enabling rapid querying capabilities. - -Columnar Storage -^^^^^^^^^^^^^^^^ - -Similar to numerous other analytical database management systems, SQreamDB employs a column store structure for its tables, leveraging the advantages it provides. This approach enhances I/O efficiency and overall performance when dealing with analytic workloads. Furthermore, columns exhibit superior compression properties and are particularly suited for handling bulk data operations. +SQreamDB harnesses the power of its columnar storage architecture within the bulk data layer for performance optimization. This layer employs IO-optimized extents containing compression-enabled CPU and GPU-efficient chunks. Even during small insert operations, SQreamDB maintains efficiency by generating less optimized chunks and extents as needed. This is achieved through background transactional reorganization that doesn't disrupt Data Manipulation Language (DML) operations. The system initially writes small chunks via small inserts and subsequently reorganizes them, facilitating swift medium-sized insert transactions and rapid queries. This optimization strategy, coupled with SQreamDB's columnar storage, ensures peak performance across diverse data processing tasks. Concurrency and Admission Control --------------------------------- @@ -54,7 +49,7 @@ Learn more about :ref:`concurrency_and_scaling_in_sqream`. Transactions ------------ -SQreamDB has serializable transactions, with these features: +SQreamDB has serializable (auto commit) transactions, with these features: * Serializable, with any kind of statement From 1509b8693dc821da181d6194a2605f7ff685c8ad Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 5 Sep 2023 12:50:37 +0300 Subject: [PATCH 733/882] SQLoader --- data_ingestion/index.rst | 2 +- data_ingestion/ingesting_from_databases.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/data_ingestion/index.rst b/data_ingestion/index.rst index ad3e27e93..3c8c65368 100644 --- a/data_ingestion/index.rst +++ b/data_ingestion/index.rst @@ -15,7 +15,7 @@ The **Data Ingestion Sources** page provides information about the following: csv parquet orc - json + json ingesting_from_databases For information about database tools and interfaces that SQream supports, see :ref:`Third Party Tools <connecting_to_sqream>`. \ No newline at end of file diff --git a/data_ingestion/ingesting_from_databases.rst b/data_ingestion/ingesting_from_databases.rst index 546c712cf..48eb7084f 100644 --- a/data_ingestion/ingesting_from_databases.rst +++ b/data_ingestion/ingesting_from_databases.rst @@ -1 +1 @@ -.. _ingesting_from_databases: ****************** External Databases ****************** The **SQLoader** is a CLI program that enables you to load data into SQreamDB from other databases. **SQLoader** supports Oracle and Postgresql. .. contents:: :local: :depth: 1 Before You Begin ================ It is essential that you have the following: * Java 17 * SQLoader configuration files * SQLoader.jar file Getting the SQLoader Configuration and JAR Files ================================================ 1. Download the ``.tar`` file using the following command: .. code-block:: linux curl -O https://sq-ftp-public.s3.amazonaws.com/sqloader-0.0.6.tar.gz 2. Extract the ``.tar`` file using the following command: .. code-block:: linux tar -xf sqloader-0.0.6.tar.gz A folder named ``sqloader-0.0.6`` with the following files is created: .. list-table:: SQLoader Files :widths: auto :header-rows: 1 * - File - Description * - ``sqream-mapping.json`` - Maps Postgresql and Oracle data types into SQreamDB data types during ingestion * - ``sqload-jdbc-oracle.properties`` - Used for defining a connection string and may also be used to reconfigure data loading * - ``reserved_words.txt`` - A list of reserved words which cannot be used as table and/or column names * - ``sqloader-0.0.6.jar`` - The SQLoader package file Connection String ================= The ``sqload-jdbc-oracle-incr.properties`` file contains a connection string that must be configured to enable data loading into SQreamDB. .. literalinclude:: connection_string.java :language: java :caption: Properties File Sample :linenos: Configuring SQLoader Connection ------------------------------- 1. Open the ``sqload-jdbc-oracle.properties`` file. 2. Configure the following parameters for: a. Postgresql, Oracle, or SQreamDB connection strings b. Oracle or SQreamDB catalogs (recommended) .. list-table:: Connection String Parameters :widths: auto :header-rows: 1 * - Parameter - Description * - ``HostIp:port`` - The host and IP address number * - ``database_name`` - The name of the database from which data is loaded * - ``user`` - Username of a role to use for connection * - ``password`` - Specifies the password of the selected role * - ``ssl`` - Specifies SSL for this connection Loading Data into SQreamDB Tables ================================= 1. Run the ``sqloader.jar`` file using the following CLI command: .. code-block:: console java -jar sqloader-0.0.6.jar 2. You may load the entire data of a source table using the following CLI command: .. code-block:: console java -jar sqloader-0.0.6.jar -table source_table_name 3. You may customize the data load either by using each of the following parameters within a CLI command or by configuring the ``properties`` file: .. list-table:: SQLoader CLI Parameters :widths: auto :header-rows: 1 * - CLI Parameter - State - Default - Description * - ``-batchsize`` - Optional - ``10.000`` - The number of records to be inserted into SQreamDB at once. Please note that the configured batch size may impact chunk sizes. * - ``-casesensative`` - Optional - ``false`` - If ``true``, keeps table name uppercase and lowercase characters when table is created in SQreamDB * - ``-chunkSize`` - Optional - ``0`` - The number of records read at once from the source database * - ``-columnlist`` - Optional - None - The name of the file that contains all column names * - ``-columns`` - Optional - All columns - The name or names of columns to be loaded into SQreamDB ("col1,col2, ...") * - ``-config`` - Optional - ``config/sqload-jdbc-oracle-incr.properties`` - Defines the configuration file you wish to use * - ``-count`` - Optional - ``true`` - Defines whether or not table rows will be counted before being loaded into SQreamDB * - ``-delete`` - Optional - ``true`` - Defines whether or not loading using Change Data Capture (CDC) includes deleted rows * - ``-drop`` - Optional - ``true`` - Defines whether or not a new target table in SQreamDB is created. If ``false``, you will need to configure a target table name using the ``-target`` parameter * - ``-fetchsize`` - Optional - ``100000`` - The number of records to be read at once from source database. * - ``-filter`` - Optional - ``1=1`` - Defines whether or not only records with SQL conditions are loaded * - ``-h, --help`` - Optional - None - Displays the help menu and exits * - ``-limit`` - Optional - ``0`` (no limit) - Limits the number of rows to be loaded * - ``-load_dttm`` - Optional - ``true`` - Add an additional ``load_dttm`` column that defines the time and date of loading * - ``-lock_check`` - Optional - ``true`` - Defines whether or not SQLoader will check source table is locked before the loading starts * - ``-lock_table`` - Optional - ``true`` - Defines whether or not SQLoader will lock target table before the loading starts * - ``-log_dir`` - Optional - ``logs`` - Defines the path of log directory created when loading data. If no value is specified, a ``logs`` folder is created under the same location as the ``sqloader.jar`` file * - ``-partition`` - Optional - None - Defines the partition to load data from if table is partitioned * - ``-rowid`` - Optional - ``false`` - Defines whether or not SQLoader will get row IDs from Oracle tables * - ``-split`` - Optional - None - Column name for split (required for multi-thread loads) * - ``-table`` - Mandatory - None - Source table name to load data from * - ``-target`` - Optional - Source table name - Target table name to load data into * - ``-target_db`` - Optional - None - Target database name to load data into * - ``-thread`` - Optional - ``1`` - Number of threads to be used during loading * - ``-truncate`` - Optional - ``false`` - Truncate target table before loading * - ``-type`` - Optional - ``full`` - Defines a loading type that affects the table that is created in SQreamDB. Options are ``full``, ``cdc``, or ``incremental``. Please note that ``cdc``, and ``incremental`` are supported only for Oracle * - ``-use_dbms_lob`` - Optional - ``true`` - Defines whether or not SQLoader uses ``dbms_lob_substr`` function for ``CLOB`` and ``BLOB`` data types * - ``-use_partitions`` - Optional - ``true`` - Defines whether or not SQLoader uses partitions in ``SELECT`` statements Using the ``type`` Parameter ============================ Using the ``type`` parameter you may define a loading type that affects the table that is created in SQreamDB. .. list-table:: The ``type`` Parameter :widths: auto :header-rows: 1 * - Loading Type - Description * - Full Table - The entire data of the source table is loaded into SQreamDB * - Change Data Capture (CDC) - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT``, ``UPDATE``, and ``DELETE`` statements. SQLoader recognizes tables by table name and metadata. Supported for Oracle only * - Incremental - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT`` statement. SQLoader recognizes the table by table name and metadata. Supported for Oracle only Data Type Mapping ================= The **SQLoader** automatically maps data types used in Postgresql and Oracle tables that are loaded into SQreamDB. .. list-table:: Postgresql :widths: auto :header-rows: 1 * - Postgresql Type - SQreamDB Type * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``NVARCHAR``, ``NVARCHAR2``, ``CHARACTER``, ``NTEXT`` - ``TEXT`` * - ``TEXT`` - ``TEXT`` * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INT``, ``TINYINT`` - ``BIGINT`` * - ``DATETIME``, ``TIMESTAMP``, ``SMALLDATETIME``, ``DATETIMEOFFSET``, ``DATETIME2`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BIT`` - ``BOOL`` * - ``decimal``, ``numeric`` - ``numeric`` * - ``float``, ``double`` - ``double`` * - ``REAL`` - ``REAL`` * - ``VARBINARY`` - ``TEXT`` .. list-table:: Oracle :widths: auto :header-rows: 1 * - Oracle Type - SQreamDB Type * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGE`` - ``BIGINT`` * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``VARCHAR2``, ``NVARCHAR``, ``NVARCHAR2``, ``CHARACTER`` - ``TEXT`` * - ``DATE``, ``DATETIME`` - ``DATETIME`` * - ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOLEAN`` - ``BOOL`` * - ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``CLOB`` - ``TEXT`` * - ``BLOB`` - ``TEXT`` CLI Examples ============ Loading data into a CDC table using the ``type`` and ``limit`` parameters: .. code-block:: console java -jar sqloader-0.0.6.jar -table source_table_name -type cdc -limit 100 Loading data into a table using your own configuration file (this will override the default configuration file): .. code-block:: console java -jar sqloader-0.0.6.jar -config path/to/your/config/file Loading data into a table using a custom configuration file: .. code-block:: console java -jar -config MyConfigFile.properties -table source_table_name -type cdc -target target_table_name -drop true -lock_check false Loading data into a table using a the ``filter`` parameter: .. code-block:: console java -jar sqloader-0.0.6.jar -table source_table_name -filter column_name>50 \ No newline at end of file +.. _ingesting_from_databases: ****************** External Databases ****************** The **SQLoader** is a CLI program that enables you to load data into SQreamDB from other databases. **SQLoader** supports Oracle and Postgresql. .. contents:: :local: :depth: 1 Before You Begin ================ It is essential that you have the following: * Java 17 * SQLoader configuration files * SQLoader.jar file Getting the SQLoader Configuration and JAR Files ================================================ 1. Download the ``.tar`` file using the following command: .. code-block:: linux curl -O https://sq-ftp-public.s3.amazonaws.com/sqloader-7.0.tar 2. Extract the ``.tar`` file using the following command: .. code-block:: linux tar -xf sqloader-7.0.tar.gz A folder named ``sqloader`` with the following files is created: .. list-table:: SQLoader Files :widths: auto :header-rows: 1 * - File - Description * - ``sqream-mapping.json`` - Maps Postgresql and Oracle data types into SQreamDB data types during ingestion * - ``sqload-jdbc-oracle.properties`` - Used for defining a connection string and may also be used to reconfigure data loading * - ``reserved_words.txt`` - A list of reserved words which cannot be used as table and/or column names * - ``sqloader.jar`` - The SQLoader package file Connection String ================= The ``sqload-jdbc.properties`` file contains a connection string that must be configured to enable data loading into SQreamDB. .. literalinclude:: connection_string.java :language: java :caption: Properties File Sample :linenos: Configuring SQLoader Connection ------------------------------- 1. Open the ``sqload-jdbc-oracle.properties`` file. 2. Configure the following parameters for: a. Either Postgresql, Oracle, or SQreamDB connection strings b. Optionally, Oracle or SQreamDB catalogs (recommended) .. list-table:: Connection String Parameters :widths: auto :header-rows: 1 * - Parameter - Description * - ``HostIp:port`` - The host and IP address number * - ``database_name`` - The name of the database from which data is loaded * - ``user`` - Username of a role to use for connection * - ``password`` - Specifies the password of the selected role * - ``ssl`` - Specifies SSL for this connection Loading Data into SQreamDB Tables ================================= 1. Run the ``sqloader.jar`` file using the following CLI command: .. code-block:: console java -jar sqloader.jar 2. You may load the entire data of a source table using the following CLI command: .. code-block:: console java -jar sqloader.jar -table source_table_name 3. You may customize the data load either by using each of the following parameters within a CLI command or by configuring the ``properties`` file: .. list-table:: SQLoader CLI Parameters :widths: auto :header-rows: 1 * - CLI Parameter - State - Default - Description * - ``-batchsize`` - Optional - ``10.000`` - The number of records to be inserted into SQreamDB at once. Please note that the configured batch size may impact chunk sizes. * - ``-casesensative`` - Optional - ``false`` - If ``true``, keeps table name uppercase and lowercase characters when table is created in SQreamDB * - ``-check_cdc_chain`` - Optional - ``false`` - Check CDC chain between tracking table and source table * - ``-chunkSize`` - Optional - ``0`` - The number of records read at once from the source database * - ``-columnlist`` - Optional - None - The name of the file that contains all column names. Columns must be separated using ``\n`` * - ``-columns`` - Optional - All columns - The name or names of columns to be loaded into SQreamDB ("col1,col2, ...") * - ``-config`` - Optional - ``config/sqload-jdbc.properties`` - Defines the configuration file you wish to use * - ``-count`` - Optional - ``true`` - Defines whether or not table rows will be counted before being loaded into SQreamDB * - ``-delete`` - Optional - ``true`` - Defines whether or not loading using Change Data Capture (CDC) includes deleted rows * - ``-drop`` - Optional - ``true`` - Defines whether or not a new target table in SQreamDB is created. If ``false``, you will need to configure a target table name using the ``-target`` parameter * - ``-fetchsize`` - Optional - ``100000`` - The number of records to be read at once from source database. * - ``-filter`` - Optional - ``1=1`` - Defines whether or not only records with SQL conditions are loaded * - ``-h, --help`` - Optional - None - Displays the help menu and exits * - ``-limit`` - Optional - ``0`` (no limit) - Limits the number of rows to be loaded * - ``-load_dttm`` - Optional - ``true`` - Add an additional ``load_dttm`` column that defines the time and date of loading * - ``-lock_check`` - Optional - ``true`` - Defines whether or not SQLoader will check source table is locked before the loading starts * - ``-lock_table`` - Optional - ``true`` - Defines whether or not SQLoader will lock target table before the loading starts * - ``-log_dir`` - Optional - ``logs`` - Defines the path of log directory created when loading data. If no value is specified, a ``logs`` folder is created under the same location as the ``sqloader.jar`` file * - ``-partition`` - Optional - None - Defines the partition to load data from if table is partitioned * - ``-rowid`` - Optional - ``false`` - Defines whether or not SQLoader will get row IDs from Oracle tables * - ``-source_db`` - Optional - ``ORCL`` - * - ``-split`` - Optional - None - Column name for split (required for multi-thread loads) * - ``-table`` - Mandatory - None - Source table name to load data from * - ``-target`` - Optional - Source table name - Target table name to load data into * - ``-target_db`` - Optional - None - Target database name to load data into * - ``-thread`` - Optional - ``1`` - Number of threads to be used during loading * - ``-truncate`` - Optional - ``false`` - Truncate target table before loading * - ``-type`` - Optional - ``full`` - Defines a loading type that affects the table that is created in SQreamDB. Options are ``full``, ``cdc``, or ``inc``. Please note that ``cdc``, and ``inc`` are supported only for Oracle * - ``-use_dbms_lob`` - Optional - ``true`` - Defines whether or not SQLoader uses ``dbms_lob_substr`` function for ``CLOB`` and ``BLOB`` data types * - ``-use_partitions`` - Optional - ``true`` - Defines whether or not SQLoader uses partitions in ``SELECT`` statements Using the ``type`` Parameter ============================ Using the ``type`` parameter you may define a loading type that affects the table that is created in SQreamDB. .. list-table:: :widths: auto :header-rows: 1 * - Loading Type - Parameter Option - Description * - Full Table - ``full`` - The entire data of the source table is loaded into SQreamDB * - Change Data Capture (CDC) - ``cdc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT``, ``UPDATE``, and ``DELETE`` statements. SQLoader recognizes tables by table name and metadata. Supported for Oracle only * - Incremental - ``inc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT`` statement. SQLoader recognizes the table by table name and metadata. Supported for Oracle only Data Type Mapping ================= The **SQLoader** automatically maps data types used in Postgresql and Oracle tables that are loaded into SQreamDB. .. list-table:: Postgresql :widths: auto :header-rows: 1 * - Postgresql Type - SQreamDB Type * - ``CHAR``, ``VARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``TEXT`` - ``TEXT`` * - ``BIGINT`` (8bytes), ``INTEGER`` (4 bytes), ``SMALLINT`` (2 bytes) - ``BIGINT`` * - ``DATETIME``, ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BIT``, ``BOOL`` - ``BOOL`` * - ``DECIMAL``, ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT`` (8 bytes), ``DOUBLE`` (4 bytes) - ``DOUBLE`` * - ``REAL`` - ``REAL`` .. list-table:: Oracle :widths: auto :header-rows: 1 * - Oracle Type - SQreamDB Type * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGE`` - ``BIGINT`` * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``VARCHAR2``, ``NVARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``DATE``, ``DATETIME`` - ``DATETIME`` * - ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOLEAN`` - ``BOOL`` * - ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``CLOB`` - ``TEXT`` * - ``BLOB`` - ``TEXT`` CLI Examples ============ Loading data into a CDC table using the ``type`` and ``limit`` parameters: .. code-block:: console java -jar sqloader.jar -table source_table_name -type cdc -limit 100 Loading data into a table using your own configuration file (this will override the default configuration file): .. code-block:: console java -jar sqloader.jar -config path/to/your/config/file Loading data into a table using a custom configuration file: .. code-block:: console java -jar -config MyConfigFile.properties -table source_table_name -type cdc -target target_table_name -drop true -lock_check false Loading data into a table using a the ``filter`` parameter: .. code-block:: console java -jar sqloader.jar -table source_table_name -filter column_name>50 \ No newline at end of file From 33f0086fe73acb85c89cdf45b502c7657eabde9b Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 5 Sep 2023 12:56:27 +0300 Subject: [PATCH 734/882] Update ingesting_from_databases.rst --- data_ingestion/ingesting_from_databases.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data_ingestion/ingesting_from_databases.rst b/data_ingestion/ingesting_from_databases.rst index 48eb7084f..ecf9ebf63 100644 --- a/data_ingestion/ingesting_from_databases.rst +++ b/data_ingestion/ingesting_from_databases.rst @@ -1 +1 @@ -.. _ingesting_from_databases: ****************** External Databases ****************** The **SQLoader** is a CLI program that enables you to load data into SQreamDB from other databases. **SQLoader** supports Oracle and Postgresql. .. contents:: :local: :depth: 1 Before You Begin ================ It is essential that you have the following: * Java 17 * SQLoader configuration files * SQLoader.jar file Getting the SQLoader Configuration and JAR Files ================================================ 1. Download the ``.tar`` file using the following command: .. code-block:: linux curl -O https://sq-ftp-public.s3.amazonaws.com/sqloader-7.0.tar 2. Extract the ``.tar`` file using the following command: .. code-block:: linux tar -xf sqloader-7.0.tar.gz A folder named ``sqloader`` with the following files is created: .. list-table:: SQLoader Files :widths: auto :header-rows: 1 * - File - Description * - ``sqream-mapping.json`` - Maps Postgresql and Oracle data types into SQreamDB data types during ingestion * - ``sqload-jdbc-oracle.properties`` - Used for defining a connection string and may also be used to reconfigure data loading * - ``reserved_words.txt`` - A list of reserved words which cannot be used as table and/or column names * - ``sqloader.jar`` - The SQLoader package file Connection String ================= The ``sqload-jdbc.properties`` file contains a connection string that must be configured to enable data loading into SQreamDB. .. literalinclude:: connection_string.java :language: java :caption: Properties File Sample :linenos: Configuring SQLoader Connection ------------------------------- 1. Open the ``sqload-jdbc-oracle.properties`` file. 2. Configure the following parameters for: a. Either Postgresql, Oracle, or SQreamDB connection strings b. Optionally, Oracle or SQreamDB catalogs (recommended) .. list-table:: Connection String Parameters :widths: auto :header-rows: 1 * - Parameter - Description * - ``HostIp:port`` - The host and IP address number * - ``database_name`` - The name of the database from which data is loaded * - ``user`` - Username of a role to use for connection * - ``password`` - Specifies the password of the selected role * - ``ssl`` - Specifies SSL for this connection Loading Data into SQreamDB Tables ================================= 1. Run the ``sqloader.jar`` file using the following CLI command: .. code-block:: console java -jar sqloader.jar 2. You may load the entire data of a source table using the following CLI command: .. code-block:: console java -jar sqloader.jar -table source_table_name 3. You may customize the data load either by using each of the following parameters within a CLI command or by configuring the ``properties`` file: .. list-table:: SQLoader CLI Parameters :widths: auto :header-rows: 1 * - CLI Parameter - State - Default - Description * - ``-batchsize`` - Optional - ``10.000`` - The number of records to be inserted into SQreamDB at once. Please note that the configured batch size may impact chunk sizes. * - ``-casesensative`` - Optional - ``false`` - If ``true``, keeps table name uppercase and lowercase characters when table is created in SQreamDB * - ``-check_cdc_chain`` - Optional - ``false`` - Check CDC chain between tracking table and source table * - ``-chunkSize`` - Optional - ``0`` - The number of records read at once from the source database * - ``-columnlist`` - Optional - None - The name of the file that contains all column names. Columns must be separated using ``\n`` * - ``-columns`` - Optional - All columns - The name or names of columns to be loaded into SQreamDB ("col1,col2, ...") * - ``-config`` - Optional - ``config/sqload-jdbc.properties`` - Defines the configuration file you wish to use * - ``-count`` - Optional - ``true`` - Defines whether or not table rows will be counted before being loaded into SQreamDB * - ``-delete`` - Optional - ``true`` - Defines whether or not loading using Change Data Capture (CDC) includes deleted rows * - ``-drop`` - Optional - ``true`` - Defines whether or not a new target table in SQreamDB is created. If ``false``, you will need to configure a target table name using the ``-target`` parameter * - ``-fetchsize`` - Optional - ``100000`` - The number of records to be read at once from source database. * - ``-filter`` - Optional - ``1=1`` - Defines whether or not only records with SQL conditions are loaded * - ``-h, --help`` - Optional - None - Displays the help menu and exits * - ``-limit`` - Optional - ``0`` (no limit) - Limits the number of rows to be loaded * - ``-load_dttm`` - Optional - ``true`` - Add an additional ``load_dttm`` column that defines the time and date of loading * - ``-lock_check`` - Optional - ``true`` - Defines whether or not SQLoader will check source table is locked before the loading starts * - ``-lock_table`` - Optional - ``true`` - Defines whether or not SQLoader will lock target table before the loading starts * - ``-log_dir`` - Optional - ``logs`` - Defines the path of log directory created when loading data. If no value is specified, a ``logs`` folder is created under the same location as the ``sqloader.jar`` file * - ``-partition`` - Optional - None - Defines the partition to load data from if table is partitioned * - ``-rowid`` - Optional - ``false`` - Defines whether or not SQLoader will get row IDs from Oracle tables * - ``-source_db`` - Optional - ``ORCL`` - * - ``-split`` - Optional - None - Column name for split (required for multi-thread loads) * - ``-table`` - Mandatory - None - Source table name to load data from * - ``-target`` - Optional - Source table name - Target table name to load data into * - ``-target_db`` - Optional - None - Target database name to load data into * - ``-thread`` - Optional - ``1`` - Number of threads to be used during loading * - ``-truncate`` - Optional - ``false`` - Truncate target table before loading * - ``-type`` - Optional - ``full`` - Defines a loading type that affects the table that is created in SQreamDB. Options are ``full``, ``cdc``, or ``inc``. Please note that ``cdc``, and ``inc`` are supported only for Oracle * - ``-use_dbms_lob`` - Optional - ``true`` - Defines whether or not SQLoader uses ``dbms_lob_substr`` function for ``CLOB`` and ``BLOB`` data types * - ``-use_partitions`` - Optional - ``true`` - Defines whether or not SQLoader uses partitions in ``SELECT`` statements Using the ``type`` Parameter ============================ Using the ``type`` parameter you may define a loading type that affects the table that is created in SQreamDB. .. list-table:: :widths: auto :header-rows: 1 * - Loading Type - Parameter Option - Description * - Full Table - ``full`` - The entire data of the source table is loaded into SQreamDB * - Change Data Capture (CDC) - ``cdc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT``, ``UPDATE``, and ``DELETE`` statements. SQLoader recognizes tables by table name and metadata. Supported for Oracle only * - Incremental - ``inc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT`` statement. SQLoader recognizes the table by table name and metadata. Supported for Oracle only Data Type Mapping ================= The **SQLoader** automatically maps data types used in Postgresql and Oracle tables that are loaded into SQreamDB. .. list-table:: Postgresql :widths: auto :header-rows: 1 * - Postgresql Type - SQreamDB Type * - ``CHAR``, ``VARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``TEXT`` - ``TEXT`` * - ``BIGINT`` (8bytes), ``INTEGER`` (4 bytes), ``SMALLINT`` (2 bytes) - ``BIGINT`` * - ``DATETIME``, ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BIT``, ``BOOL`` - ``BOOL`` * - ``DECIMAL``, ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT`` (8 bytes), ``DOUBLE`` (4 bytes) - ``DOUBLE`` * - ``REAL`` - ``REAL`` .. list-table:: Oracle :widths: auto :header-rows: 1 * - Oracle Type - SQreamDB Type * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGE`` - ``BIGINT`` * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``VARCHAR2``, ``NVARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``DATE``, ``DATETIME`` - ``DATETIME`` * - ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOLEAN`` - ``BOOL`` * - ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``CLOB`` - ``TEXT`` * - ``BLOB`` - ``TEXT`` CLI Examples ============ Loading data into a CDC table using the ``type`` and ``limit`` parameters: .. code-block:: console java -jar sqloader.jar -table source_table_name -type cdc -limit 100 Loading data into a table using your own configuration file (this will override the default configuration file): .. code-block:: console java -jar sqloader.jar -config path/to/your/config/file Loading data into a table using a custom configuration file: .. code-block:: console java -jar -config MyConfigFile.properties -table source_table_name -type cdc -target target_table_name -drop true -lock_check false Loading data into a table using a the ``filter`` parameter: .. code-block:: console java -jar sqloader.jar -table source_table_name -filter column_name>50 \ No newline at end of file +.. _ingesting_from_databases: ****************** External Databases ****************** The **SQLoader** is a CLI program that enables you to load data into SQreamDB from other databases. **SQLoader** supports Oracle and Postgresql. .. contents:: :local: :depth: 1 Before You Begin ================ It is essential that you have the following: * Java 17 * SQLoader configuration files * SQLoader.jar file Getting the SQLoader Configuration and JAR Files ================================================ 1. Download the ``.tar`` file using the following command: .. code-block:: linux curl -O https://sq-ftp-public.s3.amazonaws.com/sqloader-7.0.tar 2. Extract the ``.tar`` file using the following command: .. code-block:: linux tar -xf sqloader-7.0.tar.gz A folder named ``sqloader`` with the following files is created: .. list-table:: SQLoader Files :widths: auto :header-rows: 1 * - File - Description * - ``sqream-mapping.json`` - Maps Postgresql and Oracle data types into SQreamDB data types during ingestion * - ``sqload-jdbc.properties`` - Used for defining a connection string and may also be used to reconfigure data loading * - ``reserved_words.txt`` - A list of reserved words which cannot be used as table and/or column names * - ``sqloader.jar`` - The SQLoader package file Connection String ================= The ``sqload-jdbc.properties`` file contains a connection string that must be configured to enable data loading into SQreamDB. .. literalinclude:: connection_string.java :language: java :caption: Properties File Sample :linenos: Configuring SQLoader Connection ------------------------------- 1. Open the ``sqload-jdbc.properties`` file. 2. Configure the following parameters for: a. Either Postgresql, Oracle, or SQreamDB connection strings b. Optionally, Oracle or SQreamDB catalogs (recommended) .. list-table:: Connection String Parameters :widths: auto :header-rows: 1 * - Parameter - Description * - ``HostIp:port`` - The host and IP address number * - ``database_name`` - The name of the database from which data is loaded * - ``user`` - Username of a role to use for connection * - ``password`` - Specifies the password of the selected role * - ``ssl`` - Specifies SSL for this connection Loading Data into SQreamDB Tables ================================= 1. Run the ``sqloader.jar`` file using the following CLI command: .. code-block:: console java -jar sqloader.jar 2. You may load the entire data of a source table using the following CLI command: .. code-block:: console java -jar sqloader.jar -table source_table_name 3. You may customize the data load either by using each of the following parameters within a CLI command or by configuring the ``properties`` file: .. list-table:: SQLoader CLI Parameters :widths: auto :header-rows: 1 * - CLI Parameter - State - Default - Description * - ``-batchsize`` - Optional - ``10.000`` - The number of records to be inserted into SQreamDB at once. Please note that the configured batch size may impact chunk sizes. * - ``-casesensative`` - Optional - ``false`` - If ``true``, keeps table name uppercase and lowercase characters when table is created in SQreamDB * - ``-check_cdc_chain`` - Optional - ``false`` - Check CDC chain between tracking table and source table * - ``-chunkSize`` - Optional - ``0`` - The number of records read at once from the source database * - ``-columnlist`` - Optional - None - The name of the file that contains all column names. Columns must be separated using ``\n`` * - ``-columns`` - Optional - All columns - The name or names of columns to be loaded into SQreamDB ("col1,col2, ...") * - ``-config`` - Optional - ``config/sqload-jdbc.properties`` - Defines the configuration file you wish to use * - ``-count`` - Optional - ``true`` - Defines whether or not table rows will be counted before being loaded into SQreamDB * - ``-delete`` - Optional - ``true`` - Defines whether or not loading using Change Data Capture (CDC) includes deleted rows * - ``-drop`` - Optional - ``true`` - Defines whether or not a new target table in SQreamDB is created. If ``false``, you will need to configure a target table name using the ``-target`` parameter * - ``-fetchsize`` - Optional - ``100000`` - The number of records to be read at once from source database. * - ``-filter`` - Optional - ``1=1`` - Defines whether or not only records with SQL conditions are loaded * - ``-h, --help`` - Optional - None - Displays the help menu and exits * - ``-limit`` - Optional - ``0`` (no limit) - Limits the number of rows to be loaded * - ``-load_dttm`` - Optional - ``true`` - Add an additional ``load_dttm`` column that defines the time and date of loading * - ``-lock_check`` - Optional - ``true`` - Defines whether or not SQLoader will check source table is locked before the loading starts * - ``-lock_table`` - Optional - ``true`` - Defines whether or not SQLoader will lock target table before the loading starts * - ``-log_dir`` - Optional - ``logs`` - Defines the path of log directory created when loading data. If no value is specified, a ``logs`` folder is created under the same location as the ``sqloader.jar`` file * - ``-partition`` - Optional - None - Defines the partition to load data from if table is partitioned * - ``-rowid`` - Optional - ``false`` - Defines whether or not SQLoader will get row IDs from Oracle tables * - ``-source_db`` - Optional - ``ORCL`` - * - ``-split`` - Optional - None - Column name for split (required for multi-thread loads) * - ``-table`` - Mandatory - None - Source table name to load data from * - ``-target`` - Optional - Source table name - Target table name to load data into * - ``-target_db`` - Optional - None - Target database name to load data into * - ``-thread`` - Optional - ``1`` - Number of threads to be used during loading * - ``-truncate`` - Optional - ``false`` - Truncate target table before loading * - ``-type`` - Optional - ``full`` - Defines a loading type that affects the table that is created in SQreamDB. Options are ``full``, ``cdc``, or ``inc``. Please note that ``cdc``, and ``inc`` are supported only for Oracle * - ``-use_dbms_lob`` - Optional - ``true`` - Defines whether or not SQLoader uses ``dbms_lob_substr`` function for ``CLOB`` and ``BLOB`` data types * - ``-use_partitions`` - Optional - ``true`` - Defines whether or not SQLoader uses partitions in ``SELECT`` statements Using the ``type`` Parameter ============================ Using the ``type`` parameter you may define a loading type that affects the table that is created in SQreamDB. .. list-table:: :widths: auto :header-rows: 1 * - Loading Type - Parameter Option - Description * - Full Table - ``full`` - The entire data of the source table is loaded into SQreamDB * - Change Data Capture (CDC) - ``cdc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT``, ``UPDATE``, and ``DELETE`` statements. SQLoader recognizes tables by table name and metadata. Supported for Oracle only * - Incremental - ``inc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT`` statement. SQLoader recognizes the table by table name and metadata. Supported for Oracle only Data Type Mapping ================= The **SQLoader** automatically maps data types used in Postgresql and Oracle tables that are loaded into SQreamDB. .. list-table:: Postgresql :widths: auto :header-rows: 1 * - Postgresql Type - SQreamDB Type * - ``CHAR``, ``VARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``TEXT`` - ``TEXT`` * - ``BIGINT`` (8bytes), ``INTEGER`` (4 bytes), ``SMALLINT`` (2 bytes) - ``BIGINT`` * - ``DATETIME``, ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BIT``, ``BOOL`` - ``BOOL`` * - ``DECIMAL``, ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT`` (8 bytes), ``DOUBLE`` (4 bytes) - ``DOUBLE`` * - ``REAL`` - ``REAL`` .. list-table:: Oracle :widths: auto :header-rows: 1 * - Oracle Type - SQreamDB Type * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGE`` - ``BIGINT`` * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``VARCHAR2``, ``NVARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``DATE``, ``DATETIME`` - ``DATETIME`` * - ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOLEAN`` - ``BOOL`` * - ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``CLOB`` - ``TEXT`` * - ``BLOB`` - ``TEXT`` CLI Examples ============ Loading data into a CDC table using the ``type`` and ``limit`` parameters: .. code-block:: console java -jar sqloader.jar -table source_table_name -type cdc -limit 100 Loading data into a table using your own configuration file (this will override the default configuration file): .. code-block:: console java -jar sqloader.jar -config path/to/your/config/file Loading data into a table using a custom configuration file: .. code-block:: console java -jar -config MyConfigFile.properties -table source_table_name -type cdc -target target_table_name -drop true -lock_check false Loading data into a table using a the ``filter`` parameter: .. code-block:: console java -jar sqloader.jar -table source_table_name -filter column_name>50 \ No newline at end of file From c3b7fa12073b34f2a170f1e71b723a728c863754 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 5 Sep 2023 15:18:57 +0300 Subject: [PATCH 735/882] Update ingesting_from_databases.rst --- data_ingestion/ingesting_from_databases.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data_ingestion/ingesting_from_databases.rst b/data_ingestion/ingesting_from_databases.rst index ecf9ebf63..3ace7f4b7 100644 --- a/data_ingestion/ingesting_from_databases.rst +++ b/data_ingestion/ingesting_from_databases.rst @@ -1 +1 @@ -.. _ingesting_from_databases: ****************** External Databases ****************** The **SQLoader** is a CLI program that enables you to load data into SQreamDB from other databases. **SQLoader** supports Oracle and Postgresql. .. contents:: :local: :depth: 1 Before You Begin ================ It is essential that you have the following: * Java 17 * SQLoader configuration files * SQLoader.jar file Getting the SQLoader Configuration and JAR Files ================================================ 1. Download the ``.tar`` file using the following command: .. code-block:: linux curl -O https://sq-ftp-public.s3.amazonaws.com/sqloader-7.0.tar 2. Extract the ``.tar`` file using the following command: .. code-block:: linux tar -xf sqloader-7.0.tar.gz A folder named ``sqloader`` with the following files is created: .. list-table:: SQLoader Files :widths: auto :header-rows: 1 * - File - Description * - ``sqream-mapping.json`` - Maps Postgresql and Oracle data types into SQreamDB data types during ingestion * - ``sqload-jdbc.properties`` - Used for defining a connection string and may also be used to reconfigure data loading * - ``reserved_words.txt`` - A list of reserved words which cannot be used as table and/or column names * - ``sqloader.jar`` - The SQLoader package file Connection String ================= The ``sqload-jdbc.properties`` file contains a connection string that must be configured to enable data loading into SQreamDB. .. literalinclude:: connection_string.java :language: java :caption: Properties File Sample :linenos: Configuring SQLoader Connection ------------------------------- 1. Open the ``sqload-jdbc.properties`` file. 2. Configure the following parameters for: a. Either Postgresql, Oracle, or SQreamDB connection strings b. Optionally, Oracle or SQreamDB catalogs (recommended) .. list-table:: Connection String Parameters :widths: auto :header-rows: 1 * - Parameter - Description * - ``HostIp:port`` - The host and IP address number * - ``database_name`` - The name of the database from which data is loaded * - ``user`` - Username of a role to use for connection * - ``password`` - Specifies the password of the selected role * - ``ssl`` - Specifies SSL for this connection Loading Data into SQreamDB Tables ================================= 1. Run the ``sqloader.jar`` file using the following CLI command: .. code-block:: console java -jar sqloader.jar 2. You may load the entire data of a source table using the following CLI command: .. code-block:: console java -jar sqloader.jar -table source_table_name 3. You may customize the data load either by using each of the following parameters within a CLI command or by configuring the ``properties`` file: .. list-table:: SQLoader CLI Parameters :widths: auto :header-rows: 1 * - CLI Parameter - State - Default - Description * - ``-batchsize`` - Optional - ``10.000`` - The number of records to be inserted into SQreamDB at once. Please note that the configured batch size may impact chunk sizes. * - ``-casesensative`` - Optional - ``false`` - If ``true``, keeps table name uppercase and lowercase characters when table is created in SQreamDB * - ``-check_cdc_chain`` - Optional - ``false`` - Check CDC chain between tracking table and source table * - ``-chunkSize`` - Optional - ``0`` - The number of records read at once from the source database * - ``-columnlist`` - Optional - None - The name of the file that contains all column names. Columns must be separated using ``\n`` * - ``-columns`` - Optional - All columns - The name or names of columns to be loaded into SQreamDB ("col1,col2, ...") * - ``-config`` - Optional - ``config/sqload-jdbc.properties`` - Defines the configuration file you wish to use * - ``-count`` - Optional - ``true`` - Defines whether or not table rows will be counted before being loaded into SQreamDB * - ``-delete`` - Optional - ``true`` - Defines whether or not loading using Change Data Capture (CDC) includes deleted rows * - ``-drop`` - Optional - ``true`` - Defines whether or not a new target table in SQreamDB is created. If ``false``, you will need to configure a target table name using the ``-target`` parameter * - ``-fetchsize`` - Optional - ``100000`` - The number of records to be read at once from source database. * - ``-filter`` - Optional - ``1=1`` - Defines whether or not only records with SQL conditions are loaded * - ``-h, --help`` - Optional - None - Displays the help menu and exits * - ``-limit`` - Optional - ``0`` (no limit) - Limits the number of rows to be loaded * - ``-load_dttm`` - Optional - ``true`` - Add an additional ``load_dttm`` column that defines the time and date of loading * - ``-lock_check`` - Optional - ``true`` - Defines whether or not SQLoader will check source table is locked before the loading starts * - ``-lock_table`` - Optional - ``true`` - Defines whether or not SQLoader will lock target table before the loading starts * - ``-log_dir`` - Optional - ``logs`` - Defines the path of log directory created when loading data. If no value is specified, a ``logs`` folder is created under the same location as the ``sqloader.jar`` file * - ``-partition`` - Optional - None - Defines the partition to load data from if table is partitioned * - ``-rowid`` - Optional - ``false`` - Defines whether or not SQLoader will get row IDs from Oracle tables * - ``-source_db`` - Optional - ``ORCL`` - * - ``-split`` - Optional - None - Column name for split (required for multi-thread loads) * - ``-table`` - Mandatory - None - Source table name to load data from * - ``-target`` - Optional - Source table name - Target table name to load data into * - ``-target_db`` - Optional - None - Target database name to load data into * - ``-thread`` - Optional - ``1`` - Number of threads to be used during loading * - ``-truncate`` - Optional - ``false`` - Truncate target table before loading * - ``-type`` - Optional - ``full`` - Defines a loading type that affects the table that is created in SQreamDB. Options are ``full``, ``cdc``, or ``inc``. Please note that ``cdc``, and ``inc`` are supported only for Oracle * - ``-use_dbms_lob`` - Optional - ``true`` - Defines whether or not SQLoader uses ``dbms_lob_substr`` function for ``CLOB`` and ``BLOB`` data types * - ``-use_partitions`` - Optional - ``true`` - Defines whether or not SQLoader uses partitions in ``SELECT`` statements Using the ``type`` Parameter ============================ Using the ``type`` parameter you may define a loading type that affects the table that is created in SQreamDB. .. list-table:: :widths: auto :header-rows: 1 * - Loading Type - Parameter Option - Description * - Full Table - ``full`` - The entire data of the source table is loaded into SQreamDB * - Change Data Capture (CDC) - ``cdc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT``, ``UPDATE``, and ``DELETE`` statements. SQLoader recognizes tables by table name and metadata. Supported for Oracle only * - Incremental - ``inc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT`` statement. SQLoader recognizes the table by table name and metadata. Supported for Oracle only Data Type Mapping ================= The **SQLoader** automatically maps data types used in Postgresql and Oracle tables that are loaded into SQreamDB. .. list-table:: Postgresql :widths: auto :header-rows: 1 * - Postgresql Type - SQreamDB Type * - ``CHAR``, ``VARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``TEXT`` - ``TEXT`` * - ``BIGINT`` (8bytes), ``INTEGER`` (4 bytes), ``SMALLINT`` (2 bytes) - ``BIGINT`` * - ``DATETIME``, ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BIT``, ``BOOL`` - ``BOOL`` * - ``DECIMAL``, ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT`` (8 bytes), ``DOUBLE`` (4 bytes) - ``DOUBLE`` * - ``REAL`` - ``REAL`` .. list-table:: Oracle :widths: auto :header-rows: 1 * - Oracle Type - SQreamDB Type * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGE`` - ``BIGINT`` * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``VARCHAR2``, ``NVARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``DATE``, ``DATETIME`` - ``DATETIME`` * - ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOLEAN`` - ``BOOL`` * - ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``CLOB`` - ``TEXT`` * - ``BLOB`` - ``TEXT`` CLI Examples ============ Loading data into a CDC table using the ``type`` and ``limit`` parameters: .. code-block:: console java -jar sqloader.jar -table source_table_name -type cdc -limit 100 Loading data into a table using your own configuration file (this will override the default configuration file): .. code-block:: console java -jar sqloader.jar -config path/to/your/config/file Loading data into a table using a custom configuration file: .. code-block:: console java -jar -config MyConfigFile.properties -table source_table_name -type cdc -target target_table_name -drop true -lock_check false Loading data into a table using a the ``filter`` parameter: .. code-block:: console java -jar sqloader.jar -table source_table_name -filter column_name>50 \ No newline at end of file +.. _ingesting_from_databases: ****************** External Databases ****************** The **SQLoader** is a CLI program that enables you to load data into SQreamDB from other databases. **SQLoader** supports Oracle and Postgresql. .. contents:: :local: :depth: 1 Before You Begin ================ It is essential that you have the following: * Java 17 * SQLoader configuration files * SQLoader.jar file Getting the SQLoader Configuration and JAR Files ================================================ 1. Download the ``.tar`` file using the following command: .. code-block:: linux curl -O https://sq-ftp-public.s3.amazonaws.com/sqloader-7.0.tar 2. Extract the ``.tar`` file using the following command: .. code-block:: linux tar -xf sqloader-7.0.tar.gz A folder named ``sqloader`` with the following files is created: .. list-table:: SQLoader Files :widths: auto :header-rows: 1 * - File - Description * - ``sqream-mapping.json`` - Maps Postgresql and Oracle data types into SQreamDB data types during ingestion * - ``sqload-jdbc.properties`` - Used for defining a connection string and may also be used to reconfigure data loading * - ``reserved_words.txt`` - A list of reserved words which cannot be used as table and/or column names * - ``sqloader.jar`` - The SQLoader package file Connection String ================= The ``sqload-jdbc.properties`` file contains a connection string that must be configured to enable data loading into SQreamDB. .. literalinclude:: connection_string.java :language: java :caption: Properties File Sample :linenos: Configuring SQLoader Connection ------------------------------- 1. Open the ``sqload-jdbc.properties`` file. 2. Configure the following parameters for: a. Either Postgresql, Oracle, or SQreamDB connection strings b. Optionally, Oracle or SQreamDB catalogs (recommended) .. list-table:: Connection String Parameters :widths: auto :header-rows: 1 * - Parameter - Description * - ``HostIp:port`` - The host and IP address number * - ``database_name`` - The name of the database from which data is loaded * - ``user`` - Username of a role to use for connection * - ``password`` - Specifies the password of the selected role * - ``ssl`` - Specifies SSL for this connection Loading Data into SQreamDB Tables ================================= 1. Run the ``sqloader.jar`` file using the following CLI command: .. code-block:: console java -jar sqloader.jar 2. You may load the entire data of a source table using the following CLI command: .. code-block:: console java -jar sqloader.jar -table source_table_name 3. You may customize the data load either by using each of the following parameters within a CLI command or by configuring the ``properties`` file: .. list-table:: SQLoader CLI Parameters :widths: auto :header-rows: 1 * - CLI Parameter - State - Default - Description * - ``-batchsize`` - Optional - ``10.000`` - The number of records to be inserted into SQreamDB at once. Please note that the configured batch size may impact chunk sizes. * - ``-casesensative`` - Optional - ``false`` - If ``true``, keeps table name uppercase and lowercase characters when table is created in SQreamDB * - ``-check_cdc_chain`` - Optional - ``false`` - Check CDC chain between tracking table and source table * - ``-chunkSize`` - Optional - ``0`` - The number of records read at once from the source database * - ``-columnlist`` - Optional - None - The name of the file that contains all column names. Columns must be separated using ``\n`` * - ``-columns`` - Optional - All columns - The name or names of columns to be loaded into SQreamDB ("col1,col2, ...") * - ``-config`` - Optional - ``config/sqload-jdbc.properties`` - Defines the configuration file you wish to use * - ``-count`` - Optional - ``true`` - Defines whether or not table rows will be counted before being loaded into SQreamDB * - ``-delete`` - Optional - ``true`` - Defines whether or not loading using Change Data Capture (CDC) includes deleted rows * - ``-drop`` - Optional - ``true`` - Defines whether or not a new target table in SQreamDB is created. If ``false``, you will need to configure a target table name using the ``-target`` parameter * - ``-fetchsize`` - Optional - ``100000`` - The number of records to be read at once from source database. * - ``-filter`` - Optional - ``1=1`` - Defines whether or not only records with SQL conditions are loaded * - ``-h, --help`` - Optional - None - Displays the help menu and exits * - ``-limit`` - Optional - ``0`` (no limit) - Limits the number of rows to be loaded * - ``-load_dttm`` - Optional - ``true`` - Add an additional ``load_dttm`` column that defines the time and date of loading * - ``-lock_check`` - Optional - ``true`` - Defines whether or not SQLoader will check source table is locked before the loading starts * - ``-lock_table`` - Optional - ``true`` - Defines whether or not SQLoader will lock target table before the loading starts * - ``-log_dir`` - Optional - ``logs`` - Defines the path of log directory created when loading data. If no value is specified, a ``logs`` folder is created under the same location as the ``sqloader.jar`` file * - ``-partition`` - Optional - None - Defines the partition to load data from if table is partitioned * - ``-rowid`` - Optional - ``false`` - Defines whether or not SQLoader will get row IDs from Oracle tables * - ``-source_db`` - Optional - ``ORCL`` - Defines the source database name. It does not modify the database connection string but impacts the storage and retrieval of data within catalog tables. * - ``-split`` - Optional - None - Column name for split (required for multi-thread loads) * - ``-table`` - Mandatory - None - Source table name to load data from * - ``-target`` - Optional - Source table name - Target table name to load data into * - ``-target_db`` - Optional - None - Target database name to load data into * - ``-thread`` - Optional - ``1`` - Number of threads to be used during loading * - ``-truncate`` - Optional - ``false`` - Truncate target table before loading * - ``-type`` - Optional - ``full`` - Defines a loading type that affects the table that is created in SQreamDB. Options are ``full``, ``cdc``, or ``inc``. Please note that ``cdc``, and ``inc`` are supported only for Oracle * - ``-use_dbms_lob`` - Optional - ``true`` - Defines whether or not SQLoader uses ``dbms_lob_substr`` function for ``CLOB`` and ``BLOB`` data types * - ``-use_partitions`` - Optional - ``true`` - Defines whether or not SQLoader uses partitions in ``SELECT`` statements Using the ``type`` Parameter ============================ Using the ``type`` parameter you may define a loading type that affects the table that is created in SQreamDB. .. list-table:: :widths: auto :header-rows: 1 * - Loading Type - Parameter Option - Description * - Full Table - ``full`` - The entire data of the source table is loaded into SQreamDB * - Change Data Capture (CDC) - ``cdc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT``, ``UPDATE``, and ``DELETE`` statements. SQLoader recognizes tables by table name and metadata. Supported for Oracle only * - Incremental - ``inc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT`` statement. SQLoader recognizes the table by table name and metadata. Supported for Oracle only Data Type Mapping ================= The **SQLoader** automatically maps data types used in Postgresql and Oracle tables that are loaded into SQreamDB. .. list-table:: Postgresql :widths: auto :header-rows: 1 * - Postgresql Type - SQreamDB Type * - ``CHAR``, ``VARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``TEXT`` - ``TEXT`` * - ``INT``, ``SMALLINT``, ``BIGINT``, ``INT2``, ``INT8`` - ``BIGINT`` * - ``DATETIME``, ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BIT``, ``BOOL`` - ``BOOL`` * - ``DECIMAL``, ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``REAL``, ``FLOAT4`` - ``REAL`` .. list-table:: Oracle :widths: auto :header-rows: 1 * - Oracle Type - SQreamDB Type * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGE`` - ``BIGINT`` * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``VARCHAR2``, ``NVARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``DATE``, ``DATETIME`` - ``DATETIME`` * - ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOLEAN`` - ``BOOL`` * - ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``CLOB`` - ``TEXT`` * - ``BLOB`` - ``TEXT`` CLI Examples ============ Loading data into a CDC table using the ``type`` and ``limit`` parameters: .. code-block:: console java -jar sqloader.jar -table source_table_name -type cdc -limit 100 Loading data into a table using your own configuration file (this will override the default configuration file): .. code-block:: console java -jar sqloader.jar -config path/to/your/config/file Loading data into a table using a custom configuration file: .. code-block:: console java -jar -config MyConfigFile.properties -table source_table_name -type cdc -target target_table_name -drop true -lock_check false Loading data into a table using a the ``filter`` parameter: .. code-block:: console java -jar sqloader.jar -table source_table_name -filter column_name>50 \ No newline at end of file From 1fae8fc518a0652cf798ea9ea89e3409030cfb76 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 5 Sep 2023 15:39:07 +0300 Subject: [PATCH 736/882] Update ingesting_from_databases.rst --- data_ingestion/ingesting_from_databases.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data_ingestion/ingesting_from_databases.rst b/data_ingestion/ingesting_from_databases.rst index 3ace7f4b7..d6324b517 100644 --- a/data_ingestion/ingesting_from_databases.rst +++ b/data_ingestion/ingesting_from_databases.rst @@ -1 +1 @@ -.. _ingesting_from_databases: ****************** External Databases ****************** The **SQLoader** is a CLI program that enables you to load data into SQreamDB from other databases. **SQLoader** supports Oracle and Postgresql. .. contents:: :local: :depth: 1 Before You Begin ================ It is essential that you have the following: * Java 17 * SQLoader configuration files * SQLoader.jar file Getting the SQLoader Configuration and JAR Files ================================================ 1. Download the ``.tar`` file using the following command: .. code-block:: linux curl -O https://sq-ftp-public.s3.amazonaws.com/sqloader-7.0.tar 2. Extract the ``.tar`` file using the following command: .. code-block:: linux tar -xf sqloader-7.0.tar.gz A folder named ``sqloader`` with the following files is created: .. list-table:: SQLoader Files :widths: auto :header-rows: 1 * - File - Description * - ``sqream-mapping.json`` - Maps Postgresql and Oracle data types into SQreamDB data types during ingestion * - ``sqload-jdbc.properties`` - Used for defining a connection string and may also be used to reconfigure data loading * - ``reserved_words.txt`` - A list of reserved words which cannot be used as table and/or column names * - ``sqloader.jar`` - The SQLoader package file Connection String ================= The ``sqload-jdbc.properties`` file contains a connection string that must be configured to enable data loading into SQreamDB. .. literalinclude:: connection_string.java :language: java :caption: Properties File Sample :linenos: Configuring SQLoader Connection ------------------------------- 1. Open the ``sqload-jdbc.properties`` file. 2. Configure the following parameters for: a. Either Postgresql, Oracle, or SQreamDB connection strings b. Optionally, Oracle or SQreamDB catalogs (recommended) .. list-table:: Connection String Parameters :widths: auto :header-rows: 1 * - Parameter - Description * - ``HostIp:port`` - The host and IP address number * - ``database_name`` - The name of the database from which data is loaded * - ``user`` - Username of a role to use for connection * - ``password`` - Specifies the password of the selected role * - ``ssl`` - Specifies SSL for this connection Loading Data into SQreamDB Tables ================================= 1. Run the ``sqloader.jar`` file using the following CLI command: .. code-block:: console java -jar sqloader.jar 2. You may load the entire data of a source table using the following CLI command: .. code-block:: console java -jar sqloader.jar -table source_table_name 3. You may customize the data load either by using each of the following parameters within a CLI command or by configuring the ``properties`` file: .. list-table:: SQLoader CLI Parameters :widths: auto :header-rows: 1 * - CLI Parameter - State - Default - Description * - ``-batchsize`` - Optional - ``10.000`` - The number of records to be inserted into SQreamDB at once. Please note that the configured batch size may impact chunk sizes. * - ``-casesensative`` - Optional - ``false`` - If ``true``, keeps table name uppercase and lowercase characters when table is created in SQreamDB * - ``-check_cdc_chain`` - Optional - ``false`` - Check CDC chain between tracking table and source table * - ``-chunkSize`` - Optional - ``0`` - The number of records read at once from the source database * - ``-columnlist`` - Optional - None - The name of the file that contains all column names. Columns must be separated using ``\n`` * - ``-columns`` - Optional - All columns - The name or names of columns to be loaded into SQreamDB ("col1,col2, ...") * - ``-config`` - Optional - ``config/sqload-jdbc.properties`` - Defines the configuration file you wish to use * - ``-count`` - Optional - ``true`` - Defines whether or not table rows will be counted before being loaded into SQreamDB * - ``-delete`` - Optional - ``true`` - Defines whether or not loading using Change Data Capture (CDC) includes deleted rows * - ``-drop`` - Optional - ``true`` - Defines whether or not a new target table in SQreamDB is created. If ``false``, you will need to configure a target table name using the ``-target`` parameter * - ``-fetchsize`` - Optional - ``100000`` - The number of records to be read at once from source database. * - ``-filter`` - Optional - ``1=1`` - Defines whether or not only records with SQL conditions are loaded * - ``-h, --help`` - Optional - None - Displays the help menu and exits * - ``-limit`` - Optional - ``0`` (no limit) - Limits the number of rows to be loaded * - ``-load_dttm`` - Optional - ``true`` - Add an additional ``load_dttm`` column that defines the time and date of loading * - ``-lock_check`` - Optional - ``true`` - Defines whether or not SQLoader will check source table is locked before the loading starts * - ``-lock_table`` - Optional - ``true`` - Defines whether or not SQLoader will lock target table before the loading starts * - ``-log_dir`` - Optional - ``logs`` - Defines the path of log directory created when loading data. If no value is specified, a ``logs`` folder is created under the same location as the ``sqloader.jar`` file * - ``-partition`` - Optional - None - Defines the partition to load data from if table is partitioned * - ``-rowid`` - Optional - ``false`` - Defines whether or not SQLoader will get row IDs from Oracle tables * - ``-source_db`` - Optional - ``ORCL`` - Defines the source database name. It does not modify the database connection string but impacts the storage and retrieval of data within catalog tables. * - ``-split`` - Optional - None - Column name for split (required for multi-thread loads) * - ``-table`` - Mandatory - None - Source table name to load data from * - ``-target`` - Optional - Source table name - Target table name to load data into * - ``-target_db`` - Optional - None - Target database name to load data into * - ``-thread`` - Optional - ``1`` - Number of threads to be used during loading * - ``-truncate`` - Optional - ``false`` - Truncate target table before loading * - ``-type`` - Optional - ``full`` - Defines a loading type that affects the table that is created in SQreamDB. Options are ``full``, ``cdc``, or ``inc``. Please note that ``cdc``, and ``inc`` are supported only for Oracle * - ``-use_dbms_lob`` - Optional - ``true`` - Defines whether or not SQLoader uses ``dbms_lob_substr`` function for ``CLOB`` and ``BLOB`` data types * - ``-use_partitions`` - Optional - ``true`` - Defines whether or not SQLoader uses partitions in ``SELECT`` statements Using the ``type`` Parameter ============================ Using the ``type`` parameter you may define a loading type that affects the table that is created in SQreamDB. .. list-table:: :widths: auto :header-rows: 1 * - Loading Type - Parameter Option - Description * - Full Table - ``full`` - The entire data of the source table is loaded into SQreamDB * - Change Data Capture (CDC) - ``cdc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT``, ``UPDATE``, and ``DELETE`` statements. SQLoader recognizes tables by table name and metadata. Supported for Oracle only * - Incremental - ``inc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT`` statement. SQLoader recognizes the table by table name and metadata. Supported for Oracle only Data Type Mapping ================= The **SQLoader** automatically maps data types used in Postgresql and Oracle tables that are loaded into SQreamDB. .. list-table:: Postgresql :widths: auto :header-rows: 1 * - Postgresql Type - SQreamDB Type * - ``CHAR``, ``VARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``TEXT`` - ``TEXT`` * - ``INT``, ``SMALLINT``, ``BIGINT``, ``INT2``, ``INT8`` - ``BIGINT`` * - ``DATETIME``, ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BIT``, ``BOOL`` - ``BOOL`` * - ``DECIMAL``, ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``REAL``, ``FLOAT4`` - ``REAL`` .. list-table:: Oracle :widths: auto :header-rows: 1 * - Oracle Type - SQreamDB Type * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGE`` - ``BIGINT`` * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``VARCHAR2``, ``NVARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``DATE``, ``DATETIME`` - ``DATETIME`` * - ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOLEAN`` - ``BOOL`` * - ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``CLOB`` - ``TEXT`` * - ``BLOB`` - ``TEXT`` CLI Examples ============ Loading data into a CDC table using the ``type`` and ``limit`` parameters: .. code-block:: console java -jar sqloader.jar -table source_table_name -type cdc -limit 100 Loading data into a table using your own configuration file (this will override the default configuration file): .. code-block:: console java -jar sqloader.jar -config path/to/your/config/file Loading data into a table using a custom configuration file: .. code-block:: console java -jar -config MyConfigFile.properties -table source_table_name -type cdc -target target_table_name -drop true -lock_check false Loading data into a table using a the ``filter`` parameter: .. code-block:: console java -jar sqloader.jar -table source_table_name -filter column_name>50 \ No newline at end of file +.. _ingesting_from_databases: ****************** External Databases ****************** The **SQLoader** is a CLI program that enables you to load data into SQreamDB from other databases. **SQLoader** supports Oracle and Postgresql. .. contents:: :local: :depth: 1 Before You Begin ================ It is essential that you have the following: * Java 17 * SQLoader configuration files * SQLoader.jar file Getting the SQLoader Configuration and JAR Files ================================================ 1. Download the ``.tar`` file using the following command: .. code-block:: linux curl -O https://sq-ftp-public.s3.amazonaws.com/sqloader-7.0.tar 2. Extract the ``.tar`` file using the following command: .. code-block:: linux tar -xf sqloader-7.0.tar.gz A folder named ``sqloader`` with the following files is created: .. list-table:: SQLoader Files :widths: auto :header-rows: 1 * - File - Description * - ``sqream-mapping.json`` - Maps Postgresql and Oracle data types into SQreamDB data types during ingestion * - ``sqload-jdbc.properties`` - Used for defining a connection string and may also be used to reconfigure data loading * - ``reserved_words.txt`` - A list of reserved words which cannot be used as table and/or column names * - ``sqloader.jar`` - The SQLoader package file Connection String ================= The ``sqload-jdbc.properties`` file contains a connection string that must be configured to enable data loading into SQreamDB. .. literalinclude:: connection_string.java :language: java :caption: Properties File Sample :linenos: Configuring SQLoader Connection ------------------------------- 1. Open the ``sqload-jdbc.properties`` file. 2. Configure the following parameters for: a. Either Postgresql, Oracle, or SQreamDB connection strings b. Optionally, Oracle or SQreamDB catalogs (recommended) .. list-table:: Connection String Parameters :widths: auto :header-rows: 1 * - Parameter - Description * - ``HostIp:port`` - The host and IP address number * - ``database_name`` - The name of the database from which data is loaded * - ``user`` - Username of a role to use for connection * - ``password`` - Specifies the password of the selected role * - ``ssl`` - Specifies SSL for this connection Loading Data into SQreamDB Tables ================================= 1. Run the ``sqloader.jar`` file using the following CLI command: .. code-block:: console java -jar sqloader.jar 2. You may load the entire data of a source table using the following CLI command: .. code-block:: console java -jar sqloader.jar -table source_table_name 3. You may customize the data load either by using each of the following parameters within a CLI command or by configuring the ``properties`` file: .. list-table:: SQLoader CLI Parameters :widths: auto :header-rows: 1 * - CLI Parameter - State - Default - Description * - ``-batchsize`` - Optional - ``10.000`` - The number of records to be inserted into SQreamDB at once. Please note that the configured batch size may impact chunk sizes. * - ``-casesensative`` - Optional - ``false`` - If ``true``, keeps table name uppercase and lowercase characters when table is created in SQreamDB * - ``-check_cdc_chain`` - Optional - ``false`` - Check CDC chain between tracking table and source table * - ``-chunkSize`` - Optional - ``0`` - The number of records read at once from the source database * - ``-columnlist`` - Optional - None - The name of the file that contains all column names. Columns must be separated using ``\n`` * - ``-columns`` - Optional - All columns - The name or names of columns to be loaded into SQreamDB ("col1,col2, ...") * - ``-config`` - Optional - ``config/sqload-jdbc.properties`` - Defines the configuration file you wish to use * - ``-count`` - Optional - ``true`` - Defines whether or not table rows will be counted before being loaded into SQreamDB * - ``-delete`` - Optional - ``true`` - Defines whether or not loading using Change Data Capture (CDC) includes deleted rows * - ``-drop`` - Optional - ``true`` - Defines whether or not a new target table in SQreamDB is created. If ``false``, you will need to configure a target table name using the ``-target`` parameter * - ``-fetchsize`` - Optional - ``100000`` - The number of records to be read at once from source database. * - ``-filter`` - Optional - ``1=1`` - Defines whether or not only records with SQL conditions are loaded * - ``-h, --help`` - Optional - None - Displays the help menu and exits * - ``-limit`` - Optional - ``0`` (no limit) - Limits the number of rows to be loaded * - ``-load_dttm`` - Optional - ``true`` - Add an additional ``load_dttm`` column that defines the time and date of loading * - ``-lock_check`` - Optional - ``true`` - Defines whether or not SQLoader will check source table is locked before the loading starts * - ``-lock_table`` - Optional - ``true`` - Defines whether or not SQLoader will lock target table before the loading starts * - ``-log_dir`` - Optional - ``logs`` - Defines the path of log directory created when loading data. If no value is specified, a ``logs`` folder is created under the same location as the ``sqloader.jar`` file * - ``-partition`` - Optional - None - Defines the partition to load data from if table is partitioned * - ``-rowid`` - Optional - ``false`` - Defines whether or not SQLoader will get row IDs from Oracle tables * - ``-source_db`` - Optional - ``ORCL`` - Defines the source database name. It does not modify the database connection string but impacts the storage and retrieval of data within catalog tables. * - ``-split`` - Optional - None - Column name for split (required for multi-thread loads) * - ``-table`` - Mandatory - None - Source table name to load data from * - ``-target`` - Optional - Source table name - Target table name to load data into * - ``-target_db`` - Optional - None - Target database name to load data into * - ``-thread`` - Optional - ``1`` - Number of threads to be used during loading * - ``-truncate`` - Optional - ``false`` - Truncate target table before loading * - ``-type`` - Optional - ``full`` - Defines a loading type that affects the table that is created in SQreamDB. Options are ``full``, ``cdc``, or ``inc``. Please note that ``cdc``, and ``inc`` are supported only for Oracle * - ``-use_dbms_lob`` - Optional - ``true`` - Defines whether or not SQLoader uses ``dbms_lob_substr`` function for ``CLOB`` and ``BLOB`` data types * - ``-use_partitions`` - Optional - ``true`` - Defines whether or not SQLoader uses partitions in ``SELECT`` statements Using the ``type`` Parameter ============================ Using the ``type`` parameter you may define a loading type that affects the table that is created in SQreamDB. .. list-table:: :widths: auto :header-rows: 1 * - Loading Type - Parameter Option - Description * - Full Table - ``full`` - The entire data of the source table is loaded into SQreamDB * - Change Data Capture (CDC) - ``cdc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT``, ``UPDATE``, and ``DELETE`` statements. SQLoader recognizes tables by table name and metadata. Supported for Oracle only * - Incremental - ``inc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT`` statement. SQLoader recognizes the table by table name and metadata. Supported for Oracle only Data Type Mapping ================= The **SQLoader** automatically maps data types used in Postgresql and Oracle tables that are loaded into SQreamDB. .. list-table:: Postgresql :widths: auto :header-rows: 1 * - Postgresql Type - SQreamDB Type * - ``CHAR``, ``VARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``TEXT`` - ``TEXT`` * - ``INT``, ``SMALLINT``, ``BIGINT``, ``INT2``, ``INT4`` ``INT8`` - ``BIGINT`` * - ``DATETIME``, ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BIT``, ``BOOL`` - ``BOOL`` * - ``DECIMAL``, ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``REAL``, ``FLOAT4`` - ``REAL`` .. list-table:: Oracle :widths: auto :header-rows: 1 * - Oracle Type - SQreamDB Type * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGE`` - ``BIGINT`` * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``VARCHAR2``, ``NVARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``DATE``, ``DATETIME`` - ``DATETIME`` * - ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOLEAN`` - ``BOOL`` * - ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``CLOB`` - ``TEXT`` * - ``BLOB`` - ``TEXT`` CLI Examples ============ Loading data into a CDC table using the ``type`` and ``limit`` parameters: .. code-block:: console java -jar sqloader.jar -table source_table_name -type cdc -limit 100 Loading data into a table using your own configuration file (this will override the default configuration file): .. code-block:: console java -jar sqloader.jar -config path/to/your/config/file Loading data into a table using a custom configuration file: .. code-block:: console java -jar -config MyConfigFile.properties -table source_table_name -type cdc -target target_table_name -drop true -lock_check false Loading data into a table using a the ``filter`` parameter: .. code-block:: console java -jar sqloader.jar -table source_table_name -filter column_name>50 \ No newline at end of file From 93443611f3351fce6a8757e331aaf24f8e3fca90 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 7 Sep 2023 08:22:17 +0300 Subject: [PATCH 737/882] Update 4.3.rst --- releases/4.3.rst | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index 9a47fe2c9..e4a93b33b 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -16,8 +16,8 @@ Compatibility Matrix +-------------------------+------------------------------------------------------------------------+ | System Requirement | Details | +=========================+========================================================================+ -| Supported OS | * CentOS / REHL - 7.6 - 7.9 | -| | * IBM RedHat 7.6 | +| Supported OS | * CentOS - 7.x | +| | * RHEL - 7.x | +-------------------------+------------------------------------------------------------------------+ | Supported Nvidia driver | CUDA version from 10.1 up to 11.4.3 | +-------------------------+------------------------------------------------------------------------+ @@ -120,6 +120,10 @@ Visit :ref:`s3` to learn more about how and when you should use these two new pa Deprecated Features ------------------- +► **CentOS Linux 7.x** + +As of June 2024, CentOS Linux 7.x will reach its End of Life. This announcement provides a one-year advance notice for our users to plan for this change. We recommend users to explore migration or upgrade options to maintain ongoing support and security beyond this date. + ► ``INT96`` Due to Parquet's lack of support of the ``INT96`` data type, SQream has decided to deprecate this data type. From ca1f3fe7104998e89c68f2ff40795c295ffa6971 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 7 Sep 2023 11:14:02 +0300 Subject: [PATCH 738/882] Update sqream_db_internals.png --- _static/images/sqream_db_internals.png | Bin 132774 -> 287611 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/_static/images/sqream_db_internals.png b/_static/images/sqream_db_internals.png index 6b7b2b36bd17d88bf37f9176c00b6e9dc73d01bc..d41ea5478f98e2edff5423ea01cce806a582fba1 100644 GIT binary patch literal 287611 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 JA#EJ;zW^h6Yj6Mn literal 132774 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 From 694bb6577f3fbea1c658829a6a0411ae08593176 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 7 Sep 2023 11:14:02 +0300 Subject: [PATCH 739/882] Update sqream_db_internals.png --- _static/images/sqream_db_internals.png | Bin 132774 -> 287611 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/_static/images/sqream_db_internals.png b/_static/images/sqream_db_internals.png index 6b7b2b36bd17d88bf37f9176c00b6e9dc73d01bc..d41ea5478f98e2edff5423ea01cce806a582fba1 100644 GIT binary patch literal 287611 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 JA#EJ;zW^h6Yj6Mn literal 132774 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 From 9b4589b2ed8b0a9eaa20f9d0043c39446c974f41 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 7 Sep 2023 11:21:22 +0300 Subject: [PATCH 740/882] Update internals_architecture.rst --- architecture/internals_architecture.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/architecture/internals_architecture.rst b/architecture/internals_architecture.rst index af5ec0acf..3f548fd51 100644 --- a/architecture/internals_architecture.rst +++ b/architecture/internals_architecture.rst @@ -10,7 +10,7 @@ Get to know the SQreamDB key functions and system architecture components and th :align: left :width: 75% :alt: SQreamDB internals - + Key Functions and Components ============================ From eebc2d5f1c01e82e59a2d7875ce12479a0241277 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 7 Sep 2023 11:29:59 +0300 Subject: [PATCH 741/882] Update index.rst --- data_ingestion/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data_ingestion/index.rst b/data_ingestion/index.rst index 3c8c65368..0b812f958 100644 --- a/data_ingestion/index.rst +++ b/data_ingestion/index.rst @@ -3,7 +3,7 @@ ********************** Data Ingestion Sources ********************** - + The **Data Ingestion Sources** page provides information about the following: .. toctree:: From 53e5662d0482720ecae55a28d1badb61da0cab86 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 13 Sep 2023 09:26:07 +0300 Subject: [PATCH 742/882] Update keywords_and_identifiers.rst --- reference/sql/sql_syntax/keywords_and_identifiers.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_syntax/keywords_and_identifiers.rst b/reference/sql/sql_syntax/keywords_and_identifiers.rst index 646b12e20..aa27daf51 100644 --- a/reference/sql/sql_syntax/keywords_and_identifiers.rst +++ b/reference/sql/sql_syntax/keywords_and_identifiers.rst @@ -70,7 +70,7 @@ Identifiers are different than **keywords**, which are predefined words reserved SQreamDB reserved keywords: -``ALL`` | ``ANALYSE`` | ``ANALYZE`` | ``AND`` | ``ANY`` | ``ARRAY`` | ``AS`` | ``ASC`` | ``AUTHORIZATION`` | ``BINARY`` | ``BIGINT`` | ``BOTH`` | ``CASE`` | ``CAST`` | ``CHECK`` | ``COLLATE`` | ``COLUMN`` | ``CONCURRENTLY`` | ``CONSTRAINT`` | ``CREATE`` | ``CROSS`` | ``CURRENT_CATALOG`` | ``CURRENT_ROLE`` | ``CURRENT_TIME`` | ``CURRENT_USER`` | ``DEFAULT`` | ``DEFERRABLE`` | ``DESC`` | ``DISTINCT`` | ``DO`` | ``ELSE`` | ``END`` | ``EXCEPT`` | ``FALSE`` | ``FETCH`` | ``FOR`` | ``FREEZE`` | ``FROM`` | ``FULL`` | ``FUNCTION`` | ``GRANT`` | ``GROUP`` | ``HASH`` | ``HAVING`` | ``ILIKE`` | ``IN`` | ``INITIALLY`` | ``INNER`` | ``INTERSECT`` | ``INTO`` | ``IS`` | ``ISNULL`` | ``JOIN`` | ``KEY`` | ``LEADING`` | ``LEFT`` | ``LIKE`` | ``LIMIT`` | ``LOCALTIME`` | ``LOCALTIMESTAMP`` | ``LOOP`` | ``MERGE`` | ``NATURAL`` | ``NOT`` | ``NOTNULL`` | - ``NULL`` | ``OFFSET`` | ``ON`` | ``ONLY`` | ``OPTION`` | ``OR`` | ``ORDER`` | ``OUTER`` | ``OVER`` | ``OVERLAPS`` | ``PERCENT`` | ``PLACING`` | ``PRIMARY`` | ``PRECISION`` | ``PROC`` | ``REFERENCES`` | ``RETURNING`` | ``RIGHT`` | ``RLIKE`` | ``SELECT`` | ``SESSION_USER`` | ``SET`` | ``SIMILAR`` | ``SOME`` | ``SYMMETRIC`` | ``TABLE`` | ``THEN`` | ``TO`` | ``TRAILING`` | ``TRAN`` | ``TRUE`` | ``UNION`` | ``UNIQUE`` | ``USER`` | ``USING`` | ``VARIADIC`` | ``VERBOSE`` | ``WHEN`` | ``WHERE`` | ``WINDOW`` | ``WITH`` +``ALL`` | ``ANALYSE`` | ``ANALYZE`` | ``AND`` | ``ANY`` | ``ARRAY`` | ``AS`` | ``ASC`` | ``AUTHORIZATION`` | ``BINARY`` | ``BIGINT`` | ``BOTH`` | ``CASE`` | ``CAST`` | ``CHECK`` | ``COLLATE`` | ``COLUMN`` | ``COMMENT`` | ``CONCURRENTLY`` | ``CONSTRAINT`` | ``CREATE`` | ``CROSS`` | ``CURRENT_CATALOG`` | ``CURRENT_ROLE`` | ``CURRENT_TIME`` | ``CURRENT_USER`` | ``DEFAULT`` | ``DEFERRABLE`` | ``DESC`` | ``DISTINCT`` | ``DO`` | ``ELSE`` | ``END`` | ``EXCEPT`` | ``FALSE`` | ``FETCH`` | ``FOR`` | ``FREEZE`` | ``FROM`` | ``FULL`` | ``FUNCTION`` | ``GRANT`` | ``GROUP`` | ``HASH`` | ``HAVING`` | ``ILIKE`` | ``IN`` | ``INITIALLY`` | ``INNER`` | ``INTERSECT`` | ``INTO`` | ``IS`` | ``ISNULL`` | ``JOIN`` | ``KEY`` | ``LEADING`` | ``LEFT`` | ``LIKE`` | ``LIMIT`` | ``LOCALTIME`` | ``LOCALTIMESTAMP`` | ``LOOP`` | ``MERGE`` | ``NATURAL`` | ``NOT`` | ``NOTNULL`` | ``NULL`` | ``OFF`` | ``OFFSET`` | ``OFFSETS`` | ``ON`` | ``ONLY`` | ``OPTION`` | ``OR`` | ``ORDER`` | ``OUTER`` | ``OVER`` | ``OVERLAPS`` | ``PERCENT`` | ``PLACING`` | ``PRIMARY`` | ``PRECISION`` | ``PROC`` | ``PROCEDURE`` | ``REFERENCES`` | ``RETURNING`` | ``RIGHT`` | ``RLIKE`` | ``RULE`` | ``SCHEMA`` | ``SELECT`` | ``SESSION_USER`` | ``SET`` | ``SIMILAR`` | ``SOME`` | ``STATISTICS`` | ``SYMMETRIC`` | ``TABLE`` | ``THEN`` | ``TO`` | ``TOP`` | ``TRAILING`` | ``TRAN`` | ``TRUE`` | ``UNION`` | ``UNIQUE`` | ``USER`` | ``USING`` | ``VARIADIC`` | ``VERBOSE`` | ``WHEN`` | ``WHERE`` | ``WINDOW`` | ``WITH`` | From d66151477606ad46262a1b3af15070427283cdf5 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 13 Sep 2023 09:33:24 +0300 Subject: [PATCH 743/882] Update compression.rst --- feature_guides/compression.rst | 36 ++-------------------------------- 1 file changed, 2 insertions(+), 34 deletions(-) diff --git a/feature_guides/compression.rst b/feature_guides/compression.rst index a56826ffa..cfe0917f7 100644 --- a/feature_guides/compression.rst +++ b/feature_guides/compression.rst @@ -87,40 +87,8 @@ The following table shows the supported compression methods: - ``Integer``, ``date``, and ``timestamp`` - Optimized RLE + Delta type for built-in :ref:`identity columns<identity>`. - GPU - * - ``zlib`` - - All types - - The **basic_zlib_compressor** and **basic_zlib_decompressor** compress and decompress data in the **ZLIB** format, using **DualUseFilters** for input and output. In general, compression filters are for output, and decompression filters for input. - - CPU - * - ``SPACES`` - - All types - - Reduces the storage space required for data by identifying repeating sequences of values and replacing them with a compact representation. This method is particularly effective when there are repetitive patterns in the data. - - CPU - * - ``DELTA_RLE`` - - Integer types - - Optimized RLE + Delta type for built-in :ref:`identity columns<identity>`. - - CPU - * - ``SPADES`` - - All types - - An extension of ``SPACES`` compression, optimizing the compression scheme further to handle specific data patterns and types efficiently. - - CPU - * - ``SPAPPY`` - - All types - - Specialized variation of the ``Snappy`` compression algorithm. ``Snappy`` is a fast and efficient compression method that works well with various types of data, offering good compression ratios and decompression speeds. - - CPU - * - ``SPAZLY`` - - All types - - An encryption method involving the transformation of plaintext characters into a jumbled or disorderly arrangement - - CPU - * - ``CRLE`` - - All types - - An encryption process involving the compression and run-length encoding of data to secure it - - CPU - * - ``LZ4_ZIGZAG`` - - All types - - An encryption approach combining LZ4 compression with a zigzag pattern - - CPU - -.. note:: Automatic compression does **not** select the ``zlib`` compression method. + + .. _specifying_compressions: From 8bc8c977809da55380987cc247d3529c0dae6b03 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 14 Sep 2023 11:11:51 +0300 Subject: [PATCH 744/882] Update 4.3.rst --- releases/4.3.rst | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index e4a93b33b..16e85c052 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -124,6 +124,8 @@ Deprecated Features As of June 2024, CentOS Linux 7.x will reach its End of Life. This announcement provides a one-year advance notice for our users to plan for this change. We recommend users to explore migration or upgrade options to maintain ongoing support and security beyond this date. +**CentOS Linux 8.x** is now officially supported. + ► ``INT96`` Due to Parquet's lack of support of the ``INT96`` data type, SQream has decided to deprecate this data type. @@ -169,14 +171,25 @@ Upgrading to v4.3 $ ./upgrade_storage <levelDB path> -7. Version 4.3 introduces a service permission feature that enables superusers to grant and revoke role access to services. However, when upgrading from version 4.2 or earlier to version 4.3 or later, this feature initializes access to services, causing existing roles to lose their access to services. +7. Version 4.3 introduces a service permission feature that enables superusers to grant and revoke role access to services. However, when upgrading from version 4.2 or earlier to version 4.3 or later, this feature initializes access to services and to catalog tables, causing existing roles to lose their access to services, catalog tables and consequently also to the UI (Catalog tables may also be used to determine user access rights and privileges. The UI can integrate with these permissions to control what actions users are allowed to perform in the database.). There are two methods of granting back access to services: * Grant access to all services for all roles using the :ref:`grant_usage_on_service_to_all_roles` utility function * Selectively grant or revoke access to services by following the :ref:`access permission guide<access_control_permissions>` +To grant back access to catalog tables and the UI, you may either grant access to all system roles, using your ``public`` role: + +.. code-block:: + + GRANT ALL PERMISSIONS ON CATALOG <catalog_name> TO public; + +Or individually grant access to selected roles: + +.. code-block:: - .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. + GRANT ALL PERMISSIONS ON CATALOG <catalog_name> TO <role_name>; + +.. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. From 5ad3c61ff49a1ca947ac31fc2327ef476715f9e6 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 14 Sep 2023 16:24:51 +0300 Subject: [PATCH 745/882] Update access_control_managing_roles.rst --- .../access_control_managing_roles.rst | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/operational_guides/access_control_managing_roles.rst b/operational_guides/access_control_managing_roles.rst index 3f032bcd5..9b81b855d 100644 --- a/operational_guides/access_control_managing_roles.rst +++ b/operational_guides/access_control_managing_roles.rst @@ -3,6 +3,7 @@ ************** Managing Roles ************** + Roles are used for both users and groups, and are global across all databases in the SQream cluster. For a ``ROLE`` to be used as a user, it requires a password and log-in and connect permissionss to the relevant databases. The Managing Roles section describes the following role-related operations: @@ -13,7 +14,8 @@ The Managing Roles section describes the following role-related operations: Creating New Roles (Users) ------------------------------ -A user role logging in to the database requires ``LOGIN`` permissions and as a password. + +A user role logging in to the database requires ``LOGIN`` permissions and a password. The following is the syntax for creating a new role: @@ -37,6 +39,7 @@ A database role may have a number of permissions that define what tasks it can p Dropping a User ------------------------------ + The following is the syntax for dropping a user: .. code-block:: postgres @@ -51,6 +54,7 @@ The following is an example of dropping a user: Altering a User Name ------------------------------ + The following is the syntax for altering a user name: .. code-block:: postgres @@ -65,6 +69,7 @@ The following is an example of altering a user name: Changing a User Password ------------------------------ + You can change a user role's password by granting the user a new password. The following is an example of changing a user password: @@ -78,9 +83,9 @@ The following is an example of changing a user password: Altering Public Role Permissions ------------------------------ -There is a public role which always exists. Each role is granted to the ``PUBLIC`` role (i.e. is a member of the public group), and this cannot be revoked. You can alter the permissions granted to the public role. +The database has a predefined ``PUBLIC`` role that cannot be deleted. Each user role is automatically granted membership in the ``PUBLIC`` role public group, and this membership cannot be revoked. However, you have the capability to adjust the permissions associated with this ``PUBLIC`` role. -The ``PUBLIC`` role has ``USAGE`` and ``CREATE`` permissions on ``PUBLIC`` schema by default, therefore, new users can :ref:`insert`, :ref:`delete`, :ref:`select`, :ref:`UPDATE` and ``CREATE`` (:ref:`databases<create_database>`, :ref:`schemas<create_schema>`, :ref:`roles<create_role>`, :ref:`functions<create_function>`, :ref:`views<create_view>`, and :ref:`tables<create_table>`) from objects in the ``PUBLIC`` schema. +The ``PUBLIC`` role has ``USAGE`` and ``CREATE`` permissions on ``PUBLIC`` schema by default, therefore, newly created user roles are granted ``CREATE`` (:ref:`databases<create_database>`, :ref:`schemas<create_schema>`, :ref:`roles<create_role>`, :ref:`functions<create_function>`, :ref:`views<create_view>`, and :ref:`tables<create_table>`) on the public schema. Other permissions, such as :ref:`insert`, :ref:`delete`, :ref:`select`, and :ref:`update` on objects in the public schema are not automatically granted. Altering Role Membership (Groups) @@ -121,4 +126,4 @@ Removing users and permissions can be done with the ``REVOKE`` command: .. code-block:: postgres -- remove my_other_user from this group - REVOKE my_group FROM my_other_user; \ No newline at end of file + REVOKE my_group FROM my_other_user; From 26d3350212e88d55552188e4414550007b459adf Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 18 Sep 2023 08:21:52 +0300 Subject: [PATCH 746/882] Retrieving Execution Plan Output Using SQreamDB Studio --- .../monitoring_query_performance.rst | 6 ++-- troubleshooting/information_for_support.rst | 29 ++++++++++--------- troubleshooting/resolving_common_issues.rst | 2 +- ...ing_execution_plan_output_using_studio.rst | 27 +++++++++++++++++ 4 files changed, 47 insertions(+), 17 deletions(-) create mode 100644 troubleshooting/retrieving_execution_plan_output_using_studio.rst diff --git a/operational_guides/monitoring_query_performance.rst b/operational_guides/monitoring_query_performance.rst index 4d65abbbc..547d37d0a 100644 --- a/operational_guides/monitoring_query_performance.rst +++ b/operational_guides/monitoring_query_performance.rst @@ -117,8 +117,8 @@ Using the ``SHOW_NODE_INFO`` Command The :ref:`show_node_info` command returns a snapshot of the current query plan, similar to ``EXPLAIN ANALYZE`` from other databases. The :ref:`show_node_info` result, just like the periodically-logged execution plans described above, are an at-the-moment view of the compiler's execution plan and runtime statistics for the specified statement. -To inspect a currently running statement, execute the ``show_node_info`` utility function in a SQL client like - :ref:`sqream sql<sqream_sql_cli_reference>`, the :ref:`SQream Studio Editor<studio_editor>`, or any other :ref:`third party SQL terminal<third_party_tools>`. +To inspect a currently running statement, execute the ``show_node_info`` utility function in a SQL client like :ref:`sqream sql<sqream_sql_cli_reference>`, the :ref:`SQream Studio Editor<studio_editor>`, or any other :ref:`third party SQL terminal<third_party_tools>`. + In this example, we inspect a statement with statement ID of 176. The command looks like this: .. code-block:: sql @@ -138,6 +138,8 @@ In this example, we inspect a statement with statement ID of 176. The command lo 176 | 10 | CpuDecompress | 457 | 1 | 457 | 2019-12-25 23:53:13 | 9 | | | | 0 176 | 11 | ReadTable | 457 | 1 | 457 | 2019-12-25 23:53:13 | 10 | 4MB | | public.nba | 0.0004 +Alternatively, you may also :ref:`retrieve the query execution plan output<retrieving_execution_plan_output_using_studio>` using SQreamDB Studio, and contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_. + Understanding the Query Execution Plan Output ============================================= diff --git a/troubleshooting/information_for_support.rst b/troubleshooting/information_for_support.rst index fd1cab1fa..8450cc664 100644 --- a/troubleshooting/information_for_support.rst +++ b/troubleshooting/information_for_support.rst @@ -1,15 +1,15 @@ .. _information_for_support: -******************************************* +**************************************** Gathering Information for SQream Support -******************************************* +**************************************** .. contents:: :local: :depth: 1 Getting Support and Reporting Bugs -======================================= +================================== When contacting `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_, we recommend reporting the following information: @@ -23,12 +23,13 @@ When possible, please attach as many of the following: * DDL and queries that reproduce the issue * :ref:`Log files<logging>` * Screen captures if relevant +* :ref:`Execution plan output<retrieving_execution_plan_output_using_studio>` How SQream Debugs Issues -=================================== +======================== Reproduce --------------- +--------- If we are able to easily reproduce your issue in our testing lab, this greatly improves the speed at which we can fix it. @@ -43,7 +44,7 @@ Reproducing an issue consists of understanding: See the :ref:`reproducible_statement` section ahead for information about collecting a full reproducible example. Logs --------- +---- The logs produced by SQream DB contain a lot of information that may be useful for debugging. @@ -53,7 +54,7 @@ See the :ref:`collecting_logs` section ahead for information about collecting a Fix ---------- +--- Once we have a fix, this can be issued as a hotfix to an existing version, or as part of a bigger major release. @@ -62,14 +63,14 @@ Your SQream account manager will keep you up-to-date about the status of the iss .. _reproducible_statement: Collecting a Reproducible Example of a Problematic Statement -=============================================================== +============================================================ SQream DB contains an SQL utility that can help SQream support reproduce a problem with a query or statement. This utility compiles and executes a statement, and collects the relevant data in a small database which can be used to recreate and investigate the issue. SQL Syntax ---------------- +---------- .. code-block:: postgres @@ -81,7 +82,7 @@ SQL Syntax Parameters ---------------- +---------- .. list-table:: :widths: auto @@ -95,7 +96,7 @@ Parameters - Statements to analyze. Example ------------ +------- .. code-block:: postgres @@ -104,14 +105,14 @@ Example .. _collecting_logs: Collecting Logs and Metadata Database -============================================= +===================================== SQream DB comes bundled with a data collection utility and an SQL utility intended for collecting logs and additional information that can help SQream support drill down into possible issues. See more information in the :ref:`Collect logs from your cluster<collecting_logs2>` section of the :ref:`logging` guide. Examples ------------------ +-------- Write an archive to ``/home/rhendricks``, containing log files: @@ -129,7 +130,7 @@ Write an archive to ``/home/rhendricks``, containing log files and metadata data Using the Command Line Utility: -============================================= +=============================== .. code-block:: console diff --git a/troubleshooting/resolving_common_issues.rst b/troubleshooting/resolving_common_issues.rst index fd90472d3..73a9c07e8 100644 --- a/troubleshooting/resolving_common_issues.rst +++ b/troubleshooting/resolving_common_issues.rst @@ -40,7 +40,7 @@ Troubleshooting Connectivity Issues Troubleshooting Query Performance ------------------------------------ -#. Use :ref:`show_node_info` to examine which building blocks consume time in a statement. If the query has finished, but the results are not yet materialized in the client, it could point to a problem in the application's data buffering or a network throughput issue.. +#. Use :ref:`show_node_info` to examine which building blocks consume time in a statement. If the query has finished, but the results are not yet materialized in the client, it could point to a problem in the application's data buffering or a network throughput issue. Alternatively, you may also :ref:`retrieve the query execution plan output<retrieving_execution_plan_output_using_studio>` using SQreamDB Studio. #. If a problem occurs through a 3\ :sup:`rd` party client, try reproducing it directly with :ref:`the built in SQL client<sqream_sql_cli_reference>`. If the performance is better in the local client, it could point to a problem in the application or network connection. diff --git a/troubleshooting/retrieving_execution_plan_output_using_studio.rst b/troubleshooting/retrieving_execution_plan_output_using_studio.rst new file mode 100644 index 000000000..775991dbe --- /dev/null +++ b/troubleshooting/retrieving_execution_plan_output_using_studio.rst @@ -0,0 +1,27 @@ +.. _retrieving_execution_plan_output_using_studio: + +******************************************************* +Retrieving Execution Plan Output Using SQreamDB Studio +******************************************************* + +You may use SQreamDB Studio to create a query plan snapshot to be used for monitoring and troubleshooting slow running statements and for identifying long-running execution nodes (components that process data), that may cause performance issues. + +Retrieving Execution Plan Output +================================ + +You can retrieve the execution plan output either after the query execution has completed, in the case of a hanging query, or if you suspect no progress is being made. + +1. In the **Result Panel**, select **Execution Details View** |icon-execution-details-view|. + + The **Execution Tree** window opens. + +.. |icon-execution-details-view| image:: /_static/images/studio_icon_execution_details_view.png + +2. From the upper-right corner, select the |icon-download| to download a CSV execution plan table. + +.. |icon-download| image:: /_static/images/studio_icon_download.png + :align: middle + +3. Save the execution plan on your local machine. + +The information may be analyzed by :ref:`monitoring_query_performance` or with help from `SQreamDB Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_. \ No newline at end of file From a563d03f512b68ea2ee15b5b6220390d558ec209 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 18 Sep 2023 09:37:56 +0300 Subject: [PATCH 747/882] Update retrieving_execution_plan_output_using_studio.rst --- .../retrieving_execution_plan_output_using_studio.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/troubleshooting/retrieving_execution_plan_output_using_studio.rst b/troubleshooting/retrieving_execution_plan_output_using_studio.rst index 775991dbe..6dac66f74 100644 --- a/troubleshooting/retrieving_execution_plan_output_using_studio.rst +++ b/troubleshooting/retrieving_execution_plan_output_using_studio.rst @@ -4,7 +4,7 @@ Retrieving Execution Plan Output Using SQreamDB Studio ******************************************************* -You may use SQreamDB Studio to create a query plan snapshot to be used for monitoring and troubleshooting slow running statements and for identifying long-running execution nodes (components that process data), that may cause performance issues. +You may use SQreamDB Studio to create a query plan snapshot to be used for monitoring and troubleshooting slow running statements and for identifying long-running execution Workers (components that process data), that may cause performance issues. Retrieving Execution Plan Output ================================ From d4a73af01d5b921eb60676406c967aa4a3652b1f Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 18 Sep 2023 11:21:43 +0300 Subject: [PATCH 748/882] Update saved_queries.rst --- operational_guides/saved_queries.rst | 43 ++++++++++++---------------- 1 file changed, 18 insertions(+), 25 deletions(-) diff --git a/operational_guides/saved_queries.rst b/operational_guides/saved_queries.rst index 2ec42f247..f1a9d4ee3 100644 --- a/operational_guides/saved_queries.rst +++ b/operational_guides/saved_queries.rst @@ -11,12 +11,12 @@ Using the ``save_query`` command will both generate and save an execution plan. Note that the saved execution plan is tightly coupled with the structure of its underlying tables, which means that if one or more of the objects mentioned in the query is modified, the saved query must be re-created. -How saved queries work +How Saved Queries Work ========================== Saved queries are compiled when they are created. When a saved query is run, this query plan is used instead of compiling a query plan at query time. -Parameters support +Parameter Support =========================== Query parameters can be used as substitutes for constants expressions in queries. @@ -25,45 +25,38 @@ Query parameters can be used as substitutes for constants expressions in queries * Query parameters of a string datatype (like ``TEXT``) must be of a fixed length, and can be used in equality checks, but not patterns (e.g. :ref:`like`, :ref:`rlike`, etc.) -Creating a saved query +Creating a Saved Query ====================== A saved query is created using the :ref:`save_query` utility command. -Saving a simple query +Saving a Simple Query --------------------------- .. code-block:: psql - t=> SELECT SAVE_QUERY('select_all','SELECT * FROM nba'); + SELECT SAVE_QUERY('select_all','SELECT * FROM nba'); executed -Saving a parametrized query +Saving a Parameterized Query ------------------------------------------ -Use parameters to replace them later at execution time. - - +Parameterized queries, also known as prepared statements, enable the usage of parameters which may be replaced by actual values when executing the query. They are created and managed in application code, primarily to optimize query execution, enhance security, and allow for the reuse of query templates with different parameter values. .. code-block:: psql - t=> SELECT SAVE_QUERY('select_by_weight_and_team','SELECT * FROM nba WHERE Weight > ? AND Team = ?'); - executed + SELECT SAVE_QUERY('select_by_weight_and_team','SELECT * FROM nba WHERE Weight > ? AND Team = ?'); -.. TODO tip Use dollar quoting (`$$`) to avoid escaping strings. -.. this makes no sense unless you have a query which would otherwise need escaping -.. t=> SELECT SAVE_QUERY('select_by_weight_and_team',$$SELECT * FROM nba WHERE Weight > ? AND Team = ?$$); -.. executed -Executing saved queries +Executing Saved Queries ======================= Executing a saved query requires calling it by it's name in a :ref:`execute_saved_query` statement. A saved query with no parameter is called without parameters. .. code-block:: psql - t=> SELECT EXECUTE_SAVED_QUERY('select_all'); + SELECT EXECUTE_SAVED_QUERY('select_all'); Name | Team | Number | Position | Age | Height | Weight | College | Salary -------------------------+------------------------+--------+----------+-----+--------+--------+-----------------------+--------- Avery Bradley | Boston Celtics | 0 | PG | 25 | 6-2 | 180 | Texas | 7730337 @@ -76,7 +69,7 @@ Executing a saved query with parameters requires specifying the parameters in th .. code-block:: psql - t=> SELECT EXECUTE_SAVED_QUERY('select_by_weight_and_team', 240, 'Toronto Raptors'); + SELECT EXECUTE_SAVED_QUERY('select_by_weight_and_team', 240, 'Toronto Raptors'); Name | Team | Number | Position | Age | Height | Weight | College | Salary ------------------+-----------------+--------+----------+-----+--------+--------+-------------+-------- Bismack Biyombo | Toronto Raptors | 8 | C | 23 | 6-9 | 245 | | 2814000 @@ -84,7 +77,7 @@ Executing a saved query with parameters requires specifying the parameters in th Jason Thompson | Toronto Raptors | 1 | PF | 29 | 6-11 | 250 | Rider | 245177 Jonas Valanciunas | Toronto Raptors | 17 | C | 24 | 7-0 | 255 | | 4660482 -Listing saved queries +Listing Saved Queries ======================= Saved queries are saved as a database objects. They can be listed in one of two ways: @@ -93,7 +86,7 @@ Using the :ref:`catalog<catalog_reference>`: .. code-block:: psql - t=> SELECT * FROM sqream_catalog.savedqueries; + SELECT * FROM sqream_catalog.savedqueries; name | num_parameters --------------------------+--------------- select_all | 0 @@ -104,7 +97,7 @@ Using the :ref:`list_saved_queries` utility function: .. code-block:: psql - t=> SELECT LIST_SAVED_QUERIES(); + SELECT LIST_SAVED_QUERIES(); saved_query ------------------------- select_all @@ -112,19 +105,19 @@ Using the :ref:`list_saved_queries` utility function: select_by_weight_and_team -Dropping a saved query +Dropping a Saved Query ============================= When you're done with a saved query, or would like to replace it with another, you can drop it with :ref:`drop_saved_query`: .. code-block:: psql - t=> SELECT DROP_SAVED_QUERY('select_all'); + SELECT DROP_SAVED_QUERY('select_all'); executed - t=> SELECT DROP_SAVED_QUERY('select_by_weight_and_team'); + SELECT DROP_SAVED_QUERY('select_by_weight_and_team'); executed - t=> SELECT LIST_SAVED_QUERIES(); + SELECT LIST_SAVED_QUERIES(); saved_query ------------------------- select_by_weight \ No newline at end of file From 91ce63620fd8b3722299b93600aa6757802723d0 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 18 Sep 2023 11:22:10 +0300 Subject: [PATCH 749/882] Update index.rst --- .../client_drivers/jdbc/index.rst | 45 +++++++++++++------ 1 file changed, 31 insertions(+), 14 deletions(-) diff --git a/connecting_to_sqream/client_drivers/jdbc/index.rst b/connecting_to_sqream/client_drivers/jdbc/index.rst index efed488d6..ef56dc1c6 100644 --- a/connecting_to_sqream/client_drivers/jdbc/index.rst +++ b/connecting_to_sqream/client_drivers/jdbc/index.rst @@ -1,8 +1,8 @@ .. _java_jdbc: -************************* +**** JDBC -************************* +**** The SQream JDBC driver lets you connect to SQream using many Java applications and tools. This page describes how to write a Java application using the JDBC interface. The JDBC driver requires Java 1.8 or newer. @@ -11,7 +11,7 @@ The SQream JDBC driver lets you connect to SQream using many Java applications a :depth: 1 Installing the JDBC Driver -================================== +========================== The **Installing the JDBC Driver** section describes the following: @@ -20,7 +20,7 @@ The **Installing the JDBC Driver** section describes the following: :depth: 1 Prerequisites ----------------- +------------- The SQream JDBC driver requires Java 1.8 or newer, and SQream recommends using Oracle Java or OpenJDK.: @@ -35,13 +35,13 @@ The SQream JDBC driver requires Java 1.8 or newer, and SQream recommends using O * **Windows** - SQream recommends installing `Zulu 8 <https://www.azul.com/downloads/zulu-community/?&version=java-8-lts&architecture=x86-64-bit&package=jdk>`_ Getting the JAR file ---------------------- +-------------------- The SQream JDBC driver is available for download from the :ref:`client drivers download page<client_drivers>`. This JAR file can be integrated into your Java-based applications or projects. Setting Up the Class Path ----------------------------- +------------------------- To use the driver, you must include the JAR named ``sqream-jdbc-<version>.jar`` in the class path, either by inserting it in the ``CLASSPATH`` environment variable, or by using flags on the relevant Java command line. @@ -59,7 +59,7 @@ Alternatively, you can pass ``-classpath`` to the Java executable file: $ java -classpath .:/home/sqream/sqream-jdbc-4.3.0.jar my_java_app Connecting to SQream Using a JDBC Application -============================================== +============================================= You can connect to SQream using one of the following JDBC applications: @@ -68,12 +68,12 @@ You can connect to SQream using one of the following JDBC applications: :depth: 1 Driver Class --------------- +------------ Use ``com.sqream.jdbc.SQDriver`` as the driver class in the JDBC application. Connection String --------------------- +----------------- JDBC drivers rely on a connection string. @@ -84,7 +84,7 @@ The following is the syntax for SQream: jdbc:Sqream://<host and port>/<database name>;user=<username>;password=<password>;[<optional parameters>; ...] Connection Parameters -^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^ The following table shows the connection string parameters: @@ -127,7 +127,7 @@ The following table shows the connection string parameters: * - ``<fetchSize>`` - Optional - ``true`` - - Enables on-demand loading, and defines double buffer size for result. The ``fetchSize`` parameter is rounded according to chunk size. For example, ``fetchSize=1`` loads one row and is rounded to one chunk. If the fetchSize is 100,600, a chunk size of 100,000 loads, and is rounded to, two chunks. + - Enables on-demand loading, and defines double buffer size for the result. The ``fetchSize`` parameter is rounded according to chunk size. For example, ``fetchSize=1`` loads one row and is rounded to one chunk. If the ``fetchSize`` is 100,600, a chunk size of 100,000 loads, and is rounded to, two chunks. * - ``<insertBuffer>`` - Optional - ``true`` @@ -143,10 +143,10 @@ The following table shows the connection string parameters: * - ``<idleconnectiontimeout>`` - Optional - 0 - - Sets the duration, in seconds, for which a database connection can remain idle before it is terminated. If the parameter is set to its default value, idle connections will not be terminated. The idle connection timer begins counting after the completion of a query execution. + - Sets the duration, in seconds, for which a database connection can remain idle before it is terminated. If the parameter is set to its default value, idle connections will not be terminated. The idle connection timer begins counting after the completion of query execution. Connection String Examples -^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^ The following is an example of a SQream cluster with a load balancer and no service queues (with SSL): @@ -166,7 +166,7 @@ The following is an example of a SQream cluster with a load balancer and a speci jdbc:Sqream://sqream.mynetwork.co:3108/raviga;user=rhendricks;password=Tr0ub4dor&3;cluster=true;service=etl -Sample Java Program +Java Program Sample -------------------- You can download the :download:`JDBC Application Sample File <sample.java>` below by right-clicking and saving it to your computer. @@ -175,3 +175,20 @@ You can download the :download:`JDBC Application Sample File <sample.java>` belo :language: java :caption: JDBC Application Sample :linenos: + +Prepared Statements +==================== + +Prepared statements, also known as parameterized queries, are a feature of JDBC that enable the use of parameters to optimize query execution, enhance security, and enable query template reuse with different parameter values in Java applications. + +Prepared Statement Sample +--------------------------- + +The following is a Java code snippet employing a JDBC prepared statement object to ingest a batch of one million records into SQreamDB. + +You may download the :download:`Prepared statement <samplepreparedstatement.java>` by right-clicking and saving it to your computer. + +.. literalinclude:: samplePreparedStatement.java + :language: java + :caption: Prepared Statement Sample + :linenos: \ No newline at end of file From f12e4219575cbeb3460f8141e8966ce95cdd5d87 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 18 Sep 2023 15:09:55 +0300 Subject: [PATCH 750/882] Update copy_from.rst --- .../sql_statements/dml_commands/copy_from.rst | 30 +++++++++++-------- 1 file changed, 18 insertions(+), 12 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/copy_from.rst b/reference/sql/sql_statements/dml_commands/copy_from.rst index 403836e27..7b90d822d 100644 --- a/reference/sql/sql_statements/dml_commands/copy_from.rst +++ b/reference/sql/sql_statements/dml_commands/copy_from.rst @@ -133,7 +133,7 @@ Elements - No error log - - - When used, the ``COPY`` process will write error information from unparsable rows to the file specified by this parameter. + When used, the ``COPY`` process will write error information from unparsable rows to the file specified by this parameter. ``ERROR_LOG`` requires ``CONTINUE_ON_ERROR`` to be set to ``true`` * If an existing file path is specified, it will be overwritten. @@ -547,20 +547,26 @@ Saving Rejected Rows to a File .. code-block:: postgres - COPY table_name FROM WRAPPER csv_fdw OPTIONS (location = '/tmp/file.csv', - ,continue_on_error = true - ,error_log = '/temp/load_error.log' - ); + COPY table_name FROM WRAPPER csv_fdw + OPTIONS + ( + location = '/tmp/file.csv' + ,continue_on_error = true + ,error_log = '/temp/load_error.log' + ); .. code-block:: postgres - COPY table_name FROM WRAPPER csv_fdw OPTIONS (location = '/tmp/file.psv' - ,delimiter '|' - ,error_log = '/temp/load_error.log' -- Save error log - ,rejected_data = '/temp/load_rejected.log' -- Only save rejected rows - ,limit = 100 -- Only load 100 rows - ,error_count = 5 -- Stop the load if 5 errors reached - ); + COPY table_name FROM WRAPPER csv_fdw + OPTIONS + ( + location = '/tmp/file.psv' + ,delimiter '|' + ,error_log = '/temp/load_error.log' -- Save error log + ,rejected_data = '/temp/load_rejected.log' -- Only save rejected rows + ,limit = 100 -- Only load 100 rows + ,error_count = 5 -- Stop the load if 5 errors reached + ); Loading CSV Files from a Set of Directories From 064193375a9b1e8b1eb7f9fcebb91124a947637e Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 18 Sep 2023 15:45:37 +0300 Subject: [PATCH 751/882] Update 4.3.rst --- releases/4.3.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index 16e85c052..e496137ad 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -17,7 +17,7 @@ Compatibility Matrix | System Requirement | Details | +=========================+========================================================================+ | Supported OS | * CentOS - 7.x | -| | * RHEL - 7.x | +| | * RHEL - 7.x / 8.x | +-------------------------+------------------------------------------------------------------------+ | Supported Nvidia driver | CUDA version from 10.1 up to 11.4.3 | +-------------------------+------------------------------------------------------------------------+ @@ -117,14 +117,14 @@ Visit :ref:`s3` to learn more about how and when you should use these two new pa * ``AwsEndpointOverride`` * ``AwsObjectAccessStyle`` -Deprecated Features +Deprecations ------------------- ► **CentOS Linux 7.x** -As of June 2024, CentOS Linux 7.x will reach its End of Life. This announcement provides a one-year advance notice for our users to plan for this change. We recommend users to explore migration or upgrade options to maintain ongoing support and security beyond this date. - -**CentOS Linux 8.x** is now officially supported. +* As of June 2024, CentOS Linux 7.x will reach its End of Life and will not be supported by SQreamDB. This announcement provides a one-year advance notice for our users to plan for this change. We recommend users to explore migration or upgrade options to maintain ongoing support and security beyond this date. +* All new SQreamDB installations must use CentOS 8.X as the required operating system platform. +* **CentOS Linux 8.x** is now officially supported. ► ``INT96`` From 555b9ceb4979e15f371b91ad827c3e66b3100e62 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 19 Sep 2023 14:06:23 +0300 Subject: [PATCH 752/882] Update internals_architecture.rst --- architecture/internals_architecture.rst | 44 ++++++++++--------------- 1 file changed, 18 insertions(+), 26 deletions(-) diff --git a/architecture/internals_architecture.rst b/architecture/internals_architecture.rst index 3f548fd51..a47092fb6 100644 --- a/architecture/internals_architecture.rst +++ b/architecture/internals_architecture.rst @@ -4,50 +4,52 @@ Internals and Architecture ************************** -Get to know the SQreamDB key functions and system architecture components and the best practices and customization possibilities. +Get to know the SQreamDB key functions and system architecture components, best practices, customization possibilities, and optimizations. + +SQreamDB leverages GPU acceleration as an essential component of its core database operations, significantly enhancing columnar data processing. This integral GPU utilization isn't an optional feature but is fundamental to a wide range of data tasks such as ``GROUP BY``, scalar functions, ``JOIN``, ``ORDER BY``, and more. This approach harnesses the inherent parallelism of GPUs, effectively employing a single instruction to process multiple values, akin to the Single-Instruction, Multiple Data (SIMD) concept, tailored for high-throughput operations. .. figure:: /_static/images/sqream_db_internals.png :align: left :width: 75% :alt: SQreamDB internals - -Key Functions and Components -============================ + +Concurrency and Admission Control +================================== + +The SQreamDB execution engine employs thread workers and message passing for its foundation. This threading approach enables the concurrent execution of diverse operations, seamlessly integrating IO and GPU tasks with CPU operations while boosting the performance of CPU-intensive tasks. + +Learn more about :ref:`concurrency_and_scaling_in_sqream`. Statement Compiler ------------------- +============================ The Statement Compiler, developed using Haskell, accepts SQL text and generates optimized statement execution plans. Building Blocks (GPU Workers) ------------------------------ +============================== In SQreamDB, the main workload is carried out by specialized C++/CUDA building blocks, also known as Workers, which intentionally lack inherent intelligence and require precise instructions for operation. Effectively assembling these components relies largely on the capabilities of the statement compiler. Storage Layer -------------- +================ The storage is split into the metadata layer and an append-only data layer. Metadata Layer -^^^^^^^^^^^^^^ +------------------ Utilizing RocksDB key/value data store, the metadata layer incorporates features such as snapshots and atomic writes within the transaction system, while working in conjunction with the append-only bulk data layer to maintain overall data consistency. Bulk Data Layer Optimization -^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +------------------------------------ -SQreamDB harnesses the power of its columnar storage architecture within the bulk data layer for performance optimization. This layer employs IO-optimized extents containing compression-enabled CPU and GPU-efficient chunks. Even during small insert operations, SQreamDB maintains efficiency by generating less optimized chunks and extents as needed. This is achieved through background transactional reorganization that doesn't disrupt Data Manipulation Language (DML) operations. The system initially writes small chunks via small inserts and subsequently reorganizes them, facilitating swift medium-sized insert transactions and rapid queries. This optimization strategy, coupled with SQreamDB's columnar storage, ensures peak performance across diverse data processing tasks. +SQreamDB harnesses the power of its columnar storage architecture within the bulk data layer for performance optimization. This layer employs IO-optimized extents containing compression-enabled CPU and GPU-efficient chunks. Even during small insert operations, SQreamDB maintains efficiency by generating less optimized chunks and extents as needed. This is achieved through background transactional reorganization, such as ``DeferredGather``, that doesn't disrupt Data Manipulation Language (DML) operations. Deferred Gather optimizes GPU processing by selectively gathering only the necessary columns after GPU execution, effectively conserving memory and enhancing query performance. -Concurrency and Admission Control ---------------------------------- +The system initially writes small chunks via small inserts and subsequently reorganizes them, facilitating swift medium-sized insert transactions and rapid queries. This optimization strategy, coupled with SQreamDB's columnar storage, ensures peak performance across diverse data processing tasks. -The SQreamDB execution engine employs thread workers and message passing for its foundation. This threading approach enables the concurrent execution of diverse operations, seamlessly integrating IO and GPU tasks with CPU operations while boosting the performance of CPU-intensive tasks. - -Learn more about :ref:`concurrency_and_scaling_in_sqream`. Transactions ------------- +============================ SQreamDB has serializable (auto commit) transactions, with these features: @@ -61,13 +63,3 @@ SQreamDB has serializable (auto commit) transactions, with these features: * Other operations such as :ref:`delete`, :ref:`truncate`, and DDL use :ref:`coarse-grained exclusive locking<concurrency_and_locks>`. -GPU Usage -========= - -SQreamDB uses GPUs for accelerating database operations. This acceleration brings additional benefits to columnar data processing. - -SQreamDB's GPU acceleration is integral to database operations. It is not an additional feature, but rather core to most data operations, e.g. ``GROUP BY``, scalar functions, ``JOIN``, ``ORDER BY``, and more. - -Using a GPU is an extended form of SIMD (Single-Instruction, Multiple Data) intended for high throughput operations. When GPU acceleration is used, SQreamDB uses special building blocks to take advantage of the high degree of parallelism of the GPU. This means that GPU operations use a single instruction that runs on multiple values. - - From c2e66f7dc3b2b84068808878a3e08b5bf8ea2288 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 19 Sep 2023 14:13:08 +0300 Subject: [PATCH 753/882] Update copy_from.rst --- .../sql_statements/dml_commands/copy_from.rst | 24 ++++++++++++++++--- 1 file changed, 21 insertions(+), 3 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/copy_from.rst b/reference/sql/sql_statements/dml_commands/copy_from.rst index 7b90d822d..111949c83 100644 --- a/reference/sql/sql_statements/dml_commands/copy_from.rst +++ b/reference/sql/sql_statements/dml_commands/copy_from.rst @@ -102,9 +102,9 @@ Elements - - Table to copy data into * - ``QUOTE`` - - " + - ``"`` - - - Specifies an alternative quote character. The quote character must be a single, 1-byte printable ASCII character, and the equivalent octal syntax of the copy command can be used. The quote character cannot be contained in the field delimiter, the record delimiter, or the null marker. ``QUOTE`` can be used with ``csv_fdw`` in **COPY FROM** and foreign tables. + - Specifies an alternative quote character. The quote character must be a single, 1-byte printable ASCII character, and the equivalent octal syntax of the copy command can be used. The quote character cannot be contained in the field delimiter, the record delimiter, or the null marker. ``QUOTE`` can be used with ``csv_fdw`` in ``COPY FROM`` and foreign tables. The following characters cannot be an alternative quote character: ``"-.:\\0123456789abcdefghijklmnopqrstuvwxyzN"`` * - ``fdw_name`` - - ``csv_fdw``, ``orc_fdw``, ``parquet_fdw``, ``json_fdw``, or ``avro_fdw`` @@ -531,7 +531,25 @@ Loading a File from a Public S3 Bucket .. code-block:: postgres - COPY table_name FROM WRAPPER csv_fdw OPTIONS (location = 's3://sqream-demo-data/file.csv', delimiter = '\r\n', offset = 2); + COPY table_name FROM WRAPPER csv_fdw OPTIONS (location = 's3://sqream-demo-data/file.csv', delimiter = '\r\n', offset = 2); + +Loading a File From a Google Cloud Platform Bucket +---------------------------------------------------- + +To access a Google Cloud Platform (GCP) Bucket it is required that your environment be authorized. + +.. code-block:: + + COPY table_name FROM WRAPPER csv_fdw OPTIONS (location = 'gs://<gcs path>/<gcs_bucket>/*'); + +Loading a File From Azure +---------------------------------- + +To access Azure it is required that your environment be authorized. + +.. code-block:: + + COPY table_name FROM WRAPPER csv_fdw OPTIONS(location = 'azure://sqreamrole.core.windows.net/sqream-demo-data/file.csv'); Loading Files from an Authenticated S3 Bucket --------------------------------------------------- From c13bf65498683a698f54116f7f3e253d27fd4515 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 26 Sep 2023 13:50:18 +0300 Subject: [PATCH 754/882] Remove Docker Mentions --- .../sqream_installer_cli_ref_admin.rst | 142 ----------------- getting_started/hardware_guide.rst | 36 +++-- ...mended_pre-installation_configurations.rst | 44 +++++- reference/cli/index.rst | 11 +- reference/cli/sqream_installer.rst | 144 ------------------ reference/cli/sqream_sql.rst | 1 - 6 files changed, 58 insertions(+), 320 deletions(-) delete mode 100644 feature_guides/sqream_installer_cli_ref_admin.rst delete mode 100644 reference/cli/sqream_installer.rst diff --git a/feature_guides/sqream_installer_cli_ref_admin.rst b/feature_guides/sqream_installer_cli_ref_admin.rst deleted file mode 100644 index fad8107b9..000000000 --- a/feature_guides/sqream_installer_cli_ref_admin.rst +++ /dev/null @@ -1,142 +0,0 @@ -.. _sqream_installer_cli_ref_admin: - -********************************* -SQream Installer -********************************* -``sqream-installer`` is an application that prepares and configures a dockerized SQream DB installation. - -This page serves as a reference for the options and parameters. - -.. contents:: In this topic: - :local: - - -Operations and flag reference -=============================== - -Command line flags ------------------------ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Flag - - Description - * - ``-i`` - - Loads the docker images for installation - * - ``-k`` - - Load new licenses from the ``license`` subdirectory - * - ``-K`` - - Validate licenses - * - ``-f`` - - Force overwrite any existing installation **and data directories currently in use** - * - ``-c <path to read configuration from>`` - - Specifies a path to read and store configuration files in. Defaults to ``/etc/sqream``. - * - ``-v <storage cluster path>`` - - Specifies a path to the storage cluster. The path is created if it does not exist. - * - ``-l <startup log path>`` - - Specifies a path to store system startup logs. Defaults to ``/var/log/sqream`` - * - ``-d <path>`` - - Specifies a path to expose to SQream DB workers. To expose several paths, repeat the usage of this flag. - * - ``-s`` - - Shows system settings - * - ``-r`` - - Reset the system configuration. This flag can't be combined with other flags. - -Usage -============= - -Install SQream DB for the first time ----------------------------------------- - -Assuming license package tarball has been placed in the ``license`` subfolder. - -* The path where SQream DB will store data is ``/home/rhendricks/sqream_storage``. - -* Logs will be stored in /var/log/sqream - -* Source CSV, Parquet, and ORC files can be accessed from ``/home/rhendricks/source_data``. All other directory paths are hidden from the Docker container. - -.. code-block:: console - - # ./sqream-install -i -k -v /home/rhendricks/sqream_storage -l /var/log/sqream -c /etc/sqream -d /home/rhendricks/source_data - -.. note:: Installation commands should be run with ``sudo`` or root access. - -Modify exposed directories -------------------------------- - -To expose more directory paths for SQream DB to read and write data from, re-run the installer with additional directory flags. - -.. code-block:: console - - # ./sqream-install -d /home/rhendricks/more_source_data - -There is no need to specify the initial installation flags - only the modified exposed directory paths flag. - - -Install a new license package ----------------------------------- - -Assuming license package tarball has been placed in the ``license`` subfolder. - -.. code-block:: console - - # ./sqream-install -k - -View system settings ----------------------------- - -This information may be useful to identify problems accessing directory paths, or locating where data is stored. - -.. code-block:: console - - # ./sqream-install -s - SQREAM_CONSOLE_TAG=1.7.4 - SQREAM_TAG=2020.1 - SQREAM_EDITOR_TAG=3.1.0 - license_worker_0=[...] - license_worker_1=[...] - license_worker_2=[...] - license_worker_3=[...] - SQREAM_VOLUME=/home/rhendricks/sqream_storage - SQREAM_DATA_INGEST=/home/rhendricks/source_data - SQREAM_CONFIG_DIR=/etc/sqream/ - LICENSE_VALID=true - SQREAM_LOG_DIR=/var/log/sqream/ - SQREAM_USER=sqream - SQREAM_HOME=/home/sqream - SQREAM_ENV_PATH=/home/sqream/.sqream/env_file - PROCESSOR=x86_64 - METADATA_PORT=3105 - PICKER_PORT=3108 - NUM_OF_GPUS=8 - CUDA_VERSION=10.1 - NVIDIA_SMI_PATH=/usr/bin/nvidia-smi - DOCKER_PATH=/usr/bin/docker - NVIDIA_DRIVER=418 - SQREAM_MODE=single_host - - -.. _upgrade_with_docker: - -Upgrading to a new version of SQream DB ----------------------------------------------- - -When upgrading to a new version with Docker, most settings don't need to be modified. - -The upgrade process replaces the existing docker images with new ones. - -#. Obtain the new tarball, and untar it to an accessible location. Enter the newly extracted directory. - -#. - Install the new images - - .. code-block:: console - - # ./sqream-install -i - -#. The upgrade process will check for running SQream DB processes. If any are found running, the installer will ask to stop them in order to continue the upgrade process. Once all services are stopped, the new version will be loaded. - -#. After the upgrade, open :ref:`sqream_console_cli_reference` and restart the desired services. \ No newline at end of file diff --git a/getting_started/hardware_guide.rst b/getting_started/hardware_guide.rst index ea6f3606a..f0a1b2479 100644 --- a/getting_started/hardware_guide.rst +++ b/getting_started/hardware_guide.rst @@ -51,17 +51,17 @@ An average single-node cluster can be a rackmount server or workstation, contain * - Onboard storage - * 2x 960GB SSD 2.5in hot plug for OS, RAID1 - * 2x 2TB SSD or NVMe, for temporary spooling, RAID1 + * 2x 2TB SSD or NVMe, for temporary spooling, RAID0 * 10x 3.84TB SSD 2.5in Hot plug for storage, RAID6 * - GPU - NVIDIA 2x A100 or H100 * - Operating System - - Red Hat Enterprise Linux v7.x or CentOS v7.x or Amazon Linux + - Red Hat Enterprise Linux v7.9 or CentOS v7.9 or Amazon Linux .. note:: If you are using internal storage, your volumes must be formatted as xfs. -In this system configuration, SQream can store about 100TB of raw data (assuming average compression ratio and ~30TB of usable raw storage). +In this system configuration, SQream can store about 100TB of raw data (assuming an average compression ratio and ~30TB of usable raw storage). If a NAS is used, the 10x SSD drives can be omitted, but SQream recommends 2TB of local spool space on SSD or NVMe drives. @@ -96,15 +96,15 @@ The following table shows SQream's recommended hardware specifications: * - Onboard storage - * 2x 960GB SSD 2.5in hot plug for OS, RAID1 - * 2x 2TB SSD or NVMe, for temporary spooling, RAID1 + * 2x 2TB SSD or NVMe, for temporary spooling, RAID0 * - External Storage - - * Mellanox Connectx5/6 100G NVIDIA Network Card (if applicable) or other high speed network card minimum 40G compatible to customer’s infrastructure + * Mellanox Connectx5/6 100G NVIDIA Network Card (if applicable) or other high-speed network card minimum 40G compatible with customer’s infrastructure * 50 TB (NAS connected over GPFS, Lustre, Weka, or VAST) GPFS recommended * - GPU - NVIDIA 2x A100 or H100 * - Operating System - - Red Hat Enterprise Linux v7.x or CentOS v7.x or Amazon Linux + - Red Hat Enterprise Linux v7.9 or CentOS v7.9 or Amazon Linux Metadata Specifications ~~~~~~~~~~~~~~~~~~~~~~~ @@ -130,9 +130,9 @@ The following table shows SQream's recommended metadata server specifications: * - Power sources - Two Power Supplies - 800W AC 50/60Hz 100~240Vac/9.2-4.7A, 3139 BTU/hr * - Operating System - - Red Hat Enterprise Linux v7.x or CentOS v7.x or Amazon Linux + - Red Hat Enterprise Linux v7.9 or CentOS v7.9 or Amazon Linux -.. note:: With a NAS connected over GPFS, Lustre, Weka, or VAST, each SQream worker can read data at up to 5GB/s. +.. note:: With a NAS connected over GPFS, Lustre, Weka, or VAST, each SQream worker can read data at 5GB/s or more. SQream Studio Server Example ---------------------------- @@ -152,16 +152,16 @@ The following table shows SQream's recommended Studio server specifications: * - RAM - 16 GB * - Onboard storage - - 50 GB SSD 2.5in Hot plug for OS, RAID1 + - 50 GB SSD 2.5in Hot-plug for OS, RAID1 * - Operating System - - Red Hat Enterprise Linux v7.x or CentOS v7.x + - Red Hat Enterprise Linux v7.9 or CentOS v7.9 Cluster Design Considerations ============================= This section describes the following cluster design considerations: -* In a SQream installation, the storage and compute are logically separated. While they may reside on the same machine in a standalone installation, they may also reside on different hosts, providing additional flexibility and scalability. +* In a SQream installation, the storage and computing are logically separated. While they may reside on the same machine in a standalone installation, they may also reside on different hosts, providing additional flexibility and scalability. :: @@ -169,7 +169,7 @@ This section describes the following cluster design considerations: :: -* Local disk space is required for good temporary spooling performance, particularly when performing intensive operations exceeding the available RAM, such as sorting. SQream recommends an SSD or NVMe drive in RAID 1 configuration with about twice the RAM size available for temporary storage. This can be shared with the operating system drive if necessary. +* Local disk space is required for good temporary spooling performance, particularly when performing intensive operations exceeding the available RAM, such as sorting. SQream recommends an SSD or NVMe drive in RAID0 configuration with about twice the RAM size available for temporary storage. This can be shared with the operating system drive if necessary. :: @@ -206,12 +206,12 @@ The **Balancing Cost and Performance** section provides a breakdown of deploymen CPU Compute ----------- -SQream relies on multi-core Intel Gold Xeon processors or IBM POWER9 processors, and recommends a dual-socket machine populated with CPUs with 18C/36HT or better. While a higher core count may not necessarily affect query performance, more cores will enable higher concurrency and better load performance. +SQream relies on multi-core Intel Gold Xeon processors or IBM POWER9 processors and recommends a dual-socket machine populated with CPUs with 18C/36HT or better. While a higher core count may not necessarily affect query performance, more cores will enable higher concurrency and better load performance. GPU Compute and RAM ------------------- -The NVIDIA Tesla range of high-throughput GPU accelerators provides the best performance for enterprise environments. Most cards have ECC memory, which is crucial for delivering correct results every time. SQream recommends the NVIDIA Tesla A100 40GB or H100 GPU for best performance and highest concurrent user support. +The NVIDIA Tesla range of high-throughput GPU accelerators provides the best performance for enterprise environments. Most cards have ECC memory, which is crucial for delivering correct results every time. SQream recommends the NVIDIA Tesla A100 80GB GPU for the best performance and highest concurrent user support. GPU RAM, sometimes called GRAM or VRAM, is used for processing queries. It is possible to select GPUs with less RAM. However, the smaller GPU RAM results in reduced concurrency, as the GPU RAM is used extensively in operations like JOINs, ORDER BY, GROUP BY, and all SQL transforms. @@ -227,10 +227,10 @@ Operating System SQream can run on the following 64-bit Linux operating systems: - * Red Hat Enterprise Linux (RHEL) v7 - * CentOS v7 + * Red Hat Enterprise Linux (RHEL) v7.9 + * CentOS v7.9 * Amazon Linux 2018.03 - * Other Linux distributions may be supported via nvidia-docker + Storage ------- @@ -239,5 +239,3 @@ For clustered scale-out installations, SQream relies on NAS storage. For stand-a SQream recommends using enterprise-grade SAS SSD or NVMe drives. For a 32-user configuration, the number of GPUs should roughly match the number of users. SQream recommends 1 Tesla A100 GPU or H100 per 2 users, for full, uninterrupted dedicated access. - -.. note:: Non production HW requirements may be found at `Non Production HW Requirements <non_production_hardware_guide.html>`_ \ No newline at end of file diff --git a/installation_guides/recommended_pre-installation_configurations.rst b/installation_guides/recommended_pre-installation_configurations.rst index 9e965e221..b1374d131 100644 --- a/installation_guides/recommended_pre-installation_configurations.rst +++ b/installation_guides/recommended_pre-installation_configurations.rst @@ -3,6 +3,7 @@ ********************************************* Recommended Pre-Installation Configuration ********************************************* + Before :ref:`installing SQream DB<installing_sqream_db_docker>`, SQream recommends you to tune your system for better performance and stability. This page provides recommendations for production deployments of SQream and describes the following: @@ -13,6 +14,7 @@ This page provides recommendations for production deployments of SQream and desc Recommended BIOS Settings ========================== + The first step when setting your pre-installation configurations is to use the recommended BIOS settings. The BIOS settings may have a variety of names, or may not exist on your system. Each system vendor has a different set of settings and variables. It is safe to skip any and all of the configuration steps, but this may impact performance. @@ -86,6 +88,7 @@ If any doubt arises, consult the documentation for your server or your hardware Installing the Operating System =================================================== + Once the BIOS settings have been set, you must install the operating system. Either the CentOS (versions 7.6-7.9) or RHEL (versions 7.6-7.9) must be installed before installing the SQream database, by either the customer or a SQream representative. **To install the operating system:** @@ -120,10 +123,12 @@ The root user is created and the OS shell is booted up. Configuring the Operating System =================================================== + Once you've installted your operation system, you can configure it. When configuring the operating system, several basic settings related to creating a new server are required. Configuring these as part of your basic set-up increases your server's security and usability. Logging In to the Server -------------------------------- + You can log in to the server using the server's IP address and password for the **root** user. The server's IP address and **root** user were created while installing the operating system above. Automatically Creating a SQream User @@ -214,6 +219,7 @@ If needed, you can run the **timedatectl list-timezones** command to see your cu Installing the Required Packages -------------------------------- + You can install the required packages by running the following command: .. code-block:: console @@ -223,6 +229,7 @@ You can install the required packages by running the following command: Installing the Recommended Tools -------------------------------- + You can install the recommended tools by running the following command: .. code-block:: console @@ -232,6 +239,7 @@ You can install the recommended tools by running the following command: Installing Python 3.6.7 -------------------------------- + 1. Download the Python 3.6.7 source code tarball file from the following URL into the **/home/sqream** directory: .. code-block:: console @@ -276,6 +284,7 @@ Installing Python 3.6.7 Installing NodeJS on CentOS -------------------------------- + **To install the node.js on CentOS:** 1. Download the `setup_12.x file <https://rpm.nodesource.com/setup_12.x>`__ as a root user logged in shell: @@ -304,6 +313,7 @@ Installing NodeJS on CentOS Installing NodeJS on Ubuntu -------------------------------- + **To install the node.js file on Ubuntu:** 1. Download the `setup_12.x file <https://deb.nodesource.com/setup_12.x>`__ as a root user logged in shell: @@ -326,6 +336,7 @@ Installing NodeJS on Ubuntu Installing NodeJS Offline ------------------------------------------- + **To install NodeJS Offline** 1. Download the NodeJS source code tarball file from the following URL into the **/home/sqream** directory: @@ -372,6 +383,7 @@ Installing NodeJS Offline Installing the pm2 Service Offline ------------------------------------------- + **To install the pm2 Service Offline** 1. On a machine with internet access, install the following: @@ -425,6 +437,7 @@ Installing the pm2 Service Offline Configuring the Network Time Protocol ------------------------------------------- + This section describes how to configure your **Network Time Protocol (NTP)**. If you don't have internet access, see `Configure NTP Client to Synchronize with NTP Server <https://www.thegeekstuff.com/2014/06/linux-ntp-server-client/>`__. @@ -457,6 +470,7 @@ If you don't have internet access, see `Configure NTP Client to Synchronize with Configuring the Network Time Protocol Server -------------------------------------------- + If your organization has an NTP server, you can configure it. **To configure your NTP server:** @@ -500,6 +514,7 @@ If your organization has an NTP server, you can configure it. Configuring the Server to Boot Without the UI --------------------------------------------- + You can configure your server to boot without a UI in cases when it is not required (recommended) by running the following command: .. code-block:: console @@ -510,6 +525,7 @@ Running this command activates the **NO-UI** server mode. Configuring the Security Limits -------------------------------- + The security limits refers to the number of open files, processes, etc. You can configure the security limits by running the **echo -e** command as a root user logged in shell: @@ -524,6 +540,7 @@ You can configure the security limits by running the **echo -e** command as a ro Configuring the Kernel Parameters --------------------------------- + **To configure the kernel parameters:** 1. Insert a new line after each kernel parameter: @@ -545,8 +562,6 @@ Configuring the Kernel Parameters .. code-block:: console $ echo "fs.file-max=2097152" >> /etc/sysctl.conf - - **IP4 forward** must be enabled for Docker and K8s installation only. 4. Run the following command: @@ -562,6 +577,7 @@ Configuring the Kernel Parameters Configuring the Firewall -------------------------------- + The example in this section shows the open ports for four sqreamd sessions. If more than four are required, open the required ports as needed. Port 8080 in the example below is a new UI port. **To configure the firewall:** @@ -603,6 +619,7 @@ The example in this section shows the open ports for four sqreamd sessions. If m Disabling selinux -------------------------------- + **To disable selinux:** 1. Show the status of **selinux**: @@ -629,6 +646,7 @@ Disabling selinux Configuring the /etc/hosts File -------------------------------- + **To configure the /etc/hosts file:** 1. Edit the **/etc/hosts** file: @@ -647,6 +665,7 @@ Configuring the /etc/hosts File Configuring the DNS -------------------------------- + **To configure the DNS:** 1. Run the **ifconfig** commasnd to check your NIC name. In the following example, **eth0** is the NIC name: @@ -664,12 +683,14 @@ Configuring the DNS Installing the Nvidia CUDA Driver =================================================== + After configuring your operating system, you must install the Nvidia CUDA driver. .. warning:: If your UI runs on the server, the server must be stopped before installing the CUDA drivers. CUDA Driver Prerequisites -------------------------------- + 1. Verify that the NVIDIA card has been installed and is detected by the system: .. code-block:: console @@ -698,6 +719,7 @@ CUDA Driver Prerequisites Updating the Kernel Headers -------------------------------- + **To update the kernel headers:** 1. Update the kernel headers on one of the following operating systems: @@ -730,6 +752,7 @@ Updating the Kernel Headers Disabling Nouveau -------------------------------- + You can disable Nouveau, which is the default driver. **To disable Nouveau:** @@ -767,6 +790,7 @@ You can disable Nouveau, which is the default driver. Installing the CUDA Driver -------------------------------- + This section describes how to install the CUDA driver. .. note:: The version of the driver installed on the customer's server must be equal or higher than the driver included in the Sqream release package. Contact a Sqream customer service representative to identify the correct version to install. @@ -779,6 +803,7 @@ The **Installing the CUDA Driver** section describes the following: Installing the CUDA Driver from the Repository ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + Installing the CUDA driver from the Repository is the recommended installation method. .. warning:: For A100 GPU and other A series GPUs, you must install the **cuda 11.4.3 driver**. The version of the driver installed on the customer server must be equal to or higher than the one used to build the SQream package. For questions related to which driver to install, contact SQream Customer Support. @@ -922,6 +947,7 @@ You can prepare the CUDA driver offline from a server connected to the CUDA repo Tuning Up NVIDIA Performance ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + This section describes how to tune up NVIDIA performance. .. note:: The procedures in this section are relevant to Intel only. @@ -931,7 +957,8 @@ This section describes how to tune up NVIDIA performance. :depth: 1 To Tune Up NVIDIA Performance when Driver Installed from the Repository -~~~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + **To tune up NVIDIA performance when the driver was installed from the repository:** 1. Check the service status: @@ -982,7 +1009,8 @@ To Tune Up NVIDIA Performance when Driver Installed from the Repository .. note:: Setting up the NVIDIA POWER9 CUDA driver includes additional set-up requirements. The NVIDIA POWER9 CUDA driver will not function properly if the additional set-up requirements are not followed. See `POWER9 Setup <https://docs.nvidia.com/cuda/cuda-installation-guide-linux/index.html#power9-setup>`__ for the additional set-up requirements. To Tune Up NVIDIA Performance when Driver Installed from the Runfile -~~~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + **To tune up NVIDIA performance when the driver was installed from the runfile:** 1. Change the permissions on the **rc.local** file to **executable**: @@ -1032,6 +1060,7 @@ To Tune Up NVIDIA Performance when Driver Installed from the Runfile Disabling Automatic Bug Reporting Tools ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + **To disable automatic bug reporting tools:** 1. Run the following **abort** commands: @@ -1090,6 +1119,7 @@ The server is ready for the SQream software installation. Enabling Core Dumps =================================================== + After installing the Nvidia CUDA driver, you can enable your core dumps. While SQream recommends enabling your core dumps, it is optional. The **Enabling Core Dumps** section describes the following: @@ -1100,6 +1130,7 @@ The **Enabling Core Dumps** section describes the following: Checking the abrtd Status --------------------------------------------------- + **To check the abrtd status:** 1. Check if **abrtd** is running: @@ -1121,6 +1152,7 @@ Checking the abrtd Status Setting the Limits --------------------------------------------------- + **To set the limits:** 1. Set the limits: @@ -1140,6 +1172,7 @@ Setting the Limits Creating the Core Dumps Directory --------------------------------------------------- + **To set the core dumps directory:** 1. Make the **/tmp/core_dumps** directory: @@ -1164,6 +1197,7 @@ Creating the Core Dumps Directory Setting the Output Directory of the /etc/sysctl.conf File ----------------------------------------------------------------- + **To set the output directory of the /etc/sysctl.conf file:** 1. Edit the **/etc/sysctl.conf** file: @@ -1206,6 +1240,7 @@ Setting the Output Directory of the /etc/sysctl.conf File Verifying that the Core Dumps Work --------------------------------------------------- + You can verify that the core dumps work only after installing and running SQream. This causes the server to crash and a new core.xxx file to be included in the folder that is written in **/etc/sysctl.conf** **To verify that the core dumps work:** @@ -1222,6 +1257,7 @@ You can verify that the core dumps work only after installing and running SQream Troubleshooting Core Dumping --------------------------------------------------- + This section describes the troubleshooting procedure to be followed if all parameters have been configured correctly, but the cores have not been created. **To troubleshoot core dumping:** diff --git a/reference/cli/index.rst b/reference/cli/index.rst index d892ffea6..542c6960b 100644 --- a/reference/cli/index.rst +++ b/reference/cli/index.rst @@ -41,16 +41,7 @@ This topic contains the reference for these programs, as well as flags and confi * - :ref:`upgrade_storage <upgrade_storage_cli_reference>` - Upgrade metadata schemas when upgrading between major versions -.. list-table:: Docker utilities - :widths: auto - :header-rows: 1 - - * - Command - - Usage - * - :ref:`sqream_console <sqream_console_cli_reference>` - - Dockerized convenience wrapper for operations - * - :ref:`sqream_installer <sqream_installer_cli_reference>` - - Dockerized installer + .. toctree:: :maxdepth: 1 diff --git a/reference/cli/sqream_installer.rst b/reference/cli/sqream_installer.rst deleted file mode 100644 index cdd9e801a..000000000 --- a/reference/cli/sqream_installer.rst +++ /dev/null @@ -1,144 +0,0 @@ -.. _sqream_installer_cli_reference: - -********************************* -sqream-installer -********************************* - -``sqream-installer`` is an application that prepares and configures a dockerized SQream DB installation. - - -This page serves as a reference for the options and parameters. - -.. contents:: In this topic: - :local: - - -Operations and flag reference -=============================== - -Command line flags ------------------------ - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Flag - - Description - * - ``-i`` - - Loads the docker images for installation - * - ``-k`` - - Load new licenses from the ``license`` subdirectory - * - ``-K`` - - Validate licenses - * - ``-f`` - - Force overwrite any existing installation **and data directories currently in use** - * - ``-c <path to read configuration from>`` - - Specifies a path to read and store configuration files in. Defaults to ``/etc/sqream``. - * - ``-v <storage cluster path>`` - - Specifies a path to the storage cluster. The path is created if it does not exist. - * - ``-l <startup log path>`` - - Specifies a path to store system startup logs. Defaults to ``/var/log/sqream`` - * - ``-d <path>`` - - Specifies a path to expose to SQream DB workers. To expose several paths, repeat the usage of this flag. - * - ``-s`` - - Shows system settings - * - ``-r`` - - Reset the system configuration. This flag can't be combined with other flags. - -Usage -============= - -Install SQream DB for the first time ----------------------------------------- - -Assuming license package tarball has been placed in the ``license`` subfolder. - -* The path where SQream DB will store data is ``/home/rhendricks/sqream_storage``. - -* Logs will be stored in /var/log/sqream - -* Source CSV, Parquet, and ORC files can be accessed from ``/home/rhendricks/source_data``. All other directory paths are hidden from the Docker container. - -.. code-block:: console - - # ./sqream-install -i -k -v /home/rhendricks/sqream_storage -l /var/log/sqream -c /etc/sqream -d /home/rhendricks/source_data - -.. note:: Installation commands should be run with ``sudo`` or root access. - -Modify exposed directories -------------------------------- - -To expose more directory paths for SQream DB to read and write data from, re-run the installer with additional directory flags. - -.. code-block:: console - - # ./sqream-install -d /home/rhendricks/more_source_data - -There is no need to specify the initial installation flags - only the modified exposed directory paths flag. - - -Install a new license package ----------------------------------- - -Assuming license package tarball has been placed in the ``license`` subfolder. - -.. code-block:: console - - # ./sqream-install -k - -View system settings ----------------------------- - -This information may be useful to identify problems accessing directory paths, or locating where data is stored. - -.. code-block:: console - - # ./sqream-install -s - SQREAM_CONSOLE_TAG=1.7.4 - SQREAM_TAG=2020.1 - SQREAM_EDITOR_TAG=3.1.0 - license_worker_0=[...] - license_worker_1=[...] - license_worker_2=[...] - license_worker_3=[...] - SQREAM_VOLUME=/home/rhendricks/sqream_storage - SQREAM_DATA_INGEST=/home/rhendricks/source_data - SQREAM_CONFIG_DIR=/etc/sqream/ - LICENSE_VALID=true - SQREAM_LOG_DIR=/var/log/sqream/ - SQREAM_USER=sqream - SQREAM_HOME=/home/sqream - SQREAM_ENV_PATH=/home/sqream/.sqream/env_file - PROCESSOR=x86_64 - METADATA_PORT=3105 - PICKER_PORT=3108 - NUM_OF_GPUS=8 - CUDA_VERSION=10.1 - NVIDIA_SMI_PATH=/usr/bin/nvidia-smi - DOCKER_PATH=/usr/bin/docker - NVIDIA_DRIVER=418 - SQREAM_MODE=single_host - - -.. _upgrade_with_docker: - -Upgrading to a new version of SQream DB ----------------------------------------------- - -When upgrading to a new version with Docker, most settings don't need to be modified. - -The upgrade process replaces the existing docker images with new ones. - -#. Obtain the new tarball, and untar it to an accessible location. Enter the newly extracted directory. - -#. - Install the new images - - .. code-block:: console - - # ./sqream-install -i - -#. The upgrade process will check for running SQream DB processes. If any are found running, the installer will ask to stop them in order to continue the upgrade process. Once all services are stopped, the new version will be loaded. - -#. After the upgrade, open :ref:`sqream_console_cli_reference` and restart the desired services. \ No newline at end of file diff --git a/reference/cli/sqream_sql.rst b/reference/cli/sqream_sql.rst index b9feff992..132f9679c 100644 --- a/reference/cli/sqream_sql.rst +++ b/reference/cli/sqream_sql.rst @@ -16,7 +16,6 @@ Installing Sqream SQL If you have a SQream DB installation on your server, ``sqream sql`` can be found in the ``bin`` directory of your SQream DB installation, under the name ``sqream``. -.. note:: If you installed SQream DB via Docker, the command is named ``sqream-client sql``, and can be found in the same location as the console. .. versionchanged:: 2020.1 From 7947711113225a793d7d4d01a0d737d5789a8fe5 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 26 Sep 2023 13:54:19 +0300 Subject: [PATCH 755/882] Update index.rst --- reference/cli/index.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/reference/cli/index.rst b/reference/cli/index.rst index 542c6960b..588e8d54a 100644 --- a/reference/cli/index.rst +++ b/reference/cli/index.rst @@ -50,7 +50,6 @@ This topic contains the reference for these programs, as well as flags and confi metadata_server sqreamd sqream_console - sqream_installer server_picker sqream_storage sqream sql<sqream_sql> From 7cdb54c35c5f7fa1525d249686b522c6363baec9 Mon Sep 17 00:00:00 2001 From: TaliaSQream <taliar@sqreamtech.com> Date: Wed, 27 Sep 2023 15:26:04 +0300 Subject: [PATCH 756/882] Encryption --- feature_guides/.DS_Store | Bin 0 -> 6148 bytes feature_guides/data_encryption.rst | 20 ----------- feature_guides/data_encryption_methods.rst | 17 ---------- feature_guides/data_encryption_overview.rst | 28 --------------- .../data_encryption_permissions.rst | 6 ---- feature_guides/data_encryption_syntax.rst | 32 ------------------ feature_guides/data_encryption_types.rst | 14 -------- feature_guides/index.rst | 1 - 8 files changed, 118 deletions(-) create mode 100644 feature_guides/.DS_Store delete mode 100644 feature_guides/data_encryption.rst delete mode 100644 feature_guides/data_encryption_methods.rst delete mode 100644 feature_guides/data_encryption_overview.rst delete mode 100644 feature_guides/data_encryption_permissions.rst delete mode 100644 feature_guides/data_encryption_syntax.rst delete mode 100644 feature_guides/data_encryption_types.rst diff --git a/feature_guides/.DS_Store b/feature_guides/.DS_Store new file mode 100644 index 0000000000000000000000000000000000000000..5008ddfcf53c02e82d7eee2e57c38e5672ef89f6 GIT binary patch literal 6148 zcmeH~Jr2S!425mzP>H1@V-^m;4Wg<&0T*E43hX&L&p$$qDprKhvt+--jT7}7np#A3 zem<@ulZcFPQ@L2!n>{z**<q8>++&mCkOWA81W14cNZ<zv;LbK1Poaz?KmsK2CSc!( z0ynLxE!0092;Krf2c+FF_Fe*7ECH>lEfg7;MkzE(HCqgga^y>{tEnwC%0;vJ&^%eQ zLs35+`xjp>T0<F0fCPF1$Cyrb|F7^5{eNG?83~ZUUlGt@xh*qZDeu<Z%US-OSsOPv j)R!Z4KLME7ReXlK;d!wEw5GODWMKRea10D2@KpjYNUI8I literal 0 HcmV?d00001 diff --git a/feature_guides/data_encryption.rst b/feature_guides/data_encryption.rst deleted file mode 100644 index 607d6c09a..000000000 --- a/feature_guides/data_encryption.rst +++ /dev/null @@ -1,20 +0,0 @@ -.. _data_encryption: - -*********************** -Data Encryption -*********************** -The **Data Encryption** page describes the following: - -.. |icon-new_2022.1| image:: /_static/images/new_2022.1.png - :align: middle - :width: 110 - -.. toctree:: - :maxdepth: 1 - :titlesonly: - - data_encryption_overview - data_encryption_methods - data_encryption_types - data_encryption_syntax - data_encryption_permissions \ No newline at end of file diff --git a/feature_guides/data_encryption_methods.rst b/feature_guides/data_encryption_methods.rst deleted file mode 100644 index db789d02f..000000000 --- a/feature_guides/data_encryption_methods.rst +++ /dev/null @@ -1,17 +0,0 @@ -.. _data_encryption_methods: - -*********************** -Encryption Methods -*********************** -Data exists in one of following states and determines the encryption method: - - -Encrypting Data in Transit ----------------- -**Data in transit** refers to data you use on a regular basis, usually stored on a database and accessed through applications or programs. This data is typically transferred between several physical or remote locations through email or uploading documents to the cloud. This type of data must therefore be protected while **in transit**. SQream encrypts data in transit using SSL when, for example, users insert data files from external repositories over a JDBC or ODBC connection. - -For more information, see `Use TLS/SSL When Possible <https://docs.sqream.com/en/v2022.1/operational_guides/security.html#use-tls-ssl-when-possible>`_. - -Encrypting Data at Rest ----------------- -**Data at rest** refers to data stored on your hard drive or on the cloud. Because this data can be potentially intercepted **physically**, it requires a form of encryption that protects your data wherever you store it. SQream faciliates encryption by letting you encrypt any columns located in your database that you want to keep private. \ No newline at end of file diff --git a/feature_guides/data_encryption_overview.rst b/feature_guides/data_encryption_overview.rst deleted file mode 100644 index 256e3d718..000000000 --- a/feature_guides/data_encryption_overview.rst +++ /dev/null @@ -1,28 +0,0 @@ -.. _data_encryption_overview: - -*********************** -Overview -*********************** -**Data Encryption** helps protect sensitive data at rest by concealing it from unauthorized users in the event of a breach. This is achieved by scrambling the content into an unreadable format based on encryption and decryption keys. Typically speaking, this data pertains to **PII (Personally Identifiable Information)**, which is sensitive information such as credit card numbers and other information related to an identifiable person. - -Users encrypt their data on a column basis by specifying ``column_name`` in the encryption syntax. - -The demand for confidentiality has steadily increased to protect the growing volumes of private data stored on computer systems and transmitted over the internet. To this end, regulatory bodies such as the **General Data Protection Regulation (GDPR)** have produced requirements to standardize and enforce compliance aimed at protecting customer data. - -Encryption can be used for the following: - -* Creating tables with up to three encrypted columns. - - :: - -* Joining encrypted columns with other tables. - - :: - -* Selecting data from an encrypted column. - -.. warning:: The ``SELECT`` statement decrypts information by default. When executing ``CREATE TABLE AS SELECT`` or ``INSERT INTO TABLE AS SELECT``, encrypted information will appear as clear text in the newly created table. - -For more information on the encryption syntax, see :ref:`data_encryption_syntax`. - -For more information on GDPR compliance requirements, see the `GDPR checklist <https://gdpr.eu/checklist/>`_. \ No newline at end of file diff --git a/feature_guides/data_encryption_permissions.rst b/feature_guides/data_encryption_permissions.rst deleted file mode 100644 index ba51f2501..000000000 --- a/feature_guides/data_encryption_permissions.rst +++ /dev/null @@ -1,6 +0,0 @@ -.. _data_encryption_permissions: - -*********************** -Permissions -*********************** -Because the Data Encryption feature does not require a role, users with **Read** and **Insert** permissions can read tables containing encrypted data. \ No newline at end of file diff --git a/feature_guides/data_encryption_syntax.rst b/feature_guides/data_encryption_syntax.rst deleted file mode 100644 index 56934378e..000000000 --- a/feature_guides/data_encryption_syntax.rst +++ /dev/null @@ -1,32 +0,0 @@ -.. _data_encryption_syntax: - -*********************** -Syntax -*********************** -The following is the syntax for encrypting a new table: - -.. code-block:: console - - CREATE TABLE <table name> ( - <column_name> NOT NULL ENCRYPT, - <column_name> <type_name> ENCRYPT, - <column_name> <type_name>, - <column_name> <type_name> ENCRYPT); - -The following is an example of encrypting a new table: - -.. code-block:: console - - CREATE TABLE client_name ( - id BIGINT NOT NULL ENCRYPT, - first_name TEXT ENCRYPT, - last_name TEXT, - salary INT ENCRYPT); - -.. note:: Because encryption is not associated with any role, users with **Read** or **Insert** permissions can read tables containing encrypted data. - -You cannot encrypt more than three columns. Attempting to encrypt more than three columns displays the following error message: - -.. code-block:: console - - Error preparing statement: Cannot create a table with more than three encrypted columns. diff --git a/feature_guides/data_encryption_types.rst b/feature_guides/data_encryption_types.rst deleted file mode 100644 index ad6d96dc3..000000000 --- a/feature_guides/data_encryption_types.rst +++ /dev/null @@ -1,14 +0,0 @@ -.. _data_encryption_types: - -*********************** -Data Types -*********************** -Typically speaking, sensitive pertains to **PII (Personally Identifiable Information)**, which is sensitive information such as credit card numbers and other information related to an identifiable person. - -SQream's data encryption feature supports encrypting column-based data belonging to the following data types: - -* INT -* BIGINT -* TEXT - -For more information on the above data types, see :ref:`supported_data_types`. \ No newline at end of file diff --git a/feature_guides/index.rst b/feature_guides/index.rst index 4fe0652ce..cf56f184c 100644 --- a/feature_guides/index.rst +++ b/feature_guides/index.rst @@ -13,7 +13,6 @@ This section describes the following features: automatic_foreign_table_ddl_resolution query_healer - data_encryption compression python_functions workload_manager From 3970375bbd17d3d1e418ab0f691f0ebf0727cf05 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 27 Sep 2023 15:30:32 +0300 Subject: [PATCH 757/882] Update pentaho.rst --- connecting_to_sqream/client_platforms/pentaho.rst | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/connecting_to_sqream/client_platforms/pentaho.rst b/connecting_to_sqream/client_platforms/pentaho.rst index 5bf4c3685..8ae213b33 100644 --- a/connecting_to_sqream/client_platforms/pentaho.rst +++ b/connecting_to_sqream/client_platforms/pentaho.rst @@ -39,8 +39,6 @@ After installing Pentaho you must install and set up the JDBC driver. This secti You can install the driver by copying and pasting the SQream JDBC .jar file into your **<directory>/design-tools/data-integration/lib** directory. -**NOTE:** Contact your SQream license account manager for the JDBC .jar file. - :ref:`Back to Overview <pentaho_top>` .. _create_transformation: @@ -242,4 +240,4 @@ For more information about backing up users, permissions, or schedules, see `Bac The **Execution Results** are displayed. -:ref:`Back to Overview <pentaho_top>` \ No newline at end of file +:ref:`Back to Overview <pentaho_top>` From 4ce807cba88017474e331060091247be7c77744c Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 1 Oct 2023 11:25:53 +0300 Subject: [PATCH 758/882] remove sqream_catalog.sequences --- reference/catalog_reference_catalog_tables.rst | 12 ------------ reference/catalog_reference_schema_information.rst | 2 -- 2 files changed, 14 deletions(-) diff --git a/reference/catalog_reference_catalog_tables.rst b/reference/catalog_reference_catalog_tables.rst index e771b9697..4ad9a916f 100644 --- a/reference/catalog_reference_catalog_tables.rst +++ b/reference/catalog_reference_catalog_tables.rst @@ -364,18 +364,6 @@ The ``schemas`` data object identifies all the database's schemas, as shown belo * - ``rechunker_ignore`` - Reserved for internal use. -.. _sequences: - -Sequences ----------------- - -The ``sequences`` data object is used for displaying identity key information, as shown below: - -Identity Key -************* - -**Comment** - *No content.* - .. _tables: Tables diff --git a/reference/catalog_reference_schema_information.rst b/reference/catalog_reference_schema_information.rst index 6cd43ab6a..ad130643e 100644 --- a/reference/catalog_reference_schema_information.rst +++ b/reference/catalog_reference_schema_information.rst @@ -33,8 +33,6 @@ The following table shows the data objects contained in the ``sqream_catalog`` s - ``roles``, ``roles_memeberships`` * - :ref:`Schemas<schemas>` - ``schemas`` - * - :ref:`Sequences<sequences>` - - ``identity_key`` * - :ref:`Tables<tables>` - ``tables``, ``external_tables`` * - :ref:`Views<views>` From 2102d07812dbd574c8be91604f57d5088dbd3480 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 2 Oct 2023 08:25:51 +0300 Subject: [PATCH 759/882] Remove Kubernetes --- getting_started/installing_sqream.rst | 6 +----- .../installing_studio_on_stand_alone_server.rst | 4 +--- 2 files changed, 2 insertions(+), 8 deletions(-) diff --git a/getting_started/installing_sqream.rst b/getting_started/installing_sqream.rst index fef12ab36..09eefed8b 100644 --- a/getting_started/installing_sqream.rst +++ b/getting_started/installing_sqream.rst @@ -4,8 +4,6 @@ Installing SQreamDB ******************* -You may choose one of the following installation methods: - .. list-table:: :widths: auto :header-rows: 1 @@ -13,6 +11,4 @@ You may choose one of the following installation methods: * - Method - Description * - :ref:`Installing SQreamDB natively <installing_sqream_with_binary>` - - Describes installing SQreamDB using binary packages provided by SQreamDB - * - :ref:`Installing SQreamDB with Kubernetes <installing_sqream_with_kubernetes>` - - Describes installing SQreamDB using the Kubernetes open source platform + - Describes installing SQreamDB using binary packages provided by SQreamDB \ No newline at end of file diff --git a/installation_guides/installing_studio_on_stand_alone_server.rst b/installation_guides/installing_studio_on_stand_alone_server.rst index 6c6c2e05a..ad7802732 100644 --- a/installation_guides/installing_studio_on_stand_alone_server.rst +++ b/installation_guides/installing_studio_on_stand_alone_server.rst @@ -5,9 +5,7 @@ *********************** Installing Studio on a Stand-Alone Server *********************** -A stand-alone server is a server that does not run SQream based on binary files or Kubernetes. - -The Installing Studio on a Stand-Alone Server guide includes the following sections: +A stand-alone server is a server that does not run SQreamDB based on binary files. .. contents:: :local: From b3af0ac92787c670d39eff34179bcb05d6f15c67 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 2 Oct 2023 09:06:56 +0300 Subject: [PATCH 760/882] S3 alignment --- external_storage_platforms/hdfs.rst | 2 +- external_storage_platforms/s3.rst | 76 ++++++++--------------------- 2 files changed, 20 insertions(+), 58 deletions(-) diff --git a/external_storage_platforms/hdfs.rst b/external_storage_platforms/hdfs.rst index a6ffe0ead..99bb465ea 100644 --- a/external_storage_platforms/hdfs.rst +++ b/external_storage_platforms/hdfs.rst @@ -2,7 +2,7 @@ .. _back_to_top_hdfs: -Using SQream in an HDFS Environment +HDFS Environment ======================================= .. _configuring_an_hdfs_environment_for_the_user_sqream: diff --git a/external_storage_platforms/s3.rst b/external_storage_platforms/s3.rst index 2314170cf..e986ee10a 100644 --- a/external_storage_platforms/s3.rst +++ b/external_storage_platforms/s3.rst @@ -1,35 +1,26 @@ .. _s3: *********************** -Inserting Data Using Amazon S3 +Amazon Web Services *********************** -SQream uses a native S3 connector for inserting data. The ``s3://`` URI specifies an external file path on an S3 bucket. File names may contain wildcard characters, and the files can be in CSV or columnar format, such as Parquet and ORC. -.. contents:: - :local: - :depth: 1 +SQreamDB uses a native Amazon Simple Storage Services (S3) connector for inserting data. The ``s3://`` URI specifies an external file path to an S3 bucket. File names may contain wildcard characters, and the files can be in CSV or columnar format, such as Parquet and ORC. -S3 Configuration -================ - -A best practice for granting access to AWS S3 is by creating an `Identity and Access Management (IAM) <https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started.html>`_ user account. If creating an IAM user account is not possible, you may follow AWS guidelines for `using the global configuration object <https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/global-config-object.html>`_ and setting an `AWS region <https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/setting-region.html>`_. - - S3 URI Format ============= + With S3, specify a location for a file (or files) when using :ref:`copy_from` or :ref:`foreign_tables`. The following is an example of the general S3 syntax: .. code-block:: console - s3://bucket_name/path - - -Authentication -============== -SQream supports ``AWS ID`` and ``AWS SECRET`` authentication. These should be specified when executing a statement. + s3://bucket_name/path + +Granting Access to S3 +====================== +A best practice for granting access to AWS S3 is by creating an `Identity and Access Management (IAM) <https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started.html>`_ user account. If creating an IAM user account is not possible, you may follow AWS guidelines for `using the global configuration object <https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/global-config-object.html>`_ and setting an `AWS region <https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/setting-region.html>`_. Connecting to S3 Using SQreamDB Legacy Configuration File ========================================================= @@ -67,46 +58,19 @@ You may use the following parameters within your SQreamDB legacy configuration f "AwsObjectAccessStyle": "path" } +Authentication +============== + +SQreamDB supports ``AWS ID`` and ``AWS SECRET`` authentication. These should be specified when executing a statement. + Examples ======== Use a foreign table to stage data from S3 before loading from CSV, Parquet, or ORC files. -.. contents:: - :local: - :depth: 1 - -Planning for Data Staging -------------------------- -The examples in this section are based on the following table: - -+---------------+----------------+--------+----------+-----+--------+--------+-------------------+-----------+ -| Name | Team | Number | Position | Age | Height | Weight | College | Salary | -+===============+================+========+==========+=====+========+========+===================+===========+ -| Avery Bradley | Boston Celtics | 0 | PG | 25 | 2-Jun | 180 | Texas | 7730337 | -+---------------+----------------+--------+----------+-----+--------+--------+-------------------+-----------+ -| Jae Crowder | Boston Celtics | 99 | SF | 25 | 6-Jun | 235 | Marquette | 6796117 | -+---------------+----------------+--------+----------+-----+--------+--------+-------------------+-----------+ -| John Holland | Boston Celtics | 30 | SG | 27 | 5-Jun | 205 | Boston University | | -+---------------+----------------+--------+----------+-----+--------+--------+-------------------+-----------+ -| R.J. Hunter | Boston Celtics | 28 | SG | 22 | 5-Jun | 185 | Georgia State | 1148640 | -+---------------+----------------+--------+----------+-----+--------+--------+-------------------+-----------+ -| Jonas Jerebko | Boston Celtics | 8 | PF | 29 | 10-Jun | 231 | | 5000000 | -+---------------+----------------+--------+----------+-----+--------+--------+-------------------+-----------+ -| Amir Johnson | Boston Celtics | 90 | PF | 29 | 9-Jun | 240 | | 12000000 | -+---------------+----------------+--------+----------+-----+--------+--------+-------------------+-----------+ -| Jordan Mickey | Boston Celtics | 55 | PF | 21 | 8-Jun | 235 | LSU | 1170960 | -+---------------+----------------+--------+----------+-----+--------+--------+-------------------+-----------+ -| Kelly Olynyk | Boston Celtics | 41 | C | 25 | Jul-00 | 238 | Gonzaga | 2165160 | -+---------------+----------------+--------+----------+-----+--------+--------+-------------------+-----------+ -| Terry Rozier | Boston Celtics | 12 | PG | 22 | 2-Jun | 190 | Louisville | 1824360 | -+---------------+----------------+--------+----------+-----+--------+--------+-------------------+-----------+ - - -The file is stored on Amazon S3, and this bucket is public and listable. To create a matching ``CREATE FOREIGN TABLE`` statement you can make note of the file structure. - Creating a Foreign Table ------------------------ + Based on the source file's structure, you can create a foreign table with the appropriate structure, and point it to your file as shown in the following example: .. code-block:: postgres @@ -135,11 +99,12 @@ In the example above the file format is CSV, and it is stored as an S3 object. I For more information, see the following: -* :ref:`create a foreign table<create_foreign_table>` +* :ref:`Creating a foreign table<create_foreign_table>` * :ref:`hdfs` Querying Foreign Tables ----------------------- + The following shows the data in the foreign table: .. code-block:: psql @@ -160,21 +125,18 @@ The following shows the data in the foreign table: Bulk Loading a File from a Public S3 Bucket ------------------------------------------- -The ``COPY FROM`` command can also be used to load data without staging it first. -.. note:: The bucket must be publicly available and objects can be listed. +The ``COPY FROM`` command can also be used to load data without staging it first. -The following is an example of bulk loading a file from a public S3 bucket: +The bucket must be publicly available and objects must be listed. .. code-block:: postgres COPY nba FROM 's3://sqream-demo-data/nba.csv' WITH OFFSET 2 RECORD DELIMITER '\r\n'; - -For more information on the ``COPY FROM`` command, see :ref:`copy_from`. + Loading Files from an Authenticated S3 Bucket --------------------------------------------------- -The following is an example of loading fles from an authenticated S3 bucket: .. code-block:: postgres From 1b2bffc11e05a61eba850e8752e94df7b9447173 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 2 Oct 2023 09:14:54 +0300 Subject: [PATCH 761/882] Update index.rst --- external_storage_platforms/index.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/external_storage_platforms/index.rst b/external_storage_platforms/index.rst index 827fdf190..bec142ce0 100644 --- a/external_storage_platforms/index.rst +++ b/external_storage_platforms/index.rst @@ -9,9 +9,12 @@ SQream supports the following external storage platforms: :maxdepth: 1 :titlesonly: + azure + gcp + hdfs s3 - hdfs + For more information, see the following: From 4a2ce7b34cdf7cb9c1c77cca81f8d7a97f5db9e5 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 3 Oct 2023 14:26:53 +0300 Subject: [PATCH 762/882] Studio 5.6.0 --- index.rst | 2 +- releases/4.3.rst | 36 ++++++++++--------- .../configuring_your_instance_of_sqream.rst | 0 ...ing_and_managing_roles_and_permissions.rst | 0 ...ts_and_running_queries_from_the_editor.rst | 0 .../getting_started.rst | 16 ++++----- .../index.rst | 6 ++-- ...orkers_and_services_from_the_dashboard.rst | 0 .../viewing_logs.rst | 0 9 files changed, 30 insertions(+), 30 deletions(-) rename {sqream_studio_5.4.7 => sqream_studio_5.6.0}/configuring_your_instance_of_sqream.rst (100%) rename {sqream_studio_5.4.7 => sqream_studio_5.6.0}/creating_assigning_and_managing_roles_and_permissions.rst (100%) rename {sqream_studio_5.4.7 => sqream_studio_5.6.0}/executing_statements_and_running_queries_from_the_editor.rst (100%) rename {sqream_studio_5.4.7 => sqream_studio_5.6.0}/getting_started.rst (89%) rename {sqream_studio_5.4.7 => sqream_studio_5.6.0}/index.rst (77%) rename {sqream_studio_5.4.7 => sqream_studio_5.6.0}/monitoring_workers_and_services_from_the_dashboard.rst (100%) rename {sqream_studio_5.4.7 => sqream_studio_5.6.0}/viewing_logs.rst (100%) diff --git a/index.rst b/index.rst index 6a174af67..f3cbf51c3 100644 --- a/index.rst +++ b/index.rst @@ -71,7 +71,7 @@ If you couldn't find what you're looking for, we're always happy to help. Visit loading_and_unloading_data/index feature_guides/index operational_guides/index - sqream_studio_5.4.7/index + sqream_studio_5.6.0/index architecture/index configuration_guides/index reference/index diff --git a/releases/4.3.rst b/releases/4.3.rst index e496137ad..b1fa79f64 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -13,23 +13,25 @@ The 4.3 release notes were released on 11/06/2023 and describe the following: Compatibility Matrix -------------------- -+-------------------------+------------------------------------------------------------------------+ -| System Requirement | Details | -+=========================+========================================================================+ -| Supported OS | * CentOS - 7.x | -| | * RHEL - 7.x / 8.x | -+-------------------------+------------------------------------------------------------------------+ -| Supported Nvidia driver | CUDA version from 10.1 up to 11.4.3 | -+-------------------------+------------------------------------------------------------------------+ -| Storage version | 49 | -+-------------------------+------------------------------------------------------------------------+ -| Driver compatibility | * JDBC 4.5.8 | -| | * ODBC 4.4.4 | -| | * NodeJS | -| | * .NET 3.0.2 | -| | * Pysqream 3.2.5 | -| | * Spark | -+-------------------------+------------------------------------------------------------------------+ ++---------------------------------+------------------------------------------------------------------------+ +| System Requirement | Details | ++=================================+========================================================================+ +| Supported OS | * CentOS - 7.x | +| | * RHEL - 7.x / 8.x | ++---------------------------------+------------------------------------------------------------------------+ +| Supported Nvidia driver | CUDA version from 10.1 up to 11.4.3 | ++---------------------------------+------------------------------------------------------------------------+ +| Storage version | 49 | ++---------------------------------+------------------------------------------------------------------------+ +| Driver compatibility | * JDBC 4.5.8 | +| | * ODBC 4.4.4 | +| | * NodeJS | +| | * .NET 3.0.2 | +| | * Pysqream 3.2.5 | +| | * Spark | ++---------------------------------+------------------------------------------------------------------------+ +| SQream Acceleration Studio | Version 5.6.0 | ++---------------------------------+------------------------------------------------------------------------+ New Features and Enhancements ----------------------------- diff --git a/sqream_studio_5.4.7/configuring_your_instance_of_sqream.rst b/sqream_studio_5.6.0/configuring_your_instance_of_sqream.rst similarity index 100% rename from sqream_studio_5.4.7/configuring_your_instance_of_sqream.rst rename to sqream_studio_5.6.0/configuring_your_instance_of_sqream.rst diff --git a/sqream_studio_5.4.7/creating_assigning_and_managing_roles_and_permissions.rst b/sqream_studio_5.6.0/creating_assigning_and_managing_roles_and_permissions.rst similarity index 100% rename from sqream_studio_5.4.7/creating_assigning_and_managing_roles_and_permissions.rst rename to sqream_studio_5.6.0/creating_assigning_and_managing_roles_and_permissions.rst diff --git a/sqream_studio_5.4.7/executing_statements_and_running_queries_from_the_editor.rst b/sqream_studio_5.6.0/executing_statements_and_running_queries_from_the_editor.rst similarity index 100% rename from sqream_studio_5.4.7/executing_statements_and_running_queries_from_the_editor.rst rename to sqream_studio_5.6.0/executing_statements_and_running_queries_from_the_editor.rst diff --git a/sqream_studio_5.4.7/getting_started.rst b/sqream_studio_5.6.0/getting_started.rst similarity index 89% rename from sqream_studio_5.4.7/getting_started.rst rename to sqream_studio_5.6.0/getting_started.rst index 8771e5545..801996b21 100644 --- a/sqream_studio_5.4.7/getting_started.rst +++ b/sqream_studio_5.6.0/getting_started.rst @@ -1,15 +1,17 @@ .. _getting_started: -**************************** -Getting Started with SQream Acceleration Studio 5.4.7 -**************************** +******************************************************* +Getting Started with SQream Acceleration Studio 5.6.0 +******************************************************* + Setting Up and Starting Studio ------------------------------ When starting Studio, it listens on the local machine on port 8080. Logging In to Studio ---------------- +--------------------- + **To log in to SQream Studio:** 1. Open a browser to the host on **port 8080**. @@ -25,7 +27,8 @@ Logging In to Studio When you sign in, the License Warning is displayed. Navigating Studio's Main Features -------------- +--------------------------------------- + When you log in, you are automatically taken to the **Editor** screen. The Studio's main functions are displayed in the **Navigation** pane on the left side of the screen. From here you can navigate between the main areas of the Studio: @@ -57,6 +60,3 @@ By clicking the user icon, you can also use it for logging out and viewing the f * License storage capacity * Log out -.. _back_to_dashboard_5.4.7: - -.. _studio_dashboard_5.4.7: diff --git a/sqream_studio_5.4.7/index.rst b/sqream_studio_5.6.0/index.rst similarity index 77% rename from sqream_studio_5.4.7/index.rst rename to sqream_studio_5.6.0/index.rst index de8138b89..385a6e446 100644 --- a/sqream_studio_5.4.7/index.rst +++ b/sqream_studio_5.6.0/index.rst @@ -1,12 +1,10 @@ .. _sqream_studio_: ******************************** -SQream Acceleration Studio 5.4.7 +SQream Acceleration Studio 5.6.0 ******************************** -The SQreamDB Acceleration Studio 5.4.7 is a web-based client for use with SQreamDB. Studio provides users with all functionality available from the command line in an intuitive and easy-to-use format. This includes running statements, managing roles and permissions, and managing SQreamDB clusters. - -This section describes how to use the SQream Accleration Studio version 5.4.7: +The SQreamDB Acceleration Studio 5.6.0 is a web-based client for use with SQreamDB. Studio provides users with all functionality available from the command line in an intuitive and easy-to-use format. This includes running statements, managing roles and permissions, and managing SQreamDB clusters. .. toctree:: :maxdepth: 1 diff --git a/sqream_studio_5.4.7/monitoring_workers_and_services_from_the_dashboard.rst b/sqream_studio_5.6.0/monitoring_workers_and_services_from_the_dashboard.rst similarity index 100% rename from sqream_studio_5.4.7/monitoring_workers_and_services_from_the_dashboard.rst rename to sqream_studio_5.6.0/monitoring_workers_and_services_from_the_dashboard.rst diff --git a/sqream_studio_5.4.7/viewing_logs.rst b/sqream_studio_5.6.0/viewing_logs.rst similarity index 100% rename from sqream_studio_5.4.7/viewing_logs.rst rename to sqream_studio_5.6.0/viewing_logs.rst From e5f33b7af34b449926107347ee828af88c5bd1e3 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 5 Oct 2023 12:14:40 +0300 Subject: [PATCH 763/882] Update round.rst --- .../scalar_functions/numeric/round.rst | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/numeric/round.rst b/reference/sql/sql_functions/scalar_functions/numeric/round.rst index 462ec606f..b45549309 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/round.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/round.rst @@ -1,10 +1,12 @@ .. _round: -************************** +********** ROUND -************************** +********** -Rounds a numeric expression to the nearest precision. +Rounds a numeric expression to the nearest precision. + +Supported data types: ``INT``, ``TINYINT``, ``SMALLINT``, ``BIGINT``, ``REAL``, ``DOUBLE``, ``NUMERIC``. See also :ref:`ceiling`, :ref:`floor`. @@ -32,12 +34,12 @@ Arguments Returns ============ -When using the ``ROUND`` floating point number scalar function, ``real`` arguments are automatically cast to ``double`` precision. +``REAL`` arguments are automatically cast to double precision, while all other supported data types retain the supplied data type. Notes ======= -* If the input value is NULL, the result is NULL. +If the input value is ``NULL``, the result is ``NULL``. Examples =========== @@ -47,7 +49,7 @@ Rounding to the nearest integer .. code-block:: psql - numbers=> SELECT ROUND(x) FROM (VALUES (0.0001), (PI()), (-2.718281), (500.1234), (0.5), (1.5)) as t(x); + SELECT ROUND(x) FROM (VALUES (0.0001), (PI()), (-2.718281), (500.1234), (0.5), (1.5)) as t(x); round ------ 0 @@ -62,7 +64,7 @@ Rounding to 2 digits after the decimal point .. code-block:: psql - numbers=> SELECT ROUND(x,2) FROM (VALUES (0.0001), (PI()), (-2.718281), (500.1234)) as t(x); + SELECT ROUND(x,2) FROM (VALUES (0.0001), (PI()), (-2.718281), (500.1234)) as t(x); round ------- 0 @@ -75,7 +77,7 @@ Rounding to 2 digits after the decimal point .. code-block:: psql - numbers=> SELECT FLOOR(x), CEIL(x), ROUND(x) + SELECT FLOOR(x), CEIL(x), ROUND(x) . FROM (VALUES (0.0001), (-0.0001) . , (PI()), (-2.718281), (500.1234)) as t(x); floor | ceil | round From a409650f76bf84046825b8d88a730a4e4c8ca96c Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 5 Oct 2023 12:33:46 +0300 Subject: [PATCH 764/882] Update 4.3.rst --- releases/4.3.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/releases/4.3.rst b/releases/4.3.rst index b1fa79f64..0a705f640 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -50,6 +50,11 @@ To learn more about how and when you should use this new capability, visit :ref: ► RocksDB's metadata scale-up improvements have been implemented. +SQreamDB Studio Updates and Improvements +----------------------------------------- + +SQream Studio version 5.6.0 has been released. + Known Issues ------------ From 4f045a85ed74a3621e4a53d25739bcf6f4ea1382 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 16 Oct 2023 11:44:57 +0300 Subject: [PATCH 765/882] Update current_method_modification_methods.rst --- .../current_method_modification_methods.rst | 31 +++++++++---------- 1 file changed, 15 insertions(+), 16 deletions(-) diff --git a/configuration_guides/current_method_modification_methods.rst b/configuration_guides/current_method_modification_methods.rst index be12a9b4c..9c56fb6ea 100644 --- a/configuration_guides/current_method_modification_methods.rst +++ b/configuration_guides/current_method_modification_methods.rst @@ -4,7 +4,6 @@ Modification Methods ************************** - .. contents:: :local: :depth: 1 @@ -15,18 +14,18 @@ You can modify your configuration using the **worker configuration file (config. The following is an example of a worker configuration file: -.. code-block:: postgres +.. code-block:: json { - “cluster”: “/home/test_user/sqream_testing_temp/sqreamdb”, - “gpu”: 0, - “licensePath”: “home/test_user/SQream/tests/license.enc”, - “machineIP”: “127.0.0.1”, - “metadataServerIp”: “127.0.0.1”, - “metadataServerPort”: “3105, - “port”: 5000, - “useConfigIP”” true, - “legacyConfigFilePath”: “home/SQream_develop/SqrmRT/utils/json/legacy_congif.json” + "cluster": "/home/test_user/sqream_testing_temp/sqreamdb", + "gpu": 0, + "licensePath": "home/test_user/SQream/tests/license.enc", + "machineIP": "127.0.0.1", + "metadataServerIp": "127.0.0.1", + "metadataServerPort": 3105, + "port": 5000, + "useConfigIP": true, + "legacyConfigFilePath": "home/SQream_develop/SqrmRT/utils/json/legacy_congif.json" } You can access the legacy configuration file from the ``legacyConfigFilePath`` parameter shown above. If all (or most) of your workers require the same flag settings, you can set the ``legacyConfigFilePath`` attribute to the same legacy file. @@ -39,11 +38,11 @@ The Legacy configuration file provides access to the read/write flags. A link to The following is an example of the legacy configuration file: -.. code-block:: postgres +.. code-block:: json { - “developerMode”: true, - “reextentUse”: false, - “useClientLog”: true, - “useMetadataServer”” false + "developerMode": true, + "reextentUse": false, + "useClientLog": true, + "useMetadataServer": false } \ No newline at end of file From c88edee60446304d8b29a7346a691b3f77fa963c Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 16 Oct 2023 17:06:11 +0300 Subject: [PATCH 766/882] Update 4.3.rst --- releases/4.3.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/releases/4.3.rst b/releases/4.3.rst index 0a705f640..b56a89964 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -130,8 +130,8 @@ Deprecations ► **CentOS Linux 7.x** * As of June 2024, CentOS Linux 7.x will reach its End of Life and will not be supported by SQreamDB. This announcement provides a one-year advance notice for our users to plan for this change. We recommend users to explore migration or upgrade options to maintain ongoing support and security beyond this date. -* All new SQreamDB installations must use CentOS 8.X as the required operating system platform. -* **CentOS Linux 8.x** is now officially supported. + +* **REHL 8.x** is now officially supported. ► ``INT96`` From 15c2e497f9934dd946873c6d5be98896bafd48cc Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 17 Oct 2023 11:27:06 +0300 Subject: [PATCH 767/882] Update ingesting_from_databases.rst --- data_ingestion/ingesting_from_databases.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data_ingestion/ingesting_from_databases.rst b/data_ingestion/ingesting_from_databases.rst index d6324b517..654796f9b 100644 --- a/data_ingestion/ingesting_from_databases.rst +++ b/data_ingestion/ingesting_from_databases.rst @@ -1 +1 @@ -.. _ingesting_from_databases: ****************** External Databases ****************** The **SQLoader** is a CLI program that enables you to load data into SQreamDB from other databases. **SQLoader** supports Oracle and Postgresql. .. contents:: :local: :depth: 1 Before You Begin ================ It is essential that you have the following: * Java 17 * SQLoader configuration files * SQLoader.jar file Getting the SQLoader Configuration and JAR Files ================================================ 1. Download the ``.tar`` file using the following command: .. code-block:: linux curl -O https://sq-ftp-public.s3.amazonaws.com/sqloader-7.0.tar 2. Extract the ``.tar`` file using the following command: .. code-block:: linux tar -xf sqloader-7.0.tar.gz A folder named ``sqloader`` with the following files is created: .. list-table:: SQLoader Files :widths: auto :header-rows: 1 * - File - Description * - ``sqream-mapping.json`` - Maps Postgresql and Oracle data types into SQreamDB data types during ingestion * - ``sqload-jdbc.properties`` - Used for defining a connection string and may also be used to reconfigure data loading * - ``reserved_words.txt`` - A list of reserved words which cannot be used as table and/or column names * - ``sqloader.jar`` - The SQLoader package file Connection String ================= The ``sqload-jdbc.properties`` file contains a connection string that must be configured to enable data loading into SQreamDB. .. literalinclude:: connection_string.java :language: java :caption: Properties File Sample :linenos: Configuring SQLoader Connection ------------------------------- 1. Open the ``sqload-jdbc.properties`` file. 2. Configure the following parameters for: a. Either Postgresql, Oracle, or SQreamDB connection strings b. Optionally, Oracle or SQreamDB catalogs (recommended) .. list-table:: Connection String Parameters :widths: auto :header-rows: 1 * - Parameter - Description * - ``HostIp:port`` - The host and IP address number * - ``database_name`` - The name of the database from which data is loaded * - ``user`` - Username of a role to use for connection * - ``password`` - Specifies the password of the selected role * - ``ssl`` - Specifies SSL for this connection Loading Data into SQreamDB Tables ================================= 1. Run the ``sqloader.jar`` file using the following CLI command: .. code-block:: console java -jar sqloader.jar 2. You may load the entire data of a source table using the following CLI command: .. code-block:: console java -jar sqloader.jar -table source_table_name 3. You may customize the data load either by using each of the following parameters within a CLI command or by configuring the ``properties`` file: .. list-table:: SQLoader CLI Parameters :widths: auto :header-rows: 1 * - CLI Parameter - State - Default - Description * - ``-batchsize`` - Optional - ``10.000`` - The number of records to be inserted into SQreamDB at once. Please note that the configured batch size may impact chunk sizes. * - ``-casesensative`` - Optional - ``false`` - If ``true``, keeps table name uppercase and lowercase characters when table is created in SQreamDB * - ``-check_cdc_chain`` - Optional - ``false`` - Check CDC chain between tracking table and source table * - ``-chunkSize`` - Optional - ``0`` - The number of records read at once from the source database * - ``-columnlist`` - Optional - None - The name of the file that contains all column names. Columns must be separated using ``\n`` * - ``-columns`` - Optional - All columns - The name or names of columns to be loaded into SQreamDB ("col1,col2, ...") * - ``-config`` - Optional - ``config/sqload-jdbc.properties`` - Defines the configuration file you wish to use * - ``-count`` - Optional - ``true`` - Defines whether or not table rows will be counted before being loaded into SQreamDB * - ``-delete`` - Optional - ``true`` - Defines whether or not loading using Change Data Capture (CDC) includes deleted rows * - ``-drop`` - Optional - ``true`` - Defines whether or not a new target table in SQreamDB is created. If ``false``, you will need to configure a target table name using the ``-target`` parameter * - ``-fetchsize`` - Optional - ``100000`` - The number of records to be read at once from source database. * - ``-filter`` - Optional - ``1=1`` - Defines whether or not only records with SQL conditions are loaded * - ``-h, --help`` - Optional - None - Displays the help menu and exits * - ``-limit`` - Optional - ``0`` (no limit) - Limits the number of rows to be loaded * - ``-load_dttm`` - Optional - ``true`` - Add an additional ``load_dttm`` column that defines the time and date of loading * - ``-lock_check`` - Optional - ``true`` - Defines whether or not SQLoader will check source table is locked before the loading starts * - ``-lock_table`` - Optional - ``true`` - Defines whether or not SQLoader will lock target table before the loading starts * - ``-log_dir`` - Optional - ``logs`` - Defines the path of log directory created when loading data. If no value is specified, a ``logs`` folder is created under the same location as the ``sqloader.jar`` file * - ``-partition`` - Optional - None - Defines the partition to load data from if table is partitioned * - ``-rowid`` - Optional - ``false`` - Defines whether or not SQLoader will get row IDs from Oracle tables * - ``-source_db`` - Optional - ``ORCL`` - Defines the source database name. It does not modify the database connection string but impacts the storage and retrieval of data within catalog tables. * - ``-split`` - Optional - None - Column name for split (required for multi-thread loads) * - ``-table`` - Mandatory - None - Source table name to load data from * - ``-target`` - Optional - Source table name - Target table name to load data into * - ``-target_db`` - Optional - None - Target database name to load data into * - ``-thread`` - Optional - ``1`` - Number of threads to be used during loading * - ``-truncate`` - Optional - ``false`` - Truncate target table before loading * - ``-type`` - Optional - ``full`` - Defines a loading type that affects the table that is created in SQreamDB. Options are ``full``, ``cdc``, or ``inc``. Please note that ``cdc``, and ``inc`` are supported only for Oracle * - ``-use_dbms_lob`` - Optional - ``true`` - Defines whether or not SQLoader uses ``dbms_lob_substr`` function for ``CLOB`` and ``BLOB`` data types * - ``-use_partitions`` - Optional - ``true`` - Defines whether or not SQLoader uses partitions in ``SELECT`` statements Using the ``type`` Parameter ============================ Using the ``type`` parameter you may define a loading type that affects the table that is created in SQreamDB. .. list-table:: :widths: auto :header-rows: 1 * - Loading Type - Parameter Option - Description * - Full Table - ``full`` - The entire data of the source table is loaded into SQreamDB * - Change Data Capture (CDC) - ``cdc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT``, ``UPDATE``, and ``DELETE`` statements. SQLoader recognizes tables by table name and metadata. Supported for Oracle only * - Incremental - ``inc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT`` statement. SQLoader recognizes the table by table name and metadata. Supported for Oracle only Data Type Mapping ================= The **SQLoader** automatically maps data types used in Postgresql and Oracle tables that are loaded into SQreamDB. .. list-table:: Postgresql :widths: auto :header-rows: 1 * - Postgresql Type - SQreamDB Type * - ``CHAR``, ``VARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``TEXT`` - ``TEXT`` * - ``INT``, ``SMALLINT``, ``BIGINT``, ``INT2``, ``INT4`` ``INT8`` - ``BIGINT`` * - ``DATETIME``, ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BIT``, ``BOOL`` - ``BOOL`` * - ``DECIMAL``, ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``REAL``, ``FLOAT4`` - ``REAL`` .. list-table:: Oracle :widths: auto :header-rows: 1 * - Oracle Type - SQreamDB Type * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGE`` - ``BIGINT`` * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``VARCHAR2``, ``NVARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``DATE``, ``DATETIME`` - ``DATETIME`` * - ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOLEAN`` - ``BOOL`` * - ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``CLOB`` - ``TEXT`` * - ``BLOB`` - ``TEXT`` CLI Examples ============ Loading data into a CDC table using the ``type`` and ``limit`` parameters: .. code-block:: console java -jar sqloader.jar -table source_table_name -type cdc -limit 100 Loading data into a table using your own configuration file (this will override the default configuration file): .. code-block:: console java -jar sqloader.jar -config path/to/your/config/file Loading data into a table using a custom configuration file: .. code-block:: console java -jar -config MyConfigFile.properties -table source_table_name -type cdc -target target_table_name -drop true -lock_check false Loading data into a table using a the ``filter`` parameter: .. code-block:: console java -jar sqloader.jar -table source_table_name -filter column_name>50 \ No newline at end of file +.. _ingesting_from_databases: ****************** External Databases ****************** The **SQLoader** is a CLI program that enables you to load data into SQreamDB from other databases. **SQLoader** supports Oracle and Postgresql. .. contents:: :local: :depth: 1 Before You Begin ================ It is essential that you have the following: * Java 17 * SQLoader configuration files * SQLoader.jar file Getting the SQLoader Configuration and JAR Files ================================================ 1. Download the ``.tar`` file using the following command: .. code-block:: linux curl -O https://sq-ftp-public.s3.amazonaws.com/sqloader-7.7.tar 2. Extract the ``.tar`` file using the following command: .. code-block:: linux tar -xf sqloader-7.7.tar.gz A folder named ``sqloader`` with the following files is created: .. list-table:: SQLoader Files :widths: auto :header-rows: 1 * - File - Description * - ``sqream-mapping.json`` - Maps Postgresql and Oracle data types into SQreamDB data types during ingestion * - ``sqload-jdbc.properties`` - Used for defining a connection string and may also be used to reconfigure data loading * - ``reserved_words.txt`` - A list of reserved words which cannot be used as table and/or column names. * - ``sqloader.jar`` - The SQLoader package file Connection String ================= The ``sqload-jdbc.properties`` file contains a connection string that must be configured to enable data loading into SQreamDB. .. literalinclude:: connection_string.java :language: java :caption: Properties File Sample :linenos: Configuring SQLoader Connection ------------------------------- 1. Open the ``sqload-jdbc.properties`` file. 2. Configure the following parameters for: a. Either Postgresql, Oracle, or SQreamDB connection strings b. Optionally, Oracle or SQreamDB catalogs (recommended) .. list-table:: Connection String Parameters :widths: auto :header-rows: 1 * - Parameter - Description * - ``HostIp:port`` - The host and IP address number * - ``database_name`` - The name of the database from which data is loaded * - ``user`` - Username of a role to use for connection * - ``password`` - Specifies the password of the selected role * - ``ssl`` - Specifies SSL for this connection Loading Data into SQreamDB Tables ================================= 1. Run the ``sqloader.jar`` file using the following CLI command: .. code-block:: console java -jar sqloader.jar 2. You may load the entire data of a source table using the following CLI command: .. code-block:: console java -jar sqloader.jar -table source_table_name 3. You may customize the data load either by using each of the following parameters within a CLI command or by configuring the ``properties`` file: .. list-table:: SQLoader CLI Parameters :widths: 5 4 5 25 :header-rows: 1 * - CLI Parameter - State - Default - Description * - ``-batchsize`` - Optional - ``10.000`` - The number of records to be inserted into SQreamDB at once. Please note that the configured batch size may impact chunk sizes. * - ``-casesensative`` - Optional - ``false`` - If ``true``, keeps table name uppercase and lowercase characters when table is created in SQreamDB * - ``-check_cdc_chain`` - Optional - ``false`` - Check CDC chain between tracking table and source table * - ``-chunkSize`` - Optional - ``0`` - The number of records read at once from the source database * - ``-columnlist`` - Optional - None - The name of the file that contains all column names. Columns must be separated using ``\n`` * - ``-columns`` - Optional - All columns - The name or names of columns to be loaded into SQreamDB ("col1,col2, ..."). For column names containing uppercase characters, maintain the uppercase format, avoid using double quotes or apostrophes, and ensure that the ``caseSensitive`` parameter is set to true * - ``-config`` - Optional - ``/home/username/downloads/config/sqload-jdbc.properties`` - Defines the path to the configuration file you wish to use. This parameter may be defined using only the CLI * - ``-config_dir`` - Optional - ``/home/username/downloads/config`` - Defines the path to the folder containing both the data type mapping and the reserved words files. The defined folder must contain both files or else you will receive an error. * - ``-count`` - Optional - ``true`` - Defines whether or not table rows will be counted before being loaded into SQreamDB * - ``-delete`` - Optional - ``true`` - Defines whether or not loading using Change Data Capture (CDC) includes deleted rows * - ``-drop`` - Optional - ``true`` - Defines whether or not a new target table in SQreamDB is created. If ``false``, you will need to configure a target table name using the ``-target`` parameter * - ``-fetchsize`` - Optional - ``100000`` - The number of records to be read at once from source database. * - ``-filter`` - Optional - ``1=1`` - Defines whether or not only records with SQL conditions are loaded * - ``-h, --help`` - Optional - None - Displays the help menu and exits * - ``-limit`` - Optional - ``0`` (no limit) - Limits the number of rows to be loaded * - ``-load_dttm`` - Optional - ``true`` - Add an additional ``load_dttm`` column that defines the time and date of loading * - ``-lock_check`` - Optional - ``true`` - Defines whether or not SQLoader will check source table is locked before the loading starts * - ``-lock_table`` - Optional - ``true`` - Defines whether or not SQLoader will lock target table before the loading starts * - ``-log_dir`` - Optional - ``logs`` - Defines the path of log directory created when loading data. If no value is specified, a ``logs`` folder is created under the same location as the ``sqloader.jar`` file * - ``-partition`` - Optional - None - Defines the partition to load data from if table is partitioned * - ``-rowid`` - Optional - ``false`` - Defines whether or not SQLoader will get row IDs from Oracle tables * - ``-source_db`` - Optional - ``ORCL`` - Defines the source database name. It does not modify the database connection string but impacts the storage and retrieval of data within catalog tables. * - ``-split`` - Optional - None - Column name for split (required for multi-thread loads) * - ``-table`` - Mandatory - None - Source table name to load data from * - ``-target`` - Optional - Source table name - Target table name to load data into * - ``-target_db`` - Optional - None - Target database name to load data into * - ``-thread`` - Optional - ``1`` - Number of threads to be used during loading * - ``-truncate`` - Optional - ``false`` - Truncate target table before loading * - ``-type`` - Optional - ``full`` - Defines a loading type that affects the table that is created in SQreamDB. Options are ``full``, ``cdc``, or ``inc``. Please note that ``cdc``, and ``inc`` are supported only for Oracle * - ``-use_dbms_lob`` - Optional - ``true`` - Defines whether or not SQLoader uses ``dbms_lob_substr`` function for ``CLOB`` and ``BLOB`` data types * - ``-use_partitions`` - Optional - ``true`` - Defines whether or not SQLoader uses partitions in ``SELECT`` statements Using the ``type`` Parameter ============================ Using the ``type`` parameter you may define a loading type that affects the table that is created in SQreamDB. .. list-table:: :widths: auto :header-rows: 1 * - Loading Type - Parameter Option - Description * - Full Table - ``full`` - The entire data of the source table is loaded into SQreamDB * - Change Data Capture (CDC) - ``cdc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT``, ``UPDATE``, and ``DELETE`` statements. SQLoader recognizes tables by table name and metadata. Supported for Oracle only * - Incremental - ``inc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT`` statement. SQLoader recognizes the table by table name and metadata. Supported for Oracle only Data Type Mapping ================= The **SQLoader** automatically maps data types used in Postgresql and Oracle tables that are loaded into SQreamDB. .. list-table:: Postgresql :widths: auto :header-rows: 1 * - Postgresql Type - SQreamDB Type * - ``CHAR``, ``VARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``TEXT`` - ``TEXT`` * - ``INT``, ``SMALLINT``, ``BIGINT``, ``INT2``, ``INT4`` ``INT8`` - ``BIGINT`` * - ``DATETIME``, ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BIT``, ``BOOL`` - ``BOOL`` * - ``DECIMAL``, ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``REAL``, ``FLOAT4`` - ``REAL`` .. list-table:: Oracle :widths: auto :header-rows: 1 * - Oracle Type - SQreamDB Type * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGE`` - ``BIGINT`` * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``VARCHAR2``, ``NVARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``DATE``, ``DATETIME`` - ``DATETIME`` * - ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOLEAN`` - ``BOOL`` * - ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``CLOB`` - ``TEXT`` * - ``BLOB`` - ``TEXT`` CLI Examples ============ Loading data into a CDC table using the ``type`` and ``limit`` parameters: .. code-block:: console java -jar sqloader.jar -table source_table_name -type cdc -limit 100 Loading data into a table using your own configuration file (this will override the default configuration file): .. code-block:: console java -jar sqloader.jar -config path/to/your/config/file Loading data into a table using a custom configuration file: .. code-block:: console java -jar -config MyConfigFile.properties -table source_table_name -type cdc -target target_table_name -drop true -lock_check false Loading data into a table using a the ``filter`` parameter: .. code-block:: console java -jar sqloader.jar -table source_table_name -filter column_name>50 \ No newline at end of file From 696d821d9e95deb82bdd6a59a63cecdc2d45872b Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 18 Oct 2023 15:33:45 +0300 Subject: [PATCH 768/882] Update workload_manager.rst --- feature_guides/workload_manager.rst | 72 +++++++++++++---------------- 1 file changed, 33 insertions(+), 39 deletions(-) diff --git a/feature_guides/workload_manager.rst b/feature_guides/workload_manager.rst index 9cf582dde..aa18c4823 100644 --- a/feature_guides/workload_manager.rst +++ b/feature_guides/workload_manager.rst @@ -62,49 +62,43 @@ Queries from management uses any available worker. Creating the Configuration ----------------------------------- -The persistent configuration for this set-up is listed in the four configuration files shown below. - -Each worker gets a comma-separated list of service queues that it subscribes to. These services are specified in the ``initialSubscribedServices`` attribute. - .. code-block:: json - :caption: Worker #1 - :emphasize-lines: 7 - { - "compileFlags": { - }, - "runtimeFlags": { - }, - "runtimeGlobalFlags": { - "initialSubscribedServices" : "etl,management" - }, - "server": { - "gpu": 0, - "port": 5000, - "cluster": "/home/rhendricks/raviga_database", - "licensePath": "/home/sqream/.sqream/license.enc" - } - } -.. code-block:: json - :caption: Workers #2, #3, #4 - :emphasize-lines: 7 + { + "cluster": "/home/rhendricks/raviga_database", + "cudaMemQuota": 25, + "gpu": 0, + "maxConnectionInactivitySeconds": 120, + "legacyConfigFilePath": "tzah_legacy.json", + "licensePath": "/home/sqream/.sqream/license.enc", + "metadataServerIp": "192.168.0.103", + "limitQueryMemoryGB": 250, + "machineIP": "192.168.0.103", + "metadataServerPort": 3105, + "port": 5000, + "useConfigIP": true + } - { - "compileFlags": { - }, - "runtimeFlags": { - }, - "runtimeGlobalFlags": { - "initialSubscribedServices" : "query,management" - }, - "server": { - "gpu": 1, - "port": 5001, - "cluster": "/home/rhendricks/raviga_database", - "licensePath": "/home/sqream/.sqream/license.enc" - } - } +.. code-block:: json + :caption: Legacy File + + + { + "debugNetworkSession": false, + "diskSpaceMinFreePercent": 1, + "maxNumAutoCompressedChunksThreshold" : 1, + "insertMergeRowsThreshold":40000000, + "insertCompressors": 8, + "insertParsers": 8, + "nodeInfoLoggingSec": 60, + "reextentUse": true, + "separatedGatherThreads": 16, + "showFullExceptionInfo": true, + "spoolMemoryGB":200, + "useClientLog": true, + "useMetadataServer":true + } .. tip:: You can create this configuration temporarily (for the current session only) by using the :ref:`subscribe_service` and :ref:`unsubscribe_service` statements. From c0fb2bf60c6b4504bac1b3513f39197346ddccbb Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 19 Oct 2023 11:33:15 +0300 Subject: [PATCH 769/882] PERMISSIONS, GRANT, REVOKE --- .../access_control_permissions.rst | 442 +++++++++++------- .../access_control_commands/grant.rst | 200 ++++---- .../access_control_commands/revoke.rst | 204 ++++---- 3 files changed, 517 insertions(+), 329 deletions(-) diff --git a/operational_guides/access_control_permissions.rst b/operational_guides/access_control_permissions.rst index 276b969c5..23d28b031 100644 --- a/operational_guides/access_control_permissions.rst +++ b/operational_guides/access_control_permissions.rst @@ -4,135 +4,198 @@ Permissions ************** -.. contents:: - :local: - :depth: 1 - -The following table displays the access control permissions: - -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| **Permission** | **Description** | -+====================+=========================================================================================================================+ -| **Object/Layer: All Databases** | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``LOGIN`` | Use role to log into the system (the role also needs connect permission on the database it is connecting to) | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``PASSWORD`` | The password used for logging into the system | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``SUPERUSER`` | No permission restrictions on any activity | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| **Object/Layer: Database** | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``SUPERUSER`` | No permission restrictions on any activity within that database (this does not include modifying roles or permissions) | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``CONNECT`` | Connect to the database | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``CREATE`` | Create schemas in the database | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``CREATE FUNCTION``| Create and drop functions | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| **Object/Layer: Schema** | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``USAGE`` | Grants access to schema objects | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``CREATE`` | Create tables in the schema | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| **Object/Layer: Table** | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``SELECT`` | :ref:`select` from the table | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``INSERT`` | :ref:`insert` into the table | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``UPDATE`` | :ref:`update` the value of certain columns in existing rows | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``DELETE`` | :ref:`delete` and :ref:`truncate` on the table | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``DDL`` | Drop and alter on the table | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``ALL`` | All the table permissions | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| **Object/Layer: Function** | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``EXECUTE`` | Use the function | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``DDL`` | Drop and alter on the function | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``ALL`` | All function permissions | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| **Object/Layer: View** | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``SELECT`` | Select from view | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``DDL`` | DDL operations of view results | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| **Object/Layer: Foreign Table** | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``SELECT`` | Select from foreign table | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``DDL`` | Foreign table DDL operations | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| **Object/Layer: Column** | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``SELECT`` | Select from catalog | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``DDL`` | Column DDL operations | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| **Object/Layer: Catalog** | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``SELECT`` | Select from catalog | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``DDL`` | Catalog DDL operations | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| **Object/Services** | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``USAGE`` | Using a specific service | -+--------------------+-------------------------------------------------------------------------------------------------------------------------+ - - -GRANT Syntax -============ - -:ref:`grant` gives permissions to a role. +SQreamDB’s primary permission object is a role. The role operates in a dual capacity as both a user and a group. As a user, a role may have permissions to execute operations like creating tables, querying data, and administering the database. The group attribute may be thought of as a membership. As a group, a role may extend its permissions to other roles defined as its group members. This becomes handy when privileged roles wish to extend their permissions and grant multiple permissions to multiple roles. The information about all system role permissions is stored in the metadata. + +There are two types of permissions: global and object-level. Global permissions belong to ``SUPERUSER`` roles, allowing unrestricted access to all system and database activities. Object-level permissions apply to non-``SUPERUSER`` roles and can be assigned to databases, schemas, tables, functions, views, foreign tables, columns, catalogs, and services. + +The following table describe the required permissions for performing and executing operations on various SQreamDB objects. + ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| **Permission** | **Description** | ++======================+=========================================================================================================================+ +|**All Databases** | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``LOGIN`` | Use role to log into the system (the role also needs connect permission on the database it is connecting to) | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``PASSWORD`` | The password used for logging into the system | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``SUPERUSER`` | No permission restrictions on any activity | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| **Database** | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``SUPERUSER`` | No permission restrictions on any activity within that database (this does not include modifying roles or permissions) | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``CONNECT`` | Connect to the database | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``CREATE`` | Create schemas in the database | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``CREATE FUNCTION`` | Create and drop functions | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| **Schema** | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``USAGE`` | Grants access to schema objects | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``CREATE`` | Create tables in the schema | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| **Table** | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``SELECT`` | :ref:`select` from the table | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``INSERT`` | :ref:`insert` into the table | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``UPDATE`` | :ref:`update` the value of certain columns in existing rows | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``DELETE`` | :ref:`delete` and :ref:`truncate` on the table | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``DDL`` | Drop and alter on the table | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``ALL`` | All the table permissions | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| **Function** | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``EXECUTE`` | Use the function | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``DDL`` | Drop and alter on the function | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``ALL`` | All function permissions | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| **View** | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``SELECT`` | Select from view | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``DDL`` | DDL operations of view results | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| **Foreign Table** | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``SELECT`` | Select from foreign table | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``DDL`` | Foreign table DDL operations | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| **Column** | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``SELECT`` | Select from catalog | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``DDL`` | Column DDL operations | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| **Catalog** | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``SELECT`` | Select from catalog | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| **Services** | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``USAGE`` | Using a specific service | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ + +Syntax +====== + +Permissions may be granted or revoked using the following syntax. + +GRANT +------ .. code-block:: postgres -- Grant permissions at the instance/ storage cluster level: GRANT - - { SUPERUSER - | LOGIN - | PASSWORD '<password>' + { + SUPERUSER + | LOGIN + | PASSWORD '<password>' } TO <role> [, ...] -- Grant permissions at the database level: - GRANT {{CREATE | CONNECT| DDL | SUPERUSER | CREATE FUNCTION} [, ...] | ALL [PERMISSIONS]} - + GRANT + { + { CREATE + | CONNECT + | DDL + | SUPERUSER + | CREATE FUNCTION } [, ...] + | ALL [PERMISSIONS] + } ON DATABASE <database> [, ...] TO <role> [, ...] -- Grant permissions at the schema level: - GRANT {{ CREATE | DDL | USAGE | SUPERUSER } [, ...] | ALL [ - PERMISSIONS ]} + GRANT + { + { CREATE + | DDL + | USAGE + | SUPERUSER } [, ...] + | ALL [PERMISSIONS] + } ON SCHEMA <schema> [, ...] TO <role> [, ...] -- Grant permissions at the object level: - GRANT {{SELECT | INSERT | DELETE | DDL | UPDATE } [, ...] | ALL [PERMISSIONS]} - ON { TABLE <table_name> [, ...] | ALL TABLES IN SCHEMA <schema_name> [, ...] | VIEW <view_name> [, ...] | ALL VIEWS IN SCHEMA <schema_name> [, ...] | FOREIGN TABLE <table_name> [, ...] | ALL FOREIGN TABLE IN SCHEMA <schema_name> [, ...] | CATALOG <catalog_name> [, ...] } - TO <role> [, ...]; + GRANT + { + { SELECT + | INSERT + | DELETE + | DDL + | UPDATE } [, ...] + | ALL [PERMISSIONS] + } + ON + { + TABLE <table_name> [, ...] + | ALL TABLES IN SCHEMA <schema_name> [, ...] + | VIEW <schema_name.view_name> [, ...] + | ALL VIEWS IN SCHEMA <schema_name> [, ...] + | FOREIGN TABLE <table_name> [, ...] + | ALL FOREIGN TABLES IN SCHEMA <schema_name> [, ...] + } + TO <role> [, ...] + + GRANT + { + { SELECT + | INSERT + | DELETE + | UPDATE } [, ...] + | ALL [PERMISSIONS] + } + ON + { + | CATALOG <catalog_name> [, ...] + } + TO <role> [, ...] -- Grant execute function permission: - GRANT {ALL | EXECUTE | DDL} ON FUNCTION function_name + GRANT + { + ALL + | EXECUTE + | DDL + } + ON FUNCTION function_name TO role; -- Grant permissions at the column level: - GRANT {{SELECT | DDL } [, ...] | ALL [PERMISSIONS]} - ON { COLUMN <column_name> [, ...] | ALL COLUMNS IN TABLE <table_name> [, ...] | ALL COLUMNS IN FOREIGN TABLE <foreign_table_name> [, ...] | ALL COLUMNS IN VIEW <view_name> [, ...] | ALL COLUMNS IN CATALOG <catalog_name> [, ...]} - TO <role> [, ...]; + GRANT + { + { SELECT + | DDL } [, ...] + | ALL [PERMISSIONS] + } + ON + { + COLUMN <column_name> [,<column_name_2>] IN TABLE <table_name> [,<table_name2>] + | COLUMN <column_name> [,<column_name_2>] IN FOREIGN TABLE <table_name> [,<table_name2>] + | ALL COLUMNS IN TABLE <schema_name.table_name> [, ...] + | ALL COLUMNS IN FOREIGN TABLE <foreign_table_name> [, ...] + } + TO <role> [, ...] -- Grant permissions at the Service level: - GRANT {{USAGE} [PERMISSIONS]} + GRANT + { + { USAGE } [PERMISSIONS] + } ON { SERVICE <service_name> } TO <role> [, ...] @@ -142,58 +205,116 @@ GRANT Syntax -- Also allows the role2 to grant role1 to other roles: GRANT <role1> [, ...] - TO <role2> + TO <role2> [,...] [WITH ADMIN OPTION] -REVOKE Syntax -============= - -:ref:`revoke` removes permissions from a role. +REVOKE +------- .. code-block:: postgres -- Revoke permissions at the instance/ storage cluster level: REVOKE - { SUPERUSER - | LOGIN - | PASSWORD + { + SUPERUSER + | LOGIN + | PASSWORD } FROM <role> [, ...] -- Revoke permissions at the database level: - REVOKE {{CREATE | CONNECT | DDL | SUPERUSER | CREATE FUNCTION}[, ...] |ALL [PERMISSIONS]} + REVOKE + { + { CREATE + | CONNECT + | DDL + | SUPERUSER + | CREATE FUNCTION }[, ...] + | ALL [PERMISSIONS] + } ON DATABASE <database> [, ...] FROM <role> [, ...] -- Revoke permissions at the schema level: - REVOKE { { CREATE | DDL | USAGE | SUPERUSER } [, ...] | ALL [PERMISSIONS]} + REVOKE + { + { CREATE + | DDL + | USAGE + | SUPERUSER } [, ...] + | ALL [PERMISSIONS] + } ON SCHEMA <schema> [, ...] FROM <role> [, ...] -- Revoke permissions at the object level: - REVOKE { { SELECT | INSERT | DELETE | DDL | UPDATE } [, ...] | ALL } - ON { [ TABLE ] <table_name> [, ...] | ALL TABLES IN SCHEMA <schema_name> [, ...] | VIEW <view_name> [, ...] | ALL VIEWS IN SCHEMA <schema_name> [, ...] | FOREIGN TABLE <table_name> [, ...] | ALL FOREIGN TABLES IN SCHEMA <schema_name> [, ...] | CATALOG <catalog_name> [, ...] } - FROM <role> [, ...]; + REVOKE + { + { SELECT + | INSERT + | DELETE + | DDL + | UPDATE } [, ...] + | ALL + } + ON + { + [ TABLE ] <table_name> [, ...] + | ALL TABLES IN SCHEMA <schema_name> [, ...] + | VIEW <schema_name.view_name> [, ...] + | ALL VIEWS IN SCHEMA <schema_name> [, ...] + | FOREIGN TABLE <table_name> [, ...] + | ALL FOREIGN TABLES IN SCHEMA <schema_name> [, ...] + } + FROM <role> [, ...] + + REVOKE + { + { SELECT + | INSERT + | DELETE + | UPDATE } [, ...] + | ALL + } + ON + { + | CATALOG <catalog_name> [, ...] + } + FROM <role> [, ...] -- Revoke permissions at the column level: - REVOKE {{SELECT | DDL } [, ...] | ALL [PERMISSIONS]} - ON { COLUMN <column_name> [, ...] | ALL COLUMNS IN TABLE <table_name> [, ...] | ALL COLUMNS IN FOREIGN TABLE <foreign_table_name> [, ...] | ALL COLUMNS IN VIEW <view_name> [, ...] | ALL COLUMNS IN CATALOG <catalog_name> [, ...]} - FROM <role> [, ...]; + REVOKE + { + { SELECT + | DDL } [, ...] + | ALL [PERMISSIONS]} + ON + { + COLUMN <column_name> [,<column_name_2>] IN TABLE <table_name> [,<table_name2>] | COLUMN <column_name> [,<column_name_2>] IN FOREIGN TABLE <table_name> [,<table_name2>] + | ALL COLUMNS IN TABLE <schema_name.table_name> [, ...] + | ALL COLUMNS IN FOREIGN TABLE <schema_name.foreign_table_name> [, ...] + } + FROM <role> [, ...] - -- Revoke permissions at the service level: - REVOKE {{USAGE} [, ...] | ALL [PERMISSIONS]} + REVOKE + { + { USAGE } [, ...] + | ALL [PERMISSIONS] + } ON { SERVICE <service_name> } FROM <role> [, ...] -- Removes access to permissions in role1 by role 2 - REVOKE <role1> [, ...] FROM <role2> [, ...] + REVOKE [ADMIN OPTION FOR] <role1> [, ...] + FROM <role2> [, ...] -- Removes permissions to grant role1 to additional roles from role2 - REVOKE <role1> [, ...] FROM <role2> [, ...] + REVOKE [ADMIN OPTION FOR] <role1> [, ...] + FROM <role2> [, ...] Altering Default Permissions -============================ +----------------------------- The default permissions system (See :ref:`alter_default_permissions`) can be used to automatically grant permissions to newly @@ -207,37 +328,46 @@ schema statement is run. .. code-block:: postgres - ALTER DEFAULT PERMISSIONS FOR target_role_name - [IN schema_name, ...] - FOR { SCHEMAS | TABLES | FOREIGN TABLE | VIEWS | COLUMN | SERVICES | CATALOG } - { grant_clause | DROP grant_clause} - TO ROLE { role_name | public }; - - grant_clause ::= + ALTER DEFAULT PERMISSIONS FOR target_role_name + [IN schema_name, ...] + FOR { + SCHEMAS + | TABLES + | FOREIGN TABLE + | VIEWS + | COLUMNS + | SAVED_QUERIES + } + { grant_clause + | DROP grant_clause } + TO ROLE { role_name | public + } + + grant_clause ::= GRANT { CREATE FUNCTION - | SUPERUSER - | CONNECT - | CREATE - | USAGE - | SELECT - | INSERT - | DELETE - | DDL - | UPDATE - | EXECUTE - | ALL + | SUPERUSER + | CONNECT + | CREATE + | USAGE + | SELECT + | INSERT + | DELETE + | DDL + | UPDATE + | EXECUTE + | ALL } Examples ======== -GRANT Examples +GRANT -------------- Grant superuser privileges and login capability to a role: -.. code-block:: postgres +.. code-block:: sql GRANT SUPERUSER, LOGIN TO role_name; @@ -257,7 +387,7 @@ Grant permissions on specific objects (table, view, foreign table, or catalog) t .. code-block:: postgres - GRANT SELECT, INSERT, DELETE, DDL, UPDATE ON TABLE table_name TO role_name; + GRANT SELECT, INSERT, DELETE, DDL, UPDATE ON TABLE schema_name.table_name TO role_name; Grant execute function permission to a role: @@ -269,7 +399,7 @@ Grant column-level permissions to a role: .. code-block:: postgres - GRANT SELECT, DDL ON COLUMN column_name TO role_name; + GRANT SELECT, DDL ON COLUMN column_name IN TABLE schema_name.table_name TO role_name; Grant usage permissions on a service to a role: @@ -290,7 +420,7 @@ Grant role2 the ability to grant role1 to other roles: GRANT role1 TO role2 WITH ADMIN OPTION; -REVOKE Examples +REVOKE --------------- Revoke superuser privileges or login capability from a role: @@ -303,42 +433,42 @@ Revoke specific permissions on a database from a role: .. code-block:: postgres - REVOKE CREATE, CONNECT, DDL, SUPERUSER, CREATE FUNCTION FROM role_name; + REVOKE CREATE, CONNECT, DDL, SUPERUSER, CREATE FUNCTION ON DATABASE database_name FROM role_name; Revoke permissions on a schema from a role: .. code-block:: postgres - REVOKE CREATE, DDL, USAGE, SUPERUSER FROM role_name; + REVOKE CREATE, DDL, USAGE, SUPERUSER ON SCHEMA schema_name FROM role_name; Revoke permissions on specific objects (table, view, foreign table, or catalog) from a role: .. code-block:: postgres - REVOKE SELECT, INSERT, DELETE, DDL, UPDATE FROM TABLE table_name; + REVOKE SELECT, INSERT, DELETE, DDL, UPDATE ON TABLE schema_name.table_name FROM role_name; Revoke column-level permissions from a role: .. code-block:: postgres - REVOKE SELECT, DDL FROM COLUMN column_name; + REVOKE SELECT, DDL FROM COLUMN column_name IN TABLE schema_name.table_name FROM role_name; Revoke usage permissions on a service from a role: .. code-block:: postgres - REVOKE USAGE FROM SERVICE service_name; + REVOKE USAGE ON SERVICE service_name FROM role_name; Remove access to permissions in role1 by role2: .. code-block:: postgres - REVOKE role1 FROM role2 WITH ADMIN OPTION; + REVOKE role1 FROM role2 ; Remove permissions to grant role1 to additional roles from role2: .. code-block:: postgres - REVOKE role1 FROM role2 WITH ADMIN OPTION; + REVOKE ADMIN OPTION FOR role1 FROM role2 ; diff --git a/reference/sql/sql_statements/access_control_commands/grant.rst b/reference/sql/sql_statements/access_control_commands/grant.rst index d86522900..283ce3f3a 100644 --- a/reference/sql/sql_statements/access_control_commands/grant.rst +++ b/reference/sql/sql_statements/access_control_commands/grant.rst @@ -17,90 +17,124 @@ See also :ref:`revoke`, :ref:`create_role`. Syntax ========== -The following is the syntax for the ``GRANT` statement: .. code-block:: postgres - grant_statement ::= - { - -- Grant permissions at the cluster level: - GRANT - { SUPERUSER - | LOGIN - | PASSWORD 'password' - } - TO role_name [, ...] - - -- Grant permissions at the database level: - | GRANT - { - { CREATE - | CONNECT - | DDL - | SUPERUSER - | CREATE FUNCTION - } [, ...] - | ALL [PERMISSIONS] - } - ON DATABASE database_name [, ...] - TO role_name [, ...] - - -- Grant permissions at the schema level: - | GRANT - { - { CREATE - | DDL - | USAGE - | SUPERUSER - } [, ...] - | ALL [PERMISSIONS ] - } - ON SCHEMA schema_name [, ...] - TO role_name [, ...] - - -- Grant permissions at the object level: - | GRANT - { - { SELECT - | INSERT - | DELETE - | DDL - } [, ...] - | ALL [PERMISSIONS] - } - ON { TABLE table_name [, ...] | ALL TABLES IN SCHEMA schema_name [, ...]} - TO role_name [, ...] - - - -- Grant execute function permission: - | GRANT - { ALL - | EXECUTE - | DDL - } - ON FUNCTION function_name - TO role_name [, ...] - - - -- Pass permissions between roles by granting one role to another: - | GRANT role_name [, ...] - TO role_name_2 - [ WITH ADMIN OPTION ] - - ; - - role_name ::= identifier - - role_name2 ::= identifier - - database_name ::= identifier - - table_name ::= identifier - - schema_name ::= identifier + -- Grant permissions at the instance/ storage cluster level: + GRANT + { + SUPERUSER + | LOGIN + | PASSWORD '<password>' + } + TO <role> [, ...] + + -- Grant permissions at the database level: + GRANT + { + { CREATE + | CONNECT + | DDL + | SUPERUSER + | CREATE FUNCTION } [, ...] + | ALL [PERMISSIONS] + } + ON DATABASE <database> [, ...] + TO <role> [, ...] + + -- Grant permissions at the schema level: + GRANT + { + { CREATE + | DDL + | USAGE + | SUPERUSER } [, ...] + | ALL [PERMISSIONS] + } + ON SCHEMA <schema> [, ...] + TO <role> [, ...] + + -- Grant permissions at the object level: + GRANT + { + { SELECT + | INSERT + | DELETE + | DDL + | UPDATE } [, ...] + | ALL [PERMISSIONS] + } + ON + { + TABLE <table_name> [, ...] + | ALL TABLES IN SCHEMA <schema_name> [, ...] + | VIEW <schema_name.view_name> [, ...] + | ALL VIEWS IN SCHEMA <schema_name> [, ...] + | FOREIGN TABLE <table_name> [, ...] + | ALL FOREIGN TABLES IN SCHEMA <schema_name> [, ...] + } + TO <role> [, ...] + + GRANT + { + { SELECT + | INSERT + | DELETE + | UPDATE } [, ...] + | ALL [PERMISSIONS] + } + ON + { + | CATALOG <catalog_name> [, ...] + } + TO <role> [, ...] + + -- Grant execute function permission: + GRANT + { + ALL + | EXECUTE + | DDL + } + ON FUNCTION function_name + TO role; + + -- Grant permissions at the column level: + GRANT + { + { SELECT + | DDL } [, ...] + | ALL [PERMISSIONS] + } + ON + { + COLUMN <column_name> [,<column_name_2>] IN TABLE <table_name> [,<table_name2>] + | COLUMN <column_name> [,<column_name_2>] IN FOREIGN TABLE <table_name> [,<table_name2>] + | ALL COLUMNS IN TABLE <schema_name.table_name> [, ...] + | ALL COLUMNS IN FOREIGN TABLE <foreign_table_name> [, ...] + } + TO <role> [, ...] + + -- Grant permissions at the Service level: + GRANT + { + { USAGE } [PERMISSIONS] + } + ON { SERVICE <service_name> } + TO <role> [, ...] + + -- Allows role2 to use permissions granted to role1 + GRANT <role1> [, ...] + TO <role2> + + -- Also allows the role2 to grant role1 to other roles: + GRANT <role1> [, ...] + TO <role2> [,...] [WITH ADMIN OPTION] + Parameters ============ + The following table describes the ``GRANT`` parameters: .. list-table:: @@ -111,7 +145,7 @@ The following table describes the ``GRANT`` parameters: - Description * - ``role_name`` - The name of the role to grant permissions to - * - ``table_name``, ``database_name``, ``schema_name``, ``function_name`` + * - ``table_name``, ``database_name``, ``schema_name``, ``function_name``, ``catalog_name``, ``column_name``, ``service_name`` - Object to grant permissions on. * - ``WITH ADMIN OPTION`` - @@ -125,6 +159,7 @@ The following table describes the ``GRANT`` parameters: Supported Permissions ======================= + The following table describes the supported permissions: .. list-table:: @@ -182,6 +217,7 @@ The following table describes the supported permissions: Examples =========== + This section includes the following examples: .. contents:: @@ -190,6 +226,7 @@ This section includes the following examples: Creating a User Role with Log-in Permissions ---------------------------------------------- + The following example shows how to convert a role to a user by granting password and log-in permissions: .. code-block:: postgres @@ -201,6 +238,7 @@ The following example shows how to convert a role to a user by granting password Promoting a User to a Superuser ------------------------------------- + The following is the syntax for promoting a user to a superuser: .. code-block:: postgres @@ -213,6 +251,7 @@ The following is the syntax for promoting a user to a superuser: Creating a New Role for a Group of Users -------------------------------------------- + The following example shows how to create a new role for a group of users: .. code-block:: postgres @@ -229,6 +268,7 @@ The following example shows how to create a new role for a group of users: Granting with Admin Option ------------------------------ + If ``WITH ADMIN OPTION`` is specified, the role with the **admin** option can grant membership in the role to others and revoke membership, as shown below: .. code-block:: postgres @@ -240,6 +280,7 @@ If ``WITH ADMIN OPTION`` is specified, the role with the **admin** option can gr Changing Password for User Role -------------------------------------- + The following is an example of changing a password for a user role. This is done by granting the user a new password: .. code-block:: postgres @@ -250,4 +291,5 @@ The following is an example of changing a password for a user role. This is done Permissions ============= + To grant permissions, the current role must have the ``SUPERUSER`` permission, or have the ``ADMIN OPTION``. \ No newline at end of file diff --git a/reference/sql/sql_statements/access_control_commands/revoke.rst b/reference/sql/sql_statements/access_control_commands/revoke.rst index fbeee701d..8491911e9 100644 --- a/reference/sql/sql_statements/access_control_commands/revoke.rst +++ b/reference/sql/sql_statements/access_control_commands/revoke.rst @@ -1,8 +1,8 @@ .. _revoke: -***************** +****** REVOKE -***************** +****** The ``REVOKE`` statement removes permissions from a role. It allows for removing permissions to specific objects. @@ -11,95 +11,117 @@ Learn more about the permission system in the :ref:`access control guide<access_ See also :ref:`grant`, :ref:`drop_role`. Permissions -============= +=========== To revoke permissions, the current role must have the ``SUPERUSER`` permission, or have the ``ADMIN OPTION``. Syntax -========== +====== .. code-block:: postgres - grant_statement ::= - { - -- revoke permissions at the cluster level: - REVOKE - { SUPERUSER - | LOGIN - | PASSWORD 'password' - } - FROM role_name [, ...] - - -- Revoke permissions at the database level: - | REVOKE - { - { CREATE - | CONNECT - | DDL - | SUPERUSER - | CREATE FUNCTION - } [, ...] - | ALL [PERMISSIONS] - } - ON DATABASE database_name [, ...] - FROM role_name [, ...] - - -- Revoke permissions at the schema level: - | REVOKE - { - { CREATE - | DDL - | USAGE - | SUPERUSER - } [, ...] - | ALL [PERMISSIONS ] - } - ON SCHEMA schema_name [, ...] - FROM role_name [, ...] - - -- Revoke permissions at the object level: - | REVOKE - { - { SELECT - | INSERT - | DELETE - | DDL - } [, ...] - | ALL [PERMISSIONS] - } - ON { TABLE table_name [, ...] | ALL TABLES IN SCHEMA schema_name [, ...]} - FROM role_name [, ...] - - - -- Revoke execute function permission: - | REVOKE - { ALL - | EXECUTE - | DDL - } - ON FUNCTION function_name - FROM role_name [, ...] - - - -- Remove permissions between roles by revoking role membership: - | REVOKE role_name [, ...] - FROM role_name_2 - [ WITH ADMIN OPTION ] - - ; - - role_name ::= identifier - - role_name2 ::= identifier - - database_name ::= identifier - - table_name ::= identifier - - schema_name ::= identifier + -- Revoke permissions at the instance/ storage cluster level: + REVOKE + { + SUPERUSER + | LOGIN + | PASSWORD + } + FROM <role> [, ...] + + -- Revoke permissions at the database level: + REVOKE + { + { CREATE + | CONNECT + | DDL + | SUPERUSER + | CREATE FUNCTION }[, ...] + | ALL [PERMISSIONS] + } + ON DATABASE <database> [, ...] + FROM <role> [, ...] + + -- Revoke permissions at the schema level: + REVOKE + { + { CREATE + | DDL + | USAGE + | SUPERUSER } [, ...] + | ALL [PERMISSIONS] + } + ON SCHEMA <schema> [, ...] + FROM <role> [, ...] + + -- Revoke permissions at the object level: + REVOKE + { + { SELECT + | INSERT + | DELETE + | DDL + | UPDATE } [, ...] + | ALL + } + ON + { + [ TABLE ] <table_name> [, ...] + | ALL TABLES IN SCHEMA <schema_name> [, ...] + | VIEW <schema_name.view_name> [, ...] + | ALL VIEWS IN SCHEMA <schema_name> [, ...] + | FOREIGN TABLE <table_name> [, ...] + | ALL FOREIGN TABLES IN SCHEMA <schema_name> [, ...] + } + FROM <role> [, ...] + + REVOKE + { + { SELECT + | INSERT + | DELETE + | UPDATE } [, ...] + | ALL + } + ON + { + | CATALOG <catalog_name> [, ...] + } + FROM <role> [, ...] + + -- Revoke permissions at the column level: + REVOKE + { + { SELECT + | DDL } [, ...] + | ALL [PERMISSIONS]} + ON + { + COLUMN <column_name> [,<column_name_2>] IN TABLE <table_name> [,<table_name2>] | COLUMN <column_name> [,<column_name_2>] IN FOREIGN TABLE <table_name> [,<table_name2>] + | ALL COLUMNS IN TABLE <schema_name.table_name> [, ...] + | ALL COLUMNS IN FOREIGN TABLE <schema_name.foreign_table_name> [, ...] + } + FROM <role> [, ...] + + -- Revoke permissions at the service level: + REVOKE + { + { USAGE } [, ...] + | ALL [PERMISSIONS] + } + ON { SERVICE <service_name> } + FROM <role> [, ...] + + -- Removes access to permissions in role1 by role 2 + REVOKE [ADMIN OPTION FOR] <role1> [, ...] + FROM <role2> [, ...] + + -- Removes permissions to grant role1 to additional roles from role2 + REVOKE [ADMIN OPTION FOR] <role1> [, ...] + FROM <role2> [, ...] Parameters -============ +========== .. list-table:: :widths: auto @@ -109,26 +131,20 @@ Parameters - Description * - ``role_name`` - The name of the role to revoke permissions from - * - ``table_name``, ``database_name``, ``schema_name``, ``function_name`` - - Object to revoke permissions on. + * - ``table_name``, ``database_name``, ``schema_name``, ``function_name``, ``catalog_name``, ``column_name``, ``service_name`` + - Object to revoke permissions from * - ``WITH ADMIN OPTION`` - If ``WITH ADMIN OPTION`` is specified, the role that has the admin option can in turn grant membership in the role to others, and revoke membership in the role as well. Specifying ``WITH ADMIN OPTION`` for revocation will return the role to an ordinary role. An ordinary role cannot grant or revoke membership. - - - -.. include:: grant.rst - :start-line: 127 - :end-line: 180 Examples -=========== +======== Prevent a role from modifying table contents ----------------------------------------------- +-------------------------------------------- If you don't trust user ``shifty``, reokve DDL and INSERT permissions. @@ -138,7 +154,7 @@ If you don't trust user ``shifty``, reokve DDL and INSERT permissions. REVOKE DDL ON TABLE important_table FROM shifty; Demoting a user from superuser -------------------------------------- +------------------------------ .. code-block:: postgres @@ -146,7 +162,7 @@ Demoting a user from superuser REVOKE SUPERUSER FROM new_role; Revoking admin option ------------------------------- +--------------------- If ``WITH ADMIN OPTION`` is specified, the role that has the admin option can in turn grant membership in the role to others, and revoke membership in the role as well. From 856f08285f9e35fed992d2a68b86763ac7547abe Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 19 Oct 2023 11:45:54 +0300 Subject: [PATCH 770/882] Update alter_default_permissions.rst --- .../alter_default_permissions.rst | 98 ++++++++++--------- 1 file changed, 53 insertions(+), 45 deletions(-) diff --git a/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst b/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst index 95c5acfd0..c2de52db5 100644 --- a/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst +++ b/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst @@ -1,60 +1,64 @@ .. _alter_default_permissions: -***************************** +************************* ALTER DEFAULT PERMISSIONS -***************************** +************************* -.. contents:: - :local: - :depth: 1 - -Overview -============= The ``ALTER DEFAULT PERMISSIONS`` command lets you grant automatic permissions to future objects. By default, users do not have ``SELECT`` permissions on tables created by other users. Database administrators can grant access to other users by modifying the target role default permissions. For more information about access control, see :ref:`Access Control<access_control>`. +.. contents:: + :local: + :depth: 1 + Permissions -============= +=========== + The ``SUPERUSER`` permission is required to alter default permissions. Syntax -========== -The following is the syntax for altering default permissions: +====== .. code-block:: postgres - alter_default_permissions_statement ::= - ALTER DEFAULT PERMISSIONS FOR { target_role_name | ALL ROLES } - [IN schema_name, ...] - FOR { TABLES | SCHEMAS } - { grant_clause [, ...] | DROP grant_clause[, ...]} - TO { role_name [, ...] | public }; - - grant_clause ::= - GRANT - { SUPERUSER + ALTER DEFAULT PERMISSIONS FOR target_role_name + [IN schema_name, ...] + FOR { + SCHEMAS + | TABLES + | FOREIGN TABLE + | VIEWS + | COLUMNS + | SAVED_QUERIES + } + { grant_clause + | DROP grant_clause } + TO ROLE { role_name | public + } + + grant_clause ::= + GRANT + { CREATE FUNCTION + | SUPERUSER + | CONNECT | CREATE | USAGE | SELECT | INSERT - | UPDATE | DELETE | DDL + | UPDATE + | EXECUTE | ALL - } [, ...] - - target_role_name ::= identifier - - role_name ::= identifier - - schema_name ::= identifier + } Supported Permissions -======================= +===================== + The following table describes the supported permissions: .. list-table:: @@ -93,37 +97,38 @@ The following table describes the supported permissions: Examples -============ +======== .. contents:: :local: :depth: 1 Granting Default Table Permissions -------------------------------------------------- -This example is based on the roles **r1** and **r2**, created as follows: +---------------------------------- + +Altering the default permissions of **r1** so that **r2** is able to execute ``SELECT`` on tables created by **r1**: .. code-block:: postgres - create role r1; - create role r2; - alter default permissions for r1 for tables grant select to r2; + CREATE ROLE r1; + CREATE ROLE r2; + ALTER DEFAULT PERMISSIONS FOR r1 FOR TABLES GRANT SELECT TO r2; Once created, you can build and run the following query based on the above: .. code-block:: postgres - select + SELECT tdp.database_name as "database_name", ss.schema_name as "schema_name", rs1.name as "table_creator", rs2.name as "grant_to", pts.name as "permission_type" - from sqream_catalog.table_default_permissions tdp - inner join sqream_catalog.roles rs1 on tdp.modifier_role_id = rs1.role_id - inner join sqream_catalog.roles rs2 on tdp.getter_role_id = rs2.role_id - left join sqream_catalog.schemas ss on tdp.schema_id = ss.schema_id - inner join sqream_catalog.permission_types pts on pts.permission_type_id=tdp.permission_type + FROM sqream_catalog.table_default_permissions tdp + INNER JOIN sqream_catalog.roles rs1 on tdp.modifier_role_id = rs1.role_id + INNER JOIN sqream_catalog.roles rs2 on tdp.getter_role_id = rs2.role_id + LEFT JOIN sqream_catalog.schemas ss on tdp.schema_id = ss.schema_id + INNER JOIN sqream_catalog.permission_types pts on pts.permission_type_id=tdp.permission_type ; The following is an example of the output generated from the above queries: @@ -137,7 +142,8 @@ The following is an example of the output generated from the above queries: For more information about default permissions, see `Default Permissions <https://docs.sqream.com/en/latest/reference/catalog_reference_catalog_tables.html#default-permissions.html>`_. Granting Automatic Permissions for Newly Created Schemas -------------------------------------------------- +-------------------------------------------------------- + When the role ``demo`` creates a new schema, roles **u1,u2** are granted ``USAGE`` and ``CREATE`` permissions in the new schema, as shown below: .. code-block:: postgres @@ -145,7 +151,8 @@ When the role ``demo`` creates a new schema, roles **u1,u2** are granted ``USAGE ALTER DEFAULT PERMISSIONS FOR demo FOR SCHEMAS GRANT USAGE, CREATE TO u1,u2; Granting Automatic Permissions for Newly Created Tables in a Schema ----------------------------------------------------------------- +------------------------------------------------------------------- + When the role ``demo`` creates a new table in schema ``s1``, roles **u1,u2** are granted ``SELECT`` permissions, as shown below: .. code-block:: postgres @@ -153,7 +160,8 @@ When the role ``demo`` creates a new table in schema ``s1``, roles **u1,u2** are ALTER DEFAULT PERMISSIONS FOR demo IN s1 FOR TABLES GRANT SELECT TO u1,u2; Revoking Permissions from Newly Created Tables ---------------------------------------------------------------- +---------------------------------------------- + Revoking permissions refers to using the ``DROP GRANT`` command, as shown below: .. code-block:: postgres From dd390757935150ec91e0c818a0f6cfcc4c86e400 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 31 Oct 2023 15:17:42 +0200 Subject: [PATCH 771/882] Update hardware_guide.rst --- getting_started/hardware_guide.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/getting_started/hardware_guide.rst b/getting_started/hardware_guide.rst index f0a1b2479..bb922664d 100644 --- a/getting_started/hardware_guide.rst +++ b/getting_started/hardware_guide.rst @@ -45,7 +45,7 @@ An average single-node cluster can be a rackmount server or workstation, contain * - Server - Dell R750, Dell R940xa, HP ProLiant DL380 Gen10 or similar (Intel only) * - Processor - - 2x Intel Xeon Gold 6240 (18C/36HT) 2.6GHz or similar + - 2x Intel Xeon Gold 6348 (28C/56HT) 3.5GHz or similar * - RAM - 1.5 TB * - Onboard storage @@ -90,7 +90,7 @@ The following table shows SQream's recommended hardware specifications: * - Server - Dell R750, Dell R940xa, HP ProLiant DL380 Gen10 or similar (Intel only) * - Processor - - 2x Intel Xeon Gold 6240 (18C/36HT) 2.6GHz or similar + - 2x Intel Xeon Gold 6348 (28C/56HT) 3.5GHz or similar * - RAM - 2 TB * - Onboard storage From 5e22e2f6d97b4b7e221d254930eec9c00b6e3ceb Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 6 Nov 2023 07:45:21 +0200 Subject: [PATCH 772/882] Update hardware_guide.rst --- getting_started/hardware_guide.rst | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/getting_started/hardware_guide.rst b/getting_started/hardware_guide.rst index bb922664d..1cdd0965e 100644 --- a/getting_started/hardware_guide.rst +++ b/getting_started/hardware_guide.rst @@ -55,7 +55,10 @@ An average single-node cluster can be a rackmount server or workstation, contain * 10x 3.84TB SSD 2.5in Hot plug for storage, RAID6 * - GPU - - NVIDIA 2x A100 or H100 + - + * NVIDIA 2x A100 or H100 + * NVIDIA 2x L40S + * - Operating System - Red Hat Enterprise Linux v7.9 or CentOS v7.9 or Amazon Linux @@ -102,7 +105,7 @@ The following table shows SQream's recommended hardware specifications: * Mellanox Connectx5/6 100G NVIDIA Network Card (if applicable) or other high-speed network card minimum 40G compatible with customer’s infrastructure * 50 TB (NAS connected over GPFS, Lustre, Weka, or VAST) GPFS recommended * - GPU - - NVIDIA 2x A100 or H100 + - NVIDIA 2x A100, H100, or L40S * - Operating System - Red Hat Enterprise Linux v7.9 or CentOS v7.9 or Amazon Linux @@ -237,5 +240,5 @@ Storage For clustered scale-out installations, SQream relies on NAS storage. For stand-alone installations, SQream relies on redundant disk configurations, such as RAID 5, 6, or 10. These RAID configurations replicate blocks of data between disks to avoid data loss or system unavailability. -SQream recommends using enterprise-grade SAS SSD or NVMe drives. For a 32-user configuration, the number of GPUs should roughly match the number of users. SQream recommends 1 Tesla A100 GPU or H100 per 2 users, for full, uninterrupted dedicated access. +SQream recommends using enterprise-grade SAS SSD or NVMe drives. For a 32-user configuration, the number of GPUs should roughly match the number of users. SQream recommends 1 Tesla A100 / H100 or L40S GPU per 2 users, for full, uninterrupted dedicated access. From 7ba111923675f4e6e3e64347d8e1176bffaccc3c Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 6 Nov 2023 08:17:26 +0200 Subject: [PATCH 773/882] Update catalog_reference_catalog_tables.rst --- reference/catalog_reference_catalog_tables.rst | 4 ---- 1 file changed, 4 deletions(-) diff --git a/reference/catalog_reference_catalog_tables.rst b/reference/catalog_reference_catalog_tables.rst index 4ad9a916f..6d07f9008 100644 --- a/reference/catalog_reference_catalog_tables.rst +++ b/reference/catalog_reference_catalog_tables.rst @@ -264,10 +264,6 @@ The following table describes the ``schema_permissions`` data object: * - ``permission_type`` - Identifies the permission type. -UDF Permissions -***************** - -**Comment** - *No content.* .. _queries: From 4ac4342c918d3728c53c172e106b325c66dee8fa Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 6 Nov 2023 08:37:33 +0200 Subject: [PATCH 774/882] Update catalog_reference_overview.rst --- reference/catalog_reference_overview.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/reference/catalog_reference_overview.rst b/reference/catalog_reference_overview.rst index b74663509..132e2db1f 100644 --- a/reference/catalog_reference_overview.rst +++ b/reference/catalog_reference_overview.rst @@ -3,9 +3,10 @@ ************************************* Overview ************************************* -The SQream database uses a schema called ``sqream_catalog`` that contains information about your database's objects, such tables, columns, views, and permissions. Some additional catalog tables are used primarily for internal analysis and which may be different across SQream versions. + +The SQream database uses a schema called ``sqream_catalog`` that contains information about your database's objects, such as tables, columns, views, and permissions. Some additional catalog tables are used primarily for internal analysis and may differ across SQream versions. * :ref:`catalog_reference_schema_information` * :ref:`catalog_reference_catalog_tables` * :ref:`catalog_reference_additonal_tables` -* :ref:`catalog_reference_examples` \ No newline at end of file +* :ref:`catalog_reference_examples` From 485ddc0f9b9cb058bceb4ddd896cca3aae6e60ec Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 6 Nov 2023 08:48:42 +0200 Subject: [PATCH 775/882] Update supported_data_types.rst --- data_type_guides/supported_data_types.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/data_type_guides/supported_data_types.rst b/data_type_guides/supported_data_types.rst index 25309ad65..91762ba1d 100644 --- a/data_type_guides/supported_data_types.rst +++ b/data_type_guides/supported_data_types.rst @@ -3,6 +3,7 @@ ************************* Supported Data Types ************************* + The **Supported Data Types** page describes SQream's supported data types: The following table shows the supported data types. @@ -55,7 +56,7 @@ The following table shows the supported data types. - Variable length string - UTF-8 unicode - Up to ``4`` bytes - ``'Kiwis have tiny wings, but cannot fly.'`` - - ``CHAR VARYING``, ``CHAR``, ``CHARACTER VARYING``, ``CHARACTER``, ``NATIONAL CHARACTER VARYING``, ``NATIONAL CHARACTER``, ``NCHAR VARYING``, ``NCHAR``, ``NATIONAL CHAR``, ``NATIONAL CHAR VARYING`` + - ``CHAR VARYING``, ``CHAR``, ``CHARACTER VARYING``, ``CHARACTER``, ``NATIONAL CHARACTER VARYING``, ``NATIONAL CHARACTER``, ``NCHAR VARYING``, ``NCHAR``, ``NATIONAL CHAR``, ``NATIONAL CHAR VARYING``, ``NVARCHAR`` * - ``NUMERIC`` - 38 digits - 16 bytes From d7f73e3e932593d231dedda51a856ffb59c1a6b9 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 6 Nov 2023 11:32:22 +0200 Subject: [PATCH 776/882] Revert "Update supported_data_types.rst" This reverts commit 485ddc0f9b9cb058bceb4ddd896cca3aae6e60ec. --- data_type_guides/supported_data_types.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/data_type_guides/supported_data_types.rst b/data_type_guides/supported_data_types.rst index 91762ba1d..25309ad65 100644 --- a/data_type_guides/supported_data_types.rst +++ b/data_type_guides/supported_data_types.rst @@ -3,7 +3,6 @@ ************************* Supported Data Types ************************* - The **Supported Data Types** page describes SQream's supported data types: The following table shows the supported data types. @@ -56,7 +55,7 @@ The following table shows the supported data types. - Variable length string - UTF-8 unicode - Up to ``4`` bytes - ``'Kiwis have tiny wings, but cannot fly.'`` - - ``CHAR VARYING``, ``CHAR``, ``CHARACTER VARYING``, ``CHARACTER``, ``NATIONAL CHARACTER VARYING``, ``NATIONAL CHARACTER``, ``NCHAR VARYING``, ``NCHAR``, ``NATIONAL CHAR``, ``NATIONAL CHAR VARYING``, ``NVARCHAR`` + - ``CHAR VARYING``, ``CHAR``, ``CHARACTER VARYING``, ``CHARACTER``, ``NATIONAL CHARACTER VARYING``, ``NATIONAL CHARACTER``, ``NCHAR VARYING``, ``NCHAR``, ``NATIONAL CHAR``, ``NATIONAL CHAR VARYING`` * - ``NUMERIC`` - 38 digits - 16 bytes From 59d0aa6c83de80fdc05df61d62df83701b60b34b Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 6 Nov 2023 11:37:02 +0200 Subject: [PATCH 777/882] Update hardware_guide.rst --- getting_started/hardware_guide.rst | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/getting_started/hardware_guide.rst b/getting_started/hardware_guide.rst index 1cdd0965e..f03f57f83 100644 --- a/getting_started/hardware_guide.rst +++ b/getting_started/hardware_guide.rst @@ -56,9 +56,8 @@ An average single-node cluster can be a rackmount server or workstation, contain * - GPU - - * NVIDIA 2x A100 or H100 - * NVIDIA 2x L40S - + NVIDIA 2x A100ת, H100, or L40S + * - Operating System - Red Hat Enterprise Linux v7.9 or CentOS v7.9 or Amazon Linux From c613a67bb753fc8a08d4fb17b4ea4d6f886c6f5d Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 20 Nov 2023 10:58:20 +0200 Subject: [PATCH 778/882] Update max_statement_inactivity_seconds.rst --- configuration_guides/max_statement_inactivity_seconds.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/configuration_guides/max_statement_inactivity_seconds.rst b/configuration_guides/max_statement_inactivity_seconds.rst index a6e35d28c..868d1ab64 100644 --- a/configuration_guides/max_statement_inactivity_seconds.rst +++ b/configuration_guides/max_statement_inactivity_seconds.rst @@ -4,7 +4,7 @@ MAX STATEMENT INACTIVITY SECONDS ******************************** -The ``maxConnectionInactivitySeconds`` determines the maximum period of session idleness, after which the connection is terminated. +The ``maxStatementInactivitySeconds`` determines the maximum period of session idleness, after which the connection is terminated. * **Data type** - size_t * **Default value** - ``5*60*60 seconds (18000)`` From 51be7637b054757d3272a47fe3bf510e5fde300e Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 20 Nov 2023 15:30:18 +0200 Subject: [PATCH 779/882] Update max_statement_inactivity_seconds.rst --- configuration_guides/max_statement_inactivity_seconds.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/configuration_guides/max_statement_inactivity_seconds.rst b/configuration_guides/max_statement_inactivity_seconds.rst index 868d1ab64..7a1483f6c 100644 --- a/configuration_guides/max_statement_inactivity_seconds.rst +++ b/configuration_guides/max_statement_inactivity_seconds.rst @@ -4,7 +4,7 @@ MAX STATEMENT INACTIVITY SECONDS ******************************** -The ``maxStatementInactivitySeconds`` determines the maximum period of session idleness, after which the connection is terminated. +The ``maxStatementInactivitySeconds`` parameter is optional and determines the maximum duration of statement inactivity before terminating the Worker. Its behavior is contingent on the configuration of ``healerActionGracefulShutdown``. If set to ``true``, it triggers a graceful Worker shutdown; if set to ``false``, the Worker continues without shutting down, accompanied by relevant log information regarding the stuck query. * **Data type** - size_t * **Default value** - ``5*60*60 seconds (18000)`` From 5dd56493dae29a14c146a17bb0fd559c73c3f3b5 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 20 Nov 2023 15:32:40 +0200 Subject: [PATCH 780/882] Delete healer_max_statement_inactivity_seconds.rst --- .../healer_max_statement_inactivity_seconds.rst | 14 -------------- 1 file changed, 14 deletions(-) delete mode 100644 configuration_guides/healer_max_statement_inactivity_seconds.rst diff --git a/configuration_guides/healer_max_statement_inactivity_seconds.rst b/configuration_guides/healer_max_statement_inactivity_seconds.rst deleted file mode 100644 index 142e76eb7..000000000 --- a/configuration_guides/healer_max_statement_inactivity_seconds.rst +++ /dev/null @@ -1,14 +0,0 @@ -.. _healer_max_statement_inactivity_seconds: - -************************* -Max Statement Inactivity Seconds -************************* -The ``maxStatementInactivitySeconds`` flag is used for defining the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU. - -The following describes the ``maxStatementInactivitySeconds`` worker level flag: - -* **Data type** - size_t -* **Default value** - ``5`` -* **Allowed values** - 1-4000000000 - -For related flags, see :ref:`is_healer_on`. \ No newline at end of file From a0896f83e2733b4a10c010bde61ed1fad5063da6 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 20 Nov 2023 15:54:16 +0200 Subject: [PATCH 781/882] modifying_role --- operational_guides/access_control_permissions.rst | 2 +- .../access_control_commands/alter_default_permissions.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/operational_guides/access_control_permissions.rst b/operational_guides/access_control_permissions.rst index 23d28b031..2883ffee6 100644 --- a/operational_guides/access_control_permissions.rst +++ b/operational_guides/access_control_permissions.rst @@ -328,7 +328,7 @@ schema statement is run. .. code-block:: postgres - ALTER DEFAULT PERMISSIONS FOR target_role_name + ALTER DEFAULT PERMISSIONS FOR modifying_role [IN schema_name, ...] FOR { SCHEMAS diff --git a/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst b/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst index c2de52db5..478bbdf5b 100644 --- a/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst +++ b/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst @@ -24,7 +24,7 @@ Syntax .. code-block:: postgres - ALTER DEFAULT PERMISSIONS FOR target_role_name + ALTER DEFAULT PERMISSIONS FOR modifying_role [IN schema_name, ...] FOR { SCHEMAS From a6664b205e8e141fd4721808b3df17a76b4e3eab Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 22 Nov 2023 10:55:06 +0200 Subject: [PATCH 782/882] Spooling --- .../concurrency_and_scaling_in_sqream.rst | 24 ++-- configuration_guides/index.rst | 9 +- configuration_guides/spooling.rst | 43 ------- .../installing_sqream_with_binary.rst | 109 +----------------- 4 files changed, 20 insertions(+), 165 deletions(-) delete mode 100644 configuration_guides/spooling.rst diff --git a/architecture/concurrency_and_scaling_in_sqream.rst b/architecture/concurrency_and_scaling_in_sqream.rst index 990f49075..740a5ff10 100644 --- a/architecture/concurrency_and_scaling_in_sqream.rst +++ b/architecture/concurrency_and_scaling_in_sqream.rst @@ -7,7 +7,7 @@ Sizing Concurrency and Scaling in SQreamDB =================================== -A SQreamDB cluster can execute one statement per worker process while also supporting the concurrent operation of multiple workers. Utility functions with minimal resource requirements, such as :ref:`show_server_status`, will be executed regardless of the workload. +A SQreamDB cluster can execute one statement per worker process while also supporting the concurrent operation of multiple workers. Utility functions with minimal resource requirements, such as :ref:`show_server_status`, :ref:`show_locks`, and :ref:`show_node_info` will be executed regardless of the workload. Minimum Resource Required Per Worker: @@ -47,16 +47,18 @@ Maximum Workers Per GPU: * - GPU - Workers - * - NVIDIA Tesla T4 (16GB) + * - NVIDIA Turing T4 (16GB) - 1 - * - NVIDIA Tesla V100 (32GB) + * - NVIDIA Volta V100 (32GB) - 2 - * - NVIDIA Tesla A100 (40GB) + * - NVIDIA Ampere A100 (40GB) - 3 - * - NVIDIA Tesla A100 (80GB) + * - NVIDIA Ampere A100 (80GB) - 6 - * - NVIDIA Tesla H100 (80GB) + * - NVIDIA Hopper H100 (80GB) - 6 + * - L40S Ada Lovelace (48GB) + - 4 @@ -82,6 +84,8 @@ To boost the performance of a single statement, start by examining the :ref:`bes Adding additional RAM to nodes, using more GPU memory, and faster CPUs or storage can also sometimes help. +.. _spooling: + Spooling Configuration ====================== @@ -89,7 +93,7 @@ Spooling Configuration :math:`spoolMemoryGB=limitQueryMemoryGB - 50GB` -SQreamDB recommends setting the ``spoolMemoryGB`` flag to 90% of the ``limitQueryMemoryGB`` flag. The ``limitQueryMemoryGB`` flag is the total memory you’ve allocated for processing queries. In addition, the ``limitQueryMemoryGB`` defines how much total system memory is used by each worker. Note that ``spoolMemoryGB`` must bet set to less than the ``limitQueryMemoryGB``. +The ``limitQueryMemoryGB`` flag is the total memory you’ve allocated for processing queries. In addition, the ``limitQueryMemoryGB`` defines how much total system memory is used by each worker. Note that ``spoolMemoryGB`` must bet set to less than the ``limitQueryMemoryGB``. Example ------- @@ -97,7 +101,7 @@ Example Setting Spool Memory ~~~~~~~~~~~~~~~~~~~~ -The following examples are for 2T of RAM and 9 workers running on 3 A100(40) GPUs: +The provided examples assume a configuration with 2T of RAM, 8 workers running on 2 A100(80GB) GPUs, with 200 GB allocated for Internal Operations, Metadata Server, Server Picker, and UI. Configuring the ``limitQueryMemoryGB`` using the Worker configuration file: @@ -112,7 +116,7 @@ Configuring the ``limitQueryMemoryGB`` using the Worker configuration file: “metadataServerPort”: 3105, “port”: 5000, “useConfigIP”: true, - “limitQueryMemoryGB" : 201, + “limitQueryMemoryGB" : 225, } Configuring the ``spoolMemoryGB`` using the legacy configuration file: @@ -130,7 +134,7 @@ Configuring the ``spoolMemoryGB`` using the legacy configuration file: "nodeInfoLoggingSec": 60, "useClientLog": true, "useMetadataServer": true, - "spoolMemoryGB": 151, + "spoolMemoryGB": 175, "waitForClientSeconds": 18000, "enablePythonUdfs": true } diff --git a/configuration_guides/index.rst b/configuration_guides/index.rst index f93fce2ae..a694bb227 100644 --- a/configuration_guides/index.rst +++ b/configuration_guides/index.rst @@ -1,8 +1,8 @@ .. _configuration_guides: -******************** +************************* Configuration Guides -******************** +************************* The **Configuration Guides** page describes the following configuration information: @@ -11,7 +11,4 @@ The **Configuration Guides** page describes the following configuration informat :glob: configuring_sqream - configuration_flags - spooling - ldap - previous_configuration_method + ldap \ No newline at end of file diff --git a/configuration_guides/spooling.rst b/configuration_guides/spooling.rst deleted file mode 100644 index 0235b757a..000000000 --- a/configuration_guides/spooling.rst +++ /dev/null @@ -1,43 +0,0 @@ -.. _spooling: - -************************** -Configuring the Spooling Feature -************************** - -From the SQream Acceleration Studio you can allocate the amount of memory (GB) available to the server for spooling using the :ref:`spoolMemoryGB flag<spool_memory_gb>`. SQream recommends setting the ``spoolMemoryGB`` flag to 90% of the ``limitQueryMemoryGB`` flag. The ``limitQueryMemoryGB`` flag is the total memory you’ve allocated for processing queries. - -In addition, the ``limitQueryMemoryGB`` defines how much total system memory is used by each worker. SQream recommends setting ``limitQueryMemoryGB`` to 5% less than the total host memory divided by the amount of ``sqreamd`` workers on host. - -Note that ``spoolMemoryGB`` must bet set to less than the ``limitQueryMemoryGB``. - -Example Configurations ----------- - -Setting Spool Memory -~~~~~~~~~~~ -The following is an example of setting ``spoolMemoryGB`` value per-worker for 512GB of RAM and 4 workers: - -.. code-block:: console - - { - “cluster”: “/home/test_user/sqream_testing_temp/sqreamdb”, - “gpu”: 0, - “licensePath”: “home/test_user/SQream/tests/license.enc”, - “machineIP”: “127.0.0.1”, - “metadataServerIp”: “127.0.0.1”, - “metadataServerPort”: “3105, - “port”: 5000, - “useConfigIP”” true, - “limitQueryMemoryGB" : 121, - “spoolMemoryGB" : 108 - “legacyConfigFilePath”: “home/SQream_develop/SqrmRT/utils/json/legacy_congif.json” - } - -Recommended Settings -~~~~~~~~~~~ -The following is an example of the recommended settings for a machine with 512GB of RAM and 4 workers: - -.. code-block:: console - - limitQueryMemoryGB - ⌊(512 * 0.95 / 4)⌋ → ~ 486 / 4 → 121 - spoolMemoryGB - ⌊( 0.9 * limitQueryMemoryGB )⌋ → ⌊( 0.9 * 121 )⌋ → 108 diff --git a/installation_guides/installing_sqream_with_binary.rst b/installation_guides/installing_sqream_with_binary.rst index bb26a8180..9c79c1688 100644 --- a/installation_guides/installing_sqream_with_binary.rst +++ b/installation_guides/installing_sqream_with_binary.rst @@ -3,6 +3,7 @@ ********************************************* Installing SQream Using Binary Packages ********************************************* + This procedure describes how to install SQream using Binary packages and must be done on all servers. **To install SQream using Binary packages:** @@ -86,6 +87,8 @@ In each JSON file, the following parameters **must be updated**: * port * ssl_port +See how to :ref:`configure <spooling>` the Spool Memory and Limit Query Memory. + Note the following: * The value of the **metadataServerIp** parameter must point to the IP that the metadata is running on. @@ -170,109 +173,3 @@ It would be same on server running metadataserver and different on other server If you have an HDFS environment, see :ref:`Configuring an HDFS Environment for the User sqream <hdfs>`. - - - - -Upgrading SQream Version -------------------------- -Upgrading your SQream version requires stopping all running services while you manually upgrade SQream. - -**To upgrade your version of SQream:** - -1. Stop all actively running SQream services. - -.. note:: All SQream services must remain stopped while the upgrade is in process. Ensuring that SQream services remain stopped depends on the tool being used. - -For an example of stopping actively running SQream services, see :ref:`Launching SQream with Monit <launching_sqream_with_monit>`. - -2. Verify that SQream has stopped listening on ports **500X**, **510X**, and **310X**: - - .. code-block:: console - - $ sudo netstat -nltp #to make sure sqream stopped listening on 500X, 510X and 310X ports. - -3. Replace the old version ``sqream-db-v2021.1``, with the new version ``sqream-db-v2021.1``: - - .. code-block:: console - - $ cd /home/sqream - $ mkdir tempfolder - $ mv sqream-db-v2021.1.tar.gz tempfolder/ - $ cd tempfolder/ - $ tar -xf sqream-db-v2021.1.tar.gz - $ sudo mv sqream /usr/local/sqream-db-v2021.1 - $ cd /usr/local - $ sudo chown -R sqream:sqream sqream-db-v2021.1 - -4. Remove the symbolic link: - - .. code-block:: console - - $ sudo rm sqream - -5. Create a new symbolic link named "sqream" pointing to the new version: - - .. code-block:: console - - $ sudo ln -s sqream-db-v2021.1 sqream - -6. Verify that the symbolic SQream link points to the real folder: - - .. code-block:: console - - $ ls -l - - The following is an example of the correct output: - - .. code-block:: console - - $ sqream -> sqream-db-v2021.1 - -7. **Optional-** (for major versions) Upgrade your version of SQream storage cluster, as shown in the following example: - - .. code-block:: console - - $ cat /etc/sqream/sqream1_config.json |grep cluster - $ ./upgrade_storage <cluster path> - - The following is an example of the correct output: - - .. code-block:: console - - get_leveldb_version path{<cluster path>} - current storage version 23 - upgrade_v24 - upgrade_storage to 24 - upgrade_storage to 24 - Done - upgrade_v25 - upgrade_storage to 25 - upgrade_storage to 25 - Done - upgrade_v26 - upgrade_storage to 26 - upgrade_storage to 26 - Done - validate_leveldb - ... - upgrade_v37 - upgrade_storage to 37 - upgrade_storage to 37 - Done - validate_leveldb - storage has been upgraded successfully to version 37 - -8. Verify that the latest version has been installed: - - .. code-block:: console - - $ ./sqream sql --username sqream --password sqream --host localhost --databasename master -c "SELECT SHOW_VERSION();" - - The following is an example of the correct output: - - .. code-block:: console - - v2021.1 - 1 row - time: 0.050603s - -For more information, see the :ref:`upgrade_storage<upgrade_storage_cli_reference>` command line program. - -For more information about installing Studio on a stand-alone server, see :ref:`Installing Studio on a Stand-Alone Server<installing_studio_on_stand_alone_server>`. \ No newline at end of file From fd2cef0112cc3108272a0c2629eed16baef5a223 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 19 Dec 2023 08:46:59 +0200 Subject: [PATCH 783/882] Update create_foreign_table.rst --- .../ddl_commands/create_foreign_table.rst | 84 ++++++++++++------- 1 file changed, 56 insertions(+), 28 deletions(-) diff --git a/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst b/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst index 2cda212d6..c21b5e925 100644 --- a/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst +++ b/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst @@ -4,22 +4,9 @@ CREATE FOREIGN TABLE *********************** -.. note:: - - Starting with SQream DB v2020.2, external tables have been renamed to foreign tables, and use a more flexible foreign data wrapper concept. - - Upgrading to a new version of SQream DB converts existing external tables automatically. - - ``CREATE FOREIGN TABLE`` creates a new foreign table in an existing database. -See more in the :ref:`Foreign tables guide<external_tables>`. - -.. tip:: - - * Data in a foreign table can change if the sources change, and frequent access to remote files may harm performance. - - * To create a regular table, see :ref:`CREATE TABLE <create_table>` +Changes in the source data can result in corresponding modifications to the content of a foreign table. Consistent access to remote files might impact performance. Permissions ============= @@ -44,15 +31,18 @@ Syntax table_name ::= identifier fdw_name ::= - { csv_fdw | orc_fdw | parquet_fdw } + { csv_fdw | orc_fdw | parquet_fdw | json_fdw | avro_fdw } option_def ::= { - LOCATION = '{ path_spec }' - | DELIMITER = '{ field_delimiter }' -- for CSV only - | RECORD_DELIMITER = '{ record_delimiter }' -- for CSV only - | AWS_ID '{ AWS ID }' - | AWS_SECRET '{ AWS SECRET }' + LOCATION = '{ path_spec }', + | DELIMITER = '{ field_delimiter }' -- for CSV only, + | RECORD_DELIMITER = '{ record_delimiter }', -- for CSV only + | AWS_ID '{ AWS ID }', + | CONTINUE_ON_ERROR = { true | false } + | ERROR_COUNT = '{ error count }' + | AWS_SECRET '{ AWS SECRET }', + | OFFSET -- for CSV and JSON only } path_spec ::= { local filepath | S3 URI | HDFS URI } @@ -85,23 +75,30 @@ Parameters * - Parameter - Description * - ``OR REPLACE`` - - Create a new table, and overwrite any existing table by the same name. Does not return an error if the table already exists. ``CREATE OR REPLACE`` does not check the table contents or structure, only the table name. + - Create a new table, and overwrite any existing table by the same name. Does not return an error if the table already exists. ``CREATE OR REPLACE`` does not check the table contents or structure, only the table name * - ``schema_name`` - - The name of the schema in which to create the table. + - The name of the schema in which to create the table * - ``table_name`` - - The name of the table to create, which must be unique inside the schema. + - The name of the table to create, which must be unique inside the schema * - ``column_def`` - - A comma separated list of column definitions. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally. + - A comma separated list of column definitions. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally * - ``WRAPPER ...`` - - Specifies the format of the source files, such as ``parquet_fdw``, ``orc_fdw``, or ``csv_fdw``. + - Specifies the format of the source files, such as ``parquet_fdw``, ``orc_fdw``, or ``csv_fdw`` * - ``LOCATION = ...`` - - Specifies a path or URI of the source files, such as ``/path/to/*.parquet``. + - Specifies a path or URI of the source files, such as ``/path/to/*.parquet`` * - ``DELIMITER = ...`` - - Specifies the field delimiter for CSV files. Defaults to ``,``. + - Specifies the field delimiter for CSV files. Defaults to ``,`` * - ``RECORD_DELIMITER = ...`` - Specifies the record delimiter for CSV files. Defaults to a newline, ``\n`` * - ``AWS_ID``, ``AWS_SECRET`` - Credentials for authenticated S3 access + * - ``OFFSET`` + - Used to specify the number of rows to skip from the beginning of the result set + * - ``CONTINUE_ON_ERROR`` + - Specifies if errors should be ignored or skipped. When set to ``true``, the transaction continues despite rejected data and rows containing partially faulty data are skipped entirely. This parameter should be set together with ``ERROR_COUNT``. When reading multiple files, if an entire file can’t be opened it will be skipped. Default value: ``false``. Value range: ``true`` or ``false``. + * - ``ERROR_COUNT`` + - Specifies the threshold for the maximum number of faulty records that will be ignored. This setting must be used in conjunction with ``CONTINUE_ON_ERROR``. Default value: ``unlimited``. Value range: 1 to 2147483647. + Examples @@ -162,4 +159,35 @@ Materializes a foreign table into a regular table. CREATE TABLE real_table AS SELECT * FROM some_foreign_table; - + +Using the ``OFFSET`` Parameter +-------------------------------- + +The ``OFFSET`` parameter may be used with Parquet and CSV textual formats. + +.. code-block:: + + CREATE FOREIGN TABLE users7 + (id INT NOT NULL, name text(30) NOT NULL, email text(50) NOT NULL) + WRAPPER parquet_fdw + OPTIONS + ( + LOCATION = 'hdfs://hadoop-nn.piedpiper.com/rhendricks/users/*.parquet', + OFFSET = 2 + ); + +Using the ``CONTINUE_ON_ERROR`` and ``ERROR_COUNT`` Parameters +---------------------------------------------------------------- + +.. code-block:: + + CREATE OR REPLACE FOREIGN TABLE cool_animalz + (id INT NOT NULL, name text(30) NOT NULL, weight FLOAT NOT NULL) + WRAPPER csv_fdw + OPTIONS + ( LOCATION = '/home/rhendricks/cool_animals.csv', + DELIMITER = '\t', + continue_on_error = true, + ERROR_COUNT = 3 + ) + ; \ No newline at end of file From d1a38f3e6e1b48c1b833b41fb688e1c274de1e9f Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 19 Dec 2023 16:32:55 +0200 Subject: [PATCH 784/882] Update sign.rst --- reference/sql/sql_functions/scalar_functions/numeric/sign.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/numeric/sign.rst b/reference/sql/sql_functions/scalar_functions/numeric/sign.rst index b86f9c573..a1f835c4b 100644 --- a/reference/sql/sql_functions/scalar_functions/numeric/sign.rst +++ b/reference/sql/sql_functions/scalar_functions/numeric/sign.rst @@ -4,7 +4,7 @@ SIGN **** -The ``SIGN`` function takes a single argument, which can be any numeric data type such as INTEGER, FLOAT, or DECIMAL, and returns an ``INT`` value of -1, 0, or 1, depending on the sign of the input argument. +The ``SIGN`` function takes a single argument, which can be any numeric data type such as INTEGER, FLOAT, or DECIMAL, and returns a value of -1, 0, or 1, depending on the sign of the input argument. @@ -30,7 +30,7 @@ Arguments Return ====== -Returns an ``INT`` value. +The ``SIGN`` function returns the same data type as inserted, with the exception of ``REAL``, which is converted to ``DOUBLE``. Depending on the sign of the input argument, the return is: From b2dab2d1eb40d4ba57daee4ec4bf4c07edda2abc Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 21 Dec 2023 09:20:48 +0200 Subject: [PATCH 785/882] Python --- .../current_method_modification_methods.rst | 9 +- feature_guides/python_functions.rst | 163 +++++++++--------- 2 files changed, 87 insertions(+), 85 deletions(-) diff --git a/configuration_guides/current_method_modification_methods.rst b/configuration_guides/current_method_modification_methods.rst index 9c56fb6ea..f3f229a5e 100644 --- a/configuration_guides/current_method_modification_methods.rst +++ b/configuration_guides/current_method_modification_methods.rst @@ -9,7 +9,8 @@ Modification Methods :depth: 1 Modifying Your Configuration Using the Worker Configuration File -------------------- +---------------------------------------------------------------------------- + You can modify your configuration using the **worker configuration file (config.json)**. Changes that you make to worker configuration files are persistent. Note that you can only set the attributes in your worker configuration file **before** initializing your SQream worker, and while your worker is active these attributes are read-only. The following is an example of a worker configuration file: @@ -31,7 +32,8 @@ The following is an example of a worker configuration file: You can access the legacy configuration file from the ``legacyConfigFilePath`` parameter shown above. If all (or most) of your workers require the same flag settings, you can set the ``legacyConfigFilePath`` attribute to the same legacy file. Modifying Your Configuration Using a Legacy Configuration File ---------------------- +------------------------------------------------------------------------------ + You can modify your configuration using a legacy configuration file. The Legacy configuration file provides access to the read/write flags. A link to this file is provided in the **legacyConfigFilePath** parameter in the worker configuration file. @@ -44,5 +46,6 @@ The following is an example of the legacy configuration file: "developerMode": true, "reextentUse": false, "useClientLog": true, - "useMetadataServer": false + "useMetadataServer": false, + "enablePythonUdfs": true } \ No newline at end of file diff --git a/feature_guides/python_functions.rst b/feature_guides/python_functions.rst index 7aaea5051..eb7b0a54c 100644 --- a/feature_guides/python_functions.rst +++ b/feature_guides/python_functions.rst @@ -1,94 +1,38 @@ .. _python_functions: ************************************* -Python UDF (User-Defined Functions) +Python User-Defined Functions ************************************* -User-defined functions (UDFs) are a feature that extends SQream DB's built in SQL functionality. SQream DB's Python UDFs allow developers to create new functionality in SQL by writing the lower-level language implementation in Python. +User-Defined Functions (UDFs) offer streamlined statements, enabling the creation of a function once, storing it in the database, and calling it multiple times within a statement. Additionally, UDFs can be shared among roles, created by a database administrator and utilized by others. Furthermore, they contribute to code simplicity by allowing independent modifications in SQream DB without altering program source code. -.. note:: Starting v2022.1.4, Python UDF are disabled by default in order to enhance product security. Use the ``enablePythonUdfs`` configuration flag in order to enable Python UDF. +To enable UDFs, in your :ref:`legacy configuration file<current_method_modification_methods>`, set the ``enablePythonUdfs`` configuration flag to ``true``. -.. contents:: In this topic: +.. contents:: :local: + :depth: 1 -A simple example -===================== +Before You Begin +================= -Most databases have an :ref:`UPPER` function, including SQream DB. However, assume that this function is missing for the sake of this example. - -You can write a function in Python to uppercase a text value using the :ref:`create_function` syntax. - -.. code-block:: postgres - - CREATE FUNCTION my_upper (x1 text) - RETURNS text - AS $$ - return x1.upper() - $$ LANGUAGE PYTHON; - -Let's break down this example: - -* ``CREATE FUNCTION my_upper`` - :ref:`Create a function<create_function>` called ``my_upper``. This name must be unique in the current database -* ``(x1 text)`` - the function accepts one argument named ``x1`` which is of the SQL type ``TEXT``. All :ref:`data types<data_types>` are supported. -* ``RETURNS text`` - the function returns the same type - ``TEXT``. All :ref:`data types<data_types>` are supported. -* ``AS $$`` - what follows is some code that we don't want to quote, so we use dollar-quoting (``$$``) instead of single quotes (``'``). -* ``return x1.upper()`` - the Python function's body is the argument named ``x1``, uppercased. -* ``$$ LANGUAGE PYTHON`` - this is the end of the function, and it's in the Python language. - -.. rubric:: Running this example - -After creating the function, you can use it in any SQL query. - -For example: +* Ensure you have Python 3.6.7 or newer installed -.. code-block:: psql - - master=>CREATE TABLE jabberwocky(line text); - executed - master=> INSERT INTO jabberwocky VALUES - . ('''Twas brillig, and the slithy toves '), (' Did gyre and gimble in the wabe: ') - . ,('All mimsy were the borogoves, '), (' And the mome raths outgrabe. ') - . ,('"Beware the Jabberwock, my son! '), (' The jaws that bite, the claws that catch! ') - . ,('Beware the Jubjub bird, and shun '), (' The frumious Bandersnatch!" '); - executed - master=> SELECT line, my_upper(line) FROM jabberwocky; - line | my_upper - -------------------------------------------------+------------------------------------------------- - 'Twas brillig, and the slithy toves | 'TWAS BRILLIG, AND THE SLITHY TOVES - Did gyre and gimble in the wabe: | DID GYRE AND GIMBLE IN THE WABE: - All mimsy were the borogoves, | ALL MIMSY WERE THE BOROGOVES, - And the mome raths outgrabe. | AND THE MOME RATHS OUTGRABE. - "Beware the Jabberwock, my son! | "BEWARE THE JABBERWOCK, MY SON! - The jaws that bite, the claws that catch! | THE JAWS THAT BITE, THE CLAWS THAT CATCH! - Beware the Jubjub bird, and shun | BEWARE THE JUBJUB BIRD, AND SHUN - The frumious Bandersnatch!" | THE FRUMIOUS BANDERSNATCH!" - -Why use UDFs? -===================== - -* They allow simpler statements - You can create the function once, store it in the database, and call it any number of times in a statement. +* Enable UDFs by setting the ``enablePythonUdfs`` configuration flag to ``true`` in your :ref:`legacy configuration file<current_method_modification_methods>` -* They can be shared - UDFs can be created by a database administrator, and then used by other roles. - -* They can simplify downstream code - UDFs can be modified in SQream DB independently of program source code. - -SQream DB's UDF support +SQreamDB's UDF Support ============================= -Scalar functions +Scalar Functions --------------------- -SQream DB's UDFs are scalar functions. This means that the UDF returns a single data value of the type defined in the ``RETURNS`` clause. For an inline scalar function, the returned scalar value is the result of a single statement. +SQreamDB's UDFs are scalar functions. This means that the UDF returns a single data value of the type defined in the ``RETURNS`` clause. For an inline scalar function, the returned scalar value is the result of a single statement. Python -------------------- - -At this time, SQream DB's UDFs are supported for Python. +--------- -Python 3.6.7 is installed alongside SQream DB, for use exclusively by SQream DB. -You may have a different version of Python installed on your server. +Python is installed alongside SQreamDB, for use exclusively by SQreamDB. You may have a different version of Python installed on your server. -To find which version of Python is installed for use by SQream DB, create and run this UDF: +To find which version of Python is installed for use by SQreamDB, create and run this UDF: .. code-block:: psql @@ -105,14 +49,16 @@ To find which version of Python is installed for use by SQream DB, create and ru Python version: 3.6.7 (default, Jul 22 2019, 11:03:54) [GCC 5.4.0]. Path: /opt/sqream/python-3.6.7-5.4.0 -Using modules +Using Modules --------------------- To import a Python module, use the standard ``import`` syntax in the first lines of the user-defined function. +Working with Existing UDFs +=========================== -Finding existing UDFs in the catalog -======================================== +Finding Existing UDFs in the Catalog +---------------------------------------- The ``user_defined_functions`` catalog view contains function information. @@ -126,8 +72,8 @@ Here's how you'd list all UDFs in the system: master | 1 | my_upper -Getting the DDL for a function -===================================== +Getting Function DDL +---------------------- .. code-block:: psql @@ -142,12 +88,12 @@ Getting the DDL for a function See :ref:`get_function_ddl` for more information. -Error handling -===================== +Handling Errors +----------------- In UDFs, any error that occurs causes the execution of the function to stop. This in turn causes the statement that invoked the function to be canceled. -Permissions and sharing +Permissions and Sharing ============================ To create a UDF, the creator needs the ``CREATE FUNCTION`` permission at the database level. @@ -156,7 +102,7 @@ For example, to grant ``CREATE FUNCTION`` to a non-superuser role: .. code-block:: postgres - GRANT CREATE FUNCTION ON DATABASE master TO mjordan; + GRANT CREATE FUNCTION ON DATABASE master TO role1; To execute a UDF, the role needs the ``EXECUTE FUNCTION`` permission for every function. @@ -170,9 +116,62 @@ For example, to grant the permission to the ``r_bi_users`` role group, run: See more information about permissions in the :ref:`Access control guide<access_control>`. +Example +========= + +Most databases have an :ref:`UPPER` function, including SQream DB. However, assume that this function is missing for the sake of this example. + +You can write a function in Python to uppercase a text value using the :ref:`create_function` syntax. + +.. code-block:: postgres + + CREATE FUNCTION my_upper (x1 text) + RETURNS text + AS $$ + return x1.upper() + $$ LANGUAGE PYTHON; + +Let's break down this example: + +* ``CREATE FUNCTION my_upper`` - :ref:`Create a function<create_function>` called ``my_upper``. This name must be unique in the current database +* ``(x1 text)`` - the function accepts one argument named ``x1`` which is of the SQL type ``TEXT``. All :ref:`data types<data_types>` are supported. +* ``RETURNS text`` - the function returns the same type - ``TEXT``. All :ref:`data types<data_types>` are supported. +* ``AS $$`` - what follows is some code that we don't want to quote, so we use dollar-quoting (``$$``) instead of single quotes (``'``). +* ``return x1.upper()`` - the Python function's body is the argument named ``x1``, uppercased. +* ``$$ LANGUAGE PYTHON`` - this is the end of the function, and it's in the Python language. + +.. rubric:: Running this example + +After creating the function, you can use it in any SQL query. + +For example: + +.. code-block:: psql + + master=>CREATE TABLE jabberwocky(line text); + executed + master=> INSERT INTO jabberwocky VALUES + . ('''Twas brillig, and the slithy toves '), (' Did gyre and gimble in the wabe: ') + . ,('All mimsy were the borogoves, '), (' And the mome raths outgrabe. ') + . ,('"Beware the Jabberwock, my son! '), (' The jaws that bite, the claws that catch! ') + . ,('Beware the Jubjub bird, and shun '), (' The frumious Bandersnatch!" '); + executed + master=> SELECT line, my_upper(line) FROM jabberwocky; + line | my_upper + -------------------------------------------------+------------------------------------------------- + 'Twas brillig, and the slithy toves | 'TWAS BRILLIG, AND THE SLITHY TOVES + Did gyre and gimble in the wabe: | DID GYRE AND GIMBLE IN THE WABE: + All mimsy were the borogoves, | ALL MIMSY WERE THE BOROGOVES, + And the mome raths outgrabe. | AND THE MOME RATHS OUTGRABE. + "Beware the Jabberwock, my son! | "BEWARE THE JABBERWOCK, MY SON! + The jaws that bite, the claws that catch! | THE JAWS THAT BITE, THE CLAWS THAT CATCH! + Beware the Jubjub bird, and shun | BEWARE THE JUBJUB BIRD, AND SHUN + The frumious Bandersnatch!" | THE FRUMIOUS BANDERSNATCH!" + + -Best practices -===================== +Best Practices +=============== Although user-defined functions add flexibility, they may have some performance drawbacks. They are not usually a replacement for subqueries or views. From dd1ecbdbd723d0a2e24dbb792484c19f642b55fc Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 21 Dec 2023 09:43:40 +0200 Subject: [PATCH 786/882] Delete storing_data_on_parquet.rst --- external_storage_platforms/storing_data_on_parquet.rst | 8 -------- 1 file changed, 8 deletions(-) delete mode 100644 external_storage_platforms/storing_data_on_parquet.rst diff --git a/external_storage_platforms/storing_data_on_parquet.rst b/external_storage_platforms/storing_data_on_parquet.rst deleted file mode 100644 index 0aa54dbc4..000000000 --- a/external_storage_platforms/storing_data_on_parquet.rst +++ /dev/null @@ -1,8 +0,0 @@ -.. _storing_data_on_parquet: - -*********************** -Storing Data on Parquet -*********************** -As described in the **Data Ingestion Sources** section, users can insert data into SQream from Parquet files. However, because it is an open-source column-oriented data storage format, users may want to retain their data there instead of inserting it into SQream. This requires SQream users to be able to execute queries on external Parquet files. - - From d716d21e8d82bf91527b9804bb8e983d638535fb Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 25 Dec 2023 10:59:57 +0200 Subject: [PATCH 787/882] ALTER DEFAULT PERMISSIONS FOREIGN TABLEs --- operational_guides/access_control_permissions.rst | 2 +- .../access_control_commands/alter_default_permissions.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/operational_guides/access_control_permissions.rst b/operational_guides/access_control_permissions.rst index 2883ffee6..8e4469da2 100644 --- a/operational_guides/access_control_permissions.rst +++ b/operational_guides/access_control_permissions.rst @@ -333,7 +333,7 @@ schema statement is run. FOR { SCHEMAS | TABLES - | FOREIGN TABLE + | FOREIGN TABLES | VIEWS | COLUMNS | SAVED_QUERIES diff --git a/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst b/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst index 478bbdf5b..f8e92fd85 100644 --- a/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst +++ b/reference/sql/sql_statements/access_control_commands/alter_default_permissions.rst @@ -29,7 +29,7 @@ Syntax FOR { SCHEMAS | TABLES - | FOREIGN TABLE + | FOREIGN TABLES | VIEWS | COLUMNS | SAVED_QUERIES From 76fb9c213c8647d351b7cde1035398cdec0bdcae Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 25 Dec 2023 11:26:01 +0200 Subject: [PATCH 788/882] Update create_role.rst --- .../access_control_commands/create_role.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/reference/sql/sql_statements/access_control_commands/create_role.rst b/reference/sql/sql_statements/access_control_commands/create_role.rst index 1eb2bba47..6e3b815b1 100644 --- a/reference/sql/sql_statements/access_control_commands/create_role.rst +++ b/reference/sql/sql_statements/access_control_commands/create_role.rst @@ -76,11 +76,11 @@ Creating a user role A user role has permissions to login, and has a password. -.. tip:: Some DBMSs call this *CREATE USER* or *ADD USER* - .. code-block:: postgres CREATE ROLE new_role; GRANT LOGIN to new_role; - GRANT PASSWORD 'Tr0ub4dor&3' to new_role; - GRANT CONNECT ON DATABASE master to new_role; -- Repeat for other desired databases \ No newline at end of file + GRANT PASSWORD 'passw0rd' to new_role; + GRANT CONNECT ON DATABASE master to new_role; -- Repeat for all desired databases + GRANT USAGE ON SERVICE sqream TO new_role; + GRANT ALL ON SCHEMA public; -- It is advisable to grant permissions on at least one schema \ No newline at end of file From 5db3e436d6c907af00d959b304ffa97087af7324 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Sun, 7 Jan 2024 11:38:06 +0200 Subject: [PATCH 789/882] Update ingesting_data.rst --- data_ingestion/ingesting_data.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/data_ingestion/ingesting_data.rst b/data_ingestion/ingesting_data.rst index 4f0155255..a725608f8 100644 --- a/data_ingestion/ingesting_data.rst +++ b/data_ingestion/ingesting_data.rst @@ -28,6 +28,8 @@ SQream supports loading files from the following formats: * Text - CSV, TSV, and PSV * Parquet * ORC +* Avro +* JSON For more information, see the following: @@ -476,4 +478,4 @@ For more information, see the following: .. [#f6] Will succeed if all values are 0, 1 -.. [#f7] Will succeed if all values fit the destination type \ No newline at end of file +.. [#f7] Will succeed if all values fit the destination type From 68018d147f926581a158631a52ab08a1b6939e9b Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 8 Jan 2024 08:45:30 +0200 Subject: [PATCH 790/882] Update foreign_tables.rst --- operational_guides/foreign_tables.rst | 42 ++++++++++++++++----------- 1 file changed, 25 insertions(+), 17 deletions(-) diff --git a/operational_guides/foreign_tables.rst b/operational_guides/foreign_tables.rst index 557e76c16..c22156a1c 100644 --- a/operational_guides/foreign_tables.rst +++ b/operational_guides/foreign_tables.rst @@ -3,26 +3,32 @@ *********************** Foreign Tables *********************** + Foreign tables can be used to run queries directly on data without inserting it into SQream DB first. -SQream DB supports read only foreign tables, so you can query from foreign tables, but you cannot insert to them, or run deletes or updates on them. +SQream DB supports read-only foreign tables so that you can query from foreign tables, but you cannot insert to them, or run deletes or updates on them. -Running queries directly on external data is most effectively used for things like one off querying. If you will be repeatedly querying data, the performance will usually be better if you insert the data into SQream DB first. +Running queries directly on foreign data is most effectively used for one-off querying. If you are repeatedly querying data, the performance will usually be better if you insert the data into SQream DB first. Although foreign tables can be used without inserting data into SQream DB, one of their main use cases is to help with the insertion process. An insert select statement on a foreign table can be used to insert data into SQream using the full power of the query engine to perform ETL. .. contents:: In this topic: :local: + :depth: 1 Supported Data Formats ===================================== + SQream DB supports foreign tables over: -* Text files (e.g. CSV, PSV, TSV) -* ORC +* Text - CSV, TSV, and PSV * Parquet +* ORC +* Avro +* JSON Supported Data Staging ============================================ + SQream can stage data from: * a local filesystem (e.g. ``/mnt/storage/....``) @@ -31,22 +37,20 @@ SQream can stage data from: Using Foreign Tables ============================================== + Use a foreign table to stage data before loading from CSV, Parquet or ORC files. Planning for Data Staging -------------------------------- -For the following examples, we will want to interact with a CSV file. Here's a peek at the table contents: - -.. csv-table:: nba.csv - :file: nba-t10.csv - :widths: auto - :header-rows: 1 + +For the following examples, we will interact with a CSV file. The file is stored on :ref:`s3`, at ``s3://sqream-demo-data/nba_players.csv``. We will make note of the file structure, to create a matching ``CREATE_EXTERNAL_TABLE`` statement. Creating a Foreign Table ----------------------------- + Based on the source file structure, we :ref:`create a foreign table<create_external_table>` with the appropriate structure, and point it to the file. .. code-block:: postgres @@ -63,10 +67,12 @@ Based on the source file structure, we :ref:`create a foreign table<create_exter College varchar, Salary float ) - USING FORMAT CSV -- Text file - WITH PATH 's3://sqream-demo-data/nba_players.csv' - RECORD DELIMITER '\r\n'; -- DOS delimited file - + WRAPPER csv_fdw + OPTIONS + ( LOCATION = 's3://sqream-demo-data/nba_players.csv', + DELIMITER = '\r\n' -- DOS delimited file + ); + The file format in this case is CSV, and it is stored as an :ref:`s3` object (if the path is on :ref:`hdfs`, change the URI accordingly). We also took note that the record delimiter was a DOS newline (``\r\n``). @@ -94,8 +100,9 @@ Let's peek at the data from the foreign table: Modifying Data from Staging ------------------------------- -One of the main reasons for staging data is to examine the contents and modify them before loading them. -Assume we are unhappy with weight being in pounds, because we want to use kilograms instead. We can apply the transformation as part of a query: + +One of the main reasons for staging data is to examine the content and modify it before loading. +Assume we are unhappy with weight being in pounds because we want to use kilograms instead. We can apply the transformation as part of a query: .. code-block:: psql @@ -144,6 +151,7 @@ Converting a Foreign Table to a Standard Database Table Error Handling and Limitations ================================== + * Error handling in foreign tables is limited. Any error that occurs during source data parsing will result in the statement aborting. * @@ -155,4 +163,4 @@ Error Handling and Limitations t=> SELECT * FROM nba; master=> select * from nba; Record delimiter mismatch during CSV parsing. User defined line delimiter \n does not match the first delimiter \r\n found in s3://sqream-demo-data/nba.csv -* Since the data for a foreign table is not stored in SQream DB, it can be changed or removed at any time by an external process. As a result, the same query can return different results each time it runs against a foreign table. Similarly, a query might fail if the external data is moved, removed, or has changed structure. \ No newline at end of file +* Since the data for a foreign table is not stored in SQream DB, it can be changed or removed at any time by an external process. As a result, the same query can return different results each time it runs against a foreign table. Similarly, a query might fail if the external data is moved, removed, or has changed structure. From 60f08adb97dbb66e6cbdf76ed45a64812511402e Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 9 Jan 2024 16:34:00 +0200 Subject: [PATCH 791/882] Update metadata_server.rst --- reference/cli/metadata_server.rst | 52 ++++++++++++++++++------------- 1 file changed, 31 insertions(+), 21 deletions(-) diff --git a/reference/cli/metadata_server.rst b/reference/cli/metadata_server.rst index d39924684..f3b04d054 100644 --- a/reference/cli/metadata_server.rst +++ b/reference/cli/metadata_server.rst @@ -8,39 +8,49 @@ SQream DB's cluster manager/coordinator is called ``metadata_server``. In general, you should not need to run ``metadata_server`` manually, but it is sometimes useful for testing. -This page serves as a reference for the options and parameters. - -Positional command line arguments -=================================== - -.. code-block:: console - - $ metadata_server [ <logging path> [ <listen port> ] ] +Command Line Arguments +========================== .. list-table:: - :widths: auto + :widths: 2 3 5 :header-rows: 1 * - Argument - Default - Description - * - Logging path - - Current directory - - Path to store metadata logs into - * - Listen port + * - ``--config`` + - ``/home/omert/.sqream/metadata_server_config.json`` + - The configuration file to use + * - ``--port`` - ``3105`` - - TCP listen port. If used, log path must be specified beforehand. + - The metadata server listening port + * - ``--log_path`` + - ``./metadata_server_log`` + - The ``metadata_server`` log file output contains information about the activities and events related to the metadata server of a system. + * - ``--log4_config`` + - None + - Specifies the location of the configuration file for the ``Log4cxx`` logging library. + * - ``--num_deleters`` + - 1 + - Specifies the number of threads to use for the file reaper in a system or program. + * - ``--metadata_path`` + - ``<...sqreamd/leveldb>`` + - Specifies the path to the directory where metadata files are stored for a system or program. + * - ``--help`` + - None + - Used to display a help message or documentation for a particular program or command. + Starting metadata server ============================ Starting temporarily ------------------------------ +--------------------- .. code-block:: console - $ nohup metadata_server & - $ MS_PID=$! + nohup metadata_server -config ~/.sqream/metadata_server_config.json & + MS_PID=$! Using ``nohup`` and ``&`` sends metadata server to run in the background. @@ -55,15 +65,15 @@ To use a non-default port, specify the logging path as well. .. code-block:: console - nohup metadata_server --log_path=/home/rhendricks/metadata_logs --port=9241 & - $ MS_PID=$! + nohup metadata_server --log_path=/home/rhendricks/metadata_logs --port=9241 & + MS_PID=$! Using ``nohup`` and ``&`` sends metadata server to run in the background. .. note:: * Logs are saved to the ``/home/rhendricks/metadata_logs`` directory. * The listening port is 9241 - + Stopping metadata server ---------------------------- @@ -71,6 +81,6 @@ To stop metadata server: .. code-block:: console - $ kill -9 $MS_PID + kill -9 $MS_PID .. tip:: It is safe to stop any SQream DB component at any time using ``kill``. No partial data or data corruption should occur when using this method to stop the process. From 864e40ac31c4fce15167c9a1534bda6929af836a Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 10 Jan 2024 09:14:47 +0200 Subject: [PATCH 792/882] Update access_control_permissions.rst --- .../access_control_permissions.rst | 130 +++++++----------- 1 file changed, 49 insertions(+), 81 deletions(-) diff --git a/operational_guides/access_control_permissions.rst b/operational_guides/access_control_permissions.rst index 8e4469da2..86548f7a4 100644 --- a/operational_guides/access_control_permissions.rst +++ b/operational_guides/access_control_permissions.rst @@ -6,7 +6,7 @@ Permissions SQreamDB’s primary permission object is a role. The role operates in a dual capacity as both a user and a group. As a user, a role may have permissions to execute operations like creating tables, querying data, and administering the database. The group attribute may be thought of as a membership. As a group, a role may extend its permissions to other roles defined as its group members. This becomes handy when privileged roles wish to extend their permissions and grant multiple permissions to multiple roles. The information about all system role permissions is stored in the metadata. -There are two types of permissions: global and object-level. Global permissions belong to ``SUPERUSER`` roles, allowing unrestricted access to all system and database activities. Object-level permissions apply to non-``SUPERUSER`` roles and can be assigned to databases, schemas, tables, functions, views, foreign tables, columns, catalogs, and services. +There are two types of permissions: global and object-level. Global permissions belong to ``SUPERUSER`` roles, allowing unrestricted access to all system and database activities. Object-level permissions apply to non-``SUPERUSER`` roles and can be assigned to databases, schemas, tables, functions, views, foreign tables, catalogs, and services. The following table describe the required permissions for performing and executing operations on various SQreamDB objects. @@ -31,12 +31,16 @@ The following table describe the required permissions for performing and executi +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``CREATE FUNCTION`` | Create and drop functions | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``ALL`` | All database permissions except for a SUPERUSER permission | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ | **Schema** | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``USAGE`` | Grants access to schema objects | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``CREATE`` | Create tables in the schema | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``ALL`` | All schema permissions | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ | **Table** | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``SELECT`` | :ref:`select` from the table | @@ -49,7 +53,7 @@ The following table describe the required permissions for performing and executi +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``DDL`` | Drop and alter on the table | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``ALL`` | All the table permissions | +| ``ALL`` | All table permissions | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | **Function** | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ @@ -71,20 +75,20 @@ The following table describe the required permissions for performing and executi +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``DDL`` | Foreign table DDL operations | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ -| **Column** | -+----------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``SELECT`` | Select from catalog | -+----------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``DDL`` | Column DDL operations | +| ``ALL`` | All foreign table permissions | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | **Catalog** | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``SELECT`` | Select from catalog | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``ALL`` | All catalog permissions | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ | **Services** | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``USAGE`` | Using a specific service | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``ALL`` | All services permissions | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ Syntax ====== @@ -96,7 +100,7 @@ GRANT .. code-block:: postgres - -- Grant permissions at the instance/ storage cluster level: + -- Grant permissions to all databases: GRANT { SUPERUSER @@ -108,38 +112,35 @@ GRANT -- Grant permissions at the database level: GRANT { - { CREATE + CREATE | CONNECT | DDL | SUPERUSER | CREATE FUNCTION } [, ...] | ALL [PERMISSIONS] - } ON DATABASE <database> [, ...] TO <role> [, ...] -- Grant permissions at the schema level: GRANT { - { CREATE + CREATE | DDL | USAGE | SUPERUSER } [, ...] - | ALL [PERMISSIONS] - } + | ALL [PERMISSIONS] ON SCHEMA <schema> [, ...] TO <role> [, ...] -- Grant permissions at the object level: GRANT { - { SELECT + SELECT | INSERT | DELETE | DDL | UPDATE } [, ...] | ALL [PERMISSIONS] - } ON { TABLE <table_name> [, ...] @@ -151,45 +152,29 @@ GRANT } TO <role> [, ...] + -- Grant permissions at the catalog level: GRANT { - { SELECT + SELECT | INSERT | DELETE | UPDATE } [, ...] | ALL [PERMISSIONS] - } ON { - | CATALOG <catalog_name> [, ...] + CATALOG <catalog_name> [, ...] } TO <role> [, ...] - -- Grant execute function permission: + -- Grant function execution permission: GRANT { ALL | EXECUTE | DDL } - ON FUNCTION function_name + ON FUNCTION <function_name> TO role; - - -- Grant permissions at the column level: - GRANT - { - { SELECT - | DDL } [, ...] - | ALL [PERMISSIONS] - } - ON - { - COLUMN <column_name> [,<column_name_2>] IN TABLE <table_name> [,<table_name2>] - | COLUMN <column_name> [,<column_name_2>] IN FOREIGN TABLE <table_name> [,<table_name2>] - | ALL COLUMNS IN TABLE <schema_name.table_name> [, ...] - | ALL COLUMNS IN FOREIGN TABLE <foreign_table_name> [, ...] - } - TO <role> [, ...] -- Grant permissions at the Service level: GRANT @@ -213,7 +198,7 @@ REVOKE .. code-block:: postgres - -- Revoke permissions at the instance/ storage cluster level: + -- Revoke permissions from all databases: REVOKE { SUPERUSER @@ -225,77 +210,71 @@ REVOKE -- Revoke permissions at the database level: REVOKE { - { CREATE + CREATE | CONNECT | DDL | SUPERUSER - | CREATE FUNCTION }[, ...] + | CREATE FUNCTION } [, ...] | ALL [PERMISSIONS] - } - ON DATABASE <database> [, ...] + ON DATABASE <database_name> [, ...] FROM <role> [, ...] -- Revoke permissions at the schema level: REVOKE { - { CREATE + CREATE | DDL | USAGE | SUPERUSER } [, ...] | ALL [PERMISSIONS] - } - ON SCHEMA <schema> [, ...] + ON SCHEMA <schema_name> [, ...] FROM <role> [, ...] -- Revoke permissions at the object level: REVOKE { - { SELECT + SELECT | INSERT | DELETE | DDL | UPDATE } [, ...] - | ALL - } + | ALL [PERMISSIONS] ON { - [ TABLE ] <table_name> [, ...] - | ALL TABLES IN SCHEMA <schema_name> [, ...] + TABLE <table_name> [, ...] + | ALL TABLES [, ...] | VIEW <schema_name.view_name> [, ...] - | ALL VIEWS IN SCHEMA <schema_name> [, ...] + | ALL VIEWS [, ...] | FOREIGN TABLE <table_name> [, ...] - | ALL FOREIGN TABLES IN SCHEMA <schema_name> [, ...] + | ALL FOREIGN TABLES [, ...] + IN SCHEMA <schema_name> [, ...] } FROM <role> [, ...] + -- Revoke permissions at the catalog level: REVOKE { - { SELECT + SELECT | INSERT | DELETE | UPDATE } [, ...] - | ALL - } + | ALL [PERMISSIONS] ON { - | CATALOG <catalog_name> [, ...] + CATALOG <catalog_name> [, ...] } FROM <role> [, ...] - -- Revoke permissions at the column level: - REVOKE + -- Revoke permissions at the function execution level: + REVOKE { - { SELECT - | DDL } [, ...] - | ALL [PERMISSIONS]} - ON - { - COLUMN <column_name> [,<column_name_2>] IN TABLE <table_name> [,<table_name2>] | COLUMN <column_name> [,<column_name_2>] IN FOREIGN TABLE <table_name> [,<table_name2>] - | ALL COLUMNS IN TABLE <schema_name.table_name> [, ...] - | ALL COLUMNS IN FOREIGN TABLE <schema_name.foreign_table_name> [, ...] + All + | EXECUTE + | DDL } - FROM <role> [, ...] - + ON FUNCTION <function_name> + FROM <role> [, ...] + -- Revoke permissions at the service level: REVOKE { @@ -329,13 +308,14 @@ schema statement is run. .. code-block:: postgres ALTER DEFAULT PERMISSIONS FOR modifying_role - [IN schema_name, ...] + [IN schema_name [, ...] FOR { SCHEMAS | TABLES | FOREIGN TABLES | VIEWS - | COLUMNS + | CATALOGS + | SERVICES | SAVED_QUERIES } { grant_clause @@ -395,12 +375,6 @@ Grant execute function permission to a role: GRANT EXECUTE ON FUNCTION function_name TO role_name; -Grant column-level permissions to a role: - -.. code-block:: postgres - - GRANT SELECT, DDL ON COLUMN column_name IN TABLE schema_name.table_name TO role_name; - Grant usage permissions on a service to a role: .. code-block:: postgres @@ -447,12 +421,6 @@ Revoke permissions on specific objects (table, view, foreign table, or catalog) REVOKE SELECT, INSERT, DELETE, DDL, UPDATE ON TABLE schema_name.table_name FROM role_name; -Revoke column-level permissions from a role: - -.. code-block:: postgres - - REVOKE SELECT, DDL FROM COLUMN column_name IN TABLE schema_name.table_name FROM role_name; - Revoke usage permissions on a service from a role: .. code-block:: postgres From 67877e9b513a3402875e67a25087d9d2783d6879 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 17 Jan 2024 09:39:10 +0200 Subject: [PATCH 793/882] Update index.rst --- connecting_to_sqream/client_drivers/Spark/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/connecting_to_sqream/client_drivers/Spark/index.rst b/connecting_to_sqream/client_drivers/Spark/index.rst index a7b031e53..da71f8872 100644 --- a/connecting_to_sqream/client_drivers/Spark/index.rst +++ b/connecting_to_sqream/client_drivers/Spark/index.rst @@ -59,7 +59,7 @@ The following Spark connection properties are supported by SQream: - 0 - The maximum time in seconds for a JDBC query to execute before timing out. * - ``fetchsize`` - - 1 + - 0 - The number of rows to fetch in a single JDBC fetch operation. * - ``batchsize`` - 1000000 From ae4d209bb223695388b265a1f9c1335bb601d02e Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 18 Jan 2024 16:09:32 +0200 Subject: [PATCH 794/882] Update index.rst --- .../client_drivers/Spark/index.rst | 124 +++++++++--------- 1 file changed, 65 insertions(+), 59 deletions(-) diff --git a/connecting_to_sqream/client_drivers/Spark/index.rst b/connecting_to_sqream/client_drivers/Spark/index.rst index da71f8872..5c616e437 100644 --- a/connecting_to_sqream/client_drivers/Spark/index.rst +++ b/connecting_to_sqream/client_drivers/Spark/index.rst @@ -1,43 +1,38 @@ .. _spark: -************************* -Using Spark With SQream -************************* - +***** +Spark +***** The Spark connector enables reading and writing data to and from SQreamDB and may be used for large-scale data processing. - .. contents:: :local: :depth: 1 -Installation and Configuration ------------------------------- - Before You Begin -~~~~~~~~~~~~~~~~ +================= -To use Spark with SQream, it is essential that you have the following installed: +To use Spark with SQreamDB, it is essential that you have the following installed: -* SQream version 2022.1.8 or later +* SQreamDB version 2022.1.8 or later * Spark version 3.3.1 or later -* `SQream Spark Connector 5.0.0 <https://sq-ftp-public.s3.amazonaws.com/Spark-Sqream-Connector-5.0.0.jar>`_ +* `SQreamDB Spark Connector 5.0.0 <https://sq-ftp-public.s3.amazonaws.com/Spark-Sqream-Connector-5.0.0.jar>`_ * :ref:`JDBC<jdbc>` version 4.5.6 or later -Connector Configuration -~~~~~~~~~~~~~~~~~~~~~~~ +Configuration +============= -The Spark JDBC connection properties allow users to configure connections between Spark and databases. These properties enable database access, query execution, and result retrieval, as well as authentication, encryption, and connection pooling. +The Spark JDBC connection properties empower you to customize your Spark connection. These properties facilitate various aspects, including database access, query execution, and result retrieval. Additionally, they provide options for authentication, encryption, and connection pooling. -The following Spark connection properties are supported by SQream: +The following Spark connection properties are supported by SQreamDB: .. list-table:: :widths: auto :header-rows: 1 - * - Item + * - Parameter - Default - Description * - ``url`` @@ -101,77 +96,75 @@ The following Spark connection properties are supported by SQream: - ``false`` - A shorthand for specifying connection properties in the JDBC data source. +Connecting Spark to SQreamDB +---------------------------- - -Connecting Spark to SQream --------------------------- - -The SQream-Spark Connector enables inserting DataFrames into SQream tables and exporting tables or queries as DataFrames for use with Spark. DataFrames are Spark objects used for transferring data from one data source to another. +DataFrames, as Spark objects, play a crucial role in transferring data between different sources. The SQreamDB-Spark Connector facilitates the seamless integration of DataFrames, allowing the insertion of DataFrames into SQreamDB tables. Furthermore, it enables the export of tables or queries as DataFrames, providing compatibility with Spark for versatile data processing. 1. To open the Spark Shell, run the following command under the ``Spark/bin`` directory: -.. code-block:: postgres - - ./spark-shell --driver-class-path {driver path} --jars {Spark-Sqream-Connector.jar path} - - -Example: +.. code-block:: console -.. code-block:: postgres + ./spark-shell --driver-class-path {driver path} --jars {Spark-Sqream-Connector.jar path} + + + //Example: - ./spark-shell --driver-class-path /home/sqream/sqream-jdbc-4.5.6.jar --jars Spark-Sqream-Connector-1.0.jar + ./spark-shell --driver-class-path /home/sqream/sqream-jdbc-4.5.6.jar --jars Spark-Sqream-Connector-1.0.jar -2. To create a SQream session, run the following commands in the Spark Shell: +2. To create a SQreamDB session, run the following commands in the Spark Shell: -.. code-block:: postgres +.. code-block:: console import scala.collection.JavaConverters.mapAsJavaMapConverter val config = Map("spark.master"->"local").asJava import com.sqream.driver.SqreamSession; val sqreamSession=SqreamSession.getSession(config) - -Transferring Data From SQream to Spark --------------------------------------- +Transferring Data +=================== + +Transferring Data From SQreamDB to Spark +------------------------------------------ 1. Create a mapping of Spark options: -.. code-block:: postgres +.. code-block:: console val options = Map("query"->"select * from <table_name>", "url"->"jdbc:<jdbc_path>/master;user=<username>;password=<password>;cluster=false").asJava 2. Create a Spark DataFrame: -.. code-block:: postgres +.. code-block:: console val df=sqreamSession.read(options) -Transferring Data From Spark to SQream --------------------------------------- +Transferring Data From Spark to SQreamDB +------------------------------------------ 1. Create a mapping of Spark options, using the ``dbtable`` Spark option (``query`` is not allowed for writing): -.. code-block:: postgres +.. code-block:: console val options = Map("dbtable"-> <table_name>", "url"->"jdbc:<jdbc_path>/master;user=<username>;password=<password>;cluster=false").asJava 2. Create a Spark DataFrame: -.. code-block:: postgres +.. code-block:: console import org.apache.spark.sql.SaveMode val df=sqreamSession.write(df, options, SaveMode.Overwrite) -Supported Data Types and Mapping --------------------------------- +Data Types and Mapping +======================== -SQream data types mapped to Spark +SQreamDB data types mapped to Spark .. list-table:: :widths: auto :header-rows: 1 - * - SQream + * - SQreamDB - Spark * - ``BIGINT`` - ``LONGINT`` @@ -194,14 +187,14 @@ SQream data types mapped to Spark * - ``DATETIME`` - ``TimestampType`` -Spark data types mapped to SQream +Spark data types mapped to SQreamDB .. list-table:: :widths: auto :header-rows: 1 * - Spark - - SQream + - SQreamDB * - ``BooleanType`` - ``BOOL`` * - ``ByteType`` @@ -227,11 +220,11 @@ Spark data types mapped to SQream Example -------- +======== JAVA - -.. code-block:: postgres + +.. code-block:: java import com.sqream.driver.SqreamSession; import org.apache.spark.sql.Dataset; @@ -245,24 +238,37 @@ JAVA HashMap<String, String> config = new HashMap<>(); //spark configuration //optional configuration here: https://spark.apache.org/docs/latest/configuration.html - config.put("spark.master", "local"); + config.put("spark.master", "spark://localhost:7077"); + config.put("spark.dynamicAllocation.enabled", "false"); + + config.put("spark.driver.port", "7077"); + config.put("spark.driver.host", "192.168.0.157"); + config.put("spark.driver.bindAddress", "192.168.0.157"); + SqreamSession sqreamSession = SqreamSession.getSession(config); //spark properties //optional properties here: https://spark.apache.org/docs/latest/sql-data-sources-jdbc.html HashMap<String, String> props = new HashMap<>(); - props.put("url", "jdbc:Sqream://192.168.4.51:5000/master;user=sqream;password=sqream;cluster=false;logfile=logsFiles.txt;loggerlevel=DEBUG"); - props.put("dbtable", "test"); + props.put("url", "jdbc:Sqream://192.168.0.157:3108/master;user=sqream;password=1234;cluster=true;"); + + //spark partition// + props.put("dbtable", "public.test_table"); + props.put("partitionColumn","sr_date_sk"); + props.put("numPartitions","2"); + props.put("lowerBound","2450820"); + props.put("upperBound","2452822"); + /*Read from sqream table*/ Dataset<Row> dataFrame = sqreamSession.read(props); + dataFrame.show();/*By default, show() displays only the first 20 rows of the DataFrame. + This can be insufficient when working with large datasets. You can customize the number of rows displayed by passing an argument to show(n).*// - /*Added to sqream table*/ - sqreamSession.write(dataFrame, props); - sqreamSession.write(dataFrame, props, SaveMode.Overwrite); - + + /*Add to sqream table*/ + sqreamSession.write(dataFrame, props, SaveMode.Append); } - } - + } \ No newline at end of file From 8fa46c347b507ed72b515052e59f07055b4219be Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 23 Jan 2024 15:33:41 +0200 Subject: [PATCH 795/882] Update sample.java --- connecting_to_sqream/client_drivers/jdbc/sample.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/connecting_to_sqream/client_drivers/jdbc/sample.java b/connecting_to_sqream/client_drivers/jdbc/sample.java index ca591aa26..9f43188b3 100644 --- a/connecting_to_sqream/client_drivers/jdbc/sample.java +++ b/connecting_to_sqream/client_drivers/jdbc/sample.java @@ -52,7 +52,7 @@ public void testJDBC() throws SQLException, IOException { } rs.close(); // Close the result set stmt.close(); // Close the statement handle - conn.close() + conn.close(); } From 3bb396d7c48bc54cc21b84315595bfb8bf3837e7 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 1 Feb 2024 10:38:58 +0200 Subject: [PATCH 796/882] Update hardware_guide.rst --- getting_started/hardware_guide.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/getting_started/hardware_guide.rst b/getting_started/hardware_guide.rst index f03f57f83..89c62b61d 100644 --- a/getting_started/hardware_guide.rst +++ b/getting_started/hardware_guide.rst @@ -56,7 +56,7 @@ An average single-node cluster can be a rackmount server or workstation, contain * - GPU - - NVIDIA 2x A100ת, H100, or L40S + NVIDIA 2x A00ת, H100, or L40S * - Operating System - Red Hat Enterprise Linux v7.9 or CentOS v7.9 or Amazon Linux From b14e7cdb9a555a6555c13d6b3a2e9d91264b411c Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 1 Feb 2024 10:42:06 +0200 Subject: [PATCH 797/882] Update hardware_guide.rst --- getting_started/hardware_guide.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/getting_started/hardware_guide.rst b/getting_started/hardware_guide.rst index 89c62b61d..e2ead1e4c 100644 --- a/getting_started/hardware_guide.rst +++ b/getting_started/hardware_guide.rst @@ -56,7 +56,7 @@ An average single-node cluster can be a rackmount server or workstation, contain * - GPU - - NVIDIA 2x A00ת, H100, or L40S + NVIDIA 2x A100, H100, or L40S * - Operating System - Red Hat Enterprise Linux v7.9 or CentOS v7.9 or Amazon Linux From df3f31dd9f7c6791a98de439c559cee1cbb35c2b Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 1 Feb 2024 13:49:32 +0200 Subject: [PATCH 798/882] Update show_locks.rst --- .../utility_commands/show_locks.rst | 36 ++++++++----------- 1 file changed, 15 insertions(+), 21 deletions(-) diff --git a/reference/sql/sql_statements/utility_commands/show_locks.rst b/reference/sql/sql_statements/utility_commands/show_locks.rst index d5e7c02ec..df9c769a2 100644 --- a/reference/sql/sql_statements/utility_commands/show_locks.rst +++ b/reference/sql/sql_statements/utility_commands/show_locks.rst @@ -8,24 +8,13 @@ SHOW_LOCKS Read more about locks in :ref:`concurrency_and_locks`. -Permissions -============= - -The role must have the ``SUPERUSER`` permissions. - Syntax ========== .. code-block:: postgres - show_locks_statement ::= - SELECT SHOW_LOCKS() - ; - -Parameters -============ - -None + show_locks_statement ::= + SELECT SHOW_LOCKS() Returns ========= @@ -67,13 +56,18 @@ In this example, we create a table based on results (:ref:`create_table_as`), bu .. code-block:: psql - t=> SELECT SHOW_LOCKS(); - statement_id | statement_string | username | server | port | locked_object | lockmode | statement_start_time | lock_start_time - -------------+-------------------------------------------------------------------------------------------------+----------+--------------+------+---------------------------------+-----------+----------------------+-------------------- - 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | database$t | Inclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 - 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | globalpermission$ | Exclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 - 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | schema$t$public | Inclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 - 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | table$t$public$nba2$Insert | Exclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 - 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | table$t$public$nba2$Update | Exclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 + SELECT SHOW_LOCKS(); + + statement_id | statement_string | username | server | port | locked_object | lockmode | statement_start_time | lock_start_time + -------------+-------------------------------------------------------------------------------------------------+----------+--------------+------+---------------------------------+-----------+----------------------+-------------------- + 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | database$t | Inclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 + 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | globalpermission$ | Exclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 + 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | schema$t$public | Inclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 + 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | table$t$public$nba2$Insert | Exclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 + 287 | CREATE OR REPLACE TABLE nba2 AS SELECT "Name" FROM nba WHERE REGEXP_COUNT("Name", '( )+', 8)>1; | sqream | 192.168.1.91 | 5000 | table$t$public$nba2$Update | Exclusive | 2019-12-26 00:03:30 | 2019-12-26 00:03:30 + +Permissions +============= +This utility function requires a ``SUPERUSER`` permission. \ No newline at end of file From 526288aef963ba6dd95d766c8a370415779a458a Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 5 Feb 2024 08:48:24 +0200 Subject: [PATCH 799/882] Update logging.rst --- operational_guides/logging.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/operational_guides/logging.rst b/operational_guides/logging.rst index 28ffca44b..e22a89632 100644 --- a/operational_guides/logging.rst +++ b/operational_guides/logging.rst @@ -292,7 +292,7 @@ SQL Syntax Command Line Utility -------------------- -If you cannot access SQream DB for any reason, you can also use a command line toolto collect the same information: +If you cannot access SQream DB for any reason, you can also use a command line tool to collect the same information: .. code-block:: console From a1898a819b175e380810970a4d22963ad50a6f7f Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 5 Feb 2024 14:37:17 +0200 Subject: [PATCH 800/882] Update monitoring_query_performance.rst --- operational_guides/monitoring_query_performance.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/operational_guides/monitoring_query_performance.rst b/operational_guides/monitoring_query_performance.rst index 547d37d0a..a2ec79564 100644 --- a/operational_guides/monitoring_query_performance.rst +++ b/operational_guides/monitoring_query_performance.rst @@ -71,7 +71,7 @@ First, create a foreign table for the logs message TEXT, end_message TEXT(5) ) - WRAPPER cdv_fdw + WRAPPER csv_fdw OPTIONS ( LOCATION = '/home/rhendricks/sqream_storage/logs/**/sqream*.log', From 8f47ab11c8a4bfb4100050f4f32bdcf965f76620 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 6 Feb 2024 16:46:58 +0200 Subject: [PATCH 801/882] Passw0rd! --- .../access_control_departmental_example.rst | 27 ++++++------------- .../access_control_managing_roles.rst | 6 ++--- .../access_control_commands/grant.rst | 2 +- 3 files changed, 12 insertions(+), 23 deletions(-) diff --git a/operational_guides/access_control_departmental_example.rst b/operational_guides/access_control_departmental_example.rst index 0a6b55e54..e17ce4717 100644 --- a/operational_guides/access_control_departmental_example.rst +++ b/operational_guides/access_control_departmental_example.rst @@ -1,8 +1,8 @@ .. _access_control_departmental_example: -************** +********************* Departmental Example -************** +********************* You work in a company with several departments. @@ -118,13 +118,13 @@ After the group roles have been created, you can now create user roles for each CREATE ROLE ecodd; GRANT LOGIN TO ecodd; - GRANT PASSWORD 'ecodds_secret_password' TO ecodd; + GRANT PASSWORD 'Passw0rd!' TO ecodd; GRANT CONNECT ON DATABASE my_database TO ecodd; GRANT my_schema_database_designers TO ecodd; CREATE ROLE ebachmann; GRANT LOGIN TO ebachmann; - GRANT PASSWORD 'another_secret_password' TO ebachmann; + GRANT PASSWORD 'Passw0rd!!!' TO ebachmann; GRANT CONNECT ON DATABASE my_database TO ebachmann; GRANT my_database_designers TO ebachmann; @@ -136,19 +136,19 @@ After the group roles have been created, you can now create user roles for each CREATE ROLE jbarker; GRANT LOGIN TO jbarker; - GRANT PASSWORD 'action_jack' TO jbarker; + GRANT PASSWORD 'action_jacC%k' TO jbarker; GRANT CONNECT ON DATABASE my_database TO jbarker; GRANT my_schema_readers TO jbarker; CREATE ROLE lbream; GRANT LOGIN TO lbream; - GRANT PASSWORD 'artichoke123' TO lbream; + GRANT PASSWORD 'artichoke123O$' TO lbream; GRANT CONNECT ON DATABASE my_database TO lbream; GRANT my_schema_readers TO lbream; CREATE ROLE pgregory; GRANT LOGIN TO pgregory; - GRANT PASSWORD 'c1ca6a' TO pgregory; + GRANT PASSWORD 'c1ca6aG$' TO pgregory; GRANT CONNECT ON DATABASE my_database TO pgregory; GRANT my_schema_readers TO pgregory; @@ -156,22 +156,11 @@ After the group roles have been created, you can now create user roles for each CREATE ROLE hoover; GRANT LOGIN TO hoover; - GRANT PASSWORD 'mintchip' TO hoover; + GRANT PASSWORD 'mint*Rchip' TO hoover; GRANT CONNECT ON DATABASE my_database TO hoover; GRANT my_schema_security_officers TO hoover; -.. todo: - create some example users - show that they have the right permission - try out the with admin option. we can't really do a security officer because - only superusers can create users and logins. see what can be done - need 1-2 users in each group, for at least 2 schemas/departments - this example will be very big just to show what this setup can do ... - example: a security officer for a department which will only have - read only access to a schema can only get that with admin option - access granted to them - After this setup: * Database designers will be able to run any ddl on objects in the schema and create new objects, including ones created by other database designers diff --git a/operational_guides/access_control_managing_roles.rst b/operational_guides/access_control_managing_roles.rst index 9b81b855d..b6e9985f8 100644 --- a/operational_guides/access_control_managing_roles.rst +++ b/operational_guides/access_control_managing_roles.rst @@ -32,7 +32,7 @@ The following is an example of creating a new role: CREATE ROLE new_role_name ; GRANT LOGIN TO new_role_name; - GRANT PASSWORD 'my_password' to new_role_name; + GRANT PASSWORD 'Passw0rd!' to new_role_name; GRANT CONNECT ON DATABASE master to new_role_name; A database role may have a number of permissions that define what tasks it can perform, which are assigned using the :ref:`grant` command. @@ -81,7 +81,7 @@ The following is an example of changing a user password: .. note:: Granting a new password overrides any previous password. Changing the password while the role has an active running statement does not affect that statement, but will affect subsequent statements. Altering Public Role Permissions ------------------------------- +--------------------------------- The database has a predefined ``PUBLIC`` role that cannot be deleted. Each user role is automatically granted membership in the ``PUBLIC`` role public group, and this membership cannot be revoked. However, you have the capability to adjust the permissions associated with this ``PUBLIC`` role. @@ -89,7 +89,7 @@ The ``PUBLIC`` role has ``USAGE`` and ``CREATE`` permissions on ``PUBLIC`` schem Altering Role Membership (Groups) ------------------------------- +--------------------------------- Many database administrators find it useful to group user roles together. By grouping users, permissions can be granted to, or revoked from a group with one command. In SQream DB, this is done by creating a group role, granting permissions to it, and then assigning users to that group role. diff --git a/reference/sql/sql_statements/access_control_commands/grant.rst b/reference/sql/sql_statements/access_control_commands/grant.rst index 283ce3f3a..7159ed367 100644 --- a/reference/sql/sql_statements/access_control_commands/grant.rst +++ b/reference/sql/sql_statements/access_control_commands/grant.rst @@ -285,7 +285,7 @@ The following is an example of changing a password for a user role. This is done .. code-block:: postgres - GRANT PASSWORD 'new_password' TO rhendricks; + GRANT PASSWORD 'Passw0rd!' TO rhendricks; .. note:: Granting a new password overrides any previous password. Changing the password while the role has an active running statement does not affect that statement, but will affect subsequent statements. From 7c7a9503635d9192d5186cdb93c4aea6b1820449 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 8 Feb 2024 14:35:26 +0200 Subject: [PATCH 802/882] stop_statement --- .../utility_commands/stop_statement.rst | 69 +++++++++---------- troubleshooting/lock_related_issues.rst | 26 ++----- 2 files changed, 38 insertions(+), 57 deletions(-) diff --git a/reference/sql/sql_statements/utility_commands/stop_statement.rst b/reference/sql/sql_statements/utility_commands/stop_statement.rst index 30efc25b5..64256d681 100644 --- a/reference/sql/sql_statements/utility_commands/stop_statement.rst +++ b/reference/sql/sql_statements/utility_commands/stop_statement.rst @@ -6,25 +6,15 @@ STOP_STATEMENT ``STOP_STATEMENT`` stops or aborts an active statement. -To find a statement by ID, see :ref:`show_server_status` and :ref:`show_connections`. - -.. tip:: Some DBMSs call this process killing a session, terminating a job, or kill query - -Permissions -============= - -The role must have the ``SUPERUSER`` permissions. - Syntax ========== -.. code-block:: postgres +.. code-block:: sql - stop_statement_statement ::= - SELECT STOP_STATEMENT(stmt_id) - ; - - stmt_id ::= bigint + stop_statement_statement ::= + SELECT STOP_STATEMENT(stmt_id) + + stmt_id ::= bigint Parameters ============ @@ -38,40 +28,45 @@ Parameters * - ``stmt_id`` - The statement ID to stop -Returns -========= -This utility does not return any value, and always succeeds even if the statement does not exist, or has already stopped. +Notes +===== +This utility always succeeds even if the statement does not exist, or has already stopped. -Notes -=========== +Example +======= -* This utility always succeeds even if the statement does not exist, or has already stopped. +1. Check your server status: -Examples -=========== +.. code-block:: psql -Using :ref:`show_connections` to get statement IDs ----------------------------------------------------- + SELECT SHOW_SERVER_STATUS(); + service | instanceid | connection_id | serverip | serverport | database_name | user_name | clientip | statementid | statement | statementstarttime | statementstatus | statementstatusstart + --------+------------+---------------+---------------+------------+---------------+------------------+---------------+-------------+-------------------------------------------------------------------------------------------------------+---------------------+-----------------+--------------------- + sqream | sqream_2 | 19 | 192.168.0.111 | 5000 | master | etl | 192.168.0.011 |2484923 | SELECT t1.account, t1.msisd from table a t1 join table b t2 on t1.id = t2.id where t1.msid='123123'; | 17-01-2022 16:19:31 | Executing | 17-01-2022 16:19:32 + sqream | sqream_1 | 2 | 192.168.1.112 | 5000 | master | etl | 192.168.1.112 |2484924 | select show_server_status(); | 17-01-2022 16:19:39 | Executing | 17-01-2022 16:19:39 + sqream | None | 248 | 192.168.1.112 | 5007 | master | maintenance_user | 192.168.1.112 |2484665 | select * from sqream_catalog.tables; | 17-01-2022 15:55:01 | In Queue | 17-01-2022 15:55:02 -.. tip:: Use :ref:`show_server_status` to find statments from across the entire cluster, or :ref:`show_connections` to show statements from the current worker the client is connected to. +2. Retrieve stuck statement ID: .. code-block:: psql - t=> SELECT SHOW_CONNECTIONS(); - ip | conn_id | conn_start_time | stmt_id | stmt_start_time | stmt - -------------+---------+---------------------+---------+---------------------+-------------------------- - 192.168.1.91 | 103 | 2019-12-24 00:01:27 | 129 | 2019-12-24 00:38:18 | SELECT GET_DATE(), * F... - 192.168.1.91 | 23 | 2019-12-24 00:01:27 | -1 | 2019-12-24 00:01:27 | - 192.168.1.91 | 22 | 2019-12-24 00:01:27 | -1 | 2019-12-24 00:01:27 | - 192.168.1.91 | 26 | 2019-12-24 00:01:28 | -1 | 2019-12-24 00:01:28 | + SELECT SHOW_CONNECTIONS(); + + ip | conn_id | conn_start_time | stmt_id | stmt_start_time | stmt + --------------+----------+---------------------+---------+---------------------+----------------------------------------------------------------------------------------------------- + 192.168.0.111 | 19 | 2022-01-17 15:50:05 | 2484923 | 2022-01-17 16:19:31 | SELECT t1.account, t1.msisd from table a t1 join table b t2 on t1.id = t2.id where t1.msid='123123'; + 192.168.1.112 | 2 | 2022-01-17 15:50:05 | 2484924 | 2022-01-17 16:19:39 | select show_server_status(); + 192.168.1.112 | 248 | 2022-01-17 15:50:05 | 2484665 | 2022-01-17 15:55:01 | select * from sqream_catalog.tables; +3. Stop stuck query: -The statement ID we're interested in is ``129``. We can now stop this statement: +.. code-block:: sql -.. code-block:: psql + SELECT STOP_STATEMENT(2484923); - t=> SELECT STOP_STATEMENT(129) - executed +Permissions +============= +The role must have the ``SUPERUSER`` permissions. \ No newline at end of file diff --git a/troubleshooting/lock_related_issues.rst b/troubleshooting/lock_related_issues.rst index ed1e21579..7a5ef908b 100644 --- a/troubleshooting/lock_related_issues.rst +++ b/troubleshooting/lock_related_issues.rst @@ -3,29 +3,15 @@ *********************** Lock Related Issues *********************** + Sometimes, a rare situation can occur where a lock is never freed. The workflow for troubleshooting locks is: -#. Identify which statement has obtained locks -#. Understand if the statement is itself stuck, or waiting for another statement -#. Try to abort the offending statement -#. Force the stale locks to be removed - -For example, we will assume that the statement from the previous example is stuck (statement #\ ``287``). We can attempt to abort it using :ref:`stop_statement`: - -.. code-block:: psql - - t=> SELECT STOP_STATEMENT(287); - executed - -If the locks still appear in the :ref:`show_locks` utility, we can force remove the stale locks: - -.. code-block:: psql - - t=> SELECT RELEASE_DEFUNCT_LOCKS(); - executed +#. Identify which statement has obtained locks. +#. Understand if the statement is itself stuck, or waiting for another statement. +#. Try to :ref:`stop<stop_statement>` the offending statement, as in the following example: -.. tip:: ``RELEASE_DEFUNCT_LOCKS`` has an optional input parameter to specify the number of seconds, after which ``RELEASE_DEFUNCT_LOCKS`` will execute. +.. code-block:: sql -.. warning:: This operation can cause some statements to fail on the specific worker on which they are queued. This is intended as a "last resort" to solve stale locks. \ No newline at end of file + SELECT STOP_STATEMENT(2484923); \ No newline at end of file From e7b34e2f8c065376e38852846833018fb08eefc2 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 15 Feb 2024 15:15:16 +0200 Subject: [PATCH 803/882] Update ingesting_from_databases.rst --- data_ingestion/ingesting_from_databases.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data_ingestion/ingesting_from_databases.rst b/data_ingestion/ingesting_from_databases.rst index 654796f9b..b7df158de 100644 --- a/data_ingestion/ingesting_from_databases.rst +++ b/data_ingestion/ingesting_from_databases.rst @@ -1 +1 @@ -.. _ingesting_from_databases: ****************** External Databases ****************** The **SQLoader** is a CLI program that enables you to load data into SQreamDB from other databases. **SQLoader** supports Oracle and Postgresql. .. contents:: :local: :depth: 1 Before You Begin ================ It is essential that you have the following: * Java 17 * SQLoader configuration files * SQLoader.jar file Getting the SQLoader Configuration and JAR Files ================================================ 1. Download the ``.tar`` file using the following command: .. code-block:: linux curl -O https://sq-ftp-public.s3.amazonaws.com/sqloader-7.7.tar 2. Extract the ``.tar`` file using the following command: .. code-block:: linux tar -xf sqloader-7.7.tar.gz A folder named ``sqloader`` with the following files is created: .. list-table:: SQLoader Files :widths: auto :header-rows: 1 * - File - Description * - ``sqream-mapping.json`` - Maps Postgresql and Oracle data types into SQreamDB data types during ingestion * - ``sqload-jdbc.properties`` - Used for defining a connection string and may also be used to reconfigure data loading * - ``reserved_words.txt`` - A list of reserved words which cannot be used as table and/or column names. * - ``sqloader.jar`` - The SQLoader package file Connection String ================= The ``sqload-jdbc.properties`` file contains a connection string that must be configured to enable data loading into SQreamDB. .. literalinclude:: connection_string.java :language: java :caption: Properties File Sample :linenos: Configuring SQLoader Connection ------------------------------- 1. Open the ``sqload-jdbc.properties`` file. 2. Configure the following parameters for: a. Either Postgresql, Oracle, or SQreamDB connection strings b. Optionally, Oracle or SQreamDB catalogs (recommended) .. list-table:: Connection String Parameters :widths: auto :header-rows: 1 * - Parameter - Description * - ``HostIp:port`` - The host and IP address number * - ``database_name`` - The name of the database from which data is loaded * - ``user`` - Username of a role to use for connection * - ``password`` - Specifies the password of the selected role * - ``ssl`` - Specifies SSL for this connection Loading Data into SQreamDB Tables ================================= 1. Run the ``sqloader.jar`` file using the following CLI command: .. code-block:: console java -jar sqloader.jar 2. You may load the entire data of a source table using the following CLI command: .. code-block:: console java -jar sqloader.jar -table source_table_name 3. You may customize the data load either by using each of the following parameters within a CLI command or by configuring the ``properties`` file: .. list-table:: SQLoader CLI Parameters :widths: 5 4 5 25 :header-rows: 1 * - CLI Parameter - State - Default - Description * - ``-batchsize`` - Optional - ``10.000`` - The number of records to be inserted into SQreamDB at once. Please note that the configured batch size may impact chunk sizes. * - ``-casesensative`` - Optional - ``false`` - If ``true``, keeps table name uppercase and lowercase characters when table is created in SQreamDB * - ``-check_cdc_chain`` - Optional - ``false`` - Check CDC chain between tracking table and source table * - ``-chunkSize`` - Optional - ``0`` - The number of records read at once from the source database * - ``-columnlist`` - Optional - None - The name of the file that contains all column names. Columns must be separated using ``\n`` * - ``-columns`` - Optional - All columns - The name or names of columns to be loaded into SQreamDB ("col1,col2, ..."). For column names containing uppercase characters, maintain the uppercase format, avoid using double quotes or apostrophes, and ensure that the ``caseSensitive`` parameter is set to true * - ``-config`` - Optional - ``/home/username/downloads/config/sqload-jdbc.properties`` - Defines the path to the configuration file you wish to use. This parameter may be defined using only the CLI * - ``-config_dir`` - Optional - ``/home/username/downloads/config`` - Defines the path to the folder containing both the data type mapping and the reserved words files. The defined folder must contain both files or else you will receive an error. * - ``-count`` - Optional - ``true`` - Defines whether or not table rows will be counted before being loaded into SQreamDB * - ``-delete`` - Optional - ``true`` - Defines whether or not loading using Change Data Capture (CDC) includes deleted rows * - ``-drop`` - Optional - ``true`` - Defines whether or not a new target table in SQreamDB is created. If ``false``, you will need to configure a target table name using the ``-target`` parameter * - ``-fetchsize`` - Optional - ``100000`` - The number of records to be read at once from source database. * - ``-filter`` - Optional - ``1=1`` - Defines whether or not only records with SQL conditions are loaded * - ``-h, --help`` - Optional - None - Displays the help menu and exits * - ``-limit`` - Optional - ``0`` (no limit) - Limits the number of rows to be loaded * - ``-load_dttm`` - Optional - ``true`` - Add an additional ``load_dttm`` column that defines the time and date of loading * - ``-lock_check`` - Optional - ``true`` - Defines whether or not SQLoader will check source table is locked before the loading starts * - ``-lock_table`` - Optional - ``true`` - Defines whether or not SQLoader will lock target table before the loading starts * - ``-log_dir`` - Optional - ``logs`` - Defines the path of log directory created when loading data. If no value is specified, a ``logs`` folder is created under the same location as the ``sqloader.jar`` file * - ``-partition`` - Optional - None - Defines the partition to load data from if table is partitioned * - ``-rowid`` - Optional - ``false`` - Defines whether or not SQLoader will get row IDs from Oracle tables * - ``-source_db`` - Optional - ``ORCL`` - Defines the source database name. It does not modify the database connection string but impacts the storage and retrieval of data within catalog tables. * - ``-split`` - Optional - None - Column name for split (required for multi-thread loads) * - ``-table`` - Mandatory - None - Source table name to load data from * - ``-target`` - Optional - Source table name - Target table name to load data into * - ``-target_db`` - Optional - None - Target database name to load data into * - ``-thread`` - Optional - ``1`` - Number of threads to be used during loading * - ``-truncate`` - Optional - ``false`` - Truncate target table before loading * - ``-type`` - Optional - ``full`` - Defines a loading type that affects the table that is created in SQreamDB. Options are ``full``, ``cdc``, or ``inc``. Please note that ``cdc``, and ``inc`` are supported only for Oracle * - ``-use_dbms_lob`` - Optional - ``true`` - Defines whether or not SQLoader uses ``dbms_lob_substr`` function for ``CLOB`` and ``BLOB`` data types * - ``-use_partitions`` - Optional - ``true`` - Defines whether or not SQLoader uses partitions in ``SELECT`` statements Using the ``type`` Parameter ============================ Using the ``type`` parameter you may define a loading type that affects the table that is created in SQreamDB. .. list-table:: :widths: auto :header-rows: 1 * - Loading Type - Parameter Option - Description * - Full Table - ``full`` - The entire data of the source table is loaded into SQreamDB * - Change Data Capture (CDC) - ``cdc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT``, ``UPDATE``, and ``DELETE`` statements. SQLoader recognizes tables by table name and metadata. Supported for Oracle only * - Incremental - ``inc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT`` statement. SQLoader recognizes the table by table name and metadata. Supported for Oracle only Data Type Mapping ================= The **SQLoader** automatically maps data types used in Postgresql and Oracle tables that are loaded into SQreamDB. .. list-table:: Postgresql :widths: auto :header-rows: 1 * - Postgresql Type - SQreamDB Type * - ``CHAR``, ``VARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``TEXT`` - ``TEXT`` * - ``INT``, ``SMALLINT``, ``BIGINT``, ``INT2``, ``INT4`` ``INT8`` - ``BIGINT`` * - ``DATETIME``, ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BIT``, ``BOOL`` - ``BOOL`` * - ``DECIMAL``, ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``REAL``, ``FLOAT4`` - ``REAL`` .. list-table:: Oracle :widths: auto :header-rows: 1 * - Oracle Type - SQreamDB Type * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGE`` - ``BIGINT`` * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``VARCHAR2``, ``NVARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``DATE``, ``DATETIME`` - ``DATETIME`` * - ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOLEAN`` - ``BOOL`` * - ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``CLOB`` - ``TEXT`` * - ``BLOB`` - ``TEXT`` CLI Examples ============ Loading data into a CDC table using the ``type`` and ``limit`` parameters: .. code-block:: console java -jar sqloader.jar -table source_table_name -type cdc -limit 100 Loading data into a table using your own configuration file (this will override the default configuration file): .. code-block:: console java -jar sqloader.jar -config path/to/your/config/file Loading data into a table using a custom configuration file: .. code-block:: console java -jar -config MyConfigFile.properties -table source_table_name -type cdc -target target_table_name -drop true -lock_check false Loading data into a table using a the ``filter`` parameter: .. code-block:: console java -jar sqloader.jar -table source_table_name -filter column_name>50 \ No newline at end of file +.. _ingesting_from_databases: ****************** External Databases ****************** The **SQLoader** is a CLI program that enables you to load data into SQreamDB from other DBMS and DBaaS. **SQLoader** supports Oracle, Postgresql, Teradata, Microsoft SQL Server, and SAP HANA. .. contents:: :local: :depth: 1 Before You Begin ================ It is essential that you have the following: * Java 17 * SQLoader configuration files * SQLoader.jar file Minimum Hardware Requirements ------------------------------ .. list-table:: :widths: auto :header-rows: 1 * - Component - Type * - CPU cores - 16 * - RAM - 32GB .. _sqloader_thread_sizing_guidelines: Sizing Guidelines ------------------ The SQLoader sizing is determined by the number of concurrent tables and threads based on the available CPU cores, limiting it to the number of cores minus one, with the remaining core reserved for the operating system. Each SQLoader instance runs on a single table, meaning concurrent imports of multiple tables require multiple instances. Additionally, when dealing with partitioned tables, each partition consumes a thread, so users should consider the table's partition count when managing thread allocation for efficient performance. Getting the SQLoader Configuration and JAR Files ================================================ 1. Download the ``.tar`` file using the following command: .. code-block:: linux curl -O https://sq-ftp-public.s3.amazonaws.com/sqloader-7.8.tar 2. Extract the ``.tar`` file using the following command: .. code-block:: linux tar -xf sqloader-7.8.tar.gz A folder named ``sqloader`` with the following files is created: .. list-table:: SQLoader Files :widths: auto :header-rows: 1 * - File - Description * - ``sqream-mapping.json`` - Maps foreign DBMS and DBaaS data types into SQreamDB data types during ingestion * - ``sqload-jdbc.properties`` - Used for defining a connection string and may also be used to reconfigure data loading * - ``reserved_words.txt`` - A list of reserved words which cannot be used as table and/or column names. * - ``sqloader.jar`` - The SQLoader package file Connection String ================= The ``sqload-jdbc.properties`` file contains a connection string that must be configured to enable data loading into SQreamDB. 1. Open the ``sqload-jdbc.properties`` file. 2. Configure connection parameters for: a. Either Postgresql, Oracle, Teradata, Microsoft SQL Server, SAP HANA or SQreamDB connection strings b. Optionally, Oracle or SQreamDB catalogs (recommended) .. list-table:: Connection String Parameters :widths: auto :header-rows: 1 * - Parameter - Description * - ``HostIp:port`` - The host and IP address number * - ``database_name`` - The name of the database from which data is loaded * - ``user`` - Username of a role to use for connection * - ``password`` - Specifies the password of the selected role * - ``ssl`` - Specifies SSL for this connection .. literalinclude:: connection_string.java :language: java :caption: Properties File Sample :linenos: Loading Data into SQreamDB Tables ================================= 1. Run the ``sqloader.jar`` file using the following CLI command: .. code-block:: console java -jar sqloader.jar 2. You may load the entire data of a source table using the following CLI command: .. code-block:: console java -jar sqloader.jar -table source_table_name 3. You may customize the data load either by using each of the following parameters within a CLI command or by configuring the ``properties`` file: .. list-table:: SQLoader CLI Parameters :widths: auto :header-rows: 1 * - CLI Parameter - State - Default - Type - Description * - ``-batchsize`` - Optional - ``10.000`` - - The number of records to be inserted into SQreamDB at once. Please note that the configured batch size may impact chunk sizes. * - ``-casesensative`` - Optional - ``false`` - - If ``true``, keeps table name uppercase and lowercase characters when table is created in SQreamDB * - ``-check_cdc_chain`` - Optional - ``false`` - - Check CDC chain between tracking table and source table * - ``-chunkSize`` - Optional - ``0`` - - The number of records read at once from the source database * - ``-columnlist`` - Optional - *None* - ``.txt`` - The name of the file that contains all column names. Columns must be separated using ``\n`` * - ``-columns`` - Optional - All columns - - The name or names of columns to be loaded into SQreamDB ("col1,col2, ..."). For column names containing uppercase characters, maintain the uppercase format, avoid using double quotes or apostrophes, and ensure that the ``caseSensitive`` parameter is set to true * - ``-config`` - Optional - ``/home/username/downloads/config/sqload-jdbc.properties`` - - Defines the path to the configuration file you wish to use. This parameter may be defined using only the CLI * - ``-config_dir`` - Optional - ``/home/username/downloads/config`` - - Defines the path to the folder containing both the data type mapping and the reserved words files. The defined folder must contain both files or else you will receive an error. * - ``-count`` - Optional - ``true`` - - Defines whether or not table rows will be counted before being loaded into SQreamDB * - ``-delete`` - Optional - ``true`` - - Defines whether or not loading using Change Data Capture (CDC) includes deleted rows * - ``-drop`` - Optional - ``true`` - - Defines whether or not a new target table in SQreamDB is created. If ``false``, you will need to configure a target table name using the ``-target`` parameter * - ``-fetchsize`` - Optional - ``100000`` - - The number of records to be read at once from source database. * - ``-filter`` - Optional - ``1=1`` - - Defines whether or not only records with SQL conditions are loaded * - ``-h, --help`` - Optional - *No input* - - Displays the help menu and exits * - ``-limit`` - Optional - ``0`` (no limit) - - Limits the number of rows to be loaded * - ``-load_dttm`` - Optional - ``true`` - - Add an additional ``load_dttm`` column that defines the time and date of loading * - ``-lock_check`` - Optional - ``true`` - - Defines whether or not SQLoader will check source table is locked before the loading starts * - ``-lock_table`` - Optional - ``true`` - - Defines whether or not SQLoader will lock target table before the loading starts * - ``-log_dir`` - Optional - ``logs`` - - Defines the path of log directory created when loading data. If no value is specified, a ``logs`` folder is created under the same location as the ``sqloader.jar`` file * - ``-partition`` - Optional - *None* - Partition identifier ``string`` - Specifies the number of table partitions. If configured, ``-partition`` ensures that data is loaded according to the specified partition. You may configure the ``-thread`` parameter for parallel loading of your table partitions. If you do, please ensure that the number of threads does not exceed the number of partitions. * - ``-rowid`` - Optional - ``false`` - - Defines whether or not SQLoader will get row IDs from Oracle tables * - ``-source_db`` - Optional - ``ORCL`` - - Defines the source database name. It does not modify the database connection string but impacts the storage and retrieval of data within catalog tables. * - ``-split`` - Optional - *None* - Column name ``string`` - Column name for split (required for multi-thread loads) * - ``-table`` - Mandatory - *None* - Table name ``string`` - Source table name to load data from * - ``-target`` - Optional - Target table name - Table name ``string`` - Target table name to load data into * - ``-thread`` - Optional - ``1`` - - Number of threads to use for loading. Using multiple threads can significantly improve the loading performance, especially when dealing with columns that have metadata statistics (e.g., min/max values). SQLoader will automatically divide the data into batches based on the specified thread number, allowing for parallel processing. You may use ``-thread`` both for tables that are partitioned and tables that are not. See :ref:`Sizing Guidelines<sqloader_thread_sizing_guidelines>` * - ``-truncate`` - Optional - ``false`` - - Truncate target table before loading * - ``-type`` - Optional - ``full`` - - Defines a loading type that affects the table that is created in SQreamDB. Options are ``full``, ``cdc``, or ``inc``. Please note that ``cdc``, and ``inc`` are supported only for Oracle * - ``-use_dbms_lob`` - Optional - ``true`` - - Defines whether or not SQLoader uses ``dbms_lob_substr`` function for ``CLOB`` and ``BLOB`` data types * - ``-use_partitions`` - Optional - ``true`` - - Defines whether or not SQLoader uses partitions in ``SELECT`` statements Using the ``type`` Parameter ------------------------------ Using the ``type`` parameter you may define a loading type that affects the table that is created in SQreamDB. .. list-table:: :widths: auto :header-rows: 1 * - Loading Type - Parameter Option - Description * - Full Table - ``full`` - The entire data of the source table is loaded into SQreamDB * - Change Data Capture (CDC) - ``cdc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT``, ``UPDATE``, and ``DELETE`` statements. SQLoader recognizes tables by table name and metadata. Supported for Oracle only * - Incremental - ``inc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT`` statement. SQLoader recognizes the table by table name and metadata. Supported for Oracle only Creating Summary Tables ======================== Summary tables are pre-aggregated tables that store summarized or aggregated data, which can help improve query performance and reduce the need for complex calculations during runtime. Summary tables are part of the schema within the database catalog. Creating a Summary Table -------------------------- This summary table uses Oracle syntax. .. code-block:: sql CREATE TABLE public.SQLOAD_SUMMARY ( DB_NAME TEXT(200 BYTE) VISIBLE, SCHEMA_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME_FULL TEXT(200 BYTE) VISIBLE, LOAD_TYPE TEXT(200 BYTE) VISIBLE, UPDATED_DTTM_FROM DATE VISIBLE, UPDATED_DTTM_TO DATE VISIBLE, LAST_VAL_INT NUMBER(22,0) VISIBLE, LAST_VAL_TS DATE VISIBLE, START_TIME TIMESTAMP(6) VISIBLE, FINISH_TIME TIMESTAMP(6) VISIBLE, ELAPSED_SEC NUMBER VISIBLE, ROW_COUNT NUMBER VISIBLE, SQL_FILTER TEXT(200 BYTE) VISIBLE, PARTITION TEXT(200 BYTE) VISIBLE, STMT_TYPE TEXT(200 BYTE) VISIBLE, STATUS TEXT(200 BYTE) VISIBLE, LOG_FILE TEXT(200 BYTE) VISIBLE, DB_URL TEXT(200 BYTE) VISIBLE, PARTITION_COUNT NUMBER VISIBLE DEFAULT 0, THREAD_COUNT NUMBER VISIBLE DEFAULT 1, ELAPSED_MS NUMBER VISIBLE DEFAULT 0, STATUS_CODE NUMBER VISIBLE DEFAULT 0, ELAPSED_SOURCE_MS NUMBER(38,0) DEFAULT NULL, ELAPSED_SOURCE_SEC NUMBER(38,0) DEFAULT NULL, ELAPSED_TARGET_MS NUMBER(38,0) DEFAULT NULL, ELAPSED_TARGET_SEC NUMBER(38,0) DEFAULT NULL, ELAPSED_SOURCE_MS NUMBER(38,0) DEFAULT NULL, TARGET_DB_URL VARCHAR2(200) DEFAULT NULL, SQLOADER_VERSION VARCHAR2(20) DEFAULT NULL, HOST VARCHAR2(200) DEFAULT NULL ); Creating a Change Data Capture Table -------------------------------------- Change Data Capture (CDC) tables are supported only for Oracle. .. code-block:: sql CREATE TABLE public.CDC_TABLES ( DB_NAME TEXT(200 BYTE) VISIBLE, SCHEMA_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME_FULL TEXT(200 BYTE) VISIBLE, TABLE_NAME_CDC TEXT(200 BYTE) VISIBLE, INC_COLUMN_NAME TEXT(200 BYTE) VISIBLE, INC_COLUMN_TYPE TEXT(200 BYTE) VISIBLE, LOAD_TYPE TEXT(200 BYTE) VISIBLE, FREQ_TYPE TEXT(200 BYTE) VISIBLE, FREQ_INTERVAL NUMBER(22,0) VISIBLE, IS_ACTIVE NUMBER VISIBLE DEFAULT 0, STATUS_LOAD NUMBER VISIBLE DEFAULT 0, INC_GAP_VALUE NUMBER VISIBLE DEFAULT 0 ); CREATE TABLE public.CDC_TRACKING ( DB_NAME TEXT(200 BYTE) VISIBLE, SCHEMA_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME_FULL TEXT(200 BYTE) VISIBLE, LAST_UPDATED_DTTM DATE VISIBLE, LAST_VAL_INT NUMBER(22,0) VISIBLE DEFAULT 0, LAST_VAL_TS TIMESTAMP(6) VISIBLE, LAST_VAL_DT DATE VISIBLE ); CREATE TABLE public.CDC_TABLE_PRIMARY_KEYS ( DB_NAME TEXT(200 BYTE) VISIBLE, SCHEMA_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME_FULL TEXT(200 BYTE) VISIBLE, CONSTRAINT_NAME TEXT(200 BYTE) VISIBLE, COLUMN_NAME TEXT(200 BYTE) VISIBLE, IS_NULLABLE NUMBER VISIBLE DEFAULT 0 ); Data Type Mapping ================= .. contents:: :local: :depth: 1 Automatic Mapping ------------------ The **SQLoader** automatically maps data types used in Oracle, Postgresql, Teradata, Microsoft SQL Server, and SAP HANA tables that are loaded into SQreamDB. Oracle ^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - Oracle Type - SQreamDB Type * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGE`` - ``BIGINT`` * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``VARCHAR2``, ``NVARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``DATE``, ``DATETIME`` - ``DATETIME`` * - ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOLEAN`` - ``BOOL`` * - ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``CLOB`` - ``TEXT`` * - ``BLOB`` - ``TEXT`` * - ``RAW`` - ``TEXT`` Postgresql ^^^^^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - Postgresql Type - SQreamDB Type * - ``CHAR``, ``VARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``TEXT`` - ``TEXT`` * - ``INT``, ``SMALLINT``, ``BIGINT``, ``INT2``, ``INT4``, ``INT8`` - ``BIGINT`` * - ``DATETIME``, ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BIT``, ``BOOL`` - ``BOOL`` * - ``DECIMAL``, ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``REAL``, ``FLOAT4`` - ``REAL`` Teradata ^^^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - Teradata Type - SQreamDB Type * - ``F`` - ``DOUBLE`` * - ``N``, ``D`` - ``NUMERIC`` * - ``CO`` - ``TEXT`` * - ``BO`` - ``TEXT`` * - ``A1``, ``AN``, ``AT``, ``BF``, ``BV``, ``CF``, ``CV``, ``JN``, ``PD``, ``PM``, ``PS``, ``PT``, ``PZ``, ``SZ``, ``TZ`` - ``TEXT`` * - ``I``, ``I4``, ``I(4)`` - ``INT`` * - ``I2``, ``I(2)`` - ``SMALLINT`` * - ``I1``, ``I(1)`` - ``TINYINT`` * - ``DH``, ``DM``, ``DS``, ``DY``, ``HM``, ``HS``, ``HR``, ``I8``, ``MO``, ``MS``, ``MI``, ``SC``, ``YM``, ``YR`` - ``BIGINT`` * - ``TS``, ``DATETIME`` - ``DATETIME`` * - ``DA`` - ``DATE`` * - ``BIT`` - ``BOOL`` * - ``REAL``, ``DOUBLE`` - ``DOUBLE`` Microsoft SQL Server ^^^^^^^^^^^^^^^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - Microsoft SQL Server Type - SQreamDB Type * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``NVARCHAR``, ``NVARCHAR2``, ``CHARACTER``, ``TEXT``, ``NTEXT`` - ``TEXT`` * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INT``, ``TINYINT`` - ``BIGINT`` * - ``DATETIME``, ``TIMESTAMP``, ``SMALLDATETIME``, ``DATETIMEOFFSET``, ``DATETIME2`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BIT`` - ``BOOL`` * - ``DECIMAL``, ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``REAL`` - ``REAL`` * - ``VARBINARY`` - ``TEXT`` SAP HANA ^^^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - SAP HANA Type - SQreamDB Type * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGER``, ``TINYINT`` - ``BIGINT`` * - ``CHAR``, ``VARCHAR``, ``NVARCHAR``, ``TEXT``, ``VARCHAR2``, ``NVARCHAR2`` - ``TEXT`` * - ``DATETIME``, ``TIMESTAMP``, ``SECONDDATE`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOLEAN`` - ``TEXT`` * - ``DECIMAL``, ``SMALLDECIMAL``, ``BIGDECIMAL`` - ``NUMERIC`` * - ``DOUBLE``, ``REAL`` - ``FLOAT`` * - ``TEXT`` - ``TEXT`` * - ``BIGINT`` - ``BIGINT`` * - ``INT`` - ``INT`` * - ``SMALLINT`` - ``SMALLINT`` * - ``TINYINT`` - ``TINYINT`` * - ``DATETIME`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOL`` - ``BOOL`` * - ``NUMERIC`` - ``NUMERIC`` * - ``DOUBLE`` - ``DOUBLE`` * - ``FLOAT`` - ``FLOAT`` * - ``REAL`` - ``REAL`` Manually Adjusting Mapping ---------------------------- You have the possibility to adjust the mapping process according to your specific needs, using any of the following methods. ``names`` Method ^^^^^^^^^^^^^^^^^ To specify that you want to map one or more columns in your table to a specific data type, duplicate the code block which maps to the SQreamDB data type you want and include the ``names`` parameter in your code block. The SQLoader will map the specified columns to the specified SQreamDB data type. After the specified columns are mapped, the SQLoader continue to search for how to convert other data types to the same data type of the specified columns. In this example, ``column1``, ``column2``, and ``column3`` are mapped to ``BIGINT`` and the Oracle data types ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGER`` are also mapped to ``BIGINT``. .. code-block:: json { "oracle": [ { "names": ["column1", "column2", "column3"], "sqream": "bigint", "java": "int", "length": false }, { "type": ["bigint","int","smallint","integer"], "sqream": "bigint", "java": "int", "length": false } } .. code-block:: json { "type": ["char","nchar","varchar","varchar2","nvarchar","nvarchar2","character"], "sqream": "text", "java": "string", "length": true }, { "type": ["date","datetime"], "sqream": "datetime", "java": "datetime", "length": false }, { "type": ["timestamp"], "sqream": "datetime", "java": "timestamp", "length": false }, { "type": ["date"], "sqream": "date", "java": "datetime", "length": false }, { "type": ["boolean"], "sqream": "bool", "java": "boolean", "length": false }, { "type": ["number"], "sqream": "numeric", "java": "bigdecimal", "length": true, "prec": true }, { "type": ["float","double"], "sqream": "double", "java": "double", "length": false }, { "type": ["clob"], "sqream": "text", "java": "clob", "length": false }, { "type": ["blob"], "sqream": "text", "java": "blob", "length": false } ] } CLI Examples ============ Loading data into a CDC table using the ``type`` and ``limit`` parameters: .. code-block:: console java -jar sqloader.jar -table source_table_name -type cdc -limit 100 Loading data into a table using your own configuration file (this will override the default configuration file): .. code-block:: console java -jar sqloader.jar -config path/to/your/config/file Loading data into a table using a custom configuration file: .. code-block:: console java -jar -config MyConfigFile.properties -table source_table_name -type cdc -target target_table_name -drop true -lock_check false Loading data into a table using a the ``filter`` parameter: .. code-block:: console java -jar sqloader.jar -table source_table_name -filter column_name>50 \ No newline at end of file From 64cafa218921da8f17d4c5d5318570fe0a64c82f Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 15 Feb 2024 15:18:13 +0200 Subject: [PATCH 804/882] Update ingesting_from_databases.rst --- data_ingestion/ingesting_from_databases.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data_ingestion/ingesting_from_databases.rst b/data_ingestion/ingesting_from_databases.rst index b7df158de..cb1e88f4b 100644 --- a/data_ingestion/ingesting_from_databases.rst +++ b/data_ingestion/ingesting_from_databases.rst @@ -1 +1 @@ -.. _ingesting_from_databases: ****************** External Databases ****************** The **SQLoader** is a CLI program that enables you to load data into SQreamDB from other DBMS and DBaaS. **SQLoader** supports Oracle, Postgresql, Teradata, Microsoft SQL Server, and SAP HANA. .. contents:: :local: :depth: 1 Before You Begin ================ It is essential that you have the following: * Java 17 * SQLoader configuration files * SQLoader.jar file Minimum Hardware Requirements ------------------------------ .. list-table:: :widths: auto :header-rows: 1 * - Component - Type * - CPU cores - 16 * - RAM - 32GB .. _sqloader_thread_sizing_guidelines: Sizing Guidelines ------------------ The SQLoader sizing is determined by the number of concurrent tables and threads based on the available CPU cores, limiting it to the number of cores minus one, with the remaining core reserved for the operating system. Each SQLoader instance runs on a single table, meaning concurrent imports of multiple tables require multiple instances. Additionally, when dealing with partitioned tables, each partition consumes a thread, so users should consider the table's partition count when managing thread allocation for efficient performance. Getting the SQLoader Configuration and JAR Files ================================================ 1. Download the ``.tar`` file using the following command: .. code-block:: linux curl -O https://sq-ftp-public.s3.amazonaws.com/sqloader-7.8.tar 2. Extract the ``.tar`` file using the following command: .. code-block:: linux tar -xf sqloader-7.8.tar.gz A folder named ``sqloader`` with the following files is created: .. list-table:: SQLoader Files :widths: auto :header-rows: 1 * - File - Description * - ``sqream-mapping.json`` - Maps foreign DBMS and DBaaS data types into SQreamDB data types during ingestion * - ``sqload-jdbc.properties`` - Used for defining a connection string and may also be used to reconfigure data loading * - ``reserved_words.txt`` - A list of reserved words which cannot be used as table and/or column names. * - ``sqloader.jar`` - The SQLoader package file Connection String ================= The ``sqload-jdbc.properties`` file contains a connection string that must be configured to enable data loading into SQreamDB. 1. Open the ``sqload-jdbc.properties`` file. 2. Configure connection parameters for: a. Either Postgresql, Oracle, Teradata, Microsoft SQL Server, SAP HANA or SQreamDB connection strings b. Optionally, Oracle or SQreamDB catalogs (recommended) .. list-table:: Connection String Parameters :widths: auto :header-rows: 1 * - Parameter - Description * - ``HostIp:port`` - The host and IP address number * - ``database_name`` - The name of the database from which data is loaded * - ``user`` - Username of a role to use for connection * - ``password`` - Specifies the password of the selected role * - ``ssl`` - Specifies SSL for this connection .. literalinclude:: connection_string.java :language: java :caption: Properties File Sample :linenos: Loading Data into SQreamDB Tables ================================= 1. Run the ``sqloader.jar`` file using the following CLI command: .. code-block:: console java -jar sqloader.jar 2. You may load the entire data of a source table using the following CLI command: .. code-block:: console java -jar sqloader.jar -table source_table_name 3. You may customize the data load either by using each of the following parameters within a CLI command or by configuring the ``properties`` file: .. list-table:: SQLoader CLI Parameters :widths: auto :header-rows: 1 * - CLI Parameter - State - Default - Type - Description * - ``-batchsize`` - Optional - ``10.000`` - - The number of records to be inserted into SQreamDB at once. Please note that the configured batch size may impact chunk sizes. * - ``-casesensative`` - Optional - ``false`` - - If ``true``, keeps table name uppercase and lowercase characters when table is created in SQreamDB * - ``-check_cdc_chain`` - Optional - ``false`` - - Check CDC chain between tracking table and source table * - ``-chunkSize`` - Optional - ``0`` - - The number of records read at once from the source database * - ``-columnlist`` - Optional - *None* - ``.txt`` - The name of the file that contains all column names. Columns must be separated using ``\n`` * - ``-columns`` - Optional - All columns - - The name or names of columns to be loaded into SQreamDB ("col1,col2, ..."). For column names containing uppercase characters, maintain the uppercase format, avoid using double quotes or apostrophes, and ensure that the ``caseSensitive`` parameter is set to true * - ``-config`` - Optional - ``/home/username/downloads/config/sqload-jdbc.properties`` - - Defines the path to the configuration file you wish to use. This parameter may be defined using only the CLI * - ``-config_dir`` - Optional - ``/home/username/downloads/config`` - - Defines the path to the folder containing both the data type mapping and the reserved words files. The defined folder must contain both files or else you will receive an error. * - ``-count`` - Optional - ``true`` - - Defines whether or not table rows will be counted before being loaded into SQreamDB * - ``-delete`` - Optional - ``true`` - - Defines whether or not loading using Change Data Capture (CDC) includes deleted rows * - ``-drop`` - Optional - ``true`` - - Defines whether or not a new target table in SQreamDB is created. If ``false``, you will need to configure a target table name using the ``-target`` parameter * - ``-fetchsize`` - Optional - ``100000`` - - The number of records to be read at once from source database. * - ``-filter`` - Optional - ``1=1`` - - Defines whether or not only records with SQL conditions are loaded * - ``-h, --help`` - Optional - *No input* - - Displays the help menu and exits * - ``-limit`` - Optional - ``0`` (no limit) - - Limits the number of rows to be loaded * - ``-load_dttm`` - Optional - ``true`` - - Add an additional ``load_dttm`` column that defines the time and date of loading * - ``-lock_check`` - Optional - ``true`` - - Defines whether or not SQLoader will check source table is locked before the loading starts * - ``-lock_table`` - Optional - ``true`` - - Defines whether or not SQLoader will lock target table before the loading starts * - ``-log_dir`` - Optional - ``logs`` - - Defines the path of log directory created when loading data. If no value is specified, a ``logs`` folder is created under the same location as the ``sqloader.jar`` file * - ``-partition`` - Optional - *None* - Partition identifier ``string`` - Specifies the number of table partitions. If configured, ``-partition`` ensures that data is loaded according to the specified partition. You may configure the ``-thread`` parameter for parallel loading of your table partitions. If you do, please ensure that the number of threads does not exceed the number of partitions. * - ``-rowid`` - Optional - ``false`` - - Defines whether or not SQLoader will get row IDs from Oracle tables * - ``-source_db`` - Optional - ``ORCL`` - - Defines the source database name. It does not modify the database connection string but impacts the storage and retrieval of data within catalog tables. * - ``-split`` - Optional - *None* - Column name ``string`` - Column name for split (required for multi-thread loads) * - ``-table`` - Mandatory - *None* - Table name ``string`` - Source table name to load data from * - ``-target`` - Optional - Target table name - Table name ``string`` - Target table name to load data into * - ``-thread`` - Optional - ``1`` - - Number of threads to use for loading. Using multiple threads can significantly improve the loading performance, especially when dealing with columns that have metadata statistics (e.g., min/max values). SQLoader will automatically divide the data into batches based on the specified thread number, allowing for parallel processing. You may use ``-thread`` both for tables that are partitioned and tables that are not. See :ref:`Sizing Guidelines<sqloader_thread_sizing_guidelines>` * - ``-truncate`` - Optional - ``false`` - - Truncate target table before loading * - ``-type`` - Optional - ``full`` - - Defines a loading type that affects the table that is created in SQreamDB. Options are ``full``, ``cdc``, or ``inc``. Please note that ``cdc``, and ``inc`` are supported only for Oracle * - ``-use_dbms_lob`` - Optional - ``true`` - - Defines whether or not SQLoader uses ``dbms_lob_substr`` function for ``CLOB`` and ``BLOB`` data types * - ``-use_partitions`` - Optional - ``true`` - - Defines whether or not SQLoader uses partitions in ``SELECT`` statements Using the ``type`` Parameter ------------------------------ Using the ``type`` parameter you may define a loading type that affects the table that is created in SQreamDB. .. list-table:: :widths: auto :header-rows: 1 * - Loading Type - Parameter Option - Description * - Full Table - ``full`` - The entire data of the source table is loaded into SQreamDB * - Change Data Capture (CDC) - ``cdc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT``, ``UPDATE``, and ``DELETE`` statements. SQLoader recognizes tables by table name and metadata. Supported for Oracle only * - Incremental - ``inc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT`` statement. SQLoader recognizes the table by table name and metadata. Supported for Oracle only Creating Summary Tables ======================== Summary tables are pre-aggregated tables that store summarized or aggregated data, which can help improve query performance and reduce the need for complex calculations during runtime. Summary tables are part of the schema within the database catalog. Creating a Summary Table -------------------------- This summary table uses Oracle syntax. .. code-block:: sql CREATE TABLE public.SQLOAD_SUMMARY ( DB_NAME TEXT(200 BYTE) VISIBLE, SCHEMA_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME_FULL TEXT(200 BYTE) VISIBLE, LOAD_TYPE TEXT(200 BYTE) VISIBLE, UPDATED_DTTM_FROM DATE VISIBLE, UPDATED_DTTM_TO DATE VISIBLE, LAST_VAL_INT NUMBER(22,0) VISIBLE, LAST_VAL_TS DATE VISIBLE, START_TIME TIMESTAMP(6) VISIBLE, FINISH_TIME TIMESTAMP(6) VISIBLE, ELAPSED_SEC NUMBER VISIBLE, ROW_COUNT NUMBER VISIBLE, SQL_FILTER TEXT(200 BYTE) VISIBLE, PARTITION TEXT(200 BYTE) VISIBLE, STMT_TYPE TEXT(200 BYTE) VISIBLE, STATUS TEXT(200 BYTE) VISIBLE, LOG_FILE TEXT(200 BYTE) VISIBLE, DB_URL TEXT(200 BYTE) VISIBLE, PARTITION_COUNT NUMBER VISIBLE DEFAULT 0, THREAD_COUNT NUMBER VISIBLE DEFAULT 1, ELAPSED_MS NUMBER VISIBLE DEFAULT 0, STATUS_CODE NUMBER VISIBLE DEFAULT 0, ELAPSED_SOURCE_MS NUMBER(38,0) DEFAULT NULL, ELAPSED_SOURCE_SEC NUMBER(38,0) DEFAULT NULL, ELAPSED_TARGET_MS NUMBER(38,0) DEFAULT NULL, ELAPSED_TARGET_SEC NUMBER(38,0) DEFAULT NULL, ELAPSED_SOURCE_MS NUMBER(38,0) DEFAULT NULL, TARGET_DB_URL VARCHAR2(200) DEFAULT NULL, SQLOADER_VERSION VARCHAR2(20) DEFAULT NULL, HOST VARCHAR2(200) DEFAULT NULL ); Creating a Change Data Capture Table -------------------------------------- Change Data Capture (CDC) tables are supported only for Oracle. .. code-block:: sql CREATE TABLE public.CDC_TABLES ( DB_NAME TEXT(200 BYTE) VISIBLE, SCHEMA_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME_FULL TEXT(200 BYTE) VISIBLE, TABLE_NAME_CDC TEXT(200 BYTE) VISIBLE, INC_COLUMN_NAME TEXT(200 BYTE) VISIBLE, INC_COLUMN_TYPE TEXT(200 BYTE) VISIBLE, LOAD_TYPE TEXT(200 BYTE) VISIBLE, FREQ_TYPE TEXT(200 BYTE) VISIBLE, FREQ_INTERVAL NUMBER(22,0) VISIBLE, IS_ACTIVE NUMBER VISIBLE DEFAULT 0, STATUS_LOAD NUMBER VISIBLE DEFAULT 0, INC_GAP_VALUE NUMBER VISIBLE DEFAULT 0 ); CREATE TABLE public.CDC_TRACKING ( DB_NAME TEXT(200 BYTE) VISIBLE, SCHEMA_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME_FULL TEXT(200 BYTE) VISIBLE, LAST_UPDATED_DTTM DATE VISIBLE, LAST_VAL_INT NUMBER(22,0) VISIBLE DEFAULT 0, LAST_VAL_TS TIMESTAMP(6) VISIBLE, LAST_VAL_DT DATE VISIBLE ); CREATE TABLE public.CDC_TABLE_PRIMARY_KEYS ( DB_NAME TEXT(200 BYTE) VISIBLE, SCHEMA_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME_FULL TEXT(200 BYTE) VISIBLE, CONSTRAINT_NAME TEXT(200 BYTE) VISIBLE, COLUMN_NAME TEXT(200 BYTE) VISIBLE, IS_NULLABLE NUMBER VISIBLE DEFAULT 0 ); Data Type Mapping ================= .. contents:: :local: :depth: 1 Automatic Mapping ------------------ The **SQLoader** automatically maps data types used in Oracle, Postgresql, Teradata, Microsoft SQL Server, and SAP HANA tables that are loaded into SQreamDB. Oracle ^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - Oracle Type - SQreamDB Type * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGE`` - ``BIGINT`` * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``VARCHAR2``, ``NVARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``DATE``, ``DATETIME`` - ``DATETIME`` * - ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOLEAN`` - ``BOOL`` * - ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``CLOB`` - ``TEXT`` * - ``BLOB`` - ``TEXT`` * - ``RAW`` - ``TEXT`` Postgresql ^^^^^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - Postgresql Type - SQreamDB Type * - ``CHAR``, ``VARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``TEXT`` - ``TEXT`` * - ``INT``, ``SMALLINT``, ``BIGINT``, ``INT2``, ``INT4``, ``INT8`` - ``BIGINT`` * - ``DATETIME``, ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BIT``, ``BOOL`` - ``BOOL`` * - ``DECIMAL``, ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``REAL``, ``FLOAT4`` - ``REAL`` Teradata ^^^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - Teradata Type - SQreamDB Type * - ``F`` - ``DOUBLE`` * - ``N``, ``D`` - ``NUMERIC`` * - ``CO`` - ``TEXT`` * - ``BO`` - ``TEXT`` * - ``A1``, ``AN``, ``AT``, ``BF``, ``BV``, ``CF``, ``CV``, ``JN``, ``PD``, ``PM``, ``PS``, ``PT``, ``PZ``, ``SZ``, ``TZ`` - ``TEXT`` * - ``I``, ``I4``, ``I(4)`` - ``INT`` * - ``I2``, ``I(2)`` - ``SMALLINT`` * - ``I1``, ``I(1)`` - ``TINYINT`` * - ``DH``, ``DM``, ``DS``, ``DY``, ``HM``, ``HS``, ``HR``, ``I8``, ``MO``, ``MS``, ``MI``, ``SC``, ``YM``, ``YR`` - ``BIGINT`` * - ``TS``, ``DATETIME`` - ``DATETIME`` * - ``DA`` - ``DATE`` * - ``BIT`` - ``BOOL`` * - ``REAL``, ``DOUBLE`` - ``DOUBLE`` Microsoft SQL Server ^^^^^^^^^^^^^^^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - Microsoft SQL Server Type - SQreamDB Type * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``NVARCHAR``, ``NVARCHAR2``, ``CHARACTER``, ``TEXT``, ``NTEXT`` - ``TEXT`` * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INT``, ``TINYINT`` - ``BIGINT`` * - ``DATETIME``, ``TIMESTAMP``, ``SMALLDATETIME``, ``DATETIMEOFFSET``, ``DATETIME2`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BIT`` - ``BOOL`` * - ``DECIMAL``, ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``REAL`` - ``REAL`` * - ``VARBINARY`` - ``TEXT`` SAP HANA ^^^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - SAP HANA Type - SQreamDB Type * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGER``, ``TINYINT`` - ``BIGINT`` * - ``CHAR``, ``VARCHAR``, ``NVARCHAR``, ``TEXT``, ``VARCHAR2``, ``NVARCHAR2`` - ``TEXT`` * - ``DATETIME``, ``TIMESTAMP``, ``SECONDDATE`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOLEAN`` - ``TEXT`` * - ``DECIMAL``, ``SMALLDECIMAL``, ``BIGDECIMAL`` - ``NUMERIC`` * - ``DOUBLE``, ``REAL`` - ``FLOAT`` * - ``TEXT`` - ``TEXT`` * - ``BIGINT`` - ``BIGINT`` * - ``INT`` - ``INT`` * - ``SMALLINT`` - ``SMALLINT`` * - ``TINYINT`` - ``TINYINT`` * - ``DATETIME`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOL`` - ``BOOL`` * - ``NUMERIC`` - ``NUMERIC`` * - ``DOUBLE`` - ``DOUBLE`` * - ``FLOAT`` - ``FLOAT`` * - ``REAL`` - ``REAL`` Manually Adjusting Mapping ---------------------------- You have the possibility to adjust the mapping process according to your specific needs, using any of the following methods. ``names`` Method ^^^^^^^^^^^^^^^^^ To specify that you want to map one or more columns in your table to a specific data type, duplicate the code block which maps to the SQreamDB data type you want and include the ``names`` parameter in your code block. The SQLoader will map the specified columns to the specified SQreamDB data type. After the specified columns are mapped, the SQLoader continue to search for how to convert other data types to the same data type of the specified columns. In this example, ``column1``, ``column2``, and ``column3`` are mapped to ``BIGINT`` and the Oracle data types ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGER`` are also mapped to ``BIGINT``. .. code-block:: json { "oracle": [ { "names": ["column1", "column2", "column3"], "sqream": "bigint", "java": "int", "length": false }, { "type": ["bigint","int","smallint","integer"], "sqream": "bigint", "java": "int", "length": false } } .. code-block:: json { "type": ["char","nchar","varchar","varchar2","nvarchar","nvarchar2","character"], "sqream": "text", "java": "string", "length": true }, { "type": ["date","datetime"], "sqream": "datetime", "java": "datetime", "length": false }, { "type": ["timestamp"], "sqream": "datetime", "java": "timestamp", "length": false }, { "type": ["date"], "sqream": "date", "java": "datetime", "length": false }, { "type": ["boolean"], "sqream": "bool", "java": "boolean", "length": false }, { "type": ["number"], "sqream": "numeric", "java": "bigdecimal", "length": true, "prec": true }, { "type": ["float","double"], "sqream": "double", "java": "double", "length": false }, { "type": ["clob"], "sqream": "text", "java": "clob", "length": false }, { "type": ["blob"], "sqream": "text", "java": "blob", "length": false } ] } CLI Examples ============ Loading data into a CDC table using the ``type`` and ``limit`` parameters: .. code-block:: console java -jar sqloader.jar -table source_table_name -type cdc -limit 100 Loading data into a table using your own configuration file (this will override the default configuration file): .. code-block:: console java -jar sqloader.jar -config path/to/your/config/file Loading data into a table using a custom configuration file: .. code-block:: console java -jar -config MyConfigFile.properties -table source_table_name -type cdc -target target_table_name -drop true -lock_check false Loading data into a table using a the ``filter`` parameter: .. code-block:: console java -jar sqloader.jar -table source_table_name -filter column_name>50 \ No newline at end of file +.. _ingesting_from_databases: ****************** External Databases ****************** The **SQLoader** is a CLI program that enables you to load data into SQreamDB from other DBMS and DBaaS. **SQLoader** supports Oracle, Postgresql, Teradata, Microsoft SQL Server, and SAP HANA. .. contents:: :local: :depth: 1 Before You Begin ================ It is essential that you have the following: * Java 17 * SQLoader configuration files * SQLoader.jar file Minimum Hardware Requirements ------------------------------ .. list-table:: :widths: auto :header-rows: 1 * - Component - Type * - CPU cores - 16 * - RAM - 32GB .. _sqloader_thread_sizing_guidelines: Sizing Guidelines ------------------ The SQLoader sizing is determined by the number of concurrent tables and threads based on the available CPU cores, limiting it to the number of cores minus one, with the remaining core reserved for the operating system. Each SQLoader instance runs on a single table, meaning concurrent imports of multiple tables require multiple instances. Additionally, when dealing with partitioned tables, each partition consumes a thread, so users should consider the table's partition count when managing thread allocation for efficient performance. Getting the SQLoader Configuration and JAR Files ================================================ 1. Download the ``.tar`` file using the following command: .. code-block:: linux curl -O https://sq-ftp-public.s3.amazonaws.com/sqloader-7.8.tar 2. Extract the ``.tar`` file using the following command: .. code-block:: linux tar -xf sqloader-7.8.tar.gz A folder named ``sqloader`` with the following files is created: .. list-table:: SQLoader Files :widths: auto :header-rows: 1 * - File - Description * - ``sqream-mapping.json`` - Maps foreign DBMS and DBaaS data types into SQreamDB data types during ingestion * - ``sqload-jdbc.properties`` - Used for defining a connection string and may also be used to reconfigure data loading * - ``reserved_words.txt`` - A list of reserved words which cannot be used as table and/or column names. * - ``sqloader.jar`` - The SQLoader package file Connection String ================= The ``sqload-jdbc.properties`` file contains a connection string that must be configured to enable data loading into SQreamDB. 1. Open the ``sqload-jdbc.properties`` file. 2. Configure connection parameters for: a. Either Postgresql, Oracle, Teradata, Microsoft SQL Server, SAP HANA or SQreamDB connection strings b. Optionally, Oracle or SQreamDB catalogs (recommended) .. list-table:: Connection String Parameters :widths: auto :header-rows: 1 * - Parameter - Description * - ``HostIp:port`` - The host and IP address number * - ``database_name`` - The name of the database from which data is loaded * - ``user`` - Username of a role to use for connection * - ``password`` - Specifies the password of the selected role * - ``ssl`` - Specifies SSL for this connection .. literalinclude:: connection_string.java :language: java :caption: Properties File Sample :linenos: Loading Data into SQreamDB Tables ================================= 1. Run the ``sqloader.jar`` file using the following CLI command: .. code-block:: console java -jar sqloader.jar 2. You may load the entire data of a source table using the following CLI command: .. code-block:: console java -jar sqloader.jar -table source_table_name 3. You may customize the data load either by using each of the following parameters within a CLI command or by configuring the ``properties`` file: .. list-table:: SQLoader CLI Parameters :widths: auto :header-rows: 1 * - CLI Parameter - State - Default - Type - Description * - ``-batchsize`` - Optional - ``10.000`` - - The number of records to be inserted into SQreamDB at once. Please note that the configured batch size may impact chunk sizes. * - ``-casesensative`` - Optional - ``false`` - - If ``true``, keeps table name uppercase and lowercase characters when table is created in SQreamDB * - ``-check_cdc_chain`` - Optional - ``false`` - - Check CDC chain between tracking table and source table * - ``-chunkSize`` - Optional - ``0`` - - The number of records read at once from the source database * - ``-columnlist`` - Optional - *None* - ``.txt`` - The name of the file that contains all column names. Columns must be separated using ``\n`` * - ``-columns`` - Optional - All columns - - The name or names of columns to be loaded into SQreamDB ("col1,col2, ..."). For column names containing uppercase characters, maintain the uppercase format, avoid using double quotes or apostrophes, and ensure that the ``caseSensitive`` parameter is set to true * - ``-config`` - Optional - ``/home/username/downloads/config/sqload-jdbc.properties`` - - Defines the path to the configuration file you wish to use. This parameter may be defined using only the CLI * - ``-config_dir`` - Optional - ``/home/username/downloads/config`` - - Defines the path to the folder containing both the data type mapping and the reserved words files. The defined folder must contain both files or else you will receive an error. * - ``-count`` - Optional - ``true`` - - Defines whether or not table rows will be counted before being loaded into SQreamDB * - ``-delete`` - Optional - ``true`` - - Defines whether or not loading using Change Data Capture (CDC) includes deleted rows * - ``-drop`` - Optional - ``true`` - - Defines whether or not a new target table in SQreamDB is created. If ``false``, you will need to configure a target table name using the ``-target`` parameter * - ``-fetchsize`` - Optional - ``100000`` - - The number of records to be read at once from source database. * - ``-filter`` - Optional - ``1=1`` - - Defines whether or not only records with SQL conditions are loaded * - ``-h, --help`` - Optional - *No input* - - Displays the help menu and exits * - ``-limit`` - Optional - ``0`` (no limit) - - Limits the number of rows to be loaded * - ``-load_dttm`` - Optional - ``true`` - - Add an additional ``load_dttm`` column that defines the time and date of loading * - ``-lock_check`` - Optional - ``true`` - - Defines whether or not SQLoader will check source table is locked before the loading starts * - ``-lock_table`` - Optional - ``true`` - - Defines whether or not SQLoader will lock target table before the loading starts * - ``-log_dir`` - Optional - ``logs`` - - Defines the path of log directory created when loading data. If no value is specified, a ``logs`` folder is created under the same location as the ``sqloader.jar`` file * - ``-partition`` - Optional - *None* - Partition identifier ``string`` - Specifies the number of table partitions. If configured, ``-partition`` ensures that data is loaded according to the specified partition. You may configure the ``-thread`` parameter for parallel loading of your table partitions. If you do, please ensure that the number of threads does not exceed the number of partitions. * - ``-rowid`` - Optional - ``false`` - - Defines whether or not SQLoader will get row IDs from Oracle tables * - ``-source_db`` - Optional - ``ORCL`` - - Defines the source database name. It does not modify the database connection string but impacts the storage and retrieval of data within catalog tables. * - ``-split`` - Optional - *None* - Column name ``string`` - Column name for split (required for multi-thread loads) * - ``-table`` - Mandatory - *None* - Table name ``string`` - Source table name to load data from * - ``-target`` - Optional - Target table name - Table name ``string`` - Target table name to load data into * - ``-thread`` - Optional - ``1`` - - Number of threads to use for loading. Using multiple threads can significantly improve the loading performance, especially when dealing with columns that have metadata statistics (e.g., min/max values). SQLoader will automatically divide the data into batches based on the specified thread number, allowing for parallel processing. You may use ``-thread`` both for tables that are partitioned and tables that are not. See :ref:`Sizing Guidelines<sqloader_thread_sizing_guidelines>` * - ``-truncate`` - Optional - ``false`` - - Truncate target table before loading * - ``-type`` - Optional - ``full`` - - Defines a loading type that affects the table that is created in SQreamDB. Options are ``full``, ``cdc``, or ``inc``. Please note that ``cdc``, and ``inc`` are supported only for Oracle * - ``-use_dbms_lob`` - Optional - ``true`` - - Defines whether or not SQLoader uses ``dbms_lob_substr`` function for ``CLOB`` and ``BLOB`` data types * - ``-use_partitions`` - Optional - ``true`` - - Defines whether or not SQLoader uses partitions in ``SELECT`` statements Using the ``type`` Parameter ------------------------------ Using the ``type`` parameter you may define a loading type that affects the table that is created in SQreamDB. .. list-table:: :widths: auto :header-rows: 1 * - Loading Type - Parameter Option - Description * - Full Table - ``full`` - The entire data of the source table is loaded into SQreamDB * - Change Data Capture (CDC) - ``cdc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT``, ``UPDATE``, and ``DELETE`` statements. SQLoader recognizes tables by table name and metadata. Supported for Oracle only * - Incremental - ``inc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT`` statement. SQLoader recognizes the table by table name and metadata. Supported for Oracle only Creating Summary Tables ======================== Summary tables are pre-aggregated tables that store summarized or aggregated data, which can help improve query performance and reduce the need for complex calculations during runtime. Summary tables are part of the schema within the database catalog. Creating a Summary Table -------------------------- This summary table uses Oracle syntax. .. code-block:: sql CREATE TABLE public.SQLOAD_SUMMARY ( DB_NAME TEXT(200 BYTE) VISIBLE, SCHEMA_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME_FULL TEXT(200 BYTE) VISIBLE, LOAD_TYPE TEXT(200 BYTE) VISIBLE, UPDATED_DTTM_FROM DATE VISIBLE, UPDATED_DTTM_TO DATE VISIBLE, LAST_VAL_INT NUMBER(22,0) VISIBLE, LAST_VAL_TS DATE VISIBLE, START_TIME TIMESTAMP(6) VISIBLE, FINISH_TIME TIMESTAMP(6) VISIBLE, ELAPSED_SEC NUMBER VISIBLE, ROW_COUNT NUMBER VISIBLE, SQL_FILTER TEXT(200 BYTE) VISIBLE, PARTITION TEXT(200 BYTE) VISIBLE, STMT_TYPE TEXT(200 BYTE) VISIBLE, STATUS TEXT(200 BYTE) VISIBLE, LOG_FILE TEXT(200 BYTE) VISIBLE, DB_URL TEXT(200 BYTE) VISIBLE, PARTITION_COUNT NUMBER VISIBLE DEFAULT 0, THREAD_COUNT NUMBER VISIBLE DEFAULT 1, ELAPSED_MS NUMBER VISIBLE DEFAULT 0, STATUS_CODE NUMBER VISIBLE DEFAULT 0, ELAPSED_SOURCE_MS NUMBER(38,0) DEFAULT NULL, ELAPSED_SOURCE_SEC NUMBER(38,0) DEFAULT NULL, ELAPSED_TARGET_MS NUMBER(38,0) DEFAULT NULL, ELAPSED_TARGET_SEC NUMBER(38,0) DEFAULT NULL, TARGET_DB_URL VARCHAR2(200) DEFAULT NULL, SQLOADER_VERSION VARCHAR2(20) DEFAULT NULL, HOST VARCHAR2(200) DEFAULT NULL ); Creating a Change Data Capture Table -------------------------------------- Change Data Capture (CDC) tables are supported only for Oracle. .. code-block:: sql CREATE TABLE public.CDC_TABLES ( DB_NAME TEXT(200 BYTE) VISIBLE, SCHEMA_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME_FULL TEXT(200 BYTE) VISIBLE, TABLE_NAME_CDC TEXT(200 BYTE) VISIBLE, INC_COLUMN_NAME TEXT(200 BYTE) VISIBLE, INC_COLUMN_TYPE TEXT(200 BYTE) VISIBLE, LOAD_TYPE TEXT(200 BYTE) VISIBLE, FREQ_TYPE TEXT(200 BYTE) VISIBLE, FREQ_INTERVAL NUMBER(22,0) VISIBLE, IS_ACTIVE NUMBER VISIBLE DEFAULT 0, STATUS_LOAD NUMBER VISIBLE DEFAULT 0, INC_GAP_VALUE NUMBER VISIBLE DEFAULT 0 ); CREATE TABLE public.CDC_TRACKING ( DB_NAME TEXT(200 BYTE) VISIBLE, SCHEMA_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME_FULL TEXT(200 BYTE) VISIBLE, LAST_UPDATED_DTTM DATE VISIBLE, LAST_VAL_INT NUMBER(22,0) VISIBLE DEFAULT 0, LAST_VAL_TS TIMESTAMP(6) VISIBLE, LAST_VAL_DT DATE VISIBLE ); CREATE TABLE public.CDC_TABLE_PRIMARY_KEYS ( DB_NAME TEXT(200 BYTE) VISIBLE, SCHEMA_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME_FULL TEXT(200 BYTE) VISIBLE, CONSTRAINT_NAME TEXT(200 BYTE) VISIBLE, COLUMN_NAME TEXT(200 BYTE) VISIBLE, IS_NULLABLE NUMBER VISIBLE DEFAULT 0 ); Data Type Mapping ================= .. contents:: :local: :depth: 1 Automatic Mapping ------------------ The **SQLoader** automatically maps data types used in Oracle, Postgresql, Teradata, Microsoft SQL Server, and SAP HANA tables that are loaded into SQreamDB. Oracle ^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - Oracle Type - SQreamDB Type * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGE`` - ``BIGINT`` * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``VARCHAR2``, ``NVARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``DATE``, ``DATETIME`` - ``DATETIME`` * - ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOLEAN`` - ``BOOL`` * - ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``CLOB`` - ``TEXT`` * - ``BLOB`` - ``TEXT`` * - ``RAW`` - ``TEXT`` Postgresql ^^^^^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - Postgresql Type - SQreamDB Type * - ``CHAR``, ``VARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``TEXT`` - ``TEXT`` * - ``INT``, ``SMALLINT``, ``BIGINT``, ``INT2``, ``INT4``, ``INT8`` - ``BIGINT`` * - ``DATETIME``, ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BIT``, ``BOOL`` - ``BOOL`` * - ``DECIMAL``, ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``REAL``, ``FLOAT4`` - ``REAL`` Teradata ^^^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - Teradata Type - SQreamDB Type * - ``F`` - ``DOUBLE`` * - ``N``, ``D`` - ``NUMERIC`` * - ``CO`` - ``TEXT`` * - ``BO`` - ``TEXT`` * - ``A1``, ``AN``, ``AT``, ``BF``, ``BV``, ``CF``, ``CV``, ``JN``, ``PD``, ``PM``, ``PS``, ``PT``, ``PZ``, ``SZ``, ``TZ`` - ``TEXT`` * - ``I``, ``I4``, ``I(4)`` - ``INT`` * - ``I2``, ``I(2)`` - ``SMALLINT`` * - ``I1``, ``I(1)`` - ``TINYINT`` * - ``DH``, ``DM``, ``DS``, ``DY``, ``HM``, ``HS``, ``HR``, ``I8``, ``MO``, ``MS``, ``MI``, ``SC``, ``YM``, ``YR`` - ``BIGINT`` * - ``TS``, ``DATETIME`` - ``DATETIME`` * - ``DA`` - ``DATE`` * - ``BIT`` - ``BOOL`` * - ``REAL``, ``DOUBLE`` - ``DOUBLE`` Microsoft SQL Server ^^^^^^^^^^^^^^^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - Microsoft SQL Server Type - SQreamDB Type * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``NVARCHAR``, ``NVARCHAR2``, ``CHARACTER``, ``TEXT``, ``NTEXT`` - ``TEXT`` * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INT``, ``TINYINT`` - ``BIGINT`` * - ``DATETIME``, ``TIMESTAMP``, ``SMALLDATETIME``, ``DATETIMEOFFSET``, ``DATETIME2`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BIT`` - ``BOOL`` * - ``DECIMAL``, ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``REAL`` - ``REAL`` * - ``VARBINARY`` - ``TEXT`` SAP HANA ^^^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - SAP HANA Type - SQreamDB Type * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGER``, ``TINYINT`` - ``BIGINT`` * - ``CHAR``, ``VARCHAR``, ``NVARCHAR``, ``TEXT``, ``VARCHAR2``, ``NVARCHAR2`` - ``TEXT`` * - ``DATETIME``, ``TIMESTAMP``, ``SECONDDATE`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOLEAN`` - ``TEXT`` * - ``DECIMAL``, ``SMALLDECIMAL``, ``BIGDECIMAL`` - ``NUMERIC`` * - ``DOUBLE``, ``REAL`` - ``FLOAT`` * - ``TEXT`` - ``TEXT`` * - ``BIGINT`` - ``BIGINT`` * - ``INT`` - ``INT`` * - ``SMALLINT`` - ``SMALLINT`` * - ``TINYINT`` - ``TINYINT`` * - ``DATETIME`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOL`` - ``BOOL`` * - ``NUMERIC`` - ``NUMERIC`` * - ``DOUBLE`` - ``DOUBLE`` * - ``FLOAT`` - ``FLOAT`` * - ``REAL`` - ``REAL`` Manually Adjusting Mapping ---------------------------- You have the possibility to adjust the mapping process according to your specific needs, using any of the following methods. ``names`` Method ^^^^^^^^^^^^^^^^^ To specify that you want to map one or more columns in your table to a specific data type, duplicate the code block which maps to the SQreamDB data type you want and include the ``names`` parameter in your code block. The SQLoader will map the specified columns to the specified SQreamDB data type. After the specified columns are mapped, the SQLoader continue to search for how to convert other data types to the same data type of the specified columns. In this example, ``column1``, ``column2``, and ``column3`` are mapped to ``BIGINT`` and the Oracle data types ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGER`` are also mapped to ``BIGINT``. .. code-block:: json { "oracle": [ { "names": ["column1", "column2", "column3"], "sqream": "bigint", "java": "int", "length": false }, { "type": ["bigint","int","smallint","integer"], "sqream": "bigint", "java": "int", "length": false } } .. code-block:: json { "type": ["char","nchar","varchar","varchar2","nvarchar","nvarchar2","character"], "sqream": "text", "java": "string", "length": true }, { "type": ["date","datetime"], "sqream": "datetime", "java": "datetime", "length": false }, { "type": ["timestamp"], "sqream": "datetime", "java": "timestamp", "length": false }, { "type": ["date"], "sqream": "date", "java": "datetime", "length": false }, { "type": ["boolean"], "sqream": "bool", "java": "boolean", "length": false }, { "type": ["number"], "sqream": "numeric", "java": "bigdecimal", "length": true, "prec": true }, { "type": ["float","double"], "sqream": "double", "java": "double", "length": false }, { "type": ["clob"], "sqream": "text", "java": "clob", "length": false }, { "type": ["blob"], "sqream": "text", "java": "blob", "length": false } ] } CLI Examples ============ Loading data into a CDC table using the ``type`` and ``limit`` parameters: .. code-block:: console java -jar sqloader.jar -table source_table_name -type cdc -limit 100 Loading data into a table using your own configuration file (this will override the default configuration file): .. code-block:: console java -jar sqloader.jar -config path/to/your/config/file Loading data into a table using a custom configuration file: .. code-block:: console java -jar -config MyConfigFile.properties -table source_table_name -type cdc -target target_table_name -drop true -lock_check false Loading data into a table using a the ``filter`` parameter: .. code-block:: console java -jar sqloader.jar -table source_table_name -filter column_name>50 \ No newline at end of file From 25ba3f52d068a7ce9827e8aa1acd03183ef93a27 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 20 Feb 2024 08:59:12 +0200 Subject: [PATCH 805/882] Update repeat.rst --- .../scalar_functions/string/repeat.rst | 142 +++++++----------- 1 file changed, 55 insertions(+), 87 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/string/repeat.rst b/reference/sql/sql_functions/scalar_functions/string/repeat.rst index 4e202b5b2..920aa55db 100644 --- a/reference/sql/sql_functions/scalar_functions/string/repeat.rst +++ b/reference/sql/sql_functions/scalar_functions/string/repeat.rst @@ -1,20 +1,17 @@ .. _repeat: -************************** +****** REPEAT -************************** - -Repeats a string as many times as specified. - -.. warning:: This function works ONLY with ``TEXT`` data type. +****** +The ``REPEAT`` function repeats an input string expression as many times as specified. Syntax ========== -.. code-block:: postgres +.. code-block:: sql - REPEAT(expr, character_count) + REPEAT('expr', n) Arguments ============ @@ -25,105 +22,76 @@ Arguments * - Parameter - Description - * - ``expr`` - - String expression - * - ``character_count`` + * - ``'expr'`` + - A ``TEXT`` expression + * - ``n`` + - An ``INTEGER`` expression specifying the number of repetitions for the string expression -Returns -============ - -Returns the same type as the argument supplied. - -Notes -======= +Return +====== -* When ``character_count`` <= 0, and empty string is returned. +* Returns a ``TEXT`` string. +* When ``n`` <= 0, and empty string is returned. Examples -=========== +======== -For these examples, consider the following table and contents: +For these example, consider the following table: -.. code-block:: postgres +.. code-block:: sql - CREATE TABLE customer(customername TEXT)); + CREATE TABLE customer(customername TEXT); - INSERT INTO customer VALUES - ('Alfreds Futterkiste'), - ('Ana Trujillo Emparedados y helados'), - ('Antonio Moreno Taquería'), - ('Around the Horn'); + INSERT INTO customer VALUES + ('Alfreds Futterkiste'), + ('Ana Trujillo Emparedados y helados'), + ('Antonio Moreno Taquería'), + ('Around the Horn'); -Repeat the text in customername 2 times: ------------------------------------------ +Repeating Content of a Table Column +----------------------------------- -.. code-block:: psql +.. code-block:: sql - t=> SELECT REPEAT(customername, 2) FROM customers; + SELECT REPEAT(customername, 2) FROM customer; - repeat - -------------------------- - Alfreds FutterkisteAlfreds Futterkiste - Ana Trujillo Emparedados y heladosAna Trujillo Emparedados y helados - Antonio Moreno TaqueríaAntonio Moreno Taquería - Around the HornAround the Horn + repeat + -------------------------------------------------------------------- + Alfreds FutterkisteAlfreds Futterkiste + Ana Trujillo Emparedados y heladosAna Trujillo Emparedados y helados + Antonio Moreno TaqueríaAntonio Moreno Taquería + Around the HornAround the Horn +Repeating a String +------------------ -Repeat the string 0 times: ----------------------------- +.. code-block:: sql -.. code-block:: psql + SELECT REPEAT('abc', 3); + + repeat + --------- + abcabcabc - t=> SELECT REPEAT('abc', 0); - - repeat - ----------------------------------------------- - '' -Repeat the string 1 times: ----------------------------- +Repeating a String 0 Times +-------------------------- -.. code-block:: psql +.. code-block:: sql - t=> SELECT REPEAT('abc', 1); - - repeat - ----------------------------------------------- - 'abc' - + SELECT REPEAT('abc', 0); + + repeat + ------ -Repeat the string 3 times: ----------------------------- +Repeating an Empty String +------------------------- -.. code-block:: psql - - t=> SELECT REPEAT('a', 3); - - repeat - ----------------------------------------------- - 'aaa' +.. code-block:: sql - -Repeat an empty string 10 times: ----------------------------- - -.. code-block:: psql - - t=> SELECT REPEAT('', 10); - - repeat - ----------------------------------------------- - '' - - -Repeat a string -3 times: ----------------------------- - -.. code-block:: psql - - t=> SELECT REPEAT('abc', -3); - - repeat - ----------------------------------------------- - '' \ No newline at end of file + SELECT REPEAT('', 3); + + repeat + ------ + From bd5df3838f575143030fbb33e394e0f101cedf18 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 20 Feb 2024 15:20:08 +0200 Subject: [PATCH 806/882] Update repeat.rst --- .../sql/sql_functions/scalar_functions/string/repeat.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/reference/sql/sql_functions/scalar_functions/string/repeat.rst b/reference/sql/sql_functions/scalar_functions/string/repeat.rst index 920aa55db..df9c2fe6f 100644 --- a/reference/sql/sql_functions/scalar_functions/string/repeat.rst +++ b/reference/sql/sql_functions/scalar_functions/string/repeat.rst @@ -3,7 +3,7 @@ ****** REPEAT ****** - + The ``REPEAT`` function repeats an input string expression as many times as specified. Syntax @@ -32,7 +32,8 @@ Return ====== * Returns a ``TEXT`` string. -* When ``n`` <= 0, and empty string is returned. +* When ``n`` = 0, and empty string is returned. +* When ``n`` < 0, an error is thrown. Examples ======== From 0d95eac948668bf6d880fb1437da94579af0f3c6 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 5 Mar 2024 11:36:09 +0200 Subject: [PATCH 807/882] Update ldap.rst --- configuration_guides/ldap.rst | 57 +++++++++++++++-------------------- 1 file changed, 25 insertions(+), 32 deletions(-) diff --git a/configuration_guides/ldap.rst b/configuration_guides/ldap.rst index ec16f9c69..75b99bb6f 100644 --- a/configuration_guides/ldap.rst +++ b/configuration_guides/ldap.rst @@ -13,27 +13,15 @@ Before integrating SQream with LDAP consider the following: * If SQream DB has been installed and LDAP has not yet been integrated with SQream, it is best practice to ensure that the newly created LDAP user names are consistent with existing SQream role names. Previously existing SQream roles that were mistakenly not configured in LDAP or that have names which are different than in LDAP, will be recreated in SQream as roles that cannot log in, have no permissions, and have no default schema. -.. contents:: In this topic: +.. contents:: :local: - -Before You Begin -================ - -Enable self-signed certificates for OpenLDAP by adding the following line to the ``ldap.conf`` configuration file: - -.. code-block:: postgres - - ``TLS_REQCERT allow`` - - + :depth: 1 Configuring SQream roles ======================== Follow this procedure if you already have LDAP configured for your environment. -**Procedure** - 1. Create a new role: .. code-block:: postgres @@ -58,8 +46,9 @@ You may also wish to :ref:`rename SQream roles<rename_role>` so that they are co Configuring LDAP Authentication =============================== -.. contents:: In this topic: +.. contents:: :local: + :depth: 1 Configuration Methods --------------------- @@ -85,7 +74,7 @@ Basic Method Flag Attributes ~~~~~~~~~~~~~~~ -To enable basic LDAP authentication, configure the following **Cluster** flag attributes using the ``ALTER SYSTEM SET`` command: +To enable basic LDAP authentication, configure the following cluster flag attributes using the ``ALTER SYSTEM SET`` command: .. list-table:: :widths: auto @@ -94,19 +83,19 @@ To enable basic LDAP authentication, configure the following **Cluster** flag at * - Attribute - Description * - ``authenticationMethod`` - - Configure an authentication method: ``sqream`` or ``ldap``. To configure LDAP authentication, choose ``ldap``. + - Configure an authentication method: ``sqream`` or ``ldap``. To configure LDAP authentication, choose ``ldap`` * - ``ldapIpAddress`` - - Configure the IP address or the Fully Qualified Domain Name (FQDN) of your LDAP server and select a protocol: ``ldap`` or ``ldaps``. Sqream recommends using the encrypted ``ldaps`` protocol. + - Configure the IP address or the Fully Qualified Domain Name (FQDN) of your LDAP server and select a protocol: ``ldap`` or ``ldaps``. Sqream recommends using the encrypted ``ldaps`` protocol * - ``ldapConnTimeoutSec`` - - Configure the LDAP connection timeout threshold (seconds). Default = 30 seconds. + - Configure the LDAP connection timeout threshold (seconds). Default = 30 seconds * - ``ldapPort`` - LDAP server port number. * - ``ldapAdvancedMode`` - - Configure either basic or advanced authentication method. Default = ``false``. + - Configure either basic or advanced authentication method. Default = ``false`` * - ``ldapPrefix`` - - String to prefix to the user name when forming the DN to bind as, when doing simple bind authentication. + - String to prefix to the user name when forming the DN to bind as, when doing simple bind authentication * - ``ldapSuffix`` - - String to append to the user name when forming the DN to bind as, when doing simple bind authentication. + - String to append to the user name when forming the DN to bind as, when doing simple bind authentication Basic Method Configuration @@ -183,7 +172,7 @@ Advanced Method Flag Attributes ~~~~~~~~~~~~~~~ -To enable advanced LDAP authentication, configure the following **Cluster** flag attributes using the ``ALTER SYSTEM SET`` command: +To enable advanced LDAP authentication, configure the following cluster flag attributes using the ``ALTER SYSTEM SET`` command: .. list-table:: :widths: auto @@ -192,23 +181,25 @@ To enable advanced LDAP authentication, configure the following **Cluster** flag * - Attribute - Description * - ``authenticationMethod`` - - Configure an authentication method: ``sqream`` or ``ldap``. To configure LDAP authentication, choose ``ldap``. + - Configure an authentication method: ``sqream`` or ``ldap``. To configure LDAP authentication, choose ``ldap`` * - ``ldapIpAddress`` - - Configure the IP address or the Fully Qualified Domain Name (FQDN) of your LDAP server and select a protocol: ``ldap`` or ``ldaps``. Sqream recommends using the encrypted ``ldaps`` protocol. + - Configure the IP address or the Fully Qualified Domain Name (FQDN) of your LDAP server and select a protocol: ``ldap`` or ``ldaps``. Sqream recommends using the encrypted ``ldaps`` protocol * - ``ldapConnTimeoutSec`` - - Configure the LDAP connection timeout threshold (seconds). Default = 30 seconds. + - Configure the LDAP connection timeout threshold (seconds). Default = 30 seconds * - ``ldapPort`` - - LDAP server port number. + - LDAP server port number * - ``ldapAdvancedMode`` - - Set ``ldapAdvancedMode`` = ``true``. + - Set ``ldapAdvancedMode`` = ``true`` * - ``ldapBaseDn`` - - Root DN to begin the search for the user in, when doing advanced authentication. + - Root DN to begin the search for the user in, when doing advanced authentication * - ``ldapBindDn`` - - DN of user with which to bind to the directory to perform the search when doing search + bind authentication. + - DN of user with which to bind to the directory to perform the search when doing search + bind authentication * - ``ldapBindDnPassword`` - - Password for user with which to bind to the directory to perform the search when doing search + bind authentication. + - Password for user with which to bind to the directory to perform the search when doing search + bind authentication * - ``ldapSearchAttribute`` - - Attribute to match against the user name in the search when doing search + bind authentication. If no attribute is specified, ``the uid`` attribute will be used. + - Attribute to match against the user name in the search when doing search + bind authentication. If no attribute is specified, ``the uid`` attribute will be used + * - ``ldapSearchFilter`` + - Filters ``ldapAdvancedMode`` authentication Advanced Method Configuration ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -307,6 +298,8 @@ User has value of elonm for attribute ``sAMAccountName``. ALTER SYSTEM SET ldapConnTimeoutSec = 30; + ALTER SYSTEM SET ldapSearchFilter = "(memberOf=CN=SqreamGroup,CN=Builtin,DC=sqream,DC=loc)(memberOf=CN=Admins,CN=Builtin,DC=sqream,DC=loc)"; + Logging in will be possible using the username elonm using sqream client From a3cbf78b82fcf89fb95694081f83b0105eb1c173 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 5 Mar 2024 13:11:49 +0200 Subject: [PATCH 808/882] Update ldap.rst --- configuration_guides/ldap.rst | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/configuration_guides/ldap.rst b/configuration_guides/ldap.rst index 75b99bb6f..c89249eb1 100644 --- a/configuration_guides/ldap.rst +++ b/configuration_guides/ldap.rst @@ -249,20 +249,26 @@ Only roles with admin privileges and higher may enable LDAP Authentication. .. code-block:: postgres ALTER SYSTEM SET ldapSearchAttribute = '<search_attribute>'; + +8. To set the ``ldapSearchFilter`` attribute (Optional), run: + +.. code-block:: postgres + + ALTER SYSTEM SET ldapSearchFilter = '(<attribute>=<value>)(<attribute2>=<value2>)(…)'; -8. To set the ``ldapPort`` attribute (Optional), run: +9. To set the ``ldapPort`` attribute (Optional), run: .. code-block:: postgres ALTER SYSTEM SET ldapPort = <port_number> -9. To set the ``ldapConnTimeoutSec`` attribute (Optional), run: +10. To set the ``ldapConnTimeoutSec`` attribute (Optional), run: .. code-block:: postgres ALTER SYSTEM SET ldapConnTimeoutSec = <15>; -10. Restart all sqreamd servers. +11. Restart all sqreamd servers. Example ~~~~~~~ From 04096547863cce7f4f345514976854383eb9d47c Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 5 Mar 2024 13:17:17 +0200 Subject: [PATCH 809/882] Update ldap.rst --- configuration_guides/ldap.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/configuration_guides/ldap.rst b/configuration_guides/ldap.rst index c89249eb1..8f1d53fd9 100644 --- a/configuration_guides/ldap.rst +++ b/configuration_guides/ldap.rst @@ -199,7 +199,7 @@ To enable advanced LDAP authentication, configure the following cluster flag att * - ``ldapSearchAttribute`` - Attribute to match against the user name in the search when doing search + bind authentication. If no attribute is specified, ``the uid`` attribute will be used * - ``ldapSearchFilter`` - - Filters ``ldapAdvancedMode`` authentication + - Filters ``ldapAdvancedMode`` authentication. ``ALTER SYSTEM SET ldapSearchFilter = '(<attribute>=<value>)(<attribute2>=<value2>)(…)';`` Advanced Method Configuration ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ From b99495bb49f4f535cf9e9c7d198f3d7157a71edd Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 6 Mar 2024 10:10:01 +0200 Subject: [PATCH 810/882] Update create_role.rst --- .../sql/sql_statements/access_control_commands/create_role.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/access_control_commands/create_role.rst b/reference/sql/sql_statements/access_control_commands/create_role.rst index 6e3b815b1..630cf6714 100644 --- a/reference/sql/sql_statements/access_control_commands/create_role.rst +++ b/reference/sql/sql_statements/access_control_commands/create_role.rst @@ -83,4 +83,4 @@ A user role has permissions to login, and has a password. GRANT PASSWORD 'passw0rd' to new_role; GRANT CONNECT ON DATABASE master to new_role; -- Repeat for all desired databases GRANT USAGE ON SERVICE sqream TO new_role; - GRANT ALL ON SCHEMA public; -- It is advisable to grant permissions on at least one schema \ No newline at end of file + GRANT ALL ON SCHEMA public TO new_role; -- It is advisable to grant permissions on at least one schema From ce417628b1a26680397b61f2ce24416963beaf59 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 11 Mar 2024 13:10:28 +0200 Subject: [PATCH 811/882] Update hardware_guide.rst --- getting_started/hardware_guide.rst | 114 +++++++++++++++-------------- 1 file changed, 58 insertions(+), 56 deletions(-) diff --git a/getting_started/hardware_guide.rst b/getting_started/hardware_guide.rst index e2ead1e4c..bfb85acf3 100644 --- a/getting_started/hardware_guide.rst +++ b/getting_started/hardware_guide.rst @@ -4,22 +4,27 @@ Hardware Guide ************** -The **Hardware Guide** describes the SQream reference architecture, emphasizing the benefits to the technical audience, and provides guidance for end-users on selecting the right configuration for a SQream installation. +The **Hardware Guide** describes the SQreamDB reference architecture, emphasizing the benefits to the technical audience, and provides guidance for end-users on selecting the right configuration for a SQreamDB installation. .. rubric:: Need help? -This page is intended as a "reference" to suggested hardware. However, different workloads require different solution sizes. SQream's experienced customer support has the experience to advise on these matters to ensure the best experience. +This page is intended as a "reference" to suggested hardware. However, different workloads require different solution sizes. SQreamDB's experienced customer support has the experience to advise on these matters to ensure the best experience. -Visit `SQream's support portal <https://sqream.atlassian.net/servicedesk/customer/portals>`_ for additional support. +Visit `SQreamDB's support portal <https://sqream.atlassian.net/servicedesk/customer/portals>`_ for additional support. + +.. contents:: + :local: + :depth: 2 -A SQream Cluster -================ -SQream recommends rackmount servers by server manufacturers Dell, Lenovo, HP, Cisco, Supermicro, IBM, and others. +Cluster Architectures +===================== -A typical SQream cluster includes one or more nodes, consisting of +SQreamDB recommends rackmount servers by server manufacturers Dell, Lenovo, HP, Cisco, Supermicro, IBM, and others. -* Two-socket enterprise processors, like the Intel® Xeon® Gold processor family or an IBM® POWER9 processors, providing the high performance required for compute-bound database workloads. +A typical SQreamDB cluster includes one or more nodes, consisting of: + +* Two-socket enterprise processors, such as Intel® Xeon® Gold processors or the IBM® POWER9 processors, providing the high performance required for compute-bound database workloads. :: @@ -29,10 +34,10 @@ A typical SQream cluster includes one or more nodes, consisting of * High density chassis design, offering between 2 and 4 GPUs in a 1U, 2U, or 3U package, for best-in-class performance per cm\ :sup:`2`. -Single-Node Cluster Example ---------------------------- +Single-Node Cluster +------------------- -A single-node SQream cluster can handle between 1 and 8 concurrent users, with up to 1PB of data storage (when connected via NAS). +A single-node SQreamDB cluster can handle between 1 and 8 concurrent users, with up to 1PB of data storage (when connected via NAS). An average single-node cluster can be a rackmount server or workstation, containing the following components: @@ -44,7 +49,7 @@ An average single-node cluster can be a rackmount server or workstation, contain - Type * - Server - Dell R750, Dell R940xa, HP ProLiant DL380 Gen10 or similar (Intel only) - * - Processor + * - Processors - 2x Intel Xeon Gold 6348 (28C/56HT) 3.5GHz or similar * - RAM - 1.5 TB @@ -59,29 +64,22 @@ An average single-node cluster can be a rackmount server or workstation, contain NVIDIA 2x A100, H100, or L40S * - Operating System - - Red Hat Enterprise Linux v7.9 or CentOS v7.9 or Amazon Linux + - Red Hat Enterprise Linux v8.8 or Amazon Linux .. note:: If you are using internal storage, your volumes must be formatted as xfs. -In this system configuration, SQream can store about 100TB of raw data (assuming an average compression ratio and ~30TB of usable raw storage). +In this system configuration, SQreamDB can store about 100TB of raw data (assuming an average compression ratio and ~30TB of usable raw storage). -If a NAS is used, the 10x SSD drives can be omitted, but SQream recommends 2TB of local spool space on SSD or NVMe drives. +If a NAS is used, the 10x SSD drives can be omitted, but SQreamDB recommends 2TB of local spool space on SSD or NVMe drives. -Multi-Node Cluster Examples ---------------------------- +Multi-Node Cluster +------------------ -Multi-node clusters can handle any number of concurrent users. A typical SQream cluster relies on a minimum of two GPU-enabled servers and shared storage connected over a network fabric, such as InfiniBand EDR, 40GbE, or 100GbE. +Multi-node clusters can handle any number of concurrent users. A typical SQreamDB cluster relies on a minimum of two GPU-enabled servers and shared storage connected over a network fabric, such as InfiniBand EDR, 40GbE, or 100GbE. The **Multi-Node Cluster Examples** section describes the following specifications: -.. contents:: - :local: - :depth: 1 - -Hardware Specifications -~~~~~~~~~~~~~~~~~~~~~~~ - -The following table shows SQream's recommended hardware specifications: +The following table shows SQreamDB's recommended hardware specifications: .. list-table:: :widths: 15 65 @@ -91,7 +89,7 @@ The following table shows SQream's recommended hardware specifications: - Type * - Server - Dell R750, Dell R940xa, HP ProLiant DL380 Gen10 or similar (Intel only) - * - Processor + * - Processors - 2x Intel Xeon Gold 6348 (28C/56HT) 3.5GHz or similar * - RAM - 2 TB @@ -99,6 +97,10 @@ The following table shows SQream's recommended hardware specifications: - * 2x 960GB SSD 2.5in hot plug for OS, RAID1 * 2x 2TB SSD or NVMe, for temporary spooling, RAID0 + * - Network Card (Storage) + - 2x Mellanox ConnectX-6 Single Port HDR VPI InfiniBand Adapter cards at 100GbE or similar. + * - Network Card (Client) + - 2x 1 GbE cards or similar * - External Storage - * Mellanox Connectx5/6 100G NVIDIA Network Card (if applicable) or other high-speed network card minimum 40G compatible with customer’s infrastructure @@ -106,12 +108,12 @@ The following table shows SQream's recommended hardware specifications: * - GPU - NVIDIA 2x A100, H100, or L40S * - Operating System - - Red Hat Enterprise Linux v7.9 or CentOS v7.9 or Amazon Linux + - Red Hat Enterprise Linux v8.8 or Amazon Linux -Metadata Specifications -~~~~~~~~~~~~~~~~~~~~~~~ +Metadata Server +--------------- -The following table shows SQream's recommended metadata server specifications: +The following table shows SQreamDB's recommended metadata server specifications: .. list-table:: :widths: 15 90 @@ -119,27 +121,27 @@ The following table shows SQream's recommended metadata server specifications: * - Component - Type + * - Server + - Dell R750, Dell R940xa, HP ProLiant DL380 Gen10 or similar (Intel only) * - Processors - - Two Intel Xeon Gold 6342 2.8 Ghz 24C processors or similar + - 2x Intel Xeon Gold 6342 2.8 Ghz 24C processors or similar * - RAM - 512GB DDR4 RAM 8x64GB RDIMM or similar - * - Discs - - Two 960 GB MVMe SSD drives in RAID 1 or similar + * - Onboard storage + - 2x 960 GB MVMe SSD drives in RAID 1 or similar * - Network Card (Storage) - - Two Mellanox ConnectX-6 Single Port HDR VPI InfiniBand Adapter cards at 100GbE or similar. - * - Network Card (Corporate) - - Two 1 GbE cards or similar - * - Power sources - - Two Power Supplies - 800W AC 50/60Hz 100~240Vac/9.2-4.7A, 3139 BTU/hr + - 2x Mellanox ConnectX-6 Single Port HDR VPI InfiniBand Adapter cards at 100GbE or similar. + * - Network Card (Client) + - 2x 1 GbE cards or similar * - Operating System - - Red Hat Enterprise Linux v7.9 or CentOS v7.9 or Amazon Linux + - Red Hat Enterprise Linux v8.8 or Amazon Linux -.. note:: With a NAS connected over GPFS, Lustre, Weka, or VAST, each SQream worker can read data at 5GB/s or more. +.. note:: With a NAS connected over GPFS, Lustre, Weka, or VAST, each SQreamDB worker can read data at 5GB/s or more. -SQream Studio Server Example ----------------------------- +SQreamDB Studio Server +---------------------- -The following table shows SQream's recommended Studio server specifications: +The following table shows SQreamDB's recommended Studio server specifications: .. list-table:: :widths: auto @@ -163,24 +165,24 @@ Cluster Design Considerations This section describes the following cluster design considerations: -* In a SQream installation, the storage and computing are logically separated. While they may reside on the same machine in a standalone installation, they may also reside on different hosts, providing additional flexibility and scalability. +* In a SQreamDB installation, the storage and computing are logically separated. While they may reside on the same machine in a standalone installation, they may also reside on different hosts, providing additional flexibility and scalability. :: -* SQream uses all resources in a machine, including CPU, RAM, and GPU to deliver the best performance. At least 256GB of RAM per physical GPU is recommended. +* SQreamDB uses all resources in a machine, including CPU, RAM, and GPU to deliver the best performance. At least 256GB of RAM per physical GPU is recommended. :: -* Local disk space is required for good temporary spooling performance, particularly when performing intensive operations exceeding the available RAM, such as sorting. SQream recommends an SSD or NVMe drive in RAID0 configuration with about twice the RAM size available for temporary storage. This can be shared with the operating system drive if necessary. +* Local disk space is required for good temporary spooling performance, particularly when performing intensive operations exceeding the available RAM, such as sorting. SQreamDB recommends an SSD or NVMe drive in RAID0 configuration with about twice the RAM size available for temporary storage. This can be shared with the operating system drive if necessary. :: -* When using NAS devices, SQream recommends approximately 5GB/s of burst throughput from storage per GPU. +* When using NAS devices, SQreamDB recommends approximately 5GB/s of burst throughput from storage per GPU. Balancing Cost and Performance ------------------------------ -Prior to designing and deploying a SQream cluster, a number of important factors must be considered. +Prior to designing and deploying a SQreamDB cluster, a number of important factors must be considered. The **Balancing Cost and Performance** section provides a breakdown of deployment details to ensure that this installation exceeds or meets the stated requirements. The rationale provided includes the necessary information for modifying configurations to suit the customer use-case scenario, as shown in the following table: @@ -208,26 +210,26 @@ The **Balancing Cost and Performance** section provides a breakdown of deploymen CPU Compute ----------- -SQream relies on multi-core Intel Gold Xeon processors or IBM POWER9 processors and recommends a dual-socket machine populated with CPUs with 18C/36HT or better. While a higher core count may not necessarily affect query performance, more cores will enable higher concurrency and better load performance. +SQreamDB relies on multi-core Intel Gold Xeon processors or IBM POWER9 processors and recommends a dual-socket machine populated with CPUs with 18C/36HT or better. While a higher core count may not necessarily affect query performance, more cores will enable higher concurrency and better load performance. GPU Compute and RAM ------------------- -The NVIDIA Tesla range of high-throughput GPU accelerators provides the best performance for enterprise environments. Most cards have ECC memory, which is crucial for delivering correct results every time. SQream recommends the NVIDIA Tesla A100 80GB GPU for the best performance and highest concurrent user support. +The NVIDIA Tesla range of high-throughput GPU accelerators provides the best performance for enterprise environments. Most cards have ECC memory, which is crucial for delivering correct results every time. SQreamDB recommends the NVIDIA Tesla A100 80GB GPU for the best performance and highest concurrent user support. GPU RAM, sometimes called GRAM or VRAM, is used for processing queries. It is possible to select GPUs with less RAM. However, the smaller GPU RAM results in reduced concurrency, as the GPU RAM is used extensively in operations like JOINs, ORDER BY, GROUP BY, and all SQL transforms. RAM --- -SQream requires using **Error-Correcting Code memory (ECC)**, standard on most enterprise servers. Large amounts of memory are required for improved performance for heavy external operations, such as sorting and joining. +SQreamDB requires using **Error-Correcting Code memory (ECC)**, standard on most enterprise servers. Large amounts of memory are required for improved performance for heavy external operations, such as sorting and joining. -SQream recommends at least 256GB of RAM per GPU on your machine. +SQreamDB recommends at least 256GB of RAM per GPU on your machine. Operating System ---------------- -SQream can run on the following 64-bit Linux operating systems: +SQreamDB can run on the following 64-bit Linux operating systems: * Red Hat Enterprise Linux (RHEL) v7.9 * CentOS v7.9 @@ -237,7 +239,7 @@ SQream can run on the following 64-bit Linux operating systems: Storage ------- -For clustered scale-out installations, SQream relies on NAS storage. For stand-alone installations, SQream relies on redundant disk configurations, such as RAID 5, 6, or 10. These RAID configurations replicate blocks of data between disks to avoid data loss or system unavailability. +For clustered scale-out installations, SQreamDB relies on NAS storage. For stand-alone installations, SQreamDB relies on redundant disk configurations, such as RAID 5, 6, or 10. These RAID configurations replicate blocks of data between disks to avoid data loss or system unavailability. -SQream recommends using enterprise-grade SAS SSD or NVMe drives. For a 32-user configuration, the number of GPUs should roughly match the number of users. SQream recommends 1 Tesla A100 / H100 or L40S GPU per 2 users, for full, uninterrupted dedicated access. +SQreamDB recommends using enterprise-grade SAS SSD or NVMe drives. For a 32-user configuration, the number of GPUs should roughly match the number of users. SQreamDB recommends 1 Tesla A100 / H100 or L40S GPU per 2 users, for full, uninterrupted dedicated access. From 1c3aff80168f02249287a51496c0f43f2b2e5954 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 13 Mar 2024 10:41:56 +0200 Subject: [PATCH 812/882] Update power_bi.rst --- connecting_to_sqream/client_platforms/power_bi.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/connecting_to_sqream/client_platforms/power_bi.rst b/connecting_to_sqream/client_platforms/power_bi.rst index 2c19567d3..d29aca30c 100644 --- a/connecting_to_sqream/client_platforms/power_bi.rst +++ b/connecting_to_sqream/client_platforms/power_bi.rst @@ -20,7 +20,7 @@ SQream integrates with Power BI Desktop to do the following: SQream uses Power BI for extracting data sets using the following methods: -* **Direct query** - Direct queries lets you connect easily with no errors, and refreshes Power BI artifacts, such as graphs and reports, in a considerable amount of time in relation to the time taken for queries to run using the `SQream SQL CLI Reference guide <https://docs.sqream.com/en/v2022.1/reference/cli/sqream_sql.html>`_. +* **Direct query** - Direct queries let you connect easily with no errors, and refresh Power BI artifacts, such as graphs and reports, in a considerable amount of time in relation to the time taken for queries to run using the :ref:`SQream SQL CLI Reference guide <sqream_sql_cli_reference>`. :: From b0aaa27c5d93d99f2f43cf6852155895501d674d Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 18 Mar 2024 14:10:26 +0200 Subject: [PATCH 813/882] Removing _seeing_system_objects_as_ddl: --- operational_guides/index.rst | 1 - .../seeing_system_objects_as_ddl.rst | 171 ------------------ ...ts_and_running_queries_from_the_editor.rst | 2 +- 3 files changed, 1 insertion(+), 173 deletions(-) delete mode 100644 operational_guides/seeing_system_objects_as_ddl.rst diff --git a/operational_guides/index.rst b/operational_guides/index.rst index 989d32435..c73e4eee8 100644 --- a/operational_guides/index.rst +++ b/operational_guides/index.rst @@ -21,7 +21,6 @@ This section summarizes the following operational guides: monitoring_query_performance security saved_queries - seeing_system_objects_as_ddl configuration optimization_best_practices hardware_guide diff --git a/operational_guides/seeing_system_objects_as_ddl.rst b/operational_guides/seeing_system_objects_as_ddl.rst deleted file mode 100644 index 2aacb49e8..000000000 --- a/operational_guides/seeing_system_objects_as_ddl.rst +++ /dev/null @@ -1,171 +0,0 @@ -.. _seeing_system_objects_as_ddl: - -******************************** -Seeing System Objects as DDL -******************************** - -Dump specific objects -=========================== - -Tables ----------- - -See :ref:`get_ddl` for more information. - -.. rubric:: Examples - -Getting the DDL for a table -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -.. code-block:: psql - - farm=> SELECT GET_DDL('cool_animals'); - create table "public"."cool_animals" ( - "id" int not null, - "name" text(30) not null, - "weight" double null, - "is_agressive" bool default false not null ) - ; - -Exporting table DDL to a file -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -.. code-block:: postgres - - COPY (SELECT GET_DDL('cool_animals')) TO '/home/rhendricks/animals.ddl'; - -Views ----------- - -See :ref:`get_view_ddl` for more information. - -.. rubric:: Examples - -Listing all views -^^^^^^^^^^^^^^^^^^^^^^^ - -.. code-block:: psql - - farm=> SELECT view_name FROM sqream_catalog.views; - view_name - ---------------------- - angry_animals - only_agressive_animals - - -Getting the DDL for a view -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -.. code-block:: psql - - farm=> SELECT GET_VIEW_DDL('angry_animals'); - create view "public".angry_animals as - select - "cool_animals"."id" as "id", - "cool_animals"."name" as "name", - "cool_animals"."weight" as "weight", - "cool_animals"."is_agressive" as "is_agressive" - from - "public".cool_animals as cool_animals - where - "cool_animals"."is_agressive" = false; - -Exporting view DDL to a file -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -.. code-block:: postgres - - COPY (SELECT GET_VIEW_DDL('angry_animals')) TO '/home/rhendricks/angry_animals.sql'; - -User defined functions -------------------------- - -See :ref:`get_function_ddl` for more information. - -.. rubric:: Examples - -Listing all UDFs -^^^^^^^^^^^^^^^^^^^^^ - -.. code-block:: psql - - master=> SELECT * FROM sqream_catalog.user_defined_functions; - database_name | function_id | function_name - --------------+-------------+-------------- - master | 1 | my_distance - -Getting the DDL for a function -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -.. code-block:: psql - - master=> SELECT GET_FUNCTION_DDL('my_distance'); - create function "my_distance" (x1 float, - y1 float, - x2 float, - y2 float) returns float as - $$ - import math - if y1 < x1: - return 0.0 - else: - return math.sqrt((y2 - y1) ** 2 + (x2 - x1) ** 2) - $$ - language python volatile; - -Exporting function DDL to a file ------------------------------------- - -.. code-block:: postgres - - COPY (SELECT GET_FUNCTION_DDL('my_distance')) TO '/home/rhendricks/my_distance.sql'; - -Saved queries ------------------ - -See :ref:`list_saved_queries`, :ref:`show_saved_query` for more information. - -Dump entire database DDLs -================================== - -Dumping the database DDL includes tables and views, but not UDFs and saved queries. - -See :ref:`dump_database_ddl` for more information. - -.. rubric:: Examples - -Exporting database DDL to a client ---------------------------------------- - -.. code-block:: psql - - farm=> SELECT DUMP_DATABASE_DDL(); - create table "public"."cool_animals" ( - "id" int not null, - "name" text(30) not null, - "weight" double null, - "is_agressive" bool default false not null - ) - ; - - create view "public".angry_animals as - select - "cool_animals"."id" as "id", - "cool_animals"."name" as "name", - "cool_animals"."weight" as "weight", - "cool_animals"."is_agressive" as "is_agressive" - from - "public".cool_animals as cool_animals - where - "cool_animals"."is_agressive" = false; - -Exporting database DDL to a file ---------------------------------------- - -.. code-block:: postgres - - COPY (SELECT DUMP_DATABASE_DDL()) TO '/home/rhendricks/database.ddl'; - - - -.. note:: To export data in tables, see :ref:`copy_to`. diff --git a/sqream_studio_5.6.0/executing_statements_and_running_queries_from_the_editor.rst b/sqream_studio_5.6.0/executing_statements_and_running_queries_from_the_editor.rst index 2a2a9475e..b310b93bf 100644 --- a/sqream_studio_5.6.0/executing_statements_and_running_queries_from_the_editor.rst +++ b/sqream_studio_5.6.0/executing_statements_and_running_queries_from_the_editor.rst @@ -203,7 +203,7 @@ The database object functions are used to perform the following: * - Drop table statement - Generates a ``DROP`` statement for the selected object in the editing area. * - Table DDL - - Generates a DDL statement for the selected object in the editing area. To get the entire database DDL, click the |icon-ddl-edit| icon next to the database name in the tree root. See `Seeing System Objects as DDL <https://docs.sqream.com/en/latest/operational_guides/seeing_system_objects_as_ddl.html>`_. + - Generates a DDL statement for the selected object in the editing area. To get the entire database DDL, click the |icon-ddl-edit| icon next to the database name in the tree root. * - DDL Optimizer - The `DDL Optimizer <https://docs.sqream.com/en/latest/sqream_studio_5.4.7/executing_statements_and_running_queries_from_the_editor.html#optimizing-database-tables-using-the-ddl-optimizer>`_ lets you analyze database tables and recommends possible optimizations. From 4fc006e9a46fb2cf6b229cae4ff4fe662d4f3277 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 21 Mar 2024 16:13:24 +0200 Subject: [PATCH 814/882] Update 4.3.rst --- releases/4.3.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/releases/4.3.rst b/releases/4.3.rst index b56a89964..eb57a967f 100644 --- a/releases/4.3.rst +++ b/releases/4.3.rst @@ -62,6 +62,8 @@ Known Issues * Performance degradation when using ``VARCHAR`` partition key in a :ref:`Window Functions<window_functions>` expression +* In SQreamDB minor versions 4.3.9 and 4.3.10, granting permissions through the Acceleration Studio might result in an error, even though the permission has been successfully granted. + Version 4.3 resolved Issues --------------------------- From 142c8dc32b94912e5d2aa8a5417d62194e7e9185 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 25 Mar 2024 08:13:44 +0200 Subject: [PATCH 815/882] Update remedying_slow_queries.rst --- troubleshooting/remedying_slow_queries.rst | 128 ++++++++++----------- 1 file changed, 60 insertions(+), 68 deletions(-) diff --git a/troubleshooting/remedying_slow_queries.rst b/troubleshooting/remedying_slow_queries.rst index 2c18f5278..c8e7c5896 100644 --- a/troubleshooting/remedying_slow_queries.rst +++ b/troubleshooting/remedying_slow_queries.rst @@ -4,76 +4,68 @@ Remedying Slow Queries *********************** -The **Remedying Slow Queries** page describes how to troubleshoot the causes of slow queries. - -The following table is a checklist you can use to identify the cause of your slow queries: - -.. list-table:: - :widths: auto - :header-rows: 1 - - * - Step - - Description - - Results - * - 1 - - A single query is slow - - - If a query isn't performing as you expect, follow the :ref:`Query best practices<query_best_practices>` part of the :ref:`sql_best_practices` guide. - - If all queries are slow, continue to step 2. - * - 2 - - All queries on a specific table are slow - - - #. If all queries on a specific table aren't performing as you expect, follow the :ref:`Table design best practices<table_design_best_practices>` part of the :ref:`sql_best_practices` guide. - #. Check for active delete predicates in the table. Consult the :ref:`delete_guide` guide for more information. - - If the problem spans all tables, continue to step 3. - * - 3 - - Check that all workers are up - - - Use ``SELECT show_cluster_nodes();`` to list the active cluster workers. - - If the worker list is incomplete, locate and start the missing worker(s). - - If all workers are up, continue to step 4. - * - 4 - - Check that all workers are performing well - - - #. Identify if a specific worker is slower than others by running the same query on different workers. (e.g. by connecting directly to the worker or through a service queue) - #. If a specific worker is slower than others, investigate performance issues on the host using standard monitoring tools (e.g. ``top``). - #. Restart SQream DB workers on the problematic host. - - If all workers are performing well, continue to step 5. - * - 5 - - Check if the workload is balanced across all workers - - - #. Run the same query several times and check that it appears across multiple workers (use ``SELECT show_server_status()`` to monitor) - #. If some workers have a heavier workload, check the service queue usage. Refer to the :ref:`workload_manager` guide. +This page describes how to troubleshoot the causes of slow queries. + +Slow queries may be the result of various factors, including inefficient query practices, suboptimal table designs, or issues with system resources. If you're experiencing sluggish query performance, it's essential to diagnose and address the underlying causes promptly. + +.. glossary:: + + Step 1: A single query is slow + If a query isn't performing as you expect, follow the :ref:`Query best practices<query_best_practices>` part of the :ref:`sql_best_practices` guide. - If the workload is balanced, continue to step 6. - * - 6 - - Check if there are long running statements - - - #. Identify any currently running statements (use ``SELECT show_server_status()`` to monitor) - #. If there are more statements than available resources, some statements may be in an ``In queue`` mode. - #. If there is a statement that has been running for too long and is blocking the queue, consider stopping it (use ``SELECT stop_statement(<statement id>)``). + If all queries are slow, continue to step 2. + + Step 2: All queries on a specific table are slow + #. If all queries on a specific table aren't performing as you expect, follow the :ref:`Table design best practices<table_design_best_practices>` part of the :ref:`sql_best_practices` guide. + #. Check for active delete predicates in the table. Consult the :ref:`delete_guide` guide for more information. - If the statement does not stop correctly, contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_. + If the problem spans all tables, continue to step 3. + + + Step 3: Check that all workers are up + Use ``SELECT show_cluster_nodes();`` to list the active cluster workers. - If there are no long running statements or this does not help, continue to step 7. - * - 7 - - Check if there are active locks - - - #. Use ``SELECT show_locks()`` to list any outstanding locks. - #. If a statement is locking some objects, consider waiting for that statement to end or stop it. - #. If after a statement is completed the locks don't free up, refer to the :ref:`concurrency_and_locks` guide. + If the worker list is incomplete, locate and start the missing worker(s). - If performance does not improve after the locks are released, continue to step 8. - * - 8 - - Check free memory across hosts - - - #. Check free memory across the hosts by running ``$ free -th`` from the terminal. - #. If the machine has less than 5% free memory, consider **lowering** the ``limitQueryMemoryGB`` and ``spoolMemoryGB`` settings. Refer to the :ref:`spooling` guide. - #. If the machine has a lot of free memory, consider **increasing** the ``limitQueryMemoryGB`` and ``spoolMemoryGB`` settings. + If all workers are up, continue to step 4. + + Step 4: Check that all workers are performing well + + #. Identify if a specific worker is slower than others by running the same query on different workers. (e.g. by connecting directly to the worker or through a service queue) + #. If a specific worker is slower than others, investigate performance issues on the host using standard monitoring tools (e.g. ``top``). + #. Restart SQream DB workers on the problematic host. + + If all workers are performing well, continue to step 5. + + Step 5: Check if the workload is balanced across all workers + + #. Run the same query several times and check that it appears across multiple workers (use ``SELECT show_server_status()`` to monitor) + #. If some workers have a heavier workload, check the service queue usage. Refer to the :ref:`workload_manager` guide. - If performance does not improve, contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_. \ No newline at end of file + If the workload is balanced, continue to step 6. + + Step 6: Check if there are long running statements + + #. Identify any currently running statements (use ``SELECT show_server_status()`` to monitor) + #. If there are more statements than available resources, some statements may be in an ``In queue`` mode. + #. If there is a statement that has been running for too long and is blocking the queue, consider stopping it (use ``SELECT stop_statement(<statement id>)``). + + If the statement does not stop correctly, contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_. + + If there are no long running statements or this does not help, continue to step 7. + + Step 7: Check if there are active locks + + #. Use ``SELECT show_locks()`` to list any outstanding locks. + #. If a statement is locking some objects, consider waiting for that statement to end or stop it. + #. If after a statement is completed the locks don't free up, refer to the :ref:`concurrency_and_locks` guide. + + If performance does not improve after the locks are released, continue to step 8. + + Step 8: Check free memory across hosts + + #. Check free memory across the hosts by running ``$ free -th`` from the terminal. + #. If the machine has less than 5% free memory, consider **lowering** the ``limitQueryMemoryGB`` and ``spoolMemoryGB`` settings. Refer to the :ref:`spooling` guide. + #. If the machine has a lot of free memory, consider **increasing** the ``limitQueryMemoryGB`` and ``spoolMemoryGB`` settings. + + If performance does not improve, contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_. \ No newline at end of file From e43baeff59c56e0217a6079b71074ab5be4aad2c Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 3 Apr 2024 10:50:47 +0300 Subject: [PATCH 816/882] Update create_foreign_table.rst --- .../sql/sql_statements/ddl_commands/create_foreign_table.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst b/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst index c21b5e925..37781b1c3 100644 --- a/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst +++ b/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst @@ -24,7 +24,7 @@ Syntax ) [ FOREIGN DATA ] WRAPPER fdw_name [ OPTIONS ( option_def [, ... ] ) ] - ; + schema_name ::= identifier @@ -83,7 +83,7 @@ Parameters * - ``column_def`` - A comma separated list of column definitions. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally * - ``WRAPPER ...`` - - Specifies the format of the source files, such as ``parquet_fdw``, ``orc_fdw``, or ``csv_fdw`` + - Specifies the format of the source files, such as ``parquet_fdw``, ``orc_fdw``, ``json_fdw``, or ``csv_fdw`` * - ``LOCATION = ...`` - Specifies a path or URI of the source files, such as ``/path/to/*.parquet`` * - ``DELIMITER = ...`` From b4bd10cb131a8c49b5724c798da0a1d1e18e0794 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 4 Apr 2024 11:27:16 +0300 Subject: [PATCH 817/882] Update index.rst --- reference/sql/sql_statements/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/index.rst b/reference/sql/sql_statements/index.rst index 47a26b0a9..32f5b201a 100644 --- a/reference/sql/sql_statements/index.rst +++ b/reference/sql/sql_statements/index.rst @@ -209,7 +209,7 @@ The following table shows the Access Control commands: - Returns a list of permissions required to run a statement or query * - :ref:`grant` - Grant permissions to a role - * - :ref:`GRANT_USAGE_ON_SERVICE_TO_ALL_ROLES` + * - :ref:`grant_usage_on_service_to_all_roles` - Grant service usage permissions * - :ref:`revoke` - Revoke permissions from a role From 1424164e0ac7222f9bf08ba3e6c267daa2024839 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 8 Apr 2024 14:03:07 +0300 Subject: [PATCH 818/882] Update values.rst --- .../sql_statements/dml_commands/values.rst | 116 +++++++++++------- 1 file changed, 69 insertions(+), 47 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/values.rst b/reference/sql/sql_statements/dml_commands/values.rst index 4e8e1f28b..aa8d367e1 100644 --- a/reference/sql/sql_statements/dml_commands/values.rst +++ b/reference/sql/sql_statements/dml_commands/values.rst @@ -1,83 +1,105 @@ .. _values: -********************** +****** VALUES -********************** +****** -``VALUES`` is a table constructor - a clause that can be used to define tabular data. - -.. tip:: - * Use VALUES in conjunction with :ref:`INSERT<insert>` statements to insert a set of one or more rows. - - -Permissions -============= - -This clause requires no special permissions. +``VALUES`` is a table constructor used to define tabular data. It’s utilized with :ref:`INSERT<insert>` statements to insert one or more rows. Syntax -========== +====== .. code-block:: postgres - values_expr ::= VALUES ( value_expr [, ... ] ) [, ... ] - ; -Notes +Usage Notes =========== -Each set of comma-separated ``value_expr`` in parentheses represents a single row in the result set. +.. glossary:: + + ``value_expr`` + Each set of comma-separated ``value_expr`` in parentheses represents a single row in the result set. -Column names of the result table are auto-generated. To rename the column names, add an ``AS`` clause. + **Column Names** + Column names of the result table are auto-generated. To rename the column names, add an ``AS`` clause. + + **Aggregations** + Aggregations (e.g., ``SUM``, ``COUNT``) cannot be directly used in the ``VALUES`` clause. Examples -=========== +======== -Tabular data with VALUES --------------------------- +Tabular data with ``VALUES`` +---------------------------- .. code-block:: psql - master=> VALUES (1,2,3,4), (5,6,7,8), (9,10,11,12); - 1,2,3,4 - 5,6,7,8 - 9,10,11,12 - 3 rows + VALUES (1,2,3,4), (5,6,7,8), (9,10,11,12); -Using VALUES with a SELECT query ----------------------------------- + clmn1 |clmn2 |clmn3 |clmn4 + ------+------+------+----- + 1 | 2 | 3 | 4 + 5 | 6 | 7 | 8 + 9 | 10 | 11 | 12 -To use VALUES in a select query, assign a :ref:`name<identifiers>` to the ``VALUES`` clause with ``AS`` +Using ``VALUES`` in a ``SELECT`` Query +-------------------------------------- .. code-block:: postgres - master=> SELECT t.* FROM (VALUES (1,2,3,'a'), (5,6,7,'b'), (9,10,11,'c')) AS t; - 1,2,3,a - 5,6,7,b - 9,10,11,c - - 3 rows + SELECT + t.* + FROM + ( + VALUES + (1, 2, 3, 'a'), + (5, 6, 7, 'b'), + (9, 10, 11, 'c') + ) AS t; + + clmn1 |clmn2 |clmn3 |clmn4 + ------+------+------+----- + 1 | 2 | 3 | a + 5 | 6 | 7 | b + 9 | 10 | 11 | c You can also use this to rename the columns .. code-block:: postgres - SELECT t.* FROM (VALUES (1,2,3,'a'), (5,6,7,'b'), (9,10,11,'c')) AS t(a,b,c,d); - - -Creating a table with ``VALUES`` + SELECT + t.* + FROM + ( + VALUES + (1, 2, 3, 'a'), + (5, 6, 7, 'b'), + (9, 10, 11, 'c') + ) AS t(a, b, c, d); + +Creating a Table Using ``VALUES`` --------------------------------- Use ``AS`` to assign names to columns .. code-block:: postgres - CREATE TABLE cool_animals AS - (SELECT t.* - FROM (VALUES (1, 'dog'), - (2, 'cat'), - (3, 'horse'), - (4, 'hippopotamus') - ) AS t(id, name) - ); + CREATE TABLE + cool_animals AS ( + SELECTt.* + FROM + ( + VALUES + (1, 'dog'), + (2, 'cat'), + (3, 'horse'), + (4, 'hippopotamus') + ) + AS t(id, name) + ); + +Permissions +=========== + +This clause requires no special permissions. \ No newline at end of file From 5c4ddb0015028c9186c9fe780802099aa5d12e1b Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 8 Apr 2024 15:41:26 +0300 Subject: [PATCH 819/882] Update monitoring_query_performance.rst --- .../monitoring_query_performance.rst | 486 +++++++++--------- 1 file changed, 255 insertions(+), 231 deletions(-) diff --git a/operational_guides/monitoring_query_performance.rst b/operational_guides/monitoring_query_performance.rst index a2ec79564..a17a66dad 100644 --- a/operational_guides/monitoring_query_performance.rst +++ b/operational_guides/monitoring_query_performance.rst @@ -5,7 +5,7 @@ Monitoring Query Performance **************************** When analyzing options for query tuning, the first step is to analyze the query plan and execution. -The query plan and execution details explain how SQream DB processes a query and where time is spent. +The query plan and execution details explain how SQreamDB processes a query and where time is spent. This document details how to analyze query performance with execution plans. This guide focuses specifically on identifying bottlenecks and possible optimization techniques to improve query performance. Performance tuning options for each query are different. You should adapt the recommendations and tips for your own workloads. @@ -19,7 +19,7 @@ See also our :ref:`sql_best_practices` guide for more information about data loa Setting Up the System for Monitoring ==================================== -By default, SQream DB logs execution details for every statement that runs for more than 60 seconds. +By default, SQreamDB logs execution details for every statement that runs for more than 60 seconds. If you want to see the execution details for a currently running statement, see :ref:`using_show_node_info` below. Adjusting the Logging Frequency @@ -28,8 +28,7 @@ Adjusting the Logging Frequency To adjust the frequency of logging for statements, you may want to reduce the interval from 60 seconds down to, say, 5 or 10 seconds. Modify the configuration files and set the ``nodeInfoLoggingSec`` parameter as you see fit: -.. code-block:: sql - +.. code-block:: console :emphasize-lines: 7 { @@ -43,7 +42,7 @@ say, 5 or 10 seconds. Modify the configuration files and set the ``nodeInfoLoggi "server":{ } } -After restarting the SQream DB cluster, the execution plan details will be logged to the :ref:`standard SQream DB logs directory<logging>`, as a message of type ``200``. +After restarting the SQreamDB cluster, the execution plan details will be logged to the :ref:`standard SQreamDB logs directory<logging>`, as a message of type ``200``. You can see these messages with a text viewer or with queries on the log :ref:`foreign_tables`. Reading Execution Plans with a Foreign Table @@ -51,63 +50,67 @@ Reading Execution Plans with a Foreign Table First, create a foreign table for the logs -.. code-block:: sql - - CREATE FOREIGN TABLE logs - ( - start_marker TEXT(4), - row_id BIGINT, - timestamp DATETIME, - message_level TEXT, - thread_id TEXT, - worker_hostname TEXT, - worker_port INT, - connection_id INT, - database_name TEXT, - user_name TEXT, - statement_id INT, - service_name TEXT, - message_type_id INT, - message TEXT, - end_message TEXT(5) - ) - WRAPPER csv_fdw - OPTIONS - ( - LOCATION = '/home/rhendricks/sqream_storage/logs/**/sqream*.log', - DELIMITER = '|' - ) - ; +.. code-block:: postgres + + CREATE FOREIGN TABLE logs ( + start_marker TEXT(4), + row_id BIGINT, + timestamp DATETIME, + message_level TEXT, + thread_id TEXT, + worker_hostname TEXT, + worker_port INT, + connection_id INT, + database_name TEXT, + user_name TEXT, + statement_id INT, + service_name TEXT, + message_type_id INT, + message TEXT, + end_message TEXT(5) + ) + WRAPPER + csv_fdw + OPTIONS + ( + LOCATION = '/home/rhendricks/sqream_storage/logs/**/sqream*.log', + DELIMITER = '|' + ); + Once you've defined the foreign table, you can run queries to observe the previously logged execution plans. This is recommended over looking at the raw logs. -.. code-block:: sql - - t=> SELECT message - . FROM logs - . WHERE message_type_id = 200 - . AND timestamp BETWEEN '2020-06-11' AND '2020-06-13'; - message - --------------------------------------------------------------------------------------------------------------------------------- - SELECT *,coalesce((depdelay > 15),false) AS isdepdelayed FROM ontime WHERE year IN (2005, 2006, 2007, 2008, 2009, 2010) - : - : 1,PushToNetworkQueue ,10354468,10,1035446,2020-06-12 20:41:42,-1,,,,13.55 - : 2,Rechunk ,10354468,10,1035446,2020-06-12 20:41:42,1,,,,0.10 - : 3,ReorderInput ,10354468,10,1035446,2020-06-12 20:41:42,2,,,,0.00 - : 4,DeferredGather ,10354468,10,1035446,2020-06-12 20:41:42,3,,,,1.23 - : 5,ReorderInput ,10354468,10,1035446,2020-06-12 20:41:41,4,,,,0.01 - : 6,GpuToCpu ,10354468,10,1035446,2020-06-12 20:41:41,5,,,,0.07 - : 7,GpuTransform ,10354468,10,1035446,2020-06-12 20:41:41,6,,,,0.02 - : 8,ReorderInput ,10354468,10,1035446,2020-06-12 20:41:41,7,,,,0.00 - : 9,Filter ,10354468,10,1035446,2020-06-12 20:41:41,8,,,,0.07 - : 10,GpuTransform ,10485760,10,1048576,2020-06-12 20:41:41,9,,,,0.07 - : 11,GpuDecompress ,10485760,10,1048576,2020-06-12 20:41:41,10,,,,0.03 - : 12,GpuTransform ,10485760,10,1048576,2020-06-12 20:41:41,11,,,,0.22 - : 13,CpuToGpu ,10485760,10,1048576,2020-06-12 20:41:41,12,,,,0.76 - : 14,ReorderInput ,10485760,10,1048576,2020-06-12 20:41:40,13,,,,0.11 - : 15,Rechunk ,10485760,10,1048576,2020-06-12 20:41:40,14,,,,5.58 - : 16,CpuDecompress ,10485760,10,1048576,2020-06-12 20:41:34,15,,,,0.04 - : 17,ReadTable ,10485760,10,1048576,2020-06-12 20:41:34,16,832MB,,public.ontime,0.55 +.. code-block:: postgres + + SELECT + message + FROM + logs + WHERE + message_type_id = 200 + AND timestamp BETWEEN '2020-06-11' AND '2020-06-13'; + + message + --------------------------------------------------------------------------------------------------------------------------------- + SELECT *,coalesce((depdelay > 15),false) AS isdepdelayed FROM ontime WHERE year IN (2005, 2006, 2007, 2008, 2009, 2010) + + 1,PushToNetworkQueue ,10354468,10,1035446,2020-06-12 20:41:42,-1,,,,13.55 + 2,Rechunk ,10354468,10,1035446,2020-06-12 20:41:42,1,,,,0.10 + 3,ReorderInput ,10354468,10,1035446,2020-06-12 20:41:42,2,,,,0.00 + 4,DeferredGather ,10354468,10,1035446,2020-06-12 20:41:42,3,,,,1.23 + 5,ReorderInput ,10354468,10,1035446,2020-06-12 20:41:41,4,,,,0.01 + 6,GpuToCpu ,10354468,10,1035446,2020-06-12 20:41:41,5,,,,0.07 + 7,GpuTransform ,10354468,10,1035446,2020-06-12 20:41:41,6,,,,0.02 + 8,ReorderInput ,10354468,10,1035446,2020-06-12 20:41:41,7,,,,0.00 + 9,Filter ,10354468,10,1035446,2020-06-12 20:41:41,8,,,,0.07 + 10,GpuTransform ,10485760,10,1048576,2020-06-12 20:41:41,9,,,,0.07 + 11,GpuDecompress ,10485760,10,1048576,2020-06-12 20:41:41,10,,,,0.03 + 12,GpuTransform ,10485760,10,1048576,2020-06-12 20:41:41,11,,,,0.22 + 13,CpuToGpu ,10485760,10,1048576,2020-06-12 20:41:41,12,,,,0.76 + 14,ReorderInput ,10485760,10,1048576,2020-06-12 20:41:40,13,,,,0.11 + 15,Rechunk ,10485760,10,1048576,2020-06-12 20:41:40,14,,,,5.58 + 16,CpuDecompress ,10485760,10,1048576,2020-06-12 20:41:34,15,,,,0.04 + 17,ReadTable ,10485760,10,1048576,2020-06-12 20:41:34,16,832MB,,public.ontime,0.55 .. _using_show_node_info: @@ -121,22 +124,24 @@ To inspect a currently running statement, execute the ``show_node_info`` utility In this example, we inspect a statement with statement ID of 176. The command looks like this: -.. code-block:: sql - - t=> SELECT SHOW_NODE_INFO(176); - stmt_id | node_id | node_type | rows | chunks | avg_rows_in_chunk | time | parent_node_id | read | write | comment | timeSum - --------+---------+--------------------+------+--------+-------------------+---------------------+----------------+------+-------+------------+-------- - 176 | 1 | PushToNetworkQueue | 1 | 1 | 1 | 2019-12-25 23:53:13 | -1 | | | | 0.0025 - 176 | 2 | Rechunk | 1 | 1 | 1 | 2019-12-25 23:53:13 | 1 | | | | 0 - 176 | 3 | GpuToCpu | 1 | 1 | 1 | 2019-12-25 23:53:13 | 2 | | | | 0 - 176 | 4 | ReorderInput | 1 | 1 | 1 | 2019-12-25 23:53:13 | 3 | | | | 0 - 176 | 5 | Filter | 1 | 1 | 1 | 2019-12-25 23:53:13 | 4 | | | | 0.0002 - 176 | 6 | GpuTransform | 457 | 1 | 457 | 2019-12-25 23:53:13 | 5 | | | | 0.0002 - 176 | 7 | GpuDecompress | 457 | 1 | 457 | 2019-12-25 23:53:13 | 6 | | | | 0 - 176 | 8 | CpuToGpu | 457 | 1 | 457 | 2019-12-25 23:53:13 | 7 | | | | 0.0003 - 176 | 9 | Rechunk | 457 | 1 | 457 | 2019-12-25 23:53:13 | 8 | | | | 0 - 176 | 10 | CpuDecompress | 457 | 1 | 457 | 2019-12-25 23:53:13 | 9 | | | | 0 - 176 | 11 | ReadTable | 457 | 1 | 457 | 2019-12-25 23:53:13 | 10 | 4MB | | public.nba | 0.0004 +.. code-block:: postgres + + SELECT + SHOW_NODE_INFO(176); + + stmt_id | node_id | node_type | rows | chunks | avg_rows_in_chunk | time | parent_node_id | read | write | comment | timeSum + --------+---------+--------------------+------+--------+-------------------+---------------------+----------------+------+-------+------------+-------- + 176 | 1 | PushToNetworkQueue | 1 | 1 | 1 | 2019-12-25 23:53:13 | -1 | | | | 0.0025 + 176 | 2 | Rechunk | 1 | 1 | 1 | 2019-12-25 23:53:13 | 1 | | | | 0 + 176 | 3 | GpuToCpu | 1 | 1 | 1 | 2019-12-25 23:53:13 | 2 | | | | 0 + 176 | 4 | ReorderInput | 1 | 1 | 1 | 2019-12-25 23:53:13 | 3 | | | | 0 + 176 | 5 | Filter | 1 | 1 | 1 | 2019-12-25 23:53:13 | 4 | | | | 0.0002 + 176 | 6 | GpuTransform | 457 | 1 | 457 | 2019-12-25 23:53:13 | 5 | | | | 0.0002 + 176 | 7 | GpuDecompress | 457 | 1 | 457 | 2019-12-25 23:53:13 | 6 | | | | 0 + 176 | 8 | CpuToGpu | 457 | 1 | 457 | 2019-12-25 23:53:13 | 7 | | | | 0.0003 + 176 | 9 | Rechunk | 457 | 1 | 457 | 2019-12-25 23:53:13 | 8 | | | | 0 + 176 | 10 | CpuDecompress | 457 | 1 | 457 | 2019-12-25 23:53:13 | 9 | | | | 0 + 176 | 11 | ReadTable | 457 | 1 | 457 | 2019-12-25 23:53:13 | 10 | 4MB | | public.nba | 0.0004 Alternatively, you may also :ref:`retrieve the query execution plan output<retrieving_execution_plan_output_using_studio>` using SQreamDB Studio, and contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_. @@ -323,7 +328,7 @@ In the following examples you will learn how to identify and solve some common i Spooling to Disk ---------------- -When there is not enough RAM to process a statement, SQream DB will spill over data to the ``temp`` folder in the storage disk. +When there is not enough RAM to process a statement, SQreamDB will spill over data to the ``temp`` folder in the storage disk. While this ensures that a statement can always finish processing, it can slow down the processing significantly. It's worth identifying these statements, to figure out if the cluster is configured correctly, as well as potentially reduce the statement size. @@ -339,24 +344,38 @@ Identifying the Offending Nodes For example, a query from the TPC-H benchmark: - .. code-block:: sql + .. code-block:: postgres - SELECT o_year, - SUM(CASE WHEN nation = 'BRAZIL' THEN volume ELSE 0 END) / SUM(volume) AS mkt_share - FROM (SELECT datepart(YEAR,o_orderdate) AS o_year, - l_extendedprice*(1 - l_discount / 100.0) AS volume, - n2.n_name AS nation - FROM lineitem - JOIN part ON p_partkey = CAST (l_partkey AS INT) - JOIN orders ON l_orderkey = o_orderkey - JOIN customer ON o_custkey = c_custkey - JOIN nation n1 ON c_nationkey = n1.n_nationkey - JOIN region ON n1.n_regionkey = r_regionkey - JOIN supplier ON s_suppkey = l_suppkey - JOIN nation n2 ON s_nationkey = n2.n_nationkey - WHERE o_orderdate BETWEEN '1995-01-01' AND '1996-12-31') AS all_nations - GROUP BY o_year - ORDER BY o_year; + SELECT + o_year, + SUM( + CASE + WHEN nation = 'BRAZIL' THEN volume + ELSE 0 + END + ) / SUM(volume) AS mkt_share + FROM + ( + SELECT + datepart(YEAR, o_orderdate) AS o_year, + l_extendedprice * (1 - l_discount / 100.0) AS volume, + n2.n_name AS nation + FROM + lineitem + JOIN part ON p_partkey = CAST (l_partkey AS INT) + JOIN orders ON l_orderkey = o_orderkey + JOIN customer ON o_custkey = c_custkey + JOIN nation n1 ON c_nationkey = n1.n_nationkey + JOIN region ON n1.n_regionkey = r_regionkey + JOIN supplier ON s_suppkey = l_suppkey + JOIN nation n2 ON s_nationkey = n2.n_nationkey + WHERE + o_orderdate BETWEEN '1995-01-01' AND '1996-12-31' + ) AS all_nations + GROUP BY + o_year + ORDER BY + o_year; #. Observe the execution information by using the foreign table, or use ``show_node_info`` @@ -365,11 +384,10 @@ Identifying the Offending Nodes The execution below has been shortened, but note the highlighted rows for ``LoopJoin``: - .. code-block:: sql + .. code-block:: postgres + :emphasize-lines: 33,35,37,39 - :emphasize-lines: 33,35,37,39 - - t=> SELECT message FROM logs WHERE message_type_id = 200 LIMIT 1; + SELECT message FROM logs WHERE message_type_id = 200 LIMIT 1; message ----------------------------------------------------------------------------------------- SELECT o_year, @@ -410,7 +428,7 @@ Identifying the Offending Nodes : 150,LoopJoin ,182369485,10,18236948,2020-09-04 18:31:47,149,12860MB,12860MB,inner,23.62 [...] : 199,ReadTable ,20000000,1,20000000,2020-09-04 18:30:33,198,0MB,,public.part,0.83 - Because of the relatively low amount of RAM in the machine and because the data set is rather large at around 10TB, SQream DB needs to spool. + Because of the relatively low amount of RAM in the machine and because the data set is rather large at around 10TB, SQreamDB needs to spool. The total spool used by this query is around 20GB (1915MB + 2191MB + 3064MB + 12860MB). @@ -419,7 +437,7 @@ Common Solutions for Reducing Spool * Increase the amount of spool memory available for the workers, as a proportion of the maximum statement memory. - When the amount of spool memory is increased, SQream DB may not need to write to disk. + When the amount of spool memory is increased, SQreamDB may not need to write to disk. This setting is called ``spoolMemoryGB``. Refer to the :ref:`configuration` guide. * @@ -440,27 +458,30 @@ Identifying the Offending Nodes For example, a modified query from the TPC-H benchmark: - .. code-block:: sql + .. code-block:: postgres - SELECT s.*, - l.*, - r.*, - n1.*, - n2.*, - p.*, - o.*, - c.* - FROM lineitem l - JOIN part p ON p_partkey = CAST (l_partkey AS INT) - JOIN orders o ON l_orderkey = o_orderkey - JOIN customer c ON o_custkey = c_custkey - JOIN nation n1 ON c_nationkey = n1.n_nationkey - JOIN region r ON n1.n_regionkey = r_regionkey - JOIN supplier s ON s_suppkey = l_suppkey - JOIN nation n2 ON s_nationkey = n2.n_nationkey - WHERE r_name = 'AMERICA' - AND o_orderdate BETWEEN '1995-01-01' AND '1996-12-31' - AND high_selectivity(p_type = 'ECONOMY BURNISHED NICKEL'); + SELECT + s.*, + l.*, + r.*, + n1.*, + n2.*, + p.*, + o.*, + c.* + FROM + lineitem l + JOIN part p ON p_partkey = CAST (l_partkey AS INT) + JOIN orders o ON l_orderkey = o_orderkey + JOIN customer c ON o_custkey = c_custkey + JOIN nation n1 ON c_nationkey = n1.n_nationkey + JOIN region r ON n1.n_regionkey = r_regionkey + JOIN supplier s ON s_suppkey = l_suppkey + JOIN nation n2 ON s_nationkey = n2.n_nationkey + WHERE + r_name = 'AMERICA' + AND o_orderdate BETWEEN '1995-01-01' AND '1996-12-31' + AND high_selectivity(p_type = 'ECONOMY BURNISHED NICKEL'); #. Observe the execution information by using the foreign table, or use ``show_node_info`` @@ -469,23 +490,22 @@ Identifying the Offending Nodes The execution below has been shortened, but note the highlighted rows for ``DeferredGather``: - .. code-block:: sql - + .. code-block:: postgres :emphasize-lines: 7,9,11 - t=> SELECT show_node_info(494); - stmt_id | node_id | node_type | rows | chunks | avg_rows_in_chunk | time | parent_node_id | read | write | comment | timeSum - --------+---------+----------------------+-----------+--------+-------------------+---------------------+----------------+---------+-------+-----------------+-------- - 494 | 1 | PushToNetworkQueue | 242615 | 1 | 242615 | 2020-09-04 19:07:55 | -1 | | | | 0.36 - 494 | 2 | Rechunk | 242615 | 1 | 242615 | 2020-09-04 19:07:55 | 1 | | | | 0 - 494 | 3 | ReorderInput | 242615 | 1 | 242615 | 2020-09-04 19:07:55 | 2 | | | | 0 - 494 | 4 | DeferredGather | 242615 | 1 | 242615 | 2020-09-04 19:07:55 | 3 | | | | 0.16 - [...] - 494 | 166 | DeferredGather | 3998730 | 39 | 102531 | 2020-09-04 19:07:47 | 165 | | | | 21.75 - [...] - 494 | 194 | DeferredGather | 133241 | 20 | 6662 | 2020-09-04 19:07:03 | 193 | | | | 0.41 - [...] - 494 | 221 | ReadTable | 20000000 | 20 | 1000000 | 2020-09-04 19:07:01 | 220 | 20MB | | public.part | 0.1 + SELECT show_node_info(494); + stmt_id | node_id | node_type | rows | chunks | avg_rows_in_chunk | time | parent_node_id | read | write | comment | timeSum + --------+---------+----------------------+-----------+--------+-------------------+---------------------+----------------+---------+-------+-----------------+-------- + 494 | 1 | PushToNetworkQueue | 242615 | 1 | 242615 | 2020-09-04 19:07:55 | -1 | | | | 0.36 + 494 | 2 | Rechunk | 242615 | 1 | 242615 | 2020-09-04 19:07:55 | 1 | | | | 0 + 494 | 3 | ReorderInput | 242615 | 1 | 242615 | 2020-09-04 19:07:55 | 2 | | | | 0 + 494 | 4 | DeferredGather | 242615 | 1 | 242615 | 2020-09-04 19:07:55 | 3 | | | | 0.16 + [...] + 494 | 166 | DeferredGather | 3998730 | 39 | 102531 | 2020-09-04 19:07:47 | 165 | | | | 21.75 + [...] + 494 | 194 | DeferredGather | 133241 | 20 | 6662 | 2020-09-04 19:07:03 | 193 | | | | 0.41 + [...] + 494 | 221 | ReadTable | 20000000 | 20 | 1000000 | 2020-09-04 19:07:01 | 220 | 20MB | | public.part | 0.1 When you see ``DeferredGather`` operations taking more than a few seconds, that's a sign that you're selecting too much data. In this case, the DeferredGather with node ID 166 took over 21 seconds. @@ -493,12 +513,13 @@ Identifying the Offending Nodes #. Modify the statement to see the difference Altering the select clause to be more restrictive will reduce the deferred gather time back to a few milliseconds. - .. code-block:: sql + .. code-block:: postgres - SELECT DATEPART(year, o_orderdate) AS o_year, - l_extendedprice * (1 - l_discount / 100.0) as volume, - n2.n_name as nation - FROM ... + SELECT + DATEPART(year, o_orderdate) AS o_year, + l_extendedprice * (1 - l_discount / 100.0) as volume, + n2.n_name as nation + FROM ... Common Solutions for Reducing Gather Time ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -509,8 +530,8 @@ Common Solutions for Reducing Gather Time Inefficient Filtering --------------------- -When running statements, SQream DB tries to avoid reading data that is not needed for the statement by :ref:`skipping chunks<chunks_and_extents>`. -If statements do not include efficient filtering, SQream DB will read a lot of data off disk. +When running statements, SQreamDB tries to avoid reading data that is not needed for the statement by :ref:`skipping chunks<chunks_and_extents>`. +If statements do not include efficient filtering, SQreamDB will read a lot of data off disk. In some cases, you need the data and there's nothing to do about it. However, if most of it gets pruned further down the line, it may be efficient to skip reading the data altogether by using the :ref:`metadata<metadata_system>`. @@ -526,39 +547,52 @@ For example: In this example, we execute a modified query from the TPC-H benchmark. Our ``lineitem`` table contains 600,037,902 rows. - .. code-block:: sql + .. code-block:: postgres - SELECT o_year, - SUM(CASE WHEN nation = 'BRAZIL' THEN volume ELSE 0 END) / SUM(volume) AS mkt_share - FROM (SELECT datepart(YEAR,o_orderdate) AS o_year, - l_extendedprice*(1 - l_discount / 100.0) AS volume, - n2.n_name AS nation - FROM lineitem - JOIN part ON p_partkey = CAST (l_partkey AS INT) - JOIN orders ON l_orderkey = o_orderkey - JOIN customer ON o_custkey = c_custkey - JOIN nation n1 ON c_nationkey = n1.n_nationkey - JOIN region ON n1.n_regionkey = r_regionkey - JOIN supplier ON s_suppkey = l_suppkey - JOIN nation n2 ON s_nationkey = n2.n_nationkey - WHERE r_name = 'AMERICA' - AND lineitem.l_quantity = 3 - AND o_orderdate BETWEEN '1995-01-01' AND '1996-12-31' - AND high_selectivity(p_type = 'ECONOMY BURNISHED NICKEL')) AS all_nations - GROUP BY o_year - ORDER BY o_year; + SELECT + o_year, + SUM( + CASE + WHEN nation = 'BRAZIL' THEN volume + ELSE 0 + END + ) / SUM(volume) AS mkt_share + FROM + ( + SELECT + datepart(YEAR, o_orderdate) AS o_year, + l_extendedprice * (1 - l_discount / 100.0) AS volume, + n2.n_name AS nation + FROM + lineitem + JOIN part ON p_partkey = CAST (l_partkey AS INT) + JOIN orders ON l_orderkey = o_orderkey + JOIN customer ON o_custkey = c_custkey + JOIN nation n1 ON c_nationkey = n1.n_nationkey + JOIN region ON n1.n_regionkey = r_regionkey + JOIN supplier ON s_suppkey = l_suppkey + JOIN nation n2 ON s_nationkey = n2.n_nationkey + WHERE + r_name = 'AMERICA' + AND lineitem.l_quantity = 3 + AND o_orderdate BETWEEN '1995-01-01' AND '1996-12-31' + AND high_selectivity(p_type = 'ECONOMY BURNISHED NICKEL') + ) AS all_nations + GROUP BY + o_year + ORDER BY + o_year; #. Observe the execution information by using the foreign table, or use ``show_node_info`` The execution below has been shortened, but note the highlighted rows for ``ReadTable`` and ``Filter``: - .. code-block:: sql - + .. code-block:: postgres :linenos: :emphasize-lines: 9,17,19,27 - t=> SELECT show_node_info(559); + SELECT show_node_info(559); stmt_id | node_id | node_type | rows | chunks | avg_rows_in_chunk | time | parent_node_id | read | write | comment | timeSum --------+---------+----------------------+-----------+--------+-------------------+---------------------+----------------+--------+-------+-----------------+-------- 559 | 1 | PushToNetworkQueue | 2 | 1 | 2 | 2020-09-07 11:12:01 | -1 | | | | 0.28 @@ -597,10 +631,9 @@ For example: of the data, but the entire table was read. However, this table is small enough that we can ignore it. #. Modify the statement to see the difference - Altering the statement to have a ``WHERE`` condition on the clustered ``l_orderkey`` column of the ``lineitem`` table will help SQream DB skip reading the data. - - .. code-block:: sql + Altering the statement to have a ``WHERE`` condition on the clustered ``l_orderkey`` column of the ``lineitem`` table will help SQreamDB skip reading the data. + .. code-block:: postgres :emphasize-lines: 15 SELECT o_year, @@ -623,12 +656,11 @@ For example: GROUP BY o_year ORDER BY o_year; - .. code-block:: sql - + .. code-block:: postgres :linenos: :emphasize-lines: 5,13 - t=> SELECT show_node_info(586); + SELECT show_node_info(586); stmt_id | node_id | node_type | rows | chunks | avg_rows_in_chunk | time | parent_node_id | read | write | comment | timeSum --------+---------+----------------------+-----------+--------+-------------------+---------------------+----------------+--------+-------+-----------------+-------- [...] @@ -665,7 +697,7 @@ Identifying the Situation When a join is inefficient, you may note that a query spends a lot of time on the ``Join`` node. For example, consider these two table structures: -.. code-block:: sql +.. code-block:: postgres CREATE TABLE t_a ( @@ -687,7 +719,7 @@ For example, consider these two table structures: In this example, we will join ``t_a.fk`` with ``t_b.id``, both of which are ``TEXT(50)``. - .. code-block:: sql + .. code-block:: postgres SELECT AVG(t_b.j :: BIGINT), t_a.country_code @@ -702,12 +734,11 @@ For example, consider these two table structures: The ``Join`` node is by far the most time-consuming part of this statement - clocking in at 69.7 seconds joining 1.5 billion records. - .. code-block:: sql - + .. code-block:: postgres :linenos: :emphasize-lines: 8 - t=> SELECT show_node_info(5); + SELECT show_node_info(5); stmt_id | node_id | node_type | rows | chunks | avg_rows_in_chunk | time | parent_node_id | read | write | comment | timeSum --------+---------+----------------------+------------+--------+-------------------+---------------------+----------------+-------+-------+------------+-------- [...] @@ -733,7 +764,7 @@ Improving Query Performance For example: - .. code-block:: sql + .. code-block:: postgres SELECT AVG(t_b.j::BIGINT), t_a.country_code FROM "public"."t_a" @@ -743,12 +774,11 @@ Improving Query Performance The execution below has been shortened, but note the highlighted rows for ``Join``. The ``Join`` node went from taking nearly 70 seconds, to just 6.67 seconds for joining 1.5 billion records. - .. code-block:: sql - + .. code-block:: postgres :linenos: :emphasize-lines: 8 - t=> SELECT show_node_info(6); + SELECT show_node_info(6); stmt_id | node_id | node_type | rows | chunks | avg_rows_in_chunk | time | parent_node_id | read | write | comment | timeSum --------+---------+----------------------+------------+--------+-------------------+---------------------+----------------+-------+-------+------------+-------- [...] @@ -768,7 +798,7 @@ Improving Query Performance Sorting on big ``TEXT`` fields ------------------------------ -In general, SQream DB automatically inserts a ``Sort`` node which arranges the data prior to reductions and aggregations. +In general, SQreamDB automatically inserts a ``Sort`` node which arranges the data prior to reductions and aggregations. When running a ``GROUP BY`` on large ``TEXT`` fields, you may see nodes for ``Sort`` and ``Reduce`` taking a long time. Identifying the Situation @@ -783,8 +813,7 @@ For example: Our ``t_inefficient`` table contains 60,000,000 rows, and the structure is simple, but with an oversized ``country_code`` column: - .. code-block:: sql - + .. code-block:: postgres :emphasize-lines: 5 CREATE TABLE t_inefficient ( @@ -798,14 +827,14 @@ For example: We will run a query, and inspect it's execution details: - .. code-block:: psql + .. code-block:: postgres - t=> SELECT country_code, - . SUM(amt) - . FROM t_inefficient - . GROUP BY country_code; - executed - time: 47.55s + SELECT + country_code, + SUM(amt) + FROM t_inefficient + GROUP BY country_code; + country_code | sum -------------+----------- @@ -815,11 +844,10 @@ For example: [...] - .. code-block:: sql - + .. code-block:: postgres :emphasize-lines: 8,9 - t=> select show_node_info(30); + SELECT SHOW_NODE_INFO(30); stmt_id | node_id | node_type | rows | chunks | avg_rows_in_chunk | time | parent_node_id | read | write | comment | timeSum --------+---------+--------------------+----------+--------+-------------------+---------------------+----------------+-------+-------+----------------------+-------- 30 | 1 | PushToNetworkQueue | 249 | 1 | 249 | 2020-09-10 16:17:10 | -1 | | | | 0.25 @@ -837,9 +865,9 @@ For example: #. We can look to see if there's any shrinking we can do on the ``GROUP BY`` key - .. code-block:: sql + .. code-block:: postgres - t=> SELECT MAX(LEN(country_code)) FROM t_inefficient; + SELECT MAX(LEN(country_code)) FROM t_inefficient; max --- 3 @@ -847,24 +875,22 @@ For example: #. We can recreate the table with a more restrictive ``TEXT(3)``, and can examine the difference in performance: - .. code-block:: sql + .. code-block:: postgres - t=> CREATE TABLE t_efficient - . AS SELECT i, - . amt, - . ts, - . country_code::TEXT(3) AS country_code, - . flag - . FROM t_inefficient; - executed - time: 16.03s + CREATE TABLE t_efficient + AS SELECT i, + amt, + ts, + country_code::TEXT(3) AS country_code, + flag + FROM t_inefficient; - t=> SELECT country_code, - . SUM(amt::bigint) - . FROM t_efficient - . GROUP BY country_code; - executed - time: 4.75s + SELECT + country_code, + SUM(amt::bigint) + FROM t_efficient + GROUP BY country_code; + country_code | sum -------------+----------- VUT | 1195416012 @@ -888,11 +914,11 @@ High Selectivity Data --------------------- Selectivity is the ratio of cardinality to the number of records of a chunk. We define selectivity as :math:`\frac{\text{Distinct values}}{\text{Total number of records in a chunk}}` -SQream DB has a hint called ``HIGH_SELECTIVITY``, which is a function you can wrap a condition in. -The hint signals to SQream DB that the result of the condition will be very sparse, and that it should attempt to rechunk +SQreamDB has a hint called ``HIGH_SELECTIVITY``, which is a function you can wrap a condition in. +The hint signals to SQreamDB that the result of the condition will be very sparse, and that it should attempt to rechunk the results into fewer, fuller chunks. .. note:: - SQream DB doesn't do this automatically because it adds a significant overhead on naturally ordered and + SQreamDB doesn't do this automatically because it adds a significant overhead on naturally ordered and well-clustered data, which is the more common scenario. Identifying the Situation @@ -901,9 +927,9 @@ Identifying the Situation This is easily identifiable - when the amount of average of rows in a chunk is small, following a ``Filter`` operation. Consider this execution plan: -.. code-block:: sql +.. code-block:: postgres - t=> select show_node_info(30); + SELECT SHOW_NODE_INFO(30); stmt_id | node_id | node_type | rows | chunks | avg_rows_in_chunk | time | parent_node_id | read | write | comment | timeSum --------+---------+-------------------+-----------+--------+-------------------+---------------------+----------------+-------+-------+------------+-------- [...] @@ -935,11 +961,10 @@ In this case, we're also interested in the number of chunks produced by these no Consider this execution plan: -.. code-block:: sql - +.. code-block:: postgres :emphasize-lines: 6,11 - t=> select show_node_info(30); + SELECT SHOW_NODE_INFO(30); stmt_id | node_id | node_type | rows | chunks | avg_rows_in_chunk | time | parent_node_id | read | write | comment | timeSum --------+---------+-------------------+-----------+--------+-------------------+---------------------+----------------+-------+-------+------------+-------- [...] @@ -954,6 +979,7 @@ Consider this execution plan: 30 | 38 | Filter | 18160 | 74 | 245 | 2020-09-10 12:17:09 | 37 | | | | 0.012 [...] 30 | 44 | ReadTable | 77000000 | 74 | 1040540 | 2020-09-10 12:17:09 | 43 | 277MB | | public.dim | 0.058 + * ``Join`` is the node that matches rows from both table relations. * ``DeferredGather`` gathers the required column chunks to decompress Pay special attention to the volume of data removed by the ``Filter`` node. @@ -964,30 +990,29 @@ All of these rows could fit in one single chunk, instead of spanning 74 rather s Improving Join Performance when Data is Sparse ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -You can tell SQream DB to reduce the amount of chunks involved, if you know that the filter is going to be quite +You can tell SQreamDB to reduce the amount of chunks involved, if you know that the filter is going to be quite agressive by using the :ref:`HIGH_SELECTIVITY<high_selectivity>` hint described :ref:`above<high_selectivity_data_opt>`. This forces the compiler to rechunk the data into fewer chunks. -To tell SQream DB to rechunk the data, wrap a condition (or several) in the ``HIGH_SELECTIVITY`` hint: - -.. code-block:: sql +To tell SQreamDB to rechunk the data, wrap a condition (or several) in the ``HIGH_SELECTIVITY`` hint: +.. code-block:: postgres :emphasize-lines: 13 -- Without the hint SELECT * FROM cdrs WHERE - RequestReceiveTime BETWEEN '2018-01-01 00:00:00.000' AND '2018-08-31 23:59:59.999' - AND EnterpriseID=1150 - AND MSISDN='9724871140341'; + RequestReceiveTime BETWEEN '2018-01-01 00:00:00.000' AND '2018-08-31 23:59:59.999' + AND EnterpriseID=1150 + AND MSISDN='9724871140341'; -- With the hint SELECT * FROM cdrs WHERE - HIGH_SELECTIVITY(RequestReceiveTime BETWEEN '2018-01-01 00:00:00.000' AND '2018-08-31 23:59:59.999') - AND EnterpriseID=1150 - AND MSISDN='9724871140341'; + HIGH_SELECTIVITY(RequestReceiveTime BETWEEN '2018-01-01 00:00:00.000' AND '2018-08-31 23:59:59.999') + AND EnterpriseID=1150 + AND MSISDN='9724871140341'; Manual Join Reordering ---------------------- @@ -1009,8 +1034,7 @@ Always prefer to join the smallest tables first. Changing the join order can reduce the query runtime significantly. In the examples below, we reduce the time from 27.3 seconds to just 6.4 seconds. -.. code-block:: sql - +.. code-block:: postgres :caption: Original query -- This variant runs in 27.3 seconds @@ -1029,7 +1053,7 @@ from 27.3 seconds to just 6.4 seconds. AND l_shipdate <= dateadd(DAY,122,'1994-01-01') GROUP BY c_nationkey -.. code-block:: sql +.. code-block:: postgres :caption: Modified query with improved join order From 8953183f59fa6417bfb0d69f8a79fc9a12c850a3 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 11 Apr 2024 16:22:15 +0300 Subject: [PATCH 820/882] Remove old COPY TO syntax --- .../utility_commands/dump_database_ddl.rst | 101 ++++++++---------- .../utility_commands/get_ddl.rst | 96 +++++++++-------- .../utility_commands/get_function_ddl.rst | 87 ++++++++------- .../get_role_database_ddl.rst | 46 +++----- .../utility_commands/get_view_ddl.rst | 95 ++++++++-------- 5 files changed, 202 insertions(+), 223 deletions(-) diff --git a/reference/sql/sql_statements/utility_commands/dump_database_ddl.rst b/reference/sql/sql_statements/utility_commands/dump_database_ddl.rst index fc9ca1282..2be276ef7 100644 --- a/reference/sql/sql_statements/utility_commands/dump_database_ddl.rst +++ b/reference/sql/sql_statements/utility_commands/dump_database_ddl.rst @@ -4,75 +4,66 @@ DUMP_DATABASE_DDL ***************** -``DUMP_DATABASE_DDL()`` is a function that shows the ``CREATE`` statements for database objects including views and tables. Begining with 2020.3.1, DUMP_DATABASE_DDL includes foreign tables in the output. - -.. warning:: - This function does not currently show UDFs. To list available UDFs, use the catalog: - - .. code-block:: psql - - farm=> SELECT * FROM sqream_catalog.user_defined_functions; - farm,1,my_distance - - Then, export UDFs one-by-one using :ref:`GET_FUNCTION_DDL<get_function_ddl>`. - -.. tip:: - * For just tables, see :ref:`GET_DDL<get_ddl>`. - * For just views, see :ref:`GET_VIEW_DDL<get_view_ddl>`. - * For UDFs, see :ref:`GET_FUNCTION_DDL<get_function_ddl>`. - -Permissions -============= - -The role must have the ``CONNECT`` permission at the database level. +``DUMP_DATABASE_DDL()`` is a function that shows the ``CREATE`` statements for database objects including views and tables. Syntax -========== +====== .. code-block:: postgres - dump_database_ddl_statement ::= - SELECT DUMP_DATABASE_DDL() - ; + SELECT DUMP_DATABASE_DDL() -Parameters -============ +Examples +======== -This function accepts no parameters. +.. code-block:: postgres -Examples -=========== + SELECT + DUMP_DATABASE_DDL(); -Getting the DDL for a database ---------------------------------- +Exporting database DDL to a file +-------------------------------- -.. code-block:: psql +.. code-block:: postgres - farm=> SELECT DUMP_DATABASE_DDL(); - create table "public"."cool_animals" ( - "id" int not null, - "name" text(30) not null, - "weight" double null, - "is_agressive" bool default false not null - ) - ; + COPY + ( + SELECT + DUMP_DATABASE_DDL() + ) TO + WRAPPER + csv_fdw + OPTIONS + (LOCATION = 's3://sqream-docs/database.ddl'); + +Showing the ``CREATE`` Statements for UDFs +------------------------------------------ + +``DUMP_DATABASE_DDL`` does not show UDFs. + +To list available UDFs: + +#. Retrieve UDFs from catalog: + + .. code-block:: postgres - create view "public".angry_animals as - select - "cool_animals"."id" as "id", - "cool_animals"."name" as "name", - "cool_animals"."weight" as "weight", - "cool_animals"."is_agressive" as "is_agressive" - from - "public".cool_animals as cool_animals - where - "cool_animals"."is_agressive" = false; + SELECT + * + FROM + sqream_catalog.user_defined_functions; + Output: + .. code-block:: console -Exporting database DDL to a file ------------------------------------- + database_name|function_id|function_name| + -------------+-----------+-------------+ + master | 0|add_months | + master | 2|my_distance | + +#. Export UDFs one-by-one using :ref:`GET_FUNCTION_DDL<get_function_ddl>`. -.. code-block:: postgres +Permissions +=========== - COPY (SELECT DUMP_DATABASE_DDL()) TO '/home/rhendricks/database.ddl'; +The role must have the ``CONNECT`` permission at the database level. \ No newline at end of file diff --git a/reference/sql/sql_statements/utility_commands/get_ddl.rst b/reference/sql/sql_statements/utility_commands/get_ddl.rst index bc3b9ef54..07a25951a 100644 --- a/reference/sql/sql_statements/utility_commands/get_ddl.rst +++ b/reference/sql/sql_statements/utility_commands/get_ddl.rst @@ -1,36 +1,23 @@ .. _get_ddl: -***************** -GET_DDL -***************** +******* +GET DDL +******* -``GET_DDL(<table name>)`` is a function that shows the :ref:`CREATE TABLE<create_table>` statement for a table. +The ``GET DDL`` function retrieves the Data Definition Language (DDL) statement used to create a table. It may include additional information that was added by SQreamDB (e.g., explicit ``NULL`` constraints). -.. tip:: - * For views, see :ref:`GET_VIEW_DDL<get_view_ddl>`. - * For the entire database, see :ref:`DUMP_DATABASE_DDL<dump_database_ddl>`. - * For UDFs, see :ref:`GET_FUNCTION_DDL<get_function_ddl>`. - -Permissions -============= - -The role must have the ``CONNECT`` permission at the database level. +See also: :ref:`GET_VIEW_DDL<get_view_ddl>`, :ref:`DUMP_DATABASE_DDL<dump_database_ddl>`, :ref:`GET_FUNCTION_DDL<get_function_ddl>` Syntax -========== +====== .. code-block:: postgres - get_ddl_statement ::= - SELECT GET_DDL('[schema_name.]table_name') - ; - - schema_name ::= identifier - - table_name ::= identifier + SELECT + GET_DDL(['<schema_name>'.]'<table_name>') Parameters -============ +========== .. list-table:: :widths: auto @@ -39,39 +26,54 @@ Parameters * - Parameter - Description * - ``schema_name`` - - The name of the schema. + - The name of the schema * - ``table_name`` - - The name of the table. + - The name of the table Examples -=========== +======== -Getting the DDL for a table ------------------------------ -The result of the ``GET_DDL`` function is a verbose version of the :ref:`create_table` syntax, which may include additional information that was added by SQream DB. For example, a ``NULL`` constraint may be specified explicitly. - -.. code-block:: psql +.. code-block:: postgres - farm=> CREATE TABLE cool_animals ( - id INT NOT NULL, - name text(30) NOT NULL, - weight FLOAT, - is_agressive BOOL DEFAULT false NOT NULL - ); - executed - - farm=> SELECT GET_DDL('cool_animals'); - create table "public"."cool_animals" ( - "id" int not null, - "name" text(30) not null, - "weight" double null, - "is_agressive" bool default false not null ) - ; + -- Create a table: + CREATE TABLE + cool_animals ( + id INT NOT NULL, + name TEXT NOT NULL, + weight FLOAT, + is_agressive BOOL DEFAULT false NOT NULL + ); + + -- Get table ddl: + SELECT + GET_DDL('cool_animals'); + + -- Result: + CREATE TABLE + 'public'.'cool_animals' ( + 'id' INT NOT NULL, + 'name' TEXT NOT NULL, + 'weight' DOUBLE NULL, + 'is_agressive' BOOL DEFAULT FALSE NOT NULL + ); Exporting table DDL to a file -------------------------------- +----------------------------- .. code-block:: postgres - COPY (SELECT GET_DDL('cool_animals')) TO '/home/rhendricks/animals.ddl'; + COPY + ( + SELECT + GET_DDL('cool_animals') + ) TO + WRAPPER + csv_fdw + OPTIONS + (LOCATION = 's3://sqream-docs/cool_animals_ddl.csv'); + +Permissions +============= + +The role must have the ``CONNECT`` permission at the database level. \ No newline at end of file diff --git a/reference/sql/sql_statements/utility_commands/get_function_ddl.rst b/reference/sql/sql_statements/utility_commands/get_function_ddl.rst index e456073ae..4327ba33f 100644 --- a/reference/sql/sql_statements/utility_commands/get_function_ddl.rst +++ b/reference/sql/sql_statements/utility_commands/get_function_ddl.rst @@ -1,31 +1,18 @@ .. _get_function_ddl: ***************** -GET_FUNCTION_DDL +GET FUNCTION DDL ***************** -``GET_FUNCTION_DDL(<function name>)`` is a function that shows the :ref:`CREATE FUNCTION<create_function>` statement for a function. - -.. tip:: - * For tables, see :ref:`GET_DDL<get_ddl>`. - * For views, see :ref:`GET_VIEW_DDL<get_view_ddl>`. - * For the entire database, see :ref:`DUMP_DATABASE_DDL<dump_database_ddl>`. - -Permissions -============= - -The role must have the ``CONNECT`` permission at the database level. +``GET_FUNCTION_DDL`` is a function that shows the :ref:`create_function` statement for a function. Syntax -========== +====== .. code-block:: postgres - get_function_ddl_statement ::= - SELECT GET_FUNCTION_DDL('function_name') - ; - function_name ::= identifier + SELECT GET_FUNCTION_DDL('<function_name>') Parameters ============ @@ -37,46 +24,58 @@ Parameters * - Parameter - Description * - ``function_name`` - - The name of the function. + - The name of the function Examples -=========== - -Getting the DDL for a function ---------------------------------- +======== -The result of the ``GET_FUNCTION_DDL`` function is a verbose version of the CREATE FUNCTION statement, which may include additional information that was added by SQream DB. For example, some type names and identifiers may be quoted or altered. +.. code-block:: postgres -.. code-block:: psql + CREATE OR REPLACE FUNCTION my_distance (x1 float, + y1 float, + x2 float, + y2 float) returns float as + $$ import mathIF y1 < X1:RETURN 0.0 + else: + return math.Sqrt((y2 - y1) ** 2 + (x2 - x1) ** 2) + $$ + language python; - master=> CREATE OR REPLACE FUNCTION my_distance (x1 float, y1 float, x2 float, y2 float) RETURNS float as $$ - import math - if y1 < x1: - return 0.0 - else: - return math.sqrt((y2 - y1) ** 2 + (x2 - x1) ** 2) - $$ LANGUAGE PYTHON; - executed - master=> SELECT GET_FUNCTION_DDL('my_distance'); - create function "my_distance" (x1 float, + SELECT + GET_FUNCTION_DDL('my_distance'); + + CREATE FUNCTION 'my_distance' (x1 float, y1 float, x2 float, y2 float) returns float as - $$ - import math - if y1 < x1: - return 0.0 - else: - return math.sqrt((y2 - y1) ** 2 + (x2 - x1) ** 2) - $$ - language python volatile; + $$ + import math + if y1 < x1: + return 0.0 + else: + return math.sqrt((y2 - y1) ** 2 + (x2 - x1) ** 2) + $$ + language python volatile; Exporting function DDL to a file ------------------------------------- +-------------------------------- .. code-block:: postgres - COPY (SELECT GET_FUNCTION_DDL('my_distance')) TO '/home/rhendricks/my_distance.sql'; + COPY + ( + SELECT + GET_FUNCTION_DDL('my_distance') + ) TO + WRAPPER + csv_fdw + OPTIONS + (LOCATION = 's3://sqream-docs/cool_animals_ddl.csv'); + +Permissions +============= + +The role must have the ``CONNECT`` permission at the database level. \ No newline at end of file diff --git a/reference/sql/sql_statements/utility_commands/get_role_database_ddl.rst b/reference/sql/sql_statements/utility_commands/get_role_database_ddl.rst index ed7adfcf5..13dd0d98b 100644 --- a/reference/sql/sql_statements/utility_commands/get_role_database_ddl.rst +++ b/reference/sql/sql_statements/utility_commands/get_role_database_ddl.rst @@ -1,23 +1,20 @@ .. _get_role_database_ddl: -******************** +********************* GET_ROLE_DATABASE_DDL -******************** -The ``GET_ROLE_DATABASE_DDL`` statement returns the definition of a role's database in DDL format. +********************* -The ``GET_ROLE_DATABASE_DDL`` page describes the following: +The ``GET_ROLE_DATABASE_DDL`` statement returns the definition of a role's database in DDL format. Syntax -========== -The following is the correct syntax for using the ``GET_ROLE_DATABASE_DDL`` statement: +====== .. code-block:: postgres - select get_role_database_ddl(<'role_name'>) + SELECT GET_ROLE_DATABASE_DDL('<role_name>') Parameters -============ -The following table shows the ``GET_ROLE_DATABASE_DDL`` parameters: +========== .. list-table:: :widths: auto @@ -26,33 +23,24 @@ The following table shows the ``GET_ROLE_DATABASE_DDL`` parameters: * - Parameter - Description * - ``role_name`` - - The definition of the database role in DDL format. + - The role for which to get database definition Example -=========== -The following is an example of using the ``GET_ROLE_DATABASE_DDL`` statement: +======= -.. code-block:: psql +.. code-block:: postgres - select get_role_database_ddl('public'); + SELECT GET_ROLE_DATABASE_DDL('public'); - -Output -========== -The following is an example of the output of the ``GET_ROLE_DATABASE_DDL`` statement: +Output: -.. code-block:: postgres +.. code-block:: console - grant create, usage on schema "public" to "public" ; alter default schema for "public" to "public"; alter default permissions for "public" for schemas grant superuser to creator_role ; alter default permissions for "public" for tables grant select, insert, delete, ddl to creator_role ; + Name|Value | + ----+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + ddl |grant create, usage on schema 'master'.'public' to 'public' ;alter default schema for 'public' to 'master'.'public';alter default permissions for 'public' for schemas grant superuser to creator_role ;alter default permissions for 'public' for tables grant select, insert, delete, update, ddl to creator_role ;alter default permissions for 'public' for external tables grant select, ddl to creator_role ;alter default permissions for 'public' for views grant select, ddl to creator_role ;| Permissions -============= -Using the ``GET_ROLE_DATABASE_DDL`` statement requires no special permissions. - -For more information, see the following: - -* :ref:`get_role_global_ddl` +=========== - :: - -* :ref:`get_role_permissions` \ No newline at end of file +Using the ``GET_ROLE_DATABASE_DDL`` statement requires no special permissions. diff --git a/reference/sql/sql_statements/utility_commands/get_view_ddl.rst b/reference/sql/sql_statements/utility_commands/get_view_ddl.rst index 5ce56d7af..6ae5d4328 100644 --- a/reference/sql/sql_statements/utility_commands/get_view_ddl.rst +++ b/reference/sql/sql_statements/utility_commands/get_view_ddl.rst @@ -1,36 +1,20 @@ .. _get_view_ddl: -***************** -GET_VIEW_DDL -***************** +************ +GET VIEW DDL +************ -``GET_VIEW_DDL(<view name>)`` is a function that shows the :ref:`CREATE VIEW<create_view>` statement for a view. - -.. tip:: - * For tables, see :ref:`GET_DDL<get_ddl>`. - * For the entire database, see :ref:`DUMP_DATABASE_DDL<dump_database_ddl>`. - * For UDFs, see :ref:`GET_FUNCTION_DDL<get_function_ddl>`. - -Permissions -============= - -The role must have the ``CONNECT`` permission at the database level. +``GET_VIEW_DDL`` is a function that shows the :ref:`CREATE VIEW<create_view>` statement for a view. Syntax -========== +====== .. code-block:: postgres - get_view_ddl_statement ::= - SELECT GET_VIEW_DDL('[schema_name.]view_name') - ; - - schema_name ::= identifier - - view_name ::= identifier + SELECT GET_VIEW_DDL(['<schema_name>'.]'<view_name>') Parameters -============ +========== .. list-table:: :widths: auto @@ -39,40 +23,55 @@ Parameters * - Parameter - Description * - ``schema_name`` - - The name of the schema. + - The name of the schema * - ``view_name`` - - The name of the view. + - The name of the view Examples -=========== +======== -Getting the DDL for a view ------------------------------ - -The result of the ``GET_VIEW_DDL`` function is a verbose version of the CREATE VIEW statement, which may include additional information that was added by SQream DB. For example, schemas and column names will be be specified explicitly. +.. code-block:: postgres -.. code-block:: psql + CREATE VIEW + angry_animals AS + SELECT + * + FROM + cool_animals + WHERE + is_agressive = false; - farm=> CREATE VIEW angry_animals AS SELECT * FROM cool_animals WHERE is_agressive = false; - executed - farm=> SELECT GET_VIEW_DDL('angry_animals'); - create view "public".angry_animals as - select - "cool_animals"."id" as "id", - "cool_animals"."name" as "name", - "cool_animals"."weight" as "weight", - "cool_animals"."is_agressive" as "is_agressive" - from - "public".cool_animals as cool_animals - where - "cool_animals"."is_agressive" = false; - - + SELECT + GET_VIEW_DDL('angry_animals'); + + CREATE VIEW 'public'.angry_animals AS + SELECT + 'cool_animals'.'id' as 'id', + 'cool_animals'.'name' as 'name', + 'cool_animals'.'weight' as 'weight', + 'cool_animals'.'is_agressive' as 'is_agressive' + FROM + 'public'.cool_animals as cool_animals + WHERE + 'cool_animals'.'is_agressive' = false; Exporting view DDL to a file -------------------------------- +---------------------------- .. code-block:: postgres - COPY (SELECT GET_VIEW_DDL('angry_animals')) TO '/home/rhendricks/angry_animals.sql'; + COPY + ( + SELECT + GET_VIEW_DDL('angry_animals') + ) TO + WRAPPER + csv_fdw + OPTIONS + (LOCATION = 's3://sqream-docs/cool_animals_ddl.csv'); + +Permissions +=========== + +The role must have the ``CONNECT`` permission at the database level. \ No newline at end of file From 70f8350021846ee079bce2b3cd7bd329b28c2c60 Mon Sep 17 00:00:00 2001 From: TaliaSQream <taliar@sqreamtech.com> Date: Sun, 14 Apr 2024 16:44:20 +0300 Subject: [PATCH 821/882] Update access_control_permissions.rst --- .../access_control_permissions.rst | 63 ++++++++++++++++--- 1 file changed, 56 insertions(+), 7 deletions(-) diff --git a/operational_guides/access_control_permissions.rst b/operational_guides/access_control_permissions.rst index 86548f7a4..53753ec9a 100644 --- a/operational_guides/access_control_permissions.rst +++ b/operational_guides/access_control_permissions.rst @@ -6,7 +6,7 @@ Permissions SQreamDB’s primary permission object is a role. The role operates in a dual capacity as both a user and a group. As a user, a role may have permissions to execute operations like creating tables, querying data, and administering the database. The group attribute may be thought of as a membership. As a group, a role may extend its permissions to other roles defined as its group members. This becomes handy when privileged roles wish to extend their permissions and grant multiple permissions to multiple roles. The information about all system role permissions is stored in the metadata. -There are two types of permissions: global and object-level. Global permissions belong to ``SUPERUSER`` roles, allowing unrestricted access to all system and database activities. Object-level permissions apply to non-``SUPERUSER`` roles and can be assigned to databases, schemas, tables, functions, views, foreign tables, catalogs, and services. +There are two types of permissions: global and object-level. Global permissions belong to ``SUPERUSER`` roles, allowing unrestricted access to all system and database activities. Object-level permissions apply to non-``SUPERUSER`` roles and can be assigned to databases, schemas, tables, functions, views, foreign tables, columns, catalogs, and services. The following table describe the required permissions for performing and executing operations on various SQreamDB objects. @@ -59,21 +59,27 @@ The following table describe the required permissions for performing and executi +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``EXECUTE`` | Use the function | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``DDL`` | Drop and alter on the function | +| ``DDL`` | Drop and alter on the function | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``ALL`` | All function permissions | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| **Column** | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``SELECT`` | Select from catalog | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ +| ``DDL`` | Column DDL operations | ++----------------------+-------------------------------------------------------------------------------------------------------------------------+ | **View** | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``SELECT`` | Select from view | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``DDL`` | DDL operations of view results | +| ``DDL`` | DDL operations of view results | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | **Foreign Table** | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``SELECT`` | Select from foreign table | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``DDL`` | Foreign table DDL operations | +| ``DDL`` | Foreign table DDL operations | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``ALL`` | All foreign table permissions | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ @@ -176,6 +182,22 @@ GRANT ON FUNCTION <function_name> TO role; + -- Grant permissions at the column level: + GRANT + { + { SELECT + | DDL } [, ...] + | ALL [PERMISSIONS] + } + ON + { + COLUMN <column_name> [,<column_name_2>] IN TABLE <table_name> [,<table_name2>] + | COLUMN <column_name> [,<column_name_2>] IN FOREIGN TABLE <table_name> [,<table_name2>] + | ALL COLUMNS IN TABLE <schema_name.table_name> [, ...] + | ALL COLUMNS IN FOREIGN TABLE <foreign_table_name> [, ...] + } + TO <role> [, ...] + -- Grant permissions at the Service level: GRANT { @@ -274,6 +296,20 @@ REVOKE } ON FUNCTION <function_name> FROM <role> [, ...] + + -- Revoke permissions at the column level: + REVOKE + { + { SELECT + | DDL } [, ...] + | ALL [PERMISSIONS]} + ON + { + COLUMN <column_name> [,<column_name_2>] IN TABLE <table_name> [,<table_name2>] | COLUMN <column_name> [,<column_name_2>] IN FOREIGN TABLE <table_name> [,<table_name2>] + | ALL COLUMNS IN TABLE <schema_name.table_name> [, ...] + | ALL COLUMNS IN FOREIGN TABLE <schema_name.foreign_table_name> [, ...] + } + FROM <role> [, ...] -- Revoke permissions at the service level: REVOKE @@ -313,9 +349,10 @@ schema statement is run. SCHEMAS | TABLES | FOREIGN TABLES - | VIEWS - | CATALOGS - | SERVICES + | VIEWS + | COLUMNS + | CATALOGS + | SERVICES | SAVED_QUERIES } { grant_clause @@ -375,6 +412,12 @@ Grant execute function permission to a role: GRANT EXECUTE ON FUNCTION function_name TO role_name; +Grant column-level permissions to a role: + +.. code-block:: postgres + + GRANT SELECT, DDL ON COLUMN column_name IN TABLE schema_name.table_name TO role_name; + Grant usage permissions on a service to a role: .. code-block:: postgres @@ -421,6 +464,12 @@ Revoke permissions on specific objects (table, view, foreign table, or catalog) REVOKE SELECT, INSERT, DELETE, DDL, UPDATE ON TABLE schema_name.table_name FROM role_name; +Revoke column-level permissions from a role: + +.. code-block:: postgres + + REVOKE SELECT, DDL FROM COLUMN column_name IN TABLE schema_name.table_name FROM role_name; + Revoke usage permissions on a service from a role: .. code-block:: postgres From bacea0ed0c0c624245877ec236698700dfbed9dc Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 18 Apr 2024 15:25:13 +0300 Subject: [PATCH 822/882] Update filesystem_and_filesystem_usage.rst --- architecture/filesystem_and_filesystem_usage.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/architecture/filesystem_and_filesystem_usage.rst b/architecture/filesystem_and_filesystem_usage.rst index 1bd670efb..90b1c0a40 100644 --- a/architecture/filesystem_and_filesystem_usage.rst +++ b/architecture/filesystem_and_filesystem_usage.rst @@ -77,7 +77,7 @@ The ``temp`` directory is where SQreamDB writes temporary data. The directory to which SQreamDB writes temporary data can be changed to any other directory on the filesystem. SQreamDB recommends remapping this directory to a fast local storage to get better performance when executing intensive larger-than-RAM operations like sorting. SQreamDB recommends an SSD or NVMe drive, in mirrored RAID 1 configuration. -If desired, the ``temp`` folder can be redirected to a local disk for improved performance, by setting the ``tempPath`` setting in the :ref:`configuration<configuration>` file. +If desired, the ``temp`` folder can be redirected to a local disk for improved performance, by setting the ``tempPath`` setting in the :ref:`legacy configuration<current_method_modification_methods>` file. ``logs`` From 05a98a29a498067f0ff7823104a764e3bf8ebc72 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 18 Apr 2024 15:29:29 +0300 Subject: [PATCH 823/882] Update pentaho.rst --- .../client_platforms/pentaho.rst | 26 ++++++++++++------- 1 file changed, 16 insertions(+), 10 deletions(-) diff --git a/connecting_to_sqream/client_platforms/pentaho.rst b/connecting_to_sqream/client_platforms/pentaho.rst index 8ae213b33..64cd8f81b 100644 --- a/connecting_to_sqream/client_platforms/pentaho.rst +++ b/connecting_to_sqream/client_platforms/pentaho.rst @@ -1,12 +1,13 @@ .. _pentaho_data_integration: -************************* -Connecting to SQream Using Pentaho Data Integration -************************* +************************ +Pentaho Data Integration +************************ .. _pentaho_top: Overview -========= +======== + This document is a Quick Start Guide that describes how to install Pentaho, create a transformation, and define your output. The Connecting to SQream Using Pentaho page describes the following: @@ -20,8 +21,9 @@ The Connecting to SQream Using Pentaho page describes the following: .. _install_pentaho: Installing Pentaho -~~~~~~~~~~~~~~~~~ -To install PDI, see the `Pentaho Community Edition (CE) Installation Guide <https://www.hitachivantara.com/en-us/pdf/white-paper/pentaho-community-edition-installation-guide-for-windows-whitepaper.pdf>`_. +~~~~~~~~~~~~~~~~~~ + +To install PDI, see the `Pentaho Community Edition (CE) Installation Guide <https://www.hitachivantara.com/en-us/pdf/implementation-guide/three-steps-to-install-pentaho-data-integration-ce.pdf>`_. The **Pentaho Community Edition (CE) Installation Guide** describes how to do the following: @@ -34,7 +36,8 @@ The **Pentaho Community Edition (CE) Installation Guide** describes how to do th .. _install_set_up_jdbc_driver: Installing and Setting Up the JDBC Driver -~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + After installing Pentaho you must install and set up the JDBC driver. This section explains how to set up the JDBC driver using Pentaho. These instructions use Spoon, the graphical transformation and job designer associated with the PDI suite. You can install the driver by copying and pasting the SQream JDBC .jar file into your **<directory>/design-tools/data-integration/lib** directory. @@ -44,7 +47,8 @@ You can install the driver by copying and pasting the SQream JDBC .jar file into .. _create_transformation: Creating a Transformation -~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~ + After installing Pentaho you can create a transformation. **To create a transformation:** @@ -114,7 +118,8 @@ After installing Pentaho you can create a transformation. .. _define_output: Defining Your Output ------------------ +-------------------- + After creating your transformation you must define your output. **To define your output:** @@ -176,7 +181,8 @@ After creating your transformation you must define your output. .. _import_data: Importing Data ------------------ +-------------- + After defining your output you can begin importing your data. For more information about backing up users, permissions, or schedules, see `Backup and Restore Pentaho Repositories <https://help.pentaho.com/Documentation/7.0/0P0/Managing_the_Pentaho_Repository/Backup_and_Restore_Pentaho_Repositories>`_ From 071c830811c2aa6ff721fe14d40923b7d295c244 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 18 Apr 2024 15:35:40 +0300 Subject: [PATCH 824/882] Remove 2021 --- releases/2020.1.rst | 189 --------------------------------- releases/2020.2.rst | 116 --------------------- releases/2020.3.1.rst | 73 ------------- releases/2020.3.2.1.rst | 32 ------ releases/2020.3.2.rst | 28 ----- releases/2020.3.rst | 105 ------------------- releases/2020.3_index.rst | 19 ---- releases/2021.1.2.rst | 62 ----------- releases/2021.1.rst | 214 -------------------------------------- releases/2021.1_index.rst | 18 ---- releases/2021.2.1.24.rst | 85 --------------- releases/2021.2.1.rst | 80 -------------- releases/2021.2.rst | 170 ------------------------------ releases/2021.2_index.rst | 18 ---- releases/index.rst | 2 +- 15 files changed, 1 insertion(+), 1210 deletions(-) delete mode 100644 releases/2020.1.rst delete mode 100644 releases/2020.2.rst delete mode 100644 releases/2020.3.1.rst delete mode 100644 releases/2020.3.2.1.rst delete mode 100644 releases/2020.3.2.rst delete mode 100644 releases/2020.3.rst delete mode 100644 releases/2020.3_index.rst delete mode 100644 releases/2021.1.2.rst delete mode 100644 releases/2021.1.rst delete mode 100644 releases/2021.1_index.rst delete mode 100644 releases/2021.2.1.24.rst delete mode 100644 releases/2021.2.1.rst delete mode 100644 releases/2021.2.rst delete mode 100644 releases/2021.2_index.rst diff --git a/releases/2020.1.rst b/releases/2020.1.rst deleted file mode 100644 index 769fa0ebb..000000000 --- a/releases/2020.1.rst +++ /dev/null @@ -1,189 +0,0 @@ -.. _2020.1: - -************************** -Release Notes 2020.1 -************************** - -SQream DB v2020.1 contains lots of new features, improved performance, and bug fixes. - -This is the first release of 2020, with a strong focus on integration into existing environments. The release includes connectivity to Hadoop and other legacy data warehouse ecosystems. We’re also bringing lots of new capabilities to our analytics engine, to empower data users to analyze more data with less friction. - -The latest release vastly improves reliability and performance, and makes getting more data into SQream DB easier than ever. - -The core of SQream DB v2020.1 contains new integration features, more analytics capabilities, and better drivers and connectors. - - -New features -================ - -Integrations ------------------ - -* Load files directly from :ref:`S3 buckets<inserting_data>`. Customers with columnar data in S3 data lakes can now access the data directly. All that is needed is to simply point an external table to an S3 bucket with Parquet, ORC, or CSV objects. This feature is available on all deployments of SQream DB – in the cloud and on-prem. - -* Load files directly from :ref:`HDFS<inserting_data>`. SQream DB now comes with built-in, native HDFS support for directly loading data from Hadoop-based data lakes. Our focus on helping Hadoop customers do more with their data led us to develop this feature, which works out of the box. As a result, SQream DB can now not only read but also write data, and intermediate results back to HDFS for HIVE and other data consumers. SQream DB now fits seamlessly into a Hadoop data pipeline. - - -* Import :ref:`ORC files<orc>`, through :ref:`external_tables`. ORC files join Parquet as files that can be natively accessed and inserted into SQream DB tables. - -* :ref:`Python driver (pysqream)<pysqream>` is now DB-API v2.0 compliant. Customers can write high-performance Python applications that make full use of SQream DB - connect, query, delete, and insert data. Data scientists can use pysqream with Pandas, Numpy, and AI/ML frameworks like TensorFlow for direct queries of huge datasets. - -* Certified :ref:`Tableau JDBC connector (taco)<connect_to_tableau>`, now also :ref:`supported on MacOS<tableau_manual_installation>`. Users are encouraged to install the new JDBC connector. - -* - All logs are now unified into one log, which can be analyzed with SQream DB directly. - See :ref:`logging` for more information. - - -SQL support ---------------- - -* - Added frames and frame exclusions to :ref:`window_functions`. This is available for preview, with more features coming in the next version. - - The new frames and frame exclusionsfeature adds complex analytics capabilities to the already powerful window functions. - -* - New datatype - ``TEXT``, which replaces ``NVARCHAR`` directly with UTF-8 support and improved performance. - - Unlike ``VARCHAR``, the new ``TEXT`` data type has no restrictions on size, and carries no performance overhead as the text sizes grow. - -* ``TEXT`` join keys are now supported - -* Added lots of new :ref:`aggregate functions<aggregate_functions>`, including ``VAR_SAMP``, ``VAR_POP``, ``COVAR_POP``, etc. - - -Improvements and fixes -======================== - -SQream DB v2020.1 includes hundreds of small new features and tunable parameters that improve performance, reliability, and stability. Existing SQream DB users can expect to see a general speedup of around 10% on most statements and queries! - -* 207 bug fixes, including: - - - Improved performance of both inner and outer joins - - Fixed wrong results on STDDEV (0 instead of ``NULL``) - - Fixed wrong results on nested Parquet files - - Fixed failing cast from ``VARCHAR`` to ``FLOAT`` - - Fix ``INSERT`` that would fail on nullable values and non-nullable columns in some scenarios - - Improved memory consumption, so ``Out of GPU memory`` errors should not occur anymore - - Reduced long compilation times for very complex queries - - Improved ODBC reliability - - Fixed situation where some logs would clip very long queries - - Improved error messages when dropping a schema with many objects - - Fixed situation where Spotfire would not show table names - - Fixed situation where some queries with UTF-8 literals wouldn't run through Tableau over ODBC - - Significantly improved cache freeing and memory allocation - - Fixed situation in which a malformed time (``24:00:00``) would get incorrectly inserted from a CSV - - Fixed race condition in which loading thousands of small files from HDFScaused a memory leak - -* The :ref:`saved query<saved_queries>` feature can now be used with :ref:`insert` statements - -* Faster "Deferred gather" algorithm for joins with text keys - -* Faster filtering when using :ref:`datepart` - -* Faster metadata tagging during load - -* Fixed situation where some queries would get compiled twice - -* :ref:`saved_queries` now support :ref:`insert` statements - -* ``highCardinalityColumns`` can be configured to tell the system about :ref:`high selectivity<high_selectivity>` columns - -* :ref:`sqream sql<sqream_sql_cli_reference>` starts up faster, can run on any Linux machine - -* Additional CSV date formats (date parsers) added for compatibility - -Behaviour changes -======================== - -* ``ClientCmd`` is now known as :ref:`sqream sql<sqream_sql_cli_reference>` - -* ``NVARCHAR`` columns are now known as ``TEXT`` internally - -* - Deprecated the ability to run ``SELECT`` and ``COPY`` at the same time on the same worker. This change is designed to protect against ``out of GPU memory`` issues. - This comes with a configuration change, namely the ``limitQueryMemoryGB`` setting. See the operations section for more information. - -* All logs are now unified into one log. See :ref:`logging` for more information - -* Compression changes: - - - The latest version of SQream DB could select a different compression scheme if data is reloaded, compared to previous versions of SQream DB. This internal change improves performance. - - - With ``LZ4`` compression, the maximum chunk size is limited to 2.1GB. If the chunk size is bigger, another compression may be selected - primarily ``SNAPPY``. - -* The following configuration flags have been deprecated: - - - ``addStatementRechunkerAfterGpuToHost`` - - ``increasedChunkSizeFactor`` - - ``gpuReduceMergeOutputFactor`` - - ``fullSortInputMemFactor`` - - ``reduceInputMemFactor`` - - ``distinctInputMemFactor`` - - ``useAutoMemFactors`` - - ``autoMemFactorsVramFactor`` - - ``catchNotEnoughVram`` - - ``useNetworkRechunker`` - - ``useMemFactorInJoinOutput`` - -Operations -======================== - -* The client-server protocol has been updated to support faster data flow, and more reliable memory allocations on the client side. End users are required to use only the latest :ref:`sqream sql<sqream_sql_cli_reference>`, :ref:`java_jdbc`, and :ref:`odbc` drivers delivered with this version. See the :ref:`client driver download page<client_drivers>` for the latest drivers and connectors. - -* When upgrading from a previous version of SQream DB (for example, v2019.2), the storage version must be upgraded using the :ref:`upgrade_storage_cli_reference` utility: ``./bin/upgrade_storage /path/to/storage/sqreamdb/`` - -* - A change in memory allocation behaviour in this version sees the introduction of a new setting, ``limitQueryMemoryGB``. This is an addition to the previous ``spoolMemoryGB`` setting. - - A good rule-of-thumb is to allow 5% system memory for other processes. The spool memory allocation should be around 90% of the total memory allocated. - - - ``limitQueryMemoryGB`` defines how much total system memory is used by the worker. The recommended setting is (``total host memory`` - 5%) / ``sqreamd workers on host``. - - - ``spoolMemoryGB`` defines how much memory is set aside for spooling, out of the total system memory allocated in ``limitQueryMemoryGB``. The recommended setting is 90% of the ``limitQueryMemoryGB``. - - This setting must be set lower than the ``limitQueryMemoryGB`` setting. - - For example, for a machine with 512GB of RAM and 4 workers, the recommended settings are: - - - ``limitQueryMemoryGB`` - ``⌊(512 * 0.95 / 4)⌋ → ~ 486 / 4 → 121``. - - - ``spoolMemoryGB`` - ``⌊( 0.9 * limitQueryMemoryGB )⌋ → ⌊( 0.9 * 121 )⌋ → 108`` - - Example settings per-worker, for 512GB of RAM and 4 workers: - - .. code-block:: none - - "runtimeGlobalFlags": { - "limitQueryMemoryGB" : 121, - "spoolMemoryGB" : 108 - - - - -Known Issues & Limitations -================================ - -* An invalid formatted CSV can cause an ``insufficient memory`` error on a :ref:`copy_from` statement if a quote isn't closed and the file is much larger than system memory. - -* ``TEXT`` columns cannot be used in a window functions' partition - -* Parsing errors are sometimes hard to read - the location points to the wrong part of the statement - -* LZ4 compression may not be applied correctly on very large ``VARCHAR`` columns, which decreases performance - -* Using ``SUM`` on very large numbers in window functions can error (``overflow``) when not used with an ``ORDER BY`` clause - -* Slight performance decrease with :ref:`dateadd` in this version (<4%) - -* Operations on Snappy-compressed ORC files are slower than their Parquet equivalents. - - -Upgrading to v2020.1 -======================== - -Versions are available for IBM POWER9, RedHat (CentOS) 7, Ubuntu 18.04, and other OSs via Docker. - -Contact your account manager to get the latest release of SQream. - diff --git a/releases/2020.2.rst b/releases/2020.2.rst deleted file mode 100644 index 5a66e99bd..000000000 --- a/releases/2020.2.rst +++ /dev/null @@ -1,116 +0,0 @@ -.. _2020.2: - -************************** -Release Notes 2020.2 -************************** - -SQream v2020.2 contains some new features, improved performance, and bug fixes. - -This version has new window ranking function and a new editor UI to empower data users to analyze more data with less friction. - -As always, the latest release improves reliability and performance, and makes getting more data into SQream easier than ever. - - -New Features -================ - -UI ----------- - -* New :ref:`sqream_studio` replaces the previous Statement Editor. - -Integrations ------------------ - -* Our :ref:`Python driver (pysqream)<pysqream>` now has an SQLAlchemy dialect. Customers can write high-performance Python applications that make full use of SQream - connect, query, delete, and insert data. Data scientists can use pysqream with Pandas, Numpy, and AI/ML frameworks like TensorFlow for direct queries of huge datasets. - -SQL Support ---------------- - -* Added :ref:`lag`/:ref:`lead` ranking functions to our :ref:`window_functions` support. We will have more features coming in the next version. - -* - New syntax preview for :ref:`external_tables`. Foreign tables replace external tables, with improved functionality. - - You can keep using the existing foreign table syntax for now, but it may be deprecated in the future. - - .. code-block:: postgres - - CREATE FOREIGN TABLE orc_example - ( - name varchar(40), - Age tinyint, - Salary float - ) - WRAPPER orc_fdw - OPTIONS - ( LOCATION = 'hdfs://hadoop-nn.piedpiper.com:8020/demo-data/example.orc' ); - - -Improvements and Fixes -======================== - -SQream v2020.2 includes hundreds of small new features and tunable parameters that improve performance, reliability, and stability. - -* ~100 bug fixes, including: - - - Fixed CSV handling for DOS newlines - - Fixed "out of bounds" message when several layers of nested ``substring``, ``cast``, and ``to_hex`` were used to produce one value. - - Fixed "Illegal memory access" that would occur in extremely rare situations on all-text tables - - Window functions can now be used with all aggregations - - Fixed situation where a single worker may use more than one GPU that isn't allocated to it - - Text columns can now be added to existing tables with :ref:`alter_table` - -* New :ref:`data_clustering` syntax that can improve query performance for unsorted data - - -Operations -======================== - -* When upgrading from a previous version of SQream (for example, v2019.2), the storage version must be upgraded using the :ref:`upgrade_storage_cli_reference` utility: ``./bin/upgrade_storage /path/to/storage/sqreamdb/`` - -* - A change in memory allocation behaviour in this version sees the introduction of a new setting, ``limitQueryMemoryGB``. This is an addition to the previous ``spoolMemoryGB`` setting. - - A good rule-of-thumb is to allow 5% system memory for other processes. The spool memory allocation should be around 90% of the total memory allocated. - - - ``limitQueryMemoryGB`` defines how much total system memory is used by the worker. The recommended setting is (``total host memory`` - 5%) / ``sqreamd workers on host``. - - - ``spoolMemoryGB`` defines how much memory is set aside for spooling, out of the total system memory allocated in ``limitQueryMemoryGB``. The recommended setting is 90% of the ``limitQueryMemoryGB``. - - This setting must be set lower than the ``limitQueryMemoryGB`` setting. - - For example, for a machine with 512GB of RAM and 4 workers, the recommended settings are: - - - ``limitQueryMemoryGB`` - ``⌊(512 * 0.95 / 4)⌋ → ~ 486 / 4 → 121``. - - - ``spoolMemoryGB`` - ``⌊( 0.9 * limitQueryMemoryGB )⌋ → ⌊( 0.9 * 121 )⌋ → 108`` - - Example settings per-worker, for 512GB of RAM and 4 workers: - - .. code-block:: none - - "runtimeFlags": { - "limitQueryMemoryGB" : 121, - "spoolMemoryGB" : 108 - - - - -Known Issues and Limitations -================================ - -* An invalid formatted CSV can cause an ``insufficient memory`` error on a :ref:`copy_from` statement if a quote isn't closed and the file is much larger than system memory. - -* Multiple ``COUNT( distinct ... )`` operations within the same query are limited to "developer mode" due to an instability that was identified. If you rely on this feature, contact your SQream account manager to enable this feature. - -* ``TEXT`` columns can't be used with an outer join together with an inequality check (``!= , <>``) - - -Upgrading to Version 2020.2 -======================== - -Versions are available for IBM POWER9, RedHat (CentOS) 7, Ubuntu 18.04, and other OSs via Docker. - -Contact your account manager to get the latest release of SQream. - diff --git a/releases/2020.3.1.rst b/releases/2020.3.1.rst deleted file mode 100644 index 9fa40cbb0..000000000 --- a/releases/2020.3.1.rst +++ /dev/null @@ -1,73 +0,0 @@ -.. _2020.3.1: - -************************** -Release Notes 2020.3.1 -************************** -The 2020.3.1 release notes were released on October 8, 2020 and describe the following: - -.. contents:: - :local: - :depth: 1 - - - -New Features -------------- -The following list describes the new features: - - -* TEXT data type: - * Full support for ``MIN`` and ``MAX`` aggregate functions on ``TEXT`` columns in ``GROUP BY`` queries. - * Support Text-type as window partition keys (e.g., select distinct name, max(id) over (partition by name) from ``textTable;``). - * Support Text-type fields in windows order by keys. - * Support join on ``TEXT`` columns (such as ``t1.x = t2.y`` where ``x`` and ``y`` are columns of type ``TEXT``). - * Complete the implementation of ``LIKE`` on ``TEXT`` columns (previously limited to prefix and suffix). - * Support for cast fromm ``TEXT`` to ``REAL/FLOAT``. - * New string function - ``REPEAT`` for repeating a string value for a specified number of times. - -* Support mapping ``DECIMAL ORC`` columns to SQream's floating-point types. - -* Support ``LIKE`` on non-literal patterns (such as columns and complex expressions). - -* Catch OS signals and save the signal along with the stack trace in the SQream debug log. - -* Support equijoin conditions on columns with different types (such as ``tinyint``, ``smallint``, ``int`` and ``bigint``). - -* ``DUMP_DATABASE_DDL`` now includes foreign tables in the output. - -* New utility function - ``TRUNCATE_IF_EXISTS``. - - -Performance Enhancements -------------- -The following list describes the performance enhancements: - - -* Introduced the "MetaData on Demand" feature which results in signicant proformance improvements. - -* Implemented regex functions (``RLIKE``, ``REGEXP_COUNT``, ``REGEXP_INSTR``, ``REGEXP_SUBSTR``, ``PATINDEX``) for ``TEXT`` columns on GPU. - - -Resolved Issues -------------- -The following list describes the resolved issues: - - -* Multiple distinct aggregates no longer need to be used with developerMode flag. -* In some scenarios, the ``statement_id`` and ``connection_id values`` are incorrectly recorded as ``-1`` in the log. -* ``NOT RLIKE`` is not supported for ``TEXT`` in the compiler. -* Casting from ``TEXT`` to ``date/datetime`` returns an error when the ``TEXT`` column contains ``NULL``. - - -Known Issues and Limitations -------------- -No known issues and limitations. - - -Upgrading to v2020.3.1 ----------------- - -Versions are available for IBM POWER9, RedHat (CentOS) 7, Ubuntu 18.04, and other OSs via Docker. - -Contact your account manager to get the latest release of SQream. - diff --git a/releases/2020.3.2.1.rst b/releases/2020.3.2.1.rst deleted file mode 100644 index 29f3b3e88..000000000 --- a/releases/2020.3.2.1.rst +++ /dev/null @@ -1,32 +0,0 @@ -.. _2020.3.2.1: - -************************** -Release Notes 2020.3.2.1 -************************** -The 2020.3.2.1 release notes were released on October 8, 2020 and describe the following: - -.. contents:: - :local: - :depth: 1 - - -Overview ------------------ -SQream DB v2020.3.2.1 contains major performance improvements and some bug fixes. - -Performance Enhancements -------------- -* Metadata on Demand optimization resulting in reduced latency and improved overall performance. - - -Known Issues and Limitations -------------- -* Multiple count distinct operations is enabled for all data types. - -Upgrading to v2020.3.2.1 -------------- - -Versions are available for IBM POWER9, RedHat (CentOS) 7, Ubuntu 18.04, and other OSs via Docker. - -Contact your account manager to get the latest release of SQream. - diff --git a/releases/2020.3.2.rst b/releases/2020.3.2.rst deleted file mode 100644 index c97e2bd47..000000000 --- a/releases/2020.3.2.rst +++ /dev/null @@ -1,28 +0,0 @@ -.. _2020.3.2: - -************************** -What's new in 2020.3.2 -************************** - -SQream DB v2020.3.2 contains major performance improvements and some bug fixes. - -Performance Enhancements -========================= -* Metadata on Demand optimization resulting in reduced latency and improved overall performance - - -Known Issues & Limitations -================================ -* Bug with STDDEV_SAMP,STDDEV_POP and STDEV functions -* Window function query returns wrong results -* rank() in window function sometimes returns garbage -* Window function on null value could have bad result -* Window function lead() on varchar can have garbage results -* Performance degradation when using "groupby" or outer_join - -Upgrading to v2020.3.2 -======================== - -Versions are available for IBM POWER9, RedHat (CentOS) 7, Ubuntu 18.04, and other OSs via Docker. - -Contact your account manager to get the latest release of SQream DB. diff --git a/releases/2020.3.rst b/releases/2020.3.rst deleted file mode 100644 index eb8ca8f62..000000000 --- a/releases/2020.3.rst +++ /dev/null @@ -1,105 +0,0 @@ -.. _2020.3: - -************************** -Release Notes 2020.3 -************************** -The 2020.3 release notes were released on October 8, 2020 and describes the following: - -.. contents:: - :local: - :depth: 1 - - -Overview ------------- -SQream DB v2020.3 contains new features, performance enhancements, and resolved issues. - - -New Features ----------- -The following list describes the new features: - - -* Parquet and ORC files can now be exported to local storage, S3, and HDFS with :ref:`copy_to` and foreign data wrappers. - -* New error tolerance features when loading data with foreign data wrappers. - -* ``TEXT`` is ramping up with new features (previously only available with VARCHARs): - - * `SUBSTRING <https://docs.sqream.com/en/v2020.3/reference/sql/sql_functions/scalar_functions/string/substring.html>`_ - * `LTRIM <https://docs.sqream.com/en/v2020.3/reference/sql/sql_functions/scalar_functions/string/substring.html>`_ - * `CHARINDEX <https://docs.sqream.com/en/v2020.3/reference/sql/sql_functions/scalar_functions/string/substring.html>`_ - * `REPLACE <https://docs.sqream.com/en/v2020.3/reference/sql/sql_functions/scalar_functions/string/substring.html>`_ - - * Binary operators - `CONCAT <https://docs.sqream.com/en/v2020.3/reference/sql/sql_functions/scalar_functions/string/concat.html>`_ , `REPLACE <https://docs.sqream.com/en/v2020.3/reference/sql/sql_functions/scalar_functions/string/like.html>`_ , etc. - - * Casts to and from ``TEXT`` - -* :ref:`sqream_studio` v5.1 - - * New log viewer helps you track and debug what's going on in SQream DB. - - * Dashboard now also available for non-k8s deployments. - - * The editor contains a new query concurrency tool for date and numeric ranges. - - - -Performance Enhancements ----------- -The following list describes the performance enhancements: - - -* Error handling for CSV FDW. -* Enable logging errors - ORC, Parquet, CSV. -* Add limit and offset options to ``csv_fdw`` import. -* Enable logging errors to an external file when skipping CSV, Parquet, and ORC errors. -* Option to specify date format to the CSV FDW. -* Support all existing ``VARCHAR`` functions with ``TEXT`` on GPU. -* Support ``INSERT INTO`` + ``ORDER BY`` optimization for non-clustered tables. -* Performance improvements with I/O. - -Resolved Issues ---------------- -The following list describes the resolved issues: - - -* Better error message when passing the max errors limit. This was fixed. -* ``showFullExceptionInfo`` is no longer restricted to Developer Mode. This was fixed. -* An ``StreamAggregateA`` reduction error occured when performing aggregation on a ``NULL`` column. This was fixed. -* Insert into query fails with ""Error at Sql phase during Stages ""rewriteSqlQuery"". This was fixed. -* Casting from ``VARCHAR`` to ``TEXT`` does not remove the spaces. This was fixed. -* An ``Internal Runtime Error t1.size() == t2.size()`` occurs when querying the ``sqream_catalog.delete_predicates``. This was fixed. -* ``spoolMemoryGB`` and ``limitQueryMemoryGB`` show incorrectly in the **runtime global** section of ``show_conf.`` This was fixed. -* Casting empty text to ``int`` causes illegal memory access. This was fixed. -* Copying from the ``TEXT`` field is 1.5x slower than the ``VARCHAR`` equivalent. This was fixed. -* ``TPCDS 10TB - Internal runtime error (std::bad_alloc: out of memory)`` occurs on 2020.1.0.2. This was fixed. -* An unequal join on non-existing ``TEXT`` caused a system crash. This was fixed. -* An ``Internal runtime time error`` occured when using ``TEXT (tpcds)``. This was fixed. -* Copying CSV with a quote in the middle of a field to a ``TEXT`` field does not produce the required error. This was fixed. -* Cannot monitor long network insert loads with SQream. This was fixed. -* Upper and like performance on ``TEXT``. This was fixed. -* Insert into from 4 instances would get stuck (hanging). This was fixed. -* An invalid formatted CSV would cause an insufficient memory error on a ``COPY FROM`` statement if a quote was not closed and the file was much larger than system memory. This was fixed. -* ``TEXT`` columns cannot be used with an outer join together with an inequality check (!= , <>). This was fixed. - -Known Issues And Limitations ----------- -The following list describes the known issues and limitations: - - -* Cast from ``TEXT`` to a ``DATE`` or ``DATETIME`` errors when the ``TEXT`` column contains ``NULL`` - -* Casting an empty ``TEXT`` field to an ``INT`` type returns ``0`` instead of erroring - -* Multiple ``COUNT( distinct ... )`` operations on the ``TEXT`` data type are currently unsupported - -* Multiple ``COUNT( distinct ... )`` operations within the same query are limited to "developer mode" due to an instability that was identified. If you rely on this feature, contact your SQream account manager to enable this feature. - - -Upgrading to v2020.3 ----------- - -Versions are available for IBM POWER9, RedHat (CentOS) 7, Ubuntu 18.04, and other OSs via Docker. - -Contact your account manager to get the latest release of SQream. diff --git a/releases/2020.3_index.rst b/releases/2020.3_index.rst deleted file mode 100644 index a662cb48a..000000000 --- a/releases/2020.3_index.rst +++ /dev/null @@ -1,19 +0,0 @@ -.. _2020.3_index: - -************************** -Release Notes 2020.3 -************************** -The 2020.3 release notes describe the following releases: - -.. contents:: - :local: - :depth: 1 - -.. toctree:: - :maxdepth: 1 - :glob: - - 2020.3.2.1 - 2020.3.2 - 2020.3.1 - 2020.3 \ No newline at end of file diff --git a/releases/2021.1.2.rst b/releases/2021.1.2.rst deleted file mode 100644 index ee33cfbd8..000000000 --- a/releases/2021.1.2.rst +++ /dev/null @@ -1,62 +0,0 @@ -.. _2021.1.2: - -************************** -Release Notes 2021.1.2 -************************** -The 2021.1.2 release notes were released on 8/9/2021 and describe the following: - -.. contents:: - :local: - :depth: 1 - -New Features -------------- -The 2021.1.2 Release Notes include the following new features: - -.. contents:: - :local: - :depth: 1 - -Aliases Added to SUBSTRING Function and Length Argument -************ -The following aliases have been added: - -* length - ``len`` -* substring - ``substr`` - -Data Type Aliases Added -************ -The following data type aliases have been added: - -* INTEGER - ``int`` -* DECIMAL - ``numeric`` -* DOUBLE PRECISION - ``double`` -* CHARACTER/CHAR - ``text`` -* NATIONAL CHARACTER/NATIONAL CHAR/NCHAR - ``text`` -* CHARACTER VARYING/CHAR VARYING - ``text`` -* NATIONAL CHARACTER VARYING/NATIONAL CHAR VARYING/NCHAR VARYING - ``text`` - -String Literals Containing ASCII Characters Interepreted as TEXT -************ -SQream now interprets all string literals, including those containing ASCII characters, as ``text``. - -For more information, see `String Types <https://docs.sqream.com/en/v2021.1.2/data_type_guides/sql_data_types_string.html>`_. - -Decimal Literals Interpreted as Numeric Columns -************ -SQream now interprets literals containing decimal points as ``numeric`` instead of as ``double``. - -For more information, see `Data Types <https://docs.sqream.com/en/v2021.1.2/data_type_guides/index.html>`_. - -Roles Area Added to Studio Version 5.4.3 -**************** -The **Roles** area has been added to `Studio version 5.4.3 <https://docs.sqream.com/en/v2021.1.2/sqream_studio_5.4.3/creating_assigning_and_managing_roles_and_permissions.html>`_. From the Roles area users can create and assign roles and manage user permissions. - -Resolved Issues -------------- -The following list describes the resolved issues: - -* In Parquet files, ``float`` columns could not be mapped to SQream ``double`` columns. This was fixed. -* The ``REPLACE`` function only supported constant values as arguments. This was fixed. -* The ``LIKE`` function did not check for incorrect patterns or handle escape characters. This was fixed. - diff --git a/releases/2021.1.rst b/releases/2021.1.rst deleted file mode 100644 index 02d5377d5..000000000 --- a/releases/2021.1.rst +++ /dev/null @@ -1,214 +0,0 @@ -.. _2021.1: - -************************** -Release Notes 2021.1 -************************** -The 2021.1 release notes were released on 6/13/2021 and describe the following: - -.. contents:: - :local: - :depth: 1 - - -Version Content ----------- -The 2021.1 Release Notes describes the following: - -* Major feature release targeted for all on-premises customers. -* Basic Cloud functionality. - - -New Features ----------- -The 2021.1 Release Notes include the following new features: - - - -.. contents:: - :local: - :depth: 1 - -SQream DB on Cloud -************ -SQream DB can now be run on AWS, GCP, and Azure. - -Numeric Data Types -************ -SQream now supports Numeric Data types for the following operations: - - * All join types. - * All aggregation types (not including Window functions). - * Scalar functions (not including some trigonometric and logarithmic functions). - -For more information, see `Numeric Data Types <https://docs.sqream.com/en/v2021.1/reference/sql_data_types.html#numeric-data-types.html>`_. - -Text Data Type -************ -SQream now supports TEXT data types in all operations, which is default string data type for new projects. - - - * Sqream supports VARCHAR functionalty, but recommends using TEXT. - - * TEXT data enhancements introduced in Release Notes version 2020.3.1: - - * Support text columns in queries with multiple distinct aggregates. - * Text literal support for all functions. - -For more information, see `String Types <https://docs.sqream.com/en/v2021.1/data_type_guides/sql_data_types_string.html>`_. - - -Supports Scalar Subqueries -************ -SQream now supports running initial scalar subqueries. - -For more information, see `Subqueries <https://docs.sqream.com/en/v2021.1/reference/sql/sql_syntax/subqueries.html>`_. - -Literal Arguments -************ - -SQream now supports literal arguments for functions in all cases where column/scalar arguments are supported. - -Simple Scalar SQL UDFs -************ -SQream now supports simple scalar SQL UDF's. - -For more information, see `Simple Scalar SQL UDF’s <https://docs.sqream.com/en/v2021.1/reference/sql/sql_functions/user_defined_functions/scalar_sql_udf.html>`_. - -Logging Enhancements -************ -The following log information has been added for the following events: - - * Compilation start time. - * When the first metadata callback in the compiler (if relevant). - * When the last metadata callback in the compiler (if relevant). - * When the log started attempting to apply locks. - * When a statement entered the queue. - * When a statement exited the queue. - * When a client has connected to an instance of **sqreamd** (if it reconnects). - * When the log started executing. - -Improved Presented License Information -************ -SQream now displays information related to data size limitations, expiration date, type of license shown by the new UF. The **Utility Function (UF)** name is ``get_license_info()``. - -For more information, see `GET_LICENSE_INFO <https://docs.sqream.com/en/v2021.1/reference/sql/sql_statements/utility_commands/get_license_info.html>`_. - - - - -Optimized Foreign Data Wrapper Export -************ -Sqream now supports exporting to multiple files concurrently. This is useful when you need to reduce file size to more easily export multiple files. - -The following is the correct syntax for exporting multiple files concurrently: - -.. code-block:: none - - COPY table_name TO fdw_name OPTIONS(max_file_size=size_in_bytes,enforce_single_file={TRUE|FALSE}); - -The following is an example of the correct syntax for exporting multiple files concurrently: - -.. code-block:: none - - COPY my_table1 TO my_ext_table OPTIONS(max_file_size=500000,enforce_single_file=TRUE); - -The following apply: - -* Both of the parameters in the above example are optional. - -* The ``max_file_size`` value is specified in bytes and can be any positive value. The default value is ``16*2^20`` (16MB). - -* When the ``enforce_single_file`` value is set to ``TRUE``, only one file is created, and its size is not limited by the ``max_file_size`` value. Its default value is ``TRUE``. - -Main Features --------- -The following list describes the main features: - -* SQreamDB available on AWS. -* SQreamDB available on GCP. -* SQreamDB available on Azure. -* SQream usages storage located on Object Store (as opposed to local disks) for the above three cloud providers. -* SQream now supports Microstrategy. -* Supports MVP licensing system. -* A new literal syntax containing character escape semantics for string literals has been added. -* Supports optimizing exporting foreign data wrappers. -* Supports truncating Numeric values when ingested from ORC and CSV files. -* Supports catalog Utility Function that accepts valid SQL patterns and escape characters. -* Supports creating a basic random data foreign data wrapper for non-text types. -* The new foreign data wrapper ``random_fdw`` has been introduced for non-text types. -* Supports simple scalar SQL UDF's. -* SQream parses its own logs as CSV's. - - -Resolved Issues ---------- -The following list describes the resolved issues: - -* Copying text from a CSV file to the TEXT column without closing quotes caused SQream to crash. This was fixed. -* Using an unsupported function call generated an incorrect insert error. This was fixed. -* Using the ``insert into`` function from ``table_does_not_exist`` generated an incorrect error. -* SQream treated inserting ``*`` in ``select_distinct`` as one column. This was fixed. -* Using certain encodeKey functions generated errors. This was fixed. -* Compile errors occurred while running decimal datatype sets. This was fixed. -* Running the ``select table_name,row_count from sqream_catalog.tables order by row_count limit 5`` query generated an internal runtime error. -* Using wildcards (such as ``*.x.y``) did not work in parquet files. This was fixed. -* Executing ``log*(x,y)`` generated an incorrect error message. This was fixed. -* The ``internal runtime error`` type doesn't have a fixed size when doing max on text on develop. -* The ``min`` and ``max`` on ``TEXT`` were significantly slower than ``varchar``. This was fixed. -* Running ``regexp_instr`` generated an empty regular expression. This was fixed. -* Schemas with foreign tables could be dropped. This was fixed. - - - - - - - - - -Operations and Configuration Changes --------- -Recommended SQream Configuration on Cloud -************ - -For more information about AWS, see `Amazon S3 <https://docs.sqream.com/en/v2021.1/operational_guides/s3.html>`_. - - - - -Optimized Foreign Data Wrapper Export Configuration Flag -************ - -SQream now has a new ``runtimeGlobalFlags`` flag called ``WriteToFileThreads``. - -This flag configures the number of threads in the **WriteToFile** function. The default value is ``16``. - -For more information about the ``runtimeGlobalFlags`` flag, see the **Runtime Global Flags** table in `Configuration <https://docs.sqream.com/en/v2021.1/configuration_guides/index.html>`_. - - - - -Naming Changes -------- -No relevant naming changes were made. - -Deprecated Features -------- -No features were depecrated. - -Known Issues and Limitations --------- -The the list below describes the following known issues and limitations: - -* In cases when selecting top 1 from foreign table using the Parquet format with an hdfs path, SQream experienced an error. -* Internal Runtime Error occurred when SQream was unable to find column in reorder columns. -* Casting datetime to text truncates the time segment. -* In the **select** list, the compiler generates an error when a count is used as an alias. -* Performance degradation occurred when joins made on small tables. -* SQream causes a logging error when using copy from logs. -* Deploying S3 requires setting the ``ObjectStoreClients`` parameter to ``40``. - -Upgrading to v2021.1 -------- -Due to the known issue of a limitation on the amount of access requests that can be simultaneously sent to AWS, deploying S3 requires setting the ``ObjectStoreClients`` parameter to ``40``. - diff --git a/releases/2021.1_index.rst b/releases/2021.1_index.rst deleted file mode 100644 index 64b06e1d1..000000000 --- a/releases/2021.1_index.rst +++ /dev/null @@ -1,18 +0,0 @@ -.. _2021.1_index: - -************************** -Release Notes 2021.1 -************************** -The 2021.1 Release Notes describe the following releases: - -.. contents:: - :local: - :depth: 1 - -.. toctree:: - :maxdepth: 1 - :glob: - - 2021.1.2 - 2021.1.1 - 2021.1 \ No newline at end of file diff --git a/releases/2021.2.1.24.rst b/releases/2021.2.1.24.rst deleted file mode 100644 index 2016dd564..000000000 --- a/releases/2021.2.1.24.rst +++ /dev/null @@ -1,85 +0,0 @@ -.. _2021.2.1.24: - -************************** -Release Notes 2021.2.1.24 -************************** -The 2021.2.1.24 release notes were released on 7/28/2022 and describe the following: - -.. contents:: - :local: - :depth: 1 - -Version Content ----------- -The 2021.2.1.24 Release Notes includes a query maintenance feature. - -New Features ----------- -The 2021.2.1.24 Release Notes include the following new features: - -.. contents:: - :local: - :depth: 1 - -Query Healer -************ -The new **Query Healer** feature periodically examines the progress of running statements, and is used for query maintenance. - -For more information, see `Query Healer <https://docs.sqream.com/en/v2021.2.1.24/feature_guides/query_healer.html>`_. - -Resolved Issues ---------- -The following table lists the resolved issues for Version 2021.2.1.24: - -+-------------+------------------------------------------------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+=============+====================================================================================================================================+ -| SQ-10606 | Queries were getting stuck in the queue for a prolonged time. | -+-------------+------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10691 | The DB schema identifier was causing an error when running queries from joins suite. | -+-------------+------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10918 | The Workload Manager was only assigning jobs sequentially, delaying user SQLs assigned to workers running very large jobs. | -+-------------+------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10955 | Metadata filters were not being applied when users filtered by nullable dates using ``dateadd`` | -+-------------+------------------------------------------------------------------------------------------------------------------------------------+ - -Known Issues ---------- -The following table lists the known issues for Version 2021.2.1.24: - -+-------------+------------------------------------------------------------------------------------------------------------------------------------+ -| **SQ No.** | **Description** | -+=============+====================================================================================================================================+ -| SQ-10071 | An error occurred on existing subqueries with ``TEXT`` and ``VARCHAR`` equality conditions. | -+-------------+------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-10902 | Inserting a null value into non-null column was causing SQream to crash. | -+-------------+------------------------------------------------------------------------------------------------------------------------------------+ -| SQ-11088 | Specific workers caused low performance during compilation. | -+-------------+------------------------------------------------------------------------------------------------------------------------------------+ - -Operations and Configuration Changes --------- -The following worker level configuration flags were added: - - * :ref:`is_healer_on` - - :: - - * :ref:`healer_max_statement_inactivity_seconds` - - :: - - * :ref:`healer_detection_frequency_seconds` - -Naming Changes -------- -No relevant naming changes were made. - -Deprecated Features -------- -Version 2021.2.1.24 includes no deprecated features. - -End of Support -------- -The End of Support section is not relevant to Version 2021.2.1.24. - diff --git a/releases/2021.2.1.rst b/releases/2021.2.1.rst deleted file mode 100644 index d50f1084e..000000000 --- a/releases/2021.2.1.rst +++ /dev/null @@ -1,80 +0,0 @@ -.. _2021.2.1: - -************************** -Release Notes 2021.2.1 -************************** -The 2021.2.1 release notes were released on 15/12/2021 and describes the following: - -.. contents:: - :local: - :depth: 1 - -New Features -------------- -The 2021.2.1 Release Notes include the following new features: - -.. contents:: - :local: - :depth: 1 - -CREATE TABLE -************ -SQream now supports duplicating the column structure of an existing table using the ``LIKE`` clause. - -For more information, see `Duplicating the Column Structure of an Existing Table <https://docs.sqream.com/en/v2021.2.1/reference/sql/sql_statements/ddl_commands/create_table.html#duplicating-the-column-structure-of-an-existing-table>`_. - -PERCENTILE FUNCTIONS -************ -SQream now supports the following aggregation functions: - -* `PERCENTILE_CONT <https://docs.sqream.com/en/v2021.2.1/reference/sql/sql_functions/aggregate_functions/percentile_cont.html>`_ -* `PERCENTILE_DISC <https://docs.sqream.com/en/v2021.2.1/reference/sql/sql_functions/aggregate_functions/percentile_disc.html>`_ -* `MODE <https://docs.sqream.com/en/v2021.2.1/reference/sql/sql_functions/aggregate_functions/mode.html>`_ - -REGEX REPLACE -************ -SQream now supports the ``REGEXP_REPLACE`` function for finding and replacing text column substrings. - -For more information, see `REGEX_REPLACE <https://docs.sqream.com/en/v2021.2.1/reference/sql/sql_functions/scalar_functions/string/regexp_replace.html>`_. - -Delete Optimization -************ -The ``DELETE`` statement can now delete values that contain multi-table conditions. - -For more information, see `Deleting Values that Contain Multi-Table Conditions <https://docs.sqream.com/en/v2021.2.1/reference/sql/sql_statements/dml_commands/delete.html#deleting-values-that-contain-multi-table-conditions>`_. - -For more information, see `REGEX_REPLACE <https://docs.sqream.com/en/v2021.2.1/reference/sql/sql_functions/scalar_functions/string/regexp_replace.html>`_. - -Performance Enhancements ------- -The **Performance Enhancements** section is not relevant to Version 2021.2.1. - -Resolved Issues -------------- -The following table lists the issues that were resolved in Version 2021.2.1: - -.. list-table:: - :widths: 17 200 - :header-rows: 1 - - * - SQ No. - - Description - * - SQ-8267 - - A method has been provided for including the ``GROUP BY`` and ``DISTINCT COUNT`` statements. - -Known Issues ------- -The **Known Issues** section is not relevant to 2021.2.1. - -Naming Convention Modifications ------- -The **Naming Convention Modifications** section is not relevant to Version 2021.2.1. - -End of Support ------- -The **End of Support** section is not relevant to Version 2021.2.1. - -Deprecated Features ------- -The **Deprecated Components** section is not relevant to Version 2021.2.1. - diff --git a/releases/2021.2.rst b/releases/2021.2.rst deleted file mode 100644 index f95de16a5..000000000 --- a/releases/2021.2.rst +++ /dev/null @@ -1,170 +0,0 @@ -.. _2021.2: - -************************** -Release Notes 2021.2 -************************** -The 2021.2 release notes were released on 13/9/2021. - -.. contents:: - :local: - :depth: 1 - -New Features ----------- -The 2021.2 Release Notes include the following new features: - -.. contents:: - :local: - :depth: 1 - -New Driver Compatibility -************ -The 2021.2 release supports the following drivers: - -* **JDBC** - new driver version (JDBC 4.5) with important bug fixes. -* **ODBC** - ODBC 4.1.1. available on request. -* **NodeJS** - all versions starting with NodeJS 4.0. SQream recommends the latest version (NodeJS 4.2.4). -* **Dot Net** - SQream recommends version version 3.02 (compatible with DotNet version 48). -* **Pysqream** - pysqream 3.1.2 - -Centralized Configuration System -************ -SQream now uses a new configuration system based on centralized configuration accessible from SQream Studio. - -For more information, see the following: - -* `Configuration <https://docs.sqream.com/en/v2021.2/guides/operations/configuration.html>`_ - describes how to configure your instance of SQream from a centralized location. -* `SQream Studio 5.4.3 <https://docs.sqream.com/en/v2021.2/sqream_studio_5.4.3/index.html>`_ - configure your instance of SQream from Studio. - -Qualifying Schemas Without Providing an Alias -************ -When running queries, SQream now supports qualifying schemas without providing an alias. - -For more information, see `SQream Studio 5.4.3 <https://docs.sqream.com/en/v2021.2/reference/sql/sql_statements/ddl_commands/create_schema.html>`_. - -Double-Quotations Supported When Importing and Exporting CSVs -************ -When importing and exporting CSVs, SQream now supports using quotation characters other than double quotation marks (``"``). - -For more information, see the following: - -* `COPY_FROM <https://docs.sqream.com/en/v2021.2/reference/sql/sql_statements/dml_commands/copy_from.html#copy-from>`_ - -* `COPY_TO <https://docs.sqream.com/en/v2021.2/reference/sql/sql_statements/dml_commands/copy_to.html#copy-to>`_ - - - -Note the following: - -* Leaving *<x>* unspecified uses the default value of standard double quotations ``”``. - - :: - -* The quotation character must be a single, 1-byte printable ASCII character. The same octal syntax of the copy command can be used. - - :: - -* The quote character cannot be contained in the field delimiter, record delimiter, or null marker. - - :: - -* Double-quotations can be customized when the ``csv_fdw`` value is used with the ``COPY FROM`` and ``CREATE FOREIGN TABLE`` statements. - - :: - -* The default escape character always matches the quote character, and can be overridden by using the ``ESCAPE = {'\\' | E'\XXX')`` syntax as shown in the following examples: - - .. code-block:: postgres - - copy t from wrapper csv_fdw options (location = '/tmp/file.csv', escape='\\'); - - .. code-block:: postgres - - copy t from wrapper csv_fdw options (location = '/tmp/file.csv', escape=E'\017'); - - .. code-block:: postgres - - copy t to wrapper csv_fdw options (location = '/tmp/file.csv', escape='\\'); - -For more information, see the following statements: - - -* `COPY_FROM <https://docs.sqream.com/en/v2021.2/reference/sql/sql_statements/dml_commands/copy_from.html#copy-from>`_ - -* `CREATE_FOREIGN_TABLE <https://docs.sqream.com/en/v2021.2/reference/sql/sql_statements/ddl_commands/create_foreign_table.html>`_ - -Performance Enhancements ------- -In Version 2021.2, an advanced smart spooling mechanism splits spool memory based on required CP usage. - -Resolved Issues ------- -The following table lists the issues that were resolved in Version 2021.2: - -.. list-table:: - :widths: 17 200 - :header-rows: 1 - - * - SQ No. - - Description - * - SQ-8294 - - Quote qualifiers were not present in exported file, preventing it from being reloaded. - * - SQ-8288 - - Saved ``TEXT`` query parameters were not supported. - * - SQ-8266 - - A data loading issue occurred related to column order. - - -Known Issues ------- -The **Known Issues** section is not relevant to Version 2021.2. - - -Naming Convention Modifications ------- -The **Naming Convention Modifications** describes SQream features, such as data types or statements, that have been renamed. - -NVARCHAR Data Type Renamed TEXT -************ -The ``NVARCHAR`` data type has been renamed ``TEXT``. - - -For more information on the ``TEXT`` data type, see `String (TEXT) <https://docs.sqream.com/en/v2021.2/data_type_guides/sql_data_types_string.html>`_ - -End of Support ------- -The **End of Support** section is not relevant to Version 2021.2. - -Deprecated Features ------- -The **Deprecated Components** section is not relevant to Version 2021.2. - -Upgrading Your SQream Version ------- -The **Upgrading Your SQream Version** section describes the following: - -.. contents:: - :local: - :depth: 1 - -Upgrading Your Storage Version -************ -When upgrading from a SQream version earlier than 2021.2 you must upgrade your storage version, as shown in the following example: - - .. code-block:: console - - $ cat /etc/sqream/sqream1_config.json |grep cluster - $ ./upgrade_storage <cluster path> - -For more information on upgrading your SQream version, see `Upgrading SQream Version <https://docs.sqream.com/en/v2021.2/guides/operations/installing_sqream_with_binary.html#upgrading-sqream-version>`_. - -Upgrading Your Client Drivers -************ -For more information on the client drivers for version 2021.2, see `Client Drivers for 2021.2 <https://docs.sqream.com/en/v2021.2/connecting_to_sqream/client_drivers/index.html>`_. - -Configuring Your Instance of SQream -************ -A new configuration method is used starting with Version 2021.2. - -For more information about configuring your instance of SQream, see `Client Drivers for 2021.2 <https://docs.sqream.com/en/v2021.2/configuration_guides/index.html>`_. - diff --git a/releases/2021.2_index.rst b/releases/2021.2_index.rst deleted file mode 100644 index 9bee5fd66..000000000 --- a/releases/2021.2_index.rst +++ /dev/null @@ -1,18 +0,0 @@ -.. _2021.2_index: - -************************** -Release Notes 2021.2 -************************** -The 2021.2 Release Notes describe the following releases: - -.. contents:: - :local: - :depth: 1 - -.. toctree:: - :maxdepth: 1 - :glob: - - 2021.2.1.24 - 2021.2.1 - 2021.2 \ No newline at end of file diff --git a/releases/index.rst b/releases/index.rst index 0ce60dfe7..a945c97ec 100644 --- a/releases/index.rst +++ b/releases/index.rst @@ -31,4 +31,4 @@ Release Notes 4.0_index 2022.1_index - 2021.2_index + From a9484907f0bcd2e725227728cdd93b2bea9f5b26 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 18 Apr 2024 16:23:31 +0300 Subject: [PATCH 825/882] Maintenance --- configuration_guides/cache_persistent_gb.rst | 5 +- .../copy_to_restrict_utf8.rst | 5 +- .../cuda_mem_cpy_max_size_bytes.rst | 5 +- configuration_guides/cuda_mem_quota.rst | 5 +- configuration_guides/flip_join_order.rst | 5 +- configuration_guides/graceful_shutdown.rst | 2 - .../client_platforms/informatica.rst | 48 +--- data_type_guides/sql_data_types_boolean.rst | 6 +- data_type_guides/sql_data_types_date.rst | 9 +- .../sql_data_types_floating_point.rst | 8 +- data_type_guides/sql_data_types_integer.rst | 7 +- external_storage_platforms/index.rst | 9 +- operational_guides/hdfs.rst | 265 ------------------ operational_guides/s3.rst | 129 --------- 14 files changed, 43 insertions(+), 465 deletions(-) delete mode 100644 operational_guides/hdfs.rst delete mode 100644 operational_guides/s3.rst diff --git a/configuration_guides/cache_persistent_gb.rst b/configuration_guides/cache_persistent_gb.rst index 418364e5c..ff223b299 100644 --- a/configuration_guides/cache_persistent_gb.rst +++ b/configuration_guides/cache_persistent_gb.rst @@ -1,8 +1,9 @@ .. _cache_persistent_gb: -************************* +***************************************** Setting Data Stored Persistently on Cache -************************* +***************************************** + The ``cachePersistentGB`` flag sets the amount of data (GB) for the cache to store persistently . The following describes the ``cachePersistentGB`` flag: diff --git a/configuration_guides/copy_to_restrict_utf8.rst b/configuration_guides/copy_to_restrict_utf8.rst index 869de3bea..66ee4ab72 100644 --- a/configuration_guides/copy_to_restrict_utf8.rst +++ b/configuration_guides/copy_to_restrict_utf8.rst @@ -1,8 +1,9 @@ .. _copy_to_restrict_utf8: -************************* +************************************* Enabling High Bin Control Granularity -************************* +************************************* + The ``copyToRestrictUtf8`` flag sets the custom bin size in the cache to enable high bin control granularity. The following describes the ``copyToRestrictUtf8`` flag: diff --git a/configuration_guides/cuda_mem_cpy_max_size_bytes.rst b/configuration_guides/cuda_mem_cpy_max_size_bytes.rst index 371c9bda4..9c7de07ce 100644 --- a/configuration_guides/cuda_mem_cpy_max_size_bytes.rst +++ b/configuration_guides/cuda_mem_cpy_max_size_bytes.rst @@ -1,8 +1,9 @@ .. _cuda_mem_cpy_max_size_bytes: -************************* +********************************************** Setting Chunk Size for Copying from CPU to GPU -************************* +********************************************** + The ``cudaMemcpyMaxSizeBytes`` flag sets the chunk size for copying from CPU to GPU. If this value is set to ``0``, do not divide. The following describes the ``cudaMemcpyMaxSizeBytes`` flag: diff --git a/configuration_guides/cuda_mem_quota.rst b/configuration_guides/cuda_mem_quota.rst index 43f9d4943..b659c566d 100644 --- a/configuration_guides/cuda_mem_quota.rst +++ b/configuration_guides/cuda_mem_quota.rst @@ -1,8 +1,9 @@ .. _cuda_mem_quota: -************************* +**************************************************** Setting Total Device Memory Usage in SQream Instance -************************* +**************************************************** + The ``cudaMemQuota`` flag sets the percentage of total device memory used by your instance of SQream. The following describes the ``cudaMemQuota`` flag: diff --git a/configuration_guides/flip_join_order.rst b/configuration_guides/flip_join_order.rst index 341f12ada..d160beb5a 100644 --- a/configuration_guides/flip_join_order.rst +++ b/configuration_guides/flip_join_order.rst @@ -1,8 +1,9 @@ .. _flip_join_order: -************************* +************************************** Flipping Join Order to Force Equijoins -************************* +************************************** + The ``flipJoinOrder`` flag reorders join to force equijoins and/or equijoins sorted by table size. The following describes the ``flipJoinOrder`` flag: diff --git a/configuration_guides/graceful_shutdown.rst b/configuration_guides/graceful_shutdown.rst index 8b4f4b55c..9be60d095 100644 --- a/configuration_guides/graceful_shutdown.rst +++ b/configuration_guides/graceful_shutdown.rst @@ -17,6 +17,4 @@ For related flags, see the folowing: * :ref:`is_healer_on` - :: - * :ref:`healer_max_inactivity_hours` \ No newline at end of file diff --git a/connecting_to_sqream/client_platforms/informatica.rst b/connecting_to_sqream/client_platforms/informatica.rst index ec39a0129..bf6bfe53a 100644 --- a/connecting_to_sqream/client_platforms/informatica.rst +++ b/connecting_to_sqream/client_platforms/informatica.rst @@ -21,13 +21,9 @@ The **Establishing a Connection between SQream and Informatica** page describes 1. Go to the `Informatica Cloud homepage <https://emw1.dm-em.informaticacloud.com/diUI/products/integrationDesign/main/home>`_. - :: - 2. Do one of the following: 1. Log in using your credentials. - - :: 2. Log in using your SAML Identity Provider. @@ -36,26 +32,16 @@ The **Establishing a Connection between SQream and Informatica** page describes The SQream dashboard is displayed. - - :: - - 4. In the menu on the left, click **Runtime Environments**. The **Runtime Environments** panel is displayed. - :: - 5. Click **Download Secure Agent**. - :: - 6. When the **Download the Secure Agent** panel is displayed, do the following: 1. Select a platform (Windows 64 or Linux 64). - - :: 2. Click **Copy** and save the token on your local hard drive. @@ -66,27 +52,18 @@ The **Establishing a Connection between SQream and Informatica** page describes 7. Click **Download**. The installation begins. - - :: + 8. When the **Informatica Cloud Secure Agent Setup** panel is displayed, click **Next**. - :: - - 9. Provide your **User Name** and **Install Token** and click **Register**. - :: - - 10. From the Runtime Environments panel, click **New Runtime Environment**. The **New Secure Agent Group** window is displayed. - - :: 11. On the New Secure Agent Group window, click **OK** to connect your Runtime Environment with the running agent. @@ -107,24 +84,16 @@ After establishing a connection between SQream and Informatica you can establish **To establish an ODBC connection in your environment:** 1. Click **Add**. - - :: 2. Click **Configure**. .. note:: Verify that **Use Server Picker** is selected. 3. Click **Test**. - - :: 4. Verify that the connection has tested successfully. - - :: 5. Click **Save**. - - :: 6. Click **Actions** > **Publish**. @@ -137,27 +106,18 @@ After establishing a connection between SQream and Informatica you can establish 1. Create a new DB connection by clicking **Connections** > **New Connection**. The **New Connection** window is displayed. - - :: 2. In the **JDBC_IC Connection Properties** section, in the **JDBC Connection URL** field, establish a JDBC connection by providing the correct connection string. - For connection string examples, see `Connection Strings <https://docs.sqream.com/en/v2022.1/connecting_to_sqream/client_drivers/jdbc/index.html#connection-string-examples>`_. - - :: + For connection string examples, see :ref:`Connection Strings<java_jdbc>`. + 3. Click **Test**. - - :: 4. Verify that the connection has tested successfully. - - :: 5. Click **Save**. - - :: 6. Click **Actions** > **Publish**. @@ -168,6 +128,4 @@ SQream supports the following SQream driver versions: * **JDBC** - Version 4.3.4 and above. - :: - * **ODBC** - Version 4.0.0 and above. diff --git a/data_type_guides/sql_data_types_boolean.rst b/data_type_guides/sql_data_types_boolean.rst index 84b7c14ce..8142ae6f6 100644 --- a/data_type_guides/sql_data_types_boolean.rst +++ b/data_type_guides/sql_data_types_boolean.rst @@ -3,6 +3,7 @@ ************************* Boolean ************************* + The following table describes the Boolean data type. .. list-table:: @@ -17,7 +18,8 @@ The following table describes the Boolean data type. - 1 byte, but resulting average data sizes may be lower after compression. Boolean Examples -^^^^^^^^^^ +^^^^^^^^^^^^^^^^ + The following is an example of the Boolean syntax: .. code-block:: postgres @@ -37,7 +39,7 @@ The following is an example of the correct output: "kiwi","Is not angry" Boolean Casts and Conversions -^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The following table shows the possible Boolean value conversions: diff --git a/data_type_guides/sql_data_types_date.rst b/data_type_guides/sql_data_types_date.rst index d25d2a7b8..4bd7d25a5 100644 --- a/data_type_guides/sql_data_types_date.rst +++ b/data_type_guides/sql_data_types_date.rst @@ -3,11 +3,13 @@ ************************* Date ************************* + ``DATE`` is a type designed for storing year, month, and day. ``DATETIME`` is a type designed for storing year, month, day, hour, minute, seconds, and milliseconds in UTC with 1 millisecond precision. Date Types ^^^^^^^^^^^^^^^^^^^^^^ + The following table describes the Date types: .. list-table:: Date Types @@ -35,6 +37,7 @@ Aliases Syntax ^^^^^^^^ + ``DATE`` values are formatted as string literals. The following is an example of the DATETIME syntax: @@ -60,12 +63,14 @@ SQream attempts to guess if the string literal is a date or datetime based on co Size ^^^^^^ + A ``DATE`` column is 4 bytes in length, while a ``DATETIME`` column is 8 bytes in length. However, the size of these values is compressed by SQream DB. Date Examples -^^^^^^^^^^ +^^^^^^^^^^^^^ + The following is an example of the Date syntax: .. code-block:: postgres @@ -97,7 +102,7 @@ The following is an example of the correct output: Date Casts and Conversions -^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^ The following table shows the possible ``DATE`` and ``DATETIME`` value conversions: diff --git a/data_type_guides/sql_data_types_floating_point.rst b/data_type_guides/sql_data_types_floating_point.rst index 3edc8362d..4ea388dd7 100644 --- a/data_type_guides/sql_data_types_floating_point.rst +++ b/data_type_guides/sql_data_types_floating_point.rst @@ -3,12 +3,14 @@ ************************* Floating Point ************************* + The **Floating Point** data types (``REAL`` and ``DOUBLE``) store extremely close value approximations, and are therefore recommended for values that tend to be inexact, such as Scientific Notation. While Floating Point generally runs faster than Numeric, it has a lower precision of ``9`` (``REAL``) or ``17`` (``DOUBLE``) compared to Numeric's ``38``. For operations that require a higher level of precision, using :ref:`Numeric <numeric>` is recommended. The floating point representation is based on `IEEE 754 <https://en.wikipedia.org/wiki/IEEE_754>`_. Floating Point Types ^^^^^^^^^^^^^^^^^^^^^^ + The following table describes the Floating Point data types. .. list-table:: @@ -42,7 +44,8 @@ The following table shows information relevant to the Floating Point data types. - Floating point types are either 4 or 8 bytes, but size could be lower after compression. Floating Point Examples -^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^ + The following are examples of the Floating Point syntax: .. code-block:: postgres @@ -61,7 +64,8 @@ The following are examples of the Floating Point syntax: .. note:: Most SQL clients control display precision of floating point numbers, and values may appear differently in some clients. Floating Point Casts and Conversions -^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + The following table shows the possible Floating Point value conversions: .. list-table:: diff --git a/data_type_guides/sql_data_types_integer.rst b/data_type_guides/sql_data_types_integer.rst index cd27f6956..24ace31b9 100644 --- a/data_type_guides/sql_data_types_integer.rst +++ b/data_type_guides/sql_data_types_integer.rst @@ -3,12 +3,14 @@ ************************* Integer ************************* + Integer data types are designed to store whole numbers. For more information about identity sequences (sometimes called auto-increment or auto-numbers), see :ref:`identity`. Integer Types ^^^^^^^^^^^^^^^^^^^ + The following table describes the Integer types. .. list-table:: @@ -48,7 +50,8 @@ The following table describes the Integer data type. - Integer types range between 1, 2, 4, and 8 bytes - but resulting average data sizes could be lower after compression. Integer Examples -^^^^^^^^^^ +^^^^^^^^^^^^^^^^ + The following is an example of the Integer syntax: .. code-block:: postgres @@ -67,7 +70,7 @@ The following is an example of the correct output: -5,127,32000,45000000000 Integer Casts and Conversions -^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The following table shows the possible Integer value conversions: diff --git a/external_storage_platforms/index.rst b/external_storage_platforms/index.rst index bec142ce0..ec8aaf2d0 100644 --- a/external_storage_platforms/index.rst +++ b/external_storage_platforms/index.rst @@ -1,8 +1,9 @@ .. _external_storage_platforms: -*********************** +************************** External Storage Platforms -*********************** +************************** + SQream supports the following external storage platforms: .. toctree:: @@ -19,11 +20,7 @@ SQream supports the following external storage platforms: For more information, see the following: * :ref:`foreign_tables` - - :: * :ref:`copy_from` - - :: * :ref:`copy_to` diff --git a/operational_guides/hdfs.rst b/operational_guides/hdfs.rst deleted file mode 100644 index e59c49cc7..000000000 --- a/operational_guides/hdfs.rst +++ /dev/null @@ -1,265 +0,0 @@ -.. _hdfs: - -.. _back_to_top_hdfs: - -Using SQream in an HDFS Environment -======================================= - -.. _configuring_an_hdfs_environment_for_the_user_sqream: - -Configuring an HDFS Environment for the User **sqream** ----------------------------------------------------------- - -This section describes how to configure an HDFS environment for the user **sqream** and is only relevant for users with an HDFS environment. - -**To configure an HDFS environment for the user sqream:** - -1. Open your **bash_profile** configuration file for editing: - - .. code-block:: console - - $ vim /home/sqream/.bash_profile - -.. - Comment: - see below; do we want to be a bit more specific on what changes we're talking about? - - .. code-block:: console - - $ #PATH=$PATH:$HOME/.local/bin:$HOME/bin - - $ #export PATH - - $ # PS1 - $ #MYIP=$(curl -s -XGET "http://ip-api.com/json" | python -c 'import json,sys; jstr=json.load(sys.stdin); print jstr["query"]') - $ #PS1="\[\e[01;32m\]\D{%F %T} \[\e[01;33m\]\u@\[\e[01;36m\]$MYIP \[\e[01;31m\]\w\[\e[37;36m\]\$ \[\e[1;37m\]" - - $ SQREAM_HOME=/usr/local/sqream - $ export SQREAM_HOME - - $ export JAVA_HOME=${SQREAM_HOME}/hdfs/jdk - $ export HADOOP_INSTALL=${SQREAM_HOME}/hdfs/hadoop - $ export CLASSPATH=`${HADOOP_INSTALL}/bin/hadoop classpath --glob` - $ export HADOOP_COMMON_LIB_NATIVE_DIR=${HADOOP_INSTALL}/lib/native - $ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${SQREAM_HOME}/lib:$HADOOP_COMMON_LIB_NATIVE_DIR - - - $ PATH=$PATH:$HOME/.local/bin:$HOME/bin:${SQREAM_HOME}/bin/:${JAVA_HOME}/bin:$HADOOP_INSTALL/bin - $ export PATH - -2. Verify that the edits have been made: - - .. code-block:: console - - source /home/sqream/.bash_profile - -3. Check if you can access Hadoop from your machine: - - .. code-block:: console - - $ hadoop fs -ls hdfs://<hadoop server name or ip>:8020/ - -.. - Comment: - - **NOTICE:** If you cannot access Hadoop from your machine because it uses Kerberos, see `Connecting a SQream Server to Cloudera Hadoop with Kerberos <https://sqream.atlassian.net/wiki/spaces/DOC/pages/822902789/How+to+connect+sqream+server+to+Cloudera+Hadoop+with+kerberos>`_ - - -4. Verify that an HDFS environment exists for SQream services: - - .. code-block:: console - - $ ls -l /etc/sqream/sqream_env.sh - -.. _step_6: - - -5. If an HDFS environment does not exist for SQream services, create one (sqream_env.sh): - - .. code-block:: console - - $ #!/bin/bash - - $ SQREAM_HOME=/usr/local/sqream - $ export SQREAM_HOME - - $ export JAVA_HOME=${SQREAM_HOME}/hdfs/jdk - $ export HADOOP_INSTALL=${SQREAM_HOME}/hdfs/hadoop - $ export CLASSPATH=`${HADOOP_INSTALL}/bin/hadoop classpath --glob` - $ export HADOOP_COMMON_LIB_NATIVE_DIR=${HADOOP_INSTALL}/lib/native - $ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${SQREAM_HOME}/lib:$HADOOP_COMMON_LIB_NATIVE_DIR - - - $ PATH=$PATH:$HOME/.local/bin:$HOME/bin:${SQREAM_HOME}/bin/:${JAVA_HOME}/bin:$HADOOP_INSTALL/bin - $ export PATH - -:ref:`Back to top <back_to_top_hdfs>` - -.. _authenticate_hadoop_servers_that_require_kerberos: - -Authenticating Hadoop Servers that Require Kerberos ---------------------------------------------------- -If your Hadoop server requires Kerberos authentication, do the following: - -1. Create a principal for the user **sqream**. - - .. code-block:: console - - $ kadmin -p root/admin@SQ.COM - $ addprinc sqream@SQ.COM - -2. If you do not know yor Kerberos root credentials, connect to the Kerberos server as a root user with ssh and run **kadmin.local**: - - .. code-block:: console - - $ kadmin.local - - Running **kadmin.local** does not require a password. - -3. If a password is not required, change your password to **sqream@SQ.COM**. - - .. code-block:: console - - $ change_password sqream@SQ.COM - -4. Connect to the hadoop name node using ssh: - - .. code-block:: console - - $ cd /var/run/cloudera-scm-agent/process - -5. Check the most recently modified content of the directory above: - - .. code-block:: console - - $ ls -lrt - -6. Look for a recently updated folder containing the text **hdfs**. - - The following is an example of the correct folder name: - - .. code-block:: console - - cd <number>-hdfs-<something> - - This folder should contain a file named **hdfs.keytab** or another similar .keytab file. - - - -.. - Comment: - Does "something" need to be replaced with "file name" - - -7. Copy the .keytab file to user **sqream's** Home directory on the remote machines that you are planning to use Hadoop on. - - :: - -8. Copy the following files to the **sqream sqream@server:<sqream folder>/hdfs/hadoop/etc/hadoop:** directory: - - * core-site.xml - * hdfs-site.xml - -9. Connect to the sqream server and verify that the .keytab file's owner is a user sqream and is granted the correct permissions: - - .. code-block:: console - - $ sudo chown sqream:sqream /home/sqream/hdfs.keytab - $ sudo chmod 600 /home/sqream/hdfs.keytab - -10. Log into the sqream server. - - :: - -11. Log in as the user **sqream**. - - :: - -12. Navigate to the Home directory and check the name of a Kerberos principal represented by the following .keytab file: - - .. code-block:: console - - $ klist -kt hdfs.keytab - - The following is an example of the correct output: - - .. code-block:: console - - $ sqream@Host-121 ~ $ klist -kt hdfs.keytab - $ Keytab name: FILE:hdfs.keytab - $ KVNO Timestamp Principal - $ ---- ------------------- ------------------------------------------------------ - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM - -13. Verify that the hdfs service named **hdfs/nn1@SQ.COM** is shown in the generated output above. - - :: - -14. Run the following: - - .. code-block:: console - - $ kinit -kt hdfs.keytab hdfs/nn1@SQ.COM - -15. Verify that the output is correct: - - .. code-block:: console - - $ klist - - The following is an example of the correct output: - - .. code-block:: console - - $ Ticket cache: FILE:/tmp/krb5cc_1000 - $ Default principal: sqream@SQ.COM - $ - $ Valid starting Expires Service principal - $ 09/16/2020 13:44:18 09/17/2020 13:44:18 krbtgt/SQ.COM@SQ.COM - -16. List the files located at the defined server name or IP address: - - .. code-block:: console - - $ hadoop fs -ls hdfs://<hadoop server name or ip>:8020/ - -17. Do one of the following: - - :: - - * If the list below is output, continue with Step 18. - - :: - - * If the list is not output, verify that your environment has been set up correctly. - -If any of the following are empty, verify that you followed :ref:`Step 6 <step_6>` in the **Configuring an HDFS Environment for the User sqream** section above correctly: - - .. code-block:: console - - $ echo $JAVA_HOME - $ echo $SQREAM_HOME - $ echo $CLASSPATH - $ echo $HADOOP_COMMON_LIB_NATIVE_DIR - $ echo $LD_LIBRARY_PATH - $ echo $PATH - -18. Verify that you copied the correct keytab file. - - :: - -19. Review this procedure to verify that you have followed each step. - -:ref:`Back to top <back_to_top_hdfs>` \ No newline at end of file diff --git a/operational_guides/s3.rst b/operational_guides/s3.rst deleted file mode 100644 index 5e4f8b264..000000000 --- a/operational_guides/s3.rst +++ /dev/null @@ -1,129 +0,0 @@ -.. _s3: - -*********************** -Inserting Data Using Amazon S3 -*********************** -SQream uses a native S3 connector for directly inserting data from a number of external sources directly into SQream. This is done using the ``s3://`` URI to specify an external file path on an S3 bucket. Your files can be saved in CSV or columnar format, such as Parquet and ORC, and your file names can include wildcard characters. - -The **Amazon S3** page describes the following topics: - -.. contents:: - :local: - :depth: 1 - -Configuring Amazon S3 -============================== -Any database host with access to S3 endpoints can access S3 without any configuration. To read files from an S3 bucket, the database must have listable files. - -Setting the S3 URI Format -=============== -With S3, specify a location for a file (or files) when using :ref:`copy_from` or :ref:`external_tables`. - -The following is an example of the general S3 syntax: - -.. code-block:: console - - s3://bucket_name/path - -Authenticating Users -================= - -SQream supports ``AWS ID`` and ``AWS SECRET`` authentication. These should be specified when executing a statement. - -Examples -========== -You can use a foreign table to stage data from S3 before loading from CSV, Parquet, or ORC files. - -This section includes the following examples: - -.. contents:: - :local: - :depth: 1 - -Planning for Data Staging --------------------------------- -The examples in this section are based on the CSV file shown in the following table: - -.. csv-table:: nba-t10 - :file: ../_static/samples/nba-t10.csv - :widths: auto - :header-rows: 1 - -This CSV file is stored on Amazon S3, and this bucket is public and listable. To create a matching ``CREATE FOREIGN TABLE`` statement you can make a record of your source file's structure and use it to reproduce a corresponding foreign table, as shown in the following section. - -Creating a Foreign Table ------------------------------ -Based on the source file's structure above, you can create a foreign table with the structure you want and point it to your file, as shown in the following example: - -.. code-block:: postgres - - CREATE FOREIGN TABLE nba - ( - Name text(40), - Team text(40), - Number tinyint, - Position text(2), - Age tinyint, - Height text(4), - Weight real, - College text(40), - Salary float - ) - WRAPPER csv_fdw - OPTIONS - ( - LOCATION = 's3://sqream-demo-data/nba_players.csv', - RECORD_DELIMITER = '\r\n' -- DOS delimited file - ) - ; - -.. note:: In the example above the file format is CSV and is stored as an S3 object. If your file has an HDFS path, you must change the URI accordingly. Note that the record delimiter is a DOS newline (``\r\n``). - -For more information, see the following: - -* **Creating a foreign table** - see :ref:`creating a foreign table<create_foreign_table>`. -* **Using SQream in an HDFS environment** - see :ref:`hdfs`. - -Querying Foreign Tables ------------------------------- -The following shows the data located in the foreign table: - -.. code-block:: psql - - t=> SELECT * FROM nba LIMIT 10; - name | team | number | position | age | height | weight | college | salary - --------------+----------------+--------+----------+-----+--------+--------+-------------------+--------- - Avery Bradley | Boston Celtics | 0 | PG | 25 | 6-2 | 180 | Texas | 7730337 - Jae Crowder | Boston Celtics | 99 | SF | 25 | 6-6 | 235 | Marquette | 6796117 - John Holland | Boston Celtics | 30 | SG | 27 | 6-5 | 205 | Boston University | - R.J. Hunter | Boston Celtics | 28 | SG | 22 | 6-5 | 185 | Georgia State | 1148640 - Jonas Jerebko | Boston Celtics | 8 | PF | 29 | 6-10 | 231 | | 5000000 - Amir Johnson | Boston Celtics | 90 | PF | 29 | 6-9 | 240 | | 12000000 - Jordan Mickey | Boston Celtics | 55 | PF | 21 | 6-8 | 235 | LSU | 1170960 - Kelly Olynyk | Boston Celtics | 41 | C | 25 | 7-0 | 238 | Gonzaga | 2165160 - Terry Rozier | Boston Celtics | 12 | PG | 22 | 6-2 | 190 | Louisville | 1824360 - Marcus Smart | Boston Celtics | 36 | PG | 22 | 6-4 | 220 | Oklahoma State | 3431040 - -Bulk Loading a File from a Public S3 Bucket ----------------------------------------------- -Youc an use the ``COPY FROM`` command to load data without staging it first. - -.. note:: The bucket must be publicly available and objects can be listed. - -The following is an example of bulk loading a file from a public S3 bucket: - -.. code-block:: postgres - - COPY nba FROM 's3://sqream-demo-data/nba.csv' WITH OFFSET 2 RECORD DELIMITER '\r\n'; - -For more information on the ``COPY FROM`` command, see :ref:`copy_from`. - -Loading Files from an Authenticated S3 Bucket ---------------------------------------------------- -The following is an example of loading fles from an authenticated S3 bucket: - -.. code-block:: postgres - - COPY nba FROM 's3://secret-bucket/*.csv' WITH OFFSET 2 RECORD DELIMITER '\r\n' - AWS_ID '12345678' - AWS_SECRET 'super_secretive_secret'; \ No newline at end of file From 63964726e37fc0ec4d9a8542515844eca1029d56 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 24 Apr 2024 15:51:19 +0300 Subject: [PATCH 826/882] Update recommended_pre-installation_configurations.rst --- .../recommended_pre-installation_configurations.rst | 3 --- 1 file changed, 3 deletions(-) diff --git a/installation_guides/recommended_pre-installation_configurations.rst b/installation_guides/recommended_pre-installation_configurations.rst index b1374d131..4a03a51d1 100644 --- a/installation_guides/recommended_pre-installation_configurations.rst +++ b/installation_guides/recommended_pre-installation_configurations.rst @@ -52,9 +52,6 @@ If any doubt arises, consult the documentation for your server or your hardware * - **Intel Turbo Boost** - **Enabled** - Intel Turbo Boost enables overclocking the processor to boost CPU-bound operation performance. Overclocking may risk computational jitter due to changes in the processor's turbo frequency. This causes brief pauses in processor operation, introducing uncertainty into application processing time. Turbo operation is a function of power consumption, processor temperature, and the number of active cores. - * - **Logical Processor** - - **HPe**: Enable **Hyperthreading** **Dell**: Enable **Logical Processor** - - Hyperthreading doubles the amount of logical processors, which may improve performance by ~5-10% for CPU-bound operations. * - **Intel Virtualization Technology** (VT-d) - **Disable** - VT-d is optimal for running VMs. However, when running Linux natively, disabling VT-d boosts performance by up to 10%. From 48dca88acb627271c84b6b513ccca22ba175dfe4 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 25 Apr 2024 16:47:26 +0300 Subject: [PATCH 827/882] Recommended pre installation --- ...eparing_your_machine_to_install_sqream.rst | 19 +- .../installing_and_launching_sqream.rst | 7 +- ...st => pre-installation_configurations.rst} | 2642 ++++++++--------- 3 files changed, 1335 insertions(+), 1333 deletions(-) rename installation_guides/{recommended_pre-installation_configurations.rst => pre-installation_configurations.rst} (96%) diff --git a/getting_started/preparing_your_machine_to_install_sqream.rst b/getting_started/preparing_your_machine_to_install_sqream.rst index d57861b1a..432089fc0 100644 --- a/getting_started/preparing_your_machine_to_install_sqream.rst +++ b/getting_started/preparing_your_machine_to_install_sqream.rst @@ -1,17 +1,18 @@ .. _preparing_your_machine_to_install_sqream: -**************************** -Preparing Your Machine to Install SQream -**************************** -To prepare your machine to install SQream, do the following: +******************************************* +Preparing Your Machine to Install SQreamDB +******************************************* - * Set up your local machine according to SQream's recommended pre-installation configurations. +To prepare your machine to install SQreamDB, do the following: + + * Set up your local machine according to SQreamDB's recommended pre-installation configurations. :: * Verify you have an NVIDIA-capable server, either on-premise or on supported cloud platforms: - * Red Hat Enterprise Linux v7.x + * Red Hat Enterprise Linux v7.x / v8.6 - 8.8 * CentOS v7.x @@ -19,7 +20,7 @@ To prepare your machine to install SQream, do the following: * Verify that you have the following: - * An NVIDIA GPU - SQream recommends using a Tesla GPU. + * An NVIDIA GPU - SQreamDB recommends using a Tesla GPU. * An SSH connection to your server. @@ -28,8 +29,8 @@ To prepare your machine to install SQream, do the following: * SUDO permissions for installation and configuration purposes. - * A SQream license - Contact support@sqream.com or your SQream account manager for your license key. + * A SQreamDB license - Contact `SQreamDB Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_ for your license key. For more information, see the following: -* :ref:`recommended_pre-installation_configurations` +* :ref:`pre-installation_configurations` * :ref:`hardware_guide` \ No newline at end of file diff --git a/installation_guides/installing_and_launching_sqream.rst b/installation_guides/installing_and_launching_sqream.rst index 2c325c3a7..229b053a1 100644 --- a/installation_guides/installing_and_launching_sqream.rst +++ b/installation_guides/installing_and_launching_sqream.rst @@ -1,15 +1,16 @@ .. _installing_and_launching_sqream: -************************* +******************************* Installing and Launching SQream -************************* +******************************* + The **Installing and Launching SQream** page includes the following installation guides: .. toctree:: :maxdepth: 1 :glob: - recommended_pre-installation_configurations + pre-installation_configurations installing_sqream_with_binary running_sqream_in_a_docker_container installing_monit diff --git a/installation_guides/recommended_pre-installation_configurations.rst b/installation_guides/pre-installation_configurations.rst similarity index 96% rename from installation_guides/recommended_pre-installation_configurations.rst rename to installation_guides/pre-installation_configurations.rst index 4a03a51d1..3151fac6c 100644 --- a/installation_guides/recommended_pre-installation_configurations.rst +++ b/installation_guides/pre-installation_configurations.rst @@ -1,1321 +1,1321 @@ -.. _recommended_pre-installation_configurations: - -********************************************* -Recommended Pre-Installation Configuration -********************************************* - -Before :ref:`installing SQream DB<installing_sqream_db_docker>`, SQream recommends you to tune your system for better performance and stability. - -This page provides recommendations for production deployments of SQream and describes the following: - -.. contents:: - :local: - :depth: 1 - -Recommended BIOS Settings -========================== - -The first step when setting your pre-installation configurations is to use the recommended BIOS settings. - -The BIOS settings may have a variety of names, or may not exist on your system. Each system vendor has a different set of settings and variables. It is safe to skip any and all of the configuration steps, but this may impact performance. - -If any doubt arises, consult the documentation for your server or your hardware vendor for the correct way to apply the settings. - -.. list-table:: - :widths: 25 25 50 - :header-rows: 1 - - * - Item - - Setting - - Rationale - * - **Management console access** - - **Connected** - - Connection to OOB required to preserve continuous network uptime. - * - **All drives** - - **Connected and displayed on RAID interface** - - Prerequisite for cluster or OS installation. - * - **RAID volumes.** - - **Configured according to project guidelines. Must be rebooted to take effect.** - - Clustered to increase logical volume and provide redundancy. - * - **Fan speed Thermal Configuration.** - - Dell fan speed: **High Maximum**. Specified minimum setting: **60**. HPe thermal configuration: **Increased cooling**. - - NVIDIA Tesla GPUs are passively cooled and require high airflow to operate at full performance. - * - **Power regulator or iDRAC power unit policy** - - HPe: **HP static high performance** mode enabled. Dell: **iDRAC power unit policy** (power cap policy) disabled. - - Other power profiles (such as "balanced") throttle the CPU and diminishes performance. Throttling may also cause GPU failure. - * - **System Profile**, **Power Profile**, or **Performance Profile** - - **High Performance** - - The Performance profile provides potentially increased performance by maximizing processor frequency, and the disabling certain power saving features such as C-states. Use this setting for environments that are not sensitive to power consumption. - * - **Power Cap Policy** or **Dynamic power capping** - - **Disabled** - - Other power profiles (like "balanced") throttle the CPU and may diminish performance or cause GPU failure. This setting may appear together with the above (Power profile or Power regulator). This setting allows disabling system ROM power calibration during the boot process. Power regulator settings are named differently in BIOS and iLO/iDRAC. - * - **Intel Turbo Boost** - - **Enabled** - - Intel Turbo Boost enables overclocking the processor to boost CPU-bound operation performance. Overclocking may risk computational jitter due to changes in the processor's turbo frequency. This causes brief pauses in processor operation, introducing uncertainty into application processing time. Turbo operation is a function of power consumption, processor temperature, and the number of active cores. - * - **Intel Virtualization Technology** (VT-d) - - **Disable** - - VT-d is optimal for running VMs. However, when running Linux natively, disabling VT-d boosts performance by up to 10%. - * - **Logical Processor** - - **HPe**: Enable **Hyperthreading** **Dell**: Enable **Logical Processor** - - Hyperthreading doubles the amount of logical processors, which may improve performance by ~5-10% for CPU-bound operations. - * - **Intel Virtualization Technology** (VT-d) - - **Disable** - - VT-d is optimal for running VMs. However, when running Linux natively, disabling VT-d boosts performance by up to 10%. - * - **Processor C-States** (Minimum processor idle power core state) - - **Disable** - - Processor C-States reduce server power when the system is in an idle state. This causes slower cold-starts when the system transitions from an idle to a load state, and may reduce query performance by up to 15%. - * - **HPe**: **Energy/Performance bias** - - **Maximum performance** - - Configures processor sub-systems for high-performance and low-latency. Other power profiles (like "balanced") throttle the CPU and may diminish performance. Use this setting for environments that are not sensitive to power consumption. - * - **HPe**: **DIMM voltage** - - **Optimized for Performance** - - Setting a higher voltage for DIMMs may increase performance. - * - **Memory Operating Mode** - - **Optimizer Mode**, **Disable Node Interleaving**, **Auto Memory Operating Voltage** - - Memory Operating Mode is tuned for performance in **Optimizer** mode. Other modes may improve reliability, but reduce performance. **Node Interleaving** should be disabled because enabling it interleaves the memory between memory nodes, which harms NUMA-aware applications such as SQream DB. - * - **HPe**: **Memory power savings mode** - - **Maximum performance** - - This setting configures several memory parameters to optimize the performance of memory sub-systems. The default setting is **Balanced**. - * - **HPe ACPI SLIT** - - **Enabled** - - ACPI SLIT sets the relative access times between processors and memory and I/O sub-systems. ACPI SLIT enables operating systems to use this data to improve performance by more efficiently allocating resources and workloads. - * - **QPI Snoop** - - **Cluster on Die** or **Home Snoop** - - QPI (QuickPath Interconnect) Snoop lets you configure different Snoop modes that impact the QPI interconnect. Changing this setting may improve the performance of certain workloads. The default setting of **Home Snoop** provides high memory bandwidth in an average NUMA environment. **Cluster on Die** may provide increased memory bandwidth in highly optimized NUMA workloads. **Early Snoop** may decrease memory latency, but may result in lower overall bandwidth compared to other modes. - -Installing the Operating System -=================================================== - -Once the BIOS settings have been set, you must install the operating system. Either the CentOS (versions 7.6-7.9) or RHEL (versions 7.6-7.9) must be installed before installing the SQream database, by either the customer or a SQream representative. - -**To install the operating system:** - -#. Select a language (English recommended). -#. From **Software Selection**, select **Minimal**. -#. Select the **Development Tools** group checkbox. -#. Continue the installation. -#. Set up the necessary drives and users as per the installation process. - - Using Debugging Tools is recommended for future problem-solving if necessary. - -Selecting the **Development Tools** group installs the following tools: - - * autoconf - * automake - * binutils - * bison - * flex - * gcc - * gcc-c++ - * gettext - * libtool - * make - * patch - * pkgconfig - * redhat-rpm-config - * rpm-build - * rpm-sign - -The root user is created and the OS shell is booted up. - -Configuring the Operating System -=================================================== - -Once you've installted your operation system, you can configure it. When configuring the operating system, several basic settings related to creating a new server are required. Configuring these as part of your basic set-up increases your server's security and usability. - -Logging In to the Server --------------------------------- - -You can log in to the server using the server's IP address and password for the **root** user. The server's IP address and **root** user were created while installing the operating system above. - -Automatically Creating a SQream User ------------------------------------- - -**To automatically create a SQream user:** - -#. If a SQream user was created during installation, verify that the same ID is used on every server: - - .. code-block:: console - - $ sudo id sqream - - The ID **1000** is used on each server in the following example: - - .. code-block:: console - - $ uid=1000(sqream) gid=1000(sqream) groups=1000(sqream) - -2. If the ID's are different, delete the SQream user and SQream group from both servers: - - .. code-block:: console - - $ sudo userdel sqream - -3. Recreate it using the same ID: - - .. code-block:: console - - $ sudo rm /var/spool/mail/sqream - -Manually Creating a SQream User --------------------------------- - -**To manually create a SQream user:** - -SQream enables you to manually create users. This section shows you how to manually create a user with the UID **1111**. You cannot manually create during the operating system installation procedure. - -1. Add a user with an identical UID on all cluster nodes: - - .. code-block:: console - - $ useradd -u 1111 sqream - -2. Add the user **sqream** to the **wheel** group. - - .. code-block:: console - - $ sudo usermod -aG wheel sqream - - You can remove the SQream user from the **wheel** group when the installation and configuration are complete: - - .. code-block:: console - - $ passwd sqream - -3. Log out and log back in as **sqream**. - - .. note:: If you deleted the **sqream** user and recreated it with different ID, to avoid permission errors, you must change its ownership to /home/sqream. - -4. Change the **sqream** user's ownership to /home/sqream: - - .. code-block:: console - - $ sudo chown -R sqream:sqream /home/sqream - -Setting Up A Locale --------------------------------- - -SQream enables you to set up a locale. In this example, the locale used is your own location. - -**To set up a locale:** - -1. Set the language of the locale: - - .. code-block:: console - - $ sudo localectl set-locale LANG=en_US.UTF-8 - -2. Set the time stamp (time and date) of the locale: - - .. code-block:: console - - $ sudo timedatectl set-timezone Asia/Jerusalem - -If needed, you can run the **timedatectl list-timezones** command to see your current time-zone. - - -Installing the Required Packages --------------------------------- - -You can install the required packages by running the following command: - -.. code-block:: console - - $ sudo yum install ntp pciutils monit zlib-devel openssl-devel kernel-devel-$(uname -r) kernel-headers-$(uname -r) gcc net-tools wget jq - - -Installing the Recommended Tools --------------------------------- - -You can install the recommended tools by running the following command: - -.. code-block:: console - - $ sudo yum install bash-completion.noarch vim-enhanced vim-common net-tools iotop htop psmisc screen xfsprogs wget yum-utils deltarpm dos2unix - - -Installing Python 3.6.7 --------------------------------- - -1. Download the Python 3.6.7 source code tarball file from the following URL into the **/home/sqream** directory: - - .. code-block:: console - - $ wget https://www.python.org/ftp/python/3.6.7/Python-3.6.7.tar.xz - -2. Extract the Python 3.6.7 source code into your current directory: - - .. code-block:: console - - $ tar -xf Python-3.6.7.tar.xz - -3. Navigate to the Python 3.6.7 directory: - - .. code-block:: console - - $ cd Python-3.6.7 - -4. Run the **./configure** script: - - .. code-block:: console - - $ ./configure - -5. Build the software: - - .. code-block:: console - - $ make -j30 - -6. Install the software: - - .. code-block:: console - - $ sudo make install - -7. Verify that Python 3.6.7 has been installed: - - .. code-block:: console - - $ python3 - -Installing NodeJS on CentOS --------------------------------- - -**To install the node.js on CentOS:** - -1. Download the `setup_12.x file <https://rpm.nodesource.com/setup_12.x>`__ as a root user logged in shell: - - .. code-block:: console - - $ curl -sL https://rpm.nodesource.com/setup_12.x | sudo bash - - -2. Clear the YUM cache and update the local metadata: - - .. code-block:: console - - $ sudo yum clean all && sudo yum makecache fast - -3. Install the **node.js** file: - - .. code-block:: console - - $ sudo yum install -y nodejs - -4. Install npm and make it available for all users: - - .. code-block:: console - - $ sudo npm install pm2 -g - -Installing NodeJS on Ubuntu --------------------------------- - -**To install the node.js file on Ubuntu:** - -1. Download the `setup_12.x file <https://deb.nodesource.com/setup_12.x>`__ as a root user logged in shell: - - .. code-block:: console - - $ curl -sL https://rpm.nodesource.com/setup_12.x | sudo bash - - -2. Install the node.js file: - - .. code-block:: console - - $ sudo apt-get install -y nodejs - -3. Install npm and make it available for all users: - - .. code-block:: console - - $ sudo npm install pm2 -g - -Installing NodeJS Offline -------------------------------------------- - -**To install NodeJS Offline** - -1. Download the NodeJS source code tarball file from the following URL into the **/home/sqream** directory: - - .. code-block:: console - - $ wget https://nodejs.org/dist/v12.13.0/node-v12.13.0-linux-x64.tar.xz - -2. Move the node-v12.13.0-linux-x64 file to the */usr/local* directory. - - .. code-block:: console - - $ sudo mv node-v12.13.0-linux-x64 /usr/local - -3. Navigate to the */usr/bin/* directory: - - .. code-block:: console - - $ cd /usr/bin - -4. Create a symbolic link to the */local/node-v12.13.0-linux-x64/bin/node node* directory: - - .. code-block:: console - - $ sudo ln -s ../local/node-v12.13.0-linux-x64/bin/node node - -5. Create a symbolic link to the */local/node-v12.13.0-linux-x64/bin/npm npm* directory: - - .. code-block:: console - - $ sudo ln -s ../local/node-v12.13.0-linux-x64/bin/npm npm - -6. Create a symbolic link to the */local/node-v12.13.0-linux-x64/bin/npx npx* directory: - - .. code-block:: console - - $ sudo ln -s ../local/node-v12.13.0-linux-x64/bin/npx npx - -7. Verify that the node versions for the above are correct: - - .. code-block:: console - - $ node --version - -Installing the pm2 Service Offline -------------------------------------------- - -**To install the pm2 Service Offline** - -1. On a machine with internet access, install the following: - - * nodejs - * npm - * pm2 - -2. Extract the pm2 module to the correct directory: - - .. code-block:: console - - $ cd /usr/local/node-v12.13.0-linux-x64/lib/node_modules - $ tar -czvf pm2_x86.tar.gz pm2 - -3. Copy the **pm2_x86.tar.gz** file to a server without access to the internet and extract it. - - :: - -4. Move the **pm2** folder to the */usr/local/node-v12.13.0-linux-x64/lib/node_modules* directory: - - .. code-block:: console - - $ sudo mv pm2 /usr/local/node-v12.13.0-linux-x64/lib/node_modules - -5. Navigate back to the */usr/bin* directory: - - .. code-block:: console - - $ cd /usr/bin again - -6. Create a symbolink to the **pm2** service: - - .. code-block:: console - - $ sudo ln -s /usr/local/node-v12.22.3-linux-x64/lib/node_modules/pm2/bin/pm2 pm2 - -7. Verify that installation was successful: - - .. code-block:: console - - $ pm2 list - - .. note:: This must be done as a **sqream** user, and not as a **sudo** user. - -8. Verify that the node version is correct: - - .. code-block:: console - - $ node -v - -Configuring the Network Time Protocol -------------------------------------------- - -This section describes how to configure your **Network Time Protocol (NTP)**. - -If you don't have internet access, see `Configure NTP Client to Synchronize with NTP Server <https://www.thegeekstuff.com/2014/06/linux-ntp-server-client/>`__. - -**To configure your NTP:** - -1. Install the NTP file. - - .. code-block:: console - - $ sudo yum install ntp - -2. Enable the **ntpd** program. - - .. code-block:: console - - $ sudo systemctl enable ntpd - -3. Start the **ntdp** program. - - .. code-block:: console - - $ sudo systemctl start ntpd - -4. Print a list of peers known to the server and a summary of their states. - - .. code-block:: console - - $ sudo ntpq -p - -Configuring the Network Time Protocol Server --------------------------------------------- - -If your organization has an NTP server, you can configure it. - -**To configure your NTP server:** - -1. Output your NTP server address and append ``/etc/ntpd.conf`` to the outuput. - - .. code-block:: console - - $ echo -e "\nserver <your NTP server address>\n" | sudo tee -a /etc/ntp.conf - -2. Restart the service. - - .. code-block:: console - - $ sudo systemctl restart ntpd - -3. Check that synchronization is enabled: - - .. code-block:: console - - $ sudo timedatectl - - Checking that synchronization is enabled generates the following output: - - .. code-block:: console - - $ Local time: Sat 2019-10-12 17:26:13 EDT - Universal time: Sat 2019-10-12 21:26:13 UTC - RTC time: Sat 2019-10-12 21:26:13 - Time zone: America/New_York (EDT, -0400) - NTP enabled: yes - NTP synchronized: yes - RTC in local TZ: no - DST active: yes - Last DST change: DST began at - Sun 2019-03-10 01:59:59 EST - Sun 2019-03-10 03:00:00 EDT - Next DST change: DST ends (the clock jumps one hour backwards) at - Sun 2019-11-03 01:59:59 EDT - Sun 2019-11-03 01:00:00 EST - -Configuring the Server to Boot Without the UI ---------------------------------------------- - -You can configure your server to boot without a UI in cases when it is not required (recommended) by running the following command: - -.. code-block:: console - - $ sudo systemctl set-default multi-user.target - -Running this command activates the **NO-UI** server mode. - -Configuring the Security Limits --------------------------------- - -The security limits refers to the number of open files, processes, etc. - -You can configure the security limits by running the **echo -e** command as a root user logged in shell: - -.. code-block:: console - - $ sudo bash - -.. code-block:: console - - $ echo -e "sqream soft nproc 1000000\nsqream hard nproc 1000000\nsqream soft nofile 1000000\nsqream hard nofile 1000000\nsqream soft core unlimited\nsqream hard core unlimited" >> /etc/security/limits.conf - -Configuring the Kernel Parameters ---------------------------------- - -**To configure the kernel parameters:** - -1. Insert a new line after each kernel parameter: - - .. code-block:: console - - $ echo -e "vm.dirty_background_ratio = 5 \n vm.dirty_ratio = 10 \n vm.swappiness = 10 \n vm.vfs_cache_pressure = 200 \n vm.zone_reclaim_mode = 0 \n" >> /etc/sysctl.conf - - .. note:: In the past, the **vm.zone_reclaim_mode** parameter was set to **7.** In the latest Sqream version, the vm.zone_reclaim_mode parameter must be set to **0**. If it is not set to **0**, when a numa node runs out of memory, the system will get stuck and will be unable to pull memory from other numa nodes. - -2. Check the maximum value of the **fs.file**. - - .. code-block:: console - - $ sysctl -n fs.file-max - -3. If the maximum value of the **fs.file** is smaller than **2097152**, run the following command: - - .. code-block:: console - - $ echo "fs.file-max=2097152" >> /etc/sysctl.conf - -4. Run the following command: - - .. code-block:: console - - $ sudo echo “net.ipv4.ip_forward = 1” >> /etc/sysctl.conf - -5. Reboot your system: - - .. code-block:: console - - $ sudo reboot - -Configuring the Firewall --------------------------------- - -The example in this section shows the open ports for four sqreamd sessions. If more than four are required, open the required ports as needed. Port 8080 in the example below is a new UI port. - -**To configure the firewall:** - -1. Start the service and enable FirewallID on boot: - - .. code-block:: console - - $ systemctl start firewalld - -2. Add the following ports to the permanent firewall: - - .. code-block:: console - - $ firewall-cmd --zone=public --permanent --add-port=8080/tcp - $ firewall-cmd --zone=public --permanent --add-port=3105/tcp - $ firewall-cmd --zone=public --permanent --add-port=3108/tcp - $ firewall-cmd --zone=public --permanent --add-port=5000-5003/tcp - $ firewall-cmd --zone=public --permanent --add-port=5100-5103/tcp - $ firewall-cmd --permanent --list-all - -3. Reload the firewall: - - .. code-block:: console - - $ firewall-cmd --reload - -4. Enable FirewallID on boot: - - .. code-block:: console - - $ systemctl enable firewalld - - If you do not need the firewall, you can disable it: - - .. code-block:: console - - $ sudo systemctl disable firewalld - -Disabling selinux --------------------------------- - -**To disable selinux:** - -1. Show the status of **selinux**: - - .. code-block:: console - - $ sudo sestatus - -2. If the output is not **disabled**, edit the **/etc/selinux/config** file: - - .. code-block:: console - - $ sudo vim /etc/selinux/config - -3. Change **SELINUX=enforcing** to **SELINUX=disabled**. - - The above changes will only take effect after rebooting the server. - - You can disable selinux immediately after rebooting the server by running the following command: - - .. code-block:: console - - $ sudo setenforce 0 - -Configuring the /etc/hosts File --------------------------------- - -**To configure the /etc/hosts file:** - -1. Edit the **/etc/hosts** file: - - .. code-block:: console - - $ sudo vim /etc/hosts - -2. Call your local host: - - .. code-block:: console - - $ 127.0.0.1 localhost - $ <server1 ip> <server_name> - $ <server2 ip> <server_name> - -Configuring the DNS --------------------------------- - -**To configure the DNS:** - -1. Run the **ifconfig** commasnd to check your NIC name. In the following example, **eth0** is the NIC name: - - .. code-block:: console - - $ sudo vim /etc/sysconfig/network-scripts/ifcfg-eth0 - -2. Replace the DNS lines from the example above with your own DNS addresses : - - .. code-block:: console - - $ DNS1="4.4.4.4" - $ DNS2="8.8.8.8" - -Installing the Nvidia CUDA Driver -=================================================== - -After configuring your operating system, you must install the Nvidia CUDA driver. - - .. warning:: If your UI runs on the server, the server must be stopped before installing the CUDA drivers. - -CUDA Driver Prerequisites --------------------------------- - -1. Verify that the NVIDIA card has been installed and is detected by the system: - - .. code-block:: console - - $ lspci | grep -i nvidia - -2. Check which version of gcc has been installed: - - .. code-block:: console - - $ gcc --version - -3. If gcc has not been installed, install it for one of the following operating systems: - - * On RHEL/CentOS: - - .. code-block:: console - - $ sudo yum install -y gcc - - * On Ubuntu: - - .. code-block:: console - - $ sudo apt-get install gcc - -Updating the Kernel Headers --------------------------------- - -**To update the kernel headers:** - -1. Update the kernel headers on one of the following operating systems: - - * On RHEL/CentOS: - - .. code-block:: console - - $ sudo yum install kernel-devel-$(uname -r) kernel-headers-$(uname -r) - - * On Ubuntu: - - .. code-block:: console - - $ sudo apt-get install linux-headers-$(uname -r) - -2. Install **wget** one of the following operating systems: - - * On RHEL/CentOS: - - .. code-block:: console - - $ sudo yum install wget - - * On Ubuntu: - - .. code-block:: console - - $ sudo apt-get install wget - -Disabling Nouveau --------------------------------- - -You can disable Nouveau, which is the default driver. - -**To disable Nouveau:** - -1. Check if the Nouveau driver has been loaded: - - .. code-block:: console - - $ lsmod | grep nouveau - - If the Nouveau driver has been loaded, the command above generates output. - -2. Blacklist the Nouveau drivers to disable them: - - .. code-block:: console - - $ cat <<EOF | sudo tee /etc/modprobe.d/blacklist-nouveau.conf - blacklist nouveau - options nouveau modeset=0 - EOF - -3. Regenerate the kernel **initramfs** directory set: - - 1. Modify the **initramfs** directory set: - - .. code-block:: console - - $ sudo dracut --force - - 2. Reboot the server: - - .. code-block:: console - - $ sudo reboot - -Installing the CUDA Driver --------------------------------- - -This section describes how to install the CUDA driver. - -.. note:: The version of the driver installed on the customer's server must be equal or higher than the driver included in the Sqream release package. Contact a Sqream customer service representative to identify the correct version to install. - -The **Installing the CUDA Driver** section describes the following: - -.. contents:: - :local: - :depth: 1 - -Installing the CUDA Driver from the Repository -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Installing the CUDA driver from the Repository is the recommended installation method. - -.. warning:: For A100 GPU and other A series GPUs, you must install the **cuda 11.4.3 driver**. The version of the driver installed on the customer server must be equal to or higher than the one used to build the SQream package. For questions related to which driver to install, contact SQream Customer Support. - -**To install the CUDA driver from the Repository:** - -1. Install the CUDA dependencies for one of the following operating systems: - - * For RHEL: - - .. code-block:: console - - $ sudo rpm -Uvh http://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm - - * For CentOS: - - .. code-block:: console - - $ sudo yum install epel-release - -2. Install the CUDA dependencies from the **epel** repository: - - .. code-block:: console - - $ sudo yum install dkms libvdpau - - Installing the CUDA depedendencies from the **epel** repository is only required for installing **runfile**. - -3. Download and install the required local repository: - - * **Intel - CUDA 10.1 for RHEL7**: - - .. code-block:: console - - $ wget http://developer.download.nvidia.com/compute/cuda/10.1/Prod/local_installers/cuda-repo-rhel7-10-1-local-10.1.243-418.87.00-1.0-1.x86_64.rpm - $ sudo yum localinstall cuda-repo-rhel7-10-1-local-10.1.243-418.87.00-1.0-1.x86_64.rpm - - * **Intel - 11.4.3 repository**: - - .. code-block:: console - - $ wget https://developer.download.nvidia.com/compute/cuda/11.4.3/local_installers/cuda-repo-rhel7-11-4-local-11.4.3_470.82.01-1.x86_64.rpm - $ sudo yum localinstall cuda-repo-rhel7-11-4-local-11.4.3_470.82.01-1.x86_64.rpm - - * **IBM Power9 - CUDA 10.1 for RHEL7**: - - .. code-block:: console - - $ wget https://developer.download.nvidia.com/compute/cuda/10.1/Prod/local_installers/cuda-repo-rhel7-10-1-local-10.1.243-418.87.00-1.0-1.ppc64le.rpm - $ sudo yum localinstall cuda-repo-rhel7-10-1-local-10.1.243-418.87.00-1.0-1.ppc64le.rpm - - -4. Install the CUDA drivers: - - a. Clear the YUM cache: - - .. code-block:: console - - $ sudo yum clean all - - b. Install the most current DKMS (Dynamic Kernel Module Support) NVIDIA driver: - - .. code-block:: console - - $ sudo yum -y install nvidia-driver-latest-dkms - -5. Verify that the installation was successful: - - .. code-block:: console - - $ nvidia-smi - -.. note:: If you do not have access to internet, you can set up a local repository offline. - -You can prepare the CUDA driver offline from a server connected to the CUDA repo by running the following commands as a *root* user: - -6. Query all the packages installed in your system, and verify that cuda-repo has been installed: - - .. code-block:: console - - $ rpm -qa |grep cuda-repo - -7. Navigate to the correct repository: - - .. code-block:: console - - $ cd /etc/yum.repos.d/ - -8. List in long format and print lines matching a pattern for the cuda file: - - .. code-block:: console - - $ ls -l |grep cuda - - The following is an example of the correct output: - - .. code-block:: console - - $ cuda-10-1-local.repo - -9. Edit the **/etc/yum.repos.d/cuda-10-1-local.repo** file: - - .. code-block:: console - - $ vim /etc/yum.repos.d/cuda-10-1-local.repo - - The following is an example of the correct output: - - .. code-block:: console - - $ name=cuda-10-1-local - -10. Clone the repository to a location where it can be copied from: - - .. code-block:: console - - $ reposync -g -l -m --repoid=cuda-10-1-local --download_path=/var/cuda-repo-10.1-local - -11. Copy the repository to the installation server and create the repository: - - .. code-block:: console - - $ createrepo -g comps.xml /var/cuda-repo-10.1-local - -12. Add a repo configuration file in **/etc/yum.repos.d/** by editing the **/etc/yum.repos.d/cuda-10.1-local.repo** repository: - - .. code-block:: console - - $ [cuda-10.1-local] - $ name=cuda-10.1-local - $ baseurl=file:///var/cuda-repo-10.1-local - $ enabled=1 - $ gpgcheck=1 - $ gpgkey=file:///var/cuda-repo-10-1-local/7fa2af80.pub - -13. Install the CUDA drivers by installing the most current DKMS (Dynamic Kernel Module Support) NVIDIA driver as a root user logged in shell: - - .. code-block:: console - - $ sudo yum -y install nvidia-driver-latest-dkms - -Tuning Up NVIDIA Performance -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -This section describes how to tune up NVIDIA performance. - -.. note:: The procedures in this section are relevant to Intel only. - -.. contents:: - :local: - :depth: 1 - -To Tune Up NVIDIA Performance when Driver Installed from the Repository -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**To tune up NVIDIA performance when the driver was installed from the repository:** - -1. Check the service status: - - .. code-block:: console - - $ sudo systemctl status nvidia-persistenced - - If the service exists, it will be stopped be default. - -2. Start the service: - - .. code-block:: console - - $ sudo systemctl start nvidia-persistenced - -3. Verify that no errors have occurred: - - .. code-block:: console - - $ sudo systemctl status nvidia-persistenced - -4. Enable the service to start up on boot: - - .. code-block:: console - - $ sudo systemctl enable nvidia-persistenced - -5. For **H100/A100**, add the following lines: - - .. code-block:: console - - $ nvidia-persistenced - - .. note:: The following are mandatory for IBM: - - .. code-block:: console - - $ sudo systemctl start nvidia-persistenced - $ sudo systemctl enable nvidia-persistenced - -6. Reboot the server and run the **NVIDIA System Management Interface (NVIDIA SMI)**: - - .. code-block:: console - - $ nvidia-smi - -.. note:: Setting up the NVIDIA POWER9 CUDA driver includes additional set-up requirements. The NVIDIA POWER9 CUDA driver will not function properly if the additional set-up requirements are not followed. See `POWER9 Setup <https://docs.nvidia.com/cuda/cuda-installation-guide-linux/index.html#power9-setup>`__ for the additional set-up requirements. - -To Tune Up NVIDIA Performance when Driver Installed from the Runfile -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**To tune up NVIDIA performance when the driver was installed from the runfile:** - -1. Change the permissions on the **rc.local** file to **executable**: - - .. code-block:: console - - $ sudo chmod +x /etc/rc.local - -2. Edit the **/etc/yum.repos.d/cuda-10-1-local.repo** file: - - .. code-block:: console - - $ sudo vim /etc/rc.local - -3. Add the following lines: - - * **For H100/A100**: - - .. code-block:: console - - $ nvidia-persistenced - - * **For IBM (mandatory)**: - - .. code-block:: console - - $ sudo systemctl start nvidia-persistenced - $ sudo systemctl enable nvidia-persistenced - - * **For K80**: - - .. code-block:: console - - $ nvidia-persistenced - $ nvidia-smi -pm 1 - $ nvidia-smi -acp 0 - $ nvidia-smi --auto-boost-permission=0 - $ nvidia-smi --auto-boost-default=0 - -4. Reboot the server and run the **NVIDIA System Management Interface (NVIDIA SMI)**: - - .. code-block:: console - - $ nvidia-smi - -.. note:: Setting up the NVIDIA POWER9 CUDA driver includes additional set-up requirements. The NVIDIA POWER9 CUDA driver will not function properly if the additional set-up requirements are not followed. See `POWER9 Setup <https://docs.nvidia.com/cuda/cuda-installation-guide-linux/index.html#power9-setup>`__ for the additional set-up requirements. - -Disabling Automatic Bug Reporting Tools -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -**To disable automatic bug reporting tools:** - -1. Run the following **abort** commands: - - .. code-block:: console - - $ for i in abrt-ccpp.service abrtd.service abrt-oops.service abrt-pstoreoops.service abrt-vmcore.service abrt-xorg.service ; do sudo systemctl disable $i; sudo systemctl stop $i; done - -The server is ready for the SQream software installation. - -2. Run the following checks: - - a. Check the OS release: - - .. code-block:: console - - $ cat /etc/os-release - - b. Verify that a SQream user exists and has the same ID on all cluster member services: - - .. code-block:: console - - $ id sqream - - c. Verify that the storage is mounted: - - .. code-block:: console - - $ mount - - d. Verify that the driver has been installed correctly: - - .. code-block:: console - - $ nvidia-smi - - e. Check the maximum value of the **fs.file**: - - .. code-block:: console - - $ sysctl -n fs.file-max - - f. Run the following command as a SQream user: - - .. code-block:: console - - $ ulimit -c -u -n - - The following shows the desired output: - - .. code-block:: console - - $ core file size (blocks, -c) unlimited - $ max user processes (-u) 1000000 - $ open files (-n) 1000000 - -Enabling Core Dumps -=================================================== - -After installing the Nvidia CUDA driver, you can enable your core dumps. While SQream recommends enabling your core dumps, it is optional. - -The **Enabling Core Dumps** section describes the following: - -.. contents:: - :local: - :depth: 1 - -Checking the abrtd Status ---------------------------------------------------- - -**To check the abrtd status:** - -1. Check if **abrtd** is running: - - .. code-block:: console - - $ sudo ps -ef |grep abrt - -2. If **abrtd** is running, stop it: - - .. code-block:: console - - $ sudo service abrtd stop - $ sudo chkconfig abrt-ccpp off - $ sudo chkconfig abrt-oops off - $ sudo chkconfig abrt-vmcore off - $ sudo chkconfig abrt-xorg off - $ sudo chkconfig abrtd off - -Setting the Limits ---------------------------------------------------- - -**To set the limits:** - -1. Set the limits: - - .. code-block:: console - - $ ulimit -c - -2. If the output is **0**, add the following lines to the **limits.conf** file (/etc/security): - - .. code-block:: console - - $ * soft core unlimited - $ * hard core unlimited - -3. Log out and log in to apply the limit changes. - -Creating the Core Dumps Directory ---------------------------------------------------- - -**To set the core dumps directory:** - -1. Make the **/tmp/core_dumps** directory: - - .. code-block:: console - - $ mkdir /tmp/core_dumps - -2. Set the ownership of the **/tmp/core_dumps** directory: - - .. code-block:: console - - $ sudo chown sqream.sqream /tmp/core_dumps - -3. Grant read, write, and execute permissions to all users: - - .. code-block:: console - - $ sudo chmod -R 777 /tmp/core_dumps - -.. warning:: Because the core dump file may be the size of total RAM on the server, verify that you have sufficient disk space. In the example above, the core dump is configured to the */tmp/core_dumps* directory. You must replace path according to your own environment and disk space. - -Setting the Output Directory of the /etc/sysctl.conf File ------------------------------------------------------------------ - -**To set the output directory of the /etc/sysctl.conf file:** - -1. Edit the **/etc/sysctl.conf** file: - - .. code-block:: console - - $ sudo vim /etc/sysctl.conf - -2. Add the following to the bottom of the file: - - .. code-block:: console - - $ kernel.core_uses_pid = 1 - $ kernel.core_pattern = /<tmp/core_dumps>/core-%e-%s-%u-%g-%p-%t - $ fs.suid_dumpable = 2 - -3. To apply the changes without rebooting the server, run the following: - - .. code-block:: console - - $ sudo sysctl -p - -4. Check that the core output directory points to the following: - - .. code-block:: console - - $ sudo cat /proc/sys/kernel/core_pattern - - The following shows the correct generated output: - - .. code-block:: console - - $ /tmp/core_dumps/core-%e-%s-%u-%g-%p-%t - -5. Verify that the core dumping works: - - .. code-block:: console - - $ select abort_server(); - -Verifying that the Core Dumps Work ---------------------------------------------------- - -You can verify that the core dumps work only after installing and running SQream. This causes the server to crash and a new core.xxx file to be included in the folder that is written in **/etc/sysctl.conf** - -**To verify that the core dumps work:** - -1. Stop and restart all SQream services. - - :: - -2. Connect to SQream with ClientCmd and run the following command: - - .. code-block:: console - - $ select abort_server(); - -Troubleshooting Core Dumping ---------------------------------------------------- - -This section describes the troubleshooting procedure to be followed if all parameters have been configured correctly, but the cores have not been created. - -**To troubleshoot core dumping:** - -1. Reboot the server. - - :: - -2. Verify that you have folder permissions: - - .. code-block:: console - - $ sudo chmod -R 777 /tmp/core_dumps - -3. Verify that the limits have been set correctly: - - .. code-block:: console - - $ ulimit -c - - If all parameters have been configured correctly, the correct output is: - - .. code-block:: console - - $ core file size (blocks, -c) unlimited - $ open files (-n) 1000000 - -4. If all parameters have been configured correctly, but running **ulimit -c** outputs **0**, run the following: - - .. code-block:: console - - $ sudo vim /etc/profile - -5. Search for line and tag it with the **hash** symbol: - - .. code-block:: console - - $ ulimit -S -c 0 > /dev/null 2>&1 - -6. Log out and log in. - - :: - -7. Run the ulimit -c command: - - .. code-block:: console - - $ ulimit -c command - -8. If the line is not found in **/etc/profile** directory, do the following: - - a. Run the following command: - - .. code-block:: console - - $ sudo vim /etc/init.d/functions - - b. Search for the following: - - .. code-block:: console - - $ ulimit -S -c ${DAEMON_COREFILE_LIMIT:-0} >/dev/null 2>&1 - - c. If the line is found, tag it with the **hash** symbol and reboot the server. +.. _pre-installation_configurations: + +********************************************* + Pre-Installation Configuration +********************************************* + +Before :ref:`installing SQream DB<installing_sqream_db_docker>`, it is essential that you tune your system for better performance and stability. + +This page provides recommendations for production deployments of SQream and describes the following: + +.. contents:: + :local: + :depth: 1 + +BIOS Settings +========================== + +The first step when setting your pre-installation configurations is to use the BIOS settings. + +The BIOS settings may have a variety of names, or may not exist on your system. Each system vendor has a different set of settings and variables. It is safe to skip any and all of the configuration steps, but this may impact performance. + +If any doubt arises, consult the documentation for your server or your hardware vendor for the correct way to apply the settings. + +.. list-table:: + :widths: 25 25 50 + :header-rows: 1 + + * - Item + - Setting + - Rationale + * - **Management console access** + - **Connected** + - Connection to OOB required to preserve continuous network uptime. + * - **All drives** + - **Connected and displayed on RAID interface** + - Prerequisite for cluster or OS installation. + * - **RAID volumes.** + - **Configured according to project guidelines. Must be rebooted to take effect.** + - Clustered to increase logical volume and provide redundancy. + * - **Fan speed Thermal Configuration.** + - Dell fan speed: **High Maximum**. Specified minimum setting: **60**. HPe thermal configuration: **Increased cooling**. + - NVIDIA Tesla GPUs are passively cooled and require high airflow to operate at full performance. + * - **Power regulator or iDRAC power unit policy** + - HPe: **HP static high performance** mode enabled. Dell: **iDRAC power unit policy** (power cap policy) disabled. + - Other power profiles (such as "balanced") throttle the CPU and diminishes performance. Throttling may also cause GPU failure. + * - **System Profile**, **Power Profile**, or **Performance Profile** + - **High Performance** + - The Performance profile provides potentially increased performance by maximizing processor frequency, and the disabling certain power saving features such as C-states. Use this setting for environments that are not sensitive to power consumption. + * - **Power Cap Policy** or **Dynamic power capping** + - **Disabled** + - Other power profiles (like "balanced") throttle the CPU and may diminish performance or cause GPU failure. This setting may appear together with the above (Power profile or Power regulator). This setting allows disabling system ROM power calibration during the boot process. Power regulator settings are named differently in BIOS and iLO/iDRAC. + * - **Intel Turbo Boost** + - **Enabled** + - Intel Turbo Boost enables overclocking the processor to boost CPU-bound operation performance. Overclocking may risk computational jitter due to changes in the processor's turbo frequency. This causes brief pauses in processor operation, introducing uncertainty into application processing time. Turbo operation is a function of power consumption, processor temperature, and the number of active cores. + * - **Intel Virtualization Technology** (VT-d) + - **Disable** + - VT-d is optimal for running VMs. However, when running Linux natively, disabling VT-d boosts performance by up to 10%. + * - **Logical Processor** + - **HPe**: Enable **Hyperthreading** **Dell**: Enable **Logical Processor** + - Hyperthreading doubles the amount of logical processors, which may improve performance by ~5-10% for CPU-bound operations. + * - **Intel Virtualization Technology** (VT-d) + - **Disable** + - VT-d is optimal for running VMs. However, when running Linux natively, disabling VT-d boosts performance by up to 10%. + * - **Processor C-States** (Minimum processor idle power core state) + - **Disable** + - Processor C-States reduce server power when the system is in an idle state. This causes slower cold-starts when the system transitions from an idle to a load state, and may reduce query performance by up to 15%. + * - **HPe**: **Energy/Performance bias** + - **Maximum performance** + - Configures processor sub-systems for high-performance and low-latency. Other power profiles (like "balanced") throttle the CPU and may diminish performance. Use this setting for environments that are not sensitive to power consumption. + * - **HPe**: **DIMM voltage** + - **Optimized for Performance** + - Setting a higher voltage for DIMMs may increase performance. + * - **Memory Operating Mode** + - **Optimizer Mode**, **Disable Node Interleaving**, **Auto Memory Operating Voltage** + - Memory Operating Mode is tuned for performance in **Optimizer** mode. Other modes may improve reliability, but reduce performance. **Node Interleaving** should be disabled because enabling it interleaves the memory between memory nodes, which harms NUMA-aware applications such as SQream DB. + * - **HPe**: **Memory power savings mode** + - **Maximum performance** + - This setting configures several memory parameters to optimize the performance of memory sub-systems. The default setting is **Balanced**. + * - **HPe ACPI SLIT** + - **Enabled** + - ACPI SLIT sets the relative access times between processors and memory and I/O sub-systems. ACPI SLIT enables operating systems to use this data to improve performance by more efficiently allocating resources and workloads. + * - **QPI Snoop** + - **Cluster on Die** or **Home Snoop** + - QPI (QuickPath Interconnect) Snoop lets you configure different Snoop modes that impact the QPI interconnect. Changing this setting may improve the performance of certain workloads. The default setting of **Home Snoop** provides high memory bandwidth in an average NUMA environment. **Cluster on Die** may provide increased memory bandwidth in highly optimized NUMA workloads. **Early Snoop** may decrease memory latency, but may result in lower overall bandwidth compared to other modes. + +Installing the Operating System +=================================================== + +Once the BIOS settings have been set, you must install the operating system. Either the CentOS (versions 7.6-7.9) or RHEL (versions 7.6-7.9) must be installed before installing the SQream database, by either the customer or a SQream representative. + +**To install the operating system:** + +#. Select a language (English recommended). +#. From **Software Selection**, select **Minimal**. +#. Select the **Development Tools** group checkbox. +#. Continue the installation. +#. Set up the necessary drives and users as per the installation process. + + Using Debugging Tools is recommended for future problem-solving if necessary. + +Selecting the **Development Tools** group installs the following tools: + + * autoconf + * automake + * binutils + * bison + * flex + * gcc + * gcc-c++ + * gettext + * libtool + * make + * patch + * pkgconfig + * redhat-rpm-config + * rpm-build + * rpm-sign + +The root user is created and the OS shell is booted up. + +Configuring the Operating System +=================================================== + +Once you've installted your operation system, you can configure it. When configuring the operating system, several basic settings related to creating a new server are required. Configuring these as part of your basic set-up increases your server's security and usability. + +Logging In to the Server +-------------------------------- + +You can log in to the server using the server's IP address and password for the **root** user. The server's IP address and **root** user were created while installing the operating system above. + +Automatically Creating a SQream User +------------------------------------ + +**To automatically create a SQream user:** + +#. If a SQream user was created during installation, verify that the same ID is used on every server: + + .. code-block:: console + + $ sudo id sqream + + The ID **1000** is used on each server in the following example: + + .. code-block:: console + + $ uid=1000(sqream) gid=1000(sqream) groups=1000(sqream) + +2. If the ID's are different, delete the SQream user and SQream group from both servers: + + .. code-block:: console + + $ sudo userdel sqream + +3. Recreate it using the same ID: + + .. code-block:: console + + $ sudo rm /var/spool/mail/sqream + +Manually Creating a SQream User +-------------------------------- + +**To manually create a SQream user:** + +SQream enables you to manually create users. This section shows you how to manually create a user with the UID **1111**. You cannot manually create during the operating system installation procedure. + +1. Add a user with an identical UID on all cluster nodes: + + .. code-block:: console + + $ useradd -u 1111 sqream + +2. Add the user **sqream** to the **wheel** group. + + .. code-block:: console + + $ sudo usermod -aG wheel sqream + + You can remove the SQream user from the **wheel** group when the installation and configuration are complete: + + .. code-block:: console + + $ passwd sqream + +3. Log out and log back in as **sqream**. + + .. note:: If you deleted the **sqream** user and recreated it with different ID, to avoid permission errors, you must change its ownership to /home/sqream. + +4. Change the **sqream** user's ownership to /home/sqream: + + .. code-block:: console + + $ sudo chown -R sqream:sqream /home/sqream + +Setting Up A Locale +-------------------------------- + +SQream enables you to set up a locale. In this example, the locale used is your own location. + +**To set up a locale:** + +1. Set the language of the locale: + + .. code-block:: console + + $ sudo localectl set-locale LANG=en_US.UTF-8 + +2. Set the time stamp (time and date) of the locale: + + .. code-block:: console + + $ sudo timedatectl set-timezone Asia/Jerusalem + +If needed, you can run the **timedatectl list-timezones** command to see your current time-zone. + + +Installing the Required Packages +-------------------------------- + +You can install the required packages by running the following command: + +.. code-block:: console + + $ sudo yum install ntp pciutils monit zlib-devel openssl-devel kernel-devel-$(uname -r) kernel-headers-$(uname -r) gcc net-tools wget jq + + +Installing the Recommended Tools +-------------------------------- + +You can install the recommended tools by running the following command: + +.. code-block:: console + + $ sudo yum install bash-completion.noarch vim-enhanced vim-common net-tools iotop htop psmisc screen xfsprogs wget yum-utils deltarpm dos2unix + + +Installing Python 3.6.7 +-------------------------------- + +1. Download the Python 3.6.7 source code tarball file from the following URL into the **/home/sqream** directory: + + .. code-block:: console + + $ wget https://www.python.org/ftp/python/3.6.7/Python-3.6.7.tar.xz + +2. Extract the Python 3.6.7 source code into your current directory: + + .. code-block:: console + + $ tar -xf Python-3.6.7.tar.xz + +3. Navigate to the Python 3.6.7 directory: + + .. code-block:: console + + $ cd Python-3.6.7 + +4. Run the **./configure** script: + + .. code-block:: console + + $ ./configure + +5. Build the software: + + .. code-block:: console + + $ make -j30 + +6. Install the software: + + .. code-block:: console + + $ sudo make install + +7. Verify that Python 3.6.7 has been installed: + + .. code-block:: console + + $ python3 + +Installing NodeJS on CentOS +-------------------------------- + +**To install the node.js on CentOS:** + +1. Download the `setup_12.x file <https://rpm.nodesource.com/setup_12.x>`__ as a root user logged in shell: + + .. code-block:: console + + $ curl -sL https://rpm.nodesource.com/setup_12.x | sudo bash - + +2. Clear the YUM cache and update the local metadata: + + .. code-block:: console + + $ sudo yum clean all && sudo yum makecache fast + +3. Install the **node.js** file: + + .. code-block:: console + + $ sudo yum install -y nodejs + +4. Install npm and make it available for all users: + + .. code-block:: console + + $ sudo npm install pm2 -g + +Installing NodeJS on Ubuntu +-------------------------------- + +**To install the node.js file on Ubuntu:** + +1. Download the `setup_12.x file <https://deb.nodesource.com/setup_12.x>`__ as a root user logged in shell: + + .. code-block:: console + + $ curl -sL https://rpm.nodesource.com/setup_12.x | sudo bash - + +2. Install the node.js file: + + .. code-block:: console + + $ sudo apt-get install -y nodejs + +3. Install npm and make it available for all users: + + .. code-block:: console + + $ sudo npm install pm2 -g + +Installing NodeJS Offline +------------------------------------------- + +**To install NodeJS Offline** + +1. Download the NodeJS source code tarball file from the following URL into the **/home/sqream** directory: + + .. code-block:: console + + $ wget https://nodejs.org/dist/v12.13.0/node-v12.13.0-linux-x64.tar.xz + +2. Move the node-v12.13.0-linux-x64 file to the */usr/local* directory. + + .. code-block:: console + + $ sudo mv node-v12.13.0-linux-x64 /usr/local + +3. Navigate to the */usr/bin/* directory: + + .. code-block:: console + + $ cd /usr/bin + +4. Create a symbolic link to the */local/node-v12.13.0-linux-x64/bin/node node* directory: + + .. code-block:: console + + $ sudo ln -s ../local/node-v12.13.0-linux-x64/bin/node node + +5. Create a symbolic link to the */local/node-v12.13.0-linux-x64/bin/npm npm* directory: + + .. code-block:: console + + $ sudo ln -s ../local/node-v12.13.0-linux-x64/bin/npm npm + +6. Create a symbolic link to the */local/node-v12.13.0-linux-x64/bin/npx npx* directory: + + .. code-block:: console + + $ sudo ln -s ../local/node-v12.13.0-linux-x64/bin/npx npx + +7. Verify that the node versions for the above are correct: + + .. code-block:: console + + $ node --version + +Installing the pm2 Service Offline +------------------------------------------- + +**To install the pm2 Service Offline** + +1. On a machine with internet access, install the following: + + * nodejs + * npm + * pm2 + +2. Extract the pm2 module to the correct directory: + + .. code-block:: console + + $ cd /usr/local/node-v12.13.0-linux-x64/lib/node_modules + $ tar -czvf pm2_x86.tar.gz pm2 + +3. Copy the **pm2_x86.tar.gz** file to a server without access to the internet and extract it. + + :: + +4. Move the **pm2** folder to the */usr/local/node-v12.13.0-linux-x64/lib/node_modules* directory: + + .. code-block:: console + + $ sudo mv pm2 /usr/local/node-v12.13.0-linux-x64/lib/node_modules + +5. Navigate back to the */usr/bin* directory: + + .. code-block:: console + + $ cd /usr/bin again + +6. Create a symbolink to the **pm2** service: + + .. code-block:: console + + $ sudo ln -s /usr/local/node-v12.22.3-linux-x64/lib/node_modules/pm2/bin/pm2 pm2 + +7. Verify that installation was successful: + + .. code-block:: console + + $ pm2 list + + .. note:: This must be done as a **sqream** user, and not as a **sudo** user. + +8. Verify that the node version is correct: + + .. code-block:: console + + $ node -v + +Configuring the Network Time Protocol +------------------------------------------- + +This section describes how to configure your **Network Time Protocol (NTP)**. + +If you don't have internet access, see `Configure NTP Client to Synchronize with NTP Server <https://www.thegeekstuff.com/2014/06/linux-ntp-server-client/>`__. + +**To configure your NTP:** + +1. Install the NTP file. + + .. code-block:: console + + $ sudo yum install ntp + +2. Enable the **ntpd** program. + + .. code-block:: console + + $ sudo systemctl enable ntpd + +3. Start the **ntdp** program. + + .. code-block:: console + + $ sudo systemctl start ntpd + +4. Print a list of peers known to the server and a summary of their states. + + .. code-block:: console + + $ sudo ntpq -p + +Configuring the Network Time Protocol Server +-------------------------------------------- + +If your organization has an NTP server, you can configure it. + +**To configure your NTP server:** + +1. Output your NTP server address and append ``/etc/ntpd.conf`` to the outuput. + + .. code-block:: console + + $ echo -e "\nserver <your NTP server address>\n" | sudo tee -a /etc/ntp.conf + +2. Restart the service. + + .. code-block:: console + + $ sudo systemctl restart ntpd + +3. Check that synchronization is enabled: + + .. code-block:: console + + $ sudo timedatectl + + Checking that synchronization is enabled generates the following output: + + .. code-block:: console + + $ Local time: Sat 2019-10-12 17:26:13 EDT + Universal time: Sat 2019-10-12 21:26:13 UTC + RTC time: Sat 2019-10-12 21:26:13 + Time zone: America/New_York (EDT, -0400) + NTP enabled: yes + NTP synchronized: yes + RTC in local TZ: no + DST active: yes + Last DST change: DST began at + Sun 2019-03-10 01:59:59 EST + Sun 2019-03-10 03:00:00 EDT + Next DST change: DST ends (the clock jumps one hour backwards) at + Sun 2019-11-03 01:59:59 EDT + Sun 2019-11-03 01:00:00 EST + +Configuring the Server to Boot Without the UI +--------------------------------------------- + +You can configure your server to boot without a UI in cases when it is not required (recommended) by running the following command: + +.. code-block:: console + + $ sudo systemctl set-default multi-user.target + +Running this command activates the **NO-UI** server mode. + +Configuring the Security Limits +-------------------------------- + +The security limits refers to the number of open files, processes, etc. + +You can configure the security limits by running the **echo -e** command as a root user logged in shell: + +.. code-block:: console + + $ sudo bash + +.. code-block:: console + + $ echo -e "sqream soft nproc 1000000\nsqream hard nproc 1000000\nsqream soft nofile 1000000\nsqream hard nofile 1000000\nsqream soft core unlimited\nsqream hard core unlimited" >> /etc/security/limits.conf + +Configuring the Kernel Parameters +--------------------------------- + +**To configure the kernel parameters:** + +1. Insert a new line after each kernel parameter: + + .. code-block:: console + + $ echo -e "vm.dirty_background_ratio = 5 \n vm.dirty_ratio = 10 \n vm.swappiness = 10 \n vm.vfs_cache_pressure = 200 \n vm.zone_reclaim_mode = 0 \n" >> /etc/sysctl.conf + + .. note:: In the past, the **vm.zone_reclaim_mode** parameter was set to **7.** In the latest Sqream version, the vm.zone_reclaim_mode parameter must be set to **0**. If it is not set to **0**, when a numa node runs out of memory, the system will get stuck and will be unable to pull memory from other numa nodes. + +2. Check the maximum value of the **fs.file**. + + .. code-block:: console + + $ sysctl -n fs.file-max + +3. If the maximum value of the **fs.file** is smaller than **2097152**, run the following command: + + .. code-block:: console + + $ echo "fs.file-max=2097152" >> /etc/sysctl.conf + +4. Run the following command: + + .. code-block:: console + + $ sudo echo “net.ipv4.ip_forward = 1” >> /etc/sysctl.conf + +5. Reboot your system: + + .. code-block:: console + + $ sudo reboot + +Configuring the Firewall +-------------------------------- + +The example in this section shows the open ports for four sqreamd sessions. If more than four are required, open the required ports as needed. Port 8080 in the example below is a new UI port. + +**To configure the firewall:** + +1. Start the service and enable FirewallID on boot: + + .. code-block:: console + + $ systemctl start firewalld + +2. Add the following ports to the permanent firewall: + + .. code-block:: console + + $ firewall-cmd --zone=public --permanent --add-port=8080/tcp + $ firewall-cmd --zone=public --permanent --add-port=3105/tcp + $ firewall-cmd --zone=public --permanent --add-port=3108/tcp + $ firewall-cmd --zone=public --permanent --add-port=5000-5003/tcp + $ firewall-cmd --zone=public --permanent --add-port=5100-5103/tcp + $ firewall-cmd --permanent --list-all + +3. Reload the firewall: + + .. code-block:: console + + $ firewall-cmd --reload + +4. Enable FirewallID on boot: + + .. code-block:: console + + $ systemctl enable firewalld + + If you do not need the firewall, you can disable it: + + .. code-block:: console + + $ sudo systemctl disable firewalld + +Disabling selinux +-------------------------------- + +**To disable selinux:** + +1. Show the status of **selinux**: + + .. code-block:: console + + $ sudo sestatus + +2. If the output is not **disabled**, edit the **/etc/selinux/config** file: + + .. code-block:: console + + $ sudo vim /etc/selinux/config + +3. Change **SELINUX=enforcing** to **SELINUX=disabled**. + + The above changes will only take effect after rebooting the server. + + You can disable selinux immediately after rebooting the server by running the following command: + + .. code-block:: console + + $ sudo setenforce 0 + +Configuring the /etc/hosts File +-------------------------------- + +**To configure the /etc/hosts file:** + +1. Edit the **/etc/hosts** file: + + .. code-block:: console + + $ sudo vim /etc/hosts + +2. Call your local host: + + .. code-block:: console + + $ 127.0.0.1 localhost + $ <server1 ip> <server_name> + $ <server2 ip> <server_name> + +Configuring the DNS +-------------------------------- + +**To configure the DNS:** + +1. Run the **ifconfig** commasnd to check your NIC name. In the following example, **eth0** is the NIC name: + + .. code-block:: console + + $ sudo vim /etc/sysconfig/network-scripts/ifcfg-eth0 + +2. Replace the DNS lines from the example above with your own DNS addresses : + + .. code-block:: console + + $ DNS1="4.4.4.4" + $ DNS2="8.8.8.8" + +Installing the Nvidia CUDA Driver +=================================================== + +After configuring your operating system, you must install the Nvidia CUDA driver. + + .. warning:: If your UI runs on the server, the server must be stopped before installing the CUDA drivers. + +CUDA Driver Prerequisites +-------------------------------- + +1. Verify that the NVIDIA card has been installed and is detected by the system: + + .. code-block:: console + + $ lspci | grep -i nvidia + +2. Check which version of gcc has been installed: + + .. code-block:: console + + $ gcc --version + +3. If gcc has not been installed, install it for one of the following operating systems: + + * On RHEL/CentOS: + + .. code-block:: console + + $ sudo yum install -y gcc + + * On Ubuntu: + + .. code-block:: console + + $ sudo apt-get install gcc + +Updating the Kernel Headers +-------------------------------- + +**To update the kernel headers:** + +1. Update the kernel headers on one of the following operating systems: + + * On RHEL/CentOS: + + .. code-block:: console + + $ sudo yum install kernel-devel-$(uname -r) kernel-headers-$(uname -r) + + * On Ubuntu: + + .. code-block:: console + + $ sudo apt-get install linux-headers-$(uname -r) + +2. Install **wget** one of the following operating systems: + + * On RHEL/CentOS: + + .. code-block:: console + + $ sudo yum install wget + + * On Ubuntu: + + .. code-block:: console + + $ sudo apt-get install wget + +Disabling Nouveau +-------------------------------- + +You can disable Nouveau, which is the default driver. + +**To disable Nouveau:** + +1. Check if the Nouveau driver has been loaded: + + .. code-block:: console + + $ lsmod | grep nouveau + + If the Nouveau driver has been loaded, the command above generates output. + +2. Blacklist the Nouveau drivers to disable them: + + .. code-block:: console + + $ cat <<EOF | sudo tee /etc/modprobe.d/blacklist-nouveau.conf + blacklist nouveau + options nouveau modeset=0 + EOF + +3. Regenerate the kernel **initramfs** directory set: + + 1. Modify the **initramfs** directory set: + + .. code-block:: console + + $ sudo dracut --force + + 2. Reboot the server: + + .. code-block:: console + + $ sudo reboot + +Installing the CUDA Driver +-------------------------------- + +This section describes how to install the CUDA driver. + +.. note:: The version of the driver installed on the customer's server must be equal or higher than the driver included in the Sqream release package. Contact a Sqream customer service representative to identify the correct version to install. + +The **Installing the CUDA Driver** section describes the following: + +.. contents:: + :local: + :depth: 1 + +Installing the CUDA Driver from the Repository +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Installing the CUDA driver from the Repository is the recommended installation method. + +.. warning:: For A100 GPU and other A series GPUs, you must install the **cuda 11.4.3 driver**. The version of the driver installed on the customer server must be equal to or higher than the one used to build the SQream package. For questions related to which driver to install, contact SQream Customer Support. + +**To install the CUDA driver from the Repository:** + +1. Install the CUDA dependencies for one of the following operating systems: + + * For RHEL: + + .. code-block:: console + + $ sudo rpm -Uvh http://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm + + * For CentOS: + + .. code-block:: console + + $ sudo yum install epel-release + +2. Install the CUDA dependencies from the **epel** repository: + + .. code-block:: console + + $ sudo yum install dkms libvdpau + + Installing the CUDA depedendencies from the **epel** repository is only required for installing **runfile**. + +3. Download and install the required local repository: + + * **Intel - CUDA 10.1 for RHEL7**: + + .. code-block:: console + + $ wget http://developer.download.nvidia.com/compute/cuda/10.1/Prod/local_installers/cuda-repo-rhel7-10-1-local-10.1.243-418.87.00-1.0-1.x86_64.rpm + $ sudo yum localinstall cuda-repo-rhel7-10-1-local-10.1.243-418.87.00-1.0-1.x86_64.rpm + + * **Intel - 11.4.3 repository**: + + .. code-block:: console + + $ wget https://developer.download.nvidia.com/compute/cuda/11.4.3/local_installers/cuda-repo-rhel7-11-4-local-11.4.3_470.82.01-1.x86_64.rpm + $ sudo yum localinstall cuda-repo-rhel7-11-4-local-11.4.3_470.82.01-1.x86_64.rpm + + * **IBM Power9 - CUDA 10.1 for RHEL7**: + + .. code-block:: console + + $ wget https://developer.download.nvidia.com/compute/cuda/10.1/Prod/local_installers/cuda-repo-rhel7-10-1-local-10.1.243-418.87.00-1.0-1.ppc64le.rpm + $ sudo yum localinstall cuda-repo-rhel7-10-1-local-10.1.243-418.87.00-1.0-1.ppc64le.rpm + + +4. Install the CUDA drivers: + + a. Clear the YUM cache: + + .. code-block:: console + + $ sudo yum clean all + + b. Install the most current DKMS (Dynamic Kernel Module Support) NVIDIA driver: + + .. code-block:: console + + $ sudo yum -y install nvidia-driver-latest-dkms + +5. Verify that the installation was successful: + + .. code-block:: console + + $ nvidia-smi + +.. note:: If you do not have access to internet, you can set up a local repository offline. + +You can prepare the CUDA driver offline from a server connected to the CUDA repo by running the following commands as a *root* user: + +6. Query all the packages installed in your system, and verify that cuda-repo has been installed: + + .. code-block:: console + + $ rpm -qa |grep cuda-repo + +7. Navigate to the correct repository: + + .. code-block:: console + + $ cd /etc/yum.repos.d/ + +8. List in long format and print lines matching a pattern for the cuda file: + + .. code-block:: console + + $ ls -l |grep cuda + + The following is an example of the correct output: + + .. code-block:: console + + $ cuda-10-1-local.repo + +9. Edit the **/etc/yum.repos.d/cuda-10-1-local.repo** file: + + .. code-block:: console + + $ vim /etc/yum.repos.d/cuda-10-1-local.repo + + The following is an example of the correct output: + + .. code-block:: console + + $ name=cuda-10-1-local + +10. Clone the repository to a location where it can be copied from: + + .. code-block:: console + + $ reposync -g -l -m --repoid=cuda-10-1-local --download_path=/var/cuda-repo-10.1-local + +11. Copy the repository to the installation server and create the repository: + + .. code-block:: console + + $ createrepo -g comps.xml /var/cuda-repo-10.1-local + +12. Add a repo configuration file in **/etc/yum.repos.d/** by editing the **/etc/yum.repos.d/cuda-10.1-local.repo** repository: + + .. code-block:: console + + $ [cuda-10.1-local] + $ name=cuda-10.1-local + $ baseurl=file:///var/cuda-repo-10.1-local + $ enabled=1 + $ gpgcheck=1 + $ gpgkey=file:///var/cuda-repo-10-1-local/7fa2af80.pub + +13. Install the CUDA drivers by installing the most current DKMS (Dynamic Kernel Module Support) NVIDIA driver as a root user logged in shell: + + .. code-block:: console + + $ sudo yum -y install nvidia-driver-latest-dkms + +Tuning Up NVIDIA Performance +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +This section describes how to tune up NVIDIA performance. + +.. note:: The procedures in this section are relevant to Intel only. + +.. contents:: + :local: + :depth: 1 + +To Tune Up NVIDIA Performance when Driver Installed from the Repository +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**To tune up NVIDIA performance when the driver was installed from the repository:** + +1. Check the service status: + + .. code-block:: console + + $ sudo systemctl status nvidia-persistenced + + If the service exists, it will be stopped be default. + +2. Start the service: + + .. code-block:: console + + $ sudo systemctl start nvidia-persistenced + +3. Verify that no errors have occurred: + + .. code-block:: console + + $ sudo systemctl status nvidia-persistenced + +4. Enable the service to start up on boot: + + .. code-block:: console + + $ sudo systemctl enable nvidia-persistenced + +5. For **H100/A100**, add the following lines: + + .. code-block:: console + + $ nvidia-persistenced + + .. note:: The following are mandatory for IBM: + + .. code-block:: console + + $ sudo systemctl start nvidia-persistenced + $ sudo systemctl enable nvidia-persistenced + +6. Reboot the server and run the **NVIDIA System Management Interface (NVIDIA SMI)**: + + .. code-block:: console + + $ nvidia-smi + +.. note:: Setting up the NVIDIA POWER9 CUDA driver includes additional set-up requirements. The NVIDIA POWER9 CUDA driver will not function properly if the additional set-up requirements are not followed. See `POWER9 Setup <https://docs.nvidia.com/cuda/cuda-installation-guide-linux/index.html#power9-setup>`__ for the additional set-up requirements. + +To Tune Up NVIDIA Performance when Driver Installed from the Runfile +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**To tune up NVIDIA performance when the driver was installed from the runfile:** + +1. Change the permissions on the **rc.local** file to **executable**: + + .. code-block:: console + + $ sudo chmod +x /etc/rc.local + +2. Edit the **/etc/yum.repos.d/cuda-10-1-local.repo** file: + + .. code-block:: console + + $ sudo vim /etc/rc.local + +3. Add the following lines: + + * **For H100/A100**: + + .. code-block:: console + + $ nvidia-persistenced + + * **For IBM (mandatory)**: + + .. code-block:: console + + $ sudo systemctl start nvidia-persistenced + $ sudo systemctl enable nvidia-persistenced + + * **For K80**: + + .. code-block:: console + + $ nvidia-persistenced + $ nvidia-smi -pm 1 + $ nvidia-smi -acp 0 + $ nvidia-smi --auto-boost-permission=0 + $ nvidia-smi --auto-boost-default=0 + +4. Reboot the server and run the **NVIDIA System Management Interface (NVIDIA SMI)**: + + .. code-block:: console + + $ nvidia-smi + +.. note:: Setting up the NVIDIA POWER9 CUDA driver includes additional set-up requirements. The NVIDIA POWER9 CUDA driver will not function properly if the additional set-up requirements are not followed. See `POWER9 Setup <https://docs.nvidia.com/cuda/cuda-installation-guide-linux/index.html#power9-setup>`__ for the additional set-up requirements. + +Disabling Automatic Bug Reporting Tools +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +**To disable automatic bug reporting tools:** + +1. Run the following **abort** commands: + + .. code-block:: console + + $ for i in abrt-ccpp.service abrtd.service abrt-oops.service abrt-pstoreoops.service abrt-vmcore.service abrt-xorg.service ; do sudo systemctl disable $i; sudo systemctl stop $i; done + +The server is ready for the SQream software installation. + +2. Run the following checks: + + a. Check the OS release: + + .. code-block:: console + + $ cat /etc/os-release + + b. Verify that a SQream user exists and has the same ID on all cluster member services: + + .. code-block:: console + + $ id sqream + + c. Verify that the storage is mounted: + + .. code-block:: console + + $ mount + + d. Verify that the driver has been installed correctly: + + .. code-block:: console + + $ nvidia-smi + + e. Check the maximum value of the **fs.file**: + + .. code-block:: console + + $ sysctl -n fs.file-max + + f. Run the following command as a SQream user: + + .. code-block:: console + + $ ulimit -c -u -n + + The following shows the desired output: + + .. code-block:: console + + $ core file size (blocks, -c) unlimited + $ max user processes (-u) 1000000 + $ open files (-n) 1000000 + +Enabling Core Dumps +=================================================== + +After installing the Nvidia CUDA driver, you can enable your core dumps. While SQream recommends enabling your core dumps, it is optional. + +The **Enabling Core Dumps** section describes the following: + +.. contents:: + :local: + :depth: 1 + +Checking the abrtd Status +--------------------------------------------------- + +**To check the abrtd status:** + +1. Check if **abrtd** is running: + + .. code-block:: console + + $ sudo ps -ef |grep abrt + +2. If **abrtd** is running, stop it: + + .. code-block:: console + + $ sudo service abrtd stop + $ sudo chkconfig abrt-ccpp off + $ sudo chkconfig abrt-oops off + $ sudo chkconfig abrt-vmcore off + $ sudo chkconfig abrt-xorg off + $ sudo chkconfig abrtd off + +Setting the Limits +--------------------------------------------------- + +**To set the limits:** + +1. Set the limits: + + .. code-block:: console + + $ ulimit -c + +2. If the output is **0**, add the following lines to the **limits.conf** file (/etc/security): + + .. code-block:: console + + $ * soft core unlimited + $ * hard core unlimited + +3. Log out and log in to apply the limit changes. + +Creating the Core Dumps Directory +--------------------------------------------------- + +**To set the core dumps directory:** + +1. Make the **/tmp/core_dumps** directory: + + .. code-block:: console + + $ mkdir /tmp/core_dumps + +2. Set the ownership of the **/tmp/core_dumps** directory: + + .. code-block:: console + + $ sudo chown sqream.sqream /tmp/core_dumps + +3. Grant read, write, and execute permissions to all users: + + .. code-block:: console + + $ sudo chmod -R 777 /tmp/core_dumps + +.. warning:: Because the core dump file may be the size of total RAM on the server, verify that you have sufficient disk space. In the example above, the core dump is configured to the */tmp/core_dumps* directory. You must replace path according to your own environment and disk space. + +Setting the Output Directory of the /etc/sysctl.conf File +----------------------------------------------------------------- + +**To set the output directory of the /etc/sysctl.conf file:** + +1. Edit the **/etc/sysctl.conf** file: + + .. code-block:: console + + $ sudo vim /etc/sysctl.conf + +2. Add the following to the bottom of the file: + + .. code-block:: console + + $ kernel.core_uses_pid = 1 + $ kernel.core_pattern = /<tmp/core_dumps>/core-%e-%s-%u-%g-%p-%t + $ fs.suid_dumpable = 2 + +3. To apply the changes without rebooting the server, run the following: + + .. code-block:: console + + $ sudo sysctl -p + +4. Check that the core output directory points to the following: + + .. code-block:: console + + $ sudo cat /proc/sys/kernel/core_pattern + + The following shows the correct generated output: + + .. code-block:: console + + $ /tmp/core_dumps/core-%e-%s-%u-%g-%p-%t + +5. Verify that the core dumping works: + + .. code-block:: console + + $ select abort_server(); + +Verifying that the Core Dumps Work +--------------------------------------------------- + +You can verify that the core dumps work only after installing and running SQream. This causes the server to crash and a new core.xxx file to be included in the folder that is written in **/etc/sysctl.conf** + +**To verify that the core dumps work:** + +1. Stop and restart all SQream services. + + :: + +2. Connect to SQream with ClientCmd and run the following command: + + .. code-block:: console + + $ select abort_server(); + +Troubleshooting Core Dumping +--------------------------------------------------- + +This section describes the troubleshooting procedure to be followed if all parameters have been configured correctly, but the cores have not been created. + +**To troubleshoot core dumping:** + +1. Reboot the server. + + :: + +2. Verify that you have folder permissions: + + .. code-block:: console + + $ sudo chmod -R 777 /tmp/core_dumps + +3. Verify that the limits have been set correctly: + + .. code-block:: console + + $ ulimit -c + + If all parameters have been configured correctly, the correct output is: + + .. code-block:: console + + $ core file size (blocks, -c) unlimited + $ open files (-n) 1000000 + +4. If all parameters have been configured correctly, but running **ulimit -c** outputs **0**, run the following: + + .. code-block:: console + + $ sudo vim /etc/profile + +5. Search for line and tag it with the **hash** symbol: + + .. code-block:: console + + $ ulimit -S -c 0 > /dev/null 2>&1 + +6. Log out and log in. + + :: + +7. Run the ulimit -c command: + + .. code-block:: console + + $ ulimit -c command + +8. If the line is not found in **/etc/profile** directory, do the following: + + a. Run the following command: + + .. code-block:: console + + $ sudo vim /etc/init.d/functions + + b. Search for the following: + + .. code-block:: console + + $ ulimit -S -c ${DAEMON_COREFILE_LIMIT:-0} >/dev/null 2>&1 + + c. If the line is found, tag it with the **hash** symbol and reboot the server. From 5a1a9cbd2118ab50e021aea4780e32ffefea31fc Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 25 Apr 2024 16:54:24 +0300 Subject: [PATCH 828/882] Update pre-installation_configurations.rst --- installation_guides/pre-installation_configurations.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/installation_guides/pre-installation_configurations.rst b/installation_guides/pre-installation_configurations.rst index 3151fac6c..5b6a52388 100644 --- a/installation_guides/pre-installation_configurations.rst +++ b/installation_guides/pre-installation_configurations.rst @@ -1,10 +1,10 @@ .. _pre-installation_configurations: -********************************************* - Pre-Installation Configuration -********************************************* +****************************** +Pre-Installation Configuration +****************************** -Before :ref:`installing SQream DB<installing_sqream_db_docker>`, it is essential that you tune your system for better performance and stability. +Before installing SQreamDB, it is essential that you tune your system for better performance and stability. This page provides recommendations for production deployments of SQream and describes the following: From 5723802068e81f7fe03ee835b18bbefb276a135e Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 25 Apr 2024 17:02:33 +0300 Subject: [PATCH 829/882] Update pre-installation_configurations.rst --- installation_guides/pre-installation_configurations.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/installation_guides/pre-installation_configurations.rst b/installation_guides/pre-installation_configurations.rst index 5b6a52388..193872ca4 100644 --- a/installation_guides/pre-installation_configurations.rst +++ b/installation_guides/pre-installation_configurations.rst @@ -6,8 +6,6 @@ Pre-Installation Configuration Before installing SQreamDB, it is essential that you tune your system for better performance and stability. -This page provides recommendations for production deployments of SQream and describes the following: - .. contents:: :local: :depth: 1 From 5c4f07ef455f362a6c9de756eb56b2d687f4d874 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 1 May 2024 12:51:14 +0300 Subject: [PATCH 830/882] Update access_control_permissions.rst --- operational_guides/access_control_permissions.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/operational_guides/access_control_permissions.rst b/operational_guides/access_control_permissions.rst index 53753ec9a..68a87a724 100644 --- a/operational_guides/access_control_permissions.rst +++ b/operational_guides/access_control_permissions.rst @@ -65,7 +65,7 @@ The following table describe the required permissions for performing and executi +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | **Column** | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``SELECT`` | Select from catalog | +| ``SELECT`` | Select from column | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``DDL`` | Column DDL operations | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ From 51e7fc38a0d793e2b6350d7c78fa858c4cc78d35 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 29 May 2024 11:08:13 +0300 Subject: [PATCH 831/882] Update copy_from.rst --- reference/sql/sql_statements/dml_commands/copy_from.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/dml_commands/copy_from.rst b/reference/sql/sql_statements/dml_commands/copy_from.rst index 111949c83..07fc0f75a 100644 --- a/reference/sql/sql_statements/dml_commands/copy_from.rst +++ b/reference/sql/sql_statements/dml_commands/copy_from.rst @@ -616,4 +616,4 @@ In this example, ``date_col1`` and ``date_col2`` in the table are non-standard. .. code-block:: postgres - COPY my_table (date_col1, date_col2, date_col3) FROM '/tmp/my_data.csv' WITH CSV HEADER datetime_format 'DMY'; + COPY my_table (date_col1, date_col2, date_col3) FROM WRAPPER csv_fdw OPTIONS (location = '/tmp/my_data.csv', offset = 2, datetime_format 'DMY'); From 910f8c7e48c18b199347d883f8f8930c85735eeb Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 30 May 2024 09:36:23 +0300 Subject: [PATCH 832/882] Update create_foreign_table.rst --- .../ddl_commands/create_foreign_table.rst | 20 ++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst b/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst index 37781b1c3..31d18969d 100644 --- a/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst +++ b/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst @@ -42,7 +42,8 @@ Syntax | CONTINUE_ON_ERROR = { true | false } | ERROR_COUNT = '{ error count }' | AWS_SECRET '{ AWS SECRET }', - | OFFSET -- for CSV and JSON only + | OFFSET -- for CSV and JSON only, + | QUOTE = {'C' | E'\ooo') -- for CSV only } path_spec ::= { local filepath | S3 URI | HDFS URI } @@ -98,6 +99,8 @@ Parameters - Specifies if errors should be ignored or skipped. When set to ``true``, the transaction continues despite rejected data and rows containing partially faulty data are skipped entirely. This parameter should be set together with ``ERROR_COUNT``. When reading multiple files, if an entire file can’t be opened it will be skipped. Default value: ``false``. Value range: ``true`` or ``false``. * - ``ERROR_COUNT`` - Specifies the threshold for the maximum number of faulty records that will be ignored. This setting must be used in conjunction with ``CONTINUE_ON_ERROR``. Default value: ``unlimited``. Value range: 1 to 2147483647. + * - ``QUOTE`` + - Specifies an alternative quote character. The quote character must be a single, 1-byte printable ASCII character, and the equivalent octal syntax of the copy command can be used. The quote character cannot be contained in the field delimiter, the record delimiter, or the null marker. QUOTE can be used with ``csv_fdw`` in ``COPY FROM`` and foreign tables. The following characters cannot be an alternative quote character: ``"-.:\\0123456789abcdefghijklmnopqrstuvwxyzN"`` @@ -190,4 +193,19 @@ Using the ``CONTINUE_ON_ERROR`` and ``ERROR_COUNT`` Parameters continue_on_error = true, ERROR_COUNT = 3 ) + ; + +Customizing Quotations Using Alternative Characters +--------------------------------------------------- + +.. code-block:: + + CREATE OR REPLACE FOREIGN TABLE cool_animalz + (id INT NOT NULL, name text(30) NOT NULL, weight FLOAT NOT NULL) + WRAPPER csv_fdw + OPTIONS + ( LOCATION = '/home/rhendricks/cool_animals.csv', + DELIMITER = '\t', + QUOTE = '@' + ) ; \ No newline at end of file From 5cedb4944d9bf23c9a73aa006cae690b9e8b853b Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 30 May 2024 11:17:13 +0300 Subject: [PATCH 833/882] Update copy_from.rst --- .../sql_statements/dml_commands/copy_from.rst | 19 +++++++++++++++++-- 1 file changed, 17 insertions(+), 2 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/copy_from.rst b/reference/sql/sql_statements/dml_commands/copy_from.rst index 07fc0f75a..cebd852de 100644 --- a/reference/sql/sql_statements/dml_commands/copy_from.rst +++ b/reference/sql/sql_statements/dml_commands/copy_from.rst @@ -21,13 +21,13 @@ Syntax .. code-block:: postgres - COPY [schema name.]table_name + COPY [schema name.]table_name [ (<column_name>) [, ...] ] FROM WRAPPER fdw_name OPTIONS ( [ copy_from_option [, ...] ] ) - ; + schema_name ::= identifer @@ -617,3 +617,18 @@ In this example, ``date_col1`` and ``date_col2`` in the table are non-standard. .. code-block:: postgres COPY my_table (date_col1, date_col2, date_col3) FROM WRAPPER csv_fdw OPTIONS (location = '/tmp/my_data.csv', offset = 2, datetime_format 'DMY'); + +Loading Specific Columns +------------------------ + +.. code-block:: postgres + + COPY + new_nba (name, salary) + FROM + WRAPPER + parquet_fdw + OPTIONS + ( + LOCATION = '/tmp/nba.parquet' + ); \ No newline at end of file From 738183a7d6b49e5f2d6fc60f9a604e5e32f31185 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 30 May 2024 14:26:33 +0300 Subject: [PATCH 834/882] Update copy_from.rst --- reference/sql/sql_statements/dml_commands/copy_from.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/reference/sql/sql_statements/dml_commands/copy_from.rst b/reference/sql/sql_statements/dml_commands/copy_from.rst index cebd852de..1042df573 100644 --- a/reference/sql/sql_statements/dml_commands/copy_from.rst +++ b/reference/sql/sql_statements/dml_commands/copy_from.rst @@ -621,6 +621,8 @@ In this example, ``date_col1`` and ``date_col2`` in the table are non-standard. Loading Specific Columns ------------------------ +Loading specific columns using the COPY FROM command is not supported when using the CSV file format. + .. code-block:: postgres COPY From 15f8d45cbfeccf1a7f101fa150d1f99b1c6e1115 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 30 May 2024 15:00:56 +0300 Subject: [PATCH 835/882] Update copy_from.rst --- reference/sql/sql_statements/dml_commands/copy_from.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/dml_commands/copy_from.rst b/reference/sql/sql_statements/dml_commands/copy_from.rst index 1042df573..826703a4b 100644 --- a/reference/sql/sql_statements/dml_commands/copy_from.rst +++ b/reference/sql/sql_statements/dml_commands/copy_from.rst @@ -621,7 +621,7 @@ In this example, ``date_col1`` and ``date_col2`` in the table are non-standard. Loading Specific Columns ------------------------ -Loading specific columns using the COPY FROM command is not supported when using the CSV file format. +Loading specific columns using the ``COPY FROM`` command is not supported when using the CSV file format. .. code-block:: postgres From 6d6f6142540d1ba2fe094d4a9d81772550608373 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 4 Jun 2024 12:57:07 +0300 Subject: [PATCH 836/882] Update create_foreign_table.rst --- .../ddl_commands/create_foreign_table.rst | 225 ++++++++++-------- 1 file changed, 125 insertions(+), 100 deletions(-) diff --git a/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst b/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst index 31d18969d..12288a310 100644 --- a/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst +++ b/reference/sql/sql_statements/ddl_commands/create_foreign_table.rst @@ -1,68 +1,59 @@ .. _create_foreign_table: -*********************** +******************** CREATE FOREIGN TABLE -*********************** +******************** ``CREATE FOREIGN TABLE`` creates a new foreign table in an existing database. Changes in the source data can result in corresponding modifications to the content of a foreign table. Consistent access to remote files might impact performance. Permissions -============= +=========== The role must have the ``CREATE`` permission at the database level. Syntax -========== +====== .. code-block:: postgres - create_table_statement ::= - CREATE [ OR REPLACE ] FOREIGN TABLE [schema_name].table_name ( - { column_def [, ...] } - ) - [ FOREIGN DATA ] WRAPPER fdw_name - [ OPTIONS ( option_def [, ... ] ) ] - - - schema_name ::= identifier + CREATE [ OR REPLACE ] FOREIGN TABLE [ "<schema_name>" ]."<table_name>" ( + [ column_def [, ...] ] -- When creating foreign tables using CSV source files, it is mandatory to provide the complete table DDL + ) + [ FOREIGN DATA ] WRAPPER fdw_name + [ OPTIONS ( option_def [, ... ] ) ] - table_name ::= identifier - - fdw_name ::= - { csv_fdw | orc_fdw | parquet_fdw | json_fdw | avro_fdw } + fdw_name ::= + { csv_fdw | orc_fdw | parquet_fdw } - option_def ::= - { - LOCATION = '{ path_spec }', - | DELIMITER = '{ field_delimiter }' -- for CSV only, - | RECORD_DELIMITER = '{ record_delimiter }', -- for CSV only - | AWS_ID '{ AWS ID }', - | CONTINUE_ON_ERROR = { true | false } - | ERROR_COUNT = '{ error count }' - | AWS_SECRET '{ AWS SECRET }', - | OFFSET -- for CSV and JSON only, - | QUOTE = {'C' | E'\ooo') -- for CSV only - } + option_def ::= + LOCATION = '{ path_spec }' + [ + | DELIMITER = '{ field_delimiter }' -- for CSV only + | RECORD_DELIMITER = '{ record_delimiter }' -- for CSV only + | AWS_ID '{ AWS ID }' + | AWS_SECRET '{ AWS SECRET }' + | QUOTE = {'C' | E'\ooo') -- for CSV only + ] - path_spec ::= { local filepath | S3 URI | HDFS URI } + path_spec ::= { GS URI | S3 URI | HDFS URI } - field_delimiter ::= delimiter_character + field_delimiter ::= delimiter_character - record_delimiter ::= delimiter_character + record_delimiter ::= delimiter_character - column_def ::= - { column_name type_name [ default ] [ column_constraint ] } + column_def ::= + { column_name type_name [ default ] [ column_constraint ] } - column_name ::= identifier + column_name ::= identifier - column_constraint ::= - { NOT NULL | NULL } + column_constraint ::= + { NOT NULL | NULL } - default ::= - DEFAULT default_value - | IDENTITY [ ( start_with [ , increment_by ] ) ] + default ::= + DEFAULT default_value + | IDENTITY [ ( start_with [ , increment_by ] ) ] .. _cft_parameters: @@ -82,7 +73,7 @@ Parameters * - ``table_name`` - The name of the table to create, which must be unique inside the schema * - ``column_def`` - - A comma separated list of column definitions. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally + - A comma separated list of column definitions. A minimal column definition includes a name and datatype. Other column constraints and default values may optionally be added. When creating foreign tables using CSV source files, it is mandatory to provide the complete table DDL * - ``WRAPPER ...`` - Specifies the format of the source files, such as ``parquet_fdw``, ``orc_fdw``, ``json_fdw``, or ``csv_fdw`` * - ``LOCATION = ...`` @@ -96,9 +87,9 @@ Parameters * - ``OFFSET`` - Used to specify the number of rows to skip from the beginning of the result set * - ``CONTINUE_ON_ERROR`` - - Specifies if errors should be ignored or skipped. When set to ``true``, the transaction continues despite rejected data and rows containing partially faulty data are skipped entirely. This parameter should be set together with ``ERROR_COUNT``. When reading multiple files, if an entire file can’t be opened it will be skipped. Default value: ``false``. Value range: ``true`` or ``false``. + - Specifies if errors should be ignored or skipped. When set to ``true``, the transaction continues despite rejected data and rows containing partially faulty data are skipped entirely. This parameter should be set together with ``ERROR_COUNT``. When reading multiple files, if an entire file can’t be opened it will be skipped. Default value: ``false``. Value range: ``true`` or ``false`` * - ``ERROR_COUNT`` - - Specifies the threshold for the maximum number of faulty records that will be ignored. This setting must be used in conjunction with ``CONTINUE_ON_ERROR``. Default value: ``unlimited``. Value range: 1 to 2147483647. + - Specifies the threshold for the maximum number of faulty records that will be ignored. This setting must be used in conjunction with ``CONTINUE_ON_ERROR``. Default value: ``unlimited``. Value range: 1 to 2147483647 * - ``QUOTE`` - Specifies an alternative quote character. The quote character must be a single, 1-byte printable ASCII character, and the equivalent octal syntax of the copy command can be used. The quote character cannot be contained in the field delimiter, the record delimiter, or the null marker. QUOTE can be used with ``csv_fdw`` in ``COPY FROM`` and foreign tables. The following characters cannot be an alternative quote character: ``"-.:\\0123456789abcdefghijklmnopqrstuvwxyzN"`` @@ -107,75 +98,99 @@ Parameters Examples =========== -A simple table from Tab-delimited file (TSV) ----------------------------------------------- +Creating a Tab-Delimited Table +------------------------------ .. code-block:: postgres - CREATE OR REPLACE FOREIGN TABLE cool_animals - (id INT NOT NULL, name text(30) NOT NULL, weight FLOAT NOT NULL) - WRAPPER csv_fdw - OPTIONS - ( LOCATION = '/home/rhendricks/cool_animals.csv', - DELIMITER = '\t' - ) - ; + CREATE + OR REPLACE FOREIGN TABLE nba_new( + "player_name" text null, + "team_name" text null, + "jersey_number" int null, + "position" text null, + "age" int null, + "height" text null, + "weight" int null, + "college" text null, + "salary" int null + ) + WRAPPER + csv_fdw + OPTIONS + (LOCATION = 'gs://blue_docs/nba.csv', + DELIMITER = '\t' + ); -A table from a directory of Parquet files on HDFS ------------------------------------------------------ +Creating a Table Located In a HDFS Directory +-------------------------------------------- .. code-block:: postgres - CREATE FOREIGN TABLE users - (id INT NOT NULL, name text(30) NOT NULL, email text(50) NOT NULL) - WRAPPER parquet_fdw - OPTIONS - ( - LOCATION = 'hdfs://hadoop-nn.piedpiper.com/rhendricks/users/*.parquet' - ); + CREATE FOREIGN TABLE users ( + id INT NOT NULL, + name TEXT(30) NOT NULL, + email TEXT(50) NOT NULL + ) + WRAPPER + parquet_fdw + OPTIONS + ( + LOCATION = 'hdfs://hadoop-nn.piedpiper.com/rhendricks/users/*.parquet' + ); -A table from a bucket of ORC files on S3 ------------------------------------------- +Creating a Table Located Within a S3 Bucket of ORC Files +-------------------------------------------------------- .. code-block:: postgres - CREATE FOREIGN TABLE users - (id INT NOT NULL, name text(30) NOT NULL, email text(50) NOT NULL) - WRAPPER orc_fdw - OPTIONS - ( - LOCATION = 's3://pp-secret-bucket/users/*.orc', - AWS_ID = 'our_aws_id', - AWS_SECRET = 'our_aws_secret' - ); - + CREATE FOREIGN TABLE users ( + id INT NOT NULL, + name TEXT(30) NOT NULL, + email TEXT(50) NOT NULL + ) + WRAPPER + orc_fdw + OPTIONS + ( + LOCATION = 's3://pp-secret-bucket/users/*.orc', + AWS_ID = 'our_aws_id', + AWS_SECRET = 'our_aws_secret' + ); -Changing a foreign table to a regular table ------------------------------------------------- -Materializes a foreign table into a regular table. +Converting a Foreign Table to an Internal Table +----------------------------------------------- -.. tip: Using a foreign table allows you to perform ETL-like operations in SQream DB by applying SQL functions and operations to raw files +Using a foreign table allows you to perform ETL-like operations by applying SQL functions and operations to raw files. .. code-block:: postgres - CREATE TABLE real_table - AS SELECT * FROM some_foreign_table; + CREATE TABLE + real_table AS + SELECT + * + FROM + some_foreign_table; Using the ``OFFSET`` Parameter --------------------------------- +------------------------------ The ``OFFSET`` parameter may be used with Parquet and CSV textual formats. .. code-block:: - CREATE FOREIGN TABLE users7 - (id INT NOT NULL, name text(30) NOT NULL, email text(50) NOT NULL) - WRAPPER parquet_fdw + CREATE FOREIGN TABLE users7 ( + id INT NOT NULL, + name TEXT NOT NULL, + email TEXT NOT NULL + ) + WRAPPER + parquet_fdw OPTIONS ( - LOCATION = 'hdfs://hadoop-nn.piedpiper.com/rhendricks/users/*.parquet', + LOCATION = 'hdfs://hadoop-nn.piedpiper.com/rhendricks/users/*.parquet', OFFSET = 2 ); @@ -184,28 +199,38 @@ Using the ``CONTINUE_ON_ERROR`` and ``ERROR_COUNT`` Parameters .. code-block:: - CREATE OR REPLACE FOREIGN TABLE cool_animalz - (id INT NOT NULL, name text(30) NOT NULL, weight FLOAT NOT NULL) - WRAPPER csv_fdw + CREATE + OR REPLACE FOREIGN TABLE cool_animalz ( + id INT NOT NULL, + name TEXT NOT NULL, + weight FLOAT NOT NULL + ) + WRAPPER + csv_fdw OPTIONS - ( LOCATION = '/home/rhendricks/cool_animals.csv', - DELIMITER = '\t', - continue_on_error = true, - ERROR_COUNT = 3 - ) - ; + ( + LOCATION = '/home/rhendricks/cool_animals.csv', + DELIMITER = '\t', + CONTINUE_ON_ERROR = true, + ERROR_COUNT = 3 + ); Customizing Quotations Using Alternative Characters --------------------------------------------------- .. code-block:: - CREATE OR REPLACE FOREIGN TABLE cool_animalz - (id INT NOT NULL, name text(30) NOT NULL, weight FLOAT NOT NULL) - WRAPPER csv_fdw + CREATE + OR REPLACE FOREIGN TABLE cool_animalz ( + id INT NOT NULL, + name text(30) NOT NULL, + weight FLOAT NOT NULL + ) + WRAPPER + csv_fdw OPTIONS - ( LOCATION = '/home/rhendricks/cool_animals.csv', + ( + LOCATION = '/home/rhendricks/cool_animals.csv', DELIMITER = '\t', QUOTE = '@' - ) - ; \ No newline at end of file + ); \ No newline at end of file From 806808a67c5844569a39b7af486c7d827f5b2f96 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 4 Jun 2024 13:15:58 +0300 Subject: [PATCH 837/882] Update copy_from.rst --- .../sql_statements/dml_commands/copy_from.rst | 20 ++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/copy_from.rst b/reference/sql/sql_statements/dml_commands/copy_from.rst index 826703a4b..020c6baea 100644 --- a/reference/sql/sql_statements/dml_commands/copy_from.rst +++ b/reference/sql/sql_statements/dml_commands/copy_from.rst @@ -1,10 +1,10 @@ .. _copy_from: -********************** +********* COPY FROM -********************** +********* -``COPY ... FROM`` is a statement that allows loading data from files on the filesystem and importing them into SQream tables. This is the recommended way for bulk loading CSV files into SQream DB. In general, ``COPY`` moves data between filesystem files and SQream DB tables. +``COPY ... FROM`` is a statement that allows loading data from files on the filesystem and importing them into SQreamDB tables. This is the recommended way for bulk loading CSV files into SQreamDB. In general, ``COPY`` moves data between filesystem files and SQreamDB tables. .. note:: * Learn how to migrate from CSV files in the :ref:`csv` guide @@ -12,12 +12,12 @@ COPY FROM * To load Parquet or ORC files, see :ref:`CREATE FOREIGN TABLE<create_foreign_table>` Permissions -============= +=========== The role must have the ``INSERT`` permission to the destination table. Syntax -========== +====== .. code-block:: postgres @@ -608,9 +608,7 @@ When the source of the files does not match the table structure, tell the ``COPY Loading Non-Standard Dates ---------------------------------- -If files contain dates not formatted as ``ISO8601``, tell ``COPY`` how to parse the column. After parsing, the date will appear as ``ISO8601`` inside SQreamDB. - -These are called date parsers. You can find the supported dates in the :ref:`'Supported date parsers' table<copy_date_parsers>` above. +If your files contain dates in a format other than ``ISO8601``, you can specify a :ref:`parsing<copy_date_parsers>` format to convert them during the import process. This ensures the dates are stored internally as ``ISO8601`` within the database. In this example, ``date_col1`` and ``date_col2`` in the table are non-standard. ``date_col3`` is mentioned explicitly, but can be left out. Any column that is not specified is assumed to be ``ISO8601``. @@ -621,7 +619,11 @@ In this example, ``date_col1`` and ``date_col2`` in the table are non-standard. Loading Specific Columns ------------------------ -Loading specific columns using the ``COPY FROM`` command is not supported when using the CSV file format. +Loading specific columns using the ``COPY FROM`` command: + +* Does not support CSV files + +* Requires that the target table columns be nullable .. code-block:: postgres From 1fd9371c6e2e7a126777494388174aa0fadfaf6a Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 13 Jun 2024 16:30:37 +0300 Subject: [PATCH 838/882] Update index.rst --- architecture/index.rst | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/architecture/index.rst b/architecture/index.rst index 83111b8cd..213700b35 100644 --- a/architecture/index.rst +++ b/architecture/index.rst @@ -1,16 +1,14 @@ .. _architecture: -******************* -System Architecture -******************* +************ +Architecture +************ -The :ref:`internals_architecture` and :ref:`filesystem_and_filesystem_usage` guides are walk-throughs for end-users, database administrators, and system architects who wish to get familiarized with the SQreamDB system and its unique capabilities. +The :ref:`internals_architecture`, :ref:`concurrency_and_scaling_in_sqream`, and :ref:`filesystem_and_filesystem_usage` guides are walk-throughs for end-users, database administrators, and system architects who wish to get familiarized with the SQreamDB system and its unique capabilities. .. figure:: /_static/images/sqream_db_table_crop.png :scale: 60 % - - .. toctree:: :hidden: From 5258f81ce839040a2421508dc066eac996c6f9ae Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 17 Jun 2024 13:43:48 +0300 Subject: [PATCH 839/882] Update create_table.rst --- .../ddl_commands/create_table.rst | 138 +++++++++--------- 1 file changed, 69 insertions(+), 69 deletions(-) diff --git a/reference/sql/sql_statements/ddl_commands/create_table.rst b/reference/sql/sql_statements/ddl_commands/create_table.rst index 76b3e3086..111e15229 100644 --- a/reference/sql/sql_statements/ddl_commands/create_table.rst +++ b/reference/sql/sql_statements/ddl_commands/create_table.rst @@ -1,30 +1,29 @@ .. _create_table: -***************** +************ CREATE TABLE -***************** +************ The ``CREATE TABLE`` statement is used to create a new table in an existing database. -.. tip:: - * To create a table based on the result of a select query, see :ref:`CREATE TABLE AS <create_table_as>`. - * To create a table based on files like Parquet and ORC, see :ref:`CREATE FOREIGN TABLE <create_foreign_table>` - +See also: :ref:`CREATE TABLE AS <create_table_as>`, :ref:`CREATE FOREIGN TABLE <create_foreign_table>` +.. contents:: + :local: + :depth: 1 Syntax -========== - -The following is the correct syntax for creating a table: +====== .. code-block:: postgres create_table_statement ::= - CREATE [ OR REPLACE ] TABLE [schema_name.]table_name ( - { column_def [, ...] } - ) - [ CLUSTER BY { column_name [, ...] } ] - ; + CREATE [ OR REPLACE ] TABLE [<schema_name>.]<table_name> + { + (<column_def> [, ...] [{NULL | NOT NULL}] + | LIKE <source_table> [INCLUDE PERMISSIONS] + } + [ CLUSTER BY <column_name> [, ...] ] schema_name ::= identifier @@ -33,16 +32,14 @@ The following is the correct syntax for creating a table: column_def :: = { column_name type_name [ default ] [ column_constraint ] } column_name ::= identifier - - column_constraint ::= - { NOT NULL | NULL } + default ::= DEFAULT default_value | IDENTITY [ ( start_with [ , increment_by ] ) ] Parameters -============ +========== The following parameters can be used when creating a table: @@ -53,39 +50,48 @@ The following parameters can be used when creating a table: * - Parameter - Description * - ``OR REPLACE`` - - Creates a new table and overwrites any existing table by the same name. Does not return an error if the table already exists. ``CREATE OR REPLACE`` does not check table contents or structure, only the table name. + - Creates a new table and overwrites any existing table by the same name. Does not return an error if the table already exists. ``CREATE OR REPLACE`` does not check table contents or structure, only the table name * - ``schema_name`` - - The name of the schema in which to create the table. + - The name of the schema in which to create the table * - ``table_name`` - - The name of the table to create, which must be unique inside the schema. + - The name of the table to create, which must be unique inside the schema * - ``column_def`` - - A comma separated list of column definitions. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally. + - A comma separated list of column definitions. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally + * - ``LIKE`` + - Duplicates the column structure of an existing table. The newly created table is granted default ``CREATE TABLE`` permissions: ``SELECT``, ``INSERT``, ``DELETE``, ``DDL``, and ``UPDATE`` + * - ``INCLUDE PERMISSIONS`` + - In addition to the default ``CREATE TABLE`` permissions (``SELECT``, ``INSERT``, ``DELETE``, ``DDL``, and ``UPDATE``), the newly created table is granted the source table existing permissions * - ``CLUSTER BY column_name1 ...`` - - A comma separated list of clustering column keys. + A comma separated list of clustering column keys - See :ref:`cluster_by` for more information. - * - ``LIKE`` - - Duplicates the column structure of an existing table. - - + See :ref:`cluster_by` for more information + + +Usage Notes +=========== + +When using ``CREATE TABLE... LIKE``, the permissions from the source table are inherited by the newly created table. To add extra permissions to the new table, you can utilize the ``INCLUDE PERMISSIONS`` clause. + .. _default_values: Default Value Constraints -=========================== +========================= -The ``DEFAULT`` value constraint specifies a value to use if one is not defined in an :ref:`insert` or :ref:`copy_from` statement. +The ``DEFAULT`` value constraint specifies a default value to use if none is provided in an :ref:`insert` or :ref:`copy_from` statement. This value can be a literal or ``NULL``. It's worth noting that even for nullable columns, you can still explicitly insert a ``NULL`` value using the ``NULL`` keyword, as demonstrated in the example: -The default value may be a literal or NULL. +.. code-block:: postgres -.. note:: The ``DEFAULT`` constraint only applies if the column does not have a value specified in the :ref:`insert` or :ref:`copy_from` statement. You can still insert a ``NULL`` into an nullable column by explicitly inserting ``NULL``. For example, ``INSERT INTO cool_animals VALUES (1, 'Gnu', NULL)``. + INSERT INTO + cool_animals + VALUES + (1, 'Gnu', NULL); Syntax ---------- +------ The following is the correct syntax for using the **DEFAULT** value constraints: - .. code-block:: postgres column_def :: = { column_name type_name [ default ] [ column_constraint ] } @@ -95,7 +101,9 @@ The following is the correct syntax for using the **DEFAULT** value constraints: default ::= DEFAULT default_value - | IDENTITY [ ( start_with [ , increment_by ] ) ] + | IDENTITY [ ( start_with [ , increment_by ] ) ] [ check_specification ] + | check_specification [ IDENTITY [ ( start_with [ , increment_by ] ) ] + check_specification ::= CHECK( 'CS compression_spec' ) @@ -107,7 +115,7 @@ The following is the correct syntax for using the **DEFAULT** value constraints: .. _identity: Identity ------------------------ +-------- The ``Identity`` (or sequence) columns can be used for generating key values. Some databases call this ``AUTOINCREMENT``. @@ -130,9 +138,7 @@ The following table describes the identity parameters: - Incremental value that is added to the identity value of the previous row that was loaded. Examples -=========== - -This section includes the following examples: +======== .. contents:: :local: @@ -141,8 +147,6 @@ This section includes the following examples: Creating a Standard Table -------------------------- -The following is an example of the syntax used to create a standard table: - .. code-block:: postgres CREATE TABLE cool_animals ( @@ -153,10 +157,7 @@ The following is an example of the syntax used to create a standard table: ); Creating a Table with Default Value Constraints for Some Columns --------------------------------------------------------------------- - -The following is an example of the syntax used to create a table with default value constraints for some columns: - +---------------------------------------------------------------- .. code-block:: postgres @@ -170,10 +171,7 @@ The following is an example of the syntax used to create a table with default va .. note:: The nullable/non-nullable constraint appears at the end, after the default option Creating a Table with an Identity Column ---------------------------------------------------- - -The following is an example of the syntax used to create a table with an identity (auto-increment) column: - +---------------------------------------- .. code-block:: postgres @@ -185,25 +183,27 @@ The following is an example of the syntax used to create a table with an identit .. note:: Identity does not enforce the uniqueness of values. The identity value can be bypassed by specifying it in an :ref:`insert` command. -Creating a Table from a SELECT Query ------------------------------------------ - -The following is an example of the syntax used to create a table from a SELECT query: +Creating a Table from a ``SELECT`` Query +---------------------------------------- .. code-block:: postgres - CREATE TABLE users_uk AS SELECT * FROM users WHERE country = 'United Kingdom'; + CREATE TABLE + users_uk AS + SELECT + * + FROM + users + WHERE + country = 'United Kingdom'; -For more information on creating a new table from the results of a SELECT query, see :ref:`CREATE TABLE AS <create_table_as>`. +For more information on creating a new table from the results of a ``SELECT`` query, see :ref:`CREATE TABLE AS <create_table_as>`. Creating a Table with a Clustering Key ----------------------------------------------- +-------------------------------------- -When data in a table is stored in a sorted order, the sorted columns are considered clustered. Good clustering can have a significant positive impact on performance. -In the following example, we expect the ``start_date`` column to be naturally clustered, as new users sign up and get a newer start date. - -When the clustering key is set, if the incoming data isn’t naturally clustered, it will be clustered by SQream DB during insert or bulk load. +When data within a table is organized in a sorted manner, the columns responsible for this sorting are termed as clustered. Effective clustering can greatly enhance performance. For instance, in the scenario provided, the ``start_date`` column is anticipated to naturally cluster due to the continuous influx of new users and their corresponding start dates. However, in cases where the clustering of incoming data isn't inherent, SQreamDB will automatically cluster it during insertion or bulk loading processes once the clustering key is set. The following is an example of the syntax used to create a table with a clustering key: @@ -218,25 +218,25 @@ The following is an example of the syntax used to create a table with a clusteri For more information on data clustering, see :ref:`cluster_by`. Duplicating the Column Structure of an Existing Table ------------------------------------------------------------- +----------------------------------------------------- Syntax -************ +****** The following is the correct syntax for duplicating the column structure of an existing table: .. code-block:: postgres - CREATE [OR REPLACE] TABLE table_name + CREATE [OR REPLACE] TABLE <table_name> { - (column_name column_type [{NULL | NOT NULL}] [,...]) - | LIKE source_table_name + (<column_name> <column_type> [{NULL | NOT NULL}] [,...]) + | LIKE <source_table_name> [INCLUDE PERMISSIONS] } [CLUSTER BY ...] ; Examples -************** +******** This section includes the following examples of duplicating the column structure of an existing table using the ``LIKE`` clause: @@ -245,7 +245,7 @@ This section includes the following examples of duplicating the column structure :depth: 3 Creating a Table Using an Explicit Column List -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The following is an example of creating a table using an explicit column list: @@ -254,7 +254,7 @@ The following is an example of creating a table using an explicit column list: CREATE TABLE t1(x int default 0 not null, y text(10) null); Creating a Second Table Based on the Structure of Another Table -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Either of the following examples can be used to create a second table based on the structure of another table. @@ -306,4 +306,4 @@ The following table describes which properties are copied from the target table Permissions ============= -The role must have the ``CREATE`` permission at the schema level. +``CREATE TABLE`` requires ``CREATE`` permission at the schema level. From b53b59c893a0a934d1a8a9b49ed4fc166b60c7c3 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 17 Jun 2024 15:45:39 +0300 Subject: [PATCH 840/882] ALTER TABLE maintenance --- .../ddl_commands/add_column.rst | 82 +++++++++---------- .../ddl_commands/alter_table.rst | 22 +++-- .../ddl_commands/cluster_by.rst | 76 ++++++++--------- .../ddl_commands/drop_clustering_key.rst | 45 +++++----- .../ddl_commands/drop_column.rst | 55 ++++++------- .../ddl_commands/rename_column.rst | 59 +++++-------- .../ddl_commands/rename_table.rst | 45 +++++----- 7 files changed, 177 insertions(+), 207 deletions(-) diff --git a/reference/sql/sql_statements/ddl_commands/add_column.rst b/reference/sql/sql_statements/ddl_commands/add_column.rst index 0cf7143fd..0fb006226 100644 --- a/reference/sql/sql_statements/ddl_commands/add_column.rst +++ b/reference/sql/sql_statements/ddl_commands/add_column.rst @@ -1,40 +1,35 @@ .. _add_column: -********************** +********** ADD COLUMN -********************** +********** The ``ADD COLUMN`` command is used to add columns to an existing table. Syntax -========== - -The following is the correct syntax for adding a column to an existing table: +====== .. code-block:: postgres - alter_table_add_column_statement ::= - ALTER TABLE [schema_name.]table_name { ADD COLUMN column_def [, ...] } - ; + ALTER TABLE [schema_name.]table_name { ADD COLUMN column_def [, ...] } - table_name ::= identifier - - schema_name ::= identifier - - column_def :: = { column_name type_name [ default ] [ column_constraint ] CHECK('CS "compression_type"') } + schema_name ::= identifier + + table_name ::= identifier + + column_def ::= + { column_name type_name [ default ] [ column_constraint ] CHECK('CS "compression_type"') } - column_name ::= identifier - - column_constraint ::= - { NOT NULL | NULL } - - default ::= - DEFAULT default_value + column_name ::= identifier + + column_constraint ::= + { NOT NULL | NULL } + + default ::= + DEFAULT default_value Parameters -============ - -The following parameters can be used for adding a table: +========== .. list-table:: :widths: auto @@ -43,13 +38,13 @@ The following parameters can be used for adding a table: * - Parameter - Description * - ``schema_name`` - - The schema name for the table. Defaults to ``public`` if not specified. + - The schema name for the table. Defaults to ``public`` if not specified * - ``table_name`` - - The table name to apply the change to. + - The table name to apply the change to * - ``ADD COLUMN column_def`` - A comma separated list of ADD COLUMN commands * - ``column_def`` - - A column definition. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally. + - A column definition. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally Usage Notes =========== @@ -57,40 +52,43 @@ Usage Notes When adding an empty column, the default values for that column will be set to ``NULL``. Examples -=========== +======== Adding a Simple Column with a Default Value ------------------------------------------ - -This example shows how to add a simple column with a default value: +------------------------------------------- .. code-block:: postgres - ALTER TABLE cool_animals - ADD COLUMN number_of_eyes INT DEFAULT 2 NOT NULL; + ALTER TABLE + cool_animals + ADD + COLUMN number_of_eyes INT DEFAULT 2 NOT NULL; Adding Several Columns in One Command -------------------------------------------- - -This example shows how to add several columns in one command: +------------------------------------- .. code-block:: postgres - ALTER TABLE cool_animals - ADD COLUMN number_of_eyes INT DEFAULT 2 NOT NULL, - ADD COLUMN date_seen DATE DEFAULT '2019-08-01'; + ALTER TABLE + cool_animals + ADD + COLUMN number_of_eyes INT DEFAULT 2 NOT NULL, + ADD + COLUMN date_seen DATE DEFAULT '2019-08-01'; Adding Compressed Column --------------------------- +------------------------ .. code-block:: - ALTER TABLE coo_animals ADD COLUMN animal_salary INT CHECK('CS "dict"'); + ALTER TABLE + coo_animals + ADD + COLUMN animal_salary INT CHECK('CS "dict"'); Follow SQreamDB :ref:`compression guide<compression>` for compression types and methods. - Permissions -============= +=========== The role must have the ``DDL`` permission at the database or table level. \ No newline at end of file diff --git a/reference/sql/sql_statements/ddl_commands/alter_table.rst b/reference/sql/sql_statements/ddl_commands/alter_table.rst index 4046a31fe..752125ad2 100644 --- a/reference/sql/sql_statements/ddl_commands/alter_table.rst +++ b/reference/sql/sql_statements/ddl_commands/alter_table.rst @@ -1,17 +1,23 @@ .. _alter_table: -********************** +*********** ALTER TABLE -********************** -You can use the ``ALTER TABLE`` command to make schema changes to a table, and can be used in conjunction with several sub-commands. +*********** -Locks -======= -Making changes to a schema makes an exclusive lock on tables. While these operations do not typically take much time, other statements may have to wait until the schema changes are completed. +You can use the ``ALTER TABLE`` command to: + +* Add, drop, and rename table columns +* Rename tables +* Add and reorder table clustering keys +* Drop table clustering keys + +Usage Note +========== + +Making changes to a schema makes an :ref:`exclusive lock<concurrency_and_locks>` on tables. While these operations do not typically take much time, other statements may have to wait until the schema changes are completed. Sub-Commands -============== -The following table shows the sub-commands that can be used with the ``ALTER TABLE`` command: +============ .. list-table:: :widths: auto diff --git a/reference/sql/sql_statements/ddl_commands/cluster_by.rst b/reference/sql/sql_statements/ddl_commands/cluster_by.rst index 7dcedaaf1..1d1aa4ae2 100644 --- a/reference/sql/sql_statements/ddl_commands/cluster_by.rst +++ b/reference/sql/sql_statements/ddl_commands/cluster_by.rst @@ -1,46 +1,35 @@ .. _cluster_by: -********************** +********** CLUSTER BY -********************** -The ``CLUSTER BY`` command is used for changing clustering keys in a table. +********** -For more information, see the following: +The ``CLUSTER BY`` command is used for changing clustering keys in a table. -* :ref:`drop_clustering_key` - - :: - -* :ref:`create_table` +For more information, see :ref:`drop_clustering_key`, :ref:`create_table` Syntax -========== -The following is the correct syntax for the CLUSTER BY command: +====== .. code-block:: postgres - alter_table_rename_table_statement ::= - ALTER TABLE [schema_name.]table_name CLUSTER BY column_name [, ...] - ; - - create_table_statement ::= - CREATE [ OR REPLACE ] TABLE [schema_name.]table_name ( - { column_def [, ...] } - ) - [ CLUSTER BY { column_name [, ...] } ] - ; - - column_def :: = { column_name type_name [ default ] [ column_constraint ] } + ALTER TABLE [schema_name.]table_name CLUSTER BY column_name [, ...] - table_name ::= identifier + + create_table_statement ::= + CREATE [ OR REPLACE ] TABLE [schema_name.]table_name ( + { column_def [, ...] } + ) + [ CLUSTER BY { column_name [, ...] } ] - column_name ::= identifier + column_def :: = { column_name type_name [ default ] [ column_constraint ] } -.. note:: SQream does not support clustering by TEXT columns. + table_name ::= identifier + + column_name ::= identifier Parameters -============ -The following table shows the CLUSTER BY parameters: +========== .. list-table:: :widths: auto @@ -49,33 +38,38 @@ The following table shows the CLUSTER BY parameters: * - Parameter - Description * - ``schema_name`` - - The schema name for the table. Defaults to ``public`` if not specified. + - The schema name for the table. Defaults to ``public`` if not specified * - ``OR REPLACE`` - - Creates a new tables and overwrites any existing table by the same name. Does not return an error if the table already exists. ``CREATE OR REPLACE`` does not check the table contents or structure, only the table name. + - Creates a new tables and overwrites any existing table by the same name. Does not return an error if the table already exists. ``CREATE OR REPLACE`` does not check the table contents or structure, only the table name * - ``column_def`` - - A comma separated list of column definitions. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally. + - A comma separated list of column definitions. A minimal column definition includes a name identifier and a datatype. Other column constraints and default values can be added optionally * - ``table_name`` - - The table name to apply the change to. + - The table name to apply the change to * - ``column_name [, ... ]`` - - Comma separated list of columns to create clustering keys for. + - Comma separated list of columns to create clustering keys for Usage Notes -================= -Removing clustering keys does not affect existing data. +=========== + +* Clustering by ``TEXT`` columns is not supported + +* Removing clustering keys does not affect existing data -To force data to re-cluster, the table has to be recreated (i.e. with :ref:`create_table`). +* To force data to re-cluster, the table has to be recreated (i.e. with :ref:`create_table`). Example -=========== +======= + Reclustering a Table ------------------------------------------ -The following example shows how to recluster a table: +-------------------- .. code-block:: postgres - ALTER TABLE public.users CLUSTER BY start_date; + ALTER TABLE + public.users CLUSTER BY start_date; Permissions -============= +=========== + The role must have the ``DDL`` permission at the database or table level. \ No newline at end of file diff --git a/reference/sql/sql_statements/ddl_commands/drop_clustering_key.rst b/reference/sql/sql_statements/ddl_commands/drop_clustering_key.rst index 06cb848ad..eb7b9972f 100644 --- a/reference/sql/sql_statements/ddl_commands/drop_clustering_key.rst +++ b/reference/sql/sql_statements/ddl_commands/drop_clustering_key.rst @@ -1,8 +1,8 @@ .. _drop_clustering_key: -********************** +******************* DROP CLUSTERING KEY -********************** +******************* ``DROP CLUSTERING KEY`` drops all clustering keys in a table. @@ -10,25 +10,17 @@ Read our :ref:`data_clustering` guide for more information. See also: :ref:`cluster_by`, :ref:`create_table`. - -Permissions -============= - -The role must have the ``DDL`` permission at the database or table level. - Syntax -========== +====== .. code-block:: postgres - alter_table_rename_table_statement ::= - ALTER TABLE [schema_name.]table_name DROP CLUSTERING KEY - ; + ALTER TABLE [schema_name.]table_name DROP CLUSTERING KEY - table_name ::= identifier + table_name ::= identifier Parameters -============ +========== .. list-table:: :widths: auto @@ -37,28 +29,29 @@ Parameters * - Parameter - Description * - ``schema_name`` - - The schema name for the table. Defaults to ``public`` if not specified. + - The schema name for the table. Defaults to ``public`` if not specified * - ``table_name`` - - The table name to apply the change to. + - The table name to apply the change to Usage notes -================= - -Removing clustering keys does not affect existing data. - -To force data to re-cluster, the table has to be recreated (i.e. with :ref:`create_table_as`). - +=========== +* Removing clustering keys does not affect existing data +* To force data to re-cluster, the table has to be recreated (i.e. with :ref:`create_table_as`) Examples -=========== +======== -Dropping clustering keys in a table ------------------------------------------ +Dropping Clustering Keys in a Table +----------------------------------- .. code-block:: postgres - ALTER TABLE public.users DROP CLUSTERING KEY + ALTER TABLE + public.users DROP CLUSTERING KEY +Permissions +=========== +The role must have the ``DDL`` permission at the database or table level. diff --git a/reference/sql/sql_statements/ddl_commands/drop_column.rst b/reference/sql/sql_statements/ddl_commands/drop_column.rst index f4c4e4504..0fa54c049 100644 --- a/reference/sql/sql_statements/ddl_commands/drop_column.rst +++ b/reference/sql/sql_statements/ddl_commands/drop_column.rst @@ -1,35 +1,26 @@ .. _drop_column: -********************** +*********** DROP COLUMN -********************** +*********** ``DROP COLUMN`` can be used to remove columns from a table. -Permissions -============= - -The role must have the ``DDL`` permission at the database or table level. - Syntax -========== +====== .. code-block:: postgres - alter_table_drop_column_statement ::= - ALTER TABLE [schema_name.]table_name DROP COLUMN column_name - ; - - table_name ::= identifier - - schema_name ::= identifier - - column_name ::= identifier + ALTER TABLE [schema_name.]table_name DROP COLUMN column_name + schema_name ::= identifier + + table_name ::= identifier + column_name ::= identifier Parameters -============ +========== .. list-table:: :widths: auto @@ -38,26 +29,32 @@ Parameters * - Parameter - Description * - ``schema_name`` - - The schema name for the table. Defaults to ``public`` if not specified. + - The schema name for the table. Defaults to ``public`` if not specified * - ``table_name`` - - The table name to apply the change to. + - The table name to apply the change to * - ``column_name`` - - The column to remove. + - The column to remove Examples -=========== +======== -Removing a column ------------------------------------------ +Removing a Column +----------------- .. code-block:: postgres - -- Remove the 'weight' column - ALTER TABLE users DROP COLUMN weight; + ALTER TABLE + users DROP COLUMN weight; -Removing a column with a quoted identifier name ----------------------------------------------------- +Removing a Column with a Quoted Identifier Name +----------------------------------------------- .. code-block:: postgres - ALTER TABLE users DROP COLUMN "Weight in kilograms"; \ No newline at end of file + ALTER TABLE + users DROP COLUMN "Weight in kilograms"; + +Permissions +=========== + +The role must have the ``DDL`` permission at the database or table level. \ No newline at end of file diff --git a/reference/sql/sql_statements/ddl_commands/rename_column.rst b/reference/sql/sql_statements/ddl_commands/rename_column.rst index 239d7c7f8..51e1e035a 100644 --- a/reference/sql/sql_statements/ddl_commands/rename_column.rst +++ b/reference/sql/sql_statements/ddl_commands/rename_column.rst @@ -1,34 +1,28 @@ .. _rename_column: -********************** +************* RENAME COLUMN -********************** +************* The ``RENAME COLUMN`` command can be used to rename columns in a table. Syntax -========== - -The following is the correct syntax for the ``RENAME_COLUMN`` command: +====== .. code-block:: postgres - alter_table_rename_column_statement ::= - ALTER TABLE [schema_name.]table_name RENAME COLUMN current_name TO new_name - ; + ALTER TABLE [schema_name.]table_name RENAME COLUMN current_name TO new_name - table_name ::= identifier - - schema_name ::= identifier + schema_name ::= identifier + + table_name ::= identifier - current_name ::= identifier + current_name ::= identifier - new_name ::= identifier + new_name ::= identifier Parameters -============ - -The following table describes the `RENAME_COLUMN`` parameters: +========== .. list-table:: :widths: auto @@ -37,43 +31,34 @@ The following table describes the `RENAME_COLUMN`` parameters: * - Parameter - Description * - ``schema_name`` - - The schema name for the table. Defaults to ``public`` if not specified. + - The schema name for the table. Defaults to ``public`` if not specified * - ``table_name`` - - The table name to apply the change to. + - The table name to apply the change to * - ``current_name`` - - The column to rename. + - The column to rename * - ``new_name`` - - The new column name. + - The new column name Examples -=========== - -The **Examples** section includes the following examples: - -.. contents:: - :local: - :depth: 1 +======== Renaming a Column ------------------------------------------ - -The following is an example of renaming a column: +----------------- .. code-block:: postgres - -- Remove the 'weight' column - ALTER TABLE users RENAME COLUMN weight TO mass; + ALTER TABLE + users RENAME COLUMN weight TO mass; Renaming a Quoted Name --------------------------- - -The following is an example of renaming a quoted name: +---------------------- .. code-block:: postgres - ALTER TABLE users RENAME COLUMN "mass" TO "Mass" (Kilograms); + ALTER TABLE + users RENAME COLUMN "mass" TO "Mass" (Kilograms); Permissions -============= +=========== The role must have the ``DDL`` permission at the database or table level. \ No newline at end of file diff --git a/reference/sql/sql_statements/ddl_commands/rename_table.rst b/reference/sql/sql_statements/ddl_commands/rename_table.rst index 96cc7102e..f426dfdc3 100644 --- a/reference/sql/sql_statements/ddl_commands/rename_table.rst +++ b/reference/sql/sql_statements/ddl_commands/rename_table.rst @@ -1,35 +1,28 @@ .. _rename_table: -********************** +************ RENAME TABLE -********************** +************ ``RENAME TABLE`` can be used to rename a table. .. warning:: Renaming a table can void existing views that use this table. See more about :ref:`recompiling views <recompile_view>`. -Permissions -============= - -The role must have the ``DDL`` permission at the database or table level. - Syntax -========== +====== .. code-block:: postgres - alter_table_rename_table_statement ::= - ALTER TABLE [schema_name.]current_name RENAME TO new_name - ; + ALTER TABLE [schema_name.]current_name RENAME TO new_name - current_name ::= identifier - - schema_name ::= identifier - - new_name ::= identifier + schema_name ::= identifier + + current_name ::= identifier + + new_name ::= identifier Parameters -============ +========== .. list-table:: :widths: auto @@ -38,20 +31,24 @@ Parameters * - Parameter - Description * - ``schema_name`` - - The schema name for the table. Defaults to ``public`` if not specified. + - The schema name for the table. Defaults to ``public`` if not specified * - ``current_name`` - - The table name to apply the change to. + - The table name to apply the change to * - ``new_name`` - - The new table name. + - The new table name Examples -=========== +======== -Renaming a table ------------------------------------------ +Renaming a Table +---------------- .. code-block:: postgres - ALTER TABLE public.users RENAME TO former_users; + ALTER TABLE + public.users RENAME TO former_users; +Permissions +=========== +The role must have the ``DDL`` permission at the database or table level. From 653666641cd6e088a06dabdbe920550f593eb555 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 18 Jun 2024 11:40:58 +0300 Subject: [PATCH 841/882] Update configuring_your_instance_of_sqream.rst --- .../configuring_your_instance_of_sqream.rst | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/sqream_studio_5.6.0/configuring_your_instance_of_sqream.rst b/sqream_studio_5.6.0/configuring_your_instance_of_sqream.rst index 3fcac7861..17d9bc43c 100644 --- a/sqream_studio_5.6.0/configuring_your_instance_of_sqream.rst +++ b/sqream_studio_5.6.0/configuring_your_instance_of_sqream.rst @@ -1,23 +1,24 @@ .. _configuring_your_instance_of_sqream: -**************************** +************************************ Configuring Your Instance of SQreams -**************************** +************************************ + The **Configuration** section lets you edit parameters from one centralized location. While you can edit these parameters from the **worker configuration file (config.json)** or from your CLI, you can also modify them in Studio in an easy-to-use format. Configuring your instance of SQream in Studio is session-based, which enables you to edit parameters per session on your own device. Because session-based configurations are not persistent and are deleted when your session ends, you can edit your required parameters while avoiding conflicts between parameters edited on different devices at different points in time. Editing Your Parameters -------------------------------- -When configuring your instance of SQream in Studio you can edit parameters for the **Generic** and **Admin** parameters only. +----------------------- + +When configuring your instance of SQream in Studio you can edit session and cluster parameters only. Studio includes two types of parameters: toggle switches, such as **flipJoinOrder**, and text fields, such as **logSysLevel**. After editing a parameter, you can reset each one to its previous value or to its default value individually, or revert all parameters to their default setting simultaneously. Note that you must click **Save** to save your configurations. You can hover over the **information** icon located on each parameter to read a short description of its behavior. Exporting and Importing Configuration Files -------------------------- -You can also export and import your configuration settings into a .json file. This allows you to easily edit your parameters and to share this file with other users if required. +------------------------------------------- -For more information about configuring your instance of SQream, see :ref:`Configuration<configuration>`. \ No newline at end of file +You can also export and import your configuration settings into a .json file. This allows you to easily edit your parameters and to share this file with other users if required. \ No newline at end of file From 76ac1b42887924c131d70763f567cf0bfa78bae4 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 18 Jun 2024 12:53:07 +0300 Subject: [PATCH 842/882] Maintenance --- configuration_guides/graceful_shutdown.rst | 4 ++-- connecting_to_sqream/client_drivers/Spark/index.rst | 2 +- .../client_drivers/odbc/install_configure_odbc_windows.rst | 2 +- connecting_to_sqream/client_platforms/r.rst | 2 +- connecting_to_sqream/client_platforms/sql_workbench.rst | 2 +- 5 files changed, 6 insertions(+), 6 deletions(-) diff --git a/configuration_guides/graceful_shutdown.rst b/configuration_guides/graceful_shutdown.rst index 9be60d095..97e249f3e 100644 --- a/configuration_guides/graceful_shutdown.rst +++ b/configuration_guides/graceful_shutdown.rst @@ -11,10 +11,10 @@ The following describes the ``defaultGracefulShutdownTimeoutMinutes`` flag: * **Default value** - ``5`` * **Allowed values** - 1-4000000000 -For more information, see :ref:`shutdown_server`. +For more information, see :ref:`shutdown_server_command`. For related flags, see the folowing: * :ref:`is_healer_on` -* :ref:`healer_max_inactivity_hours` \ No newline at end of file +* :ref:`current_method_flag_types` \ No newline at end of file diff --git a/connecting_to_sqream/client_drivers/Spark/index.rst b/connecting_to_sqream/client_drivers/Spark/index.rst index 5c616e437..03ef309c3 100644 --- a/connecting_to_sqream/client_drivers/Spark/index.rst +++ b/connecting_to_sqream/client_drivers/Spark/index.rst @@ -18,7 +18,7 @@ To use Spark with SQreamDB, it is essential that you have the following installe * SQreamDB version 2022.1.8 or later * Spark version 3.3.1 or later * `SQreamDB Spark Connector 5.0.0 <https://sq-ftp-public.s3.amazonaws.com/Spark-Sqream-Connector-5.0.0.jar>`_ -* :ref:`JDBC<jdbc>` version 4.5.6 or later +* :ref:`JDBC<java_jdbc>` version 4.5.6 or later Configuration ============= diff --git a/connecting_to_sqream/client_drivers/odbc/install_configure_odbc_windows.rst b/connecting_to_sqream/client_drivers/odbc/install_configure_odbc_windows.rst index 4972e3057..ce9d98de7 100644 --- a/connecting_to_sqream/client_drivers/odbc/install_configure_odbc_windows.rst +++ b/connecting_to_sqream/client_drivers/odbc/install_configure_odbc_windows.rst @@ -80,7 +80,7 @@ ODBC driver configurations are done via DSNs. Each DSN represents one SQream DB .. image:: /_static/images/odbc_windows_dsn_test.png -#. You can now use this DSN in ODBC applications like :ref:`Tableau <connect_to_tableau>`. + diff --git a/connecting_to_sqream/client_platforms/r.rst b/connecting_to_sqream/client_platforms/r.rst index c84bf901b..d64889c35 100644 --- a/connecting_to_sqream/client_platforms/r.rst +++ b/connecting_to_sqream/client_platforms/r.rst @@ -44,7 +44,7 @@ JDBC > .jinit(classpath=cp) > drv <- JDBC("com.sqream.jdbc.SQDriver","C:\\Program Files\\SQream Technologies\\JDBC Driver\\2020.1-3.2.0\\sqream-jdbc-3.2.jar") #. - Open a connection with a :ref:`JDBC connection string<connection_string>` and run your first statement + Open a connection with a :ref:`JDBC connection string<java_jdbc>` and run your first statement .. code-block:: rconsole diff --git a/connecting_to_sqream/client_platforms/sql_workbench.rst b/connecting_to_sqream/client_platforms/sql_workbench.rst index a5f7e8871..201ba4cec 100644 --- a/connecting_to_sqream/client_platforms/sql_workbench.rst +++ b/connecting_to_sqream/client_platforms/sql_workbench.rst @@ -113,7 +113,7 @@ Create a New Connection Profile for Your Cluster #. Select the SQream Driver that was created in the previous screen -#. Type in your connection string. To find out more about your connection string (URL), see the :ref:`Connection string documentation <connection_string>`. +#. Type in your connection string. #. Text the connection details From ba2d67e812e0858641caf491c280176637cdc7f3 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 18 Jun 2024 13:38:56 +0300 Subject: [PATCH 843/882] Update monitoring_query_performance.rst --- .../monitoring_query_performance.rst | 510 +++++++++--------- 1 file changed, 270 insertions(+), 240 deletions(-) diff --git a/operational_guides/monitoring_query_performance.rst b/operational_guides/monitoring_query_performance.rst index a17a66dad..51552a921 100644 --- a/operational_guides/monitoring_query_performance.rst +++ b/operational_guides/monitoring_query_performance.rst @@ -4,31 +4,25 @@ Monitoring Query Performance **************************** -When analyzing options for query tuning, the first step is to analyze the query plan and execution. -The query plan and execution details explain how SQreamDB processes a query and where time is spent. -This document details how to analyze query performance with execution plans. -This guide focuses specifically on identifying bottlenecks and possible optimization techniques to improve query performance. -Performance tuning options for each query are different. You should adapt the recommendations and tips for your own workloads. -See also our :ref:`sql_best_practices` guide for more information about data loading considerations and other best practices. +The initial step in query tuning involves a thorough analysis of the query plan and its execution. The query plan and execution details illuminate how SQreamDB handles a query and pinpoint where time resources are consumed. This document offers a comprehensive guide on analyzing query performance through execution plans, with a specific emphasis on recognizing bottlenecks and exploring potential optimization strategies to enhance query efficiency. + +It's important to note that performance tuning approaches can vary for each query, necessitating adaptation of recommendations and tips to suit specific workloads. Additionally, for further insights into data loading considerations and other best practices, refer to our :ref:`sql_best_practices` guide. .. contents:: :local: :depth: 1 +Setting Up System Monitoring Preferences +======================================== -Setting Up the System for Monitoring -==================================== - -By default, SQreamDB logs execution details for every statement that runs for more than 60 seconds. -If you want to see the execution details for a currently running statement, see :ref:`using_show_node_info` below. +By default, SQreamDB automatically logs execution details for any query that runs longer than 60 seconds. This means that by default, queries shorter than 60 seconds are not logged. You can adjust this parameter to your own preference. Adjusting the Logging Frequency ------------------------------- -To adjust the frequency of logging for statements, you may want to reduce the interval from 60 seconds down to, -say, 5 or 10 seconds. Modify the configuration files and set the ``nodeInfoLoggingSec`` parameter as you see fit: +To customize statement logging frequency to be more frequent, consider reducing the interval from the default 60 seconds to a shorter duration like 5 or 10 seconds. This adjustment can be made by modifying the ``nodeInfoLoggingSec`` in your SQreamDB :ref:`configuration files<current_method_modification_methods>` and setting the parameter to your preferred value. -.. code-block:: console +.. code-block:: json :emphasize-lines: 7 { @@ -42,18 +36,22 @@ say, 5 or 10 seconds. Modify the configuration files and set the ``nodeInfoLoggi "server":{ } } -After restarting the SQreamDB cluster, the execution plan details will be logged to the :ref:`standard SQreamDB logs directory<logging>`, as a message of type ``200``. -You can see these messages with a text viewer or with queries on the log :ref:`foreign_tables`. -Reading Execution Plans with a Foreign Table --------------------------------------------- +After customizing the frequency, please restart your SQreamDB cluster. Execution plan details are logged to the default SQreamDB :ref:`log directory<logging>` as :ref:`message type<message_type>` ``200``. + +You can access these log details by using a text viewer or by creating a dedicated :ref:`foreign table<foreign_tables>` to store the logs in a SQreamDB table. -First, create a foreign table for the logs +Creating a Dedicated Foreign Table to Store Log Details +------------------------------------------------------- + +Utilizing a SQreamDB table for storing and accessing log details helps simplify log management by avoiding direct handling of raw logs. + +To create a foreign table for storing your log details, use the following table DDL: .. code-block:: postgres CREATE FOREIGN TABLE logs ( - start_marker TEXT(4), + start_marker TEXT, row_id BIGINT, timestamp DATETIME, message_level TEXT, @@ -67,7 +65,7 @@ First, create a foreign table for the logs service_name TEXT, message_type_id INT, message TEXT, - end_message TEXT(5) + end_message TEXT ) WRAPPER csv_fdw @@ -77,8 +75,7 @@ First, create a foreign table for the logs DELIMITER = '|' ); -Once you've defined the foreign table, you can run queries to observe the previously logged execution plans. -This is recommended over looking at the raw logs. +Use the following query structure as an example to view previously logged execution plans: .. code-block:: postgres @@ -117,12 +114,11 @@ This is recommended over looking at the raw logs. Using the ``SHOW_NODE_INFO`` Command ==================================== -The :ref:`show_node_info` command returns a snapshot of the current query plan, similar to ``EXPLAIN ANALYZE`` from other databases. -The :ref:`show_node_info` result, just like the periodically-logged execution plans described above, are an at-the-moment -view of the compiler's execution plan and runtime statistics for the specified statement. -To inspect a currently running statement, execute the ``show_node_info`` utility function in a SQL client like :ref:`sqream sql<sqream_sql_cli_reference>`, the :ref:`SQream Studio Editor<studio_editor>`, or any other :ref:`third party SQL terminal<third_party_tools>`. +The :ref:`show_node_info` command provides a snapshot of the current query plan. Similar to periodically-logged execution plans, ``SHOW_NODE_INFO`` displays the compiler's execution plan and runtime statistics for a specified statement at the moment of execution. + +You can execute the ``SHOW_NODE_INFO`` utility function using :ref:`sqream sql<sqream_sql_cli_reference>`, :ref:`SQream Studio Editor<sqream_studio_>`, or other :ref:`third party tool<client_platforms>`. -In this example, we inspect a statement with statement ID of 176. The command looks like this: +In this example, we inspect a statement with statement ID of 176: .. code-block:: postgres @@ -143,7 +139,7 @@ In this example, we inspect a statement with statement ID of 176. The command lo 176 | 10 | CpuDecompress | 457 | 1 | 457 | 2019-12-25 23:53:13 | 9 | | | | 0 176 | 11 | ReadTable | 457 | 1 | 457 | 2019-12-25 23:53:13 | 10 | 4MB | | public.nba | 0.0004 -Alternatively, you may also :ref:`retrieve the query execution plan output<retrieving_execution_plan_output_using_studio>` using SQreamDB Studio, and contact `SQream Support <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_. +You may also :ref:`download the query execution plan<retrieving_execution_plan_output_using_studio>` to a CSV file using the **Execution Details View** feature. Understanding the Query Execution Plan Output ============================================= @@ -151,7 +147,7 @@ Understanding the Query Execution Plan Output Both :ref:`show_node_info` and the logged execution plans represents the query plan as a graph hierarchy, with data separated into different columns. Each row represents a single logical database operation, which is also called a **node** or **chunk producer**. A node reports several metrics during query execution, such as how much data it has read and written, how many chunks and rows, and how much time has elapsed. -Consider the example show_node_info presented above. The source node with ID #11 (``ReadTable``), has a parent node ID #10 +Consider the example SHOW_NODE_INFO presented above. The source node with ID #11 (``ReadTable``), has a parent node ID #10 (``CpuDecompress``). If we were to draw this out in a graph, it'd look like this: .. figure:: /_static/images/show_node_info_graph.png @@ -275,7 +271,7 @@ Commonly Seen Nodes - Reads data from a standard table stored on disk * - ``Rechunk`` - - - Reorganize multiple small :ref:`chunks<chunks_and_extents>` into a full chunk. Commonly found after joins and when :ref:`HIGH_SELECTIVITY<high_selectivity>` is used + - Reorganize multiple small chunks into a full chunk. Commonly found after joins and when :ref:`HIGH_SELECTIVITY<high_selectivity>` is used * - ``Reduce`` - GPU - A reduction operation, such as a ``GROUP BY`` @@ -318,23 +314,18 @@ Commonly Seen Nodes Examples ======== -In general, looking at the top three longest running nodes (as is detailed in the ``timeSum`` column) can indicate the biggest bottlenecks. -In the following examples you will learn how to identify and solve some common issues. +Typically, examining the top three longest running nodes (detailed in the ``timeSum`` column) can highlight major bottlenecks. The following examples will demonstrate how to identify and address common issues. -.. contents:: In this section: +.. contents:: :local: - :depths: 1 + :depth: 1 Spooling to Disk ---------------- -When there is not enough RAM to process a statement, SQreamDB will spill over data to the ``temp`` folder in the storage disk. -While this ensures that a statement can always finish processing, it can slow down the processing significantly. -It's worth identifying these statements, to figure out if the cluster is configured correctly, as well as potentially reduce -the statement size. -You can identify a statement that spools to disk by looking at the ``write`` column in the execution details. -A node that spools will have a value, shown in megabytes in the ``write`` column. -Common nodes that write spools include ``Join`` or ``LoopJoin``. +When SQreamDB doesn't have enough RAM to process a statement, it will temporarily store overflow data in the ``temp`` folder on the storage disk. While this ensures that statements complete processing, it can significantly slow down performance. It's important to identify these statements to assess cluster configuration and potentially optimize statement size. + +To identify statements that spill data to disk, check the ``write`` column in the execution details. Nodes that write to disk will display a value (in megabytes) in this column. Common nodes that may write spillover data include ``Join`` and ``LoopJoin``. Identifying the Offending Nodes ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -342,7 +333,7 @@ Identifying the Offending Nodes #. Run a query. - For example, a query from the TPC-H benchmark: + This example is from the TPC-H benchmark: .. code-block:: postgres @@ -378,7 +369,7 @@ Identifying the Offending Nodes o_year; #. - Observe the execution information by using the foreign table, or use ``show_node_info`` + Use a foreign table or ``SHOW_NODE_INFO`` to view the execution information. This statement is made up of 199 nodes, starting from a ``ReadTable``, and finishes by returning only 2 results to the client. @@ -428,27 +419,29 @@ Identifying the Offending Nodes : 150,LoopJoin ,182369485,10,18236948,2020-09-04 18:31:47,149,12860MB,12860MB,inner,23.62 [...] : 199,ReadTable ,20000000,1,20000000,2020-09-04 18:30:33,198,0MB,,public.part,0.83 - Because of the relatively low amount of RAM in the machine and because the data set is rather large at around 10TB, SQreamDB needs to spool. - The total spool used by this query is around 20GB (1915MB + 2191MB + 3064MB + 12860MB). + Due to the machine's limited RAM and the large dataset of approximately 10TB, SQreamDB requires spooling. + + The total spool used by this query amounts to approximately 20GB (1915MB + 2191MB + 3064MB + 12860MB). Common Solutions for Reducing Spool ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -* - Increase the amount of spool memory available for the workers, as a proportion of the maximum statement memory. - When the amount of spool memory is increased, SQreamDB may not need to write to disk. +.. list-table:: + :widths: auto + :header-rows: 1 - This setting is called ``spoolMemoryGB``. Refer to the :ref:`configuration` guide. -* - Reduce the amount of **workers** per host, and increase the amount of spool available to the (now reduced amount of) active workers. - This may reduce the amount of concurrent statements, but will improve performance for heavy statements. + * - Solution + - Description + * - Increasing Spool Memory Amount + - Increase the amount of spool memory available for the Workers relative to the maximum statement memory. By increasing spool memory, SQreamDB may avoid the need to write to disk. This setting is known as ``spoolMemoryGB``. Refer to the :ref:`concurrency_and_scaling_in_sqream` guide for details. + * - Reducing Workers Per Host + - Reduce the number of Workers per host and allocate more spool memory to the reduced number of active Workers. This approach may decrease concurrent statements but can enhance performance for resource-intensive queries. Queries with Large Result Sets ------------------------------ -When queries have large result sets, you may see a node called ``DeferredGather``. -This gathering occurs when the result set is assembled, in preparation for sending it to the client. +When queries produce large result sets, you may encounter a node called ``DeferredGather``. This node is responsible for assembling the result set in preparation for sending it to the client. Identifying the Offending Nodes ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -456,7 +449,7 @@ Identifying the Offending Nodes #. Run a query. - For example, a modified query from the TPC-H benchmark: + This example is from the TPC-H benchmark: .. code-block:: postgres @@ -484,7 +477,7 @@ Identifying the Offending Nodes AND high_selectivity(p_type = 'ECONOMY BURNISHED NICKEL'); #. - Observe the execution information by using the foreign table, or use ``show_node_info`` + Use a foreign table or ``SHOW_NODE_INFO`` to view the execution information. This statement is made up of 221 nodes, containing 8 ``ReadTable`` nodes, and finishes by returning billions of results to the client. @@ -493,7 +486,7 @@ Identifying the Offending Nodes .. code-block:: postgres :emphasize-lines: 7,9,11 - SELECT show_node_info(494); + SELECT SHOW_NODE_INFO(494); stmt_id | node_id | node_type | rows | chunks | avg_rows_in_chunk | time | parent_node_id | read | write | comment | timeSum --------+---------+----------------------+-----------+--------+-------------------+---------------------+----------------+---------+-------+-----------------+-------- 494 | 1 | PushToNetworkQueue | 242615 | 1 | 242615 | 2020-09-04 19:07:55 | -1 | | | | 0.36 @@ -507,11 +500,13 @@ Identifying the Offending Nodes [...] 494 | 221 | ReadTable | 20000000 | 20 | 1000000 | 2020-09-04 19:07:01 | 220 | 20MB | | public.part | 0.1 - When you see ``DeferredGather`` operations taking more than a few seconds, that's a sign that you're selecting too much data. - In this case, the DeferredGather with node ID 166 took over 21 seconds. + If you notice that ``DeferredGather`` operations are taking more than a few seconds, it could indicate that you're selecting a large amount of data. For example, in this case, the ``DeferredGather`` with node ID 166 took over 21 seconds. -#. Modify the statement to see the difference - Altering the select clause to be more restrictive will reduce the deferred gather time back to a few milliseconds. +#. + + Modify the statement by making the ``SELECT`` clause more restrictive. + + This adjustment will reduce the ``DeferredGather`` time from several seconds to just a few milliseconds. .. code-block:: postgres @@ -524,27 +519,30 @@ Identifying the Offending Nodes Common Solutions for Reducing Gather Time ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -* Reduce the effect of the preparation time. Avoid selecting unnecessary columns (``SELECT * FROM...``), or reduce the result set size by using more filters. -.. `` +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Solution + - Description + * - minimizing preparation time + - To minimize preparation time, avoid selecting unnecessary columns (e.g., ``SELECT * FROM`` ...) or reduce the result set size by applying more filters. Inefficient Filtering --------------------- -When running statements, SQreamDB tries to avoid reading data that is not needed for the statement by :ref:`skipping chunks<chunks_and_extents>`. -If statements do not include efficient filtering, SQreamDB will read a lot of data off disk. -In some cases, you need the data and there's nothing to do about it. However, if most of it gets pruned further down the line, -it may be efficient to skip reading the data altogether by using the :ref:`metadata<metadata_system>`. +When executing statements, SQreamDB optimizes data retrieval by :ref:`skipping unnecessary chunks<bulk_data_layer_optimization>`. However, if statements lack efficient filtering, SQreamDB may end up reading excessive data from disk. Identifying the Situation ^^^^^^^^^^^^^^^^^^^^^^^^^ -We consider the filtering to be inefficient when the ``Filter`` node shows that the number of rows processed is less -than a third of the rows passed into it by the ``ReadTable`` node. -For example: +Filtering is considered inefficient when the ``Filter`` node processes less than one-third of the rows passed into it by the ``ReadTable`` node. + #. Run a query. In this example, we execute a modified query from the TPC-H benchmark. + Our ``lineitem`` table contains 600,037,902 rows. .. code-block:: postgres @@ -584,7 +582,7 @@ For example: o_year; #. - Observe the execution information by using the foreign table, or use ``show_node_info`` + Use a foreign table or ``SHOW_NODE_INFO`` to view the execution information. The execution below has been shortened, but note the highlighted rows for ``ReadTable`` and ``Filter``: @@ -592,7 +590,7 @@ For example: :linenos: :emphasize-lines: 9,17,19,27 - SELECT show_node_info(559); + SELECT SHOW_NODE_INFO(559); stmt_id | node_id | node_type | rows | chunks | avg_rows_in_chunk | time | parent_node_id | read | write | comment | timeSum --------+---------+----------------------+-----------+--------+-------------------+---------------------+----------------+--------+-------+-----------------+-------- 559 | 1 | PushToNetworkQueue | 2 | 1 | 2 | 2020-09-07 11:12:01 | -1 | | | | 0.28 @@ -619,19 +617,20 @@ For example: 559 | 214 | Rechunk | 20000000 | 20 | 1000000 | 2020-09-07 11:11:57 | 213 | | | | 0 559 | 215 | CpuDecompress | 20000000 | 20 | 1000000 | 2020-09-07 11:11:57 | 214 | | | | 0 559 | 216 | ReadTable | 20000000 | 20 | 1000000 | 2020-09-07 11:11:57 | 215 | 20MB | | public.part | 0 + + Note the following: + + * The ``Filter`` on line 9 has processed 12,007,447 rows, but the output of ``ReadTable`` on ``public.lineitem`` on line 17 was 600,037,902 rows. + + This means that it has filtered out 98% (:math:`1 - \dfrac{600037902}{12007447} = 98\%`) of the data, but the entire table was read. - * - The ``Filter`` on line 9 has processed 12,007,447 rows, but the output of ``ReadTable`` on ``public.lineitem`` - on line 17 was 600,037,902 rows. This means that it has filtered out 98% (:math:`1 - \dfrac{600037902}{12007447} = 98\%`) - of the data, but the entire table was read. - - * - The ``Filter`` on line 19 has processed 133,000 rows, but the output of ``ReadTable`` on ``public.part`` - on line 27 was 20,000,000 rows. This means that it has filtered out >99% (:math:`1 - \dfrac{133241}{20000000} = 99.4\%`) - of the data, but the entire table was read. However, this table is small enough that we can ignore it. + * The ``Filter`` on line 19 has processed 133,000 rows, but the output of ``ReadTable`` on ``public.part`` on line 27 was 20,000,000 rows. + + This means that it has filtered out >99% (:math:`1 - \dfrac{133241}{20000000} = 99.4\%`) of the data, but the entire table was read. However, this table is small enough that we can ignore it. -#. Modify the statement to see the difference - Altering the statement to have a ``WHERE`` condition on the clustered ``l_orderkey`` column of the ``lineitem`` table will help SQreamDB skip reading the data. +#. modify the statement by adding a ``WHERE`` condition on the clustered ``l_orderkey`` column of the ``lineitem`` table. + + This adjustment will enable SQreamDB to skip reading unnecessary data. .. code-block:: postgres :emphasize-lines: 15 @@ -660,7 +659,7 @@ For example: :linenos: :emphasize-lines: 5,13 - SELECT show_node_info(586); + SELECT SHOW_NODE_INFO(586); stmt_id | node_id | node_type | rows | chunks | avg_rows_in_chunk | time | parent_node_id | read | write | comment | timeSum --------+---------+----------------------+-----------+--------+-------------------+---------------------+----------------+--------+-------+-----------------+-------- [...] @@ -674,71 +673,86 @@ For example: 586 | 197 | CpuDecompress | 494927872 | 8 | 61865984 | 2020-09-07 13:20:44 | 196 | | | | 0 586 | 198 | ReadTable | 494927872 | 8 | 61865984 | 2020-09-07 13:20:44 | 197 | 6595MB | | public.lineitem | 0.09 [...] - In this example, the filter processed 494,621,593 rows, while the output of ``ReadTable`` on ``public.lineitem`` - was 494,927,872 rows. This means that it has filtered out all but 0.01% (:math:`1 - \dfrac{494621593}{494927872} = 0.01\%`) - of the data that was read. - The metadata skipping has performed very well, and has pre-filtered the data for us by pruning unnecessary chunks. + Note the following: + + * The filter processed 494,621,593 rows, while the output of ``ReadTable`` on ``public.lineitem`` was 494,927,872 rows. + + This means that it has filtered out all but 0.01% (:math:`1 - \dfrac{494621593}{494927872} = 0.01\%`) of the data that was read. + + * The metadata skipping has performed very well, and has pre-filtered the data for us by pruning unnecessary chunks. Common Solutions for Improving Filtering ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -* Use :ref:`clustering keys and naturally ordered data<data_clustering>` in your filters. -* Avoid full table scans when possible +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Solution + - Description + * - :ref:`Clustering keys<cluster_by>` and ordering data + - Utilize clustering keys and naturally ordered data to enhance filtering efficiency. + * - Avoiding full table scans + - Minimize full table scans by applying targeted filtering conditions. -Joins with ``text`` Keys +Joins with ``TEXT`` Keys ------------------------ -Joins on long text keys do not perform as well as numeric data types or very short text keys. +Joins on long ``TEXT`` keys may result in reduced performance compared to joins on ``NUMERIC`` data types or very short ``TEXT`` keys. Identifying the Situation ^^^^^^^^^^^^^^^^^^^^^^^^^ -When a join is inefficient, you may note that a query spends a lot of time on the ``Join`` node. -For example, consider these two table structures: +When a join is inefficient, you may observe that a query spends a significant amount of time on the ``Join`` node. + +Consider these two table structures: .. code-block:: postgres - CREATE TABLE t_a - ( - amt FLOAT NOT NULL, - i INT NOT NULL, - ts DATETIME NOT NULL, - country_code TEXT(3) NOT NULL, - flag TEXT(10) NOT NULL, - fk TEXT(50) NOT NULL - ); - CREATE TABLE t_b - ( - id TEXT(50) NOT NULL - prob FLOAT NOT NULL, - j INT NOT NULL, - ); + CREATE TABLE + t_a ( + amt FLOAT NOT NULL, + i INT NOT NULL, + ts DATETIME NOT NULL, + country_code TEXT NOT NULL, + flag TEXT NOT NULL, + fk TEXT NOT NULL + ); + + CREATE TABLE + t_b ( + id TEXT NOT NULL, + prob FLOAT NOT NULL, + j INT NOT NULL + ); #. Run a query. - In this example, we will join ``t_a.fk`` with ``t_b.id``, both of which are ``TEXT(50)``. + In this example, we join ``t_a.fk`` with ``t_b.id``, both of which are ``TEXT``. .. code-block:: postgres - SELECT AVG(t_b.j :: BIGINT), - t_a.country_code - FROM t_a - JOIN t_b ON (t_a.fk = t_b.id) - GROUP BY t_a.country_code + SELECT + AVG(t_b.j :: BIGINT), + t_a.country_code + FROM + t_a + JOIN t_b ON (t_a.fk = t_b.id) + GROUP BY + t_a.country_code; + #. - Observe the execution information by using the foreign table, or use ``show_node_info`` + Use a foreign table or ``SHOW_NODE_INFO`` to view the execution information. The execution below has been shortened, but note the highlighted rows for ``Join``. - The ``Join`` node is by far the most time-consuming part of this statement - clocking in at 69.7 seconds - joining 1.5 billion records. .. code-block:: postgres :linenos: :emphasize-lines: 8 - SELECT show_node_info(5); + SELECT SHOW_NODE_INFO(5); stmt_id | node_id | node_type | rows | chunks | avg_rows_in_chunk | time | parent_node_id | read | write | comment | timeSum --------+---------+----------------------+------------+--------+-------------------+---------------------+----------------+-------+-------+------------+-------- [...] @@ -754,65 +768,70 @@ For example, consider these two table structures: 5 | 41 | CpuDecompress | 10000000 | 2 | 5000000 | 2020-09-08 18:26:09 | 40 | | | | 0 5 | 42 | ReadTable | 10000000 | 2 | 5000000 | 2020-09-08 18:26:09 | 41 | 14MB | | public.t_a | 0 -Improving Query Performance -^^^^^^^^^^^^^^^^^^^^^^^^^^^ + Note the following: + + * The ``Join`` node is the most time-consuming part of this statement, taking 69.7 seconds to join 1.5 billion records. + +Common Solutions for Improving Query Performance +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -* In general, try to avoid ``TEXT`` as a join key. As a rule of thumb, ``BIGINT`` works best as a join key. -* - Convert text values on-the-fly before running the query. For example, the :ref:`crc64` function takes a text - input and returns a ``BIGINT`` hash. +In general, try to avoid ``TEXT`` as a join key. As a rule of thumb, ``BIGINT`` works best as a join key. + +.. list-table:: + :widths: auto + :header-rows: 1 - For example: + * - Solution + - Description + * - Mapping + - Use a dimension table to map ``TEXT`` values to ``NUMERIC`` types, and then reconcile these values as needed by joining the dimension table. + * - Conversion + - Use functions like :ref:`crc64` to convert ``TEXT`` values into BIGINT hashes directly before running the query. + + For example: - .. code-block:: postgres + .. code-block:: postgres - SELECT AVG(t_b.j::BIGINT), t_a.country_code - FROM "public"."t_a" - JOIN "public"."t_b" ON (CRC64(t_a.fk::TEXT) = CRC64(t_b.id::TEXT)) - GROUP BY t_a.country_code; + SELECT AVG(t_b.j::BIGINT), t_a.country_code + FROM "public"."t_a" + JOIN "public"."t_b" ON (CRC64(t_a.fk::TEXT) = CRC64(t_b.id::TEXT)) + GROUP BY t_a.country_code; - The execution below has been shortened, but note the highlighted rows for ``Join``. - The ``Join`` node went from taking nearly 70 seconds, to just 6.67 seconds for joining 1.5 billion records. + The execution below has been shortened, but note the highlighted rows for ``Join``. + The ``Join`` node went from taking nearly 70 seconds, to just 6.67 seconds for joining 1.5 billion records. - .. code-block:: postgres - :linenos: - :emphasize-lines: 8 + .. code-block:: postgres + :linenos: + :emphasize-lines: 8 - SELECT show_node_info(6); - stmt_id | node_id | node_type | rows | chunks | avg_rows_in_chunk | time | parent_node_id | read | write | comment | timeSum - --------+---------+----------------------+------------+--------+-------------------+---------------------+----------------+-------+-------+------------+-------- - [...] - 6 | 19 | GpuTransform | 1497366528 | 85 | 17825792 | 2020-09-08 18:57:04 | 18 | | | | 1.48 - 6 | 20 | ReorderInput | 1497366528 | 85 | 17825792 | 2020-09-08 18:57:04 | 19 | | | | 0 - 6 | 21 | ReorderInput | 1497366528 | 85 | 17825792 | 2020-09-08 18:57:04 | 20 | | | | 0 - 6 | 22 | Join | 1497366528 | 85 | 17825792 | 2020-09-08 18:57:04 | 21 | | | inner | 6.67 - 6 | 24 | AddSortedMinMaxMet.. | 6291456 | 1 | 6291456 | 2020-09-08 18:55:12 | 22 | | | | 0 - [...] - 6 | 32 | ReadTable | 6291456 | 1 | 6291456 | 2020-09-08 18:55:12 | 31 | 235MB | | public.t_b | 0.02 - [...] - 6 | 43 | CpuDecompress | 10000000 | 2 | 5000000 | 2020-09-08 18:55:13 | 42 | | | | 0 - 6 | 44 | ReadTable | 10000000 | 2 | 5000000 | 2020-09-08 18:55:13 | 43 | 14MB | | public.t_a | 0 - -* You can map some text values to numeric types by using a dimension table. Then, reconcile the values when you need them by joining the dimension table. - -Sorting on big ``TEXT`` fields + SELECT SHOW_NODE_INFO(6); + stmt_id | node_id | node_type | rows | chunks | avg_rows_in_chunk | time | parent_node_id | read | write | comment | timeSum + --------+---------+----------------------+------------+--------+-------------------+---------------------+----------------+-------+-------+------------+-------- + [...] + 6 | 19 | GpuTransform | 1497366528 | 85 | 17825792 | 2020-09-08 18:57:04 | 18 | | | | 1.48 + 6 | 20 | ReorderInput | 1497366528 | 85 | 17825792 | 2020-09-08 18:57:04 | 19 | | | | 0 + 6 | 21 | ReorderInput | 1497366528 | 85 | 17825792 | 2020-09-08 18:57:04 | 20 | | | | 0 + 6 | 22 | Join | 1497366528 | 85 | 17825792 | 2020-09-08 18:57:04 | 21 | | | inner | 6.67 + 6 | 24 | AddSortedMinMaxMet.. | 6291456 | 1 | 6291456 | 2020-09-08 18:55:12 | 22 | | | | 0 + [...] + 6 | 32 | ReadTable | 6291456 | 1 | 6291456 | 2020-09-08 18:55:12 | 31 | 235MB | | public.t_b | 0.02 + [...] + 6 | 43 | CpuDecompress | 10000000 | 2 | 5000000 | 2020-09-08 18:55:13 | 42 | | | | 0 + 6 | 44 | ReadTable | 10000000 | 2 | 5000000 | 2020-09-08 18:55:13 | 43 | 14MB | | public.t_a | 0 + +Sorting on Big ``TEXT`` Fields ------------------------------ -In general, SQreamDB automatically inserts a ``Sort`` node which arranges the data prior to reductions and aggregations. -When running a ``GROUP BY`` on large ``TEXT`` fields, you may see nodes for ``Sort`` and ``Reduce`` taking a long time. +In SQreamDB, a ``Sort`` node is automatically added to organize data prior to reductions and aggregations. When executing a ``GROUP BY`` operation on extensive ``TEXT`` fields, you might observe that the ``Sort`` and subsequent ``Reduce`` nodes require a considerable amount of time to finish. Identifying the Situation ^^^^^^^^^^^^^^^^^^^^^^^^^ -When running a statement, inspect it with :ref:`show_node_info`. If you see ``Sort`` and ``Reduce`` among +If you see ``Sort`` and ``Reduce`` among your top five longest running nodes, there is a potential issue. -For example: -#. - Run a query to test it out. - - - Our ``t_inefficient`` table contains 60,000,000 rows, and the structure is simple, but with an oversized ``country_code`` column: - + +Consider this ``t_inefficient`` table which contains 60,000,000 rows, and the structure is simple, but with an oversized ``country_code`` column: + .. code-block:: postgres :emphasize-lines: 5 @@ -820,12 +839,13 @@ For example: i INT NOT NULL, amt DOUBLE NOT NULL, ts DATETIME NOT NULL, - country_code TEXT(100) NOT NULL, - flag TEXT(10) NOT NULL, - string_fk TEXT(50) NOT NULL + country_code TEXT NOT NULL, + flag TEXT NOT NULL, + string_fk TEXTNOT NULL ); - - We will run a query, and inspect it's execution details: + +#. + Run a query. .. code-block:: postgres @@ -843,6 +863,8 @@ For example: TUR | 1195946178 [...] +#. + Use a foreign table or ``SHOW_NODE_INFO`` to view the execution information. .. code-block:: postgres :emphasize-lines: 8,9 @@ -863,7 +885,7 @@ For example: 30 | 11 | CpuDecompress | 60000000 | 15 | 4000000 | 2020-09-10 16:17:10 | 10 | | | | 0 30 | 12 | ReadTable | 60000000 | 15 | 4000000 | 2020-09-10 16:17:10 | 11 | 520MB | | public.t_inefficient | 0.05 -#. We can look to see if there's any shrinking we can do on the ``GROUP BY`` key +#. Look to see if there's any shrinking that can be done on the ``GROUP BY`` key: .. code-block:: postgres @@ -873,59 +895,70 @@ For example: 3 With a maximum string length of just 3 characters, our ``TEXT(100)`` is way oversized. #. - We can recreate the table with a more restrictive ``TEXT(3)``, and can examine the difference in performance: + Recreate the table with a more restrictive ``TEXT(3)``, and examine the difference in performance: .. code-block:: postgres - CREATE TABLE t_efficient - AS SELECT i, - amt, - ts, - country_code::TEXT(3) AS country_code, - flag - FROM t_inefficient; - - SELECT - country_code, - SUM(amt::bigint) - FROM t_efficient - GROUP BY country_code; - - country_code | sum - -------------+----------- - VUT | 1195416012 - GIB | 1195710372 - TUR | 1195946178 - [...] + CREATE TABLE + t_efficient AS + SELECT + i, + amt, + ts, + country_code :: TEXT(3) AS country_code, + flag + FROM + t_inefficient; + + SELECT + country_code, + SUM(amt :: bigint) + FROM + t_efficient + GROUP BY + country_code; + + country_code | sum + -------------+----------- + VUT | 1195416012 + GIB | 1195710372 + TUR | 1195946178 + [...] - This time, the entire query took just 4.75 seconds, or just about 91% faster. + This time, the query should be about 91% faster. -Improving Sort Performance on Text Keys -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Common Solutions for Improving Sort Performance on ``TEXT`` Keys +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -When using TEXT, ensure that the maximum length defined in the table structure is as small as necessary. -For example, if you're storing phone numbers, don't define the field as ``TEXT(255)``, as that affects sort performance. +.. list-table:: + :widths: auto + :header-rows: 1 -You can run a query to get the maximum column length (e.g. ``MAX(LEN(a_column))``), and potentially modify the table structure. + * - Solution + - Description + * - Using Appropriate Text Length + - Define the maximum length of ``TEXT`` fields in your table structure as small as necessary. For example, if you're storing phone numbers, avoid defining the field as ``TEXT(255)`` to optimize sort performance. + * - Optimize Column Length + - Execute a query to determine the maximum length of data in the column (e.g., ``MAX(LEN(a_column))``) and consider modifying the table structure based on this analysis. .. _high_selectivity_data_opt: High Selectivity Data --------------------- -Selectivity is the ratio of cardinality to the number of records of a chunk. We define selectivity as :math:`\frac{\text{Distinct values}}{\text{Total number of records in a chunk}}` -SQreamDB has a hint called ``HIGH_SELECTIVITY``, which is a function you can wrap a condition in. -The hint signals to SQreamDB that the result of the condition will be very sparse, and that it should attempt to rechunk -the results into fewer, fuller chunks. +In SQreamDB, selectivity refers to the ratio of distinct values to the total number of records within a chunk. It is defined by the formula: :math:`\frac{\text{Distinct values}}{\text{Total number of records in a chunk}}` + +SQreamDB provides a hint called ``HIGH_SELECTIVITY`` that can be used to optimize queries. When you wrap a condition with this hint, it signals to SQreamDB that the result of the condition will yield a sparse output. As a result, SQreamDB attempts to rechunk the results into fewer, fuller chunks for improved performance. + .. note:: - SQreamDB doesn't do this automatically because it adds a significant overhead on naturally ordered and - well-clustered data, which is the more common scenario. + SQreamDB does not apply this optimization automatically because it introduces significant overhead for naturally ordered and well-clustered data, which is the more common scenario. Identifying the Situation ^^^^^^^^^^^^^^^^^^^^^^^^^ -This is easily identifiable - when the amount of average of rows in a chunk is small, following a ``Filter`` operation. -Consider this execution plan: +This condition is easily identifiable when the average number of rows in a chunk is small, particularly after a Filter operation. + +Consider the following execution plan: .. code-block:: postgres @@ -936,18 +969,27 @@ Consider this execution plan: 30 | 38 | Filter | 18160 | 74 | 245 | 2020-09-10 12:17:09 | 37 | | | | 0.012 [...] 30 | 44 | ReadTable | 77000000 | 74 | 1040540 | 2020-09-10 12:17:09 | 43 | 277MB | | public.dim | 0.058 -The table was read entirely - 77 million rows into 74 chunks. -The filter node reduced the output to just 18,160 relevant rows, but they're distributed across the original 74 chunks. -All of these rows could fit in one single chunk, instead of spanning 74 rather sparse chunks. - -Improving Performance with High Selectivity Hints -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -* - Use when there's a ``WHERE`` condition on an :ref:`unclustered column<data_clustering>`, and when you expect the filter - to cut out more than 60% of the result set. -* Use when the data is uniformly distributed or random - -Performance of unsorted data in joins + +The table was initially read entirely, containing 77 million rows divided into 74 chunks. After applying a filter node, the output was reduced to just 18,160 relevant rows, which are still distributed across the original 74 chunks. However, all these rows could fit into a single chunk instead of spanning across 74 sparsely populated chunks. + +Common Solutions for Improving Performance with High Selectivity Hints +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Solution + - Description + * - Using ``HIGH_SELECTIVITY`` hint + - + * When a ``WHERE`` condition is used on an :ref:`unclustered column<cluster_by>`, especially if you anticipate the filter to reduce more than 60% of the result set + + * When the data is uniformly distributed or random + + + +Performance of Unsorted Data in Joins ------------------------------------- When data is not well-clustered or naturally ordered, a join operation can take a long time. @@ -955,9 +997,7 @@ When data is not well-clustered or naturally ordered, a join operation can take Identifying the Situation ^^^^^^^^^^^^^^^^^^^^^^^^^ -When running a statement, inspect it with :ref:`show_node_info`. If you see ``Join`` and ``DeferredGather`` among your -top five longest running nodes, there is a potential issue. -In this case, we're also interested in the number of chunks produced by these nodes. +If you identify ``Join`` and ``DeferredGather`` as two of the top five longest running nodes, this could indicate a potential issue. Additionally, it's important to consider the number of chunks generated by these nodes in such cases. Consider this execution plan: @@ -980,20 +1020,16 @@ Consider this execution plan: [...] 30 | 44 | ReadTable | 77000000 | 74 | 1040540 | 2020-09-10 12:17:09 | 43 | 277MB | | public.dim | 0.058 -* ``Join`` is the node that matches rows from both table relations. -* ``DeferredGather`` gathers the required column chunks to decompress -Pay special attention to the volume of data removed by the ``Filter`` node. -The table was read entirely - 77 million rows into 74 chunks. -The filter node reduced the output to just 18,160 relevant rows, but they're distributed across the original 74 chunks. -All of these rows could fit in one single chunk, instead of spanning 74 rather sparse chunks. +The ``Join`` node performs row matching between table relations, while ``DeferredGather`` is responsible for gathering necessary column chunks for decompression. Notably, closely monitor the data volume filtered out by the ``Filter`` node. + +The table of 77 million rows was read into 74 chunks. After applying a filter, only 18,160 relevant rows remained, dispersed across these 74 chunks. Ideally, these rows could be consolidated into a single chunk rather than spanning multiple sparse chunks. Improving Join Performance when Data is Sparse ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -You can tell SQreamDB to reduce the amount of chunks involved, if you know that the filter is going to be quite -agressive by using the :ref:`HIGH_SELECTIVITY<high_selectivity>` hint described :ref:`above<high_selectivity_data_opt>`. -This forces the compiler to rechunk the data into fewer chunks. -To tell SQreamDB to rechunk the data, wrap a condition (or several) in the ``HIGH_SELECTIVITY`` hint: +To optimize performance in SQreamDB, especially when dealing with aggressive filtering, you can use the :ref:`HIGH_SELECTIVITY<high_selectivity>` hint as described :ref:`above<high_selectivity_data_opt>`. This hint instructs the compiler to rechunk the data into fewer chunks. + +To apply this optimization, wrap your filtering condition (or conditions) with the ``HIGH_SELECTIVITY`` hint like this: .. code-block:: postgres :emphasize-lines: 13 @@ -1017,22 +1053,17 @@ To tell SQreamDB to rechunk the data, wrap a condition (or several) in the ``HIG Manual Join Reordering ---------------------- -When joining multiple tables, you may wish to change the join order to join the smallest tables first. +When performing joins involving multiple tables, consider changing the join order to start with the smallest tables first. Identifying the situation ^^^^^^^^^^^^^^^^^^^^^^^^^ -When joining more than two tables, the ``Join`` nodes will be the most time-consuming nodes. +When joining more than two tables, the ``Join`` nodes typically represent the most time-consuming operations. Changing the Join Order ^^^^^^^^^^^^^^^^^^^^^^^ -Always prefer to join the smallest tables first. -.. note:: - We consider small tables to be tables that only retain a small amount of rows after conditions - are applied. This bears no direct relation to the amount of total rows in the table. -Changing the join order can reduce the query runtime significantly. In the examples below, we reduce the time -from 27.3 seconds to just 6.4 seconds. +It's advisable to prioritize joining the smallest tables first. By small tables, we mean tables that retain a relatively low number of rows after applying filtering conditions, regardless of the total row count in the table. Changing the join order in this way can lead to a significant reduction in query runtime. For instance, in specific examples, this approach has resulted in a remarkable 76.64% reduction in query time. .. code-block:: postgres :caption: Original query @@ -1054,7 +1085,6 @@ from 27.3 seconds to just 6.4 seconds. GROUP BY c_nationkey .. code-block:: postgres - :caption: Modified query with improved join order -- This variant runs in 6.4 seconds From 356b2f1b4db89df921257587a058b59f3b2234c3 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 18 Jun 2024 13:39:36 +0300 Subject: [PATCH 844/882] Update saving_query_results_to_a_csv_or_psv_file.rst --- .../saving_query_results_to_a_csv_or_psv_file.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/getting_started/saving_query_results_to_a_csv_or_psv_file.rst b/getting_started/saving_query_results_to_a_csv_or_psv_file.rst index 9a40ad440..f51ddaa10 100644 --- a/getting_started/saving_query_results_to_a_csv_or_psv_file.rst +++ b/getting_started/saving_query_results_to_a_csv_or_psv_file.rst @@ -1,15 +1,16 @@ .. _saving_query_results_to_a_csv_or_psv_file: -**************************** +***************************************** Saving Query Results to a CSV or PSV File -**************************** +***************************************** + You can save query results to a CSV or PSV file using the ``sqream sql`` command from a CLI client. This saves your query results to the selected delimited file format, as shown in the following example: .. code-block:: console $ sqream sql --username=mjordan --database=nba --host=localhost --port=5000 -c "SELECT * FROM nba LIMIT 5" --results-only --delimiter='|' > nba.psv $ cat nba.psv - Avery Bradley |Boston Celtics |0|PG|25|6-2 |180|Texas |7730337 + Avery Bradley |Boston Celtics |0|PG|25|6-2 |180|Texas |7730337 Jae Crowder |Boston Celtics |99|SF|25|6-6 |235|Marquette |6796117 John Holland |Boston Celtics |30|SG|27|6-5 |205|Boston University |\N R.J. Hunter |Boston Celtics |28|SG|22|6-5 |185|Georgia State |1148640 @@ -21,4 +22,4 @@ For more output options, see :ref:`Controlling the Client Output<controlling_out * Explore all of SQream DB's :ref:`SQL Syntax <sql_syntax>`. * See the full :ref:`SQream SQL CLI reference <sqream_sql_cli_reference>`. -* Connect a :ref:`third party tool <third_party_tools>` to start analyzing data. \ No newline at end of file +* Connect a :ref:`third party tool <client_platforms>` to start analyzing data. \ No newline at end of file From 0ed9ed1e4825cac2963019b06fde4b03dd079477 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 18 Jun 2024 13:39:55 +0300 Subject: [PATCH 845/882] Update inserting_rows.rst --- getting_started/inserting_rows.rst | 34 ++++++++++++++---------------- 1 file changed, 16 insertions(+), 18 deletions(-) diff --git a/getting_started/inserting_rows.rst b/getting_started/inserting_rows.rst index 890befebf..aa2bcd534 100644 --- a/getting_started/inserting_rows.rst +++ b/getting_started/inserting_rows.rst @@ -1,8 +1,9 @@ .. _inserting_rows: -**************************** +************** Inserting Rows -**************************** +************** + The **Inserting Rows** section describes the following: * :ref:`Inserting basic rows<inserting_basic_rows>` @@ -19,9 +20,8 @@ You can insert basic rows into a table using the ``INSERT`` statement. The inser .. code-block:: psql - test=> INSERT INTO cool_animals VALUES (1, 'Dog', 7); + INSERT INTO cool_animals VALUES (1, 'Dog', 7); - executed .. _changing_value_order: @@ -31,9 +31,8 @@ You can change the order of values by specifying the column order, as shown in t .. code-block:: psql - test=> INSERT INTO cool_animals(weight, id, name) VALUES (3, 2, 'Possum'); + INSERT INTO cool_animals(weight, id, name) VALUES (3, 2, 'Possum'); - executed .. _inserting_multiple_rows: @@ -43,14 +42,13 @@ You can insert multiple rows using the ``INSERT`` statement by using sets of par .. code-block:: psql - test=> INSERT INTO cool_animals VALUES - (3, 'Cat', 5) , - (4, 'Elephant', 6500) , - (5, 'Rhinoceros', 2100); + INSERT INTO cool_animals VALUES + (3, 'Cat', 5) , + (4, 'Elephant', 6500) , + (5, 'Rhinoceros', 2100); - executed -.. note:: You can load large data sets using bulk loading methods instead. For more information, see :ref:`inserting_data`. +.. note:: You can load large data sets using bulk loading methods instead. For more information, see :ref:`ingesting_data`. .. _omitting_columns: @@ -60,16 +58,16 @@ Omitting columns that have a default values (including default ``NULL`` values) .. code-block:: psql - test=> INSERT INTO cool_animals (id) VALUES (6); + INSERT INTO cool_animals (id) VALUES (6); - executed + .. code-block:: psql - test=> INSERT INTO cool_animals (id) VALUES (6); + INSERT INTO cool_animals (id) VALUES (6); - executed - test=> SELECT * FROM cool_animals; + + SELECT * FROM cool_animals; 1,Dog ,7 2,Possum ,3 3,Cat ,5 @@ -77,7 +75,7 @@ Omitting columns that have a default values (including default ``NULL`` values) 5,Rhinoceros ,2100 6,\N,\N - 6 rows + .. note:: Null row values are represented as ``\N`` From ba7fd332e5cd7b237b00653e3616e0ae6166c412 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 18 Jun 2024 13:40:24 +0300 Subject: [PATCH 846/882] Update query_healer.rst --- feature_guides/query_healer.rst | 32 +++++++++++--------------------- 1 file changed, 11 insertions(+), 21 deletions(-) diff --git a/feature_guides/query_healer.rst b/feature_guides/query_healer.rst index 257de9e32..ba07d3f11 100644 --- a/feature_guides/query_healer.rst +++ b/feature_guides/query_healer.rst @@ -1,21 +1,16 @@ .. _query_healer: -*********************** +************ Query Healer -*********************** -The **Query Healer** page describes the following: - -.. contents:: - :local: - :depth: 1 - -Overview ----------- +************ + + The **Query Healer** periodically examines the progress of running statements, creating a log entry for all statements exceeding a defined time period. Configuration ------------- -The following **Administration Worker** flags are required to configure the Query Healer: + +The following worker flags are required to configure the Query Healer: .. list-table:: :widths: auto @@ -26,12 +21,12 @@ The following **Administration Worker** flags are required to configure the Quer * - ``is_healer_on`` - The :ref:`is_healer_on` enables and disables the Query Healer. * - ``maxStatementInactivitySeconds`` - - The :ref:`healer_max_statement_inactivity_seconds` worker level flag defines the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU. The default setting is five hours. + - The :ref:`max_statement_inactivity_seconds` worker level flag defines the threshold for creating a log recording a slow statement. The log includes information about the log memory, CPU and GPU. The default setting is five hours. * - ``healerDetectionFrequencySeconds`` - The :ref:`healer_detection_frequency_seconds` worker level flag triggers the healer to examine the progress of running statements. The default setting is one hour. Query Log ---------------- +--------- The following is an example of a log record for a query stuck in the query detection phase for more than five hours: @@ -42,7 +37,8 @@ The following is an example of a log record for a query stuck in the query detec Once you identify the stuck worker, you can execute the ``shutdown_server`` utility function from this specific worker, as described in the next section. Activating a Graceful Shutdown ------------------- +------------------------------ + You can activate a graceful shutdown if your log entry says ``Stuck query found``, as shown in the example above. You can do this by setting the **shutdown_server** utility function to ``select shutdown_server();``. **To activte a graceful shutdown:** @@ -59,10 +55,4 @@ You can activate a graceful shutdown if your log entry says ``Stuck query found` 3. Execute ``shutdown_server``. -For more information, see the following: - -* Activating the :ref:`shutdown_server_command` utility function. This page describes all of ``shutdown_server`` options. - - :: - -* Configuring the :ref:`shutdown_server` flag. \ No newline at end of file +For more information, see the :ref:`shutdown_server_command` utility function. This page describes all of ``shutdown_server`` options. From 40018ca42290e3b624c67185b38d797381f357ff Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 18 Jun 2024 13:41:38 +0300 Subject: [PATCH 847/882] Update python_functions.rst --- feature_guides/python_functions.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/feature_guides/python_functions.rst b/feature_guides/python_functions.rst index eb7b0a54c..e4589e0f8 100644 --- a/feature_guides/python_functions.rst +++ b/feature_guides/python_functions.rst @@ -134,8 +134,8 @@ You can write a function in Python to uppercase a text value using the :ref:`cre Let's break down this example: * ``CREATE FUNCTION my_upper`` - :ref:`Create a function<create_function>` called ``my_upper``. This name must be unique in the current database -* ``(x1 text)`` - the function accepts one argument named ``x1`` which is of the SQL type ``TEXT``. All :ref:`data types<data_types>` are supported. -* ``RETURNS text`` - the function returns the same type - ``TEXT``. All :ref:`data types<data_types>` are supported. +* ``(x1 text)`` - the function accepts one argument named ``x1`` which is of the SQL type ``TEXT``. All :ref:`data types<supported_data_types>` are supported. +* ``RETURNS text`` - the function returns the same type - ``TEXT``. All :ref:`data types<supported_data_types>` are supported. * ``AS $$`` - what follows is some code that we don't want to quote, so we use dollar-quoting (``$$``) instead of single quotes (``'``). * ``return x1.upper()`` - the Python function's body is the argument named ``x1``, uppercased. * ``$$ LANGUAGE PYTHON`` - this is the end of the function, and it's in the Python language. From afb977c1458d607c49ec2d70c150a90684c7d7b1 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 18 Jun 2024 13:41:53 +0300 Subject: [PATCH 848/882] Update sql_data_types_numeric.rst --- data_type_guides/sql_data_types_numeric.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data_type_guides/sql_data_types_numeric.rst b/data_type_guides/sql_data_types_numeric.rst index 6a7a7b6ec..e97528b63 100644 --- a/data_type_guides/sql_data_types_numeric.rst +++ b/data_type_guides/sql_data_types_numeric.rst @@ -4,7 +4,7 @@ Numeric ******* -The **Numeric** data type (also known as **Decimal**) is recommended for values that tend to occur as exact decimals, such as in Finance. While Numeric has a fixed precision of ``38``, higher than ``REAL`` (``9``) or ``DOUBLE`` (``17``), it runs calculations more slowly. For operations that require faster performance, using :ref:`Floating Point <floating_point>` is recommended. +The **Numeric** data type (also known as **Decimal**) is recommended for values that tend to occur as exact decimals, such as in Finance. While Numeric has a fixed precision of ``38``, higher than ``REAL`` (``9``) or ``DOUBLE`` (``17``), it runs calculations more slowly. For operations that require faster performance, using :ref:`Floating Point <sql_data_types_floating_point>` is recommended. The correct syntax for Numeric is ``numeric(p, s)``), where ``p`` is the total number of digits (``38`` maximum), and ``s`` is the total number of decimal digits. If no parameters are specified, Numeric defaults to ``numeric(38, 0)``. From 50e1fa5034cbe1569f9f373ac3c12ca2c463a112 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 18 Jun 2024 13:42:46 +0300 Subject: [PATCH 849/882] Update orc.rst --- data_ingestion/orc.rst | 197 ++++++++++++++++++++++++++--------------- 1 file changed, 127 insertions(+), 70 deletions(-) diff --git a/data_ingestion/orc.rst b/data_ingestion/orc.rst index 8a88b4228..5be02eb72 100644 --- a/data_ingestion/orc.rst +++ b/data_ingestion/orc.rst @@ -4,12 +4,23 @@ ORC *** +This guide covers ingesting data from ORC files into SQream DB using :ref:`FOREIGN TABLE<foreign_tables>`. + .. contents:: :local: :depth: 1 -This guide covers ingesting data from ORC files into SQreamDB using :ref:`FOREIGN TABLE<external_tables>`. +Foreign Data Wrapper Prerequisites +=================================== + +Before proceeding, ensure the following Foreign Data Wrapper (FDW) prerequisites: + +* **File Existence:** Verify that the file you are ingesting data from exists at the specified path. + +* **Path Accuracy:** Confirm that all path elements are present and correctly spelled. Any inaccuracies may lead to data retrieval issues. +* **Bucket Access Permissions:** Ensure that you have the necessary access permissions to the bucket from which you are ingesting data. Lack of permissions can hinder the data retrieval process. +* **Wildcard Accuracy:** If using wildcards, double-check their spelling and configuration. Misconfigured wildcards may result in unintended data ingestion. Prepare the files ================= @@ -21,7 +32,7 @@ Prepare the source ORC files, with the following requirements: :header-rows: 1 - * - SQreamDB type → + * - SQream DB type → ORC source - ``BOOL`` @@ -157,15 +168,15 @@ Prepare the source ORC files, with the following requirements: .. [#f7] Will succeed if all values fit the destination type -Place ORC files where SQreamDB workers can access them -====================================================== +Place ORC files where SQream DB workers can access them +======================================================= Any worker may try to access files (unless explicitly speficied with the :ref:`workload_manager`). -It is important that every node has the same view of the storage being used - meaning, every SQreamDB worker should have access to the files. +It is important that every node has the same view of the storage being used - meaning, every SQream DB worker should have access to the files. * For files hosted on NFS, ensure that the mount is accessible from all servers. -* For HDFS, ensure that SQreamDB servers can access the HDFS name node with the correct user-id. See our :ref:`hdfs` guide for more information. +* For HDFS, ensure that SQream DB servers can access the HDFS name node with the correct user-id. See our :ref:`hdfs` guide for more information. * For S3, ensure network access to the S3 endpoint. See our :ref:`s3` guide for more information. @@ -188,27 +199,25 @@ We will make note of the file structure to create a matching ``CREATE FOREIGN TA .. code-block:: postgres - CREATE FOREIGN TABLE ext_nba - ( - Name TEXT(40), - Team TEXT(40), - Number BIGINT, - Position TEXT(2), - Age BIGINT, - Height TEXT(4), - Weight BIGINT, - College TEXT(40), - Salary FLOAT - ) - WRAPPER orc_fdw - OPTIONS - ( - LOCATION = 's3://sqream-demo-data/nba.orc' - ); + CREATE FOREIGN TABLE ext_nba ( + Name TEXT(40), + Team TEXT(40), + Number BIGINT, + Position TEXT(2), + Age BIGINT, + Height TEXT(4), + Weight BIGINT, + College TEXT(40), + Salary FLOAT + ) + WRAPPER + orc_fdw + OPTIONS + (LOCATION = 's3://sqream-docs/nba.orc'); .. tip:: - Types in SQreamDB must match ORC types according to the table above. + Types in SQream DB must match ORC types according to the table above. If the column type isn't supported, a possible workaround is to set it to any arbitrary type and then exclude it from subsequent queries. @@ -220,33 +229,38 @@ External tables do not verify file integrity or structure, so verify that the ta .. code-block:: psql - t=> SELECT * FROM ext_nba LIMIT 10; - Name | Team | Number | Position | Age | Height | Weight | College | Salary - --------------+----------------+--------+----------+-----+--------+--------+-------------------+--------- - Avery Bradley | Boston Celtics | 0 | PG | 25 | 6-2 | 180 | Texas | 7730337 - Jae Crowder | Boston Celtics | 99 | SF | 25 | 6-6 | 235 | Marquette | 6796117 - John Holland | Boston Celtics | 30 | SG | 27 | 6-5 | 205 | Boston University | - R.J. Hunter | Boston Celtics | 28 | SG | 22 | 6-5 | 185 | Georgia State | 1148640 - Jonas Jerebko | Boston Celtics | 8 | PF | 29 | 6-10 | 231 | | 5000000 - Amir Johnson | Boston Celtics | 90 | PF | 29 | 6-9 | 240 | | 12000000 - Jordan Mickey | Boston Celtics | 55 | PF | 21 | 6-8 | 235 | LSU | 1170960 - Kelly Olynyk | Boston Celtics | 41 | C | 25 | 7-0 | 238 | Gonzaga | 2165160 - Terry Rozier | Boston Celtics | 12 | PG | 22 | 6-2 | 190 | Louisville | 1824360 - Marcus Smart | Boston Celtics | 36 | PG | 22 | 6-4 | 220 | Oklahoma State | 3431040 + SELECT * FROM ext_nba LIMIT 10; + + Name | Team | Number | Position | Age | Height | Weight | College | Salary + --------------+----------------+--------+----------+-----+--------+--------+-------------------+--------- + Avery Bradley | Boston Celtics | 0 | PG | 25 | 6-2 | 180 | Texas | 7730337 + Jae Crowder | Boston Celtics | 99 | SF | 25 | 6-6 | 235 | Marquette | 6796117 + John Holland | Boston Celtics | 30 | SG | 27 | 6-5 | 205 | Boston University | + R.J. Hunter | Boston Celtics | 28 | SG | 22 | 6-5 | 185 | Georgia State | 1148640 + Jonas Jerebko | Boston Celtics | 8 | PF | 29 | 6-10 | 231 | | 5000000 + Amir Johnson | Boston Celtics | 90 | PF | 29 | 6-9 | 240 | | 12000000 + Jordan Mickey | Boston Celtics | 55 | PF | 21 | 6-8 | 235 | LSU | 1170960 + Kelly Olynyk | Boston Celtics | 41 | C | 25 | 7-0 | 238 | Gonzaga | 2165160 + Terry Rozier | Boston Celtics | 12 | PG | 22 | 6-2 | 190 | Louisville | 1824360 + Marcus Smart | Boston Celtics | 36 | PG | 22 | 6-4 | 220 | Oklahoma State | 3431040 If any errors show up at this stage, verify the structure of the ORC files and match them to the external table structure you created. -Copying data into SQreamDB -========================== +Copying data into SQream DB +=========================== -To load the data into SQreamDB, use the :ref:`create_table_as` statement: +To load the data into SQream DB, use the :ref:`create_table_as` statement: .. code-block:: postgres - CREATE TABLE nba AS - SELECT * FROM ext_nba; - -Working around unsupported column types + CREATE TABLE + nba AS + SELECT + * + FROM + ext_nba; + +Working Around Unsupported Column Types --------------------------------------- Suppose you only want to load some of the columns - for example, if one of the columns isn't supported. @@ -256,9 +270,21 @@ By ommitting unsupported columns from queries that access the ``EXTERNAL TABLE`` For this example, assume that the ``Position`` column isn't supported because of its type. .. code-block:: postgres - - CREATE TABLE nba AS - SELECT Name, Team, Number, NULL as Position, Age, Height, Weight, College, Salary FROM ext_nba; + + CREATE TABLE + nba AS + SELECT + Name, + Team, + Number, + NULL as Position, + Age, + Height, + Weight, + College, + Salary + FROM + ext_nba; -- We ommitted the unsupported column `Position` from this query, and replaced it with a default ``NULL`` value, to maintain the same table structure. @@ -274,10 +300,22 @@ Similar to the previous example, we will also set the ``Position`` column as a d .. code-block:: postgres - CREATE TABLE nba AS - SELECT name, team, number, NULL as position, age, height, (weight / 2.205) as weight, college, salary - FROM ext_nba - ORDER BY weight; + CREATE TABLE + nba AS + SELECT + name, + team, + number, + NULL as position, + age, + height, + (weight / 2.205) as weight, + college, + salary + FROM + ext_nba + ORDER BY + weight; Further ORC loading examples @@ -291,29 +329,48 @@ Loading a table from a directory of ORC files on HDFS .. code-block:: postgres - CREATE FOREIGN TABLE ext_users - (id INT NOT NULL, name TEXT(30) NOT NULL, email TEXT(50) NOT NULL) - WRAPPER orc_fdw - OPTIONS - ( - LOCATION = 'hdfs://hadoop-nn.piedpiper.com/rhendricks/users/*.ORC' - ); + CREATE FOREIGN TABLE ext_users ( + id INT NOT NULL, + name TEXT(30) NOT NULL, + email TEXT(50) NOT NULL + ) + WRAPPER + orc_fdw + OPTIONS + ( + LOCATION = 'hdfs://hadoop-nn.piedpiper.com/rhendricks/users/*.ORC' + ); - CREATE TABLE users AS SELECT * FROM ext_users; + CREATE TABLE + users AS + SELECT + * + FROM + ext_users; Loading a table from a bucket of files on S3 -------------------------------------------- .. code-block:: postgres - CREATE FOREIGN TABLE ext_users - (id INT NOT NULL, name TEXT(30) NOT NULL, email TEXT(50) NOT NULL) - WRAPPER orc_fdw - OPTIONS - ( LOCATION = 's3://pp-secret-bucket/users/*.ORC', - AWS_ID = 'our_aws_id', - AWS_SECRET = 'our_aws_secret' - ) - ; - - CREATE TABLE users AS SELECT * FROM ext_users; \ No newline at end of file + CREATE FOREIGN TABLE ext_users ( + id INT NOT NULL, + name TEXT(30) NOT NULL, + email TEXT(50) NOT NULL + ) + WRAPPER + orc_fdw + OPTIONS + ( + LOCATION = 's3://sqream-docs/users/*.ORC', + AWS_ID = 'our_aws_id', + AWS_SECRET = 'our_aws_secret' + ); + + + CREATE TABLE + users AS + SELECT + * + FROM + ext_users; \ No newline at end of file From dd4c83d13479c2ce98696319e891b668182a2bc2 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 18 Jun 2024 13:43:21 +0300 Subject: [PATCH 850/882] Update ingesting_data.rst --- data_ingestion/ingesting_data.rst | 63 ++++++++++++++++++++----------- 1 file changed, 41 insertions(+), 22 deletions(-) diff --git a/data_ingestion/ingesting_data.rst b/data_ingestion/ingesting_data.rst index a725608f8..68d114e13 100644 --- a/data_ingestion/ingesting_data.rst +++ b/data_ingestion/ingesting_data.rst @@ -1,8 +1,9 @@ .. _ingesting_data: -*************************** -Ingesting Data Overview -*************************** +******** +Overview +******** + The **Ingesting Data Overview** page provides basic information useful when ingesting data into SQream from a variety of sources and locations, and describes the following: .. contents:: @@ -10,7 +11,8 @@ The **Ingesting Data Overview** page provides basic information useful when inge :depth: 1 Getting Started -================================ +=============== + SQream supports ingesting data using the following methods: * Executing the ``INSERT`` statement using a client driver. @@ -46,7 +48,8 @@ For more information, see the following: * Loading data from foreign tables - :ref:`foreign_tables` Data Loading Considerations -================================ +=========================== + The **Data Loading Considerations** section describes the following: .. contents:: @@ -54,7 +57,8 @@ The **Data Loading Considerations** section describes the following: :depth: 1 Verifying Data and Performance after Loading ------------------------------------------ +-------------------------------------------- + Like many RDBMSs, SQream recommends its own set of best practices for table design and query optimization. When using SQream, verify the following: * That your data is structured as you expect (row counts, data types, formatting, content). @@ -63,12 +67,13 @@ Like many RDBMSs, SQream recommends its own set of best practices for table desi * That you followed the table design best practices (:ref:`Optimization and Best Practices<sql_best_practices>`). -* That you've tested and verified that your applications work (such as :ref:`Tableau<connect_to_tableau>`). +* That you've tested and verified that your applications work. * That your data types have not been not over-provisioned. File Soure Location when Loading -------------------------------- + While you are loading data, you can use the ``COPY FROM`` command to let statements run on any worker. If you are running multiple nodes, verify that all nodes can see the source the same. Loading data from a local file that is only on one node and not on shared storage may cause it to fail. If required, you can also control which node a statement runs on using the Workload Manager). For more information, see the following: @@ -79,8 +84,11 @@ For more information, see the following: Supported Load Methods ---------------------- + You can use the ``COPY FROM`` syntax to load CSV files. +.. note:: The ``COPY FROM`` cannot be used for loading data from Parquet and ORC files. + You can use foreign tables to load text files, Parquet, and ORC files, and to transform your data before generating a full table, as described in the following table: .. list-table:: @@ -95,8 +103,8 @@ You can use foreign tables to load text files, Parquet, and ORC files, and to tr - Streaming Data * - COPY FROM - Supported - - Supported - - Supported + - Not supported + - Not supported - Not supported * - Foreign tables - Supported @@ -118,17 +126,25 @@ For more information, see the following: * :ref:`INSERT<insert>` Unsupported Data Types ------------------------------ +---------------------- + SQream does not support certain features that are supported by other databases, such as ``ARRAY``, ``BLOB``, ``ENUM``, and ``SET``. You must convert these data types before loading them. For example, you can store ``ENUM`` as ``TEXT``. Handing Extended Errors ----------------------------- +----------------------- + While you can use foreign tables to load CSVs, the ``COPY FROM`` statement provides more fine-grained error handling options and extended support for non-standard CSVs with multi-character delimiters, alternate timestamp formats, and more. For more information, see :ref:`foreign tables<foreign_tables>`. + +Foreign Data Wrapper Best Practice +================================== + +A recommended approach when working with :ref:`foreign_tables` and Foreign Data Wrapper (FDW) is storing files belonging to distinct file families and files with similar schemas in separate folders. Best Practices for CSV ------------------------------- +---------------------- + Text files, such as CSV, rarely conform to `RFC 4180 <https://tools.ietf.org/html/rfc4180>`_ , so you may need to make the following modifications: * Use ``OFFSET 2`` for files containing header rows. @@ -148,7 +164,8 @@ Text files, such as CSV, rarely conform to `RFC 4180 <https://tools.ietf.org/htm * Field delimiters do not have to be a displayable ASCII character. For all supported field delimiters, see :ref:`field_delimiters`. Best Practices for Parquet --------------------------------- +-------------------------- + The following list shows the best practices when ingesting data from Parquet files: * You must load Parquet files through :ref:`foreign_tables`. Note that the destination table structure must be identical to the number of columns between the source files. @@ -156,7 +173,8 @@ The following list shows the best practices when ingesting data from Parquet fil * Parquet files support **predicate pushdown**. When a query is issued over Parquet files, SQream uses row-group metadata to determine which row-groups in a file must be read for a particular query and the row indexes can narrow the search to a particular set of rows. Supported Types and Behavior Notes -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + Unlike the ORC format, the column types should match the data types exactly, as shown in the table below: .. list-table:: @@ -269,7 +287,8 @@ Unlike the ORC format, the column types should match the data types exactly, as If a Parquet file has an unsupported type, such as ``enum``, ``uuid``, ``time``, ``json``, ``bson``, ``lists``, ``maps``, but the table does not reference this data (i.e., the data does not appear in the :ref:`SELECT` query), the statement will succeed. If the table **does** reference a column, an error will be displayed explaining that the type is not supported, but the column may be omitted. Best Practices for ORC --------------------------------- +---------------------- + The following list shows the best practices when ingesting data from ORC files: * You must load ORC files through :ref:`foreign_tables`. Note that the destination table structure must be identical to the number of columns between the source files. @@ -277,8 +296,9 @@ The following list shows the best practices when ingesting data from ORC files: * ORC files support **predicate pushdown**. When a query is issued over ORC files, SQream uses ORC metadata to determine which stripes in a file need to be read for a particular query and the row indexes can narrow the search to a particular set of 10,000 rows. Type Support and Behavior Notes -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -You must load ORC files through foreign table. Note that the destination table structure must be identical to the number of columns between the source files. +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +You must load ORC files through a foreign table. Note that the destination table structure must be identical to the number of columns between the source files. For more information, see :ref:`foreign_tables`. @@ -299,7 +319,7 @@ The types should match to some extent within the same "class", as shown in the f - ``BIGINT`` - ``REAL`` - ``DOUBLE`` - - Text [#f0]_ + - ``TEXT`` - ``DATE`` - ``DATETIME`` * - ``boolean`` @@ -413,7 +433,7 @@ The types should match to some extent within the same "class", as shown in the f - - Supported -* If an ORC file has an unsupported type like ``binary``, ``list``, ``map``, and ``union``, but the data is not referenced in the table (it does not appear in the :ref:`SELECT` query), the statement will succeed. If the column is referenced, an error will be thrown to the user, explaining that the type is not supported, but the column may be ommited. +* If an ORC file has an unsupported type like ``binary``, ``list``, ``map``, and ``union``, but the data is not referenced in the table (it does not appear in the :ref:`SELECT` query), the statement will succeed. If the column is referenced, an error will be thrown to the user, explaining that the type is not supported, but the column may be omitted. @@ -457,7 +477,8 @@ The types should match to some extent within the same "class", as shown in the f try to combine sensibly with the external table stuff Further Reading and Migration Guides -======================================= +==================================== + For more information, see the following: * :ref:`copy_from` @@ -466,8 +487,6 @@ For more information, see the following: .. rubric:: Footnotes -.. [#f0] Text values include ``TEXT``, ``VARCHAR``, and ``NVARCHAR`` - .. [#f2] With UTF8 annotation .. [#f3] With ``TIMESTAMP_NANOS`` or ``TIMESTAMP_MILLIS`` annotation From 3e317bd11b4632ebcaa0082f31e9afe61b227a67 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 20 Jun 2024 08:24:53 +0300 Subject: [PATCH 851/882] Maintenance --- releases/4.0.rst | 24 +++++++++++------------- releases/index.rst | 4 ++-- 2 files changed, 13 insertions(+), 15 deletions(-) diff --git a/releases/4.0.rst b/releases/4.0.rst index ed6dc628c..1c499e9ea 100644 --- a/releases/4.0.rst +++ b/releases/4.0.rst @@ -1,8 +1,8 @@ .. _4.0: -************************** +***************** Release Notes 4.0 -************************** +***************** SQream is introducing a new version release system that follows the more commonly used Major.Minor versioning schema. The newly released **4.0 version** is a minor version upgrade and does not require considerable preparation. @@ -42,10 +42,11 @@ SQream Studio Updates and Improvements Known Issues ------------ + :ref:`Percentile<percentile_disc>` is not supported for Window functions. Version 4.0 resolved Issues ------------------------------ +---------------------------- +-----------------+---------------------------------------------------------------------------------------+ | **SQ No.** | **Description** | @@ -77,14 +78,17 @@ Version 4.0 resolved Issues Configuration Changes --------------------- + No configuration changes were made. Naming Changes -------------- + No relevant naming changes were made. Deprecated Features ------------------- + SQream is declaring end of support of VARCHAR data type, the decision resulted by SQream's effort to enhance its core functionalities and with respect to ever changing echo system requirements. VARCHAR is no longer supported for new customers - effective from Version 2022.1.3 (September 2022). @@ -93,11 +97,13 @@ TEXT data type is replacing VARCHAR and NVARCHAR - SQream will maintain VARCHAR End of Support ---------------- +-------------- + No End of Support changes were made. Upgrading to version 4.0 -------------------- +------------------------ + 1. Generate a back-up of the metadata by running the following command: .. code-block:: console @@ -110,20 +116,12 @@ Upgrading to version 4.0 2. Shut down all SQream services. - :: - 3. Extract the recently created back-up file. - :: - 4. Replace your current metadata with the metadata you stored in the back-up file. - :: - 5. Navigate to the new SQream package bin folder. - :: - 6. Run the following command: .. code-block:: console diff --git a/releases/index.rst b/releases/index.rst index a945c97ec..b17b05ff8 100644 --- a/releases/index.rst +++ b/releases/index.rst @@ -1,8 +1,8 @@ .. _releases: -********** +************* Release Notes -********** +************* .. list-table:: From 84221813d3898e9086f1fc0fa54ee36c5da57b68 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 20 Jun 2024 09:36:03 +0300 Subject: [PATCH 852/882] Maintenance --- .../client_platforms/microstrategy.rst | 39 +------ .../client_platforms/sas_viya.rst | 106 +++++------------- .../client_platforms/talend.rst | 45 +++----- .../client_platforms/tibco_spotfire.rst | 94 +++++----------- 4 files changed, 71 insertions(+), 213 deletions(-) diff --git a/connecting_to_sqream/client_platforms/microstrategy.rst b/connecting_to_sqream/client_platforms/microstrategy.rst index 8947eb0e6..87f688a7b 100644 --- a/connecting_to_sqream/client_platforms/microstrategy.rst +++ b/connecting_to_sqream/client_platforms/microstrategy.rst @@ -1,5 +1,4 @@ -.. _microstrategy: - +.. _micro_strategy: ************* MicroStrategy @@ -49,62 +48,38 @@ Connecting a Data Source ======================== 1. Activate the **MicroStrategy Desktop** app. The app displays the Dossiers panel to the right. - - :: 2. Download the most current version of the `SQream JDBC driver <https://docs.sqream.com/en/v2022.1/connecting_to_sqream/client_drivers/index.html>`_. - :: - 3. Click **Dossiers** and **New Dossier**. The **Untitled Dossier** panel is displayed. - - :: 4. Click **New Data**. - - :: 5. From the **Data Sources** panel, select **Databases** to access data from tables. The **Select Import Options** panel is displayed. - - :: 6. Select one of the following: * Build a Query * Type a Query * Select Tables - - :: 7. Click **Next**. - - :: 8. In the Data Source panel, do the following: 1. From the **Database** dropdown menu, select **Generic**. The **Host Name**, **Port Number**, and **Database Name** fields are removed from the panel. - - :: 2. In the **Version** dropdown menu, verify that **Generic DBMS** is selected. - - :: 3. Click **Show Connection String**. - - :: 4. Select the **Edit connection string** checkbox. - - :: 5. From the **Driver** dropdown menu, select a driver for one of the following connectors: * **JDBC** - The SQream driver is not integrated with MicroStrategy and does not appear in the dropdown menu. However, to proceed, you must select an item, and in the next step you must specify the path to the SQream driver that you installed on your machine. * **ODBC** - SQreamDB ODBC - :: - 6. In the **Connection String** text box, type the relevant connection string and path to the JDBC jar file using the following syntax: .. code-block:: console @@ -126,32 +101,20 @@ Connecting a Data Source For more information about the available **connection parameters** and other examples, see :ref:`Connection Parameters <java_jdbc>`. 7. In the **User** and **Password** fields, fill out your user name and password. - - :: 8. In the **Data Source Name** field, type **SQreamDB**. - - :: 9. Click **Save**. The SQreamDB that you picked in the Data Source panel is displayed. 9. In the **Namespace** menu, select a namespace. The tables files are displayed. - :: - 10. Drag and drop the tables into the panel on the right in your required order. - :: - 11. **Recommended** - Click **Prepare Data** to customize your data for analysis. - :: - 12. Click **Finish**. - :: - 13. From the **Data Access Mode** dialog box, select one of the following: diff --git a/connecting_to_sqream/client_platforms/sas_viya.rst b/connecting_to_sqream/client_platforms/sas_viya.rst index d84e9a038..7fc3cd912 100644 --- a/connecting_to_sqream/client_platforms/sas_viya.rst +++ b/connecting_to_sqream/client_platforms/sas_viya.rst @@ -4,79 +4,62 @@ SAS Viya ******** -Overview -======== - -SAS Viya is a cloud-enabled analytics engine used for producing useful insights. The **Connect to SQream Using SAS Viya** page describes how to connect to SAS Viya, and describes the following: +SAS Viya is a cloud-enabled analytics engine used for producing useful insights. .. contents:: :local: :depth: 1 Installing SAS Viya -------------------- +=================== The **Installing SAS Viya** section describes the following: -.. contents:: - :local: - :depth: 1 - Downloading SAS Viya -~~~~~~~~~~~~~~~~~~~~ +-------------------- -Integrating with SQream has been tested with SAS Viya v.03.05 and newer. +Integrating with SQreamDB has been tested with SAS Viya v.03.05 and newer. To download SAS Viya, see `SAS Viya <https://www.sas.com/en_us/software/viya.html>`_. Installing the JDBC Driver -~~~~~~~~~~~~~~~~~~~~~~~~~~ +-------------------------- -The SQream JDBC driver is required for establishing a connection between SAS Viya and SQream. +The SQreamDB JDBC driver is required for establishing a connection between SAS Viya and SQreamDB. **To install the JDBC driver:** -#. Download the `JDBC driver <https://docs.sqream.com/en/v2022.1/connecting_to_sqream/client_drivers/jdbc/index.html>`_. +#. Download the :ref:`JDBC driver<java_jdbc>`. :: #. Unzip the JDBC driver into a location on the SAS Viya server. - SQream recommends creating the directory ``/opt/sqream`` on the SAS Viya server. + SQreamDB recommends creating the directory ``/opt/sqream`` on the SAS Viya server. Configuring SAS Viya --------------------- +==================== -After installing the JDBC driver, you must configure the JDBC driver from the SAS Studio so that it can be used with SQream Studio. +After installing the JDBC driver, you must configure the JDBC driver from the SAS Studio so that it can be used with SQreamDB BStudio. **To configure the JDBC driver from the SAS Studio:** #. Sign in to the SAS Studio. - :: - #. From the **New** menu, click **SAS Program**. - - :: -#. Configure the SQream JDBC connector by adding the following rows: +#. Configure the SQreamDB JDBC connector by adding the following rows: .. literalinclude:: connect3.sas :language: php -For more information about writing a connection string, see **Connect to SQream DB with a JDBC Application** and navigate to `Connection String <https://docs.sqream.com/en/v2022.1/connecting_to_sqream/client_drivers/jdbc/index.html#connection-string-examples>`_. - Operating SAS Viya ------------------- +================== The **Operating SAS Viya** section describes the following: - -.. contents:: - :local: - :depth: 1 Using SAS Viya Visual Analytics -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +------------------------------- This section describes how to use SAS Viya Visual Analytics. @@ -84,36 +67,20 @@ This section describes how to use SAS Viya Visual Analytics. #. Log in to SAS Viya Visual Analytics using your credentials: - :: - 2. Click **New Report**. - :: - 3. Click **Data**. - :: - 4. Click **Data Sources**. - :: - 5. Click the **Connect** icon. - :: - 6. From the **Type** menu, select **Database**. - :: - 7. Provide the required information and select **Persist this connection beyond the current session**. - :: - 8. Click **Advanced** and provide the required information. - :: - 9. Add the following additional parameters by clicking **Add Parameters**: .. list-table:: @@ -123,75 +90,64 @@ This section describes how to use SAS Viya Visual Analytics. * - Name - Value * - class - - com.sqream.jdbc.SQDriver + - ``com.sqream.jdbc.SQDriver`` * - classPath - - *<path_to_jar_file>* + - ``<path_to_jar_file>`` * - url - - \jdbc:Sqream://*<IP>*:*<port>*/*<database>*;cluster=true + - ``\jdbc:Sqream://*<IP>*:*<port>*/*<database>*;cluster=true`` * - username - - <username> + - ``<username>`` * - password - - <password> + - ``<password>`` 10. Click **Test Connection**. - :: - 11. If the connection is successful, click **Save**. -If your connection is not successful, see :ref:`troubleshooting_sas_viya` below. .. _troubleshooting_sas_viya: Troubleshooting SAS Viya ------------------------- - -The **Best Practices and Troubleshooting** section describes the following best practices and troubleshooting procedures when connecting to SQream using SAS Viya: +======================== -.. contents:: - :local: - :depth: 1 +The **Best Practices and Troubleshooting** section describes the following best practices and troubleshooting procedures when connecting to SQreamDB using SAS Viya: Inserting Only Required Data -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +---------------------------- -When using SAS Viya, SQream recommends using only data that you need, as described below: +When using SAS Viya, SQreamDB recommends using only data that you need, as described below: * Insert only the data sources you need into SAS Viya, excluding tables that don’t require analysis. :: -* To increase query performance, add filters before analyzing. Every modification you make while analyzing data queries the SQream database, sometimes several times. Adding filters to the datasource before exploring limits the amount of data analyzed and increases query performance. +* To increase query performance, add filters before analyzing. Every modification you make while analyzing data queries the SQreamDB database, sometimes several times. Adding filters to the datasource before exploring limits the amount of data analyzed and increases query performance. Creating a Separate Service for SAS Viya -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +---------------------------------------- -SQream recommends creating a separate service for SAS Viya with the DWLM. This reduces the impact that Tableau has on other applications and processes, such as ETL. In addition, this works in conjunction with the load balancer to ensure good performance. +SQreamDB recommends creating a separate service for SAS Viya with the DWLM. This reduces the impact that Tableau has on other applications and processes, such as ETL. In addition, this works in conjunction with the load balancer to ensure good performance. -Locating the SQream JDBC Driver -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Locating the SQreamDB JDBC Driver +--------------------------------- -In some cases, SAS Viya cannot locate the SQream JDBC driver, generating the following error message: +In some cases, SAS Viya cannot locate the SQreamDB JDBC driver, generating the following error message: .. code-block:: text java.lang.ClassNotFoundException: com.sqream.jdbc.SQDriver -**To locate the SQream JDBC driver:** +**To locate the SQreamDB JDBC driver:** 1. Verify that you have placed the JDBC driver in a directory that SAS Viya can access. - :: - 2. Verify that the classpath in your SAS program is correct, and that SAS Viya can access the file that it references. - :: - 3. Restart SAS Viya. -For more troubleshooting assistance, see the `SQream Support Portal <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_. +For more troubleshooting assistance, see the `SQreamDB Support Portal <https://sqream.atlassian.net/servicedesk/customer/portal/2/group/8/create/26>`_. Supporting TEXT -~~~~~~~~~~~~~~~ +--------------- In SAS Viya versions lower than 4.0, casting ``TEXT`` to ``CHAR`` changes the size to 1,024, such as when creating a table including a ``TEXT`` column. This is resolved by casting ``TEXT`` into ``CHAR`` when using the JDBC driver. \ No newline at end of file diff --git a/connecting_to_sqream/client_platforms/talend.rst b/connecting_to_sqream/client_platforms/talend.rst index 7f11092fb..b439fe87d 100644 --- a/connecting_to_sqream/client_platforms/talend.rst +++ b/connecting_to_sqream/client_platforms/talend.rst @@ -1,12 +1,13 @@ .. _talend: -************************* -Connecting to SQream Using Talend -************************* +****** +Talend +****** Overview -================= -This page describes how to use Talend to interact with a SQream cluster. The Talend connector is used for reading data from a SQream cluster and loading data into SQream. In addition, this page provides a viability report on Talend's comptability with SQream for stakeholders. +======== + +This page describes how to use Talend to interact with a SQream cluster. The Talend connector is used for reading data from a SQream cluster and loading data into SQream. In addition, this page provides a viability report on Talend's comparability with SQream for stakeholders. The **Connecting to SQream Using Talend** describes the following: @@ -15,33 +16,24 @@ The **Connecting to SQream Using Talend** describes the following: :depth: 1 Creating a New Metadata JDBC DB Connection ----------------- +------------------------------------------ + **To create a new metadata JDBC DB connection:** 1. In the **Repository** panel, nagivate to **Metadata** and right-click **Db connections**. - - :: 2. Select **Create connection**. - - :: 3. In the **Name** field, type a name. - :: - Note that the name cannot contain spaces. 4. In the **Purpose** field, type a purpose and click **Next**. Note that you cannot continue to the next step until you define both a Name and a Purpose. - :: - 5. In the **DB Type** field, select **JDBC**. - :: - 6. In the **JDBC URL** field, type the relevant connection string. For connection string examples, see `Connection Strings <https://docs.sqream.com/en/v2022.1/connecting_to_sqream/client_drivers/jdbc/index.html#connection-string-examples>`_. @@ -56,28 +48,20 @@ Creating a New Metadata JDBC DB Connection 9. From the Module window, select **Artifact repository(local m2/nexus)** and select **Install a new module**. - :: - 10. Click the ellipsis. Your hard drive is displayed. 11. Navigate to a **JDBC jar file** (such as **sqream-jdbc-4.5.3.jar**)and click **Open**. - :: - 12. Click **Detect the module install status**. - :: - 13. Click **OK**. The JDBC that you selected is displayed in the **Driver** field. 14. Click **Select class name**. - :: - 15. Click **Test connection**. If a driver class is not found (for example, you didn't select a JDBC jar file), the following error message is displayed: @@ -85,19 +69,16 @@ Creating a New Metadata JDBC DB Connection After creating a new metadata JDBC DB connection, you can do the following: * Use your new metadata connection. - - :: * Drag it to the **job** screen. - - :: * Build Talend components. For more information on loading data from JSON files to the Talend Open Studio, see `How to Load Data from JSON Files in Talend <https://www.youtube.com/watch?v=qNt9CYZFFqQ&list=PLOr008ImHvfan_fuDr5RVyexpeYJAp9FX&index=6>`_. Supported SQream Drivers ----------------- +------------------------ + The following list shows the supported SQream drivers and versions: * **JDBC** - Version 4.3.3 and higher. @@ -107,7 +88,8 @@ The following list shows the supported SQream drivers and versions: * **ODBC** - Version 4.0.0. This version requires a Bridge to connect. For more information on the required Bridge, see `Connecting Talend on Windows to an ODBC Database <https://www.easysoft.com/blog/talend.html>`_. Supported Data Sources ----------------- +---------------------- + Talend Cloud connectors let you create reusable connections with a wide variety of systems and environments, such as those shown below. This lets you access and read records of a range of diverse data. * **Connections:** Connections are environments or systems for storing datasets, including databases, file systems, distributed systems and platforms. Because these systems are reusable, you only need to establish connectivity with them once. @@ -117,7 +99,6 @@ Talend Cloud connectors let you create reusable connections with a wide variety * **Datasets:** Datasets include database tables, file names, topics (Kafka), queues (JMS) and file paths (HDFS). For more information on the complete list of connectors and datasets that Talend supports, see `Introducing Talend Connectors <https://help.talend.com/r/vqIZei8ynfi_BaDCg3d~_g/M0qzU1kTnL0bPou7OuxJfw>`_. Known Issues ----------------- -As of 6/1/2021 schemas were not displayed for tables with identical names. +------------ If you experience issues using Talend, see the `SQream support portal <https://support.sqream.com>`_. \ No newline at end of file diff --git a/connecting_to_sqream/client_platforms/tibco_spotfire.rst b/connecting_to_sqream/client_platforms/tibco_spotfire.rst index 2d85fecf1..e4d1eec3a 100644 --- a/connecting_to_sqream/client_platforms/tibco_spotfire.rst +++ b/connecting_to_sqream/client_platforms/tibco_spotfire.rst @@ -1,11 +1,13 @@ .. _tibco_spotfire: -************************* -Connecting to SQream Using TIBCO Spotfire -************************* +************** +TIBCO Spotfire +************** + Overview -========= +======== + The **TIBCO Spotfire** software is an analytics solution that enables visualizing and exploring data through dashboards and advanced analytics. This document is a Quick Start Guide that describes the following: @@ -15,7 +17,8 @@ This document is a Quick Start Guide that describes the following: :depth: 1 Establishing a Connection between TIBCO Spotfire and SQream ------------------ +----------------------------------------------------------- + TIBCO Spotfire supports the following versions: * **JDBC driver** - Version 4.5.2 @@ -30,13 +33,15 @@ The **Establishing a JDBC Connection between TIBCO Spotfire and SQream** section :depth: 1 Creating a JDBC Connection -~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~ + For TIBCO Spotfire to recognize SQream, you must add the correct JDBC jar file to Spotfire's loaded binary folder. The following is an example of a path to the Spotfire loaded binaries folder: ``C:\tibco\tss\7.12.0\tomcat\bin``. For the complete TIBCO Spotfire documentation, see `TIBCO Spotfire® JDBC Data Access Connectivity Details <https://community.tibco.com/wiki/tibco-spotfire-jdbc-data-access-connectivity-details>`_. Creating an ODBC Connection -~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + **To create an ODBC connection** 1. Install and configure ODBC on Windows. @@ -45,8 +50,6 @@ Creating an ODBC Connection #. Launch the TIBCO Spotfire application. - :: - #. From the **File** menu click **Add Data Tables**. The **Add Database Tables** window is displayed. @@ -61,20 +64,14 @@ Creating an ODBC Connection #. Select **System or user data source** and from the drop-down menu select the DSN of your data source (SQreamDB). - :: - #. Provide your database username and password and click **OK**. - :: - #. In the **Open Database** window, click **OK**. The **Specify Tables and Columns** window is displayed. #. In the **Specify Tables and Columns** window, select the checkboxes corresponding to the tables and columns that you want to include in your SQL statement. - :: - #. In the **Data source name** field, set your data source name and click **OK**. Your data source is displayed in the **Data tables** area. @@ -84,7 +81,8 @@ Creating an ODBC Connection .. note:: Verify that you have checked the SQL statement. Creating the SQream Data Source Template -~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + After creating a connection, you can create your SQream data source template. **To create your SQream data source template:** @@ -102,13 +100,9 @@ After creating a connection, you can create your SQream data source template. * Override an existing template: 1. In the template text field, select an existing template. - - :: 2. Copy and paste your data source template text. - :: - * Create a new template: 1. Click **New**. @@ -118,8 +112,6 @@ After creating a connection, you can create your SQream data source template. .. _creating_sqream_data_source_template: 2. In the **Name** field, define your template name. - - :: 3. In the **Data Source Template** text field, copy and paste your data source template text. @@ -141,7 +133,7 @@ After creating a connection, you can create your SQream data source template. <to>Integer</to> </type-mapping> <type-mapping> - <from>VARCHAR(2048)</from> + <from>TEXT(2048)</from> <to>String</to> </type-mapping> <type-mapping> @@ -177,55 +169,41 @@ After creating a connection, you can create your SQream data source template. </jdbc-type-settings> 4. Click **Save configuration**. - - :: 5. Close and restart your Spotfire server. Creating a Data Source -~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~ + After creating the SQream data source template, you can create a data source. **To create a data source:** 1. Launch the TIBCO Spotfire application. - :: - #. From the **Tools** menu, select **Information Designer**. The **Information Designer** window is displayed. - - :: #. From the **New** menu, click **Data Source**. The **Data Source** tab is displayed. - - :: #. Provide the following information: * **Name** - define a unique name. - - :: * **Type** - use the same type template name you used while configuring your template. See **Step 3** in :ref:`Creating the SQream Data Source Template<creating_sqream_data_source_template>`. - - :: * **Connection URL** - use the standard JDBC connection string, ``<ip>:<port>/database``. - - :: * **No. of connections** - define a number between **1** and **100**. SQream recommends setting your number of connections to **100**. - - :: * **Username and Password** - define your SQream username and password. Creating an Information Link -~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + After creating a data source, you can create an information link. **To create an information link**: @@ -234,8 +212,6 @@ After creating a data source, you can create an information link. The **Information Designer** window is displayed. - :: - #. From the **New** menu, click **Information Link**. The **Information link** tab is displayed. @@ -247,8 +223,6 @@ After creating a data source, you can create an information link. Note the following: * You can select procedures from the Elements region. - - :: * You can remove an element by selecting an element and clicking **Remove**. @@ -258,13 +232,9 @@ After creating a data source, you can create an information link. 5. *Optional* - In the **Description** region, type the description of the information link. - :: - #. *Optional* - To filter your data, expand the **Filters** section and do the following: 1. From the **Information Link** region, select the element you added in Step 3 above. - - :: 2. Click **Add**. @@ -275,8 +245,6 @@ After creating a data source, you can create an information link. The selected column is added to the Filters list. 4. Repeat steps 2 and 3 to add filters to additional columns. - - :: 5. For each column, from the **Filter Type** drop-down list, select **range** or **values**. @@ -301,8 +269,6 @@ After creating a data source, you can create an information link. The selected column is added to the Prompts list. #. Repeat **Step 1** to add prompts to additional columns. - - :: #. Do the following for each column: @@ -322,29 +288,18 @@ After creating a data source, you can create an information link. 9. *Optional* - Expand the **Parameters** section and define your parameters. - :: - 10. *Optional* - Expand the **Properties** section and define your properties. - :: - 11. *Optional* - Expand the **Caching** section and enable or disable whether your information link can be cached. - :: - 12. Click **Save**. The **Save As** window is displayed. 13. In the tree, select where you want to save the information link. - :: - 14. In the **Name** field, type a name and description for the information link. - :: - - 15. Click **Save**. The new information link is added to the library and can be accessed by other users. @@ -354,7 +309,8 @@ After creating a data source, you can create an information link. For more information on the Information Link attributes, see `Information Link Tab <https://docs.tibco.com/pub/spotfire/7.0.1/doc/html/id/id_information_link_tab.htm>`_. Troubleshooting -------------- +--------------- + The **Troubleshooting** section describes the following scenarios: .. contents:: @@ -362,7 +318,8 @@ The **Troubleshooting** section describes the following scenarios: :depth: 1 The JDBC Driver does not Support Boolean, Decimal, or Numeric Types -~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + When attempting to load data, the the Boolean, Decimal, or Numeric column types are not supported and generate the following error: .. code-block:: console @@ -381,7 +338,8 @@ For more information, see the following: * **Supported data types** - :ref:`Data Types<supported_data_types>`. Information Services do not Support Live Queries -~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + TIBCO Spotfire data connectors support live queries, but no APIs currently exist for creating custom data connectors. This is resolved by creating a customized SQream adapter using TIBCO's **Data Virtualization (TDV)** or the **Spotfire Advanced Services (ADS)**. These can be used from the built-in TDV connector to enable live queries. -This resolution applies to JDBC and ODBC drivers. \ No newline at end of file +This resolution applies to JDBC and ODBC drivers. From a52616596a8d6f34e6fa9c235f9d0dd140370e47 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 20 Jun 2024 10:54:11 +0300 Subject: [PATCH 853/882] Update index.rst --- connecting_to_sqream/client_platforms/index.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/connecting_to_sqream/client_platforms/index.rst b/connecting_to_sqream/client_platforms/index.rst index d1a336e86..d3dd43e7d 100644 --- a/connecting_to_sqream/client_platforms/index.rst +++ b/connecting_to_sqream/client_platforms/index.rst @@ -1,15 +1,15 @@ .. _client_platforms: -************************************ +**************** Client Platforms -************************************ +**************** These topics explain how to install and connect a variety of third party tools. Browse the articles below, in the sidebar, or use the search to find the information you need. Overview -========== +======== SQream DB is designed to work with most common database tools and interfaces, allowing you direct access through a variety of drivers, connectors, tools, vizualisers, and utilities. @@ -25,7 +25,7 @@ If you are looking for a tool that is not listed, SQream and our partners can he informatica - microstrategy + micro_strategy pentaho php power_bi @@ -36,7 +36,7 @@ If you are looking for a tool that is not listed, SQream and our partners can he tableau talend tibco_spotfire - xxdiagnosing_common_connectivity_issues + .. image:: /_static/images/connectivity_ecosystem.png From e1f7c5fd471e6f04d52a889bb6929cbdb1da0605 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 20 Jun 2024 10:55:44 +0300 Subject: [PATCH 854/882] Update index.rst --- connecting_to_sqream/client_platforms/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/connecting_to_sqream/client_platforms/index.rst b/connecting_to_sqream/client_platforms/index.rst index d3dd43e7d..ccac24679 100644 --- a/connecting_to_sqream/client_platforms/index.rst +++ b/connecting_to_sqream/client_platforms/index.rst @@ -25,7 +25,7 @@ If you are looking for a tool that is not listed, SQream and our partners can he informatica - micro_strategy + microstrategy pentaho php power_bi From f3effe63f30565aff90f20efa740c89841c7f550 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 20 Jun 2024 11:25:16 +0300 Subject: [PATCH 855/882] Maintenance --- reference/cli/sqream_sql.rst | 2 +- releases/2022.1.1.rst | 13 ++----------- releases/2022.1.2.rst | 13 ++----------- 3 files changed, 5 insertions(+), 23 deletions(-) diff --git a/reference/cli/sqream_sql.rst b/reference/cli/sqream_sql.rst index 132f9679c..e04cfc7d1 100644 --- a/reference/cli/sqream_sql.rst +++ b/reference/cli/sqream_sql.rst @@ -438,7 +438,7 @@ Basic Commands -------------- .. list-table:: - :widths: 20 30 50 + :widths: auto :header-rows: 1 * - Command diff --git a/releases/2022.1.1.rst b/releases/2022.1.1.rst index db64d9b6c..2690139bf 100644 --- a/releases/2022.1.1.rst +++ b/releases/2022.1.1.rst @@ -33,7 +33,8 @@ The 2022.1.1 Release Notes include the following new features: :depth: 1 Password Security Compliance -************ +**************************** + In compliance with GDPR standards, SQream now requires a strong password policy when accessing the CLI or Studio. For more information, see :ref:`Password Policy <access_control_password_policy>`. @@ -95,19 +96,15 @@ Upgrading to v2022.1.1 2. Shut down all SQream services. - :: 3. Extract the recently created back-up file. - :: 4. Replace your current metadata with the metadata you stored in the back-up file. - :: 5. Navigate to the new SQream package bin folder. - :: 6. Run the following command: @@ -117,9 +114,3 @@ Upgrading to v2022.1.1 .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the :ref:`Upgrading SQream Version <installing_sqream_with_binary>` procedure. -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2022.1.1 \ No newline at end of file diff --git a/releases/2022.1.2.rst b/releases/2022.1.2.rst index d19f8aa60..8b65a56e2 100644 --- a/releases/2022.1.2.rst +++ b/releases/2022.1.2.rst @@ -36,7 +36,8 @@ The 2022.1.2 Release Notes include the following new features: :depth: 1 Parquet Read Optimization -************ +************************* + Querying Parquet foreign tables has been optimized and is now up to 20x faster than in previous versions. Resolved Issues @@ -87,19 +88,15 @@ Upgrading to v2022.1.2 2. Shut down all SQream services. - :: 3. Extract the recently created back-up file. - :: 4. Replace your current metadata with the metadata you stored in the back-up file. - :: 5. Navigate to the new SQream package bin folder. - :: 6. Run the following command: @@ -109,9 +106,3 @@ Upgrading to v2022.1.2 .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the :ref:`Upgrading SQream Version <installing_sqream_with_binary>` procedure. -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2022.1.2 \ No newline at end of file From 6fad0327062d8c05c582afde6cb6c69089ef24ca Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 1 Jul 2024 13:55:39 +0300 Subject: [PATCH 856/882] Maintenance --- .../aggregate_functions/count.rst | 26 ++++--- .../aggregate_functions/index.rst | 10 ++- .../aggregate_functions/mode.rst | 76 +++++++++++-------- .../scalar_functions/string/octet_length.rst | 19 +++-- .../user_defined_functions/index.rst | 4 +- .../sql_statements/dml_commands/delete.rst | 43 ++++++----- .../sql_statements/dml_commands/update.rst | 29 ++++--- reference/sql/sql_syntax/joins.rst | 41 ++++++---- .../core_dumping_related_issues.rst | 4 +- 9 files changed, 154 insertions(+), 98 deletions(-) diff --git a/reference/sql/sql_functions/aggregate_functions/count.rst b/reference/sql/sql_functions/aggregate_functions/count.rst index 133d658f4..15e4de46a 100644 --- a/reference/sql/sql_functions/aggregate_functions/count.rst +++ b/reference/sql/sql_functions/aggregate_functions/count.rst @@ -1,13 +1,14 @@ .. _count: -************************** +***** COUNT -************************** +***** The ``COUNT`` function returns the count of numeric values, or only the distinct values. Syntax -========== +====== + The following is the correct syntax for using the ``COUNT`` function as an **aggregate**: .. code-block:: postgres @@ -25,7 +26,8 @@ The following is the correct syntax for using the ``COUNT`` function as a **wind ) Arguments -============ +========= + The following table describes the ``COUNT`` arguments: .. list-table:: @@ -42,12 +44,14 @@ The following table describes the ``COUNT`` arguments: - Specifies that the operation should operate only on unique values Returns -============ +======= + * The ``COUNT`` function returns ``BIGINT``. Notes -======= +===== + The following notes apply to the ``COUNT`` function: * When all rows contain ``NULL`` values, the function returns ``NULL``. @@ -60,7 +64,8 @@ The following notes apply to the ``COUNT`` function: Examples -=========== +======== + The examples in this section are based on a table named ``nba``, structured as follows: .. code-block:: postgres @@ -92,7 +97,8 @@ This section includes the following examples: :depth: 1 Counting Rows in a Table ---------------------------- +------------------------ + This example shows how to count rows in a table: .. code-block:: psql @@ -103,7 +109,8 @@ This example shows how to count rows in a table: 457 Counting Distinct Values in a Table ----------------------------------- +----------------------------------- + This example shows how to count distinct values in a table: The following structures generate the same result: @@ -125,6 +132,7 @@ The following structures generate the same result: Combining COUNT with Other Aggregates ------------------------------------- + This example shows how to combine the ``COUNT`` function with other aggregates: .. code-block:: psql diff --git a/reference/sql/sql_functions/aggregate_functions/index.rst b/reference/sql/sql_functions/aggregate_functions/index.rst index 5d3dfc125..ffd41b538 100644 --- a/reference/sql/sql_functions/aggregate_functions/index.rst +++ b/reference/sql/sql_functions/aggregate_functions/index.rst @@ -1,15 +1,17 @@ .. _aggregate_functions: -******************** +******************* Aggregate Functions -******************** +******************* Overview -=========== +======== + Aggregate functions perform calculations based on a set of values and return a single value. Most aggregate functions ignore null values. Aggregate functions are often used with the ``GROUP BY`` clause of the :ref:`select` statement. Available Aggregate Functions -=============== +============================= + The following list shows the available aggregate functions: .. hlist:: diff --git a/reference/sql/sql_functions/aggregate_functions/mode.rst b/reference/sql/sql_functions/aggregate_functions/mode.rst index a4675b659..b57186a41 100644 --- a/reference/sql/sql_functions/aggregate_functions/mode.rst +++ b/reference/sql/sql_functions/aggregate_functions/mode.rst @@ -1,8 +1,9 @@ .. _mode: -************************** +**** MODE -************************** +**** + The **MODE** function returns the most common value in the selected column. If there are no repeating values, or if there is the same frequency of multiple values, this function returns the top value based on the ``ORDER BY`` clause. The **MODE** function is commonly used with the following functions: @@ -11,7 +12,8 @@ The **MODE** function is commonly used with the following functions: * `PERCENTILE_DISC <https://docs.sqream.com/en/latest/reference/sql/sql_functions/aggregate_functions/percentile_disc.html>`_ function Syntax -======== +====== + The following is the correct syntax for the ``MODE`` function: .. code-block:: postgres @@ -19,38 +21,50 @@ The following is the correct syntax for the ``MODE`` function: MODE() WITHIN GROUP (ORDER BY column) Example -======== +======= + The example in this section is based on the ``players`` table below: .. list-table:: - :widths: 33 33 33 + :widths: auto :header-rows: 1 - -+-----------------+----------+-----------+ -| **Player_Name** | **Team** | **Score** | -+-----------------+----------+-----------+ -| T_Tock | Blue | 13 | -+-----------------+----------+-----------+ -| N_Stein | Blue | 20 | -+-----------------+----------+-----------+ -| F_Dirk | Blue | 20 | -+-----------------+----------+-----------+ -| Y_Hyung | Blue | 10 | -+-----------------+----------+-----------+ -| A_Rodrick | Blue | 13 | -+-----------------+----------+-----------+ -| R_Evans | Red | 55 | -+-----------------+----------+-----------+ -| C_Johnston | Red | 20 | -+-----------------+----------+-----------+ -| K_Stoll | Red | 25 | -+-----------------+----------+-----------+ -| J_Loftus | Red | 22 | -+-----------------+----------+-----------+ -| L_Ellis | Red | 7 | -+-----------------+----------+-----------+ -| G_Elroy | Red | 23 | -+-----------------+----------+-----------+ + + * - Player_Name + - Team + - Score + * - T_Tock + - Blue + - 13 + * - N_Stein + - Blue + - 20 + * - F_Dirk + - Blue + - 20 + * - Y_Hyung + - Blue + - 10 + * - A_Rodrick + - Blue + - 13 + * - R_Evans + - Red + - 55 + * - C_Johnston + - Red + - 20 + * - K_Stoll + - Red + - 25 + * - J_Loftus + - Red + - 22 + * - L_Ellis + - Red + - 7 + * - G_Elroy + - Red + - 23 The following is an example of the ``MODE`` function: diff --git a/reference/sql/sql_functions/scalar_functions/string/octet_length.rst b/reference/sql/sql_functions/scalar_functions/string/octet_length.rst index 0836b4685..061b008c4 100644 --- a/reference/sql/sql_functions/scalar_functions/string/octet_length.rst +++ b/reference/sql/sql_functions/scalar_functions/string/octet_length.rst @@ -1,8 +1,8 @@ .. _octet_length: -************************** +************ OCTET_LENGTH -************************** +************ Calculates the number of bytes in a string. @@ -11,7 +11,8 @@ Calculates the number of bytes in a string. * To get the length in bytes, see :ref:`octet_length`. Syntax -========== +====== + The following is the correct syntax for the ``OCTET_LENGTH`` function: .. code-block:: postgres @@ -19,7 +20,8 @@ The following is the correct syntax for the ``OCTET_LENGTH`` function: OCTET_LEN( text_expr ) --> INT Arguments -============ +========= + The following table describes the ``OCTET_LENGTH`` arguments: .. list-table:: @@ -32,11 +34,13 @@ The following table describes the ``OCTET_LENGTH`` arguments: - ``TEXT`` expression Returns -============ +======= + The ``OCTET_LENGTH`` function returns an integer containing the number of bytes in the string. Notes -======= +===== + The following notes are applicable to the ``OCTET_LENGTH`` function: * To get the length in characters, see :ref:`char_length` @@ -44,7 +48,8 @@ The following notes are applicable to the ``OCTET_LENGTH`` function: * If the value is NULL, the result is NULL. Length in Characters and Bytes of Strings -=========== +========================================= + The **Length in characters and bytes of strings** example is based on the following table and contents: .. code-block:: postgres diff --git a/reference/sql/sql_functions/user_defined_functions/index.rst b/reference/sql/sql_functions/user_defined_functions/index.rst index b3c52022b..af3e5c281 100644 --- a/reference/sql/sql_functions/user_defined_functions/index.rst +++ b/reference/sql/sql_functions/user_defined_functions/index.rst @@ -1,8 +1,8 @@ .. _user_defined_functions_index: -******************** +********************** User-Defined Functions -******************** +********************** The following user-defined functions are functions that can be defined and configured by users. diff --git a/reference/sql/sql_statements/dml_commands/delete.rst b/reference/sql/sql_statements/dml_commands/delete.rst index b561eaf78..94d65ed57 100644 --- a/reference/sql/sql_statements/dml_commands/delete.rst +++ b/reference/sql/sql_statements/dml_commands/delete.rst @@ -1,18 +1,17 @@ .. _delete: -********************** +****** DELETE -********************** +****** Overview -================== +======== + The ``DELETE`` statement is used to remove specific rows from a table. SQream deletes data in the following steps: 1. The designated rows are marked as deleted, but remain on-disk until the user initiates a clean-up process. - - :: #. The user initiates a clean-up process is initiated to delete the rows. @@ -22,8 +21,6 @@ Note the following: * The :ref:`ALTER TABLE<alter_table>` and other `DDL operations <https://docs.sqream.com/en/latest/reference/sql/sql_statements/index.html#data-definition-commands-ddl>`_ are blocked on tables that require clean-up. - - * The value expression for deletion cannot be the result of a sub-query or join. * SQream may abort delete processes exceeding a pre-defined time threshold. If the estimated time exceeds the threshold, an error message is displayed with an description for overriding the threshold and continuing with the delete. @@ -35,7 +32,7 @@ For more information about SQream's delete methodology, see the :ref:`delete_gui * To delete columns, see :ref:`DROP COLUMN<drop_column>`. Permissions -============= +=========== To execute the ``DELETE`` statement, the ``DELETE`` and ``SELECT`` permissions must be assigned to the role at the table level. @@ -43,7 +40,8 @@ For more information about assigning permissions to roles, see `Creating, Assign Syntax -========== +====== + The following is the correct syntax for executing the ``DELETE`` statement: .. code-block:: postgres @@ -81,7 +79,8 @@ For systems with delete parallelism capabilities, use the following syntax to en .. note:: You may configure up to 10 threads. Parameters -============ +========== + The following table describes the parameters used for executing the ``DELETE`` statement: .. list-table:: @@ -101,7 +100,8 @@ The following table describes the parameters used for executing the ``DELETE`` s Examples -=========== +======== + The **Examples** section shows the following examples: * :ref:`Deleting values from a table<deleting_values_from_a_table>` @@ -111,7 +111,8 @@ The **Examples** section shows the following examples: .. _deleting_values_from_a_table: Deleting Values from a Table ------------------------------- +---------------------------- + The following shows an example of deleting values from a table: .. code-block:: psql @@ -140,7 +141,8 @@ The following shows an example of deleting values from a table: .. _deleting_values_based_on_more_complex_predicates: Deleting Values Based on More Complex Predicates ---------------------------------------------------- +------------------------------------------------ + The following shows an example of deleting values based on more complex predicates: .. code-block:: psql @@ -167,7 +169,8 @@ The following shows an example of deleting values based on more complex predicat 4 rows Deleting Values that Contain Multi-Table Conditions ------------------ +--------------------------------------------------- + The following shows an example of deleting values that contain multi-table conditions. The example is based on the following tables: .. image:: /_static/images/delete_optimization.png @@ -190,7 +193,8 @@ The statement below uses the ``EXISTS`` subquery to delete all bands based in Sw .. _identifying_and_cleaning_up_tables: Identifying and Cleaning Up Tables ---------------------------------------- +---------------------------------- + The following section shows examples of each phase required for cleaning up tables: * :ref:`Listing tables that require clean-up<listing_tables_that_require_cleanup>` @@ -200,7 +204,8 @@ The following section shows examples of each phase required for cleaning up tabl .. _listing_tables_that_require_cleanup: Listing Tables that Require Clean-Up -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + The following shows an example of listing tables that require clean-up: .. code-block:: psql @@ -216,7 +221,8 @@ The following shows an example of listing tables that require clean-up: .. _identifying_cleanup_predicates: Identify Clean-Up Predicates -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + The following shows an example of listing the clean-up predicates: .. code-block:: psql @@ -232,7 +238,8 @@ The following shows an example of listing the clean-up predicates: .. _triggering_a_cleanup: Triggering a Clean-Up -^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^ + The following shows an example of triggering a clean-up: .. code-block:: psql diff --git a/reference/sql/sql_statements/dml_commands/update.rst b/reference/sql/sql_statements/dml_commands/update.rst index 3bbeceeef..ad2c149c8 100644 --- a/reference/sql/sql_statements/dml_commands/update.rst +++ b/reference/sql/sql_statements/dml_commands/update.rst @@ -1,8 +1,9 @@ .. _update: -********************** +****** UPDATE -********************** +****** + The **UPDATE** statement page describes the following: .. |icon-new_2022.1| image:: /_static/images/new_2022.1.png @@ -14,7 +15,8 @@ The **UPDATE** statement page describes the following: :depth: 1 Overview -========== +======== + The ``UPDATE`` statement is used to modify the value of certain columns in existing rows without creating a table. It can be used to do the following: @@ -30,7 +32,8 @@ It can be used to do the following: The ``UPDATE`` statement cannot be used to reference other tables in the ``WHERE`` or ``SET`` clauses. Syntax -========== +====== + The following is the correct syntax for the ``UPDATE`` command: .. code-block:: postgres @@ -43,7 +46,8 @@ The following is the correct syntax for the ``UPDATE`` command: Parameters -============ +========== + The following table describes the ``UPDATE`` parameters: .. list-table:: @@ -62,7 +66,7 @@ The following table describes the ``UPDATE`` parameters: - Specifies the condition for updating the data. Examples -=========== +======== The examples section shows how to modify the value of certain columns in existing rows without creating a table. @@ -117,7 +121,7 @@ To be able to follow the examples, create these two tables: :depth: 1 Updating an Entire Table ------------------ +------------------------ Two different ``UPDATE`` methods for updating an entire table. @@ -131,7 +135,8 @@ Two different ``UPDATE`` methods for updating an entire table. Performing Simple Updates ------------------ +------------------------- + The following is an example of performing a simple update: .. code-block:: postgres @@ -139,7 +144,8 @@ The following is an example of performing a simple update: UPDATE countries SET records_sold = records_sold + 1 WHERE name = 'Israel'; Updating Tables that Contain Multi-Table Conditions ------------------ +--------------------------------------------------- + The following shows an example of updating tables that contain multi-table conditions: .. code-block:: postgres @@ -155,6 +161,7 @@ The following shows an example of updating tables that contain multi-table condi Updating Tables that Contain Multi-Table Expressions ---------------------------------------------------- + The following shows an example of updating tables that contain multi-table expressions: .. code-block:: postgres @@ -169,7 +176,7 @@ The following shows an example of updating tables that contain multi-table expre ; Triggering a Cleanup ---------------------- +-------------------- When an ``UPDATE`` statement is executed, it creates a new table that contains the updated data, while the original table remains intact. As a result, residual data may be left behind, and a cleanup operation is necessary to ensure the database remains in a consistent state. @@ -184,6 +191,7 @@ The following is the syntax for triggering a cleanup: Permissions =========== + Executing an ``UPDATE`` statement requires the following permissions: * Both ``UPDATE`` and ``SELECT`` permissions on the target table. @@ -191,4 +199,5 @@ Executing an ``UPDATE`` statement requires the following permissions: Locking and Concurrency ======================= + Executing the ``UPDATE`` statement obtains an exclusive UPDATE lock on the target table, but does not lock the destination tables. \ No newline at end of file diff --git a/reference/sql/sql_syntax/joins.rst b/reference/sql/sql_syntax/joins.rst index b9d04c589..94f61291a 100644 --- a/reference/sql/sql_syntax/joins.rst +++ b/reference/sql/sql_syntax/joins.rst @@ -1,8 +1,8 @@ .. _joins: -*************************** +***** Joins -*************************** +***** The ``JOIN`` clause combines results from two or more table expressions (tables, external tables, views) based on a related column or other condition. Performing a join outputs a new result set. For example, two tables containing one or more columns in common can be joined to match or correlate with rows from another table. @@ -10,7 +10,8 @@ The ``JOIN`` clause combines results from two or more table expressions (tables, Syntax -========== +====== + The following shows the correct syntax for creating a **join**: .. code-block:: postgres @@ -30,7 +31,8 @@ The following shows the correct syntax for creating a **join**: MERGE | LOOP Join Types -------------- +---------- + The **Join Types** section describes the following join types: * :ref:`Inner joins<inner_joins>` @@ -41,7 +43,8 @@ The **Join Types** section describes the following join types: .. _inner_joins: Inner Joins -^^^^^^^^^^^^ +^^^^^^^^^^^ + The following shows the correct syntax for creating an **inner join**: .. code-block:: postgres @@ -70,7 +73,8 @@ For an inner join example, see :ref:`Inner Join Example<inner_join_example>`. .. _left_outer_joins: Left Outer Joins -^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^ + The following shows the correct syntax for creating an **left outer join**: .. code-block:: postgres @@ -85,7 +89,8 @@ For a left inner join example, see :ref:`Left Join Example<left_join_example>`. .. _right_outer_joins: Right Outer Joins -^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^ + The following shows the correct syntax for creating an **right outer join**: .. code-block:: postgres @@ -100,7 +105,8 @@ For a right outer join example, see :ref:`Right Join Example<right_join_example> .. _cross_joins: Cross Joins -^^^^^^^^^^^^^ +^^^^^^^^^^^ + The following shows the correct syntax for creating an **cross join**: .. code-block:: postgres @@ -145,7 +151,7 @@ For a cross join example, see :ref:`Cross Join Example<cross_join_example>`. The ON Condition -------------- +---------------- The ``ON`` condition is a value expression that generates a Boolean output to identify whether rows match. @@ -161,7 +167,8 @@ The ``ON`` clause is optional for ``LEFT`` and ``RIGHT`` joins. However, excludi Join Type Examples -============= +================== + The examples in this section are based on a pair of tables with the following structure and content: .. code-block:: postgres @@ -175,7 +182,8 @@ The examples in this section are based on a pair of tables with the following st .. _inner_join_example: Inner Join Example ------------- +------------------ + The following is an example of an inner join. .. code-block:: psql @@ -193,7 +201,8 @@ Notice in the example above that values with no matching conditions do not appea .. _left_join_example: Left Join Example ------------- +----------------- + The following is an example of a left join: .. code-block:: psql @@ -212,7 +221,8 @@ The following is an example of a left join: .. _right_join_example: Right Join Example ------------- +------------------ + The following is an example of a right join: .. code-block:: psql @@ -232,7 +242,8 @@ The following is an example of a right join: .. _cross_join_example: Cross Join Example -------------- +------------------ + The following is an example of a cross join: .. code-block:: psql @@ -297,7 +308,7 @@ Specifying multiple comma-separated tables is equivalent to a cross join, which 5 | 5 Join Hints -------------- +---------- **Join hints** can be used to override the query compiler and choose a particular join algorithm. The available algorithms are ``LOOP`` (corresponding to non-indexed nested loop join algorithm), and ``MERGE`` (corresponding to sort merge join algorithm). If no algorithm is specified, a loop join is performed by default. diff --git a/troubleshooting/core_dumping_related_issues.rst b/troubleshooting/core_dumping_related_issues.rst index ace7c8787..a4d71b9b0 100644 --- a/troubleshooting/core_dumping_related_issues.rst +++ b/troubleshooting/core_dumping_related_issues.rst @@ -1,8 +1,8 @@ .. _core_dumping_related_issues: -*********************** +*************************** Core Dumping Related Issues -*********************** +*************************** The **Core Dumping Related Issues** page describes the troubleshooting procedure to be followed if all parameters have been configured correctly, but the cores have not been created. From ca2a6658c2bf8e3c7794a03ed948c480b65c0f40 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 1 Jul 2024 14:05:22 +0300 Subject: [PATCH 857/882] Maintenance --- connecting_to_sqream/client_platforms/r.rst | 14 +++++++------- .../client_platforms/tableau.rst | 18 ++++++------------ .../client_platforms/talend.rst | 9 --------- 3 files changed, 13 insertions(+), 28 deletions(-) diff --git a/connecting_to_sqream/client_platforms/r.rst b/connecting_to_sqream/client_platforms/r.rst index d64889c35..074baf5ff 100644 --- a/connecting_to_sqream/client_platforms/r.rst +++ b/connecting_to_sqream/client_platforms/r.rst @@ -1,8 +1,8 @@ .. _r: -***************************** -Connect to SQream Using R -***************************** +** +R +** You can use R to interact with a SQream DB cluster. @@ -12,7 +12,7 @@ This tutorial is a guide that will show you how to connect R to SQream DB. :local: JDBC -========= +==== #. Get the :ref:`SQream DB JDBC driver<java_jdbc>`. @@ -66,7 +66,7 @@ JDBC > close(con) A full example ------------------ +-------------- .. code-block:: rconsole @@ -85,7 +85,7 @@ A full example > close(con) ODBC -========= +==== #. Install the :ref:`SQream DB ODBC driver<odbc>` for your operating system, and create a DSN. @@ -135,7 +135,7 @@ ODBC > close(ch) A full example ------------------ +-------------- .. code-block:: rconsole diff --git a/connecting_to_sqream/client_platforms/tableau.rst b/connecting_to_sqream/client_platforms/tableau.rst index 8161a96ac..7b1efbb39 100644 --- a/connecting_to_sqream/client_platforms/tableau.rst +++ b/connecting_to_sqream/client_platforms/tableau.rst @@ -1,8 +1,8 @@ .. _tableau: -************************* -Connecting to SQream Using Tableau -************************* +******* +Tableau +******* SQream's Tableau connector, based on standard JDBC, enables storing and fast querying large volumes of data. This connector is useful for users who want to integrate and analyze data from various sources within the Tableau platform. With the Tableau connector, users can easily connect to databases and cloud applications and perform high-speed queries on large datasets. Additionally, the connector allows for seamless integration with Tableau, enabling users to visualize their data. @@ -25,7 +25,7 @@ Setting Up JDBC ---------------- #. Download the SQream JDBC Connector :ref:`.jar file <client_drivers>`. -#. Place the JDBC .jar file in the Tableau driver directory. +#. Place the JDBC ``.jar`` file in the Tableau driver directory. Based on your operating system, you may find the Tableau driver directory in one of the following locations: @@ -64,24 +64,18 @@ Installing the Tableau Connector 3. Restart Tableau Desktop or Tableau server. Connecting to SQream ---------------------- +-------------------- #. Start Tableau Desktop. - - :: #. In the **Connect** menu, under the **To a Server** option , click **More**. Additional connection options are displayed. - - :: #. Select **SQream DB by SQream Technologies**. - The connection dialog box is displayed. - - :: + A connection dialog box is displayed. #. In the connection dialog box, fill in the following fields: diff --git a/connecting_to_sqream/client_platforms/talend.rst b/connecting_to_sqream/client_platforms/talend.rst index b439fe87d..d7b3494be 100644 --- a/connecting_to_sqream/client_platforms/talend.rst +++ b/connecting_to_sqream/client_platforms/talend.rst @@ -82,8 +82,6 @@ Supported SQream Drivers The following list shows the supported SQream drivers and versions: * **JDBC** - Version 4.3.3 and higher. - - :: * **ODBC** - Version 4.0.0. This version requires a Bridge to connect. For more information on the required Bridge, see `Connecting Talend on Windows to an ODBC Database <https://www.easysoft.com/blog/talend.html>`_. @@ -94,11 +92,4 @@ Talend Cloud connectors let you create reusable connections with a wide variety * **Connections:** Connections are environments or systems for storing datasets, including databases, file systems, distributed systems and platforms. Because these systems are reusable, you only need to establish connectivity with them once. - :: - * **Datasets:** Datasets include database tables, file names, topics (Kafka), queues (JMS) and file paths (HDFS). For more information on the complete list of connectors and datasets that Talend supports, see `Introducing Talend Connectors <https://help.talend.com/r/vqIZei8ynfi_BaDCg3d~_g/M0qzU1kTnL0bPou7OuxJfw>`_. - -Known Issues ------------- - -If you experience issues using Talend, see the `SQream support portal <https://support.sqream.com>`_. \ No newline at end of file From d68f27d7e669bf57f0173e2bbbb97b9f9a80021d Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 1 Jul 2024 14:29:49 +0300 Subject: [PATCH 858/882] Update sqream_console.rst --- reference/cli/sqream_console.rst | 105 +++++++++++++++---------------- 1 file changed, 51 insertions(+), 54 deletions(-) diff --git a/reference/cli/sqream_console.rst b/reference/cli/sqream_console.rst index 0fda5cfdc..280ab0b14 100644 --- a/reference/cli/sqream_console.rst +++ b/reference/cli/sqream_console.rst @@ -1,22 +1,21 @@ .. _sqream_console_cli_reference: -********************************* -sqream-console -********************************* +**************** +SqreamDB Console +**************** -``sqream-console`` is an interactive shell designed to help manage a dockerized SQream DB installation. +``sqream-console`` is an interactive shell designed to help manage a dockerized SQreamDB installation. The console itself is a dockerized application. -This page serves as a reference for the options and parameters. - -.. contents:: In this topic: +.. contents:: :local: + :depth: 1 Starting the console -====================== +==================== -``sqream-console`` can be found in your SQream DB installation, under the name ``sqream-console``. +``sqream-console`` can be found in your SQreamDB installation, under the name ``sqream-console``. Start the console by executing it from the shell @@ -60,14 +59,14 @@ The console is now waiting for commands. The console is a wrapper around a standard linux shell. It supports commands like ``ls``, ``cp``, etc. -All SQream DB-specific commands start with the keyword ``sqream``. +All SQreamDB-specific commands start with the keyword ``sqream``. Operations and flag reference -=============================== +============================= Commands ------------------------ +-------- .. list-table:: :widths: auto @@ -89,12 +88,12 @@ Commands .. _master_node: Master ------------- +------ The master node contains the :ref:`metadata server<metadata_server_cli_reference>` and the :ref:`load balancer<server_picker_cli_reference>`. Syntax -^^^^^^^^^^ +^^^^^^ .. code-block:: console @@ -114,7 +113,7 @@ Syntax * - ``--stop [ --all ]`` - Stops the master node and all connected :ref:`workers<workers>`. - The ``--all`` modifier instructs the ``--stop`` command to stop all running services related to SQream DB + The ``--all`` modifier instructs the ``--stop`` command to stop all running services related to SQreamDB * - ``--list`` - Shows a list of all active master nodes and their workers * - ``-p <port>`` @@ -123,10 +122,10 @@ Syntax - Sets the port for the metadata server. Defaults to ``3105`` Common usage -^^^^^^^^^^^^^^^ +^^^^^^^^^^^^ Start master node -******************** +***************** .. code-block:: console @@ -135,7 +134,7 @@ Start master node sqream_single_host_master is up and listening on ports: 3105,3108 Start master node on different ports -******************************************* +************************************ .. code-block:: console @@ -144,7 +143,7 @@ Start master node on different ports sqream_single_host_master is up and listening on ports: 4105,4108 Listing active master nodes and workers -*************************************************** +*************************************** .. code-block:: console @@ -153,8 +152,8 @@ Listing active master nodes and workers container name: sqream_single_host_worker_0, container id: c919e8fb78c8 container name: sqream_single_host_master, container id: ea7eef80e038 -Stopping all SQream DB workers and master -********************************************* +Stopping all SQreamDB workers and master +***************************************** .. code-block:: console @@ -168,12 +167,12 @@ Stopping all SQream DB workers and master .. _workers: Workers ------------- +------- -Workers are :ref:`SQream DB daemons<sqreamd_cli_reference>`, that connect to the master node. +Workers are :ref:`SQreamDB daemons<sqreamd_cli_reference>`, that connect to the master node. Syntax -^^^^^^^^^^ +^^^^^^ .. code-block:: console @@ -218,10 +217,10 @@ Start options are specified consecutively, separated by spaces. - For testing only: Starts a worker without connecting to the master node. Common usage -^^^^^^^^^^^^^^^ +^^^^^^^^^^^^ Start 2 workers -******************** +*************** After starting the master node, start workers: @@ -232,7 +231,7 @@ After starting the master node, start workers: started sqream_single_host_worker_1 on port 5001, allocated gpu: 1 Stop a single worker -******************************************* +******************** To stop a single worker, find its name first: @@ -251,7 +250,7 @@ Then, issue a stop command: stopped sqream_single_host_worker_1 Start workers with a different spool size -********************************************** +***************************************** If no spool size is specified, the RAM is equally distributed among workers. Sometimes a system engineer may wish to specify the spool size manually. @@ -263,9 +262,9 @@ This example starts two workers, with a spool size of 50GB per node: sqream-console> sqream worker --start 2 -m 50 Starting multiple workers on non-dedicated GPUs -**************************************************** +*********************************************** -By default, SQream DB workers assign one worker per GPU. However, a system engineer may wish to assign multiple workers per GPU, if the workload permits it. +By default, SQreamDB workers assign one worker per GPU. However, a system engineer may wish to assign multiple workers per GPU, if the workload permits it. This example starts 4 workers on 2 GPUs, with 50GB spool each: @@ -279,7 +278,7 @@ This example starts 4 workers on 2 GPUs, with 50GB spool each: started sqream_single_host_worker_3 on port 5003, allocated gpu: 1 Overriding default configuration files -******************************************* +************************************** It is possible to override default configuration settings by listing a configuration file for every worker. @@ -290,14 +289,12 @@ This example starts 2 workers on the same GPU, with modified configuration files sqream-console> sqream worker --start 2 -g 0 -j /etc/sqream/configfile.json /etc/sqream/configfile2.json Client ------------- +------ The client operation runs :ref:`sqream sql<sqream_sql_cli_reference>` in interactive mode. -.. note:: The dockerized client is useful for testing and experimentation. It is not the recommended method for executing analytic queries. See more about connecting a :ref:`third party tool to SQream DB <third_party_tools>` for data analysis. - Syntax -^^^^^^^^^^ +^^^^^^ .. code-block:: console @@ -325,10 +322,10 @@ Syntax - Specifies the database name for the connection. Defaults to ``master``. Common usage -^^^^^^^^^^^^^^^ +^^^^^^^^^^^^ Start a client -******************** +************** Connect to default ``master`` database through the load balancer: @@ -341,7 +338,7 @@ Connect to default ``master`` database through the load balancer: master=> _ Start a client to a specific worker -************************************** +*********************************** Connect to database ``raviga`` directly to a worker on port 5000: @@ -354,7 +351,7 @@ Connect to database ``raviga`` directly to a worker on port 5000: raviga=> _ Start master node on different ports -******************************************* +************************************ .. code-block:: console @@ -363,7 +360,7 @@ Start master node on different ports sqream_single_host_master is up and listening on ports: 4105,4108 Listing active master nodes and worker nodes -*************************************************** +******************************************** .. code-block:: console @@ -375,14 +372,14 @@ Listing active master nodes and worker nodes .. _start_editor: Editor ------------- +------ -The editor operation runs the web UI for the :ref:`SQream DB Statement Editor<statement_editor>`. +The editor operation runs the web UI for the SQreamDB Statement Editor. The editor can be used to run queries from a browser. Syntax -^^^^^^^^^^ +^^^^^^ .. code-block:: console @@ -402,10 +399,10 @@ Syntax - Specify a different port for the editor. Defaults to ``3000``. Common usage -^^^^^^^^^^^^^^^ +^^^^^^^^^^^^ Start the editor UI -********************** +******************* .. code-block:: console @@ -413,7 +410,7 @@ Start the editor UI access sqream statement editor through Chrome http://192.168.0.100:3000 Stop the editor UI -********************** +****************** .. code-block:: console @@ -421,15 +418,15 @@ Stop the editor UI sqream_editor stopped -Using the console to start SQream DB -============================================ +Using the console to start SQreamDB +=================================== -The console is used to start and stop SQream DB components in a dockerized environment. +The console is used to start and stop SQreamDB components in a dockerized environment. -Starting a SQream DB cluster for the first time -------------------------------------------------------- +Starting a SQreamDB cluster for the first time +---------------------------------------------- -To start a SQream DB cluster, start the master node, followed by workers. +To start a SQreamDB cluster, start the master node, followed by workers. The example below starts 2 workers, running on 2 dedicated GPUs. @@ -446,6 +443,6 @@ The example below starts 2 workers, running on 2 dedicated GPUs. sqream-console> sqream editor --start access sqream statement editor through Chrome http://192.168.0.100:3000 -SQream DB is now listening on port 3108 for any incoming statements. +SQreamDB is now listening on port 3108 for any incoming statements. -A user can also access the web editor (running on port ``3000`` on the SQream DB machine) to connect and run queries. \ No newline at end of file +A user can also access the web editor (running on port ``3000`` on the SQreamDB machine) to connect and run queries. \ No newline at end of file From 28b0366fa9c3c4a8221757164214fea316bbac14 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 1 Jul 2024 14:46:39 +0300 Subject: [PATCH 859/882] Maintenance --- releases/2022.1.2.rst | 2 -- releases/2022.1.3.rst | 49 +++++++++++++++++-------------------------- releases/2022.1.4.rst | 39 +++++++++++++++++----------------- releases/2022.1.5.rst | 14 ------------- releases/2022.1.6.rst | 40 +++++++++++++++-------------------- releases/2022.1.7.rst | 39 +++++++++++++++------------------- releases/4.0.rst | 12 +++-------- releases/4.1.rst | 24 +++++++-------------- releases/4.2.rst | 19 +++-------------- 9 files changed, 85 insertions(+), 153 deletions(-) diff --git a/releases/2022.1.2.rst b/releases/2022.1.2.rst index 8b65a56e2..b45f10af5 100644 --- a/releases/2022.1.2.rst +++ b/releases/2022.1.2.rst @@ -17,8 +17,6 @@ The 2022.1.2 Release Notes describes the following: * Automatic schema identification. - :: - * Optimized queries on external Parquet tables. Storage Version diff --git a/releases/2022.1.3.rst b/releases/2022.1.3.rst index e31c6728f..1c073760b 100644 --- a/releases/2022.1.3.rst +++ b/releases/2022.1.3.rst @@ -1,8 +1,9 @@ .. _2022.1.3: -************************** +********************** Release Notes 2022.1.3 -************************** +********************** + The 2022.1.3 release notes were released on 9/20/2022 and describe the following: .. contents:: @@ -10,21 +11,16 @@ The 2022.1.3 release notes were released on 9/20/2022 and describe the following :depth: 1 Version Content ----------- +--------------- + The 2022.1.3 Release Notes describes the following: * Optimize the delete operation by removing redundant calls. - :: - * Support LIKE condition for filtering metadata. - :: - * Migration tool for converting VARCHAR columns into TEXT columns. - :: - * Support sub-queries in the UPDATE condition. Storage Version @@ -34,7 +30,8 @@ The storage version presently in effect is version 42. Known Issues ---------- +------------ + The following table lists the issues that are known limitations in Version 2022.1.3: +-------------+--------------------------------------------------------------------------------------------+ @@ -45,7 +42,8 @@ The following table lists the issues that are known limitations in Version 2022. Resolved Issues ---------- +--------------- + The following table lists the issues that were resolved in Version 2022.1.3: +-------------+-------------------------------------------------------------------------------------------------+ @@ -69,15 +67,18 @@ The following table lists the issues that were resolved in Version 2022.1.3: Operations and Configuration Changes --------- +------------------------------------ + No configuration changes were made. Naming Changes -------- +-------------- + No relevant naming changes were made. Deprecated Features -------- +------------------- + SQream is declaring end of support of VARCHAR data type, the decision resulted by SQream's effort to enhance its core functionalities and with respect to ever changing echo system requirements. VARCHAR is no longer supported for new customers - effective immediately. @@ -87,11 +88,13 @@ TEXT data type is replacing VARCHAR - SQream will maintain VARCHAR data type sup As part of this release 2022.1.3, SQream provides an automated and secured migration tool to help customers with the conversion phase from VARCHAR to TEXT data type, please address delivery for further information. End of Support -------- +-------------- + No End of Support changes were made. Upgrading to v2022.1.3 -------- +---------------------- + 1. Generate a back-up of the metadata by running the following command: .. code-block:: console @@ -104,20 +107,12 @@ Upgrading to v2022.1.3 2. Shut down all SQream services. - :: - 3. Extract the recently created back-up file. - :: - 4. Replace your current metadata with the metadata you stored in the back-up file. - :: - 5. Navigate to the new SQream package bin folder. - :: - 6. Run the following command: .. code-block:: console @@ -126,9 +121,3 @@ Upgrading to v2022.1.3 .. note:: Upgrading from a major version to another major version requires you to follow the **Upgrade Storage** step. This is described in Step 7 of the `Upgrading SQream Version <../installation_guides/installing_sqream_with_binary.html#upgrading-sqream-version>`_ procedure. -.. toctree:: - :maxdepth: 2 - :glob: - :hidden: - - 2022.1.3 \ No newline at end of file diff --git a/releases/2022.1.4.rst b/releases/2022.1.4.rst index 30a81b231..d4fa19783 100644 --- a/releases/2022.1.4.rst +++ b/releases/2022.1.4.rst @@ -1,8 +1,9 @@ .. _2022.1.4: -************************** +********************** Release Notes 2022.1.4 -************************** +********************** + The 2022.1.4 release notes were released on 10/11/2022 and describe the following: .. contents:: @@ -10,13 +11,12 @@ The 2022.1.4 release notes were released on 10/11/2022 and describe the followin :depth: 1 Version Content ----------- +--------------- + The 2022.1.4 Release Notes describes the following: * Security enhancement - Disable Python UDFs by default. - :: - Storage Version --------------- @@ -24,12 +24,14 @@ Storage Version The storage version presently in effect is version 42. Known Issues ---------- +------------ + No relevant Known Issues. Resolved Issues ---------- +--------------- + The following table lists the issues that were resolved in Version 2022.1.4: +---------------------+------------------------------------------------------------------------------------------------------------------+ @@ -50,15 +52,18 @@ The following table lists the issues that were resolved in Version 2022.1.4: Operations and Configuration Changes --------- +------------------------------------ + No configuration changes were made. Naming Changes -------- +-------------- + No relevant naming changes were made. Deprecated Features -------- +------------------- + SQream is declaring end of support of VARCHAR data type, the decision resulted by SQream's effort to enhance its core functionalities and with respect to ever changing echo system requirements. VARCHAR is no longer supported for new customers - effective from Version 2022.1.3 (September 2022). @@ -67,11 +72,13 @@ TEXT data type is replacing VARCHAR - SQream will maintain VARCHAR data type sup End of Support -------- +-------------- + No End of Support changes were made. Upgrading to v2022.1.4 -------- +---------------------- + 1. Generate a back-up of the metadata by running the following command: .. code-block:: console @@ -84,20 +91,12 @@ Upgrading to v2022.1.4 2. Shut down all SQream services. - :: - 3. Extract the recently created back-up file. - :: - 4. Replace your current metadata with the metadata you stored in the back-up file. - :: - 5. Navigate to the new SQream package bin folder. - :: - 6. Run the following command: .. code-block:: console diff --git a/releases/2022.1.5.rst b/releases/2022.1.5.rst index e6324e9cb..7a26cf30a 100644 --- a/releases/2022.1.5.rst +++ b/releases/2022.1.5.rst @@ -17,16 +17,10 @@ The 2022.1.5 Release Notes include the following new features: * ``keys_evaluate`` utility function enhancement - add problematic chunk ID to the function's output report - :: - * Automatically close database client connections that have been open for 24 hours without any active statements - :: - * ``release_defunct_locks`` utility function enhancement to receive new optional input parameter to specify timeout - for more details see :ref:`Lock Related Issues <lock_related_issues>`. - :: - * Metadata scale up process improvement through RocksDB configuration improvements Storage Version @@ -113,20 +107,12 @@ Upgrading to v2022.1.5 2. Shut down all SQream services. - :: - 3. Extract the recently created back-up file. - :: - 4. Replace your current metadata with the metadata you stored in the back-up file. - :: - 5. Navigate to the new SQream package bin folder. - :: - 6. Run the following command: .. code-block:: console diff --git a/releases/2022.1.6.rst b/releases/2022.1.6.rst index efd0a4ab2..6734ef097 100644 --- a/releases/2022.1.6.rst +++ b/releases/2022.1.6.rst @@ -1,8 +1,9 @@ .. _2022.1.6: -************************** +********************** Release Notes 2022.1.6 -************************** +********************** + The 2022.1.6 release notes were released on 12/11/2022 and describe the following: .. contents:: @@ -10,23 +11,22 @@ The 2022.1.6 release notes were released on 12/11/2022 and describe the followin :depth: 1 New Features ----------- +------------ * :ref:`.Net Driver<net>` now supports .NET version 6 or newer. - :: - Storage Version --------------- The storage version presently in effect is version 42. Known Issues ---------- +------------ + :ref:`Percentile<percentile_disc>` is not supported for Window functions. Version 2022.1.6 resolved Issues ---------- +-------------------------------- +--------------------------------+------------------------------------------------------------------------------------------+ | **SQ No.** | **Description** | @@ -48,21 +48,21 @@ Version 2022.1.6 resolved Issues | SQ-12204 | Possible issue when trying to INSERT Unicode data using .Net client | +--------------------------------+------------------------------------------------------------------------------------------+ - - - Configuration Changes --------- +--------------------- + No configuration changes were made. Naming Changes -------- +-------------- + No relevant naming changes were made. Deprecated Features -------- +------------------- + SQream is declaring end of support of VARCHAR data type, the decision resulted by SQream's effort to enhance its core functionalities and with respect to ever changing echo system requirements. VARCHAR is no longer supported for new customers - effective from Version 2022.1.3 (September 2022). @@ -71,11 +71,13 @@ TEXT data type is replacing VARCHAR and NVARCHAR - SQream will maintain VARCHAR End of Support -------- +-------------- + No End of Support changes were made. Upgrading to v2022.1.6 -------- +---------------------- + 1. Generate a back-up of the metadata by running the following command: .. code-block:: console @@ -88,20 +90,12 @@ Upgrading to v2022.1.6 2. Shut down all SQream services. - :: - 3. Extract the recently created back-up file. - :: - 4. Replace your current metadata with the metadata you stored in the back-up file. - :: - 5. Navigate to the new SQream package bin folder. - :: - 6. Run the following command: .. code-block:: console diff --git a/releases/2022.1.7.rst b/releases/2022.1.7.rst index c5f738eba..a8a61202f 100644 --- a/releases/2022.1.7.rst +++ b/releases/2022.1.7.rst @@ -1,8 +1,9 @@ .. _2022.1.7: -************************** +********************** Release Notes 2022.1.7 -************************** +********************** + The 2022.1.7 release notes were released on 12/15/2022 and describe the following: .. contents:: @@ -10,27 +11,24 @@ The 2022.1.7 release notes were released on 12/15/2022 and describe the followin :depth: 1 New Features ----------- +------------ * Ingesting data from :ref:`JSON<json>` files. - :: - * ZLIB compression performance enhancements. - :: - Storage Version --------------- The storage version presently in effect is version 43. Known Issues ---------- +------------ + :ref:`Percentile<percentile_disc>` is not supported for Window functions. Version 2022.1.7 resolved Issues ---------- +-------------------------------- +------------------+-----------------------------------------------------------------------+ | **SQ No.** | **Description** | @@ -43,15 +41,18 @@ Version 2022.1.7 resolved Issues +------------------+-----------------------------------------------------------------------+ Configuration Changes --------- +--------------------- + No configuration changes were made. Naming Changes -------- +-------------- + No relevant naming changes were made. Deprecated Features -------- +------------------- + SQream is declaring end of support of VARCHAR data type, the decision resulted by SQream's effort to enhance its core functionalities and with respect to ever changing echo system requirements. VARCHAR is no longer supported for new customers - effective from Version 2022.1.3 (September 2022). @@ -60,11 +61,13 @@ TEXT data type is replacing VARCHAR and NVARCHAR - SQream will maintain VARCHAR End of Support -------- +-------------- + No End of Support changes were made. Upgrading to v2022.1.7 -------- +---------------------- + 1. Generate a back-up of the metadata by running the following command: .. code-block:: console @@ -77,20 +80,12 @@ Upgrading to v2022.1.7 2. Shut down all SQream services. - :: - 3. Extract the recently created back-up file. - :: - 4. Replace your current metadata with the metadata you stored in the back-up file. - :: - 5. Navigate to the new SQream package bin folder. - :: - 6. Run the following command: .. code-block:: console diff --git a/releases/4.0.rst b/releases/4.0.rst index 1c499e9ea..f69d01f5e 100644 --- a/releases/4.0.rst +++ b/releases/4.0.rst @@ -17,26 +17,20 @@ New Features * Re-enabling an enhanced version of the :ref:`License Storage Capacity<monitoring_workers_and_services_from_the_dashboard>` feature - :: - * :ref:`Lightweight Directory Access Protocol(LDAP)<ldap>` may be used to authenticate SQream roles - :: - - * :ref:`Physical deletion performance enhancement<delete>` by supporting file systems with parallelism capabilities + * :ref:`Physical deletion performance enhancement<delete_guide>` by supporting file systems with parallelism capabilities Storage Version --------------- The storage version presently in effect is version 45. - + SQream Studio Updates and Improvements -------------------------------------- * When creating a **New Role**, you may now create a group role by selecting **Set as a group role**. - - :: * When editing an **Existing Role**, you are no longer obligated to update the role's password. @@ -46,7 +40,7 @@ Known Issues :ref:`Percentile<percentile_disc>` is not supported for Window functions. Version 4.0 resolved Issues ----------------------------- +--------------------------- +-----------------+---------------------------------------------------------------------------------------+ | **SQ No.** | **Description** | diff --git a/releases/4.1.rst b/releases/4.1.rst index 38df59422..0b88617bb 100644 --- a/releases/4.1.rst +++ b/releases/4.1.rst @@ -1,8 +1,8 @@ .. _4.1: -************************** +***************** Release Notes 4.1 -************************** +***************** SQream is introducing a new version release system that follows the more commonly used Major.Minor.Patch versioning schema. The newly released **4.0 version** is a minor version upgrade and does not require considerable preparation. @@ -16,8 +16,6 @@ New Features ------------ * :ref:`Lightweight Directory Access Protocol (LDAP)<ldap>` management enhancement - - :: * A new brute-force attack protection mechanism locks out user accounts for 15 minutes following 5 consecutive failed login attempts @@ -36,8 +34,6 @@ SQream Studio Updates and Improvements SQream Studio v5.5.4 has been released. - :: - Known Issues ------------ @@ -45,7 +41,7 @@ Known Issues Version 4.1 resolved Issues ------------------------------ +--------------------------- +------------------------+------------------------------------------------------------------------------------------+ | **SQ No.** | **Description** | @@ -98,11 +94,13 @@ The ``VARCHAR`` data type is deprecated to improve the core functionalities of t End of Support ---------------- +-------------- + No End of Support changes were made. Upgrading to v4.1 -------------------- +----------------- + 1. Generate a back-up of the metadata by running the following command: .. code-block:: console @@ -115,20 +113,12 @@ Upgrading to v4.1 2. Shut down all SQream services. - :: - 3. Copy the recently created back-up file. - :: - 4. Replace your current metadata with the metadata you stored in the back-up file. - :: - 5. Navigate to the new SQream package bin folder. - :: - 6. Run the following command: .. code-block:: console diff --git a/releases/4.2.rst b/releases/4.2.rst index 87f266740..203afa04a 100644 --- a/releases/4.2.rst +++ b/releases/4.2.rst @@ -1,8 +1,8 @@ .. _4.2: -************************** +***************** Release Notes 4.2 -************************** +***************** SQream is introducing a new version release system that follows the more commonly used Major.Minor.Patch versioning schema. The newly released **4.0 version** is a minor version upgrade and does not require considerable preparation. @@ -17,8 +17,6 @@ New Features :ref:`Apache Spark<spark>` may now be used for large-scale data processing. - - :: :ref:`Physical deletion<delete_guide>` performance enhancement by supporting file systems with parallelism capabilities @@ -70,8 +68,6 @@ SQream Studio Updates and Improvements SQream Studio v5.5.4 has been released. - :: - Known Issues ------------ @@ -80,9 +76,8 @@ Known Issues * Performance degradation when using ``VARCHAR`` partition key in a :ref:`Window Functions<window_functions>` expression - Version 4.2 Resolved Issues ------------------------------ +--------------------------- +------------------------+------------------------------------------------------------------------------------------+ | **SQ No.** | **Description** | @@ -152,20 +147,12 @@ Upgrading to v4.2 2. Shut down all SQream services. - :: - 3. Copy the recently created back-up file. - :: - 4. Replace your current metadata with the metadata you stored in the back-up file. - :: - 5. Navigate to the new SQream package bin folder. - :: - 6. Run the following command: .. code-block:: console From c6229e482259201ee9924d2792f3c7a66695b2b7 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 1 Jul 2024 15:30:58 +0300 Subject: [PATCH 860/882] sqream_scripting --- reference/sql/sql_syntax/index.rst | 3 +- reference/sql/sql_syntax/sqream_scripting.rst | 125 ++++++++++++++++++ 2 files changed, 127 insertions(+), 1 deletion(-) create mode 100644 reference/sql/sql_syntax/sqream_scripting.rst diff --git a/reference/sql/sql_syntax/index.rst b/reference/sql/sql_syntax/index.rst index 9e0422db4..ee1447468 100644 --- a/reference/sql/sql_syntax/index.rst +++ b/reference/sql/sql_syntax/index.rst @@ -16,4 +16,5 @@ SQream DB supports SQL from the ANSI 92 syntax and describes the following: * :ref:`common_table_expressions` * :ref:`window_functions` * :ref:`subqueries` - * :ref:`null_handling` \ No newline at end of file + * :ref:`null_handling` + * :ref:`sqream_scripting` \ No newline at end of file diff --git a/reference/sql/sql_syntax/sqream_scripting.rst b/reference/sql/sql_syntax/sqream_scripting.rst new file mode 100644 index 000000000..cd1ba7213 --- /dev/null +++ b/reference/sql/sql_syntax/sqream_scripting.rst @@ -0,0 +1,125 @@ +.. _sqream_scripting: + +**************** +SQream Scripting +**************** + +The Java- based SQreamDB scripting enhances your interaction with SQL by providing conventions which allow dynamic generation, management, and automation of SQL code and database operations. + +Syntax +====== + +.. code-block:: postgres + + -- Parallel: + + @@ Parallel $$ ... $$ + + -- Declare: + + @@ Declare <my_parameter> = <value> + + -- SetResults: + + @@ SetResults <result_variable> + + -- SplitQueryByDateTime + + @@ SplitQueryByDateTime instances = <value>, from = <value>, to = <value> + + -- SplitQueryByDate + + @@ SplitQueryByDate instances = <value>, from = <value>, to = <value> + + -- SplitQueryByNumber + + @@ SplitQueryByNumber instances = <value>, from = <value>, to = <value> + + -- ${ ... } + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Parameter + - Description + * - ``Parallel`` + - Runs specified queries in parallel + * - ``Declare`` + - Declares a variable value + * - ``SetResults`` + - Saves specified query results as a variable + * - ``SplitQueryByDateTime`` + - Splits query execution by a predefined number of instances and by specific ``DATETIME`` column values + * - ``SplitQueryByDate`` + - Splits query execution by a predefined number of instances and by specific ``DATE`` column values + * - ``SplitQueryByNumber`` + - Splits query execution by a predefined number of instances and by specific ``NUMERIC`` column values + +Usage Notes +=========== + +.. glossary:: + + **Execution** + Metalanguage scripting is available only through the SQreamDB web interface and cannot be used via the CLI. + +Examples +======== + +``Parallel`` +------------ + +.. code-block:: console + + @@ Parallel + $$ + SELECT * FROM my_table; + SELECT * FROM our_table; + SELECT * FROM that_table; + $$; + +``Declare`` +----------- + +.. code-block:: console + + @@ Declare myVar = 3; + SELECT ${myVar}; + +``SetResults`` +-------------- + +.. code-block:: console + + @@ SetResults tableAverage + SELECT AVG(col1) AS avg_salary FROM my_table; + + SELECT col1 FROM my_table WHERE col1 > ${tableAverage[0].avg_salary}; + + +``SplitQueryByDateTime`` +------------------------ + +.. code-block:: console + + @@ SplitQueryByDateTime instances = 4, from = '2021-01-01 00:00:00', to = '2022-01-01 00:00:00' + SELECT ${from}, ${to}; + + +``SplitQueryByDate`` +-------------------- + +.. code-block:: console + + @@ SplitQueryByDateTime instances = 4, from = '2021-01-01', to = '2022-01-01' + SELECT ${from}, ${to}; + + +``SplitQueryByNumber`` +---------------------- + +.. code-block:: console + + @@ SplitQueryByDateTime instances = 4, from = 0, to = 100 + SELECT ${from}, ${to}; From 6a2eca9062d32e29b0f0a008a9246100264fdffc Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Mon, 1 Jul 2024 16:01:20 +0300 Subject: [PATCH 861/882] Update sqream_scripting.rst --- reference/sql/sql_syntax/sqream_scripting.rst | 19 +++++++++++++++++-- 1 file changed, 17 insertions(+), 2 deletions(-) diff --git a/reference/sql/sql_syntax/sqream_scripting.rst b/reference/sql/sql_syntax/sqream_scripting.rst index cd1ba7213..72a274cee 100644 --- a/reference/sql/sql_syntax/sqream_scripting.rst +++ b/reference/sql/sql_syntax/sqream_scripting.rst @@ -11,13 +11,17 @@ Syntax .. code-block:: postgres + -- Double curly brackets + + {{ … }} + -- Parallel: @@ Parallel $$ ... $$ -- Declare: - @@ Declare <my_parameter> = <value> + @@ Declare '<my_parameter>' = <value> -- SetResults: @@ -43,6 +47,8 @@ Syntax * - Parameter - Description + * - ``{{ … }}`` + - Double brackets can contain JavaScript code to be executed through the Editor * - ``Parallel`` - Runs specified queries in parallel * - ``Declare`` @@ -67,6 +73,15 @@ Usage Notes Examples ======== +Double Curly Brackets +--------------------- + +.. code-block:: console + + {{ + return 1; + }} + ``Parallel`` ------------ @@ -85,7 +100,7 @@ Examples .. code-block:: console @@ Declare myVar = 3; - SELECT ${myVar}; + SELECT '${myVar}'; ``SetResults`` -------------- From b930293459551ea9d5b33f5c7c52e56077466d5c Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 2 Jul 2024 14:10:07 +0300 Subject: [PATCH 862/882] Delete troubleshooting/examining_logs.rst --- troubleshooting/examining_logs.rst | 6 ------ 1 file changed, 6 deletions(-) delete mode 100644 troubleshooting/examining_logs.rst diff --git a/troubleshooting/examining_logs.rst b/troubleshooting/examining_logs.rst deleted file mode 100644 index 9b5a5fb79..000000000 --- a/troubleshooting/examining_logs.rst +++ /dev/null @@ -1,6 +0,0 @@ -.. _examining_logs: - -*********************** -Examining Logs -*********************** -See the :ref:`collecting_logs` section of the :ref:`information_for_support` guide for information about collecting logs for support. \ No newline at end of file From 06e93d7ff24e8ae0cb267646d912a4d1d820e997 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 2 Jul 2024 15:37:02 +0300 Subject: [PATCH 863/882] Delete querying_data.rst --- getting_started/querying_data.rst | 51 ------------------------------- 1 file changed, 51 deletions(-) delete mode 100644 getting_started/querying_data.rst diff --git a/getting_started/querying_data.rst b/getting_started/querying_data.rst deleted file mode 100644 index 7b6b46aed..000000000 --- a/getting_started/querying_data.rst +++ /dev/null @@ -1,51 +0,0 @@ -.. _querying_data: - -**************************** -Querying Data -**************************** -One of the most basic operations when using SQream is querying data. - -To begin familiarizing yourself with querying data, you can create the following table using the ``CREATE TABLE`` statement: - -.. code-block:: postgres - - CREATE TABLE nba - ( - Name text(40), - Team text(40), - Number tinyint, - Position text(2), - Age tinyint, - Height text(4), - Weight real, - College text(40), - Salary float - ); - - -You can down download the above (:download:`nba.csv table </_static/samples/nba.csv>`) if needed, shown below: - -.. csv-table:: nba.csv - :file: nba-t10.csv - :widths: auto - :header-rows: 1 - -The above query gets the following from the table above, limited to showing the first ten results: - -* Name -* Team name -* Age - -.. code-block:: psql - - nba=> SELECT Name, Team, Age FROM nba LIMIT 10; - Avery Bradley,Boston Celtics,25 - Jae Crowder,Boston Celtics,25 - John Holland,Boston Celtics,27 - R.J. Hunter,Boston Celtics,22 - Jonas Jerebko,Boston Celtics,29 - Amir Johnson,Boston Celtics,29 - Jordan Mickey,Boston Celtics,21 - Kelly Olynyk,Boston Celtics,25 - Terry Rozier,Boston Celtics,22 - Marcus Smart,Boston Celtics,22 \ No newline at end of file From 963b5fe8decb79e5250d5205cbd8f9e1f8d96085 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 9 Jul 2024 08:25:02 +0300 Subject: [PATCH 864/882] Catalog permissions --- .../access_control_permissions.rst | 30 ++++--------------- .../access_control_commands/grant.rst | 16 +++------- .../access_control_commands/revoke.rst | 16 +++------- 3 files changed, 14 insertions(+), 48 deletions(-) diff --git a/operational_guides/access_control_permissions.rst b/operational_guides/access_control_permissions.rst index 68a87a724..9eed6c837 100644 --- a/operational_guides/access_control_permissions.rst +++ b/operational_guides/access_control_permissions.rst @@ -87,8 +87,6 @@ The following table describe the required permissions for performing and executi +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``SELECT`` | Select from catalog | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``ALL`` | All catalog permissions | -+----------------------+-------------------------------------------------------------------------------------------------------------------------+ | **Services** | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``USAGE`` | Using a specific service | @@ -159,17 +157,9 @@ GRANT TO <role> [, ...] -- Grant permissions at the catalog level: - GRANT - { - SELECT - | INSERT - | DELETE - | UPDATE } [, ...] - | ALL [PERMISSIONS] - ON - { - CATALOG <catalog_name> [, ...] - } + + GRANT SELECT + ON { CATALOG <catalog_name> [, ...] } TO <role> [, ...] -- Grant function execution permission: @@ -274,17 +264,9 @@ REVOKE FROM <role> [, ...] -- Revoke permissions at the catalog level: - REVOKE - { - SELECT - | INSERT - | DELETE - | UPDATE } [, ...] - | ALL [PERMISSIONS] - ON - { - CATALOG <catalog_name> [, ...] - } + + REVOKE SELECT + ON { CATALOG <catalog_name> [, ...] } FROM <role> [, ...] -- Revoke permissions at the function execution level: diff --git a/reference/sql/sql_statements/access_control_commands/grant.rst b/reference/sql/sql_statements/access_control_commands/grant.rst index 7159ed367..590217743 100644 --- a/reference/sql/sql_statements/access_control_commands/grant.rst +++ b/reference/sql/sql_statements/access_control_commands/grant.rst @@ -75,18 +75,10 @@ Syntax } TO <role> [, ...] - GRANT - { - { SELECT - | INSERT - | DELETE - | UPDATE } [, ...] - | ALL [PERMISSIONS] - } - ON - { - | CATALOG <catalog_name> [, ...] - } + -- Grant permissions at the catalog level: + + GRANT SELECT + ON { CATALOG <catalog_name> [, ...] } TO <role> [, ...] -- Grant execute function permission: diff --git a/reference/sql/sql_statements/access_control_commands/revoke.rst b/reference/sql/sql_statements/access_control_commands/revoke.rst index 8491911e9..067b90818 100644 --- a/reference/sql/sql_statements/access_control_commands/revoke.rst +++ b/reference/sql/sql_statements/access_control_commands/revoke.rst @@ -75,18 +75,10 @@ Syntax } FROM <role> [, ...] - REVOKE - { - { SELECT - | INSERT - | DELETE - | UPDATE } [, ...] - | ALL - } - ON - { - | CATALOG <catalog_name> [, ...] - } + -- Revoke permissions at the catalog level: + + REVOKE SELECT + ON { CATALOG <catalog_name> [, ...] } FROM <role> [, ...] -- Revoke permissions at the column level: From 523dfd91816847d62f36d4db1e1efe61f557a7fb Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 10 Jul 2024 09:56:15 +0300 Subject: [PATCH 865/882] Update hdfs.rst --- external_storage_platforms/hdfs.rst | 178 +++++++++++++--------------- 1 file changed, 82 insertions(+), 96 deletions(-) diff --git a/external_storage_platforms/hdfs.rst b/external_storage_platforms/hdfs.rst index 99bb465ea..bf4e59cc6 100644 --- a/external_storage_platforms/hdfs.rst +++ b/external_storage_platforms/hdfs.rst @@ -1,14 +1,12 @@ .. _hdfs: -.. _back_to_top_hdfs: - HDFS Environment -======================================= +================ .. _configuring_an_hdfs_environment_for_the_user_sqream: Configuring an HDFS Environment for the User **sqream** ----------------------------------------------------------- +------------------------------------------------------- This section describes how to configure an HDFS environment for the user **sqream** and is only relevant for users with an HDFS environment. @@ -18,33 +16,31 @@ This section describes how to configure an HDFS environment for the user **sqrea .. code-block:: console - $ vim /home/sqream/.bash_profile + vim /home/sqream/.bash_profile -.. - Comment: - see below; do we want to be a bit more specific on what changes we're talking about? .. code-block:: console - $ #PATH=$PATH:$HOME/.local/bin:$HOME/bin + #PATH=$PATH:$HOME/.local/bin:$HOME/bin - $ #export PATH + #export PATH - $ # PS1 - $ #MYIP=$(curl -s -XGET "http://ip-api.com/json" | python -c 'import json,sys; jstr=json.load(sys.stdin); print jstr["query"]') - $ #PS1="\[\e[01;32m\]\D{%F %T} \[\e[01;33m\]\u@\[\e[01;36m\]$MYIP \[\e[01;31m\]\w\[\e[37;36m\]\$ \[\e[1;37m\]" + # PS1 + #MYIP=$(curl -s -XGET "http://ip-api.com/json" | python -c 'import json,sys; jstr=json.load(sys.stdin); print jstr["query"]') + #PS1="\[\e[01;32m\]\D{%F %T} \[\e[01;33m\]\u@\[\e[01;36m\]$MYIP \[\e[01;31m\]\w\[\e[37;36m\]\$ \[\e[1;37m\]" - $ SQREAM_HOME=/usr/local/sqream - $ export SQREAM_HOME + SQREAM_HOME=/usr/local/sqream + export SQREAM_HOME - $ export JAVA_HOME=${SQREAM_HOME}/hdfs/jdk - $ export HADOOP_INSTALL=${SQREAM_HOME}/hdfs/hadoop - $ export CLASSPATH=`${HADOOP_INSTALL}/bin/hadoop classpath --glob` - $ export HADOOP_COMMON_LIB_NATIVE_DIR=${HADOOP_INSTALL}/lib/native - $ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${SQREAM_HOME}/lib:$HADOOP_COMMON_LIB_NATIVE_DIR + export JAVA_HOME=${SQREAM_HOME}/hdfs/jdk + export HADOOP_INSTALL=${SQREAM_HOME}/hdfs/hadoop + export CLASSPATH=`${HADOOP_INSTALL}/bin/hadoop classpath --glob` + export HADOOP_COMMON_LIB_NATIVE_DIR=${HADOOP_INSTALL}/lib/native + export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${SQREAM_HOME}/lib:$HADOOP_COMMON_LIB_NATIVE_DIR - $ PATH=$PATH:$HOME/.local/bin:$HOME/bin:${SQREAM_HOME}/bin/:${JAVA_HOME}/bin:$HADOOP_INSTALL/bin - $ export PATH + PATH=$PATH:$HOME/.local/bin:$HOME/bin:${SQREAM_HOME}/bin/:${JAVA_HOME}/bin:$HADOOP_INSTALL/bin + export PATH 2. Verify that the edits have been made: @@ -56,7 +52,7 @@ This section describes how to configure an HDFS environment for the user **sqrea .. code-block:: console - $ hadoop fs -ls hdfs://<hadoop server name or ip>:8020/ + hadoop fs -ls hdfs://<hadoop server name or ip>:8020/ .. Comment: - @@ -76,24 +72,21 @@ This section describes how to configure an HDFS environment for the user **sqrea .. code-block:: console - $ #!/bin/bash + #!/bin/bash - $ SQREAM_HOME=/usr/local/sqream - $ export SQREAM_HOME + SQREAM_HOME=/usr/local/sqream + export SQREAM_HOME - $ export JAVA_HOME=${SQREAM_HOME}/hdfs/jdk - $ export HADOOP_INSTALL=${SQREAM_HOME}/hdfs/hadoop - $ export CLASSPATH=`${HADOOP_INSTALL}/bin/hadoop classpath --glob` - $ export HADOOP_COMMON_LIB_NATIVE_DIR=${HADOOP_INSTALL}/lib/native - $ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${SQREAM_HOME}/lib:$HADOOP_COMMON_LIB_NATIVE_DIR + export JAVA_HOME=${SQREAM_HOME}/hdfs/jdk + export HADOOP_INSTALL=${SQREAM_HOME}/hdfs/hadoop + export CLASSPATH=`${HADOOP_INSTALL}/bin/hadoop classpath --glob` + export HADOOP_COMMON_LIB_NATIVE_DIR=${HADOOP_INSTALL}/lib/native + export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${SQREAM_HOME}/lib:$HADOOP_COMMON_LIB_NATIVE_DIR - $ PATH=$PATH:$HOME/.local/bin:$HOME/bin:${SQREAM_HOME}/bin/:${JAVA_HOME}/bin:$HADOOP_INSTALL/bin - $ export PATH - -:ref:`Back to top <back_to_top_hdfs>` + PATH=$PATH:$HOME/.local/bin:$HOME/bin:${SQREAM_HOME}/bin/:${JAVA_HOME}/bin:$HADOOP_INSTALL/bin + export PATH - .. _authenticate_hadoop_servers_that_require_kerberos: Authenticating Hadoop Servers that Require Kerberos @@ -105,99 +98,94 @@ If your Hadoop server requires Kerberos authentication, do the following: .. code-block:: console - $ kadmin -p root/admin@SQ.COM - $ addprinc sqream@SQ.COM + kadmin -p root/admin@SQ.COM + addprinc sqream@SQ.COM -2. If you do not know yor Kerberos root credentials, connect to the Kerberos server as a root user with ssh and run **kadmin.local**: +2. If you do not know yor Kerberos root credentials, connect to the Kerberos server as a root user with ssh and run: .. code-block:: console - $ kadmin.local + kadmin.local - Running **kadmin.local** does not require a password. + Running ``kadmin.local`` does not require a password. -3. If a password is not required, change your password to **sqream@SQ.COM**. +3. If a password is not required, change your password to ``sqream@SQ.COM``. .. code-block:: console - $ change_password sqream@SQ.COM + change_password sqream@SQ.COM 4. Connect to the hadoop name node using ssh: .. code-block:: console - $ cd /var/run/cloudera-scm-agent/process + cd /var/run/cloudera-scm-agent/process 5. Check the most recently modified content of the directory above: .. code-block:: console - $ ls -lrt + ls -lrt 6. Look for a recently updated folder containing the text **hdfs**. -The following is an example of the correct folder name: + The following is an example of the correct folder name: .. code-block:: console cd <number>-hdfs-<something> - This folder should contain a file named **hdfs.keytab** or another similar .keytab file. + This folder should contain a file named **hdfs.keytab** or a similar ``.keytab`` file. - -.. - Comment: - Does "something" need to be replaced with "file name" - - -7. Copy the .keytab file to user **sqream's** Home directory on the remote machines that you are planning to use Hadoop on. +7. Copy the ``.keytab`` file to user **sqream**'s Home directory on the remote machines that you are planning to use Hadoop on. -8. Copy the following files to the **sqream sqream@server:<sqream folder>/hdfs/hadoop/etc/hadoop:** directory: +8. Copy the following files to the ``sqream sqream@server:<sqream folder>/hdfs/hadoop/etc/hadoop:`` directory: * core-site.xml * hdfs-site.xml -9. Connect to the sqream server and verify that the .keytab file's owner is a user sqream and is granted the correct permissions: +9. Connect to the sqream server and verify that the ``.keytab`` file's owner is a user sqream and is granted the correct permissions: .. code-block:: console - $ sudo chown sqream:sqream /home/sqream/hdfs.keytab - $ sudo chmod 600 /home/sqream/hdfs.keytab + sudo chown sqream:sqream /home/sqream/hdfs.keytab + sudo chmod 600 /home/sqream/hdfs.keytab 10. Log into the sqream server. 11. Log in as the user **sqream**. -12. Navigate to the Home directory and check the name of a Kerberos principal represented by the following .keytab file: +12. Navigate to the Home directory and check the name of a Kerberos principal represented by the following ``.keytab`` file: .. code-block:: console - $ klist -kt hdfs.keytab + klist -kt hdfs.keytab The following is an example of the correct output: .. code-block:: console - $ sqream@Host-121 ~ $ klist -kt hdfs.keytab - $ Keytab name: FILE:hdfs.keytab - $ KVNO Timestamp Principal - $ ---- ------------------- ------------------------------------------------------ - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM - $ 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + sqream@Host-121 ~ $ klist -kt hdfs.keytab + Keytab name: FILE:hdfs.keytab + KVNO Timestamp Principal + ---- ------------------- ------------------------------------------------------ + 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + 5 09/15/2020 18:03:05 HTTP/nn1@SQ.COM + 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM + 5 09/15/2020 18:03:05 hdfs/nn1@SQ.COM 13. Verify that the hdfs service named **hdfs/nn1@SQ.COM** is shown in the generated output above. @@ -205,48 +193,46 @@ The following is an example of the correct folder name: .. code-block:: console - $ kinit -kt hdfs.keytab hdfs/nn1@SQ.COM + kinit -kt hdfs.keytab hdfs/nn1@SQ.COM 15. Check the output: .. code-block:: console - $ klist + klist The following is an example of the correct output: .. code-block:: console - $ Ticket cache: FILE:/tmp/krb5cc_1000 - $ Default principal: sqream@SQ.COM - $ - $ Valid starting Expires Service principal - $ 09/16/2020 13:44:18 09/17/2020 13:44:18 krbtgt/SQ.COM@SQ.COM + Ticket cache: FILE:/tmp/krb5cc_1000 + Default principal: sqream@SQ.COM + + Valid starting Expires Service principal + 09/16/2020 13:44:18 09/17/2020 13:44:18 krbtgt/SQ.COM@SQ.COM 16. List the files located at the defined server name or IP address: .. code-block:: console - $ hadoop fs -ls hdfs://<hadoop server name or ip>:8020/ + hadoop fs -ls hdfs://<hadoop server name or ip>:8020/ 17. Do one of the following: - * If the list below is output, continue with Step 16. + * If the list below is output, continue with the next step. * If the list is not output, verify that your environment has been set up correctly. -If any of the following are empty, verify that you followed :ref:`Step 6 <step_6>` in the **Configuring an HDFS Environment for the User sqream** section above correctly: + If any of the following are empty, verify that you followed :ref:`Step 6 <step_6>` in the **Configuring an HDFS Environment for the User sqream** section above correctly: .. code-block:: console - $ echo $JAVA_HOME - $ echo $SQREAM_HOME - $ echo $CLASSPATH - $ echo $HADOOP_COMMON_LIB_NATIVE_DIR - $ echo $LD_LIBRARY_PATH - $ echo $PATH + echo $JAVA_HOME + echo $SQREAM_HOME + echo $CLASSPATH + echo $HADOOP_COMMON_LIB_NATIVE_DIR + echo $LD_LIBRARY_PATH + echo $PATH 18. Verify that you copied the correct keytab file. 19. Review this procedure to verify that you have followed each step. - -:ref:`Back to top <back_to_top_hdfs>` \ No newline at end of file From e1eeb949b0e85911cfb233b08d5ea4a6e02ee45c Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 10 Jul 2024 13:16:21 +0300 Subject: [PATCH 866/882] Update ingesting_from_databases.rst --- data_ingestion/ingesting_from_databases.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data_ingestion/ingesting_from_databases.rst b/data_ingestion/ingesting_from_databases.rst index cb1e88f4b..06eaf2c6b 100644 --- a/data_ingestion/ingesting_from_databases.rst +++ b/data_ingestion/ingesting_from_databases.rst @@ -1 +1 @@ -.. _ingesting_from_databases: ****************** External Databases ****************** The **SQLoader** is a CLI program that enables you to load data into SQreamDB from other DBMS and DBaaS. **SQLoader** supports Oracle, Postgresql, Teradata, Microsoft SQL Server, and SAP HANA. .. contents:: :local: :depth: 1 Before You Begin ================ It is essential that you have the following: * Java 17 * SQLoader configuration files * SQLoader.jar file Minimum Hardware Requirements ------------------------------ .. list-table:: :widths: auto :header-rows: 1 * - Component - Type * - CPU cores - 16 * - RAM - 32GB .. _sqloader_thread_sizing_guidelines: Sizing Guidelines ------------------ The SQLoader sizing is determined by the number of concurrent tables and threads based on the available CPU cores, limiting it to the number of cores minus one, with the remaining core reserved for the operating system. Each SQLoader instance runs on a single table, meaning concurrent imports of multiple tables require multiple instances. Additionally, when dealing with partitioned tables, each partition consumes a thread, so users should consider the table's partition count when managing thread allocation for efficient performance. Getting the SQLoader Configuration and JAR Files ================================================ 1. Download the ``.tar`` file using the following command: .. code-block:: linux curl -O https://sq-ftp-public.s3.amazonaws.com/sqloader-7.8.tar 2. Extract the ``.tar`` file using the following command: .. code-block:: linux tar -xf sqloader-7.8.tar.gz A folder named ``sqloader`` with the following files is created: .. list-table:: SQLoader Files :widths: auto :header-rows: 1 * - File - Description * - ``sqream-mapping.json`` - Maps foreign DBMS and DBaaS data types into SQreamDB data types during ingestion * - ``sqload-jdbc.properties`` - Used for defining a connection string and may also be used to reconfigure data loading * - ``reserved_words.txt`` - A list of reserved words which cannot be used as table and/or column names. * - ``sqloader.jar`` - The SQLoader package file Connection String ================= The ``sqload-jdbc.properties`` file contains a connection string that must be configured to enable data loading into SQreamDB. 1. Open the ``sqload-jdbc.properties`` file. 2. Configure connection parameters for: a. Either Postgresql, Oracle, Teradata, Microsoft SQL Server, SAP HANA or SQreamDB connection strings b. Optionally, Oracle or SQreamDB catalogs (recommended) .. list-table:: Connection String Parameters :widths: auto :header-rows: 1 * - Parameter - Description * - ``HostIp:port`` - The host and IP address number * - ``database_name`` - The name of the database from which data is loaded * - ``user`` - Username of a role to use for connection * - ``password`` - Specifies the password of the selected role * - ``ssl`` - Specifies SSL for this connection .. literalinclude:: connection_string.java :language: java :caption: Properties File Sample :linenos: Loading Data into SQreamDB Tables ================================= 1. Run the ``sqloader.jar`` file using the following CLI command: .. code-block:: console java -jar sqloader.jar 2. You may load the entire data of a source table using the following CLI command: .. code-block:: console java -jar sqloader.jar -table source_table_name 3. You may customize the data load either by using each of the following parameters within a CLI command or by configuring the ``properties`` file: .. list-table:: SQLoader CLI Parameters :widths: auto :header-rows: 1 * - CLI Parameter - State - Default - Type - Description * - ``-batchsize`` - Optional - ``10.000`` - - The number of records to be inserted into SQreamDB at once. Please note that the configured batch size may impact chunk sizes. * - ``-casesensative`` - Optional - ``false`` - - If ``true``, keeps table name uppercase and lowercase characters when table is created in SQreamDB * - ``-check_cdc_chain`` - Optional - ``false`` - - Check CDC chain between tracking table and source table * - ``-chunkSize`` - Optional - ``0`` - - The number of records read at once from the source database * - ``-columnlist`` - Optional - *None* - ``.txt`` - The name of the file that contains all column names. Columns must be separated using ``\n`` * - ``-columns`` - Optional - All columns - - The name or names of columns to be loaded into SQreamDB ("col1,col2, ..."). For column names containing uppercase characters, maintain the uppercase format, avoid using double quotes or apostrophes, and ensure that the ``caseSensitive`` parameter is set to true * - ``-config`` - Optional - ``/home/username/downloads/config/sqload-jdbc.properties`` - - Defines the path to the configuration file you wish to use. This parameter may be defined using only the CLI * - ``-config_dir`` - Optional - ``/home/username/downloads/config`` - - Defines the path to the folder containing both the data type mapping and the reserved words files. The defined folder must contain both files or else you will receive an error. * - ``-count`` - Optional - ``true`` - - Defines whether or not table rows will be counted before being loaded into SQreamDB * - ``-delete`` - Optional - ``true`` - - Defines whether or not loading using Change Data Capture (CDC) includes deleted rows * - ``-drop`` - Optional - ``true`` - - Defines whether or not a new target table in SQreamDB is created. If ``false``, you will need to configure a target table name using the ``-target`` parameter * - ``-fetchsize`` - Optional - ``100000`` - - The number of records to be read at once from source database. * - ``-filter`` - Optional - ``1=1`` - - Defines whether or not only records with SQL conditions are loaded * - ``-h, --help`` - Optional - *No input* - - Displays the help menu and exits * - ``-limit`` - Optional - ``0`` (no limit) - - Limits the number of rows to be loaded * - ``-load_dttm`` - Optional - ``true`` - - Add an additional ``load_dttm`` column that defines the time and date of loading * - ``-lock_check`` - Optional - ``true`` - - Defines whether or not SQLoader will check source table is locked before the loading starts * - ``-lock_table`` - Optional - ``true`` - - Defines whether or not SQLoader will lock target table before the loading starts * - ``-log_dir`` - Optional - ``logs`` - - Defines the path of log directory created when loading data. If no value is specified, a ``logs`` folder is created under the same location as the ``sqloader.jar`` file * - ``-partition`` - Optional - *None* - Partition identifier ``string`` - Specifies the number of table partitions. If configured, ``-partition`` ensures that data is loaded according to the specified partition. You may configure the ``-thread`` parameter for parallel loading of your table partitions. If you do, please ensure that the number of threads does not exceed the number of partitions. * - ``-rowid`` - Optional - ``false`` - - Defines whether or not SQLoader will get row IDs from Oracle tables * - ``-source_db`` - Optional - ``ORCL`` - - Defines the source database name. It does not modify the database connection string but impacts the storage and retrieval of data within catalog tables. * - ``-split`` - Optional - *None* - Column name ``string`` - Column name for split (required for multi-thread loads) * - ``-table`` - Mandatory - *None* - Table name ``string`` - Source table name to load data from * - ``-target`` - Optional - Target table name - Table name ``string`` - Target table name to load data into * - ``-thread`` - Optional - ``1`` - - Number of threads to use for loading. Using multiple threads can significantly improve the loading performance, especially when dealing with columns that have metadata statistics (e.g., min/max values). SQLoader will automatically divide the data into batches based on the specified thread number, allowing for parallel processing. You may use ``-thread`` both for tables that are partitioned and tables that are not. See :ref:`Sizing Guidelines<sqloader_thread_sizing_guidelines>` * - ``-truncate`` - Optional - ``false`` - - Truncate target table before loading * - ``-type`` - Optional - ``full`` - - Defines a loading type that affects the table that is created in SQreamDB. Options are ``full``, ``cdc``, or ``inc``. Please note that ``cdc``, and ``inc`` are supported only for Oracle * - ``-use_dbms_lob`` - Optional - ``true`` - - Defines whether or not SQLoader uses ``dbms_lob_substr`` function for ``CLOB`` and ``BLOB`` data types * - ``-use_partitions`` - Optional - ``true`` - - Defines whether or not SQLoader uses partitions in ``SELECT`` statements Using the ``type`` Parameter ------------------------------ Using the ``type`` parameter you may define a loading type that affects the table that is created in SQreamDB. .. list-table:: :widths: auto :header-rows: 1 * - Loading Type - Parameter Option - Description * - Full Table - ``full`` - The entire data of the source table is loaded into SQreamDB * - Change Data Capture (CDC) - ``cdc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT``, ``UPDATE``, and ``DELETE`` statements. SQLoader recognizes tables by table name and metadata. Supported for Oracle only * - Incremental - ``inc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT`` statement. SQLoader recognizes the table by table name and metadata. Supported for Oracle only Creating Summary Tables ======================== Summary tables are pre-aggregated tables that store summarized or aggregated data, which can help improve query performance and reduce the need for complex calculations during runtime. Summary tables are part of the schema within the database catalog. Creating a Summary Table -------------------------- This summary table uses Oracle syntax. .. code-block:: sql CREATE TABLE public.SQLOAD_SUMMARY ( DB_NAME TEXT(200 BYTE) VISIBLE, SCHEMA_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME_FULL TEXT(200 BYTE) VISIBLE, LOAD_TYPE TEXT(200 BYTE) VISIBLE, UPDATED_DTTM_FROM DATE VISIBLE, UPDATED_DTTM_TO DATE VISIBLE, LAST_VAL_INT NUMBER(22,0) VISIBLE, LAST_VAL_TS DATE VISIBLE, START_TIME TIMESTAMP(6) VISIBLE, FINISH_TIME TIMESTAMP(6) VISIBLE, ELAPSED_SEC NUMBER VISIBLE, ROW_COUNT NUMBER VISIBLE, SQL_FILTER TEXT(200 BYTE) VISIBLE, PARTITION TEXT(200 BYTE) VISIBLE, STMT_TYPE TEXT(200 BYTE) VISIBLE, STATUS TEXT(200 BYTE) VISIBLE, LOG_FILE TEXT(200 BYTE) VISIBLE, DB_URL TEXT(200 BYTE) VISIBLE, PARTITION_COUNT NUMBER VISIBLE DEFAULT 0, THREAD_COUNT NUMBER VISIBLE DEFAULT 1, ELAPSED_MS NUMBER VISIBLE DEFAULT 0, STATUS_CODE NUMBER VISIBLE DEFAULT 0, ELAPSED_SOURCE_MS NUMBER(38,0) DEFAULT NULL, ELAPSED_SOURCE_SEC NUMBER(38,0) DEFAULT NULL, ELAPSED_TARGET_MS NUMBER(38,0) DEFAULT NULL, ELAPSED_TARGET_SEC NUMBER(38,0) DEFAULT NULL, TARGET_DB_URL VARCHAR2(200) DEFAULT NULL, SQLOADER_VERSION VARCHAR2(20) DEFAULT NULL, HOST VARCHAR2(200) DEFAULT NULL ); Creating a Change Data Capture Table -------------------------------------- Change Data Capture (CDC) tables are supported only for Oracle. .. code-block:: sql CREATE TABLE public.CDC_TABLES ( DB_NAME TEXT(200 BYTE) VISIBLE, SCHEMA_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME_FULL TEXT(200 BYTE) VISIBLE, TABLE_NAME_CDC TEXT(200 BYTE) VISIBLE, INC_COLUMN_NAME TEXT(200 BYTE) VISIBLE, INC_COLUMN_TYPE TEXT(200 BYTE) VISIBLE, LOAD_TYPE TEXT(200 BYTE) VISIBLE, FREQ_TYPE TEXT(200 BYTE) VISIBLE, FREQ_INTERVAL NUMBER(22,0) VISIBLE, IS_ACTIVE NUMBER VISIBLE DEFAULT 0, STATUS_LOAD NUMBER VISIBLE DEFAULT 0, INC_GAP_VALUE NUMBER VISIBLE DEFAULT 0 ); CREATE TABLE public.CDC_TRACKING ( DB_NAME TEXT(200 BYTE) VISIBLE, SCHEMA_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME_FULL TEXT(200 BYTE) VISIBLE, LAST_UPDATED_DTTM DATE VISIBLE, LAST_VAL_INT NUMBER(22,0) VISIBLE DEFAULT 0, LAST_VAL_TS TIMESTAMP(6) VISIBLE, LAST_VAL_DT DATE VISIBLE ); CREATE TABLE public.CDC_TABLE_PRIMARY_KEYS ( DB_NAME TEXT(200 BYTE) VISIBLE, SCHEMA_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME_FULL TEXT(200 BYTE) VISIBLE, CONSTRAINT_NAME TEXT(200 BYTE) VISIBLE, COLUMN_NAME TEXT(200 BYTE) VISIBLE, IS_NULLABLE NUMBER VISIBLE DEFAULT 0 ); Data Type Mapping ================= .. contents:: :local: :depth: 1 Automatic Mapping ------------------ The **SQLoader** automatically maps data types used in Oracle, Postgresql, Teradata, Microsoft SQL Server, and SAP HANA tables that are loaded into SQreamDB. Oracle ^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - Oracle Type - SQreamDB Type * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGE`` - ``BIGINT`` * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``VARCHAR2``, ``NVARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``DATE``, ``DATETIME`` - ``DATETIME`` * - ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOLEAN`` - ``BOOL`` * - ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``CLOB`` - ``TEXT`` * - ``BLOB`` - ``TEXT`` * - ``RAW`` - ``TEXT`` Postgresql ^^^^^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - Postgresql Type - SQreamDB Type * - ``CHAR``, ``VARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``TEXT`` - ``TEXT`` * - ``INT``, ``SMALLINT``, ``BIGINT``, ``INT2``, ``INT4``, ``INT8`` - ``BIGINT`` * - ``DATETIME``, ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BIT``, ``BOOL`` - ``BOOL`` * - ``DECIMAL``, ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``REAL``, ``FLOAT4`` - ``REAL`` Teradata ^^^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - Teradata Type - SQreamDB Type * - ``F`` - ``DOUBLE`` * - ``N``, ``D`` - ``NUMERIC`` * - ``CO`` - ``TEXT`` * - ``BO`` - ``TEXT`` * - ``A1``, ``AN``, ``AT``, ``BF``, ``BV``, ``CF``, ``CV``, ``JN``, ``PD``, ``PM``, ``PS``, ``PT``, ``PZ``, ``SZ``, ``TZ`` - ``TEXT`` * - ``I``, ``I4``, ``I(4)`` - ``INT`` * - ``I2``, ``I(2)`` - ``SMALLINT`` * - ``I1``, ``I(1)`` - ``TINYINT`` * - ``DH``, ``DM``, ``DS``, ``DY``, ``HM``, ``HS``, ``HR``, ``I8``, ``MO``, ``MS``, ``MI``, ``SC``, ``YM``, ``YR`` - ``BIGINT`` * - ``TS``, ``DATETIME`` - ``DATETIME`` * - ``DA`` - ``DATE`` * - ``BIT`` - ``BOOL`` * - ``REAL``, ``DOUBLE`` - ``DOUBLE`` Microsoft SQL Server ^^^^^^^^^^^^^^^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - Microsoft SQL Server Type - SQreamDB Type * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``NVARCHAR``, ``NVARCHAR2``, ``CHARACTER``, ``TEXT``, ``NTEXT`` - ``TEXT`` * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INT``, ``TINYINT`` - ``BIGINT`` * - ``DATETIME``, ``TIMESTAMP``, ``SMALLDATETIME``, ``DATETIMEOFFSET``, ``DATETIME2`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BIT`` - ``BOOL`` * - ``DECIMAL``, ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``REAL`` - ``REAL`` * - ``VARBINARY`` - ``TEXT`` SAP HANA ^^^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - SAP HANA Type - SQreamDB Type * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGER``, ``TINYINT`` - ``BIGINT`` * - ``CHAR``, ``VARCHAR``, ``NVARCHAR``, ``TEXT``, ``VARCHAR2``, ``NVARCHAR2`` - ``TEXT`` * - ``DATETIME``, ``TIMESTAMP``, ``SECONDDATE`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOLEAN`` - ``TEXT`` * - ``DECIMAL``, ``SMALLDECIMAL``, ``BIGDECIMAL`` - ``NUMERIC`` * - ``DOUBLE``, ``REAL`` - ``FLOAT`` * - ``TEXT`` - ``TEXT`` * - ``BIGINT`` - ``BIGINT`` * - ``INT`` - ``INT`` * - ``SMALLINT`` - ``SMALLINT`` * - ``TINYINT`` - ``TINYINT`` * - ``DATETIME`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOL`` - ``BOOL`` * - ``NUMERIC`` - ``NUMERIC`` * - ``DOUBLE`` - ``DOUBLE`` * - ``FLOAT`` - ``FLOAT`` * - ``REAL`` - ``REAL`` Manually Adjusting Mapping ---------------------------- You have the possibility to adjust the mapping process according to your specific needs, using any of the following methods. ``names`` Method ^^^^^^^^^^^^^^^^^ To specify that you want to map one or more columns in your table to a specific data type, duplicate the code block which maps to the SQreamDB data type you want and include the ``names`` parameter in your code block. The SQLoader will map the specified columns to the specified SQreamDB data type. After the specified columns are mapped, the SQLoader continue to search for how to convert other data types to the same data type of the specified columns. In this example, ``column1``, ``column2``, and ``column3`` are mapped to ``BIGINT`` and the Oracle data types ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGER`` are also mapped to ``BIGINT``. .. code-block:: json { "oracle": [ { "names": ["column1", "column2", "column3"], "sqream": "bigint", "java": "int", "length": false }, { "type": ["bigint","int","smallint","integer"], "sqream": "bigint", "java": "int", "length": false } } .. code-block:: json { "type": ["char","nchar","varchar","varchar2","nvarchar","nvarchar2","character"], "sqream": "text", "java": "string", "length": true }, { "type": ["date","datetime"], "sqream": "datetime", "java": "datetime", "length": false }, { "type": ["timestamp"], "sqream": "datetime", "java": "timestamp", "length": false }, { "type": ["date"], "sqream": "date", "java": "datetime", "length": false }, { "type": ["boolean"], "sqream": "bool", "java": "boolean", "length": false }, { "type": ["number"], "sqream": "numeric", "java": "bigdecimal", "length": true, "prec": true }, { "type": ["float","double"], "sqream": "double", "java": "double", "length": false }, { "type": ["clob"], "sqream": "text", "java": "clob", "length": false }, { "type": ["blob"], "sqream": "text", "java": "blob", "length": false } ] } CLI Examples ============ Loading data into a CDC table using the ``type`` and ``limit`` parameters: .. code-block:: console java -jar sqloader.jar -table source_table_name -type cdc -limit 100 Loading data into a table using your own configuration file (this will override the default configuration file): .. code-block:: console java -jar sqloader.jar -config path/to/your/config/file Loading data into a table using a custom configuration file: .. code-block:: console java -jar -config MyConfigFile.properties -table source_table_name -type cdc -target target_table_name -drop true -lock_check false Loading data into a table using a the ``filter`` parameter: .. code-block:: console java -jar sqloader.jar -table source_table_name -filter column_name>50 \ No newline at end of file +.. _ingesting_from_databases: ****************** External Databases ****************** The **SQLoader** is a CLI program that enables you to load data into SQreamDB from other DBMS and DBaaS. **SQLoader** supports Oracle, Postgresql, Teradata, Microsoft SQL Server, and SAP HANA. .. contents:: :local: :depth: 1 Before You Begin ================ It is essential that you have the following: * Java 17 * SQLoader configuration files * SQLoader.jar file Minimum Hardware Requirements ------------------------------ .. list-table:: :widths: auto :header-rows: 1 * - Component - Type * - CPU cores - 16 * - RAM - 32GB .. _sqloader_thread_sizing_guidelines: Sizing Guidelines ------------------ The SQLoader sizing is determined by the number of concurrent tables and threads based on the available CPU cores, limiting it to the number of cores minus one, with the remaining core reserved for the operating system. Each SQLoader instance runs on a single table, meaning concurrent imports of multiple tables require multiple instances. Additionally, when dealing with partitioned tables, each partition consumes a thread, so users should consider the table's partition count when managing thread allocation for efficient performance. Getting the SQLoader Configuration and JAR Files ================================================ 1. Download the ``.tar`` file using the following command: .. code-block:: linux curl -O https://sq-ftp-public.s3.amazonaws.com/sqloader-7.8.tar 2. Extract the ``.tar`` file using the following command: .. code-block:: linux tar -xf sqloader-7.8.tar.gz A folder named ``sqloader`` with the following files is created: .. list-table:: SQLoader Files :widths: auto :header-rows: 1 * - File - Description * - ``sqream-mapping.json`` - Maps foreign DBMS and DBaaS data types into SQreamDB data types during ingestion * - ``sqload-jdbc.properties`` - Used for defining a connection string and may also be used to reconfigure data loading * - ``reserved_words.txt`` - A list of reserved words which cannot be used as table and/or column names. * - ``sqloader.jar`` - The SQLoader package file Connection String ================= The ``sqload-jdbc.properties`` file contains a connection string that must be configured to enable data loading into SQreamDB. 1. Open the ``sqload-jdbc.properties`` file. 2. Configure connection parameters for: a. Either Postgresql, Oracle, Teradata, Microsoft SQL Server, SAP HANA or SQreamDB connection strings b. Optionally, Oracle or SQreamDB catalogs (recommended) .. list-table:: Connection String Parameters :widths: auto :header-rows: 1 * - Parameter - Description * - ``HostIp:port`` - The host and IP address number * - ``database_name`` - The name of the database from which data is loaded * - ``user`` - Username of a role to use for connection * - ``password`` - Specifies the password of the selected role * - ``ssl`` - Specifies SSL for this connection .. literalinclude:: connection_string.java :language: java :caption: Properties File Sample :linenos: Loading Data into SQreamDB Tables ================================= 1. Run the ``sqloader.jar`` file using the following CLI command: .. code-block:: console java -jar sqloader.jar 2. You may load the entire data of a source table using the following CLI command: .. code-block:: console java -jar sqloader.jar -table source_table_name 3. You may customize the data load either by using each of the following parameters within a CLI command or by configuring the ``properties`` file: .. list-table:: SQLoader CLI Parameters :widths: auto :header-rows: 1 * - CLI Parameter - State - Default - Type - Description * - ``-batchsize`` - Optional - ``10.000`` - - The number of records to be inserted into SQreamDB at once. Please note that the configured batch size may impact chunk sizes. * - ``-casesensative`` - Optional - ``false`` - - If ``true``, keeps table name uppercase and lowercase characters when table is created in SQreamDB * - ``-check_cdc_chain`` - Optional - ``false`` - - Check CDC chain between tracking table and source table * - ``-chunkSize`` - Optional - ``0`` - - The number of records read at once from the source database * - ``-columnlist`` - Optional - *None* - ``.txt`` - The name of the file that contains all column names. Columns must be separated using ``\n`` * - ``-columns`` - Optional - All columns - - The name or names of columns to be loaded into SQreamDB ("col1,col2, ..."). For column names containing uppercase characters, maintain the uppercase format, avoid using double quotes or apostrophes, and ensure that the ``caseSensitive`` parameter is set to true * - ``-config`` - Optional - ``/home/username/downloads/config/sqload-jdbc.properties`` - - Defines the path to the configuration file you wish to use. This parameter may be defined using only the CLI * - ``-config_dir`` - Optional - ``/home/username/downloads/config`` - - Defines the path to the folder containing both the data type mapping and the reserved words files. The defined folder must contain both files or else you will receive an error. * - ``-count`` - Optional - ``true`` - - Defines whether or not table rows will be counted before being loaded into SQreamDB * - ``-delete`` - Optional - ``true`` - - Defines whether or not loading using Change Data Capture (CDC) includes deleted rows * - ``-drop`` - Optional - ``true`` - - Defines whether or not a new target table in SQreamDB is created. If ``false``, you will need to configure a target table name using the ``-target`` parameter * - ``-fetchsize`` - Optional - ``100000`` - - The number of records to be read at once from source database. * - ``-filter`` - Optional - ``1=1`` - - Defines whether or not only records with SQL conditions are loaded * - ``-h, --help`` - Optional - *No input* - - Displays the help menu and exits * - ``-limit`` - Optional - ``0`` (no limit) - - Limits the number of rows to be loaded * - ``-load_dttm`` - Optional - ``true`` - - Add an additional ``load_dttm`` column that defines the time and date of loading * - ``-lock_check`` - Optional - ``true`` - - Defines whether or not SQLoader will check source table is locked before the loading starts * - ``-lock_table`` - Optional - ``true`` - - Defines whether or not SQLoader will lock target table before the loading starts * - ``-log_dir`` - Optional - ``logs`` - - Defines the path of log directory created when loading data. If no value is specified, a ``logs`` folder is created under the same location as the ``sqloader.jar`` file * - ``-partition`` - Optional - *None* - Partition identifier ``string`` - Specifies the number of table partitions. If configured, ``-partition`` ensures that data is loaded according to the specified partition. You may configure the ``-thread`` parameter for parallel loading of your table partitions. If you do, please ensure that the number of threads does not exceed the number of partitions. * - ``-rowid`` - Optional - ``false`` - - Defines whether or not SQLoader will get row IDs from Oracle tables * - ``-source_db`` - Optional - ``ORCL`` - - Defines the source database name. It does not modify the database connection string but impacts the storage and retrieval of data within catalog tables. * - ``-split`` - Optional - *None* - Column name ``string`` - Column name for split (required for multi-thread loads) * - ``-table`` - Mandatory - *None* - Table name ``string`` - Source table name to load data from * - ``-target`` - Optional - Target table name - Table name ``string`` - Target table name to load data into * - ``-thread`` - Optional - ``1`` - - Number of threads to use for loading. Using multiple threads can significantly improve the loading performance, especially when dealing with columns that have metadata statistics (e.g., min/max values). SQLoader will automatically divide the data into batches based on the specified thread number, allowing for parallel processing. You may use ``-thread`` both for tables that are partitioned and tables that are not. See :ref:`Sizing Guidelines<sqloader_thread_sizing_guidelines>` * - ``-truncate`` - Optional - ``false`` - - Truncate target table before loading * - ``-type`` - Optional - ``full`` - - Defines a loading type that affects the table that is created in SQreamDB. Options are ``full``, ``cdc``, or ``inc``. Please note that ``cdc``, and ``inc`` are supported only for Oracle * - ``-use_dbms_lob`` - Optional - ``true`` - - Defines whether or not SQLoader uses ``dbms_lob_substr`` function for ``CLOB`` and ``BLOB`` data types * - ``-use_partitions`` - Optional - ``true`` - - Defines whether or not SQLoader uses partitions in ``SELECT`` statements Using the ``type`` Parameter ------------------------------ Using the ``type`` parameter you may define a loading type that affects the table that is created in SQreamDB. .. list-table:: :widths: auto :header-rows: 1 * - Loading Type - Parameter Option - Description * - Full Table - ``full`` - The entire data of the source table is loaded into SQreamDB * - Change Data Capture (CDC) - ``cdc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT``, ``UPDATE``, and ``DELETE`` statements. SQLoader recognizes tables by table name and metadata. Supported for Oracle only * - Incremental - ``inc`` - Only changes made to the source table data since last load will be loaded into SQreamDB. Changes include transactions of ``INSERT`` statement. SQLoader recognizes the table by table name and metadata. Supported for Oracle only Creating Summary Tables ======================== Summary tables are pre-aggregated tables that store summarized or aggregated data, which can help improve query performance and reduce the need for complex calculations during runtime. Summary tables are part of the schema within the database catalog. Creating a Summary Table -------------------------- This summary table uses Oracle syntax. .. code-block:: sql CREATE TABLE public.SQLOAD_SUMMARY ( DB_NAME TEXT(200 BYTE) VISIBLE, SCHEMA_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME_FULL TEXT(200 BYTE) VISIBLE, LOAD_TYPE TEXT(200 BYTE) VISIBLE, UPDATED_DTTM_FROM DATE VISIBLE, UPDATED_DTTM_TO DATE VISIBLE, LAST_VAL_INT NUMBER(22,0) VISIBLE, LAST_VAL_TS DATE VISIBLE, START_TIME TIMESTAMP(6) VISIBLE, FINISH_TIME TIMESTAMP(6) VISIBLE, ELAPSED_SEC NUMBER VISIBLE, ROW_COUNT NUMBER VISIBLE, SQL_FILTER TEXT(200 BYTE) VISIBLE, PARTITION TEXT(200 BYTE) VISIBLE, STMT_TYPE TEXT(200 BYTE) VISIBLE, STATUS TEXT(200 BYTE) VISIBLE, LOG_FILE TEXT(200 BYTE) VISIBLE, DB_URL TEXT(200 BYTE) VISIBLE, PARTITION_COUNT NUMBER VISIBLE DEFAULT 0, THREAD_COUNT NUMBER VISIBLE DEFAULT 1, ELAPSED_MS NUMBER VISIBLE DEFAULT 0, STATUS_CODE NUMBER VISIBLE DEFAULT 0, ELAPSED_SOURCE_MS NUMBER(38,0) DEFAULT NULL, ELAPSED_SOURCE_SEC NUMBER(38,0) DEFAULT NULL, ELAPSED_TARGET_MS NUMBER(38,0) DEFAULT NULL, ELAPSED_TARGET_SEC NUMBER(38,0) DEFAULT NULL, TARGET_DB_URL VARCHAR2(200) DEFAULT NULL, SQLOADER_VERSION VARCHAR2(20) DEFAULT NULL, HOST VARCHAR2(200) DEFAULT NULL ); Creating a Change Data Capture Table -------------------------------------- Change Data Capture (CDC) tables are supported only for Oracle. .. code-block:: sql CREATE TABLE public.CDC_TABLES ( DB_NAME TEXT(200 BYTE) VISIBLE, SCHEMA_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME_FULL TEXT(200 BYTE) VISIBLE, TABLE_NAME_CDC TEXT(200 BYTE) VISIBLE, INC_COLUMN_NAME TEXT(200 BYTE) VISIBLE, INC_COLUMN_TYPE TEXT(200 BYTE) VISIBLE, LOAD_TYPE TEXT(200 BYTE) VISIBLE, FREQ_TYPE TEXT(200 BYTE) VISIBLE, FREQ_INTERVAL NUMBER(22,0) VISIBLE, IS_ACTIVE NUMBER VISIBLE DEFAULT 0, STATUS_LOAD NUMBER VISIBLE DEFAULT 0, INC_GAP_VALUE NUMBER VISIBLE DEFAULT 0 ); CREATE TABLE public.CDC_TRACKING ( DB_NAME TEXT(200 BYTE) VISIBLE, SCHEMA_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME_FULL TEXT(200 BYTE) VISIBLE, LAST_UPDATED_DTTM DATE VISIBLE, LAST_VAL_INT NUMBER(22,0) VISIBLE DEFAULT 0, LAST_VAL_TS TIMESTAMP(6) VISIBLE, LAST_VAL_DT DATE VISIBLE ); CREATE TABLE public.CDC_TABLE_PRIMARY_KEYS ( DB_NAME TEXT(200 BYTE) VISIBLE, SCHEMA_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME TEXT(200 BYTE) VISIBLE, TABLE_NAME_FULL TEXT(200 BYTE) VISIBLE, CONSTRAINT_NAME TEXT(200 BYTE) VISIBLE, COLUMN_NAME TEXT(200 BYTE) VISIBLE, IS_NULLABLE NUMBER VISIBLE DEFAULT 0 ); Data Type Mapping ================= .. contents:: :local: :depth: 1 Automatic Mapping ------------------ The **SQLoader** automatically maps data types used in Oracle, Postgresql, Teradata, Microsoft SQL Server, and SAP HANA tables that are loaded into SQreamDB. Oracle ^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - Oracle Type - SQreamDB Type * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGE`` - ``BIGINT`` * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``VARCHAR2``, ``NVARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``DATE``, ``DATETIME`` - ``DATETIME`` * - ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOLEAN`` - ``BOOL`` * - ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``CLOB`` - ``TEXT`` * - ``BLOB`` - ``TEXT`` * - ``RAW`` - ``TEXT`` Postgresql ^^^^^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - Postgresql Type - SQreamDB Type * - ``CHAR``, ``VARCHAR``, ``CHARACTER`` - ``TEXT`` * - ``TEXT`` - ``TEXT`` * - ``INT``, ``SMALLINT``, ``BIGINT``, ``INT2``, ``INT4``, ``INT8`` - ``BIGINT`` * - ``DATETIME``, ``TIMESTAMP`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BIT``, ``BOOL`` - ``BOOL`` * - ``DECIMAL``, ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``REAL``, ``FLOAT4`` - ``REAL`` Teradata ^^^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - Teradata Type - SQreamDB Type * - ``F`` - ``DOUBLE`` * - ``N``, ``D`` - ``NUMERIC`` * - ``CO`` - ``TEXT`` * - ``BO`` - ``TEXT`` * - ``A1``, ``AN``, ``AT``, ``BF``, ``BV``, ``CF``, ``CV``, ``JN``, ``PD``, ``PM``, ``PS``, ``PT``, ``PZ``, ``SZ``, ``TZ`` - ``TEXT`` * - ``I``, ``I4``, ``I(4)`` - ``INT`` * - ``I2``, ``I(2)`` - ``SMALLINT`` * - ``I1``, ``I(1)`` - ``TINYINT`` * - ``DH``, ``DM``, ``DS``, ``DY``, ``HM``, ``HS``, ``HR``, ``I8``, ``MO``, ``MS``, ``MI``, ``SC``, ``YM``, ``YR`` - ``BIGINT`` * - ``TS``, ``DATETIME`` - ``DATETIME`` * - ``DA`` - ``DATE`` * - ``BIT`` - ``BOOL`` * - ``REAL``, ``DOUBLE`` - ``DOUBLE`` Microsoft SQL Server ^^^^^^^^^^^^^^^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - Microsoft SQL Server Type - SQreamDB Type * - ``CHAR``, ``NCHAR``, ``VARCHAR``, ``NVARCHAR``, ``NVARCHAR2``, ``CHARACTER``, ``TEXT``, ``NTEXT`` - ``TEXT`` * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INT``, ``TINYINT`` - ``BIGINT`` * - ``DATETIME``, ``TIMESTAMP``, ``SMALLDATETIME``, ``DATETIMEOFFSET``, ``DATETIME2`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BIT`` - ``BOOL`` * - ``DECIMAL``, ``NUMERIC`` - ``NUMERIC`` * - ``FLOAT``, ``DOUBLE`` - ``DOUBLE`` * - ``REAL`` - ``REAL`` * - ``VARBINARY`` - ``TEXT`` SAP HANA ^^^^^^^^^ .. list-table:: :widths: auto :header-rows: 1 * - SAP HANA Type - SQreamDB Type * - ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGER``, ``TINYINT`` - ``BIGINT`` * - ``CHAR``, ``VARCHAR``, ``NVARCHAR``, ``TEXT``, ``VARCHAR2``, ``NVARCHAR2`` - ``TEXT`` * - ``DATETIME``, ``TIMESTAMP``, ``SECONDDATE`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOLEAN`` - ``TEXT`` * - ``DECIMAL``, ``SMALLDECIMAL``, ``BIGDECIMAL`` - ``NUMERIC`` * - ``DOUBLE``, ``REAL`` - ``FLOAT`` * - ``TEXT`` - ``TEXT`` * - ``BIGINT`` - ``BIGINT`` * - ``INT`` - ``INT`` * - ``SMALLINT`` - ``SMALLINT`` * - ``TINYINT`` - ``TINYINT`` * - ``DATETIME`` - ``DATETIME`` * - ``DATE`` - ``DATE`` * - ``BOOL`` - ``BOOL`` * - ``NUMERIC`` - ``NUMERIC`` * - ``DOUBLE`` - ``DOUBLE`` * - ``FLOAT`` - ``FLOAT`` * - ``REAL`` - ``REAL`` Manually Adjusting Mapping ---------------------------- You have the possibility to adjust the mapping process according to your specific needs, using any of the following methods. ``names`` Method ^^^^^^^^^^^^^^^^^ To specify that you want to map one or more columns in your table to a specific data type, duplicate the code block which maps to the SQreamDB data type you want and include the ``names`` parameter in your code block. The SQLoader will map the specified columns to the specified SQreamDB data type. After the specified columns are mapped, the SQLoader continue to search for how to convert other data types to the same data type of the specified columns. In this example, ``column1``, ``column2``, and ``column3`` are mapped to ``BIGINT`` and the Oracle data types ``BIGINT``, ``INT``, ``SMALLINT``, ``INTEGER`` are also mapped to ``BIGINT``. .. code-block:: json { "oracle": [ { "names": ["column1", "column2", "column3"], "sqream": "bigint", "java": "int", "length": false }, { "type": ["bigint","int","smallint","integer"], "sqream": "bigint", "java": "int", "length": false } } CLI Examples ============ Loading data into a CDC table using the ``type`` and ``limit`` parameters: .. code-block:: console java -jar sqloader.jar -table source_table_name -type cdc -limit 100 Loading data into a table using your own configuration file (this will override the default configuration file): .. code-block:: console java -jar sqloader.jar -config path/to/your/config/file Loading data into a table using a custom configuration file: .. code-block:: console java -jar -config MyConfigFile.properties -table source_table_name -type cdc -target target_table_name -drop true -lock_check false Loading data into a table using a the ``filter`` parameter: .. code-block:: console java -jar sqloader.jar -table source_table_name -filter column_name>50 \ No newline at end of file From d6c6cfeb5c57712ce12dc94cd8545d2d85c5d1d7 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 18 Jul 2024 08:39:19 +0300 Subject: [PATCH 867/882] Update logging.rst --- operational_guides/logging.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/operational_guides/logging.rst b/operational_guides/logging.rst index e22a89632..60dff88c0 100644 --- a/operational_guides/logging.rst +++ b/operational_guides/logging.rst @@ -105,7 +105,7 @@ The log is a CSV, with several fields. - ``INFO`` - Statement passed to another worker for execution - - * ``""Reconstruct query before parsing"`` + * ``"Reconstruct query before parsing"`` * ``"SELECT * FROM nba WHERE ""Team"" NOT LIKE ""Portland%%"""`` (statement preparing on node) * - ``4`` - ``INFO`` From 5610a8d906b76fccdf26f2f8f137932e5346b6e3 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Thu, 18 Jul 2024 14:24:36 +0300 Subject: [PATCH 868/882] Allow lower and upper case characters delimiters --- .../sql_statements/dml_commands/copy_from.rst | 2 - .../sql_statements/dml_commands/copy_to.rst | 104 ------------------ 2 files changed, 106 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/copy_from.rst b/reference/sql/sql_statements/dml_commands/copy_from.rst index 020c6baea..cb199c789 100644 --- a/reference/sql/sql_statements/dml_commands/copy_from.rst +++ b/reference/sql/sql_statements/dml_commands/copy_from.rst @@ -356,8 +356,6 @@ The following ASCII field delimiters (octal range 001 - 176) are not supported: | 8 | 56 | 70 | n | 110 | 156 | 13 | 49 | 13 | +---------------+-------------+------------+---------------+-------------+------------+ | | | | 9 | 57 | 71 | o | 111 | 157 | | | | -+---------------+-------------+------------+---------------+-------------+------------+ | | | -| a | 97 | 141 | p | 112 | 160 | | | | +---------------+-------------+------------+---------------+-------------+------------+---------------+-------------+------------+ diff --git a/reference/sql/sql_statements/dml_commands/copy_to.rst b/reference/sql/sql_statements/dml_commands/copy_to.rst index f15b7e36f..42ea5e738 100644 --- a/reference/sql/sql_statements/dml_commands/copy_to.rst +++ b/reference/sql/sql_statements/dml_commands/copy_to.rst @@ -299,112 +299,8 @@ The following table shows the unsupported ASCII field delimiters: +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ | 58 | : | Colon | 72 | 3A | 111010 | &#58; | &colon; | +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 65 | A | Upper Case Letter A | 101 | 41 | 1000001 | &#65; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 66 | B | Upper Case Letter B | 102 | 42 | 1000010 | &#66; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 67 | C | Upper Case Letter C | 103 | 43 | 1000011 | &#67; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 68 | D | Upper Case Letter D | 104 | 44 | 1000100 | &#68; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 69 | E | Upper Case Letter E | 105 | 45 | 1000101 | &#69; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 70 | F | Upper Case Letter F | 106 | 46 | 1000110 | &#70; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 71 | G | Upper Case Letter G | 107 | 47 | 1000111 | &#71; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 72 | H | Upper Case Letter H | 110 | 48 | 1001000 | &#72; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 73 | I | Upper Case Letter I | 111 | 49 | 1001001 | &#73; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 74 | J | Upper Case Letter J | 112 | 4A | 1001010 | &#74; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 75 | K | Upper Case Letter K | 113 | 4B | 1001011 | &#75; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 76 | L | Upper Case Letter L | 114 | 4C | 1001100 | &#76; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 77 | M | Upper Case Letter M | 115 | 4D | 1001101 | &#77; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 78 | N | Upper Case Letter N | 116 | 4E | 1001110 | &#78; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 79 | O | Upper Case Letter O | 117 | 4F | 1001111 | &#79; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 80 | P | Upper Case Letter P | 120 | 50 | 1010000 | &#80; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 81 | Q | Upper Case Letter Q | 121 | 51 | 1010001 | &#81; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 82 | R | Upper Case Letter R | 122 | 52 | 1010010 | &#82; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 83 | S | Upper Case Letter S | 123 | 53 | 1010011 | &#83; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 84 | T | Upper Case Letter T | 124 | 54 | 1010100 | &#84; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 85 | U | Upper Case Letter U | 125 | 55 | 1010101 | &#85; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 86 | V | Upper Case Letter V | 126 | 56 | 1010110 | &#86; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 87 | W | Upper Case Letter W | 127 | 57 | 1010111 | &#87; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 88 | X | Upper Case Letter X | 130 | 58 | 1011000 | &#88; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 89 | Y | Upper Case Letter Y | 131 | 59 | 1011001 | &#89; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 90 | Z | Upper Case Letter Z | 132 | 5A | 1011010 | &#90; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ | 92 | \\ | Backslash | 134 | 5C | 01011100 | \&\#92\; | | +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 97 | a | Lower Case Letter a | 141 | 61 | 1100001 | &#97; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 98 | b | Lower Case Letter b | 142 | 62 | 1100010 | &#98; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 99 | c | Lower Case Letter c | 143 | 63 | 1100011 | &#99; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 100 | d | Lower Case Letter d | 144 | 64 | 1100100 | &#100; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 101 | e | Lower Case Letter e | 145 | 65 | 1100101 | &#101; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 102 | f | Lower Case Letter f | 146 | 66 | 1100110 | &#102; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 103 | g | Lower Case Letter g | 147 | 67 | 1100111 | &#103; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 104 | h | Lower Case Letter h | 150 | 68 | 1101000 | &#104; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 105 | i | Lower Case Letter i | 151 | 69 | 1101001 | &#105; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 106 | j | Lower Case Letter j | 152 | 6A | 1101010 | &#106; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 107 | k | Lower Case Letter k | 153 | 6B | 1101011 | &#107; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 108 | l | Lower Case Letter l | 154 | 6C | 1101100 | &#108; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 109 | m | Lower Case Letter m | 155 | 6D | 1101101 | &#109; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 110 | n | Lower Case Letter n | 156 | 6E | 1101110 | &#110; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 111 | o | Lower Case Letter o | 157 | 6F | 1101111 | &#111; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 112 | p | Lower Case Letter p | 160 | 70 | 1110000 | &#112; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 113 | q | Lower Case Letter q | 161 | 71 | 1110001 | &#113; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 114 | r | Lower Case Letter r | 162 | 72 | 1110010 | &#114; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 115 | s | Lower Case Letter s | 163 | 73 | 1110011 | &#115; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 116 | t | Lower Case Letter t | 164 | 74 | 1110100 | &#116; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 117 | u | Lower Case Letter u | 165 | 75 | 1110101 | &#117; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 118 | v | Lower Case Letter v | 166 | 76 | 1110110 | &#118; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 119 | w | Lower Case Letter w | 167 | 77 | 1110111 | &#119; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 120 | x | Lower Case Letter x | 170 | 78 | 1111000 | &#120; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 121 | y | Lower Case Letter y | 171 | 79 | 1111001 | &#121; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ -| 122 | z | Lower Case Letter z | 172 | 7A | 1111010 | &#122; | | -+-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ Date Format --------------- From f33cd9491c67c3f826414e0ee98a79916f91cf2d Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 23 Jul 2024 13:01:11 +0300 Subject: [PATCH 869/882] Update copy_to.rst --- .../sql_statements/dml_commands/copy_to.rst | 110 +++++++++++++++++- 1 file changed, 109 insertions(+), 1 deletion(-) diff --git a/reference/sql/sql_statements/dml_commands/copy_to.rst b/reference/sql/sql_statements/dml_commands/copy_to.rst index 42ea5e738..c64e4b655 100644 --- a/reference/sql/sql_statements/dml_commands/copy_to.rst +++ b/reference/sql/sql_statements/dml_commands/copy_to.rst @@ -118,7 +118,7 @@ Supported Field Delimiters Printable ASCII Characters ^^^^^^^^^^^^^^^^^^^^^^^^^^ -Any printable ASCII character can be used as a delimiter without special syntax. The default CSV field delimiter is a comma (``,``). +All printable ASCII character (except for ``N``) can be used as a delimiter without special syntax. The default CSV field delimiter is a comma (``,``). The following table shows the supported printable ASCII characters: @@ -181,6 +181,112 @@ The following table shows the supported printable ASCII characters: +---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ | ~ | Tilde | 126 | 176 | 7E | 1111110 | &#126; | &tilde; | +---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 58 | : | Colon | 72 | 3A | 111010 | &#58; | &colon; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 65 | A | A | 101 | 41 | 1000001 | &#65; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 66 | B | B | 102 | 42 | 1000010 | &#66; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 67 | C | C | 103 | 43 | 1000011 | &#67; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 68 | D | D | 104 | 44 | 1000100 | &#68; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 69 | E | E | 105 | 45 | 1000101 | &#69; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 70 | F | F | 106 | 46 | 1000110 | &#70; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 71 | G | G | 107 | 47 | 1000111 | &#71; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 72 | H | H | 110 | 48 | 1001000 | &#72; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 73 | I | I | 111 | 49 | 1001001 | &#73; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 74 | J | J | 112 | 4A | 1001010 | &#74; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 75 | K | K | 113 | 4B | 1001011 | &#75; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 76 | L | L | 114 | 4C | 1001100 | &#76; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 77 | M | M | 115 | 4D | 1001101 | &#77; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 79 | O | O | 117 | 4F | 1001111 | &#79; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 80 | P | P | 120 | 50 | 1010000 | &#80; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 81 | Q | Q | 121 | 51 | 1010001 | &#81; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 82 | R | R | 122 | 52 | 1010010 | &#82; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 83 | S | S | 123 | 53 | 1010011 | &#83; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 84 | T | T | 124 | 54 | 1010100 | &#84; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 85 | U | U | 125 | 55 | 1010101 | &#85; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 86 | V | V | 126 | 56 | 1010110 | &#86; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 87 | W | W | 127 | 57 | 1010111 | &#87; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 88 | X | X | 130 | 58 | 1011000 | &#88; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 89 | Y | Y | 131 | 59 | 1011001 | &#89; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 90 | Z | Z | 132 | 5A | 1011010 | &#90; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 92 | \\ | Backslash | 134 | 5C | 01011100 | \&\#92\; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 97 | a | a | 141 | 61 | 1100001 | &#97; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 98 | b | b | 142 | 62 | 1100010 | &#98; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 99 | c | c | 143 | 63 | 1100011 | &#99; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 100 | d | d | 144 | 64 | 1100100 | &#100; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 101 | e | e | 145 | 65 | 1100101 | &#101; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 102 | f | f | 146 | 66 | 1100110 | &#102; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 103 | g | g | 147 | 67 | 1100111 | &#103; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 104 | h | h | 150 | 68 | 1101000 | &#104; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 105 | i | i | 151 | 69 | 1101001 | &#105; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 106 | j | j | 152 | 6A | 1101010 | &#106; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 107 | k | k | 153 | 6B | 1101011 | &#107; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 108 | l | l | 154 | 6C | 1101100 | &#108; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 109 | m | m | 155 | 6D | 1101101 | &#109; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 110 | n | n | 156 | 6E | 1101110 | &#110; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 111 | o | o | 157 | 6F | 1101111 | &#111; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 112 | p | p | 160 | 70 | 1110000 | &#112; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 113 | q | q | 161 | 71 | 1110001 | &#113; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 114 | r | r | 162 | 72 | 1110010 | &#114; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 115 | s | s | 163 | 73 | 1110011 | &#115; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 116 | t | t | 164 | 74 | 1110100 | &#116; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 117 | u | u | 165 | 75 | 1110101 | &#117; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 118 | v | v | 166 | 76 | 1110110 | &#118; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 119 | w | w | 167 | 77 | 1110111 | &#119; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 120 | x | x | 170 | 78 | 1111000 | &#120; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 121 | y | y | 171 | 79 | 1111001 | &#121; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 122 | z | z | 172 | 7A | 1111010 | &#122; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ Non-Printable ASCII Characters ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -301,6 +407,8 @@ The following table shows the unsupported ASCII field delimiters: +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ | 92 | \\ | Backslash | 134 | 5C | 01011100 | \&\#92\; | | +-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 78 | N | N | 116 | 4E | 1001110 | &#78; | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ Date Format --------------- From 5ac3c7ad513a4450eb461527252be4775c492212 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 23 Jul 2024 13:23:29 +0300 Subject: [PATCH 870/882] Update copy_from.rst --- .../sql_statements/dml_commands/copy_from.rst | 316 ++++++++++++++++-- 1 file changed, 279 insertions(+), 37 deletions(-) diff --git a/reference/sql/sql_statements/dml_commands/copy_from.rst b/reference/sql/sql_statements/dml_commands/copy_from.rst index cb199c789..8838cd123 100644 --- a/reference/sql/sql_statements/dml_commands/copy_from.rst +++ b/reference/sql/sql_statements/dml_commands/copy_from.rst @@ -305,58 +305,300 @@ A multi-character delimiter can be specified. For example, ``DELIMITER '%%'``, ` Printable Characters -------------------- -Any printable ASCII character (or characters) can be used as a delimiter without special syntax. The default CSV field delimiter is a comma (``,``). +All printable ASCII character (except for ``N``) can be used as a delimiter without special syntax. The default CSV field delimiter is a comma (``,``). + + +The following table shows the supported printable ASCII characters: + ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| **Character** | **Description** | **ASCII** | **Octal** | **Hex** | **Binary** | **HTML Code** | **HTML Name** | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| (Space) | Space | 32 | 40 | 20 | 100000 | &#32; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ! | Exclamation Mark | 33 | 41 | 21 | 100001 | &#33; | &excl; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| # | Hash or Number | 35 | 43 | 23 | 100011 | &#35; | &num; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| $ | Dollar Sign | 36 | 44 | 24 | 100100 | &#36; | &dollar; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| % | Percentage | 37 | 45 | 25 | 100101 | &#37; | &percnt; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| & | Ampersand | 38 | 46 | 26 | 100110 | &#38; | &amp; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ( | Left Parenthesis | 40 | 50 | 28 | 101000 | &#40; | &lpar; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ) | Right Parenthesis | 41 | 51 | 29 | 101001 | &#41; | &rpar; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| \*\ | Asterisk | 42 | 52 | 2A | 101010 | &#42; | &ast; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| \+\ | Plus Sign | 43 | 53 | 2B | 101011 | &#43; | &plus; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| , | Comma | 44 | 54 | 2C | 101100 | &#44; | &comma; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| / | Slash | 47 | 57 | 2F | 101111 | &#47; | &sol; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ; | Semicolon | 59 | 73 | 3B | 111011 | &#59; | &semi; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| < | Less Than | 60 | 74 | 3C | 111100 | &#60; | &lt; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| = | Equals Sign | 61 | 75 | 3D | 111101 | &#61; | &equals; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| > | Greater Than | 62 | 76 | 3E | 111110 | &#62; | &gt; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ? | Question Mark | 63 | 77 | 3F | 111111 | &#63; | &quest; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| @ | At Sign | 64 | 100 | 40 | 1000000 | &#64; | &commat; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| [ | Left Square Bracket | 91 | 133 | 5B | 1011011 | &#91; | &lsqb; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| \\ | Backslash | 92 | 134 | 5C | 1011100 | \&\#92\; | &bsol; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ] | Right Square Bracket | 93 | 135 | 5D | 1011101 | &#93; | &rsqb; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ^ | Caret or Circumflex | 94 | 136 | 5E | 1011110 | &#94; | &hat; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| _ | Underscore | 95 | 137 | 5F | 1011111 | &#95; | &lowbar; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ` | Grave Accent | 96 | 140 | 60 | 1100000 | &#96; | &grave; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| { | Left Curly Bracket | 123 | 173 | 7B | 1111011 | &#123; | &lcub; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| \|\ | Vertical Bar | 124 | 174 | 7C | 1111100 | &#124; | &verbar; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| } | Right Curly Bracket | 125 | 175 | 7D | 1111101 | &#125; | &rcub; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ~ | Tilde | 126 | 176 | 7E | 1111110 | &#126; | &tilde; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 58 | : | Colon | 72 | 3A | 111010 | &#58; | &colon; | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 65 | A | A | 101 | 41 | 1000001 | &#65; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 66 | B | B | 102 | 42 | 1000010 | &#66; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 67 | C | C | 103 | 43 | 1000011 | &#67; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 68 | D | D | 104 | 44 | 1000100 | &#68; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 69 | E | E | 105 | 45 | 1000101 | &#69; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 70 | F | F | 106 | 46 | 1000110 | &#70; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 71 | G | G | 107 | 47 | 1000111 | &#71; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 72 | H | H | 110 | 48 | 1001000 | &#72; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 73 | I | I | 111 | 49 | 1001001 | &#73; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 74 | J | J | 112 | 4A | 1001010 | &#74; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 75 | K | K | 113 | 4B | 1001011 | &#75; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 76 | L | L | 114 | 4C | 1001100 | &#76; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 77 | M | M | 115 | 4D | 1001101 | &#77; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 79 | O | O | 117 | 4F | 1001111 | &#79; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 80 | P | P | 120 | 50 | 1010000 | &#80; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 81 | Q | Q | 121 | 51 | 1010001 | &#81; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 82 | R | R | 122 | 52 | 1010010 | &#82; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 83 | S | S | 123 | 53 | 1010011 | &#83; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 84 | T | T | 124 | 54 | 1010100 | &#84; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 85 | U | U | 125 | 55 | 1010101 | &#85; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 86 | V | V | 126 | 56 | 1010110 | &#86; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 87 | W | W | 127 | 57 | 1010111 | &#87; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 88 | X | X | 130 | 58 | 1011000 | &#88; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 89 | Y | Y | 131 | 59 | 1011001 | &#89; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 90 | Z | Z | 132 | 5A | 1011010 | &#90; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 92 | \\ | Backslash | 134 | 5C | 01011100 | \&\#92\; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 97 | a | a | 141 | 61 | 1100001 | &#97; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 98 | b | b | 142 | 62 | 1100010 | &#98; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 99 | c | c | 143 | 63 | 1100011 | &#99; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 100 | d | d | 144 | 64 | 1100100 | &#100; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 101 | e | e | 145 | 65 | 1100101 | &#101; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 102 | f | f | 146 | 66 | 1100110 | &#102; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 103 | g | g | 147 | 67 | 1100111 | &#103; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 104 | h | h | 150 | 68 | 1101000 | &#104; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 105 | i | i | 151 | 69 | 1101001 | &#105; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 106 | j | j | 152 | 6A | 1101010 | &#106; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 107 | k | k | 153 | 6B | 1101011 | &#107; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 108 | l | l | 154 | 6C | 1101100 | &#108; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 109 | m | m | 155 | 6D | 1101101 | &#109; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 110 | n | n | 156 | 6E | 1101110 | &#110; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 111 | o | o | 157 | 6F | 1101111 | &#111; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 112 | p | p | 160 | 70 | 1110000 | &#112; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 113 | q | q | 161 | 71 | 1110001 | &#113; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 114 | r | r | 162 | 72 | 1110010 | &#114; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 115 | s | s | 163 | 73 | 1110011 | &#115; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 116 | t | t | 164 | 74 | 1110100 | &#116; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 117 | u | u | 165 | 75 | 1110101 | &#117; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 118 | v | v | 166 | 76 | 1110110 | &#118; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 119 | w | w | 167 | 77 | 1110111 | &#119; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 120 | x | x | 170 | 78 | 1111000 | &#120; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 121 | y | y | 171 | 79 | 1111001 | &#121; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ +| 122 | z | z | 172 | 7A | 1111010 | &#122; | | ++---------------+----------------------+-----------+-----------+---------+------------+---------------+---------------+ -A printable character is any ASCII character in the range 32 - 126. - -:ref:`Literal quoting rules<string_literals>` apply with delimiters. For example, to use ``'`` as a field delimiter, use ``DELIMITER ''''`` Non-Printable Characters ------------------------ -A non-printable character (1 - 31, 127) can be used in its octal form. - A tab can be specified by escaping it, for example ``\t``. Other non-printable characters can be specified using their octal representations, by using the ``E'\000'`` format, where ``000`` is the octal value of the character. For example, ASCII character ``15``, known as "shift in", can be specified using ``E'\017'``. +The following table shows the supported non-printable ASCII characters: + ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| **Character** | **Description** | **Octal** | **ASCII** | **Hex** | **Binary** | **HTML Code** | **HTML Name** | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| NUL | Null | 0 | 0 | 0 | 0 | &#0; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| SOH | Start of Heading | 1 | 1 | 1 | 1 | &#1; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| STX | Start of Text | 2 | 2 | 2 | 10 | &#2; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ETX | End of Text | 3 | 3 | 3 | 11 | &#3; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| EOT | End of Transmission | 4 | 4 | 4 | 100 | &#4; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ENQ | Enquiry | 5 | 5 | 5 | 101 | &#5; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ACK | Acknowledge | 6 | 6 | 6 | 110 | &#6; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| BEL | Bell | 7 | 7 | 7 | 111 | &#7; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| BS | Backspace | 10 | 8 | 8 | 1000 | &#8; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| HT | Horizontal Tab | 11 | 9 | 9 | 1001 | &#9; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| VT | Vertical Tab | 13 | 11 | 0B | 1011 | &#11; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| FF | NP Form Feed, New Page | 14 | 12 | 0C | 1100 | &#12; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| SO | Shift Out | 16 | 14 | 0E | 1110 | &#14; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| SI | Shift In | 17 | 15 | 0F | 1111 | &#15; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| DLE | Data Link Escape | 20 | 16 | 10 | 10000 | &#16; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| DC1 | Device Control 1 | 21 | 17 | 11 | 10001 | &#17; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| DC2 | Device Control 2 | 22 | 18 | 12 | 10010 | &#18; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| DC3 | Device Control 3 | 23 | 19 | 13 | 10011 | &#19; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| DC4 | Device Control 4 | 24 | 20 | 14 | 10100 | &#20; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| NAK | Negative Acknowledge | 25 | 21 | 15 | 10101 | &#21; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| SYN | Synchronous Idle | 26 | 22 | 16 | 10110 | &#22; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ETB | End of Transmission Block | 27 | 23 | 17 | 10111 | &#23; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| CAN | Cancel | 30 | 24 | 18 | 11000 | &#24; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| EM | End of Medium | 31 | 25 | 19 | 11001 | &#25; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| SUB | Substitute | 32 | 26 | 1A | 11010 | &#26; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| ESC | Escape | 33 | 27 | 1B | 11011 | &#27; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| FS | File Separator | 34 | 28 | 1C | 11100 | &#28; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| GS | Group Separator | 35 | 29 | 1D | 11101 | &#29; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| RS | Record Separator | 36 | 30 | 1E | 11110 | &#30; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| US | Unit Separator | 37 | 31 | 1F | 11111 | &#31; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ +| DEL | Delete | 177 | 127 | 7F | 1111111 | &#127; | | ++---------------+---------------------------+-----------+-----------+---------+------------+---------------+---------------+ + .. _capturing_rejected_rows: Unsupported Field Delimiters ========================== The following ASCII field delimiters (octal range 001 - 176) are not supported: -+---------------+-------------+------------+---------------+-------------+------------+---------------+-------------+------------+ -| **Character** | **Decimal** | **Symbol** | **Character** | **Decimal** | **Symbol** | **Character** | **Decimal** | **Symbol** | -+===============+=============+============+===============+=============+============+===============+=============+============+ -| - | 45 | 55 | b | 98 | 142 | q | 113 | 161 | -+---------------+-------------+------------+---------------+-------------+------------+---------------+-------------+------------+ -| . | 46 | 56 | c | 99 | 143 | r | 114 | 162 | -+---------------+-------------+------------+---------------+-------------+------------+---------------+-------------+------------+ -| : | 58 | 72 | d | 100 | 144 | s | 115 | 163 | -+---------------+-------------+------------+---------------+-------------+------------+---------------+-------------+------------+ -| \ | 92 | 134 | e | 101 | 145 | t | 116 | 164 | -+---------------+-------------+------------+---------------+-------------+------------+---------------+-------------+------------+ -| 0 | 48 | 60 | f | 102 | 146 | u | 117 | 165 | -+---------------+-------------+------------+---------------+-------------+------------+---------------+-------------+------------+ -| 1 | 49 | 61 | g | 103 | 147 | v | 118 | 166 | -+---------------+-------------+------------+---------------+-------------+------------+---------------+-------------+------------+ -| 2 | 50 | 62 | h | 104 | 150 | w | 119 | 167 | -+---------------+-------------+------------+---------------+-------------+------------+---------------+-------------+------------+ -| 3 | 51 | 63 | i | 105 | 151 | x | 120 | 170 | -+---------------+-------------+------------+---------------+-------------+------------+---------------+-------------+------------+ -| 4 | 52 | 64 | j | 106 | 152 | y | 121 | 171 | -+---------------+-------------+------------+---------------+-------------+------------+---------------+-------------+------------+ -| 5 | 53 | 65 | k | 107 | 153 | z | 122 | 172 | -+---------------+-------------+------------+---------------+-------------+------------+---------------+-------------+------------+ -| 6 | 54 | 66 | l | 108 | 154 | N | 78 | 116 | -+---------------+-------------+------------+---------------+-------------+------------+---------------+-------------+------------+ -| 7 | 55 | 67 | m | 109 | 155 | 10 | 49 | 12 | -+---------------+-------------+------------+---------------+-------------+------------+---------------+-------------+------------+ -| 8 | 56 | 70 | n | 110 | 156 | 13 | 49 | 13 | -+---------------+-------------+------------+---------------+-------------+------------+ | | | -| 9 | 57 | 71 | o | 111 | 157 | | | | -+---------------+-------------+------------+---------------+-------------+------------+---------------+-------------+------------+ +The following table shows the unsupported ASCII field delimiters: + ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| **ASCII** | **Character** | **Description** | **Octal** | **Hex** | **Binary** | **HTML Code** | **HTML Name** | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 10 | LF | NL Line Feed, New Line | 12 | 0A | 1010 | &#10; | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 13 | CR | Carriage Return | 15 | 0D | 1101 | &#13; | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 34 | " | Double Quote | 42 | 22 | 100010 | &#34; | &quot; | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 45 | \-\ | Minus Sign | 55 | 2D | 101101 | &#45; | &minus; | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 46 | . | Period | 56 | 2E | 101110 | &#46; | &period; | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 48 | 0 | Zero | 60 | 30 | 110000 | &#48; | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 49 | 1 | Number One | 61 | 31 | 110001 | &#49; | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 50 | 2 | Number Two | 62 | 32 | 110010 | &#50; | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 51 | 3 | Number Three | 63 | 33 | 110011 | &#51; | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 52 | 4 | Number Four | 64 | 34 | 110100 | &#52; | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 53 | 5 | Number Five | 65 | 35 | 110101 | &#53; | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 54 | 6 | Number Six | 66 | 36 | 110110 | &#54; | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 55 | 7 | Number Seven | 67 | 37 | 110111 | &#55; | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 56 | 8 | Number Eight | 70 | 38 | 111000 | &#56; | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 57 | 9 | Number Nine | 71 | 39 | 111001 | &#57; | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 58 | : | Colon | 72 | 3A | 111010 | &#58; | &colon; | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 92 | \\ | Backslash | 134 | 5C | 01011100 | \&\#92\; | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ +| 78 | N | N | 116 | 4E | 1001110 | &#78; | | ++-----------+---------------+------------------------+-----------+---------+------------+---------------+---------------+ From 22ac7a3d4ca5985fec100ff78e5da0de122b2d84 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 24 Jul 2024 13:23:25 +0300 Subject: [PATCH 871/882] Update conf.py --- conf.py | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/conf.py b/conf.py index cfc66507b..8794a46dd 100644 --- a/conf.py +++ b/conf.py @@ -10,11 +10,16 @@ # add these directories to sys.path here. If the directory is relative to the # documentation root, use os.path.abspath to make it absolute, like shown here. # -# import os -# import sys -# sys.path.insert(0, os.path.abspath('.')) -# print(sys.executable) +import os +# Define the canonical URL if you are using a custom domain on Read the Docs +html_baseurl = os.environ.get("READTHEDOCS_CANONICAL_URL", "") + +# Tell Jinja2 templates the build is running on Read the Docs +if os.environ.get("READTHEDOCS", "") == "True": + if "html_context" not in globals(): + html_context = {} + html_context["READTHEDOCS"] = True import sphinx_rtd_theme From 5e5c08ee343fb3930c4b2f54ad558e16f0a7a885 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Tue, 30 Jul 2024 10:08:27 +0300 Subject: [PATCH 872/882] Update requirements.txt --- requirements.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/requirements.txt b/requirements.txt index 634ac675a..7677beb13 100644 --- a/requirements.txt +++ b/requirements.txt @@ -2,7 +2,7 @@ # Defining the exact version will make sure things don't break sphinx==5.3.0 -sphinx_rtd_theme==1.2.0 +sphinx-rtd-theme>=2.1.0rc1 urllib3<=2.0.0 openssl-python>=0.1.1 sphinx-notfound-page From 3af327cceb7ba89da0b4491e1db81f91fd9d61a6 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 7 Aug 2024 08:38:20 +0300 Subject: [PATCH 873/882] Upgrade Sphinx --- conf.py | 2 +- requirements.txt | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/conf.py b/conf.py index 8794a46dd..c4d61eefc 100644 --- a/conf.py +++ b/conf.py @@ -22,7 +22,7 @@ html_context["READTHEDOCS"] = True import sphinx_rtd_theme - +html_theme_path = [sphinx_rtd_theme.get_html_theme_path()] # -- Project information ----------------------------------------------------- diff --git a/requirements.txt b/requirements.txt index 7677beb13..9a5b53fe3 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,11 +1,11 @@ # File: docs/requirements.txt # Defining the exact version will make sure things don't break -sphinx==5.3.0 +sphinx==7.2.6 sphinx-rtd-theme>=2.1.0rc1 urllib3<=2.0.0 openssl-python>=0.1.1 -sphinx-notfound-page +sphinx-notfound-page>=1.0.4 Pygments>=2.4.0 +sphinx-favicon>=1.0.1 pdftex -sphinx-version-warning From 8603a7ad6976527abdf80f5fb68da33802bfa2df Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 7 Aug 2024 08:52:42 +0300 Subject: [PATCH 874/882] Update conf.py --- conf.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/conf.py b/conf.py index c4d61eefc..eee4ec9b7 100644 --- a/conf.py +++ b/conf.py @@ -46,9 +46,9 @@ # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom # ones. extensions = [ - 'sphinx_rtd_theme' - ,'notfound.extension' # 404 handling - ,'versionwarning.extension' + "sphinx_rtd_theme", + "notfound.extension", # 404 handling + "sphinx_favicon" ] # Mark 'index' as the main page From 465b097162d2e1441b7e98e464dd37fca5cff5df Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 7 Aug 2024 11:31:00 +0300 Subject: [PATCH 875/882] Update access_control_permissions.rst --- operational_guides/access_control_permissions.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/operational_guides/access_control_permissions.rst b/operational_guides/access_control_permissions.rst index 9eed6c837..663de79d7 100644 --- a/operational_guides/access_control_permissions.rst +++ b/operational_guides/access_control_permissions.rst @@ -27,7 +27,7 @@ The following table describe the required permissions for performing and executi +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``CONNECT`` | Connect to the database | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``CREATE`` | Create schemas in the database | +| ``CREATE`` | Create and drop schemas in the database (the schema must be empty for ``DROP`` operation to succeed | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``CREATE FUNCTION`` | Create and drop functions | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ From 301b6a967df2a6eb4f5ba92d4d320bdedc6be9b1 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 7 Aug 2024 11:37:28 +0300 Subject: [PATCH 876/882] Update access_control_permissions.rst --- operational_guides/access_control_permissions.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/operational_guides/access_control_permissions.rst b/operational_guides/access_control_permissions.rst index 663de79d7..6f970e0e2 100644 --- a/operational_guides/access_control_permissions.rst +++ b/operational_guides/access_control_permissions.rst @@ -27,7 +27,7 @@ The following table describe the required permissions for performing and executi +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``CONNECT`` | Connect to the database | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ -| ``CREATE`` | Create and drop schemas in the database (the schema must be empty for ``DROP`` operation to succeed | +| ``CREATE`` | Create and drop schemas in the database (the schema must be empty for ``DROP`` operation to succeed) | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ | ``CREATE FUNCTION`` | Create and drop functions | +----------------------+-------------------------------------------------------------------------------------------------------------------------+ From 910a2d858c70e05f0ce0a1d1b5a7f51d252c642f Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 7 Aug 2024 12:39:44 +0300 Subject: [PATCH 877/882] Update len.rst --- reference/sql/sql_functions/scalar_functions/string/len.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/reference/sql/sql_functions/scalar_functions/string/len.rst b/reference/sql/sql_functions/scalar_functions/string/len.rst index 2dee61a61..276ad62be 100644 --- a/reference/sql/sql_functions/scalar_functions/string/len.rst +++ b/reference/sql/sql_functions/scalar_functions/string/len.rst @@ -18,7 +18,8 @@ Syntax .. code-block:: postgres - LEN( expr ) --> INT + LEN( expr ) + LENGTH( expr ) Arguments ============ From 3c2d89d6393cbba8fa104719d6e6f319abdc8486 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 7 Aug 2024 12:56:07 +0300 Subject: [PATCH 878/882] Update parquet.rst --- data_ingestion/parquet.rst | 33 --------------------------------- 1 file changed, 33 deletions(-) diff --git a/data_ingestion/parquet.rst b/data_ingestion/parquet.rst index fbc5aa383..fcc637921 100644 --- a/data_ingestion/parquet.rst +++ b/data_ingestion/parquet.rst @@ -20,50 +20,17 @@ Prepare your source Parquet files according to the requirements described in the :header-rows: 1 * - SQreamDB Type → - - :: - Parquet Source ↓ - ``BOOL`` - - :: - - ``TINYINT`` - - :: - - ``SMALLINT`` - - :: - - ``INT`` - - :: - - ``BIGINT`` - - :: - - ``REAL`` - - :: - - ``DOUBLE`` - - :: - - ``TEXT`` [#f0]_ - - :: - - ``DATE`` - - :: - - ``DATETIME`` - - :: - * - ``BOOLEAN`` - Supported - From e3095757dc36b4fac05c07d6ebad9a54e5b4d734 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 14 Aug 2024 13:29:18 +0300 Subject: [PATCH 879/882] Update pre-installation_configurations.rst --- .../pre-installation_configurations.rst | 45 ------------------- 1 file changed, 45 deletions(-) diff --git a/installation_guides/pre-installation_configurations.rst b/installation_guides/pre-installation_configurations.rst index 193872ca4..a2a040e30 100644 --- a/installation_guides/pre-installation_configurations.rst +++ b/installation_guides/pre-installation_configurations.rst @@ -231,51 +231,6 @@ You can install the recommended tools by running the following command: $ sudo yum install bash-completion.noarch vim-enhanced vim-common net-tools iotop htop psmisc screen xfsprogs wget yum-utils deltarpm dos2unix - -Installing Python 3.6.7 --------------------------------- - -1. Download the Python 3.6.7 source code tarball file from the following URL into the **/home/sqream** directory: - - .. code-block:: console - - $ wget https://www.python.org/ftp/python/3.6.7/Python-3.6.7.tar.xz - -2. Extract the Python 3.6.7 source code into your current directory: - - .. code-block:: console - - $ tar -xf Python-3.6.7.tar.xz - -3. Navigate to the Python 3.6.7 directory: - - .. code-block:: console - - $ cd Python-3.6.7 - -4. Run the **./configure** script: - - .. code-block:: console - - $ ./configure - -5. Build the software: - - .. code-block:: console - - $ make -j30 - -6. Install the software: - - .. code-block:: console - - $ sudo make install - -7. Verify that Python 3.6.7 has been installed: - - .. code-block:: console - - $ python3 Installing NodeJS on CentOS -------------------------------- From d8e66ff867d37b10f08f7da2468892f21288b845 Mon Sep 17 00:00:00 2001 From: TaliaSQream <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 14 Aug 2024 13:31:23 +0300 Subject: [PATCH 880/882] Revert "Update pre-installation_configurations.rst" This reverts commit e3095757dc36b4fac05c07d6ebad9a54e5b4d734. --- .../pre-installation_configurations.rst | 45 +++++++++++++++++++ 1 file changed, 45 insertions(+) diff --git a/installation_guides/pre-installation_configurations.rst b/installation_guides/pre-installation_configurations.rst index a2a040e30..193872ca4 100644 --- a/installation_guides/pre-installation_configurations.rst +++ b/installation_guides/pre-installation_configurations.rst @@ -231,6 +231,51 @@ You can install the recommended tools by running the following command: $ sudo yum install bash-completion.noarch vim-enhanced vim-common net-tools iotop htop psmisc screen xfsprogs wget yum-utils deltarpm dos2unix + +Installing Python 3.6.7 +-------------------------------- + +1. Download the Python 3.6.7 source code tarball file from the following URL into the **/home/sqream** directory: + + .. code-block:: console + + $ wget https://www.python.org/ftp/python/3.6.7/Python-3.6.7.tar.xz + +2. Extract the Python 3.6.7 source code into your current directory: + + .. code-block:: console + + $ tar -xf Python-3.6.7.tar.xz + +3. Navigate to the Python 3.6.7 directory: + + .. code-block:: console + + $ cd Python-3.6.7 + +4. Run the **./configure** script: + + .. code-block:: console + + $ ./configure + +5. Build the software: + + .. code-block:: console + + $ make -j30 + +6. Install the software: + + .. code-block:: console + + $ sudo make install + +7. Verify that Python 3.6.7 has been installed: + + .. code-block:: console + + $ python3 Installing NodeJS on CentOS -------------------------------- From f25e9a5b9a0a1a528fac7d72d9fded510b8f4b98 Mon Sep 17 00:00:00 2001 From: RosinTalia <117294941+TaliaSQream@users.noreply.github.com> Date: Wed, 21 Aug 2024 14:04:08 +0300 Subject: [PATCH 881/882] Update datediff.rst --- .../sql_functions/scalar_functions/date_and_time/datediff.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sql/sql_functions/scalar_functions/date_and_time/datediff.rst b/reference/sql/sql_functions/scalar_functions/date_and_time/datediff.rst index 1af8827de..f5b37c79e 100644 --- a/reference/sql/sql_functions/scalar_functions/date_and_time/datediff.rst +++ b/reference/sql/sql_functions/scalar_functions/date_and_time/datediff.rst @@ -4,7 +4,7 @@ DATEDIFF ************************** -Calculates the difference between to ``DATE`` or ``DATETIME`` expressions, in terms of a specific date part. +Calculates the difference between two ``DATE`` or ``DATETIME`` expressions, in terms of a specific date part. .. note:: Results are given in integers, rather than ``INTERVAL``, which SQream DB does not support. From 20460cea621afb7c73efa59b84a0f120ae813d01 Mon Sep 17 00:00:00 2001 From: sharonl-sqreamtech <sharonl@sqreamtech.com> Date: Sun, 24 Aug 2025 13:22:56 +0300 Subject: [PATCH 882/882] Update python_functions.rst --- feature_guides/python_functions.rst | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/feature_guides/python_functions.rst b/feature_guides/python_functions.rst index e4589e0f8..5a6c2973b 100644 --- a/feature_guides/python_functions.rst +++ b/feature_guides/python_functions.rst @@ -6,7 +6,6 @@ Python User-Defined Functions User-Defined Functions (UDFs) offer streamlined statements, enabling the creation of a function once, storing it in the database, and calling it multiple times within a statement. Additionally, UDFs can be shared among roles, created by a database administrator and utilized by others. Furthermore, they contribute to code simplicity by allowing independent modifications in SQream DB without altering program source code. -To enable UDFs, in your :ref:`legacy configuration file<current_method_modification_methods>`, set the ``enablePythonUdfs`` configuration flag to ``true``. .. contents:: :local: @@ -17,7 +16,7 @@ Before You Begin * Ensure you have Python 3.6.7 or newer installed -* Enable UDFs by setting the ``enablePythonUdfs`` configuration flag to ``true`` in your :ref:`legacy configuration file<current_method_modification_methods>` +.. note:: This feature is deprecated on Q3 2025, and would be replaced by an enhanced implementation. Please consult SQream support for usage. SQreamDB's UDF Support ============================= @@ -44,10 +43,7 @@ To find which version of Python is installed for use by SQreamDB, create and run . $$ LANGUAGE PYTHON; executed master=> SELECT py_version(); - py_version - ------------------------------------------------------------------------------------- - Python version: 3.6.7 (default, Jul 22 2019, 11:03:54) [GCC 5.4.0]. - Path: /opt/sqream/python-3.6.7-5.4.0 + "Python version: 3.11.7 (main, Dec 22 2024, 18:29:20) [GCC 11.1.0]. Path: /usr/local" Using Modules ---------------------