[DOCS] Add an Expectation using the GX Cloud API

docs/docusaurus/docs/cloud/connect/connect_databrickssql.md

@@ -42,5 +42,5 @@ import Tabs from '@theme/Tabs';
 
 ## Next steps
 
-- [Add an Expectation](/cloud/expectations/manage_expectations.md#add-an-expectation).
+- [Add an Expectation](/cloud/expectations/manage_expectations.md#create-an-expectation).
 - [Run a Validation](/cloud/validations/run_validations.md).

docs/docusaurus/docs/cloud/connect/connect_postgresql.md

@@ -41,7 +41,7 @@ import Tabs from '@theme/Tabs';
 
 ## Next steps
 
-- [Add an Expectation](/cloud/expectations/manage_expectations.md#add-an-expectation).
+- [Add an Expectation](/cloud/expectations/manage_expectations.md#create-an-expectation).
 - [Run a Validation](/cloud/validations/run_validations.md).
 
 

docs/docusaurus/docs/cloud/connect/connect_redshift.md

@@ -72,6 +72,6 @@ description: Connect GX Cloud to a Redshift Data Source.
 
 ## Next steps
 
-- [Add an Expectation](/cloud/expectations/manage_expectations.md#add-an-expectation).
+- [Add an Expectation](/cloud/expectations/manage_expectations.md#create-an-expectation).
 - [Run a Validation](/cloud/validations/run_validations.md).
 

docs/docusaurus/docs/cloud/connect/connect_s3.md

@@ -159,7 +159,7 @@ Keep the following limitations in mind when working with S3 Data Sources.
 
 - S3 Data Source connections cannot be edited in the GX Cloud UI. Use the GX Cloud API if you need to [edit the connection](/cloud/data_sources/manage_data_sources.md#edit-data-source-settings).
 - S3 Data Assets cannot be added through the GX Cloud UI. Use the GX Cloud API to [add more Data Assets](/docs/cloud/data_assets/manage_data_assets.md?interface=api#add-a-data-asset-from-an-existing-data-source) from your S3 Data Source.
-- When you add an S3 Data Asset, Expectations for Anomaly Detection are not automatically generated. You can [generate Anomaly Detection Expectations](/docs/cloud/expectations/manage_expectations#add-an-expectation) after the Data Asset is created.
+- When you add an S3 Data Asset, Expectations for Anomaly Detection are not automatically generated. You can [generate Anomaly Detection Expectations](/docs/cloud/expectations/manage_expectations#create-an-expectation) after the Data Asset is created.
 - ExpectAI is not supported.
 - Data Asset metrics are not automatically fetched. You can [manually profile data](/docs/cloud/data_assets/manage_data_assets.md#view-data-asset-metrics) to return all available metrics for an S3 Data Asset.
 - Custom SQL and multi-source Expectations are not supported.

docs/docusaurus/docs/cloud/connect/connect_snowflake.md

@@ -53,7 +53,7 @@ description: Connect GX Cloud to a Snowflake Data Source.
 
 ## Next steps
 
-- [Add an Expectation](/cloud/expectations/manage_expectations.md#add-an-expectation).
+- [Add an Expectation](/cloud/expectations/manage_expectations.md#create-an-expectation).
 - [Run a Validation](/cloud/validations/run_validations.md).
 
 

docs/docusaurus/docs/cloud/data_assets/manage_data_assets.md

@@ -115,7 +115,7 @@ To add a Data Asset from an existing Data Source using the GX Cloud API, complet
 
 </Tabs>
 
-Now you can [add an Expectation](/cloud/expectations/manage_expectations.md#add-an-expectation) for your new Data Asset.
+Now you can [add an Expectation](/cloud/expectations/manage_expectations.md#create-an-expectation) for your new Data Asset.
 
 ## View Data Asset metrics
 

docs/docusaurus/docs/cloud/expectations/examples/create_an_expectation.py

@@ -0,0 +1,48 @@
+"""
+This is an example script for creating an expectation with preset parameters.
+
+To test, run:
+pytest --docs-tests -k "doc_example_create_an_expectation_for_cloud" tests/integration/test_script_runner.py
+"""
+
+
+def set_up_context_for_example(context):
+    pass
+
+
+# EXAMPLE SCRIPT STARTS HERE:
+import great_expectations as gx
+
+context = gx.get_context()
+# Hide this
+set_up_context_for_example(context)
+
+# All Expectations are found in the `gx.expectations` module.
+# This Expectation has all values set in advance:
+# <snippet name="docs/docusaurus/docs/cloud/expectations/examples/create_an_expectation.py - preset expectation">
+expectation = gx.expectations.ExpectColumnMaxToBeBetween(
+    column="passenger_count", min_value=1, max_value=6, severity="warning"
+)
+# </snippet>
+
+# Expectations need to be added to an Expectation Suite before being associated with a Data Asset.
+# Create the Expectation Suite and add it to your Data Context
+# <snippet name="docs/docusaurus/docs/cloud/expectations/examples/create_an_expectation.py - create expectation suite">
+suite_name = "my_expectation_suite"
+suite = gx.ExpectationSuite(name=suite_name)
+context.suites.add(suite)
+# </snippet>
+
+# Optional. If you have an existing Expectation Suite you'd like to use, get it from the Data Context.
+# <snippet name="docs/docusaurus/docs/cloud/expectations/examples/create_an_expectation.py - get expectation suite">
+existing_suite_name = (
+    "my_expectation_suite"  # replace this with the name of your Expectation Suite
+)
+suite = context.suites.get(name=existing_suite_name)
+# </snippet>
+
+# Add the Expectation to the Expectation Suite.
+# <snippet name="docs/docusaurus/docs/cloud/expectations/examples/create_an_expectation.py - add expectation to suite">
+suite.add_expectation(expectation)
+suite.save()
+# </snippet>

docs/docusaurus/docs/cloud/expectations/expectations_overview.md

@@ -28,6 +28,8 @@ The following table lists the available GX Cloud Expectations. Note that some Da
 | Numeric            | **column values to be between**                        | Expect the column entries to be between a minimum value and a maximum value.                                                           | No                  | No                |
 | Numeric            | **column z scores to be less than**                    | Expect the Z-scores of a column's values to be less than a given threshold.                                                            | No                  | No                |
 | Numeric            | **multicolumn sum to equal**                           | Expect that the sum of row values in a specified column list is the same for each row, and equal to a specified sum total.             | No                  | No                |
+| Numeric            | **column KL divergence to be less than***               | Expect the Kulback-Leibler (KL) divergence (relative entropy) of the specified column with respect to the partition object to be lower than the provided threshold.         | No              | No              |
+| Numeric            | **column quantile values to be between***               | Expect the specific provided column quantiles to be between a minimum value and a maximum value. | No | No |
 | Schema             | **column to exist**                                    | Checks for the existence of a specified column within a table or view.                                                                 | No                  | No                |
 | Schema             | **column values to be in type list**                   | Expect a column to contain values from a specified type list.                                                                          | No                  | No                |
 | Schema             | **column values to be of type**                        | Expect a column to contain values of a specified data type.                                                                            | No                  | No                |
@@ -46,6 +48,7 @@ The following table lists the available GX Cloud Expectations. Note that some Da
 | Uniqueness         | **select column values to be unique within record**    | Expect the values for each record to be unique across the columns listed. Note that records can be duplicated.                         | No                  | No                |
 | Validity           | **column most common value to be in set**              | Expect the most common value to be within the designated value set.                                                                    | No                  | No                |
 | Validity           | **column pair values to be equal**                     | Expect the values in column A to be the same as column B.                                                                              | No                  | No                |
+| Validity           | **column pair values to be in set***                    | Expect the paired values from columns A and B to belong to a set of valid pairs.                                                     | No                   | No               |
 | Validity           | **column value lengths to be between**                 | Expect the column entries to be strings with length between a minimum value and a maximum value.                                       | No                  | No                |
 | Validity           | **column value lengths to equal**                      | Expect the column entries to be strings with length equal to the provided value.                                                       | No                  | No                |
 | Validity           | **column values to be in set**                         | Expect each column value to be in a given set.                                                                                         | No                  | No                |
@@ -62,6 +65,7 @@ The following table lists the available GX Cloud Expectations. Note that some Da
 | Volume             | **table row count to equal**                           | Expect the number of rows to equal a value.                                                                                            | No                  | No                |
 | Volume             | **table row count to equal other table**               | Expect the number of rows to equal the number in another table or view within the same database.                                       | No                  | No                |
 
+*Configurable through only the GX Cloud API. 
 
 ## Custom SQL Expectations
 
@@ -93,7 +97,7 @@ The percentage of identical rows is computed by dividing the number of matching
 | 100                   | 25                          | 1            | 1%                           |
 | 0                     | 0                           | 0            | 100%                         |
 
-To create a Multi-source Expectation, [add the **expect query results to match comparison** Expectation](/cloud/expectations/manage_expectations.md#add-an-expectation) on the base Data Source. Each provided query should be written in the dialect of the associated Data Source.
+To create a Multi-source Expectation, [add the **expect query results to match comparison** Expectation](/cloud/expectations/manage_expectations.md#create-an-expectation) on the base Data Source. Each provided query should be written in the dialect of the associated Data Source.
 
 Keep the following limitations in mind when working with Multi-source Expectations:
 - The comparison is limited to the first 200 rows of each query result. If you anticipate that a query will return more than 200 rows, use an `ORDER BY` clause to control what is surfaced first for comparison.
@@ -102,7 +106,7 @@ Keep the following limitations in mind when working with Multi-source Expectatio
 
 ## Anomaly Detection
 
-Anomaly Detection Expectations evolve with your data to detect deviations from historical patterns. To speed up their creation, you can generate Anomaly Detection Expectations when you use the GX Cloud UI to [create new Data Assets](/cloud/data_assets/manage_data_assets.md#add-a-data-asset-from-an-existing-data-source) or [add Expectations](/cloud/expectations/manage_expectations.md#add-an-expectation). Note that [some Data Sources](/docs/cloud/data_sources/manage_data_sources.md#workflow-and-feature-support) don't support these options. All Data Sources support manual configuration of Anomaly Detection by adding Expectations with Dynamic Parameters or forecasted ranges.
+Anomaly Detection Expectations evolve with your data to detect deviations from historical patterns. To speed up their creation, you can generate Anomaly Detection Expectations when you use the GX Cloud UI to [create new Data Assets](/cloud/data_assets/manage_data_assets.md#add-a-data-asset-from-an-existing-data-source) or [add Expectations](/cloud/expectations/manage_expectations.md#create-an-expectation). Note that [some Data Sources](/docs/cloud/data_sources/manage_data_sources.md#workflow-and-feature-support) don't support these options. All Data Sources support manual configuration of Anomaly Detection by adding Expectations with Dynamic Parameters or forecasted ranges.
 
 ### Dynamic Parameters