SQL エンドポイントSQL endpoints

重要

この機能はパブリック プレビュー段階にあります。This feature is in Public Preview. アクセスを要求するには、Azure Databricks の担当者にお問い合わせください。Contact your Azure Databricks representative to request access.

Azure Databricks SQL エンドポイントは、Azure Databricks 環境内のデータオブジェクトに対して SQL コマンドを実行できる計算リソースです。An Azure Databricks SQL endpoint is a computation resource that lets you run SQL commands on data objects within the Azure Databricks environment.

SQL エンドポイントは、 クエリ履歴 に表示され、クエリを実行したユーザーを記録します。SQL endpoints appear in query history and record the user that ran the query.

Sql エンドポイントは sql Analytics のsql コマンドをサポートしています。SQL endpoints support the SQL commands in SQL reference for SQL Analytics.

このセクションでは、UI を使用して SQL エンドポイントを操作する方法について説明します。This section describes how to work with SQL endpoints using the UI. API を使用して SQL エンドポイントを操作する方法については、「 Sql エンドポイント api」を参照してください。To work with SQL endpoints using the API, see SQL Endpoint APIs.

SQL エンドポイントを使用したクエリは、その記事で説明されている既定値を使用して、 クエリウォッチドッグ によって管理されます。Queries through SQL endpoints are managed by the Query Watchdog with the defaults as described in that article.

要件Requirements

  • SQL エンドポイントを作成するには、Azure Databricks ワークスペースでのクラスター作成のアクセス許可が必要です。To create SQL endpoints you must have cluster create permission in Azure Databricks Workspace.
  • SQL エンドポイントを管理するには、エンドポイントの Azure Databricks SQL Analytics の 管理 権限を持っている必要があります。To manage a SQL endpoint you must have Can Manage permission in Azure Databricks SQL Analytics for the endpoint.

SQL エンドポイントの表示View SQL endpoints

以下をクリックしますClick the エンドポイントアイコン アイコンをクリックします。icon in the sidebar.

既定では、エンドポイントはアルファベット順に並べ替えられます。By default, endpoints are sorted in alphabetical order. 列の見出しをクリックすることで、一覧を並べ替えることができます。You can reorder the list by clicking the column headings.

エンドポイントの一覧をフィルター処理するには、検索ボックスにテキストを入力します。To filter the list of endpoints, enter text in the search box:

エンドポイントのフィルター処理Filter endpoints

SQL エンドポイントを作成するCreate a SQL endpoint

  1. 以下をクリックしますClick the エンドポイントアイコン アイコンをクリックします。icon in the sidebar.

  2. [ + 新しい SQL エンドポイント] をクリックします。Click + New SQL Endpoint.

    エンドポイントを作成するCreate endpoint

  3. エンドポイントの名前を入力します。Enter a name for the endpoint. エンドポイントのプロパティを受け入れるか、または編集します。Accept or edit the endpoint properties.

  4. Create をクリックしてください。Click Create.

  5. 次のいずれかの操作を行います。Do one of the following:

    エンドポイントが作成され、開始されます。The endpoint is created and started.

SQL エンドポイントの開始、停止、または削除 Start, stop, or delete a SQL endpoint

  1. 以下をクリックしますClick the エンドポイントアイコン アイコンをクリックします。icon in the sidebar.
  2. [アクション] 列で、縦の省略記号の垂直の省略記号をクリックし、  [ 開始]、[ 停止]、または [ 削除] を選択します。In the Actions column, click the vertical ellipsis Vertical Ellipsis and select Start, Stop, or Delete.

サービスプリンシパルの構成」も参照してください。Also see Configure a service principal.

SQL エンドポイント の編集 Edit a SQL endpoint

  1. 以下をクリックしますClick the エンドポイントアイコン アイコンをクリックします。icon in the sidebar.
  2. エンドポイントをクリックします。Click an endpoint.
  3. [編集] をクリックします。Click Edit.
  4. エンドポイントのプロパティを編集します。Edit endpoint properties.
    • クラスターサイズ: クラスターワーカーの数とコーディネーターのサイズ。Cluster Size: the number of cluster workers and size of the coordinator. 既定値は X-Large です。The default is X-Large. クエリの待機時間を短縮するには、サイズを大きくします。To reduce the latency of queries, increase the size. サイズが大きいほど、コーディネーターが大きくなり、クラスターワーカーの数が倍増します。A larger size has a larger coordinator and doubles the number of cluster workers. 詳細については、「 クラスターサイズ」を参照してください。For details, see Cluster size.

    • 自動停止: 指定した分間アイドル状態になったエンドポイントを停止するかどうかを指定します。Auto Stop: whether the endpoint stops if it’s idle for the specified number of minutes. 既定 値は120分です。The default is On with a value of 120 minutes.

      注意

      アイドル状態の SQL エンドポイントは、停止するまで DBU と cloud instance の料金を累積し続けます。Idle SQL endpoints continue to accumulate DBU and cloud instance charges until they are stopped.

    • 複数クラスターの負荷分散: エンドポイントに送信されたクエリが分散されるクラスターの最小数と最大数。Multi-cluster Load Balancing: the minimum and maximum number of clusters over which queries sent to the endpoint are distributed. 既定値は [ オフ ] で、 [オン] の場合は1クラスターです。The default is Off and 1 cluster if On. 特定のクエリの同時実行ユーザー数を増やすには、負荷分散を有効にし、クラスター数を増やします。To handle more concurrent users for a given query, enable load balancing and increase the cluster count.

    • Photon: クエリの実行速度を上げるネイティブベクター化エンジンでクエリを実行するかどうかを指定します。Photon: whether queries are executed on a native vectorized engine that speeds up query execution. 既定値は Off です。The default is Off. 有効にするには、 [オン] を選択し、免責事項を読んで、[ enable Photon] をクリックします。To enable, select On, read the disclaimer, and click Enable Photon.

      重要

      マルチクラスターの負荷分散と Photon は、プレビュー段階にあります。Multi-cluster Load Balancing and Photon are in Preview. アクセスを要求するには、Azure Databricks の担当者にお問い合わせください。Contact your Azure Databricks representative to request access.

    • アクセス許可: エンドポイントを管理および使用できるユーザーとグループ。Permissions: users and groups that can manage and use the endpoint.

    • Tags: エンドポイントを使用するユーザーを識別できる、キーと値のペアの注釈。Tags: key-value pair annotations that can identify who uses the endpoint.

  5. [ 保存 ] または [ 保存して再起動] を クリックします。Click Save or Save and restart.

