{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["availability","img","partial","faq","faq-item"]},"type":"markdown","userRole":"Users, Editors, and Admins","accountType":"All accounts","plan":"Exclusive to select subscription plans"},"seo":{"title":"Integrate Oracle with Databox","description":"Learn how to connect Oracle to Databox and unlock reusable datasets for advanced reporting and visualization.","siteUrl":"https://help.databox.com","llmstxt":{"title":"Databox Knowledge Base","description":"Databox is a business analytics platform that consolidates data in one place, enabling real-time performance tracking and insights by mixing and matching data from various sources for a comprehensive view.","details":{"content":"This knowledge base covers everything from account setup and integrations to building Databoards, creating custom metrics, and using AI-powered features."},"sections":[{"title":"General","includeFiles":["docs/general/*.md","docs/general/visualization-types/*.md","docs/general/templates/*.md"],"excludeFiles":[]},{"title":"AI","includeFiles":["docs/ai/*.md"],"excludeFiles":[]},{"title":"Account Management","includeFiles":["docs/account-management/**/*.md"],"excludeFiles":[]},{"title":"Databoards","includeFiles":["docs/databoards/**/*.md"],"excludeFiles":[]},{"title":"Data Management","includeFiles":["docs/data-management/**/*.md"],"excludeFiles":[]},{"title":"Metrics","includeFiles":["docs/metrics/**/*.md"],"excludeFiles":[]},{"title":"Forecasts","includeFiles":["docs/forecasts/*.md"],"excludeFiles":[]},{"title":"Goals","includeFiles":["docs/goals/*.md"],"excludeFiles":[]},{"title":"Reports","includeFiles":["docs/reports/*.md"],"excludeFiles":[]},{"title":"Notifications","includeFiles":["docs/notifications/*.md"],"excludeFiles":[]},{"title":"Pricing and Billing","includeFiles":["docs/pricing-and-billing/*.md"],"excludeFiles":[]},{"title":"Mobile","includeFiles":["docs/mobile/*.md"],"excludeFiles":[]},{"title":"Support","includeFiles":["docs/support/*.md"],"excludeFiles":[]},{"title":"Integrations","includeFiles":["docs/integrations/**/*.md"],"excludeFiles":[]}],"hide":false,"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"integrate-oracle-with-databox","__idx":0},"children":["Integrate Oracle with Databox"]},{"$$mdtype":"Tag","name":"Availability","attributes":{"users":"users","accounts":"all","plans":"exclusive"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Oracle Database is a widely used relational database management system (RDBMS) known for its reliability, performance, and advanced security features. It supports large-scale transaction processing, data warehousing, and analytics workloads. Oracle offers extensive SQL capabilities, support for PL/SQL, and options for clustering and high availability. Many organizations rely on Oracle as a centralized source of truth for mission-critical business data and reporting"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connection","__idx":1},"children":["Connection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When setting up an Oracle connection in Databox, you'll first choose whether you're connecting an ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.oracle.com/en-us/iaas/autonomous-database-serverless/doc/autonomous-intro-adb.html"},"children":["Autonomous Database"]}," or a another type of Oracle database. Use the checkbox at the top of the connection form to select the appropriate option."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"path-1-oracle-autonomous-database","__idx":2},"children":["Path 1: Oracle Autonomous Database"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For Autonomous Database connections, you'll need:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Username"]}," — Oracle user with read access to the database."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Password"]}," — The user's password."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connection String (TLS)"]}," — The TLS-enabled connection string copied from your Autonomous Database."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Data source name"]}," — A label for the data source in Databox."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Time zone"]}," — The time zone used for interpreting and filtering data points in visualizations."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-1-open-your-database-details","__idx":3},"children":["Step 1: Open your database details"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Oracle Cloud Console"]},", go to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://cloud.oracle.com/db/adbs"},"children":["Autonomous Database"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select your database from the list to open the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.oracle.com/en/cloud/paas/autonomous-database/dedicated/vlscd/index.html"},"children":["Details"]}," page."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-2--configure-the-access-control-list-acl","__idx":4},"children":["Step 2:  Configure the Access control list (ACL)"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Network > Access control list"]},", click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add a new rule for the IP address ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["52.4.198.118"]}," (Databox IP)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["(Optional)"]}," Add your own IP to allow direct access."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Wait for the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Lifecycle State"]}," to change from ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Updating"]}," back to ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Available"]},"."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/integrate-oracle-with-databox_1.ad2ee9447f78c961925a64c7122b4d29d266926c06736771163b05cfb8a24537.4783b0ec.png","alt":"access-control-list","withLightbox":true,"className":"ss-img"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-3--adjust-tls-authentication-settings","__idx":5},"children":["Step 3:  Adjust TLS authentication settings"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Network > Mutual TLS (mTLS) authentication"]},", click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Deselect the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["require Mutual TLS (mTLS) authentication"]}," option."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Wait for the update to complete (",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Updating → Available"]},")."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/integrate-oracle-with-databox_2.6d773a5e593ec5335941922b1cee75f3164f605d7ac9d4a872c3a0f418f728aa.4783b0ec.png","alt":"tls","withLightbox":true,"className":"ss-img"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-4--copy-the-tls-connection-string","__idx":6},"children":["Step 4:  Copy the TLS connection string"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["At the top of the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Details"]}," page, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Database connection"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.oracle.com/en/cloud/paas/autonomous-database/dedicated/vcsad/"},"children":["Connection strings"]}," section, under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["TLS authentication"]},", select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["TLS"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose the preferred TNS name, for example:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["_low"]}," (lowest resource use, for light or infrequent queries)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["_medium"]}," (balanced performance and cost)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["_high"]}," (allocates more resources for heavy queries and reporting)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tp/tpurgent"]}," (optimized for OLTP workloads, with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tpurgent"]}," offering the lowest latency"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["…"]}," menu next to the chosen TNS name and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Copy"]}," to copy the full connection string."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/integrate-oracle-with-databox_3.0bf2a76b66575739a9b2ac5ffdc0239de08ec8f749c65eb263af5eb4c2b67d23.4783b0ec.png","alt":"tls-connection-string","withLightbox":true,"className":"ss-img"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"path-2-other-oracle-setups-on-premises-or-self-managed-cloud","__idx":7},"children":["Path 2: Other Oracle setups (on-premises or self-managed cloud)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For non-Autonomous Oracle connections, you'll need:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Host"]}," — Server hostname or IP address."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Port"]}," — Default is 1521."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Service Name"]}," — Identifier for your Oracle instance."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Username"]}," — Oracle user with read access to the database."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Password"]}," — The user's password."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Data source name"]}," — A label for the data source in Databox."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Time zone"]}," — The time zone used for interpreting and filtering data points in visualizations."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-1-make-sure-your-firewall-or-network-rules-allow-inbound-access-from-databox-ips","__idx":8},"children":["Step 1: Make sure your firewall or network rules allow inbound access from Databox IPs."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-2-create-a-dedicated-read-only-oracle-user-for-example","__idx":9},"children":["Step 2: Create a dedicated read-only Oracle user, for example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"sql","header":{"controls":{"copy":{}}},"source":"CREATE USER databox_user IDENTIFIED BY strong_password;  \nGRANT CREATE SESSION TO databox_user;  \nGRANT SELECT ON schema.table TO databox_user;\n","lang":"sql"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"datasets","__idx":10},"children":["Datasets"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Oracle integration supports the creation of ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/understanding-datasets"},"children":["datasets"]},", which allow you to define and shape the specific data you want to use for reporting in Databox. Datasets make it easier to focus on the most relevant information, enabling you to filter, visualize, and analyze metrics across projects, teams, and clients without writing complex queries each time."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"steps-to-create-a-dataset","__idx":11},"children":["Steps to create a dataset:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Select a table"]},": Pick the appropriate schema within that database."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Select columns"]},": Browse and select the specific columns (fields) from your tables or views to include in your dataset. These columns define the structure and content of your dataset."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"optional-write-sql","__idx":12},"children":["Optional: Write SQL"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more advanced use cases, you can write a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["custom SQL query"]}," instead of selecting columns manually. This allows you to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Join multiple tables"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Apply filters and aggregations"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Format or transform data before importing it into Databox"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your query must return a valid tabular result to be used as a dataset."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"additional-resources","__idx":13},"children":["Additional resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.oracle.com/en/database/oracle/oracle-database/index.html"},"children":["Oracle Database Documentation"]}," — Central hub for Oracle Database docs, including administration, SQL and PL/SQL references, security, backup & recovery, performance, tools, and release notes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.oracle.com/en/cloud/paas/autonomous-database/index.html"},"children":["Oracle Autonomous Database"]}," — Oracle Cloud docs for Autonomous Database: provisioning, connectivity, network access, scaling, administration, data loading, monitoring, and tooling."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"resources","__idx":14},"children":["Resources"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For comprehensive details on metrics, data availability, templates, specifications, usage guidelines, and other key information, refer to the resources listed below."]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":4,"cardMinWidth":240},"children":[{"$$mdtype":"Tag","name":"IntegrationResources","attributes":{"integrationKey":"oracle","hideMetrics":true},"children":[]}]},{"$$mdtype":"Tag","name":"Faq","attributes":{},"children":[{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Do I need to use a wallet to connect Oracle Autonomous Database to Databox?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No. When using TLS (one-way) connections, no wallet is required."]}]},{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Which connection string should I use?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each option represents a different workload profile in Oracle Autonomous Database, and the choice is built into the connection string itself. When you paste a string into Databox, all queries will run under that profile."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you later decide to use a different profile, you'll need to copy the new connection string from the Oracle Cloud Console and update your Databox connection."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[" "]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":4,"cardMinWidth":160},"children":[{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Ask Genie","icon":"genie","to":"https://app.databox.com/genie","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get instant answers or help with your data using the in-app AI assistant."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Talk to an expert","icon":"assistance","to":"https://meetings.hubspot.com/databox-meeting/account-management","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For customers: Get help with your setup, strategy, or making the most of Databox."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Book a demo","icon":"eye-open","to":"https://meetings.hubspot.com/databox-meeting/ref-knowledge-base","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["New to Databox? See how it works and get guidance on getting started."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Send an email","icon":"help","to":"mailto:help@databox.com","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reach out to support for help with your account, data, or technical issues."]}]}]}]},"headings":[{"value":"Integrate Oracle with Databox","id":"integrate-oracle-with-databox","depth":1},{"value":"Connection","id":"connection","depth":2},{"value":"Path 1: Oracle Autonomous Database","id":"path-1-oracle-autonomous-database","depth":3},{"value":"Step 1: Open your database details","id":"step-1-open-your-database-details","depth":4},{"value":"Step 2:  Configure the Access control list (ACL)","id":"step-2--configure-the-access-control-list-acl","depth":4},{"value":"Step 3:  Adjust TLS authentication settings","id":"step-3--adjust-tls-authentication-settings","depth":4},{"value":"Step 4:  Copy the TLS connection string","id":"step-4--copy-the-tls-connection-string","depth":4},{"value":"Path 2: Other Oracle setups (on-premises or self-managed cloud)","id":"path-2-other-oracle-setups-on-premises-or-self-managed-cloud","depth":3},{"value":"Step 1: Make sure your firewall or network rules allow inbound access from Databox IPs.","id":"step-1-make-sure-your-firewall-or-network-rules-allow-inbound-access-from-databox-ips","depth":4},{"value":"Step 2: Create a dedicated read-only Oracle user, for example:","id":"step-2-create-a-dedicated-read-only-oracle-user-for-example","depth":4},{"value":"Datasets","id":"datasets","depth":2},{"value":"Steps to create a dataset:","id":"steps-to-create-a-dataset","depth":3},{"value":"Optional: Write SQL","id":"optional-write-sql","depth":3},{"value":"Additional resources","id":"additional-resources","depth":3},{"value":"Resources","id":"resources","depth":2}],"frontmatter":{"slug":"integrate-oracle-with-databox","seo":{"title":"Integrate Oracle with Databox","description":"Learn how to connect Oracle to Databox and unlock reusable datasets for advanced reporting and visualization."},"metadata":{"userRole":"Users, Editors, and Admins","accountType":"All accounts","plan":"Exclusive to select subscription plans"},"keywords":{"includes":["Oracle integration","connect Oracle to Databox","Oracle Autonomous Database","Oracle TLS connection string","Oracle service name","Oracle ACL access control list","Oracle port 1521","Oracle wallet","mTLS Oracle","Oracle read-only user","Oracle on-premises connection","Oracle dataset custom SQL","whitelist Databox IP Oracle","TNS name Oracle"]}},"lastModified":"2026-04-17T19:27:17.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/integrate-oracle-with-databox","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}