Release notes soda-agent 1.1.21 soda-library 1.5.20 (#839)

Author: janet-can

_includes/single-quotes.md

@@ -0,0 +1,3 @@
+**Problem:** Using an `invalid_count` check, the list of `valid_values` includes a value with a single quote, such as `Tuesday's orders`. During scanning, he check results in and error because it does not recognize the special character.
+
+**Solution:** When using single-quoted strings, any single quote `'` inside its contents must be doubled to escape it. For example, `Tuesday''s orders`.

_release-notes/soda-agent-1.1.21.md

@@ -0,0 +1,10 @@
+---
+name: "1.1.21"
+date: 2024-07-24
+products:
+  - soda-agent
+---
+## 1.1.21
+
+This release maps to [Soda Library 1.5.19]({% link release-notes/soda-library.md %}). <br />
+Access [Soda documentation]({% link soda/upgrade.md %}#upgrade-a-soda-agent) for instructions to upgrade a Soda Agent helm chart to use the latest version of Soda Library.

_release-notes/soda-library-1.5.20.md

@@ -0,0 +1,10 @@
+---
+name: "1.5.20"
+date: 2024-07-24
+products:
+  - soda-library
+---
+
+## 1.5.20 Fixes
+
+* Fix: make sure labelling incorrect anomalies always returns something by @bastienboutonnet in #265

soda-cl/troubleshoot.md

@@ -20,7 +20,8 @@ parent: SodaCL reference
 [Failed row check with CTE error](#failed-row-check-with-cte-error)<br />
 [Errors with column names containing periods or colons](#errors-when-column-names-containing-periods-or-colons)<br />
 [Errors when using in-check filters](#errors-when-using-in-check-filters)<br />
-[Using reference checks with Spark DataFrames](#using-reference-checks-with-spark-dataframes)
+[Using reference checks with Spark DataFrames](#using-reference-checks-with-spark-dataframes)<br />
+[Single quotes in valid values list result in error](#single-quotes-in-valid-values-list-result-in-error)<br />
 <br />
 
 <hr/>
@@ -236,6 +237,10 @@ checks for my_dataset:
 {% include reference-with-spark.md %}
 
 
+## Single quotes in valid values list result in error
+
+{% include single-quotes.md %}
+
 
 ## Go further
 

soda-cl/validity-metrics.md

@@ -52,6 +52,7 @@ checks for dim_customer:
 [Define checks with validity metrics](#define-checks-with-validity-metrics) <br />
 &nbsp;&nbsp;&nbsp;&nbsp;[Specify valid or invalid values](#specify-valid-or-invalid-values)<br />
 &nbsp;&nbsp;&nbsp;&nbsp;[Specify valid format](#specify-valid-format)<br />
+&nbsp;&nbsp;&nbsp;&nbsp;[Troubleshoot valid format and values](#troubleshoot-valid-format-and-values)<br />
 &nbsp;&nbsp;&nbsp;&nbsp;[Failed row samples](#failed-row-samples)<br />
 [Optional check configurations](#optional-check-configurations)<br />
 [List of validity metrics](#list-of-validity-metrics)<br />
@@ -193,7 +194,7 @@ checks for dim_customer:
 
 <br />
 
-#### Troubleshoot valid format
+### Troubleshoot valid format and values
 
 **Problem:** You are using a `valid format` to test the format of values in a column and the CLI returns the following error message when you run a scan. 
 
@@ -209,6 +210,10 @@ Error occurred while executing scan.
 
 <br />
 
+{% include single-quotes.md %}
+
+<br />
+
 ### Failed row samples
 
 Checks with validity metrics automatically collect samples of any failed rows to display Soda Cloud. The default number of failed row samples that Soda collects and displays is 100. 

soda/connect-troubleshoot.md

@@ -11,6 +11,7 @@ Last modified on {% last_modified_at %}
 [SSL certificate error](#ssl-certificate-error)<br />
 [Snowflake proxy connection error](#go-further)<br />
 [Spark DataFrame object error](#spark-dataframe-object-error)<br />
+[ImportError during programmatic scan](#importerror-during-programmatic-scan)<br />
 [Go further](#go-further)<br />
 <br />
 
@@ -32,6 +33,14 @@ Last modified on {% last_modified_at %}
 
 **Solution:** Be sure to upgrade your version of PySpark to 3.4.0 or greater for compatibility with Soda packages.
 
+## ImportError during programmatic scan
+
+**Problem:** When importing Soda scan, you get an error that reads, `ImportError: cannot import name 'field_validator' from 'pydantic'...`.
+
+**Solution:** This error typically emerges when your environment is using pydantic v1 instead of v2. Soda requires pydantic v2 to work and this is correctly set via installation requirements in the package, however Python allows you to override those requirements. Use `pip list | grep "pydantic"` to determine which version you are using and upgrade as necessary.
+
+<br />
+
 ## Go further
 
 * Access [Troubleshoot SodaCL]({% link soda-cl/troubleshoot.md %}) for help resolving issues running scans with SodaCL.

soda/new-documentation.md

@@ -9,6 +9,9 @@ parent: Learning resources
 
 <br /> 
 
+#### July 24, 2024
+* Added [release notes]({% link release-notes/all.md %}) documentation for Soda Library 1.5.20 and Soda Agent 1.1.21.
+
 #### July 23, 2024
 * Added [release notes]({% link release-notes/all.md %}) documentation for Soda Library 1.5.19.