Skip to content

Commit 93666b1

Browse files
DOCSP-19083 reorganize pages in ADL (#217)
* DOCSP-19083 reorganize pages in ADL * DOCSP-19083 updates for review feedback * DOCSP-19083 updates for tutorial page
1 parent 6ba4469 commit 93666b1

20 files changed

+253
-646
lines changed

config/redirects

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,3 +4,6 @@ raw: /datalake/reference/cli/datalake-cli -> ${base}/reference/cli/administratio
44
raw: /datalake/reference/config-files/data-lake-configuration -> ${base}/reference/format/data-lake-configuration/
55
raw: /datalake/reference/config-files/sql-schema-format -> ${base}/reference/format/sql-schema-format/
66
raw: /datalake/tutorial/load-sample-data -> ${base}/tutorial/deploy/
7+
raw: /datalake/config/manage-stores-cli -> ${base}/config/config-data-lake/#set-or-update-data-lake-configuration
8+
raw: /datalake/config/manage-dbs-cli -> ${base}/config/config-data-lake/#set-or-update-data-lake-configuration
9+
raw: /datalake/config/manage-collections-views-cli -> ${base}/config/config-data-lake/#set-or-update-data-lake-configuration

snooty.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title = "MongoDB Atlas Data Lake"
33

44
intersphinx = ["https://docs.mongodb.com/manual/objects.inv","https://docs.atlas.mongodb.com/objects.inv","https://docs.mongodb.com/database-tools/objects.inv","https://docs.mongodb.com/mongodb-shell/objects.inv"]
55

6-
toc_landing_pages = ["/config/config-data-lake", "/tutorial/getting-started", "/admin/query-with-sql", "/query/query-data-lake", "/tutorial/connect", "/supported-unsupported/mql-support", "/tutorial/configure-connection"]
6+
toc_landing_pages = ["/config/config-data-lake", "/tutorial/getting-started", "/admin/query-with-sql", "/query/query-data-lake", "/tutorial/connect", "/supported-unsupported/mql-support", "/tutorial/configure-connection", "/reference/api/datalakes-api", "/reference/cli/administration-commands", "/reference/pipeline/aggr-pipeline", "/tutorials" ]
77

88
[constants]
99
adl = "Atlas Data Lake"

source/admin/optimize-query-performance.txt

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
.. _optimize-query-perf:
22

3-
======================================
4-
Optimize |data-lake| Query Performance
5-
======================================
3+
==================================
4+
Optimization for Query Performance
5+
==================================
66

77
.. default-domain:: mongodb
88

source/admin/query-with-sql.txt

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
.. _query-with-sql:
22

3-
=================
4-
Querying with SQL
5-
=================
3+
==============
4+
Query with SQL
5+
==============
66

77
.. default-domain:: mongodb
88

source/administration.txt

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -10,16 +10,16 @@ This section contains the following:
1010

1111
- :ref:`Managing Namespace Metadata Catalog for Wildcard Collections
1212
<manage-ns-catalog-cli>`
13-
- :ref:`Optimizing Query Performance <optimize-query-perf>`
1413
- :ref:`Determining Query Status <determine-query-status>`
1514

1615
.. toctree::
1716
:titlesonly:
1817
:hidden:
1918

20-
/config/manage-stores-cli
21-
/config/manage-dbs-cli
22-
/config/manage-collections-views-cli
2319
/admin/manage-namespace-catalog-cli
2420
/admin/manage-private-endpoint
2521
/config/update-region
22+
/admin/determine-query-status
23+
/admin/terminate-running-query
24+
/query/view-query-history
25+
/query/download-query-logs

source/billing.txt

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
.. _atlas-data-lake-billing:
2+
3+
{+adl+} Costs
4+
---------------------
5+
6+
You incur |service| |data-lake| costs for the following items:
7+
8+
- Storage on the cloud object storage
9+
- Data processed by |data-lake|
10+
- Data returned by |data-lake|
11+
12+
Total Data Processed
13+
~~~~~~~~~~~~~~~~~~~~
14+
15+
|service| charges for the total number of bytes that |data-lake|
16+
processes from your |aws| S3 buckets, rounded up to the nearest
17+
megabyte. |service| charges **$5.00 per TB** of processed data, with a
18+
minimum of **10 MB** or **$0.00005 per query**.
19+
20+
.. include:: /includes/fact-partition-cost-benefit.rst
21+
22+
You can use partitioning strategies and compression in |aws| |s3| to
23+
reduce the amount of processed data.
24+
25+
Total Data Returned
26+
~~~~~~~~~~~~~~~~~~~
27+
28+
|service| charges for the total number of bytes returned by
29+
|data-lake|. This total is the sum of the following data transfers:
30+
31+
- The number of bytes transferred between |data-lake| service nodes
32+
- The number of bytes transferred from |data-lake| to the client
33+
34+
Returned data is billed as outlined in the :guilabel:`Data Transfer
35+
Fees` section of the `Atlas pricing page
36+
<https://www.mongodb.com/cloud/atlas/pricing?tck=docs_atlas>`_. The
37+
cost of data transfer depends on the Cloud Service Provider charges
38+
for same-region, region-to-region, or region-to-internet data transfer.

source/config/config-data-lake.txt

Lines changed: 5 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -72,20 +72,7 @@ updating the {+dl+} configuration by running the
7272

7373
To set or update the storage configuration through the |service| UI:
7474

75-
1. From the |service| UI, select :guilabel:`Data Lake` from the
76-
left-hand navigation.
77-
78-
#. Click :guilabel:`Configuration` for the {+data-lake-short+} that you
79-
want to update.
80-
81-
.. figure:: /images/set-update-config-ui.png
82-
:figwidth: 600px
83-
:alt: Image highlighting the Configuration button.
84-
85-
#. Make any necessary changes to the :ref:`storage configuration
86-
<datalake-configuration-file>`.
87-
88-
#. Click :guilabel:`Save` for the changes to take effect.
75+
.. include:: /includes/steps/manage-storage-configuration-ui.rst
8976

9077
.. important::
9178

@@ -96,6 +83,9 @@ To set or update the storage configuration through the |service| UI:
9683
connect. If you are already connected, you might have to
9784
disconnect and reconnect to use the most recent storage configuration.
9885

86+
You can also set and manage the storage configuration using the
87+
:ref:`adl-cli`.
88+
9989
.. _datalake-validatestorageconfig:
10090

10191
Validate {+data-lake-short+} Configuration
@@ -380,4 +370,5 @@ To learn more about the configuration settings, see
380370
/reference/format/data-lake-configuration
381371
/reference/examples/path-syntax-examples
382372
/supported-unsupported/supported-partition-attributes
373+
/admin/optimize-query-performance
383374
/supported-unsupported/encryption

source/config/manage-collections-views-cli.txt

Lines changed: 0 additions & 42 deletions
This file was deleted.

source/config/manage-dbs-cli.txt

Lines changed: 0 additions & 33 deletions
This file was deleted.

source/config/manage-stores-cli.txt

Lines changed: 0 additions & 34 deletions
This file was deleted.

0 commit comments

Comments
 (0)