DOCSP-10462 doc for sql support (#27)

* DOCSP-10462 doc for sql support

Author: kanchana-mongodb

snooty.toml

@@ -3,7 +3,7 @@ title = "MongoDB Atlas Data Lake"
 
 intersphinx = ["https://docs.mongodb.com/manual/objects.inv"]
 
-toc_landing_pages = ["/config/config-data-lake", "/tutorial/getting-started"]
+toc_landing_pages = ["/config/config-data-lake", "/tutorial/getting-started", "/admin/query-with-sql"]
 
 [constants]
 adl = "Atlas Data Lake"

source/admin/query-with-sql.txt

@@ -0,0 +1,71 @@
+.. _query-with-sql:
+
+=================
+Querying with SQL
+=================
+
+.. default-domain:: mongodb
+
+.. include:: /includes/fact-sql-beta-message.rst
+
+{+adl+} supports SQL format queries through the :ref:`JDBC driver 
+<jdbc-driver>` for {+adl+} and using the :ref:`adl-sql-stage` 
+:ref:`aggregation pipeline <adl-aggregation-pipeline>` stage. To support 
+SQL format queries, {+adl+} automatically creates a |json| schema that maps 
+to a relational schema of columns, tables, and databases for all new 
+collections, except wildcard (``*``) collections, and views in the {+dl+} 
+storage configuration. To learn more about the schema, see 
+:ref:`sql-schema-format`.
+
+{+dl+} automatically generates a schema for a new non-wildcard collection or 
+view in the storage configuration when you: 
+
+- :ref:`Create <dl-create-collection-views-cmd>` the collection or view 
+  in the storage configuration.
+
+- :ref:`Rename <dl-rename-collection-cmd>` a collection or view that does not 
+  already have a schema. If you rename a collection or view that already has 
+  a schema, the schema is also renamed. {+dl+} does not generate a new schema 
+  for a renamed collection or view if it already exists.
+
+- :ref:`Set <datalake-setstorageconfig>` the storage configuration.
+
+.. include:: /includes/fact-schema-for-existing-collections.rst
+
+By default, {+dl+} samples data from only one randomly selected document in 
+your non-wildcard collection or view to generate a |json| schema. If your 
+collection or view contains polymorphic data, you can provide a larger 
+sampling size to {+dl+} to generate a new schema or you can manually 
+construct and set the schema. 
+
+You can manually generate schemas for all collections and views using the 
+:ref:`sqlgenerateschema-cmd` command, set or update the schema for your 
+collections or views using the :ref:`sqlsetschema-cmd` command, and view 
+the stored schema using the :ref:`sqlgetschema-cmd` command. 
+
+Once the SQL schema is set up, you can query your {+adl+} collections or views 
+through the :ref:`JDBC driver <jdbc-driver>` for {+adl+} and using the 
+:ref:`adl-sql-stage` :ref:`aggregation pipeline <adl-aggregation-pipeline>` 
+stage. 
+
+You can manually delete a schema for a collection or view by running the 
+:ref:`sqlsetschema-cmd` command with an empty schema document. {+dl+} 
+automatically removes the schema for a collection or view when you: 
+
+- :ref:`Drop the collection or view <dl-drop-collection-views-cmd>` from the 
+  storage configuration.
+- :ref:`Modify the storage configuration <datalake-setstorageconfig>` to 
+  remove the collection or view from the storage configuration.
+- :ref:`Drop the database <dl-drop-database-cmd>` that contains the collection 
+  or view from the storage configuration.
+
+.. class:: hidden
+
+   .. toctree::
+      :titlesonly:
+
+      SQL Schema Format </reference/config-files/sql-schema-format>
+      Generate SQL Schema </reference/cli/sql/sqlgenerateschema>
+      Set SQL Schema </reference/cli/sql/sqlsetschema>
+      Retrieve SQL Schema </reference/cli/sql/sqlgetschema>
+      Connect Using JDBC Driver </tutorial/jdbc-driver>

source/images/jdbc-driver-maven-project-dependency.png

@@ -0,0 +1,13 @@
+Consider a collection named ``egData`` in a database named 
+``sampleDB`` with the following documents: 
+
+.. code-block:: json 
+
+   {"a": {"b": {"c": [1, 2, 3]}}, "s": 1}
+   {"a": {"b": {"c": [4, 5, 6]}}, "s": 2}
+   {"a": {"b": [7, 8, 9]}, "s": 3}
+   {"a": {"b": {"c": []}}, "s": 4}
+   {"a": {"b": {"c": "hello"}}, "s": 5}
+   {"a": {"b": {"c": {"d": 1}}}, "s": 6}
+   {"a": {"b": {"c": null}}}
+   {"s": 7}

source/images/jdbc-driver-maven-project-setup.png

@@ -0,0 +1,10 @@
+.. note:: 
+
+   {+dl+} automatically generates schemas for only new collections and 
+   views in the :ref:`storage configuration <datalake-configuration-file>`.
+   Existing :manual:`namespaces </reference/limits/#faq-dev-namespace>` 
+   will not have auto-generated schemas. If you want {+dl+} to automatically 
+   generate schemas for your existing non-wildcard collections and views in 
+   the storage configuration, :ref:`remove <datalake-setstorageconfig>` the :datalakeconf:`databases` in your {+dl+} storage configuration and then 
+   :ref:`update <datalake-setstorageconfig>` your {+dl+} storage 
+   configuration with the old configuration.

source/images/scalar-lattice.png

@@ -0,0 +1,6 @@
+.. admonition:: Beta
+   :class: note
+
+   The support for SQL format queries is available as a Beta feature. 
+   The feature and the corresponding documentation may change at any 
+   time during the Beta stage.