Merge branch 'master' into lfischerstrom/quarter-dimension

Author: KSDaemon

.github/pull_request_template.md

@@ -1,5 +1,5 @@
 **Check List**
-- [ ] Tests has been run in packages where changes made if available
+- [ ] Tests have been run in packages where changes made if available
 - [ ] Linter has been run for changed code
 - [ ] Tests for the changes have been added if not covered yet
 - [ ] Docs have been added / updated if required

dev-env.sh

@@ -5,6 +5,8 @@ set -e
 CURRENT_DIR=$(pwd)
 SCRIPT_DIR=$(dirname "$(realpath "$0")")
 
+IGNORED_PACKAGES=("cubejs-testing*" "cubejs-linter" "cubejs-docker")
+
 # Function to install dependencies in root
 install_root_dependencies() {
     echo "Running 'yarn install' in the root directory..."
@@ -35,6 +37,21 @@ link_packages() {
     cd "$SCRIPT_DIR"
     for package in packages/*; do
         if [ -d "$package" ]; then
+            package_name=$(basename "$package")
+
+            skip_package="false"
+            for pattern in "${IGNORED_PACKAGES[@]}"; do
+                # shellcheck disable=SC2053
+                if [[ "$package_name" == $pattern ]]; then
+                    echo "Skipping $package_name..."
+                    skip_package="true"
+                fi
+            done
+
+            if [ "$skip_package" = "true" ]; then
+                continue
+            fi
+
             echo "Linking $package..."
             cd "$package"
             yarn link
@@ -106,6 +123,21 @@ link_project_packages() {
     cd "$CURRENT_DIR/$app_name"
     for package in "$SCRIPT_DIR"/packages/*; do
         if [ -d "$package" ]; then
+            package_name=$(basename "$package")
+
+            skip_package="false"
+            for pattern in "${IGNORED_PACKAGES[@]}"; do
+                # shellcheck disable=SC2053
+                if [[ "$package_name" == $pattern ]]; then
+                    echo "Skipping $package_name..."
+                    skip_package="true"
+                fi
+            done
+
+            if [ "$skip_package" = "true" ]; then
+                continue
+            fi
+
             package_name=$(node -p "require('$package/package.json').name")
             echo "Linking $package_name..."
             yarn link "$package_name"
@@ -146,6 +178,7 @@ show_help() {
     echo ""
     echo "  link           Link all packages and link them to a project"
     echo "                  Usage: ./dev-env.sh link [app_name]"
+    echo "                  If argument is omitted, cube packages will be marked as linked"
     echo ""
     echo "  setup          Run all steps (install, build, link, create project)"
     echo "                  Usage: ./dev-env.sh setup [app_name] [db_type]"
@@ -177,7 +210,9 @@ case "$command" in
         ;;
     "link")
         link_packages
-        link_project_packages "$2"
+        if [ -n "$2" ]; then
+            link_project_packages "$2"
+        fi
         ;;
     "drivers")
         get_db_types

docs/package.json

@@ -21,7 +21,7 @@
     "classnames": "^2.3.2",
     "cubedev-tracking": "^1.1.0",
     "date-fns": "^2.30.0",
-    "next": "^14.2.10",
+    "next": "^14.2.21",
     "next-sitemap": "^4.1.3",
     "nextra": "^2.13.2",
     "nextra-theme-docs": "^2.4.0",

docs/pages/product/configuration/data-sources/snowflake.mdx

@@ -150,6 +150,26 @@ CUBEJS_DB_EXPORT_GCS_CREDENTIALS=<BASE64_ENCODED_SERVICE_CREDENTIALS_JSON>
 CUBEJS_DB_EXPORT_INTEGRATION=gcs_int
 ```
 
+#### Azure
+
+To use Azure Blob Storage as an export bucket, follow [the guide on 
+using a Snowflake storage integration (Option 1)][snowflake-docs-azure]. 
+Take note of the integration name (`azure_int` from the example link)
+as you'll need it to configure Cube.
+
+[Retrieve the storage account access key][azure-bs-docs-get-key] from your Azure
+account.
+
+Once the Snowflake integration is set up, configure Cube using the following:
+
+```dotenv
+CUBEJS_DB_EXPORT_BUCKET_TYPE=azure
+CUBEJS_DB_EXPORT_BUCKET=wasbs://[email protected]
+CUBEJS_DB_EXPORT_BUCKET_AZURE_KEY=<AZURE_STORAGE_ACCOUNT_ACCESS_KEY>
+CUBEJS_DB_EXPORT_INTEGRATION=azure_int
+```
+
+
 ## SSL
 
 Cube does not require any additional configuration to enable SSL as Snowflake
@@ -176,3 +196,5 @@ connections are made over HTTPS.
 [snowflake-docs-warehouse]:
   https://docs.snowflake.com/en/user-guide/warehouses.html
 [snowflake-format-2]: https://docs.snowflake.com/en/user-guide/admin-account-identifier#format-2-account-locator-in-a-region
+[snowflake-docs-azure]: https://docs.snowflake.com/en/user-guide/data-load-azure-config#option-1-configuring-a-snowflake-storage-integration
+[azure-bs-docs-get-key]: https://docs.microsoft.com/en-us/azure/storage/common/storage-account-keys-manage?toc=%2Fazure%2Fstorage%2Fblobs%2Ftoc.json&tabs=azure-portal#view-account-access-keys

docs/pages/product/distribution.mdx

@@ -54,6 +54,13 @@ that breaking changes can happen both in _major_ and _minor_ versions. Before
 upgrading, it is recommended that you check the [release notes][link-releases]
 on GitHub and read [changelog entries][link-changelog] in the blog.
 
+<WarningBox>
+
+You can find a list of currently [deprecated features][link-github-deprecation] on GitHub.
+Usually, there are also deprecation notices in the documentation that look similar to this one.
+
+</WarningBox>
+
 Additionally, Cube Cloud provides [update channels][ref-update-channels] where
 versions are marked as either <Btn>Stable</Btn> or <Btn>Latest</Btn>.
 
@@ -92,6 +99,7 @@ List of LTS releases:
 [link-dockerhub-cubestore]: https://hub.docker.com/r/cubejs/cubestore/tags
 [link-apple-silicon]: https://support.apple.com/en-us/116943
 [link-semver]: https://semver.org
+[link-github-deprecation]: https://github.com/cube-js/cube/blob/master/DEPRECATION.md
 [ref-infrastructure]: /product/deployment/cloud
 [ref-workspace]: /product/workspace
 [ref-deployment]: /product/deployment

docs/pages/reference/data-model/joins.mdx

@@ -654,6 +654,16 @@ Joins `a → b` and `b → c` will be resolved automatically. Cube uses the
 [Dijkstra algorithm][wiki-djikstra-alg] to find a join path between cubes given
 requested members.
 
+In case there are multiple join paths that can be used to join the same set of cubes, Cube will collect cube names from members in the following order:
+
+1. Measures
+2. Dimensions
+3. Segments
+4. Time dimensions
+
+Cube makes join trees as predictable and stable as possible, but this isn't guaranteed in case multiple join paths exist.
+Please use views to address join predictability and stability.
+
 [ref-restapi-query-filter-op-set]:
   /product/apis-integrations/rest-api/query-format#set
 [ref-schema-fundamentals-join-dir]: