Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
129 changes: 111 additions & 18 deletions confluence-mdx/var/pages.qm.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -1829,6 +1829,66 @@
- "databases"
- "connection-management"
- "kerberos-configurations"
- "page_id": "2010153049"
"title": "Custom JDBC Configs"
"title_orig": "Custom JDBC Configs"
"breadcrumbs":
- "관리자 매뉴얼"
- "Databases"
- "Connection Management"
- "Custom JDBC Configs"
"breadcrumbs_en":
- "Administrator Manual"
- "Databases"
- "Connection Management"
- "Custom JDBC Configs"
"path":
- "administrator-manual"
- "databases"
- "connection-management"
- "custom-jdbc-configs"
- "page_id": "2010120237"
"title": "QSI Parser Selection"
"title_orig": "QSI Parser Selection"
"breadcrumbs":
- "관리자 매뉴얼"
- "Databases"
- "Connection Management"
- "Custom JDBC Configs"
- "QSI Parser Selection"
"breadcrumbs_en":
- "Administrator Manual"
- "Databases"
- "Connection Management"
- "Custom JDBC Configs"
- "QSI Parser Selection"
"path":
- "administrator-manual"
- "databases"
- "connection-management"
- "custom-jdbc-configs"
- "qsi-parser-selection"
- "page_id": "2010153057"
"title": "Custom JDBC Configs - Databricks 예시"
"title_orig": "Custom JDBC Configs - Databricks 예시"
"breadcrumbs":
- "관리자 매뉴얼"
- "Databases"
- "Connection Management"
- "Custom JDBC Configs"
- "Custom JDBC Configs - Databricks 예시"
"breadcrumbs_en":
- "Administrator Manual"
- "Databases"
- "Connection Management"
- "Custom JDBC Configs"
- "Custom JDBC Configs - Databricks Example"
"path":
- "administrator-manual"
- "databases"
- "connection-management"
- "custom-jdbc-configs"
- "custom-jdbc-configs-databricks-example"
- "page_id": "544380126"
"title": "DB Access Control"
"title_orig": "DB Access Control​"
Expand Down Expand Up @@ -1985,6 +2045,24 @@
- "databases"
- "policies"
- "policy-exception"
- "page_id": "2010153040"
"title": "Query Rules"
"title_orig": "Query Rules"
"breadcrumbs":
- "관리자 매뉴얼"
- "Databases"
- "Policies"
- "Query Rules"
"breadcrumbs_en":
- "Administrator Manual"
- "Databases"
- "Policies"
- "Query Rules"
"path":
- "administrator-manual"
- "databases"
- "policies"
- "query-rules"
- "page_id": "571277577"
"title": "Ledger Management"
"title_orig": "Ledger Management"
Expand Down Expand Up @@ -4124,18 +4202,6 @@
- "Release Notes"
"path":
- "release-notes"
- "page_id": "1924891357"
"title": "11.6.0"
"title_orig": "11.6.0"
"breadcrumbs":
- "Release Notes"
- "11.6.0"
"breadcrumbs_en":
- "Release Notes"
- "11.6.0"
"path":
- "release-notes"
- "11.6.0"
- "page_id": "1751810049"
"title": "11.5.0 ~ 11.5.4"
"title_orig": "11.5.0 ~ 11.5.4"
Expand Down Expand Up @@ -4754,21 +4820,21 @@
"path":
- "installation"
- "querypie-acp-community-edition"
- "page_id": "1735589937"
"title": "MCP 설정 가이드"
"title_orig": "MCP 설정 가이드"
- "page_id": "1805516819"
"title": "QueryPie ACP Community Edition 초기 구성 가이드"
"title_orig": "QueryPie ACP Community Edition 초기 구성 가이드"
"breadcrumbs":
- "제품 설치"
- "QueryPie ACP Community Edition"
- "MCP 설정 가이드"
- "QueryPie ACP Community Edition 초기 구성 가이드"
"breadcrumbs_en":
- "Installation"
- "QueryPie ACP Community Edition"
- "MCP Configuration Guide"
- "QueryPie ACP Community Edition Initial Configuration Guide"
"path":
- "installation"
- "querypie-acp-community-edition"
- "mcp-configuration-guide"
- "querypie-acp-community-edition-initial-configuration-guide"
- "page_id": "1990000673"
"title": "QueryPie ACP Community Edition 업그레이드 방법"
"title_orig": "QueryPie ACP Community Edition 업그레이드 방법"
Expand Down Expand Up @@ -4799,6 +4865,21 @@
- "installation"
- "querypie-acp-community-edition"
- "how-to-remove-querypie-acp-community-edition"
- "page_id": "1735589937"
"title": "MCP 설정 가이드"
"title_orig": "MCP 설정 가이드"
"breadcrumbs":
- "제품 설치"
- "QueryPie ACP Community Edition"
- "MCP 설정 가이드"
"breadcrumbs_en":
- "Installation"
- "QueryPie ACP Community Edition"
- "MCP Configuration Guide"
"path":
- "installation"
- "querypie-acp-community-edition"
- "mcp-configuration-guide"
- "page_id": "1844969501"
"title": "지원"
"title_orig": "지원"
Expand Down Expand Up @@ -4853,6 +4934,18 @@
- "Unreleased"
"path":
- "unreleased"
- "page_id": "1924891357"
"title": "11.6.0"
"title_orig": "11.6.0"
"breadcrumbs":
- "Unreleased"
- "11.6.0"
"breadcrumbs_en":
- "Unreleased"
- "11.6.0"
"path":
- "unreleased"
- "11.6.0"
- "page_id": "1911652402"
"title": "Reverse Sync Test Page"
"title_orig": "Reverse Sync Test Page"
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
export default {
'qsi-parser-selection': 'QSI Parser Selection',
'custom-jdbc-configs-databricks': 'Custom JDBC Configs - Databricks Example',
'custom-jdbc-configs-databricks-example': 'Custom JDBC Configs - Databricks Example',
};
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
---
title: 'Custom JDBC Configs - Databricks Example'
confluenceUrl: 'https://querypie.atlassian.net/wiki/spaces/QM/pages/2010153057/Custom+JDBC+Configs+-+Databricks'
---

