|
1 |
| -.. _bi-connector: |
| 1 | +:template: product-landing |
| 2 | +:hidefeedback: header |
| 3 | +:noprevnext: |
2 | 4 |
|
3 |
| -======================== |
4 |
| -MongoDB Connector for BI |
5 |
| -======================== |
| 5 | +==================================== |
| 6 | +What is the MongoDB Connector for BI |
| 7 | +==================================== |
6 | 8 |
|
7 |
| -.. default-domain:: mongodb |
| 9 | +.. introduction:: |
8 | 10 |
|
9 |
| -About the |bi| |
10 |
| --------------- |
| 11 | + Traditional business intelligence tools are designed to work with |
| 12 | + tabular, row-and-column data. The MongoDB Connector for BI allows you |
| 13 | + query MongoDB data with SQL using tools such as Tableau, Power BI, |
| 14 | + and Excel. |
11 | 15 |
|
12 |
| -.. include:: /includes/fact-bi-enterprise.rst |
| 16 | + .. button:: Download the MongoDB Connector for BI |
| 17 | + :uri: /local-quickstart |
13 | 18 |
|
14 |
| -The MongoDB Connector for Business Intelligence (BI) allows users to |
15 |
| -create queries with |sql| and visualize, graph, and report on their |
16 |
| -MongoDB Enterprise data using existing relational business intelligence |
17 |
| -tools such as :doc:`Tableau </connect/tableau>`, |
18 |
| -:doc:`MicroStrategy </connect/microstrategy>`, and |
19 |
| -:doc:`Qlik </connect/qlik>`. |
| 19 | + :doc:`Get Started </local-quickstart>` |
20 | 20 |
|
21 |
| -.. note:: |
| 21 | +.. image:: /images/hero.png |
| 22 | + :alt: MongoDB Connector for BI homepage hero image |
22 | 23 |
|
23 |
| - As an alternative to using third-party data visualization tools and |
24 |
| - the |bi-short|, you can use :charts:`MongoDB Charts </>` to create |
25 |
| - data visualizations directly from your MongoDB collections. |
| 24 | +.. kicker:: What You Can Do |
26 | 25 |
|
27 |
| -The |bi| acts as a layer that translates queries and data between a |
28 |
| -|mongod| or |mongos| instance and your reporting tool. The |bi-short| |
29 |
| -stores no data, and purely serves to bridge your MongoDB cluster with |
30 |
| -business intelligence tools. |
| 26 | +Use Your Favorite BI Tools with MongoDB Data |
| 27 | +-------------------------------------------- |
31 | 28 |
|
32 |
| -.. figure:: /images/bi-connector/components-all.jpg |
33 |
| - :figwidth: 700px |
34 |
| - :align: center |
35 |
| - :alt: Diagram showing that other BI tools communicate with the DSN, which communicates with MongoDB's BI Connector, which in turn communicates with the MongoDB database. |
| 29 | +|bi| makes it easy to create powerful visualizations of your MongoDB |
| 30 | +data with popular analysis tools. |
36 | 31 |
|
37 |
| -System Components |
38 |
| ------------------ |
| 32 | +.. tabs:: |
39 | 33 |
|
40 |
| -A complete BI system includes the following components: |
| 34 | + .. tab:: Run SQL queries against collections |
| 35 | + :tabid: sql |
41 | 36 |
|
42 |
| -MongoDB database |
43 |
| - Data storage. |
| 37 | + .. procedure:: |
44 | 38 |
|
45 |
| -BI Connector |
46 |
| - Provides a relational schema and translates |sql| |
47 |
| - queries between your BI tool and MongoDB. |
| 39 | + .. step:: Enable |bi| for your {+atlas-short+} cluster |
48 | 40 |
|
49 |
| -ODBC data source name (DSN) |
50 |
| - Holds authentication and connection configuration data. |
| 41 | + Host the {+bi-full+} in {+atlas+}. |
51 | 42 |
|
52 |
| -BI Tool Data visualization and analysis. |
| 43 | + To learn more, see :doc:`Enable the BI Connector in Atlas </atlas-bi-connector>`. |
53 | 44 |
|
54 |
| -Most BI tools can import data from a |
55 |
| -:doc:`DSN </tutorial/create-system-dsn>`. Configure a |dsn| to |
56 |
| -point to your |bi-short| instance. This provides you a wide range of |
57 |
| -BI tools and |sql| clients with a single data source configuration. |
| 45 | + .. step:: Query MongoDB databases using SQL |
58 | 46 |
|
59 |
| -Your BI tool and your |dsn| always run on your local desktop, but your |
60 |
| -database and your |bi-short| instance may be local, on premises, or |
61 |
| -hosted. The following sections describe possible configurations for a |
62 |
| -BI system. |
| 47 | + Use SQL to run queries against MongoDB collections, |
| 48 | + including joins, subqueries, and aggregate functions. |
63 | 49 |
|
64 |
| -Hosted Database and |bi-short| |
65 |
| ------------------------------- |
| 50 | + To learn more, see :doc:`Connect from the MySQL Client |
| 51 | + </connect/mysql>`. |
66 | 52 |
|
67 |
| -.. note:: |
| 53 | + .. image:: /images/Tab1_illo.png |
| 54 | + :alt: Connect to a MongoDB database from the MySQL Client |
68 | 55 |
|
69 |
| - If you don’t want to install and manage the |bi-short|, you can use |
70 |
| - {+atlas+}, our fully-managed database-as-a-service. Databases hosted |
71 |
| - on {+atlas+} natively support the |bi| and make it easy to start |
72 |
| - analyzing your data with your preferred BI tools. To get started, |
73 |
| - :website:`create an {+atlas+} cluster </cloud/atlas/lp/general>`. |
| 56 | + .. tab:: Visualize MongoDB data with Tableau |
| 57 | + :tabid: tableau |
74 | 58 |
|
75 |
| -In this scenario, the database and |bi-short| applications both run on |
76 |
| -{+atlas+}, and you set up your :doc:`DSN </tutorial/create-system-dsn>` |
77 |
| -with connection information that {+atlas+} provides. |
| 59 | + .. procedure:: |
78 | 60 |
|
79 |
| -.. figure:: /images/bi-connector/components-cloud.jpg |
80 |
| - :alt: Hosted DB and BI Connector |
81 |
| - :figwidth: 700px |
82 |
| - :align: center |
| 61 | + .. step:: Install |bi| for your platform |
83 | 62 |
|
84 |
| -Hosted Database and On Premises |bi-short| |
85 |
| ------------------------------------------- |
| 63 | + |bi| is available for Windows, macOS, and Linux. |
86 | 64 |
|
87 |
| -If you have an {+atlas+} deployment smaller than M10 (including the |
88 |
| -{+atlas+} :atlas:`free tier </getting-started/>`), or if your MongoDB |
89 |
| -instance is not hosted on {+atlas+}, you can run |bi-short| locally and |
90 |
| -specify a remote database address with the |
91 |
| -:option:`--mongo-uri <mongosqld --mongo-uri>` option when you start |
92 |
| -the BI Connector's :doc:`mongosqld process </reference/mongosqld>`. |
| 65 | + :doc:`Download the MongoDB Connector for BI </installation>` |
93 | 66 |
|
94 |
| -.. figure:: /images/bi-connector/components-onprem-bi-atlas.jpg |
95 |
| - :alt: On Premises DB and Local BI Connector |
96 |
| - :figwidth: 700px |
97 |
| - :align: center |
| 67 | + .. step:: Create visualizations of MongoDB data with Tableau |
98 | 68 |
|
99 |
| -On Premises Database and |bi-short| |
100 |
| ------------------------------------ |
| 69 | + Many business intelligence visualization tools can't |
| 70 | + communicate with MongoDB databases using MongoDB Query |
| 71 | + Language. |bi| translates MQL into SQL, enabling |
| 72 | + communication with any BI tool that uses |jdbc| or |odbc| |
| 73 | + connections. |
101 | 74 |
|
102 |
| -Your organization may have installations of both MongoDB and |bi-short| |
103 |
| -elsewhere on your network, in which case you can set up your |
104 |
| -:doc:`DSN </tutorial/create-system-dsn>` to point to the |bi-short| |
105 |
| -server address. |
| 75 | + To learn more, see :ref:`connect-tableau-auth`. |
106 | 76 |
|
107 |
| -.. figure:: /images/bi-connector/components-onprem.jpg |
108 |
| - :alt: On Premises DB and BI Connector |
109 |
| - :figwidth: 700px |
110 |
| - :align: center |
| 77 | + .. image:: /images/Tab2_illo.png |
| 78 | + :alt: Use Tableau with MongoDB Databases |
111 | 79 |
|
112 |
| -Local Database and |bi-short| |
113 |
| ------------------------------ |
| 80 | + .. tab:: Analyze MongoDB data with Excel |
| 81 | + :tabid: excel |
114 | 82 |
|
115 |
| -For testing and all-in-one-box local experimentation, you can run |
116 |
| -MongoDB and |bi-short| on your desktop. This is the simplest |
117 |
| -configuration, perfect for quickly looking over the possibilities for |
118 |
| -data visualization with |bi-short|. |
| 83 | + .. procedure:: |
119 | 84 |
|
120 |
| -Learn more about setting up a local |bi-short| test installation |
121 |
| -in the :doc:`Quick Start Guide </local-quickstart>`. |
| 85 | + .. step:: Create a Data Source Name (DSN) |
122 | 86 |
|
| 87 | + A DSN is a saved configuration with authentication |
| 88 | + credentials and |odbc| driver information. |
| 89 | + |
| 90 | + To learn more, see :doc:`Create a System DSN |
| 91 | + </tutorial/create-system-dsn>`. |
| 92 | + |
| 93 | + .. step:: Analyze MongoDB data with Excel |
| 94 | + |
| 95 | + Connect MongoDB with Excel via an |odbc| connector. |
| 96 | + |
| 97 | + To learn more, see :doc:`Connect from Microsoft Excel |
| 98 | + </connect/excel>`. |
| 99 | + |
| 100 | + .. image:: /images/Tab3_illo.png |
| 101 | + :alt: Analyze MongoDB data with Excel |
| 102 | + |
| 103 | +.. kicker:: Related Products & Resources |
| 104 | + |
| 105 | +Go Further with the |bi| |
| 106 | +------------------------ |
| 107 | + |
| 108 | +Explore |bi|\'s advanced features. |
| 109 | + |
| 110 | +.. card-group:: |
| 111 | + :columns: 3 |
| 112 | + :style: compact |
| 113 | + |
| 114 | + .. card:: |
| 115 | + :cta: Learn about Schemas |
| 116 | + :url: https://docs.mongodb.com/bi-connector/current/schema-configuration/ |
| 117 | + :icon: /images/drivers-connectors-icon.svg |
| 118 | + :icon-alt: MongoDB BI Connector icon |
| 119 | + |
| 120 | + Auto-generate a schema based on your data |
| 121 | + |
| 122 | + .. card:: |
| 123 | + :cta: Learn about Views |
| 124 | + :url: https://docs.mongodb.com/bi-connector/current/schema/use-views/ |
| 125 | + :icon: /images/drivers-connectors-icon.svg |
| 126 | + :icon-alt: MongoDB BI Connector icon |
| 127 | + |
| 128 | + Control data access with MongoDB Views |
| 129 | + |
| 130 | + .. card:: |
| 131 | + :cta: View Charts Docs |
| 132 | + :url: https://docs.mongodb.com/charts/saas/ |
| 133 | + :icon: /images/charts-icon.svg |
| 134 | + :icon-alt: MongoDB Charts icon |
| 135 | + |
| 136 | + Visually explore your data with MongoDB Charts. |
123 | 137 |
|
124 | 138 | .. toctree::
|
125 | 139 | :titlesonly:
|
126 | 140 |
|
| 141 | + Overview </index> |
| 142 | + </what-is-the-bi-connector> |
127 | 143 | Quick Start Guide </local-quickstart>
|
128 | 144 | /atlas-bi-connector
|
129 | 145 | Install BI Connector</installation>
|
|
0 commit comments