エンドポイントのアクセス許可の編集Edit endpoint permissions

エンドポイントのアクセス許可を編集するには:To edit endpoint permissions:

  1. 以下をクリックしますClick the [アクセス許可] ボタン ボタンを選択します。button.

    SQL エンドポイントのアクセス許可が表示されます。The SQL endpoint permissions display. エンドポイント作成者と Azure Databricks 管理者は、アクセス許可 を管理でき ます。The endpoint creator and Azure Databricks admins have Can Manage permission.

    アクセス許可の追加Add permission

  2. ユーザーまたはグループ、およびアクセス許可を選択します。Select a user or group and a permission.

  3. [追加] をクリックします。Click Add.

  4. [保存] をクリックします。Click Save.

エンドポイントタグを追加するAdd an endpoint tag

タグを使用すると、組織内のさまざまなグループによって使用されるクラウドリソースのコストを簡単に監視できます。Tags allow you to easily monitor the cost of cloud resources used by various groups in your organization. エンドポイントを作成するときに、キーと値のペアとしてタグを指定し、これらのタグをクラウドリソースに適用 Azure Databricks ことができます。You can specify tags as key-value pairs when you create an endpoint, and Azure Databricks applies these tags to cloud resources.

エンドポイントタグを追加するには:To add an endpoint tag:

  1. 以下をクリックしますClick the エンドポイントアイコン アイコンをクリックします。icon in the sidebar.

  2. エンドポイントをクリックします。Click an endpoint.

  3. [編集] をクリックします。Click Edit.

  4. [タグ] 行に、タグキーと値を入力します。In the Tags row, enter a tag key and value.

    タグの追加Add tag

  5. [ 保存して再起動] を クリックします。Click Save and restart.

SQL エンドポイントを監視するMonitor a SQL endpoint

エンドポイントによって処理されるクエリの数と、エンドポイントに割り当てられたクラスターの数を調べることができます。You can examine the number of queries handled by the endpoint and the number of clusters allocated to the endpoint.

  1. 以下をクリックしますClick the エンドポイントアイコン アイコンをクリックします。icon in the sidebar.

  2. エンドポイントをクリックします。Click an endpoint.

  3. [監視] をクリックします。Click Monitoring.

    エンドポイントによって処理されたクエリの数と、過去6時間にエンドポイントに割り当てられたクラスターの数を示すグラフ。A chart showing the number of queries handled by the endpoint and the number of clusters allocated to the endpoint over the last 6 hours displays.

    グラフの右上にある [タイムスケール] ボタンをクリックして、表示される期間を変更します。Click a timescale button at the top right of the chart to change the displayed period. たとえば、次のスクリーンショットは7日間の統計を示しています。For example, the following screenshot shows these statistics over 7 days:

    エンドポイントの監視Monitor endpoint

    注意

    クラスター数は、 マルチクラスターの負荷分散 が有効になっていて構成されている場合に限り、1つより大きくなることがあります。The Cluster Count can be greater than one only if multi-cluster load balancing is enabled and configured.

クラスター サイズCluster size

このセクションの表では、SQL エンドポイントクラスターのサイズを Azure Databricks クラスターのドライバーサイズとワーカー数にマップします。The table in this section maps SQL endpoint cluster sizes to Azure Databricks cluster driver size and worker counts.

クラスター サイズCluster size Driver size (ドライバー サイズ)Driver size ワーカー数Worker count
2X-小2X-Small Standard_E8_v3Standard_E8_v3 11
X-小X-Small Standard_E8_v3Standard_E8_v3 22
Small Standard_E16_v3Standard_E16_v3 44
MediumMedium Standard_E32_v3Standard_E32_v3 88
LargeLarge Standard_E32_v3Standard_E32_v3 1616
X-大X-Large Standard_E64_v3Standard_E64_v3 3232
2倍大2X-Large Standard_E64_v3Standard_E64_v3 6464
3倍-大3X-Large Standard_E64_v3Standard_E64_v3 128128
4X-大4X-Large Standard_E64_v3Standard_E64_v3 256256

すべてのワーカーのインスタンスサイズが Standard_E8_v3 ます。The instance size of all workers is Standard_E8_v3.