Release 14.01.2022

* Audit Trails: added solution for using Yandex Cloud Logging and Yandex Cloud Functions.
* Data Transfer: added a warning to whitelist IPs used by the service.
* Managed Service for Kubernetes: added information about network in Managed Service for Kubernetes.
* Translations updated.
* Fixes and improvements.

Author: DataUI VCS Robot

en/_assets/datalens/quickstart/01-create-connection.png

@@ -0,0 +1,20 @@
+1. Go to the [connections page](https://datalens.yandex.com/connections).
+1. Click **Create connection**.
+1. Select the **ClickHouse** connection.
+
+   1. In the window that opens, specify the connection parameters:
+   
+      * Connection name: `Sample ClickHouse`.
+      * Connection type: **Specify manually**.
+      * Host name: `rc1a-ckg8nrosr2lim5iz.mdb.yandexcloud.net`.
+      * HTTP interface port: `8443` (default).
+      * Username: `samples_ro`.
+      * Password: `MsgfcjEhJk`.
+
+   1. Enable the **HTTPS** option and **Allow subqueries in datasets and queries from charts**.
+   1. Check the connection and click **Create**.
+
+      ![create-connection](../../../_assets/datalens/sql-chart/create-sample-connection-sql-chart.png)
+
+Wait for the connection to be saved.
+

en/_assets/datalens/quickstart/06-create-map-chart.png

@@ -0,0 +1 @@
+`dns.admin`: enables you to view, create, edit, and delete [DNS zones](../../../dns/concepts/dns-zone.md) and [resource records](../../../dns/concepts/resource-record.md) as well as control DNS zone access.

en/_assets/datalens/sql-chart/add-chart-on-dashboard.png

@@ -0,0 +1,6 @@
+### dns.admin {#dns-admin}
+
+The `dns.admin` role includes the following privileges:
+
+* Viewing, creating, editing, and deleting [DNS zones](../../../dns/concepts/dns-zone.md) and [resource records](../../../dns/concepts/resource-record.md).
+* Managing access to DNS zones.

en/_assets/datalens/sql-chart/add-chart.png

@@ -0,0 +1 @@
+`dns.editor`: enables you to view, create, edit, and delete [DNS zones](../../../dns/concepts/dns-zone.md) and [resource records](../../../dns/concepts/resource-record.md).

en/_assets/datalens/sql-chart/add-selector-on-dashboard.png

@@ -0,0 +1,3 @@
+### dns.editor {#dns-editor}
+
+The `dns.editor` role includes permissions to view, create, edit, and delete [DNS zones](../../../dns/concepts/dns-zone.md) and [resource records](../../../dns/concepts/resource-record.md).

en/_assets/datalens/sql-chart/add-selector-parameters.png

@@ -0,0 +1 @@
+`dns.viewer`: enables you to view [DNS zones](../../../dns/concepts/dns-zone.md) and [resource records](../../../dns/concepts/resource-record.md).

en/_assets/datalens/sql-chart/add-selector-select-all.png

@@ -0,0 +1,3 @@
+### dns.viewer {#dns-viewer}
+
+The `dns.viewer` role enables you to view [DNS zones](../../../dns/concepts/dns-zone.md) and [resource records](../../../dns/concepts/resource-record.md).

en/_assets/datalens/sql-chart/add-selector-values.png

@@ -1,9 +1,4 @@
 The disk size is specified in bytes by default. You can specify a different unit of measurement using the applicable suffix.
 
-| Name | Example of a YAML file entry: |
-| ----- | ----- |
-| Kilobyte | 1073741824k |
-| Megabyte | 1048576m |
-| Gigabyte | 1024g |
-| Terabyte | 1t |
+{% include [yaml-int64-suffixes](yaml-int64-suffixes.md) %}
 

en/_assets/datalens/sql-chart/add-selector.png

@@ -0,0 +1,8 @@
+| Suffix | Prefix and multiplier | Example |
+| ----- | ----- | ----- |
+| `k` | kilo- (2^10^) | `640k` = 640 × 2^10^ = `655360` |
+| `m` | mega- (2^20^) | `48m` = 48 × 2^20^ = `50331648` |
+| `g` | giga- (2^30^) | `10g` = 10 × 2^30^ = `10737418240` |
+| `t` | tera- (2^40^) | `4t` = 4 × 2^40^ = `4398046511104` |
+| `p` | peta- (2^50^) | `2p` = 2 × 2^50^ = `2251799813685248` |
+

en/_assets/datalens/sql-chart/create-sample-connection-sql-chart.png

@@ -72,9 +72,4 @@ You can filter records using the [language of filter expressions](../../logging/
 
     You can view the entries in a log group using the API [read](../../logging/api-ref/grpc/log_reading_service.md) method.
 
-- API
-
-  You can view the entries in a log group using the API [read](../../logging/api-ref/grpc/log_reading_service.md) method.
-
 {% endlist %}
-

en/_assets/datalens/sql-chart/select-chart.png

@@ -875,3 +875,5 @@ sudo apt update && sudo apt install -y ruby ruby-pg
       ```bash
       ruby connect.rb
       ```
+
+{% endlist %}

en/_assets/datalens/sql-chart/selector-2-values.png

@@ -28,3 +28,4 @@
   +----------------------+--------------------+-----------------------+--------+
   ```
 
+{% endlist %}

en/_assets/datalens/sql-chart/sql-chart-diagram.png

@@ -0,0 +1,171 @@
+# Visualizing data with a SQL chart
+
+In this scenario, you will create charts using SQL queries. SQL queries enable you to configure data for visualization in a more flexible way than the standard dataset method does. For example, you can add parameters from dashboards to a SQL query.
+
+We recommend using a SQL chart when creating a conventional chart from a dataset isn't suitable, or when you would like to experiment with data.
+
+A direct connection to a demo database will be used as your data source.
+
+To visualize and analyze data, make sure you have a [ready-to-use cloud](#before-you-begin) and follow these steps:
+
+1. [Create a connection](#create-connection).
+1. [Create a SQL chart](#create-sql-chart).
+1. [Create a dashboard](#create-dashboard).
+1. [Add the SQL chart to the dashboard](#add-sql-chart-to-dashboard).
+1. [Add a selector to the dashboard](#add-selector-to-dashboard).
+
+{% note warning %}
+
+* SQL queries only work with databases. CSV, GoogleSheets, Yandex.Metrica, and other service connections do not support SQL queries.
+
+* SQL charts are currently available on non-public dashboards only. If you open a [public dashboard](../../datalens/concepts/datalens-public.md), you will see an error in the chart.
+
+{% endnote %}
+
+## Before you start {#before-you-begin}
+
+{% include [before-you-begin](includes/before-you-begin-datalens.md) %}
+
+## Create a connection {#create-connection}
+
+{% include [datalens-create-sample-connection](../datalens/operations/datalens-create-sample-connection.md) %}
+
+## Create a SQL chart {#create-sql-chart}
+
+1. Go to an existing database connection.
+1. Make sure **Raw SQL level** → **Allow subqueries in datasets and queries from charts** is enabled.
+1. In the upper right-hand corner, click **Create SQL chart**.
+1. On the **Query** tab, enter the query code:
+
+   ```sql
+   SELECT 
+      year(t2.FirstDate) as "Year",
+      COUNT(t1.ClientID) as "Number of new  clients", t3.ClientStatus as "Status"
+   FROM
+      samples.MS_SalesFacts t1,
+      (SELECT 
+   	      ClientID, 
+         MIN(OrderDatetime) as FirstDate
+      FROM samples.MS_SalesFacts
+      GROUP BY ClientID) as t2,
+         samples.MS_Clients t3
+   WHERE t1.ClientID =t2.ClientID and t3.ClientID=t2.ClientID and t3.ClientStatus in not_var{{status}} -- status: variable associated with parameter affected by selector
+   GROUP BY "Year", "Status"
+   ORDER BY "Year"
+   ```
+
+1. On the **Params** tab, click **Add param** and complete the input fields:
+
+   * From the drop-down list, select `string` (default).
+   * In the **Name** field, enter `status`.
+   * In the **Default value** field, enter `Базовый`.
+   * Below, click **Add param value** and enter `Золотой`.
+
+     ![sql-chart-parameter](../../_assets/datalens/sql-chart/sql-chart-parameter.png)
+
+   The added parameter will be associated with the `not_var{{status}}` variable in the query.
+
+   {% note info %}
+
+   You can control the value of the parameter using a dashboard selector.
+
+   {% endnote %}
+
+1. Go back to the **Query** tab. In the lower left-hand corner, click **Run**. Running the query will produce a visualization in the right-hand window.
+1. Configure the visualization:
+
+   * Select **Column chart** as chart type.
+
+     ![sql-chart-diagram](../../_assets/datalens/sql-chart/sql-chart-diagram.png)
+
+   * Drag the **Year** field to the **X** section.
+   * Drag the **Number of new clients** field to the **Y** section.
+   * Drag the **Status** field to the **Colors** section.
+   * Make sure the **Available** section is empty. This is the section that contains fields not involved in calculations. Otherwise, the visualization will display incorrectly.
+
+     ![sql-chart-rezult](../../_assets/datalens/sql-chart/sql-chart-rezult.png)
+
+1. In the upper right-hand corner, click **Save**.
+
+You can place the chart created on the dashboard. You can also add a selector to the dashboard to control the SQL chart `status` parameter.
+
+## Create a dashboard {#create-dashboard}
+
+Create a [dashboard](../../datalens/concepts/dashboard.md) to add your charts to.
+
+1. Go to the {{ datalens-short-name }} [home page]({{ link-datalens-main }}).
+1. Click **Create dashboard**.
+
+   ![image](../../_assets/datalens/solution-02/35-create-dashboard.png)
+
+1. Enter `Change in number of clients by year` as the name for the dashboard and click **Create**.
+
+   The dashboard created will open for editing.
+
+## Add a SQL chart to your dashboard {#add-sql-chart-to-dashboard}
+
+1. At the top of the page, click **Add** and select **Chart**.
+
+   ![image](../../_assets/datalens/sql-chart/add-chart.png)
+
+1. In the **Chart** field, click **Select** and select the previously created **New clients** chart from the chart list.
+
+   ![image](../../_assets/datalens/sql-chart/select-chart.png)
+
+   Click **Add**.
+
+1. The chart is displayed on the dashboard. Stretch it to improve visualization.
+
+   ![image](../../_assets/datalens/sql-chart/add-chart-on-dashboard.png)
+
+1. Save the dashboard.
+
+## Add a selector to the dashboard {#add-selector-to-dashboard}
+
+Add a [selector](../../datalens/concepts/dashboard.md#selector) to be able to filter charts by customer status.
+
+1. At the top of the page, click **Add**.
+1. Choose **Selector**.
+
+   ![image](../../_assets/datalens/sql-chart/add-selector.png)
+
+1. In the **Title** field, enter `Select client status`.
+1. Enable the **Show** option.
+1. Select **Manual input** as source type.
+1. Select **List** as element type.
+1. In the **Field name** field, enter `status`. Certain selector values will be passed into this SQL query variable.
+1. Click on the **Possible values** input field. In the resulting window, add:
+
+   * Золотой
+   * Серебряный
+   * Базовый
+
+   ![image](../../_assets/datalens/sql-chart/add-selector-values.png)
+
+   Click **Apply**.
+
+1. Enable **Multiple choice**.
+1. In the **Default value** list, specify **Select all**.
+
+   ![image](../../_assets/datalens/sql-chart/add-selector-select-all.png)
+
+1. Verify the specified selector parameters.
+
+   ![image](../../_assets/datalens/sql-chart/add-selector-parameters.png)
+
+1. Click **Add**.
+1. Place the selector above the chart on the dashboard and stretch to match the width of the chart.
+1. Save the dashboard.
+
+   ![image](../../_assets/datalens/sql-chart/add-selector-on-dashboard.png)
+
+1. Your dashboard is ready. Now, you can filter the chart using the selector.
+
+   ![image](../../_assets/datalens/sql-chart/selector-2-values.png)
+
+#### See also {#see-also}
+
+- [{#T}](../../datalens/operations/dashboard/add-chart.md)
+- [{#T}](../../datalens/operations/dashboard/add-selector.md)
+- [SQL charts](../../datalens/concepts/chart/index.md#sql-charts)
+

en/_assets/datalens/sql-chart/sql-chart-parameter.png

@@ -438,7 +438,7 @@ VMs with Active Directory don't have internet access, so they should be configur
        --metadata-from-file user-data=setpass
      ```
 
-   {% list tabs %}
+   {% endlist %}
 
 1. Connect to `fsw-vm` using RDP.
 1. On `fsw-vm`, start the RDP client and use it to connect to `vm-exchange-a`. Enter `Administrator` as the username and then your password. Launch PowerShell.