This is an automated email from the ASF dual-hosted git repository. dzamo pushed a commit to branch gh-pages in repository https://gitbox.apache.org/repos/asf/drill.git
commit 771a08368f2d6fb9cf200eb73d8d304adbe82a3c Author: James Turton <[email protected]> AuthorDate: Thu Feb 25 08:16:24 2021 +0200 Tidy up azure blob and docker pg fixes. --- _data/docs.json | 557 +++++++++++---------- .../plugins/130-elasticsearch-plugin.md | 3 +- .../011-running-drill-on-docker.md | 59 ++- 3 files changed, 337 insertions(+), 282 deletions(-) diff --git a/_data/docs.json b/_data/docs.json index a723d74..f98896d 100644 --- a/_data/docs.json +++ b/_data/docs.json @@ -5264,24 +5264,25 @@ "Embedded Mode Prerequisites": { "breadcrumbs": [ { - "title": "Installing Drill in Embedded Mode", - "url": "/docs/:slug/" - }, - { - "title": "Install Drill", - "url": "/docs/:slug/" - } - ], - "children": [], - "next_title": "Running Drill on Docker", - "next_url": "/docs/:slug/", - "parent": "Installing Drill in Embedded Mode", - "previous_title": "Installing Drill in Embedded Mode", - "previous_url": "/docs/:slug/", - "relative_path": "_docs/install/installing-drill-in-embedded-mode/010-embedded-mode-prerequisites.md", - "title": "Embedded Mode Prerequisites", - "url": "/docs/:slug/" - }, + + "title": "Installing Drill in Embedded Mode", + "url": "/docs/installing-drill-in-embedded-mode/" + }, + { + "title": "Install Drill", + "url": "/docs/install-drill/" + } + ], + "children": [], + "next_title": "Running Drill on Docker", + "next_url": "/docs/running-drill-on-docker/", + "parent": "Installing Drill in Embedded Mode", + "previous_title": "Installing Drill in Embedded Mode", + "previous_url": "/docs/installing-drill-in-embedded-mode/", + "relative_path": "_docs/install/installing-drill-in-embedded-mode/010-embedded-mode-prerequisites.md", + "title": "Embedded Mode Prerequisites", + "url": "/docs/embedded-mode-prerequisites/" + }, "Enabling Query Queuing": { "breadcrumbs": [ { @@ -5952,41 +5953,62 @@ "url": "/docs/:slug/" }, { - "title": "Install Drill", - "url": "/docs/:slug/" + "title": "Install Drill", + "url": "/docs/install-drill/" } - ], - "children": [], - "next_title": "Running Drill on Docker", - "next_url": "/docs/:slug/", - "parent": "Installing Drill in Embedded Mode", - "previous_title": "Installing Drill in Embedded Mode", - "previous_url": "/docs/:slug/", - "relative_path": "_docs/install/installing-drill-in-embedded-mode/010-embedded-mode-prerequisites.md", - "title": "Embedded Mode Prerequisites", - "url": "/docs/:slug/" - }, + ], + "children": [], + "next_title": "Running Drill on Docker", + "next_url": "/docs/running-drill-on-docker/", + "parent": "Installing Drill in Embedded Mode", + "previous_title": "Installing Drill in Embedded Mode", + "previous_url": "/docs/installing-drill-in-embedded-mode/", + "relative_path": "_docs/install/installing-drill-in-embedded-mode/010-embedded-mode-prerequisites.md", + "title": "Embedded Mode Prerequisites", + "url": "/docs/embedded-mode-prerequisites/" + }, { "breadcrumbs": [ { - "title": "Installing Drill in Embedded Mode", - "url": "/docs/:slug/" - }, + "title": "Installing Drill in Embedded Mode", + "url": "/docs/installing-drill-in-embedded-mode/" + }, { - "title": "Install Drill", - "url": "/docs/:slug/" + "title": "Install Drill", + "url": "/docs/install-drill/" } - ], - "children": [], - "next_title": "Installing Drill on Linux and Mac OS X", - "next_url": "/docs/:slug/", - "parent": "Installing Drill in Embedded Mode", - "previous_title": "Embedded Mode Prerequisites", - "previous_url": "/docs/:slug/", - "relative_path": "_docs/install/installing-drill-in-embedded-mode/011-running-drill-on-docker.md", - "title": "Running Drill on Docker", - "url": "/docs/:slug/" - }, + ], + "children": [], + "next_title": "Installing Drill on Linux and Mac OS X", + "next_url": "/docs/installing-drill-on-linux-and-mac-os-x/", + "parent": "Installing Drill in Embedded Mode", + "previous_title": "Embedded Mode Prerequisites", + "previous_url": "/docs/embedded-mode-prerequisites/", + "relative_path": "_docs/install/installing-drill-in-embedded-mode/011-running-drill-on-docker.md", + "title": "Running Drill on Docker", + "url": "/docs/running-drill-on-docker/" + }, + { + "breadcrumbs": [ + { + "title": "Installing Drill in Embedded Mode", + "url": "/docs/installing-drill-in-embedded-mode/" + }, + { + "title": "Install Drill", + "url": "/docs/install-drill/" + } + ], + "children": [], + "next_title": "Starting Drill on Linux and Mac OS X", + "next_url": "/docs/starting-drill-on-linux-and-mac-os-x/", + "parent": "Installing Drill in Embedded Mode", + "previous_title": "Running Drill on Docker", + "previous_url": "/docs/running-drill-on-docker/", + "relative_path": "_docs/install/installing-drill-in-embedded-mode/020-installing-drill-on-linux-and-mac-os-x.md", + "title": "Installing Drill on Linux and Mac OS X", + "url": "/docs/installing-drill-on-linux-and-mac-os-x/" + }, { "breadcrumbs": [ { @@ -6336,156 +6358,156 @@ "url": "/docs/:slug/" }, { - "title": "Install Drill", - "url": "/docs/:slug/" - } - ], - "children": [], - "next_title": "Running Drill on Docker", - "next_url": "/docs/:slug/", - "parent": "Installing Drill in Embedded Mode", - "previous_title": "Installing Drill in Embedded Mode", - "previous_url": "/docs/:slug/", - "relative_path": "_docs/install/installing-drill-in-embedded-mode/010-embedded-mode-prerequisites.md", - "title": "Embedded Mode Prerequisites", - "url": "/docs/:slug/" - }, - { - "breadcrumbs": [ - { - "title": "Installing Drill in Embedded Mode", - "url": "/docs/:slug/" - }, - { - "title": "Install Drill", - "url": "/docs/:slug/" - } - ], - "children": [], - "next_title": "Installing Drill on Linux and Mac OS X", - "next_url": "/docs/:slug/", - "parent": "Installing Drill in Embedded Mode", - "previous_title": "Embedded Mode Prerequisites", - "previous_url": "/docs/:slug/", - "relative_path": "_docs/install/installing-drill-in-embedded-mode/011-running-drill-on-docker.md", - "title": "Running Drill on Docker", - "url": "/docs/:slug/" - }, - { - "breadcrumbs": [ - { - "title": "Installing Drill in Embedded Mode", - "url": "/docs/:slug/" - }, - { - "title": "Install Drill", - "url": "/docs/:slug/" - } - ], - "children": [], - "next_title": "Starting Drill on Linux and Mac OS X", - "next_url": "/docs/:slug/", - "parent": "Installing Drill in Embedded Mode", - "previous_title": "Running Drill on Docker", - "previous_url": "/docs/:slug/", - "relative_path": "_docs/install/installing-drill-in-embedded-mode/020-installing-drill-on-linux-and-mac-os-x.md", - "title": "Installing Drill on Linux and Mac OS X", - "url": "/docs/:slug/" - }, - { - "breadcrumbs": [ - { - "title": "Installing Drill in Embedded Mode", - "url": "/docs/:slug/" - }, - { - "title": "Install Drill", - "url": "/docs/:slug/" - } - ], - "children": [], - "next_title": "Installing Drill on Windows", - "next_url": "/docs/:slug/", - "parent": "Installing Drill in Embedded Mode", - "previous_title": "Installing Drill on Linux and Mac OS X", - "previous_url": "/docs/:slug/", - "relative_path": "_docs/install/installing-drill-in-embedded-mode/030-starting-drill-on-linux-and-mac-os-x.md", - "title": "Starting Drill on Linux and Mac OS X", - "url": "/docs/:slug/" - }, - { - "breadcrumbs": [ - { - "title": "Installing Drill in Embedded Mode", - "url": "/docs/:slug/" - }, - { - "title": "Install Drill", - "url": "/docs/:slug/" + "title": "Install Drill", + "url": "/docs/install-drill/" } - ], - "children": [], - "next_title": "Starting Drill on Windows", - "next_url": "/docs/:slug/", - "parent": "Installing Drill in Embedded Mode", - "previous_title": "Starting Drill on Linux and Mac OS X", - "previous_url": "/docs/:slug/", - "relative_path": "_docs/install/installing-drill-in-embedded-mode/040-installing-drill-on-windows.md", - "title": "Installing Drill on Windows", - "url": "/docs/:slug/" - }, + ], + "children": [], + "next_title": "Running Drill on Docker", + "next_url": "/docs/running-drill-on-docker/", + "parent": "Installing Drill in Embedded Mode", + "previous_title": "Installing Drill in Embedded Mode", + "previous_url": "/docs/installing-drill-in-embedded-mode/", + "relative_path": "_docs/install/installing-drill-in-embedded-mode/010-embedded-mode-prerequisites.md", + "title": "Embedded Mode Prerequisites", + "url": "/docs/embedded-mode-prerequisites/" + }, { "breadcrumbs": [ - { - "title": "Installing Drill in Embedded Mode", - "url": "/docs/:slug/" - }, - { - "title": "Install Drill", - "url": "/docs/:slug/" - } - ], - "children": [], - "next_title": "Installing Drill in Distributed Mode", - "next_url": "/docs/:slug/", - "parent": "Installing Drill in Embedded Mode", - "previous_title": "Installing Drill on Windows", - "previous_url": "/docs/:slug/", - "relative_path": "_docs/install/installing-drill-in-embedded-mode/050-starting-drill-on-windows.md", - "title": "Starting Drill on Windows", - "url": "/docs/:slug/" - } - ], - "next_title": "Embedded Mode Prerequisites", - "next_url": "/docs/:slug/", - "parent": "Install Drill", - "previous_title": "Migrating Parquet Data", - "previous_url": "/docs/:slug/", - "relative_path": "_docs/install/030-installing-drill-in-embedded-mode.md", - "title": "Installing Drill in Embedded Mode", - "url": "/docs/:slug/" - }, + { + "title": "Installing Drill in Embedded Mode", + "url": "/docs/installing-drill-in-embedded-mode/" + }, + { + "title": "Install Drill", + "url": "/docs/install-drill/" + } + ], + "children": [], + "next_title": "Installing Drill on Linux and Mac OS X", + "next_url": "/docs/installing-drill-on-linux-and-mac-os-x/", + "parent": "Installing Drill in Embedded Mode", + "previous_title": "Embedded Mode Prerequisites", + "previous_url": "/docs/embedded-mode-prerequisites/", + "relative_path": "_docs/install/installing-drill-in-embedded-mode/011-running-drill-on-docker.md", + "title": "Running Drill on Docker", + "url": "/docs/running-drill-on-docker/" + }, + { + "breadcrumbs": [ + { + "title": "Installing Drill in Embedded Mode", + "url": "/docs/installing-drill-in-embedded-mode/" + }, + { + "title": "Install Drill", + "url": "/docs/install-drill/" + } + ], + "children": [], + "next_title": "Starting Drill on Linux and Mac OS X", + "next_url": "/docs/starting-drill-on-linux-and-mac-os-x/", + "parent": "Installing Drill in Embedded Mode", + "previous_title": "Running Drill on Docker", + "previous_url": "/docs/running-drill-on-docker/", + "relative_path": "_docs/install/installing-drill-in-embedded-mode/020-installing-drill-on-linux-and-mac-os-x.md", + "title": "Installing Drill on Linux and Mac OS X", + "url": "/docs/installing-drill-on-linux-and-mac-os-x/" + }, + { + "breadcrumbs": [ + { + "title": "Installing Drill in Embedded Mode", + "url": "/docs/installing-drill-in-embedded-mode/" + }, + { + "title": "Install Drill", + "url": "/docs/install-drill/" + } + ], + "children": [], + "next_title": "Installing Drill on Windows", + "next_url": "/docs/installing-drill-on-windows/", + "parent": "Installing Drill in Embedded Mode", + "previous_title": "Installing Drill on Linux and Mac OS X", + "previous_url": "/docs/installing-drill-on-linux-and-mac-os-x/", + "relative_path": "_docs/install/installing-drill-in-embedded-mode/030-starting-drill-on-linux-and-mac-os-x.md", + "title": "Starting Drill on Linux and Mac OS X", + "url": "/docs/starting-drill-on-linux-and-mac-os-x/" + }, + { + "breadcrumbs": [ + { + "title": "Installing Drill in Embedded Mode", + "url": "/docs/installing-drill-in-embedded-mode/" + }, + { + "title": "Install Drill", + "url": "/docs/install-drill/" + } + ], + "children": [], + "next_title": "Starting Drill on Windows", + "next_url": "/docs/starting-drill-on-windows/", + "parent": "Installing Drill in Embedded Mode", + "previous_title": "Starting Drill on Linux and Mac OS X", + "previous_url": "/docs/starting-drill-on-linux-and-mac-os-x/", + "relative_path": "_docs/install/installing-drill-in-embedded-mode/040-installing-drill-on-windows.md", + "title": "Installing Drill on Windows", + "url": "/docs/installing-drill-on-windows/" + }, + { + "breadcrumbs": [ + { + "title": "Installing Drill in Embedded Mode", + "url": "/docs/installing-drill-in-embedded-mode/" + }, + { + "title": "Install Drill", + "url": "/docs/install-drill/" + } + ], + "children": [], + "next_title": "Installing Drill in Distributed Mode", + "next_url": "/docs/installing-drill-in-distributed-mode/", + "parent": "Installing Drill in Embedded Mode", + "previous_title": "Installing Drill on Windows", + "previous_url": "/docs/installing-drill-on-windows/", + "relative_path": "_docs/install/installing-drill-in-embedded-mode/050-starting-drill-on-windows.md", + "title": "Starting Drill on Windows", + "url": "/docs/starting-drill-on-windows/" + } + ], + "next_title": "Embedded Mode Prerequisites", + "next_url": "/docs/embedded-mode-prerequisites/", + "parent": "Install Drill", + "previous_title": "Migrating Parquet Data", + "previous_url": "/docs/migrating-parquet-data/", + "relative_path": "_docs/install/030-installing-drill-in-embedded-mode.md", + "title": "Installing Drill in Embedded Mode", + "url": "/docs/installing-drill-in-embedded-mode/" + }, "Installing Drill on Linux and Mac OS X": { "breadcrumbs": [ { - "title": "Installing Drill in Embedded Mode", - "url": "/docs/:slug/" - }, - { - "title": "Install Drill", - "url": "/docs/:slug/" - } - ], - "children": [], - "next_title": "Starting Drill on Linux and Mac OS X", - "next_url": "/docs/:slug/", - "parent": "Installing Drill in Embedded Mode", - "previous_title": "Running Drill on Docker", - "previous_url": "/docs/:slug/", - "relative_path": "_docs/install/installing-drill-in-embedded-mode/020-installing-drill-on-linux-and-mac-os-x.md", - "title": "Installing Drill on Linux and Mac OS X", - "url": "/docs/:slug/" - }, + "title": "Installing Drill in Embedded Mode", + "url": "/docs/installing-drill-in-embedded-mode/" + }, + { + "title": "Install Drill", + "url": "/docs/install-drill/" + } + ], + "children": [], + "next_title": "Starting Drill on Linux and Mac OS X", + "next_url": "/docs/starting-drill-on-linux-and-mac-os-x/", + "parent": "Installing Drill in Embedded Mode", + "previous_title": "Running Drill on Docker", + "previous_url": "/docs/running-drill-on-docker/", + "relative_path": "_docs/install/installing-drill-in-embedded-mode/020-installing-drill-on-linux-and-mac-os-x.md", + "title": "Installing Drill on Linux and Mac OS X", + "url": "/docs/installing-drill-on-linux-and-mac-os-x/" + }, "Installing Drill on Windows": { "breadcrumbs": [ { @@ -11720,45 +11742,45 @@ "Roles and Privileges": { "breadcrumbs": [ { - "title": "Securing Drill", - "url": "/docs/:slug/" - }, - { - "title": "Configure Drill", - "url": "/docs/:slug/" - } - ], - "children": [], - "next_title": "Configuring User Impersonation", - "next_url": "/docs/:slug/", - "parent": "Securing Drill", - "previous_title": "Secure Communication Paths", - "previous_url": "/docs/:slug/", - "relative_path": "_docs/configure-drill/securing-drill/030-roles-privileges.md", - "title": "Roles and Privileges", - "url": "/docs/:slug/" - }, + "title": "Securing Drill", + "url": "/docs/securing-drill/" + }, + { + "title": "Configure Drill", + "url": "/docs/configure-drill/" + } + ], + "children": [], + "next_title": "Configuring User Impersonation", + "next_url": "/docs/configuring-user-impersonation/", + "parent": "Securing Drill", + "previous_title": "Secure Communication Paths", + "previous_url": "/docs/secure-communication-paths/", + "relative_path": "_docs/configure-drill/securing-drill/030-roles-privileges.md", + "title": "Roles and Privileges", + "url": "/docs/roles-and-privileges/" + }, "Running Drill on Docker": { "breadcrumbs": [ { - "title": "Installing Drill in Embedded Mode", - "url": "/docs/:slug/" - }, - { - "title": "Install Drill", - "url": "/docs/:slug/" - } - ], - "children": [], - "next_title": "Installing Drill on Linux and Mac OS X", - "next_url": "/docs/:slug/", - "parent": "Installing Drill in Embedded Mode", - "previous_title": "Embedded Mode Prerequisites", - "previous_url": "/docs/:slug/", - "relative_path": "_docs/install/installing-drill-in-embedded-mode/011-running-drill-on-docker.md", - "title": "Running Drill on Docker", - "url": "/docs/:slug/" - }, + "title": "Installing Drill in Embedded Mode", + "url": "/docs/installing-drill-in-embedded-mode/" + }, + { + "title": "Install Drill", + "url": "/docs/install-drill/" + } + ], + "children": [], + "next_title": "Installing Drill on Linux and Mac OS X", + "next_url": "/docs/installing-drill-on-linux-and-mac-os-x/", + "parent": "Installing Drill in Embedded Mode", + "previous_title": "Embedded Mode Prerequisites", + "previous_url": "/docs/embedded-mode-prerequisites/", + "relative_path": "_docs/install/installing-drill-in-embedded-mode/011-running-drill-on-docker.md", + "title": "Running Drill on Docker", + "url": "/docs/running-drill-on-docker/" + }, "S3 Storage Plugin": { "breadcrumbs": [ { @@ -17726,41 +17748,62 @@ "url": "/docs/:slug/" }, { - "title": "Install Drill", - "url": "/docs/:slug/" + "title": "Install Drill", + "url": "/docs/install-drill/" } - ], - "children": [], - "next_title": "Running Drill on Docker", - "next_url": "/docs/:slug/", - "parent": "Installing Drill in Embedded Mode", - "previous_title": "Installing Drill in Embedded Mode", - "previous_url": "/docs/:slug/", - "relative_path": "_docs/install/installing-drill-in-embedded-mode/010-embedded-mode-prerequisites.md", - "title": "Embedded Mode Prerequisites", - "url": "/docs/:slug/" - }, + ], + "children": [], + "next_title": "Running Drill on Docker", + "next_url": "/docs/running-drill-on-docker/", + "parent": "Installing Drill in Embedded Mode", + "previous_title": "Installing Drill in Embedded Mode", + "previous_url": "/docs/installing-drill-in-embedded-mode/", + "relative_path": "_docs/install/installing-drill-in-embedded-mode/010-embedded-mode-prerequisites.md", + "title": "Embedded Mode Prerequisites", + "url": "/docs/embedded-mode-prerequisites/" + }, { "breadcrumbs": [ { - "title": "Installing Drill in Embedded Mode", - "url": "/docs/:slug/" - }, + "title": "Installing Drill in Embedded Mode", + "url": "/docs/installing-drill-in-embedded-mode/" + }, { - "title": "Install Drill", - "url": "/docs/:slug/" + "title": "Install Drill", + "url": "/docs/install-drill/" } - ], - "children": [], - "next_title": "Installing Drill on Linux and Mac OS X", - "next_url": "/docs/:slug/", - "parent": "Installing Drill in Embedded Mode", - "previous_title": "Embedded Mode Prerequisites", - "previous_url": "/docs/:slug/", - "relative_path": "_docs/install/installing-drill-in-embedded-mode/011-running-drill-on-docker.md", - "title": "Running Drill on Docker", - "url": "/docs/:slug/" - }, + ], + "children": [], + "next_title": "Installing Drill on Linux and Mac OS X", + "next_url": "/docs/installing-drill-on-linux-and-mac-os-x/", + "parent": "Installing Drill in Embedded Mode", + "previous_title": "Embedded Mode Prerequisites", + "previous_url": "/docs/embedded-mode-prerequisites/", + "relative_path": "_docs/install/installing-drill-in-embedded-mode/011-running-drill-on-docker.md", + "title": "Running Drill on Docker", + "url": "/docs/running-drill-on-docker/" + }, + { + "breadcrumbs": [ + { + "title": "Installing Drill in Embedded Mode", + "url": "/docs/installing-drill-in-embedded-mode/" + }, + { + "title": "Install Drill", + "url": "/docs/install-drill/" + } + ], + "children": [], + "next_title": "Starting Drill on Linux and Mac OS X", + "next_url": "/docs/starting-drill-on-linux-and-mac-os-x/", + "parent": "Installing Drill in Embedded Mode", + "previous_title": "Running Drill on Docker", + "previous_url": "/docs/running-drill-on-docker/", + "relative_path": "_docs/install/installing-drill-in-embedded-mode/020-installing-drill-on-linux-and-mac-os-x.md", + "title": "Installing Drill on Linux and Mac OS X", + "url": "/docs/installing-drill-on-linux-and-mac-os-x/" + }, { "breadcrumbs": [ { @@ -23821,4 +23864,4 @@ "url": "/docs/:slug/" } ] -} \ No newline at end of file +} diff --git a/_docs/connect-a-data-source/plugins/130-elasticsearch-plugin.md b/_docs/connect-a-data-source/plugins/130-elasticsearch-plugin.md index 2ebd1a4..b9b76aa 100644 --- a/_docs/connect-a-data-source/plugins/130-elasticsearch-plugin.md +++ b/_docs/connect-a-data-source/plugins/130-elasticsearch-plugin.md @@ -44,11 +44,12 @@ Following is the default registration configuration. ### Configuration Options - +|----------|-----------------------|----------------------------------------------------| | Option | Default | Description | |----------|-----------------------|----------------------------------------------------| | type | (none) | Set to "elastic" to use this plugin | | hosts | http://localhost:9200 | List of ElasticSearch hosts to be queried by Drill | | username | null | ElasticSearch username to be used by Drill | | password | null | ElasticSearch password to be used by Drill | +|----------|-----------------------|----------------------------------------------------| diff --git a/_docs/install/installing-drill-in-embedded-mode/011-running-drill-on-docker.md b/_docs/install/installing-drill-in-embedded-mode/011-running-drill-on-docker.md index e5be00a..b875ff6 100644 --- a/_docs/install/installing-drill-in-embedded-mode/011-running-drill-on-docker.md +++ b/_docs/install/installing-drill-in-embedded-mode/011-running-drill-on-docker.md @@ -4,14 +4,15 @@ slug: "Running Drill on Docker" parent: "Installing Drill in Embedded Mode" --- -Starting in Drill 1.14, you can run Drill in a [Docker container](https://www.docker.com/what-container#/package_software). Running Drill in a container is the simplest way to start using Drill; all you need is the Docker client installed on your machine. You simply run a Docker command, and your Docker client downloads the Drill Docker image from the [apache/drill](https://hub.docker.com/r/apache/drill) repository on [Docker Hub](https://docs.docker.com/docker-hub/) and brings up a cont [...] +**Introduced in release:** 1.14 -Currently, you can only run Drill in embedded mode in a Docker container. Embedded mode is when a single instance of Drill runs on a node or in a container. You do not have to perform any configuration tasks when Drill runs in embedded mode. +You can run Drill in a [Docker container](https://www.docker.com/what-container#/package_software). Running Drill in a container gives a simple way to start using Drill; all you need is Docker installed on your machine. You simply run a Docker command, and your installation will download the Drill Docker image from the [apache/drill](https://hub.docker.com/r/apache/drill) repository on [Docker Hub](https://docs.docker.com/docker-hub/) and bring up a container with Apache Drill running i [...] -## Prerequisite +Currently, you can only run Drill in embedded mode in a Docker container. Embedded mode is when a single instance of Drill runs on a node or in a container. You do not have to perform any configuration tasks to start using Drill to query local files in embedded mode. -You must have the Docker client (version 18 or later) [installed on your machine](https://docs.docker.com/install/). +## Prerequisites +You must have Docker version 18 or later [installed on your machine](https://docs.docker.com/install/). ## Running Drill in a Docker Container @@ -19,7 +20,8 @@ You can start and run a Docker container in detached mode or foreground mode. [D Whether you run the Docker container in detached or foreground mode, you start Drill in a container by issuing the docker `run` command with some options, as described in the following table: - + +|--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Option | Description | |--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `-i` | Keeps STDIN open. STDIN is standard input, an input stream where data is sent to and read by a program. | @@ -28,12 +30,14 @@ Whether you run the Docker container in detached or foreground mode, you start D | `-p` | The TCP port for the Drill Web UI. If needed, you can change this port using the `drill.exec.http.port` [start-up option]({{site.baseurl}}/docs/start-up-options/). | | `apache/drill:<version>` | The Docker Hub repository and tag. In the following example, `apache/drill` is the repository and `1.17.0` is the tag: `apache/drill:1.17.0`. The tag correlates with the version of Drill. When a new version of Drill is available, you can use the new version as the tag. | | `bin/bash` | Connects to the Drill container using a bash shell. | +|--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| ### Running the Drill Docker Container in Foreground Mode Open a terminal window (Command Prompt or PowerShell, but not PowerShell ISE) and then issue the following command and options to connect to SQLLine (the Drill shell): - - docker run -i --name drill-1.18.0 -p 8047:8047 -t apache/drill:1.18.0 /bin/bash +```sh +docker run -i --name drill-1.18.0 -p 8047:8047 -t apache/drill:1.18.0 /bin/bash +``` When you issue the docker run command, the Drill process starts in a container. SQLLine prints a message, and the prompt appears: @@ -42,22 +46,24 @@ When you issue the docker run command, the Drill process starts in a container. apache drill> At the prompt, you can enter the following simple query to verify that Drill is running: - - SELECT version FROM sys.version; +```sql +SELECT version FROM sys.version; +``` ### Running the Drill Docker Container in Detached Mode Open a terminal window (Command Prompt or PowerShell, but not PowerShell ISE) and then issue the following commands and options to connect to SQLLine (the Drill shell): **Note:** When you run the Drill Docker container in detached mode, you connect to SQLLine (the Drill shell) using drill-localhost. +```sh +$ docker run -i --name drill-1.18.0 -p 8047:8047 --detach -t apache/drill:1.18.0 /bin/bash +<displays container ID> - $ docker run -i --name drill-1.18.0 -p 8047:8047 --detach -t apache/drill:1.18.0 /bin/bash - <displays container ID> - - $ docker exec -it drill-1.18.0 bash - <connects to container> +$ docker exec -it drill-1.18.0 bash +<connects to container> - $ /opt/drill/bin/drill-localhost +$ /opt/drill/bin/drill-localhost +``` After you issue the commands, the Drill process starts in a container. SQLLine prints a message, and the prompt appears: @@ -66,20 +72,25 @@ After you issue the commands, the Drill process starts in a container. SQLLine p apache drill> At the prompt, you can enter the following simple query to verify that Drill is running: - - SELECT version FROM sys.version; +```sql +SELECT version FROM sys.version; +``` ## Querying Data By default, you can only query files that are accessible within the container. For example, you can query the sample data packaged with Drill, as shown: - SELECT first_name, last_name FROM cp.`employee.json` LIMIT 1; - |------------|-----------| - | first_name | last_name | - |------------|-----------| - | Sheri | Nowmer | - |------------|-----------| - 1 row selected (0.256 seconds) +```sql +SELECT first_name, last_name FROM cp.`employee.json` LIMIT 1; +``` +``` +|------------|-----------| +| first_name | last_name | +|------------|-----------| +| Sheri | Nowmer | +|------------|-----------| +1 row selected (0.256 seconds) +``` To query files outside of the container, you can configure [Docker volumes](https://docs.docker.com/storage/volumes/#start-a-service-with-volumes).
