release: 2023-05-05 (#403)

.github/workflows/bigquery.yml

@@ -17,6 +17,7 @@ on:
 env:
   NODE_VERSION: 14
   PYTHON3_VERSION: 3.8.10
+  VIRTUALENV_VERSION: 20.21.1
   GCLOUD_VERSION: 290.0.1
 
 jobs:
@@ -54,7 +55,7 @@ jobs:
         with:
           python-version: ${{ env.PYTHON3_VERSION }}
       - name: Setup virtualenv
-        run: pip install virtualenv
+        run: pip install virtualenv==${{ env.VIRTUALENV_VERSION }}
       - name: Run linter and tests
         run: |
           cd clouds/bigquery

.github/workflows/databricks.yml

@@ -16,12 +16,14 @@ on:
 
 env:
   PYTHON3_VERSION: 3.8.11
+  VIRTUALENV_VERSION: 20.21.1
   GCLOUD_VERSION: 290.0.1
   GOOGLE_SECRET_MANAGER_PROJECT: ${{ secrets.GOOGLE_SECRET_MANAGER_PROJECT }}
 
 jobs:
 
   test:
+    if: false
     runs-on: ubuntu-20.04
     timeout-minutes: 30
     env:
@@ -53,7 +55,7 @@ jobs:
         with:
           python-version: ${{ env.PYTHON3_VERSION }}
       - name: Setup virtualenv
-        run: pip install virtualenv
+        run: pip install virtualenv==${{ env.VIRTUALENV_VERSION }}
       - name: Setup databricks cli
         uses: microsoft/[email protected]
       - name: Run linter and tests
@@ -99,7 +101,7 @@ jobs:
         with:
           python-version: ${{ env.PYTHON3_VERSION }}
       - name: Setup virtualenv
-        run: pip install virtualenv
+        run: pip install virtualenv==${{ env.VIRTUALENV_VERSION }}
       - name: Setup databricks cli
         uses: microsoft/[email protected]
       - name: Run deploy
@@ -128,7 +130,7 @@ jobs:
         with:
           python-version: ${{ env.PYTHON3_VERSION }}
       - name: Setup virtualenv
-        run: pip install virtualenv
+        run: pip install virtualenv==${{ env.VIRTUALENV_VERSION }}
       - name: Auth google
         uses: google-github-actions/auth@v0
         with:

.github/workflows/postgres-ded.yml

@@ -7,6 +7,7 @@ on:
 env:
   NODE_VERSION: 14
   PYTHON3_VERSION: 3.8.10
+  VIRTUALENV_VERSION: 20.21.1
 
 jobs:
 
@@ -51,7 +52,7 @@ jobs:
         with:
           python-version: ${{ env.PYTHON3_VERSION }}
       - name: Setup virtualenv
-        run: pip install virtualenv
+        run: pip install virtualenv==${{ env.VIRTUALENV_VERSION }}
       - name: Run deploy
         if: github.event.action == 'synchronize' || github.event.action == 'labeled'
         id: deploy

.github/workflows/postgres.yml

@@ -17,6 +17,7 @@ on:
 env:
   NODE_VERSION: 14
   PYTHON3_VERSION: 3.8.10
+  VIRTUALENV_VERSION: 20.21.1
   GCLOUD_VERSION: 290.0.1
 
 jobs:
@@ -44,7 +45,7 @@ jobs:
         with:
           python-version: ${{ env.PYTHON3_VERSION }}
       - name: Setup virtualenv
-        run: pip install virtualenv
+        run: pip install virtualenv==${{ env.VIRTUALENV_VERSION }}
       - name: Run linter and tests
         run: |
           cd clouds/postgres
@@ -77,7 +78,7 @@ jobs:
         with:
           python-version: ${{ env.PYTHON3_VERSION }}
       - name: Setup virtualenv
-        run: pip install virtualenv
+        run: pip install virtualenv==${{ env.VIRTUALENV_VERSION }}
       - name: Run deploy
         run: |
           cd clouds/postgres
@@ -102,7 +103,7 @@ jobs:
         with:
           python-version: ${{ env.PYTHON3_VERSION }}
       - name: Setup virtualenv
-        run: pip install virtualenv
+        run: pip install virtualenv==${{ env.VIRTUALENV_VERSION }}
       - name: Auth google
         uses: google-github-actions/auth@v0
         with:

.github/workflows/redshift-ded.yml

@@ -8,6 +8,7 @@ env:
   NODE_VERSION: 14
   PYTHON2_VERSION: 2.7.18
   PYTHON3_VERSION: 3.8.10
+  VIRTUALENV_VERSION: 20.21.1
 
 jobs:
 
@@ -65,7 +66,7 @@ jobs:
           aws-secret-access-key: ${{ secrets.RS_AWS_SECRET_ACCESS_KEY_CD }}
           aws-region: ${{ secrets.RS_REGION_CD }}
       - name: Setup virtualenv
-        run: pip install virtualenv
+        run: pip install virtualenv==${{ env.VIRTUALENV_VERSION }}
       - name: Run deploy
         id: deploy
         if: github.event.action == 'synchronize' || github.event.action == 'labeled'

.github/workflows/redshift.yml

@@ -18,6 +18,7 @@ env:
   NODE_VERSION: 14
   PYTHON2_VERSION: 2.7.18
   PYTHON3_VERSION: 3.8.10
+  VIRTUALENV_VERSION: 20.21.1
   GCLOUD_VERSION: 290.0.1
 
 jobs:
@@ -52,7 +53,7 @@ jobs:
         with:
           python-version: ${{ env.PYTHON3_VERSION }}
       - name: Setup virtualenv
-        run: pip install virtualenv
+        run: pip install virtualenv==${{ env.VIRTUALENV_VERSION }}
       - name: Configure AWS Credentials
         uses: aws-actions/configure-aws-credentials@v1
         with:
@@ -98,7 +99,7 @@ jobs:
         with:
           python-version: ${{ env.PYTHON3_VERSION }}
       - name: Setup virtualenv
-        run: pip install virtualenv
+        run: pip install virtualenv==${{ env.VIRTUALENV_VERSION }}
       - name: Configure AWS Credentials
         uses: aws-actions/configure-aws-credentials@v1
         with:
@@ -130,7 +131,7 @@ jobs:
         with:
           python-version: ${{ env.PYTHON2_VERSION }}
       - name: Setup virtualenv
-        run: pip install virtualenv
+        run: pip install virtualenv==${{ env.VIRTUALENV_VERSION }}
       - name: Auth google
         uses: google-github-actions/auth@v0
         with:

.github/workflows/snowflake.yml

@@ -17,6 +17,7 @@ on:
 env:
   NODE_VERSION: 14
   PYTHON3_VERSION: 3.8.10
+  VIRTUALENV_VERSION: 20.21.1
   GCLOUD_VERSION: 290.0.1
 
 jobs:
@@ -45,7 +46,7 @@ jobs:
         with:
           python-version: ${{ env.PYTHON3_VERSION }}
       - name: Setup virtualenv
-        run: pip install virtualenv
+        run: pip install virtualenv==${{ env.VIRTUALENV_VERSION }}
       - name: Run linter and tests
         run: |
           cd clouds/snowflake

CHANGELOG.md

@@ -4,6 +4,15 @@ CARTO Analytics Toolbox Core.
 
 All notable commits to this project will be documented in this file.
 
+## 2023-05-05
+
+- feat(sf|h3): add H3_CENTER function (#395)
+- feat(sf|transformations): add ST_CONVEXHULL function (#397)
+- feat(pg|h3): support H3 functions (#396)
+- feat(pg|tools): add cat-installer for pg (#400)
+- fix(all|h3,quadbin,placekey,s2): update indexes in examples (#401)
+- feat(sf|h3): add H3_RESOLUTION function (#402)
+
 ## 2023-03-06
 
 - chore(rs): add initial version of cat-installer script (#386)

clouds/bigquery/common/DROP_FUNCTIONS.sql

@@ -1,5 +1,5 @@
 ---------------------------------
--- Copyright (C) 2021-2022 CARTO
+-- Copyright (C) 2021-2023 CARTO
 ---------------------------------
 
 CREATE OR REPLACE PROCEDURE `@@BQ_DATASET@@.DROP_FUNCTIONS`()

clouds/bigquery/modules/doc/h3/H3_BOUNDARY.md

@@ -17,6 +17,6 @@ Returns a geography representing the H3 cell. It will return `null` on error (in
 **Example**
 
 ```sql
-SELECT carto.H3_BOUNDARY('847b59dffffffff');
--- POLYGON((40.4650636223452 -3.9352772457965, 40.5465406026705 ...
+SELECT carto.H3_BOUNDARY('84390cbffffffff');
+-- POLYGON((-3.57692743539573 40.6134385959352, -3.85975632308016 ...
 ```

clouds/bigquery/modules/doc/h3/H3_CENTER.md

@@ -17,6 +17,6 @@ Returns the center of the H3 cell as a GEOGRAPHY point. It will return `null` on
 **Example**
 
 ```sql
-SELECT carto.H3_CENTER('847b59dffffffff');
--- POINT(40.3054764231743 -3.74320332556168)
+SELECT carto.H3_CENTER('84390cbffffffff');
+-- POINT(-3.61760324662829 40.3725405821658)
 ```

clouds/bigquery/modules/doc/h3/H3_COMPACT.md

@@ -17,6 +17,6 @@ Returns an array with the indexes of a set of hexagons across multiple resolutio
 **Example**
 
 ```sql
-SELECT carto.H3_COMPACT(['857b59c3fffffff', '857b59c7fffffff', '857b59cbfffffff', '857b59cffffffff', '857b59d3fffffff', '857b59d7fffffff', '857b59dbfffffff']);
--- 847b59dffffffff
+SELECT carto.H3_COMPACT(['85390ca3fffffff', '85390ca7fffffff', '85390cabfffffff', '85390caffffffff', '85390cb3fffffff', '85390cb7fffffff', '85390cbbfffffff']);
+-- 84390cbffffffff
 ```

clouds/bigquery/modules/doc/h3/H3_DISTANCE.md

@@ -18,7 +18,7 @@ Returns the **grid distance** between two hexagon indexes. This function may fai
 **Example**
 
 ```sql
-SELECT carto.H3_DISTANCE('847b591ffffffff', '847b59bffffffff');
+SELECT carto.H3_DISTANCE('84390c1ffffffff', '84390cbffffffff');
 -- 1
 ```
 

clouds/bigquery/modules/doc/h3/H3_FROMGEOGPOINT.md

@@ -18,8 +18,8 @@ Returns the H3 cell index that the point belongs to in the required `resolution`
 **Example**
 
 ```sql
-SELECT carto.H3_FROMGEOGPOINT(ST_GEOGPOINT(40.4168, -3.7038), 4);
--- 847b59dffffffff
+SELECT carto.H3_FROMGEOGPOINT(ST_GEOGPOINT(-3.7038, 40.4168), 4);
+-- 84390cbffffffff
 ```
 
 ````hint:info

clouds/bigquery/modules/doc/h3/H3_FROMLONGLAT.md

@@ -19,6 +19,6 @@ Returns the H3 cell index that the point belongs to in the required `resolution`
 **Example**
 
 ```sql
-SELECT carto.H3_FROMLONGLAT(40.4168, -3.7038, 4);
--- 847b59dffffffff
+SELECT carto.H3_FROMLONGLAT(-3.7038, 40.4168, 4);
+-- 84390cbffffffff
 ```

clouds/bigquery/modules/doc/h3/H3_HEXRING.md

@@ -18,11 +18,11 @@ Returns all cell indexes in a **hollow hexagonal ring** centered at the origin i
 **Example**
 
 ```sql
-SELECT carto.H3_HEXRING('837b59fffffffff', 1);
--- 837b5dfffffffff
--- 837b58fffffffff
--- 837b5bfffffffff
--- 837a66fffffffff
--- 837a64fffffffff
--- 837b4afffffffff
+SELECT carto.H3_HEXRING('84390cbffffffff', 1);
+-- 84392b5ffffffff
+-- 84390c9ffffffff
+-- 84390c1ffffffff
+-- 84390c3ffffffff
+-- 84390ddffffffff
+-- 84392b7ffffffff
 ```

clouds/bigquery/modules/doc/h3/H3_INT_TOSTRING.md

@@ -17,6 +17,6 @@ Converts the integer representation of the H3 index to the string representation
 **Example**
 
 ```sql
-SELECT carto.H3_INT_TOSTRING(596645165859340287);
--- 847b59dffffffff
+SELECT carto.H3_INT_TOSTRING(595478781590765567);
+-- 84390cbffffffff
 ```

clouds/bigquery/modules/doc/h3/H3_ISPENTAGON.md

@@ -17,7 +17,7 @@ Returns `true` if given H3 index is a pentagon. Returns `false` otherwise, even
 **Example**
 
 ```sql
-SELECT carto.H3_ISPENTAGON('837b59fffffffff');
+SELECT carto.H3_ISPENTAGON('84390cbffffffff');
 -- false
 ```
 

clouds/bigquery/modules/doc/h3/H3_ISVALID.md

@@ -17,7 +17,7 @@ Returns `true` when the given index is a valid H3 index, `false` otherwise.
 **Examples**
 
 ```sql
-SELECT carto.H3_ISVALID('847b59dffffffff');
+SELECT carto.H3_ISVALID('84390cbffffffff');
 -- true
 ```
 

clouds/bigquery/modules/doc/h3/H3_KRING.md

@@ -18,12 +18,12 @@ Returns all cell indexes in a **filled hexagonal k-ring** centered at the origin
 **Example**
 
 ```sql
-SELECT carto.H3_KRING('837b59fffffffff', 1);
--- 837b59fffffffff
--- 837b58fffffffff
--- 837b5bfffffffff
--- 837a66fffffffff
--- 837a64fffffffff
--- 837b4afffffffff
--- 837b5dfffffffff
+SELECT carto.H3_KRING('84390cbffffffff', 1);
+-- 84390cbffffffff
+-- 84390c9ffffffff
+-- 84390c1ffffffff
+-- 84390c3ffffffff
+-- 84390ddffffffff
+-- 84392b7ffffffff
+-- 84392b5ffffffff
 ```

clouds/bigquery/modules/doc/h3/H3_KRING_DISTANCES.md

@@ -18,12 +18,12 @@ Returns all cell indexes and their distances in a **filled hexagonal k-ring** ce
 **Example**
 
 ```sql
-SELECT carto.H3_KRING_DISTANCES('837b59fffffffff', 1);
--- {"index": "837b59fffffffff", "distance": "0"}
--- {"index": "837b5dfffffffff", "distance": "1"}
--- {"index": "837b58fffffffff", "distance": "1"}
--- {"index": "837b5bfffffffff", "distance": "1"}
--- {"index": "837a66fffffffff", "distance": "1"}
--- {"index": "837a64fffffffff", "distance": "1"}
--- {"index": "837b4afffffffff", "distance": "1"}
+SELECT carto.H3_KRING_DISTANCES('84390cbffffffff', 1);
+-- {"index": "84390cbffffffff", "distance": "0"}
+-- {"index": "84390c9ffffffff", "distance": "1"}
+-- {"index": "84390c1ffffffff", "distance": "1"}
+-- {"index": "84390c3ffffffff", "distance": "1"}
+-- {"index": "84390ddffffffff", "distance": "1"}
+-- {"index": "84392b7ffffffff", "distance": "1"}
+-- {"index": "84392b5ffffffff", "distance": "1"}
 ```

clouds/bigquery/modules/doc/h3/H3_RESOLUTION.md

@@ -17,6 +17,6 @@ Returns the H3 cell resolution as an integer. It will return `null` on error (in
 **Example**
 
 ```sql
-SELECT carto.H3_RESOLUTION('847b59dffffffff');
+SELECT carto.H3_RESOLUTION('84390cbffffffff');
 -- 4
 ```

clouds/bigquery/modules/doc/h3/H3_STRING_TOINT.md

@@ -17,6 +17,6 @@ Converts the string representation of the H3 index to the integer representation
 **Example**
 
 ```sql
-SELECT carto.H3_STRING_TOINT('847b59dffffffff');
--- 596645165859340287
+SELECT carto.H3_STRING_TOINT('84390cbffffffff');
+-- 595478781590765567
 ```

clouds/bigquery/modules/doc/h3/H3_TOCHILDREN.md

@@ -18,12 +18,12 @@ Returns an array with the H3 indexes of the children/descendents of the given he
 **Example**
 
 ```sql
-SELECT carto.H3_TOCHILDREN('837b59fffffffff', 4);
--- 847b591ffffffff
--- 847b593ffffffff
--- 847b595ffffffff
--- 847b597ffffffff
--- 847b599ffffffff
--- 847b59bffffffff
--- 847b59dffffffff
+SELECT carto.H3_TOCHILDREN('83390cfffffffff', 4);
+-- 84390c1ffffffff
+-- 84390c3ffffffff
+-- 84390c5ffffffff
+-- 84390c7ffffffff
+-- 84390c9ffffffff
+-- 84390cbffffffff
+-- 84390cdffffffff
 ```

clouds/bigquery/modules/doc/h3/H3_TOPARENT.md

@@ -18,6 +18,6 @@ Returns the H3 cell index of the parent of the given hexagon at the given resolu
 **Example**
 
 ```sql
-SELECT carto.H3_TOPARENT('847b59dffffffff', 3);
--- 837b59fffffffff
+SELECT carto.H3_TOPARENT('84390cbffffffff', 3);
+-- 83390cfffffffff
 ```