import { Callout } from 'nextra/components'

# Custom JDBC Configs - Databricks Example

### Overview

Starting from QueryPie ACP 11.6.0, the Custom JDBC Configs feature allows administrators to register a JDBC Driver and create a Databricks connection with policies applied.<br/>The query parser (QSI) supported by QueryPie ACP for Databricks is ANSI query, so Databricks-specific syntax may not work correctly.

<Callout type="info">
This feature is provided as **Beta**.
To use it, you must set the **Custom JDBC Configuration** option to `Enable` in the Experimental section on the `Admin > Databases > General > Configurations` page.
After activation, the `Admin > Databases > Connection Management > Custom JDBC Configs` menu will appear.
</Callout>

### Registering Databricks as a Custom JDBC Vendor

1. Navigate to `Admin > Databases > Connection Management > Custom JDBC Configs`.
2. Click the `Create Custom JDBC` button in the upper right corner.
3. Enter an identifiable name in the Name field. This name will be displayed in the Custom JDBC Vendors section when creating a DB connection.
4. Enter any additional information in the Description field.
5. Enter the Databricks driver class in the `Driver Class` field of the JDBC Configuration section. (For Databricks: `com.databricks.client.jdbc.Driver`)<br/>In general, the Driver Class can be verified with the following command:
```
unzip -p <your-driver.jar> META-INF/services/java.sql.Driver
```
6. Enter `jdbc:databricks://{host}:{port}/default` in the JDBC URL Template.
7. Enter `/` in the Options Prefix.
8. Enter `443` in the Default Port.
9. Enter `--add-opens=java.base/java.nio=ALL-UNNAMED` in the JVM Arguments.
10. Click the `Select JAR file to upload` button in the Driver JAR File section and upload the JDBC Driver.<br/>Databricks: [JDBC Driver Download](https://www.databricks.com/spark/jdbc-drivers-download)
11. Click the `Save` button to save the configuration.

### Creating a Databricks Connection with a Custom Vendor

1. Navigate to `Admin > Databases > Connection Management > DB Connections`.
2. Click the `Create Connection` button in the upper right corner.
3. Scroll down and select the Databricks entry you registered earlier (the item entered as `Name` when creating the Custom JDBC) from the **Custom JDBC Vendors** section.
4. Enter the connection information such as **Connection Name**, **Host**, **Port**, etc.
1. Host: Copy and paste the server hostname value obtained from Databricks.
2. Port: Use the default value of 443 specified in the Custom Vendor.
3. Database Name: Leave it empty or enter the name corresponding to a Databricks Catalog (refer to the **Structure Mapping Comparison** table below). Leaving it empty is recommended since this specifies the default path.
4. Username: Since Databricks uses tokens, leave the Username empty.
5. Password: Enter the token value issued from Settings (User Settings) &gt; Developer &gt; Access tokens in the Databricks console. When generating the token, specify the token scope as sql, workspace, catalog.
6. Other Options: Copy and paste the portion after default; from the JDBC URL field found in the connection details of the Databricks console.
5. Select a **QSI Parser** if needed. Select the default `ANSI SQL`.
6. Click the `Next` button to proceed to the connection creation complete screen.

#### Structure Mapping Comparison

| **Databricks** | **QueryPie ACP** |
| -------------- | ---------------- |
| Catalog | Database |
| Schema | Schema |
| Table | Table |
| Column | Column |

<Callout type="important">
Only Custom JDBC Vendors with `Active` status are displayed in the `Custom JDBC Vendors` section.
</Callout>
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,5 @@ export default {
'data-masking': 'Data Masking',
'sensitive-data': 'Sensitive Data',
'policy-exception': 'Policy Exception',
'query-rules': 'Query Rules',
};
Loading
Loading